@nlozgachev/pipelined 0.42.0 → 0.44.0

package/dist/index.mjs

@@ -27,7 +27,7 @@ import {
   uncurry,
   uncurry3,
   uncurry4
-} from "./chunk-F6SBU7GB.mjs";
+} from "./chunk-X6XQX3OZ.mjs";
 import {
   Arr,
   Dict,
@@ -35,7 +35,7 @@ import {
   Rec,
   Str,
   Uniq
-} from "./chunk-6VYLZTAM.mjs";
+} from "./chunk-LKTOK5IT.mjs";
 import {
   Combinable,
   Deferred,
@@ -61,12 +61,11 @@ import {
   These,
   Tuple,
   Validation
-} from "./chunk-OAP765G3.mjs";
+} from "./chunk-ND476266.mjs";
 import {
   Brand,
-  Duration,
-  isNonEmptyList
-} from "./chunk-GBB6LVLI.mjs";
+  Duration
+} from "./chunk-74JKKJ4R.mjs";
 export {
   Arr,
   Brand,
@@ -116,7 +115,6 @@ export {
   flip,
   flow,
   identity,
-  isNonEmptyList,
   juxt,
   memoize,
   memoizeWeak,

package/dist/types.d.mts

@@ -1,32 +1,127 @@
-export { B as Brand, D as Duration } from './Duration-BTeT9D-q.mjs';
-
+declare const _brand: unique symbol;
 /**
- * A list that is guaranteed to have at least one element.
- * Useful for ensuring functions receive non-empty input and for
- * accumulating errors in Validation.
+ * 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
- * const errors: NonEmptyList<string> = ["First error", "Second error"];
+ * type UserId = Brand<"UserId", string>;
+ * type ProductId = Brand<"ProductId", string>;
+ *
+ * const toUserId = Brand.wrap<"UserId", string>();
+ * const toProductId = Brand.wrap<"ProductId", string>();
  *
- * // TypeScript ensures at least one element:
- * const invalid: NonEmptyList<string> = []; // Error!
+ * 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 NonEmptyList<A> = readonly [A, ...A[]];
+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;
+}
+
 /**
- * Type guard that checks if an array is non-empty.
+ * 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 items: string[] = getItems();
+ * const halfSecond = Duration.milliseconds(500);
+ * const twoSeconds = Duration.seconds(2);
+ * const total = pipe(halfSecond, Duration.add(twoSeconds));
  *
- * if (isNonEmptyList(items)) {
- *   // TypeScript knows items has at least one element
- *   const first = items[0]; // string, not string | undefined
- * }
+ * Duration.toSeconds(total); // 2.5
  * ```
  */
-declare const isNonEmptyList: <A>(list: readonly A[]) => list is NonEmptyList<A>;
+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;
+    /**
+     * Converts a Duration back to raw milliseconds.
+     */
+    const toMilliseconds: (d: Duration) => number;
+    /**
+     * Converts a Duration to seconds.
+     */
+    const toSeconds: (d: Duration) => number;
+    /**
+     * Converts a Duration to minutes.
+     */
+    const toMinutes: (d: Duration) => number;
+    /**
+     * Converts a Duration to hours.
+     */
+    const toHours: (d: Duration) => number;
+    /**
+     * Converts a Duration to days.
+     */
+    const toDays: (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 { type NonEmptyList, isNonEmptyList };
+export { Brand, Duration };

package/dist/types.d.ts

@@ -1,32 +1,127 @@
-export { B as Brand, D as Duration } from './Duration-BTeT9D-q.js';
-
+declare const _brand: unique symbol;
 /**
- * A list that is guaranteed to have at least one element.
- * Useful for ensuring functions receive non-empty input and for
- * accumulating errors in Validation.
+ * 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
- * const errors: NonEmptyList<string> = ["First error", "Second error"];
+ * type UserId = Brand<"UserId", string>;
+ * type ProductId = Brand<"ProductId", string>;
+ *
+ * const toUserId = Brand.wrap<"UserId", string>();
+ * const toProductId = Brand.wrap<"ProductId", string>();
  *
- * // TypeScript ensures at least one element:
- * const invalid: NonEmptyList<string> = []; // Error!
+ * 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 NonEmptyList<A> = readonly [A, ...A[]];
+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;
+}
+
 /**
- * Type guard that checks if an array is non-empty.
+ * 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 items: string[] = getItems();
+ * const halfSecond = Duration.milliseconds(500);
+ * const twoSeconds = Duration.seconds(2);
+ * const total = pipe(halfSecond, Duration.add(twoSeconds));
  *
- * if (isNonEmptyList(items)) {
- *   // TypeScript knows items has at least one element
- *   const first = items[0]; // string, not string | undefined
- * }
+ * Duration.toSeconds(total); // 2.5
  * ```
  */
-declare const isNonEmptyList: <A>(list: readonly A[]) => list is NonEmptyList<A>;
+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;
+    /**
+     * Converts a Duration back to raw milliseconds.
+     */
+    const toMilliseconds: (d: Duration) => number;
+    /**
+     * Converts a Duration to seconds.
+     */
+    const toSeconds: (d: Duration) => number;
+    /**
+     * Converts a Duration to minutes.
+     */
+    const toMinutes: (d: Duration) => number;
+    /**
+     * Converts a Duration to hours.
+     */
+    const toHours: (d: Duration) => number;
+    /**
+     * Converts a Duration to days.
+     */
+    const toDays: (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 { type NonEmptyList, isNonEmptyList };
+export { Brand, Duration };

package/dist/types.js

@@ -21,8 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var Types_exports = {};
 __export(Types_exports, {
   Brand: () => Brand,
-  Duration: () => Duration,
-  isNonEmptyList: () => isNonEmptyList
+  Duration: () => Duration
 });
 module.exports = __toCommonJS(Types_exports);
 
@@ -50,12 +49,8 @@ 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/NonEmptyList.ts
-var isNonEmptyList = (list) => list.length > 0;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Brand,
-  Duration,
-  isNonEmptyList
+  Duration
 });

package/dist/types.mjs

@@ -1,10 +1,8 @@
 import {
   Brand,
-  Duration,
-  isNonEmptyList
-} from "./chunk-GBB6LVLI.mjs";
+  Duration
+} from "./chunk-74JKKJ4R.mjs";
 export {
   Brand,
-  Duration,
-  isNonEmptyList
+  Duration
 };