@cullet/erp-core 1.4.0 → 1.5.0

package/dist/condition-evaluator.js.map

@@ -1 +1 @@
-{"version":3,"file":"condition-evaluator.js","names":["#initialReporter","#currentReporter","#bridgeToConditionReporter"],"sources":["../src/core/config/silent-policy-reporter.ts","../src/core/config/core-config.ts","../src/core/config/core-config.instance.ts","../src/core/policies/context/path.ts","../src/core/policies/utils/date.ts","../src/core/policies/engines/v1/condition-evaluator.ts"],"sourcesContent":["import type { PolicyReporter } from \"./policy-reporter.js\";\n\nexport class SilentPolicyReporter implements PolicyReporter {\n    report(_event: Parameters<PolicyReporter[\"report\"]>[0]): void {}\n}\n","import type {\n    ConditionEvaluationOptions,\n    ConditionEvaluatorReporter,\n} from \"../policies/engines/condition-evaluator-reporter.js\";\nimport type { PolicyEvent, PolicyReporter } from \"./policy-reporter.js\";\nimport { SilentPolicyReporter } from \"./silent-policy-reporter.js\";\n\nexport interface CoreObservabilityConfig {\n    readonly reporter?: PolicyReporter;\n}\n\nexport interface CoreConfigOptions {\n    readonly observability?: CoreObservabilityConfig;\n}\n\nfunction reportSafely(\n    policyReporter: PolicyReporter,\n    event: PolicyEvent,\n): void {\n    try {\n        policyReporter.report(event);\n    } catch {\n        // Falhas de telemetria nao podem interromper o fluxo de dominio.\n    }\n}\n\n/**\n * Centraliza a configuracao pura do core sem depender de implementacoes\n * concretas de logging, tracing ou report.\n */\nexport class CoreConfig {\n    readonly #initialReporter: PolicyReporter;\n    #currentReporter: PolicyReporter;\n\n    constructor(options: CoreConfigOptions = {}) {\n        const reporter =\n            options.observability?.reporter ?? new SilentPolicyReporter();\n        this.#initialReporter = reporter;\n        this.#currentReporter = reporter;\n    }\n\n    configure(options: CoreConfigOptions): this {\n        const reporter = options.observability?.reporter;\n        if (reporter) {\n            this.#currentReporter = reporter;\n        }\n        return this;\n    }\n\n    // Restores the reporter captured at construction time.\n    reset(): this {\n        this.#currentReporter = this.#initialReporter;\n        return this;\n    }\n\n    getPolicyReporter(): PolicyReporter {\n        return this.#currentReporter;\n    }\n\n    getConditionEvaluationOptions(\n        engineVersion: number,\n    ): ConditionEvaluationOptions {\n        return {\n            reporter: this.#bridgeToConditionReporter(this.#currentReporter),\n            engineVersion,\n        };\n    }\n\n    #bridgeToConditionReporter(\n        policyReporter: PolicyReporter,\n    ): ConditionEvaluatorReporter {\n        return {\n            warn(report) {\n                reportSafely(policyReporter, {\n                    kind: \"condition-eval\",\n                    ...report,\n                } satisfies PolicyEvent);\n            },\n            error(report) {\n                reportSafely(policyReporter, {\n                    kind: \"condition-eval\",\n                    ...report,\n                } satisfies PolicyEvent);\n            },\n        };\n    }\n}\n","import { CoreConfig } from \"./core-config.js\";\nimport { SilentPolicyReporter } from \"./silent-policy-reporter.js\";\n\n/**\n * Shared instance for the application composition root.\n * Use `new CoreConfig()` for isolated runtimes, tests, or multi-tenant hosts.\n *\n * The default reporter is silent so the core has no runtime logging dependency.\n * Hosts can swap in their own `PolicyReporter` via\n * `coreConfig.configure({ observability: { reporter } })`.\n */\nexport const coreConfig = new CoreConfig({\n    observability: { reporter: new SilentPolicyReporter() },\n});\n","/**\n * Utilities for reading/writing values at dot-separated paths\n * in plain objects, e.g. \"installment.dueDate\".\n */\n\nimport { Result } from \"../../result/result.js\";\n\nexport class PolicyContextPath {\n    private static readonly FORBIDDEN_SEGMENTS = new Set([\n        \"__proto__\",\n        \"prototype\",\n        \"constructor\",\n    ]);\n\n    private static resolve(\n        obj: Record<string, unknown>,\n        path: string,\n    ): Result<\n        {\n            readonly found: boolean;\n            readonly value: unknown;\n        },\n        string\n    > {\n        const segmentsResult = PolicyContextPath.parseSegments(path);\n        if (segmentsResult.isErr()) {\n            return Result.err(segmentsResult.errorOrNull()!);\n        }\n\n        const segments = segmentsResult.getOrNull()!;\n        let current: unknown = obj;\n\n        for (const segment of segments) {\n            if (\n                current === null ||\n                current === undefined ||\n                typeof current !== \"object\"\n            ) {\n                return Result.ok({ found: false, value: undefined });\n            }\n\n            const record = current as Record<string, unknown>;\n            if (!Object.prototype.hasOwnProperty.call(record, segment)) {\n                return Result.ok({ found: false, value: undefined });\n            }\n\n            current = record[segment];\n        }\n\n        return Result.ok({ found: true, value: current });\n    }\n\n    private static parseSegments(\n        path: string,\n    ): Result<readonly string[], string> {\n        if (path.trim().length === 0) {\n            return Result.err(\"Path cannot be empty\");\n        }\n\n        const segments = path.split(\".\");\n        if (segments.some((segment) => segment.length === 0)) {\n            return Result.err(`Path \"${path}\" contains an empty segment`);\n        }\n\n        const forbiddenSegment = segments.find((segment) =>\n            PolicyContextPath.FORBIDDEN_SEGMENTS.has(segment),\n        );\n        if (forbiddenSegment !== undefined) {\n            return Result.err(\n                `Path \"${path}\" contains forbidden segment \"${forbiddenSegment}\"`,\n            );\n        }\n\n        return Result.ok(segments);\n    }\n\n    private static isPlainRecord(\n        value: unknown,\n    ): value is Record<string, unknown> {\n        if (\n            typeof value !== \"object\" ||\n            value === null ||\n            Array.isArray(value)\n        ) {\n            return false;\n        }\n\n        const prototype = Object.getPrototypeOf(value);\n        return prototype === Object.prototype || prototype === null;\n    }\n\n    static getOrAbsent(\n        obj: Record<string, unknown>,\n        path: string,\n    ): Result<unknown, \"absent\"> {\n        const resolvedPath = PolicyContextPath.resolve(obj, path);\n        if (resolvedPath.isErr()) {\n            return Result.err(\"absent\");\n        }\n\n        const { found, value } = resolvedPath.getOrNull()!;\n        if (!found) {\n            return Result.err(\"absent\");\n        }\n\n        return Result.ok(value);\n    }\n\n    static has(obj: Record<string, unknown>, path: string): boolean {\n        const resolvedPath = PolicyContextPath.resolve(obj, path);\n        if (resolvedPath.isErr()) {\n            return false;\n        }\n\n        return resolvedPath.getOrNull()!.found;\n    }\n\n    static set(\n        obj: Record<string, unknown>,\n        path: string,\n        value: unknown,\n    ): Result<void, string> {\n        const segmentsResult = PolicyContextPath.parseSegments(path);\n        if (segmentsResult.isErr()) {\n            return Result.err(segmentsResult.errorOrNull()!);\n        }\n\n        const segments = segmentsResult.getOrNull()!;\n        let current: Record<string, unknown> = obj;\n\n        for (let i = 0; i < segments.length - 1; i++) {\n            const seg = segments[i];\n            const next = current[seg];\n\n            if (next === undefined) {\n                const container = Object.create(null) as Record<\n                    string,\n                    unknown\n                >;\n                current[seg] = container;\n                current = container;\n                continue;\n            }\n\n            if (!PolicyContextPath.isPlainRecord(next)) {\n                return Result.err(\n                    `Cannot create nested path \"${path}\" because \"${segments\n                        .slice(0, i + 1)\n                        .join(\".\")}\" already contains a non-plain object`,\n                );\n            }\n\n            current = next;\n        }\n\n        current[segments[segments.length - 1]] = value;\n        return Result.ok(undefined);\n    }\n}\n","import { isValidDate } from \"../../shared/temporal-guards.js\";\n\nexport class PolicyDateUtils {\n    static isValid(value: Date): boolean {\n        return isValidDate(value);\n    }\n}\n","import { PolicyContextPath } from \"../../context/index.js\";\nimport { PolicyDateUtils } from \"../../utils/index.js\";\nimport { Result } from \"../../../result/result.js\";\n\nimport type {\n    ConditionAndNode,\n    ConditionLeafNode,\n    ConditionNode,\n    ConditionNotNode,\n    ConditionOp,\n    ConditionOrNode,\n} from \"./condition-types.js\";\nimport type {\n    ConditionEvaluationOptions,\n    ConditionEvaluationReport,\n} from \"../condition-evaluator-reporter.js\";\nimport type { PolicyContext } from \"../gate-types.js\";\n\nconst CONDITION_EVAL_THROWN_TAG = \"CONDITION_EVAL_THREW\";\nconst NULLISH_NUMERIC_OPERAND_NOT_ALLOWED_TAG =\n    \"NULLISH_NUMERIC_OPERAND_NOT_ALLOWED\";\nconst NULLISH_DATE_OPERAND_NOT_ALLOWED_TAG = \"NULLISH_DATE_OPERAND_NOT_ALLOWED\";\nconst INVALID_DATE_OPERAND_TAG = \"INVALID_DATE_OPERAND\";\nconst INVALID_NUMERIC_OPERAND_TAG = \"INVALID_NUMERIC_OPERAND\";\nconst INVALID_SET_OPERAND_TAG = \"INVALID_SET_OPERAND\";\nconst EMPTY_OR_CONDITION_TAG = \"EMPTY_OR_CONDITION\";\nconst EMPTY_AND_CONDITION_TAG = \"EMPTY_AND_CONDITION\";\nconst ISO_8601_UTC_DATE_PATTERN =\n    /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$/;\n\nexport interface ConditionEvaluationTrace {\n    readonly conditionPath: string;\n    readonly decisiveNode: ConditionNode;\n    readonly lastEvaluatedLeaf: ConditionLeafNode;\n    readonly lastEvaluatedLeafPath: string;\n    readonly lastEvaluatedLeafResult: boolean;\n}\n\nexport interface TracedConditionEvaluation {\n    readonly matched: boolean;\n    readonly trace: ConditionEvaluationTrace;\n}\n\ntype RelationalOperator = Extract<ConditionOp, \"gt\" | \"gte\" | \"lt\" | \"lte\">;\n\nexport class ConditionEvaluatorV1 {\n    constructor(\n        private readonly context: PolicyContext,\n        private readonly options: ConditionEvaluationOptions,\n    ) {}\n\n    private static isLeafNode(node: ConditionNode): node is ConditionLeafNode {\n        return \"field\" in node && \"op\" in node;\n    }\n\n    private static isAndNode(node: ConditionNode): node is ConditionAndNode {\n        return \"and\" in node;\n    }\n\n    private static isOrNode(node: ConditionNode): node is ConditionOrNode {\n        return \"or\" in node;\n    }\n\n    private static isNotNode(node: ConditionNode): node is ConditionNotNode {\n        return \"not\" in node;\n    }\n\n    private static isRelationalOperator(\n        op: ConditionOp,\n    ): op is RelationalOperator {\n        return op === \"gt\" || op === \"gte\" || op === \"lt\" || op === \"lte\";\n    }\n\n    private static describeError(error: unknown): {\n        name: string;\n        message: string;\n    } {\n        if (error instanceof Error) {\n            return {\n                name: error.name,\n                message: error.message,\n            };\n        }\n\n        return {\n            name: \"NonErrorThrown\",\n            message: String(error),\n        };\n    }\n\n    private static buildNullishNumericOperandMessage(\n        node: ConditionLeafNode,\n        actual: null | undefined,\n    ): string {\n        const resolvedValue = actual === null ? \"null\" : \"undefined\";\n\n        return `${NULLISH_NUMERIC_OPERAND_NOT_ALLOWED_TAG}: \"${node.field}\" resolved to ${resolvedValue} for numeric operator \"${node.op}\"`;\n    }\n\n    private static buildNullishDateOperandMessage(\n        node: ConditionLeafNode,\n        actual: null | undefined,\n    ): string {\n        const resolvedValue = actual === null ? \"null\" : \"undefined\";\n\n        return `${NULLISH_DATE_OPERAND_NOT_ALLOWED_TAG}: \"${node.field}\" resolved to ${resolvedValue} for date comparison operator \"${node.op}\"`;\n    }\n\n    private static buildInvalidDateOperandMessage(\n        node: ConditionLeafNode,\n    ): string {\n        return `${INVALID_DATE_OPERAND_TAG}: \"${node.field}\" with operator \"${node.op}\" requires Date or ISO 8601 UTC string operands`;\n    }\n\n    private static buildInvalidNumericOperandMessage(\n        node: ConditionLeafNode,\n    ): string {\n        return `${INVALID_NUMERIC_OPERAND_TAG}: \"${node.field}\" with operator \"${node.op}\" requires numeric operands`;\n    }\n\n    private static buildInvalidSetOperandMessage(\n        node: ConditionLeafNode,\n    ): string {\n        return `${INVALID_SET_OPERAND_TAG}: \"${node.field}\" with operator \"${node.op}\" requires an array operand`;\n    }\n\n    private static buildEmptyOrConditionMessage(): string {\n        return `${EMPTY_OR_CONDITION_TAG}: OR nodes must contain at least one child condition`;\n    }\n\n    private static buildEmptyAndConditionMessage(): string {\n        return `${EMPTY_AND_CONDITION_TAG}: AND nodes must contain at least one child condition`;\n    }\n\n    private static parseComparableDate(\n        value: unknown,\n    ): Result<Date, string> | null {\n        if (value instanceof Date) {\n            if (!PolicyDateUtils.isValid(value)) {\n                return Result.err(\"Invalid Date instance\");\n            }\n\n            return Result.ok(value);\n        }\n\n        if (\n            typeof value !== \"string\" ||\n            !ISO_8601_UTC_DATE_PATTERN.test(value)\n        ) {\n            return null;\n        }\n\n        const parsed = new Date(value);\n        if (\n            !PolicyDateUtils.isValid(parsed) ||\n            parsed.toISOString() !== value\n        ) {\n            return Result.err(\"Invalid ISO 8601 UTC date string\");\n        }\n\n        return Result.ok(parsed);\n    }\n\n    private static evaluateRelationalNumbers(\n        actual: number,\n        op: RelationalOperator,\n        expected: number,\n    ): boolean {\n        switch (op) {\n            case \"gt\":\n                return actual > expected;\n            case \"gte\":\n                return actual >= expected;\n            case \"lt\":\n                return actual < expected;\n            case \"lte\":\n                return actual <= expected;\n        }\n    }\n\n    private buildReport(params: {\n        readonly level: ConditionEvaluationReport[\"level\"];\n        readonly tag: ConditionEvaluationReport[\"tag\"];\n        readonly message: string;\n        readonly details: Readonly<Record<string, unknown>>;\n    }): ConditionEvaluationReport {\n        return {\n            occurredAt: new Date(),\n            level: params.level,\n            tag: params.tag,\n            message: params.message,\n            engineVersion: this.options.engineVersion,\n            details: params.details,\n        };\n    }\n\n    private conditionEvalErr<TValue>(\n        node: ConditionNode,\n        error: unknown,\n    ): Result<TValue, string> {\n        const cause = ConditionEvaluatorV1.describeError(error);\n        const message = `${CONDITION_EVAL_THROWN_TAG}: ${cause.name}: ${cause.message}`;\n\n        this.options.reporter.error(\n            this.buildReport({\n                level: \"error\",\n                tag: CONDITION_EVAL_THROWN_TAG,\n                message,\n                details: { node, cause },\n            }),\n        );\n\n        return Result.err(message);\n    }\n\n    private reportDateOperandError(\n        node: ConditionLeafNode,\n        actual: unknown,\n    ): Result<boolean, string> {\n        const message =\n            ConditionEvaluatorV1.buildInvalidDateOperandMessage(node);\n\n        this.options.reporter.error(\n            this.buildReport({\n                level: \"error\",\n                tag: INVALID_DATE_OPERAND_TAG,\n                message,\n                details: {\n                    field: node.field,\n                    op: node.op,\n                    actual,\n                    expected: node.value,\n                    node,\n                },\n            }),\n        );\n\n        return Result.err(message);\n    }\n\n    private reportInvalidNumericOperand(\n        node: ConditionLeafNode,\n        actual: unknown,\n    ): Result<boolean, string> {\n        const message =\n            ConditionEvaluatorV1.buildInvalidNumericOperandMessage(node);\n\n        this.options.reporter.error(\n            this.buildReport({\n                level: \"error\",\n                tag: INVALID_NUMERIC_OPERAND_TAG,\n                message,\n                details: {\n                    field: node.field,\n                    op: node.op,\n                    actual,\n                    expected: node.value,\n                    node,\n                },\n            }),\n        );\n\n        return Result.err(message);\n    }\n\n    private reportInvalidSetOperand(\n        node: ConditionLeafNode,\n        actual: unknown,\n    ): Result<boolean, string> {\n        const message =\n            ConditionEvaluatorV1.buildInvalidSetOperandMessage(node);\n\n        this.options.reporter.error(\n            this.buildReport({\n                level: \"error\",\n                tag: INVALID_SET_OPERAND_TAG,\n                message,\n                details: {\n                    field: node.field,\n                    op: node.op,\n                    actual,\n                    expected: node.value,\n                    node,\n                },\n            }),\n        );\n\n        return Result.err(message);\n    }\n\n    private evaluateDateRelationalNode(\n        node: ConditionLeafNode,\n        actual: unknown,\n    ): Result<boolean, string> | null {\n        if (!ConditionEvaluatorV1.isRelationalOperator(node.op)) {\n            return null;\n        }\n\n        const actualDateResult =\n            ConditionEvaluatorV1.parseComparableDate(actual);\n        const expectedDateResult = ConditionEvaluatorV1.parseComparableDate(\n            node.value,\n        );\n\n        if (actualDateResult === null && expectedDateResult === null) {\n            return null;\n        }\n\n        const allowsNull = node.allowNull === true;\n\n        if (actual === null) {\n            if (allowsNull) {\n                return Result.ok(false);\n            }\n\n            const message = ConditionEvaluatorV1.buildNullishDateOperandMessage(\n                node,\n                actual,\n            );\n            this.options.reporter.error(\n                this.buildReport({\n                    level: \"error\",\n                    tag: NULLISH_DATE_OPERAND_NOT_ALLOWED_TAG,\n                    message,\n                    details: {\n                        field: node.field,\n                        op: node.op,\n                        actual,\n                        expected: node.value,\n                        allowNull: allowsNull,\n                        node,\n                    },\n                }),\n            );\n\n            return Result.err(message);\n        }\n\n        if (actual === undefined) {\n            const message = ConditionEvaluatorV1.buildNullishDateOperandMessage(\n                node,\n                actual,\n            );\n            this.options.reporter.error(\n                this.buildReport({\n                    level: \"error\",\n                    tag: NULLISH_DATE_OPERAND_NOT_ALLOWED_TAG,\n                    message,\n                    details: {\n                        field: node.field,\n                        op: node.op,\n                        actual,\n                        expected: node.value,\n                        allowNull: allowsNull,\n                        node,\n                    },\n                }),\n            );\n\n            return Result.err(message);\n        }\n\n        if (\n            actualDateResult === null ||\n            actualDateResult.isErr() ||\n            expectedDateResult === null ||\n            expectedDateResult.isErr()\n        ) {\n            return this.reportDateOperandError(node, actual);\n        }\n\n        return Result.ok(\n            ConditionEvaluatorV1.evaluateRelationalNumbers(\n                actualDateResult.getOrNull()!.getTime(),\n                node.op,\n                expectedDateResult.getOrNull()!.getTime(),\n            ),\n        );\n    }\n\n    private evaluateOperator(\n        actual: unknown,\n        op: ConditionOp,\n        expected: unknown,\n    ): boolean {\n        switch (op) {\n            case \"eq\":\n                return actual === expected;\n            case \"neq\":\n                return actual !== expected;\n            case \"gt\":\n                return (\n                    typeof actual === \"number\" &&\n                    typeof expected === \"number\" &&\n                    ConditionEvaluatorV1.evaluateRelationalNumbers(\n                        actual,\n                        op,\n                        expected,\n                    )\n                );\n            case \"gte\":\n                return (\n                    typeof actual === \"number\" &&\n                    typeof expected === \"number\" &&\n                    ConditionEvaluatorV1.evaluateRelationalNumbers(\n                        actual,\n                        op,\n                        expected,\n                    )\n                );\n            case \"lt\":\n                return (\n                    typeof actual === \"number\" &&\n                    typeof expected === \"number\" &&\n                    ConditionEvaluatorV1.evaluateRelationalNumbers(\n                        actual,\n                        op,\n                        expected,\n                    )\n                );\n            case \"lte\":\n                return (\n                    typeof actual === \"number\" &&\n                    typeof expected === \"number\" &&\n                    ConditionEvaluatorV1.evaluateRelationalNumbers(\n                        actual,\n                        op,\n                        expected,\n                    )\n                );\n            case \"in\":\n                return Array.isArray(expected) && expected.includes(actual);\n            case \"notIn\":\n                return Array.isArray(expected) && !expected.includes(actual);\n            case \"isNull\":\n                return actual === null;\n            case \"isNotNull\":\n                return actual !== null && actual !== undefined;\n        }\n    }\n\n    private evaluateNumericRelationalNode(\n        node: ConditionLeafNode,\n        actual: unknown,\n    ): Result<boolean, string> {\n        const allowsNull = node.allowNull === true;\n        if (actual === undefined || (actual === null && !allowsNull)) {\n            const message =\n                ConditionEvaluatorV1.buildNullishNumericOperandMessage(\n                    node,\n                    actual as null | undefined,\n                );\n\n            this.options.reporter.error(\n                this.buildReport({\n                    level: \"error\",\n                    tag: NULLISH_NUMERIC_OPERAND_NOT_ALLOWED_TAG,\n                    message,\n                    details: {\n                        field: node.field,\n                        op: node.op,\n                        actual,\n                        expected: node.value,\n                        allowNull: allowsNull,\n                        node,\n                    },\n                }),\n            );\n\n            return Result.err(message);\n        }\n\n        // null + allowNull: a relational comparison against a missing value\n        // never matches.\n        if (actual === null) {\n            return Result.ok(false);\n        }\n\n        // Both operands must be numbers. A present but wrong-typed operand is a\n        // context/configuration error, surfaced like the date path instead of\n        // silently collapsing to \"no match\".\n        if (typeof actual !== \"number\" || typeof node.value !== \"number\") {\n            return this.reportInvalidNumericOperand(node, actual);\n        }\n\n        return Result.ok(this.evaluateOperator(actual, node.op, node.value));\n    }\n\n    private evaluateLeafNode(node: ConditionLeafNode): Result<boolean, string> {\n        const actualResult = PolicyContextPath.getOrAbsent(\n            this.context,\n            node.field,\n        );\n        if (actualResult.isErr()) {\n            this.options.reporter.warn(\n                this.buildReport({\n                    level: \"warn\",\n                    tag: \"MISSING_CONTEXT_FIELD\",\n                    message: `MISSING_CONTEXT_FIELD: \"${node.field}\" not found in context`,\n                    details: { field: node.field, node },\n                }),\n            );\n\n            return Result.err(\n                `MISSING_CONTEXT_FIELD: \"${node.field}\" not found in context`,\n            );\n        }\n\n        try {\n            const actual = actualResult.getOrThrow();\n            if (ConditionEvaluatorV1.isRelationalOperator(node.op)) {\n                const dateResult = this.evaluateDateRelationalNode(\n                    node,\n                    actual,\n                );\n                if (dateResult !== null) {\n                    return dateResult;\n                }\n\n                return this.evaluateNumericRelationalNode(node, actual);\n            }\n\n            if (\n                (node.op === \"in\" || node.op === \"notIn\") &&\n                !Array.isArray(node.value)\n            ) {\n                return this.reportInvalidSetOperand(node, actual);\n            }\n\n            return Result.ok(\n                this.evaluateOperator(actual, node.op, node.value),\n            );\n        } catch (error) {\n            return this.conditionEvalErr(node, error);\n        }\n    }\n\n    private buildTrace(params: {\n        readonly conditionPath: string;\n        readonly decisiveNode: ConditionNode;\n        readonly lastEvaluatedLeaf: ConditionLeafNode;\n        readonly lastEvaluatedLeafPath: string;\n        readonly lastEvaluatedLeafResult: boolean;\n    }): ConditionEvaluationTrace {\n        return {\n            conditionPath: params.conditionPath,\n            decisiveNode: params.decisiveNode,\n            lastEvaluatedLeaf: params.lastEvaluatedLeaf,\n            lastEvaluatedLeafPath: params.lastEvaluatedLeafPath,\n            lastEvaluatedLeafResult: params.lastEvaluatedLeafResult,\n        };\n    }\n\n    private evaluateWithTraceInternal(\n        node: ConditionNode,\n        path: string,\n    ): Result<TracedConditionEvaluation, string> {\n        if (ConditionEvaluatorV1.isLeafNode(node)) {\n            const leafResult = this.evaluateLeafNode(node);\n            if (leafResult.isErr()) {\n                return Result.err(leafResult.errorOrNull()!);\n            }\n\n            const matched = leafResult.getOrNull()!;\n            return Result.ok({\n                matched,\n                trace: this.buildTrace({\n                    conditionPath: path,\n                    decisiveNode: node,\n                    lastEvaluatedLeaf: node,\n                    lastEvaluatedLeafPath: path,\n                    lastEvaluatedLeafResult: matched,\n                }),\n            });\n        }\n\n        if (ConditionEvaluatorV1.isAndNode(node)) {\n            if (node.and.length === 0) {\n                return Result.err(\n                    ConditionEvaluatorV1.buildEmptyAndConditionMessage(),\n                );\n            }\n\n            let lastTracedChild: TracedConditionEvaluation | null = null;\n\n            for (const [index, child] of node.and.entries()) {\n                const childPath = `${path}.and[${index}]`;\n                const childResult = this.evaluateWithTraceInternal(\n                    child,\n                    childPath,\n                );\n                if (childResult.isErr()) {\n                    return Result.err(childResult.errorOrNull()!);\n                }\n\n                const tracedChild = childResult.getOrNull()!;\n                lastTracedChild = tracedChild;\n                if (!tracedChild.matched) {\n                    return Result.ok({\n                        matched: false,\n                        trace: this.buildTrace({\n                            conditionPath: childPath,\n                            decisiveNode: child,\n                            lastEvaluatedLeaf:\n                                tracedChild.trace.lastEvaluatedLeaf,\n                            lastEvaluatedLeafPath:\n                                tracedChild.trace.lastEvaluatedLeafPath,\n                            lastEvaluatedLeafResult:\n                                tracedChild.trace.lastEvaluatedLeafResult,\n                        }),\n                    });\n                }\n            }\n\n            return Result.ok({\n                matched: true,\n                trace: lastTracedChild!.trace,\n            });\n        }\n\n        if (ConditionEvaluatorV1.isOrNode(node)) {\n            let lastTrace: ConditionEvaluationTrace | null = null;\n\n            for (const [index, child] of node.or.entries()) {\n                const childResult = this.evaluateWithTraceInternal(\n                    child,\n                    `${path}.or[${index}]`,\n                );\n                if (childResult.isErr()) {\n                    return Result.err(childResult.errorOrNull()!);\n                }\n\n                const tracedChild = childResult.getOrNull()!;\n                lastTrace = tracedChild.trace;\n                if (tracedChild.matched) {\n                    return Result.ok({\n                        matched: true,\n                        trace: tracedChild.trace,\n                    });\n                }\n            }\n\n            if (lastTrace === null) {\n                return Result.err(\n                    ConditionEvaluatorV1.buildEmptyOrConditionMessage(),\n                );\n            }\n\n            return Result.ok({ matched: false, trace: lastTrace! });\n        }\n\n        if (ConditionEvaluatorV1.isNotNode(node)) {\n            const childPath = `${path}.not`;\n            const childResult = this.evaluateWithTraceInternal(\n                node.not,\n                childPath,\n            );\n            if (childResult.isErr()) {\n                return Result.err(childResult.errorOrNull()!);\n            }\n\n            const tracedChild = childResult.getOrNull()!;\n            return Result.ok({\n                matched: !tracedChild.matched,\n                trace: this.buildTrace({\n                    conditionPath: path,\n                    decisiveNode: node,\n                    lastEvaluatedLeaf: tracedChild.trace.lastEvaluatedLeaf,\n                    lastEvaluatedLeafPath:\n                        tracedChild.trace.lastEvaluatedLeafPath,\n                    lastEvaluatedLeafResult:\n                        tracedChild.trace.lastEvaluatedLeafResult,\n                }),\n            });\n        }\n\n        return this.conditionEvalErr(\n            node,\n            new TypeError(\"Invalid condition node shape\"),\n        );\n    }\n\n    evaluate(node: ConditionNode): Result<boolean, string> {\n        try {\n            const result = this.evaluateWithTraceInternal(node, \"$\");\n            if (result.isErr()) {\n                return Result.err(result.errorOrNull()!);\n            }\n\n            return Result.ok(result.getOrNull()!.matched);\n        } catch (error) {\n            return this.conditionEvalErr(node, error);\n        }\n    }\n\n    evaluateWithTrace(\n        node: ConditionNode,\n    ): Result<TracedConditionEvaluation, string> {\n        try {\n            return this.evaluateWithTraceInternal(node, \"$\");\n        } catch (error) {\n            return this.conditionEvalErr(node, error);\n        }\n    }\n\n    static extractFields(node: ConditionNode): string[] {\n        if (ConditionEvaluatorV1.isLeafNode(node)) {\n            return [node.field];\n        }\n\n        if (ConditionEvaluatorV1.isAndNode(node)) {\n            return node.and.flatMap((child) =>\n                ConditionEvaluatorV1.extractFields(child),\n            );\n        }\n\n        if (ConditionEvaluatorV1.isOrNode(node)) {\n            return node.or.flatMap((child) =>\n                ConditionEvaluatorV1.extractFields(child),\n            );\n        }\n\n        if (ConditionEvaluatorV1.isNotNode(node)) {\n            return ConditionEvaluatorV1.extractFields(node.not);\n        }\n\n        return [];\n    }\n}\n"],"mappings":"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"}
+{"version":3,"file":"condition-evaluator.js","names":["#initialReporter","#currentReporter","#bridgeToConditionReporter"],"sources":["../src/core/config/silent-policy-reporter.ts","../src/core/config/core-config.ts","../src/core/config/core-config.instance.ts","../src/core/policies/context/path.ts","../src/core/policies/utils/date.ts","../src/core/policies/engines/v1/condition-evaluator.ts"],"sourcesContent":["import type { PolicyReporter } from \"./policy-reporter.js\";\n\nexport class SilentPolicyReporter implements PolicyReporter {\n    report(_event: Parameters<PolicyReporter[\"report\"]>[0]): void {}\n}\n","import type {\n    ConditionEvaluationOptions,\n    ConditionEvaluatorReporter,\n} from \"../policies/engines/condition-evaluator-reporter.js\";\nimport type { PolicyEvent, PolicyReporter } from \"./policy-reporter.js\";\nimport { SilentPolicyReporter } from \"./silent-policy-reporter.js\";\n\nexport interface CoreObservabilityConfig {\n    readonly reporter?: PolicyReporter;\n}\n\nexport interface CoreConfigOptions {\n    readonly observability?: CoreObservabilityConfig;\n}\n\nfunction reportSafely(\n    policyReporter: PolicyReporter,\n    event: PolicyEvent,\n): void {\n    try {\n        policyReporter.report(event);\n    } catch {\n        // Falhas de telemetria nao podem interromper o fluxo de dominio.\n    }\n}\n\n/**\n * Centraliza a configuracao pura do core sem depender de implementacoes\n * concretas de logging, tracing ou report.\n */\nexport class CoreConfig {\n    readonly #initialReporter: PolicyReporter;\n    #currentReporter: PolicyReporter;\n\n    constructor(options: CoreConfigOptions = {}) {\n        const reporter =\n            options.observability?.reporter ?? new SilentPolicyReporter();\n        this.#initialReporter = reporter;\n        this.#currentReporter = reporter;\n    }\n\n    configure(options: CoreConfigOptions): this {\n        const reporter = options.observability?.reporter;\n        if (reporter) {\n            this.#currentReporter = reporter;\n        }\n        return this;\n    }\n\n    // Restores the reporter captured at construction time.\n    reset(): this {\n        this.#currentReporter = this.#initialReporter;\n        return this;\n    }\n\n    getPolicyReporter(): PolicyReporter {\n        return this.#currentReporter;\n    }\n\n    getConditionEvaluationOptions(\n        engineVersion: number,\n    ): ConditionEvaluationOptions {\n        return {\n            reporter: this.#bridgeToConditionReporter(this.#currentReporter),\n            engineVersion,\n        };\n    }\n\n    #bridgeToConditionReporter(\n        policyReporter: PolicyReporter,\n    ): ConditionEvaluatorReporter {\n        return {\n            warn(report) {\n                reportSafely(policyReporter, {\n                    kind: \"condition-eval\",\n                    ...report,\n                } satisfies PolicyEvent);\n            },\n            error(report) {\n                reportSafely(policyReporter, {\n                    kind: \"condition-eval\",\n                    ...report,\n                } satisfies PolicyEvent);\n            },\n        };\n    }\n}\n","import { CoreConfig } from \"./core-config.js\";\nimport { SilentPolicyReporter } from \"./silent-policy-reporter.js\";\n\n/**\n * Shared instance for the application composition root.\n * Use `new CoreConfig()` for isolated runtimes, tests, or multi-tenant hosts.\n *\n * The default reporter is silent so the core has no runtime logging dependency.\n * Hosts can swap in their own `PolicyReporter` via\n * `coreConfig.configure({ observability: { reporter } })`.\n */\nexport const coreConfig = new CoreConfig({\n    observability: { reporter: new SilentPolicyReporter() },\n});\n","/**\n * Utilities for reading/writing values at dot-separated paths\n * in plain objects, e.g. \"installment.dueDate\".\n */\n\nimport { Result } from \"../../result/result.js\";\n\nexport class PolicyContextPath {\n    private static readonly FORBIDDEN_SEGMENTS = new Set([\n        \"__proto__\",\n        \"prototype\",\n        \"constructor\",\n    ]);\n\n    private static resolve(\n        obj: Record<string, unknown>,\n        path: string,\n    ): Result<\n        {\n            readonly found: boolean;\n            readonly value: unknown;\n        },\n        string\n    > {\n        const segmentsResult = PolicyContextPath.parseSegments(path);\n        if (segmentsResult.isErr()) {\n            return Result.err(segmentsResult.errorOrNull()!);\n        }\n\n        const segments = segmentsResult.getOrNull()!;\n        let current: unknown = obj;\n\n        for (const segment of segments) {\n            if (\n                current === null ||\n                current === undefined ||\n                typeof current !== \"object\"\n            ) {\n                return Result.ok({ found: false, value: undefined });\n            }\n\n            const record = current as Record<string, unknown>;\n            if (!Object.prototype.hasOwnProperty.call(record, segment)) {\n                return Result.ok({ found: false, value: undefined });\n            }\n\n            current = record[segment];\n        }\n\n        return Result.ok({ found: true, value: current });\n    }\n\n    private static parseSegments(\n        path: string,\n    ): Result<readonly string[], string> {\n        if (path.trim().length === 0) {\n            return Result.err(\"Path cannot be empty\");\n        }\n\n        const segments = path.split(\".\");\n        if (segments.some((segment) => segment.length === 0)) {\n            return Result.err(`Path \"${path}\" contains an empty segment`);\n        }\n\n        const forbiddenSegment = segments.find((segment) =>\n            PolicyContextPath.FORBIDDEN_SEGMENTS.has(segment),\n        );\n        if (forbiddenSegment !== undefined) {\n            return Result.err(\n                `Path \"${path}\" contains forbidden segment \"${forbiddenSegment}\"`,\n            );\n        }\n\n        return Result.ok(segments);\n    }\n\n    private static isPlainRecord(\n        value: unknown,\n    ): value is Record<string, unknown> {\n        if (\n            typeof value !== \"object\" ||\n            value === null ||\n            Array.isArray(value)\n        ) {\n            return false;\n        }\n\n        const prototype = Object.getPrototypeOf(value);\n        return prototype === Object.prototype || prototype === null;\n    }\n\n    static getOrAbsent(\n        obj: Record<string, unknown>,\n        path: string,\n    ): Result<unknown, \"absent\"> {\n        const resolvedPath = PolicyContextPath.resolve(obj, path);\n        if (resolvedPath.isErr()) {\n            return Result.err(\"absent\");\n        }\n\n        const { found, value } = resolvedPath.getOrNull()!;\n        if (!found) {\n            return Result.err(\"absent\");\n        }\n\n        return Result.ok(value);\n    }\n\n    static has(obj: Record<string, unknown>, path: string): boolean {\n        const resolvedPath = PolicyContextPath.resolve(obj, path);\n        if (resolvedPath.isErr()) {\n            return false;\n        }\n\n        return resolvedPath.getOrNull()!.found;\n    }\n\n    static set(\n        obj: Record<string, unknown>,\n        path: string,\n        value: unknown,\n    ): Result<void, string> {\n        const segmentsResult = PolicyContextPath.parseSegments(path);\n        if (segmentsResult.isErr()) {\n            return Result.err(segmentsResult.errorOrNull()!);\n        }\n\n        const segments = segmentsResult.getOrNull()!;\n        let current: Record<string, unknown> = obj;\n\n        for (let i = 0; i < segments.length - 1; i++) {\n            const seg = segments[i];\n            const next = current[seg];\n\n            if (next === undefined) {\n                const container = Object.create(null) as Record<\n                    string,\n                    unknown\n                >;\n                current[seg] = container;\n                current = container;\n                continue;\n            }\n\n            if (!PolicyContextPath.isPlainRecord(next)) {\n                return Result.err(\n                    `Cannot create nested path \"${path}\" because \"${segments\n                        .slice(0, i + 1)\n                        .join(\".\")}\" already contains a non-plain object`,\n                );\n            }\n\n            current = next;\n        }\n\n        current[segments[segments.length - 1]] = value;\n        return Result.ok(undefined);\n    }\n}\n","import { isValidDate } from \"../../shared/temporal-guards.js\";\n\nexport class PolicyDateUtils {\n    static isValid(value: Date): boolean {\n        return isValidDate(value);\n    }\n}\n","import { PolicyContextPath } from \"../../context/index.js\";\n// Import the date util directly (not the utils barrel): the barrel re-exports\n// PolicyHashing, whose node:crypto import would needlessly drag a Node-only\n// API into the zod-free ./abac subpath.\nimport { PolicyDateUtils } from \"../../utils/date.js\";\nimport { Result } from \"../../../result/result.js\";\n\nimport type {\n    ConditionAndNode,\n    ConditionLeafNode,\n    ConditionNode,\n    ConditionNotNode,\n    ConditionOp,\n    ConditionOrNode,\n} from \"./condition-types.js\";\nimport type {\n    ConditionEvaluationOptions,\n    ConditionEvaluationReport,\n} from \"../condition-evaluator-reporter.js\";\nimport type { PolicyContext } from \"../gate-types.js\";\n\nconst CONDITION_EVAL_THROWN_TAG = \"CONDITION_EVAL_THREW\";\nconst NULLISH_NUMERIC_OPERAND_NOT_ALLOWED_TAG =\n    \"NULLISH_NUMERIC_OPERAND_NOT_ALLOWED\";\nconst NULLISH_DATE_OPERAND_NOT_ALLOWED_TAG = \"NULLISH_DATE_OPERAND_NOT_ALLOWED\";\nconst INVALID_DATE_OPERAND_TAG = \"INVALID_DATE_OPERAND\";\nconst INVALID_NUMERIC_OPERAND_TAG = \"INVALID_NUMERIC_OPERAND\";\nconst INVALID_SET_OPERAND_TAG = \"INVALID_SET_OPERAND\";\nconst EMPTY_OR_CONDITION_TAG = \"EMPTY_OR_CONDITION\";\nconst EMPTY_AND_CONDITION_TAG = \"EMPTY_AND_CONDITION\";\nconst ISO_8601_UTC_DATE_PATTERN =\n    /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$/;\n\nexport interface ConditionEvaluationTrace {\n    readonly conditionPath: string;\n    readonly decisiveNode: ConditionNode;\n    readonly lastEvaluatedLeaf: ConditionLeafNode;\n    readonly lastEvaluatedLeafPath: string;\n    readonly lastEvaluatedLeafResult: boolean;\n}\n\nexport interface TracedConditionEvaluation {\n    readonly matched: boolean;\n    readonly trace: ConditionEvaluationTrace;\n}\n\ntype RelationalOperator = Extract<ConditionOp, \"gt\" | \"gte\" | \"lt\" | \"lte\">;\n\nexport class ConditionEvaluatorV1 {\n    constructor(\n        private readonly context: PolicyContext,\n        private readonly options: ConditionEvaluationOptions,\n    ) {}\n\n    private static isLeafNode(node: ConditionNode): node is ConditionLeafNode {\n        return \"field\" in node && \"op\" in node;\n    }\n\n    private static isAndNode(node: ConditionNode): node is ConditionAndNode {\n        return \"and\" in node;\n    }\n\n    private static isOrNode(node: ConditionNode): node is ConditionOrNode {\n        return \"or\" in node;\n    }\n\n    private static isNotNode(node: ConditionNode): node is ConditionNotNode {\n        return \"not\" in node;\n    }\n\n    private static isRelationalOperator(\n        op: ConditionOp,\n    ): op is RelationalOperator {\n        return op === \"gt\" || op === \"gte\" || op === \"lt\" || op === \"lte\";\n    }\n\n    private static describeError(error: unknown): {\n        name: string;\n        message: string;\n    } {\n        if (error instanceof Error) {\n            return {\n                name: error.name,\n                message: error.message,\n            };\n        }\n\n        return {\n            name: \"NonErrorThrown\",\n            message: String(error),\n        };\n    }\n\n    private static buildNullishNumericOperandMessage(\n        node: ConditionLeafNode,\n        actual: null | undefined,\n    ): string {\n        const resolvedValue = actual === null ? \"null\" : \"undefined\";\n\n        return `${NULLISH_NUMERIC_OPERAND_NOT_ALLOWED_TAG}: \"${node.field}\" resolved to ${resolvedValue} for numeric operator \"${node.op}\"`;\n    }\n\n    private static buildNullishDateOperandMessage(\n        node: ConditionLeafNode,\n        actual: null | undefined,\n    ): string {\n        const resolvedValue = actual === null ? \"null\" : \"undefined\";\n\n        return `${NULLISH_DATE_OPERAND_NOT_ALLOWED_TAG}: \"${node.field}\" resolved to ${resolvedValue} for date comparison operator \"${node.op}\"`;\n    }\n\n    private static buildInvalidDateOperandMessage(\n        node: ConditionLeafNode,\n    ): string {\n        return `${INVALID_DATE_OPERAND_TAG}: \"${node.field}\" with operator \"${node.op}\" requires Date or ISO 8601 UTC string operands`;\n    }\n\n    private static buildInvalidNumericOperandMessage(\n        node: ConditionLeafNode,\n    ): string {\n        return `${INVALID_NUMERIC_OPERAND_TAG}: \"${node.field}\" with operator \"${node.op}\" requires numeric operands`;\n    }\n\n    private static buildInvalidSetOperandMessage(\n        node: ConditionLeafNode,\n    ): string {\n        return `${INVALID_SET_OPERAND_TAG}: \"${node.field}\" with operator \"${node.op}\" requires an array operand`;\n    }\n\n    private static buildEmptyOrConditionMessage(): string {\n        return `${EMPTY_OR_CONDITION_TAG}: OR nodes must contain at least one child condition`;\n    }\n\n    private static buildEmptyAndConditionMessage(): string {\n        return `${EMPTY_AND_CONDITION_TAG}: AND nodes must contain at least one child condition`;\n    }\n\n    private static parseComparableDate(\n        value: unknown,\n    ): Result<Date, string> | null {\n        if (value instanceof Date) {\n            if (!PolicyDateUtils.isValid(value)) {\n                return Result.err(\"Invalid Date instance\");\n            }\n\n            return Result.ok(value);\n        }\n\n        if (\n            typeof value !== \"string\" ||\n            !ISO_8601_UTC_DATE_PATTERN.test(value)\n        ) {\n            return null;\n        }\n\n        const parsed = new Date(value);\n        if (\n            !PolicyDateUtils.isValid(parsed) ||\n            parsed.toISOString() !== value\n        ) {\n            return Result.err(\"Invalid ISO 8601 UTC date string\");\n        }\n\n        return Result.ok(parsed);\n    }\n\n    private static evaluateRelationalNumbers(\n        actual: number,\n        op: RelationalOperator,\n        expected: number,\n    ): boolean {\n        switch (op) {\n            case \"gt\":\n                return actual > expected;\n            case \"gte\":\n                return actual >= expected;\n            case \"lt\":\n                return actual < expected;\n            case \"lte\":\n                return actual <= expected;\n        }\n    }\n\n    private buildReport(params: {\n        readonly level: ConditionEvaluationReport[\"level\"];\n        readonly tag: ConditionEvaluationReport[\"tag\"];\n        readonly message: string;\n        readonly details: Readonly<Record<string, unknown>>;\n    }): ConditionEvaluationReport {\n        return {\n            occurredAt: new Date(),\n            level: params.level,\n            tag: params.tag,\n            message: params.message,\n            engineVersion: this.options.engineVersion,\n            details: params.details,\n        };\n    }\n\n    private conditionEvalErr<TValue>(\n        node: ConditionNode,\n        error: unknown,\n    ): Result<TValue, string> {\n        const cause = ConditionEvaluatorV1.describeError(error);\n        const message = `${CONDITION_EVAL_THROWN_TAG}: ${cause.name}: ${cause.message}`;\n\n        this.options.reporter.error(\n            this.buildReport({\n                level: \"error\",\n                tag: CONDITION_EVAL_THROWN_TAG,\n                message,\n                details: { node, cause },\n            }),\n        );\n\n        return Result.err(message);\n    }\n\n    private static containsInvalidDate(value: unknown): boolean {\n        if (value instanceof Date) {\n            return !PolicyDateUtils.isValid(value);\n        }\n        if (Array.isArray(value)) {\n            return value.some((item) =>\n                ConditionEvaluatorV1.containsInvalidDate(item),\n            );\n        }\n        return false;\n    }\n\n    // Valid Dates become their ISO string so equality/set operators compare\n    // instants instead of references; every other value passes through.\n    private static normalizeDateOperand(value: unknown): unknown {\n        if (value instanceof Date) {\n            return value.toISOString();\n        }\n        if (Array.isArray(value)) {\n            return value.map((item) =>\n                ConditionEvaluatorV1.normalizeDateOperand(item),\n            );\n        }\n        return value;\n    }\n\n    private reportDateOperandError(\n        node: ConditionLeafNode,\n        actual: unknown,\n    ): Result<boolean, string> {\n        const message =\n            ConditionEvaluatorV1.buildInvalidDateOperandMessage(node);\n\n        this.options.reporter.error(\n            this.buildReport({\n                level: \"error\",\n                tag: INVALID_DATE_OPERAND_TAG,\n                message,\n                details: {\n                    field: node.field,\n                    op: node.op,\n                    actual,\n                    expected: node.value,\n                    node,\n                },\n            }),\n        );\n\n        return Result.err(message);\n    }\n\n    private reportInvalidNumericOperand(\n        node: ConditionLeafNode,\n        actual: unknown,\n    ): Result<boolean, string> {\n        const message =\n            ConditionEvaluatorV1.buildInvalidNumericOperandMessage(node);\n\n        this.options.reporter.error(\n            this.buildReport({\n                level: \"error\",\n                tag: INVALID_NUMERIC_OPERAND_TAG,\n                message,\n                details: {\n                    field: node.field,\n                    op: node.op,\n                    actual,\n                    expected: node.value,\n                    node,\n                },\n            }),\n        );\n\n        return Result.err(message);\n    }\n\n    private reportInvalidSetOperand(\n        node: ConditionLeafNode,\n        actual: unknown,\n    ): Result<boolean, string> {\n        const message =\n            ConditionEvaluatorV1.buildInvalidSetOperandMessage(node);\n\n        this.options.reporter.error(\n            this.buildReport({\n                level: \"error\",\n                tag: INVALID_SET_OPERAND_TAG,\n                message,\n                details: {\n                    field: node.field,\n                    op: node.op,\n                    actual,\n                    expected: node.value,\n                    node,\n                },\n            }),\n        );\n\n        return Result.err(message);\n    }\n\n    private evaluateDateRelationalNode(\n        node: ConditionLeafNode,\n        actual: unknown,\n    ): Result<boolean, string> | null {\n        if (!ConditionEvaluatorV1.isRelationalOperator(node.op)) {\n            return null;\n        }\n\n        const actualDateResult =\n            ConditionEvaluatorV1.parseComparableDate(actual);\n        const expectedDateResult = ConditionEvaluatorV1.parseComparableDate(\n            node.value,\n        );\n\n        if (actualDateResult === null && expectedDateResult === null) {\n            return null;\n        }\n\n        const allowsNull = node.allowNull === true;\n\n        if (actual === null) {\n            if (allowsNull) {\n                return Result.ok(false);\n            }\n\n            const message = ConditionEvaluatorV1.buildNullishDateOperandMessage(\n                node,\n                actual,\n            );\n            this.options.reporter.error(\n                this.buildReport({\n                    level: \"error\",\n                    tag: NULLISH_DATE_OPERAND_NOT_ALLOWED_TAG,\n                    message,\n                    details: {\n                        field: node.field,\n                        op: node.op,\n                        actual,\n                        expected: node.value,\n                        allowNull: allowsNull,\n                        node,\n                    },\n                }),\n            );\n\n            return Result.err(message);\n        }\n\n        if (actual === undefined) {\n            const message = ConditionEvaluatorV1.buildNullishDateOperandMessage(\n                node,\n                actual,\n            );\n            this.options.reporter.error(\n                this.buildReport({\n                    level: \"error\",\n                    tag: NULLISH_DATE_OPERAND_NOT_ALLOWED_TAG,\n                    message,\n                    details: {\n                        field: node.field,\n                        op: node.op,\n                        actual,\n                        expected: node.value,\n                        allowNull: allowsNull,\n                        node,\n                    },\n                }),\n            );\n\n            return Result.err(message);\n        }\n\n        if (\n            actualDateResult === null ||\n            actualDateResult.isErr() ||\n            expectedDateResult === null ||\n            expectedDateResult.isErr()\n        ) {\n            return this.reportDateOperandError(node, actual);\n        }\n\n        return Result.ok(\n            ConditionEvaluatorV1.evaluateRelationalNumbers(\n                actualDateResult.getOrNull()!.getTime(),\n                node.op,\n                expectedDateResult.getOrNull()!.getTime(),\n            ),\n        );\n    }\n\n    private evaluateOperator(\n        actual: unknown,\n        op: ConditionOp,\n        expected: unknown,\n    ): boolean {\n        switch (op) {\n            case \"eq\":\n                return actual === expected;\n            case \"neq\":\n                return actual !== expected;\n            case \"gt\":\n                return (\n                    typeof actual === \"number\" &&\n                    typeof expected === \"number\" &&\n                    ConditionEvaluatorV1.evaluateRelationalNumbers(\n                        actual,\n                        op,\n                        expected,\n                    )\n                );\n            case \"gte\":\n                return (\n                    typeof actual === \"number\" &&\n                    typeof expected === \"number\" &&\n                    ConditionEvaluatorV1.evaluateRelationalNumbers(\n                        actual,\n                        op,\n                        expected,\n                    )\n                );\n            case \"lt\":\n                return (\n                    typeof actual === \"number\" &&\n                    typeof expected === \"number\" &&\n                    ConditionEvaluatorV1.evaluateRelationalNumbers(\n                        actual,\n                        op,\n                        expected,\n                    )\n                );\n            case \"lte\":\n                return (\n                    typeof actual === \"number\" &&\n                    typeof expected === \"number\" &&\n                    ConditionEvaluatorV1.evaluateRelationalNumbers(\n                        actual,\n                        op,\n                        expected,\n                    )\n                );\n            case \"in\":\n                return Array.isArray(expected) && expected.includes(actual);\n            case \"notIn\":\n                return Array.isArray(expected) && !expected.includes(actual);\n            case \"isNull\":\n                return actual === null;\n            case \"isNotNull\":\n                return actual !== null && actual !== undefined;\n        }\n    }\n\n    private evaluateNumericRelationalNode(\n        node: ConditionLeafNode,\n        actual: unknown,\n    ): Result<boolean, string> {\n        const allowsNull = node.allowNull === true;\n        if (actual === undefined || (actual === null && !allowsNull)) {\n            const message =\n                ConditionEvaluatorV1.buildNullishNumericOperandMessage(\n                    node,\n                    actual as null | undefined,\n                );\n\n            this.options.reporter.error(\n                this.buildReport({\n                    level: \"error\",\n                    tag: NULLISH_NUMERIC_OPERAND_NOT_ALLOWED_TAG,\n                    message,\n                    details: {\n                        field: node.field,\n                        op: node.op,\n                        actual,\n                        expected: node.value,\n                        allowNull: allowsNull,\n                        node,\n                    },\n                }),\n            );\n\n            return Result.err(message);\n        }\n\n        // null + allowNull: a relational comparison against a missing value\n        // never matches.\n        if (actual === null) {\n            return Result.ok(false);\n        }\n\n        // Both operands must be numbers. A present but wrong-typed operand is a\n        // context/configuration error, surfaced like the date path instead of\n        // silently collapsing to \"no match\".\n        if (typeof actual !== \"number\" || typeof node.value !== \"number\") {\n            return this.reportInvalidNumericOperand(node, actual);\n        }\n\n        return Result.ok(this.evaluateOperator(actual, node.op, node.value));\n    }\n\n    private evaluateLeafNode(node: ConditionLeafNode): Result<boolean, string> {\n        const actualResult = PolicyContextPath.getOrAbsent(\n            this.context,\n            node.field,\n        );\n        if (actualResult.isErr()) {\n            this.options.reporter.warn(\n                this.buildReport({\n                    level: \"warn\",\n                    tag: \"MISSING_CONTEXT_FIELD\",\n                    message: `MISSING_CONTEXT_FIELD: \"${node.field}\" not found in context`,\n                    details: { field: node.field, node },\n                }),\n            );\n\n            return Result.err(\n                `MISSING_CONTEXT_FIELD: \"${node.field}\" not found in context`,\n            );\n        }\n\n        try {\n            const actual = actualResult.getOrThrow();\n            if (ConditionEvaluatorV1.isRelationalOperator(node.op)) {\n                const dateResult = this.evaluateDateRelationalNode(\n                    node,\n                    actual,\n                );\n                if (dateResult !== null) {\n                    return dateResult;\n                }\n\n                return this.evaluateNumericRelationalNode(node, actual);\n            }\n\n            if (\n                (node.op === \"in\" || node.op === \"notIn\") &&\n                !Array.isArray(node.value)\n            ) {\n                return this.reportInvalidSetOperand(node, actual);\n            }\n\n            if (\n                node.op === \"eq\" ||\n                node.op === \"neq\" ||\n                node.op === \"in\" ||\n                node.op === \"notIn\"\n            ) {\n                // A Date operand would otherwise compare by reference and\n                // silently never match. Normalize valid Dates (either side,\n                // including set items) to their ISO string; an invalid Date is\n                // a context/configuration error, like the relational path.\n                if (\n                    ConditionEvaluatorV1.containsInvalidDate(actual) ||\n                    ConditionEvaluatorV1.containsInvalidDate(node.value)\n                ) {\n                    return this.reportDateOperandError(node, actual);\n                }\n\n                return Result.ok(\n                    this.evaluateOperator(\n                        ConditionEvaluatorV1.normalizeDateOperand(actual),\n                        node.op,\n                        ConditionEvaluatorV1.normalizeDateOperand(node.value),\n                    ),\n                );\n            }\n\n            return Result.ok(\n                this.evaluateOperator(actual, node.op, node.value),\n            );\n        } catch (error) {\n            return this.conditionEvalErr(node, error);\n        }\n    }\n\n    private buildTrace(params: {\n        readonly conditionPath: string;\n        readonly decisiveNode: ConditionNode;\n        readonly lastEvaluatedLeaf: ConditionLeafNode;\n        readonly lastEvaluatedLeafPath: string;\n        readonly lastEvaluatedLeafResult: boolean;\n    }): ConditionEvaluationTrace {\n        return {\n            conditionPath: params.conditionPath,\n            decisiveNode: params.decisiveNode,\n            lastEvaluatedLeaf: params.lastEvaluatedLeaf,\n            lastEvaluatedLeafPath: params.lastEvaluatedLeafPath,\n            lastEvaluatedLeafResult: params.lastEvaluatedLeafResult,\n        };\n    }\n\n    private evaluateWithTraceInternal(\n        node: ConditionNode,\n        path: string,\n    ): Result<TracedConditionEvaluation, string> {\n        if (ConditionEvaluatorV1.isLeafNode(node)) {\n            const leafResult = this.evaluateLeafNode(node);\n            if (leafResult.isErr()) {\n                return Result.err(leafResult.errorOrNull()!);\n            }\n\n            const matched = leafResult.getOrNull()!;\n            return Result.ok({\n                matched,\n                trace: this.buildTrace({\n                    conditionPath: path,\n                    decisiveNode: node,\n                    lastEvaluatedLeaf: node,\n                    lastEvaluatedLeafPath: path,\n                    lastEvaluatedLeafResult: matched,\n                }),\n            });\n        }\n\n        if (ConditionEvaluatorV1.isAndNode(node)) {\n            if (node.and.length === 0) {\n                return Result.err(\n                    ConditionEvaluatorV1.buildEmptyAndConditionMessage(),\n                );\n            }\n\n            let lastTracedChild: TracedConditionEvaluation | null = null;\n\n            for (const [index, child] of node.and.entries()) {\n                const childPath = `${path}.and[${index}]`;\n                const childResult = this.evaluateWithTraceInternal(\n                    child,\n                    childPath,\n                );\n                if (childResult.isErr()) {\n                    return Result.err(childResult.errorOrNull()!);\n                }\n\n                const tracedChild = childResult.getOrNull()!;\n                lastTracedChild = tracedChild;\n                if (!tracedChild.matched) {\n                    return Result.ok({\n                        matched: false,\n                        trace: this.buildTrace({\n                            conditionPath: childPath,\n                            decisiveNode: child,\n                            lastEvaluatedLeaf:\n                                tracedChild.trace.lastEvaluatedLeaf,\n                            lastEvaluatedLeafPath:\n                                tracedChild.trace.lastEvaluatedLeafPath,\n                            lastEvaluatedLeafResult:\n                                tracedChild.trace.lastEvaluatedLeafResult,\n                        }),\n                    });\n                }\n            }\n\n            return Result.ok({\n                matched: true,\n                trace: lastTracedChild!.trace,\n            });\n        }\n\n        if (ConditionEvaluatorV1.isOrNode(node)) {\n            let lastTrace: ConditionEvaluationTrace | null = null;\n\n            for (const [index, child] of node.or.entries()) {\n                const childResult = this.evaluateWithTraceInternal(\n                    child,\n                    `${path}.or[${index}]`,\n                );\n                if (childResult.isErr()) {\n                    return Result.err(childResult.errorOrNull()!);\n                }\n\n                const tracedChild = childResult.getOrNull()!;\n                lastTrace = tracedChild.trace;\n                if (tracedChild.matched) {\n                    return Result.ok({\n                        matched: true,\n                        trace: tracedChild.trace,\n                    });\n                }\n            }\n\n            if (lastTrace === null) {\n                return Result.err(\n                    ConditionEvaluatorV1.buildEmptyOrConditionMessage(),\n                );\n            }\n\n            return Result.ok({ matched: false, trace: lastTrace! });\n        }\n\n        if (ConditionEvaluatorV1.isNotNode(node)) {\n            const childPath = `${path}.not`;\n            const childResult = this.evaluateWithTraceInternal(\n                node.not,\n                childPath,\n            );\n            if (childResult.isErr()) {\n                return Result.err(childResult.errorOrNull()!);\n            }\n\n            const tracedChild = childResult.getOrNull()!;\n            return Result.ok({\n                matched: !tracedChild.matched,\n                trace: this.buildTrace({\n                    conditionPath: path,\n                    decisiveNode: node,\n                    lastEvaluatedLeaf: tracedChild.trace.lastEvaluatedLeaf,\n                    lastEvaluatedLeafPath:\n                        tracedChild.trace.lastEvaluatedLeafPath,\n                    lastEvaluatedLeafResult:\n                        tracedChild.trace.lastEvaluatedLeafResult,\n                }),\n            });\n        }\n\n        return this.conditionEvalErr(\n            node,\n            new TypeError(\"Invalid condition node shape\"),\n        );\n    }\n\n    evaluate(node: ConditionNode): Result<boolean, string> {\n        try {\n            const result = this.evaluateWithTraceInternal(node, \"$\");\n            if (result.isErr()) {\n                return Result.err(result.errorOrNull()!);\n            }\n\n            return Result.ok(result.getOrNull()!.matched);\n        } catch (error) {\n            return this.conditionEvalErr(node, error);\n        }\n    }\n\n    evaluateWithTrace(\n        node: ConditionNode,\n    ): Result<TracedConditionEvaluation, string> {\n        try {\n            return this.evaluateWithTraceInternal(node, \"$\");\n        } catch (error) {\n            return this.conditionEvalErr(node, error);\n        }\n    }\n\n    static extractFields(node: ConditionNode): string[] {\n        if (ConditionEvaluatorV1.isLeafNode(node)) {\n            return [node.field];\n        }\n\n        if (ConditionEvaluatorV1.isAndNode(node)) {\n            return node.and.flatMap((child) =>\n                ConditionEvaluatorV1.extractFields(child),\n            );\n        }\n\n        if (ConditionEvaluatorV1.isOrNode(node)) {\n            return node.or.flatMap((child) =>\n                ConditionEvaluatorV1.extractFields(child),\n            );\n        }\n\n        if (ConditionEvaluatorV1.isNotNode(node)) {\n            return ConditionEvaluatorV1.extractFields(node.not);\n        }\n\n        return [];\n    }\n}\n"],"mappings":"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"}

