inferred-types 0.37.5 → 0.40.1

package/dist/types/src/types/errors/AsError.d.ts

@@ -0,0 +1,70 @@
+import { AnyObject, AsIndexOf, Concat, IfNever, IsEqual, ToString, ErrorCondition, EmptyObject, IfWide, TypeErrorInfo } from "src/types/index";
+interface Error<TName extends string = string, TMsg extends string = string> {
+    name: TName;
+    message: TMsg;
+    stack?: string;
+}
+export type AsError__Meta = [
+    kind: string,
+    msg: string,
+    context: TypeErrorInfo
+] | [
+    kind: string,
+    msg: string
+];
+type Props<T extends AnyObject | undefined> = T extends AnyObject ? T : EmptyObject;
+type ContextFrom<T extends AnyObject> = AsIndexOf<T, "context", EmptyObject>;
+type UtilityFrom<T extends AnyObject> = AsIndexOf<T, "utility", never>;
+type StackFrom<T extends AnyObject> = AsIndexOf<T, "stack", readonly []>;
+type IdFrom<T extends AnyObject> = AsIndexOf<T, "id", never>;
+type LibraryFrom<T extends AnyObject> = AsIndexOf<T, "library", never>;
+type Process<T extends AsError__Meta> = IsEqual<T, [string, string]> extends true ? ErrorCondition<T[0], T[1], null> : T extends [string, string, TypeErrorInfo] ? ErrorCondition<T[0], T[1], {
+    context: ContextFrom<Props<T[2]>>;
+    utility: UtilityFrom<Props<T[2]>>;
+    stack: StackFrom<Props<T[2]>>;
+    id: IdFrom<Props<T[2]>>;
+    library: LibraryFrom<Props<T[2]>>;
+}> : ErrorCondition<T[0], T[1], null>;
+/**
+ * **AsError**`<T>`
+ *
+ * Proxies through all `T`'s which are already extended from `ErrorCondition`
+ * unchanged but converts all other types into
+ *
+ * If no known formula's are found to convert to an ErrorCondition then a
+ * `ErrorCondition<"failed-to-wrap">` error will be produced:
+ *
+ * #### Known Formulas:
+ * - `never` - converted to `ErrorCondition<"never-value">`
+ * - `Error` - a JS `Error` type is converted to `ErrorCondition<"runtime-error"> and it's properties are available in the error conditions hash storage as `error`
+ * - `ErrorCondition` - any pre-existing `ErrorCondition` will just be proxied through
+ * - `[kind, msg, [context]]` - it will:
+ *    - the first two parameters will map directly into the error condition properties of the same name
+ *    - the optional `context` object is a dictionary of key value pairs; where:
+ *      - when the keys match one of the root properties of `ErrorCondition` it will be
+ *        mapped onto that property (assuming that the _type_ is appropriate)
+ *      - otherwise it will be added to the `context` dictionary appearing as a prop on
+ *        `ErrorCondition`.
+ *
+ * **Related:** `Throw`
+ */
+export type AsError<TType> = TType extends ErrorCondition ? TType : IfNever<TType, ErrorCondition<"never-value", "a 'never' type was encountered which is not allowed in this context!">, TType extends Error<string> ? ErrorCondition<"runtime-error", Concat<[
+    "the JS runtime's Error class was found with the message: '",
+    TType["message"],
+    "'"
+]>, {
+    library: "inferred-types";
+    utility: "AsError";
+    context: {
+        error_name: IfWide<TType["name"], "unknown; use TypedError in inferred-types instead of Error for more info">;
+    };
+}> : TType extends AsError__Meta ? Process<TType> : ErrorCondition<"failed-to-wrap", Concat<[
+    "An unexpected value -- ",
+    ToString<TType>,
+    " -- was passed into the AsError<T> type utility!"
+]>, {
+    library: "inferred-types";
+    utility: "AsError";
+}>>;
+export {};
+//# sourceMappingURL=AsError.d.ts.map

package/dist/types/src/types/errors/AsError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AsError.d.ts","sourceRoot":"","sources":["../../../../../src/types/errors/AsError.ts"],"names":[],"mappings":"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"}

