@base44-preview/sdk 0.8.48-pr.289.b9ea964 → 0.8.49-pr.280.04af9f9

package/dist/actor.d.ts

@@ -25,8 +25,8 @@ export interface Storage {
     get<T>(key: string): Promise<T | undefined>;
     put(key: string, value: unknown): Promise<void>;
     delete(key: string): Promise<boolean>;
-    /** Wipe the session's entire persisted storage. A later connection starts
-     *  with the same empty storage as a new session. */
+    /** Wipe the room's entire persisted storage (match-end cleanup). Safe: a
+     *  later rejoin re-bootstraps exactly like a brand-new room. */
     deleteAll(): Promise<void>;
 }
 /**

package/dist/client.js

@@ -14,6 +14,9 @@ import { createAppModule } from "./modules/app.js";
 import { createUsersModule } from "./modules/users.js";
 import { RoomsSocket } from "./utils/socket-utils.js";
 import { createAnalyticsModule } from "./modules/analytics.js";
+import { createExperimentsModule } from "./modules/experiments.js";
+import { createExposureTracker } from "./modules/experiment-exposures.js";
+import { EXPERIMENTS_CONTEXT_HEADER, getBrowserExperimentsContext, readExperimentsContext } from "./modules/experiments-context.js";
 import { createActorsModule, resolveActorsHost, } from "./modules/actors.js";
 /**
  * Creates a Base44 client.
@@ -53,10 +56,11 @@ import { createActorsModule, resolveActorsHost, } from "./modules/actors.js";
  * ```
  */
 export function createClient(config) {
-    var _a, _b, _c, _d;
+    var _a, _b, _c, _d, _e, _f, _g;
     const { serverUrl = "https://base44.app", appId, analytics, token, serviceToken, requiresAuth = false, appBaseUrl, options, functionsVersion, headers: optionalHeaders, } = config;
     // Normalize appBaseUrl to always be a string (empty if not provided or invalid)
     const normalizedAppBaseUrl = typeof appBaseUrl === "string" ? appBaseUrl : "";
+    const experimentsContext = (_a = config.experiments) !== null && _a !== void 0 ? _a : getBrowserExperimentsContext(appId);
     const socketConfig = {
         serverUrl,
         mountPath: "/ws-user-apps/socket.io/",
@@ -73,9 +77,14 @@ export function createClient(config) {
         }
         return socket;
     };
+    const { [EXPERIMENTS_CONTEXT_HEADER]: inheritedExperimentsContext, ...requestHeaders } = optionalHeaders !== null && optionalHeaders !== void 0 ? optionalHeaders : {};
     const headers = {
-        ...optionalHeaders,
+        ...requestHeaders,
         "X-App-Id": String(appId),
+        ...(experimentsContext ? {
+            "Base44-Visitor-Id": experimentsContext.identity.visitorId,
+            "Base44-Experiment-Preview": JSON.stringify((_b = experimentsContext.preview) !== null && _b !== void 0 ? _b : {}),
+        } : {}),
     };
     const functionHeaders = functionsVersion
         ? {
@@ -121,10 +130,25 @@ export function createClient(config) {
         baseURL: `${serverUrl}/api`,
         headers,
     });
+    const exposureTracker = createExposureTracker({
+        axiosClient,
+        appId,
+        enabled: (_c = analytics === null || analytics === void 0 ? void 0 : analytics.enabled) !== null && _c !== void 0 ? _c : true,
+        source: typeof window === "undefined" ? "backend" : "browser",
+        pageUrl: experimentsContext === null || experimentsContext === void 0 ? void 0 : experimentsContext.pageUrl,
+    });
+    const experiments = createExperimentsModule({
+        appId,
+        getAuth: () => userAuthModule,
+        trackExposure: exposureTracker.track,
+        flushExposures: exposureTracker.flush,
+        context: experimentsContext,
+    });
     const userAuthModule = createAuthModule(axiosClient, functionsAxiosClient, appId, {
         appBaseUrl: normalizedAppBaseUrl,
         serverUrl,
         token,
+        onAuthStateChange: experiments.onAuthStateChange,
     });
     // Apply the access token before any module that may issue authenticated
     // requests during construction (notably analytics, which fires an init
@@ -136,11 +160,19 @@ export function createClient(config) {
             userAuthModule.setToken(accessToken);
         }
     }
