@xemahq/contracts 0.86.0 → 0.87.0

package/dist/hook/lib/hook-deferral.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-deferral.js","sourceRoot":"","sources":["../../../src/hook/lib/hook-deferral.ts"],"names":[],"mappings":"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"}

package/dist/hook/lib/hook-enums.d.ts

@@ -0,0 +1,121 @@
+import { z } from 'zod';
+import { ActionCatalogKind } from '../../action-catalog';
+export declare enum HookMode {
+    Admit = "admit",
+    Transform = "transform",
+    Defer = "defer"
+}
+export declare const HookModeSchema: z.ZodEnum<typeof HookMode>;
+export declare const HOOK_MODE_ACTION_KINDS: Readonly<Record<HookMode, readonly ActionCatalogKind[]>>;
+export declare enum HookParticipation {
+    Required = "required",
+    Optional = "optional"
+}
+export declare const HookParticipationSchema: z.ZodEnum<typeof HookParticipation>;
+export declare enum HookBindingPermission {
+    Manage = "manage",
+    Observe = "observe",
+    Execute = "execute"
+}
+export declare const HookBindingPermissionSchema: z.ZodEnum<typeof HookBindingPermission>;
+export declare enum HookVerdictKind {
+    Allow = "allow",
+    Deny = "deny",
+    Patch = "patch",
+    Defer = "defer"
+}
+export declare const HookVerdictKindSchema: z.ZodEnum<typeof HookVerdictKind>;
+export declare enum HookPhase {
+    Transform = "transform",
+    Validate = "validate"
+}
+export declare const HookPhaseSchema: z.ZodEnum<typeof HookPhase>;
+export declare const HOOK_MODE_PHASE: Readonly<Record<HookMode, HookPhase>>;
+export declare const HOOK_MODE_VERDICTS: Readonly<Record<HookMode, readonly HookVerdictKind[]>>;
+export declare enum HookFailureCode {
+    Timeout = "timeout",
+    MalformedOutput = "malformed-output",
+    MissingSelectedExecution = "missing-selected-execution",
+    PatchConflict = "patch-conflict",
+    Saturation = "saturation",
+    Recursion = "recursion",
+    Revoked = "revoked",
+    CorrelationMismatch = "correlation-mismatch"
+}
+export declare const HookFailureCodeSchema: z.ZodEnum<typeof HookFailureCode>;
+export declare const HOOK_ALWAYS_FATAL_FAILURES: ReadonlySet<HookFailureCode>;
+export declare enum HookProjectionState {
+    Synced = "synced",
+    Unhydrated = "unhydrated",
+    Stale = "stale",
+    RevisionMismatched = "revision-mismatched",
+    Failed = "failed"
+}
+export declare const HookProjectionStateSchema: z.ZodEnum<typeof HookProjectionState>;
+export declare enum HookOutcomeKind {
+    Proceed = "proceed",
+    Deny = "deny",
+    Defer = "defer",
+    Fail = "fail"
+}
+export declare const HookOutcomeKindSchema: z.ZodEnum<typeof HookOutcomeKind>;
+export declare enum HookPatchOp {
+    Add = "add",
+    Replace = "replace",
+    Remove = "remove"
+}
+export declare const HookPatchOpSchema: z.ZodEnum<typeof HookPatchOp>;
+export declare enum HookBindingRefusalCode {
+    HookPointMismatch = "hook-point-mismatch",
+    ModeNotDeclared = "mode-not-declared",
+    ActionKindIncompatible = "action-kind-incompatible",
+    ParticipationNotAllowed = "participation-not-allowed",
+    ProjectionOutsideDeclaration = "projection-outside-declaration",
+    AmbientExecuteAuthority = "ambient-execute-authority"
+}
+export declare const HookBindingRefusalCodeSchema: z.ZodEnum<typeof HookBindingRefusalCode>;
+export declare enum HookScopeRefusalCode {
+    RequiredBindingSuppressed = "required-binding-suppressed",
+    UnknownBindingSuppressed = "unknown-binding-suppressed"
+}
+export declare const HookScopeRefusalCodeSchema: z.ZodEnum<typeof HookScopeRefusalCode>;
+export declare enum HookDeferralState {
+    Pending = "pending",
+    Resumed = "resumed",
+    Rejected = "rejected",
+    Cancelled = "cancelled",
+    Expired = "expired"
+}
+export declare const HookDeferralStateSchema: z.ZodEnum<typeof HookDeferralState>;
+export declare enum HookDecisionOutcome {
+    Approved = "approved",
+    Rejected = "rejected"
+}
+export declare const HookDecisionOutcomeSchema: z.ZodEnum<typeof HookDecisionOutcome>;
+export declare enum HookDeferralEventKind {
+    Settled = "settled",
+    Cancelled = "cancelled",
+    Expired = "expired"
+}
+export declare const HookDeferralEventKindSchema: z.ZodEnum<typeof HookDeferralEventKind>;
+export declare enum HookDeferralEffect {
+    Resume = "resume",
+    None = "none",
+    Reject = "reject",
+    RefuseUnknownRequirement = "refuse-unknown-requirement",
+    RefuseChangedCandidate = "refuse-changed-candidate"
+}
+export declare const HookDeferralEffectSchema: z.ZodEnum<typeof HookDeferralEffect>;
+export declare enum HookBindingChangeKind {
+    BindingUpserted = "binding-upserted",
+    BindingRemoved = "binding-removed",
+    SuppressionAdded = "suppression-added",
+    SuppressionRemoved = "suppression-removed"
+}
+export declare const HookBindingChangeKindSchema: z.ZodEnum<typeof HookBindingChangeKind>;
+export declare enum HookBindingFeedPageKind {
+    Changes = "changes",
+    ResyncRequired = "resync-required"
+}
+export declare const HookBindingFeedPageKindSchema: z.ZodEnum<typeof HookBindingFeedPageKind>;
+//# sourceMappingURL=hook-enums.d.ts.map

