@nlozgachev/pipelined 0.46.0 → 0.48.0

package/dist/Duration-B8joKzro.d.mts

@@ -0,0 +1,181 @@
+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
+     * 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"
+     * ```
+     */
+    const 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 namespace Duration {
+    /**
+     * Creates a Duration from milliseconds.
+     *
+     * @example
+     * ```ts
+     * Duration.milliseconds(500); // 500ms Duration
+     * ```
+     */
+    const milliseconds: (ms: number) => Duration;
+    /**
+     * Creates a Duration from seconds.
+     *
+     * @example
+     * ```ts
+     * Duration.seconds(2); // 2000ms Duration
+     * ```
+     */
+    const seconds: (s: number) => Duration;
+    /**
+     * Creates a Duration from minutes.
+     *
+     * @example
+     * ```ts
+     * Duration.minutes(5); // 300000ms Duration
+     * ```
+     */
+    const minutes: (m: number) => Duration;
+    /**
+     * Creates a Duration from hours.
+     *
+     * @example
+     * ```ts
+     * Duration.hours(1); // 3600000ms Duration
+     * ```
+     */
+    const hours: (h: number) => Duration;
+    /**
+     * Creates a Duration from days.
+     *
+     * @example
+     * ```ts
+     * Duration.days(1); // 86400000ms Duration
+     * ```
+     */
+    const days: (d: number) => Duration;
+    namespace to {
+        /**
+         * Converts a Duration back to raw milliseconds.
+         *
+         * @example
+         * ```ts
+         * Duration.to.milliseconds(Duration.seconds(2)); // 2000
+         * ```
+         */
+        const milliseconds: (d: Duration) => number;
+        /**
+         * Converts a Duration to seconds.
+         *
+         * @example
+         * ```ts
+         * Duration.to.seconds(Duration.milliseconds(2500)); // 2.5
+         * ```
+         */
+        const seconds: (d: Duration) => number;
+        /**
+         * Converts a Duration to minutes.
+         *
+         * @example
+         * ```ts
+         * Duration.to.minutes(Duration.seconds(120)); // 2
+         * ```
+         */
+        const minutes: (d: Duration) => number;
+        /**
+         * Converts a Duration to hours.
+         *
+         * @example
+         * ```ts
+         * Duration.to.hours(Duration.minutes(90)); // 1.5
+         * ```
+         */
+        const hours: (d: Duration) => number;
+        /**
+         * Converts a Duration to days.
+         *
+         * @example
+         * ```ts
+         * Duration.to.days(Duration.hours(36)); // 1.5
+         * ```
+         */
+        const days: (d: Duration) => number;
+    }
+    /**
+     * Adds two Durations together.
+     *
+     * @example
+     * ```ts
+     * pipe(Duration.seconds(1), Duration.add(Duration.milliseconds(500))); // 1500ms
+     * ```
+     */
+    const 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
+     * ```
+     */
+    const subtract: (other: Duration) => (self: Duration) => Duration;
+}
+
+export { Brand as B, Duration as D };

package/dist/Duration-B8joKzro.d.ts

