@nlozgachev/pipelined 0.62.0 → 0.63.0

package/dist/types.cjs

@@ -27,41 +27,185 @@ __export(Types_exports, {
 module.exports = __toCommonJS(Types_exports);
 
 // src/Types/Brand.ts
-var Brand;
-((Brand2) => {
-  Brand2.wrap = () => (value) => value;
-  Brand2.unwrap = (branded) => branded;
-})(Brand || (Brand = {}));
+var 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);
+   * ```
+   */
+  wrap: () => (value) => value,
+  /**
+   * Strips the brand and returns the underlying value.
+   * Since Brand<K, T> extends T this is rarely needed, but can improve readability.
+   *
+   * @example
+   * ```ts
+   * type UserId = Brand<"UserId", string>;
+   * const toUserId = Brand.wrap<"UserId", string>();
+   * const userId: UserId = toUserId("user-123");
+   * const raw: string = Brand.unwrap(userId); // "user-123"
+   * ```
+   */
+  unwrap: (branded) => branded
+};
 
 // src/Types/Duration.ts
-var Duration;
-((Duration2) => {
-  const wrap = Brand.wrap();
-  Duration2.milliseconds = (ms) => wrap(ms);
-  Duration2.seconds = (s) => wrap(s * 1e3);
-  Duration2.minutes = (m) => wrap(m * 60 * 1e3);
-  Duration2.hours = (h) => wrap(h * 60 * 60 * 1e3);
-  Duration2.days = (d) => wrap(d * 24 * 60 * 60 * 1e3);
-  let to;
-  ((to2) => {
-    to2.milliseconds = (d) => Brand.unwrap(d);
-    to2.seconds = (d) => Brand.unwrap(d) / 1e3;
-    to2.minutes = (d) => Brand.unwrap(d) / (60 * 1e3);
-    to2.hours = (d) => Brand.unwrap(d) / (60 * 60 * 1e3);
-    to2.days = (d) => Brand.unwrap(d) / (24 * 60 * 60 * 1e3);
-  })(to = Duration2.to || (Duration2.to = {}));
-  Duration2.add = (other) => (self) => wrap(Brand.unwrap(self) + Brand.unwrap(other));
-  Duration2.subtract = (other) => (self) => wrap(Brand.unwrap(self) - Brand.unwrap(other));
-})(Duration || (Duration = {}));
+var wrap = Brand.wrap();
+var Duration = {
+  /**
+   * Creates a Duration from milliseconds.
+   *
+   * @example
+   * ```ts
+   * Duration.milliseconds(500); // 500ms Duration
+   * ```
+   */
+  milliseconds: (ms) => wrap(ms),
+  /**
+   * Creates a Duration from seconds.
+   *
+   * @example
+   * ```ts
+   * Duration.seconds(2); // 2000ms Duration
+   * ```
+   */
+  seconds: (s) => wrap(s * 1e3),
+  /**
+   * Creates a Duration from minutes.
+   *
+   * @example
+   * ```ts
+   * Duration.minutes(5); // 300000ms Duration
+   * ```
+   */
+  minutes: (m) => wrap(m * 60 * 1e3),
+  /**
+   * Creates a Duration from hours.
+   *
+   * @example
+   * ```ts
+   * Duration.hours(1); // 3600000ms Duration
+   * ```
+   */
+  hours: (h) => wrap(h * 60 * 60 * 1e3),
+  /**
+   * Creates a Duration from days.
+   *
+   * @example
+   * ```ts
+   * Duration.days(1); // 86400000ms Duration
+   * ```
+   */
+  days: (d) => wrap(d * 24 * 60 * 60 * 1e3),
+  // --- to ---
+  to: {
+    /**
+     * Converts a Duration back to raw milliseconds.
+     *
+     * @example
+     * ```ts
+     * Duration.to.milliseconds(Duration.seconds(2)); // 2000
+     * ```
+     */
+    milliseconds: (d) => Brand.unwrap(d),
+    /**
+     * Converts a Duration to seconds.
+     *
+     * @example
+     * ```ts
+     * Duration.to.seconds(Duration.milliseconds(2500)); // 2.5
+     * ```
+     */
+    seconds: (d) => Brand.unwrap(d) / 1e3,
+    /**
+     * Converts a Duration to minutes.
+     *
+     * @example
+     * ```ts
+     * Duration.to.minutes(Duration.seconds(120)); // 2
+     * ```
+     */
+    minutes: (d) => Brand.unwrap(d) / (60 * 1e3),
+    /**
+     * Converts a Duration to hours.
+     *
+     * @example
+     * ```ts
+     * Duration.to.hours(Duration.minutes(90)); // 1.5
+     * ```
+     */
+    hours: (d) => Brand.unwrap(d) / (60 * 60 * 1e3),
+    /**
+     * Converts a Duration to days.
+     *
+     * @example
+     * ```ts
+     * Duration.to.days(Duration.hours(36)); // 1.5
+     * ```
+     */
+    days: (d) => Brand.unwrap(d) / (24 * 60 * 60 * 1e3)
+  },
+  /**
+   * Adds two Durations together.
+   *
+   * @example
+   * ```ts
+   * pipe(Duration.seconds(1), Duration.add(Duration.milliseconds(500))); // 1500ms
+   * ```
+   */
+  add: (other) => (self) => wrap(Brand.unwrap(self) + Brand.unwrap(other)),
+  /**
+   * Subtracts the other Duration from this one.
+   *
+   * @example
+   * ```ts
+   * pipe(Duration.seconds(1), Duration.subtract(Duration.milliseconds(500))); // 500ms
+   * ```
+   */
+  subtract: (other) => (self) => wrap(Brand.unwrap(self) - Brand.unwrap(other))
+};
 
 // src/Types/RetryPolicy.ts
-var RetryPolicy;
-((RetryPolicy2) => {
-  RetryPolicy2.constant = (options) => ({
+var RetryPolicy = {
+  /**
+   * Creates a RetryPolicy with a constant delay between retry attempts.
+   *
+   * @example
+   * ```ts
+   * const policy = RetryPolicy.constant({
+   *   attempts: 3,
+   *   delay: Duration.seconds(1),
+   * });
+   * ```
+   */
+  constant: (options) => ({
     attempts: Math.max(1, options.attempts),
     getDelay: () => options.delay
-  });
-  RetryPolicy2.exponential = (options) => {
+  }),
+  /**
+   * 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
+   * const policy = RetryPolicy.exponential({
+   *   attempts: 5,
+   *   initial: Duration.milliseconds(100),
+   *   factor: 2,
+   *   jitter: true,
+   * });
+   * ```
+   */
+  exponential: (options) => {
     const attempts = Math.max(1, options.attempts);
     const initialMs = Duration.to.milliseconds(options.initial);
     const factor = options.factor ?? 2;
@@ -74,8 +218,8 @@ var RetryPolicy;
         return Duration.milliseconds(finalMs);
       }
     };
