@cullet/erp-core 1.0.2 → 1.0.4

package/src/core/policies/defs/in-memory-policy-definition-repo.ts

@@ -1,73 +1,74 @@
 import type {
-  FindCandidatesParams,
-  PolicyDefinition,
+    FindCandidatesParams,
+    PolicyDefinition,
 } from "./policy-definition";
 import type { PolicyDefinitionRepository } from "./policy-definition-repository";
 import { PolicyScopeMatcher } from "./policy-scope";
 
 export class InMemoryPolicyDefinitionRepository implements PolicyDefinitionRepository {
-  private readonly definitions: readonly PolicyDefinition[];
-  private readonly definitionsByPolicyKey: ReadonlyMap<
-    string,
-    readonly PolicyDefinition[]
-  >;
+    private readonly definitions: readonly PolicyDefinition[];
+    private readonly definitionsByPolicyKey: ReadonlyMap<
+        string,
+        readonly PolicyDefinition[]
+    >;
 
-  constructor(definitions: readonly PolicyDefinition[]) {
-    this.definitions = definitions;
-    this.definitionsByPolicyKey = definitions.reduce<
-      Map<string, PolicyDefinition[]>
-    >((index, definition) => {
-      const existingDefinitions = index.get(definition.policyKey) ?? [];
-      existingDefinitions.push(definition);
-      index.set(definition.policyKey, existingDefinitions);
-      return index;
-    }, new Map<string, PolicyDefinition[]>());
-  }
+    constructor(definitions: readonly PolicyDefinition[]) {
+        this.definitions = definitions;
+        this.definitionsByPolicyKey = definitions.reduce<
+            Map<string, PolicyDefinition[]>
+        >((index, definition) => {
+            const existingDefinitions = index.get(definition.policyKey) ?? [];
+            existingDefinitions.push(definition);
+            index.set(definition.policyKey, existingDefinitions);
+            return index;
+        }, new Map<string, PolicyDefinition[]>());
+    }
 
-  findCandidates(params: FindCandidatesParams): PolicyDefinition[] {
-    const {
-      policyKey,
-      kind,
-      payloadSchemaVersion,
-      asOf,
-      contextVersion,
-      scopeChain,
-    } = params;
+    findCandidates(params: FindCandidatesParams): PolicyDefinition[] {
+        const {
+            policyKey,
+            kind,
+            payloadSchemaVersion,
+            asOf,
+            contextVersion,
+            scopeChain,
+        } = params;
 
-    const candidatesForPolicyKey =
-      this.definitionsByPolicyKey.get(policyKey) ?? [];
+        const candidatesForPolicyKey =
+            this.definitionsByPolicyKey.get(policyKey) ?? [];
 
-    const candidates = candidatesForPolicyKey.filter((def) => {
-      // Match kind
-      if (def.kind !== kind) return false;
-      if (
-        payloadSchemaVersion !== undefined &&
-        def.payloadSchemaVersion !== payloadSchemaVersion
-      ) {
-        return false;
-      }
+        const candidates = candidatesForPolicyKey.filter((def) => {
+            // Match kind
+            if (def.kind !== kind) return false;
+            if (
+                payloadSchemaVersion !== undefined &&
+                def.payloadSchemaVersion !== payloadSchemaVersion
+            ) {
+                return false;
+            }
 
-      if (!def.enabled) return false;
+            if (!def.enabled) return false;
 
-      // Only PUBLISHED
-      if (def.status !== "PUBLISHED") return false;
+            // Only PUBLISHED
+            if (def.status !== "PUBLISHED") return false;
 
-      // Effective date range (effectiveFrom <= asOf, and effectiveTo is null or > asOf)
-      if (def.effectiveFrom > asOf) return false;
-      if (def.effectiveTo !== null && def.effectiveTo <= asOf) return false;
+            // Effective date range (effectiveFrom <= asOf, and effectiveTo is null or > asOf)
+            if (def.effectiveFrom > asOf) return false;
+            if (def.effectiveTo !== null && def.effectiveTo <= asOf)
+                return false;
 
-      // Context version compatibility
-      if (contextVersion < def.contextVersionMin) return false;
-      if (contextVersion > def.contextVersionMax) return false;
+            // Context version compatibility
+            if (contextVersion < def.contextVersionMin) return false;
+            if (contextVersion > def.contextVersionMax) return false;
 
-      // Scope must match one of the chain entries
-      if (!PolicyScopeMatcher.matchesChain(def.scope, scopeChain)) {
-        return false;
-      }
+            // Scope must match one of the chain entries
+            if (!PolicyScopeMatcher.matchesChain(def.scope, scopeChain)) {
+                return false;
+            }
 
-      return true;
-    });
+            return true;
+        });
 
-    return candidates;
-  }
+        return candidates;
+    }
 }