@@ -0,0 +1,181 @@
+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
+     * 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"
+     * ```
+     */
+    const 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 namespace Duration {
+    /**
+     * Creates a Duration from milliseconds.
+     *
+     * @example
+     * ```ts
+     * Duration.milliseconds(500); // 500ms Duration
+     * ```
+     */
+    const milliseconds: (ms: number) => Duration;
+    /**
+     * Creates a Duration from seconds.
+     *
+     * @example
+     * ```ts
+     * Duration.seconds(2); // 2000ms Duration
+     * ```
+     */
+    const seconds: (s: number) => Duration;
+    /**
+     * Creates a Duration from minutes.
+     *
+     * @example
+     * ```ts
+     * Duration.minutes(5); // 300000ms Duration
+     * ```
+     */
+    const minutes: (m: number) => Duration;
+    /**
+     * Creates a Duration from hours.
+     *
+     * @example
+     * ```ts
+     * Duration.hours(1); // 3600000ms Duration
+     * ```
+     */
+    const hours: (h: number) => Duration;
+    /**
+     * Creates a Duration from days.
+     *
+     * @example
+     * ```ts
+     * Duration.days(1); // 86400000ms Duration
+     * ```
+     */
+    const days: (d: number) => Duration;
+    namespace to {
+        /**
+         * Converts a Duration back to raw milliseconds.
+         *
+         * @example
+         * ```ts
+         * Duration.to.milliseconds(Duration.seconds(2)); // 2000
+         * ```
+         */
+        const milliseconds: (d: Duration) => number;
+        /**
+         * Converts a Duration to seconds.
+         *
+         * @example
+         * ```ts
+         * Duration.to.seconds(Duration.milliseconds(2500)); // 2.5
+         * ```
+         */
+        const seconds: (d: Duration) => number;
+        /**
+         * Converts a Duration to minutes.
+         *
+         * @example
+         * ```ts
+         * Duration.to.minutes(Duration.seconds(120)); // 2
+         * ```
+         */
+        const minutes: (d: Duration) => number;
+        /**
+         * Converts a Duration to hours.
+         *
+         * @example
+         * ```ts
+         * Duration.to.hours(Duration.minutes(90)); // 1.5
+         * ```
+         */
+        const hours: (d: Duration) => number;
+        /**
+         * Converts a Duration to days.
+         *
+         * @example
+         * ```ts
+         * Duration.to.days(Duration.hours(36)); // 1.5
+         * ```
+         */
+        const days: (d: Duration) => number;
+    }
+    /**
+     * Adds two Durations together.
+     *
+     * @example
+     * ```ts
+     * pipe(Duration.seconds(1), Duration.add(Duration.milliseconds(500))); // 1500ms
+     * ```
+     */
+    const 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
+     * ```
+     */
+    const subtract: (other: Duration) => (self: Duration) => Duration;
+}
+
+export { Brand as B, Duration as D };

package/dist/{InternalTypes-Mssktd7z.d.ts → InternalTypes-CDiDBAY4.d.mts}

@@ -1,4 +1,4 @@
-import { Duration } from './types.js';
+import { D as Duration } from './Duration-B8joKzro.mjs';
 
 declare const _deferred: unique symbol;
 /**
@@ -54,6 +54,25 @@ declare namespace Deferred {
          */
         const Promise: <A>(d: Deferred<A>) => globalThis.Promise<A>;
     }
+    /**
+     * Combines an array or tuple of `Deferred` values into a single `Deferred` of a tuple.
+     * Resolves when all input `Deferred`s resolve.
+     *
+     * @example
+     * ```ts
+     * const [a, b] = await Deferred.all([d1, d2]);
+     * ```
+     */
+    const all: <T extends readonly Deferred<unknown>[]>(deferreds: T) => Deferred<{ [K in keyof T]: T[K] extends Deferred<infer A> ? A : never; }>;
+    /**
+     * Races multiple `Deferred` values and resolves with the first one to settle.
+     *
+     * @example
+     * ```ts
+     * const winner = await Deferred.race([d1, d2]);
+     * ```
+     */
+    const race: <A>(deferreds: ReadonlyArray<Deferred<A>>) => Deferred<A>;
 }
 
 /**

package/dist/{InternalTypes-CLE7qlOc.d.mts → InternalTypes-LdhLQx3N.d.ts}

@@ -1,4 +1,4 @@
-import { Duration } from './types.mjs';
+import { D as Duration } from './Duration-B8joKzro.js';
 
 declare const _deferred: unique symbol;
 /**
@@ -54,6 +54,25 @@ declare namespace Deferred {
          */
         const Promise: <A>(d: Deferred<A>) => globalThis.Promise<A>;
     }
+    /**
+     * Combines an array or tuple of `Deferred` values into a single `Deferred` of a tuple.
+     * Resolves when all input `Deferred`s resolve.
+     *
+     * @example
+     * ```ts
+     * const [a, b] = await Deferred.all([d1, d2]);
+     * ```
+     */
+    const all: <T extends readonly Deferred<unknown>[]>(deferreds: T) => Deferred<{ [K in keyof T]: T[K] extends Deferred<infer A> ? A : never; }>;
+    /**
+     * Races multiple `Deferred` values and resolves with the first one to settle.
+     *
+     * @example
+     * ```ts
+     * const winner = await Deferred.race([d1, d2]);
+     * ```
+     */
+    const race: <A>(deferreds: ReadonlyArray<Deferred<A>>) => Deferred<A>;
 }
 
 /**