@cullet/erp-core 1.0.5 → 1.0.7

package/src/core/policies/engines/gate-types.ts

@@ -1,7 +1,7 @@
-import type { Outcome } from "../../result/outcome";
-import type { Result } from "../../result/result";
+import type { Outcome } from "../../result/outcome.js";
+import type { Result } from "../../result/result.js";
 
-import type { GatePayload } from "./gate-payload";
+import type { GatePayload } from "./gate-payload.js";
 
 // ─── Shared gate types (version-agnostic) ───────────────────────────────────
 

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

@@ -1,4 +1,4 @@
-export type { ComputePayload, ComputePayloadV1 } from "./compute-payload";
+export type { ComputePayload, ComputePayloadV1 } from "./compute-payload.js";
 export type {
     ComputeEvaluator,
     ComputeEvaluatorRegistration,
@@ -6,7 +6,7 @@ export type {
     ComputeOutcomeData,
     ComputeStatus,
     VersionedComputeEngine,
-} from "./compute-types";
+} from "./compute-types.js";
 export type {
     ConditionEvaluationCause,
     ConditionEvaluationOptions,
@@ -14,12 +14,12 @@ export type {
     ConditionEvaluationReportLevel,
     ConditionEvaluationReportTag,
     ConditionEvaluatorReporter,
-} from "./condition-evaluator-reporter";
-export { ComputeEngineRegistry } from "./compute-engine-registry";
-export { ComputeEvaluatorRegistry } from "./compute-evaluator-registry";
-export { ComputeRegistry } from "./compute-registry";
-export { GateEngineRegistry } from "./gate-engine-registry";
-export type { GatePayload, GatePayloadV1 } from "./gate-payload";
+} from "./condition-evaluator-reporter.js";
+export { ComputeEngineRegistry } from "./compute-engine-registry.js";
+export { ComputeEvaluatorRegistry } from "./compute-evaluator-registry.js";
+export { ComputeRegistry } from "./compute-registry.js";
+export { GateEngineRegistry } from "./gate-engine-registry.js";
+export type { GatePayload, GatePayloadV1 } from "./gate-payload.js";
 export type {
     GateOutcome,
     GateOutcomeData,
@@ -30,19 +30,19 @@ export type {
     PolicyContext,
     PolicyViolation,
     VersionedGateEngine,
-} from "./gate-types";
+} from "./gate-types.js";
 export {
     ComputePayloadParsers,
     ComputePayloadParserRegistry,
-} from "./parse-compute-payload";
-export type { ComputePayloadParser } from "./parse-compute-payload";
+} from "./parse-compute-payload.js";
+export type { ComputePayloadParser } from "./parse-compute-payload.js";
 export {
     GatePayloadParsers,
     GatePayloadParserRegistry,
-} from "./parse-gate-payload";
-export type { GatePayloadParser } from "./parse-gate-payload";
+} from "./parse-gate-payload.js";
+export type { GatePayloadParser } from "./parse-gate-payload.js";
 export type {
     ComputeDecisionTablePayload,
     ComputeDecisionTableRule,
     ComputeParamsPayload,
-} from "./v1/compute";
+} from "./v1/compute/index.js";

package/src/core/policies/engines/parse-compute-payload.ts

@@ -1,8 +1,8 @@
-import type { Result as ResultType } from "../../result/result";
-import { Result } from "../../result/result";
+import type { Result as ResultType } from "../../result/result.js";
+import { Result } from "../../result/result.js";
 
