@agentick/server 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @agentick/server - Server SDK for Agentick
+ *
+ * Provides server-side components for running Agentick applications:
+ * - SSE streaming utilities
+ * - SSE utilities for streaming
+ *
+ * This package provides hooks and handlers that your web framework
+ * routes can call into. It does NOT define routes - that's your
+ * application's responsibility.
+ *
+ * @example
+ * ```typescript
+ * import { createSSEWriter, setSSEHeaders } from '@agentick/server';
+ *
+ * app.get('/events', (req, res) => {
+ *   setSSEHeaders(res);
+ *   const writer = createSSEWriter(res);
+ *   writer.writeEvent({ channel: 'session:events', type: 'ping', payload: {} });
+ * });
+ * ```
+ *
+ * @module @agentick/server
+ */
+export { createSSEWriter, streamToSSE, setSSEHeaders } from "./sse";
+export { extractToken, validateAuth, type AuthConfig, type AuthResult } from "./auth";
+export type { ChannelEvent, ChannelEventMetadata, ConnectionMetadata, ProtocolError, SessionResultPayload, ToolConfirmationRequest, ToolConfirmationResponse, SessionState, CreateSessionResponse, SSEWriter, SSEWriterOptions, } from "./types";
+export { FrameworkChannels, ErrorCodes } from "./types";
+//# 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;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAGpE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAC;AAGtF,YAAY,EAEV,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,YAAY,EACZ,qBAAqB,EAGrB,SAAS,EACT,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,31 @@
+/**
+ * @agentick/server - Server SDK for Agentick
+ *
+ * Provides server-side components for running Agentick applications:
+ * - SSE streaming utilities
+ * - SSE utilities for streaming
+ *
+ * This package provides hooks and handlers that your web framework
+ * routes can call into. It does NOT define routes - that's your
+ * application's responsibility.
+ *
+ * @example
+ * ```typescript
+ * import { createSSEWriter, setSSEHeaders } from '@agentick/server';
+ *
+ * app.get('/events', (req, res) => {
+ *   setSSEHeaders(res);
+ *   const writer = createSSEWriter(res);
+ *   writer.writeEvent({ channel: 'session:events', type: 'ping', payload: {} });
+ * });
+ * ```
+ *
+ * @module @agentick/server
+ */
+// SSE utilities
+export { createSSEWriter, streamToSSE, setSSEHeaders } from "./sse";
+// Auth utilities
+export { extractToken, validateAuth } from "./auth";
+// Re-export constants
+export { FrameworkChannels, ErrorCodes } from "./types";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,gBAAgB;AAChB,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEpE,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAoC,MAAM,QAAQ,CAAC;AAoBtF,sBAAsB;AACtB,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}

package/dist/session-handler.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Session Handler - Orchestrates session lifecycle.
+ *
+ * The session handler provides core operations for managing sessions.
+ * It does NOT define routes - your web framework routes call these methods.
+ *
+ * @module @tentickle/server/session-handler
+ */
+import type { Session, SendResult } from "@tentickle/core/app";
+import type { StreamEvent } from "@tentickle/shared";
+import type { SessionHandler, SessionHandlerConfig, CreateSessionInput, SendInput, SessionStateInfo } from "./types.js";
+/**
+ * Session Handler implementation.
+ *
+ * @example
+ * ```typescript
+ * // Create the handler
+ * const sessionHandler = createSessionHandler({
+ *   app: myApp,
+ *   store: new InMemorySessionStore(),
+ * });
+ *
+ * // Use in your routes
+ * app.post('/sessions', async (req, res) => {
+ *   const { sessionId } = await sessionHandler.create(req.body);
+ *   res.json({ sessionId, status: 'created' });
+ * });
+ *
+ * app.post('/sessions/:id/messages', async (req, res) => {
+ *   const result = await sessionHandler.send(req.params.id, {
+ *     messages: [req.body],
+ *   });
+ *   res.json(result);
+ * });
+ *
+ * app.get('/sessions/:id/stream', async (req, res) => {
+ *   res.setHeader('Content-Type', 'text/event-stream');
+ *   for await (const event of sessionHandler.stream(req.params.id, {})) {
+ *     res.write(`data: ${JSON.stringify(event)}\n\n`);
+ *   }
+ *   res.end();
+ * });
+ * ```
+ */
+export declare class SessionHandlerImpl implements SessionHandler {
+    private app;
+    private store;
+    private defaultSessionOptions;
+    constructor(config: SessionHandlerConfig);
+    /**
+     * Create a new session.
+     */
+    create(input: CreateSessionInput): Promise<{
+        sessionId: string;
+        session: Session;
+    }>;
+    /**
+     * Send to a session and wait for result.
+     */
+    send(sessionId: string, input: SendInput): Promise<SendResult>;
+    /**
+     * Stream events from a session.
+     */
+    stream(sessionId: string, input: SendInput): AsyncIterable<StreamEvent>;
+    /**
+     * Get session by ID.
+     */
+    getSession(sessionId: string): Session | undefined;
+    /**
+     * Get session state.
+     */
+    getState(sessionId: string): SessionStateInfo | undefined;
+    /**
+     * Delete session.
+     */
+    delete(sessionId: string): boolean;
+    /**
+     * List all session IDs.
+     */
+    list(): string[];
+}
+/**
+ * Create a session handler.
+ *
+ * @example
+ * ```typescript
+ * const sessionHandler = createSessionHandler({
+ *   app,
+ *   store: new InMemorySessionStore(),
+ * });
+ * ```
+ */
+export declare function createSessionHandler(config: SessionHandlerConfig): SessionHandler;
+/**
+ * Session not found error.
+ */
+export declare class SessionNotFoundError extends Error {
+    readonly code = "SESSION_NOT_FOUND";
+    constructor(sessionId: string);
+}
+/**
+ * Session closed error.
+ */
+export declare class SessionClosedError extends Error {
+    readonly code = "SESSION_CLOSED";
+    constructor(sessionId: string);
+}
+//# sourceMappingURL=session-handler.d.ts.map

