@clipboard-health/util-ts 0.0.0

package/README.md

@@ -0,0 +1,21 @@
+# @clipboard-health/util-ts
+
+TypeScript utilities.
+
+## Table of Contents
+
+- [Install](#install)
+- [Usage](#usage)
+- [Local development commands](#local-development-commands)
+
+## Install
+
+```bash
+npm install @clipboard-health/util-ts
+```
+
+## Usage
+
+## Local development commands
+
+See [`package.json`](./package.json) `scripts` for a list of commands.

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@clipboard-health/util-ts",
+  "version": "0.0.0",
+  "main": "./src/index.js",
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "scripts": {
+    "build": "nx build util-ts",
+    "lint": "nx lint util-ts",
+    "test": "nx test util-ts"
+  },
+  "type": "commonjs",
+  "types": "./src/index.d.ts"
+}

package/src/index.d.ts

@@ -0,0 +1,16 @@
+export * from "./lib/attributes";
+export * from "./lib/cbh-error";
+export * from "./lib/cbh-response";
+export * from "./lib/defined-utils";
+export * from "./lib/delay";
+export * from "./lib/either";
+export * from "./lib/force-cast";
+export * from "./lib/head";
+export * from "./lib/identity";
+export * from "./lib/is-string";
+export * from "./lib/non-empty-array";
+export * from "./lib/null-to-undefined";
+export * from "./lib/option";
+export * from "./lib/stringify";
+export * from "./lib/to-error";
+//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/util-ts/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}

package/src/index.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lib/attributes"), exports);
+tslib_1.__exportStar(require("./lib/cbh-error"), exports);
+tslib_1.__exportStar(require("./lib/cbh-response"), exports);
+tslib_1.__exportStar(require("./lib/defined-utils"), exports);
+tslib_1.__exportStar(require("./lib/delay"), exports);
+tslib_1.__exportStar(require("./lib/either"), exports);
+tslib_1.__exportStar(require("./lib/force-cast"), exports);
+tslib_1.__exportStar(require("./lib/head"), exports);
+tslib_1.__exportStar(require("./lib/identity"), exports);
+tslib_1.__exportStar(require("./lib/is-string"), exports);
+tslib_1.__exportStar(require("./lib/non-empty-array"), exports);
+tslib_1.__exportStar(require("./lib/null-to-undefined"), exports);
+tslib_1.__exportStar(require("./lib/option"), exports);
+tslib_1.__exportStar(require("./lib/stringify"), exports);
+tslib_1.__exportStar(require("./lib/to-error"), exports);
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/util-ts/src/index.ts"],"names":[],"mappings":";;;AAAA,2DAAiC;AACjC,0DAAgC;AAChC,6DAAmC;AACnC,8DAAoC;AACpC,sDAA4B;AAC5B,uDAA6B;AAC7B,2DAAiC;AACjC,qDAA2B;AAC3B,yDAA+B;AAC/B,0DAAgC;AAChC,gEAAsC;AACtC,kEAAwC;AACxC,uDAA6B;AAC7B,0DAAgC;AAChC,yDAA+B"}

package/src/lib/attributes.d.ts

@@ -0,0 +1,3 @@
+export type AttributeValue = boolean | Date | number | string | Uint8Array | undefined;
+export type Attributes = Record<string, AttributeValue>;
+//# sourceMappingURL=attributes.d.ts.map

package/src/lib/attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/attributes.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;AAEvF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC"}

package/src/lib/attributes.js

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

package/src/lib/attributes.js.map

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

package/src/lib/cbh-error.d.ts

@@ -0,0 +1,15 @@
+import { type OneOrNonEmptyArray } from "./non-empty-array";
+declare const ERROR_STATUS_CODES: readonly [400, 401, 403, 404, 409, 422, 429, 500];
+export type ErrorStatusCode = (typeof ERROR_STATUS_CODES)[number];
+export interface CbhIssue {
+    cause?: Error;
+    id?: string;
+    message: string;
+    statusCode?: ErrorStatusCode;
+}
+export declare class CbhError extends Error {
+    readonly issues: CbhIssue[];
+    constructor(issues: OneOrNonEmptyArray<CbhIssue>);
+}
+export {};
+//# sourceMappingURL=cbh-error.d.ts.map

package/src/lib/cbh-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cbh-error.d.ts","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/cbh-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAmB,MAAM,mBAAmB,CAAC;AAE7E,QAAA,MAAM,kBAAkB,mDAAoD,CAAC;AAC7E,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B;AAED,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,MAAM,EAAE,QAAQ,EAAE,CAAC;gBAEvB,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC;CAUjD"}

package/src/lib/cbh-error.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CbhError = void 0;
+const non_empty_array_1 = require("./non-empty-array");
+const ERROR_STATUS_CODES = [400, 401, 403, 404, 409, 422, 429, 500];
+class CbhError extends Error {
+    issues;
+    constructor(issues) {
+        const is = (0, non_empty_array_1.toNonEmptyArray)(issues);
+        const first = is[0];
+        super(first?.message, { cause: first?.cause });
+        // See https://www.typescriptlang.org/docs/handbook/release-notes/typescript-2-2.html#example
+        Object.setPrototypeOf(this, new.target.prototype);
+        this.issues = is;
+        this.name = "CbhError";
+    }
+}
+exports.CbhError = CbhError;
+//# sourceMappingURL=cbh-error.js.map

package/src/lib/cbh-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cbh-error.js","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/cbh-error.ts"],"names":[],"mappings":";;;AAAA,uDAA6E;AAE7E,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAU,CAAC;AAU7E,MAAa,QAAS,SAAQ,KAAK;IACjB,MAAM,CAAa;IAEnC,YAAY,MAAoC;QAC9C,MAAM,EAAE,GAAG,IAAA,iCAAe,EAAC,MAAM,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QACpB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/C,6FAA6F;QAC7F,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAElD,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAbD,4BAaC"}

package/src/lib/cbh-response.d.ts

@@ -0,0 +1,18 @@
+import { CbhError, type CbhIssue } from "./cbh-error";
+import type { OneOrNonEmptyArray } from "./non-empty-array";
+export type CbhResponse<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: CbhError;
+};
+export declare function toErrorCbhResponse(issues: OneOrNonEmptyArray<CbhIssue>): {
+    success: false;
+    error: CbhError;
+};
+export declare function toSuccessCbhResponse<T>(data: T): {
+    success: true;
+    data: T;
+};
+//# sourceMappingURL=cbh-response.d.ts.map

package/src/lib/cbh-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cbh-response.d.ts","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/cbh-response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC;AAE9F,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,GAAG;IACxE,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,QAAQ,CAAC;CACjB,CAEA;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,CAE3E"}

package/src/lib/cbh-response.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toErrorCbhResponse = toErrorCbhResponse;
+exports.toSuccessCbhResponse = toSuccessCbhResponse;
+const cbh_error_1 = require("./cbh-error");
+function toErrorCbhResponse(issues) {
+    return { success: false, error: new cbh_error_1.CbhError(issues) };
+}
+function toSuccessCbhResponse(data) {
+    return { success: true, data };
+}
+//# sourceMappingURL=cbh-response.js.map

package/src/lib/cbh-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cbh-response.js","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/cbh-response.ts"],"names":[],"mappings":";;AAKA,gDAKC;AAED,oDAEC;AAdD,2CAAsD;AAKtD,SAAgB,kBAAkB,CAAC,MAAoC;IAIrE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,oBAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;AACzD,CAAC;AAED,SAAgB,oBAAoB,CAAI,IAAO;IAC7C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACjC,CAAC"}

package/src/lib/defined-utils.d.ts

@@ -0,0 +1,19 @@
+/**
+ * We specifically want to guard against both `null` and `undefined`
+ * In this one case, we need to define `null` as an expected argument type.
+ */
+type NullOrUndefined = null | undefined;
+/**
+ * Checks whether a value is null or undefined. If it is not defined, the return type ensures type safety.
+ * @param value any value or null or undefined
+ * @returns true if `value` is null or undefined, false otherwise.
+ */
+export declare function isNullOrUndefined<T>(value: T | NullOrUndefined): value is NullOrUndefined;
+/**
+ * Checks whether a value is defined. If it is defined, the return type ensures type safety.
+ * @param value any value or null or undefined
+ * @returns true if `value` is defined (not null and not undefined), false otherwise.
+ */
+export declare function isDefined<T>(value: T | NullOrUndefined): value is T;
+export {};
+//# sourceMappingURL=defined-utils.d.ts.map

package/src/lib/defined-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defined-utils.d.ts","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/defined-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,KAAK,eAAe,GAAG,IAAI,GAAG,SAAS,CAAC;AAExC;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,eAAe,GAAG,KAAK,IAAI,eAAe,CAEzF;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,eAAe,GAAG,KAAK,IAAI,CAAC,CAEnE"}

package/src/lib/defined-utils.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isNullOrUndefined = isNullOrUndefined;
+exports.isDefined = isDefined;
+/**
+ * Checks whether a value is null or undefined. If it is not defined, the return type ensures type safety.
+ * @param value any value or null or undefined
+ * @returns true if `value` is null or undefined, false otherwise.
+ */
+function isNullOrUndefined(value) {
+    return value === null || value === undefined;
+}
+/**
+ * Checks whether a value is defined. If it is defined, the return type ensures type safety.
+ * @param value any value or null or undefined
+ * @returns true if `value` is defined (not null and not undefined), false otherwise.
+ */
+function isDefined(value) {
+    return !isNullOrUndefined(value);
+}
+//# sourceMappingURL=defined-utils.js.map

package/src/lib/defined-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defined-utils.js","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/defined-utils.ts"],"names":[],"mappings":";;AAYA,8CAEC;AAOD,8BAEC;AAhBD;;;;GAIG;AACH,SAAgB,iBAAiB,CAAI,KAA0B;IAC7D,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;AAC/C,CAAC;AAED;;;;GAIG;AACH,SAAgB,SAAS,CAAI,KAA0B;IACrD,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC"}

package/src/lib/delay.d.ts

@@ -0,0 +1,2 @@
+export declare function delay(milliseconds: number): Promise<void>;
+//# sourceMappingURL=delay.d.ts.map

package/src/lib/delay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delay.d.ts","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/delay.ts"],"names":[],"mappings":"AAAA,wBAAsB,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/D"}

package/src/lib/delay.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.delay = delay;
+async function delay(milliseconds) {
+    await new Promise((resolve) => {
+        setTimeout(resolve, milliseconds);
+    });
+}
+//# sourceMappingURL=delay.js.map

package/src/lib/delay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delay.js","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/delay.ts"],"names":[],"mappings":";;AAAA,sBAIC;AAJM,KAAK,UAAU,KAAK,CAAC,YAAoB;IAC9C,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC5B,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/src/lib/either.d.ts

@@ -0,0 +1,32 @@
+export interface Left<E> {
+    isRight: false;
+    left: E;
+}
+export interface Right<A> {
+    isRight: true;
+    right: A;
+}
+/**
+ * A value of either type `Left<E>` or type `Right<A>`; a disjoint union.
+ *
+ * A common use case is as an alternative to {@link Option} where `Left<E>` contains useful
+ * information. Convention dictates that `Left<E>` is used for failure and `Right<A>` for success.
+ */
+export type Either<E, A> = Left<E> | Right<A>;
+/**
+ * Constructs an `Either` holding a `Left<E>` value, usually representing a failure.
+ */
+export declare function left<E, A = never>(left: E): Either<E, A>;
+/**
+ * Constructs an `Either` holding a `Right<A>` value, usually representing a success.
+ */
+export declare function right<A, E = never>(right: A): Either<E, A>;
+/**
+ * Returns `true` if the either is `Left<E>`, `false` otherwise.
+ */
+export declare function isLeft<E, A>(either: Either<E, A>): either is Left<E>;
+/**
+ * Returns `true` if the either is `Right<A>`, `false` otherwise.
+ */
+export declare function isRight<E, A>(either: Either<E, A>): either is Right<A>;
+//# sourceMappingURL=either.d.ts.map

package/src/lib/either.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"either.d.ts","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/either.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,IAAI,CAAC,CAAC;IACrB,OAAO,EAAE,KAAK,CAAC;IACf,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,WAAW,KAAK,CAAC,CAAC;IACtB,OAAO,EAAE,IAAI,CAAC;IACd,KAAK,EAAE,CAAC,CAAC;CACV;AAED;;;;;GAKG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;AAE9C;;GAEG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAExD;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAE1D;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,CAEpE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,CAEtE"}

