@contract-case/case-plugin-dsl-types - npm Package Compare versions

Comparing version 0.17.1 to 0.18.0

dist/src/mocks/setup.types.d.ts

@@ -13,3 +13,13 @@ import { HasTypeForMockDescriptor } from './nodes.types';
      */
-    variables: Record<string, VariableValue>;
+    stateVariables: Record<string, VariableValue>;
+    /**
+     * Setup returned by the mock executor (eg, urls, function names, etc)
+     */
+    mock: Record<string, VariableValue>;
+    /**
+     * Arbitrary map of invokeable functions. For most purposes, this can be
+     * empty. Useful for allowing plugins to invoke functions - the intention is
+     * that arguments and return values are JSON encoded strings.
+     */
+    functions: Record<string, (...args: string[]) => string>;
 };
@@ -16,0 +26,0 @@ /**

dist/src/mocks/setup.types.d.ts.map

@@ -1,1 +0,1 @@
-{"version":3,"file":"setup.types.d.ts","sourceRoot":"","sources":["../../../src/mocks/setup.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAKzD,KAAK,aAAa,GAAG,GAAG,CAAC;AAEzB;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAC1C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,YAAY,CAAC,YAAY,EAAE,CAAC,SAAS,MAAM,IAAI,OAAO,CAChE,YAAY,EACZ,wBAAwB,CAAC,CAAC,CAAC,CAC5B,GACC,aAAa,CAAC"}
+{"version":3,"file":"setup.types.d.ts","sourceRoot":"","sources":["../../../src/mocks/setup.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAKzD,KAAK,aAAa,GAAG,GAAG,CAAC;AAEzB;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC9C;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACpC;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,KAAK,MAAM,CAAC,CAAC;CAC1D,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,YAAY,CAAC,YAAY,EAAE,CAAC,SAAS,MAAM,IAAI,OAAO,CAChE,YAAY,EACZ,wBAAwB,CAAC,CAAC,CAAC,CAC5B,GACC,aAAa,CAAC"}

dist/src/states/states.types.d.ts

 import { AnyCaseMatcherOrData } from '../matchers/types';
+/**
+ * Type identifier constant for the built-in {@link NameOnlyState} type.
+ * @public
+ */
 export declare const SETUP_NAMED_STATE: "_case:NamedState";
+/**
+ *  Type identifier constant for the built-in {@link StateWithVariables} type.
+ * @public
+ */
 export declare const SETUP_VARIABLE_STATE: "_case:StateWithVariables";
+/**
+ * Helper type for extracting state types by their constant
+ * @public
+ */
 export type HasTypeForState<T extends AnyStateType> = {
     '_case:state:type': T;
 };
+/**
+ * Describes a state that only has a name and no other information
+ * @public
+ */
 export type NameOnlyState = HasTypeForState<typeof SETUP_NAMED_STATE> & {
+    /**
+     * The human readable state name, for identifying state handlers.
+     * Any string is acceptable, though we recommend keeping state names short.
+     *
+     * In a future release, some specific state names may be reserved.
+     */
     readonly stateName: string;
 };
+/**
+ * Describes a named state that also contains some variables. These variables can be
+ * returned by state handlers later.
+ * @public
+ */
 export type StateWithVariables = HasTypeForState<typeof SETUP_VARIABLE_STATE> & {
+    /**
+     * The human readable state name, for identifying state handlers.
+     * Any string is acceptable, though we recommend keeping state names short.
+     *
+     * In a future release, some specific state names may be reserved.
+     */
     readonly stateName: string;
+    /**
+     * Default values and matchers for the variables. The state handler must return
+     * a value for each of these named variables. We recommend keeping variables
+     * human readable and short. Since the state handler needs to return these, we
+     * recommend using similar naming conventions to variables in your chosen
+     * language.
+     */
     readonly variables: Record<string, AnyCaseMatcherOrData>;
 };
