@cullet/erp-core 1.0.1 → 1.0.3

package/src/core/policies/index.ts

@@ -15,62 +15,62 @@ export { Outcome } from "../result/outcome";
 // ─── Utils ──────────────────────────────────────────────────────────────────
 export { PolicyHashing } from "./utils";
 export type {
-  PolicyDecisionId,
-  PolicyDefinitionId,
-  SchoolId,
-  TenantId,
+    PolicyDecisionId,
+    PolicyDefinitionId,
+    SchoolId,
+    TenantId,
 } from "./policy-ids";
 export {
-  asPolicyDecisionId,
-  asPolicyDefinitionId,
-  asSchoolId,
-  asTenantId,
+    asPolicyDecisionId,
+    asPolicyDefinitionId,
+    asSchoolId,
+    asTenantId,
 } from "./policy-ids";
 
 // ─── Catalog ────────────────────────────────────────────────────────────────
 export type {
-  AsOfSource,
-  PolicyCatalogEntryProps,
-  PolicyKind,
-  PolicyOwner,
-  PolicyScopeLevel,
+    AsOfSource,
+    PolicyCatalogEntryProps,
+    PolicyKind,
+    PolicyOwner,
+    PolicyScopeLevel,
 } from "./catalog";
 export { PolicyCatalog, PolicyCatalogFactory, PolicyKey } from "./catalog";
 
 // ─── Definitions ────────────────────────────────────────────────────────────
 export type {
-  BasePolicyDefinitionProps,
-  ComputePolicyDefinitionProps,
-  FindCandidatesParams,
-  GatePolicyDefinitionProps,
-  PolicyDefinitionProps,
-  PolicyDefinitionStatus,
-  PolicyScope,
-  ScopeChain,
+    BasePolicyDefinitionProps,
+    ComputePolicyDefinitionProps,
+    FindCandidatesParams,
+    GatePolicyDefinitionProps,
+    PolicyDefinitionProps,
+    PolicyDefinitionStatus,
+    PolicyScope,
+    ScopeChain,
 } from "./defs";
 export {
-  InMemoryPolicyDefinitionRepository,
-  PolicyDefinition,
-  PolicyScopeMatcher,
+    InMemoryPolicyDefinitionRepository,
+    PolicyDefinition,
+    PolicyScopeMatcher,
 } from "./defs";
 
 // ─── Context ────────────────────────────────────────────────────────────────
 export type {
-  ContextResolverCircuitBreakerOptions,
-  ContextResolverResilienceOptions,
-  ContextResolverRetryOptions,
-  ContextSeed,
-  ContextValueResolver,
-  PolicyContextBuilderOptions,
+    ContextResolverCircuitBreakerOptions,
+    ContextResolverResilienceOptions,
+    ContextResolverRetryOptions,
+    ContextSeed,
+    ContextValueResolver,
+    PolicyContextBuilderOptions,
 } from "./context";
 export {
-  ContextSeedValidator,
-  ContextResolverRegistry,
-  contextResolverRegistry,
-  PolicyContextBuilder,
-  PolicyContextPath,
-  registerNamespacedContextResolvers,
-  registerNamespacedContextResolversIn,
+    ContextSeedValidator,
+    ContextResolverRegistry,
+    contextResolverRegistry,
+    PolicyContextBuilder,
+    PolicyContextPath,
+    registerNamespacedContextResolvers,
+    registerNamespacedContextResolversIn,
 } from "./context";
 
 // ─── AsOf ───────────────────────────────────────────────────────────────────
@@ -79,39 +79,39 @@ export { PolicyAsOfResolver } from "./asof";
 
 // ─── Engines ────────────────────────────────────────────────────────────────
 export type {
-  ConditionEvaluationCause,
-  ConditionEvaluationOptions,
-  ConditionEvaluationReport,
-  ConditionEvaluationReportLevel,
-  ConditionEvaluationReportTag,
-  ConditionEvaluatorReporter,
-  GateOutcome,
-  GateOutcomeData,
-  GatePayload,
-  GateStatus,
-  GateTraceLeafSnapshot,
-  GateTraceNodeSnapshot,
-  GateViolationTrace,
-  PolicyContext,
-  PolicyViolation,
-  VersionedGateEngine,
+    ConditionEvaluationCause,
+    ConditionEvaluationOptions,
+    ConditionEvaluationReport,
+    ConditionEvaluationReportLevel,
+    ConditionEvaluationReportTag,
+    ConditionEvaluatorReporter,
+    GateOutcome,
+    GateOutcomeData,
+    GatePayload,
+    GateStatus,
+    GateTraceLeafSnapshot,
+    GateTraceNodeSnapshot,
+    GateViolationTrace,
+    PolicyContext,
+    PolicyViolation,
+    VersionedGateEngine,
 } from "./engines";
 export type {
-  ComputeEvaluator,
-  ComputeEvaluatorRegistration,
-  ComputeOutcome,
-  ComputeOutcomeData,
-  ComputeStatus,
-  VersionedComputeEngine,
+    ComputeEvaluator,
+    ComputeEvaluatorRegistration,
+    ComputeOutcome,
+    ComputeOutcomeData,
+    ComputeStatus,
+    VersionedComputeEngine,
 } from "./engines";
 export {
-  ComputeEngineRegistry,
-  ComputeEvaluatorRegistry,
-  ComputePayloadParsers,
-  ComputePayloadParserRegistry,
-  ComputeRegistry,
-  GateEngineRegistry,
-  GatePayloadParsers,
+    ComputeEngineRegistry,
+    ComputeEvaluatorRegistry,
+    ComputePayloadParsers,
+    ComputePayloadParserRegistry,
+    ComputeRegistry,
+    GateEngineRegistry,
+    GatePayloadParsers,
 } from "./engines";
 
 // ─── Resolver ───────────────────────────────────────────────────────────────
