@affino/datagrid-worker 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 affino
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { DATAGRID_WORKER_PROTOCOL_CHANNEL, DATAGRID_WORKER_PROTOCOL_VERSION, DATAGRID_WORKER_COMPUTE_PAYLOAD_SCHEMA_VERSION, createDataGridWorkerComputeRequestMessage, createDataGridWorkerComputeAckMessage, createDataGridWorkerComputeErrorAckMessage, isDataGridWorkerComputeRequestMessage, isDataGridWorkerComputeAckMessage, resolveWorkerComputeRequestPayload, type DataGridWorkerComputeRequest, type DataGridWorkerComputeRequestPayload, type DataGridWorkerComputeRequestPayloadEnvelope, type DataGridWorkerComputeBatchPlan, type DataGridWorkerComputeResult, type DataGridWorkerProtocolHeader, type DataGridWorkerComputeRequestMessage, type DataGridWorkerComputeAckMessage, type DataGridWorkerProtocolMessage, } from "./protocol.js";
+export { createDataGridWorkerPostMessageTransport, type DataGridWorkerMessageEvent, type DataGridWorkerMessageSource, type DataGridWorkerMessageTarget, type DataGridWorkerDispatchStrategy, type DataGridWorkerPostMessageTransportStats, type DataGridWorkerPostMessageTransport, type CreateDataGridWorkerPostMessageTransportOptions, } from "./postMessageTransport.js";
+export { createDataGridWorkerMessageHost, type CreateDataGridWorkerMessageHostOptions, type DataGridWorkerMessageHost, } from "./workerHost.js";
+export { DATAGRID_WORKER_ROW_MODEL_PROTOCOL_CHANNEL, DATAGRID_WORKER_ROW_MODEL_PROTOCOL_VERSION, DATAGRID_WORKER_ROW_MODEL_PAYLOAD_SCHEMA_VERSION, createDataGridWorkerRowModelCommandMessage, createDataGridWorkerRowModelUpdateMessage, isDataGridWorkerRowModelCommandMessage, isDataGridWorkerRowModelUpdateMessage, type DataGridWorkerRowModelProtocolHeader, type DataGridWorkerViewportCoalesceScope, type DataGridWorkerRowModelCommand, type DataGridWorkerRowModelCommandMessage, type DataGridWorkerRowModelUpdatePayload, type DataGridWorkerRowModelUpdateMessage, type DataGridWorkerRowModelProtocolMessage, } from "./workerOwnedRowModelProtocol.js";
+export { createDataGridWorkerOwnedRowModelHost, type CreateDataGridWorkerOwnedRowModelHostOptions, type DataGridWorkerOwnedRowModelHost, } from "./workerOwnedRowModelHost.js";
+export { createDataGridWorkerOwnedRowModel, type DataGridWorkerOwnedRowModel, type CreateDataGridWorkerOwnedRowModelOptions, } from "./workerOwnedRowModel.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gCAAgC,EAChC,gCAAgC,EAChC,8CAA8C,EAC9C,yCAAyC,EACzC,qCAAqC,EACrC,0CAA0C,EAC1C,qCAAqC,EACrC,iCAAiC,EACjC,kCAAkC,EAClC,KAAK,4BAA4B,EACjC,KAAK,mCAAmC,EACxC,KAAK,2CAA2C,EAChD,KAAK,8BAA8B,EACnC,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,mCAAmC,EACxC,KAAK,+BAA+B,EACpC,KAAK,6BAA6B,GACnC,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,wCAAwC,EACxC,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,8BAA8B,EACnC,KAAK,uCAAuC,EAC5C,KAAK,kCAAkC,EACvC,KAAK,+CAA+C,GACrD,MAAM,2BAA2B,CAAA;AAElC,OAAO,EACL,+BAA+B,EAC/B,KAAK,sCAAsC,EAC3C,KAAK,yBAAyB,GAC/B,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,0CAA0C,EAC1C,0CAA0C,EAC1C,gDAAgD,EAChD,0CAA0C,EAC1C,yCAAyC,EACzC,sCAAsC,EACtC,qCAAqC,EACrC,KAAK,oCAAoC,EACzC,KAAK,mCAAmC,EACxC,KAAK,6BAA6B,EAClC,KAAK,oCAAoC,EACzC,KAAK,mCAAmC,EACxC,KAAK,mCAAmC,EACxC,KAAK,qCAAqC,GAC3C,MAAM,kCAAkC,CAAA;AAEzC,OAAO,EACL,qCAAqC,EACrC,KAAK,4CAA4C,EACjD,KAAK,+BAA+B,GACrC,MAAM,8BAA8B,CAAA;AAErC,OAAO,EACL,iCAAiC,EACjC,KAAK,2BAA2B,EAChC,KAAK,wCAAwC,GAC9C,MAAM,0BAA0B,CAAA"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { DATAGRID_WORKER_PROTOCOL_CHANNEL, DATAGRID_WORKER_PROTOCOL_VERSION, DATAGRID_WORKER_COMPUTE_PAYLOAD_SCHEMA_VERSION, createDataGridWorkerComputeRequestMessage, createDataGridWorkerComputeAckMessage, createDataGridWorkerComputeErrorAckMessage, isDataGridWorkerComputeRequestMessage, isDataGridWorkerComputeAckMessage, resolveWorkerComputeRequestPayload, } from "./protocol.js";
+export { createDataGridWorkerPostMessageTransport, } from "./postMessageTransport.js";
+export { createDataGridWorkerMessageHost, } from "./workerHost.js";
+export { DATAGRID_WORKER_ROW_MODEL_PROTOCOL_CHANNEL, DATAGRID_WORKER_ROW_MODEL_PROTOCOL_VERSION, DATAGRID_WORKER_ROW_MODEL_PAYLOAD_SCHEMA_VERSION, createDataGridWorkerRowModelCommandMessage, createDataGridWorkerRowModelUpdateMessage, isDataGridWorkerRowModelCommandMessage, isDataGridWorkerRowModelUpdateMessage, } from "./workerOwnedRowModelProtocol.js";
+export { createDataGridWorkerOwnedRowModelHost, } from "./workerOwnedRowModelHost.js";
+export { createDataGridWorkerOwnedRowModel, } from "./workerOwnedRowModel.js";