-  };
-})(RetryPolicy || (RetryPolicy = {}));
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Brand,

package/dist/types.d.cts

@@ -1,5 +1,5 @@
-import { D as Duration } from './Duration-B8joKzro.cjs';
-export { B as Brand } from './Duration-B8joKzro.cjs';
+import { D as Duration } from './Duration-DeyxG6VQ.cjs';
+export { B as Brand } from './Duration-DeyxG6VQ.cjs';
 
 /**
  * An immutable policy describing retry limits and backoff delay strategies.
@@ -16,7 +16,7 @@ type RetryPolicy = {
     readonly attempts: number;
     readonly getDelay: (attempt: number) => Duration;
 };
-declare namespace RetryPolicy {
+declare const RetryPolicy: {
     /**
      * Creates a RetryPolicy with a constant delay between retry attempts.
      *
@@ -28,7 +28,7 @@ declare namespace RetryPolicy {
      * });
      * ```
      */
-    const constant: (options: {
+    constant: (options: {
         attempts: number;
         delay: Duration;
     }) => RetryPolicy;
@@ -47,12 +47,12 @@ declare namespace RetryPolicy {
      * });
      * ```
      */
-    const exponential: (options: {
+    exponential: (options: {
         attempts: number;
         initial: Duration;
         factor?: number;
         jitter?: boolean;
     }) => RetryPolicy;
-}
+};
 
 export { Duration, RetryPolicy };

package/dist/types.d.ts

@@ -1,5 +1,5 @@
-import { D as Duration } from './Duration-B8joKzro.js';
-export { B as Brand } from './Duration-B8joKzro.js';
+import { D as Duration } from './Duration-DeyxG6VQ.js';
+export { B as Brand } from './Duration-DeyxG6VQ.js';
 
 /**
  * An immutable policy describing retry limits and backoff delay strategies.
@@ -16,7 +16,7 @@ type RetryPolicy = {
     readonly attempts: number;
     readonly getDelay: (attempt: number) => Duration;
 };
-declare namespace RetryPolicy {
+declare const RetryPolicy: {
     /**
      * Creates a RetryPolicy with a constant delay between retry attempts.
      *
@@ -28,7 +28,7 @@ declare namespace RetryPolicy {
      * });
      * ```
      */
-    const constant: (options: {
+    constant: (options: {
         attempts: number;
         delay: Duration;
     }) => RetryPolicy;
@@ -47,12 +47,12 @@ declare namespace RetryPolicy {
      * });
      * ```
      */
-    const exponential: (options: {
+    exponential: (options: {
         attempts: number;
         initial: Duration;
         factor?: number;
         jitter?: boolean;
     }) => RetryPolicy;
-}
+};
 
 export { Duration, RetryPolicy };

package/dist/types.mjs

@@ -1,39 +1,183 @@
 // src/Types/Brand.ts
-var Brand;
-((Brand2) => {
-  Brand2.wrap = () => (value) => value;
-  Brand2.unwrap = (branded) => branded;
-})(Brand || (Brand = {}));
+var 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);
+   * ```
+   */
+  wrap: () => (value) => value,
+  /**
+   * Strips the brand and returns the underlying value.
+   * Since Brand<K, T> extends T this is rarely needed, but can improve readability.
+   *
+   * @example
+   * ```ts
+   * type UserId = Brand<"UserId", string>;
+   * const toUserId = Brand.wrap<"UserId", string>();
+   * const userId: UserId = toUserId("user-123");
+   * const raw: string = Brand.unwrap(userId); // "user-123"
+   * ```
+   */
+  unwrap: (branded) => branded
+};
 
 // src/Types/Duration.ts
-var Duration;
-((Duration2) => {
-  const wrap = Brand.wrap();
-  Duration2.milliseconds = (ms) => wrap(ms);
-  Duration2.seconds = (s) => wrap(s * 1e3);
-  Duration2.minutes = (m) => wrap(m * 60 * 1e3);
-  Duration2.hours = (h) => wrap(h * 60 * 60 * 1e3);
-  Duration2.days = (d) => wrap(d * 24 * 60 * 60 * 1e3);
-  let to;
-  ((to2) => {
-    to2.milliseconds = (d) => Brand.unwrap(d);
-    to2.seconds = (d) => Brand.unwrap(d) / 1e3;
-    to2.minutes = (d) => Brand.unwrap(d) / (60 * 1e3);
-    to2.hours = (d) => Brand.unwrap(d) / (60 * 60 * 1e3);
-    to2.days = (d) => Brand.unwrap(d) / (24 * 60 * 60 * 1e3);
-  })(to = Duration2.to || (Duration2.to = {}));
-  Duration2.add = (other) => (self) => wrap(Brand.unwrap(self) + Brand.unwrap(other));
-  Duration2.subtract = (other) => (self) => wrap(Brand.unwrap(self) - Brand.unwrap(other));
-})(Duration || (Duration = {}));
+var wrap = Brand.wrap();
+var Duration = {
+  /**
+   * Creates a Duration from milliseconds.
+   *
+   * @example
+   * ```ts
+   * Duration.milliseconds(500); // 500ms Duration
+   * ```
+   */
+  milliseconds: (ms) => wrap(ms),
+  /**
+   * Creates a Duration from seconds.
+   *
+   * @example
+   * ```ts
+   * Duration.seconds(2); // 2000ms Duration
+   * ```
+   */
+  seconds: (s) => wrap(s * 1e3),
+  /**
+   * Creates a Duration from minutes.
+   *
+   * @example
+   * ```ts
+   * Duration.minutes(5); // 300000ms Duration
+   * ```
+   */
+  minutes: (m) => wrap(m * 60 * 1e3),
+  /**
+   * Creates a Duration from hours.
+   *
+   * @example
+   * ```ts
+   * Duration.hours(1); // 3600000ms Duration
+   * ```
+   */
+  hours: (h) => wrap(h * 60 * 60 * 1e3),
+  /**
+   * Creates a Duration from days.
+   *
+   * @example
+   * ```ts
+   * Duration.days(1); // 86400000ms Duration
+   * ```
+   */
+  days: (d) => wrap(d * 24 * 60 * 60 * 1e3),
+  // --- to ---
+  to: {
+    /**
+     * Converts a Duration back to raw milliseconds.
+     *
+     * @example
+     * ```ts
+     * Duration.to.milliseconds(Duration.seconds(2)); // 2000
+     * ```
+     */
+    milliseconds: (d) => Brand.unwrap(d),
+    /**
+     * Converts a Duration to seconds.
+     *
+     * @example
+     * ```ts
+     * Duration.to.seconds(Duration.milliseconds(2500)); // 2.5
+     * ```
+     */
+    seconds: (d) => Brand.unwrap(d) / 1e3,
+    /**
+     * Converts a Duration to minutes.
+     *
+     * @example
+     * ```ts
+     * Duration.to.minutes(Duration.seconds(120)); // 2
+     * ```
+     */
+    minutes: (d) => Brand.unwrap(d) / (60 * 1e3),
+    /**
+     * Converts a Duration to hours.
+     *
+     * @example
+     * ```ts
+     * Duration.to.hours(Duration.minutes(90)); // 1.5
+     * ```
+     */
+    hours: (d) => Brand.unwrap(d) / (60 * 60 * 1e3),
+    /**
+     * Converts a Duration to days.
+     *
+     * @example
+     * ```ts
+     * Duration.to.days(Duration.hours(36)); // 1.5
+     * ```
+     */
+    days: (d) => Brand.unwrap(d) / (24 * 60 * 60 * 1e3)
+  },
+  /**
+   * Adds two Durations together.
+   *
+   * @example
+   * ```ts
+   * pipe(Duration.seconds(1), Duration.add(Duration.milliseconds(500))); // 1500ms
+   * ```
+   */
+  add: (other) => (self) => wrap(Brand.unwrap(self) + Brand.unwrap(other)),
+  /**
+   * Subtracts the other Duration from this one.
+   *
+   * @example
+   * ```ts
+   * pipe(Duration.seconds(1), Duration.subtract(Duration.milliseconds(500))); // 500ms
+   * ```
+   */
+  subtract: (other) => (self) => wrap(Brand.unwrap(self) - Brand.unwrap(other))
+};
 
 // src/Types/RetryPolicy.ts
-var RetryPolicy;
-((RetryPolicy2) => {
-  RetryPolicy2.constant = (options) => ({
+var RetryPolicy = {
+  /**
+   * Creates a RetryPolicy with a constant delay between retry attempts.
+   *
+   * @example
+   * ```ts
+   * const policy = RetryPolicy.constant({
+   *   attempts: 3,
+   *   delay: Duration.seconds(1),
+   * });
+   * ```
+   */
+  constant: (options) => ({
     attempts: Math.max(1, options.attempts),
     getDelay: () => options.delay
-  });
-  RetryPolicy2.exponential = (options) => {
+  }),
+  /**
+   * 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
+   * const policy = RetryPolicy.exponential({
+   *   attempts: 5,
+   *   initial: Duration.milliseconds(100),
+   *   factor: 2,
+   *   jitter: true,
+   * });
+   * ```
+   */
+  exponential: (options) => {
     const attempts = Math.max(1, options.attempts);
     const initialMs = Duration.to.milliseconds(options.initial);
     const factor = options.factor ?? 2;
@@ -46,8 +190,8 @@ var RetryPolicy;
         return Duration.milliseconds(finalMs);
       }
     };
-  };
-})(RetryPolicy || (RetryPolicy = {}));
+  }
+};
 export {
   Brand,
   Duration,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nlozgachev/pipelined",
-	"version": "0.62.0",
+	"version": "0.63.0",
 	"description": "Opinionated functional abstractions for TypeScript",
 	"license": "BSD-3-Clause",
 	"homepage": "https://pipelined.lozgachev.dev",
@@ -84,17 +84,16 @@
 		"lint": "oxlint src/",
 		"format": "dprint fmt && dprint fmt --config dprint.md.json \"docs/**/*.md\" \"docs/**/*.mdx\" \"README.md\"",
 		"format:check": "dprint check && dprint check --config dprint.md.json \"docs/**/*.md\" \"docs/**/*.mdx\" \"README.md\"",
-		"release:patch": "bumpp --patch -c -t -p",
-		"release:minor": "bumpp --minor -c -t -p",
 		"docs:dev": "pnpm --filter pipelined-docs dev",
 		"docs:build": "pnpm --filter pipelined-docs build"
 	},
 	"devDependencies": {
+		"@size-limit/esbuild": "13.0.3",
 		"@size-limit/file": "13.0.3",
 		"@types/node": "26.2.0",
 		"@vitest/coverage-v8": "4.1.10",
-		"bumpp": "12.2.0",
 		"dprint": "0.55.2",
+		"esbuild": "0.28.2",
 		"fast-check": "4.9.0",
 		"oxlint": "1.78.0",
 		"size-limit": "13.0.3",
@@ -104,28 +103,40 @@
 	},
 	"size-limit": [
 		{
+			"name": "Index (Monolithic import *)",
+			"import": "*",
 			"path": "dist/index.mjs",
-			"limit": "25 KB",
-			"gzip": true
+			"limit": "18 KB",
+			"gzip": true,
+			"ignore": ["util", "node:util"]
 		},
 		{
+			"name": "Core (import * as Core)",
+			"import": "*",
 			"path": "dist/core.mjs",
-			"limit": "16 KB",
+			"limit": "11 KB",
 			"gzip": true
 		},
 		{
-			"path": "dist/composition.mjs",
-			"limit": "3 KB",
+			"name": "Data (import * as Data)",
+			"import": "*",
+			"path": "dist/data.mjs",
+			"limit": "7 KB",
 			"gzip": true
 		},
 		{
-			"path": "dist/data.mjs",
-			"limit": "10 KB",
-			"gzip": true
+			"name": "Composition (import * as Composition)",
+			"import": "*",
+			"path": "dist/composition.mjs",
+			"limit": "2 KB",
+			"gzip": true,
+			"ignore": ["util", "node:util"]
 		},
 		{
+			"name": "Types (import * as Types)",
+			"import": "*",
 			"path": "dist/types.mjs",
-			"limit": "700 B",
+			"limit": "400 B",
 			"gzip": true
 		}
 	],