@kaleido-io/workflow-engine-sdk 0.0.1 → 0.9.2

package/dist/src/types/core.d.ts

@@ -0,0 +1,258 @@
+/**
+ * Core types and enums for the Workflow Engine TypeScript SDK.
+ */
+export declare enum EvalResult {
+    FIXABLE_ERROR = 0,
+    TRANSIENT_ERROR = 1,
+    HARD_FAILURE = 2,
+    COMPLETE = 3,
+    WAITING = 4
+}
+export declare enum InvocationMode {
+    PARALLEL = 0,
+    BATCH = 1
+}
+export declare enum WSMessageType {
+    PROTOCOL_ERROR = "protocol_error",
+    REGISTER_PROVIDER = "register_provider",
+    REGISTER_HANDLER = "register_handler",
+    EVALUATE = "evaluate",
+    EVALUATE_RESULT = "evaluate_result",
+    HANDLE_TRANSACTIONS = "handle_transactions",
+    HANDLE_TRANSACTIONS_RESULT = "handle_transactions_result",
+    EVENT_SOURCE_CONFIG = "event_source_config",
+    EVENT_SOURCE_POLL = "event_source_poll",
+    EVENT_SOURCE_POLL_RESULT = "event_source_poll_result",
+    EVENT_SOURCE_VALIDATE_CONFIG = "event_source_validate_config",
+    EVENT_SOURCE_VALIDATE_CONFIG_RESULT = "event_source_validate_config_result",
+    EVENT_SOURCE_DELETE = "event_source_delete",
+    EVENT_SOURCE_DELETE_RESULT = "event_source_delete_result",
+    EVENT_PROCESSOR_BATCH = "event_processor_batch",
+    EVENT_PROCESSOR_BATCH_RESULT = "event_processor_batch_result",
+    ENGINE_API_SUBMIT_TRANSACTIONS = "engineapi_submit_transactions",
+    ENGINE_API_SUBMIT_TRANSACTIONS_RESULT = "engineapi_submit_transactions_result"
+}
+export declare enum WSHandlerType {
+    TRANSACTION_HANDLER = "transaction_handler",
+    EVENT_PROCESSOR = "event_processor",
+    EVENT_SOURCE = "event_source"
+}
+export declare enum PatchOpType {
+    ADD = "add",
+    REMOVE = "remove",
+    REPLACE = "replace",
+    MOVE = "move",
+    COPY = "copy",
+    TEST = "test"
+}
+/**
+ * StageDirector controls action routing and output mapping
+ */
+export interface StageDirector {
+    action: string;
+    outputPath: string;
+    nextStage: string;
+    failureStage: string;
+}
+/**
+ * Interface for types that can provide a StageDirector
+ */
+export interface WithStageDirector {
+    getStageDirector(): StageDirector;
+}
+/**
+ * JSON Patch operation following RFC6902
+ */
+export interface PatchOp {
+    op: PatchOpType;
+    path: string;
+    from?: string;
+    value?: any;
+}
+export type Patch = PatchOp[];
+/**
+ * Event trigger for flow correlation
+ */
+export interface Trigger {
+    topic: string;
+    ephemeral?: boolean;
+}
+/**
+ * Event emitted by a handler
+ */
+export interface HandlerEvent {
+    idempotencyKey?: string;
+    topic: string;
+    data: any;
+}
+/**
+ * Flow runtime state information
+ */
+export interface FlowRuntimeState {
+    handler: string;
+    workflowId: string;
+    transactionId: string;
+    sequence: string;
+    idempotencyKey?: string;
+    stackDepth?: number;
+    identity?: string;
+    identityContext?: any;
+    stage: string;
+    state?: any;
+    queueReduce?: any;
+}
+/**
+ * Event attached to a transaction
+ */
+export interface WSEvaluateTransactionEvent {
+    topic: string;
+    data?: any;
+}
+/**
+ * Individual evaluation transaction
+ */
+export interface WSEvaluateTransaction extends FlowRuntimeState {
+    authRef?: string;
+    input?: any;
+    configProfile?: any;
+    events?: WSEvaluateTransactionEvent[];
+}
+/**
+ * Result for an individual transaction in a batch
+ */
+export interface WSEvaluateReplyResult {
+    error?: string;
+    stage?: string;
+    subflow?: string;
+    stateUpdates?: Patch;
+    triggers?: Trigger[];
+    events?: HandlerEvent[];
+}
+/**
+ * WebSocket message envelope
+ */
+export interface WSHandlerEnvelope {
+    messageType: WSMessageType;
+    id: string;
+    handlerType?: WSHandlerType;
+    handler?: string;
+    error?: string;
+    authTokens?: Record<string, string>;
+}
+export interface WSEventProcessorBatchRequest extends WSHandlerEnvelope {
+    streamName: string;
+    streamId: string;
+    events: ListenerEvent[];
+    authRef?: string;
+}
+export interface WSEventProcessorBatchResult extends WSHandlerEnvelope {
+    checkpoint?: any;
+    events: ListenerEvent[];
+}
+/**
+ * Transaction handling transaction (batch of evaluate transactions).
+ */
+export interface WSHandleTransactions extends WSHandlerEnvelope {
+    transactions: WSEvaluateTransaction[];
+}
+/**
+ * Transaction handling response (batch evaluate results).
+ */
+export interface WSHandleTransactionsResult extends WSHandlerEnvelope {
+    results: WSEvaluateReplyResult[];
+}
+/**
+ * Provider registration message
+ */
+export interface WSRegisterProvider extends WSHandlerEnvelope {
+    providerName: string;
+}
+/**
+ * Handler registration message
+ */
+export interface WSRegisterHandler extends WSHandlerEnvelope {
+}
+/**
+ * Listener event
+ */
+export interface ListenerEvent {
+    idempotencyKey: string;
+    topic: string;
+    data?: any;
+}
+/**
+ * Event source configuration
+ */
+export interface WSEventStreamInfo {
+    streamId: string;
+    streamName: string;
+}
+export interface WSEventSourceConfig extends WSHandlerEnvelope {
+    streamName: string;
+    streamId: string;
+    config?: any;
+}
+/**
+ * Listener poll request
+ */
+export interface WSListenerPollRequest extends WSHandlerEnvelope {
+    streamName: string;
+    streamId: string;
+    listenerName?: string;
+    checkpoint?: any;
+    authRef?: string;
+}
+/**
+ * Listener poll result
+ */
+export interface WSListenerPollResult extends WSHandlerEnvelope {
+    checkpoint?: any;
+    events: ListenerEvent[];
+}
+export interface AsyncTransactionInput {
+    idempotencyKey?: string;
+    workflowId?: string;
+    workflow: string;
+    operation: string;
+    input?: any;
+    labels?: Record<string, string>;
+}
+export interface IdempotentSubmitResult {
+    id: string;
+    position: number;
+    idempotencyKey?: string;
+    preexisting?: boolean;
+    rejectedError?: string;
+}
+export interface WSEngineAPIRequest {
+    activeRequestId: string;
+    authRef?: string;
+}
+export interface WSEngineAPISubmitTransactions extends WSHandlerEnvelope, WSEngineAPIRequest {
+    transactions: AsyncTransactionInput[];
+}
+export interface WSEngineAPISubmitTransactionsResult extends WSHandlerEnvelope {
+    submissions: IdempotentSubmitResult[];
+}
+/**
+ * Action result for a single action
+ */
+export interface ActionResult {
+    result: any;
+    output?: any;
+    error?: Error;
+    triggers?: any[];
+    extraUpdates?: Patch;
+    customStage?: string;
+}
+/**
+ * Internal type for tracking execution state during batch processing
+ * Used by stage_director to manage transaction execution and results
+ */
+export interface ExecutableTransaction<T = any> {
+    idx: number;
+    transaction: WSEvaluateTransaction;
+    input: T;
+    result?: WSEvaluateReplyResult;
+}
+//# sourceMappingURL=core.d.ts.map