package/dist/hook/lib/hook-enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-enums.d.ts","sourceRoot":"","sources":["../../../src/hook/lib/hook-enums.ts"],"names":[],"mappings":"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"}

package/dist/hook/lib/hook-enums.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HookBindingFeedPageKindSchema = exports.HookBindingFeedPageKind = exports.HookBindingChangeKindSchema = exports.HookBindingChangeKind = exports.HookDeferralEffectSchema = exports.HookDeferralEffect = exports.HookDeferralEventKindSchema = exports.HookDeferralEventKind = exports.HookDecisionOutcomeSchema = exports.HookDecisionOutcome = exports.HookDeferralStateSchema = exports.HookDeferralState = exports.HookScopeRefusalCodeSchema = exports.HookScopeRefusalCode = exports.HookBindingRefusalCodeSchema = exports.HookBindingRefusalCode = exports.HookPatchOpSchema = exports.HookPatchOp = exports.HookOutcomeKindSchema = exports.HookOutcomeKind = exports.HookProjectionStateSchema = exports.HookProjectionState = exports.HOOK_ALWAYS_FATAL_FAILURES = exports.HookFailureCodeSchema = exports.HookFailureCode = exports.HOOK_MODE_VERDICTS = exports.HOOK_MODE_PHASE = exports.HookPhaseSchema = exports.HookPhase = exports.HookVerdictKindSchema = exports.HookVerdictKind = exports.HookBindingPermissionSchema = exports.HookBindingPermission = exports.HookParticipationSchema = exports.HookParticipation = exports.HOOK_MODE_ACTION_KINDS = exports.HookModeSchema = exports.HookMode = void 0;
+const zod_1 = require("zod");
+const action_catalog_1 = require("../../action-catalog");
+var HookMode;
+(function (HookMode) {
+    HookMode["Admit"] = "admit";
+    HookMode["Transform"] = "transform";
+    HookMode["Defer"] = "defer";
+})(HookMode || (exports.HookMode = HookMode = {}));
+exports.HookModeSchema = zod_1.z.nativeEnum(HookMode);
+exports.HOOK_MODE_ACTION_KINDS = Object.freeze({
+    [HookMode.Admit]: Object.freeze([
+        action_catalog_1.ActionCatalogKind.Capability,
+        action_catalog_1.ActionCatalogKind.Function,
+    ]),
+    [HookMode.Transform]: Object.freeze([
+        action_catalog_1.ActionCatalogKind.Capability,
+        action_catalog_1.ActionCatalogKind.Function,
+    ]),
+    [HookMode.Defer]: Object.freeze([
+        action_catalog_1.ActionCatalogKind.Capability,
+        action_catalog_1.ActionCatalogKind.Function,
+    ]),
+});
+var HookParticipation;
+(function (HookParticipation) {
+    HookParticipation["Required"] = "required";
+    HookParticipation["Optional"] = "optional";
+})(HookParticipation || (exports.HookParticipation = HookParticipation = {}));
+exports.HookParticipationSchema = zod_1.z.nativeEnum(HookParticipation);
+var HookBindingPermission;
+(function (HookBindingPermission) {
+    HookBindingPermission["Manage"] = "manage";
+    HookBindingPermission["Observe"] = "observe";
+    HookBindingPermission["Execute"] = "execute";
+})(HookBindingPermission || (exports.HookBindingPermission = HookBindingPermission = {}));
+exports.HookBindingPermissionSchema = zod_1.z.nativeEnum(HookBindingPermission);
+var HookVerdictKind;
+(function (HookVerdictKind) {
+    HookVerdictKind["Allow"] = "allow";
+    HookVerdictKind["Deny"] = "deny";
+    HookVerdictKind["Patch"] = "patch";
+    HookVerdictKind["Defer"] = "defer";
+})(HookVerdictKind || (exports.HookVerdictKind = HookVerdictKind = {}));
+exports.HookVerdictKindSchema = zod_1.z.nativeEnum(HookVerdictKind);
+var HookPhase;
+(function (HookPhase) {
+    HookPhase["Transform"] = "transform";
+    HookPhase["Validate"] = "validate";
+})(HookPhase || (exports.HookPhase = HookPhase = {}));
+exports.HookPhaseSchema = zod_1.z.nativeEnum(HookPhase);
+exports.HOOK_MODE_PHASE = Object.freeze({
+    [HookMode.Transform]: HookPhase.Transform,
+    [HookMode.Admit]: HookPhase.Validate,
+    [HookMode.Defer]: HookPhase.Validate,
+});
+exports.HOOK_MODE_VERDICTS = Object.freeze({
+    [HookMode.Admit]: Object.freeze([HookVerdictKind.Allow, HookVerdictKind.Deny]),
+    [HookMode.Transform]: Object.freeze([
+        HookVerdictKind.Allow,
+        HookVerdictKind.Patch,
+    ]),
+    [HookMode.Defer]: Object.freeze([HookVerdictKind.Allow, HookVerdictKind.Defer]),
+});
+var HookFailureCode;
+(function (HookFailureCode) {
+    HookFailureCode["Timeout"] = "timeout";
+    HookFailureCode["MalformedOutput"] = "malformed-output";
+    HookFailureCode["MissingSelectedExecution"] = "missing-selected-execution";
+    HookFailureCode["PatchConflict"] = "patch-conflict";
+    HookFailureCode["Saturation"] = "saturation";
+    HookFailureCode["Recursion"] = "recursion";
+    HookFailureCode["Revoked"] = "revoked";
+    HookFailureCode["CorrelationMismatch"] = "correlation-mismatch";
+})(HookFailureCode || (exports.HookFailureCode = HookFailureCode = {}));
+exports.HookFailureCodeSchema = zod_1.z.nativeEnum(HookFailureCode);
+exports.HOOK_ALWAYS_FATAL_FAILURES = Object.freeze(new Set([HookFailureCode.PatchConflict, HookFailureCode.Recursion]));
+var HookProjectionState;
+(function (HookProjectionState) {
+    HookProjectionState["Synced"] = "synced";
+    HookProjectionState["Unhydrated"] = "unhydrated";
+    HookProjectionState["Stale"] = "stale";
+    HookProjectionState["RevisionMismatched"] = "revision-mismatched";
+    HookProjectionState["Failed"] = "failed";
+})(HookProjectionState || (exports.HookProjectionState = HookProjectionState = {}));
+exports.HookProjectionStateSchema = zod_1.z.nativeEnum(HookProjectionState);
+var HookOutcomeKind;
+(function (HookOutcomeKind) {
+    HookOutcomeKind["Proceed"] = "proceed";
+    HookOutcomeKind["Deny"] = "deny";
+    HookOutcomeKind["Defer"] = "defer";
+    HookOutcomeKind["Fail"] = "fail";
+})(HookOutcomeKind || (exports.HookOutcomeKind = HookOutcomeKind = {}));
+exports.HookOutcomeKindSchema = zod_1.z.nativeEnum(HookOutcomeKind);
+var HookPatchOp;
+(function (HookPatchOp) {
+    HookPatchOp["Add"] = "add";
+    HookPatchOp["Replace"] = "replace";
+    HookPatchOp["Remove"] = "remove";
+})(HookPatchOp || (exports.HookPatchOp = HookPatchOp = {}));
+exports.HookPatchOpSchema = zod_1.z.nativeEnum(HookPatchOp);
+var HookBindingRefusalCode;
+(function (HookBindingRefusalCode) {
+    HookBindingRefusalCode["HookPointMismatch"] = "hook-point-mismatch";
+    HookBindingRefusalCode["ModeNotDeclared"] = "mode-not-declared";
+    HookBindingRefusalCode["ActionKindIncompatible"] = "action-kind-incompatible";
+    HookBindingRefusalCode["ParticipationNotAllowed"] = "participation-not-allowed";
+    HookBindingRefusalCode["ProjectionOutsideDeclaration"] = "projection-outside-declaration";
+    HookBindingRefusalCode["AmbientExecuteAuthority"] = "ambient-execute-authority";
+})(HookBindingRefusalCode || (exports.HookBindingRefusalCode = HookBindingRefusalCode = {}));
+exports.HookBindingRefusalCodeSchema = zod_1.z.nativeEnum(HookBindingRefusalCode);
+var HookScopeRefusalCode;
+(function (HookScopeRefusalCode) {
+    HookScopeRefusalCode["RequiredBindingSuppressed"] = "required-binding-suppressed";
+    HookScopeRefusalCode["UnknownBindingSuppressed"] = "unknown-binding-suppressed";
+})(HookScopeRefusalCode || (exports.HookScopeRefusalCode = HookScopeRefusalCode = {}));
+exports.HookScopeRefusalCodeSchema = zod_1.z.nativeEnum(HookScopeRefusalCode);
+var HookDeferralState;
+(function (HookDeferralState) {
+    HookDeferralState["Pending"] = "pending";
+    HookDeferralState["Resumed"] = "resumed";
+    HookDeferralState["Rejected"] = "rejected";
+    HookDeferralState["Cancelled"] = "cancelled";
+    HookDeferralState["Expired"] = "expired";
+})(HookDeferralState || (exports.HookDeferralState = HookDeferralState = {}));
+exports.HookDeferralStateSchema = zod_1.z.nativeEnum(HookDeferralState);
+var HookDecisionOutcome;
+(function (HookDecisionOutcome) {
+    HookDecisionOutcome["Approved"] = "approved";
+    HookDecisionOutcome["Rejected"] = "rejected";
+})(HookDecisionOutcome || (exports.HookDecisionOutcome = HookDecisionOutcome = {}));
+exports.HookDecisionOutcomeSchema = zod_1.z.nativeEnum(HookDecisionOutcome);
+var HookDeferralEventKind;
+(function (HookDeferralEventKind) {
+    HookDeferralEventKind["Settled"] = "settled";
+    HookDeferralEventKind["Cancelled"] = "cancelled";
+    HookDeferralEventKind["Expired"] = "expired";
+})(HookDeferralEventKind || (exports.HookDeferralEventKind = HookDeferralEventKind = {}));
+exports.HookDeferralEventKindSchema = zod_1.z.nativeEnum(HookDeferralEventKind);
+var HookDeferralEffect;
+(function (HookDeferralEffect) {
+    HookDeferralEffect["Resume"] = "resume";
+    HookDeferralEffect["None"] = "none";
+    HookDeferralEffect["Reject"] = "reject";
+    HookDeferralEffect["RefuseUnknownRequirement"] = "refuse-unknown-requirement";
+    HookDeferralEffect["RefuseChangedCandidate"] = "refuse-changed-candidate";
+})(HookDeferralEffect || (exports.HookDeferralEffect = HookDeferralEffect = {}));
+exports.HookDeferralEffectSchema = zod_1.z.nativeEnum(HookDeferralEffect);
+var HookBindingChangeKind;
+(function (HookBindingChangeKind) {
+    HookBindingChangeKind["BindingUpserted"] = "binding-upserted";
+    HookBindingChangeKind["BindingRemoved"] = "binding-removed";
+    HookBindingChangeKind["SuppressionAdded"] = "suppression-added";
+    HookBindingChangeKind["SuppressionRemoved"] = "suppression-removed";
+})(HookBindingChangeKind || (exports.HookBindingChangeKind = HookBindingChangeKind = {}));
+exports.HookBindingChangeKindSchema = zod_1.z.nativeEnum(HookBindingChangeKind);
+var HookBindingFeedPageKind;
+(function (HookBindingFeedPageKind) {
+    HookBindingFeedPageKind["Changes"] = "changes";
+    HookBindingFeedPageKind["ResyncRequired"] = "resync-required";
+})(HookBindingFeedPageKind || (exports.HookBindingFeedPageKind = HookBindingFeedPageKind = {}));
+exports.HookBindingFeedPageKindSchema = zod_1.z.nativeEnum(HookBindingFeedPageKind);
+//# sourceMappingURL=hook-enums.js.map