-import type { ComputePayload } from "./compute-payload";
-import { ComputePayloadSchemaV1 } from "./v1/compute/compute-payload.schema";
+import type { ComputePayload } from "./compute-payload.js";
+import { ComputePayloadSchemaV1 } from "./v1/compute/compute-payload.schema.js";
 
 export type ComputePayloadParser = (
     payload: unknown,

package/src/core/policies/engines/parse-gate-payload.ts

@@ -1,8 +1,8 @@
-import type { Result as ResultType } from "../../result/result";
-import { Result } from "../../result/result";
+import type { Result as ResultType } from "../../result/result.js";
+import { Result } from "../../result/result.js";
 
-import type { GatePayload } from "./gate-payload";
-import { GatePayloadSchemaV1 } from "./v1/gate/gate-v1-payload.schema";
+import type { GatePayload } from "./gate-payload.js";
+import { GatePayloadSchemaV1 } from "./v1/gate/gate-v1-payload.schema.js";
 
 export type GatePayloadParser = (
     payload: unknown,

package/src/core/policies/engines/v1/compute/compute-engine-v1.ts

@@ -1,14 +1,14 @@
-import { type CoreConfig, coreConfig } from "../../../../config";
-import { Result } from "../../../../result/result";
+import { type CoreConfig, coreConfig } from "../../../../config/index.js";
+import { Result } from "../../../../result/result.js";
 
-import type { ComputePayloadV1 as ComputePayload } from "./compute-payload.schema";
-import { DecisionTableResolverV1 } from "./resolve-decision-table-v1";
+import type { ComputePayloadV1 as ComputePayload } from "./compute-payload.schema.js";
+import { DecisionTableResolverV1 } from "./resolve-decision-table-v1.js";
 import type {
     ComputeEvaluator,
     ComputeOutcome,
     VersionedComputeEngine,
-} from "../../compute-types";
-import type { PolicyContext } from "../../gate-types";
+} from "../../compute-types.js";
+import type { PolicyContext } from "../../gate-types.js";
 
 // ─── Compute engine v1 ───────────────────────────────────────────────────────
 

package/src/core/policies/engines/v1/compute/compute-payload.schema.ts

@@ -1,9 +1,9 @@
 import { z } from "zod";
 
-import { Result } from "../../../../result/result";
+import { Result } from "../../../../result/result.js";
 
-import { conditionNodeSchema } from "../condition-schema";
-import type { ConditionNode } from "../condition-types";
+import { conditionNodeSchema } from "../condition-schema.js";
+import type { ConditionNode } from "../condition-types.js";
 
 // ─── Pattern 1: Params ──────────────────────────────────────────────────────
 

package/src/core/policies/engines/v1/compute/index.ts

@@ -1,12 +1,12 @@
-export { ComputeEngineV1 } from "./compute-engine-v1";
+export { ComputeEngineV1 } from "./compute-engine-v1.js";
 export type {
     ComputeDecisionTablePayload,
     ComputeDecisionTableRule,
     ComputeParamsPayload,
     ComputePayloadV1,
-} from "./compute-payload.schema";
+} from "./compute-payload.schema.js";
 export {
     computePayloadSchema,
     ComputePayloadSchemaV1,
-} from "./compute-payload.schema";
-export { DecisionTableResolverV1 } from "./resolve-decision-table-v1";
+} from "./compute-payload.schema.js";
+export { DecisionTableResolverV1 } from "./resolve-decision-table-v1.js";

package/src/core/policies/engines/v1/compute/resolve-decision-table-v1.ts

@@ -1,9 +1,9 @@
-import { Result } from "../../../../result/result";
+import { Result } from "../../../../result/result.js";
 
-import type { ConditionEvaluationOptions } from "../../condition-evaluator-reporter";
+import type { ConditionEvaluationOptions } from "../../condition-evaluator-reporter.js";
 
-import { ConditionEvaluatorV1 } from "../condition-evaluator";
-import type { ComputeDecisionTablePayload } from "./compute-payload.schema";
+import { ConditionEvaluatorV1 } from "../condition-evaluator.js";
+import type { ComputeDecisionTablePayload } from "./compute-payload.schema.js";
 
 const COMPUTE_CONDITION_EVAL_FAILED_TAG = "COMPUTE_CONDITION_EVAL_FAILED";
 

package/src/core/policies/engines/v1/condition-evaluator.ts

