@trigger.dev/core 0.0.0-python-preview-20250226140121 → 0.0.0-rc-4-8-0-20261021151928

package/dist/esm/v3/sessionStreams/index.d.ts

@@ -0,0 +1,32 @@
+import type { InputStreamOncePromise, SessionChannelIO, SessionStreamManager, SessionStreamRecord, SessionStreamRecordPredicate } from "./types.js";
+import type { InputStreamOnceOptions } from "../realtimeStreams/types.js";
+export declare class SessionStreamsAPI implements SessionStreamManager {
+    #private;
+    private static _instance?;
+    private constructor();
+    static getInstance(): SessionStreamsAPI;
+    setGlobalManager(manager: SessionStreamManager): boolean;
+    on(sessionId: string, io: SessionChannelIO, handler: (data: unknown) => void | boolean | Promise<void>, channel?: string): {
+        off: () => void;
+    };
+    onRecord(sessionId: string, io: SessionChannelIO, handler: (record: SessionStreamRecord) => void | boolean | Promise<void>, channel?: string): {
+        off: () => void;
+    };
+    once(sessionId: string, io: SessionChannelIO, options?: InputStreamOnceOptions, channel?: string): InputStreamOncePromise<unknown>;
+    onceRecord(sessionId: string, io: SessionChannelIO, options?: InputStreamOnceOptions, channel?: string): InputStreamOncePromise<SessionStreamRecord>;
+    onceRecordWhere(sessionId: string, io: SessionChannelIO, predicate: SessionStreamRecordPredicate, options?: InputStreamOnceOptions, channel?: string): InputStreamOncePromise<SessionStreamRecord>;
+    peek(sessionId: string, io: SessionChannelIO, channel?: string): unknown | undefined;
+    peekRecord(sessionId: string, io: SessionChannelIO, channel?: string): SessionStreamRecord | undefined;
+    lastSeqNum(sessionId: string, io: SessionChannelIO, channel?: string): number | undefined;
+    setLastSeqNum(sessionId: string, io: SessionChannelIO, seqNum: number, channel?: string): void;
+    consumeRecord(sessionId: string, io: SessionChannelIO, seqNum: number, channel?: string): void;
+    lastDispatchedSeqNum(sessionId: string, io: SessionChannelIO, channel?: string): number | undefined;
+    setLastDispatchedSeqNum(sessionId: string, io: SessionChannelIO, seqNum: number, channel?: string): void;
+    setMinTimestamp(sessionId: string, io: SessionChannelIO, minTimestamp: number | undefined, channel?: string): void;
+    shiftBuffer(sessionId: string, io: SessionChannelIO, channel?: string): boolean;
+    reconnectStream(sessionId: string, io: SessionChannelIO, channel?: string): void;
+    disconnectStream(sessionId: string, io: SessionChannelIO, channel?: string): void;
+    clearHandlers(): void;
+    reset(): void;
+    disconnect(): void;
+}

package/dist/esm/v3/sessionStreams/index.js