package/dist/hook/lib/hook-enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-enums.js","sourceRoot":"","sources":["../../../src/hook/lib/hook-enums.ts"],"names":[],"mappings":"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"}

package/dist/hook/lib/hook-handler-request.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import { HookMode, type HookPhase } from './hook-enums';
+import { type HookRequestCorrelation } from './hook-verdict';
+export interface HookHandlerRequest {
+    readonly hookPointId: string;
+    readonly operation: string;
+    readonly phase: HookPhase;
+    readonly mode: HookMode;
+    readonly correlation: HookRequestCorrelation;
+    readonly projection: Readonly<Record<string, unknown>>;
+    readonly writableFields: readonly string[];
+    readonly synchronousChain: readonly string[];
+}
+export declare const HookHandlerRequestSchema: z.ZodType<HookHandlerRequest>;
+//# sourceMappingURL=hook-handler-request.d.ts.map

package/dist/hook/lib/hook-handler-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-handler-request.d.ts","sourceRoot":"","sources":["../../../src/hook/lib/hook-handler-request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAEL,QAAQ,EAGR,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAgC,KAAK,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAa3F,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAC;IAE7C,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAEvD,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAK3C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AAED,eAAO,MAAM,wBAAwB,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CA2BnB,CAAC"}

package/dist/hook/lib/hook-handler-request.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HookHandlerRequestSchema = void 0;
+const zod_1 = require("zod");
+const hook_enums_1 = require("./hook-enums");
+const hook_identifiers_1 = require("./hook-identifiers");
+const hook_verdict_1 = require("./hook-verdict");
+exports.HookHandlerRequestSchema = zod_1.z
+    .object({
+    hookPointId: hook_identifiers_1.HookPointIdSchema,
+    operation: hook_identifiers_1.HookOperationIdSchema,
+    phase: hook_enums_1.HookPhaseSchema,
+    mode: hook_enums_1.HookModeSchema,
+    correlation: hook_verdict_1.HookRequestCorrelationSchema,
+    projection: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).readonly(),
+    writableFields: zod_1.z.array(hook_identifiers_1.HookFieldPointerSchema).readonly(),
+    synchronousChain: zod_1.z.array(hook_identifiers_1.HookPointIdSchema).readonly(),
+})
+    .strict()
+    .superRefine((request, context) => {
+    if (hook_enums_1.HOOK_MODE_PHASE[request.mode] !== request.phase) {
+        context.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: ['phase'],
+            message: `Mode \`${request.mode}\` runs in the \`${hook_enums_1.HOOK_MODE_PHASE[request.mode]}\` phase.`,
+        });
+    }
+    if (request.mode !== hook_enums_1.HookMode.Transform && request.writableFields.length > 0) {
+        context.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: ['writableFields'],
+            message: 'Writable fields exist only in transform mode.',
+        });
+    }
+});
+//# sourceMappingURL=hook-handler-request.js.map