package/src/core/policies/defs/index.ts

@@ -1,19 +1,19 @@
 export { InMemoryPolicyDefinitionRepository } from "./in-memory-policy-definition-repo";
 export type {
-  BasePolicyDefinitionProps,
-  ComputePolicyDefinitionInput,
-  ComputePolicyDefinitionProps,
-  FindCandidatesParams,
-  GatePolicyDefinitionInput,
-  GatePolicyDefinitionProps,
-  PolicyDefinitionProps,
-  PolicyDefinitionStatus,
+    BasePolicyDefinitionProps,
+    ComputePolicyDefinitionInput,
+    ComputePolicyDefinitionProps,
+    FindCandidatesParams,
+    GatePolicyDefinitionInput,
+    GatePolicyDefinitionProps,
+    PolicyDefinitionProps,
+    PolicyDefinitionStatus,
 } from "./policy-definition";
 export { PolicyDefinition } from "./policy-definition";
 export type { PolicyDefinitionRepository } from "./policy-definition-repository";
 export type {
-  AnyPolicyPayload,
-  PayloadForKey,
+    AnyPolicyPayload,
+    PayloadForKey,
 } from "./policy-payload.contracts";
 export { comparePolicySemver, POLICY_SEMVER_PATTERN } from "./policy-semver";
 export type { PolicyScope, ScopeChain } from "./policy-scope";

package/src/core/policies/defs/policy-definition-repository.ts

@@ -1,8 +1,8 @@
 import type {
-  FindCandidatesParams,
-  PolicyDefinition,
+    FindCandidatesParams,
+    PolicyDefinition,
 } from "./policy-definition";
 
 export interface PolicyDefinitionRepository {
-  findCandidates(params: FindCandidatesParams): PolicyDefinition[];
+    findCandidates(params: FindCandidatesParams): PolicyDefinition[];
 }

package/src/core/policies/defs/policy-definition.ts

@@ -13,180 +13,181 @@ export type PolicyDefinitionStatus = "DRAFT" | "PUBLISHED" | "RETIRED";
 // ─── Definition props ───────────────────────────────────────────────────────
 
 export interface BasePolicyDefinitionProps<
-  K extends string = string,
-  P extends AnyPolicyPayload = AnyPolicyPayload,
+    K extends string = string,
+    P extends AnyPolicyPayload = AnyPolicyPayload,
 > {
-  readonly id: PolicyDefinitionId;
-  readonly policyKey: K;
-  readonly policyVersion: string; // semver
-  readonly payloadSchemaVersion: number;
-  readonly contextVersionMin: number;
-  readonly contextVersionMax: number;
-  readonly enabled: boolean;
-  readonly status: PolicyDefinitionStatus;
-  readonly scope: PolicyScope;
-  readonly effectiveFrom: Date;
-  readonly effectiveTo: Date | null;
-  readonly priority: number;
-  readonly payloadJson: P;
-  readonly payloadHash: string;
-  readonly createdAt: Date;
-  readonly publishedAt: Date | null;
+    readonly id: PolicyDefinitionId;
+    readonly policyKey: K;
+    readonly policyVersion: string; // semver
+    readonly payloadSchemaVersion: number;
+    readonly contextVersionMin: number;
+    readonly contextVersionMax: number;
+    readonly enabled: boolean;
+    readonly status: PolicyDefinitionStatus;
+    readonly scope: PolicyScope;
+    readonly effectiveFrom: Date;
+    readonly effectiveTo: Date | null;
+    readonly priority: number;
+    readonly payloadJson: P;
+    readonly payloadHash: string;
+    readonly createdAt: Date;
+    readonly publishedAt: Date | null;
 }
 
 export interface GatePolicyDefinitionProps<
