@prisma-next/utils 0.3.0-dev.34 → 0.3.0-dev.36

package/dist/abortable.d.mts

@@ -0,0 +1,28 @@
+//#region src/abortable.d.ts
+/**
+ * Allows aborting an async operation by returning a Promise which rejects if
+ * the provided AbortSignal aborts and otherwise resolves with the result of
+ * the async operation.
+ *
+ * Throws immediately if the signal is already aborted.
+ * When the signal is aborted later, any wrapped promise will reject with
+ * the signal's reason (or a default DOMException).
+ *
+ * @example
+ * ```typescript
+ * const { signal = new AbortController().signal } = options;
+ * const unlessAborted = abortable(signal);
+ *
+ * // Any of these will reject if signal is aborted
+ * await unlessAborted(asyncOperation());
+ * await unlessAborted(fetch(url));
+ * ```
+ *
+ * @param signal - The AbortSignal to race against
+ * @returns A function that wraps promises to be cancelable
+ * @throws If signal is already aborted
+ */
+declare function abortable(signal: AbortSignal): <T>(promise: Promise<T>) => Promise<T>;
+//#endregion
+export { abortable };
+//# sourceMappingURL=abortable.d.mts.map

package/dist/abortable.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abortable.d.mts","names":[],"sources":["../src/abortable.ts"],"sourcesContent":[],"mappings":";;AAuBA;;;;;;;;;;;;;;;;;;;;;;iBAAgB,SAAA,SAAkB,2BAA2B,QAAQ,OAAO,QAAQ"}

package/dist/abortable.mjs

@@ -0,0 +1,39 @@
+//#region src/abortable.ts
+/**
+* Allows aborting an async operation by returning a Promise which rejects if
+* the provided AbortSignal aborts and otherwise resolves with the result of
+* the async operation.
+*
+* Throws immediately if the signal is already aborted.
+* When the signal is aborted later, any wrapped promise will reject with
+* the signal's reason (or a default DOMException).
+*
+* @example
+* ```typescript
+* const { signal = new AbortController().signal } = options;
+* const unlessAborted = abortable(signal);
+*
+* // Any of these will reject if signal is aborted
+* await unlessAborted(asyncOperation());
+* await unlessAborted(fetch(url));
+* ```
+*
+* @param signal - The AbortSignal to race against
+* @returns A function that wraps promises to be cancelable
+* @throws If signal is already aborted
+*/
+function abortable(signal) {
+	signal.throwIfAborted();
+	const abortPromise = new Promise((_resolve, reject) => {
+		signal.addEventListener("abort", () => {
+			reject(signal.reason ?? new DOMException("Operation cancelled"));
+		}, { once: true });
+	});
+	return (operation) => {
+		return Promise.race([operation, abortPromise]);
+	};
+}
+
+//#endregion
+export { abortable };
+//# sourceMappingURL=abortable.mjs.map

package/dist/abortable.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"abortable.mjs","names":[],"sources":["../src/abortable.ts"],"sourcesContent":["/**\n * Allows aborting an async operation by returning a Promise which rejects if\n * the provided AbortSignal aborts and otherwise resolves with the result of\n * the async operation.\n *\n * Throws immediately if the signal is already aborted.\n * When the signal is aborted later, any wrapped promise will reject with\n * the signal's reason (or a default DOMException).\n *\n * @example\n * ```typescript\n * const { signal = new AbortController().signal } = options;\n * const unlessAborted = abortable(signal);\n *\n * // Any of these will reject if signal is aborted\n * await unlessAborted(asyncOperation());\n * await unlessAborted(fetch(url));\n * ```\n *\n * @param signal - The AbortSignal to race against\n * @returns A function that wraps promises to be cancelable\n * @throws If signal is already aborted\n */\nexport function abortable(signal: AbortSignal): <T>(promise: Promise<T>) => Promise<T> {\n  signal.throwIfAborted();\n\n  const abortPromise = new Promise<never>((_resolve, reject) => {\n    signal.addEventListener(\n      'abort',\n      () => {\n        reject(signal.reason ?? new DOMException('Operation cancelled'));\n      },\n      { once: true },\n    );\n  });\n\n  return <T>(operation: Promise<T>): Promise<T> => {\n    return Promise.race([operation, abortPromise]);\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,UAAU,QAA6D;AACrF,QAAO,gBAAgB;CAEvB,MAAM,eAAe,IAAI,SAAgB,UAAU,WAAW;AAC5D,SAAO,iBACL,eACM;AACJ,UAAO,OAAO,UAAU,IAAI,aAAa,sBAAsB,CAAC;KAElE,EAAE,MAAM,MAAM,CACf;GACD;AAEF,SAAW,cAAsC;AAC/C,SAAO,QAAQ,KAAK,CAAC,WAAW,aAAa,CAAC"}

package/dist/{defined-BuK2JPgV.mjs → defined-BSROFTyI.mjs}