package/dist/postMessageTransport.d.ts

@@ -0,0 +1,31 @@
+import type { DataGridClientComputeTransport } from "@affino/datagrid-core";
+export interface DataGridWorkerMessageEvent<T = unknown> {
+    data: T;
+}
+export interface DataGridWorkerMessageTarget {
+    postMessage: (message: unknown) => void;
+}
+export interface DataGridWorkerMessageSource {
+    addEventListener: (type: "message", listener: (event: DataGridWorkerMessageEvent) => void) => void;
+    removeEventListener: (type: "message", listener: (event: DataGridWorkerMessageEvent) => void) => void;
+}
+export type DataGridWorkerDispatchStrategy = "sync-fallback" | "fire-and-forget";
+export interface DataGridWorkerPostMessageTransportStats {
+    dispatched: number;
+    acked: number;
+    errored: number;
+    timedOut: number;
+    inflight: number;
+}
+export interface DataGridWorkerPostMessageTransport extends DataGridClientComputeTransport {
+    getStats: () => DataGridWorkerPostMessageTransportStats;
+}
+export interface CreateDataGridWorkerPostMessageTransportOptions {
+    target: DataGridWorkerMessageTarget;
+    source?: DataGridWorkerMessageSource | null;
+    channel?: string | null;
+    dispatchStrategy?: DataGridWorkerDispatchStrategy;
+    requestTimeoutMs?: number;
+}
+export declare function createDataGridWorkerPostMessageTransport(options: CreateDataGridWorkerPostMessageTransportOptions): DataGridWorkerPostMessageTransport;
+//# sourceMappingURL=postMessageTransport.d.ts.map

