@base44-preview/sdk 0.8.48-pr.286.7d59d14 → 0.8.48-pr.286.f67ed26

package/dist/platform/client/client.d.ts

@@ -1,9 +1,35 @@
-import type { PlatformClientOptions } from "./client.types.js";
-import type { BuilderModule } from "./modules/builder.types.js";
-/** Browser platform client. Construction creates no sockets, timers or network requests. */
+import type { PlatformClientOptions, PlatformSubscription, SubscriptionOptions } from "./types.js";
+/** Browser client for read-only platform app events. Constructing it opens no connection. */
 export declare class Base44PlatformClient {
-    /** Lazy builder subscriptions with independent session lifecycles. */
-    readonly builder: BuilderModule;
-    /** Configure shared service/auth settings; each module initializes its own resources. */
+    private readonly socket;
+    private readonly subscriptions;
+    private readonly options;
+    private closed;
+    private needsFreshConnection;
+    private generation;
+    private authAttempt;
+    private cancelAuth?;
+    private connecting?;
+    private resolveConnect?;
+    private rejectConnect?;
+    /** Configure a dedicated connection. API keys belong exclusively on your backend. */
     constructor(options: PlatformClientOptions);
+    /** Connect using a freshly obtained token. Resolves on CONNECT, not on app replay completion.
+     * Unexpected transport loss retries up to five times and rejoins active subscriptions.
+     * Call again after addressing a connection/auth failure; concurrent calls share one attempt.
+     */
+    connect(): Promise<void>;
+    /** Subscribe before or after connecting. One subscription per app, maximum eight.
+     * Events and boundary callbacks are awaited in order per app. Failed application,
+     * invalid frames or server errors end the subscription without advancing its cursor.
+     */
+    subscribe(appId: string, options: SubscriptionOptions): PlatformSubscription;
+    /** Stop delivery, cancel reconnection and release all listeners. Idempotent and terminal. */
+    close(): void;
+    private join;
+    private authenticate;
+    private clearConnecting;
+    private connectionError;
+    private serverError;
+    private protocolError;
 }

package/dist/platform/client/client.js

