@jonloucks/contracts-ts 0.4.0 → 1.0.0

package/index.js

@@ -1,13 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONTRACTS = exports.createContractsFactory = exports.createContracts = exports.createContractFactory = exports.createContract = exports.VERSION = exports.isString = exports.isPresent = exports.isNumber = exports.isNotPresent = exports.hasFunctions = exports.REPOSITORY_FACTORY = exports.PROMISOR_FACTORY = exports.typeToPromisor = exports.ContractException = exports.DEFAULT_BIND_STRATEGY = exports.validateContracts = exports.AUTO_CLOSE_FACTORY = exports.typeToAutoClose = void 0;
+exports.CONTRACTS = exports.VERSION = exports.createContractsFactory = exports.createContracts = exports.createContractFactory = exports.createContract = exports.validateContracts = exports.isString = exports.isPresent = exports.isNumber = exports.isNotPresent = exports.hasFunctions = exports.REPOSITORY_FACTORY = exports.PROMISOR_FACTORY = exports.typeToPromisor = exports.ContractException = exports.DEFAULT_BIND_STRATEGY = exports.AUTO_CLOSE_FACTORY = exports.typeToAutoClose = void 0;
 const Validate_1 = require("@jonloucks/contracts-ts/auxiliary/Validate");
+const ContractsFactory_impl_1 = require("./impl/ContractsFactory.impl");
 var AutoClose_1 = require("@jonloucks/contracts-ts/api/AutoClose");
 Object.defineProperty(exports, "typeToAutoClose", { enumerable: true, get: function () { return AutoClose_1.typeToAutoClose; } });
 var AutoCloseFactory_1 = require("@jonloucks/contracts-ts/api/AutoCloseFactory");
 Object.defineProperty(exports, "AUTO_CLOSE_FACTORY", { enumerable: true, get: function () { return AutoCloseFactory_1.CONTRACT; } });
-var Validate_2 = require("@jonloucks/contracts-ts/auxiliary/Validate");
-Object.defineProperty(exports, "validateContracts", { enumerable: true, get: function () { return Validate_2.validateContracts; } });
 var BindStrategy_1 = require("@jonloucks/contracts-ts/api/BindStrategy");
 Object.defineProperty(exports, "DEFAULT_BIND_STRATEGY", { enumerable: true, get: function () { return BindStrategy_1.DEFAULT_BIND_STRATEGY; } });
 var ContractException_1 = require("@jonloucks/contracts-ts/api/ContractException");