package/src/lib/either.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.left = left;
+exports.right = right;
+exports.isLeft = isLeft;
+exports.isRight = isRight;
+/**
+ * Constructs an `Either` holding a `Left<E>` value, usually representing a failure.
+ */
+function left(left) {
+    return { isRight: false, left };
+}
+/**
+ * Constructs an `Either` holding a `Right<A>` value, usually representing a success.
+ */
+function right(right) {
+    return { isRight: true, right };
+}
+/**
+ * Returns `true` if the either is `Left<E>`, `false` otherwise.
+ */
+function isLeft(either) {
+    return !either.isRight;
+}
+/**
+ * Returns `true` if the either is `Right<A>`, `false` otherwise.
+ */
+function isRight(either) {
+    return either.isRight;
+}
+//# sourceMappingURL=either.js.map

package/src/lib/either.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"either.js","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/either.ts"],"names":[],"mappings":";;AAqBA,oBAEC;AAKD,sBAEC;AAKD,wBAEC;AAKD,0BAEC;AA1BD;;GAEG;AACH,SAAgB,IAAI,CAAe,IAAO;IACxC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,KAAK,CAAe,KAAQ;IAC1C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,MAAM,CAAO,MAAoB;IAC/C,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,SAAgB,OAAO,CAAO,MAAoB;IAChD,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC"}