@@ -119,12 +119,12 @@ export { PolicyResolver } from "./resolver";
 
 // ─── Service ────────────────────────────────────────────────────────────────
 export type {
-  EvaluateInput,
-  PolicyDecision,
-  PolicyEvaluationError,
-  PolicyEvaluationResult,
-  PolicyServiceParams,
-  PolicyServiceOptions,
+    EvaluateInput,
+    PolicyDecision,
+    PolicyEvaluationError,
+    PolicyEvaluationResult,
+    PolicyServiceParams,
+    PolicyServiceOptions,
 } from "./service";
 export { PolicyEvaluationErrors, PolicyService } from "./service";
 

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

@@ -11,7 +11,7 @@ import type { ComputeEvaluatorRegistration } from "../engines";
  * - evaluators:    compute evaluator registrations keyed by policy/version.
  */
 export interface PolicyPackage {
-  readonly catalogEntries: readonly PolicyCatalogEntryProps[];
-  readonly definitions: readonly PolicyDefinition[];
-  readonly evaluators: readonly ComputeEvaluatorRegistration[];
+    readonly catalogEntries: readonly PolicyCatalogEntryProps[];
+    readonly definitions: readonly PolicyDefinition[];
+    readonly evaluators: readonly ComputeEvaluatorRegistration[];
 }

package/src/core/policies/policy-ids.ts

@@ -3,7 +3,7 @@ import { InvalidValueException } from "../exceptions/validation-exception";
 import { ValidationField } from "../exceptions/validation-field";
 
 type Brand<TValue, TBrand extends string> = TValue & {
-  readonly __brand: TBrand;
+    readonly __brand: TBrand;
 };
 
 export type PolicyDefinitionId = Brand<string, "PolicyDefinitionId">;
@@ -17,44 +17,44 @@ const TENANT_ID_FIELD = ValidationField.of("tenantId");
 const SCHOOL_ID_FIELD = ValidationField.of("schoolId");
 
 function assertIdString(value: unknown, field: ValidationField): string {
-  if (typeof value !== "string") {
-    throw new InvalidValueException(
-      field,
-      ValidationCode.INVALID_FORMAT,
-      `${field.value} must be a string, got ${typeof value}`,
-    );
-  }
-
-  if (value.trim().length === 0) {
-    throw new InvalidValueException(
-      field,
-      ValidationCode.BLANK,
-      `${field.value} must be a non-empty string`,
-    );
-  }
-
-  return value;
+    if (typeof value !== "string") {
+        throw new InvalidValueException(
+            field,
+            ValidationCode.INVALID_FORMAT,
+            `${field.value} must be a string, got ${typeof value}`,
+        );
+    }
+
+    if (value.trim().length === 0) {
+        throw new InvalidValueException(
+            field,
+            ValidationCode.BLANK,
+            `${field.value} must be a non-empty string`,
+        );
+    }
+
+    return value;
 }
 
 function brandId<TBrand extends string>(
-  value: unknown,
-  field: ValidationField,
+    value: unknown,
+    field: ValidationField,
 ): Brand<string, TBrand> {
-  return assertIdString(value, field) as Brand<string, TBrand>;
+    return assertIdString(value, field) as Brand<string, TBrand>;
 }
 
 export function asPolicyDefinitionId(value: string): PolicyDefinitionId {
-  return brandId<"PolicyDefinitionId">(value, POLICY_DEFINITION_ID_FIELD);
+    return brandId<"PolicyDefinitionId">(value, POLICY_DEFINITION_ID_FIELD);
 }
 
 export function asPolicyDecisionId(value: string): PolicyDecisionId {
-  return brandId<"PolicyDecisionId">(value, POLICY_DECISION_ID_FIELD);
+    return brandId<"PolicyDecisionId">(value, POLICY_DECISION_ID_FIELD);
 }
 
 export function asTenantId(value: string): TenantId {
-  return brandId<"TenantId">(value, TENANT_ID_FIELD);
+    return brandId<"TenantId">(value, TENANT_ID_FIELD);
 }
 
 export function asSchoolId(value: string): SchoolId {
-  return brandId<"SchoolId">(value, SCHOOL_ID_FIELD);
+    return brandId<"SchoolId">(value, SCHOOL_ID_FIELD);
 }