-  K extends string = string,
-  P extends AnyPolicyPayload = AnyPolicyPayload,
+    K extends string = string,
+    P extends AnyPolicyPayload = AnyPolicyPayload,
 > extends BasePolicyDefinitionProps<K, P> {
-  readonly kind: "GATE";
-  readonly gateEngineVersion: number;
+    readonly kind: "GATE";
+    readonly gateEngineVersion: number;
 }
 
 export interface ComputePolicyDefinitionProps<
-  K extends string = string,
-  P extends AnyPolicyPayload = AnyPolicyPayload,
+    K extends string = string,
+    P extends AnyPolicyPayload = AnyPolicyPayload,
 > extends BasePolicyDefinitionProps<K, P> {
-  readonly kind: "COMPUTE";
-  readonly computeEngineVersion: number;
+    readonly kind: "COMPUTE";
+    readonly computeEngineVersion: number;
 }
 
 export type GatePolicyDefinitionInput<
-  K extends string = string,
-  P extends AnyPolicyPayload = AnyPolicyPayload,
+    K extends string = string,
+    P extends AnyPolicyPayload = AnyPolicyPayload,
 > = Omit<GatePolicyDefinitionProps<K, P>, "kind" | "enabled"> & {
-  readonly enabled?: boolean;
+    readonly enabled?: boolean;
 };
 
 export type ComputePolicyDefinitionInput<
-  K extends string = string,
-  P extends AnyPolicyPayload = AnyPolicyPayload,
+    K extends string = string,
+    P extends AnyPolicyPayload = AnyPolicyPayload,
 > = Omit<ComputePolicyDefinitionProps<K, P>, "kind" | "enabled"> & {
-  readonly enabled?: boolean;
+    readonly enabled?: boolean;
 };
 
 export type PolicyDefinitionProps<
-  K extends string = string,
-  P extends AnyPolicyPayload = AnyPolicyPayload,
+    K extends string = string,
+    P extends AnyPolicyPayload = AnyPolicyPayload,
 > = GatePolicyDefinitionProps<K, P> | ComputePolicyDefinitionProps<K, P>;
 
 // ─── Definition row (as if loaded from database) ────────────────────────────
 
 export class PolicyDefinition<