package/src/lib/force-cast.d.ts

@@ -0,0 +1,3 @@
+/** Force cast to the provided type. */
+export declare function forceCast<T>(value: unknown): T;
+//# sourceMappingURL=force-cast.d.ts.map

package/src/lib/force-cast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"force-cast.d.ts","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/force-cast.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAE9C"}

package/src/lib/force-cast.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.forceCast = forceCast;
+/** Force cast to the provided type. */
+function forceCast(value) {
+    return value;
+}
+//# sourceMappingURL=force-cast.js.map

package/src/lib/force-cast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"force-cast.js","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/force-cast.ts"],"names":[],"mappings":";;AACA,8BAEC;AAHD,uCAAuC;AACvC,SAAgB,SAAS,CAAI,KAAc;IACzC,OAAO,KAAU,CAAC;AACpB,CAAC"}

package/src/lib/head.d.ts

@@ -0,0 +1,3 @@
+export type OneOrArray<T> = T | T[];
+export declare function head<T>(value?: OneOrArray<T>): T | undefined;
+//# sourceMappingURL=head.d.ts.map

package/src/lib/head.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"head.d.ts","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/head.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AAEpC,wBAAgB,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAE5D"}

package/src/lib/head.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.head = head;
+function head(value) {
+    return Array.isArray(value) ? value[0] : (value ?? undefined);
+}
+//# sourceMappingURL=head.js.map