@@ -1,6 +1,6 @@
-import { PolicyContextPath } from "../../context";
-import { PolicyDateUtils } from "../../utils";
-import { Result } from "../../../result/result";
+import { PolicyContextPath } from "../../context/index.js";
+import { PolicyDateUtils } from "../../utils/index.js";
+import { Result } from "../../../result/result.js";
 
 import type {
     ConditionAndNode,
@@ -9,18 +9,20 @@ import type {
     ConditionNotNode,
     ConditionOp,
     ConditionOrNode,
-} from "./condition-types";
+} from "./condition-types.js";
 import type {
     ConditionEvaluationOptions,
     ConditionEvaluationReport,
-} from "../condition-evaluator-reporter";
-import type { PolicyContext } from "../gate-types";
+} from "../condition-evaluator-reporter.js";
+import type { PolicyContext } from "../gate-types.js";
 
 const CONDITION_EVAL_THROWN_TAG = "CONDITION_EVAL_THREW";
 const NULLISH_NUMERIC_OPERAND_NOT_ALLOWED_TAG =
     "NULLISH_NUMERIC_OPERAND_NOT_ALLOWED";
 const NULLISH_DATE_OPERAND_NOT_ALLOWED_TAG = "NULLISH_DATE_OPERAND_NOT_ALLOWED";
 const INVALID_DATE_OPERAND_TAG = "INVALID_DATE_OPERAND";
+const INVALID_NUMERIC_OPERAND_TAG = "INVALID_NUMERIC_OPERAND";
+const INVALID_SET_OPERAND_TAG = "INVALID_SET_OPERAND";
 const EMPTY_OR_CONDITION_TAG = "EMPTY_OR_CONDITION";
 const EMPTY_AND_CONDITION_TAG = "EMPTY_AND_CONDITION";
 const ISO_8601_UTC_DATE_PATTERN =
@@ -110,6 +112,18 @@ export class ConditionEvaluatorV1 {
         return `${INVALID_DATE_OPERAND_TAG}: "${node.field}" with operator "${node.op}" requires Date or ISO 8601 UTC string operands`;
     }
 
+    private static buildInvalidNumericOperandMessage(
+        node: ConditionLeafNode,
+    ): string {
+        return `${INVALID_NUMERIC_OPERAND_TAG}: "${node.field}" with operator "${node.op}" requires numeric operands`;
+    }
+
+    private static buildInvalidSetOperandMessage(
+        node: ConditionLeafNode,
+    ): string {
+        return `${INVALID_SET_OPERAND_TAG}: "${node.field}" with operator "${node.op}" requires an array operand`;
+    }
+
     private static buildEmptyOrConditionMessage(): string {
         return `${EMPTY_OR_CONDITION_TAG}: OR nodes must contain at least one child condition`;
     }
@@ -224,6 +238,56 @@ export class ConditionEvaluatorV1 {
         return Result.err(message);
     }
 
+    private reportInvalidNumericOperand(
+        node: ConditionLeafNode,
+        actual: unknown,
+    ): Result<boolean, string> {
+        const message =
+            ConditionEvaluatorV1.buildInvalidNumericOperandMessage(node);
+
+        this.options.reporter.error(
+            this.buildReport({
+                level: "error",
+                tag: INVALID_NUMERIC_OPERAND_TAG,
+                message,
+                details: {
+                    field: node.field,
+                    op: node.op,
+                    actual,
+                    expected: node.value,
+                    node,
+                },
+            }),
+        );
+
+        return Result.err(message);
+    }
+
+    private reportInvalidSetOperand(
+        node: ConditionLeafNode,
+        actual: unknown,
+    ): Result<boolean, string> {
+        const message =
+            ConditionEvaluatorV1.buildInvalidSetOperandMessage(node);
+
+        this.options.reporter.error(
+            this.buildReport({
+                level: "error",
+                tag: INVALID_SET_OPERAND_TAG,
+                message,
+                details: {
+                    field: node.field,
+                    op: node.op,
+                    actual,
+                    expected: node.value,
+                    node,
+                },
+            }),
+        );
+
+        return Result.err(message);
+    }
+
     private evaluateDateRelationalNode(
         node: ConditionLeafNode,
         actual: unknown,
@@ -406,6 +470,19 @@ export class ConditionEvaluatorV1 {
             return Result.err(message);
         }
 
+        // null + allowNull: a relational comparison against a missing value
+        // never matches.
+        if (actual === null) {
+            return Result.ok(false);
+        }
+
+        // Both operands must be numbers. A present but wrong-typed operand is a
+        // context/configuration error, surfaced like the date path instead of
+        // silently collapsing to "no match".
+        if (typeof actual !== "number" || typeof node.value !== "number") {
+            return this.reportInvalidNumericOperand(node, actual);
+        }
+
         return Result.ok(this.evaluateOperator(actual, node.op, node.value));
     }
 