package/dist/types/src/types/errors/AsError.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/errors/ErrorCondition.d.ts

@@ -0,0 +1,56 @@
+import { EmptyObject, NotNull } from "src/types/index";
+export type ErrorCondition__Props = {
+    context?: Record<string, unknown>;
+    utility?: string;
+    stack?: readonly string[];
+    id?: string | number;
+    library?: string;
+};
+export interface TypeErrorInfo<TContext extends object = object, TUtility extends string | never = string | never, TStack extends readonly string[] = readonly string[], TId extends string | number | never = string | number | never, TLibrary extends string | never = string | never> {
+    /**
+     * A place to add a dictionary of key/value pairs specifically related
+     * to the error.
+     */
+    context?: TContext;
+    /**
+     * the name of the type utility which generated the error
+     */
+    utility?: TUtility;
+    /**
+     * An array of known type utilities which were involved to get to this error
+     */
+    stack?: TStack;
+    /**
+     * if there is a particular "id" value which is useful to separate from the error message
+     * you can add it here.
+     */
+    id?: TId;
+    /**
+     * If this error condition is originating in a library/repo then you can
+     * mark this as being the case.
+     */
+    library?: TLibrary;
+}
+/**
+ * **ErrorCondition**`<TKind,[TMsg],[TDomain],[TVars]>`
+ *
+ * A way to express a meaningful error message in type system
+ */
+export interface ErrorCondition<TKind extends string = string, TMsg extends string = string, TInfo extends TypeErrorInfo | null = TypeErrorInfo | null> {
+    _type: "ErrorCondition";
+    /** the kind/category of error this is */
+    kind: TKind;
+    /** an error about the message */
+    message: TMsg;
+    /** Error specific context */
+    context: TInfo extends NotNull ? TInfo["context"] : EmptyObject;
+    /** the originating type utility which threw the error */
+    utility: TInfo extends NotNull ? TInfo["utility"] : never;
+    /** the stack of utility types which were used to get to this error */
+    stack: TInfo extends NotNull ? TInfo["stack"] : [];
+    /** a unique id important to this error */
+    id: TInfo extends NotNull ? TInfo["id"] : never;
+    /** the library this error came from */
+    library: TInfo extends NotNull ? TInfo["library"] : never;
+}
+//# sourceMappingURL=ErrorCondition.d.ts.map

package/dist/types/src/types/errors/ErrorCondition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorCondition.d.ts","sourceRoot":"","sources":["../../../../../src/types/errors/ErrorCondition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAGF,MAAM,WAAW,aAAa,CAC5B,QAAQ,SAAS,MAAM,GAAG,MAAM,EAChC,QAAQ,SAAS,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,EAChD,MAAM,SAAS,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,EACpD,GAAG,SAAS,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,EAC7D,QAAQ,SAAS,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK;IAEhD;;;OAGG;IACH,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB;;OAEG;IACH,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,EAAE,CAAC,EAAE,GAAG,CAAC;IACT;;;OAGG;IACH,OAAO,CAAC,EAAE,QAAQ,CAAC;CACpB;AAID;;;;GAIG;AACH,MAAM,WAAW,cAAc,CAC7B,KAAK,SAAS,MAAM,GAAG,MAAM,EAC7B,IAAI,SAAS,MAAM,GAAG,MAAM,EAC5B,KAAK,SAAS,aAAa,GAAG,IAAI,GAAG,aAAa,GAAG,IAAI;IAEzD,KAAK,EAAE,gBAAgB,CAAC;IACxB,yCAAyC;IACzC,IAAI,EAAE,KAAK,CAAC;IACZ,iCAAiC;IACjC,OAAO,EAAE,IAAI,CAAC;IACd,6BAA6B;IAC7B,OAAO,EAAE,KAAK,SAAS,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,WAAW,CAAC;IAChE,yDAAyD;IACzD,OAAO,EAAE,KAAK,SAAS,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;IAC1D,sEAAsE;IACtE,KAAK,EAAE,KAAK,SAAS,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IACnD,0CAA0C;IAC1C,EAAE,EAAE,KAAK,SAAS,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IAChD,uCAAuC;IACvC,OAAO,EAAE,KAAK,SAAS,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;CAc3D"}

