@nlozgachev/pipelined 0.63.0 → 0.65.0

package/dist/types.mjs

@@ -1,199 +1,195 @@
-// src/Types/Brand.ts
-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
+//#region src/Types/Brand.ts
+const 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 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))
+//#endregion
+//#region src/Types/RetryPolicy.ts
+const 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
+	}),
+	/**
+	* 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;
+		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);
+			}
+		};
+	}
 };
-
-// src/Types/RetryPolicy.ts
-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
-  }),
-  /**
-   * 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;
-    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);
-      }
-    };
-  }
-};
-export {
-  Brand,
-  Duration,
-  RetryPolicy
+//#endregion
+//#region src/Types/Duration.ts
+const wrap = Brand.wrap();
+const 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: {
+		/**
+		* 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) / 6e4,
+		/**
+		* Converts a Duration to hours.
+		*
+		* @example
+		* ```ts
+		* Duration.to.hours(Duration.minutes(90)); // 1.5
+		* ```
+		*/
+		hours: (d) => Brand.unwrap(d) / 36e5,
+		/**
+		* Converts a Duration to days.
+		*
+		* @example
+		* ```ts
+		* Duration.to.days(Duration.hours(36)); // 1.5
+		* ```
+		*/
+		days: (d) => Brand.unwrap(d) / 864e5
+	},
+	/**
+	* 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))
 };
+//#endregion
+export { Brand, Duration, RetryPolicy };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nlozgachev/pipelined",
-	"version": "0.63.0",
+	"version": "0.65.0",
 	"description": "Opinionated functional abstractions for TypeScript",
 	"license": "BSD-3-Clause",
 	"homepage": "https://pipelined.lozgachev.dev",
@@ -74,7 +74,7 @@
 		}
 	},
 	"scripts": {
-		"build": "tsup",
+		"build": "tsdown",
 		"test": "vitest run",
 		"test:coverage": "vitest run --coverage",
 		"bench": "vitest bench",
@@ -85,21 +85,24 @@
 		"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\"",
 		"docs:dev": "pnpm --filter pipelined-docs dev",
-		"docs:build": "pnpm --filter pipelined-docs build"
+		"docs:build": "pnpm --filter pipelined-docs build",
+		"check": "pnpm typecheck && pnpm lint && pnpm format:check"
 	},
 	"devDependencies": {
-		"@size-limit/esbuild": "13.0.3",
-		"@size-limit/file": "13.0.3",
-		"@types/node": "26.2.0",
-		"@vitest/coverage-v8": "4.1.10",
-		"dprint": "0.55.2",
+		"@arethetypeswrong/core": "0.18.5",
+		"@size-limit/esbuild": "14.1.0",
+		"@size-limit/file": "14.1.0",
+		"@types/node": "26.6.4",
+		"@vitest/coverage-v8": "5.0.3",
+		"dprint": "0.60.1",
 		"esbuild": "0.28.2",
-		"fast-check": "4.9.0",
-		"oxlint": "1.78.0",
-		"size-limit": "13.0.3",
-		"tsup": "8.5.1",
+		"fast-check": "4.10.2",
+		"oxlint": "1.87.0",
+		"publint": "0.3.24",
+		"size-limit": "14.1.0",
+		"tsdown": "0.23.0",
 		"typescript": "6.0.3",
-		"vitest": "4.1.10"
+		"vitest": "5.0.3"
 	},
 	"size-limit": [
 		{
@@ -108,7 +111,10 @@
 			"path": "dist/index.mjs",
 			"limit": "18 KB",
 			"gzip": true,
-			"ignore": ["util", "node:util"]
+			"ignore": [
+				"util",
+				"node:util"
+			]
 		},
 		{
 			"name": "Core (import * as Core)",
@@ -130,7 +136,10 @@
 			"path": "dist/composition.mjs",
 			"limit": "2 KB",
 			"gzip": true,
-			"ignore": ["util", "node:util"]
+			"ignore": [
+				"util",
+				"node:util"
+			]
 		},
 		{
 			"name": "Types (import * as Types)",

package/dist/Duration-DeyxG6VQ.d.cts

@@ -1,181 +0,0 @@
-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 const 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: <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
-     * 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: <K extends string, T>(branded: Brand<K, T>) => T;
-};
-
-/**
- * A branded nominal type representing a duration of time in milliseconds.
- * Use Duration to ensure safe time-based operators and clear unit conversions.
- *
- * @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
- * ```
- */
-type Duration = Brand<"Duration", number>;
-declare const Duration: {
-    /**
-     * Creates a Duration from milliseconds.
-     *
-     * @example
-     * ```ts
-     * Duration.milliseconds(500); // 500ms Duration
-     * ```
-     */
-    milliseconds: (ms: number) => Duration;
-    /**
-     * Creates a Duration from seconds.
-     *
-     * @example
-     * ```ts
-     * Duration.seconds(2); // 2000ms Duration
-     * ```
-     */
-    seconds: (s: number) => Duration;
-    /**
-     * Creates a Duration from minutes.
-     *
-     * @example
-     * ```ts
-     * Duration.minutes(5); // 300000ms Duration
-     * ```
-     */
-    minutes: (m: number) => Duration;
-    /**
-     * Creates a Duration from hours.
-     *
-     * @example
-     * ```ts
-     * Duration.hours(1); // 3600000ms Duration
-     * ```
-     */
-    hours: (h: number) => Duration;
-    /**
-     * Creates a Duration from days.
-     *
-     * @example
-     * ```ts
-     * Duration.days(1); // 86400000ms Duration
-     * ```
-     */
-    days: (d: number) => Duration;
-    to: {
-        /**
-         * Converts a Duration back to raw milliseconds.
-         *
-         * @example
-         * ```ts
-         * Duration.to.milliseconds(Duration.seconds(2)); // 2000
-         * ```
-         */
-        milliseconds: (d: Duration) => number;
-        /**
-         * Converts a Duration to seconds.
-         *
-         * @example
-         * ```ts
-         * Duration.to.seconds(Duration.milliseconds(2500)); // 2.5
-         * ```
-         */
-        seconds: (d: Duration) => number;
-        /**
-         * Converts a Duration to minutes.
-         *
-         * @example
-         * ```ts
-         * Duration.to.minutes(Duration.seconds(120)); // 2
-         * ```
-         */
-        minutes: (d: Duration) => number;
-        /**
-         * Converts a Duration to hours.
-         *
-         * @example
-         * ```ts
-         * Duration.to.hours(Duration.minutes(90)); // 1.5
-         * ```
-         */
-        hours: (d: Duration) => number;
-        /**
-         * Converts a Duration to days.
-         *
-         * @example
-         * ```ts
-         * Duration.to.days(Duration.hours(36)); // 1.5
-         * ```
-         */
-        days: (d: Duration) => number;
-    };
-    /**
-     * Adds two Durations together.
-     *
-     * @example
-     * ```ts
-     * pipe(Duration.seconds(1), Duration.add(Duration.milliseconds(500))); // 1500ms
-     * ```
-     */
-    add: (other: Duration) => (self: Duration) => Duration;
-    /**
-     * Subtracts the other Duration from this one.
-     *
-     * @example
-     * ```ts
-     * pipe(Duration.seconds(1), Duration.subtract(Duration.milliseconds(500))); // 500ms
-     * ```
-     */
-    subtract: (other: Duration) => (self: Duration) => Duration;
-};
-
-export { Brand as B, Duration as D };