+/**
+ * Union type of all currently known State identifier strings.
+ * @public
+ */
 export type AnyStateType = typeof SETUP_NAMED_STATE | typeof SETUP_VARIABLE_STATE;
+/**
+ * Union type of all currently known State types.
+ * @public
+ */
 export type AnyState = NameOnlyState | StateWithVariables;
 //# sourceMappingURL=states.types.d.ts.map

dist/src/states/states.types.d.ts.map

@@ -1,1 +0,1 @@
-{"version":3,"file":"states.types.d.ts","sourceRoot":"","sources":["../../../src/states/states.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,eAAO,MAAM,iBAAiB,oBAA8B,CAAC;AAC7D,eAAO,MAAM,oBAAoB,4BAAsC,CAAC;AAExE,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,YAAY,IAAI;IACpD,kBAAkB,EAAE,CAAC,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,eAAe,CAAC,OAAO,iBAAiB,CAAC,GAAG;IACtE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAC9C,OAAO,oBAAoB,CAC5B,GAAG;IACF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;CAC1D,CAAC;AAEF,MAAM,MAAM,YAAY,GACpB,OAAO,iBAAiB,GACxB,OAAO,oBAAoB,CAAC;AAEhC,MAAM,MAAM,QAAQ,GAAG,aAAa,GAAG,kBAAkB,CAAC"}
+{"version":3,"file":"states.types.d.ts","sourceRoot":"","sources":["../../../src/states/states.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,oBAA8B,CAAC;AAC7D;;;GAGG;AACH,eAAO,MAAM,oBAAoB,4BAAsC,CAAC;AAExE;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,YAAY,IAAI;IACpD,kBAAkB,EAAE,CAAC,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,eAAe,CAAC,OAAO,iBAAiB,CAAC,GAAG;IACtE;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAC9C,OAAO,oBAAoB,CAC5B,GAAG;IACF;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;CAC1D,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB,OAAO,iBAAiB,GACxB,OAAO,oBAAoB,CAAC;AAEhC;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,aAAa,GAAG,kBAAkB,CAAC"}

dist/src/states/states.types.js

 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SETUP_VARIABLE_STATE = exports.SETUP_NAMED_STATE = void 0;
+/**
+ * Type identifier constant for the built-in {@link NameOnlyState} type.
+ * @public
+ */
 exports.SETUP_NAMED_STATE = '_case:NamedState';
+/**
+ *  Type identifier constant for the built-in {@link StateWithVariables} type.
+ * @public
+ */
 exports.SETUP_VARIABLE_STATE = '_case:StateWithVariables';
 //# sourceMappingURL=states.types.js.map

dist/src/states/states.types.js.map

@@ -1,1 +0,1 @@
-{"version":3,"file":"states.types.js","sourceRoot":"","sources":["../../../src/states/states.types.ts"],"names":[],"mappings":";;;AAEa,QAAA,iBAAiB,GAAG,kBAA2B,CAAC;AAChD,QAAA,oBAAoB,GAAG,0BAAmC,CAAC"}
+{"version":3,"file":"states.types.js","sourceRoot":"","sources":["../../../src/states/states.types.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACU,QAAA,iBAAiB,GAAG,kBAA2B,CAAC;AAC7D;;;GAGG;AACU,QAAA,oBAAoB,GAAG,0BAAmC,CAAC"}

package.json

 {
   "name": "@contract-case/case-plugin-dsl-types",
-  "version": "0.17.1",
+  "version": "0.18.0",
   "description": "Types for writing the definition DSL for plugins for the ContractCase test framework",
@@ -66,3 +66,3 @@ "keywords": [
   },
-  "gitHead": "0fdf25453a567bc6433834374725954e3d2ff206"
+  "gitHead": "9d63acd9233bdfcf1d0933517547faedaa6dc860"
 }

No alert changes

Improved metrics

Total package byte prevSize

75759

3.32%

Lines of code

406

19.41%

No dependency changes