@@ -0,0 +1,98 @@
+import { getGlobal, registerGlobal } from "../utils/globals.js";
+import { NoopSessionStreamManager } from "./noopManager.js";
+const API_NAME = "session-streams";
+const NOOP_MANAGER = new NoopSessionStreamManager();
+export class SessionStreamsAPI {
+    static _instance;
+    constructor() { }
+    static getInstance() {
+        if (!this._instance) {
+            this._instance = new SessionStreamsAPI();
+        }
+        return this._instance;
+    }
+    setGlobalManager(manager) {
+        return registerGlobal(API_NAME, manager);
+    }
+    #getManager() {
+        return getGlobal(API_NAME) ?? NOOP_MANAGER;
+    }
+    on(sessionId, io, handler, channel) {
+        return this.#getManager().on(sessionId, io, handler, channel);
+    }
+    onRecord(sessionId, io, handler, channel) {
+        const manager = this.#getManager();
+        if (!manager.onRecord) {
+            throw new Error("The configured Session stream manager does not support record handlers");
+        }
+        return manager.onRecord(sessionId, io, handler, channel);
+    }
+    once(sessionId, io, options, channel) {
+        return this.#getManager().once(sessionId, io, options, channel);
+    }
+    onceRecord(sessionId, io, options, channel) {
+        const manager = this.#getManager();
+        if (!manager.onceRecord) {
+            throw new Error("The configured Session stream manager does not support record metadata");
+        }
+        return manager.onceRecord(sessionId, io, options, channel);
+    }
+    onceRecordWhere(sessionId, io, predicate, options, channel) {
+        const manager = this.#getManager();
+        if (!manager.onceRecordWhere) {
+            throw new Error("The configured Session stream manager does not support selective records");
+        }
+        return manager.onceRecordWhere(sessionId, io, predicate, options, channel);
+    }
+    peek(sessionId, io, channel) {
+        return this.#getManager().peek(sessionId, io, channel);
+    }
+    peekRecord(sessionId, io, channel) {
+        const manager = this.#getManager();
+        if (!manager.peekRecord) {
+            throw new Error("The configured Session stream manager does not support record metadata");
+        }
+        return manager.peekRecord(sessionId, io, channel);
+    }
+    lastSeqNum(sessionId, io, channel) {
+        return this.#getManager().lastSeqNum(sessionId, io, channel);
+    }
+    setLastSeqNum(sessionId, io, seqNum, channel) {
+        this.#getManager().setLastSeqNum(sessionId, io, seqNum, channel);
+    }
+    consumeRecord(sessionId, io, seqNum, channel) {
+        const manager = this.#getManager();
+        if (!manager.consumeRecord) {
+            throw new Error("The configured Session stream manager does not support exact consumption");
+        }
+        manager.consumeRecord(sessionId, io, seqNum, channel);
+    }
+    lastDispatchedSeqNum(sessionId, io, channel) {
+        return this.#getManager().lastDispatchedSeqNum(sessionId, io, channel);
+    }
+    setLastDispatchedSeqNum(sessionId, io, seqNum, channel) {
+        this.#getManager().setLastDispatchedSeqNum(sessionId, io, seqNum, channel);
+    }
+    setMinTimestamp(sessionId, io, minTimestamp, channel) {
+        this.#getManager().setMinTimestamp(sessionId, io, minTimestamp, channel);
+    }
+    shiftBuffer(sessionId, io, channel) {
+        return this.#getManager().shiftBuffer(sessionId, io, channel);
+    }
+    reconnectStream(sessionId, io, channel) {
+        this.#getManager().reconnectStream?.(sessionId, io, channel);
+    }
+    disconnectStream(sessionId, io, channel) {
+        this.#getManager().disconnectStream(sessionId, io, channel);
+    }
+    clearHandlers() {
+        this.#getManager().clearHandlers();
+    }
+    reset() {
+        this.#getManager().reset();
+    }
+    disconnect() {
+        this.#getManager().disconnect();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/v3/sessionStreams/index.js.map

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

package/dist/esm/v3/sessionStreams/manager.d.ts

@@ -0,0 +1,79 @@
+import type { ApiClient } from "../apiClient/index.js";
+import { InputStreamOncePromise } from "../inputStreams/types.js";
+import type { InputStreamOnceOptions } from "../realtimeStreams/types.js";
+import type { SessionChannelIO, SessionStreamManager, SessionStreamRecord, SessionStreamRecordPredicate } from "./types.js";
+type SessionStreamHandler = (data: unknown) => void | boolean | Promise<void>;
+/**
+ * A handler that sees the whole record rather than just its payload. Consumers
+ * that route by sequence number need the metadata, the same reason
+ * `onceRecord` exists alongside `once`.
+ */
+type SessionStreamRecordHandler = (record: SessionStreamRecord) => void | boolean | Promise<void>;
+/**
+ * Session-scoped parallel to {@link StandardInputStreamManager}. Keeps the
+ * same buffer / once-waiter / tail lifecycle, but keyed on
+ * `(sessionId, io)` and subscribing via
+ * {@link ApiClient.subscribeToSessionStream} instead of the run input
+ * stream SSE.
+ */
+export declare class StandardSessionStreamManager implements SessionStreamManager {
+    #private;
+    private apiClient;
+    private baseUrl;
+    private debug;
+    private handlers;
+    private onceWaiters;
+    private buffer;
+    private tails;
+    private minTimestamps;
+    private explicitlyDisconnected;
+    private seqNums;
+    private unconsumedSeqNums;
+    private lastDispatchedSeqNums;
+    private reconnectAttempts;
+    constructor(apiClient: ApiClient, baseUrl: string, debug?: boolean);
+    on(sessionId: string, io: SessionChannelIO, handler: SessionStreamHandler, channel?: string): {
+        off: () => void;
+    };
+    /**
+     * Register a handler that receives the full record, including its sequence
+     * number. Same consume semantics as {@link on}: returning `true` consumes.
+     */
+    onRecord(sessionId: string, io: SessionChannelIO, handler: SessionStreamRecordHandler, channel?: string): {
+        off: () => void;
+    };
+    once(sessionId: string, io: SessionChannelIO, options?: InputStreamOnceOptions, channel?: string): InputStreamOncePromise<unknown>;
+    onceRecord(sessionId: string, io: SessionChannelIO, options?: InputStreamOnceOptions, channel?: string): InputStreamOncePromise<SessionStreamRecord>;
+    onceRecordWhere(sessionId: string, io: SessionChannelIO, predicate: SessionStreamRecordPredicate, options?: InputStreamOnceOptions, channel?: string): InputStreamOncePromise<SessionStreamRecord>;
+    peek(sessionId: string, io: SessionChannelIO, channel?: string): unknown | undefined;
+    peekRecord(sessionId: string, io: SessionChannelIO, channel?: string): SessionStreamRecord | undefined;
+    lastSeqNum(sessionId: string, io: SessionChannelIO, channel?: string): number | undefined;
+    setLastSeqNum(sessionId: string, io: SessionChannelIO, seqNum: number, channel?: string): void;
+    consumeRecord(sessionId: string, io: SessionChannelIO, seqNum: number, channel?: string): void;
+    lastDispatchedSeqNum(sessionId: string, io: SessionChannelIO, channel?: string): number | undefined;
+    setLastDispatchedSeqNum(sessionId: string, io: SessionChannelIO, seqNum: number, channel?: string): void;
+    setMinTimestamp(sessionId: string, io: SessionChannelIO, minTimestamp: number | undefined, channel?: string): void;
+    shiftBuffer(sessionId: string, io: SessionChannelIO, channel?: string): boolean;
+    disconnectStream(sessionId: string, io: SessionChannelIO, channel?: string): void;
+    /**
+     * Re-open a channel that `disconnectStream` closed, without registering a
+     * new consumer. A single long-lived reader (the session channel router) has
+     * to be able to bring its own tail back after a suspend, and re-attaching
+     * its handler just to clear the suppression flag would replay the buffer at
+     * it.
+     */
+    reconnectStream(sessionId: string, io: SessionChannelIO, channel?: string): void;
+    clearHandlers(): void;
+    /**
+     * Tear down all active tails. Does NOT clear handlers or `onceWaiters`,
+     * so any registered listener will trigger an auto-reconnect (with
+     * backoff) the moment it sees no live tail — by design, so a transient
+     * network blip recovers without the caller re-subscribing. Use
+     * `reset()` if you want a full clean state with no resurrection, or
+     * `disconnectStream(sessionId, io)` for a single channel that should
+     * stay down until a fresh `on()` / `once()` attaches.
+     */
+    disconnect(): void;
+    reset(): void;
+}
+export {};