package/dist/postMessageTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postMessageTransport.d.ts","sourceRoot":"","sources":["../src/postMessageTransport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAA;AAO3E,MAAM,WAAW,0BAA0B,CAAC,CAAC,GAAG,OAAO;IACrD,IAAI,EAAE,CAAC,CAAA;CACR;AAED,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;CACxC;AAED,MAAM,WAAW,2BAA2B;IAC1C,gBAAgB,EAAE,CAChB,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,IAAI,KAClD,IAAI,CAAA;IACT,mBAAmB,EAAE,CACnB,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,IAAI,KAClD,IAAI,CAAA;CACV;AAED,MAAM,MAAM,8BAA8B,GAAG,eAAe,GAAG,iBAAiB,CAAA;AAEhF,MAAM,WAAW,uCAAuC;IACtD,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,kCAAmC,SAAQ,8BAA8B;IACxF,QAAQ,EAAE,MAAM,uCAAuC,CAAA;CACxD;AAED,MAAM,WAAW,+CAA+C;IAC9D,MAAM,EAAE,2BAA2B,CAAA;IACnC,MAAM,CAAC,EAAE,2BAA2B,GAAG,IAAI,CAAA;IAC3C,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,gBAAgB,CAAC,EAAE,8BAA8B,CAAA;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAMD,wBAAgB,wCAAwC,CACtD,OAAO,EAAE,+CAA+C,GACvD,kCAAkC,CAuFpC"}

package/dist/postMessageTransport.js

@@ -0,0 +1,81 @@
+import { createDataGridWorkerComputeRequestMessage, isDataGridWorkerComputeAckMessage, } from "./protocol.js";
+export function createDataGridWorkerPostMessageTransport(options) {
+    var _a, _b, _c;
+    const channel = options.channel;
+    const strategy = (_a = options.dispatchStrategy) !== null && _a !== void 0 ? _a : "sync-fallback";
+    const requestTimeoutMs = Math.max(0, Math.trunc((_b = options.requestTimeoutMs) !== null && _b !== void 0 ? _b : 15000));
+    let nextRequestId = 1;
+    let dispatched = 0;
+    let acked = 0;
+    let errored = 0;
+    let timedOut = 0;
+    const pendingById = new Map();
+    const clearPending = (requestId) => {
+        const pending = pendingById.get(requestId);
+        if (!pending) {
+            return;
+        }
+        if (pending.timeoutHandle) {
+            clearTimeout(pending.timeoutHandle);
+        }
+        pendingById.delete(requestId);
+    };
+    const onMessage = (event) => {
+        if (!isDataGridWorkerComputeAckMessage(event.data, channel)) {
+            return;
+        }
+        const ackMessage = event.data;
+        if (!pendingById.has(ackMessage.requestId)) {
+            return;
+        }
+        clearPending(ackMessage.requestId);
+        acked += 1;
+        if (ackMessage.payload.error) {
+            errored += 1;
+        }
+    };
+    (_c = options.source) === null || _c === void 0 ? void 0 : _c.addEventListener("message", onMessage);
+    const dispatchRequest = (request) => {
+        const requestId = nextRequestId;
+        nextRequestId += 1;
+        dispatched += 1;
+        const requestMessage = createDataGridWorkerComputeRequestMessage(requestId, request, channel);
+        options.target.postMessage(requestMessage);
+        if (requestTimeoutMs > 0) {
+            const timeoutHandle = setTimeout(() => {
+                if (!pendingById.has(requestId)) {
+                    return;
+                }
+                pendingById.delete(requestId);
+                timedOut += 1;
+            }, requestTimeoutMs);
+            pendingById.set(requestId, { timeoutHandle });
+            return;
+        }
+        pendingById.set(requestId, { timeoutHandle: null });
+    };
+    return {
+        dispatch(request) {
+            dispatchRequest(request);
+            return {
+                handled: strategy === "fire-and-forget",
+            };
+        },
+        getStats() {
+            return {
+                dispatched,
+                acked,
+                errored,
+                timedOut,
+                inflight: pendingById.size,
+            };
+        },
+        dispose() {
+            var _a;
+            (_a = options.source) === null || _a === void 0 ? void 0 : _a.removeEventListener("message", onMessage);
+            for (const requestId of pendingById.keys()) {
+                clearPending(requestId);
+            }
+        },
+    };
+}

package/dist/protocol.d.ts