package/dist/entity.cjs

@@ -7,7 +7,6 @@ function assertValidAggregateVersion(aggregateVersion) {
 }
 //#endregion
 //#region src/core/domain/entity.ts
-var _Entity;
 /**
 * Base class for domain entities — objects defined by a stable identity rather
 * than by their attributes. Two entities are "the same" when their `id`
@@ -23,9 +22,6 @@ var _Entity;
 * @typeParam TIdentifier - The identity type (e.g. a branded string id or a VO).
 */
 let Entity = class Entity {
-	static {
-		_Entity = this;
-	}
 	/**
 	* Reconstitutes an entity from its persisted {@link EntityState}.
 	*
@@ -86,7 +82,7 @@ let Entity = class Entity {
 	* an older shape.
 	*/
 	get contractVersion() {
-		return _Entity.CONTRACT_VERSION;
+		return this.constructor.CONTRACT_VERSION;
 	}
 	/**
 	* The single seam through which an entity records a mutation: it advances
@@ -108,7 +104,7 @@ let Entity = class Entity {
 		return this._aggregateVersion;
 	}
 };
-Entity = _Entity = require_immutable.__decorate([require_immutable.version("1.0")], Entity);
+Entity = require_immutable.__decorate([require_immutable.version("1.0")], Entity);
 //#endregion
 Object.defineProperty(exports, "Entity", {
 	enumerable: true,

package/dist/entity.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"entity.cjs","names":["InvariantViolationException","InvariantViolationException","cloneDate","version"],"sources":["../src/core/shared/aggregate-version.ts","../src/core/domain/entity.ts"],"sourcesContent":["import { InvariantViolationException } from \"../exceptions/invariant-violation-exception.js\";\n\nfunction assertValidAggregateVersion(aggregateVersion: number): void {\n    if (!Number.isInteger(aggregateVersion) || aggregateVersion < 0) {\n        throw new InvariantViolationException(\n            `aggregateVersion must be a non-negative integer. Received: ${aggregateVersion}`,\n        );\n    }\n}\n\nexport { assertValidAggregateVersion };\n","import { InvariantViolationException } from \"../exceptions/invariant-violation-exception.js\";\nimport { assertValidAggregateVersion } from \"../shared/aggregate-version.js\";\nimport { assertValidDate, cloneDate } from \"../shared/temporal-guards.js\";\nimport { type ContractVersion, version } from \"../versioning/version.js\";\n\n/**\n * The minimal persisted shape needed to reconstitute an {@link Entity}.\n *\n * This is the contract between storage and the domain: a repository maps a row\n * (or document) onto these four fields and hands them to a subclass constructor.\n * `aggregateVersion` travels with the state so optimistic-concurrency checks\n * survive a round-trip through the database.\n */\ninterface EntityState<TIdentifier> {\n    readonly id: TIdentifier;\n    readonly createdAt: Date;\n    readonly updatedAt: Date;\n    readonly aggregateVersion: number;\n}\n\n/**\n * Base class for domain entities — objects defined by a stable identity rather\n * than by their attributes. Two entities are \"the same\" when their `id`\n * matches, even if every other field differs; this is the opposite of a\n * {@link ValueObject}, which is defined entirely by its contents.\n *\n * The class owns the bookkeeping common to every aggregate root: a creation\n * timestamp that never changes, a last-modified timestamp, and an\n * `aggregateVersion` counter used for optimistic concurrency control. All three\n * are validated on construction and the dates are defensively cloned, so an\n * entity can never be built into — or leak — an inconsistent temporal state.\n *\n * @typeParam TIdentifier - The identity type (e.g. a branded string id or a VO).\n */\n@version(\"1.0\")\nabstract class Entity<TIdentifier> {\n    declare public static readonly CONTRACT_VERSION: ContractVersion;\n\n    private readonly _id: TIdentifier;\n    private readonly _createdAt: Date;\n    private _updatedAt: Date;\n    private _aggregateVersion: number;\n\n    /**\n     * Reconstitutes an entity from its persisted {@link EntityState}.\n     *\n     * Validates the temporal invariants up front so an invalid entity is\n     * impossible to construct: both dates must be valid, the aggregate version\n     * must be a non-negative integer, and `updatedAt` may not predate\n     * `createdAt`. Both dates are cloned on the way in so a later mutation of\n     * the caller's `Date` objects cannot reach into the entity's internal state.\n     *\n     * Declared `protected` because entities are reconstituted through a\n     * subclass factory, never instantiated directly by application code.\n     *\n     * @throws {InvariantViolationException} When `updatedAt` is earlier than `createdAt`.\n     */\n    protected constructor(state: EntityState<TIdentifier>) {\n        assertValidDate(\"createdAt\", state.createdAt);\n        assertValidDate(\"updatedAt\", state.updatedAt);\n        assertValidAggregateVersion(state.aggregateVersion);\n\n        if (state.updatedAt.getTime() < state.createdAt.getTime()) {\n            throw new InvariantViolationException(\n                \"updatedAt cannot be earlier than createdAt\",\n            );\n        }\n\n        this._id = state.id;\n        this._createdAt = cloneDate(state.createdAt);\n        this._updatedAt = cloneDate(state.updatedAt);\n        this._aggregateVersion = state.aggregateVersion;\n    }\n\n    /** The entity's stable identity — the basis for equality between entities. */\n    public get id(): TIdentifier {\n        return this._id;\n    }\n\n    /**\n     * When the entity was first created.\n     *\n     * Returns a clone so callers cannot mutate the entity's internal `Date`;\n     * the value is fixed at construction and never changes thereafter.\n     */\n    public get createdAt(): Date {\n        return cloneDate(this._createdAt);\n    }\n\n    /**\n     * When the entity was last modified.\n     *\n     * Returns a clone for the same encapsulation reason as {@link createdAt};\n     * the underlying value advances only through {@link markAsModified}.\n     */\n    public get updatedAt(): Date {\n        return cloneDate(this._updatedAt);\n    }\n\n    /**\n     * Monotonic counter incremented on every mutation, used for optimistic\n     * concurrency control: a writer reads this value, and the persistence layer\n     * rejects the write if the stored version has moved on in the meantime.\n     */\n    public get aggregateVersion(): number {\n        return this._aggregateVersion;\n    }\n\n    /**\n     * The schema/contract version stamped on this entity type by the\n     * `@version` decorator — used to detect and migrate state persisted under\n     * an older shape.\n     */\n    public get contractVersion(): ContractVersion {\n        return Entity.CONTRACT_VERSION;\n    }\n\n    /**\n     * The single seam through which an entity records a mutation: it advances\n     * `updatedAt` and bumps {@link aggregateVersion} by one. Subclasses must\n     * call this from every state-changing method so the version counter stays\n     * an accurate optimistic-lock token.\n     *\n     * @param updatedAt - The modification instant; defaults to now. Validated\n     *   and required not to predate `createdAt`, preserving the same invariant\n     *   the constructor enforces.\n     * @returns The new aggregate version after the increment.\n     * @throws {InvariantViolationException} When `updatedAt` is earlier than `createdAt`.\n     */\n    protected markAsModified(updatedAt: Date = new Date()): number {\n        assertValidDate(\"updatedAt\", updatedAt);\n\n        if (updatedAt.getTime() < this._createdAt.getTime()) {\n            throw new InvariantViolationException(\n                \"updatedAt cannot be earlier than createdAt\",\n            );\n        }\n\n        this._updatedAt = cloneDate(updatedAt);\n        this._aggregateVersion += 1;\n\n        return this._aggregateVersion;\n    }\n}\n\nexport { Entity, type EntityState };\n"],"mappings":";;;;AAEA,SAAS,4BAA4B,kBAAgC;CACjE,IAAI,CAAC,OAAO,UAAU,gBAAgB,KAAK,mBAAmB,GAC1D,MAAM,IAAIA,sCAAAA,4BACN,8DAA8D,kBAClE;AAER;;;;;;;;;;;;;;;;;;AC0BA,IAAA,SAAA,MACe,OAAoB;;;;;;;;;;;;;;;;;;CAsB/B,YAAsB,OAAiC;EACnD,wBAAA,gBAAgB,aAAa,MAAM,SAAS;EAC5C,wBAAA,gBAAgB,aAAa,MAAM,SAAS;EAC5C,4BAA4B,MAAM,gBAAgB;EAElD,IAAI,MAAM,UAAU,QAAQ,IAAI,MAAM,UAAU,QAAQ,GACpD,MAAM,IAAIC,sCAAAA,4BACN,4CACJ;EAGJ,KAAK,MAAM,MAAM;EACjB,KAAK,aAAaC,wBAAAA,UAAU,MAAM,SAAS;EAC3C,KAAK,aAAaA,wBAAAA,UAAU,MAAM,SAAS;EAC3C,KAAK,oBAAoB,MAAM;CACnC;;CAGA,IAAW,KAAkB;EACzB,OAAO,KAAK;CAChB;;;;;;;CAQA,IAAW,YAAkB;EACzB,OAAOA,wBAAAA,UAAU,KAAK,UAAU;CACpC;;;;;;;CAQA,IAAW,YAAkB;EACzB,OAAOA,wBAAAA,UAAU,KAAK,UAAU;CACpC;;;;;;CAOA,IAAW,mBAA2B;EAClC,OAAO,KAAK;CAChB;;;;;;CAOA,IAAW,kBAAmC;EAC1C,OAAA,QAAc;CAClB;;;;;;;;;;;;;CAcA,eAAyB,4BAAkB,IAAI,KAAK,GAAW;EAC3D,wBAAA,gBAAgB,aAAa,SAAS;EAEtC,IAAI,UAAU,QAAQ,IAAI,KAAK,WAAW,QAAQ,GAC9C,MAAM,IAAID,sCAAAA,4BACN,4CACJ;EAGJ,KAAK,aAAaC,wBAAAA,UAAU,SAAS;EACrC,KAAK,qBAAqB;EAE1B,OAAO,KAAK;CAChB;AACJ;iDA7GCC,kBAAAA,QAAQ,KAAK,CAAA,GAAA,MAAA"}
+{"version":3,"file":"entity.cjs","names":["InvariantViolationException","InvariantViolationException","cloneDate","version"],"sources":["../src/core/shared/aggregate-version.ts","../src/core/domain/entity.ts"],"sourcesContent":["import { InvariantViolationException } from \"../exceptions/invariant-violation-exception.js\";\n\nfunction assertValidAggregateVersion(aggregateVersion: number): void {\n    if (!Number.isInteger(aggregateVersion) || aggregateVersion < 0) {\n        throw new InvariantViolationException(\n            `aggregateVersion must be a non-negative integer. Received: ${aggregateVersion}`,\n        );\n    }\n}\n\nexport { assertValidAggregateVersion };\n","import { InvariantViolationException } from \"../exceptions/invariant-violation-exception.js\";\nimport { assertValidAggregateVersion } from \"../shared/aggregate-version.js\";\nimport { assertValidDate, cloneDate } from \"../shared/temporal-guards.js\";\nimport { type ContractVersion, version } from \"../versioning/version.js\";\n\n/**\n * The minimal persisted shape needed to reconstitute an {@link Entity}.\n *\n * This is the contract between storage and the domain: a repository maps a row\n * (or document) onto these four fields and hands them to a subclass constructor.\n * `aggregateVersion` travels with the state so optimistic-concurrency checks\n * survive a round-trip through the database.\n */\ninterface EntityState<TIdentifier> {\n    readonly id: TIdentifier;\n    readonly createdAt: Date;\n    readonly updatedAt: Date;\n    readonly aggregateVersion: number;\n}\n\n/**\n * Base class for domain entities — objects defined by a stable identity rather\n * than by their attributes. Two entities are \"the same\" when their `id`\n * matches, even if every other field differs; this is the opposite of a\n * {@link ValueObject}, which is defined entirely by its contents.\n *\n * The class owns the bookkeeping common to every aggregate root: a creation\n * timestamp that never changes, a last-modified timestamp, and an\n * `aggregateVersion` counter used for optimistic concurrency control. All three\n * are validated on construction and the dates are defensively cloned, so an\n * entity can never be built into — or leak — an inconsistent temporal state.\n *\n * @typeParam TIdentifier - The identity type (e.g. a branded string id or a VO).\n */\n@version(\"1.0\")\nabstract class Entity<TIdentifier> {\n    declare public static readonly CONTRACT_VERSION: ContractVersion;\n\n    private readonly _id: TIdentifier;\n    private readonly _createdAt: Date;\n    private _updatedAt: Date;\n    private _aggregateVersion: number;\n\n    /**\n     * Reconstitutes an entity from its persisted {@link EntityState}.\n     *\n     * Validates the temporal invariants up front so an invalid entity is\n     * impossible to construct: both dates must be valid, the aggregate version\n     * must be a non-negative integer, and `updatedAt` may not predate\n     * `createdAt`. Both dates are cloned on the way in so a later mutation of\n     * the caller's `Date` objects cannot reach into the entity's internal state.\n     *\n     * Declared `protected` because entities are reconstituted through a\n     * subclass factory, never instantiated directly by application code.\n     *\n     * @throws {InvariantViolationException} When `updatedAt` is earlier than `createdAt`.\n     */\n    protected constructor(state: EntityState<TIdentifier>) {\n        assertValidDate(\"createdAt\", state.createdAt);\n        assertValidDate(\"updatedAt\", state.updatedAt);\n        assertValidAggregateVersion(state.aggregateVersion);\n\n        if (state.updatedAt.getTime() < state.createdAt.getTime()) {\n            throw new InvariantViolationException(\n                \"updatedAt cannot be earlier than createdAt\",\n            );\n        }\n\n        this._id = state.id;\n        this._createdAt = cloneDate(state.createdAt);\n        this._updatedAt = cloneDate(state.updatedAt);\n        this._aggregateVersion = state.aggregateVersion;\n    }\n\n    /** The entity's stable identity — the basis for equality between entities. */\n    public get id(): TIdentifier {\n        return this._id;\n    }\n\n    /**\n     * When the entity was first created.\n     *\n     * Returns a clone so callers cannot mutate the entity's internal `Date`;\n     * the value is fixed at construction and never changes thereafter.\n     */\n    public get createdAt(): Date {\n        return cloneDate(this._createdAt);\n    }\n\n    /**\n     * When the entity was last modified.\n     *\n     * Returns a clone for the same encapsulation reason as {@link createdAt};\n     * the underlying value advances only through {@link markAsModified}.\n     */\n    public get updatedAt(): Date {\n        return cloneDate(this._updatedAt);\n    }\n\n    /**\n     * Monotonic counter incremented on every mutation, used for optimistic\n     * concurrency control: a writer reads this value, and the persistence layer\n     * rejects the write if the stored version has moved on in the meantime.\n     */\n    public get aggregateVersion(): number {\n        return this._aggregateVersion;\n    }\n\n    /**\n     * The schema/contract version stamped on this entity type by the\n     * `@version` decorator — used to detect and migrate state persisted under\n     * an older shape.\n     */\n    public get contractVersion(): ContractVersion {\n        return (this.constructor as typeof Entity).CONTRACT_VERSION;\n    }\n\n    /**\n     * The single seam through which an entity records a mutation: it advances\n     * `updatedAt` and bumps {@link aggregateVersion} by one. Subclasses must\n     * call this from every state-changing method so the version counter stays\n     * an accurate optimistic-lock token.\n     *\n     * @param updatedAt - The modification instant; defaults to now. Validated\n     *   and required not to predate `createdAt`, preserving the same invariant\n     *   the constructor enforces.\n     * @returns The new aggregate version after the increment.\n     * @throws {InvariantViolationException} When `updatedAt` is earlier than `createdAt`.\n     */\n    protected markAsModified(updatedAt: Date = new Date()): number {\n        assertValidDate(\"updatedAt\", updatedAt);\n\n        if (updatedAt.getTime() < this._createdAt.getTime()) {\n            throw new InvariantViolationException(\n                \"updatedAt cannot be earlier than createdAt\",\n            );\n        }\n\n        this._updatedAt = cloneDate(updatedAt);\n        this._aggregateVersion += 1;\n\n        return this._aggregateVersion;\n    }\n}\n\nexport { Entity, type EntityState };\n"],"mappings":";;;;AAEA,SAAS,4BAA4B,kBAAgC;CACjE,IAAI,CAAC,OAAO,UAAU,gBAAgB,KAAK,mBAAmB,GAC1D,MAAM,IAAIA,sCAAAA,4BACN,8DAA8D,kBAClE;AAER;;;;;;;;;;;;;;;;;AC0BA,IAAA,SAAA,MACe,OAAoB;;;;;;;;;;;;;;;CAsB/B,YAAsB,OAAiC;EACnD,wBAAA,gBAAgB,aAAa,MAAM,SAAS;EAC5C,wBAAA,gBAAgB,aAAa,MAAM,SAAS;EAC5C,4BAA4B,MAAM,gBAAgB;EAElD,IAAI,MAAM,UAAU,QAAQ,IAAI,MAAM,UAAU,QAAQ,GACpD,MAAM,IAAIC,sCAAAA,4BACN,4CACJ;EAGJ,KAAK,MAAM,MAAM;EACjB,KAAK,aAAaC,wBAAAA,UAAU,MAAM,SAAS;EAC3C,KAAK,aAAaA,wBAAAA,UAAU,MAAM,SAAS;EAC3C,KAAK,oBAAoB,MAAM;CACnC;;CAGA,IAAW,KAAkB;EACzB,OAAO,KAAK;CAChB;;;;;;;CAQA,IAAW,YAAkB;EACzB,OAAOA,wBAAAA,UAAU,KAAK,UAAU;CACpC;;;;;;;CAQA,IAAW,YAAkB;EACzB,OAAOA,wBAAAA,UAAU,KAAK,UAAU;CACpC;;;;;;CAOA,IAAW,mBAA2B;EAClC,OAAO,KAAK;CAChB;;;;;;CAOA,IAAW,kBAAmC;EAC1C,OAAQ,KAAK,YAA8B;CAC/C;;;;;;;;;;;;;CAcA,eAAyB,4BAAkB,IAAI,KAAK,GAAW;EAC3D,wBAAA,gBAAgB,aAAa,SAAS;EAEtC,IAAI,UAAU,QAAQ,IAAI,KAAK,WAAW,QAAQ,GAC9C,MAAM,IAAID,sCAAAA,4BACN,4CACJ;EAGJ,KAAK,aAAaC,wBAAAA,UAAU,SAAS;EACrC,KAAK,qBAAqB;EAE1B,OAAO,KAAK;CAChB;AACJ;uCA7GCC,kBAAAA,QAAQ,KAAK,CAAA,GAAA,MAAA"}