package/src/lib/head.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"head.js","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/head.ts"],"names":[],"mappings":";;AAEA,oBAEC;AAFD,SAAgB,IAAI,CAAI,KAAqB;IAC3C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,SAAS,CAAC,CAAC;AAChE,CAAC"}

package/src/lib/identity.d.ts

@@ -0,0 +1,12 @@
+/**
+ * A generic function that returns its input unchanged.
+ * This function is useful in various functional programming scenarios, such as:
+ * - Creating higher-order functions like map, filter, and reduce.
+ * - Composing functions by providing an "identity element" in function composition.
+ *
+ * @template T - The type of the input value.
+ * @param {T} value - The value to return unchanged.
+ * @returns {T} The input value, unchanged.
+ */
+export declare function identity<T>(value: T): T;
+//# sourceMappingURL=identity.d.ts.map

package/src/lib/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAEvC"}

package/src/lib/identity.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.identity = identity;
+/**
+ * A generic function that returns its input unchanged.
+ * This function is useful in various functional programming scenarios, such as:
+ * - Creating higher-order functions like map, filter, and reduce.
+ * - Composing functions by providing an "identity element" in function composition.
+ *
+ * @template T - The type of the input value.
+ * @param {T} value - The value to return unchanged.
+ * @returns {T} The input value, unchanged.
+ */
+function identity(value) {
+    return value;
+}
+//# sourceMappingURL=identity.js.map

package/src/lib/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/identity.ts"],"names":[],"mappings":";;AAUA,4BAEC;AAZD;;;;;;;;;GASG;AACH,SAAgB,QAAQ,CAAI,KAAQ;IAClC,OAAO,KAAK,CAAC;AACf,CAAC"}

package/src/lib/is-string.d.ts

@@ -0,0 +1,2 @@
+export declare function isString(value: unknown): value is string;
+//# sourceMappingURL=is-string.d.ts.map

package/src/lib/is-string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-string.d.ts","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/is-string.ts"],"names":[],"mappings":"AAAA,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD"}