package/dist/src/types/core.d.ts.map

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

package/dist/src/types/core.js

@@ -0,0 +1,71 @@
+"use strict";
+// Copyright © 2026 Kaleido, Inc.
+//
+// SPDX-License-Identifier: Apache-2.0
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PatchOpType = exports.WSHandlerType = exports.WSMessageType = exports.InvocationMode = exports.EvalResult = void 0;
+/**
+ * Core types and enums for the Workflow Engine TypeScript SDK.
+ */
+var EvalResult;
+(function (EvalResult) {
+    EvalResult[EvalResult["FIXABLE_ERROR"] = 0] = "FIXABLE_ERROR";
+    EvalResult[EvalResult["TRANSIENT_ERROR"] = 1] = "TRANSIENT_ERROR";
+    EvalResult[EvalResult["HARD_FAILURE"] = 2] = "HARD_FAILURE";
+    EvalResult[EvalResult["COMPLETE"] = 3] = "COMPLETE";
+    EvalResult[EvalResult["WAITING"] = 4] = "WAITING";
+})(EvalResult || (exports.EvalResult = EvalResult = {}));
+var InvocationMode;
+(function (InvocationMode) {
+    InvocationMode[InvocationMode["PARALLEL"] = 0] = "PARALLEL";
+    InvocationMode[InvocationMode["BATCH"] = 1] = "BATCH";
+})(InvocationMode || (exports.InvocationMode = InvocationMode = {}));
+var WSMessageType;
+(function (WSMessageType) {
+    WSMessageType["PROTOCOL_ERROR"] = "protocol_error";
+    WSMessageType["REGISTER_PROVIDER"] = "register_provider";
+    WSMessageType["REGISTER_HANDLER"] = "register_handler";
+    WSMessageType["EVALUATE"] = "evaluate";
+    WSMessageType["EVALUATE_RESULT"] = "evaluate_result";
+    WSMessageType["HANDLE_TRANSACTIONS"] = "handle_transactions";
+    WSMessageType["HANDLE_TRANSACTIONS_RESULT"] = "handle_transactions_result";
+    WSMessageType["EVENT_SOURCE_CONFIG"] = "event_source_config";
+    WSMessageType["EVENT_SOURCE_POLL"] = "event_source_poll";
+    WSMessageType["EVENT_SOURCE_POLL_RESULT"] = "event_source_poll_result";
+    WSMessageType["EVENT_SOURCE_VALIDATE_CONFIG"] = "event_source_validate_config";
+    WSMessageType["EVENT_SOURCE_VALIDATE_CONFIG_RESULT"] = "event_source_validate_config_result";
+    WSMessageType["EVENT_SOURCE_DELETE"] = "event_source_delete";
+    WSMessageType["EVENT_SOURCE_DELETE_RESULT"] = "event_source_delete_result";
+    WSMessageType["EVENT_PROCESSOR_BATCH"] = "event_processor_batch";
+    WSMessageType["EVENT_PROCESSOR_BATCH_RESULT"] = "event_processor_batch_result";
+    WSMessageType["ENGINE_API_SUBMIT_TRANSACTIONS"] = "engineapi_submit_transactions";
+    WSMessageType["ENGINE_API_SUBMIT_TRANSACTIONS_RESULT"] = "engineapi_submit_transactions_result";
+})(WSMessageType || (exports.WSMessageType = WSMessageType = {}));
+var WSHandlerType;
+(function (WSHandlerType) {
+    WSHandlerType["TRANSACTION_HANDLER"] = "transaction_handler";
+    WSHandlerType["EVENT_PROCESSOR"] = "event_processor";
+    WSHandlerType["EVENT_SOURCE"] = "event_source";
+})(WSHandlerType || (exports.WSHandlerType = WSHandlerType = {}));
+var PatchOpType;
+(function (PatchOpType) {
+    PatchOpType["ADD"] = "add";
+    PatchOpType["REMOVE"] = "remove";
+    PatchOpType["REPLACE"] = "replace";
+    PatchOpType["MOVE"] = "move";
+    PatchOpType["COPY"] = "copy";
+    PatchOpType["TEST"] = "test";
+})(PatchOpType || (exports.PatchOpType = PatchOpType = {}));
+//# sourceMappingURL=core.js.map