@@ -443,6 +520,13 @@ export class ConditionEvaluatorV1 {
                 return this.evaluateNumericRelationalNode(node, actual);
             }
 
+            if (
+                (node.op === "in" || node.op === "notIn") &&
+                !Array.isArray(node.value)
+            ) {
+                return this.reportInvalidSetOperand(node, actual);
+            }
+
             return Result.ok(
                 this.evaluateOperator(actual, node.op, node.value),
             );

package/src/core/policies/engines/v1/condition-schema.ts

@@ -1,6 +1,6 @@
 import { z } from "zod";
 
-import type { ConditionLeafNode, ConditionNode } from "./condition-types";
+import type { ConditionLeafNode, ConditionNode } from "./condition-types.js";
 
 // ─── Shared v1 condition Zod schemas ─────────────────────────────────────────
 // Extracted from gate/v1 so both gate/v1 and compute/v1 can validate

package/src/core/policies/engines/v1/gate/gate-engine-v1.ts

@@ -1,13 +1,13 @@
-import { type CoreConfig, coreConfig } from "../../../../config";
-import { Outcome } from "../../../../result/outcome";
-import { Result } from "../../../../result/result";
+import { type CoreConfig, coreConfig } from "../../../../config/index.js";
+import { Outcome } from "../../../../result/outcome.js";
+import { Result } from "../../../../result/result.js";
 
 import {
     ConditionEvaluatorV1,
     type TracedConditionEvaluation,
-} from "../condition-evaluator";
-import type { ConditionLeafNode, ConditionNode } from "../condition-types";
-import type { GatePayload } from "../../gate-payload";
+} from "../condition-evaluator.js";
+import type { ConditionLeafNode, ConditionNode } from "../condition-types.js";
+import type { GatePayload } from "../../gate-payload.js";
 import type {
     GateOutcome,
     GateStatus,
@@ -16,7 +16,7 @@ import type {
     PolicyContext,
     PolicyViolation,
     VersionedGateEngine,
-} from "../../gate-types";
+} from "../../gate-types.js";
 
 // ─── Gate engine v1 ─────────────────────────────────────────────────────────
 

package/src/core/policies/engines/v1/gate/gate-types-v1.ts

@@ -2,7 +2,7 @@
 // The condition-tree DSL types are shared across the v1 engine family and live
 // in engines/v1. Imported here for the GatePayloadV1 definition only — not
 // re-exported; consumers should import condition types from engines/v1.
-import type { ConditionNode } from "../condition-types";
+import type { ConditionNode } from "../condition-types.js";
 
 export type GatePayloadV1 =
     | { readonly condition: ConditionNode }

package/src/core/policies/engines/v1/gate/gate-v1-payload.schema.ts

@@ -1,12 +1,12 @@
 import { z } from "zod";
 
-import { Result } from "../../../../result/result";
+import { Result } from "../../../../result/result.js";
 
-import type { GatePayloadV1 } from "./gate-types-v1";
+import type { GatePayloadV1 } from "./gate-types-v1.js";
 import {
     conditionLeafNodeSchema,
     conditionNodeSchema,
-} from "../condition-schema";
+} from "../condition-schema.js";
 
 // Re-export so gate/v1 public API remains unchanged.
 export { conditionLeafNodeSchema, conditionNodeSchema };

package/src/core/policies/engines/v1/gate/index.ts