package/dist/session-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-handler.d.ts","sourceRoot":"","sources":["../src/session-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAO,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EAAW,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EAEpB,kBAAkB,EAClB,SAAS,EACT,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAgBpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,qBAAqB,CAA0B;gBAE3C,MAAM,EAAE,oBAAoB;IAMxC;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IA2BzF;;OAEG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAkBpE;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,aAAa,CAAC,WAAW,CAAC;IAoBvE;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIlD;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAgBzD;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIlC;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;CAGjB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CAEjF;AAMD;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,uBAAuB;gBAExB,SAAS,EAAE,MAAM;CAI9B;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,oBAAoB;gBAErB,SAAS,EAAE,MAAM;CAI9B"}

package/dist/session-handler.js

@@ -0,0 +1,197 @@
+/**
+ * Session Handler - Orchestrates session lifecycle.
+ *
+ * The session handler provides core operations for managing sessions.
+ * It does NOT define routes - your web framework routes call these methods.
+ *
+ * @module @tentickle/server/session-handler
+ */
+import { InMemorySessionStore } from "./session-store.js";
+// Generate UUID (works in Node.js)
+function generateId() {
+    if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+        return crypto.randomUUID();
+    }
+    // Fallback
+    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === "x" ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+/**
+ * Session Handler implementation.
+ *
+ * @example
+ * ```typescript
+ * // Create the handler
+ * const sessionHandler = createSessionHandler({
+ *   app: myApp,
+ *   store: new InMemorySessionStore(),
+ * });
+ *
+ * // Use in your routes
+ * app.post('/sessions', async (req, res) => {
+ *   const { sessionId } = await sessionHandler.create(req.body);
+ *   res.json({ sessionId, status: 'created' });
+ * });
+ *
+ * app.post('/sessions/:id/messages', async (req, res) => {
+ *   const result = await sessionHandler.send(req.params.id, {
+ *     messages: [req.body],
+ *   });
+ *   res.json(result);
+ * });
+ *
+ * app.get('/sessions/:id/stream', async (req, res) => {
+ *   res.setHeader('Content-Type', 'text/event-stream');
+ *   for await (const event of sessionHandler.stream(req.params.id, {})) {
+ *     res.write(`data: ${JSON.stringify(event)}\n\n`);
+ *   }
+ *   res.end();
+ * });
+ * ```
+ */
+export class SessionHandlerImpl {
+    app;
+    store;
+    defaultSessionOptions;
+    constructor(config) {
+        this.app = config.app;
+        this.store = config.store ?? new InMemorySessionStore();
+        this.defaultSessionOptions = config.defaultSessionOptions ?? {};
+    }
+    /**
+     * Create a new session.
+     */
+    async create(input) {
+        const sessionId = input.sessionId ?? generateId();
+        // Check if session already exists
+        if (this.store.has(sessionId)) {
+            const existing = this.store.get(sessionId);
+            return { sessionId, session: existing };
+        }
+        // Create session from app
+        const session = this.app.createSession({
+            ...this.defaultSessionOptions,
+        });
+        // Store session
+        this.store.set(sessionId, session);
+        // Queue initial messages if provided
+        if (input.messages && input.messages.length > 0) {
+            for (const msg of input.messages) {
+                session.queueMessage(msg);
+            }
+        }
+        return { sessionId, session };
+    }
+    /**
+     * Send to a session and wait for result.
+     */
+    async send(sessionId, input) {
+        const session = this.store.get(sessionId);
+        if (!session) {
+            throw new SessionNotFoundError(sessionId);
+        }
+        // Queue messages if provided
+        if (input.messages && input.messages.length > 0) {
+            for (const msg of input.messages) {
+                session.queueMessage(msg);
+            }
+        }
+        // Execute tick and await the result
+        const handle = session.tick(input.props);
+        return await handle.result;
+    }
+    /**
+     * Stream events from a session.
+     */
+    stream(sessionId, input) {
+        const session = this.store.get(sessionId);
+        if (!session) {
+            throw new SessionNotFoundError(sessionId);
+        }
+        // Queue messages if provided
+        if (input.messages && input.messages.length > 0) {
+            for (const msg of input.messages) {
+                session.queueMessage(msg);
+            }
+        }
+        // Execute tick and return event stream
+        const handle = session.tick(input.props);
+        // Return async iterable from handle
+        return handle;
+    }
+    /**
+     * Get session by ID.
+     */
+    getSession(sessionId) {
+        return this.store.get(sessionId);
+    }
+    /**
+     * Get session state.
+     */
+    getState(sessionId) {
+        const session = this.store.get(sessionId);
+        if (!session) {
+            return undefined;
+        }
+        const inspection = session.inspect();
+        return {
+            sessionId,
+            status: inspection.status,
+            tick: inspection.currentTick,
+            queuedMessages: inspection.queuedMessages.length,
+        };
+    }
+    /**
+     * Delete session.
+     */
+    delete(sessionId) {
+        return this.store.delete(sessionId);
+    }
+    /**
+     * List all session IDs.
+     */
+    list() {
+        return this.store.list();
+    }
+}
+/**
+ * Create a session handler.
+ *
+ * @example
+ * ```typescript
+ * const sessionHandler = createSessionHandler({
+ *   app,
+ *   store: new InMemorySessionStore(),
+ * });
+ * ```
+ */
+export function createSessionHandler(config) {
+    return new SessionHandlerImpl(config);
+}
+// ============================================================================
+// Errors
+// ============================================================================
+/**
+ * Session not found error.
+ */
+export class SessionNotFoundError extends Error {
+    code = "SESSION_NOT_FOUND";
+    constructor(sessionId) {
+        super(`Session not found: ${sessionId}`);
+        this.name = "SessionNotFoundError";
+    }
+}
+/**
+ * Session closed error.
+ */
+export class SessionClosedError extends Error {
+    code = "SESSION_CLOSED";
+    constructor(sessionId) {
+        super(`Session is closed: ${sessionId}`);
+        this.name = "SessionClosedError";
+    }
+}
+//# sourceMappingURL=session-handler.js.map