@@ -0,0 +1,43 @@
+import type { DataGridClientComputeTransport, DataGridClientComputeTransportResult } from "@affino/datagrid-core";
+export declare const DATAGRID_WORKER_PROTOCOL_VERSION: 1;
+export declare const DATAGRID_WORKER_COMPUTE_PAYLOAD_SCHEMA_VERSION: 2;
+export declare const DATAGRID_WORKER_PROTOCOL_CHANNEL = "affino.datagrid.compute";
+export type DataGridWorkerComputeRequest = Parameters<DataGridClientComputeTransport["dispatch"]>[0];
+export type DataGridWorkerComputeResult = DataGridClientComputeTransportResult;
+export interface DataGridWorkerComputeBatchPlan {
+    kind: "stage-plan" | "execution-plan";
+    requestedStages: readonly string[];
+    blockedStages: readonly string[];
+    patchChangedRowCount?: number;
+}
+export interface DataGridWorkerComputeRequestPayloadEnvelope {
+    schemaVersion: number;
+    request: DataGridWorkerComputeRequest;
+    batchPlan?: DataGridWorkerComputeBatchPlan | null;
+}
+export type DataGridWorkerComputeRequestPayload = DataGridWorkerComputeRequest | DataGridWorkerComputeRequestPayloadEnvelope;
+export interface DataGridWorkerProtocolHeader {
+    version: typeof DATAGRID_WORKER_PROTOCOL_VERSION;
+    channel: string;
+    requestId: number;
+    timestamp: number;
+}
+export interface DataGridWorkerComputeRequestMessage extends DataGridWorkerProtocolHeader {
+    kind: "compute-request";
+    payload: DataGridWorkerComputeRequestPayload;
+}
+export interface DataGridWorkerComputeAckMessage extends DataGridWorkerProtocolHeader {
+    kind: "compute-ack";
+    payload: {
+        handled: boolean;
+        error?: string | null;
+    };
+}
+export type DataGridWorkerProtocolMessage = DataGridWorkerComputeRequestMessage | DataGridWorkerComputeAckMessage;
+export declare function createDataGridWorkerComputeRequestMessage(requestId: number, payload: DataGridWorkerComputeRequest, channel?: string | null): DataGridWorkerComputeRequestMessage;
+export declare function createDataGridWorkerComputeAckMessage(requestId: number, result: DataGridWorkerComputeResult, channel?: string | null): DataGridWorkerComputeAckMessage;
+export declare function createDataGridWorkerComputeErrorAckMessage(requestId: number, error: unknown, channel?: string | null): DataGridWorkerComputeAckMessage;
+export declare function isDataGridWorkerComputeRequestMessage(value: unknown, channel?: string | null): value is DataGridWorkerComputeRequestMessage;
+export declare function isDataGridWorkerComputeAckMessage(value: unknown, channel?: string | null): value is DataGridWorkerComputeAckMessage;
+export declare function resolveWorkerComputeRequestPayload(payload: unknown): DataGridWorkerComputeRequestPayloadEnvelope | null;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,oCAAoC,EAAE,MAAM,uBAAuB,CAAA;AAEjH,eAAO,MAAM,gCAAgC,EAAG,CAAU,CAAA;AAC1D,eAAO,MAAM,8CAA8C,EAAG,CAAU,CAAA;AACxE,eAAO,MAAM,gCAAgC,4BAA4B,CAAA;AAEzE,MAAM,MAAM,4BAA4B,GAAG,UAAU,CAAC,8BAA8B,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACpG,MAAM,MAAM,2BAA2B,GAAG,oCAAoC,CAAA;AAE9E,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,YAAY,GAAG,gBAAgB,CAAA;IACrC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,MAAM,WAAW,2CAA2C;IAC1D,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,4BAA4B,CAAA;IACrC,SAAS,CAAC,EAAE,8BAA8B,GAAG,IAAI,CAAA;CAClD;AAED,MAAM,MAAM,mCAAmC,GAC3C,4BAA4B,GAC5B,2CAA2C,CAAA;AAE/C,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,OAAO,gCAAgC,CAAA;IAChD,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,mCAAoC,SAAQ,4BAA4B;IACvF,IAAI,EAAE,iBAAiB,CAAA;IACvB,OAAO,EAAE,mCAAmC,CAAA;CAC7C;AAED,MAAM,WAAW,+BAAgC,SAAQ,4BAA4B;IACnF,IAAI,EAAE,aAAa,CAAA;IACnB,OAAO,EAAE;QACP,OAAO,EAAE,OAAO,CAAA;QAChB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KACtB,CAAA;CACF;AAED,MAAM,MAAM,6BAA6B,GACrC,mCAAmC,GACnC,+BAA+B,CAAA;AAwDnC,wBAAgB,yCAAyC,CACvD,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,4BAA4B,EACrC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACtB,mCAAmC,CAcrC;AAED,wBAAgB,qCAAqC,CACnD,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,2BAA2B,EACnC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACtB,+BAA+B,CAYjC;AAED,wBAAgB,0CAA0C,CACxD,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACtB,+BAA+B,CAejC;AAED,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACtB,KAAK,IAAI,mCAAmC,CAW9C;AAED,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACtB,KAAK,IAAI,+BAA+B,CAO1C;AAED,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,OAAO,GACf,2CAA2C,GAAG,IAAI,CA0BpD"}