package/dist/entity.js

@@ -7,7 +7,6 @@ function assertValidAggregateVersion(aggregateVersion) {
 }
 //#endregion
 //#region src/core/domain/entity.ts
-var _Entity;
 /**
 * Base class for domain entities — objects defined by a stable identity rather
 * than by their attributes. Two entities are "the same" when their `id`
@@ -23,9 +22,6 @@ var _Entity;
 * @typeParam TIdentifier - The identity type (e.g. a branded string id or a VO).
 */
 let Entity = class Entity {
-	static {
-		_Entity = this;
-	}
 	/**
 	* Reconstitutes an entity from its persisted {@link EntityState}.
 	*
@@ -86,7 +82,7 @@ let Entity = class Entity {
 	* an older shape.
 	*/
 	get contractVersion() {
-		return _Entity.CONTRACT_VERSION;
+		return this.constructor.CONTRACT_VERSION;
 	}
 	/**
 	* The single seam through which an entity records a mutation: it advances
@@ -108,7 +104,7 @@ let Entity = class Entity {
 		return this._aggregateVersion;
 	}
 };
-Entity = _Entity = __decorate([version("1.0")], Entity);
+Entity = __decorate([version("1.0")], Entity);
 //#endregion
 export { assertValidAggregateVersion as n, Entity as t };
 

package/dist/entity.js.map

@@ -1 +1 @@
-{"version":3,"file":"entity.js","names":[],"sources":["../src/core/shared/aggregate-version.ts","../src/core/domain/entity.ts"],"sourcesContent":["import { InvariantViolationException } from \"../exceptions/invariant-violation-exception.js\";\n\nfunction assertValidAggregateVersion(aggregateVersion: number): void {\n    if (!Number.isInteger(aggregateVersion) || aggregateVersion < 0) {\n        throw new InvariantViolationException(\n            `aggregateVersion must be a non-negative integer. Received: ${aggregateVersion}`,\n        );\n    }\n}\n\nexport { assertValidAggregateVersion };\n","import { InvariantViolationException } from \"../exceptions/invariant-violation-exception.js\";\nimport { assertValidAggregateVersion } from \"../shared/aggregate-version.js\";\nimport { assertValidDate, cloneDate } from \"../shared/temporal-guards.js\";\nimport { type ContractVersion, version } from \"../versioning/version.js\";\n\n/**\n * The minimal persisted shape needed to reconstitute an {@link Entity}.\n *\n * This is the contract between storage and the domain: a repository maps a row\n * (or document) onto these four fields and hands them to a subclass constructor.\n * `aggregateVersion` travels with the state so optimistic-concurrency checks\n * survive a round-trip through the database.\n */\ninterface EntityState<TIdentifier> {\n    readonly id: TIdentifier;\n    readonly createdAt: Date;\n    readonly updatedAt: Date;\n    readonly aggregateVersion: number;\n}\n\n/**\n * Base class for domain entities — objects defined by a stable identity rather\n * than by their attributes. Two entities are \"the same\" when their `id`\n * matches, even if every other field differs; this is the opposite of a\n * {@link ValueObject}, which is defined entirely by its contents.\n *\n * The class owns the bookkeeping common to every aggregate root: a creation\n * timestamp that never changes, a last-modified timestamp, and an\n * `aggregateVersion` counter used for optimistic concurrency control. All three\n * are validated on construction and the dates are defensively cloned, so an\n * entity can never be built into — or leak — an inconsistent temporal state.\n *\n * @typeParam TIdentifier - The identity type (e.g. a branded string id or a VO).\n */\n@version(\"1.0\")\nabstract class Entity<TIdentifier> {\n    declare public static readonly CONTRACT_VERSION: ContractVersion;\n\n    private readonly _id: TIdentifier;\n    private readonly _createdAt: Date;\n    private _updatedAt: Date;\n    private _aggregateVersion: number;\n\n    /**\n     * Reconstitutes an entity from its persisted {@link EntityState}.\n     *\n     * Validates the temporal invariants up front so an invalid entity is\n     * impossible to construct: both dates must be valid, the aggregate version\n     * must be a non-negative integer, and `updatedAt` may not predate\n     * `createdAt`. Both dates are cloned on the way in so a later mutation of\n     * the caller's `Date` objects cannot reach into the entity's internal state.\n     *\n     * Declared `protected` because entities are reconstituted through a\n     * subclass factory, never instantiated directly by application code.\n     *\n     * @throws {InvariantViolationException} When `updatedAt` is earlier than `createdAt`.\n     */\n    protected constructor(state: EntityState<TIdentifier>) {\n        assertValidDate(\"createdAt\", state.createdAt);\n        assertValidDate(\"updatedAt\", state.updatedAt);\n        assertValidAggregateVersion(state.aggregateVersion);\n\n        if (state.updatedAt.getTime() < state.createdAt.getTime()) {\n            throw new InvariantViolationException(\n                \"updatedAt cannot be earlier than createdAt\",\n            );\n        }\n\n        this._id = state.id;\n        this._createdAt = cloneDate(state.createdAt);\n        this._updatedAt = cloneDate(state.updatedAt);\n        this._aggregateVersion = state.aggregateVersion;\n    }\n\n    /** The entity's stable identity — the basis for equality between entities. */\n    public get id(): TIdentifier {\n        return this._id;\n    }\n\n    /**\n     * When the entity was first created.\n     *\n     * Returns a clone so callers cannot mutate the entity's internal `Date`;\n     * the value is fixed at construction and never changes thereafter.\n     */\n    public get createdAt(): Date {\n        return cloneDate(this._createdAt);\n    }\n\n    /**\n     * When the entity was last modified.\n     *\n     * Returns a clone for the same encapsulation reason as {@link createdAt};\n     * the underlying value advances only through {@link markAsModified}.\n     */\n    public get updatedAt(): Date {\n        return cloneDate(this._updatedAt);\n    }\n\n    /**\n     * Monotonic counter incremented on every mutation, used for optimistic\n     * concurrency control: a writer reads this value, and the persistence layer\n     * rejects the write if the stored version has moved on in the meantime.\n     */\n    public get aggregateVersion(): number {\n        return this._aggregateVersion;\n    }\n\n    /**\n     * The schema/contract version stamped on this entity type by the\n     * `@version` decorator — used to detect and migrate state persisted under\n     * an older shape.\n     */\n    public get contractVersion(): ContractVersion {\n        return Entity.CONTRACT_VERSION;\n    }\n\n    /**\n     * The single seam through which an entity records a mutation: it advances\n     * `updatedAt` and bumps {@link aggregateVersion} by one. Subclasses must\n     * call this from every state-changing method so the version counter stays\n     * an accurate optimistic-lock token.\n     *\n     * @param updatedAt - The modification instant; defaults to now. Validated\n     *   and required not to predate `createdAt`, preserving the same invariant\n     *   the constructor enforces.\n     * @returns The new aggregate version after the increment.\n     * @throws {InvariantViolationException} When `updatedAt` is earlier than `createdAt`.\n     */\n    protected markAsModified(updatedAt: Date = new Date()): number {\n        assertValidDate(\"updatedAt\", updatedAt);\n\n        if (updatedAt.getTime() < this._createdAt.getTime()) {\n            throw new InvariantViolationException(\n                \"updatedAt cannot be earlier than createdAt\",\n            );\n        }\n\n        this._updatedAt = cloneDate(updatedAt);\n        this._aggregateVersion += 1;\n\n        return this._aggregateVersion;\n    }\n}\n\nexport { Entity, type EntityState };\n"],"mappings":";;;;AAEA,SAAS,4BAA4B,kBAAgC;CACjE,IAAI,CAAC,OAAO,UAAU,gBAAgB,KAAK,mBAAmB,GAC1D,MAAM,IAAI,4BACN,8DAA8D,kBAClE;AAER;;;;;;;;;;;;;;;;;;AC0BA,IAAA,SAAA,MACe,OAAoB;;;;;;;;;;;;;;;;;;CAsB/B,YAAsB,OAAiC;EACnD,gBAAgB,aAAa,MAAM,SAAS;EAC5C,gBAAgB,aAAa,MAAM,SAAS;EAC5C,4BAA4B,MAAM,gBAAgB;EAElD,IAAI,MAAM,UAAU,QAAQ,IAAI,MAAM,UAAU,QAAQ,GACpD,MAAM,IAAI,4BACN,4CACJ;EAGJ,KAAK,MAAM,MAAM;EACjB,KAAK,aAAa,UAAU,MAAM,SAAS;EAC3C,KAAK,aAAa,UAAU,MAAM,SAAS;EAC3C,KAAK,oBAAoB,MAAM;CACnC;;CAGA,IAAW,KAAkB;EACzB,OAAO,KAAK;CAChB;;;;;;;CAQA,IAAW,YAAkB;EACzB,OAAO,UAAU,KAAK,UAAU;CACpC;;;;;;;CAQA,IAAW,YAAkB;EACzB,OAAO,UAAU,KAAK,UAAU;CACpC;;;;;;CAOA,IAAW,mBAA2B;EAClC,OAAO,KAAK;CAChB;;;;;;CAOA,IAAW,kBAAmC;EAC1C,OAAA,QAAc;CAClB;;;;;;;;;;;;;CAcA,eAAyB,4BAAkB,IAAI,KAAK,GAAW;EAC3D,gBAAgB,aAAa,SAAS;EAEtC,IAAI,UAAU,QAAQ,IAAI,KAAK,WAAW,QAAQ,GAC9C,MAAM,IAAI,4BACN,4CACJ;EAGJ,KAAK,aAAa,UAAU,SAAS;EACrC,KAAK,qBAAqB;EAE1B,OAAO,KAAK;CAChB;AACJ;+BA7GC,QAAQ,KAAK,CAAA,GAAA,MAAA"}
+{"version":3,"file":"entity.js","names":[],"sources":["../src/core/shared/aggregate-version.ts","../src/core/domain/entity.ts"],"sourcesContent":["import { InvariantViolationException } from \"../exceptions/invariant-violation-exception.js\";\n\nfunction assertValidAggregateVersion(aggregateVersion: number): void {\n    if (!Number.isInteger(aggregateVersion) || aggregateVersion < 0) {\n        throw new InvariantViolationException(\n            `aggregateVersion must be a non-negative integer. Received: ${aggregateVersion}`,\n        );\n    }\n}\n\nexport { assertValidAggregateVersion };\n","import { InvariantViolationException } from \"../exceptions/invariant-violation-exception.js\";\nimport { assertValidAggregateVersion } from \"../shared/aggregate-version.js\";\nimport { assertValidDate, cloneDate } from \"../shared/temporal-guards.js\";\nimport { type ContractVersion, version } from \"../versioning/version.js\";\n\n/**\n * The minimal persisted shape needed to reconstitute an {@link Entity}.\n *\n * This is the contract between storage and the domain: a repository maps a row\n * (or document) onto these four fields and hands them to a subclass constructor.\n * `aggregateVersion` travels with the state so optimistic-concurrency checks\n * survive a round-trip through the database.\n */\ninterface EntityState<TIdentifier> {\n    readonly id: TIdentifier;\n    readonly createdAt: Date;\n    readonly updatedAt: Date;\n    readonly aggregateVersion: number;\n}\n\n/**\n * Base class for domain entities — objects defined by a stable identity rather\n * than by their attributes. Two entities are \"the same\" when their `id`\n * matches, even if every other field differs; this is the opposite of a\n * {@link ValueObject}, which is defined entirely by its contents.\n *\n * The class owns the bookkeeping common to every aggregate root: a creation\n * timestamp that never changes, a last-modified timestamp, and an\n * `aggregateVersion` counter used for optimistic concurrency control. All three\n * are validated on construction and the dates are defensively cloned, so an\n * entity can never be built into — or leak — an inconsistent temporal state.\n *\n * @typeParam TIdentifier - The identity type (e.g. a branded string id or a VO).\n */\n@version(\"1.0\")\nabstract class Entity<TIdentifier> {\n    declare public static readonly CONTRACT_VERSION: ContractVersion;\n\n    private readonly _id: TIdentifier;\n    private readonly _createdAt: Date;\n    private _updatedAt: Date;\n    private _aggregateVersion: number;\n\n    /**\n     * Reconstitutes an entity from its persisted {@link EntityState}.\n     *\n     * Validates the temporal invariants up front so an invalid entity is\n     * impossible to construct: both dates must be valid, the aggregate version\n     * must be a non-negative integer, and `updatedAt` may not predate\n     * `createdAt`. Both dates are cloned on the way in so a later mutation of\n     * the caller's `Date` objects cannot reach into the entity's internal state.\n     *\n     * Declared `protected` because entities are reconstituted through a\n     * subclass factory, never instantiated directly by application code.\n     *\n     * @throws {InvariantViolationException} When `updatedAt` is earlier than `createdAt`.\n     */\n    protected constructor(state: EntityState<TIdentifier>) {\n        assertValidDate(\"createdAt\", state.createdAt);\n        assertValidDate(\"updatedAt\", state.updatedAt);\n        assertValidAggregateVersion(state.aggregateVersion);\n\n        if (state.updatedAt.getTime() < state.createdAt.getTime()) {\n            throw new InvariantViolationException(\n                \"updatedAt cannot be earlier than createdAt\",\n            );\n        }\n\n        this._id = state.id;\n        this._createdAt = cloneDate(state.createdAt);\n        this._updatedAt = cloneDate(state.updatedAt);\n        this._aggregateVersion = state.aggregateVersion;\n    }\n\n    /** The entity's stable identity — the basis for equality between entities. */\n    public get id(): TIdentifier {\n        return this._id;\n    }\n\n    /**\n     * When the entity was first created.\n     *\n     * Returns a clone so callers cannot mutate the entity's internal `Date`;\n     * the value is fixed at construction and never changes thereafter.\n     */\n    public get createdAt(): Date {\n        return cloneDate(this._createdAt);\n    }\n\n    /**\n     * When the entity was last modified.\n     *\n     * Returns a clone for the same encapsulation reason as {@link createdAt};\n     * the underlying value advances only through {@link markAsModified}.\n     */\n    public get updatedAt(): Date {\n        return cloneDate(this._updatedAt);\n    }\n\n    /**\n     * Monotonic counter incremented on every mutation, used for optimistic\n     * concurrency control: a writer reads this value, and the persistence layer\n     * rejects the write if the stored version has moved on in the meantime.\n     */\n    public get aggregateVersion(): number {\n        return this._aggregateVersion;\n    }\n\n    /**\n     * The schema/contract version stamped on this entity type by the\n     * `@version` decorator — used to detect and migrate state persisted under\n     * an older shape.\n     */\n    public get contractVersion(): ContractVersion {\n        return (this.constructor as typeof Entity).CONTRACT_VERSION;\n    }\n\n    /**\n     * The single seam through which an entity records a mutation: it advances\n     * `updatedAt` and bumps {@link aggregateVersion} by one. Subclasses must\n     * call this from every state-changing method so the version counter stays\n     * an accurate optimistic-lock token.\n     *\n     * @param updatedAt - The modification instant; defaults to now. Validated\n     *   and required not to predate `createdAt`, preserving the same invariant\n     *   the constructor enforces.\n     * @returns The new aggregate version after the increment.\n     * @throws {InvariantViolationException} When `updatedAt` is earlier than `createdAt`.\n     */\n    protected markAsModified(updatedAt: Date = new Date()): number {\n        assertValidDate(\"updatedAt\", updatedAt);\n\n        if (updatedAt.getTime() < this._createdAt.getTime()) {\n            throw new InvariantViolationException(\n                \"updatedAt cannot be earlier than createdAt\",\n            );\n        }\n\n        this._updatedAt = cloneDate(updatedAt);\n        this._aggregateVersion += 1;\n\n        return this._aggregateVersion;\n    }\n}\n\nexport { Entity, type EntityState };\n"],"mappings":";;;;AAEA,SAAS,4BAA4B,kBAAgC;CACjE,IAAI,CAAC,OAAO,UAAU,gBAAgB,KAAK,mBAAmB,GAC1D,MAAM,IAAI,4BACN,8DAA8D,kBAClE;AAER;;;;;;;;;;;;;;;;;AC0BA,IAAA,SAAA,MACe,OAAoB;;;;;;;;;;;;;;;CAsB/B,YAAsB,OAAiC;EACnD,gBAAgB,aAAa,MAAM,SAAS;EAC5C,gBAAgB,aAAa,MAAM,SAAS;EAC5C,4BAA4B,MAAM,gBAAgB;EAElD,IAAI,MAAM,UAAU,QAAQ,IAAI,MAAM,UAAU,QAAQ,GACpD,MAAM,IAAI,4BACN,4CACJ;EAGJ,KAAK,MAAM,MAAM;EACjB,KAAK,aAAa,UAAU,MAAM,SAAS;EAC3C,KAAK,aAAa,UAAU,MAAM,SAAS;EAC3C,KAAK,oBAAoB,MAAM;CACnC;;CAGA,IAAW,KAAkB;EACzB,OAAO,KAAK;CAChB;;;;;;;CAQA,IAAW,YAAkB;EACzB,OAAO,UAAU,KAAK,UAAU;CACpC;;;;;;;CAQA,IAAW,YAAkB;EACzB,OAAO,UAAU,KAAK,UAAU;CACpC;;;;;;CAOA,IAAW,mBAA2B;EAClC,OAAO,KAAK;CAChB;;;;;;CAOA,IAAW,kBAAmC;EAC1C,OAAQ,KAAK,YAA8B;CAC/C;;;;;;;;;;;;;CAcA,eAAyB,4BAAkB,IAAI,KAAK,GAAW;EAC3D,gBAAgB,aAAa,SAAS;EAEtC,IAAI,UAAU,QAAQ,IAAI,KAAK,WAAW,QAAQ,GAC9C,MAAM,IAAI,4BACN,4CACJ;EAGJ,KAAK,aAAa,UAAU,SAAS;EACrC,KAAK,qBAAqB;EAE1B,OAAO,KAAK;CAChB;AACJ;qBA7GC,QAAQ,KAAK,CAAA,GAAA,MAAA"}