package/dist/src/types/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../src/types/core.ts"],"names":[],"mappings":";AAAA,iCAAiC;AACjC,EAAE;AACF,sCAAsC;AACtC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;;;AAGjC;;GAEG;AAEH,IAAY,UAMX;AAND,WAAY,UAAU;IACpB,6DAAiB,CAAA;IACjB,iEAAmB,CAAA;IACnB,2DAAgB,CAAA;IAChB,mDAAY,CAAA;IACZ,iDAAW,CAAA;AACb,CAAC,EANW,UAAU,0BAAV,UAAU,QAMrB;AAED,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,2DAAY,CAAA;IACZ,qDAAS,CAAA;AACX,CAAC,EAHW,cAAc,8BAAd,cAAc,QAGzB;AAED,IAAY,aAmBX;AAnBD,WAAY,aAAa;IACvB,kDAAiC,CAAA;IACjC,wDAAuC,CAAA;IACvC,sDAAqC,CAAA;IACrC,sCAAqB,CAAA;IACrB,oDAAmC,CAAA;IACnC,4DAA2C,CAAA;IAC3C,0EAAyD,CAAA;IACzD,4DAA2C,CAAA;IAC3C,wDAAuC,CAAA;IACvC,sEAAqD,CAAA;IACrD,8EAA6D,CAAA;IAC7D,4FAA2E,CAAA;IAC3E,4DAA2C,CAAA;IAC3C,0EAAyD,CAAA;IACzD,gEAA+C,CAAA;IAC/C,8EAA6D,CAAA;IAC7D,iFAAgE,CAAA;IAChE,+FAA8E,CAAA;AAChF,CAAC,EAnBW,aAAa,6BAAb,aAAa,QAmBxB;AAED,IAAY,aAIX;AAJD,WAAY,aAAa;IACvB,4DAA2C,CAAA;IAC3C,oDAAmC,CAAA;IACnC,8CAA6B,CAAA;AAC/B,CAAC,EAJW,aAAa,6BAAb,aAAa,QAIxB;AAED,IAAY,WAOX;AAPD,WAAY,WAAW;IACrB,0BAAW,CAAA;IACX,gCAAiB,CAAA;IACjB,kCAAmB,CAAA;IACnB,4BAAa,CAAA;IACb,4BAAa,CAAA;IACb,4BAAa,CAAA;AACf,CAAC,EAPW,WAAW,2BAAX,WAAW,QAOtB"}

