@clipboard-health/util-ts 2.1.1 → 2.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clipboard-health/util-ts",
-  "version": "2.1.1",
+  "version": "2.1.3",
   "main": "./src/index.js",
   "publishConfig": {
     "access": "restricted"
@@ -9,5 +9,6 @@
     "build": "nx build util-ts",
     "lint": "nx lint util-ts",
     "test": "nx test util-ts"
-  }
+  },
+  "type": "commonjs"
 }

package/src/{index.ts → index.d.ts}

@@ -11,3 +11,4 @@ export * from "./lib/non-empty-array";
 export * from "./lib/null-to-undefined";
 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,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,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}

package/src/index.js

@@ -0,0 +1,17 @@
+"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/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/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,2DAAiC;AACjC,qDAA2B;AAC3B,yDAA+B;AAC/B,0DAAgC;AAChC,gEAAsC;AACtC,kEAAwC;AACxC,0DAAgC;AAChC,yDAA+B"}

package/src/lib/{attributes.ts → attributes.d.ts}

@@ -1,3 +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.ts → defined-utils.d.ts}

@@ -2,23 +2,18 @@
  * We specifically want to guard against both `null` and `undefined`
  * In this one case, we need to define `null` as an expected argument type.
  */
-// eslint-disable-next-line @typescript-eslint/ban-types
 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 function isNullOrUndefined<T>(value: T | NullOrUndefined): value is NullOrUndefined {
-  return value === null || value === undefined;
-}
-
+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 function isDefined<T>(value: T | NullOrUndefined): value is T {
-  return !isNullOrUndefined(value);
-}
+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/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.ts → identity.d.ts}

@@ -8,6 +8,5 @@
  * @param {T} value - The value to return unchanged.
  * @returns {T} The input value, unchanged.
  */
-export function identity<T>(value: T): T {
-  return value;
-}
+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.ts → null-to-undefined.d.ts}

@@ -7,7 +7,5 @@
  *
  * @param value A promise or a promise-like object.
  */
-// eslint-disable-next-line @typescript-eslint/ban-types
-export async function nullToUndefined<T>(value: PromiseLike<T | null>): Promise<T | undefined> {
-  return (await value) ?? undefined;
-}
+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/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"}

package/.eslintrc.json

@@ -1,12 +0,0 @@
-{
-  "extends": ["../../.eslintrc.json"],
-  "ignorePatterns": ["!**/*"],
-  "parserOptions": {
-    "project": "tsconfig.lint.json",
-    "tsconfigRootDir": "packages/util-ts"
-  },
-  "rules": {
-    // Block node dependencies so this library is usable in the browser.
-    "no-restricted-imports": ["error", { "patterns": ["node:*"] }]
-  }
-}

package/jest.config.ts

@@ -1,18 +0,0 @@
-export default {
-  coveragePathIgnorePatterns: [],
-  coverageThreshold: {
-    global: {
-      branches: 100,
-      functions: 100,
-      lines: 100,
-      statements: 100,
-    },
-  },
-  displayName: "util-ts",
-  moduleFileExtensions: ["ts", "js"],
-  preset: "../../jest.preset.js",
-  setupFiles: ["../../jest.setup.js"],
-  transform: {
-    "^.+\\.[tj]s$": ["ts-jest", { tsconfig: "<rootDir>/tsconfig.spec.json" }],
-  },
-};

package/project.json

@@ -1,33 +0,0 @@
-{
-  "name": "util-ts",
-  "$schema": "../../node_modules/nx/schemas/project-schema.json",
-  "projectType": "library",
-  "sourceRoot": "packages/util-ts/src",
-  "tags": ["scope:no-external-imports"],
-  "targets": {
-    "build": {
-      "executor": "@nx/js:tsc",
-      "options": {
-        "assets": ["packages/util-ts/*.md"],
-        "main": "packages/util-ts/src/index.js",
-        "outputPath": "dist/packages/util-ts",
-        "tsConfig": "packages/util-ts/tsconfig.lib.json"
-      },
-      "outputs": ["{options.outputPath}"]
-    },
-    "lint": {
-      "executor": "@nx/eslint:lint",
-      "options": {
-        "maxWarnings": 0
-      }
-    },
-    "test": {
-      "executor": "@nx/jest:jest",
-      "options": {
-        "jestConfig": "packages/util-ts/jest.config.ts",
-        "passWithNoTests": false
-      },
-      "outputs": ["{projectRoot}/coverage"]
-    }
-  }
-}

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