package/src/lib/is-string.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isString = isString;
+function isString(value) {
+    return typeof value === "string" || value instanceof String;
+}
+//# sourceMappingURL=is-string.js.map

package/src/lib/is-string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-string.js","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/is-string.ts"],"names":[],"mappings":";;AAAA,4BAEC;AAFD,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,YAAY,MAAM,CAAC;AAC9D,CAAC"}

package/src/lib/non-empty-array.d.ts

@@ -0,0 +1,4 @@
+export type NonEmptyArray<T> = [T, ...T[]];
+export type OneOrNonEmptyArray<T> = T | NonEmptyArray<T>;
+export declare function toNonEmptyArray<T>(value: OneOrNonEmptyArray<T>): NonEmptyArray<T>;
+//# sourceMappingURL=non-empty-array.d.ts.map

package/src/lib/non-empty-array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"non-empty-array.d.ts","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/non-empty-array.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;AAE3C,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;AAEzD,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAEjF"}

package/src/lib/non-empty-array.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toNonEmptyArray = toNonEmptyArray;
+function toNonEmptyArray(value) {
+    return Array.isArray(value) ? value : [value];
+}
+//# sourceMappingURL=non-empty-array.js.map

package/src/lib/non-empty-array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"non-empty-array.js","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/non-empty-array.ts"],"names":[],"mappings":";;AAIA,0CAEC;AAFD,SAAgB,eAAe,CAAI,KAA4B;IAC7D,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC"}

package/src/lib/null-to-undefined.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Turns a null-returning promise into a promise returning undefined.
+ *
+ * Some of the database packages that we use return promises (Prisma)
+ * or promise-like objects (mongoose) that can resolve to null.
+ * This function is useful for getting rid of nulls which are banned by our linter rules.
+ *
+ * @param value A promise or a promise-like object.
+ */
+export declare function nullToUndefined<T>(value: PromiseLike<T | null>): Promise<T | undefined>;
+//# sourceMappingURL=null-to-undefined.d.ts.map

package/src/lib/null-to-undefined.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"null-to-undefined.d.ts","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/null-to-undefined.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,wBAAsB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAE7F"}

package/src/lib/null-to-undefined.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nullToUndefined = nullToUndefined;
+/**
+ * Turns a null-returning promise into a promise returning undefined.
+ *
+ * Some of the database packages that we use return promises (Prisma)
+ * or promise-like objects (mongoose) that can resolve to null.
+ * This function is useful for getting rid of nulls which are banned by our linter rules.
+ *
+ * @param value A promise or a promise-like object.
+ */
+// eslint-disable-next-line @typescript-eslint/ban-types
+async function nullToUndefined(value) {
+    return (await value) ?? undefined;
+}
+//# sourceMappingURL=null-to-undefined.js.map

package/src/lib/null-to-undefined.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"null-to-undefined.js","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/null-to-undefined.ts"],"names":[],"mappings":";;AAUA,0CAEC;AAZD;;;;;;;;GAQG;AACH,wDAAwD;AACjD,KAAK,UAAU,eAAe,CAAI,KAA4B;IACnE,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC;AACpC,CAAC"}

package/src/lib/option.d.ts

@@ -0,0 +1,28 @@
+export interface None {
+    isSome: false;
+}
+export interface Some<A> {
+    isSome: true;
+    value: A;
+}
+/**
+ * An optional value. If the value exists, it's of type `Some<A>`, otherwise it's of type `None`.
+ */
+export type Option<A> = None | Some<A>;
+/**
+ * Constructs an `Option` of `None`, representing a missing value.
+ */
+export declare const none: None;
+/**
+ * Constructs an `Option` holding a `Some<A>`, representing an optional value that exists.
+ */
+export declare function some<A>(value: A): Some<A>;
+/**
+ * Returns `true` if the option is `None`, `false` otherwise.
+ */
+export declare function isNone<A>(option: Option<A>): option is None;
+/**
+ * Returns `true` if the option is `Some<A>`, `false` otherwise.
+ */
+export declare function isSome<A>(option: Option<A>): option is Some<A>;
+//# sourceMappingURL=option.d.ts.map

