@nlozgachev/pipelined 0.46.0 → 0.48.0

package/dist/index.mjs

@@ -24,18 +24,22 @@ import {
   or,
   pipe,
   tap,
+  tuple,
   uncurry,
   uncurry3,
-  uncurry4
-} from "./chunk-KOYYDQH4.mjs";
+  uncurry4,
+  untuple
+} from "./chunk-5OFVS5UZ.mjs";
 import {
   Arr,
+  BigNum,
   Dict,
+  Json,
   Num,
   Rec,
   Str,
   Uniq
-} from "./chunk-W2L244AS.mjs";
+} from "./chunk-UGVU2RTM.mjs";
 import {
   Combinable,
   Deferred,
@@ -61,19 +65,22 @@ import {
   These,
   Tuple,
   Validation
-} from "./chunk-VSU36S2K.mjs";
+} from "./chunk-LR63GW6J.mjs";
 import {
   Brand,
-  Duration
-} from "./chunk-XTVF5R6R.mjs";
+  Duration,
+  RetryPolicy
+} from "./chunk-DENXUTKL.mjs";
 export {
   Arr,
+  BigNum,
   Brand,
   Combinable,
   Deferred,
   Dict,
   Duration,
   Equality,
+  Json,
   Lazy,
   Lens,
   Logged,
@@ -89,6 +96,7 @@ export {
   RemoteData,
   Resource,
   Result,
+  RetryPolicy,
   State,
   Str,
   Task,
@@ -124,7 +132,9 @@ export {
   or,
   pipe,
   tap,
+  tuple,
   uncurry,
   uncurry3,
-  uncurry4
+  uncurry4,
+  untuple
 };

package/dist/types.d.mts

@@ -1,129 +1,58 @@
-declare const _brand: unique symbol;
-/**
- * Brand<K, T> creates a nominal type by tagging T with a phantom brand K.
- * Prevents accidentally mixing up values that share the same underlying type.
- *
- * @example
- * ```ts
- * type UserId = Brand<"UserId", string>;
- * type ProductId = Brand<"ProductId", string>;
- *
- * const toUserId = Brand.wrap<"UserId", string>();
- * const toProductId = Brand.wrap<"ProductId", string>();
- *
- * const userId: UserId = toUserId("user-123");
- * const productId: ProductId = toProductId("prod-456");
- *
- * // Type error: ProductId is not assignable to UserId
- * // const wrong: UserId = productId;
- * ```
- */
-type Brand<K extends string, T> = T & {
-    readonly [_brand]: K;
-};
-declare namespace Brand {
-    /**
-     * Returns a constructor that wraps a value of type T in brand K.
-     * The resulting function performs an unchecked cast — only use when the raw
-     * value is known to satisfy the brand's invariants.
-     *
-     * @example
-     * ```ts
-     * type PositiveNumber = Brand<"PositiveNumber", number>;
-     * const toPositiveNumber = Brand.wrap<"PositiveNumber", number>();
-     *
-     * const n: PositiveNumber = toPositiveNumber(42);
-     * ```
-     */
-    const wrap: <K extends string, T>() => (value: T) => Brand<K, T>;
-    /**
-     * Strips the brand and returns the underlying value.
-     * Since Brand<K, T> extends T this is rarely needed, but can improve readability.
-     *
-     * @example
-     * ```ts
-     * const userId: UserId = toUserId("user-123");
-     * const raw: string = Brand.unwrap(userId); // "user-123"
-     * ```
-     */
-    const unwrap: <K extends string, T>(branded: Brand<K, T>) => T;
-}
+import { D as Duration } from './Duration-B8joKzro.mjs';
+export { B as Brand } from './Duration-B8joKzro.mjs';
 
 /**
- * A branded nominal type representing a duration of time in milliseconds.
- * Use Duration to ensure safe time-based operators and clear unit conversions.
+ * An immutable policy describing retry limits and backoff delay strategies.
  *
  * @example
  * ```ts
- * const halfSecond = Duration.milliseconds(500);
- * const twoSeconds = Duration.seconds(2);
- * const total = pipe(halfSecond, Duration.add(twoSeconds));
- *
- * Duration.to.seconds(total); // 2.5
+ * const policy: RetryPolicy = RetryPolicy.constant({
+ *   attempts: 3,
+ *   delay: Duration.seconds(1),
+ * });
  * ```
  */
-type Duration = Brand<"Duration", number>;
-declare namespace Duration {
-    /**
-     * Creates a Duration from milliseconds.
-     */
-    const milliseconds: (ms: number) => Duration;
-    /**
-     * Creates a Duration from seconds.
-     */
-    const seconds: (s: number) => Duration;
-    /**
-     * Creates a Duration from minutes.
-     */
-    const minutes: (m: number) => Duration;
-    /**
-     * Creates a Duration from hours.
-     */
-    const hours: (h: number) => Duration;
-    /**
-     * Creates a Duration from days.
-     */
-    const days: (d: number) => Duration;
-    namespace to {
-        /**
-         * Converts a Duration back to raw milliseconds.
-         */
-        const milliseconds: (d: Duration) => number;
-        /**
-         * Converts a Duration to seconds.
-         */
-        const seconds: (d: Duration) => number;
-        /**
-         * Converts a Duration to minutes.
-         */
-        const minutes: (d: Duration) => number;
-        /**
-         * Converts a Duration to hours.
-         */
-        const hours: (d: Duration) => number;
-        /**
-         * Converts a Duration to days.
-         */
-        const days: (d: Duration) => number;
-    }
+type RetryPolicy = {
+    readonly attempts: number;
+    readonly getDelay: (attempt: number) => Duration;
+};
+declare namespace RetryPolicy {
     /**
-     * Adds two Durations together.
+     * Creates a RetryPolicy with a constant delay between retry attempts.
      *
      * @example
      * ```ts
-     * pipe(Duration.seconds(1), Duration.add(Duration.milliseconds(500))); // 1500ms
+     * const policy = RetryPolicy.constant({
+     *   attempts: 3,
+     *   delay: Duration.seconds(1),
+     * });
      * ```
      */
-    const add: (other: Duration) => (self: Duration) => Duration;
+    const constant: (options: {
+        attempts: number;
+        delay: Duration;
+    }) => RetryPolicy;
     /**
-     * Subtracts the other Duration from this one.
+     * Creates a RetryPolicy with exponential backoff delays between attempts.
+     * An optional `factor` (default 2) controls the growth rate.
+     * An optional `jitter` (default false) adds randomized variance to prevent thundering herd problems.
      *
      * @example
      * ```ts
-     * pipe(Duration.seconds(1), Duration.subtract(Duration.milliseconds(500))); // 500ms
+     * const policy = RetryPolicy.exponential({
+     *   attempts: 5,
+     *   initial: Duration.milliseconds(100),
+     *   factor: 2,
+     *   jitter: true,
+     * });
      * ```
      */
-    const subtract: (other: Duration) => (self: Duration) => Duration;
+    const exponential: (options: {
+        attempts: number;
+        initial: Duration;
+        factor?: number;
+        jitter?: boolean;
+    }) => RetryPolicy;
 }
 
-export { Brand, Duration };
+export { Duration, RetryPolicy };

package/dist/types.d.ts

@@ -1,129 +1,58 @@
-declare const _brand: unique symbol;
-/**
- * Brand<K, T> creates a nominal type by tagging T with a phantom brand K.
- * Prevents accidentally mixing up values that share the same underlying type.
- *
- * @example
- * ```ts
- * type UserId = Brand<"UserId", string>;
- * type ProductId = Brand<"ProductId", string>;
- *
- * const toUserId = Brand.wrap<"UserId", string>();
- * const toProductId = Brand.wrap<"ProductId", string>();
- *
- * const userId: UserId = toUserId("user-123");
- * const productId: ProductId = toProductId("prod-456");
- *
- * // Type error: ProductId is not assignable to UserId
- * // const wrong: UserId = productId;
- * ```
- */
-type Brand<K extends string, T> = T & {
-    readonly [_brand]: K;
-};
-declare namespace Brand {
-    /**
-     * Returns a constructor that wraps a value of type T in brand K.
-     * The resulting function performs an unchecked cast — only use when the raw
-     * value is known to satisfy the brand's invariants.
-     *
-     * @example
-     * ```ts
-     * type PositiveNumber = Brand<"PositiveNumber", number>;
-     * const toPositiveNumber = Brand.wrap<"PositiveNumber", number>();
-     *
-     * const n: PositiveNumber = toPositiveNumber(42);
-     * ```
-     */
-    const wrap: <K extends string, T>() => (value: T) => Brand<K, T>;
-    /**
-     * Strips the brand and returns the underlying value.
-     * Since Brand<K, T> extends T this is rarely needed, but can improve readability.
-     *
-     * @example
-     * ```ts
-     * const userId: UserId = toUserId("user-123");
-     * const raw: string = Brand.unwrap(userId); // "user-123"
-     * ```
-     */
-    const unwrap: <K extends string, T>(branded: Brand<K, T>) => T;
-}
+import { D as Duration } from './Duration-B8joKzro.js';
+export { B as Brand } from './Duration-B8joKzro.js';
 
 /**
- * A branded nominal type representing a duration of time in milliseconds.
- * Use Duration to ensure safe time-based operators and clear unit conversions.
+ * An immutable policy describing retry limits and backoff delay strategies.
  *
  * @example
  * ```ts
- * const halfSecond = Duration.milliseconds(500);
- * const twoSeconds = Duration.seconds(2);
- * const total = pipe(halfSecond, Duration.add(twoSeconds));
- *
- * Duration.to.seconds(total); // 2.5
+ * const policy: RetryPolicy = RetryPolicy.constant({
+ *   attempts: 3,
+ *   delay: Duration.seconds(1),
+ * });
  * ```
  */
-type Duration = Brand<"Duration", number>;
-declare namespace Duration {
-    /**
-     * Creates a Duration from milliseconds.
-     */
-    const milliseconds: (ms: number) => Duration;
-    /**
-     * Creates a Duration from seconds.
-     */
-    const seconds: (s: number) => Duration;
-    /**
-     * Creates a Duration from minutes.
-     */
-    const minutes: (m: number) => Duration;
-    /**
-     * Creates a Duration from hours.
-     */
-    const hours: (h: number) => Duration;
-    /**
-     * Creates a Duration from days.
-     */
-    const days: (d: number) => Duration;
-    namespace to {
-        /**
-         * Converts a Duration back to raw milliseconds.
-         */
-        const milliseconds: (d: Duration) => number;
-        /**
-         * Converts a Duration to seconds.
-         */
-        const seconds: (d: Duration) => number;
-        /**
-         * Converts a Duration to minutes.
-         */
-        const minutes: (d: Duration) => number;
-        /**
-         * Converts a Duration to hours.
-         */
-        const hours: (d: Duration) => number;
-        /**
-         * Converts a Duration to days.
-         */
-        const days: (d: Duration) => number;
-    }
+type RetryPolicy = {
+    readonly attempts: number;
+    readonly getDelay: (attempt: number) => Duration;
+};
+declare namespace RetryPolicy {
     /**
-     * Adds two Durations together.
+     * Creates a RetryPolicy with a constant delay between retry attempts.
      *
      * @example
      * ```ts
-     * pipe(Duration.seconds(1), Duration.add(Duration.milliseconds(500))); // 1500ms
+     * const policy = RetryPolicy.constant({
+     *   attempts: 3,
+     *   delay: Duration.seconds(1),
+     * });
      * ```
      */
-    const add: (other: Duration) => (self: Duration) => Duration;
+    const constant: (options: {
+        attempts: number;
+        delay: Duration;
+    }) => RetryPolicy;
     /**
-     * Subtracts the other Duration from this one.
+     * Creates a RetryPolicy with exponential backoff delays between attempts.
+     * An optional `factor` (default 2) controls the growth rate.
+     * An optional `jitter` (default false) adds randomized variance to prevent thundering herd problems.
      *
      * @example
      * ```ts
-     * pipe(Duration.seconds(1), Duration.subtract(Duration.milliseconds(500))); // 500ms
+     * const policy = RetryPolicy.exponential({
+     *   attempts: 5,
+     *   initial: Duration.milliseconds(100),
+     *   factor: 2,
+     *   jitter: true,
+     * });
      * ```
      */
-    const subtract: (other: Duration) => (self: Duration) => Duration;
+    const exponential: (options: {
+        attempts: number;
+        initial: Duration;
+        factor?: number;
+        jitter?: boolean;
+    }) => RetryPolicy;
 }
 
-export { Brand, Duration };
+export { Duration, RetryPolicy };

package/dist/types.js

@@ -21,7 +21,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var Types_exports = {};
 __export(Types_exports, {
   Brand: () => Brand,
-  Duration: () => Duration
+  Duration: () => Duration,
+  RetryPolicy: () => RetryPolicy
 });
 module.exports = __toCommonJS(Types_exports);
 
@@ -52,8 +53,32 @@ var Duration;
   Duration2.add = (other) => (self) => wrap(Brand.unwrap(self) + Brand.unwrap(other));
   Duration2.subtract = (other) => (self) => wrap(Brand.unwrap(self) - Brand.unwrap(other));
 })(Duration || (Duration = {}));
+
+// src/Types/RetryPolicy.ts
+var RetryPolicy;
+((RetryPolicy2) => {
+  RetryPolicy2.constant = (options) => ({
+    attempts: Math.max(1, options.attempts),
+    getDelay: () => options.delay
+  });
+  RetryPolicy2.exponential = (options) => {
+    const attempts = Math.max(1, options.attempts);
+    const initialMs = Duration.to.milliseconds(options.initial);
+    const factor = options.factor ?? 2;
+    const jitter = options.jitter ?? false;
+    return {
+      attempts,
+      getDelay: (attempt) => {
+        const rawMs = initialMs * factor ** Math.max(0, attempt - 1);
+        const finalMs = jitter ? Math.random() * rawMs : rawMs;
+        return Duration.milliseconds(finalMs);
+      }
+    };
+  };
+})(RetryPolicy || (RetryPolicy = {}));
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Brand,
-  Duration
+  Duration,
+  RetryPolicy
 });