@@ -1,9 +1,9 @@
-export { ConditionEvaluatorV1 } from "../condition-evaluator";
-export { GateEngineV1 } from "./gate-engine-v1";
-export type { GatePayloadV1 } from "./gate-types-v1";
+export { ConditionEvaluatorV1 } from "../condition-evaluator.js";
+export { GateEngineV1 } from "./gate-engine-v1.js";
+export type { GatePayloadV1 } from "./gate-types-v1.js";
 export {
     conditionLeafNodeSchema,
     conditionNodeSchema,
     gatePayloadSchema,
     GatePayloadSchemaV1,
-} from "./gate-v1-payload.schema";
+} from "./gate-v1-payload.schema.js";

package/src/core/policies/engines/v1/index.ts

@@ -1,8 +1,8 @@
-export { ConditionEvaluatorV1 } from "./condition-evaluator";
+export { ConditionEvaluatorV1 } from "./condition-evaluator.js";
 export {
     conditionLeafNodeSchema,
     conditionNodeSchema,
-} from "./condition-schema";
+} from "./condition-schema.js";
 export type {
     ConditionAndNode,
     ConditionLeafNode,
@@ -10,4 +10,4 @@ export type {
     ConditionNotNode,
     ConditionOp,
     ConditionOrNode,
-} from "./condition-types";
+} from "./condition-types.js";

package/src/core/policies/index.ts

@@ -2,30 +2,33 @@
 // Re-exports all public types, classes and utilities.
 
 // ─── Core Config ────────────────────────────────────────────────────────────
-export type { CoreConfigOptions, CoreObservabilityConfig } from "../config";
-export { CoreConfig, coreConfig } from "../config";
+export type {
+    CoreConfigOptions,
+    CoreObservabilityConfig,
+} from "../config/index.js";
+export { CoreConfig, coreConfig } from "../config/index.js";
 
 // ─── Result (technical execution) ───────────────────────────────────────────
-export { Err, Ok, Result } from "../result/result";
+export { Err, Ok, Result } from "../result/result.js";
 
 // ─── Outcome (business decision) ───────────────────────────────────────────
-export type { CommonOutcomeStatus } from "../result/outcome";
-export { Outcome } from "../result/outcome";
+export type { CommonOutcomeStatus } from "../result/outcome.js";
+export { Outcome } from "../result/outcome.js";
 
 // ─── Utils ──────────────────────────────────────────────────────────────────
-export { PolicyHashing } from "./utils";
+export { PolicyHashing } from "./utils/index.js";
 export type {
     PolicyDecisionId,
     PolicyDefinitionId,
     SchoolId,
     TenantId,
-} from "./policy-ids";
+} from "./policy-ids.js";
 export {
     asPolicyDecisionId,
     asPolicyDefinitionId,
     asSchoolId,
     asTenantId,
-} from "./policy-ids";
+} from "./policy-ids.js";
 
 // ─── Catalog ────────────────────────────────────────────────────────────────
 export type {
@@ -34,8 +37,12 @@ export type {
     PolicyKind,
     PolicyOwner,
     PolicyScopeLevel,
-} from "./catalog";
-export { PolicyCatalog, PolicyCatalogFactory, PolicyKey } from "./catalog";
+} from "./catalog/index.js";
+export {
+    PolicyCatalog,
+    PolicyCatalogFactory,
+    PolicyKey,
+} from "./catalog/index.js";
 
 // ─── Definitions ────────────────────────────────────────────────────────────
 export type {
@@ -47,12 +54,12 @@ export type {
     PolicyDefinitionStatus,
     PolicyScope,
     ScopeChain,
-} from "./defs";
+} from "./defs/index.js";
 export {
     InMemoryPolicyDefinitionRepository,
     PolicyDefinition,
     PolicyScopeMatcher,
-} from "./defs";
+} from "./defs/index.js";
 
 // ─── Context ────────────────────────────────────────────────────────────────
 export type {
@@ -62,7 +69,7 @@ export type {
     ContextSeed,
     ContextValueResolver,
     PolicyContextBuilderOptions,
-} from "./context";
+} from "./context/index.js";
 export {
     ContextSeedValidator,
     ContextResolverRegistry,
@@ -71,11 +78,11 @@ export {
     PolicyContextPath,
     registerNamespacedContextResolvers,
     registerNamespacedContextResolversIn,
-} from "./context";
+} from "./context/index.js";
 
 // ─── AsOf ───────────────────────────────────────────────────────────────────