@@ -27,4 +27,4 @@ function ifDefined(key, value) {
 
 //#endregion
 export { ifDefined as t };
-//# sourceMappingURL=defined-BuK2JPgV.mjs.map
+//# sourceMappingURL=defined-BSROFTyI.mjs.map

package/dist/{defined-BuK2JPgV.mjs.map → defined-BSROFTyI.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"defined-BuK2JPgV.mjs","names":[],"sources":["../src/defined.ts"],"sourcesContent":["/**\n * Returns an object with the key/value if value is defined, otherwise an empty object.\n *\n * Use with spread to conditionally include optional properties while satisfying\n * exactOptionalPropertyTypes. This is explicit about which properties are optional\n * and won't inadvertently strip other undefined values.\n *\n * @example\n * ```typescript\n * // Instead of:\n * const obj = {\n *   required: 'value',\n *   ...(optional ? { optional } : {}),\n * };\n *\n * // Use:\n * const obj = {\n *   required: 'value',\n *   ...ifDefined('optional', optional),\n * };\n * ```\n */\nexport function ifDefined<K extends string, V>(\n  key: K,\n  value: V | undefined,\n): Record<never, never> | { [P in K]: V } {\n  return value !== undefined ? ({ [key]: value } as { [P in K]: V }) : {};\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,UACd,KACA,OACwC;AACxC,QAAO,UAAU,SAAa,GAAG,MAAM,OAAO,GAAuB,EAAE"}
+{"version":3,"file":"defined-BSROFTyI.mjs","names":[],"sources":["../src/defined.ts"],"sourcesContent":["/**\n * Returns an object with the key/value if value is defined, otherwise an empty object.\n *\n * Use with spread to conditionally include optional properties while satisfying\n * exactOptionalPropertyTypes. This is explicit about which properties are optional\n * and won't inadvertently strip other undefined values.\n *\n * @example\n * ```typescript\n * // Instead of:\n * const obj = {\n *   required: 'value',\n *   ...(optional ? { optional } : {}),\n * };\n *\n * // Use:\n * const obj = {\n *   required: 'value',\n *   ...ifDefined('optional', optional),\n * };\n * ```\n */\nexport function ifDefined<K extends string, V>(\n  key: K,\n  value: V | undefined,\n): Record<never, never> | { [P in K]: V } {\n  return value !== undefined ? ({ [key]: value } as { [P in K]: V }) : {};\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,UACd,KACA,OACwC;AACxC,QAAO,UAAU,SAAa,GAAG,MAAM,OAAO,GAAuB,EAAE"}

package/dist/defined.mjs

@@ -1,3 +1,3 @@
-import { t as ifDefined } from "./defined-BuK2JPgV.mjs";
+import { t as ifDefined } from "./defined-BSROFTyI.mjs";
 
 export { ifDefined };

package/dist/redact-db-url.mjs

@@ -1,4 +1,4 @@
-import { t as ifDefined } from "./defined-BuK2JPgV.mjs";
+import { t as ifDefined } from "./defined-BSROFTyI.mjs";
 
 //#region src/redact-db-url.ts
 /**

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@prisma-next/utils",
-  "version": "0.3.0-dev.34",
+  "version": "0.3.0-dev.36",
   "type": "module",
   "sideEffects": false,
   "description": "Shared utility functions for Prisma Next",
   "devDependencies": {
     "tsdown": "0.18.4",
     "typescript": "5.9.3",
-    "vitest": "4.0.16",
+    "vitest": "4.0.17",
     "@prisma-next/tsconfig": "0.0.0",
     "@prisma-next/tsdown": "0.0.0"
   },
@@ -19,6 +19,7 @@
     "node": ">=20"
   },
   "exports": {
+    "./abortable": "./dist/abortable.mjs",
     "./array-equal": "./dist/array-equal.mjs",
     "./assertions": "./dist/assertions.mjs",
     "./defined": "./dist/defined.mjs",
@@ -26,6 +27,11 @@
     "./result": "./dist/result.mjs",
     "./package.json": "./package.json"
   },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/prisma/prisma-next.git",
+    "directory": "packages/1-framework/1-core/shared/utils"
+  },
   "scripts": {
     "build": "tsdown",
     "test": "vitest run",

package/src/abortable.ts

@@ -0,0 +1,40 @@
+/**
+ * Allows aborting an async operation by returning a Promise which rejects if
+ * the provided AbortSignal aborts and otherwise resolves with the result of
+ * the async operation.
+ *
+ * Throws immediately if the signal is already aborted.
+ * When the signal is aborted later, any wrapped promise will reject with
+ * the signal's reason (or a default DOMException).
+ *
+ * @example
+ * ```typescript
+ * const { signal = new AbortController().signal } = options;
+ * const unlessAborted = abortable(signal);
+ *
+ * // Any of these will reject if signal is aborted
+ * await unlessAborted(asyncOperation());
+ * await unlessAborted(fetch(url));
+ * ```
+ *
+ * @param signal - The AbortSignal to race against
+ * @returns A function that wraps promises to be cancelable
+ * @throws If signal is already aborted
+ */
+export function abortable(signal: AbortSignal): <T>(promise: Promise<T>) => Promise<T> {
+  signal.throwIfAborted();
+
+  const abortPromise = new Promise<never>((_resolve, reject) => {
+    signal.addEventListener(
+      'abort',
+      () => {
+        reject(signal.reason ?? new DOMException('Operation cancelled'));
+      },
+      { once: true },
+    );
+  });
+
+  return <T>(operation: Promise<T>): Promise<T> => {
+    return Promise.race([operation, abortPromise]);
+  };
+}

package/src/exports/abortable.ts

@@ -0,0 +1 @@
+export { abortable } from '../abortable';