package/dist/protocol.js

@@ -0,0 +1,134 @@
+export const DATAGRID_WORKER_PROTOCOL_VERSION = 1;
+export const DATAGRID_WORKER_COMPUTE_PAYLOAD_SCHEMA_VERSION = 2;
+export const DATAGRID_WORKER_PROTOCOL_CHANNEL = "affino.datagrid.compute";
+function isWorkerComputeRequestKind(value) {
+    return (value === "recompute-from-stage"
+        || value === "recompute-with-stage-plan"
+        || value === "recompute-with-execution-plan"
+        || value === "refresh");
+}
+function serializeComputeBatchPlan(request) {
+    var _a, _b, _c;
+    if (request.kind === "recompute-with-stage-plan") {
+        return {
+            kind: "stage-plan",
+            requestedStages: [...request.plan.requestedStages],
+            blockedStages: [...((_a = request.plan.blockedStages) !== null && _a !== void 0 ? _a : [])],
+        };
+    }
+    if (request.kind === "recompute-with-execution-plan") {
+        return {
+            kind: "execution-plan",
+            requestedStages: [...request.plan.requestedStages],
+            blockedStages: [...((_b = request.plan.blockedStages) !== null && _b !== void 0 ? _b : [])],
+            ...(typeof ((_c = request.options) === null || _c === void 0 ? void 0 : _c.patchChangedRowCount) === "number"
+                ? { patchChangedRowCount: request.options.patchChangedRowCount }
+                : {}),
+        };
+    }
+    return null;
+}
+function normalizeChannel(channel) {
+    const normalized = channel === null || channel === void 0 ? void 0 : channel.trim();
+    return normalized && normalized.length > 0
+        ? normalized
+        : DATAGRID_WORKER_PROTOCOL_CHANNEL;
+}
+function isWorkerProtocolHeader(value) {
+    if (!value || typeof value !== "object") {
+        return false;
+    }
+    const candidate = value;
+    return (candidate.version === DATAGRID_WORKER_PROTOCOL_VERSION &&
+        typeof candidate.channel === "string" &&
+        Number.isFinite(candidate.requestId) &&
+        Number.isFinite(candidate.timestamp));
+}
+export function createDataGridWorkerComputeRequestMessage(requestId, payload, channel) {
+    const batchPlan = serializeComputeBatchPlan(payload);
+    return {
+        kind: "compute-request",
+        version: DATAGRID_WORKER_PROTOCOL_VERSION,
+        channel: normalizeChannel(channel),
+        requestId,
+        timestamp: Date.now(),
+        payload: {
+            schemaVersion: DATAGRID_WORKER_COMPUTE_PAYLOAD_SCHEMA_VERSION,
+            request: payload,
+            batchPlan,
+        },
+    };
+}
+export function createDataGridWorkerComputeAckMessage(requestId, result, channel) {
+    return {
+        kind: "compute-ack",
+        version: DATAGRID_WORKER_PROTOCOL_VERSION,
+        channel: normalizeChannel(channel),
+        requestId,
+        timestamp: Date.now(),
+        payload: {
+            handled: (result === null || result === void 0 ? void 0 : result.handled) === true,
+            error: null,
+        },
+    };
+}
+export function createDataGridWorkerComputeErrorAckMessage(requestId, error, channel) {
+    const message = error instanceof Error
+        ? error.message
+        : String(error !== null && error !== void 0 ? error : "unknown worker error");
+    return {
+        kind: "compute-ack",
+        version: DATAGRID_WORKER_PROTOCOL_VERSION,
+        channel: normalizeChannel(channel),
+        requestId,
+        timestamp: Date.now(),
+        payload: {
+            handled: false,
+            error: message,
+        },
+    };
+}
+export function isDataGridWorkerComputeRequestMessage(value, channel) {
+    if (!isWorkerProtocolHeader(value)) {
+        return false;
+    }
+    const candidate = value;
+    const channelMatches = candidate.channel === normalizeChannel(channel);
+    return (candidate.kind === "compute-request"
+        && channelMatches
+        && resolveWorkerComputeRequestPayload(candidate.payload) !== null);
+}
+export function isDataGridWorkerComputeAckMessage(value, channel) {
+    if (!isWorkerProtocolHeader(value)) {
+        return false;
+    }
+    const candidate = value;
+    const channelMatches = candidate.channel === normalizeChannel(channel);
+    return candidate.kind === "compute-ack" && channelMatches && candidate.payload != null;
+}
+export function resolveWorkerComputeRequestPayload(payload) {
+    var _a;
+    if (!payload || typeof payload !== "object") {
+        return null;
+    }
+    const directCandidate = payload;
+    if (isWorkerComputeRequestKind(directCandidate.kind)) {
+        return {
+            schemaVersion: 1,
+            request: directCandidate,
+            batchPlan: serializeComputeBatchPlan(directCandidate),
+        };
+    }
+    const envelope = payload;
+    if (typeof envelope.schemaVersion !== "number"
+        || !Number.isFinite(envelope.schemaVersion)
+        || !envelope.request
+        || !isWorkerComputeRequestKind(envelope.request.kind)) {
+        return null;
+    }
+    return {
+        schemaVersion: envelope.schemaVersion,
+        request: envelope.request,
+        batchPlan: (_a = envelope.batchPlan) !== null && _a !== void 0 ? _a : null,
+    };
+}

