@cullet/erp-core 1.0.2 → 1.0.3

package/src/core/policies/utils/date.ts

@@ -1,7 +1,7 @@
 import { isValidDate } from "../../shared/temporal-guards";
 
 export class PolicyDateUtils {
-  static isValid(value: Date): boolean {
-    return isValidDate(value);
-  }
+    static isValid(value: Date): boolean {
+        return isValidDate(value);
+    }
 }

package/src/core/policies/utils/hash.ts

@@ -12,79 +12,79 @@ import { isValidDate } from "../../shared/temporal-guards";
  * prevent semantically different payloads from collapsing to the same hash.
  */
 export class PolicyHashing {
-  static sha256(input: string): string {
-    return sha256Hex(input);
-  }
-
-  private static assertHashable(value: unknown, path: string): void {
-    if (value === null) {
-      return;
+    static sha256(input: string): string {
+        return sha256Hex(input);
     }
 
-    const type = typeof value;
+    private static assertHashable(value: unknown, path: string): void {
+        if (value === null) {
+            return;
+        }
 
-    if (type === "undefined") {
-      throw new TypeError(
-        `canonicalJson does not accept undefined values (at ${path})`,
-      );
-    }
+        const type = typeof value;
 
-    if (type === "number" && !Number.isFinite(value)) {
-      throw new TypeError(
-        `canonicalJson does not accept non-finite numbers (at ${path}, value: ${String(value)})`,
-      );
-    }
+        if (type === "undefined") {
+            throw new TypeError(
+                `canonicalJson does not accept undefined values (at ${path})`,
+            );
+        }
 
-    if (type === "bigint" || type === "function" || type === "symbol") {
-      throw new TypeError(
-        `canonicalJson does not accept ${type} values (at ${path})`,
-      );
-    }
+        if (type === "number" && !Number.isFinite(value)) {
+            throw new TypeError(
+                `canonicalJson does not accept non-finite numbers (at ${path}, value: ${String(value)})`,
+            );
+        }
 
-    if (type !== "object") {
-      return;
-    }
+        if (type === "bigint" || type === "function" || type === "symbol") {
+            throw new TypeError(
+                `canonicalJson does not accept ${type} values (at ${path})`,
+            );
+        }
 
-    if (value instanceof Date) {
-      if (!isValidDate(value)) {
-        throw new TypeError(
-          `canonicalJson does not accept Invalid Date (at ${path})`,
-        );
-      }
-      return;
-    }
+        if (type !== "object") {
+            return;
+        }
 
-    if (Array.isArray(value)) {
-      value.forEach((item, index) => {
-        PolicyHashing.assertHashable(item, `${path}[${index}]`);
-      });
-      return;
-    }
+        if (value instanceof Date) {
+            if (!isValidDate(value)) {
+                throw new TypeError(
+                    `canonicalJson does not accept Invalid Date (at ${path})`,
+                );
+            }
+            return;
+        }
+
+        if (Array.isArray(value)) {
+            value.forEach((item, index) => {
+                PolicyHashing.assertHashable(item, `${path}[${index}]`);
+            });
+            return;
+        }
 
-    for (const [key, nested] of Object.entries(
-      value as Record<string, unknown>,
-    )) {
-      PolicyHashing.assertHashable(nested, `${path}.${key}`);
+        for (const [key, nested] of Object.entries(
+            value as Record<string, unknown>,
+        )) {
+            PolicyHashing.assertHashable(nested, `${path}.${key}`);
+        }
     }
-  }
 
-  static canonicalJson(value: unknown): string {
-    PolicyHashing.assertHashable(value, "$");
+    static canonicalJson(value: unknown): string {
+        PolicyHashing.assertHashable(value, "$");
 
-    return stableStringify(value);
-  }
+        return stableStringify(value);
+    }
 
-  static computePayloadHash(
-    payload: unknown,
-    policyKey: string,
-    policyVersion: string,
-  ): string {
-    const canonical = PolicyHashing.canonicalJson({
-      policyKey,
-      policyVersion,
-      payload,
-    });
+    static computePayloadHash(
+        payload: unknown,
+        policyKey: string,
+        policyVersion: string,
+    ): string {
+        const canonical = PolicyHashing.canonicalJson({
+            policyKey,
+            policyVersion,
+            payload,
+        });
 
-    return PolicyHashing.sha256(canonical);
-  }
+        return PolicyHashing.sha256(canonical);
+    }
 }

package/src/core/result/outcome.ts

@@ -19,140 +19,145 @@ import { InvariantViolationException } from "../exceptions/invariant-violation-e
  * @typeParam D - Shape of the decision data carried by this outcome
  */
 export class Outcome<S extends string, D = undefined> {
-  readonly status: S;
-  readonly data: D;
-  readonly reason: string | undefined;
-  readonly metadata: Readonly<Record<string, unknown>>;
-
-  private constructor(
-    status: S,
-    data: D,
-    reason: string | undefined,
-    metadata: Readonly<Record<string, unknown>>,
-  ) {
-    this.status = status;
-    this.data = data;
-    this.reason = reason;
-    this.metadata = metadata;
-    Object.freeze(this);
-  }
-
-  // ─── Generic factory ────────────────────────────────────────────────
-
-  static of<S extends string, D = undefined>(
-    status: S,
-    data: D,
-    reason?: string,
-    metadata?: Record<string, unknown>,
-  ): Outcome<S, D> {
-    return new Outcome(status, data, reason, Object.freeze({ ...metadata }));
-  }
-
-  // ─── Convenience factories for common business statuses ─────────────
-
-  static approved<D = undefined>(
-    data: D,
-    reason?: string,
-  ): Outcome<"APPROVED", D> {
-    return new Outcome("APPROVED", data, reason, Object.freeze({}));
-  }
-
-  static rejected<D = undefined>(
-    data: D,
-    reason: string,
-  ): Outcome<"REJECTED", D> {
-    return new Outcome("REJECTED", data, reason, Object.freeze({}));
-  }
-
-  static noOp<D = undefined>(data: D, reason?: string): Outcome<"NO_OP", D> {
-    return new Outcome("NO_OP", data, reason, Object.freeze({}));
-  }
-
-  static deferred<D = undefined>(
-    data: D,
-    reason: string,
-  ): Outcome<"DEFERRED", D> {
-    return new Outcome("DEFERRED", data, reason, Object.freeze({}));
-  }
-
-  static requiresReview<D = undefined>(
-    data: D,
-    reason: string,
-  ): Outcome<"REQUIRES_REVIEW", D> {
-    return new Outcome("REQUIRES_REVIEW", data, reason, Object.freeze({}));
-  }
-
-  // ─── Type narrowing ────────────────────────────────────────────────
-
-  /**
-   * Narrows this Outcome to a specific status.
-   *
-   * @example
-   * if (outcome.is('DENY')) {
-   *   outcome.data.violations // TS knows status is 'DENY'
-   * }
-   */
-  is<T extends S>(status: T): this is Outcome<T, D> {
-    return (this.status as string) === status;
-  }
-
-  // ─── Exhaustive match ──────────────────────────────────────────────
-
-  /**
-   * Exhaustive pattern match over all possible statuses.
-   * TypeScript enforces that every status has a handler.
-   *
-   * @example
-   * outcome.match({
-   *   ALLOW: (o) => handleAllow(o.data),
-   *   DENY:  (o) => handleDeny(o.data.violations),
-   * })
-   */
-  match<THandlers extends { [K in S]: (outcome: Outcome<K, D>) => unknown }>(
-    handlers: THandlers,
-  ): ReturnType<THandlers[S]> {
-    const handler = (
-      handlers as Partial<Record<string, (o: unknown) => unknown>>
-    )[this.status];
-
-    if (typeof handler !== "function") {
-      const availableStatuses = Object.keys(handlers);
-      throw new InvariantViolationException(
-        `Outcome.match is missing a handler for runtime status "${this.status}". Available handlers: ${availableStatuses.join(", ") || "(none)"}`,
-      );
+    readonly status: S;
+    readonly data: D;
+    readonly reason: string | undefined;
+    readonly metadata: Readonly<Record<string, unknown>>;
+
+    private constructor(
+        status: S,
+        data: D,
+        reason: string | undefined,
+        metadata: Readonly<Record<string, unknown>>,
+    ) {
+        this.status = status;
+        this.data = data;
+        this.reason = reason;
+        this.metadata = metadata;
+        Object.freeze(this);
     }
 
-    return handler(this) as ReturnType<THandlers[S]>;
-  }
+    // ─── Generic factory ────────────────────────────────────────────────
+
+    static of<S extends string, D = undefined>(
+        status: S,
+        data: D,
+        reason?: string,
+        metadata?: Record<string, unknown>,
+    ): Outcome<S, D> {
+        return new Outcome(
+            status,
+            data,
+            reason,
+            Object.freeze({ ...metadata }),
+        );
+    }
+
+    // ─── Convenience factories for common business statuses ─────────────
+
+    static approved<D = undefined>(
+        data: D,
+        reason?: string,
+    ): Outcome<"APPROVED", D> {
+        return new Outcome("APPROVED", data, reason, Object.freeze({}));
+    }
+
+    static rejected<D = undefined>(
+        data: D,
+        reason: string,
+    ): Outcome<"REJECTED", D> {
+        return new Outcome("REJECTED", data, reason, Object.freeze({}));
+    }
 
-  // ─── Derived copies ────────────────────────────────────────────────
+    static noOp<D = undefined>(data: D, reason?: string): Outcome<"NO_OP", D> {
+        return new Outcome("NO_OP", data, reason, Object.freeze({}));
+    }
 
-  withMetadata(extra: Record<string, unknown>): Outcome<S, D> {
-    return new Outcome(
-      this.status,
-      this.data,
-      this.reason,
-      Object.freeze({ ...this.metadata, ...extra }),
-    );
-  }
+    static deferred<D = undefined>(
+        data: D,
+        reason: string,
+    ): Outcome<"DEFERRED", D> {
+        return new Outcome("DEFERRED", data, reason, Object.freeze({}));
+    }
 
-  withReason(reason: string): Outcome<S, D> {
-    return new Outcome(this.status, this.data, reason, this.metadata);
-  }
+    static requiresReview<D = undefined>(
+        data: D,
+        reason: string,
+    ): Outcome<"REQUIRES_REVIEW", D> {
+        return new Outcome("REQUIRES_REVIEW", data, reason, Object.freeze({}));
+    }
 
-  // ─── Debug ─────────────────────────────────────────────────────────
+    // ─── Type narrowing ────────────────────────────────────────────────
+
+    /**
+     * Narrows this Outcome to a specific status.
+     *
+     * @example
+     * if (outcome.is('DENY')) {
+     *   outcome.data.violations // TS knows status is 'DENY'
+     * }
+     */
+    is<T extends S>(status: T): this is Outcome<T, D> {
+        return (this.status as string) === status;
+    }
 
-  toString(): string {
-    const parts: string[] = [this.status];
-    if (this.reason) parts.push(`reason="${this.reason}"`);
-    return `Outcome(${parts.join(", ")})`;
-  }
+    // ─── Exhaustive match ──────────────────────────────────────────────
+
+    /**
+     * Exhaustive pattern match over all possible statuses.
+     * TypeScript enforces that every status has a handler.
+     *
+     * @example
+     * outcome.match({
+     *   ALLOW: (o) => handleAllow(o.data),
+     *   DENY:  (o) => handleDeny(o.data.violations),
+     * })
+     */
+    match<THandlers extends { [K in S]: (outcome: Outcome<K, D>) => unknown }>(
+        handlers: THandlers,
+    ): ReturnType<THandlers[S]> {
+        const handler = (
+            handlers as Partial<Record<string, (o: unknown) => unknown>>
+        )[this.status];
+
+        if (typeof handler !== "function") {
+            const availableStatuses = Object.keys(handlers);
+            throw new InvariantViolationException(
+                `Outcome.match is missing a handler for runtime status "${this.status}". Available handlers: ${availableStatuses.join(", ") || "(none)"}`,
+            );
+        }
+
+        return handler(this) as ReturnType<THandlers[S]>;
+    }
+
+    // ─── Derived copies ────────────────────────────────────────────────
+
+    withMetadata(extra: Record<string, unknown>): Outcome<S, D> {
+        return new Outcome(
+            this.status,
+            this.data,
+            this.reason,
+            Object.freeze({ ...this.metadata, ...extra }),
+        );
+    }
+
+    withReason(reason: string): Outcome<S, D> {
+        return new Outcome(this.status, this.data, reason, this.metadata);
+    }
+
+    // ─── Debug ─────────────────────────────────────────────────────────
+
+    toString(): string {
+        const parts: string[] = [this.status];
+        if (this.reason) parts.push(`reason="${this.reason}"`);
+        return `Outcome(${parts.join(", ")})`;
+    }
 }
 
 /** Common business outcome statuses. Extend per domain as needed. */
 export type CommonOutcomeStatus =
-  | "APPROVED"
-  | "REJECTED"
-  | "NO_OP"
-  | "DEFERRED"
-  | "REQUIRES_REVIEW";
+    | "APPROVED"
+    | "REJECTED"
+    | "NO_OP"
+    | "DEFERRED"
+    | "REQUIRES_REVIEW";