@@ -1,30 +0,0 @@
-import { CbhError } from "./cbh-error";
-
-describe("CbhError", () => {
-  it("returns proper defaults", () => {
-    const message = "boom";
-    const statusCode = 500;
-
-    const error = new CbhError({ message, statusCode });
-
-    expect(error.name).toBe("CbhError");
-    expect(error.message).toBe(message);
-    expect(error.issues[0]?.statusCode).toBe(statusCode);
-  });
-
-  it("sets the cause", () => {
-    const cause = new Error("cause");
-
-    const error = new CbhError({ message: "boom", cause });
-
-    expect(error.cause).toBe(cause);
-  });
-
-  it("accpets an array", () => {
-    const message = "boom";
-
-    const error = new CbhError([{ message }]);
-
-    expect(error.message).toBe(message);
-  });
-});

package/src/lib/cbh-error.ts

@@ -1,26 +0,0 @@
-import { type OneOrNonEmptyArray, toNonEmptyArray } from "./non-empty-array";
-
-const ERROR_STATUS_CODES = [400, 401, 403, 404, 409, 422, 429, 500] as const;
-export type ErrorStatusCode = (typeof ERROR_STATUS_CODES)[number];
-
-export interface CbhIssue {
-  cause?: Error;
-  id?: string;
-  message: string;
-  statusCode?: ErrorStatusCode;
-}
-
-export class CbhError extends Error {
-  public readonly issues: CbhIssue[];
-
-  constructor(issues: OneOrNonEmptyArray<CbhIssue>) {
-    const is = 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";
-  }
-}

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

@@ -1,25 +0,0 @@
-import { CbhError } from "./cbh-error";
-import { toErrorCbhResponse, toSuccessCbhResponse } from "./cbh-response";
-
-describe("toErrorCbhResponse", () => {
-  it("returns error", () => {
-    const message = "boom";
-
-    const response = toErrorCbhResponse({ message });
-
-    expect(response).toEqual({
-      success: false,
-      error: new CbhError({ message }),
-    });
-  });
-});
-
-describe("toSuccessCbhResponse", () => {
-  it("returns success", () => {
-    const message = "success";
-
-    const response = toSuccessCbhResponse({ message });
-
-    expect(response).toEqual({ success: true, data: { message } });
-  });
-});

package/src/lib/cbh-response.ts

@@ -1,15 +0,0 @@
-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 function toErrorCbhResponse(issues: OneOrNonEmptyArray<CbhIssue>): {
-  success: false;
-  error: CbhError;
-} {
-  return { success: false, error: new CbhError(issues) };
-}
-
-export function toSuccessCbhResponse<T>(data: T): { success: true; data: T } {
-  return { success: true, data };
-}

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

@@ -1,35 +0,0 @@
-import { isDefined, isNullOrUndefined } from "./defined-utils";
-
-const DEFINED_TEST_CASES = ["gandalf", " ", "", 42, 0, -0];
-
-describe("isNullOrUndefined", () => {
-  it.each(DEFINED_TEST_CASES)("returns false for (%s)", (value) => {
-    expect(isNullOrUndefined(value)).toBe(false);
-  });
-
-  it("returns true if null", () => {
-    // eslint-disable-next-line unicorn/no-null
-    expect(isNullOrUndefined(null)).toBe(true);
-  });
-
-  it("returns true if undefined", () => {
-    // eslint-disable-next-line unicorn/no-useless-undefined
-    expect(isNullOrUndefined(undefined)).toBe(true);
-  });
-});
-
-describe("isDefined", () => {
-  it.each(DEFINED_TEST_CASES)("returns true for (%s)", (value) => {
-    expect(isDefined(value)).toBe(true);
-  });
-
-  it("returns false if undefined", () => {
-    // eslint-disable-next-line unicorn/no-null
-    expect(isDefined(null)).toBe(false);
-  });
-
-  it("returns false if null", () => {
-    // eslint-disable-next-line unicorn/no-useless-undefined
-    expect(isDefined(undefined)).toBe(false);
-  });
-});