package/src/lib/option.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"option.d.ts","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/option.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,IAAI;IACnB,MAAM,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,IAAI,CAAC,CAAC;IACrB,MAAM,EAAE,IAAI,CAAC;IACb,KAAK,EAAE,CAAC,CAAC;CACV;AAED;;GAEG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AAEvC;;GAEG;AACH,eAAO,MAAM,IAAI,EAAE,IAAwB,CAAC;AAE5C;;GAEG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAEzC;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,IAAI,CAE3D;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,CAE9D"}

package/src/lib/option.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.none = void 0;
+exports.some = some;
+exports.isNone = isNone;
+exports.isSome = isSome;
+/**
+ * Constructs an `Option` of `None`, representing a missing value.
+ */
+exports.none = { isSome: false };
+/**
+ * Constructs an `Option` holding a `Some<A>`, representing an optional value that exists.
+ */
+function some(value) {
+    return { isSome: true, value };
+}
+/**
+ * Returns `true` if the option is `None`, `false` otherwise.
+ */
+function isNone(option) {
+    return !option.isSome;
+}
+/**
+ * Returns `true` if the option is `Some<A>`, `false` otherwise.
+ */
+function isSome(option) {
+    return option.isSome;
+}
+//# sourceMappingURL=option.js.map

package/src/lib/option.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"option.js","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/option.ts"],"names":[],"mappings":";;;AAsBA,oBAEC;AAKD,wBAEC;AAKD,wBAEC;AAxBD;;GAEG;AACU,QAAA,IAAI,GAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAE5C;;GAEG;AACH,SAAgB,IAAI,CAAI,KAAQ;IAC9B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAgB,MAAM,CAAI,MAAiB;IACzC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,SAAgB,MAAM,CAAI,MAAiB;IACzC,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC"}

package/src/lib/stringify.d.ts

@@ -0,0 +1,2 @@
+export declare function stringify(value: unknown): string;
+//# sourceMappingURL=stringify.d.ts.map

package/src/lib/stringify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringify.d.ts","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/stringify.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIhD"}

package/src/lib/stringify.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stringify = stringify;
+function stringify(value) {
+    return JSON.stringify(value, (_, value) => typeof value === "bigint" ? String(value) : value);
+}
+//# sourceMappingURL=stringify.js.map

package/src/lib/stringify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringify.js","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/stringify.ts"],"names":[],"mappings":";;AAAA,8BAIC;AAJD,SAAgB,SAAS,CAAC,KAAc;IACtC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,KAAc,EAAE,EAAE,CACjD,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAClD,CAAC;AACJ,CAAC"}

package/src/lib/to-error.d.ts

@@ -0,0 +1,4 @@
+export declare function isError(error: unknown): error is Error;
+export declare function toError(error: unknown): Error;
+export declare function toErrorMessage(error: unknown): string;
+//# sourceMappingURL=to-error.d.ts.map

package/src/lib/to-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-error.d.ts","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/to-error.ts"],"names":[],"mappings":"AAGA,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAEtD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAQ7C;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAErD"}

package/src/lib/to-error.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isError = isError;
+exports.toError = toError;
+exports.toErrorMessage = toErrorMessage;
+const is_string_1 = require("./is-string");
+const stringify_1 = require("./stringify");
+function isError(error) {
+    return error instanceof Error;
+}
+function toError(error) {
+    if (isError(error))
+        return error;
+    try {
+        return new Error((0, is_string_1.isString)(error) ? error : (0, stringify_1.stringify)(error));
+    }
+    catch {
+        return new Error(String(error));
+    }
+}
+function toErrorMessage(error) {
+    return toError(error).message;
+}
+//# sourceMappingURL=to-error.js.map

package/src/lib/to-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-error.js","sourceRoot":"","sources":["../../../../../packages/util-ts/src/lib/to-error.ts"],"names":[],"mappings":";;AAGA,0BAEC;AAED,0BAQC;AAED,wCAEC;AAnBD,2CAAuC;AACvC,2CAAwC;AAExC,SAAgB,OAAO,CAAC,KAAc;IACpC,OAAO,KAAK,YAAY,KAAK,CAAC;AAChC,CAAC;AAED,SAAgB,OAAO,CAAC,KAAc;IACpC,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAEjC,IAAI,CAAC;QACH,OAAO,IAAI,KAAK,CAAC,IAAA,oBAAQ,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAA,qBAAS,EAAC,KAAK,CAAC,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAClC,CAAC;AACH,CAAC;AAED,SAAgB,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;AAChC,CAAC"}