package/dist/types/src/types/errors/ErrorCondition.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/errors/ErrorConditionHandler.d.ts

@@ -0,0 +1,9 @@
+import { ErrorCondition } from "..";
+/**
+ * **ErrorConditionHandler**
+ *
+ * A callback function which will receive an ErrorCondition and return an appropriate
+ * response.
+ */
+export type ErrorConditionHandler = <T extends ErrorCondition<any>>(err: T) => any;
+//# sourceMappingURL=ErrorConditionHandler.d.ts.map

package/dist/types/src/types/errors/ErrorConditionHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorConditionHandler.d.ts","sourceRoot":"","sources":["../../../../../src/types/errors/ErrorConditionHandler.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,cAAc,EAAC,MAAM,IAAI,CAAC;AAElC;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,SAAS,cAAc,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,GAAG,CAAC"}

package/dist/types/src/types/errors/ErrorConditionHandler.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/errors/ReportError.d.ts

@@ -0,0 +1,9 @@
+import { ErrorCondition, TypeErrorInfo } from "..";
+/**
+ * **ReportError**
+ *
+ * Type utility which takes a _desired state_ of `T` and then inspects the
+ */
+export type ReportError<T> = T extends ErrorCondition<infer Kind, infer Msg> ? ErrorCondition<Kind, Msg> : Exclude<T, ErrorCondition<string, string>>;
+export declare function errorCondition<TKind extends string, TDesc extends string, TInfo extends TypeErrorInfo | null>(kind: TKind, message?: TDesc, info?: TInfo): ErrorCondition<TKind, TDesc, TInfo>;
+//# sourceMappingURL=ReportError.d.ts.map

package/dist/types/src/types/errors/ReportError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReportError.d.ts","sourceRoot":"","sources":["../../../../../src/types/errors/ReportError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAEnD;;;;GAIG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,cAAc,CAAC,MAAM,IAAI,EAAE,MAAM,GAAG,CAAC,GACxE,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,GACzB,OAAO,CAAC,CAAC,EAAE,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAE/C,wBAAgB,cAAc,CAC5B,KAAK,SAAS,MAAM,EACpB,KAAK,SAAS,MAAM,EACpB,KAAK,SAAS,aAAa,GAAG,IAAI,EAElC,IAAI,EAAE,KAAK,EACX,OAAO,GAAE,KAAmB,EAC5B,IAAI,GAAE,KAAqB,uCAY5B"}

package/dist/types/src/types/errors/ReportError.js

@@ -0,0 +1,12 @@
+export function errorCondition(kind, message = "", info = null) {
+    return {
+        _type: "ErrorCondition",
+        kind,
+        message,
+        context: info?.context || {},
+        utility: info?.utility,
+        stack: info?.stack || [],
+        id: info?.id || kind,
+        library: info?.library,
+    };
+}

package/dist/types/src/types/errors/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./AsError";
+export * from "./ErrorCondition";
+export * from "./ErrorConditionHandler";
+export * from "./ReportError";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/types/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/types/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC"}

package/dist/types/src/types/errors/index.js

@@ -0,0 +1,4 @@
+export * from "./AsError";
+export * from "./ErrorCondition";
+export * from "./ErrorConditionHandler";
+export * from "./ReportError";

package/dist/types/src/types/functional/Left.d.ts

@@ -0,0 +1,8 @@
+import { LeftRight } from "..";
+/**
+ * **Left**<T>
+ *
+ * Extracts the **left** value from a `LeftRight`.
+ */
+export type Left<T extends LeftRight> = T[1];
+//# sourceMappingURL=Left.d.ts.map

package/dist/types/src/types/functional/Left.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Left.d.ts","sourceRoot":"","sources":["../../../../../src/types/functional/Left.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAE/B;;;;GAIG;AACH,MAAM,MAAM,IAAI,CAAC,CAAC,SAAS,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/types/src/types/functional/Left.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/functional/Right.d.ts