package/src/core/policies/resolver/policy-resolver.ts

@@ -14,44 +14,44 @@ import { Result } from "../../result/result";
  *   5. policyVersion descending (semver — final deterministic tiebreaker)
  */
 export class PolicyResolver {
-  resolveBest(
-    candidates: readonly PolicyDefinition[],
-  ): Result<PolicyDefinition, string> {
-    if (candidates.length === 0) {
-      return Result.err(
-        "No matching policy definition found (candidates list is empty)",
-      );
-    }
+    resolveBest(
+        candidates: readonly PolicyDefinition[],
+    ): Result<PolicyDefinition, string> {
+        if (candidates.length === 0) {
+            return Result.err(
+                "No matching policy definition found (candidates list is empty)",
+            );
+        }
 
-    const sorted = [...candidates].sort((a, b) => {
-      // 1) Scope specificity (higher weight = more specific)
-      const scopeDiff =
-        PolicyScopeMatcher.weight(b.scope.level) -
-        PolicyScopeMatcher.weight(a.scope.level);
-      if (scopeDiff !== 0) return scopeDiff;
+        const sorted = [...candidates].sort((a, b) => {
+            // 1) Scope specificity (higher weight = more specific)
+            const scopeDiff =
+                PolicyScopeMatcher.weight(b.scope.level) -
+                PolicyScopeMatcher.weight(a.scope.level);
+            if (scopeDiff !== 0) return scopeDiff;
 
-      // 2) Priority DESC
-      const priorityDiff = b.priority - a.priority;
-      if (priorityDiff !== 0) return priorityDiff;
+            // 2) Priority DESC
+            const priorityDiff = b.priority - a.priority;
+            if (priorityDiff !== 0) return priorityDiff;
 
-      // 3) publishedAt DESC (fallback createdAt)
-      const aDate = a.publishedAt ?? a.createdAt;
-      const bDate = b.publishedAt ?? b.createdAt;
-      const dateDiff = bDate.getTime() - aDate.getTime();
-      if (dateDiff !== 0) return dateDiff;
+            // 3) publishedAt DESC (fallback createdAt)
+            const aDate = a.publishedAt ?? a.createdAt;
+            const bDate = b.publishedAt ?? b.createdAt;
+            const dateDiff = bDate.getTime() - aDate.getTime();
+            if (dateDiff !== 0) return dateDiff;
 
-      // 4) Engine version DESC — prefers the definition running on the most
-      //    capable engine when scope/priority/date are identical.
-      const aEngine = a.gateEngineVersion ?? a.computeEngineVersion ?? 0;
-      const bEngine = b.gateEngineVersion ?? b.computeEngineVersion ?? 0;
-      const engineDiff = bEngine - aEngine;
-      if (engineDiff !== 0) return engineDiff;
+            // 4) Engine version DESC — prefers the definition running on the most
+            //    capable engine when scope/priority/date are identical.
+            const aEngine = a.gateEngineVersion ?? a.computeEngineVersion ?? 0;
+            const bEngine = b.gateEngineVersion ?? b.computeEngineVersion ?? 0;
+            const engineDiff = bEngine - aEngine;
+            if (engineDiff !== 0) return engineDiff;
 
-      // 5) policyVersion DESC (semver) — final deterministic tiebreaker so
-      //    the winner never depends on repository return order.
-      return comparePolicySemver(b.policyVersion, a.policyVersion);
-    });
+            // 5) policyVersion DESC (semver) — final deterministic tiebreaker so
+            //    the winner never depends on repository return order.
+            return comparePolicySemver(b.policyVersion, a.policyVersion);
+        });
 
-    return Result.ok(sorted[0]);
-  }
+        return Result.ok(sorted[0]);
+    }
 }

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

@@ -1,10 +1,10 @@
 export { PolicyService } from "./policy-service";
 export { PolicyEvaluationErrors } from "./policy-evaluation-error";
 export type {
-  EvaluateInput,
-  PolicyDecision,
-  PolicyEvaluationError,
-  PolicyEvaluationResult,
-  PolicyServiceOptions,
-  PolicyServiceParams,
+    EvaluateInput,
+    PolicyDecision,
+    PolicyEvaluationError,
+    PolicyEvaluationResult,
+    PolicyServiceOptions,
+    PolicyServiceParams,
 } from "./policy-service";