package/dist/hook/lib/hook-handler-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-handler-request.js","sourceRoot":"","sources":["../../../src/hook/lib/hook-handler-request.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,6CAMsB;AACtB,yDAAsG;AACtG,iDAA2F;AA8B9E,QAAA,wBAAwB,GAAkC,OAAC;KACrE,MAAM,CAAC;IACN,WAAW,EAAE,oCAAiB;IAC9B,SAAS,EAAE,wCAAqB;IAChC,KAAK,EAAE,4BAAe;IACtB,IAAI,EAAE,2BAAc;IACpB,WAAW,EAAE,2CAA4B;IACzC,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxD,cAAc,EAAE,OAAC,CAAC,KAAK,CAAC,yCAAsB,CAAC,CAAC,QAAQ,EAAE;IAC1D,gBAAgB,EAAE,OAAC,CAAC,KAAK,CAAC,oCAAiB,CAAC,CAAC,QAAQ,EAAE;CACxD,CAAC;KACD,MAAM,EAAE;KACR,WAAW,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;IAChC,IAAI,4BAAe,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC;QACpD,OAAO,CAAC,QAAQ,CAAC;YACf,IAAI,EAAE,OAAC,CAAC,YAAY,CAAC,MAAM;YAC3B,IAAI,EAAE,CAAC,OAAO,CAAC;YACf,OAAO,EAAE,UAAU,OAAO,CAAC,IAAI,oBAAoB,4BAAe,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW;SAC5F,CAAC,CAAC;IACL,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,qBAAQ,CAAC,SAAS,IAAI,OAAO,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7E,OAAO,CAAC,QAAQ,CAAC;YACf,IAAI,EAAE,OAAC,CAAC,YAAY,CAAC,MAAM;YAC3B,IAAI,EAAE,CAAC,gBAAgB,CAAC;YACxB,OAAO,EAAE,+CAA+C;SACzD,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAA6C,CAAC"}