@@ -1,12 +1,218 @@
-import { createBuilder } from "./modules/builder.js";
-/** Browser platform client. Construction creates no sockets, timers or network requests. */
+import { io } from "socket.io-client";
+import { PlatformSocketError } from "./errors.js";
+import { appFromRoom, appPattern, decode, decodeJoined, errorCodes, eventApp, eventNames, object, roomFor } from "./protocol.js";
+import { notify, Subscription } from "./subscription.js";
+/** Browser client for read-only platform app events. Constructing it opens no connection. */
 export class Base44PlatformClient {
-    /** Configure shared service/auth settings; each module initializes its own resources. */
+    /** Configure a dedicated connection. API keys belong exclusively on your backend. */
     constructor(options) {
+        this.subscriptions = new Map();
+        this.closed = false;
+        this.needsFreshConnection = false;
+        this.generation = 0;
+        this.authAttempt = 0;
         const url = new URL(options.serverUrl);
         if (!["https:", "http:"].includes(url.protocol) || url.username || url.password || url.search || url.hash || url.pathname !== "/") {
             throw new TypeError("serverUrl must be an HTTP(S) origin without credentials, path, query or fragment");
         }
-        this.builder = Object.freeze(createBuilder({ ...options, serverUrl: url.origin }));
+        this.options = { ...options };
+        this.socket = io(`${url.origin}/partner`, {
+            path: "/ws-whitelabel/socket.io/", transports: ["websocket"], autoConnect: false,
+            forceNew: true, reconnectionAttempts: 5, reconnectionDelay: 1000, reconnectionDelayMax: 10000,
+            timeout: 20000,
+            auth: (callback) => { void this.authenticate(callback); },
+        });
+        this.socket.on("connect", () => {
+            var _a;
+            const generation = ++this.generation;
+            this.needsFreshConnection = false;
+            for (const subscription of this.subscriptions.values())
+                this.join(subscription, generation);
+            (_a = this.resolveConnect) === null || _a === void 0 ? void 0 : _a.call(this);
+            this.clearConnecting();
+        });
+        this.socket.on("disconnect", (reason) => {
+            ++this.generation;
+            ++this.authAttempt;
+            if (reason === "io server disconnect")
+                this.connectionError(new PlatformSocketError("connection_failed"));
+        });
+        this.socket.on("connect_error", (error) => {
+            var _a;
+            this.connectionError(new PlatformSocketError(((_a = error.data) === null || _a === void 0 ? void 0 : _a.code) === "connection_denied" ? "connection_denied" : "connection_failed"));
+        });
+        this.socket.io.on("reconnect_failed", () => this.connectionError(new PlatformSocketError("connection_failed")));
+        this.socket.on("joined", (raw) => {
+            var _a;
+            try {
+                const joined = decodeJoined(raw);
+                (_a = this.subscriptions.get(appFromRoom(joined.room))) === null || _a === void 0 ? void 0 : _a.joined(joined);
+            }
+            catch (_b) {
+                this.protocolError(raw);
+            }
+        });
+        this.socket.on("error", (raw) => this.serverError(raw));
+        for (const type of eventNames)
+            this.socket.on(type, (raw) => {
+                var _a;
+                try {
+                    const appId = eventApp(type, raw);
+                    if (!appId)
+                        throw new Error("Invalid app");
+                    (_a = this.subscriptions.get(appId)) === null || _a === void 0 ? void 0 : _a.event(decode(type, appId, raw));
+                }
+                catch (_b) {
+                    this.protocolError(raw);
+                }
+            });
+    }
+    /** Connect using a freshly obtained token. Resolves on CONNECT, not on app replay completion.
+     * Unexpected transport loss retries up to five times and rejoins active subscriptions.
+     * Call again after addressing a connection/auth failure; concurrent calls share one attempt.
+     */
+    connect() {
+        if (this.closed)
+            return Promise.reject(new PlatformSocketError("client_closed"));
+        if (this.socket.connected)
+            return Promise.resolve();
+        if (this.connecting)
+            return this.connecting;
+        const promise = new Promise((resolve, reject) => {
+            this.resolveConnect = resolve;
+            this.rejectConnect = reject;
+        });
+        this.connecting = promise;
+        this.socket.connect();
+        return promise;
+    }
+    /** Subscribe before or after connecting. One subscription per app, maximum eight.
+     * Events and boundary callbacks are awaited in order per app. Failed application,
+     * invalid frames or server errors end the subscription without advancing its cursor.
+     */
+    subscribe(appId, options) {
+        if (this.closed)
+            throw new PlatformSocketError("client_closed");
+        if (!appPattern.test(appId))
+            throw new TypeError("appId must be 24 lowercase hexadecimal characters");
+        if (options.afterSeq !== undefined && (typeof options.afterSeq !== "string" || !options.afterSeq))
+            throw new TypeError("afterSeq must be a nonempty opaque cursor");
+        if (this.subscriptions.has(appId))
+            throw new TypeError("An app may only have one subscription per client");
+        if (this.subscriptions.size >= 8)
+            throw new PlatformSocketError("subscription_limit", appId);
+        const subscription = new Subscription(appId, { ...options }, () => {
+            this.subscriptions.delete(appId);
+            this.needsFreshConnection = true;
+            if (this.socket.connected)
+                this.socket.emit("leave", roomFor(appId));
+        });
+        this.subscriptions.set(appId, subscription);
+        if (this.socket.connected && this.needsFreshConnection) {
+            // Leave has no acknowledgement; a new transport fences late events from retired streams.
+            this.socket.disconnect();
+            void this.connect().catch(() => { }); // Connection errors are delivered through onError.
+        }
+        else if (this.socket.connected) {
+            this.join(subscription, this.generation);
+        }
+        return subscription;
+    }
+    /** Stop delivery, cancel reconnection and release all listeners. Idempotent and terminal. */
+    close() {
+        var _a, _b;
+        if (this.closed)
+            return;
+        this.closed = true;
+        ++this.authAttempt;
+        (_a = this.cancelAuth) === null || _a === void 0 ? void 0 : _a.call(this);
+        ++this.generation;
+        for (const subscription of this.subscriptions.values())
+            subscription.unsubscribe();
+        (_b = this.rejectConnect) === null || _b === void 0 ? void 0 : _b.call(this, new PlatformSocketError("client_closed"));
+        this.clearConnecting();
+        this.socket.removeAllListeners();
+        this.socket.io.removeAllListeners();
+        this.socket.disconnect();
+    }
+    join(subscription, generation) {
+        subscription.join((cursor) => {
+            if (this.socket.connected && generation === this.generation) {
+                this.socket.emit("join", roomFor(subscription.appId), cursor === undefined ? {} : { after_seq: cursor });
+            }
+        });
+    }
+    async authenticate(callback) {
+        var _a;
+        const attempt = ++this.authAttempt;
+        (_a = this.cancelAuth) === null || _a === void 0 ? void 0 : _a.call(this);
+        let timer;
+        const timeout = new Promise((_, reject) => {
+            timer = setTimeout(() => reject(new Error("Token timeout")), 20000);
+            this.cancelAuth = () => { clearTimeout(timer); reject(new Error("Cancelled")); };
+        });
+        try {
+            const token = await Promise.race([Promise.resolve().then(() => this.options.getToken()), timeout]);
+            if (this.closed || attempt !== this.authAttempt)
+                return;
+            if (typeof token !== "string" || !token.trim())
+                throw new Error("Missing token");
+            callback({ token });
+        }
+        catch (_b) {
+            if (this.closed || attempt !== this.authAttempt)
+                return;
+            this.socket.disconnect();
+            this.connectionError(new PlatformSocketError("token_unavailable"));
+        }
+        finally {
+            clearTimeout(timer);
+            if (attempt === this.authAttempt)
+                this.cancelAuth = undefined;
+        }
+    }
+    clearConnecting() {
+        this.connecting = undefined;
+        this.resolveConnect = undefined;
+        this.rejectConnect = undefined;
+    }
+    connectionError(error) {
+        var _a;
+        (_a = this.rejectConnect) === null || _a === void 0 ? void 0 : _a.call(this, error);
+        this.clearConnecting();
+        if (!this.closed)
+            notify(this.options.onError, error);
+    }
+    serverError(raw) {
+        var _a;
+        try {
+            const frame = object(raw);
+            const code = errorCodes.find((code) => code === frame.code);
+            if (!code)
+                throw new Error("Unknown error");
+            const appId = appFromRoom(frame.room);
+            if (appId)
+                (_a = this.subscriptions.get(appId)) === null || _a === void 0 ? void 0 : _a.fail(code);
+            else if (frame.room === null)
+                this.connectionError(new PlatformSocketError(code));
+            else
+                throw new Error("Invalid room");
+        }
+        catch (_b) {
+            this.protocolError(raw);
+        }
+    }
+    protocolError(raw) {
+        var _a, _b;
+        const frame = raw && typeof raw === "object" ? raw : {};
+        const appId = (_a = appFromRoom(frame.room)) !== null && _a !== void 0 ? _a : (typeof frame.app_id === "string" && appPattern.test(frame.app_id) ? frame.app_id : undefined);
+        if (appId)
+            (_b = this.subscriptions.get(appId)) === null || _b === void 0 ? void 0 : _b.fail("protocol_error");
+        else {
+            // Unknown routing means no app cursor can safely advance past this frame.
+            for (const subscription of [...this.subscriptions.values()])
+                subscription.fail("protocol_error");
+            this.connectionError(new PlatformSocketError("protocol_error"));
+        }
     }
 }