package/src/lib/delay.spec.ts

@@ -1,11 +0,0 @@
-import { delay } from "./delay";
-
-describe("delay", () => {
-  it("should wait for the specified time", async () => {
-    const start = Date.now();
-
-    await delay(10);
-
-    expect(Date.now() - start).toBeGreaterThanOrEqual(10);
-  });
-});

package/src/lib/delay.ts

@@ -1,5 +0,0 @@
-export async function delay(milliseconds: number): Promise<void> {
-  await new Promise((resolve) => {
-    setTimeout(resolve, milliseconds);
-  });
-}

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

@@ -1,8 +0,0 @@
-import { forceCast } from "./force-cast";
-
-describe("forceCast", () => {
-  it("doesn't actually change type", () => {
-    const a: number = forceCast<number>("a");
-    expect(typeof a).toBe("string");
-  });
-});

package/src/lib/force-cast.ts

@@ -1,4 +0,0 @@
-/** Force cast to the provided type. */
-export function forceCast<T>(value: unknown): T {
-  return value as T;
-}

package/src/lib/head.spec.ts

@@ -1,21 +0,0 @@
-import { head } from "./head";
-
-describe("head", () => {
-  it("returns head of list", () => {
-    expect(head([1, 2])).toBe(1);
-  });
-
-  it("returns undefined if empty list", () => {
-    // eslint-disable-next-line @typescript-eslint/no-confusing-void-expression
-    expect(head([])).toBeUndefined();
-  });
-
-  it("returns undefined if passed", () => {
-    expect(head()).toBeUndefined();
-  });
-
-  it("returns value if not an array", () => {
-    const value = { hi: "there" };
-    expect(head(value)).toEqual(value);
-  });
-});

package/src/lib/head.ts

@@ -1,5 +0,0 @@
-export type OneOrArray<T> = T | T[];
-
-export function head<T>(value?: OneOrArray<T>): T | undefined {
-  return Array.isArray(value) ? value[0] : (value ?? undefined);
-}

package/src/lib/identity.spec.ts

@@ -1,17 +0,0 @@
-import { identity } from "./identity";
-
-describe("identity", () => {
-  it("returns the provided input", () => {
-    expect(identity(1)).toBe(1);
-    expect(identity("text")).toBe("text");
-    expect(identity({})).toStrictEqual({});
-  });
-
-  it("should correctly infer the type", () => {
-    const a = 1;
-    expect(typeof a).toBe("number");
-
-    const b = identity(a);
-    expect(typeof b).toBe("number");
-  });
-});

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

@@ -1,11 +0,0 @@
-import { isString } from "./is-string";
-
-describe("isString", () => {
-  it("returns true", () => {
-    expect(isString("hi")).toBe(true);
-  });
-
-  it("returns false", () => {
-    expect(isString({})).toBe(false);
-  });
-});

package/src/lib/is-string.ts

@@ -1,3 +0,0 @@
-export function isString(value: unknown): value is string {
-  return typeof value === "string" || value instanceof String;
-}

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

@@ -1,7 +0,0 @@
-export type NonEmptyArray<T> = [T, ...T[]];
-
-export type OneOrNonEmptyArray<T> = T | NonEmptyArray<T>;
-
-export function toNonEmptyArray<T>(value: OneOrNonEmptyArray<T>): NonEmptyArray<T> {
-  return Array.isArray(value) ? value : [value];
-}

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