package/dist/errors/index.cjs

@@ -3,6 +3,7 @@ const require_app_error = require("../app-error.cjs");
 const require_validation_error = require("../validation-error.cjs");
 const require_authorization_error = require("../authorization-error.cjs");
 const require_not_found_error = require("../not-found-error.cjs");
+const require_stable_stringify = require("../stable-stringify.cjs");
 const require_hashing = require("../hashing.cjs");
 const require_unexpected_error = require("../unexpected-error.cjs");
 exports.AlreadyExistsError = require_validation_error.AlreadyExistsError;
@@ -39,5 +40,5 @@ exports.payloadHash = require_hashing.payloadHash;
 exports.safePreview = require_validation_error.safePreview;
 exports.serializationErrorCode = require_app_error.serializationErrorCode;
 exports.sha256Hex = require_hashing.sha256Hex;
-exports.stableStringify = require_hashing.stableStringify;
+exports.stableStringify = require_stable_stringify.stableStringify;
 exports.translateUniqueViolationToDuplicate = require_validation_error.translateUniqueViolationToDuplicate;

package/dist/errors/index.js

@@ -2,6 +2,7 @@ import { i as serializationErrorCode, n as assertJsonSafeMetadata, r as ErrorCod
 import { C as translateUniqueViolationToDuplicate, S as UniqueConstraintViolationError, _ as IdempotencyPayloadMismatchError, a as evaluateTemporalWindow, b as ConflictError, c as SerializationInError, d as safePreview, f as LegacyIncompatibleError, g as IdempotencyKeyMissingError, h as IdempotencyInProgressError, i as TemporalError, l as SerializationMessages, m as IdempotencyError, n as ExpiredError, o as SerializationCodes, p as IntegrationError, r as NotYetValidError, s as SerializationError, t as ValidationError, u as SerializationOutError, v as IdempotencyReplayNotSupportedError, w as AuthenticationError, x as DuplicateError, y as AlreadyExistsError } from "../validation-error.js";
 import { t as AuthorizationError } from "../authorization-error.js";
 import { n as BusinessRuleViolationError, t as NotFoundError } from "../not-found-error.js";
-import { n as sha256Hex, r as stableStringify, t as payloadHash } from "../hashing.js";
+import { t as stableStringify } from "../stable-stringify.js";
+import { n as sha256Hex, t as payloadHash } from "../hashing.js";
 import { t as UnexpectedError } from "../unexpected-error.js";
 export { AlreadyExistsError, AppError, AuthenticationError, AuthorizationError, BusinessRuleViolationError, ConflictError, SerializationInError as DeserializationError, SerializationInError, DuplicateError, ErrorCodes, ExpiredError, IdempotencyError, IdempotencyInProgressError, IdempotencyKeyMissingError, IdempotencyPayloadMismatchError, IdempotencyReplayNotSupportedError, IntegrationError, LegacyIncompatibleError, NotFoundError, NotYetValidError, SerializationCodes, SerializationError, SerializationMessages, SerializationOutError, TemporalError, UnexpectedError, UniqueConstraintViolationError, ValidationError, assertJsonSafeMetadata, evaluateTemporalWindow, payloadHash, safePreview, serializationErrorCode, sha256Hex, stableStringify, translateUniqueViolationToDuplicate };

package/dist/hashing.cjs

@@ -1,47 +1,11 @@
+const require_stable_stringify = require("./stable-stringify.cjs");
 let node_crypto = require("node:crypto");
 //#region src/core/shared/hashing.ts
-const CIRCULAR_STRUCTURE_MESSAGE = "Cannot stably stringify a circular structure";
 function sha256Hex(value) {
 	return (0, node_crypto.createHash)("sha256").update(value, "utf8").digest("hex");
 }
-function sortKeysDeep(value, seen) {
-	if (Array.isArray(value)) {
-		if (seen.has(value)) throw new TypeError(CIRCULAR_STRUCTURE_MESSAGE);
-		seen.add(value);
-		const mapped = value.map((item) => sortKeysDeep(item, seen));
-		seen.delete(value);
-		return mapped;
-	}
-	if (value instanceof Date) return value;
-	if (value && typeof value === "object") {
-		if (seen.has(value)) throw new TypeError(CIRCULAR_STRUCTURE_MESSAGE);
-		seen.add(value);
-		const record = value;
-		const ordered = Object.create(null);
-		for (const key of Object.keys(record).sort()) ordered[key] = sortKeysDeep(record[key], seen);
-		seen.delete(value);
-		return ordered;
-	}
-	return value;
-}
-/**
-* Deterministic JSON string with object keys sorted recursively, so key order
-* does not affect the output.
-*
-* Follows `JSON.stringify` semantics for the values it serializes: `undefined`,
-* functions and symbols are dropped, non-finite numbers become `null`, `bigint`
-* throws, and `Map`/`Set` serialize as `{}`. Distinct payloads can therefore
-* collapse to the same string — for collision-resistant hashing use
-* `PolicyHashing.canonicalJson` (policies/utils), which rejects those values
-* up front.
-*
-* @throws {TypeError} On circular references (mirroring `JSON.stringify`).
-*/
-function stableStringify(value) {
-	return JSON.stringify(sortKeysDeep(value, /* @__PURE__ */ new WeakSet()));
-}
 function payloadHash(value) {
-	return sha256Hex(stableStringify(value));
+	return sha256Hex(require_stable_stringify.stableStringify(value));
 }
 //#endregion
 Object.defineProperty(exports, "payloadHash", {
@@ -56,11 +20,5 @@ Object.defineProperty(exports, "sha256Hex", {
 		return sha256Hex;
 	}
 });
-Object.defineProperty(exports, "stableStringify", {
-	enumerable: true,
-	get: function() {
-		return stableStringify;
-	}
-});
 
 //# sourceMappingURL=hashing.cjs.map

package/dist/hashing.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"hashing.cjs","names":[],"sources":["../src/core/shared/hashing.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\n\nconst CIRCULAR_STRUCTURE_MESSAGE =\n    \"Cannot stably stringify a circular structure\";\n\nfunction sha256Hex(value: string): string {\n    return createHash(\"sha256\").update(value, \"utf8\").digest(\"hex\");\n}\n\n// `seen` holds the current traversal branch so true cycles are rejected while\n// repeated (acyclic) references are still serialized — matching JSON.stringify.\nfunction sortKeysDeep(value: unknown, seen: WeakSet<object>): unknown {\n    if (Array.isArray(value)) {\n        if (seen.has(value)) {\n            throw new TypeError(CIRCULAR_STRUCTURE_MESSAGE);\n        }\n        seen.add(value);\n        const mapped = value.map((item) => sortKeysDeep(item, seen));\n        seen.delete(value);\n        return mapped;\n    }\n\n    if (value instanceof Date) {\n        return value;\n    }\n\n    if (value && typeof value === \"object\") {\n        if (seen.has(value)) {\n            throw new TypeError(CIRCULAR_STRUCTURE_MESSAGE);\n        }\n        seen.add(value);\n        const record = value as Record<string, unknown>;\n        const ordered = Object.create(null) as Record<string, unknown>;\n\n        for (const key of Object.keys(record).sort()) {\n            ordered[key] = sortKeysDeep(record[key], seen);\n        }\n        seen.delete(value);\n\n        return ordered;\n    }\n\n    return value;\n}\n\n/**\n * Deterministic JSON string with object keys sorted recursively, so key order\n * does not affect the output.\n *\n * Follows `JSON.stringify` semantics for the values it serializes: `undefined`,\n * functions and symbols are dropped, non-finite numbers become `null`, `bigint`\n * throws, and `Map`/`Set` serialize as `{}`. Distinct payloads can therefore\n * collapse to the same string — for collision-resistant hashing use\n * `PolicyHashing.canonicalJson` (policies/utils), which rejects those values\n * up front.\n *\n * @throws {TypeError} On circular references (mirroring `JSON.stringify`).\n */\nfunction stableStringify(value: unknown): string {\n    return JSON.stringify(sortKeysDeep(value, new WeakSet<object>()));\n}\n\nfunction payloadHash(value: unknown): string {\n    return sha256Hex(stableStringify(value));\n}\n\nexport { payloadHash, sha256Hex, stableStringify };\n"],"mappings":";;AAEA,MAAM,6BACF;AAEJ,SAAS,UAAU,OAAuB;CACtC,QAAA,GAAA,YAAA,YAAkB,QAAQ,EAAE,OAAO,OAAO,MAAM,EAAE,OAAO,KAAK;AAClE;AAIA,SAAS,aAAa,OAAgB,MAAgC;CAClE,IAAI,MAAM,QAAQ,KAAK,GAAG;EACtB,IAAI,KAAK,IAAI,KAAK,GACd,MAAM,IAAI,UAAU,0BAA0B;EAElD,KAAK,IAAI,KAAK;EACd,MAAM,SAAS,MAAM,KAAK,SAAS,aAAa,MAAM,IAAI,CAAC;EAC3D,KAAK,OAAO,KAAK;EACjB,OAAO;CACX;CAEA,IAAI,iBAAiB,MACjB,OAAO;CAGX,IAAI,SAAS,OAAO,UAAU,UAAU;EACpC,IAAI,KAAK,IAAI,KAAK,GACd,MAAM,IAAI,UAAU,0BAA0B;EAElD,KAAK,IAAI,KAAK;EACd,MAAM,SAAS;EACf,MAAM,UAAU,OAAO,OAAO,IAAI;EAElC,KAAK,MAAM,OAAO,OAAO,KAAK,MAAM,EAAE,KAAK,GACvC,QAAQ,OAAO,aAAa,OAAO,MAAM,IAAI;EAEjD,KAAK,OAAO,KAAK;EAEjB,OAAO;CACX;CAEA,OAAO;AACX;;;;;;;;;;;;;;AAeA,SAAS,gBAAgB,OAAwB;CAC7C,OAAO,KAAK,UAAU,aAAa,uBAAO,IAAI,QAAgB,CAAC,CAAC;AACpE;AAEA,SAAS,YAAY,OAAwB;CACzC,OAAO,UAAU,gBAAgB,KAAK,CAAC;AAC3C"}
+{"version":3,"file":"hashing.cjs","names":["stableStringify"],"sources":["../src/core/shared/hashing.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\n\nimport { stableStringify } from \"./stable-stringify.js\";\n\nfunction sha256Hex(value: string): string {\n    return createHash(\"sha256\").update(value, \"utf8\").digest(\"hex\");\n}\n\nfunction payloadHash(value: unknown): string {\n    return sha256Hex(stableStringify(value));\n}\n\nexport { payloadHash, sha256Hex, stableStringify };\n"],"mappings":";;;AAIA,SAAS,UAAU,OAAuB;CACtC,QAAA,GAAA,YAAA,YAAkB,QAAQ,EAAE,OAAO,OAAO,MAAM,EAAE,OAAO,KAAK;AAClE;AAEA,SAAS,YAAY,OAAwB;CACzC,OAAO,UAAUA,yBAAAA,gBAAgB,KAAK,CAAC;AAC3C"}

package/dist/hashing.js

@@ -1,49 +1,13 @@
+import { t as stableStringify } from "./stable-stringify.js";
 import { createHash } from "node:crypto";
 //#region src/core/shared/hashing.ts
-const CIRCULAR_STRUCTURE_MESSAGE = "Cannot stably stringify a circular structure";
 function sha256Hex(value) {
 	return createHash("sha256").update(value, "utf8").digest("hex");
 }
-function sortKeysDeep(value, seen) {
-	if (Array.isArray(value)) {
-		if (seen.has(value)) throw new TypeError(CIRCULAR_STRUCTURE_MESSAGE);
-		seen.add(value);
-		const mapped = value.map((item) => sortKeysDeep(item, seen));
-		seen.delete(value);
-		return mapped;
-	}
-	if (value instanceof Date) return value;
-	if (value && typeof value === "object") {
-		if (seen.has(value)) throw new TypeError(CIRCULAR_STRUCTURE_MESSAGE);
-		seen.add(value);
-		const record = value;
-		const ordered = Object.create(null);
-		for (const key of Object.keys(record).sort()) ordered[key] = sortKeysDeep(record[key], seen);
-		seen.delete(value);
-		return ordered;
-	}
-	return value;
-}
-/**
-* Deterministic JSON string with object keys sorted recursively, so key order
-* does not affect the output.
-*
-* Follows `JSON.stringify` semantics for the values it serializes: `undefined`,
-* functions and symbols are dropped, non-finite numbers become `null`, `bigint`
-* throws, and `Map`/`Set` serialize as `{}`. Distinct payloads can therefore
-* collapse to the same string — for collision-resistant hashing use
-* `PolicyHashing.canonicalJson` (policies/utils), which rejects those values
-* up front.
-*
-* @throws {TypeError} On circular references (mirroring `JSON.stringify`).
-*/
-function stableStringify(value) {
-	return JSON.stringify(sortKeysDeep(value, /* @__PURE__ */ new WeakSet()));
-}
 function payloadHash(value) {
 	return sha256Hex(stableStringify(value));
 }
 //#endregion
-export { sha256Hex as n, stableStringify as r, payloadHash as t };
+export { sha256Hex as n, payloadHash as t };
 
 //# sourceMappingURL=hashing.js.map

package/dist/hashing.js.map

@@ -1 +1 @@
-{"version":3,"file":"hashing.js","names":[],"sources":["../src/core/shared/hashing.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\n\nconst CIRCULAR_STRUCTURE_MESSAGE =\n    \"Cannot stably stringify a circular structure\";\n\nfunction sha256Hex(value: string): string {\n    return createHash(\"sha256\").update(value, \"utf8\").digest(\"hex\");\n}\n\n// `seen` holds the current traversal branch so true cycles are rejected while\n// repeated (acyclic) references are still serialized — matching JSON.stringify.\nfunction sortKeysDeep(value: unknown, seen: WeakSet<object>): unknown {\n    if (Array.isArray(value)) {\n        if (seen.has(value)) {\n            throw new TypeError(CIRCULAR_STRUCTURE_MESSAGE);\n        }\n        seen.add(value);\n        const mapped = value.map((item) => sortKeysDeep(item, seen));\n        seen.delete(value);\n        return mapped;\n    }\n\n    if (value instanceof Date) {\n        return value;\n    }\n\n    if (value && typeof value === \"object\") {\n        if (seen.has(value)) {\n            throw new TypeError(CIRCULAR_STRUCTURE_MESSAGE);\n        }\n        seen.add(value);\n        const record = value as Record<string, unknown>;\n        const ordered = Object.create(null) as Record<string, unknown>;\n\n        for (const key of Object.keys(record).sort()) {\n            ordered[key] = sortKeysDeep(record[key], seen);\n        }\n        seen.delete(value);\n\n        return ordered;\n    }\n\n    return value;\n}\n\n/**\n * Deterministic JSON string with object keys sorted recursively, so key order\n * does not affect the output.\n *\n * Follows `JSON.stringify` semantics for the values it serializes: `undefined`,\n * functions and symbols are dropped, non-finite numbers become `null`, `bigint`\n * throws, and `Map`/`Set` serialize as `{}`. Distinct payloads can therefore\n * collapse to the same string — for collision-resistant hashing use\n * `PolicyHashing.canonicalJson` (policies/utils), which rejects those values\n * up front.\n *\n * @throws {TypeError} On circular references (mirroring `JSON.stringify`).\n */\nfunction stableStringify(value: unknown): string {\n    return JSON.stringify(sortKeysDeep(value, new WeakSet<object>()));\n}\n\nfunction payloadHash(value: unknown): string {\n    return sha256Hex(stableStringify(value));\n}\n\nexport { payloadHash, sha256Hex, stableStringify };\n"],"mappings":";;AAEA,MAAM,6BACF;AAEJ,SAAS,UAAU,OAAuB;CACtC,OAAO,WAAW,QAAQ,EAAE,OAAO,OAAO,MAAM,EAAE,OAAO,KAAK;AAClE;AAIA,SAAS,aAAa,OAAgB,MAAgC;CAClE,IAAI,MAAM,QAAQ,KAAK,GAAG;EACtB,IAAI,KAAK,IAAI,KAAK,GACd,MAAM,IAAI,UAAU,0BAA0B;EAElD,KAAK,IAAI,KAAK;EACd,MAAM,SAAS,MAAM,KAAK,SAAS,aAAa,MAAM,IAAI,CAAC;EAC3D,KAAK,OAAO,KAAK;EACjB,OAAO;CACX;CAEA,IAAI,iBAAiB,MACjB,OAAO;CAGX,IAAI,SAAS,OAAO,UAAU,UAAU;EACpC,IAAI,KAAK,IAAI,KAAK,GACd,MAAM,IAAI,UAAU,0BAA0B;EAElD,KAAK,IAAI,KAAK;EACd,MAAM,SAAS;EACf,MAAM,UAAU,OAAO,OAAO,IAAI;EAElC,KAAK,MAAM,OAAO,OAAO,KAAK,MAAM,EAAE,KAAK,GACvC,QAAQ,OAAO,aAAa,OAAO,MAAM,IAAI;EAEjD,KAAK,OAAO,KAAK;EAEjB,OAAO;CACX;CAEA,OAAO;AACX;;;;;;;;;;;;;;AAeA,SAAS,gBAAgB,OAAwB;CAC7C,OAAO,KAAK,UAAU,aAAa,uBAAO,IAAI,QAAgB,CAAC,CAAC;AACpE;AAEA,SAAS,YAAY,OAAwB;CACzC,OAAO,UAAU,gBAAgB,KAAK,CAAC;AAC3C"}
+{"version":3,"file":"hashing.js","names":[],"sources":["../src/core/shared/hashing.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\n\nimport { stableStringify } from \"./stable-stringify.js\";\n\nfunction sha256Hex(value: string): string {\n    return createHash(\"sha256\").update(value, \"utf8\").digest(\"hex\");\n}\n\nfunction payloadHash(value: unknown): string {\n    return sha256Hex(stableStringify(value));\n}\n\nexport { payloadHash, sha256Hex, stableStringify };\n"],"mappings":";;;AAIA,SAAS,UAAU,OAAuB;CACtC,OAAO,WAAW,QAAQ,EAAE,OAAO,OAAO,MAAM,EAAE,OAAO,KAAK;AAClE;AAEA,SAAS,YAAY,OAAwB;CACzC,OAAO,UAAU,gBAAgB,KAAK,CAAC;AAC3C"}

package/dist/index.cjs

@@ -3,6 +3,7 @@ const require_app_error = require("./app-error.cjs");
 const require_validation_error = require("./validation-error.cjs");
 const require_authorization_error = require("./authorization-error.cjs");
 const require_not_found_error = require("./not-found-error.cjs");
+const require_stable_stringify = require("./stable-stringify.cjs");
 const require_hashing = require("./hashing.cjs");
 const require_unexpected_error = require("./unexpected-error.cjs");
 const require_validation_code = require("./validation-code.cjs");
@@ -29,7 +30,7 @@ const require_domain_event_contracts = require("./domain-event-contracts.cjs");
 const require_outcome = require("./outcome.cjs");
 const require_gate_engine_registry = require("./gate-engine-registry.cjs");
 //#region src/version.ts
-const version$1 = "1.4.0";
+const version$1 = "1.5.0";
 //#endregion
 //#region src/index.ts
 const ERP_CORE_NAME = "erp-core";
@@ -174,7 +175,7 @@ exports.registerNamespacedContextResolversIn = require_policy_service.registerNa
 exports.safePreview = require_validation_error.safePreview;
 exports.serializationErrorCode = require_app_error.serializationErrorCode;
 exports.sha256Hex = require_hashing.sha256Hex;
-exports.stableStringify = require_hashing.stableStringify;
+exports.stableStringify = require_stable_stringify.stableStringify;
 exports.translateUniqueViolationToDuplicate = require_validation_error.translateUniqueViolationToDuplicate;
 exports.version = require_immutable.version;
 

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["version","version"],"sources":["../src/version.ts","../src/index.ts"],"sourcesContent":["// Versao do kit, sincronizada com package.json por scripts/sync-kit-version.mjs.\n// Nao edite a mao: rode `npm run sync-kit-version` (ou e regenerado no release).\n//\n// Mantemos a versao aqui, dentro de src/, para que a copia full-control seja\n// auto-contida: ao copiar so o conteudo de src/, o entry nao depende de um\n// `../package.json` que deixaria de existir no projeto consumidor.\nexport const version = \"1.4.0\";\n","import { version } from \"./version.js\";\n\nexport * from \"./core/index.js\";\n\nexport const ERP_CORE_NAME = \"erp-core\";\nexport const ERP_CORE_VERSION = version;\n\nexport const erpCoreRelease = {\n    name: ERP_CORE_NAME,\n    version: ERP_CORE_VERSION,\n} as const;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,MAAaA,YAAU;;;ACFvB,MAAa,gBAAgB;AAC7B,MAAa,mBAAmBC;AAEhC,MAAa,iBAAiB;CAC1B,MAAM;CACN,SAAS;AACb"}
+{"version":3,"file":"index.cjs","names":["version","version"],"sources":["../src/version.ts","../src/index.ts"],"sourcesContent":["// Versao do kit, sincronizada com package.json por scripts/sync-kit-version.mjs.\n// Nao edite a mao: rode `npm run sync-kit-version` (ou e regenerado no release).\n//\n// Mantemos a versao aqui, dentro de src/, para que a copia full-control seja\n// auto-contida: ao copiar so o conteudo de src/, o entry nao depende de um\n// `../package.json` que deixaria de existir no projeto consumidor.\nexport const version = \"1.5.0\";\n","import { version } from \"./version.js\";\n\nexport * from \"./core/index.js\";\n\nexport const ERP_CORE_NAME = \"erp-core\";\nexport const ERP_CORE_VERSION = version;\n\nexport const erpCoreRelease = {\n    name: ERP_CORE_NAME,\n    version: ERP_CORE_VERSION,\n} as const;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,MAAaA,YAAU;;;ACFvB,MAAa,gBAAgB;AAC7B,MAAa,mBAAmBC;AAEhC,MAAa,iBAAiB;CAC1B,MAAM;CACN,SAAS;AACb"}

package/dist/index.d.cts

@@ -27,10 +27,10 @@ import { a as buildDomainEventContractVersions, i as DomainEventEnvelope, n as D
 
 //#region src/index.d.ts
 declare const ERP_CORE_NAME = "erp-core";
-declare const ERP_CORE_VERSION = "1.4.0";
+declare const ERP_CORE_VERSION = "1.5.0";
 declare const erpCoreRelease: {
   readonly name: "erp-core";
-  readonly version: "1.4.0";
+  readonly version: "1.5.0";
 };
 //#endregion
 export { AbacAttributes, AbacAuthorizer, AbacAuthorizerPort, AbacDecision, AbacPolicySet, AbacRequest, AbacRule, AbacRuleProps, AccessRequest, AlreadyExistsError, AppError, AppErrorOptions, AsOfSource, AuthenticationError, AuthenticationErrorMetadata, AuthenticationErrorReason, AuthorizationError, AuthorizationErrorMetadata, AuthorizationErrorReason, AuthorizationRequirement, AuthorizerPort, BasePlugin, BasePolicyDefinitionProps, BusinessRuleViolationError, BusinessRuleViolationException, CONTRACT_VERSION_PROPERTY, CacheStrategy, CombiningAlgorithm, Command, CommandInput, CommonOutcomeStatus, CompositeAccessRequest, CompositeAuthorizer, ComputeEngineRegistry, ComputeEvaluator, ComputeEvaluatorRegistration, ComputeEvaluatorRegistry, ComputeOutcome, ComputeOutcomeData, ComputePayloadParserRegistry, ComputePayloadParsers, ComputePolicyDefinitionProps, ComputeRegistry, ComputeStatus, ConditionEvaluationCause, ConditionEvaluationOptions, ConditionEvaluationReport, ConditionEvaluationReportLevel, ConditionEvaluationReportTag, ConditionEvaluatorReporter, ConflictError, ConflictErrorMetadata, ConflictKind, ContextResolverCircuitBreakerOptions, ContextResolverRegistry, ContextResolverResilienceOptions, ContextResolverRetryOptions, ContextSeed, ContextSeedValidator, ContextValueResolver, ContractVersion, CoreConfig, CoreConfigOptions, CoreObservabilityConfig, CreateDomainEventEnvelopeInput, CreateTemporalContextInput, CreationRuleset, DeepReadonly, DeriveAsOfOptions, SerializationInError as DeserializationError, SerializationInError, DomainEventContractSelection, DomainEventContractVersions, DomainEventEnvelope, DomainException, DuplicateError, ERP_CORE_NAME, ERP_CORE_VERSION, Entity, EntityNotFoundException, EntityState, Err, ErrorCodes, ErrorSeverity, EvaluateInput, ExpiredError, TemporalErrorMetadata as ExpiredErrorMetadata, TemporalErrorMetadata, TemporalPrecision as ExpiredErrorPrecision, TemporalPrecision, FindCandidatesParams, GateEngineRegistry, GateOutcome, GateOutcomeData, GatePayload, GatePayloadParsers, GatePolicyDefinitionProps, GateStatus, GateTraceLeafSnapshot, GateTraceNodeSnapshot, GateViolationTrace, Grant, GrantProps, IdempotencyError, IdempotencyErrorMetadata, IdempotencyFailureKind, IdempotencyInProgressError, IdempotencyKeyMissingError, IdempotencyPayloadMismatchError, IdempotencyReplayNotSupportedError, InMemoryPolicyDefinitionRepository, IntegrationError, IntegrationErrorMetadata, IntegrationErrorReason, InvalidStateTransitionException, InvalidValueException, InvariantRuleset, InvariantViolationException, InvokeOptions, JsonSafePrimitive, JsonSafeRecord, JsonSafeValue, LegacyIncompatibleError, LogPayload, LoggerPort, MaybePromise, MetricLabels, MetricsPort, MultipleValidationException, NotFoundError, NotYetValidError, Ok, Outcome, Page, Permission, PermissionProps, PermissionSet, PipelineReducer, PluginContract, PluginManager, PolicyAsOfResolver, PolicyCatalog, PolicyCatalogEntryProps, PolicyCatalogFactory, PolicyContext, PolicyContextBuilder, PolicyContextBuilderOptions, PolicyContextPath, PolicyDecision, PolicyDecisionId, PolicyDefinition, PolicyDefinitionId, PolicyDefinitionProps, PolicyDefinitionStatus, PolicyEvaluationError, PolicyEvaluationErrors, PolicyEvaluationInput, PolicyEvaluationOutput, PolicyEvaluationResult, PolicyHashing, PolicyKey, PolicyKind, PolicyOwner, PolicyPackage, PolicyPort, PolicyPortError, PolicyResolver, PolicyScope, PolicyScopeLevel, PolicyScopeMatcher, PolicyService, PolicyServiceOptions, PolicyServiceParams, PolicyViolation, Query, RbacAuthorizer, Repository, RequestedBy, RequestedByKind, Result, ResultRepository, Role, RoleProps, RuleEffect, Ruleset, RulesetId, RulesetRegistry, SchoolId, Scope, ScopeChain, ScopeProps, SerializationBoundary, SerializationCodes, SerializationDirection, SerializationError, SerializationErrorMetadata, SerializationFailureCategory, SerializationMessages, SerializationOutError, TemporalContext, TemporalError, TemporalHistory, TemporalKind, TemporalRepository, TemporalUseCase, TemporalUseCaseInput, TemporalizedContextSeed, TenantId, TraceAttributeValue, TraceSpan, TracerPort, UnexpectedError, UniqueConstraintViolation, UniqueConstraintViolationError, UseCase, UseCaseObservability, UuidIdentifier, ValidationCode, ValidationError, ValidationException, ValidationField, ValidationViolation, ValueObject, ValueObjectPluginContract, ValueObjectRuleset, VersionedComputeEngine, VersionedGateEngine, VersionedTarget, abacContext, asPolicyDecisionId, asPolicyDefinitionId, asSchoolId, asTenantId, assertJsonSafeMetadata, assertTemporalContext, buildDomainEventContractVersions, contextResolverRegistry, coreConfig, createDomainEventEnvelope, createTemporalContext, erpCoreRelease, evaluateTemporalWindow, mapPolicyEvaluationError, payloadHash, rbacContextFields, registerNamespacedContextResolvers, registerNamespacedContextResolversIn, safePreview, serializationErrorCode, sha256Hex, stableStringify, translateUniqueViolationToDuplicate, version };