package/dist/hook/lib/hook-identifiers.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+export declare const HOOK_IDENTIFIER_PATTERN: RegExp;
+export declare const HookPointIdSchema: z.ZodString;
+export declare const HookOperationIdSchema: z.ZodString;
+export declare const HookRecordIdSchema: z.ZodString;
+export declare const HookRevisionSchema: z.ZodNumber;
+export declare const HOOK_FORBIDDEN_POINTER_TOKENS: ReadonlySet<string>;
+export declare function parseHookFieldPointer(pointer: string): readonly string[];
+export declare const HookFieldPointerSchema: z.ZodString;
+export declare function isHookFieldPointerWithin(pointer: string, prefix: string): boolean;
+export declare function hookFieldPointersOverlap(a: string, b: string): boolean;
+//# sourceMappingURL=hook-identifiers.d.ts.map

package/dist/hook/lib/hook-identifiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-identifiers.d.ts","sourceRoot":"","sources":["../../../src/hook/lib/hook-identifiers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,eAAO,MAAM,uBAAuB,QAA4C,CAAC;AAEjF,eAAO,MAAM,iBAAiB,aAIG,CAAC;AAElC,eAAO,MAAM,qBAAqB,aAAoB,CAAC;AAGvD,eAAO,MAAM,kBAAkB,aAIY,CAAC;AAG5C,eAAO,MAAM,kBAAkB,aAA0B,CAAC;AAO1D,eAAO,MAAM,6BAA6B,EAAE,WAAW,CAAC,MAAM,CAE7D,CAAC;AAOF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAsBxE;AAeD,eAAO,MAAM,sBAAsB,aAIyC,CAAC;AAG7E,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAKT;AAGD,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAEtE"}

