@jonloucks/contracts-ts 0.4.0 → 1.0.0

package/api/AutoClose.d.ts

@@ -58,7 +58,7 @@ export interface AutoCloseWrapper extends AutoClose {
     /**
      * Unwrap to get the original AutoCloseType.
      */
-    unwrap(): RequiredType<AutoCloseType>;
+    unwrapAutoCloseType(): RequiredType<AutoCloseType>;
 }
 /**
  * Convert a simple runnable into an AutoClose with dispose
@@ -80,14 +80,14 @@ export declare function unwrapAutoClose(autoClose: OptionalType<AutoClose>): Opt
  * @param instance the instance to check
  * @returns true if the instance implements AutoClose, false otherwise
  */
-export declare function isAutoClose(instance: unknown): instance is OptionalType<AutoClose>;
+export declare function guard(instance: unknown): instance is RequiredType<AutoClose>;
 /**
  * Duck-typing check for object with close() method.
  *
  * @param instance the instance to check
  * @returns true if the instance implements AutoClose, false otherwise
  */
-export declare function isClose(instance: unknown): instance is OptionalType<AutoClose>;
+export declare function isClose(instance: unknown): instance is RequiredType<AutoClose>;
 /**
  * Convert an AutoCloseType to an AutoClose
  * @param type the type to convert

package/api/AutoClose.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AutoClose.d.ts","sourceRoot":"","sources":["../../src/api/AutoClose.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAA8B,MAAM,mCAAmC,CAAC;AAI3G;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,KAAK;IAClB;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAU,SAAQ,KAAK;IACpC;;OAEG;IACH,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,SAAS;IAE5C;;;;;OAKG;IACH,GAAG,CAAC,SAAS,EAAE,YAAY,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,SAAS;IAE3C;;;;OAIG;IACH,GAAG,CAAC,SAAS,EAAE,YAAY,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;CACrD;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,SAe7B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IAE/C;;OAEG;IACH,MAAM,IAAI,YAAY,CAAC,aAAa,CAAC,CAAC;CACzC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,IAAI,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAMlF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,YAAY,CAAC,SAAS,CAAC,GAAG,YAAY,CAAC,aAAa,CAAC,CAQ/F;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,YAAY,CAAC,SAAS,CAAC,CAElF;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,YAAY,CAAC,SAAS,CAAC,CAE9E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,CAAC,aAAa,CAAC,GAAG,YAAY,CAAC,SAAS,CAAC,CAW1F"}
+{"version":3,"file":"AutoClose.d.ts","sourceRoot":"","sources":["../../src/api/AutoClose.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAgC,MAAM,mCAAmC,CAAC;AAI7G;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAU,SAAQ,KAAK;IACtC;;OAEG;IACH,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,SAAS;IAE9C;;;;;OAKG;IACH,GAAG,CAAC,SAAS,EAAE,YAAY,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,SAAS;IAE7C;;;;OAIG;IACH,GAAG,CAAC,SAAS,EAAE,YAAY,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;CACnD;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,SAe7B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IAEjD;;OAEG;IACH,mBAAmB,IAAI,YAAY,CAAC,aAAa,CAAC,CAAC;CACpD;AAWD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,IAAI,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAMlF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,YAAY,CAAC,SAAS,CAAC,GAAG,YAAY,CAAC,aAAa,CAAC,CAQ/F;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,YAAY,CAAC,SAAS,CAAC,CAE5E;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,YAAY,CAAC,SAAS,CAAC,CAE9E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,CAAC,aAAa,CAAC,GAAG,YAAY,CAAC,SAAS,CAAC,CAW1F"}

package/api/AutoClose.js

@@ -3,12 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AUTO_CLOSE_NONE = void 0;
 exports.inlineAutoClose = inlineAutoClose;
 exports.unwrapAutoClose = unwrapAutoClose;
-exports.isAutoClose = isAutoClose;
+exports.guard = guard;
 exports.isClose = isClose;
 exports.typeToAutoClose = typeToAutoClose;
 const Types_1 = require("@jonloucks/contracts-ts/api/Types");
-const IllegalArgumentException_1 = require("@jonloucks/contracts-ts/auxiliary/IllegalArgumentException");
 const Checks_1 = require("@jonloucks/contracts-ts/auxiliary/Checks");
+const IllegalArgumentException_1 = require("@jonloucks/contracts-ts/auxiliary/IllegalArgumentException");
 /**
  * A no-op AutoClose instance that does nothing on close or dispose.
  */
@@ -26,6 +26,14 @@ exports.AUTO_CLOSE_NONE = {
         // no-op
     }
 };
+/**
+ * Check if an instance is an AutoCloseWrapper
+ * @param instance the instance to check
+ * @returns true if the instance is an AutoCloseWrapper, false otherwise
+ */
+function guardAutoCloseWrapper(instance) {
+    return (0, Types_1.guardFunctions)(instance, 'unwrapAutoCloseType');
+}
 /**
  * Convert a simple runnable into an AutoClose with dispose
  *
@@ -36,7 +44,7 @@ function inlineAutoClose(action) {
     return {
         close: action,
         [Symbol.dispose]: action,
-        unwrap: () => action
+        unwrapAutoCloseType: () => action
     };
 }
 /**
@@ -49,8 +57,8 @@ function unwrapAutoClose(autoClose) {
     if ((0, Types_1.isNotPresent)(autoClose)) {
         return autoClose;
     }
-    if ('unwrap' in autoClose && typeof autoClose.unwrap === 'function') {
-        return autoClose.unwrap();
+    if (guardAutoCloseWrapper(autoClose)) {
+        return autoClose.unwrapAutoCloseType();
     }
     return autoClose;
 }
@@ -60,8 +68,8 @@ function unwrapAutoClose(autoClose) {
  * @param instance the instance to check
  * @returns true if the instance implements AutoClose, false otherwise
  */
