@contextvm/sdk 0.10.0 → 0.11.1

package/dist/esm/transport/open-stream/session.js

@@ -0,0 +1,343 @@
+import { DEFAULT_OPEN_STREAM_CLOSE_GRACE_PERIOD_MS, DEFAULT_OPEN_STREAM_IDLE_TIMEOUT_MS, DEFAULT_OPEN_STREAM_PROBE_TIMEOUT_MS, } from './constants.js';
+import { OpenStreamAbortError, OpenStreamSequenceError } from './errors.js';
+function createDeferred() {
+    let resolve;
+    let reject;
+    const promise = new Promise((res, rej) => {
+        resolve = res;
+        reject = rej;
+    });
+    return { resolve, reject, promise };
+}
+/**
+ * Readable client-side/session-side view of a CEP-41 stream.
+ */
+export class OpenStreamSession {
+    constructor(options) {
+        var _a, _b, _c;
+        this.closeDeferred = createDeferred();
+        this.waiters = [];
+        this.queue = [];
+        this.bufferedChunks = new Map();
+        this.bufferedBytes = 0;
+        this.queuedBytes = 0;
+        this.active = true;
+        this.started = false;
+        this.closedRemotely = false;
+        this.nextExpectedChunkIndex = 0;
+        this.lastProgress = -1;
+        this.controlNonce = 0;
+        this.progressToken = options.progressToken;
+        this.maxBufferedChunks = options.maxBufferedChunks;
+        this.maxBufferedBytes = options.maxBufferedBytes;
+        this.idleTimeoutMs =
+            (_a = options.idleTimeoutMs) !== null && _a !== void 0 ? _a : DEFAULT_OPEN_STREAM_IDLE_TIMEOUT_MS;
+        this.probeTimeoutMs =
+            (_b = options.probeTimeoutMs) !== null && _b !== void 0 ? _b : DEFAULT_OPEN_STREAM_PROBE_TIMEOUT_MS;
+        this.closeGracePeriodMs =
+            (_c = options.closeGracePeriodMs) !== null && _c !== void 0 ? _c : DEFAULT_OPEN_STREAM_CLOSE_GRACE_PERIOD_MS;
+        this.sendPing = options.sendPing;
+        this.sendPong = options.sendPong;
+        this.sendAbort = options.sendAbort;
+        this.onAbort = options.onAbort;
+        this.onClose = options.onClose;
+        this.closed = this.closeDeferred.promise;
+    }
+    get isActive() {
+        return this.active;
+    }
+    async abort(reason) {
+        if (!this.active) {
+            return;
+        }
+        const error = new OpenStreamAbortError(this.progressToken, reason);
+        await this.finishAborted(error, reason, true);
+    }
+    dispose() {
+        this.finalize();
+    }
+    async processFrame(progress, frame) {
+        this.assertActive();
+        this.assertProgress(progress);
+        switch (frame.frameType) {
+            case 'start':
+                if (this.started) {
+                    throw new OpenStreamSequenceError(`Duplicate start frame for stream ${this.progressToken}`);
+                }
+                this.started = true;
+                this.refreshIdleTimer();
+                return;
+            case 'accept':
+                this.refreshIdleTimer();
+                return;
+            case 'ping':
+                this.assertStarted();
+                this.refreshIdleTimer();
+                await this.handlePing(frame);
+                return;
+            case 'pong':
+                this.assertStarted();
+                this.refreshIdleTimer();
+                this.handlePong(frame.nonce);
+                return;
+            case 'chunk':
+                this.assertStarted();
+                this.bufferChunk(frame);
+                this.flushContiguousChunks();
+                this.refreshIdleTimer();
+                return;
+            case 'close':
+                this.assertStarted();
+                this.closedRemotely = true;
+                this.closeState = {
+                    expectedLastChunkIndex: frame.lastChunkIndex,
+                };
+                this.flushContiguousChunks();
+                this.refreshIdleTimer();
+                this.maybeFinishGracefully();
+                this.armCloseGraceTimer();
+                return;
+            case 'abort':
+                this.refreshIdleTimer();
+                await this.finishAborted(new OpenStreamAbortError(this.progressToken, frame.reason), frame.reason, false);
+                return;
+            default:
+                return;
+        }
+    }
+    [Symbol.asyncIterator]() {
+        return {
+            next: async () => {
+                if (this.queue.length > 0) {
+                    const value = this.queue.shift();
+                    if (!value) {
+                        return { done: true, value: undefined };
+                    }
+                    this.queuedBytes -= Buffer.byteLength(value.value, 'utf8');
+                    return { done: false, value };
+                }
+                if (!this.active) {
+                    if (this.terminalError) {
+                        throw this.terminalError;
+                    }
+                    return { done: true, value: undefined };
+                }
+                const waiter = createDeferred();
+                this.waiters.push(waiter);
+                return waiter.promise;
+            },
+        };
+    }
+    assertActive() {
+        if (!this.active) {
+            throw new OpenStreamSequenceError(`Received frame for inactive stream ${this.progressToken}`);
+        }
+    }
+    assertStarted() {
+        if (!this.started) {
+            throw new OpenStreamSequenceError(`Received non-start frame before start for ${this.progressToken}`);
+        }
+    }
+    assertProgress(progress) {
+        if (!Number.isFinite(progress) || progress <= this.lastProgress) {
+            throw new OpenStreamSequenceError(`Non-increasing progress for stream ${this.progressToken}`);
+        }
+        this.lastProgress = progress;
+    }
+    bufferChunk(frame) {
+        if (!Number.isInteger(frame.chunkIndex) || frame.chunkIndex < 0) {
+            throw new OpenStreamSequenceError(`Invalid chunkIndex for stream ${this.progressToken}`);
+        }
+        if (frame.chunkIndex < this.nextExpectedChunkIndex) {
+            throw new OpenStreamSequenceError(`Stale chunkIndex ${frame.chunkIndex} for ${this.progressToken}`);
+        }
+        if (this.bufferedChunks.has(frame.chunkIndex)) {
+            throw new OpenStreamSequenceError(`Duplicate chunkIndex ${frame.chunkIndex} for ${this.progressToken}`);
+        }
+        const chunkBytes = Buffer.byteLength(frame.data, 'utf8');
+        if (this.bufferedChunks.size + this.queue.length >=
+            this.maxBufferedChunks) {
+            throw new OpenStreamSequenceError(`Buffered chunk limit exceeded for stream ${this.progressToken}`);
+        }
+        if (this.bufferedBytes + this.queuedBytes + chunkBytes >
+            this.maxBufferedBytes) {
+            throw new OpenStreamSequenceError(`Buffered byte limit exceeded for stream ${this.progressToken}`);
+        }
+        this.bufferedChunks.set(frame.chunkIndex, frame.data);
+        this.bufferedBytes += chunkBytes;
+    }
+    flushContiguousChunks() {
+        while (this.bufferedChunks.has(this.nextExpectedChunkIndex)) {
+            const data = this.bufferedChunks.get(this.nextExpectedChunkIndex);
+            if (typeof data !== 'string') {
+                break;
+            }
+            this.bufferedChunks.delete(this.nextExpectedChunkIndex);
+            this.bufferedBytes -= Buffer.byteLength(data, 'utf8');
+            this.emit({ value: data, chunkIndex: this.nextExpectedChunkIndex });
+            this.nextExpectedChunkIndex += 1;
+        }
+        if (this.closedRemotely) {
+            this.maybeFinishGracefully();
+        }
+    }
+    emit(value) {
+        const waiter = this.waiters.shift();
+        if (waiter) {
+            waiter.resolve({ done: false, value });
+            return;
+        }
+        this.queuedBytes += Buffer.byteLength(value.value, 'utf8');
+        this.queue.push(value);
+    }
+    maybeFinishGracefully() {
+        var _a;
+        if (!this.closedRemotely || this.bufferedChunks.size > 0) {
+            return;
+        }
+        const expectedLastChunkIndex = (_a = this.closeState) === null || _a === void 0 ? void 0 : _a.expectedLastChunkIndex;
+        if (expectedLastChunkIndex !== undefined) {
+            if (!Number.isInteger(expectedLastChunkIndex) ||
+                expectedLastChunkIndex < 0) {
+                throw new OpenStreamSequenceError(`Invalid lastChunkIndex for stream ${this.progressToken}`);
+            }
+            if (this.nextExpectedChunkIndex !== expectedLastChunkIndex + 1) {
+                throw new OpenStreamSequenceError(`Incomplete stream for ${this.progressToken}: expected chunks through ${expectedLastChunkIndex}`);
+            }
+        }
+        void this.finishClosed().catch(() => undefined);
+    }
+    async handlePing(frame) {
+        var _a;
+        await ((_a = this.sendPong) === null || _a === void 0 ? void 0 : _a.call(this, frame.nonce));
+    }
+    handlePong(nonce) {
+        if (this.pendingProbeNonce !== nonce) {
+            return;
+        }
+        this.pendingProbeNonce = undefined;
+        this.clearProbeTimer();
+    }
+    refreshIdleTimer() {
+        if (!this.active || this.closedRemotely) {
+            return;
+        }
+        this.clearIdleTimer();
+        this.idleTimer = setTimeout(() => {
+            this.handleIdleTimeout().catch(() => undefined);
+        }, this.idleTimeoutMs);
+    }
+    async handleIdleTimeout() {
+        var _a;
+        if (!this.active || this.closedRemotely || this.pendingProbeNonce) {
+            return;
+        }
+        const nonce = this.nextControlNonce();
+        this.pendingProbeNonce = nonce;
+        try {
+            await ((_a = this.sendPing) === null || _a === void 0 ? void 0 : _a.call(this, nonce));
+        }
+        catch (error) {
+            await this.finishAborted(error instanceof Error ? error : new Error(String(error)), 'Failed to send keepalive ping', false);
+            return;
+        }
+        this.clearProbeTimer();
+        this.probeTimer = setTimeout(() => {
+            this.handleProbeTimeout(nonce).catch(() => undefined);
+        }, this.probeTimeoutMs);
+    }
+    async handleProbeTimeout(nonce) {
+        if (!this.active || this.pendingProbeNonce !== nonce) {
+            return;
+        }
+        await this.finishAborted(new OpenStreamAbortError(this.progressToken, 'Probe timeout'), 'Probe timeout', true);
+    }
+    armCloseGraceTimer() {
+        if (!this.active ||
+            !this.closedRemotely ||
+            this.bufferedChunks.size === 0) {
+            return;
+        }
+        this.clearCloseGraceTimer();
+        this.closeGraceTimer = setTimeout(() => {
+            this.handleCloseGraceTimeout().catch(() => undefined);
+        }, this.closeGracePeriodMs);
+    }
+    async handleCloseGraceTimeout() {
+        if (!this.active ||
+            !this.closedRemotely ||
+            this.bufferedChunks.size === 0) {
+            return;
+        }
+        await this.finishAborted(new OpenStreamAbortError(this.progressToken, 'Close grace period expired'), 'Close grace period expired', true);
+    }
+    nextControlNonce() {
+        this.controlNonce += 1;
+        return `${this.progressToken}:${this.controlNonce}`;
+    }
+    clearIdleTimer() {
+        if (this.idleTimer) {
+            clearTimeout(this.idleTimer);
+            this.idleTimer = undefined;
+        }
+    }
+    clearProbeTimer() {
+        if (this.probeTimer) {
+            clearTimeout(this.probeTimer);
+            this.probeTimer = undefined;
+        }
+    }
+    clearCloseGraceTimer() {
+        if (this.closeGraceTimer) {
+            clearTimeout(this.closeGraceTimer);
+            this.closeGraceTimer = undefined;
+        }
+    }
+    clearTimers() {
+        this.clearIdleTimer();
+        this.clearProbeTimer();
+        this.clearCloseGraceTimer();
+        this.pendingProbeNonce = undefined;
+    }
+    finalize(error) {
+        if (!this.active) {
+            return;
+        }
+        this.clearTimers();
+        this.active = false;
+        this.terminalError = error;
+        this.queuedBytes = 0;
+        while (this.waiters.length > 0) {
+            const waiter = this.waiters.shift();
+            if (!waiter) {
+                continue;
+            }
+            if (error) {
+                waiter.reject(error);
+            }
+            else {
+                waiter.resolve({ done: true, value: undefined });
+            }
+        }
+        if (error) {
+            this.closeDeferred.reject(error);
+        }
+        else {
+            this.closeDeferred.resolve(undefined);
+        }
+    }
+    async finishClosed() {
+        var _a;
+        this.finalize();
+        await ((_a = this.onClose) === null || _a === void 0 ? void 0 : _a.call(this));
+    }
+    async finishAborted(error, reason, publishAbort = false) {
+        var _a, _b;
+        this.finalize(error);
+        if (publishAbort) {
+            await ((_a = this.sendAbort) === null || _a === void 0 ? void 0 : _a.call(this, reason));
+        }
+        await ((_b = this.onAbort) === null || _b === void 0 ? void 0 : _b.call(this, reason));
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/esm/transport/open-stream/session.js.map

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

package/dist/esm/transport/open-stream/types.d.ts

@@ -0,0 +1,52 @@
+export type OpenStreamFrameType = 'start' | 'accept' | 'chunk' | 'ping' | 'pong' | 'close' | 'abort';
+export type OpenStreamCommon = {
+    type: 'open-stream';
+    frameType: OpenStreamFrameType;
+};
+export type OpenStreamStartFrame = OpenStreamCommon & {
+    frameType: 'start';
+    contentType?: string;
+};
+export type OpenStreamAcceptFrame = OpenStreamCommon & {
+    frameType: 'accept';
+};
+export type OpenStreamChunkFrame = OpenStreamCommon & {
+    frameType: 'chunk';
+    chunkIndex: number;
+    data: string;
+};
+export type OpenStreamPingFrame = OpenStreamCommon & {
+    frameType: 'ping';
+    nonce: string;
+};
+export type OpenStreamPongFrame = OpenStreamCommon & {
+    frameType: 'pong';
+    nonce: string;
+};
+export type OpenStreamCloseFrame = OpenStreamCommon & {
+    frameType: 'close';
+    lastChunkIndex?: number;
+};
+export type OpenStreamAbortFrame = OpenStreamCommon & {
+    frameType: 'abort';
+    reason?: string;
+};
+export type OpenStreamFrame = OpenStreamStartFrame | OpenStreamAcceptFrame | OpenStreamChunkFrame | OpenStreamPingFrame | OpenStreamPongFrame | OpenStreamCloseFrame | OpenStreamAbortFrame;
+export type OpenStreamProgress = {
+    progressToken: string | number;
+    progress: number;
+    message?: string;
+    total?: number;
+    cvm: OpenStreamFrame;
+};
+export interface OpenStreamReadResult<TChunk = string> {
+    readonly value: TChunk;
+    readonly chunkIndex: number;
+}
+export interface OpenStreamSessionLike<TChunk = string> extends AsyncIterable<OpenStreamReadResult<TChunk>> {
+    readonly progressToken: string;
+    readonly isActive: boolean;
+    readonly closed: Promise<void>;
+    abort(reason?: string): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/transport/open-stream/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/transport/open-stream/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAC3B,OAAO,GACP,QAAQ,GACR,OAAO,GACP,MAAM,GACN,MAAM,GACN,OAAO,GACP,OAAO,CAAC;AAEZ,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,mBAAmB,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG;IACpD,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG;IACrD,SAAS,EAAE,QAAQ,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG;IACpD,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,GAAG;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,GAAG;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG;IACpD,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG;IACpD,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,GACvB,oBAAoB,GACpB,qBAAqB,GACrB,oBAAoB,GACpB,mBAAmB,GACnB,mBAAmB,GACnB,oBAAoB,GACpB,oBAAoB,CAAC;AAEzB,MAAM,MAAM,kBAAkB,GAAG;IAC/B,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,eAAe,CAAC;CACtB,CAAC;AAEF,MAAM,WAAW,oBAAoB,CAAC,MAAM,GAAG,MAAM;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB,CAAC,MAAM,GAAG,MAAM,CAAE,SAAQ,aAAa,CAC3E,oBAAoB,CAAC,MAAM,CAAC,CAC7B;IACC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC"}

package/dist/esm/transport/open-stream/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/transport/open-stream/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/transport/open-stream/types.ts"],"names":[],"mappings":""}

package/dist/esm/transport/open-stream/writer.d.ts

@@ -0,0 +1,38 @@
+import type { OpenStreamProgress } from './types.js';
+export type OpenStreamFramePublisher = (frame: OpenStreamProgress) => Promise<string | undefined>;
+export interface OpenStreamWriterOptions {
+    progressToken: string;
+    publishFrame: OpenStreamFramePublisher;
+    contentType?: string;
+    onClose?: () => Promise<void>;
+    onAbort?: (reason?: string) => Promise<void>;
+}
+/**
+ * Minimal CEP-41 writer/session for server-side production.
+ */
+export declare class OpenStreamWriter {
+    readonly progressToken: string;
+    private readonly publishFrame;
+    private readonly contentType;
+    private readonly onClose?;
+    private readonly onAbort?;
+    private progress;
+    private chunkIndex;
+    private controlNonce;
+    private started;
+    private active;
+    private operationQueue;
+    constructor(options: OpenStreamWriterOptions);
+    get isActive(): boolean;
+    start(): Promise<void>;
+    write(data: string): Promise<void>;
+    ping(): Promise<void>;
+    pong(nonce: string): Promise<void>;
+    close(): Promise<void>;
+    abort(reason?: string): Promise<void>;
+    private startInternal;
+    private enqueue;
+    private nextProgress;
+    private nextControlNonce;
+}
+//# sourceMappingURL=writer.d.ts.map

package/dist/esm/transport/open-stream/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../../../src/transport/open-stream/writer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAUrD,MAAM,MAAM,wBAAwB,GAAG,CACrC,KAAK,EAAE,kBAAkB,KACtB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AAEjC,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,wBAAwB,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,SAAgB,aAAa,EAAE,MAAM,CAAC;IAEtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2B;IACxD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAsB;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAqC;IAC9D,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,cAAc,CAAoC;gBAE9C,OAAO,EAAE,uBAAuB;IAQ5C,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAEY,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBlC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBrB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBtB,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAkBpC,aAAa;YAeb,OAAO;IAMrB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,gBAAgB;CAIzB"}

package/dist/esm/transport/open-stream/writer.js

@@ -0,0 +1,123 @@
+import { buildOpenStreamAbortFrame, buildOpenStreamChunkFrame, buildOpenStreamCloseFrame, buildOpenStreamPingFrame, buildOpenStreamPongFrame, buildOpenStreamStartFrame, } from './frames.js';
+/**
+ * Minimal CEP-41 writer/session for server-side production.
+ */
+export class OpenStreamWriter {
+    constructor(options) {
+        this.progress = 0;
+        this.chunkIndex = 0;
+        this.controlNonce = 0;
+        this.started = false;
+        this.active = true;
+        this.operationQueue = Promise.resolve();
+        this.progressToken = options.progressToken;
+        this.publishFrame = options.publishFrame;
+        this.contentType = options.contentType;
+        this.onClose = options.onClose;
+        this.onAbort = options.onAbort;
+    }
+    get isActive() {
+        return this.active;
+    }
+    async start() {
+        await this.enqueue(async () => {
+            await this.startInternal();
+        });
+    }
+    async write(data) {
+        await this.enqueue(async () => {
+            await this.startInternal();
+            if (!this.active) {
+                return;
+            }
+            await this.publishFrame(buildOpenStreamChunkFrame({
+                progressToken: this.progressToken,
+                progress: this.nextProgress(),
+                chunkIndex: this.chunkIndex,
+                data,
+            }));
+            this.chunkIndex += 1;
+        });
+    }
+    async ping() {
+        await this.enqueue(async () => {
+            if (!this.active) {
+                return;
+            }
+            const progress = this.nextProgress();
+            await this.publishFrame(buildOpenStreamPingFrame({
+                progressToken: this.progressToken,
+                progress,
+                nonce: this.nextControlNonce(),
+            }));
+        });
+    }
+    async pong(nonce) {
+        await this.enqueue(async () => {
+            if (!this.active) {
+                return;
+            }
+            await this.publishFrame(buildOpenStreamPongFrame({
+                progressToken: this.progressToken,
+                progress: this.nextProgress(),
+                nonce,
+            }));
+        });
+    }
+    async close() {
+        await this.enqueue(async () => {
+            var _a;
+            await this.startInternal();
+            if (!this.active) {
+                return;
+            }
+            this.active = false;
+            await this.publishFrame(buildOpenStreamCloseFrame({
+                progressToken: this.progressToken,
+                progress: this.nextProgress(),
+                lastChunkIndex: this.chunkIndex > 0 ? this.chunkIndex - 1 : undefined,
+            }));
+            await ((_a = this.onClose) === null || _a === void 0 ? void 0 : _a.call(this));
+        });
+    }
+    async abort(reason) {
+        await this.enqueue(async () => {
+            var _a;
+            if (!this.active) {
+                return;
+            }
+            this.active = false;
+            await this.publishFrame(buildOpenStreamAbortFrame({
+                progressToken: this.progressToken,
+                progress: this.nextProgress(),
+                reason,
+            }));
+            await ((_a = this.onAbort) === null || _a === void 0 ? void 0 : _a.call(this, reason));
+        });
+    }
+    async startInternal() {
+        if (this.started || !this.active) {
+            return;
+        }
+        this.started = true;
+        await this.publishFrame(buildOpenStreamStartFrame({
+            progressToken: this.progressToken,
+            progress: this.nextProgress(),
+            contentType: this.contentType,
+        }));
+    }
+    async enqueue(operation) {
+        const pending = this.operationQueue.then(operation);
+        this.operationQueue = pending.catch(() => undefined);
+        await pending;
+    }
+    nextProgress() {
+        this.progress += 1;
+        return this.progress;
+    }
+    nextControlNonce() {
+        this.controlNonce += 1;
+        return `${this.progressToken}:${this.controlNonce}`;
+    }
+}
+//# sourceMappingURL=writer.js.map

package/dist/esm/transport/open-stream/writer.js.map

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

package/dist/esm/transport/open-stream-policy.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shared policy options for CEP-41 open-stream lifecycle and buffering.
+ */
+export interface OpenStreamTransportPolicy {
+    maxConcurrentStreams?: number;
+    maxBufferedChunksPerStream?: number;
+    maxBufferedBytesPerStream?: number;
+    idleTimeoutMs?: number;
+    probeTimeoutMs?: number;
+    closeGracePeriodMs?: number;
+}
+//# sourceMappingURL=open-stream-policy.d.ts.map

package/dist/esm/transport/open-stream-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-stream-policy.d.ts","sourceRoot":"","sources":["../../../src/transport/open-stream-policy.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/esm/transport/open-stream-policy.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=open-stream-policy.js.map

package/dist/esm/transport/open-stream-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-stream-policy.js","sourceRoot":"","sources":["../../../src/transport/open-stream-policy.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contextvm/sdk",
-  "version": "0.10.0",
+  "version": "0.11.1",
   "description": "ContextVM SDK for JavaScript/TypeScript",
   "license": "LGPL-3.0-1",
   "author": "ContextVM",