package/dist/src/types/flows.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Core types and builder for Flow definitions in the Workflow Engine
+ */
+export type JSONAny = any;
+/** Represents the type of a flow stage */
+export type FlowStageType = string;
+/** Available flow stage types */
+export declare const FlowStageTypes: {
+    readonly PENDING: FlowStageType;
+    readonly SUCCESS: FlowStageType;
+    readonly FAILURE: FlowStageType;
+};
+/** Represents the type of a flow operation */
+export type FlowOperationType = string;
+/** Available flow operation types */
+export declare const FlowOperationTypes: {
+    readonly ASYNC: FlowOperationType;
+    readonly SYNC: FlowOperationType;
+};
+/** Input parameters for creating or updating a flow */
+export interface FlowInput {
+    name?: string;
+    currentVersion?: string;
+    description?: string;
+    labels?: {
+        [key: string]: string;
+    };
+}
+/** Embedded version information for a flow */
+export interface FlowVersionEmbedded {
+    version?: string;
+    versionDescription?: string;
+}
+/** Complete flow resource including base fields */
+export interface Flow extends FlowInput {
+    id?: string;
+    created?: string;
+    updated?: string;
+    version?: string;
+    versionDescription?: string;
+    operations?: FlowOperation[];
+    stages?: FlowStage[];
+    events?: FlowEventHandler[];
+    constants?: {
+        [key: string]: JSONAny;
+    };
+}
+/** Handler binding target (provider and handler name). */
+export interface HandlerBindingTarget {
+    provider?: string;
+    providerHandler?: string;
+}
+/** Flow input with inline version information. */
+export interface FlowInputInlineVersion extends FlowVersionEmbedded, FlowInput, FlowDefinition {
+    version?: string;
+    versionDescription?: string;
+    handlerBindings?: Record<string, HandlerBindingTarget>;
+}
+/** Definition of a flow's structure and behavior */
+export interface FlowDefinition {
+    operations?: FlowOperation[];
+    stages?: FlowStage[];
+    events?: FlowEventHandler[];
+    constants?: {
+        [key: string]: JSONAny;
+    };
+}
+/** Definition of a stage in the flow */
+export interface FlowStage {
+    name: string;
+    type: FlowStageType;
+    queueReduce?: FlowReducer;
+    handler?: string;
+    fullState?: boolean;
+    inputMap?: FlowMapping;
+    errorRetry?: FlowHandlerRetry;
+    staleRetry?: FlowHandlerRetry;
+}
+/** Definition of an event handler in the flow */
+export interface FlowEventHandler {
+    name: string;
+    topicMatch: string;
+    handler: string;
+    fullState?: boolean;
+    inputMap?: FlowMapping;
+    errorRetry?: FlowHandlerRetry;
+}
+/** Definition of an operation in the flow */
+export interface FlowOperation {
+    name: string;
+    description?: string;
+    type: FlowOperationType;
+    sequenceMap?: FlowMapping;
+    stage?: string;
+    stateUpdates?: any;
+    inputSchema?: JSONAny;
+    outputSchema?: JSONAny;
+    outputMap?: FlowMapping;
+}
+/** Configuration for reducing queue state */
+export interface FlowReducer {
+    initializer?: FlowMapping;
+    reducer?: FlowMapping;
+}
+/** Configuration for flow transitions */
+export interface FlowTransitions {
+    onCondition: FlowConditionalTransition[];
+    onFailure: FlowTransition;
+}
+/** Definition of a conditional transition */
+export interface FlowConditionalTransition {
+    condition?: FlowMapping;
+    stage: string;
+    data?: FlowMapping;
+}
+/** Definition of a transition */
+export interface FlowTransition {
+    stage: string;
+    data?: FlowMapping;
+}
+/** Reference to a flow policy */
+export interface FlowPolicyRef {
+    name: string;
+    version?: string;
+    hash?: string;
+}
+/** Configuration for data mapping */
+export interface FlowMapping {
+    jsonata?: string;
+    rego?: string;
+}
+/** Configuration for retry timing */
+export interface FlowRetryTuning {
+    initialDelay: string;
+    maxDelay: string;
+    factor: number;
+}
+/** Configuration for handler retry behavior */
+export interface FlowHandlerRetry {
+    disabled?: boolean;
+    condition?: FlowMapping;
+    tuning?: FlowRetryTuning;
+}
+//# sourceMappingURL=flows.d.ts.map