@@ -19,21 +18,22 @@ Object.defineProperty(exports, "PROMISOR_FACTORY", { enumerable: true, get: func
 var RepositoryFactory_1 = require("@jonloucks/contracts-ts/api/RepositoryFactory");
 Object.defineProperty(exports, "REPOSITORY_FACTORY", { enumerable: true, get: function () { return RepositoryFactory_1.CONTRACT; } });
 var Types_1 = require("@jonloucks/contracts-ts/api/Types");
-Object.defineProperty(exports, "hasFunctions", { enumerable: true, get: function () { return Types_1.hasFunctions; } });
+Object.defineProperty(exports, "hasFunctions", { enumerable: true, get: function () { return Types_1.guardFunctions; } });
 Object.defineProperty(exports, "isNotPresent", { enumerable: true, get: function () { return Types_1.isNotPresent; } });
 Object.defineProperty(exports, "isNumber", { enumerable: true, get: function () { return Types_1.isNumber; } });
 Object.defineProperty(exports, "isPresent", { enumerable: true, get: function () { return Types_1.isPresent; } });
 Object.defineProperty(exports, "isString", { enumerable: true, get: function () { return Types_1.isString; } });
+var Validate_2 = require("@jonloucks/contracts-ts/auxiliary/Validate");
+Object.defineProperty(exports, "validateContracts", { enumerable: true, get: function () { return Validate_2.validateContracts; } });
 //  no qualified paths for things not exposed publicly
-var version_1 = require("./version");
-Object.defineProperty(exports, "VERSION", { enumerable: true, get: function () { return version_1.VERSION; } });
-const ContractsFactory_impl_1 = require("./impl/ContractsFactory.impl");
 var ContractFactory_impl_1 = require("./impl/ContractFactory.impl");
 Object.defineProperty(exports, "createContract", { enumerable: true, get: function () { return ContractFactory_impl_1.createContract; } });
 Object.defineProperty(exports, "createContractFactory", { enumerable: true, get: function () { return ContractFactory_impl_1.create; } });
 var ContractsFactory_impl_2 = require("./impl/ContractsFactory.impl");
 Object.defineProperty(exports, "createContracts", { enumerable: true, get: function () { return ContractsFactory_impl_2.createContracts; } });
 Object.defineProperty(exports, "createContractsFactory", { enumerable: true, get: function () { return ContractsFactory_impl_2.create; } });
+var version_1 = require("./version");
+Object.defineProperty(exports, "VERSION", { enumerable: true, get: function () { return version_1.VERSION; } });
 /**
  * A shared global Contracts instance.
  *

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,yEAA+E;AAG/E,mEAA+H;AAA/D,4GAAA,eAAe,OAAA;AAC/E,iFAAgH;AAAvG,sHAAA,QAAQ,OAAsB;AAEvC,uEAA+E;AAAtE,6GAAA,iBAAiB,OAAA;AAC1B,yEAA+F;AAAxE,qHAAA,qBAAqB,OAAA;AAE5C,mFAAkF;AAAzE,sHAAA,iBAAiB,OAAA;AAG1B,iEAAgF;AAA7D,0GAAA,cAAc,OAAA;AACjC,+EAA4G;AAAnG,mHAAA,QAAQ,OAAoB;AAErC,mFAAkH;AAAzG,uHAAA,QAAQ,OAAsB;AACvC,2DAA0I;AAAjI,qGAAA,YAAY,OAAA;AAAE,qGAAA,YAAY,OAAA;AAAE,iGAAA,QAAQ,OAAA;AAAE,kGAAA,SAAS,OAAA;AAAE,iGAAA,QAAQ,OAAA;AAElE,sDAAsD;AACtD,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,wEAA+D;AAC/D,oEAA8F;AAArF,sHAAA,cAAc,OAAA;AAAE,6HAAA,MAAM,OAAyB;AACxD,sEAAiG;AAAxF,wHAAA,eAAe,OAAA;AAAE,+HAAA,MAAM,OAA0B;AAE1D;;;;;;;;GAQG;AACU,QAAA,SAAS,GAAe,CAAC,GAAe,EAAE;IACnD,MAAM,YAAY,GAAqB;QACrC,QAAQ,EAAE,IAAI;QACd,cAAc,EAAE,CAAC,MAAM,CAAC;KACzB,CAAC;IACF,MAAM,SAAS,GAAG,IAAA,uCAAe,EAAC,YAAY,CAAC,CAAC;IAChD,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,iBAAiB;IACnC,IAAA,4BAAiB,EAAC,SAAS,CAAC,CAAC;IAC7B,OAAO,SAAS,CAAC;AACrB,CAAC,CAAC,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,yEAA+E;AAC/E,wEAA+D;AAE/D,mEAA+H;AAA/D,4GAAA,eAAe,OAAA;AAC/E,iFAAgH;AAAvG,sHAAA,QAAQ,OAAsB;AAEvC,yEAA+F;AAAxE,qHAAA,qBAAqB,OAAA;AAE5C,mFAAkF;AAAzE,sHAAA,iBAAiB,OAAA;AAG1B,iEAAgF;AAA7D,0GAAA,cAAc,OAAA;AACjC,+EAA4G;AAAnG,mHAAA,QAAQ,OAAoB;AAErC,mFAAkH;AAAzG,uHAAA,QAAQ,OAAsB;AACvC,2DAA4J;AAAnJ,qGAAA,cAAc,OAAgB;AAAE,qGAAA,YAAY,OAAA;AAAE,iGAAA,QAAQ,OAAA;AAAE,kGAAA,SAAS,OAAA;AAAE,iGAAA,QAAQ,OAAA;AACpF,uEAA+E;AAAtE,6GAAA,iBAAiB,OAAA;AAE1B,sDAAsD;AACtD,oEAA8F;AAArF,sHAAA,cAAc,OAAA;AAAE,6HAAA,MAAM,OAAyB;AACxD,sEAAiG;AAAxF,wHAAA,eAAe,OAAA;AAAE,+HAAA,MAAM,OAA0B;AAC1D,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAEhB;;;;;;;;GAQG;AACU,QAAA,SAAS,GAAe,CAAC,GAAe,EAAE;IACnD,MAAM,YAAY,GAAqB;QACrC,QAAQ,EAAE,IAAI;QACd,cAAc,EAAE,CAAC,MAAM,CAAC;KACzB,CAAC;IACF,MAAM,SAAS,GAAG,IAAA,uCAAe,EAAC,YAAY,CAAC,CAAC;IAChD,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,iBAAiB;IACnC,IAAA,4BAAiB,EAAC,SAAS,CAAC,CAAC;IAC7B,OAAO,SAAS,CAAC;AACrB,CAAC,CAAC,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jonloucks/contracts-ts",
-  "version": "0.4.0",
+  "version": "1.0.0",
   "description": "Typescript Dependency Contracts for dependency inversion",
   "main": "index.js",
   "types": "index.d.ts",
@@ -65,11 +65,12 @@
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",
-    "@types/node": "^25.0.3",
+    "@types/node": "^25.0.10",
     "@typescript-eslint/eslint-plugin": "^8.51.0",
     "@typescript-eslint/parser": "^8.53.1",
     "eslint": "^9.39.2",
     "jest": "^30.2.0",
+    "jest-mock-extended": "^4.0.0",
     "ts-jest": "^29.4.6",
     "typedoc": "^0.28.15",
     "typescript": "^5.9.3"

package/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO,EAAE,MASlB,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,OAAO,EAAE,MAalB,CAAC"}

package/version.js

@@ -3,15 +3,21 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
 const fs_1 = require("fs");
 const path_1 = require("path");
+const DEVELOPMENT_PATH = (0, path_1.join)(__dirname, "..", "package.json");
+const PRODUCTION_PATH = (0, path_1.resolve)(__dirname, 'package.json');
 exports.VERSION = (() => {
-    try {
-        const packageJsonPath = (0, path_1.resolve)(__dirname, 'package.json');
-        const parsedJson = JSON.parse((0, fs_1.readFileSync)(packageJsonPath, 'utf8'));
-        const { version } = parsedJson;
-        return version ?? "unknown";
-    }
-    catch (_error) {
-        return "unknown";
+    for (const path of [PRODUCTION_PATH, DEVELOPMENT_PATH]) {
+        try {
+            const parsedJson = JSON.parse((0, fs_1.readFileSync)(path, 'utf8'));
+            const { version } = parsedJson;
+            if (version !== undefined && version !== null) {
+                return version;
+            }
+        }
+        catch (_error) {
+            // continue to next path
+        }
     }
+    return "unknown";
 })();
 //# sourceMappingURL=version.js.map

package/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":";;;AAAA,2BAAkC;AAClC,+BAA+B;AAElB,QAAA,OAAO,GAAW,CAAC,GAAW,EAAE;IAC3C,IAAI,CAAC;QACH,MAAM,eAAe,GAAG,IAAA,cAAO,EAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAC3D,MAAM,UAAU,GAAa,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/E,MAAM,EAAE,OAAO,EAAE,GAAG,UAAkC,CAAC;QACvD,OAAO,OAAO,IAAI,SAAS,CAAC;IAC9B,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC,CAAC,EAAE,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":";;;AAAA,2BAAkC;AAClC,+BAAqC;AAErC,MAAM,gBAAgB,GAAW,IAAA,WAAI,EAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;AACvE,MAAM,eAAe,GAAW,IAAA,cAAO,EAAC,SAAS,EAAE,cAAc,CAAC,CAAC;AAEtD,QAAA,OAAO,GAAW,CAAC,GAAW,EAAE;IAC3C,KAAK,MAAM,IAAI,IAAI,CAAC,eAAe,EAAE,gBAAgB,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,MAAM,UAAU,GAAY,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;YACnE,MAAM,EAAE,OAAO,EAAE,GAAG,UAAkC,CAAC;YACvD,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBAC9C,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,wBAAwB;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC,EAAE,CAAC"}

package/api/Lawyer.d.ts

@@ -1,19 +0,0 @@
-import { Contract, Config as ContractConfig } from "@jonloucks/contracts-ts/api/Contract";
-import { OptionalType } from "@jonloucks/contracts-ts/api/Types";
-/**
- * Responsibility: A Lawyer creates Contracts for a specific type T, including duck-typing checks.
- */
-export interface Lawyer<T> {
-    /**
-     * Create a Contract for this Lawyer's deliverable type.
-     * @param config
-     */
-    createContract<X extends T>(config?: ContractConfig<X>): Contract<X>;
-    /**
-     * Duck-typing check
-     *
-     * @param instance
-     */
-    isDeliverable<X extends T>(instance: unknown): instance is OptionalType<X>;
-}
-//# sourceMappingURL=Lawyer.d.ts.map

package/api/Lawyer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Lawyer.d.ts","sourceRoot":"","sources":["../../src/api/Lawyer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,MAAM,CAAC,CAAC;IAEvB;;;OAGG;IACH,cAAc,CAAC,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAErE;;;;OAIG;IACH,aAAa,CAAC,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;CAC5E"}

package/api/Lawyer.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=Lawyer.js.map

package/api/Lawyer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Lawyer.js","sourceRoot":"","sources":["../../src/api/Lawyer.ts"],"names":[],"mappings":""}

package/auxiliary/ClassCastException.d.ts

@@ -1,8 +0,0 @@
-/**
- * Exception thrown when a class cast fails.
- * Note: This can not extend ContractException due to circular dependency.
- */
-export declare class ClassCastException extends Error {
-    constructor(message: string, _thrown?: Error | null);
-}
-//# sourceMappingURL=ClassCastException.d.ts.map

package/auxiliary/ClassCastException.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ClassCastException.d.ts","sourceRoot":"","sources":["../../src/auxiliary/ClassCastException.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,KAAK,GAAG,IAAW;CAO5D"}

package/auxiliary/ClassCastException.js

@@ -1,18 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ClassCastException = void 0;
-const Checks_1 = require("@jonloucks/contracts-ts/auxiliary/Checks");
-/**
- * Exception thrown when a class cast fails.
- * Note: This can not extend ContractException due to circular dependency.
- */
-class ClassCastException extends Error {
-    constructor(message, _thrown = null) {
-        // super(messageCheck(message), thrown || undefined);
-        super((0, Checks_1.messageCheck)(message));
-        this.name = "ClassCastException";
-        Object.setPrototypeOf(this, ClassCastException.prototype);
-    }
-}
-exports.ClassCastException = ClassCastException;
-//# sourceMappingURL=ClassCastException.js.map

package/auxiliary/ClassCastException.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ClassCastException.js","sourceRoot":"","sources":["../../src/auxiliary/ClassCastException.ts"],"names":[],"mappings":";;;AAAA,qEAAwE;AAExE;;;GAGG;AACH,MAAa,kBAAmB,SAAQ,KAAK;IACzC,YAAY,OAAe,EAAE,UAAwB,IAAI;QACrD,qDAAqD;QACrD,KAAK,CAAC,IAAA,qBAAY,EAAC,OAAO,CAAC,CAAC,CAAC;QAE7B,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAA;IAC7D,CAAC;CACJ;AARD,gDAQC"}