package/dist/platform/client/errors.d.ts

@@ -1,4 +1,5 @@
-import type { PlatformSocketErrorCode } from "./errors.types.js";
+/** Server subscription failures and client transport/processing failures. */
+export type PlatformSocketErrorCode = "invalid_room" | "invalid_cursor" | "access_denied" | "subscription_limit" | "resync_required" | "stream_unavailable" | "connection_denied" | "connection_failed" | "token_unavailable" | "protocol_error" | "handler_failed" | "client_closed";
 /** Sanitized failure. Original token-provider, handler and server exceptions are not retained. */
 export declare class PlatformSocketError extends Error {
     /** Stable machine-readable category. */

package/dist/platform/client/index.d.ts

@@ -1,7 +1,6 @@
-/** Browser platform modules, separate from the runtime and server SDKs. */
+/** Read-only browser platform subscriptions, separate from the runtime and server SDKs. */
 export { Base44PlatformClient } from "./client.js";
 export { PlatformSocketError } from "./errors.js";
-export type { PlatformSocketErrorCode } from "./errors.types.js";
-export type { PlatformClientOptions } from "./client.types.js";
-export type { BuilderModule, BuilderInitOptions, BuilderSession, PlatformSubscription, SubscriptionOptions } from "./modules/builder.types.js";
-export type { AppUpdate, ChatMessage, ToolCall, QueueItem, QueueUpdate, TaskUpdate, ImageReady, Directive, PlatformEventMap, PlatformEvent, Joined } from "./modules/builder.events.types.js";
+export type { PlatformSocketErrorCode } from "./errors.js";
+export type { PlatformClientOptions, PlatformSubscription, SubscriptionOptions } from "./types.js";
+export type { AppUpdate, ChatMessage, ToolCall, QueueItem, QueueUpdate, TaskUpdate, ImageReady, Directive, PlatformEventMap, PlatformEvent, Joined } from "./events.js";

package/dist/platform/client/index.js

@@ -1,3 +1,3 @@
-/** Browser platform modules, separate from the runtime and server SDKs. */
+/** Read-only browser platform subscriptions, separate from the runtime and server SDKs. */
 export { Base44PlatformClient } from "./client.js";
 export { PlatformSocketError } from "./errors.js";

package/dist/platform/client/{modules/builder-protocol.d.ts → protocol.d.ts}

@@ -1,4 +1,4 @@
-import type { Joined, PlatformEvent, PlatformEventMap } from "./builder.events.types.js";
+import type { Joined, PlatformEvent, PlatformEventMap } from "./events.js";
 export declare const eventNames: readonly ["update_model", "directive", "queue_update", "task_update", "image_ready"];
 export declare const errorCodes: readonly ["invalid_room", "invalid_cursor", "access_denied", "subscription_limit", "resync_required", "stream_unavailable"];
 export declare const appPattern: RegExp;

package/dist/platform/client/{modules/builder-subscription.d.ts → subscription.d.ts}

@@ -1,7 +1,6 @@
-import type { Joined, PlatformEvent } from "./builder.events.types.js";
-import { PlatformSocketError } from "../errors.js";
-import type { PlatformSocketErrorCode } from "../errors.types.js";
-import type { PlatformSubscription, SubscriptionOptions } from "./builder.types.js";
+import type { Joined, PlatformEvent } from "./events.js";
+import { PlatformSocketError, type PlatformSocketErrorCode } from "./errors.js";
+import type { PlatformSubscription, SubscriptionOptions } from "./types.js";
 /** @internal */
 export declare function notify(callback: (error: PlatformSocketError) => void, error: PlatformSocketError): void;
 /** @internal */

package/dist/platform/client/{modules/builder-subscription.js → subscription.js}

@@ -1,4 +1,4 @@
-import { PlatformSocketError } from "../errors.js";
+import { PlatformSocketError } from "./errors.js";
 /** @internal */
 export function notify(callback, error) {
     try {

package/dist/platform/client/types.d.ts

@@ -0,0 +1,33 @@
+import type { Joined, PlatformEvent } from "./events.js";
+import type { PlatformSocketError } from "./errors.js";
+/** Configuration for the browser platform connection. Never supply an API key. */
+export interface PlatformClientOptions {
+    /** Origin of the platform service, e.g. https://base44.app. No path/query/credentials. */
+    serverUrl: string;
+    /** Fetch a browser credential from your backend. Called for every connection attempt. */
+    getToken: () => string | Promise<string>;
+    /** Connection-level error notification. Errors never include tokens or server exception text. */
+    onError: (error: PlatformSocketError) => void;
+}
+/** One app subscription; at most eight may be active per client. */
+export interface SubscriptionOptions {
+    /** Last successfully applied cursor for this app; omit for a fresh live boundary. */
+    afterSeq?: string;
+    /** Apply each event. Delivery is serial per app; rejection pauses this subscription. */
+    onEvent: (event: PlatformEvent) => void | Promise<void>;
+    /** Handle subscription errors. Reconcile on resync_required; never silently reset a cursor. */
+    onError: (error: PlatformSocketError) => void;
+    /** Optional replay-complete notification, awaited before advancing to the boundary cursor. */
+    onJoined?: (joined: Joined) => void | Promise<void>;
+}
+/** Subscription lifetime and last successfully applied cursor. */
+export interface PlatformSubscription {
+    /** App identifier. */
+    readonly appId: string;
+    /** Last applied event/boundary cursor; persist alongside the state it describes. */
+    readonly cursor: string | undefined;
+    /** True while subscribed; false after an error or explicit unsubscribe. */
+    readonly active: boolean;
+    /** Stop this app's delivery and release its subscription slot. Idempotent. */
+    unsubscribe(): void;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.48-pr.286.7d59d14",
+  "version": "0.8.48-pr.286.f67ed26",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/dist/platform/client/client.types.d.ts

@@ -1,7 +0,0 @@
-/** Shared configuration for browser platform modules. Never supply an API key. */
-export interface PlatformClientOptions {
-    /** Origin of the platform service, e.g. https://base44.app. No path/query/credentials. */
-    serverUrl: string;
-    /** Refresh a browser credential through your backend; called on every builder connection attempt. */
-    refreshToken: () => string | Promise<string>;
-}

package/dist/platform/client/errors.types.d.ts

@@ -1,2 +0,0 @@
-/** Server subscription failures and client transport/processing failures. */
-export type PlatformSocketErrorCode = "invalid_room" | "invalid_cursor" | "access_denied" | "subscription_limit" | "resync_required" | "stream_unavailable" | "connection_denied" | "connection_failed" | "token_unavailable" | "protocol_error" | "handler_failed" | "client_closed";

package/dist/platform/client/modules/builder-socket.d.ts

@@ -1,35 +0,0 @@
-import type { PlatformClientOptions } from "../client.types.js";
-import type { BuilderInitOptions, BuilderSession, PlatformSubscription, SubscriptionOptions } from "./builder.types.js";
-/** @internal */
-export declare class BuilderSocket implements BuilderSession {
-    private readonly socket;
-    private readonly subscriptions;
-    private readonly options;
-    private closed;
-    private needsFreshConnection;
-    private generation;
-    private authAttempt;
-    private cancelAuth?;
-    private connecting?;
-    private resolveConnect?;
-    private rejectConnect?;
-    constructor(config: PlatformClientOptions, options: BuilderInitOptions);
-    /** Connect using a freshly obtained token. Resolves on CONNECT, not on app replay completion.
-     * Unexpected transport loss retries up to five times and rejoins active subscriptions.
-     * Call again after addressing a connection/auth failure; concurrent calls share one attempt.
-     */
-    connect(): Promise<void>;
-    /** Subscribe before or after connecting. One subscription per app, maximum eight.
-     * Events and boundary callbacks are awaited in order per app. Failed application,
-     * invalid frames or server errors end the subscription without advancing its cursor.
-     */
-    subscribe(appId: string, options: SubscriptionOptions): PlatformSubscription;
-    /** Stop delivery, cancel reconnection and release all listeners. Idempotent and terminal. */
-    close(): void;
-    private join;
-    private authenticate;
-    private clearConnecting;
-    private connectionError;
-    private serverError;
-    private protocolError;
-}

package/dist/platform/client/modules/builder-socket.js

@@ -1,213 +0,0 @@
-import { io } from "socket.io-client";
-import { PlatformSocketError } from "../errors.js";
-import { appFromRoom, appPattern, decode, decodeJoined, errorCodes, eventApp, eventNames, object, roomFor } from "./builder-protocol.js";
-import { notify, Subscription } from "./builder-subscription.js";
-/** @internal */
-export class BuilderSocket {
-    constructor(config, options) {
-        this.subscriptions = new Map();
-        this.closed = false;
-        this.needsFreshConnection = false;
-        this.generation = 0;
-        this.authAttempt = 0;
-        this.options = { ...config, onError: options.onError };
-        this.socket = io(`${config.serverUrl}/partner`, {
-            path: "/ws-whitelabel/socket.io/", transports: ["websocket"], autoConnect: false,
-            forceNew: true, reconnectionAttempts: 5, reconnectionDelay: 1000, reconnectionDelayMax: 10000,
-            timeout: 20000,
-            auth: (callback) => { void this.authenticate(callback); },
-        });
-        this.socket.on("connect", () => {
-            var _a;
-            const generation = ++this.generation;
-            this.needsFreshConnection = false;
-            for (const subscription of this.subscriptions.values())
-                this.join(subscription, generation);
-            (_a = this.resolveConnect) === null || _a === void 0 ? void 0 : _a.call(this);
-            this.clearConnecting();
-        });
-        this.socket.on("disconnect", (reason) => {
-            ++this.generation;
-            ++this.authAttempt;
-            if (reason === "io server disconnect")
-                this.connectionError(new PlatformSocketError("connection_failed"));
-        });
-        this.socket.on("connect_error", (error) => {
-            var _a;
-            this.connectionError(new PlatformSocketError(((_a = error.data) === null || _a === void 0 ? void 0 : _a.code) === "connection_denied" ? "connection_denied" : "connection_failed"));
-        });
-        this.socket.io.on("reconnect_failed", () => this.connectionError(new PlatformSocketError("connection_failed")));
-        this.socket.on("joined", (raw) => {
-            var _a;
-            try {
-                const joined = decodeJoined(raw);
-                (_a = this.subscriptions.get(appFromRoom(joined.room))) === null || _a === void 0 ? void 0 : _a.joined(joined);
-            }
-            catch (_b) {
-                this.protocolError(raw);
-            }
-        });
-        this.socket.on("error", (raw) => this.serverError(raw));
-        for (const type of eventNames)
-            this.socket.on(type, (raw) => {
-                var _a;
-                try {
-                    const appId = eventApp(type, raw);
-                    if (!appId)
-                        throw new Error("Invalid app");
-                    (_a = this.subscriptions.get(appId)) === null || _a === void 0 ? void 0 : _a.event(decode(type, appId, raw));
-                }
-                catch (_b) {
-                    this.protocolError(raw);
-                }
-            });
-    }
-    /** Connect using a freshly obtained token. Resolves on CONNECT, not on app replay completion.
-     * Unexpected transport loss retries up to five times and rejoins active subscriptions.
-     * Call again after addressing a connection/auth failure; concurrent calls share one attempt.
-     */
-    connect() {
-        if (this.closed)
-            return Promise.reject(new PlatformSocketError("client_closed"));
-        if (this.socket.connected)
-            return Promise.resolve();
-        if (this.connecting)
-            return this.connecting;
-        const promise = new Promise((resolve, reject) => {
-            this.resolveConnect = resolve;
-            this.rejectConnect = reject;
-        });
-        this.connecting = promise;
-        this.socket.connect();
-        return promise;
-    }
-    /** Subscribe before or after connecting. One subscription per app, maximum eight.
-     * Events and boundary callbacks are awaited in order per app. Failed application,
-     * invalid frames or server errors end the subscription without advancing its cursor.
-     */
-    subscribe(appId, options) {
-        if (this.closed)
-            throw new PlatformSocketError("client_closed");
-        if (!appPattern.test(appId))
-            throw new TypeError("appId must be 24 lowercase hexadecimal characters");
-        if (options.afterSeq !== undefined && (typeof options.afterSeq !== "string" || !options.afterSeq))
-            throw new TypeError("afterSeq must be a nonempty opaque cursor");
-        if (this.subscriptions.has(appId))
-            throw new TypeError("An app may only have one subscription per builder session");
-        if (this.subscriptions.size >= 8)
-            throw new PlatformSocketError("subscription_limit", appId);
-        const subscription = new Subscription(appId, { ...options }, () => {
-            this.subscriptions.delete(appId);
-            this.needsFreshConnection = true;
-            if (this.socket.connected)
-                this.socket.emit("leave", roomFor(appId));
-        });
-        this.subscriptions.set(appId, subscription);
-        if (this.socket.connected && this.needsFreshConnection) {
-            // Leave has no acknowledgement; a new transport fences late events from retired streams.
-            this.socket.disconnect();
-            void this.connect().catch(() => { }); // Connection errors are delivered through onError.
-        }
-        else if (this.socket.connected) {
-            this.join(subscription, this.generation);
-        }
-        return subscription;
-    }
-    /** Stop delivery, cancel reconnection and release all listeners. Idempotent and terminal. */
-    close() {
-        var _a, _b;
-        if (this.closed)
-            return;
-        this.closed = true;
-        ++this.authAttempt;
-        (_a = this.cancelAuth) === null || _a === void 0 ? void 0 : _a.call(this);
-        ++this.generation;
-        for (const subscription of this.subscriptions.values())
-            subscription.unsubscribe();
-        (_b = this.rejectConnect) === null || _b === void 0 ? void 0 : _b.call(this, new PlatformSocketError("client_closed"));
-        this.clearConnecting();
-        this.socket.removeAllListeners();
-        this.socket.io.removeAllListeners();
-        this.socket.disconnect();
-    }
-    join(subscription, generation) {
-        subscription.join((cursor) => {
-            if (this.socket.connected && generation === this.generation) {
-                this.socket.emit("join", roomFor(subscription.appId), cursor === undefined ? {} : { after_seq: cursor });
-            }
-        });
-    }
-    async authenticate(callback) {
-        var _a;
-        const attempt = ++this.authAttempt;
-        (_a = this.cancelAuth) === null || _a === void 0 ? void 0 : _a.call(this);
-        let timer;
-        const timeout = new Promise((_, reject) => {
-            timer = setTimeout(() => reject(new Error("Token timeout")), 20000);
-            this.cancelAuth = () => { clearTimeout(timer); reject(new Error("Cancelled")); };
-        });
-        try {
-            const token = await Promise.race([Promise.resolve().then(() => this.options.refreshToken()), timeout]);
-            if (this.closed || attempt !== this.authAttempt)
-                return;
-            if (typeof token !== "string" || !token.trim())
-                throw new Error("Missing token");
-            callback({ token });
-        }
-        catch (_b) {
-            if (this.closed || attempt !== this.authAttempt)
-                return;
-            this.socket.disconnect();
-            this.connectionError(new PlatformSocketError("token_unavailable"));
-        }
-        finally {
-            clearTimeout(timer);
-            if (attempt === this.authAttempt)
-                this.cancelAuth = undefined;
-        }
-    }
-    clearConnecting() {
-        this.connecting = undefined;
-        this.resolveConnect = undefined;
-        this.rejectConnect = undefined;
-    }
-    connectionError(error) {
-        var _a;
-        (_a = this.rejectConnect) === null || _a === void 0 ? void 0 : _a.call(this, error);
-        this.clearConnecting();
-        if (!this.closed)
-            notify(this.options.onError, error);
-    }
-    serverError(raw) {
-        var _a;
-        try {
-            const frame = object(raw);
-            const code = errorCodes.find((code) => code === frame.code);
-            if (!code)
-                throw new Error("Unknown error");
-            const appId = appFromRoom(frame.room);
-            if (appId)
-                (_a = this.subscriptions.get(appId)) === null || _a === void 0 ? void 0 : _a.fail(code);
-            else if (frame.room === null)
-                this.connectionError(new PlatformSocketError(code));
-            else
-                throw new Error("Invalid room");
-        }
-        catch (_b) {
-            this.protocolError(raw);
-        }
-    }
-    protocolError(raw) {
-        var _a, _b;
-        const frame = raw && typeof raw === "object" ? raw : {};
-        const appId = (_a = appFromRoom(frame.room)) !== null && _a !== void 0 ? _a : (typeof frame.app_id === "string" && appPattern.test(frame.app_id) ? frame.app_id : undefined);
-        if (appId)
-            (_b = this.subscriptions.get(appId)) === null || _b === void 0 ? void 0 : _b.fail("protocol_error");
-        else {
-            // Unknown routing means no app cursor can safely advance past this frame.
-            for (const subscription of [...this.subscriptions.values()])
-                subscription.fail("protocol_error");
-            this.connectionError(new PlatformSocketError("protocol_error"));
-        }
-    }
-}

package/dist/platform/client/modules/builder.d.ts

@@ -1,4 +0,0 @@
-import type { PlatformClientOptions } from "../client.types.js";
-import type { BuilderModule } from "./builder.types.js";
-/** @internal */
-export declare function createBuilder(config: PlatformClientOptions): BuilderModule;

package/dist/platform/client/modules/builder.events.types.js

@@ -1 +0,0 @@
-export {};

package/dist/platform/client/modules/builder.js

@@ -1,7 +0,0 @@
-import { BuilderSocket } from "./builder-socket.js";
-/** @internal */
-export function createBuilder(config) {
-    return {
-        init(options) { return new BuilderSocket(config, options); },
-    };
-}

package/dist/platform/client/modules/builder.types.d.ts

@@ -1,48 +0,0 @@
-import type { Joined, PlatformEvent } from "./builder.events.types.js";
-import type { PlatformSocketError } from "../errors.js";
-/** Options for an independent builder socket session. */
-export interface BuilderInitOptions {
-    /** Connection-level errors, sanitized to exclude tokens and server exception text. */
-    onError: (error: PlatformSocketError) => void;
-}
-/** Lazy builder module; no socket exists until init is called. */
-export interface BuilderModule {
-    /** Create an independent session without connecting. Call connect on the returned session. */
-    init(options: BuilderInitOptions): BuilderSession;
-}
-/** One builder socket session. Owns its subscriptions and connection lifecycle. */
-export interface BuilderSession {
-    /** Connect with a refreshed browser token; resolves on CONNECT, before app replay completes.
-     * Transport loss retries five times and rejoins active subscriptions from applied cursors.
-     * Call again after fixing connection/auth failures. Concurrent calls share one attempt.
-     */
-    connect(): Promise<void>;
-    /** Subscribe before or after connecting. One subscription per app, up to eight per session.
-     * Callbacks run serially per app; errors stop delivery without advancing the cursor.
-     */
-    subscribe(appId: string, options: SubscriptionOptions): PlatformSubscription;
-    /** Stop this session, its subscriptions and reconnection. Idempotent and terminal. */
-    close(): void;
-}
-/** One app subscription; at most eight may be active per builder session. */
-export interface SubscriptionOptions {
-    /** Last successfully applied cursor for this app; omit for a fresh live boundary. */
-    afterSeq?: string;
-    /** Apply each event. Delivery is serial per app; rejection pauses this subscription. */
-    onEvent: (event: PlatformEvent) => void | Promise<void>;
-    /** Handle subscription errors. Reconcile on resync_required; never silently reset a cursor. */
-    onError: (error: PlatformSocketError) => void;
-    /** Optional replay-complete notification, awaited before advancing to the boundary cursor. */
-    onJoined?: (joined: Joined) => void | Promise<void>;
-}
-/** Subscription lifetime and last successfully applied cursor. */
-export interface PlatformSubscription {
-    /** App identifier. */
-    readonly appId: string;
-    /** Last applied event/boundary cursor; persist alongside the state it describes. */
-    readonly cursor: string | undefined;
-    /** True while subscribed; false after an error or explicit unsubscribe. */
-    readonly active: boolean;
-    /** Stop this app's delivery and release its subscription slot. Idempotent. */
-    unsubscribe(): void;
-}

package/dist/platform/client/modules/builder.types.js

@@ -1 +0,0 @@
-export {};