@@ -1,33 +0,0 @@
-import { nullToUndefined } from "./null-to-undefined";
-
-describe("nullToUndefined", () => {
-  it("returns undefined", async () => {
-    // eslint-disable-next-line unicorn/no-null
-    expect(await nullToUndefined(Promise.resolve(null))).toBeUndefined();
-  });
-
-  it("returns value", async () => {
-    const expected = "hi";
-
-    expect(await nullToUndefined(Promise.resolve(expected))).toBe(expected);
-  });
-
-  it("supports PromiseLike objects", async () => {
-    const expected = "hello";
-
-    const promiseLike: PromiseLike<string> = {
-      // eslint-disable-next-line unicorn/no-thenable
-      then: function <TResult1, TResult2>(
-        onfulfilled?: ((value: string) => TResult1 | PromiseLike<TResult1>) | undefined,
-      ): PromiseLike<TResult1 | TResult2> {
-        if (onfulfilled) {
-          return Promise.resolve(onfulfilled(expected));
-        }
-
-        return Promise.reject();
-      },
-    };
-
-    expect(await nullToUndefined(promiseLike)).toBe(expected);
-  });
-});

package/src/lib/stringify.spec.ts

@@ -1,11 +0,0 @@
-import { stringify } from "./stringify";
-
-describe("stringify", () => {
-  test.each([
-    [1n, '"1"'],
-    [{ a: 1 }, '{"a":1}'],
-    [{ a: 1n }, '{"a":"1"}'],
-  ])("stringify(%i, %i)", (value, expected) => {
-    expect(stringify(value)).toBe(expected);
-  });
-});

package/src/lib/stringify.ts

@@ -1,5 +0,0 @@
-export function stringify(value: unknown): string {
-  return JSON.stringify(value, (_, value: unknown) =>
-    typeof value === "bigint" ? String(value) : value,
-  );
-}

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

@@ -1,28 +0,0 @@
-import { stringify } from "./stringify";
-import { toErrorMessage } from "./to-error";
-
-const MESSAGE = "hi";
-
-describe("toErrorMessage", () => {
-  it("returns message", () => {
-    expect(toErrorMessage(new Error(MESSAGE))).toEqual(MESSAGE);
-  });
-
-  it("returns message if non-error object", () => {
-    const error = { hello: MESSAGE };
-
-    expect(toErrorMessage(error)).toEqual(stringify(error));
-  });
-
-  it("returns message if unable to stringify", () => {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const circularReference = { a: { b: "c" }, d: {} } as any;
-    circularReference.a.d = circularReference.a;
-
-    expect(toErrorMessage(circularReference)).toBe("[object Object]");
-  });
-
-  it("returns message if string", () => {
-    expect(toErrorMessage(MESSAGE)).toEqual(MESSAGE);
-  });
-});

package/src/lib/to-error.ts

@@ -1,20 +0,0 @@
-import { isString } from "./is-string";
-import { stringify } from "./stringify";
-
-export function isError(error: unknown): error is Error {
-  return error instanceof Error;
-}
-
-export function toError(error: unknown): Error {
-  if (isError(error)) return error;
-
-  try {
-    return new Error(isString(error) ? error : stringify(error));
-  } catch {
-    return new Error(String(error));
-  }
-}
-
-export function toErrorMessage(error: unknown): string {
-  return toError(error).message;
-}

package/tsconfig.json

@@ -1,19 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": {
-    "outDir": "../../dist/out-tsc"
-  },
-  "files": [],
-  "include": [],
-  "references": [
-    {
-      "path": "./tsconfig.lib.json"
-    },
-    {
-      "path": "./tsconfig.lint.json"
-    },
-    {
-      "path": "./tsconfig.spec.json"
-    }
-  ]
-}

package/tsconfig.lib.json

@@ -1,8 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "types": ["node"]
-  },
-  "include": ["src/**/*.ts"],
-  "exclude": ["src/**/*.spec.ts", "src/**/*.test.ts"]
-}

package/tsconfig.lint.json

@@ -1,7 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "types": ["jest", "node"]
-  },
-  "include": ["."]
-}

package/tsconfig.spec.json

@@ -1,13 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "types": ["jest", "node"]
-  },
-  "include": [
-    "jest.config.ts",
-    "src/**/*.test.ts",
-    "src/**/*.spec.ts",
-    "src/**/*.d.ts",
-    "src/lib/types.ts"
-  ]
-}

package/typedoc.json

@@ -1,4 +0,0 @@
-{
-  "extends": ["../../typedoc.base.json"],
-  "entryPoints": ["src/index.ts"]
-}