@jonloucks/contracts-ts 1.2.2 → 1.3.0

package/api/Types.d.ts

@@ -9,6 +9,10 @@ export type OptionalType<T> = T | null | undefined;
  * Type that is guaranteed to be non-null and non-undefined
  */
 export type RequiredType<T> = NonNullable<T>;
+/**
+ * Type that can be undefined or a value of type T
+ */
+export type UndefinedType<T> = T | undefined;
 /**
  * A function of unknown signature
  */
@@ -21,10 +25,12 @@ export interface Transform<I, O> {
 }
 /**
  * A function that transforms type I to type O
+ * @deprecated use @jonloucks/contracts-ts/auxiliary/Functional instead
  */
 export type TransformFunction<I, O> = (input: I) => O;
 /**
  * A transformation type that can be a Transform or a function from type I to type O
+ * @deprecated use @jonloucks/contracts-ts/auxiliary/Functional instead
  */
 export type TransformType<I, O> = Transform<I, O> | TransformFunction<I, O>;
 /**
@@ -106,12 +112,22 @@ export declare function isConstructor<T>(value: unknown): value is RequiredType<
  * @param propertyNames the property names to check
  * @returns true if property is defined
  */
-export declare function guardFunctions(value: unknown, ...propertyNames: (string | symbol)[]): value is RequiredType<UnknownFunction>;
+export declare function guardFunctions<T>(value: unknown, ...propertyNames: (string | symbol)[]): value is RequiredType<T & object>;
+/**
+ * Check if given value has a function defined for the given property name
+ * Note: if the value is present is required to have the function defined
+ *
+ * @param value the value to check
+ * @param propertyName the property name to check
+ * @returns true if property is defined as a function or getter/setter, false otherwise
+ */
+export declare function hasFunction<T>(value: unknown, propertyName: string | symbol): value is RequiredType<T & object>;
 /**
  * Convert a TransformType to a Transform
  *
  * @param transform the TransformType to convert
  * @returns the Transform
+ * @deprecated use @jonloucks/contracts-ts/auxiliary/Functional instead
  */
 export declare function typeToTransform<I, O>(transform: TransformType<I, O>): RequiredType<Transform<I, O>>;
 //# sourceMappingURL=Types.d.ts.map

package/api/Types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Types.d.ts","sourceRoot":"","sources":["../../src/api/Types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC,EAAE,CAAC;IAC7B,SAAS,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,EAAE,CAAC,IAAI,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAE5E;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAAC,CAAC,CAAC,CAErE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,GAAG,SAAS,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,eAAe,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAAC,CAAC,CAAC,CAE9F;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,eAAe,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,YAAY,CAAC,CAAC,CAAC,CAEtH;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAAC,MAAM,CAAC,CAEtE;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAAC,MAAM,CAAC,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAAC,MAAM,CAAC,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAAC,MAAM,CAAC,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAAC,OAAO,CAAC,CAExE;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAAC,MAAM,CAAC,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAErF;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,aAAa,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,KAAK,IAAI,YAAY,CAAC,eAAe,CAAC,CAgB5H;AAUD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CASnG"}
+{"version":3,"file":"Types.d.ts","sourceRoot":"","sources":["../../src/api/Types.ts"],"names":[],"mappings":"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"}

package/api/Types.js

@@ -15,6 +15,7 @@ exports.isBoolean = isBoolean;
 exports.isBigInt = isBigInt;
 exports.isConstructor = isConstructor;
 exports.guardFunctions = guardFunctions;
+exports.hasFunction = hasFunction;
 exports.typeToTransform = typeToTransform;
 const Checks_1 = require("@jonloucks/contracts-ts/auxiliary/Checks");
 const IllegalArgumentException_1 = require("@jonloucks/contracts-ts/auxiliary/IllegalArgumentException");