@@ -0,0 +1,8 @@
+import { LeftRight } from "..";
+/**
+ * **Right**<T>
+ *
+ * Extracts the **right** value from a `LeftRight`.
+ */
+export type Right<T extends LeftRight> = T[2];
+//# sourceMappingURL=Right.d.ts.map

package/dist/types/src/types/functional/Right.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Right.d.ts","sourceRoot":"","sources":["../../../../../src/types/functional/Right.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAE/B;;;;GAIG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/types/src/types/functional/Right.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/functional/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./Left";
+export * from "./Right";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/types/functional/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/types/functional/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC"}

package/dist/types/src/types/functional/index.js

@@ -0,0 +1,2 @@
+export * from "./Left";
+export * from "./Right";

package/dist/types/src/types/functions/AsFnMeta.d.ts

@@ -0,0 +1,9 @@
+import type { AnyFunction, IfEqual, FnMeta, FnProps, EmptyObject, IndexableObject } from "..";
+/**
+ * **AsFnMeta**`<TFn>`
+ *
+ * Takes a function `TFn` and returns the meta information in `FnMeta`
+ * format.
+ */
+export type AsFnMeta<TFn extends AnyFunction> = IfEqual<FnProps<TFn>, EmptyObject, FnMeta<Parameters<TFn>, ReturnType<TFn>, "no-props">, FnMeta<Parameters<TFn>, ReturnType<TFn>, FnProps<TFn> extends IndexableObject ? FnProps<TFn> : never>>;
+//# sourceMappingURL=AsFnMeta.d.ts.map

package/dist/types/src/types/functions/AsFnMeta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AsFnMeta.d.ts","sourceRoot":"","sources":["../../../../../src/types/functions/AsFnMeta.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,IAAI,CAAC;AAE9F;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,CAClB,GAAG,SAAS,WAAW,IACrB,OAAO,CACT,OAAO,CAAC,GAAG,CAAC,EAAE,WAAW,EACzB,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,EACpD,MAAM,CACJ,UAAU,CAAC,GAAG,CAAC,EACf,UAAU,CAAC,GAAG,CAAC,EACf,OAAO,CAAC,GAAG,CAAC,SAAS,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAC5D,CACF,CAAC"}

package/dist/types/src/types/functions/AsFnMeta.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/functions/FnMeta.d.ts

@@ -0,0 +1,18 @@
+import { IndexableObject } from "..";
+/**
+ * **FnMeta**<TArgs,TReturn,TProps>
+ *
+ * The meta-information around a given function. Represented as an
+ * object with the following properties:
+ *
+ * 1. `args` - the array of arguments the function expects
+ * 2. `returns` - the return type of the function
+ * 3. `props` - any Key/Value props also packaged with the function, if no
+ * key/values are found it will be set to `no-props`.
+ */
+export type FnMeta<TArgs extends readonly unknown[], TReturn, TProps extends IndexableObject | "no-props"> = {
+    args: TArgs;
+    returns: TReturn;
+    props: TProps;
+};
+//# sourceMappingURL=FnMeta.d.ts.map

package/dist/types/src/types/functions/FnMeta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FnMeta.d.ts","sourceRoot":"","sources":["../../../../../src/types/functions/FnMeta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAG,eAAe,EAAE,MAAM,IAAI,CAAC;AAEtC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,MAAM,CAChB,KAAK,SAAS,SAAS,OAAO,EAAE,EAChC,OAAO,EACP,MAAM,SAAS,eAAe,GAAG,UAAU,IACzC;IACF,IAAI,EAAE,KAAK,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC"}

package/dist/types/src/types/functions/FnMeta.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/functions/FnProps.d.ts

@@ -0,0 +1,9 @@
+import { AnyFunction, ExpandRecursively, IfNever } from "..";
+/**
+ * **FnProps**`<T>`
+ *
+ * Return a dictionary of key/value pairs from a function. If no key/value
+ * pairs are assigned to the function base then an empty object is returned.
+ */
+export type FnProps<T extends AnyFunction> = IfNever<ExpandRecursively<keyof T>, {}, ExpandRecursively<Pick<T, ExpandRecursively<keyof T>>>>;
+//# sourceMappingURL=FnProps.d.ts.map