package/dist/hook/lib/hook-identifiers.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HookFieldPointerSchema = exports.HOOK_FORBIDDEN_POINTER_TOKENS = exports.HookRevisionSchema = exports.HookRecordIdSchema = exports.HookOperationIdSchema = exports.HookPointIdSchema = exports.HOOK_IDENTIFIER_PATTERN = void 0;
+exports.parseHookFieldPointer = parseHookFieldPointer;
+exports.isHookFieldPointerWithin = isHookFieldPointerWithin;
+exports.hookFieldPointersOverlap = hookFieldPointersOverlap;
+const zod_1 = require("zod");
+exports.HOOK_IDENTIFIER_PATTERN = /^[a-z][a-z0-9-]*(?:\.[a-z][a-z0-9-]*)*$/;
+exports.HookPointIdSchema = zod_1.z
+    .string()
+    .min(1)
+    .max(200)
+    .regex(exports.HOOK_IDENTIFIER_PATTERN);
+exports.HookOperationIdSchema = exports.HookPointIdSchema;
+exports.HookRecordIdSchema = zod_1.z
+    .string()
+    .min(1)
+    .max(512)
+    .regex(/^[A-Za-z0-9][A-Za-z0-9._:@/-]*$/);
+exports.HookRevisionSchema = zod_1.z.number().int().min(1);
+exports.HOOK_FORBIDDEN_POINTER_TOKENS = Object.freeze(new Set(['__proto__', 'constructor', 'prototype']));
+function parseHookFieldPointer(pointer) {
+    if (pointer === '')
+        return [];
+    if (!pointer.startsWith('/')) {
+        throw new TypeError(`JSON Pointer "${pointer}" must start with "/".`);
+    }
+    return pointer
+        .slice(1)
+        .split('/')
+        .map((token) => {
+        if (/~(?![01])/.test(token)) {
+            throw new TypeError(`JSON Pointer "${pointer}" has an invalid "~" escape in "${token}".`);
+        }
+        const decoded = token.replace(/~1/g, '/').replace(/~0/g, '~');
+        if (exports.HOOK_FORBIDDEN_POINTER_TOKENS.has(decoded)) {
+            throw new TypeError(`JSON Pointer "${pointer}" names the forbidden token "${decoded}".`);
+        }
+        return decoded;
+    });
+}
+function isValidPointer(pointer) {
+    try {
+        parseHookFieldPointer(pointer);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+exports.HookFieldPointerSchema = zod_1.z
+    .string()
+    .min(2)
+    .max(1024)
+    .refine(isValidPointer, { message: 'Not a valid RFC 6901 JSON Pointer.' });
+function isHookFieldPointerWithin(pointer, prefix) {
+    const tokens = parseHookFieldPointer(pointer);
+    const prefixTokens = parseHookFieldPointer(prefix);
+    if (prefixTokens.length > tokens.length)
+        return false;
+    return prefixTokens.every((token, index) => tokens[index] === token);
+}
+function hookFieldPointersOverlap(a, b) {
+    return isHookFieldPointerWithin(a, b) || isHookFieldPointerWithin(b, a);
+}
+//# sourceMappingURL=hook-identifiers.js.map

package/dist/hook/lib/hook-identifiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-identifiers.js","sourceRoot":"","sources":["../../../src/hook/lib/hook-identifiers.ts"],"names":[],"mappings":";;;AAgDA,sDAsBC;AAsBD,4DAQC;AAGD,4DAEC;AAzGD,6BAAwB;AAcX,QAAA,uBAAuB,GAAG,yCAAyC,CAAC;AAEpE,QAAA,iBAAiB,GAAG,OAAC;KAC/B,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,GAAG,CAAC;KACR,KAAK,CAAC,+BAAuB,CAAC,CAAC;AAErB,QAAA,qBAAqB,GAAG,yBAAiB,CAAC;AAG1C,QAAA,kBAAkB,GAAG,OAAC;KAChC,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,GAAG,CAAC;KACR,KAAK,CAAC,iCAAiC,CAAC,CAAC;AAG/B,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAO7C,QAAA,6BAA6B,GAAwB,MAAM,CAAC,MAAM,CAC7E,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC,CACnD,CAAC;AAOF,SAAgB,qBAAqB,CAAC,OAAe;IACnD,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,SAAS,CAAC,iBAAiB,OAAO,wBAAwB,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,OAAO;SACX,KAAK,CAAC,CAAC,CAAC;SACR,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,SAAS,CACjB,iBAAiB,OAAO,mCAAmC,KAAK,IAAI,CACrE,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC9D,IAAI,qCAA6B,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,SAAS,CACjB,iBAAiB,OAAO,gCAAgC,OAAO,IAAI,CACpE,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,cAAc,CAAC,OAAe;IACrC,IAAI,CAAC;QACH,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAMY,QAAA,sBAAsB,GAAG,OAAC;KACpC,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,IAAI,CAAC;KACT,MAAM,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC,CAAC;AAG7E,SAAgB,wBAAwB,CACtC,OAAe,EACf,MAAc;IAEd,MAAM,MAAM,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,YAAY,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACnD,IAAI,YAAY,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACtD,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,CAAC;AACvE,CAAC;AAGD,SAAgB,wBAAwB,CAAC,CAAS,EAAE,CAAS;IAC3D,OAAO,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1E,CAAC"}

package/dist/hook/lib/hook-patch.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { HookPatchOp } from './hook-enums';
+export type HookPatchOperation = {
+    readonly op: HookPatchOp.Add | HookPatchOp.Replace;
+    readonly path: string;
+    readonly value: unknown;
+} | {
+    readonly op: HookPatchOp.Remove;
+    readonly path: string;
+};
+export declare const HookPatchOperationSchema: z.ZodType<HookPatchOperation>;
+export declare function hookPatchOperationsConflict(document: unknown, a: HookPatchOperation, b: HookPatchOperation): boolean;
+export declare enum HookPatchRefusal {
+    OutsideWritable = "outside-writable",
+    Unresolvable = "unresolvable",
+    SelfConflict = "self-conflict"
+}
+export declare function checkHookPatch(document: unknown, operations: readonly HookPatchOperation[], writableFields: readonly string[]): HookPatchRefusal | null;
+export declare function applyHookPatch(document: unknown, operations: readonly HookPatchOperation[]): unknown;
+//# sourceMappingURL=hook-patch.d.ts.map

package/dist/hook/lib/hook-patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-patch.d.ts","sourceRoot":"","sources":["../../../src/hook/lib/hook-patch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAqB,MAAM,cAAc,CAAC;AA0B9D,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACtG;IAAE,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,eAAO,MAAM,wBAAwB,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAmBnB,CAAC;AAiEjD,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,OAAO,EACjB,CAAC,EAAE,kBAAkB,EACrB,CAAC,EAAE,kBAAkB,GACpB,OAAO,CAMT;AAOD,oBAAY,gBAAgB;IAC1B,eAAe,qBAAqB;IACpC,YAAY,iBAAiB;IAC7B,YAAY,kBAAkB;CAC/B;AAGD,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,OAAO,EACjB,UAAU,EAAE,SAAS,kBAAkB,EAAE,EACzC,cAAc,EAAE,SAAS,MAAM,EAAE,GAChC,gBAAgB,GAAG,IAAI,CAmBzB;AAQD,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,OAAO,EACjB,UAAU,EAAE,SAAS,kBAAkB,EAAE,GACxC,OAAO,CAqCT"}

package/dist/hook/lib/hook-patch.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HookPatchRefusal = exports.HookPatchOperationSchema = void 0;
+exports.hookPatchOperationsConflict = hookPatchOperationsConflict;
+exports.checkHookPatch = checkHookPatch;
+exports.applyHookPatch = applyHookPatch;
+const zod_1 = require("zod");
+const hook_enums_1 = require("./hook-enums");
+const hook_identifiers_1 = require("./hook-identifiers");
+exports.HookPatchOperationSchema = zod_1.z
+    .object({
+    op: hook_enums_1.HookPatchOpSchema,
+    path: hook_identifiers_1.HookFieldPointerSchema,
+    value: zod_1.z.unknown().optional(),
+})
+    .strict()
+    .superRefine((operation, context) => {
+    const hasValue = Object.prototype.hasOwnProperty.call(operation, 'value');
+    if ((operation.op === hook_enums_1.HookPatchOp.Remove) === hasValue) {
+        context.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: ['value'],
+            message: operation.op === hook_enums_1.HookPatchOp.Remove
+                ? '`remove` carries no value.'
+                : `\`${operation.op}\` requires a value.`,
+        });
+    }
+});
+const isContainer = (value) => typeof value === 'object' && value !== null;
+function resolveParent(document, tokens) {
+    let current = document;
+    for (const token of tokens.slice(0, -1)) {
+        if (Array.isArray(current)) {
+            if (!/^(0|[1-9][0-9]*)$/.test(token))
+                return undefined;
+            current = current[Number(token)];
+        }
+        else if (isContainer(current)) {
+            if (!Object.prototype.hasOwnProperty.call(current, token))
+                return undefined;
+            current = current[token];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return isContainer(current) ? current : undefined;
+}
+const ARRAY_INDEX = /^(0|[1-9][0-9]*)$/;
+const shiftsIndices = (operation) => operation.op !== hook_enums_1.HookPatchOp.Replace;
+const positionOf = (token) => token === '-' ? Number.POSITIVE_INFINITY : ARRAY_INDEX.test(token) ? Number(token) : Number.NaN;
+function shiftsAcross(document, shifter, other) {
+    if (!shiftsIndices(shifter))
+        return false;
+    const tokens = (0, hook_identifiers_1.parseHookFieldPointer)(shifter.path);
+    if (!Array.isArray(resolveParent(document, tokens)))
+        return false;
+    const arrayDepth = tokens.length - 1;
+    const otherTokens = (0, hook_identifiers_1.parseHookFieldPointer)(other.path);
+    if (otherTokens.length <= arrayDepth)
+        return false;
+    if (!tokens.slice(0, arrayDepth).every((token, index) => otherTokens[index] === token)) {
+        return false;
+    }
+    if (otherTokens.length === arrayDepth + 1 && shiftsIndices(other))
+        return true;
+    const shifted = positionOf(tokens[arrayDepth]);
+    const touched = positionOf(otherTokens[arrayDepth]);
+    return Number.isNaN(shifted) || Number.isNaN(touched) || touched >= shifted;
+}
+function hookPatchOperationsConflict(document, a, b) {
+    return ((0, hook_identifiers_1.hookFieldPointersOverlap)(a.path, b.path) ||
+        shiftsAcross(document, a, b) ||
+        shiftsAcross(document, b, a));
+}
+var HookPatchRefusal;
+(function (HookPatchRefusal) {
+    HookPatchRefusal["OutsideWritable"] = "outside-writable";
+    HookPatchRefusal["Unresolvable"] = "unresolvable";
+    HookPatchRefusal["SelfConflict"] = "self-conflict";
+})(HookPatchRefusal || (exports.HookPatchRefusal = HookPatchRefusal = {}));
+function checkHookPatch(document, operations, writableFields) {
+    for (const operation of operations) {
+        if (!writableFields.some((field) => (0, hook_identifiers_1.isHookFieldPointerWithin)(operation.path, field))) {
+            return HookPatchRefusal.OutsideWritable;
+        }
+    }
+    for (let i = 0; i < operations.length; i += 1) {
+        for (let j = i + 1; j < operations.length; j += 1) {
+            if (hookPatchOperationsConflict(document, operations[i], operations[j])) {
+                return HookPatchRefusal.SelfConflict;
+            }
+        }
+    }
+    try {
+        applyHookPatch(document, operations);
+    }
+    catch {
+        return HookPatchRefusal.Unresolvable;
+    }
+    return null;
+}
+function applyHookPatch(document, operations) {
+    const result = structuredClone(document);
+    for (const operation of operations) {
+        const tokens = (0, hook_identifiers_1.parseHookFieldPointer)(operation.path);
+        const key = tokens[tokens.length - 1];
+        const parent = resolveParent(result, tokens);
+        if (parent === undefined) {
+            throw new TypeError(`Patch path "${operation.path}" has no parent container.`);
+        }
+        if (Array.isArray(parent)) {
+            const index = key === '-' ? parent.length : Number(key);
+            const indexable = /^(0|[1-9][0-9]*)$/.test(key) || key === '-';
+            const bound = operation.op === hook_enums_1.HookPatchOp.Add ? parent.length : parent.length - 1;
+            if (!indexable || index > bound || (key === '-' && operation.op !== hook_enums_1.HookPatchOp.Add)) {
+                throw new TypeError(`Patch path "${operation.path}" is not a valid array index.`);
+            }
+            if (operation.op === hook_enums_1.HookPatchOp.Add)
+                parent.splice(index, 0, structuredClone(operation.value));
+            else if (operation.op === hook_enums_1.HookPatchOp.Replace)
+                parent[index] = structuredClone(operation.value);
+            else
+                parent.splice(index, 1);
+        }
+        else {
+            const exists = Object.prototype.hasOwnProperty.call(parent, key);
+            if (operation.op !== hook_enums_1.HookPatchOp.Add && !exists) {
+                throw new TypeError(`Patch path "${operation.path}" does not exist.`);
+            }
+            if (operation.op === hook_enums_1.HookPatchOp.Remove)
+                delete parent[key];
+            else {
+                Object.defineProperty(parent, key, {
+                    value: structuredClone(operation.value),
+                    writable: true,
+                    enumerable: true,
+                    configurable: true,
+                });
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=hook-patch.js.map