package/dist/workerHost.d.ts

@@ -0,0 +1,13 @@
+import { type DataGridWorkerComputeRequest, type DataGridWorkerComputeResult } from "./protocol.js";
+import type { DataGridWorkerMessageSource, DataGridWorkerMessageTarget } from "./postMessageTransport.js";
+export interface CreateDataGridWorkerMessageHostOptions {
+    source: DataGridWorkerMessageSource;
+    target: DataGridWorkerMessageTarget;
+    channel?: string | null;
+    handleRequest: (request: DataGridWorkerComputeRequest) => DataGridWorkerComputeResult | Promise<DataGridWorkerComputeResult>;
+}
+export interface DataGridWorkerMessageHost {
+    dispose: () => void;
+}
+export declare function createDataGridWorkerMessageHost(options: CreateDataGridWorkerMessageHostOptions): DataGridWorkerMessageHost;
+//# sourceMappingURL=workerHost.d.ts.map

package/dist/workerHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workerHost.d.ts","sourceRoot":"","sources":["../src/workerHost.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EACjC,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAEV,2BAA2B,EAC3B,2BAA2B,EAC5B,MAAM,2BAA2B,CAAA;AAElC,MAAM,WAAW,sCAAsC;IACrD,MAAM,EAAE,2BAA2B,CAAA;IACnC,MAAM,EAAE,2BAA2B,CAAA;IACnC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,aAAa,EAAE,CAAC,OAAO,EAAE,4BAA4B,KAAK,2BAA2B,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAA;CAC7H;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,sCAAsC,GAC9C,yBAAyB,CAoE3B"}

package/dist/workerHost.js