package/dist/types/src/types/functions/FnProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FnProps.d.ts","sourceRoot":"","sources":["../../../../../src/types/functions/FnProps.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAG,iBAAiB,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,WAAW,IACzC,OAAO,CACL,iBAAiB,CAAC,MAAM,CAAC,CAAC,EAC1B,EAAE,EACF,iBAAiB,CAAC,IAAI,CAAC,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CACvD,CAAC"}

package/dist/types/src/types/functions/FnProps.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/functions/LogicFunction.d.ts

@@ -0,0 +1,7 @@
+/**
+ * **LogicFunction**
+ *
+ * A function -- with _optional_ parameters -- which returns a boolean value.
+ */
+export type LogicFunction<TParams extends readonly unknown[] = unknown[]> = (...args: TParams) => boolean;
+//# sourceMappingURL=LogicFunction.d.ts.map

package/dist/types/src/types/functions/LogicFunction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogicFunction.d.ts","sourceRoot":"","sources":["../../../../../src/types/functions/LogicFunction.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,aAAa,CAAC,OAAO,SAAS,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC"}

package/dist/types/src/types/functions/LogicFunction.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/functions/PromiseAll.d.ts

@@ -0,0 +1,12 @@
+import { Tuple } from "..";
+/**
+ * **PromiseAll**
+ *
+ *
+ */
+export interface PromiseAll<TKind = unknown> {
+    <T extends Tuple<PromiseLike<TKind>>>(...promises: T): {
+        [K in keyof T]: Awaited<T[K]>;
+    };
+}
+//# sourceMappingURL=PromiseAll.d.ts.map

package/dist/types/src/types/functions/PromiseAll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromiseAll.d.ts","sourceRoot":"","sources":["../../../../../src/types/functions/PromiseAll.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC;AAG3B;;;;GAIG;AACH,MAAM,WAAW,UAAU,CAAC,KAAK,GAAG,OAAO;IACzC,CAAC,CAAC,SAAS,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,GAAG;SACpD,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAC9B,CAAC;CACH"}

package/dist/types/src/types/functions/PromiseAll.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/functions/RemoveFnProps.d.ts

@@ -0,0 +1,9 @@
+import { AnyFunction, AsFnMeta } from "..";
+/**
+ * **RemoveFnProps**`<T>`
+ *
+ * Takes a function `T` and returns the function unchanged but without any
+ * key/value pairs that may have been added to the function's definition.
+ */
+export type RemoveFnProps<T extends AnyFunction> = (...args: AsFnMeta<T>["args"]) => AsFnMeta<T>["returns"];
+//# sourceMappingURL=RemoveFnProps.d.ts.map

package/dist/types/src/types/functions/RemoveFnProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoveFnProps.d.ts","sourceRoot":"","sources":["../../../../../src/types/functions/RemoveFnProps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,WAAW,IAAI,CAAC,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC"}

package/dist/types/src/types/functions/RemoveFnProps.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/functions/ToFn.d.ts

@@ -0,0 +1,16 @@
+import { AnyFunction, IfNotError, FnMeta } from "..";
+/**
+ * **ToFn**`<T>`
+ *
+ * Ensures that resultant type is a function, where the mapping is:
+ *
+ *  - `AnyFunction` - function signature maintained
+ *  - `FnMeta` - is converted to a precise function type
+ *  - `never` _or_ `ErrorCondition` - returned "as is"
+ *
+ * All other values will return a function of the form `() => T`
+ *
+ * **Related:** `AsFn`
+ */
+export type ToFn<T> = IfNotError<T, {}, T extends AnyFunction ? T : T extends FnMeta<infer Args, infer Returns, infer Props> ? "no-props" extends Props ? (...args: Args) => Returns : ((...args: Args) => Returns) & Props : () => T>;
+//# sourceMappingURL=ToFn.d.ts.map