+    if (experimentsContext) {
+        const { userId, status } = experimentsContext.identity;
+        // The document's cookie identity may differ from this client's localStorage token.
+        const needsClientIdentity = typeof window !== "undefined" && userAuthModule.hasToken() &&
+            experimentsContext.config.experiments.some((experiment) => experiment.assign_by === "user");
+        experiments.onAuthStateChange(status === "pending" || needsClientIdentity ? { status: "pending" } :
+            userId ? { status: "authenticated", userId } : { status: "anonymous" });
+    }
     const actorsModule = createActorsModule({
         appId,
         // serverUrl is often relative/empty (same-origin app); the proxy-fallback
         // URL needs an absolute host, so fall back to the page origin.
-        host: resolveActorsHost(serverUrl, typeof window !== "undefined" ? (_a = window.location) === null || _a === void 0 ? void 0 : _a.origin : undefined),
+        host: resolveActorsHost(serverUrl, typeof window !== "undefined" ? (_d = window.location) === null || _d === void 0 ? void 0 : _d.origin : undefined),
         functionsVersion,
         getAuthToken: () => token || getAccessToken(),
         mintConnectionToken: async (actorName, room, connectionId) => {
@@ -168,6 +200,7 @@ export function createClient(config) {
         integrations: createIntegrationsModule(axiosClient, appId),
         connectors: createUserConnectorsModule(axiosClient, appId),
         auth: userAuthModule,
+        experiments: experiments.module,
         functions: createFunctionsModule(functionsAxiosClient, appId, {
             getAuthHeaders: () => {
                 const headers = {};
@@ -178,7 +211,7 @@ export function createClient(config) {
                 }
                 return headers;
             },
-            baseURL: (_b = functionsAxiosClient.defaults) === null || _b === void 0 ? void 0 : _b.baseURL,
+            baseURL: (_e = functionsAxiosClient.defaults) === null || _e === void 0 ? void 0 : _e.baseURL,
         }),
         agents: createAgentsModule({
             axios: axiosClient,
@@ -196,11 +229,14 @@ export function createClient(config) {
             serverUrl,
             appId,
             userAuthModule,
-            enabled: (_c = analytics === null || analytics === void 0 ? void 0 : analytics.enabled) !== null && _c !== void 0 ? _c : true,
+            enabled: (_f = analytics === null || analytics === void 0 ? void 0 : analytics.enabled) !== null && _f !== void 0 ? _f : true,
+            getVisitorId: experiments.visitorId,
+            experimentsContext,
         }),
         actors: actorsModule.module,
         cleanup: () => {
             userModules.analytics.cleanup();
+            experiments.cleanup();
             actorsModule.closeAll();
             if (socket) {
                 socket.disconnect();
@@ -225,7 +261,7 @@ export function createClient(config) {
                 }
                 return headers;
             },
-            baseURL: (_d = serviceRoleFunctionsAxiosClient.defaults) === null || _d === void 0 ? void 0 : _d.baseURL,
+            baseURL: (_g = serviceRoleFunctionsAxiosClient.defaults) === null || _g === void 0 ? void 0 : _g.baseURL,
         }),
         agents: createAgentsModule({
             axios: serviceRoleAxiosClient,
@@ -268,7 +304,10 @@ export function createClient(config) {
             appId: String(appId),
             serverUrl,
             functionsVersion,
-            platformHeaders: optionalHeaders,
+            platformHeaders: {
+                ...headers,
+                ...(inheritedExperimentsContext ? { [EXPERIMENTS_CONTEXT_HEADER]: inheritedExperimentsContext } : {}),
+            },
         }),
         /**
          * Sets a new authentication token for all subsequent requests.
@@ -420,6 +459,10 @@ export function createClientFromRequest(request) {
     }
     // Prepare additional headers to propagate
     const additionalHeaders = {};
+    const encodedExperiments = request.headers.get(EXPERIMENTS_CONTEXT_HEADER);
+    const experimentsContext = readExperimentsContext(encodedExperiments, appId);
+    if (experimentsContext && encodedExperiments)
+        additionalHeaders[EXPERIMENTS_CONTEXT_HEADER] = encodedExperiments;
     if (stateHeader) {
         additionalHeaders["Base44-State"] = stateHeader;
     }
@@ -440,5 +483,6 @@ export function createClientFromRequest(request) {
         serviceToken: serviceRoleToken,
         functionsVersion: functionsVersion !== null && functionsVersion !== void 0 ? functionsVersion : undefined,
         headers: additionalHeaders,
+        experiments: experimentsContext ? { ...experimentsContext, pageUrl: request.url ? new URL(request.url).pathname : "/" } : undefined,
     });
 }

package/dist/client.types.d.ts

@@ -9,6 +9,8 @@ import type { AiGatewayModule } from "./modules/ai-gateway.types.js";
 import type { AppLogsModule } from "./modules/app-logs.types.js";
 import type { AppModule } from "./modules/app.types.js";
 import type { AnalyticsModule } from "./modules/analytics.types.js";
+import type { ExperimentsModule } from "./modules/experiments.types.js";
+import type { ExperimentsContext } from "./modules/experiments-config.types.js";
 import type { ActorsModule } from "./modules/actors.types.js";
 import type { FetchWithAuthInit } from "./utils/fetch-with-auth.js";
 /**
@@ -39,9 +41,9 @@ export interface CreateClientAnalyticsConfig {
     /**
      * Whether app analytics is enabled for this client.
      *
-     * When disabled, automatic analytics and calls to `analytics.track()` are
-     * no-ops. The SDK does not create an analytics session identifier, start
-     * heartbeat timers, or send analytics requests.
+     * When disabled, automatic analytics, experiment exposures and calls to
+     * `analytics.track()` are no-ops. The SDK does not create an analytics session
+     * identifier, start heartbeat timers, or send analytics requests.
      *
      * @defaultValue `true`
      */
@@ -79,6 +81,12 @@ export interface CreateClientConfig {
      * Omit this option to preserve the default analytics behavior.
      */
     analytics?: CreateClientAnalyticsConfig;
+    /**
+     * Platform-validated context for local flag evaluation. Request-scoped on servers.
+     * Automatically read from the platform bootstrap in browsers and trusted headers
+     * by createClientFromRequest(). Not an authorization credential.
+     */
+    experiments?: ExperimentsContext;
     /**
      * User authentication token. Used to authenticate as a specific user.
      *
@@ -134,6 +142,8 @@ export interface Base44Client {
     connectors: UserConnectorsModule;
     /** {@link EntitiesModule | Entities module} for CRUD operations on your data models. */
     entities: EntitiesModule;
+    /** {@link ExperimentsModule | Experiments module} for local feature flags and exposures. */
+    experiments: ExperimentsModule;
     /** {@link FunctionsModule | Functions module} for invoking custom backend functions. */
     functions: FunctionsModule;
     /** {@link IntegrationsModule | Integrations module} for calling pre-built integration endpoints. */

package/dist/index.d.ts

@@ -4,7 +4,10 @@ import { getAccessToken, saveAccessToken, removeAccessToken, getLoginUrl } from
 export { createClient, createClientFromRequest, Base44Error, getAccessToken, saveAccessToken, removeAccessToken, getLoginUrl, };
 export type { Base44Client, CreateClientAnalyticsConfig, CreateClientConfig, CreateClientOptions, Base44ErrorJSON, };
 export * from "./types.js";
-export type { DeleteManyResult, DeleteResult, EntitiesModule, EntityFilterOperators, EntityFilterQuery, EntityFilterValue, EntityHandler, EntityRecord, EntityTypeRegistry, ImportResult, RealtimeEventType, RealtimeEvent, RealtimeCallback, SortField, UpdateManyResult, } from "./modules/entities.types.js";
+export { evaluateExperiments } from "./modules/experiments-evaluator.js";
+export type { ExperimentsConfig, ExperimentsContext, ExperimentsIdentity } from "./modules/experiments-config.types.js";
+export type { ExperimentsModule, ExperimentsSnapshot, } from "./modules/experiments.types.js";
+export type { DeleteManyResult, DeleteResult, EntitiesModule, EntityAggregateResult, EntityAggregateSpec, EntityDateBucketUnit, EntityDistinctOptions, EntityFilterOperators, EntityFilterQuery, EntityFilterValue, EntityHandler, EntityListOptions, EntityPage, EntityRecord, EntityTypeRegistry, EntityUpsertOptions, EntityUpsertResult, ImportResult, RealtimeEventType, RealtimeEvent, RealtimeCallback, SortField, UpdateManyResult, } from "./modules/entities.types.js";
 export type { AuthModule, LoginResponse, RegisterParams, VerifyOtpParams, ChangePasswordParams, ResetPasswordParams, User, } from "./modules/auth.types.js";
 export type { IntegrationsModule, IntegrationEndpointFunction, CoreIntegrations, InvokeLLMParams, GenerateImageParams, GenerateImageResult, UploadFileParams, UploadFileResult, SendEmailParams, SendEmailResult, ExtractDataFromUploadedFileParams, ExtractDataFromUploadedFileResult, UploadPrivateFileParams, UploadPrivateFileResult, CreateFileSignedUrlParams, CreateFileSignedUrlResult, } from "./modules/integrations.types.js";
 export type { FunctionsModule, FunctionName, FunctionNameRegistry, } from "./modules/functions.types.js";

package/dist/index.js

@@ -3,4 +3,5 @@ import { Base44Error } from "./utils/axios-client.js";
 import { getAccessToken, saveAccessToken, removeAccessToken, getLoginUrl, } from "./utils/auth-utils.js";
 export { createClient, createClientFromRequest, Base44Error, getAccessToken, saveAccessToken, removeAccessToken, getLoginUrl, };
 export * from "./types.js";
+export { evaluateExperiments } from "./modules/experiments-evaluator.js";
 export { Actor } from "./actor.js";

package/dist/modules/actors.types.d.ts

@@ -1,10 +1,9 @@
 /**
- * Maps actor names to their incoming and outgoing message types.
+ * Extend this interface to add typed `subscribe` callbacks and `send` payloads
+ * for your deployed Actors.
  *
- * Extend this interface through module augmentation when you want typed actor
- * messages without generating types with the CLI. For each actor, `toServer`
- * defines incoming messages that a client sends to the actor. `toClient` defines
- * outgoing messages that the actor sends to connected clients.
+ * This is separate from {@link ActorNameRegistry} (which is auto-generated
+ * by `base44 types generate`), so there are no conflicts.
  *
  * @example
  * ```typescript
@@ -21,10 +20,8 @@
 export interface ActorRegistry {
 }
 /**
- * Lists actor names when your project includes types generated by the CLI.
- *
- * The generated names provide autocomplete for deployed actors. To define
- * incoming and outgoing message types manually, augment {@link ActorRegistry}.
+ * Auto-populated by `base44 types generate` with the names of your deployed actors.
+ * Do not edit this interface manually — use {@link ActorRegistry} for message types.
  */
 export interface ActorNameRegistry {
 }
@@ -35,163 +32,71 @@ type ToClientFor<N extends string> = N extends keyof ActorRegistry ? ActorRegist
 type ToServerFor<N extends string> = N extends keyof ActorRegistry ? ActorRegistry[N] extends {
     toServer: infer O;
 } ? O : unknown : unknown;
-/**
- * Options for {@link ActorRef.connect}.
- */
+/** Options for {@link ActorRef.connect}. */
 export interface ActorConnectOptions {
     /**
-     * Connection ID that the actor receives as `conn.id`.
-     *
-     * Specify a stable value, such as a value persisted per client, so
-     * reconnections from that client reuse the same connection ID. Omit this property
-     * to generate an ID.
+     * The connection id — becomes the actor's `conn.id`. Supply a stable value
+     * (e.g. persisted per tab) so a reconnect reuses the same server-side
+     * identity; omit for an auto-generated per-connection id.
      */
     id?: string;
 }
-/**
- * Represents an outgoing-message listener registered with
- * {@link Connection.subscribe}.
- */
+/** Handle for one listener registered via {@link Connection.subscribe}. */
 export interface ActorSubscription {
-    /**
-     * Removes this listener. Other listeners and the socket stay open.
-     *
-     * @example
-     * ```typescript
-     * const sub = conn.subscribe((msg) => console.log(msg));
-     * sub.unsubscribe();
-     * ```
-     */
+    /** Remove this listener; other listeners and the socket stay live. */
     unsubscribe(): void;
 }
 /**
- * Represents a client's WebSocket connection to an actor session.
- *
- * {@link ActorRef.connect} returns this object while the socket connects.
- * The socket buffers messages sent during connection setup until it opens.
+ * A live connection to an actor instance, returned by {@link ActorRef.connect}.
+ * `subscribe`/`send` are always valid — you only get a `Connection` once the
+ * socket has been opened, so there's no pre-connect state to guard against.
  */
 export interface Connection<N extends string = string> {
-    /** Connection ID that the actor receives as `conn.id`. */
+    /** The connection id (the value the actor sees as `conn.id`). */
     readonly id: string;
-    /**
-     * Registers a listener for outgoing messages from the actor.
-     *
-     * You can register multiple listeners on the same connection.
-     *
-     * @param callback - Called with each outgoing message sent to this connection.
-     * @returns A handle you can use to remove this listener without closing the socket.
-     *
-     * @example
-     * ```typescript
-     * const conn = base44.actors.Chat("session-1").connect();
-     * const sub = conn.subscribe((msg) => {
-     *   if (msg.type === "message") console.log(msg.text);
-     * });
-     * ```
-     */
+    /** Register a message listener. Multiple are allowed; returns a per-listener unsubscribe. */
     subscribe(callback: (data: ToClientFor<N>) => void): ActorSubscription;
-    /**
-     * Sends an incoming message to the actor.
-     *
-     * The socket buffers messages until it opens. After {@link close}, the socket
-     * drops further sends.
-     *
-     * @param data - Incoming message to send. Typed through {@link ActorRegistry} when configured.
-     *
-     * @example
-     * ```typescript
-     * conn.send({ type: "message", text: "Hello" });
-     * ```
-     */
+    /** Send a message. Buffered by the socket until it's open; dropped after
+     * {@link close}. */
     send(data: ToServerFor<N>): void;
     /**
-     * Closes the connection and removes all listeners.
-     *
-     * Safe to call more than once. A connection also closes itself when it fails
-     * permanently. See {@link ActorRef.connect} for how to open a fresh connection.
-     *
-     * @example
-     * ```typescript
-     * conn.close();
-     * ```
+     * Tear down the socket, heartbeat, and all listeners. Safe to call more
+     * than once. A connection also closes itself when it fails permanently —
+     * see {@link ActorRef.connect}.
      */
     close(): void;
 }
 /**
- * Represents an actor session selected by actor name and session ID.
- *
- * Call {@link connect} to open the WebSocket and get a {@link Connection}.
+ * A handle to one actor instance — `base44.actors.MyActor(id)`. Call
+ * {@link connect} to open the socket and get a {@link Connection}.
  */
 export interface ActorRef<N extends string = string> {
     /**
-     * Creates or returns the {@link Connection} for this session.
-     *
-     * Repeated calls return the same connection until it closes. After a permanent
-     * failure, such as a missing actor or denied connection, fix the cause and call
-     * `connect()` again. Add subscriptions to the new connection.
+     * Open the WebSocket and return the {@link Connection}. Idempotent while the
+     * connection is open.
      *
-     * @param options - Optional connection settings, such as a stable connection ID.
-     * @returns The {@link Connection} for this actor session.
-     *
-     * @example
-     * ```typescript
-     * const conn = base44.actors.Chat("session-1").connect({ id: "tab-abc" });
-     * conn.subscribe((msg) => console.log(msg));
-     * ```
+     * A connection that fails permanently (for example, the actor doesn't exist
+     * or the caller isn't allowed to connect) closes itself and reports the
+     * error to the client's `onError` handler. Call `connect()` again after
+     * fixing the cause to get a fresh {@link Connection}, and re-subscribe.
      */
     connect(options?: ActorConnectOptions): Connection<N>;
 }
 /**
- * Selects a session for a named actor.
- *
- * Typed automatically when the actor is registered in {@link ActorRegistry} or
- * {@link ActorNameRegistry}.
+ * Client for a single named Actor — call it with an instance id to get an
+ * {@link ActorRef}. Typed automatically when the actor is registered in
+ * {@link ActorRegistry}.
  */
 export interface ActorClient<N extends string = string> {
-    /**
-     * Gets a reference to an actor session.
-     *
-     * Clients that specify the same actor name and session ID join the same session.
-     *
-     * @param instanceId - Session ID that identifies which session to connect to.
-     * @returns A reference to the actor session.
-     *
-     * @example
-     * ```typescript
-     * const session = base44.actors.Chat("lobby-1");
-     * const conn = session.connect();
-     * ```
-     */
     (instanceId: string): ActorRef<N>;
 }
 /**
- * Provides access to actors and their shared, live sessions.
- *
- * Select an actor by name and session ID, then connect a client to the
- * session. Clients in the same session can exchange realtime messages through the
- * actor. The client works in the browser and in Node.
- *
- * ## Connection flow
- *
- * - Connect to a session with `base44.actors.<ActorName>(sessionId).connect()`.
- * - Subscribe to outgoing messages with {@link Connection.subscribe}.
- * - Send incoming messages with {@link Connection.send}.
- * - Close the connection with {@link Connection.close}.
+ * The actors module provides access to Cloudflare Durable Object-backed
+ * Actors deployed by the Base44 platform.
  *
- * See [Actors Overview](/developers/backend/resources/actors/overview)
- * for actor concepts and terminology, and the [Actor Class Reference](/developers/backend/resources/actors/reference)
- * for the backend class API.
- *
- * ## Authentication modes
- *
- * This module is available in anonymous or user authentication mode
- * (`base44.actors`). It isn't available with service role authentication. Apps that
- * require login can reject anonymous connections in the actor's `handleConnect()` method.
- *
- * @example
  * ```typescript
- * const conn = base44.actors.Chat("session-1").connect({ id: "tab-1" });
- * const sub = conn.subscribe((msg) => console.log(msg));
+ * const conn = base44.actors.MyActor("room-1").connect();
+ * const sub = conn.subscribe((msg) => console.log(msg)); // typed via ActorRegistry
  * conn.send({ type: "message", text: "hi" });
  * sub.unsubscribe();
  * conn.close();

package/dist/modules/analytics-queue.d.ts

@@ -0,0 +1,12 @@
+import type { AxiosInstance } from "axios";
+import type { AnalyticsApiRequestData, AnalyticsModuleOptions } from "./analytics.types.js";
+type Event = AnalyticsApiRequestData & {
+    event_id?: string;
+};
+/** @internal One transport queue per client, shared by goals and exposures. */
+export declare function getAnalyticsQueue(axiosClient: AxiosInstance, appId: string, config: AnalyticsModuleOptions): {
+    enqueue(event: Event | Promise<Event>, authorization: string | null, userId: string | null | Promise<string | null>): void;
+    flush(): Promise<void>;
+    cleanup(): void;
+};
+export {};

package/dist/modules/analytics-queue.js

@@ -0,0 +1,128 @@
+const DELIVERY_BUDGET_MS = 5000;
+const queues = new WeakMap();
+/** @internal One transport queue per client, shared by goals and exposures. */
+export function getAnalyticsQueue(axiosClient, appId, config) {
+    let queue = queues.get(axiosClient);
+    if (!queue) {
+        queue = createAnalyticsQueue(axiosClient, appId, config);
+        queues.set(axiosClient, queue);
+    }
+    return queue;
+}
+function createAnalyticsQueue(axiosClient, appId, config) {
+    const entries = [];
+    const pending = new Set();
+    let timer;
+    function deliver(batch) {
+        const controller = new AbortController();
+        const deadlineAt = Date.now() + DELIVERY_BUDGET_MS;
+        const deadline = new Promise((resolve) => {
+            controller.signal.addEventListener("abort", () => resolve(), { once: true });
+        });
+        const timeout = setTimeout(() => controller.abort(), DELIVERY_BUDGET_MS);
+        function send(prepared) {
+            var _a;
+            const groups = new Map();
+            for (const entry of prepared) {
+                const key = JSON.stringify([entry.authorization, entry.userId, entry.event.session_id]);
+                const group = (_a = groups.get(key)) !== null && _a !== void 0 ? _a : [];
+                group.push(entry);
+                groups.set(key, group);
+            }
+            return Promise.all([...groups.values()].map(async (group) => {
+                var _a, _b;
+                const events = group.map(({ event }) => event);
+                const exposures = events.filter((event) => event.event_name === "__experiment_exposure__");
+                const attempts = exposures.length ? 3 : 1;
+                for (let attempt = 0; attempt < attempts; attempt++) {
+                    try {
+                        if (controller.signal.aborted)
+                            return;
+                        await axiosClient.request({
+                            method: "POST", url: `/apps/${appId}/analytics/track/batch`,
+                            headers: { Authorization: group[0].authorization },
+                            // Ordinary goals have no backend deduplication and remain single-attempt.
+                            data: { events: attempt === 0 ? events : exposures },
+                            timeout: Math.max(1, deadlineAt - Date.now()), signal: controller.signal,
+                        });
+                        return;
+                    }
+                    catch (error) {
+                        const status = (_b = (_a = error.response) === null || _a === void 0 ? void 0 : _a.status) !== null && _b !== void 0 ? _b : error.status;
+                        if (controller.signal.aborted || attempt === attempts - 1 ||
+                            (status !== undefined && (status < 500 || status >= 600)))
+                            return;
+                        await new Promise((resolve) => setTimeout(resolve, attempt === 0 ? 100 : 500));
+                    }
+                }
+            }));
+        }
+        const delivery = (async () => {
+            const ready = [];
+            const requests = [];
+            let wake = () => { };
+            let preparedAll = false;
+            const preparation = Promise.all(batch.map(async (entry) => {
+                const [event, userId] = await Promise.all([entry.event, entry.userId]);
+                if (event && !controller.signal.aborted)
+                    ready.push({ event, userId, authorization: entry.authorization });
+                wake();
+            })).then(() => { preparedAll = true; wake(); });
+            while (!preparedAll || ready.length) {
+                if (!ready.length && !preparedAll)
+                    await Promise.race([
+                        new Promise((resolve) => { wake = resolve; }), deadline,
+                    ]);
+                if (controller.signal.aborted)
+                    return;
+                // Coalesce this turn's resolved identities without waiting for unrelated auth I/O.
+                let turnTimer;
+                await Promise.race([preparation, new Promise((resolve) => { turnTimer = setTimeout(resolve, 0); })]);
+                clearTimeout(turnTimer);
+                if (ready.length)
+                    requests.push(send(ready.splice(0)));
+            }
+            await Promise.all(requests);
+        })();
+        // Identity lookup and transports that ignore cancellation must also be bounded.
+        const settlement = Promise.race([delivery, deadline]).catch(() => { }).finally(() => {
+            clearTimeout(timeout);
+            controller.abort();
+            pending.delete(settlement);
+        });
+        pending.add(settlement);
+    }
+    function schedule() {
+        var _a;
+        if (timer || entries.length === 0)
+            return;
+        timer = setTimeout(() => {
+            var _a;
+            timer = undefined;
+            deliver(entries.splice(0, (_a = config.batchSize) !== null && _a !== void 0 ? _a : 30));
+            schedule();
+        }, (_a = config.throttleTime) !== null && _a !== void 0 ? _a : 1000);
+    }
+    return {
+        enqueue(event, authorization, userId) {
+            var _a;
+            if (entries.length >= ((_a = config.maxQueueSize) !== null && _a !== void 0 ? _a : 1000))
+                return;
+            entries.push({ event: Promise.resolve(event).catch(() => undefined), authorization,
+                userId: Promise.resolve(userId).catch(() => null) });
+            schedule();
+        },
+        async flush() {
+            var _a;
+            clearTimeout(timer);
+            timer = undefined;
+            while (entries.length)
+                deliver(entries.splice(0, (_a = config.batchSize) !== null && _a !== void 0 ? _a : 30));
+            await Promise.all([...pending]);
+        },
+        cleanup() {
+            clearTimeout(timer);
+            timer = undefined;
+        },
+    };
+}