package/dist/src/types/flows.d.ts.map

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

package/dist/src/types/flows.js

@@ -0,0 +1,30 @@
+"use strict";
+// Copyright © 2026 Kaleido, Inc.
+//
+// SPDX-License-Identifier: Apache-2.0
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowOperationTypes = exports.FlowStageTypes = void 0;
+/** Available flow stage types */
+exports.FlowStageTypes = {
+    PENDING: 'pending',
+    SUCCESS: 'success',
+    FAILURE: 'failure',
+};
+/** Available flow operation types */
+exports.FlowOperationTypes = {
+    ASYNC: 'asynchronous',
+    SYNC: 'synchronous',
+};
+//# sourceMappingURL=flows.js.map

package/dist/src/types/flows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flows.js","sourceRoot":"","sources":["../../../src/types/flows.ts"],"names":[],"mappings":";AAAA,iCAAiC;AACjC,EAAE;AACF,sCAAsC;AACtC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;;;AAYjC,iCAAiC;AACpB,QAAA,cAAc,GAAG;IAC5B,OAAO,EAAE,SAA0B;IACnC,OAAO,EAAE,SAA0B;IACnC,OAAO,EAAE,SAA0B;CAC3B,CAAC;AAKX,qCAAqC;AACxB,QAAA,kBAAkB,GAAG;IAChC,KAAK,EAAE,cAAmC;IAC1C,IAAI,EAAE,aAAkC;CAChC,CAAC"}

package/dist/src/utils/errors.d.ts

