js-bao-wss-client 2.0.4 → 2.0.6

package/dist/JsBaoClient.d.ts

@@ -20,6 +20,7 @@ import { UsersAPI } from "./api/usersApi";
 import { DatabasesAPI } from "./api/databasesApi";
 import { GroupsAPI } from "./api/groupsApi";
 import { CronTriggersAPI } from "./api/cronTriggersApi";
+import { ResourceMetadataAPI } from "./api/resourceMetadataApi";
 import { RuleSetsAPI } from "./api/ruleSetsApi";
 import { BlobBucketsAPI } from "./api/blobBucketsApi";
 import { GroupTypeConfigsAPI } from "./api/groupTypeConfigsApi";
@@ -27,7 +28,8 @@ import { CollectionTypeConfigsAPI } from "./api/collectionTypeConfigsApi";
 import { DatabaseTypeConfigsAPI } from "./api/databaseTypeConfigsApi";
 import { CollectionsAPI } from "./api/collectionsApi";
 import { InvitationsAPI } from "./api/invitationsApi";
-export { JsBaoError, isJsBaoError } from "./errors";
+import { NotificationsAPI } from "./api/notificationsApi";
+export { JsBaoError, isJsBaoError, JsBaoApiError, isJsBaoApiError, JsBaoNetworkError, isJsBaoNetworkError, } from "./errors";
 export type { JsBaoErrorCode } from "./errors";
 export { AuthError, AUTH_CODES } from "./internal/authController";
 export type { AuthCode } from "./internal/authController";
