@thewhateverapp/platform 0.7.25 → 0.9.0

package/dist/realtime/index.js

@@ -0,0 +1,247 @@
+/**
+ * Realtime WebSocket Pub/Sub API
+ *
+ * Provides real-time messaging capabilities for tiles using
+ * Cloudflare Durable Objects with WebSocket hibernation.
+ *
+ * @example
+ * ```typescript
+ * import { getCloudflareContext } from '@opennextjs/cloudflare';
+ * import { configurePlatformEnv, getRealtime } from '@thewhateverapp/platform';
+ *
+ * export async function POST(req: NextRequest) {
+ *   // Configure env once per request
+ *   configurePlatformEnv(() => getCloudflareContext().env);
+ *
+ *   const realtime = await getRealtime();
+ *
+ *   // Publish to all subscribers
+ *   await realtime.publish('counter', { count: newCount });
+ *
+ *   return NextResponse.json({ success: true });
+ * }
+ * ```
+ */
+import { getPlatformEnv, isPlatformEnvConfigured } from '../env';
+/**
+ * Default base URL for HTTP-based realtime access
+ */
+const DEFAULT_REALTIME_URL = 'https://realtime.thewhatever.app';
+/**
+ * Cloudflare Durable Object-backed Realtime Provider
+ *
+ * Communicates with the RealtimeChannel Durable Object via HTTP
+ * to publish messages to connected WebSocket clients.
+ */
+class CloudflareRealtime {
+    stub;
+    constructor(stub) {
+        this.stub = stub;
+    }
+    async publish(channel, data, _options) {
+        const response = await this.stub.fetch('http://internal/publish', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ channel, data }),
+        });
+        if (!response.ok) {
+            const error = await response.json().catch(() => ({ error: 'Unknown error' }));
+            throw new Error(`Failed to publish: ${error.error}`);
+        }
+        return (await response.json());
+    }
+    async getStats() {
+        const response = await this.stub.fetch('http://internal/stats');
+        if (!response.ok) {
+            throw new Error('Failed to get realtime stats');
+        }
+        return (await response.json());
+    }
+    async isHealthy() {
+        try {
+            const response = await this.stub.fetch('http://internal/health');
+            return response.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+/**
+ * HTTP-based Realtime Provider
+ *
+ * Used when service bindings are not available (e.g., external services, testing).
+ * Authenticates via Platform API key (JWT).
+ */
+class HttpRealtime {
+    baseUrl;
+    apiKey;
+    fetchFn;
+    constructor(config) {
+        this.baseUrl = config.baseUrl || DEFAULT_REALTIME_URL;
+        this.apiKey = config.apiKey;
+        this.fetchFn = config.fetch || globalThis.fetch;
+    }
+    async publish(channel, data, _options) {
+        const response = await this.fetchFn(`${this.baseUrl}/publish`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({ channel, data }),
+        });
+        if (!response.ok) {
+            const error = await response.json().catch(() => ({ error: 'Unknown error' }));
+            throw new Error(`Failed to publish: ${error.error}`);
+        }
+        return (await response.json());
+    }
+    async getStats() {
+        // Stats endpoint doesn't require auth, but we pass it anyway
+        const response = await this.fetchFn(`${this.baseUrl}/stats`, {
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+        });
+        if (!response.ok) {
+            throw new Error('Failed to get realtime stats');
+        }
+        return (await response.json());
+    }
+    async isHealthy() {
+        try {
+            const response = await this.fetchFn(`${this.baseUrl}/health`);
+            return response.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+/**
+ * Create a Realtime instance using HTTP with API key authentication
+ *
+ * Use this when service bindings are not available (e.g., external services, testing).
+ * The API key must have 'realtime' or '*' permission.
+ *
+ * @param config - HTTP configuration with API key
+ * @returns Realtime provider instance
+ *
+ * @example
+ * ```typescript
+ * const realtime = createRealtimeHttp({
+ *   apiKey: 'wtvr_jwt_eyJ...',
+ *   baseUrl: 'https://realtime.thewhatever.app', // optional
+ * });
+ *
+ * await realtime.publish('counter', { count: 42 });
+ * ```
+ */
+export function createRealtimeHttp(config) {
+    if (!config.apiKey) {
+        throw new Error('API key is required for HTTP-based realtime access');
+    }
+    return new HttpRealtime(config);
+}
+/**
+ * Get a Realtime instance for the current request
+ *
+ * @param reqOrEnv - Optional: object with env property, or env object directly.
+ *                   If not provided, uses the env configured via configurePlatformEnv().
+ * @returns Realtime provider instance
+ *
+ * @example
+ * ```typescript
+ * // Using configured env (recommended)
+ * configurePlatformEnv(() => getCloudflareContext().env);
+ * const realtime = await getRealtime();
+ *
+ * // Or pass env directly
+ * const realtime = await getRealtime({ env });
+ * const realtime = await getRealtime(env);
+ * ```
+ */
+export async function getRealtime(reqOrEnv) {
+    let env;
+    // If no argument provided, use the configured env provider
+    if (!reqOrEnv) {
+        if (!isPlatformEnvConfigured()) {
+            throw new Error('getRealtime() called without env and configurePlatformEnv() was not called. ' +
+                'Either pass env directly: getRealtime({ env }) or call configurePlatformEnv(() => getCloudflareContext().env) first.');
+        }
+        env = getPlatformEnv();
+    }
+    else if ('env' in reqOrEnv) {
+        env = reqOrEnv.env;
+    }
+    else if ('REALTIME' in reqOrEnv) {
+        // Direct env object
+        env = reqOrEnv;
+    }
+    else {
+        env = reqOrEnv.env;
+    }
+    if (!env) {
+        throw new Error('No environment found. Ensure you are running in edge runtime.');
+    }
+    // Check for REALTIME Durable Object binding
+    if (!env.REALTIME) {
+        throw new Error('No REALTIME Durable Object binding found. ' +
+            'Add a service binding to the realtime-do worker in your wrangler.jsonc:\n' +
+            '  "services": [{ "binding": "REALTIME", "service": "realtime-do", "entrypoint": "RealtimeChannel" }]');
+    }
+    // Get APP_ID for channel isolation (one DO per app)
+    const appId = env.APP_ID || 'default';
+    // Get Durable Object ID from app ID (deterministic)
+    const id = env.REALTIME.idFromName(appId);
+    const stub = env.REALTIME.get(id);
+    return new CloudflareRealtime(stub);
+}
+/**
+ * Create a Realtime instance directly (for advanced usage)
+ *
+ * @param env - Environment with REALTIME binding
+ * @param appId - Optional app ID for isolation (defaults to env.APP_ID or 'default')
+ *
+ * @example
+ * ```typescript
+ * const realtime = createRealtime({ REALTIME: env.REALTIME }, 'my-app-id');
+ * await realtime.publish('channel', { data: 'value' });
+ * ```
+ */
+export function createRealtime(env, appId) {
+    if (!env.REALTIME) {
+        throw new Error('No REALTIME Durable Object binding found.');
+    }
+    const resolvedAppId = appId || env.APP_ID || 'default';
+    const id = env.REALTIME.idFromName(resolvedAppId);
+    const stub = env.REALTIME.get(id);
+    return new CloudflareRealtime(stub);
+}
+/**
+ * Get the WebSocket URL for connecting to realtime from the client
+ *
+ * This is typically used by the client SDK's useRealtime hook.
+ *
+ * @param appId - App ID for channel isolation
+ * @param channels - Optional initial channels to subscribe to
+ * @param baseUrl - Optional base URL (defaults to production)
+ *
+ * @example
+ * ```typescript
+ * const wsUrl = getRealtimeWebSocketUrl('my-app', ['counter', 'chat']);
+ * // Returns: wss://realtime.thewhatever.app/ws?appId=my-app&channels=counter,chat
+ * ```
+ */
+export function getRealtimeWebSocketUrl(appId, channels, baseUrl = 'wss://realtime.thewhatever.app') {
+    const url = new URL('/ws', baseUrl);
+    url.searchParams.set('appId', appId);
+    if (channels && channels.length > 0) {
+        url.searchParams.set('channels', channels.join(','));
+    }
+    return url.toString();
+}
+//# sourceMappingURL=index.js.map

package/dist/realtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/realtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAUH,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AAKjE;;GAEG;AACH,MAAM,oBAAoB,GAAG,kCAAkC,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,kBAAkB;IACd,IAAI,CAAoB;IAEhC,YAAY,IAAuB;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAe,EAAE,IAAa,EAAE,QAAyB;QACrE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,yBAAyB,EAAE;YAChE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;SACxC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;YAC9E,MAAM,IAAI,KAAK,CAAC,sBAAuB,KAA2B,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9E,CAAC;QAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAkB,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAEhE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAkB,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,SAAS;QACb,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;YACjE,OAAO,QAAQ,CAAC,EAAE,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,YAAY;IACR,OAAO,CAAS;IAChB,MAAM,CAAS;IACf,OAAO,CAAe;IAE9B,YAAY,MAA0B;QACpC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,oBAAoB,CAAC;QACtD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAe,EAAE,IAAa,EAAE,QAAyB;QACrE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,UAAU,EAAE;YAC7D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;aACvC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;SACxC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;YAC9E,MAAM,IAAI,KAAK,CAAC,sBAAuB,KAA2B,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9E,CAAC;QAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAkB,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,6DAA6D;QAC7D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,QAAQ,EAAE;YAC3D,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;aACvC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAkB,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,SAAS;QACb,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,SAAS,CAAC,CAAC;YAC9D,OAAO,QAAQ,CAAC,EAAE,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA0B;IAC3D,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAA6C;IAE7C,IAAI,GAA4B,CAAC;IAEjC,2DAA2D;IAC3D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,IAAI,CAAC,uBAAuB,EAAE,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CACb,8EAA8E;gBAC5E,sHAAsH,CACzH,CAAC;QACJ,CAAC;QACD,GAAG,GAAG,cAAc,EAAiB,CAAC;IACxC,CAAC;SAAM,IAAI,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC;IACrB,CAAC;SAAM,IAAI,UAAU,IAAI,QAAQ,EAAE,CAAC;QAClC,oBAAoB;QACpB,GAAG,GAAG,QAAuB,CAAC;IAChC,CAAC;SAAM,CAAC;QACN,GAAG,GAAI,QAAiC,CAAC,GAAG,CAAC;IAC/C,CAAC;IAED,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IAED,4CAA4C;IAC5C,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,4CAA4C;YAC1C,2EAA2E;YAC3E,sGAAsG,CACzG,CAAC;IACJ,CAAC;IAED,oDAAoD;IACpD,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,IAAI,SAAS,CAAC;IAEtC,oDAAoD;IACpD,MAAM,EAAE,GAAG,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAElC,OAAO,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,GAAgB,EAAE,KAAc;IAC7D,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,aAAa,GAAG,KAAK,IAAI,GAAG,CAAC,MAAM,IAAI,SAAS,CAAC;IACvD,MAAM,EAAE,GAAG,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAElC,OAAO,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAAa,EACb,QAAmB,EACnB,OAAO,GAAG,gCAAgC;IAE1C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACpC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAErC,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC"}

package/dist/realtime/types.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Realtime WebSocket Pub/Sub Types
+ *
+ * Provides type definitions for the realtime messaging system
+ * powered by Cloudflare Durable Objects.
+ */
+/**
+ * Message types for WebSocket communication
+ */
+export type RealtimeMessageType = 'subscribe' | 'unsubscribe' | 'publish' | 'ping' | 'pong' | 'data' | 'error' | 'connected' | 'subscribed' | 'unsubscribed';
+/**
+ * Base message structure for realtime communication
+ */
+export interface RealtimeMessage {
+    type: RealtimeMessageType;
+    channel?: string;
+    channels?: string[];
+    data?: unknown;
+    timestamp?: number;
+    message?: string;
+}
+/**
+ * Options for publishing messages
+ */
+export interface PublishOptions {
+    /**
+     * Whether to wait for confirmation
+     * @default false
+     */
+    waitForConfirm?: boolean;
+}
+/**
+ * Result of a publish operation
+ */
+export interface PublishResult {
+    success: boolean;
+    channel: string;
+    recipients: number;
+}
+/**
+ * Environment bindings required for Realtime (service binding mode)
+ */
+export interface RealtimeEnv {
+    /**
+     * Durable Object namespace binding for RealtimeChannel
+     */
+    REALTIME?: DurableObjectNamespace;
+    /**
+     * App ID for channel isolation
+     */
+    APP_ID?: string;
+}
+/**
+ * Configuration for HTTP-based Realtime access
+ * Used when service bindings are not available (e.g., external services)
+ */
+export interface RealtimeHttpConfig {
+    /**
+     * Platform API key for authentication
+     * Format: wtvr_jwt_<jwt>
+     */
+    apiKey: string;
+    /**
+     * Base URL for the realtime service
+     * @default 'https://realtime.thewhatever.app'
+     */
+    baseUrl?: string;
+    /**
+     * Custom fetch implementation (for testing or custom environments)
+     */
+    fetch?: typeof fetch;
+}
+/**
+ * Server-side Realtime Provider interface
+ *
+ * Used in API routes to publish messages to connected clients.
+ *
+ * @example
+ * ```typescript
+ * import { getRealtime } from '@thewhateverapp/platform';
+ *
+ * export async function POST(req: Request) {
+ *   const realtime = await getRealtime();
+ *
+ *   // Publish to a channel
+ *   await realtime.publish('counter', { count: 42 });
+ *
+ *   return new Response('OK');
+ * }
+ * ```
+ */
+export interface RealtimeProvider {
+    /**
+     * Publish a message to a channel
+     *
+     * All connected clients subscribed to this channel will receive the message.
+     *
+     * @param channel - Channel name to publish to
+     * @param data - Data to send (will be JSON serialized)
+     * @param options - Optional publish options
+     * @returns Result with recipient count
+     */
+    publish(channel: string, data: unknown, options?: PublishOptions): Promise<PublishResult>;
+    /**
+     * Get statistics about connected clients
+     *
+     * @returns Stats including total connections and per-channel counts
+     */
+    getStats(): Promise<RealtimeStats>;
+    /**
+     * Check if the realtime service is healthy
+     *
+     * @returns True if the service is responding
+     */
+    isHealthy(): Promise<boolean>;
+}
+/**
+ * Statistics about realtime connections
+ */
+export interface RealtimeStats {
+    totalConnections: number;
+    channels: Record<string, number>;
+}
+/**
+ * Options for creating a realtime connection (client-side)
+ */
+export interface RealtimeConnectionOptions {
+    /**
+     * Channels to subscribe to immediately on connect
+     */
+    channels?: string[];
+    /**
+     * Auto-reconnect on disconnect
+     * @default true
+     */
+    autoReconnect?: boolean;
+    /**
+     * Reconnect delay in milliseconds
+     * @default 1000
+     */
+    reconnectDelay?: number;
+    /**
+     * Maximum reconnect attempts (0 = unlimited)
+     * @default 10
+     */
+    maxReconnectAttempts?: number;
+    /**
+     * Ping interval in milliseconds (0 = disabled)
+     * @default 30000
+     */
+    pingInterval?: number;
+}
+/**
+ * Connection state for client-side realtime
+ */
+export type RealtimeConnectionState = 'connecting' | 'connected' | 'disconnected' | 'reconnecting';
+/**
+ * Client-side realtime connection interface
+ */
+export interface RealtimeConnection {
+    /**
+     * Current connection state
+     */
+    readonly state: RealtimeConnectionState;
+    /**
+     * Currently subscribed channels
+     */
+    readonly channels: readonly string[];
+    /**
+     * Subscribe to a channel
+     */
+    subscribe(channel: string): void;
+    /**
+     * Unsubscribe from a channel
+     */
+    unsubscribe(channel: string): void;
+    /**
+     * Publish a message (client-to-server-to-all)
+     */
+    publish(channel: string, data: unknown): void;
+    /**
+     * Add a message listener for a channel
+     */
+    on(channel: string, callback: (data: unknown) => void): () => void;
+    /**
+     * Add a listener for all messages
+     */
+    onAny(callback: (channel: string, data: unknown) => void): () => void;
+    /**
+     * Add a connection state listener
+     */
+    onStateChange(callback: (state: RealtimeConnectionState) => void): () => void;
+    /**
+     * Disconnect and cleanup
+     */
+    disconnect(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/realtime/types.d.ts.map

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

package/dist/realtime/types.js

@@ -0,0 +1,8 @@
+/**
+ * Realtime WebSocket Pub/Sub Types
+ *
+ * Provides type definitions for the realtime messaging system
+ * powered by Cloudflare Durable Objects.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/realtime/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/realtime/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thewhateverapp/platform",
-  "version": "0.7.25",
+  "version": "0.9.0",
   "description": "Universal SDK for The Whatever App platform services",
   "type": "module",
   "main": "./dist/index.js",
@@ -50,15 +50,20 @@
   "homepage": "https://thewhatever.app",
   "devDependencies": {
     "@cloudflare/workers-types": "^4.20250402.0",
+    "@types/react": "^18.0.0",
     "typescript": "^5.7.3"
   },
   "peerDependencies": {
     "@cloudflare/workers-types": "^4.0.0",
-    "@opennextjs/cloudflare": "^1.0.0"
+    "@opennextjs/cloudflare": "^1.0.0",
+    "react": "^18.0.0"
   },
   "peerDependenciesMeta": {
     "@opennextjs/cloudflare": {
       "optional": true
+    },
+    "react": {
+      "optional": true
     }
   }
 }