@@ -0,0 +1,2 @@
+export declare const getErrorMessage: (error: unknown) => string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,MAEhD,CAAA"}

package/dist/src/utils/errors.js

@@ -0,0 +1,23 @@
+"use strict";
+// Copyright © 2026 Kaleido, Inc.
+//
+// SPDX-License-Identifier: Apache-2.0
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getErrorMessage = void 0;
+const getErrorMessage = (error) => {
+    return error instanceof Error ? error.message : String(error);
+};
+exports.getErrorMessage = getErrorMessage;
+//# sourceMappingURL=errors.js.map

package/dist/src/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":";AAAA,iCAAiC;AACjC,EAAE;AACF,sCAAsC;AACtC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;;;AAG1B,MAAM,eAAe,GAAG,CAAC,KAAc,EAAU,EAAE;IACxD,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC,CAAA;AAFY,QAAA,eAAe,mBAE3B"}

package/dist/src/utils/patch.d.ts

@@ -0,0 +1,9 @@
+import { PatchOp, Patch } from "../types/core";
+export declare const apply: (state: unknown, patch: Patch) => unknown;
+export declare const addOp: (path: string, value: unknown) => PatchOp;
+export declare const removeOp: (path: string) => PatchOp;
+export declare const replaceOp: (path: string, value: unknown) => PatchOp;
+export declare const moveOp: (from: string, path: string) => PatchOp;
+export declare const copyOp: (from: string, path: string) => PatchOp;
+export declare const testOp: (path: string, value: unknown) => PatchOp;
+//# sourceMappingURL=patch.d.ts.map

package/dist/src/utils/patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../../../src/utils/patch.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,OAAO,EAAe,KAAK,EAAE,MAAM,eAAe,CAAC;AAI5D,eAAO,MAAM,KAAK,GAAI,OAAO,OAAO,EAAE,OAAO,KAAK,YAOjD,CAAC;AAGF,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM,EAAE,OAAO,OAAO,KAAG,OAInD,CAAC;AAEH,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,KAAG,OAGtC,CAAC;AAEH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,EAAE,OAAO,OAAO,KAAG,OAIvD,CAAC;AAEH,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,EAAE,MAAM,MAAM,KAAG,OAIlD,CAAC;AAEH,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,EAAE,MAAM,MAAM,KAAG,OAIlD,CAAC;AAEH,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,EAAE,OAAO,OAAO,KAAG,OAIpD,CAAC"}

package/dist/src/utils/patch.js

@@ -0,0 +1,99 @@
+"use strict";
+// Copyright © 2026 Kaleido, Inc.
+//
+// SPDX-License-Identifier: Apache-2.0
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testOp = exports.copyOp = exports.moveOp = exports.replaceOp = exports.removeOp = exports.addOp = exports.apply = void 0;
+const fastJsonPatch = __importStar(require("fast-json-patch"));
+const core_1 = require("../types/core");
+const { applyPatch } = fastJsonPatch;
+const apply = (state, patch) => {
+    if (!patch || patch.length === 0) {
+        return state;
+    }
+    const { newDocument: newState } = applyPatch(state, patch);
+    return newState;
+};
+exports.apply = apply;
+// JSON Patch operation creators
+const addOp = (path, value) => ({
+    op: core_1.PatchOpType.ADD,
+    path,
+    value,
+});
+exports.addOp = addOp;
+const removeOp = (path) => ({
+    op: core_1.PatchOpType.REMOVE,
+    path,
+});
+exports.removeOp = removeOp;
+const replaceOp = (path, value) => ({
+    op: core_1.PatchOpType.REPLACE,
+    path,
+    value,
+});
+exports.replaceOp = replaceOp;
+const moveOp = (from, path) => ({
+    op: core_1.PatchOpType.MOVE,
+    from,
+    path,
+});
+exports.moveOp = moveOp;
+const copyOp = (from, path) => ({
+    op: core_1.PatchOpType.COPY,
+    from,
+    path,
+});
+exports.copyOp = copyOp;
+const testOp = (path, value) => ({
+    op: core_1.PatchOpType.TEST,
+    path,
+    value,
+});
+exports.testOp = testOp;
+//# sourceMappingURL=patch.js.map