package/dist/types.mjs

@@ -1,8 +1,10 @@
 import {
   Brand,
-  Duration
-} from "./chunk-XTVF5R6R.mjs";
+  Duration,
+  RetryPolicy
+} from "./chunk-DENXUTKL.mjs";
 export {
   Brand,
-  Duration
+  Duration,
+  RetryPolicy
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nlozgachev/pipelined",
-	"version": "0.46.0",
+	"version": "0.48.0",
 	"description": "Opinionated functional abstractions for TypeScript",
 	"license": "BSD-3-Clause",
 	"homepage": "https://pipelined.lozgachev.dev",
@@ -41,10 +41,10 @@
 			"import": "./dist/core.mjs",
 			"require": "./dist/core.cjs"
 		},
-		"./utils": {
-			"types": "./dist/utils.d.ts",
-			"import": "./dist/utils.mjs",
-			"require": "./dist/utils.cjs"
+		"./data": {
+			"types": "./dist/data.d.ts",
+			"import": "./dist/data.mjs",
+			"require": "./dist/data.cjs"
 		},
 		"./types": {
 			"types": "./dist/types.d.ts",
@@ -84,7 +84,7 @@
 		{ "path": "dist/index.js", "limit": "25 KB", "gzip": true },
 		{ "path": "dist/core.js", "limit": "15 KB", "gzip": true },
 		{ "path": "dist/composition.js", "limit": "4 KB", "gzip": true },
-		{ "path": "dist/utils.js", "limit": "12 KB", "gzip": true },
+		{ "path": "dist/data.js", "limit": "12 KB", "gzip": true },
 		{ "path": "dist/types.js", "limit": "1 KB", "gzip": true }
 	],
 	"packageManager": "pnpm@11.6.0+sha512.9a36518224080c6fe5165afdcfe79bfa118c29be703f3f462b1e32efe1e98e47e8750b148e08286250aad4113cc7993ca413c4e2cd447752708c2ee5751bc95f"

package/dist/utils.mjs

@@ -1,18 +0,0 @@
-import {
-  Arr,
-  Dict,
-  Num,
-  Rec,
-  Str,
-  Uniq
-} from "./chunk-W2L244AS.mjs";
-import "./chunk-VSU36S2K.mjs";
-import "./chunk-XTVF5R6R.mjs";
-export {
-  Arr,
-  Dict,
-  Num,
-  Rec,
-  Str,
-  Uniq
-};