-function isAutoClose(instance) {
-    return (0, Types_1.hasFunctions)(instance, 'close', Symbol.dispose);
+function guard(instance) {
+    return (0, Types_1.guardFunctions)(instance, 'close', Symbol.dispose);
 }
 /**
  * Duck-typing check for object with close() method.
@@ -70,7 +78,7 @@ function isAutoClose(instance) {
  * @returns true if the instance implements AutoClose, false otherwise
  */
 function isClose(instance) {
-    return (0, Types_1.hasFunctions)(instance, 'close');
+    return (0, Types_1.guardFunctions)(instance, 'close');
 }
 /**
  * Convert an AutoCloseType to an AutoClose
@@ -79,7 +87,7 @@ function isClose(instance) {
  */
 function typeToAutoClose(type) {
     const presentType = (0, Checks_1.presentCheck)(type, "AutoClose type must be present.");
-    if (isAutoClose(presentType)) {
+    if (guard(presentType)) {
         return presentType;
     }
     else if (isClose(presentType)) {

package/api/AutoClose.js.map

@@ -1 +1 @@
-{"version":3,"file":"AutoClose.js","sourceRoot":"","sources":["../../src/api/AutoClose.ts"],"names":[],"mappings":";;;AAgGA,0CAMC;AAQD,0CAQC;AAQD,kCAEC;AAQD,0BAEC;AAOD,0CAWC;AA5JD,6DAA2G;AAC3G,yGAAsG;AACtG,qEAAwE;AAyDxE;;GAEG;AACU,QAAA,eAAe,GAAc;IAEtC;;OAEG;IACH,KAAK,EAAE,GAAG,EAAE;QACR,QAAQ;IACZ,CAAC;IAED;;OAEG;IACH,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE;QACnB,QAAQ;IACZ,CAAC;CACJ,CAAC;AAaF;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,MAAkB;IAC9C,OAAO;QACH,KAAK,EAAE,MAAM;QACb,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM;QACxB,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM;KACvB,CAAC;AACN,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,SAAkC;IAC9D,IAAI,IAAA,oBAAY,EAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,IAAI,QAAQ,IAAI,SAAS,IAAI,OAAO,SAAS,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAClE,OAAO,SAAS,CAAC,MAAM,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,QAAiB;IACzC,OAAO,IAAA,oBAAY,EAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,SAAgB,OAAO,CAAC,QAAiB;IACrC,OAAO,IAAA,oBAAY,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,SAAgB,eAAe,CAAC,IAAiC;IAC7D,MAAM,WAAW,GAAG,IAAA,qBAAY,EAAC,IAAI,EAAE,iCAAiC,CAAC,CAAC;IAC1E,IAAI,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;QAC3B,OAAO,WAAW,CAAC;IACvB,CAAC;SAAM,IAAI,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9B,OAAO,eAAe,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;SAAM,IAAI,OAAO,WAAW,KAAK,UAAU,EAAE,CAAC;QAC3C,OAAO,eAAe,CAAC,WAA4B,CAAC,CAAC;IACzD,CAAC;SAAM,CAAC;QACJ,MAAM,IAAI,mDAAwB,CAAC,yBAAyB,CAAC,CAAC;IAClE,CAAC;AACL,CAAC"}
+{"version":3,"file":"AutoClose.js","sourceRoot":"","sources":["../../src/api/AutoClose.ts"],"names":[],"mappings":";;;AAyGA,0CAMC;AAQD,0CAQC;AAQD,sBAEC;AAQD,0BAEC;AAOD,0CAWC;AArKD,6DAA6G;AAC7G,qEAAwE;AACxE,yGAAsG;AAyDtG;;GAEG;AACU,QAAA,eAAe,GAAc;IAExC;;OAEG;IACH,KAAK,EAAE,GAAG,EAAE;QACV,QAAQ;IACV,CAAC;IAED;;OAEG;IACH,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE;QACrB,QAAQ;IACV,CAAC;CACF,CAAC;AAaF;;;;GAIG;AACH,SAAS,qBAAqB,CAAC,QAAiB;IAC9C,OAAO,IAAA,sBAAc,EAAC,QAAQ,EAAE,qBAAqB,CAAC,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,MAAkB;IAChD,OAAO;QACL,KAAK,EAAE,MAAM;QACb,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM;QACxB,mBAAmB,EAAE,GAAG,EAAE,CAAC,MAAM;KAClC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,SAAkC;IAChE,IAAI,IAAA,oBAAY,EAAC,SAAS,CAAC,EAAE,CAAC;QAC5B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,qBAAqB,CAAC,SAAS,CAAC,EAAE,CAAC;QACrC,OAAO,SAAS,CAAC,mBAAmB,EAAE,CAAC;IACzC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,KAAK,CAAC,QAAiB;IACrC,OAAO,IAAA,sBAAc,EAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,SAAgB,OAAO,CAAC,QAAiB;IACvC,OAAO,IAAA,sBAAc,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,SAAgB,eAAe,CAAC,IAAiC;IAC/D,MAAM,WAAW,GAAG,IAAA,qBAAY,EAAC,IAAI,EAAE,iCAAiC,CAAC,CAAC;IAC1E,IAAI,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QACvB,OAAO,WAAW,CAAC;IACrB,CAAC;SAAM,IAAI,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,OAAO,eAAe,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC;IACpD,CAAC;SAAM,IAAI,OAAO,WAAW,KAAK,UAAU,EAAE,CAAC;QAC7C,OAAO,eAAe,CAAC,WAA4B,CAAC,CAAC;IACvD,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,mDAAwB,CAAC,yBAAyB,CAAC,CAAC;IAChE,CAAC;AACH,CAAC"}

package/api/AutoCloseFactory.d.ts

@@ -1,6 +1,5 @@
 import { AutoClose, AutoCloseMany, AutoCloseOne, AutoCloseType } from "@jonloucks/contracts-ts/api/AutoClose";
 import { Contract } from "@jonloucks/contracts-ts/api/Contract";
-import { Lawyer } from "@jonloucks/contracts-ts/api/Lawyer";
 import { RequiredType } from "@jonloucks/contracts-ts/api/Types";
 /**
  * Interface for a factory that creates AutoClose instances.
@@ -29,9 +28,12 @@ export { AutoClose, AutoCloseMany, AutoCloseOne, AutoCloseType } from "@jonlouck
 export { Contract } from "@jonloucks/contracts-ts/api/Contract";
 export { OptionalType, RequiredType } from "@jonloucks/contracts-ts/api/Types";
 /**
- * For creating a Contract for AutoCloseFactory with duck-typing checks.
+ * Type guard for AutoCloseFactory interface.
+ *
+ * @param instance the instance to check
+ * @returns true if the instance implements AutoCloseFactory
  */
-export declare const LAWYER: Lawyer<AutoCloseFactory>;
+export declare function guard(instance: unknown): instance is RequiredType<AutoCloseFactory>;
 /**
  * The Contract for AutoCloseFactory implementation.
  */

package/api/AutoCloseFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AutoCloseFactory.d.ts","sourceRoot":"","sources":["../../src/api/AutoCloseFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC9G,OAAO,EAAE,QAAQ,EAA4B,MAAM,sCAAsC,CAAC;AAC1F,OAAO,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAE5D,OAAO,EAA8B,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAE7F;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAE7B;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,YAAY,CAAC,aAAa,CAAC,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IAE5E;;;;OAIG;IACH,mBAAmB,IAAI,YAAY,CAAC,aAAa,CAAC,CAAC;IAEnD;;;;OAIG;IACH,kBAAkB,IAAI,YAAY,CAAC,YAAY,CAAC,CAAC;CACpD;AAED,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC9G,OAAO,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAE/E;;GAEG;AACH,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,gBAAgB,CAoB3C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAA2B,CAAC"}
+{"version":3,"file":"AutoCloseFactory.d.ts","sourceRoot":"","sources":["../../src/api/AutoCloseFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC9G,OAAO,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAEhE,OAAO,EAAkB,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEjF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAE7B;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,YAAY,CAAC,aAAa,CAAC,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IAE5E;;;;OAIG;IACH,mBAAmB,IAAI,YAAY,CAAC,aAAa,CAAC,CAAC;IAEnD;;;;OAIG;IACH,kBAAkB,IAAI,YAAY,CAAC,YAAY,CAAC,CAAC;CACpD;AAED,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC9G,OAAO,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAE/E;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,YAAY,CAAC,gBAAgB,CAAC,CAEnF;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAI9C,CAAC"}

package/api/AutoCloseFactory.js

@@ -1,30 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONTRACT = exports.LAWYER = void 0;
+exports.CONTRACT = void 0;
+exports.guard = guard;
 const RatifiedContract_1 = require("@jonloucks/contracts-ts/api/RatifiedContract");
 const Types_1 = require("@jonloucks/contracts-ts/api/Types");
 /**
- * For creating a Contract for AutoCloseFactory with duck-typing checks.
+ * Type guard for AutoCloseFactory interface.
+ *
+ * @param instance the instance to check
+ * @returns true if the instance implements AutoCloseFactory
  */
-exports.LAWYER = new class {
-    /**
-     * Lawyer.isDeliverable override
-     */
-    isDeliverable(instance) {
-        return (0, Types_1.hasFunctions)(instance, 'createAutoClose', 'createAutoCloseMany', 'createAutoCloseOne');
-    }
-    /**
-     * Lawyer.createContract override
-     */
-    createContract(config) {
-        const copy = { ...config ?? {} };
-        copy.test ?? (copy.test = this.isDeliverable);
-        copy.typeName ?? (copy.typeName = "AutoCloseFactory");
-        return (0, RatifiedContract_1.create)(copy);
-    }
-};
+function guard(instance) {
+    return (0, Types_1.guardFunctions)(instance, 'createAutoClose', 'createAutoCloseMany', 'createAutoCloseOne');
+}
 /**
  * The Contract for AutoCloseFactory implementation.
  */
-exports.CONTRACT = exports.LAWYER.createContract();
+exports.CONTRACT = (0, RatifiedContract_1.create)({
+    test: guard,
+    name: "AutoCloseFactory",
+    typeName: "AutoCloseFactory"
+});
 //# sourceMappingURL=AutoCloseFactory.js.map

package/api/AutoCloseFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"AutoCloseFactory.js","sourceRoot":"","sources":["../../src/api/AutoCloseFactory.ts"],"names":[],"mappings":";;;AAGA,mFAAwF;AACxF,6DAA6F;AAiC7F;;GAEG;AACU,QAAA,MAAM,GAA6B,IAAI;IAEhD;;OAEG;IACH,aAAa,CAA6B,QAAiB;QACvD,OAAO,IAAA,oBAAY,EAAC,QAAQ,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,oBAAoB,CAAC,CAAC;IAClG,CAAC;IAED;;OAEG;IACH,cAAc,CAA6B,MAA0B;QACjE,MAAM,IAAI,GAAsB,EAAE,GAAG,MAAM,IAAI,EAAE,EAAE,CAAC;QAEpD,IAAI,CAAC,IAAI,KAAT,IAAI,CAAC,IAAI,GAAK,IAAI,CAAC,aAAa,EAAC;QACjC,IAAI,CAAC,QAAQ,KAAb,IAAI,CAAC,QAAQ,GAAK,kBAAkB,EAAC;QAErC,OAAO,IAAA,yBAAc,EAAI,IAAI,CAAC,CAAC;IACnC,CAAC;CACJ,CAAC;AAEF;;GAEG;AACU,QAAA,QAAQ,GAA+B,cAAM,CAAC,cAAc,EAAE,CAAC"}
+{"version":3,"file":"AutoCloseFactory.js","sourceRoot":"","sources":["../../src/api/AutoCloseFactory.ts"],"names":[],"mappings":";;;AA0CA,sBAEC;AA1CD,mFAAwF;AACxF,6DAAiF;AAiCjF;;;;;GAKG;AACH,SAAgB,KAAK,CAAC,QAAiB;IACnC,OAAO,IAAA,sBAAc,EAAC,QAAQ,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,oBAAoB,CAAC,CAAC;AACpG,CAAC;AAED;;GAEG;AACU,QAAA,QAAQ,GAA+B,IAAA,yBAAc,EAAC;IAC/D,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,kBAAkB;IACxB,QAAQ,EAAE,kBAAkB;CAC/B,CAAC,CAAC"}

package/api/AutoOpen.d.ts

@@ -1,4 +1,5 @@
 import { AutoClose } from "@jonloucks/contracts-ts/api/AutoClose";
+import { RequiredType } from "@jonloucks/contracts-ts/api/Types";
 /**
  * Opt-in interface to be called once after creation, although implementations should
  * handle this gracefully. For example, this is when threads or hooks could be added.
@@ -11,7 +12,7 @@ export interface AutoOpen {
      * AutoOpen this instance
      * @return the mechanism to shut down
      */
-    open(): AutoClose;
+    autoOpen(): AutoClose;
 }
 /**
  * Duck-typing check for AutoOpen interface.
@@ -19,5 +20,5 @@ export interface AutoOpen {
  * @param instance the instance to check
  * @returns true if the instance implements AutoOpen, false otherwise
  */
-export declare function isAutoOpen(instance: unknown): instance is AutoOpen;
+export declare function guard(instance: unknown): instance is RequiredType<AutoOpen>;
 //# sourceMappingURL=AutoOpen.d.ts.map

package/api/AutoOpen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AutoOpen.d.ts","sourceRoot":"","sources":["../../src/api/AutoOpen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAC;AAGlE;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IAErB;;;OAGG;IACH,IAAI,IAAI,SAAS,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,QAAQ,CAElE"}
+{"version":3,"file":"AutoOpen.d.ts","sourceRoot":"","sources":["../../src/api/AutoOpen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAC;AAClE,OAAO,EAAkB,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEjF;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IAErB;;;OAGG;IACH,QAAQ,IAAI,SAAS,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,YAAY,CAAC,QAAQ,CAAC,CAE3E"}

package/api/AutoOpen.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isAutoOpen = isAutoOpen;
+exports.guard = guard;
 const Types_1 = require("@jonloucks/contracts-ts/api/Types");
 /**
  * Duck-typing check for AutoOpen interface.
@@ -8,7 +8,7 @@ const Types_1 = require("@jonloucks/contracts-ts/api/Types");
  * @param instance the instance to check
  * @returns true if the instance implements AutoOpen, false otherwise
  */
-function isAutoOpen(instance) {
-    return (0, Types_1.hasFunctions)(instance, 'open');
+function guard(instance) {
+    return (0, Types_1.guardFunctions)(instance, 'autoOpen');
 }
 //# sourceMappingURL=AutoOpen.js.map

package/api/AutoOpen.js.map

@@ -1 +1 @@
-{"version":3,"file":"AutoOpen.js","sourceRoot":"","sources":["../../src/api/AutoOpen.ts"],"names":[],"mappings":";;AAyBA,gCAEC;AA1BD,6DAAiE;AAkBjE;;;;;GAKG;AACH,SAAgB,UAAU,CAAC,QAAiB;IACxC,OAAO,IAAA,oBAAY,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"AutoOpen.js","sourceRoot":"","sources":["../../src/api/AutoOpen.ts"],"names":[],"mappings":";;AAyBA,sBAEC;AA1BD,6DAAiF;AAkBjF;;;;;GAKG;AACH,SAAgB,KAAK,CAAC,QAAiB;IACnC,OAAO,IAAA,sBAAc,EAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AAChD,CAAC"}

package/api/BasicContract.d.ts

@@ -30,13 +30,18 @@ export declare class BasicContract<T> implements Contract<T> {
     *
     * @param value the value to cast
     * @return the checked value. Note: null is possible. The Promisor is allowed to return null
-    * @throws ClassCastException iif the value can't be cast to the return type.
+    * @throws ContractException if the value can't be cast to the return type.
     */
     cast(value: unknown | null | undefined): DeliveryType<T>;
     /**
      * @return the contract name
      */
     get name(): string;
+    /**
+     * When guarded is true the Contract throws exception if deliverable is null or undefined
+     * The default is true.
+     */
+    get guarded(): boolean;
     /**
      * Note: Do not rely on this being a java class name
      * Note: The actual class is never exposed and is by design.
@@ -62,13 +67,14 @@ export declare class BasicContract<T> implements Contract<T> {
      * @param config
      */
     constructor(config?: Config<T> | null);
+    private throwCastException;
     private static ID_GENERATOR;
     private readonly _id;
     private readonly _name;
     private readonly _typeName;
     private readonly _tester;
-    private readonly _caster;
     private readonly _replaceable;
+    private readonly _guarded;
 }
 type DeliveryType<T> = OptionalType<T>;
 export {};

package/api/BasicContract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BasicContract.d.ts","sourceRoot":"","sources":["../../src/api/BasicContract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAG/E;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,GAAI,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAE/E;AAED;;;;;;;GAOG;AACH,qBAAa,aAAa,CAAC,CAAC,CAAE,YAAW,QAAQ,CAAC,CAAC,CAAC;IAEhD;;;;;;QAMI;IACJ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC;IAIxD;;;;;;;MAOE;IACK,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,YAAY,CAAC,CAAC,CAAC;IAQ/D;;OAEG;IACH,IAAW,IAAI,IAAI,MAAM,CAExB;IAED;;;;;OAKG;IACH,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED;;;;;OAKG;IACH,IAAW,WAAW,IAAI,OAAO,CAEhC;IAED;;;;OAIG;IACI,QAAQ,IAAI,MAAM;IAIzB;;;OAGG;gBACgB,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI;IAS5C,OAAO,CAAC,MAAM,CAAC,YAAY,CAAa;IAExC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAwC;IAC5D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;CAC1C;AAED,KAAK,YAAY,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"BasicContract.d.ts","sourceRoot":"","sources":["../../src/api/BasicContract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,EAAgB,YAAY,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAG7F;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAE9E;AAED;;;;;;;GAOG;AACH,qBAAa,aAAa,CAAC,CAAC,CAAE,YAAW,QAAQ,CAAC,CAAC,CAAC;IAElD;;;;;;QAMI;IACJ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC;IAIxD;;;;;;;MAOE;IACK,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,YAAY,CAAC,CAAC,CAAC;IAc/D;;OAEG;IACH,IAAW,IAAI,IAAI,MAAM,CAExB;IAED;;;OAGG;IACH,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED;;;;;OAKG;IACH,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED;;;;;OAKG;IACH,IAAW,WAAW,IAAI,OAAO,CAEhC;IAED;;;;OAIG;IACI,QAAQ,IAAI,MAAM;IAYzB;;;OAGG;gBACgB,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI;IAS5C,OAAO,CAAC,kBAAkB;IAK1B,OAAO,CAAC,MAAM,CAAC,YAAY,CAAa;IAExC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAwC;IAC5D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;CACpC;AAED,KAAK,YAAY,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC"}

package/api/BasicContract.js

@@ -2,7 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BasicContract = void 0;
 exports.create = create;
-const ClassCastException_1 = require("@jonloucks/contracts-ts/auxiliary/ClassCastException");
+const Types_1 = require("@jonloucks/contracts-ts/api/Types");
+const ContractException_1 = require("@jonloucks/contracts-ts/api/ContractException");
 /**
  * Create a basic Contract
  *
@@ -37,14 +38,22 @@ class BasicContract {
     *
     * @param value the value to cast
     * @return the checked value. Note: null is possible. The Promisor is allowed to return null
-    * @throws ClassCastException iif the value can't be cast to the return type.
+    * @throws ContractException if the value can't be cast to the return type.
     */
     cast(value) {
+        if ((0, Types_1.isNotPresent)(value)) {
+            if (this._guarded) {
+                this.throwCastException();
+            }
+            else {
+                return value;
+            }
+        }
         if (this._tester(value)) {
-            return this._caster(value);
+            return value;
         }
         else {
-            throw new ClassCastException_1.ClassCastException(`${this.toString()} cast failed.`);
+            this.throwCastException();
         }
     }
     /**
@@ -53,6 +62,13 @@ class BasicContract {
     get name() {
         return this._name;
     }
+    /**
+     * When guarded is true the Contract throws exception if deliverable is null or undefined
+     * The default is true.
+     */
+    get guarded() {
+        return this._guarded;
+    }
     /**
      * Note: Do not rely on this being a java class name
      * Note: The actual class is never exposed and is by design.
@@ -77,7 +93,15 @@ class BasicContract {
      * @returns a string representation of the contract
      */
     toString() {
-        return `Contract(id=${this._id}, name=${this.name}, type=${this.typeName})`;
+        let text = `Contract(id=${this._id}`;
+        if (this.name.length > 0) {
+            text += `, name=${this.name}`;
+        }
+        if (this.typeName.length > 0) {
+            text += `, type=${this.typeName}`;
+        }
+        text += `)`;
+        return text;
     }
     /**
      *
@@ -87,10 +111,14 @@ class BasicContract {
         this._id = BasicContract.ID_GENERATOR++;
         const candidateConfig = config ?? {};
         this._replaceable = candidateConfig?.replaceable ?? false;
+        this._guarded = candidateConfig?.guarded ?? true;
         this._name = candidateConfig?.name ?? "";
         this._typeName = candidateConfig?.typeName ?? "";
-        this._tester = candidateConfig?.test ?? ((instance) => true);
-        this._caster = candidateConfig?.cast ?? ((instance) => instance);
+        this._tester = candidateConfig?.test ?? ((_instance) => true);
+    }
+    throwCastException() {
+        // Note: message intentionally does not include the instance value
+        throw new ContractException_1.ContractException(`Casting error. Unable to cast '${this.toString()}'.`);
     }
 }
 exports.BasicContract = BasicContract;

package/api/BasicContract.js.map

@@ -1 +1 @@
-{"version":3,"file":"BasicContract.js","sourceRoot":"","sources":["../../src/api/BasicContract.ts"],"names":[],"mappings":";;;AAUA,wBAEC;AAVD,6FAA0F;AAE1F;;;;;GAKG;AACH,SAAgB,MAAM,CAAI,MAAyB;IAC/C,OAAO,aAAa,CAAC,MAAM,CAAI,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;;GAOG;AACH,MAAa,aAAa;IAEtB;;;;;;QAMI;IACJ,MAAM,CAAC,MAAM,CAAI,MAAyB;QACtC,OAAO,IAAI,aAAa,CAAI,MAAM,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;;MAOE;IACK,IAAI,CAAC,KAAiC;QACzC,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAoB,CAAC;QAClD,CAAC;aAAM,CAAC;YACJ,MAAM,IAAI,uCAAkB,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;QACpE,CAAC;IACL,CAAC;IAED;;OAEG;IACH,IAAW,IAAI;QACX,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED;;;;;OAKG;IACH,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACH,IAAW,WAAW;QAClB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACI,QAAQ;QACX,OAAO,eAAe,IAAI,CAAC,GAAG,UAAU,IAAI,CAAC,IAAI,UAAU,IAAI,CAAC,QAAQ,GAAG,CAAC;IAChF,CAAC;IAED;;;OAGG;IACH,YAAmB,MAAyB;QAW3B,QAAG,GAAW,aAAa,CAAC,YAAY,EAAE,CAAC;QAVxD,MAAM,eAAe,GAAc,MAAM,IAAI,EAAE,CAAC;QAChD,IAAI,CAAC,YAAY,GAAG,eAAe,EAAE,WAAW,IAAI,KAAK,CAAC;QAC1D,IAAI,CAAC,KAAK,GAAG,eAAe,EAAE,IAAI,IAAI,EAAE,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,eAAe,EAAE,QAAQ,IAAI,EAAE,CAAC;QACjD,IAAI,CAAC,OAAO,GAAG,eAAe,EAAE,IAAI,IAAI,CAAC,CAAC,QAAiB,EAA+B,EAAE,CAAC,IAAI,CAAC,CAAC;QACnG,IAAI,CAAC,OAAO,GAAG,eAAe,EAAE,IAAI,IAAI,CAAC,CAAC,QAAiB,EAAmB,EAAE,CAAC,QAA2B,CAAC,CAAC;IAClH,CAAC;;AA5EL,sCAsFC;AARkB,0BAAY,GAAW,CAAC,AAAZ,CAAa"}
+{"version":3,"file":"BasicContract.js","sourceRoot":"","sources":["../../src/api/BasicContract.ts"],"names":[],"mappings":";;;AAUA,wBAEC;AAXD,6DAA6F;AAC7F,qFAAkF;AAElF;;;;;GAKG;AACH,SAAgB,MAAM,CAAI,MAAyB;IACjD,OAAO,aAAa,CAAC,MAAM,CAAI,MAAM,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;GAOG;AACH,MAAa,aAAa;IAExB;;;;;;QAMI;IACJ,MAAM,CAAC,MAAM,CAAI,MAAyB;QACxC,OAAO,IAAI,aAAa,CAAI,MAAM,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;;MAOE;IACK,IAAI,CAAC,KAAiC;QAC3C,IAAI,IAAA,oBAAY,EAAC,KAAK,CAAC,EAAE,CAAC;YACxB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,CAAC;iBAAM,CAAC;gBACN,OAAO,KAAwB,CAAC;YAClC,CAAC;QACH,CAAC;QAAC,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC;QACf,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;;OAGG;IACH,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;;;;OAKG;IACH,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;;;;OAKG;IACH,IAAW,WAAW;QACpB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACI,QAAQ;QACb,IAAI,IAAI,GAAG,eAAe,IAAI,CAAC,GAAG,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,IAAI,IAAI,UAAU,IAAI,CAAC,IAAI,EAAE,CAAC;QAChC,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,IAAI,IAAI,UAAU,IAAI,CAAC,QAAQ,EAAE,CAAC;QACpC,CAAC;QACD,IAAI,IAAI,GAAG,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,YAAmB,MAAyB;QAgB3B,QAAG,GAAW,aAAa,CAAC,YAAY,EAAE,CAAC;QAf1D,MAAM,eAAe,GAAc,MAAM,IAAI,EAAE,CAAC;QAChD,IAAI,CAAC,YAAY,GAAG,eAAe,EAAE,WAAW,IAAI,KAAK,CAAC;QAC1D,IAAI,CAAC,QAAQ,GAAG,eAAe,EAAE,OAAO,IAAI,IAAI,CAAC;QACjD,IAAI,CAAC,KAAK,GAAG,eAAe,EAAE,IAAI,IAAI,EAAE,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,eAAe,EAAE,QAAQ,IAAI,EAAE,CAAC;QACjD,IAAI,CAAC,OAAO,GAAG,eAAe,EAAE,IAAI,IAAI,CAAC,CAAC,SAAkB,EAAgC,EAAE,CAAC,IAAI,CAAC,CAAC;IACvG,CAAC;IAEO,kBAAkB;QACxB,kEAAkE;QAClE,MAAM,IAAI,qCAAiB,CAAC,kCAAkC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACrF,CAAC;;AAvGH,sCAiHC;AARgB,0BAAY,GAAW,CAAC,AAAZ,CAAa"}

package/api/BindStrategy.d.ts

@@ -41,5 +41,5 @@ export declare function resolveBindStrategy(bindStrategy: OptionalType<BindStrat
  * @param instance the value to check
  * @returns true if value is a BindStrategy or null/undefined
  */
-export declare function isBindStrategy(instance: unknown): instance is OptionalType<BindStrategy>;
+export declare function guard(instance: unknown): instance is OptionalType<BindStrategy>;
 //# sourceMappingURL=BindStrategy.d.ts.map

package/api/BindStrategy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BindStrategy.d.ts","sourceRoot":"","sources":["../../src/api/BindStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAE/E;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY;AACpB;;EAEE;AACF,QAAQ;AACR;;EAEE;AACF,cAAc;AACd;;EAEE;AACF,YAAY,CAAC;AAEjB;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAA2B,CAAA;AAE/D;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;AAE1D;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,YAAY,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC,YAAY,CAAC,CAExG;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,YAAY,CAAC,YAAY,CAAC,CAWxF"}
+{"version":3,"file":"BindStrategy.d.ts","sourceRoot":"","sources":["../../src/api/BindStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAE/E;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY;AACpB;;EAEE;AACF,QAAQ;AACR;;EAEE;AACF,cAAc;AACd;;EAEE;AACF,YAAY,CAAC;AAEjB;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAA2B,CAAA;AAE/D;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;AAE1D;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,YAAY,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC,YAAY,CAAC,CAExG;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,YAAY,CAAC,YAAY,CAAC,CAW/E"}

package/api/BindStrategy.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DEFAULT_BIND_STRATEGY = void 0;
 exports.resolveBindStrategy = resolveBindStrategy;
-exports.isBindStrategy = isBindStrategy;
+exports.guard = guard;
 /**
  * The default binding strategy
  */
@@ -21,7 +21,7 @@ function resolveBindStrategy(bindStrategy) {
  * @param instance the value to check
  * @returns true if value is a BindStrategy or null/undefined
  */
-function isBindStrategy(instance) {
+function guard(instance) {
     switch (instance) {
         case undefined:
         case null:

package/api/BindStrategy.js.map

@@ -1 +1 @@
-{"version":3,"file":"BindStrategy.js","sourceRoot":"","sources":["../../src/api/BindStrategy.ts"],"names":[],"mappings":";;;AAyCA,kDAEC;AAOD,wCAWC;AApCD;;GAEG;AACU,QAAA,qBAAqB,GAAiB,YAAY,CAAA;AAO/D;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,YAAwC;IACxE,OAAO,YAAY,IAAI,6BAAqB,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,SAAgB,cAAc,CAAC,QAAiB;IAC5C,QAAQ,QAAQ,EAAE,CAAC;QACf,KAAK,SAAS,CAAC;QACf,KAAK,IAAI,CAAC;QACV,KAAK,QAAQ,CAAC;QACd,KAAK,cAAc,CAAC;QACpB,KAAK,YAAY;YACb,OAAO,IAAI,CAAC;QAChB;YACI,OAAO,KAAK,CAAC;IACrB,CAAC;AACL,CAAC"}
+{"version":3,"file":"BindStrategy.js","sourceRoot":"","sources":["../../src/api/BindStrategy.ts"],"names":[],"mappings":";;;AAyCA,kDAEC;AAOD,sBAWC;AApCD;;GAEG;AACU,QAAA,qBAAqB,GAAiB,YAAY,CAAA;AAO/D;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,YAAwC;IACxE,OAAO,YAAY,IAAI,6BAAqB,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,SAAgB,KAAK,CAAC,QAAiB;IACnC,QAAQ,QAAQ,EAAE,CAAC;QACf,KAAK,SAAS,CAAC;QACf,KAAK,IAAI,CAAC;QACV,KAAK,QAAQ,CAAC;QACd,KAAK,cAAc,CAAC;QACpB,KAAK,YAAY;YACb,OAAO,IAAI,CAAC;QAChB;YACI,OAAO,KAAK,CAAC;IACrB,CAAC;AACL,CAAC"}

package/api/Contract.d.ts

@@ -1,24 +1,16 @@
-import { OptionalType } from "@jonloucks/contracts-ts/api/Types";
+import { OptionalType, RequiredType } from "@jonloucks/contracts-ts/api/Types";
 /**
  * Configuration for a Contract
  *
  * @param <T> The Contract deliverable type
  */
 export interface Config<T> {
-    /**
-     * Ensure an instance is of type T (or descendant)
-     *
-     * @param instance the value to cast to type T
-     * @return the value, null is allowed
-     * @throws ClassCastException when type of instance is not correct
-     */
-    cast?: (instance: unknown) => OptionalType<T>;
     /**
      * the predefine test to check if instance is of type T
      * @param instance the instance to check
-     * @returns
+     * @returns true if the instance is of type T, false otherwise
      */
-    test?: (instance: unknown) => instance is OptionalType<T>;
+    test?: (instance: unknown) => instance is RequiredType<T>;
     /**
      * User defined name for this contract.
      * Note: Do not rely on this being a java class name
@@ -45,6 +37,11 @@ export interface Config<T> {
      * and must comply with RatifiedContract rules.
      */
     ratified?: boolean;
+    /**
+     * When guarded is true the Contract throws exception if deliverable is null or undefined
+     * The default is true.
+     */
+    guarded?: boolean;
 }
 /**
  * A Contract defines a deliverable type by name and type.
@@ -58,7 +55,7 @@ export interface Contract<T> {
     *
     * @param value the value to cast
     * @return the checked value. Note: null is possible. The Promisor is allowed to return null
-    * @throws ClassCastException iif the value can't be cast to the return type.
+    * @throws ContractException if the value can't be cast to the return type.
     */
     cast(value: OptionalType<unknown>): OptionalType<T>;
     /**
@@ -79,5 +76,17 @@ export interface Contract<T> {
      * @return true if replaceable
      */
     get replaceable(): boolean;
+    /**
+     * When guarded is true the Contract throws exception if deliverable is null or undefined
+     * The default is true.
+     */
+    get guarded(): boolean;
 }
+/**
+ * Duck-typing check for Contract interface.
+ *
+ * @param instance the instance to check
+ * @returns true if the instance implements Contract, false otherwise
+ */
+export declare function guard<T>(instance: unknown): instance is RequiredType<Contract<T>>;
 //# sourceMappingURL=Contract.d.ts.map

package/api/Contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Contract.d.ts","sourceRoot":"","sources":["../../src/api/Contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEjE;;;;GAIG;AACH,MAAM,WAAW,MAAM,CAAC,CAAC;IAEvB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,YAAY,CAAC,CAAC,CAAC,CAAC;IAE9C;;;;OAIG;IACH,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,QAAQ,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;IAE1D;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC;IAEzB;;;;;;;MAOE;IACF,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAEpD;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAAC;IAEnB;;;;;OAKG;IACH,IAAI,QAAQ,IAAI,MAAM,CAAC;IAEvB;;;;;OAKG;IACH,IAAI,WAAW,IAAI,OAAO,CAAC;CAC5B"}
+{"version":3,"file":"Contract.d.ts","sourceRoot":"","sources":["../../src/api/Contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,YAAY,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAE/F;;;;GAIG;AACH,MAAM,WAAW,MAAM,CAAC,CAAC;IAEvB;;;;OAIG;IACH,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,QAAQ,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;IAE1D;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC;IAEzB;;;;;;;MAOE;IACF,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAEpD;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAAC;IAEnB;;;;;OAKG;IACH,IAAI,QAAQ,IAAI,MAAM,CAAC;IAEvB;;;;;OAKG;IACH,IAAI,WAAW,IAAI,OAAO,CAAC;IAE3B;;;OAGG;IACH,IAAI,OAAO,IAAI,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAEjF"}

package/api/Contract.js

@@ -1,3 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.guard = guard;
+const Types_1 = require("@jonloucks/contracts-ts/api/Types");
+/**
+ * Duck-typing check for Contract interface.
+ *
+ * @param instance the instance to check
+ * @returns true if the instance implements Contract, false otherwise
+ */
+function guard(instance) {
+    return (0, Types_1.guardFunctions)(instance, 'cast', 'name', 'typeName', 'replaceable');
+}
 //# sourceMappingURL=Contract.js.map

package/api/Contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"Contract.js","sourceRoot":"","sources":["../../src/api/Contract.ts"],"names":[],"mappings":""}
+{"version":3,"file":"Contract.js","sourceRoot":"","sources":["../../src/api/Contract.ts"],"names":[],"mappings":";;AAwGA,sBAEC;AA1GD,6DAA+F;AAkG/F;;;;;GAKG;AACH,SAAgB,KAAK,CAAI,QAAiB;IACxC,OAAO,IAAA,sBAAc,EAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;AAC7E,CAAC"}

package/api/ContractException.d.ts

@@ -17,4 +17,11 @@ export declare class ContractException extends Error {
      */
     static rethrow(caught: unknown, message?: string): never;
 }
+/**
+ * Type guard for ContractException
+ *
+ * @param value the value to check
+ * @return true if value is ContractException, false otherwise
+ */
+export declare function guard(value: unknown): value is ContractException;
 //# sourceMappingURL=ContractException.d.ts.map

package/api/ContractException.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContractException.d.ts","sourceRoot":"","sources":["../../src/api/ContractException.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAE1C;;;;;OAKG;gBACgB,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,KAAK,GAAG,IAAW;IAQhE;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK;CASzD"}
+{"version":3,"file":"ContractException.d.ts","sourceRoot":"","sources":["../../src/api/ContractException.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAE1C;;;;;OAKG;gBACgB,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,KAAK,GAAG,IAAW;IAQhE;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK;CASzD;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAEhE"}

package/api/ContractException.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ContractException = void 0;
+exports.guard = guard;
 const Checks_1 = require("@jonloucks/contracts-ts/auxiliary/Checks");
 /**
  * Runtime exception thrown for Contract related problems.
@@ -25,7 +26,7 @@ class ContractException extends Error {
      * @param message the optional message to use if caught is not an ContractException
      */
     static rethrow(caught, message) {
-        if (caught instanceof ContractException) {
+        if (guard(caught)) {
             throw caught;
         }
         else if (caught instanceof Error) {
@@ -37,4 +38,13 @@ class ContractException extends Error {
     }
 }
 exports.ContractException = ContractException;
+/**
+ * Type guard for ContractException
+ *
+ * @param value the value to check
+ * @return true if value is ContractException, false otherwise
+ */
+function guard(value) {
+    return value instanceof ContractException;
+}
 //# sourceMappingURL=ContractException.js.map

package/api/ContractException.js.map

@@ -1 +1 @@
-{"version":3,"file":"ContractException.js","sourceRoot":"","sources":["../../src/api/ContractException.ts"],"names":[],"mappings":";;;AAAA,qEAAwE;AAExE;;;GAGG;AACH,MAAa,iBAAkB,SAAQ,KAAK;IAE1C;;;;;OAKG;IACH,YAAmB,OAAe,EAAE,UAAwB,IAAI;QAC9D,qDAAqD;QACrD,KAAK,CAAC,IAAA,qBAAY,EAAC,OAAO,CAAC,CAAC,CAAC;QAE7B,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAA;IAC1D,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,MAAe,EAAE,OAAgB;QAC9C,IAAI,MAAM,YAAY,iBAAiB,EAAE,CAAC;YACxC,MAAM,MAAM,CAAC;QACf,CAAC;aAAM,IAAI,MAAM,YAAY,KAAK,EAAE,CAAC;YACnC,MAAM,IAAI,iBAAiB,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,iBAAiB,CAAC,OAAO,IAAI,+BAA+B,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;CACF;AA9BD,8CA8BC"}
+{"version":3,"file":"ContractException.js","sourceRoot":"","sources":["../../src/api/ContractException.ts"],"names":[],"mappings":";;;AA4CA,sBAEC;AA9CD,qEAAwE;AAExE;;;GAGG;AACH,MAAa,iBAAkB,SAAQ,KAAK;IAE1C;;;;;OAKG;IACH,YAAmB,OAAe,EAAE,UAAwB,IAAI;QAC9D,qDAAqD;QACrD,KAAK,CAAC,IAAA,qBAAY,EAAC,OAAO,CAAC,CAAC,CAAC;QAE7B,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAA;IAC1D,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,MAAe,EAAE,OAAgB;QAC9C,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAClB,MAAM,MAAM,CAAC;QACf,CAAC;aAAM,IAAI,MAAM,YAAY,KAAK,EAAE,CAAC;YACnC,MAAM,IAAI,iBAAiB,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,iBAAiB,CAAC,OAAO,IAAI,+BAA+B,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;CACF;AA9BD,8CA8BC;AAED;;;;;GAKG;AACH,SAAgB,KAAK,CAAC,KAAc;IAClC,OAAO,KAAK,YAAY,iBAAiB,CAAC;AAC5C,CAAC"}

package/api/ContractFactory.d.ts

@@ -13,6 +13,13 @@ export interface ContractFactory {
      * @param config the Contract configuration
      * @return the new Contract
      */
-    create<T>(config?: OptionalType<Config<T>>): RequiredType<Contract<T>>;
+    createContract<T>(config?: OptionalType<Config<T>>): RequiredType<Contract<T>>;
 }
+/**
+ * Type guard for ContractFactory
+ *
+ * @param value the value to check
+ * @return true if value is ContractFactory, false otherwise
+ */
+export declare function guard(value: unknown): value is RequiredType<ContractFactory>;
 //# sourceMappingURL=ContractFactory.d.ts.map

package/api/ContractFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContractFactory.d.ts","sourceRoot":"","sources":["../../src/api/ContractFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAE/E;;;GAGG;AACH,MAAM,WAAW,eAAe;IAE9B;;;;;;;OAOG;IACH,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;CACxE"}
+{"version":3,"file":"ContractFactory.d.ts","sourceRoot":"","sources":["../../src/api/ContractFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,EAAkB,YAAY,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAE/F;;;GAGG;AACH,MAAM,WAAW,eAAe;IAE9B;;;;;;;OAOG;IACH,cAAc,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;CAChF;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAAC,eAAe,CAAC,CAE5E"}

package/api/ContractFactory.js

@@ -1,3 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.guard = guard;
+const Types_1 = require("@jonloucks/contracts-ts/api/Types");
+/**
+ * Type guard for ContractFactory
+ *
+ * @param value the value to check
+ * @return true if value is ContractFactory, false otherwise
+ */
+function guard(value) {
+    return (0, Types_1.guardFunctions)(value, 'createContract');
+}
 //# sourceMappingURL=ContractFactory.js.map