-export type { DeriveAsOfOptions } from "./asof";
-export { PolicyAsOfResolver } from "./asof";
+export type { DeriveAsOfOptions } from "./asof/index.js";
+export { PolicyAsOfResolver } from "./asof/index.js";
 
 // ─── Engines ────────────────────────────────────────────────────────────────
 export type {
@@ -95,7 +102,7 @@ export type {
     PolicyContext,
     PolicyViolation,
     VersionedGateEngine,
-} from "./engines";
+} from "./engines/index.js";
 export type {
     ComputeEvaluator,
     ComputeEvaluatorRegistration,
@@ -103,7 +110,7 @@ export type {
     ComputeOutcomeData,
     ComputeStatus,
     VersionedComputeEngine,
-} from "./engines";
+} from "./engines/index.js";
 export {
     ComputeEngineRegistry,
     ComputeEvaluatorRegistry,
@@ -112,10 +119,10 @@ export {
     ComputeRegistry,
     GateEngineRegistry,
     GatePayloadParsers,
-} from "./engines";
+} from "./engines/index.js";
 
 // ─── Resolver ───────────────────────────────────────────────────────────────
-export { PolicyResolver } from "./resolver";
+export { PolicyResolver } from "./resolver/index.js";
 
 // ─── Service ────────────────────────────────────────────────────────────────
 export type {
@@ -125,8 +132,8 @@ export type {
     PolicyEvaluationResult,
     PolicyServiceParams,
     PolicyServiceOptions,
-} from "./service";
-export { PolicyEvaluationErrors, PolicyService } from "./service";
+} from "./service/index.js";
+export { PolicyEvaluationErrors, PolicyService } from "./service/index.js";
 
 // ─── Package (contribution protocol) ────────────────────────────────────────
-export type { PolicyPackage } from "./package/policy-package";
+export type { PolicyPackage } from "./package/policy-package.js";

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

@@ -1,6 +1,6 @@
-import type { PolicyCatalogEntryProps } from "../catalog";
-import type { PolicyDefinition } from "../defs";
-import type { ComputeEvaluatorRegistration } from "../engines";
+import type { PolicyCatalogEntryProps } from "../catalog/index.js";
+import type { PolicyDefinition } from "../defs/index.js";
+import type { ComputeEvaluatorRegistration } from "../engines/index.js";
 
 /**
  * Protocol of contribution: a module declares what it wants to add to the

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

@@ -1,6 +1,6 @@
-import { ValidationCode } from "../exceptions/validation-code";
-import { InvalidValueException } from "../exceptions/validation-exception";
-import { ValidationField } from "../exceptions/validation-field";
+import { ValidationCode } from "../exceptions/validation-code.js";
+import { InvalidValueException } from "../exceptions/validation-exception.js";
+import { ValidationField } from "../exceptions/validation-field.js";
 
 type Brand<TValue, TBrand extends string> = TValue & {
     readonly __brand: TBrand;

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

@@ -1 +1 @@
-export { PolicyResolver } from "./policy-resolver";
+export { PolicyResolver } from "./policy-resolver.js";

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

@@ -1,7 +1,7 @@
-import type { PolicyDefinition } from "../defs";
-import { PolicyScopeMatcher } from "../defs";
-import { comparePolicySemver } from "../defs/policy-semver";
-import { Result } from "../../result/result";
+import type { PolicyDefinition } from "../defs/index.js";
+import { PolicyScopeMatcher } from "../defs/index.js";
+import { comparePolicySemver } from "../defs/policy-semver.js";
+import { Result } from "../../result/result.js";
 
 /**
  * Selects the best policy definition from a list of already-filtered candidates.

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

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

package/src/core/policies/service/policy-evaluation-error.ts

@@ -1,4 +1,4 @@
-import type { PolicyKind } from "../catalog";
+import type { PolicyKind } from "../catalog/index.js";
 
 // ─── Error Union ─────────────────────────────────────────────────────────────