@@ -0,0 +1,58 @@
+import { createDataGridWorkerComputeAckMessage, createDataGridWorkerComputeErrorAckMessage, isDataGridWorkerComputeRequestMessage, resolveWorkerComputeRequestPayload, } from "./protocol.js";
+export function createDataGridWorkerMessageHost(options) {
+    let disposed = false;
+    const postSuccessAck = (requestId, result) => {
+        if (disposed) {
+            return;
+        }
+        const ack = createDataGridWorkerComputeAckMessage(requestId, result, options.channel);
+        options.target.postMessage(ack);
+    };
+    const postErrorAck = (requestId, error) => {
+        if (disposed) {
+            return;
+        }
+        const ack = createDataGridWorkerComputeErrorAckMessage(requestId, error, options.channel);
+        options.target.postMessage(ack);
+    };
+    const onMessage = (event) => {
+        if (disposed) {
+            return;
+        }
+        if (!isDataGridWorkerComputeRequestMessage(event.data, options.channel)) {
+            return;
+        }
+        const requestMessage = event.data;
+        const payload = resolveWorkerComputeRequestPayload(requestMessage.payload);
+        if (!payload) {
+            return;
+        }
+        try {
+            const result = options.handleRequest(payload.request);
+            if (result instanceof Promise) {
+                result
+                    .then((resolvedResult) => {
+                    postSuccessAck(requestMessage.requestId, resolvedResult);
+                })
+                    .catch((error) => {
+                    postErrorAck(requestMessage.requestId, error);
+                });
+                return;
+            }
+            postSuccessAck(requestMessage.requestId, result);
+        }
+        catch (error) {
+            postErrorAck(requestMessage.requestId, error);
+        }
+    };
+    options.source.addEventListener("message", onMessage);
+    return {
+        dispose() {
+            if (disposed) {
+                return;
+            }
+            disposed = true;
+            options.source.removeEventListener("message", onMessage);
+        },
+    };
+}

package/dist/workerOwnedRowModel.d.ts

@@ -0,0 +1,41 @@
+import type { DataGridClientComputeDiagnostics, DataGridClientRowPatch, DataGridClientRowPatchOptions, DataGridFormulaComputeStageDiagnostics, DataGridFormulaFieldSnapshot, DataGridRowModel, DataGridRowModelSnapshot, DataGridRowNodeInput } from "@affino/datagrid-core";
+import type { DataGridFormulaExecutionPlanSnapshot, DataGridFormulaFieldDefinition } from "@affino/datagrid-formula-engine";
+import type { DataGridWorkerMessageSource, DataGridWorkerMessageTarget } from "./postMessageTransport.js";
+export interface DataGridWorkerOwnedRowModel<T = unknown> extends DataGridRowModel<T> {
+    setRows: (rows: readonly DataGridRowNodeInput<T>[]) => void;
+    patchRows: (updates: readonly DataGridClientRowPatch<T>[], options?: DataGridClientRowPatchOptions) => void;
+    registerFormulaField: (definition: DataGridFormulaFieldDefinition) => void;
+    getFormulaFields: () => readonly DataGridFormulaFieldSnapshot[];
+    getFormulaExecutionPlan: () => DataGridFormulaExecutionPlanSnapshot | null;
+    getFormulaComputeStageDiagnostics: () => DataGridFormulaComputeStageDiagnostics | null;
+    getComputeDiagnostics: () => DataGridClientComputeDiagnostics;
+    getWorkerProtocolDiagnostics: () => {
+        updatesReceived: number;
+        updatesApplied: number;
+        updatesDroppedStale: number;
+        updatesDroppedInitialAfterApplied: number;
+        commandsCoalesced: number;
+        patchCommandsCoalesced: number;
+        patchUpdatesReceived: number;
+        patchUpdatesDispatched: number;
+        patchUpdatesMergedAway: number;
+        immediateFlushCount: number;
+        queuePeak: number;
+        protocolVersion: number;
+        expectedPayloadSchemaVersion: number;
+        lastPayloadSchemaVersion: number | null;
+        payloadSchemaMismatches: number;
+        loadingSetCount: number;
+        loadingClearCount: number;
+    };
+}
+export interface CreateDataGridWorkerOwnedRowModelOptions<T = unknown> {
+    source: DataGridWorkerMessageSource;
+    target: DataGridWorkerMessageTarget;
+    channel?: string | null;
+    initialSnapshot?: DataGridRowModelSnapshot<T> | null;
+    requestInitialSync?: boolean;
+    viewportCoalescingStrategy?: "split" | "simple";
+}
+export declare function createDataGridWorkerOwnedRowModel<T = unknown>(options: CreateDataGridWorkerOwnedRowModelOptions<T>): DataGridWorkerOwnedRowModel<T>;
+//# sourceMappingURL=workerOwnedRowModel.d.ts.map