package/dist/session-handler.js.map

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

package/dist/session-store.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Session Store implementations.
+ *
+ * @module @tentickle/server/session-store
+ */
+import type { Session } from "@tentickle/core/app";
+import type { SessionStore } from "./types.js";
+/**
+ * In-memory session store.
+ *
+ * Suitable for:
+ * - Development
+ * - Testing
+ * - Single-instance deployments
+ *
+ * NOT suitable for:
+ * - Production multi-instance deployments
+ * - Persistent sessions across restarts
+ *
+ * @example
+ * ```typescript
+ * const store = new InMemorySessionStore();
+ *
+ * // Use with session handler
+ * const handler = createSessionHandler({
+ *   app,
+ *   store,
+ * });
+ * ```
+ */
+export declare class InMemorySessionStore implements SessionStore {
+    private sessions;
+    /**
+     * Get session by ID.
+     */
+    get(id: string): Session | undefined;
+    /**
+     * Store session.
+     */
+    set(id: string, session: Session): void;
+    /**
+     * Delete session.
+     */
+    delete(id: string): boolean;
+    /**
+     * List all session IDs.
+     */
+    list(): string[];
+    /**
+     * Check if session exists.
+     */
+    has(id: string): boolean;
+    /**
+     * Get number of sessions.
+     */
+    get size(): number;
+    /**
+     * Clear all sessions.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=session-store.d.ts.map

package/dist/session-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../src/session-store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,QAAQ,CAA8B;IAE9C;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIpC;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAIvC;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAS3B;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;IAIhB;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;CAMd"}

package/dist/session-store.js

@@ -0,0 +1,82 @@
+/**
+ * Session Store implementations.
+ *
+ * @module @tentickle/server/session-store
+ */
+/**
+ * In-memory session store.
+ *
+ * Suitable for:
+ * - Development
+ * - Testing
+ * - Single-instance deployments
+ *
+ * NOT suitable for:
+ * - Production multi-instance deployments
+ * - Persistent sessions across restarts
+ *
+ * @example
+ * ```typescript
+ * const store = new InMemorySessionStore();
+ *
+ * // Use with session handler
+ * const handler = createSessionHandler({
+ *   app,
+ *   store,
+ * });
+ * ```
+ */
+export class InMemorySessionStore {
+    sessions = new Map();
+    /**
+     * Get session by ID.
+     */
+    get(id) {
+        return this.sessions.get(id);
+    }
+    /**
+     * Store session.
+     */
+    set(id, session) {
+        this.sessions.set(id, session);
+    }
+    /**
+     * Delete session.
+     */
+    delete(id) {
+        const session = this.sessions.get(id);
+        if (session) {
+            session.close();
+            return this.sessions.delete(id);
+        }
+        return false;
+    }
+    /**
+     * List all session IDs.
+     */
+    list() {
+        return Array.from(this.sessions.keys());
+    }
+    /**
+     * Check if session exists.
+     */
+    has(id) {
+        return this.sessions.has(id);
+    }
+    /**
+     * Get number of sessions.
+     */
+    get size() {
+        return this.sessions.size;
+    }
+    /**
+     * Clear all sessions.
+     */
+    clear() {
+        for (const session of this.sessions.values()) {
+            session.close();
+        }
+        this.sessions.clear();
+    }
+}
+//# sourceMappingURL=session-store.js.map

package/dist/session-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../src/session-store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,oBAAoB;IACvB,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;IAE9C;;OAEG;IACH,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,EAAU,EAAE,OAAgB;QAC9B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,EAAU;QACf,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC7C,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/sse.d.ts

@@ -0,0 +1,71 @@
+/**
+ * SSE (Server-Sent Events) utilities.
+ *
+ * Provides helpers for streaming events to clients via SSE.
+ * Works with any web framework that supports writable streams.
+ *
+ * @module @agentick/server/sse
+ */
+import type { SSEWriter, SSEWriterOptions } from "./types";
+/**
+ * Create an SSE writer for a response stream.
+ *
+ * Works with any writable stream that has write() and end() methods
+ * (Node.js response, Express response, etc.).
+ *
+ * @example
+ * ```typescript
+ * // Express
+ * app.get('/events', (req, res) => {
+ *   setSSEHeaders(res);
+ *   const writer = createSSEWriter(res);
+ *
+ *   // Write events
+ *   writer.writeEvent({
+ *     channel: 'session:events',
+ *     type: 'content_delta',
+ *     payload: { delta: 'Hello' },
+ *   });
+ *
+ *   // Close when done
+ *   writer.close();
+ * });
+ * ```
+ */
+export declare function createSSEWriter(stream: {
+    write: (data: string) => void;
+    end: () => void;
+}, options?: SSEWriterOptions): SSEWriter;
+/**
+ * Stream an async iterable to SSE.
+ *
+ * @example
+ * ```typescript
+ * app.get('/sessions/:id/stream', async (req, res) => {
+ *   setSSEHeaders(res);
+ *
+ *   const stream = sessionHandler.stream(req.params.id, {});
+ *   await streamToSSE(res, stream, 'session:events');
+ * });
+ * ```
+ */
+export declare function streamToSSE<T>(stream: {
+    write: (data: string) => void;
+    end: () => void;
+}, events: AsyncIterable<T>, channel: string, options?: SSEWriterOptions): Promise<void>;
+/**
+ * Set SSE headers on a response.
+ *
+ * @example
+ * ```typescript
+ * app.get('/events', (req, res) => {
+ *   setSSEHeaders(res);
+ *   // ... write events
+ * });
+ * ```
+ */
+export declare function setSSEHeaders(res: {
+    setHeader: (name: string, value: string) => void;
+    flushHeaders?: () => void;
+}): void;
+//# sourceMappingURL=sse.d.ts.map

package/dist/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE;IAAE,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,IAAI,CAAA;CAAE,EAC1D,OAAO,GAAE,gBAAqB,GAC7B,SAAS,CAyDX;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,MAAM,EAAE;IAAE,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,IAAI,CAAA;CAAE,EAC1D,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EACxB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE;IACjC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B,GAAG,IAAI,CAWP"}