package/dist/types/src/types/functions/ToFn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToFn.d.ts","sourceRoot":"","sources":["../../../../../src/types/functions/ToFn.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAErD;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,IAAI,CAAC,CAAC,IAAI,UAAU,CAC9B,CAAC,EACD,EAAE,EACF,CAAC,SAAS,WAAW,GACjB,CAAC,GACD,CAAC,SAAS,MAAM,CAAC,MAAM,IAAI,EAAE,MAAM,OAAO,EAAE,MAAM,KAAK,CAAC,GACtD,UAAU,SAAS,KAAK,GACtB,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,GAC1B,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,GAAG,KAAK,GAC1C,MAAM,CAAC,CACV,CAAC"}

package/dist/types/src/types/functions/ToFn.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/functions/TypeGuard.d.ts

@@ -0,0 +1,9 @@
+import { Narrowable } from "..";
+/**
+ * **TypeGuard**
+ *
+ * a typing for a **TS** type-guard which evaluates an _unknown_ input
+ * and determines if it is of type `T`.
+ */
+export type TypeGuard<T> = <U extends Narrowable>(value: U) => value is T & U;
+//# sourceMappingURL=TypeGuard.d.ts.map

package/dist/types/src/types/functions/TypeGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeGuard.d.ts","sourceRoot":"","sources":["../../../../../src/types/functions/TypeGuard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,UAAU,EAAE,KAAK,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/dist/types/src/types/functions/TypeGuard.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/functions/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./LogicFunction";
+export * from "./TypeGuard";
+export * from "./AsFnMeta";
+export * from "./RemoveFnProps";
+export * from "./ToFn";
+export * from "./FnMeta";
+export * from "./PromiseAll";
+export * from "./FnProps";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/types/functions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/types/functions/index.ts"],"names":[],"mappings":"AAMA,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/dist/types/src/types/functions/index.js

@@ -0,0 +1,17 @@
+// #autoindex
+// #region auto-indexed files
+// index last changed at: 8th Aug, 2022, 09:51 AM ( GMT-7 )
+// hash-code: 57dfa865
+// file exports
+export * from "./LogicFunction";
+export * from "./TypeGuard";
+export * from "./AsFnMeta";
+export * from "./RemoveFnProps";
+export * from "./ToFn";
+export * from "./FnMeta";
+export * from "./PromiseAll";
+export * from "./FnProps";
+// export * from "../numeric-literals/ValueCallback";
+// #endregion auto-indexed files
+// see https://github.com/inocan-group/do-devops/docs/autoindex.md
+// for more info

package/dist/types/src/types/index.d.ts

@@ -0,0 +1,18 @@
+export * from "./base-types/index";
+export * from "./boolean-logic/index";
+export * from "./classes/index";
+export * from "./containers/index";
+export * from "./dictionary/index";
+export * from "./errors/index";
+export * from "./functional/index";
+export * from "./functions/index";
+export * from "./kv/index";
+export * from "./lists/index";
+export * from "./literals/index";
+export * from "./numeric-literals/index";
+export * from "./runtime-types/index";
+export * from "./sets/index";
+export * from "./string-literals/index";
+export * from "./tuples/index";
+export * from "./type-conversion/index";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/index.ts"],"names":[],"mappings":"AAOA,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC"}

package/dist/types/src/types/index.js

@@ -0,0 +1,23 @@
+// #autoindex
+// #region auto-indexed files
+// index last changed at: 8th Aug, 2022, 09:51 AM ( GMT-7 )
+// hash-code: fbd4603a
+// file exports
+// directory exports
+export * from "./base-types/index";
+export * from "./boolean-logic/index";
+export * from "./classes/index";
+export * from "./containers/index";
+export * from "./dictionary/index";
+export * from "./errors/index";
+export * from "./functional/index";
+export * from "./functions/index";
+export * from "./kv/index";
+export * from "./lists/index";
+export * from "./literals/index";
+export * from "./numeric-literals/index";
+export * from "./runtime-types/index";
+export * from "./sets/index";
+export * from "./string-literals/index";
+export * from "./tuples/index";
+export * from "./type-conversion/index";