package/dist/workerOwnedRowModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workerOwnedRowModel.d.ts","sourceRoot":"","sources":["../src/workerOwnedRowModel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,gCAAgC,EAChC,sBAAsB,EACtB,6BAA6B,EAC7B,sCAAsC,EACtC,4BAA4B,EAO5B,gBAAgB,EAGhB,wBAAwB,EAExB,oBAAoB,EAIrB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,KAAK,EACV,oCAAoC,EACpC,8BAA8B,EAC/B,MAAM,iCAAiC,CAAA;AACxC,OAAO,KAAK,EAEV,2BAA2B,EAC3B,2BAA2B,EAC5B,MAAM,2BAA2B,CAAA;AAUlC,MAAM,WAAW,2BAA2B,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;IACnF,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,oBAAoB,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAA;IAC3D,SAAS,EAAE,CACT,OAAO,EAAE,SAAS,sBAAsB,CAAC,CAAC,CAAC,EAAE,EAC7C,OAAO,CAAC,EAAE,6BAA6B,KACpC,IAAI,CAAA;IACT,oBAAoB,EAAE,CAAC,UAAU,EAAE,8BAA8B,KAAK,IAAI,CAAA;IAC1E,gBAAgB,EAAE,MAAM,SAAS,4BAA4B,EAAE,CAAA;IAC/D,uBAAuB,EAAE,MAAM,oCAAoC,GAAG,IAAI,CAAA;IAC1E,iCAAiC,EAAE,MAAM,sCAAsC,GAAG,IAAI,CAAA;IACtF,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;IAC7D,4BAA4B,EAAE,MAAM;QAClC,eAAe,EAAE,MAAM,CAAA;QACvB,cAAc,EAAE,MAAM,CAAA;QACtB,mBAAmB,EAAE,MAAM,CAAA;QAC3B,iCAAiC,EAAE,MAAM,CAAA;QACzC,iBAAiB,EAAE,MAAM,CAAA;QACzB,sBAAsB,EAAE,MAAM,CAAA;QAC9B,oBAAoB,EAAE,MAAM,CAAA;QAC5B,sBAAsB,EAAE,MAAM,CAAA;QAC9B,sBAAsB,EAAE,MAAM,CAAA;QAC9B,mBAAmB,EAAE,MAAM,CAAA;QAC3B,SAAS,EAAE,MAAM,CAAA;QACjB,eAAe,EAAE,MAAM,CAAA;QACvB,4BAA4B,EAAE,MAAM,CAAA;QACpC,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAA;QACvC,uBAAuB,EAAE,MAAM,CAAA;QAC/B,eAAe,EAAE,MAAM,CAAA;QACvB,iBAAiB,EAAE,MAAM,CAAA;KAC1B,CAAA;CACF;AAED,MAAM,WAAW,wCAAwC,CAAC,CAAC,GAAG,OAAO;IACnE,MAAM,EAAE,2BAA2B,CAAA;IACnC,MAAM,EAAE,2BAA2B,CAAA;IACnC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,eAAe,CAAC,EAAE,wBAAwB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IACpD,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,0BAA0B,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;CAChD;AAuJD,wBAAgB,iCAAiC,CAAC,CAAC,GAAG,OAAO,EAC3D,OAAO,EAAE,wCAAwC,CAAC,CAAC,CAAC,GACnD,2BAA2B,CAAC,CAAC,CAAC,CA0zBhC"}