@@ -123,20 +124,54 @@ function guardFunctions(value, ...propertyNames) {
     if (isObject(value) === false) {
         return false;
     }
-    const record = value;
     for (const propertyName of propertyNames) {
-        if (propertyName in value === false) {
-            return false;
-        }
-        if (isFunction(record[propertyName]) === false) {
+        if (hasFunction(value, propertyName) === false) {
             return false;
         }
     }
     return true;
 }
+/**
+ * Check if given value has a function defined for the given property name
+ * Note: if the value is present is required to have the function defined
+ *
+ * @param value the value to check
+ * @param propertyName the property name to check
+ * @returns true if property is defined as a function or getter/setter, false otherwise
+ */
+function hasFunction(value, propertyName) {
+    const descriptor = getPropertyDescriptor(value, propertyName);
+    if (isNotPresent(descriptor)) {
+        return false;
+    }
+    if (isPresent(descriptor.get) || isPresent(descriptor.set)) {
+        return true; // getter/setter is ok
+    }
+    if (isFunction(descriptor.value)) {
+        return true; // function is ok
+    }
+    return false; // not a function or getter/setter
+}
+function getPropertyDescriptor(instance, name) {
+    let focus = instance;
+    while (isObject(focus)) {
+        const descriptor = Object.getOwnPropertyDescriptor(focus, name);
+        if (isPresent(descriptor)) {
+            return descriptor;
+        }
+        focus = Object.getPrototypeOf(focus);
+    }
+    return undefined;
+}
+/**
+ * @deprecated use @jonloucks/contracts-ts/auxiliary/Functional instead
+ */
 function guardTransform(transform) {
     return guardFunctions(transform, 'transform');
 }
+/**
+ * @deprecated use @jonloucks/contracts-ts/auxiliary/Functional instead
+ */
 function guardTransformFunction(transform) {
     return isFunctionWithArity(transform, 1);
 }
@@ -145,6 +180,7 @@ function guardTransformFunction(transform) {
  *
  * @param transform the TransformType to convert
  * @returns the Transform
+ * @deprecated use @jonloucks/contracts-ts/auxiliary/Functional instead
  */
 function typeToTransform(transform) {
     const validTransformType = (0, Checks_1.presentCheck)(transform, "TransformType must be present.");

package/api/Types.js.map

@@ -1 +1 @@
-{"version":3,"file":"Types.js","sourceRoot":"","sources":["../../src/api/Types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Types.js","sourceRoot":"","sources":["../../src/api/Types.ts"],"names":[],"mappings":"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"}

package/auxiliary/Consumer.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Consumer.ts
+ * Candidate for inclusion in api-ts
+ * Defines a Consumer type that can consume values of type T.
+ */
+import { RequiredType } from "@jonloucks/contracts-ts/api/Types";
+/**
+ * A method that consumes a value of type T
+ */
+export type Method<T> = (value: T) => void;
+/**
+ * A Consumer that consumes values of type T
+ */
+export interface Consumer<T> {
+    consume(value: T): void;
+}
+/**
+ * A type that can be either a Method or a Consumer
+ */
+export type Type<T> = Method<T> | Consumer<T>;
+/**
+ * Duck type guard check for Consumer
+ *
+ * @param instance the instance to check
+ * @param <T> the type of value consumed
+ * @returns true if instance is a Consumer, false otherwise
+ */
+export declare function guard<T>(instance: unknown): instance is RequiredType<Consumer<T>>;
+/**
+ * Convert a Type to a Consumer
+ *
+ * @param type the type to convert
+ * @param <T> the type of value consumed
+ * @returns a Consumer that consumes values of type T
+ */
+export declare function fromType<T>(type: Type<T>): RequiredType<Consumer<T>>;
+/**
+ * Check that a Consumer is present
+ *
+ * @param consumer the consumer to check
+ * @return the consumer if present
+ * @throws IllegalArgumentException if the consumer is not present
+ */
+export declare function check<T>(consumer: Type<T>): Type<T>;
+//# sourceMappingURL=Consumer.d.ts.map

package/auxiliary/Consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Consumer.d.ts","sourceRoot":"","sources":["../../src/auxiliary/Consumer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAkB,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAGjF;;GAEG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC;IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;CAAE;AAEzD;;GAEG;AACH,MAAM,MAAM,IAAI,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;AAE9C;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAEjF;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAQpE;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAEnD"}

package/auxiliary/Consumer.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * Consumer.ts
+ * Candidate for inclusion in api-ts
+ * Defines a Consumer type that can consume values of type T.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.guard = guard;
+exports.fromType = fromType;
+exports.check = check;
+const Types_1 = require("@jonloucks/contracts-ts/api/Types");
+const Checks_1 = require("@jonloucks/contracts-ts/auxiliary/Checks");
+/**
+ * Duck type guard check for Consumer
+ *
+ * @param instance the instance to check
+ * @param <T> the type of value consumed
+ * @returns true if instance is a Consumer, false otherwise
+ */
+function guard(instance) {
+    return (0, Types_1.guardFunctions)(instance, 'consume');
+}
+/**
+ * Convert a Type to a Consumer
+ *
+ * @param type the type to convert
+ * @param <T> the type of value consumed
+ * @returns a Consumer that consumes values of type T
+ */
+function fromType(type) {
+    if (guard(type)) {
+        return type;
+    }
+    else {
+        return {
+            consume: type
+        };
+    }
+}
+/**
+ * Check that a Consumer is present
+ *
+ * @param consumer the consumer to check
+ * @return the consumer if present
+ * @throws IllegalArgumentException if the consumer is not present
+ */
+function check(consumer) {
+    return (0, Checks_1.presentCheck)(consumer, "Consumer must be present.");
+}
+//# sourceMappingURL=Consumer.js.map

package/auxiliary/Consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Consumer.js","sourceRoot":"","sources":["../../src/auxiliary/Consumer.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AA2BH,sBAEC;AASD,4BAQC;AASD,sBAEC;AAvDD,6DAAiF;AACjF,qEAAwE;AAiBxE;;;;;;GAMG;AACH,SAAgB,KAAK,CAAI,QAAiB;IACxC,OAAO,IAAA,sBAAc,EAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,QAAQ,CAAI,IAAa;IACvC,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;SAAM,CAAC;QACN,OAAO;YACL,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,KAAK,CAAI,QAAiB;IACxC,OAAO,IAAA,qBAAY,EAAC,QAAQ,EAAE,2BAA2B,CAAC,CAAC;AAC7D,CAAC"}

package/auxiliary/Functional.d.ts

@@ -0,0 +1,9 @@
+export type { Consumer, Method as ConsumerFunction, Type as ConsumerType } from "@jonloucks/contracts-ts/auxiliary/Consumer";
+export { guard as consumerGuard, fromType as consumerFromType, check as consumerCheck } from "@jonloucks/contracts-ts/auxiliary/Consumer";
+export type { Predicate, Method as PredicateFunction, Type as PredicateType } from "@jonloucks/contracts-ts/auxiliary/Predicate";
+export { guard as predicateGuard, fromType as predicateFromType, check as predicateCheck, toValue as predicateToValue } from "@jonloucks/contracts-ts/auxiliary/Predicate";
+export type { Supplier, Method as SupplierFunction, Type as SupplierType } from "@jonloucks/contracts-ts/auxiliary/Supplier";
+export { guard as supplierGuard, fromType as supplierFromType, check as supplierCheck, toValue as supplierToValue } from "@jonloucks/contracts-ts/auxiliary/Supplier";
+export type { Transform, Method as TransformFunction, Type as TransformType } from "@jonloucks/contracts-ts/auxiliary/Transform";
+export { guard as transformGuard, fromType as transformFromType, check as transformCheck, toValue as transformToValue } from "@jonloucks/contracts-ts/auxiliary/Transform";
+//# sourceMappingURL=Functional.d.ts.map

package/auxiliary/Functional.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Functional.d.ts","sourceRoot":"","sources":["../../src/auxiliary/Functional.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,QAAQ,EAAE,MAAM,IAAI,gBAAgB,EAAE,IAAI,IAAI,YAAY,EAAE,MACnE,4CAA4C,CAAC;AAEpD,OAAO,EAAE,KAAK,IAAI,aAAa,EAAE,QAAQ,IAAI,gBAAgB,EAAE,KAAK,IAAI,aAAa,EAAE,MAChF,4CAA4C,CAAC;AAEpD,YAAY,EAAE,SAAS,EAAE,MAAM,IAAI,iBAAiB,EAAE,IAAI,IAAI,aAAa,EAAE,MACtE,6CAA6C,CAAC;AAErD,OAAO,EAAE,KAAK,IAAI,cAAc,EAAE,QAAQ,IAAI,iBAAiB,EAAE,KAAK,IAAI,cAAc,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAChH,6CAA6C,CAAC;AAErD,YAAY,EAAE,QAAQ,EAAE,MAAM,IAAI,gBAAgB,EAAE,IAAI,IAAI,YAAY,EAAE,MACnE,4CAA4C,CAAC;AAEpD,OAAO,EAAE,KAAK,IAAI,aAAa,EAAE,QAAQ,IAAI,gBAAgB,EAAE,KAAK,IAAI,aAAa,EAAE,OAAO,IAAI,eAAe,EAAE,MAC5G,4CAA4C,CAAC;AAEpD,YAAY,EAAE,SAAS,EAAE,MAAM,IAAI,iBAAiB,EAAE,IAAI,IAAI,aAAa,EAAE,MACtE,6CAA6C,CAAC;AAErD,OAAO,EAAE,KAAK,IAAI,cAAc,EAAE,QAAQ,IAAI,iBAAiB,EAAE,KAAK,IAAI,cAAc,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAChH,6CAA6C,CAAC"}

package/auxiliary/Functional.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transformToValue = exports.transformCheck = exports.transformFromType = exports.transformGuard = exports.supplierToValue = exports.supplierCheck = exports.supplierFromType = exports.supplierGuard = exports.predicateToValue = exports.predicateCheck = exports.predicateFromType = exports.predicateGuard = exports.consumerCheck = exports.consumerFromType = exports.consumerGuard = void 0;
+var Consumer_1 = require("@jonloucks/contracts-ts/auxiliary/Consumer");
+Object.defineProperty(exports, "consumerGuard", { enumerable: true, get: function () { return Consumer_1.guard; } });
+Object.defineProperty(exports, "consumerFromType", { enumerable: true, get: function () { return Consumer_1.fromType; } });
+Object.defineProperty(exports, "consumerCheck", { enumerable: true, get: function () { return Consumer_1.check; } });
+var Predicate_1 = require("@jonloucks/contracts-ts/auxiliary/Predicate");
+Object.defineProperty(exports, "predicateGuard", { enumerable: true, get: function () { return Predicate_1.guard; } });
+Object.defineProperty(exports, "predicateFromType", { enumerable: true, get: function () { return Predicate_1.fromType; } });
+Object.defineProperty(exports, "predicateCheck", { enumerable: true, get: function () { return Predicate_1.check; } });
+Object.defineProperty(exports, "predicateToValue", { enumerable: true, get: function () { return Predicate_1.toValue; } });
+var Supplier_1 = require("@jonloucks/contracts-ts/auxiliary/Supplier");
+Object.defineProperty(exports, "supplierGuard", { enumerable: true, get: function () { return Supplier_1.guard; } });
+Object.defineProperty(exports, "supplierFromType", { enumerable: true, get: function () { return Supplier_1.fromType; } });
+Object.defineProperty(exports, "supplierCheck", { enumerable: true, get: function () { return Supplier_1.check; } });
+Object.defineProperty(exports, "supplierToValue", { enumerable: true, get: function () { return Supplier_1.toValue; } });
+var Transform_1 = require("@jonloucks/contracts-ts/auxiliary/Transform");
+Object.defineProperty(exports, "transformGuard", { enumerable: true, get: function () { return Transform_1.guard; } });
+Object.defineProperty(exports, "transformFromType", { enumerable: true, get: function () { return Transform_1.fromType; } });
+Object.defineProperty(exports, "transformCheck", { enumerable: true, get: function () { return Transform_1.check; } });
+Object.defineProperty(exports, "transformToValue", { enumerable: true, get: function () { return Transform_1.toValue; } });
+//# sourceMappingURL=Functional.js.map

package/auxiliary/Functional.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Functional.js","sourceRoot":"","sources":["../../src/auxiliary/Functional.ts"],"names":[],"mappings":";;;AAIA,uEACoD;AAD3C,yGAAA,KAAK,OAAiB;AAAE,4GAAA,QAAQ,OAAoB;AAAE,yGAAA,KAAK,OAAiB;AAMrF,yEACqD;AAD5C,2GAAA,KAAK,OAAkB;AAAE,8GAAA,QAAQ,OAAqB;AAAE,2GAAA,KAAK,OAAkB;AAAE,6GAAA,OAAO,OAAoB;AAMrH,uEACoD;AAD3C,yGAAA,KAAK,OAAiB;AAAE,4GAAA,QAAQ,OAAoB;AAAE,yGAAA,KAAK,OAAiB;AAAE,2GAAA,OAAO,OAAmB;AAMjH,yEACqD;AAD5C,2GAAA,KAAK,OAAkB;AAAE,8GAAA,QAAQ,OAAqB;AAAE,2GAAA,KAAK,OAAkB;AAAE,6GAAA,OAAO,OAAoB"}

package/auxiliary/Predicate.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Predicate.ts
+ *
+ * Defines a Predicate type that can test values of type T.
+ */
+import { OptionalType, RequiredType } from "@jonloucks/contracts-ts/api/Types";
+/**
+ * A method that tests a value of type T and returns a boolean
+ */
+export type Method<T> = (value: T) => boolean;
+/**
+ * A Predicate that tests values of type T
+ */
+export interface Predicate<T> {
+    test(value: T): boolean;
+}
+/**
+ * A type that can be a Method, Predicate, or a boolean
+ */
+export type Type<T> = Method<T> | Predicate<T> | boolean;
+/**
+ * Duck type guard check for Predicate
+ *
+ * @param instance the instance to check
+ * @param <T> the type of value tested
+ * @returns true if instance is a Predicate, false otherwise
+ */
+export declare function guard<T>(instance: unknown): instance is Predicate<T>;
+/**
+ * Convert a Type to a Predicate
+ *
+ * @param type the type to convert
+ * @param <T> the type of value tested
+ * @returns a Predicate that tests values of type T
+ */
+export declare function fromType<T>(type: Type<T>): Predicate<T>;
+/**
+ * Test a value against a Predicate Type
+ *
+ * @param type the Predicate Type
+ * @param value the value to test
+ * @param <T> the type of value tested
+ * @returns true if the value satisfies the Predicate, false otherwise
+ */
+export declare function toValue<T>(type: Type<T>, value: T): boolean;
+/**
+ * Check that a predicate is present
+ *
+ * @param predicate the predicate to check
+ * @return the predicate if present
+ * @throws IllegalArgumentException if the predicate is not present
+ */
+export declare function check<T>(predicate: OptionalType<Type<T>>): RequiredType<Type<T>>;
+//# sourceMappingURL=Predicate.d.ts.map

package/auxiliary/Predicate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Predicate.d.ts","sourceRoot":"","sources":["../../src/auxiliary/Predicate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAkB,YAAY,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAG/F;;GAEG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC;IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC;CAAE;AAE1D;;GAEG;AACH,MAAM,MAAM,IAAI,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;AAEzD;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,SAAS,CAAC,CAAC,CAAC,CAEpE;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAevD;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAQ3D;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,SAAS,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAEhF"}

package/auxiliary/Predicate.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * Predicate.ts
+ *
+ * Defines a Predicate type that can test values of type T.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.guard = guard;
+exports.fromType = fromType;
+exports.toValue = toValue;
+exports.check = check;
+const Types_1 = require("@jonloucks/contracts-ts/api/Types");
+const Checks_1 = require("@jonloucks/contracts-ts/auxiliary/Checks");
+/**
+ * Duck type guard check for Predicate
+ *
+ * @param instance the instance to check
+ * @param <T> the type of value tested
+ * @returns true if instance is a Predicate, false otherwise
+ */
+function guard(instance) {
+    return (0, Types_1.guardFunctions)(instance, 'test');
+}
+/**
+ * Convert a Type to a Predicate
+ *
+ * @param type the type to convert
+ * @param <T> the type of value tested
+ * @returns a Predicate that tests values of type T
+ */
+function fromType(type) {
+    if (guard(type)) {
+        return type;
+    }
+    else if (typeof type === 'boolean') {
+        return {
+            test: (value) => {
+                (0, Checks_1.used)(value);
+                return type;
+            }
+        };
+    }
+    else {
+        return {
+            test: type
+        };
+    }
+}
+/**
+ * Test a value against a Predicate Type
+ *
+ * @param type the Predicate Type
+ * @param value the value to test
+ * @param <T> the type of value tested
+ * @returns true if the value satisfies the Predicate, false otherwise
+ */
+function toValue(type, value) {
+    if (guard(type)) {
+        return type.test(value);
+    }
+    else if (typeof type === 'boolean') {
+        return type;
+    }
+    else {
+        return type(value);
+    }
+}
+/**
+ * Check that a predicate is present
+ *
+ * @param predicate the predicate to check
+ * @return the predicate if present
+ * @throws IllegalArgumentException if the predicate is not present
+ */
+function check(predicate) {
+    return (0, Checks_1.presentCheck)(predicate, "Predicate must be present.");
+}
+//# sourceMappingURL=Predicate.js.map

package/auxiliary/Predicate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Predicate.js","sourceRoot":"","sources":["../../src/auxiliary/Predicate.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AA2BH,sBAEC;AASD,4BAeC;AAUD,0BAQC;AASD,sBAEC;AAhFD,6DAA+F;AAC/F,qEAA8E;AAiB9E;;;;;;GAMG;AACH,SAAgB,KAAK,CAAI,QAAiB;IACxC,OAAO,IAAA,sBAAc,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,QAAQ,CAAI,IAAa;IACvC,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;SAAM,IAAI,OAAO,IAAI,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO;YACL,IAAI,EAAE,CAAC,KAAQ,EAAY,EAAE;gBAC3B,IAAA,aAAI,EAAC,KAAK,CAAC,CAAC;gBACZ,OAAO,IAAI,CAAC;YACd,CAAC;SACF,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,OAAO;YACL,IAAI,EAAE,IAAI;SACX,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,OAAO,CAAI,IAAa,EAAE,KAAQ;IAChD,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;SAAM,IAAI,OAAO,IAAI,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;SAAM,CAAC;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,KAAK,CAAI,SAAgC;IACvD,OAAO,IAAA,qBAAY,EAAC,SAAS,EAAE,4BAA4B,CAAC,CAAC;AAC/D,CAAC"}

package/auxiliary/Supplier.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Supplier.ts
+ * Defines a Supplier type that can supply values of type T.
+ */
+import { RequiredType } from "@jonloucks/contracts-ts/api/Types";
+/**
+ * A method that supplies a value of type T
+ */
+export type Method<T> = () => T;
+/**
+ * A Supplier that supplies values of type T
+ */
+export interface Supplier<T> {
+    supply(): T;
+}
+/**
+ * A type that can be a Method, Supplier, or a value of type T
+ */
+export type Type<T> = Method<T> | Supplier<T> | T;
+/**
+ * Duck type guard check for Supplier
+ *
+ * @param instance the instance to check
+ * @param <T> the type of value supplied
+ * @returns true if instance is a Supplier, false otherwise
+ */
+export declare function guard<T>(instance: unknown): instance is RequiredType<Supplier<T>>;
+/**
+ * Convert a Type to a Supplier
+ * @param type the type to convert
+ * @param <T> the type of value supplied
+ * @returns a Supplier that supplies values of type T
+ */
+export declare function fromType<T>(type: Type<T>): RequiredType<Supplier<T>>;
+/**
+ * Get the value from a Supplier Type
+ *
+ * @param type the Supplier Type
+ * @param <T> the type of value supplied
+ * @returns the value supplied by the Supplier Type
+ */
+export declare function toValue<T>(type: Type<T>): T;
+/**
+ * Check that a Supplier is present
+ *
+ * @param supplier the supplier to check
+ * @return the supplier if present
+ * @throws IllegalArgumentException if the supplier is not present
+ */
+export declare function check<T>(supplier: Type<T>): Type<T>;
+//# sourceMappingURL=Supplier.d.ts.map

package/auxiliary/Supplier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Supplier.d.ts","sourceRoot":"","sources":["../../src/auxiliary/Supplier.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAA8B,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAG7F;;GAEG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC;IAAI,MAAM,IAAI,CAAC,CAAC;CAAE;AAE7C;;GAEG;AACH,MAAM,MAAM,IAAI,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAElD;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAEjF;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAYpE;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAQ3C;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAEnD"}

package/auxiliary/Supplier.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * Supplier.ts
+ * Defines a Supplier type that can supply values of type T.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.guard = guard;
+exports.fromType = fromType;
+exports.toValue = toValue;
+exports.check = check;
+const Types_1 = require("@jonloucks/contracts-ts/api/Types");
+const Checks_1 = require("@jonloucks/contracts-ts/auxiliary/Checks");
+/**
+ * Duck type guard check for Supplier
+ *
+ * @param instance the instance to check
+ * @param <T> the type of value supplied
+ * @returns true if instance is a Supplier, false otherwise
+ */
+function guard(instance) {
+    return (0, Types_1.guardFunctions)(instance, 'supply');
+}
+/**
+ * Convert a Type to a Supplier
+ * @param type the type to convert
+ * @param <T> the type of value supplied
+ * @returns a Supplier that supplies values of type T
+ */
+function fromType(type) {
+    if (guard(type)) {
+        return type;
+    }
+    else if ((0, Types_1.isFunction)(type)) {
+        return {
+            supply: type
+        };
+    }
+    else {
+        return {
+            supply: () => type
+        };
+    }
+}
+/**
+ * Get the value from a Supplier Type
+ *
+ * @param type the Supplier Type
+ * @param <T> the type of value supplied
+ * @returns the value supplied by the Supplier Type
+ */
+function toValue(type) {
+    if (guard(type)) {
+        return type.supply();
+    }
+    else if ((0, Types_1.isFunction)(type)) {
+        return type();
+    }
+    else {
+        return type;
+    }
+}
+/**
+ * Check that a Supplier is present
+ *
+ * @param supplier the supplier to check
+ * @return the supplier if present
+ * @throws IllegalArgumentException if the supplier is not present
+ */
+function check(supplier) {
+    return (0, Checks_1.presentCheck)(supplier, "Supplier must be present.");
+}
+//# sourceMappingURL=Supplier.js.map

package/auxiliary/Supplier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Supplier.js","sourceRoot":"","sources":["../../src/auxiliary/Supplier.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AA2BH,sBAEC;AAQD,4BAYC;AASD,0BAQC;AASD,sBAEC;AA3ED,6DAA6F;AAC7F,qEAAwE;AAiBxE;;;;;;GAMG;AACH,SAAgB,KAAK,CAAI,QAAiB;IACxC,OAAO,IAAA,sBAAc,EAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,SAAgB,QAAQ,CAAI,IAAa;IACvC,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;SAAM,IAAI,IAAA,kBAAU,EAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,MAAM,EAAE,IAAI;SACb,CAAA;IACH,CAAC;SAAM,CAAC;QACN,OAAO;YACL,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI;SACnB,CAAA;IACH,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,OAAO,CAAI,IAAa;IACtC,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;IACvB,CAAC;SAAM,IAAI,IAAA,kBAAU,EAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,EAAE,CAAC;IAChB,CAAC;SAAM,CAAC;QACN,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,KAAK,CAAI,QAAiB;IACxC,OAAO,IAAA,qBAAY,EAAC,QAAQ,EAAE,2BAA2B,CAAC,CAAC;AAC7D,CAAC"}

package/auxiliary/Transform.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Transform.ts
+ *
+ * Defines a Transform type that can transform values of type I to type O.
+ */
+import { RequiredType } from "@jonloucks/contracts-ts/api/Types";
+/**
+ * A function that transforms type I to type O
+ */
+export type Method<I, O> = (input: I) => O;
+/**
+ * A transformation from type I to type O
+ */
+export interface Transform<I, O> {
+    /**
+     * Transform an input of type I to an output of type O
+     *
+     * @param input the input to transform
+     * @returns the transformed output
+     */
+    transform(input: I): O;
+}
+/**
+ * A transformation type that can be a Transform or a function from type I to type O
+ */
+export type Type<I, O> = Transform<I, O> | Method<I, O> | O;
+/**
+ * Check if a value is a Transform
+ *
+ * @param transform the value to check
+ * @returns true if the value is a Transform, false otherwise
+ */
+export declare function guard<I, O>(transform: unknown): transform is Transform<I, O>;
+/**
+ * Check if a value is a function with arity 1
+ *
+ * @param transform the value to check
+ * @returns true if the value is a function with arity 1, false otherwise
+ */
+export declare function guardMethod<I, O>(transform: unknown): transform is Method<I, O>;
+/**
+ * Convert a TransformType to a Transform
+ *
+ * @param transform the TransformType to convert
+ * @returns the Transform
+ */
+export declare function fromType<I, O>(transform: Type<I, O>): RequiredType<Transform<I, O>>;
+/**
+ * Get the value from a Transform Type
+ *
+ * @param type the Transform Type
+ * @param <T> the type of value supplied
+ * @returns the value supplied by the Transform Type
+ */
+export declare function toValue<I, O>(type: Type<I, O>, input: I): O;
+/**
+ * Check that a Transform is present
+ *
+ * @param transform the transform to check
+ * @return the transform if present
+ * @throws IllegalArgumentException if the transform is not present
+ */
+export declare function check<I, O>(transform: Type<I, O>): Type<I, O>;
+//# sourceMappingURL=Transform.d.ts.map

package/auxiliary/Transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transform.d.ts","sourceRoot":"","sources":["../../src/auxiliary/Transform.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAuC,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAGtG;;GAEG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC,EAAE,CAAC;IAE7B;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,IAAI,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,OAAO,GAAG,SAAS,IAAI,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAE5E;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,OAAO,GAAG,SAAS,IAAI,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAE/E;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAanF;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,EAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAQzD;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,EAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAC,CAAC,CAAC,CAE1D"}

package/auxiliary/Transform.js

@@ -0,0 +1,83 @@
+"use strict";
+/**
+ * Transform.ts
+ *
+ * Defines a Transform type that can transform values of type I to type O.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.guard = guard;
+exports.guardMethod = guardMethod;
+exports.fromType = fromType;
+exports.toValue = toValue;
+exports.check = check;
+const Types_1 = require("@jonloucks/contracts-ts/api/Types");
+const Checks_1 = require("@jonloucks/contracts-ts/auxiliary/Checks");
+/**
+ * Check if a value is a Transform
+ *
+ * @param transform the value to check
+ * @returns true if the value is a Transform, false otherwise
+ */
+function guard(transform) {
+    return (0, Types_1.guardFunctions)(transform, 'transform');
+}
+/**
+ * Check if a value is a function with arity 1
+ *
+ * @param transform the value to check
+ * @returns true if the value is a function with arity 1, false otherwise
+ */
+function guardMethod(transform) {
+    return (0, Types_1.isFunctionWithArity)(transform, 1);
+}
+/**
+ * Convert a TransformType to a Transform
+ *
+ * @param transform the TransformType to convert
+ * @returns the Transform
+ */
+function fromType(transform) {
+    if (guard(transform)) {
+        return transform;
+    }
+    else if (guardMethod(transform)) {
+        return { transform };
+    }
+    else {
+        return {
+            transform: (input) => {
+                (0, Checks_1.used)(input);
+                return transform;
+            },
+        };
+    }
+}
+/**
+ * Get the value from a Transform Type
+ *
+ * @param type the Transform Type
+ * @param <T> the type of value supplied
+ * @returns the value supplied by the Transform Type
+ */
+function toValue(type, input) {
+    if (guard(type)) {
+        return type.transform(input);
+    }
+    else if (guardMethod(type)) {
+        return type(input); // type is a Method, call it with input
+    }
+    else {
+        return type; // type is a direct value of type O
+    }
+}
+/**
+ * Check that a Transform is present
+ *
+ * @param transform the transform to check
+ * @return the transform if present
+ * @throws IllegalArgumentException if the transform is not present
+ */
+function check(transform) {
+    return (0, Checks_1.presentCheck)(transform, "Transform must be present.");
+}
+//# sourceMappingURL=Transform.js.map

package/auxiliary/Transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transform.js","sourceRoot":"","sources":["../../src/auxiliary/Transform.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAmCH,sBAEC;AAQD,kCAEC;AAQD,4BAaC;AASD,0BAQC;AASD,sBAEC;AA9FD,6DAAsG;AACtG,qEAA8E;AA0B9E;;;;;GAKG;AACH,SAAgB,KAAK,CAAO,SAAkB;IAC5C,OAAO,IAAA,sBAAc,EAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AAChD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,WAAW,CAAO,SAAkB;IAClD,OAAO,IAAA,2BAAmB,EAAC,SAAS,EAAE,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,SAAgB,QAAQ,CAAO,SAAqB;IAClD,IAAI,KAAK,CAAO,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO,SAAS,CAAC;IACnB,CAAC;SAAM,IAAI,WAAW,CAAO,SAAS,CAAC,EAAE,CAAC;QACxC,OAAO,EAAE,SAAS,EAAE,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,OAAO;YACL,SAAS,EAAE,CAAC,KAAQ,EAAK,EAAE;gBACzB,IAAA,aAAI,EAAC,KAAK,CAAC,CAAC;gBACZ,OAAO,SAAc,CAAC;YACxB,CAAC;SACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,OAAO,CAAM,IAAe,EAAE,KAAQ;IACpD,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;SAAM,IAAI,WAAW,CAAM,IAAI,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,uCAAuC;IAC7D,CAAC;SAAM,CAAC;QACN,OAAO,IAAI,CAAC,CAAC,mCAAmC;IAClD,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,KAAK,CAAM,SAAoB;IAC7C,OAAO,IAAA,qBAAY,EAAC,SAAS,EAAE,4BAA4B,CAAC,CAAC;AAC/D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jonloucks/contracts-ts",
-  "version": "1.2.2",
+  "version": "1.3.0",
   "description": "Typescript Dependency Contracts for dependency inversion",
   "main": "index.js",
   "types": "index.d.ts",
@@ -43,11 +43,12 @@
     "after:publish": "npm run clean",
     "prepare": "npm run build",
     "docs": "typedoc --options typedoc.json",
-    "badges": "npx tsx ./src/never-publish/generate-badges.ts",
+    "badges": "npx badges-ts generate-badges",
+    "discover": "npx badges-ts discover",
     "clean": "rm -rf dist",
     "compile": "tsc",
     "postversion": "npm run applyversion",
-    "applyversion": "npx tsx ./src/never-publish/apply-version.ts",
+    "applyversion": "npx badges-ts apply-version",
     "pack-package": "npm run before:publish && cd dist && npm pack && npm run after:publish"
   },
   "keywords": [
@@ -67,8 +68,8 @@
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",
-    "@types/node": "^25.2.1",
-    "@typescript-eslint/eslint-plugin": "^8.54.0",
+    "@types/node": "^25.2.2",
+    "@typescript-eslint/eslint-plugin": "^8.55.0",
     "@typescript-eslint/parser": "^8.53.1",
     "eslint": "^9.39.2",
     "jest": "^30.2.0",
@@ -76,5 +77,8 @@
     "ts-jest": "^29.4.6",
     "typedoc": "^0.28.15",
     "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@jonloucks/badges-ts": "^0.1.0"
   }
 }

package/version.js

@@ -3,5 +3,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = exports.NAME = void 0;
 // generated file - do not edit
 exports.NAME = "@jonloucks/contracts-ts";
-exports.VERSION = "1.2.2";
+exports.VERSION = "1.3.0";
 //# sourceMappingURL=version.js.map