@@ -35,7 +37,7 @@ export type { DocumentInfo, DocumentPermissionEntry, DocumentInvitation, Documen
 export type { UserProfile, SharedDocument, SharedDocumentListResult, SharedDocumentsOptions, OwnedDocumentsOptions, } from "./api/meApi";
 export type { SessionInfo } from "./api/sessionApi";
 export type { BasicUserInfo, BatchUserProfile } from "./api/usersApi";
-export type { DatabaseInfo, DatabasePermissionEntry, DatabaseGroupPermissionEntry, GrantDatabaseGroupPermissionParams, DatabaseOwnershipTransferResult, DatabaseOperationInfo, AddManagerParams, GrantPermissionParams, CsvImportOptions, CsvImportProgress, CsvImportResult, DatabaseChangeEvent, DatabaseChangePayload, DatabaseSubscribeOptions, ListDatabasesOptions, } from "./api/databasesApi";
+export type { DatabaseInfo, DatabasePermissionEntry, DatabaseGroupPermissionEntry, GrantDatabaseGroupPermissionParams, DatabaseOwnershipTransferResult, DatabaseOperationInfo, AddManagerParams, GrantPermissionParams, CsvImportOptions, CsvImportProgress, CsvImportResult, CelContextResult, ExecuteOperationOptions, DatabaseChangeEvent, DatabaseChangePayload, DatabaseSubscribeOptions, ListDatabasesOptions, OperationType, OperationFilter, QueryDefinition, MutationOperation, MutationDefinition, CountDefinition, AggregateOperation, AggregateDefinition, PipelineStep, PipelineDefinition, ApplyToQuerySource, ApplyToQueryAction, ApplyToQueryDefinition, OperationDefinition, CreateOperationParams, UpdateOperationParams, } from "./api/databasesApi";
 export type { GroupInfo, GroupMemberInfo, GroupMembershipInfo, GroupDocumentInfo, GroupDatabaseInfo, ListUserMembershipsOptions, PaginatedResult, DirectGroupAdd, DeferredGroupAdd, GroupAddMemberResult, } from "./api/groupsApi";
 export type { CollectionInfo, CollectionDocumentInfo, CollectionGroupPermissionInfo, CollectionMemberInfo, CollectionAccessInfo, DocumentCollectionInfo, AddCollectionMemberParams, DirectCollectionAdd, DeferredCollectionAdd, CollectionAddMemberResult, PendingCollectionInvitationEntry, } from "./api/collectionsApi";
 export type { RuleSetInfo, RuleSetSchema, RuleSetTestResult, RuleSetDebugResult, TraceEntry, TriggerDefInfo, ModelRulesInfo, } from "./api/ruleSetsApi";
@@ -60,12 +62,15 @@ export type { SessionAPI } from "./api/sessionApi";
 export type { UsersAPI } from "./api/usersApi";
 export type { GroupsAPI } from "./api/groupsApi";
 export type { RuleSetsAPI } from "./api/ruleSetsApi";
-export type { BlobBucketsAPI, BlobBucketInfo, BlobBucketTtlTier, BlobBucketPreset, BlobBucketAccessPolicy, CreateBlobBucketParams, UpdateBlobBucketParams, BlobInfo, BlobUploadParams, BucketBlobUploadResult, BucketBlobListResult, BlobListOptions, BlobSignedUrlResult, } from "./api/blobBucketsApi";
+export type { NotificationsAPI, NotificationInfo, NotificationListOptions, NotificationListResult, NotificationSendResult, SendNotificationParams, PushDeviceInfo, RegisterPushDeviceParams, } from "./api/notificationsApi";
+export type { BlobBucketsAPI, BlobBucketInfo, BlobBucketTtlTier, BlobBucketPreset, BlobBucketAccessPolicy, CreateBlobBucketParams, UpdateBlobBucketParams, BlobInfo, BlobUploadParams, BucketBlobUploadResult, BucketBlobListResult, BlobListOptions, BlobSignedUrlResult, BatchBlobDeleteResult, } from "./api/blobBucketsApi";
 export type { GroupTypeConfigsAPI } from "./api/groupTypeConfigsApi";
 export type { CollectionTypeConfigsAPI } from "./api/collectionTypeConfigsApi";
 export type { DatabaseTypeConfigsAPI } from "./api/databaseTypeConfigsApi";
 export type { CronTriggersAPI } from "./api/cronTriggersApi";
 export type { CronTriggerInfo, CreateCronTriggerParams, UpdateCronTriggerParams, CronTriggerListResult, } from "./api/cronTriggersApi";
+export type { ResourceMetadataAPI } from "./api/resourceMetadataApi";
+export type { ResourceMetadataReadResult, ResourceMetadataWriteResult, ResourceMetadataBatchRequestItem, ResourceMetadataBatchParams, ResourceMetadataBatchCategoryResult, ResourceMetadataBatchResourceResult, ResourceMetadataBatchResult, ResourceMetadataListEntry, ResourceMetadataListResult, ResourceMetadataDeleteResult, } from "./api/resourceMetadataApi";
 export interface AnalyticsAutoEventsOptions {
     dailyAuth?: boolean;
     returnActive?: boolean;
@@ -92,13 +97,13 @@ export interface AnalyticsAutoEventsOptions {
     };
 }
 export type { GeminiRole, GeminiContentPart, GeminiMessage, GeminiPromptOptions, GeminiGenerateOptions, GeminiGenerateResult, GeminiModelSummary, GeminiStructuredOutput, GeminiGenerateRawOptions, } from "./api/geminiApi";
-export interface IntegrationCallRequest {
+export interface IntegrationCallRequest<TReq = any> {
     integrationKey: string;
     method?: string;
     path?: string;
     query?: Record<string, any>;
     headers?: Record<string, string>;
-    body?: any;
+    body?: TReq;
 }
 export interface IntegrationCallResponse<T = any> {
     status: number;
@@ -109,11 +114,29 @@ export interface IntegrationCallResponse<T = any> {
     errorCode?: string;
 }
 export interface IntegrationsAPI {
-    call<T = any>(request: IntegrationCallRequest): Promise<IntegrationCallResponse<T>>;
+    /**
+     * Call an integration's proxy endpoint.
+     *
+     * The optional generics are additive (issue #1542). `TRes` types the response
+     * body and is **first** to preserve the meaning of existing single-arg
+     * `call<MyResponse>()` call sites; `TReq` types the request `body`. Both
+     * default to today's untyped `any`, so untyped callers are unaffected.
+     */
+    call<TRes = any, TReq = any>(request: IntegrationCallRequest<TReq>): Promise<IntegrationCallResponse<TRes>>;
 }
 export interface WorkflowsAPI {
-    /** Start a workflow and return the run information */
-    start(options: StartWorkflowOptions): Promise<StartWorkflowResult>;
+    /**
+     * Start a workflow and return the run information.
+     *
+     * The optional generic `I` types the `input` payload (issue #1442). It is
+     * additive and defaults to today's untyped `Record<string, any>`, so existing
+     * callers that pass no type argument are unaffected. The generated per-workflow
+     * `<key>(client)` factory (`primitive workflows codegen`) supplies it from the
+     * workflow's `inputSchema`.
+     */
+    start<I = Record<string, any>>(options: Omit<StartWorkflowOptions, "input"> & {
+        input?: I;
+    }): Promise<StartWorkflowResult>;
     /**
      * Synchronously invoke a workflow and wait for the final result.
      *
@@ -126,12 +149,57 @@ export interface WorkflowsAPI {
      * including engine failure and timeout — failure surfaces as
      * `status: "failed"` (or `"timeout"` / `"terminated"`), not a thrown
      * error. Network / transport errors still reject as usual.
+     *
+     * The optional generics `I` (input) and `O` (`output`) type the payload and
+     * the result envelope (issue #1442). Both are additive and default to today's
+     * untyped `Record<string, any>` / `any`, so existing callers are unaffected.
+     * The generated per-workflow `<key>(client)` factory supplies them from the
+     * workflow's `inputSchema`/`outputSchema`.
      */
-    runSync(options: RunSyncWorkflowOptions): Promise<RunSyncWorkflowResult>;
-    /** Get the status of a workflow run. If contextDocId is not provided, uses the user's root document. */
-    getStatus(options: GetWorkflowStatusOptions): Promise<WorkflowStatusResult>;
-    /** Terminate a running workflow. If contextDocId is not provided, uses the user's root document. */
-    terminate(options: TerminateWorkflowOptions): Promise<WorkflowStatusResult>;
+    runSync<I = Record<string, any>, O = any>(options: Omit<RunSyncWorkflowOptions, "input"> & {
+        input?: I;
+    }): Promise<RunSyncWorkflowResult<O>>;
+    /**
+     * Get the status of a workflow run. If contextDocId is not provided, uses the
+     * user's root document.
+     *
+     * The optional generic `O` types the result envelope's `output` (issue #1512).
+     * It is additive and defaults to today's untyped `any`, so existing callers
+     * are unaffected. The generated per-workflow `<key>(client)` factory supplies
+     * it from the workflow's `outputSchema`.
+     */
+    getStatus<O = any>(options: GetWorkflowStatusOptions): Promise<WorkflowStatusResult<O>>;
+    /**
+     * Wait for an async workflow run to reach a terminal state, then resolve
+     * `{ status, output?, error? }` (#1443).
+     *
+     * Event-driven: it subscribes to the existing `workflowStatus` WebSocket
+     * frame and issues no polling. One reconcile fetch runs immediately after
+     * subscribing to close the started-before-subscribed race (the terminal
+     * frame is only delivered to live connections and is not replayed). On a WS
+     * reconnect it re-runs that single reconcile fetch — still no interval timer.
+     *
+     * Resolves on every terminal state, including workflow failure
+     * (`status: "failed"`) — a failing run does NOT reject. It also treats a run
+     * with `endedAt` set as terminal regardless of its `status`, so it is robust
+     * to the stale-status bug (#1388) rather than hanging on it.
+     *
+     * Rejects only on two conditions: the reconcile fetch 404s (unknown or
+     * not-owned `runId` → `NOT_FOUND`), or `timeoutMs` elapses
+     * (`WORKFLOW_WAIT_TIMEOUT`). Both paths remove the listener and clear the
+     * timer, so there is no leak.
+     */
+    waitFor(runId: string, options?: WaitForWorkflowOptions): Promise<WaitForWorkflowResult>;
+    /**
+     * Terminate a running workflow. If contextDocId is not provided, uses the
+     * user's root document.
+     *
+     * The optional generic `O` types the result envelope's `output` (issue #1512)
+     * — a terminated run can still carry partial output. Additive, defaults to
+     * `any`. The generated per-workflow factory emits a `terminate` member that
+     * binds this generic to the workflow's `<Key>Output` (issue #1543).
+     */
+    terminate<O = any>(options: TerminateWorkflowOptions): Promise<WorkflowStatusResult<O>>;
     /** List workflow runs for the current user */
     listRuns(options?: ListWorkflowRunsOptions): Promise<ListWorkflowRunsResult>;
     /** List step runs for a specific workflow run. The run must have been started by the current user. */
@@ -142,28 +210,48 @@ export interface WorkflowsAPI {
     confirmApply(options: ConfirmApplyOptions): Promise<ConfirmApplyResult>;
     /** Release a claimed workflow apply so another client can retry. Called automatically on apply handler failure. */
     releaseApply(options: ReleaseApplyOptions): Promise<ReleaseApplyResult>;
-    /** Fetch pending workflow applies for a document. */
+    /**
+     * Fetch pending workflow applies for a document.
+     *
+     * Returns a concrete `PendingApply[]` (issue #1542) instead of the former
+     * `any[]`. The server element carries no `output`, so there is no output
+     * generic here — the apply output is typed on `define`/`onApply<O>`, where it
+     * is actually delivered.
+     */
     getPendingApplies(options: {
         contextDocId: string;
-    }): Promise<any[]>;
-    /** Define a workflow with its apply handler. Call once at app initialization so any client can handle apply. */
-    define(workflowKey: string, options: WorkflowDefineOptions): void;
+    }): Promise<PendingApply[]>;
+    /**
+     * Define a workflow with its apply handler. Call once at app initialization
+     * so any client can handle apply.
+     *
+     * The optional generic `O` types the apply handler's `output` (issue #1542).
+     * It is additive and defaults to today's untyped `any`, so existing callers
+     * are unaffected.
+     */
+    define<O = any>(workflowKey: string, options: WorkflowDefineOptions<O>): void;
 }
 export interface PromptsAPI {
-    /** Execute a prompt by key and return the result */
-    execute(promptKey: string, options: ExecutePromptOptions): Promise<ExecutePromptResult>;
+    /**
+     * Execute a prompt by key and return the result.
+     *
+     * The optional generics are additive (issue #1542). `V` types the
+     * `variables` bag and `R` types `rawResponse`. Both default to today's
+     * untyped shapes, so existing callers are unaffected.
+     */
+    execute<V extends object = Record<string, any>, R = any>(promptKey: string, options: ExecutePromptOptions<V>): Promise<ExecutePromptResult<R>>;
 }
 /** Options for executing a prompt */
-export interface ExecutePromptOptions {
+export interface ExecutePromptOptions<V extends object = Record<string, any>> {
     /** Variables to pass to the prompt template */
-    variables: Record<string, any>;
+    variables: V;
     /** Override the model specified in the prompt config */
     modelOverride?: string;
     /** Specific config ID to use (defaults to activeConfigId) */
     configId?: string;
 }
 /** Result from executing a prompt */
-export interface ExecutePromptResult {
+export interface ExecutePromptResult<R = any> {
     success: boolean;
     output: string;
     error?: string;
@@ -173,7 +261,7 @@ export interface ExecutePromptResult {
         outputTokens?: number;
         totalTokens?: number;
     };
-    rawResponse: any;
+    rawResponse: R;
     configId: string;
 }
 export interface JsBaoClientOptions {
@@ -393,6 +481,24 @@ export interface BlobUploadFailedEvent {
  * events. See {@link InvitationEvent.action} for the full list and who
  * receives each.
  */
+/**
+ * Real-time mirror of a durable in-app notification (#779).
+ *
+ * Emitted over the `notification` event channel
+ * (`client.on("notification", ...)`) when the signed-in user receives an
+ * in-app notification while connected. The durable inbox row is the source
+ * of truth — fetch it (and older rows) via `client.notifications.list()`.
+ */
+export interface NotificationEvent {
+    type: "notification";
+    notificationId: string;
+    title: string;
+    body: string;
+    iconUrl?: string;
+    deepLink?: string;
+    sourceRef?: string;
+    createdAt: string;
+}
 export interface InvitationEvent {
     type: "invitation";
     /**
@@ -497,7 +603,7 @@ export interface RunSyncWorkflowOptions {
  * resolve with this shape — promise rejection is reserved for
  * connectivity / abort-before-send errors.
  */
-export interface RunSyncWorkflowResult {
+export interface RunSyncWorkflowResult<O = any> {
     runId: string;
     runKey: string;
     /**
@@ -510,7 +616,7 @@ export interface RunSyncWorkflowResult {
      */
     status: "completed" | "failed" | "terminated" | "timeout" | "apply_pending" | string;
     /** Final output of the workflow, when `status === "completed"`. */
-    output?: any;
+    output?: O;
     /** Error message when `status === "failed"`. */
     error?: string;
     /** Persisted `WorkflowRun` row for the call (always present on success). */
@@ -557,6 +663,14 @@ export interface ListWorkflowRunsOptions {
     /** Sort direction: true for ascending (oldest first), false/undefined for descending (newest first) */
     forward?: boolean;
 }
+/**
+ * Persisted status of a workflow run row. This is the model's documented set
+ * (`models.yaml` `WorkflowRun.status`) and is a superset of
+ * `WorkflowStatusValue` (it also includes `"queued"`). #1388 relies on it to
+ * distinguish terminal states — keep this union tied to the model's set so the
+ * two stay consistent.
+ */
+export type WorkflowRunStatus = "queued" | "running" | "completed" | "failed" | "terminated" | "apply_pending" | "apply_claimed";
 /** A workflow run record */
 export interface WorkflowRun {
     runId: string;
@@ -566,9 +680,25 @@ export interface WorkflowRun {
     workflowKey: string;
     revisionId: string;
     contextDocId?: string;
-    status: string;
-    createdAt: string;
+    status: WorkflowRunStatus;
+    /** ISO timestamp stamped when the run started. Emitted by all run
+     *  serializers (the model field is `required`); optional here only to
+     *  tolerate hypothetical legacy records written before the field existed. */
+    startedAt?: string;
+    /** #1367 — ISO timestamp of the true execution start, stamped once Cloudflare
+     *  actually schedules the instance. `null`/absent while the run is still
+     *  queued. `startedAt` remains the request time. */
+    executionStartedAt?: string | null;
+    /** #1367 — derived queue delay in ms (`executionStartedAt − startedAt`), i.e.
+     *  how long the run sat queued before executing. `null` while still queued. */
+    queueDelayMs?: number | null;
+    /** #1367 — wall-clock ms the `env.WORKFLOW_APP.create()` call itself took.
+     *  `null` for runs started via a path that does not record it. */
+    createCallDurationMs?: number | null;
     endedAt?: string;
+    /** Error message when `status` is `"failed"`, `null` otherwise. Always
+     *  present in run responses (the server sends `errorMessage || null`). */
+    errorMessage?: string | null;
     /** User-defined metadata (max 1KB) */
     meta?: Record<string, any>;
 }
@@ -645,10 +775,16 @@ export interface TerminateWorkflowOptions {
  * spelling is normalized client-side and is no longer surfaced.
  */
 export type WorkflowStatusValue = "completed" | "failed" | "terminated" | "running" | "apply_pending" | "apply_claimed";
-/** Workflow status response */
-export interface WorkflowStatusResult {
+/**
+ * Workflow status response.
+ *
+ * The optional generic `O` types `output` (issue #1512). It defaults to `any`,
+ * so every existing bare reference to `WorkflowStatusResult` still compiles and
+ * the runtime is unchanged (the generic is erased).
+ */
+export interface WorkflowStatusResult<O = any> {
     status: WorkflowStatusValue;
-    output?: any;
+    output?: O;
     error?: string;
     run?: WorkflowRun;
 }
@@ -685,20 +821,61 @@ export interface ReleaseApplyResult {
     released: boolean;
     reason?: string;
 }
-/** Callback for applying a workflow result to a document */
-type WorkflowApplyHandler = (result: {
+/**
+ * Callback for applying a workflow result to a document. `O` types the
+ * workflow's `output` (issue #1542); it is additive and defaults to today's
+ * untyped `any`.
+ */
+type WorkflowApplyHandler<O = any> = (result: {
     workflowKey: string;
     runKey: string;
     runId: string;
     contextDocId?: string;
-    output: any;
+    output: O;
     startedByUserId?: string;
     meta?: Record<string, any>;
 }) => void | Promise<void>;
+/**
+ * One pending (or reclaimable) workflow apply, as returned by
+ * `workflows.getPendingApplies`. Concrete shape (issue #1542) mirroring the
+ * server element — it carries no `output`, so there is no output generic here.
+ */
+export interface PendingApply {
+    runId: string;
+    runKey: string;
+    workflowKey: string;
+    workflowId: string;
+    instanceId: string;
+    contextDocId: string;
+    /** "apply_pending", or "apply_claimed" for a run whose apply lease expired. */
+    status: string;
+    startedByUserId: string;
+    /**
+     * ISO timestamp the apply was claimed, or null once claimed and released.
+     * Absent (the key is omitted) for a run that has never been claimed, so this
+     * property is optional.
+     */
+    claimedAt?: string | null;
+    /**
+     * Connection id that holds/held the apply claim, or null. Absent for a run
+     * that has never been claimed, so this property is optional.
+     */
+    claimedBy?: string | null;
+    /** Apply-lease timeout in milliseconds. */
+    applyLeaseTimeoutMs: number;
+    /**
+     * Parsed workflow run metadata, or `null` when none was set. Typed as
+     * `unknown` because the server accepts and round-trips any JSON value here:
+     * `normalizeMeta` stores whatever was passed (object, array, string, number,
+     * boolean) and `parseMeta` returns that same shape. Narrow before use — do
+     * not assume an object.
+     */
+    meta: unknown;
+}
 /** Options for defining a workflow via `workflows.define()` */
-export interface WorkflowDefineOptions {
+export interface WorkflowDefineOptions<O = any> {
     /** Handler to apply workflow results to the document. Called automatically when this workflow completes with needsApply. */
-    onApply: WorkflowApplyHandler;
+    onApply: WorkflowApplyHandler<O>;
 }
 /** Options for {@link JsBaoClient.waitForUserId}. */
 export interface WaitForUserIdOptions {
@@ -710,6 +887,39 @@ export interface WaitForAuthReadyOptions {
     /** Maximum time to wait before rejecting (ms). */
     timeoutMs?: number;
 }
+/**
+ * Terminal status reported by `workflows.waitFor()` (#1443). Narrower than
+ * {@link WorkflowStatusValue} — `waitFor` only resolves once the run is done,
+ * so `"running"` can never be reported. `apply_pending`/`apply_claimed` are
+ * terminal for the purpose of waiting: the workflow finished and its result is
+ * available for the client-side apply step.
+ */
+export type WaitForWorkflowStatus = "completed" | "failed" | "terminated" | "apply_pending" | "apply_claimed";
+/** Options for {@link WorkflowsAPI.waitFor} (#1443). */
+export interface WaitForWorkflowOptions {
+    /**
+     * Maximum time to wait for the run to reach a terminal state before
+     * rejecting with a `WORKFLOW_WAIT_TIMEOUT` {@link JsBaoError}. Defaults to
+     * 15 minutes (900000 ms).
+     *
+     * Set to `0` or `Infinity` to disable the timeout entirely. WARNING: with no
+     * timeout the returned promise (and its `workflowStatus` listener) lives
+     * until the run terminates — only use this for runs you know will end.
+     */
+    timeoutMs?: number;
+}
+/**
+ * Result from {@link WorkflowsAPI.waitFor} (#1443). Resolved once the run
+ * reaches a terminal state.
+ */
+export interface WaitForWorkflowResult {
+    /** Terminal status of the run. Never `"running"`. */
+    status: WaitForWorkflowStatus;
+    /** Final output of the run, when available. */
+    output?: any;
+    /** Error message when `status === "failed"`. */
+    error?: string;
+}
 /** Options for {@link JsBaoClient.enableOfflineAccess}. */
 export interface EnableOfflineAccessOptions {
     /** If true, attempts passkey-based largeBlob storage before falling back to PIN. */
@@ -806,6 +1016,7 @@ export interface JsBaoEvents {
     meUpdated: MeUpdatedEvent;
     meUpdateFailed: MeUpdateFailedEvent;
     invitation: InvitationEvent;
+    notification: NotificationEvent;
     workflowStatus: WorkflowStatusEvent;
     workflowStarted: WorkflowStartedEvent;
     syncPerf: {
@@ -997,9 +1208,15 @@ export declare class JsBaoClient extends Observable<any> {
     /** Sub-API for managing cron triggers (workflow schedulers).
      * @group Sub-APIs */
     cronTriggers: CronTriggersAPI;
+    /** Sub-API for reading and writing typed resource metadata (single + batch).
+     * @group Sub-APIs */
+    resourceMetadata: ResourceMetadataAPI;
     /** Sub-API for app-level invitations and deferred grants.
      * @group Sub-APIs */
     invitations: InvitationsAPI;
+    /** Sub-API for the notification inbox (list, unread count, mark read, send).
+     * @group Sub-APIs */
+    notifications: NotificationsAPI;
     /** Sub-API for managing third-party integrations.
      * @group Sub-APIs */
     integrations: IntegrationsAPI;
@@ -1190,6 +1407,35 @@ export declare class JsBaoClient extends Observable<any> {
      */
     private runSyncWorkflow;
     private getWorkflowStatus;
+    /**
+     * Normalize a raw `{ status: rawStatus, run }` status response into a
+     * {@link WorkflowStatusResult}. Shared by `getStatus` (workflowKey/runKey
+     * route) and `waitFor`'s reconcile fetch (runId route) so both surfaces map
+     * the Cloudflare status spellings and apply-flow states identically.
+     */
+    private normalizeWorkflowStatusResponse;
+    /**
+     * Fetch normalized run status keyed by `runId` via the #1443 endpoint
+     * (`GET /workflows/runs/:runId/status`). Used by `waitFor`'s reconcile
+     * fetch. A 404 surfaces as a `NOT_FOUND` {@link JsBaoError} (unknown or
+     * not-owned run).
+     */
+    private getWorkflowStatusByRunId;
+    /**
+     * Implementation of {@link WorkflowsAPI.waitFor} (#1443). See the interface
+     * doc for the contract. Cleanup mirrors `createUserIdWaiter` in
+     * authController — a guarded `cleanup()` that clears the timer and removes
+     * every listener, run on every exit path.
+     */
+    private waitForWorkflow;
+    /**
+     * Collapse a normalized {@link WorkflowStatusValue} into the narrower
+     * {@link WaitForWorkflowStatus} for `waitFor`. Terminal statuses pass
+     * through unchanged. A `"running"` status only reaches here when `endedAt`
+     * is set (#1388): derive the real terminal state from the run row's error
+     * (failed if an error message is present, otherwise completed).
+     */
+    private toTerminalWaitStatus;
     private terminateWorkflow;
     private listWorkflowRuns;
     private listWorkflowStepRuns;
@@ -1312,7 +1558,7 @@ export declare class JsBaoClient extends Observable<any> {
      * @param documentId - The document to set awareness for
      * @param state - Arbitrary awareness data (cursor, selection, user info) to broadcast to collaborators
      * @group Awareness */
-    setAwareness(documentId: string, state: any): void;
+    setAwareness<S = any>(documentId: string, state: S): void;
     private getIndexedDbNames;
     private doesIndexedDbExist;
     /** Check if a document has IndexedDB persistence.
@@ -1382,6 +1628,7 @@ export declare class JsBaoClient extends Observable<any> {
     private handlePendingCreateFailed;
     private handleDocumentMetadataUpdate;
     private handleInvitationMessage;
+    private handleNotificationMessage;
     private handleWorkflowStatusMessage;
     private handleWorkflowStartedMessage;
     private handleOfflineAuthMessage;
@@ -1419,11 +1666,11 @@ export declare class JsBaoClient extends Observable<any> {
      *   Note: the server's wire field is named `metadata`; the local cache key is
      *   `docMetadata` to avoid colliding with the cache envelope's `metadata` key.
      * @group Documents */
-    updateLocalMetadata(documentId: string, updates: {
+    updateLocalMetadata<M = unknown>(documentId: string, updates: {
         title?: string;
         tags?: string[];
         thumbnailBlobId?: string | null;
-        docMetadata?: unknown | null;
+        docMetadata?: M | null;
     }): Promise<void>;
     private _updateSynced;
     /** Open a document for real-time collaboration and sync.
@@ -1633,15 +1880,15 @@ export declare class JsBaoClient extends Observable<any> {
      * @param documentId - The document to set awareness for
      * @param state - Arbitrary awareness data (cursor, selection, user info) to broadcast to collaborators
      * @group Awareness */
-    setLocalAwarenessState(documentId: string, state: any): void;
+    setLocalAwarenessState<S = any>(documentId: string, state: S): void;
     /** Get the local user's current awareness state for a document.
      * @param documentId - The document to get local awareness for
      * @group Awareness */
-    getLocalAwarenessState(documentId: string): any | null;
+    getLocalAwarenessState<S = any>(documentId: string): S | null;
     /** Get all users' awareness states for a document.
      * @param documentId - The document to get awareness states for
      * @group Awareness */
-    getAwarenessStates(documentId: string): Map<string, any>;
+    getAwarenessStates<S = any>(documentId: string): Map<string, S>;
     /** Remove awareness states for specific clients and broadcast the removal to the server.
      * @param documentId - The document to remove awareness from
      * @param clientIds - Array of client IDs whose awareness states should be removed
@@ -1883,9 +2130,14 @@ export declare class JsBaoClient extends Observable<any> {
         passkeyEnabled: boolean;
         passkeyRpId: string | null;
         passkeyRpName: string | null;
+        passkeyRpConfig: Record<string, {
+            name: string;
+        }> | null;
         hasPasskey: boolean;
         magicLinkEnabled: boolean;
         otpEnabled: boolean;
+        hasApple: boolean;
+        appleSignInEnabled: boolean;
     }>;
     private checkAndStartAutoOAuth;
     private handleLogoutCleanup;