-  K extends string = string,
-  P extends AnyPolicyPayload = AnyPolicyPayload,
+    K extends string = string,
+    P extends AnyPolicyPayload = AnyPolicyPayload,
 > {
-  private static assertPolicyVersionIsSemver(policyVersion: string): void {
-    if (!POLICY_SEMVER_PATTERN.test(policyVersion)) {
-      throw new InvariantViolationException(
-        `PolicyDefinition.policyVersion must be a valid semver. Received: "${policyVersion}"`,
-      );
+    private static assertPolicyVersionIsSemver(policyVersion: string): void {
+        if (!POLICY_SEMVER_PATTERN.test(policyVersion)) {
+            throw new InvariantViolationException(
+                `PolicyDefinition.policyVersion must be a valid semver. Received: "${policyVersion}"`,
+            );
+        }
+    }
+
+    public readonly id: PolicyDefinitionId;
+    public readonly policyKey: K;
+
+    public readonly policyVersion: string;
+    public readonly payloadSchemaVersion: number;
+    public readonly contextVersionMin: number;
+    public readonly contextVersionMax: number;
+    public readonly gateEngineVersion?: number;
+    public readonly computeEngineVersion?: number;
+
+    public readonly enabled: boolean;
+    public readonly status: PolicyDefinitionStatus;
+    public readonly scope: PolicyScope;
+    public readonly effectiveFrom: Date;
+    public readonly effectiveTo: Date | null;
+    public readonly priority: number;
+    public readonly payloadJson: P;
+    public readonly payloadHash: string;
+    public readonly createdAt: Date;
+    public readonly publishedAt: Date | null;
+    public readonly kind: PolicyKind;
+
+    private constructor(props: PolicyDefinitionProps<K, P>) {
+        // The static factories are the supported API. This guard stays here because
+        // TypeScript privacy does not protect runtime-only construction paths.
+        this.id = props.id;
+        this.policyKey = props.policyKey;
+        PolicyDefinition.assertPolicyVersionIsSemver(props.policyVersion);
+        this.policyVersion = props.policyVersion;
+        this.payloadSchemaVersion = props.payloadSchemaVersion;
+        this.contextVersionMin = props.contextVersionMin;
+        this.contextVersionMax = props.contextVersionMax;
+        this.enabled = props.enabled;
+        this.status = props.status;
+        this.scope = props.scope;
+        this.effectiveFrom = props.effectiveFrom;
+        this.effectiveTo = props.effectiveTo;
+        this.priority = props.priority;
+        this.payloadJson = props.payloadJson;
+        this.payloadHash = props.payloadHash;
+        this.createdAt = props.createdAt;
+        this.publishedAt = props.publishedAt;
+        this.kind = props.kind;
+
+        if (props.kind === "GATE") {
+            if (props.gateEngineVersion === undefined) {
+                throw new InvariantViolationException(
+                    `PolicyDefinition of kind 'GATE' must have a 'gateEngineVersion'. Policy key: ${props.policyKey}`,
+                );
+            }
+            this.gateEngineVersion = props.gateEngineVersion;
+        } else {
+            if (props.computeEngineVersion === undefined) {
+                throw new InvariantViolationException(
+                    `PolicyDefinition of kind 'COMPUTE' must have a 'computeEngineVersion'. Policy key: ${props.policyKey}`,
+                );
+            }
+            this.computeEngineVersion = props.computeEngineVersion;
+        }
     }
-  }
-
-  public readonly id: PolicyDefinitionId;
-  public readonly policyKey: K;
-
-  public readonly policyVersion: string;
-  public readonly payloadSchemaVersion: number;
-  public readonly contextVersionMin: number;
-  public readonly contextVersionMax: number;
-  public readonly gateEngineVersion?: number;
-  public readonly computeEngineVersion?: number;
-
-  public readonly enabled: boolean;
-  public readonly status: PolicyDefinitionStatus;
-  public readonly scope: PolicyScope;
-  public readonly effectiveFrom: Date;
-  public readonly effectiveTo: Date | null;
-  public readonly priority: number;
-  public readonly payloadJson: P;
-  public readonly payloadHash: string;
-  public readonly createdAt: Date;
-  public readonly publishedAt: Date | null;
-  public readonly kind: PolicyKind;
-
-  private constructor(props: PolicyDefinitionProps<K, P>) {
-    // The static factories are the supported API. This guard stays here because
-    // TypeScript privacy does not protect runtime-only construction paths.
-    this.id = props.id;
-    this.policyKey = props.policyKey;
-    PolicyDefinition.assertPolicyVersionIsSemver(props.policyVersion);
-    this.policyVersion = props.policyVersion;
-    this.payloadSchemaVersion = props.payloadSchemaVersion;
-    this.contextVersionMin = props.contextVersionMin;
-    this.contextVersionMax = props.contextVersionMax;
-    this.enabled = props.enabled;
-    this.status = props.status;
-    this.scope = props.scope;
-    this.effectiveFrom = props.effectiveFrom;
-    this.effectiveTo = props.effectiveTo;
-    this.priority = props.priority;
-    this.payloadJson = props.payloadJson;
-    this.payloadHash = props.payloadHash;
-    this.createdAt = props.createdAt;
-    this.publishedAt = props.publishedAt;
-    this.kind = props.kind;
-
-    if (props.kind === "GATE") {
-      if (props.gateEngineVersion === undefined) {
-        throw new InvariantViolationException(
-          `PolicyDefinition of kind 'GATE' must have a 'gateEngineVersion'. Policy key: ${props.policyKey}`,
-        );
-      }
-      this.gateEngineVersion = props.gateEngineVersion;
-    } else {
-      if (props.computeEngineVersion === undefined) {
-        throw new InvariantViolationException(
-          `PolicyDefinition of kind 'COMPUTE' must have a 'computeEngineVersion'. Policy key: ${props.policyKey}`,
-        );
-      }
-      this.computeEngineVersion = props.computeEngineVersion;
+
+    static gate<
+        K extends string,
+        P extends AnyPolicyPayload = AnyPolicyPayload,
+    >(props: GatePolicyDefinitionInput<K, P>): PolicyDefinition<K, P> {
+        return new PolicyDefinition<K, P>({
+            ...props,
+            enabled: props.enabled ?? true,
+            kind: "GATE",
+        });
     }
-  }
-
-  static gate<K extends string, P extends AnyPolicyPayload = AnyPolicyPayload>(
-    props: GatePolicyDefinitionInput<K, P>,
-  ): PolicyDefinition<K, P> {
-    return new PolicyDefinition<K, P>({
-      ...props,
-      enabled: props.enabled ?? true,
-      kind: "GATE",
-    });
-  }
-
-  static compute<
-    K extends string,
-    P extends AnyPolicyPayload = AnyPolicyPayload,
-  >(props: ComputePolicyDefinitionInput<K, P>): PolicyDefinition<K, P> {
-    return new PolicyDefinition<K, P>({
-      ...props,
-      enabled: props.enabled ?? true,
-      kind: "COMPUTE",
-    });
-  }
-
-  isGate(): this is PolicyDefinition<K, P> & {
-    readonly kind: "GATE";
-    readonly gateEngineVersion: number;
-  } {
-    return this.kind === "GATE";
-  }
 
-  isCompute(): this is PolicyDefinition<K, P> & {
-    readonly kind: "COMPUTE";
-    readonly computeEngineVersion: number;
-  } {
-    return this.kind === "COMPUTE";
-  }
+    static compute<
+        K extends string,
+        P extends AnyPolicyPayload = AnyPolicyPayload,
+    >(props: ComputePolicyDefinitionInput<K, P>): PolicyDefinition<K, P> {
+        return new PolicyDefinition<K, P>({
+            ...props,
+            enabled: props.enabled ?? true,
+            kind: "COMPUTE",
+        });
+    }
+
+    isGate(): this is PolicyDefinition<K, P> & {
+        readonly kind: "GATE";
+        readonly gateEngineVersion: number;
+    } {
+        return this.kind === "GATE";
+    }
+
+    isCompute(): this is PolicyDefinition<K, P> & {
+        readonly kind: "COMPUTE";
+        readonly computeEngineVersion: number;
+    } {
+        return this.kind === "COMPUTE";
+    }
 }
 
 // ─── Query parameters ───────────────────────────────────────────────────────
 
 export interface FindCandidatesParams {
-  readonly policyKey: string;
-  readonly kind: PolicyKind;
-  readonly payloadSchemaVersion?: number;
-  readonly asOf: Date;
-  readonly contextVersion: number;
-  readonly scopeChain: readonly PolicyScope[];
+    readonly policyKey: string;
+    readonly kind: PolicyKind;
+    readonly payloadSchemaVersion?: number;
+    readonly asOf: Date;
+    readonly contextVersion: number;
+    readonly scopeChain: readonly PolicyScope[];
 }

package/src/core/policies/defs/policy-scope.ts

@@ -5,9 +5,9 @@ import type { SchoolId, TenantId } from "../policy-ids";
  * Scope attached to a PolicyDefinition — defines where it applies.
  */
 export interface PolicyScope {
-  readonly level: PolicyScopeLevel;
-  readonly tenantId: TenantId | null;
-  readonly schoolId: SchoolId | null;
+    readonly level: PolicyScopeLevel;
+    readonly tenantId: TenantId | null;
+    readonly schoolId: SchoolId | null;
 }
 
 /**
@@ -29,25 +29,27 @@ export type ScopeChain = readonly PolicyScope[];
  * Numeric weight for scope specificity (higher = more specific).
  */
 const SCOPE_WEIGHT: Record<PolicyScopeLevel, number> = {
-  SCHOOL: 3,
-  TENANT: 2,
-  GLOBAL: 1,
+    SCHOOL: 3,
+    TENANT: 2,
+    GLOBAL: 1,
 };
 
 export class PolicyScopeMatcher {
-  static weight(level: PolicyScopeLevel): number {
-    return SCOPE_WEIGHT[level];
-  }
+    static weight(level: PolicyScopeLevel): number {
+        return SCOPE_WEIGHT[level];
+    }
 
-  static matchesChain(defScope: PolicyScope, chain: ScopeChain): boolean {
-    return chain.some((scope) => PolicyScopeMatcher.equals(defScope, scope));
-  }
+    static matchesChain(defScope: PolicyScope, chain: ScopeChain): boolean {
+        return chain.some((scope) =>
+            PolicyScopeMatcher.equals(defScope, scope),
+        );
+    }
 
-  static equals(a: PolicyScope, b: PolicyScope): boolean {
-    return (
-      a.level === b.level &&
-      a.tenantId === b.tenantId &&
-      a.schoolId === b.schoolId
-    );
-  }
+    static equals(a: PolicyScope, b: PolicyScope): boolean {
+        return (
+            a.level === b.level &&
+            a.tenantId === b.tenantId &&
+            a.schoolId === b.schoolId
+        );
+    }
 }