package/dist/types/src/types/kv/DictFromKv.d.ts

@@ -0,0 +1,7 @@
+export type DictFromKv<T extends readonly {
+    key: string;
+    value: unknown;
+}[]> = {
+    [R in T[number] as R["key"]]: R["value"];
+};
+//# sourceMappingURL=DictFromKv.d.ts.map

package/dist/types/src/types/kv/DictFromKv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DictFromKv.d.ts","sourceRoot":"","sources":["../../../../../src/types/kv/DictFromKv.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,SAAS;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,EAAE,IAAI;KAC5E,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;CACzC,CAAC"}

package/dist/types/src/types/kv/DictFromKv.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/kv/KeyValue.d.ts

@@ -0,0 +1,12 @@
+import { ExpandRecursively } from "..";
+/**
+ * Provides a strongly typed _key_ and _value_ for a dictionary `T`
+ *
+ * ```ts
+ * type Obj = { foo: 1, bar: "hi" };
+ * // ["foo", 1 ]
+ * type Foo = KeyValue<Obj, "foo">;
+ * ```
+ */
+export type KeyValue<T extends object, K extends keyof T> = [K & keyof T, ExpandRecursively<T[K]>];
+//# sourceMappingURL=KeyValue.d.ts.map

package/dist/types/src/types/kv/KeyValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeyValue.d.ts","sourceRoot":"","sources":["../../../../../src/types/kv/KeyValue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,IAAI,CAAC;AAEvC;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/types/src/types/kv/KeyValue.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/kv/KvFrom.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Type utility which takes an object type and converts to an array of KV objects:
+ * ```ts
+ * // [ {key: "id", value: 123 } | {key: "foo", value: "bar" } ][]
+ * type Arr = KvFrom<{ id: 123, foo: "bar" }>;
+ * ```
+ */
+export type KvFrom<T extends object> = Array<{
+    [K in keyof T]: {
+        key: K;
+        value: T[K];
+    };
+}[keyof T]>;
+//# sourceMappingURL=KvFrom.d.ts.map

package/dist/types/src/types/kv/KvFrom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KvFrom.d.ts","sourceRoot":"","sources":["../../../../../src/types/kv/KvFrom.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,MAAM,IAAI,KAAK,CAAC;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG;QAAE,GAAG,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;KAAE;CAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC"}

package/dist/types/src/types/kv/KvFrom.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/kv/KvTuple.d.ts

@@ -0,0 +1,15 @@
+/**
+ * **KvTuple**
+ *
+ * a key/value of type `T` represented as `[key, kv]`
+ *
+ * ```ts
+ * type Obj = { foo: 1, bar: "hi" };
+ * // ["foo", { foo: 1 } ]
+ * type Foo = KvTuple<Obj, "foo">;
+ * ```
+ *
+ * **Note:** _consider use of `KeyValue<T,K>` as an alternate representation_
+ */
+export type KvTuple<T, K extends keyof T> = [K, Record<K, T[K]>];
+//# sourceMappingURL=KvTuple.d.ts.map

package/dist/types/src/types/kv/KvTuple.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KvTuple.d.ts","sourceRoot":"","sources":["../../../../../src/types/kv/KvTuple.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/types/src/types/kv/KvTuple.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/kv/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./DictFromKv";
+export * from "./KeyValue";
+export * from "./KvFrom";
+export * from "./KvTuple";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/types/kv/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/types/kv/index.ts"],"names":[],"mappings":"AAMA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC"}

package/dist/types/src/types/kv/index.js

@@ -0,0 +1,12 @@
+// #autoindex
+// #region auto-indexed files
+// index last changed at: 8th Aug, 2022, 09:51 AM ( GMT-7 )
+// hash-code: 744ff3bf
+// file exports
+export * from "./DictFromKv";
+export * from "./KeyValue";
+export * from "./KvFrom";
+export * from "./KvTuple";
+// #endregion auto-indexed files
+// see https://github.com/inocan-group/do-devops/docs/autoindex.md
+// for more info