@abloatai/transaction 0.59.1 → 0.60.0

package/dist/sessions/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Session subsystem.
+ *
+ * Start here and descend into the public contract, issuance, server handler,
+ * source normalization, or credential lifecycle. Transports consume the
+ * normalized access contract and do not reconstruct session policy.
+ */
+export * from './contract.js';
+export * from './client.js';
+export * from './create.js';
+export * from './handler.js';
+export * from './source.js';
+export * from './lifecycle.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/sessions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sessions/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC"}

package/dist/sessions/index.js

@@ -0,0 +1,14 @@
+/**
+ * Session subsystem.
+ *
+ * Start here and descend into the public contract, issuance, server handler,
+ * source normalization, or credential lifecycle. Transports consume the
+ * normalized access contract and do not reconstruct session policy.
+ */
+export * from './contract.js';
+export * from './client.js';
+export * from './create.js';
+export * from './handler.js';
+export * from './source.js';
+export * from './lifecycle.js';
+//# sourceMappingURL=index.js.map

package/dist/sessions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sessions/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC"}

package/dist/{transport/connection/credentialLifecycle.d.ts → sessions/lifecycle.d.ts}

@@ -1,14 +1,14 @@
 /**
  * Keeps the short-lived access credential fresh. It owns the re-mint hook, a
  * single-flight guard that stops concurrent triggers from minting more than
- * once, and a browser-only proactive refresh — a timer plus an OS-wake listener
- * — that renews the credential ahead of expiry. It reaches the rest of the
+ * once, and proactive refresh — an expiry-aware timer plus a browser OS-wake
+ * listener — that renews the credential ahead of expiry. It reaches the rest of the
  * client only through the small {@link CredentialLifecycleContext} interface,
  * so the two can reference each other without an import cycle.
  */
-import type { RecoveryClass } from '../../errorCodes.js';
-import { type Logger } from '../../logger.js';
-import { type CredentialProvider, type CredentialProviderResult } from '../../auth/credentialResult.js';
+import type { RecoveryClass } from '../errorCodes.js';
+import { type Logger } from '../logger.js';
+import { type CredentialProvider, type CredentialProviderResult } from '../auth/credentialResult.js';
 /**
  * Tri-state outcome of a credential re-mint, mirroring the `getToken`
  * contract (see {@link CredentialLifecycle.refresh}).
@@ -175,4 +175,4 @@ export declare class CredentialLifecycle {
     /** Tear down the proactive credential lifecycle (idempotent). */
     stop(): void;
 }
-//# sourceMappingURL=credentialLifecycle.d.ts.map
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/sessions/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/sessions/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC9B,MAAM,6BAA6B,CAAC;AAErC;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,WAAW,GAAG,eAAe,GAAG,eAAe,CAAC;AAEvF;;;;;;GAMG;AACH,MAAM,MAAM,yBAAyB,GAAG,OAAO,GAAG,MAAM,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,MAAM,uBAAuB,GAAG,wBAAwB,CAAC;AAE/D;0DAC0D;AAC1D,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,CAAC;AAErD;;kDAEkD;AAClD,eAAO,MAAM,2BAA2B,QAAiB,CAAC;AAE1D,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB,QAAY,CAAC;AAE9C;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQvF;AAUD;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC;kEAC8D;IAC9D,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,0EAA0E;IAC1E,cAAc,IAAI,IAAI,CAAC;IACvB;gCAC4B;IAC5B,oBAAoB,IAAI,IAAI,CAAC;CAC9B;AAED,qBAAa,mBAAmB;IAoC5B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IApCzB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,mBAAmB,CAAoC;IAE/D;6EACyE;IACzE,OAAO,CAAC,yBAAyB,CAAkD;IAEnF;;wDAEoD;IACpD,OAAO,CAAC,2BAA2B,CAA6B;IAEhE;;;0BAGsB;IACtB,OAAO,CAAC,qBAAqB,CAAuB;IAEpD;;;mEAG+D;IAC/D,OAAO,CAAC,iBAAiB,CAA6B;gBAGnC,GAAG,EAAE,0BAA0B,EAC/B,MAAM,GAAE,MAAmB;IAG9C;;;;OAIG;IACH,YAAY,CAAC,SAAS,EAAE,mBAAmB,GAAG,IAAI,GAAG,IAAI;IAIzD,kFAAkF;IAClF,MAAM,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO;IAShD;;;;;;;;;;;;;;;OAeG;IACG,OAAO,IAAI,OAAO,CAAC,wBAAwB,CAAC;IAkDlD;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAmB3B;;;;;;;;;;;;;;;OAeG;IACG,wBAAwB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAY3F;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,KAAK,CAAC,QAAQ,EAAE,mBAAmB,EAAE,IAAI,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAqFhF,iEAAiE;IACjE,IAAI,IAAI,IAAI;CAIb"}

package/dist/{transport/connection/credentialLifecycle.js → sessions/lifecycle.js}

@@ -1,13 +1,13 @@
 /**
  * Keeps the short-lived access credential fresh. It owns the re-mint hook, a
  * single-flight guard that stops concurrent triggers from minting more than
- * once, and a browser-only proactive refresh — a timer plus an OS-wake listener
- * — that renews the credential ahead of expiry. It reaches the rest of the
+ * once, and proactive refresh — an expiry-aware timer plus a browser OS-wake
+ * listener — that renews the credential ahead of expiry. It reaches the rest of the
  * client only through the small {@link CredentialLifecycleContext} interface,
  * so the two can reference each other without an import cycle.
  */
-import { noopLogger } from '../../logger.js';
-import { credentialExpiry, credentialToken, } from '../../auth/credentialResult.js';
+import { noopLogger } from '../logger.js';
+import { credentialExpiry, credentialToken, } from '../auth/credentialResult.js';
 /** The fallback pre-roll interval, and also its ceiling: 10 minutes, which sits
  *  comfortably inside the server's 15-minute default credential lifetime. Used
  *  as-is when the refresher reports no expiry. */
@@ -321,4 +321,4 @@ export class CredentialLifecycle {
         this.credentialLifecycleTeardown = null;
     }
 }
-//# sourceMappingURL=credentialLifecycle.js.map
+//# sourceMappingURL=lifecycle.js.map

package/dist/sessions/lifecycle.js.map

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

package/dist/sessions/source.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Runtime lifecycle for a renewable session supplied to `Ablo({ session })`.
+ *
+ * A session provider mints a credential, while this boundary decides when to
+ * reuse it. Keeping that policy here prevents HTTP requests and the WebSocket
+ * bootstrap from independently minting duplicate sessions for the same actor.
+ */
+import type { CredentialProvider, CredentialProviderResult } from '../auth/credentialResult.js';
+import type { SessionProvider, SessionSource } from './contract.js';
+/** Cache one minted session until it approaches expiry; concurrent refreshes share one mint. */
+export declare function cachedSessionProvider(provider: SessionProvider): CredentialProvider;
+/** The one credential input a live transport consumes. */
+export interface SessionAccess {
+    readonly renewable: boolean;
+    credential(): Promise<CredentialProviderResult>;
+}
+/** Normalize a static or renewable session before it reaches a transport. */
+export declare function createSessionAccess(source: SessionSource | null | undefined, credential: () => Promise<CredentialProviderResult>): SessionAccess;
+/** Resolve the public session forms into the credential shape auth consumes. */
+export declare function resolveSessionCredential(source: SessionSource, options: {
+    readonly fetch?: typeof globalThis.fetch;
+    readonly dangerouslyAllowBrowser?: boolean;
+}): string | CredentialProvider;
+//# sourceMappingURL=source.d.ts.map

package/dist/sessions/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/sessions/source.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,wBAAwB,EACzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EACV,eAAe,EAEf,aAAa,EACd,MAAM,eAAe,CAAC;AAevB,gGAAgG;AAChG,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,kBAAkB,CAcnF;AAED,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,UAAU,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACjD;AAED,6EAA6E;AAC7E,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,EACxC,UAAU,EAAE,MAAM,OAAO,CAAC,wBAAwB,CAAC,GAClD,aAAa,CAOf;AAED,gFAAgF;AAChF,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE;IACP,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACzC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;CAC5C,GACA,MAAM,GAAG,kBAAkB,CAmB7B"}

package/dist/sessions/source.js

@@ -0,0 +1,56 @@
+/**
+ * Runtime lifecycle for a renewable session supplied to `Ablo({ session })`.
+ *
+ * A session provider mints a credential, while this boundary decides when to
+ * reuse it. Keeping that policy here prevents HTTP requests and the WebSocket
+ * bootstrap from independently minting duplicate sessions for the same actor.
+ */
+import { AbloValidationError } from '../errors.js';
+import { createEndpointCredentialResolver, isCredentialEndpoint, } from '../auth/credentialEndpoint.js';
+import { protectBrowserCredentialProvider } from '../auth/browserCredentialSafety.js';
+const SESSION_REFRESH_SKEW_MS = 30_000;
+function remainsUsable(session, now) {
+    const expiresAt = Date.parse(session.expiresAt);
+    return Number.isFinite(expiresAt) && expiresAt - now > SESSION_REFRESH_SKEW_MS;
+}
+/** Cache one minted session until it approaches expiry; concurrent refreshes share one mint. */
+export function cachedSessionProvider(provider) {
+    let current = null;
+    let refreshing = null;
+    return async () => {
+        if (current && remainsUsable(current, Date.now()))
+            return current;
+        refreshing ??= provider().then((next) => {
+            current = next;
+            return next;
+        }).finally(() => {
+            refreshing = null;
+        });
+        return refreshing;
+    };
+}
+/** Normalize a static or renewable session before it reaches a transport. */
+export function createSessionAccess(source, credential) {
+    return {
+        renewable: typeof source === 'function'
+            || (typeof source === 'object' && source !== null && 'endpoint' in source),
+        credential,
+    };
+}
+/** Resolve the public session forms into the credential shape auth consumes. */
+export function resolveSessionCredential(source, options) {
+    if (typeof source === 'function') {
+        return protectBrowserCredentialProvider(cachedSessionProvider(source), options.dangerouslyAllowBrowser);
+    }
+    if (!('endpoint' in source))
+        return source.token;
+    if (!isCredentialEndpoint(source.endpoint)) {
+        throw new AbloValidationError('`session.endpoint` expects a URL or path such as \'/api/ablo-session\'.', { code: 'invalid_options', param: 'session.endpoint' });
+    }
+    return protectBrowserCredentialProvider(createEndpointCredentialResolver(source.endpoint, {
+        fetch: options.fetch,
+        timeoutMs: source.timeoutMs,
+        allowCrossOrigin: source.allowCrossOrigin,
+    }), options.dangerouslyAllowBrowser);
+}
+//# sourceMappingURL=source.js.map

package/dist/sessions/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../src/sessions/source.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EACL,gCAAgC,EAChC,oBAAoB,GACrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,gCAAgC,EAAE,MAAM,oCAAoC,CAAC;AAEtF,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAEvC,SAAS,aAAa,CAAC,OAA6C,EAAE,GAAW;IAC/E,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChD,OAAO,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,GAAG,GAAG,uBAAuB,CAAC;AACjF,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,qBAAqB,CAAC,QAAyB;IAC7D,IAAI,OAAO,GAAgD,IAAI,CAAC;IAChE,IAAI,UAAU,GAA0C,IAAI,CAAC;IAE7D,OAAO,KAAK,IAAI,EAAE;QAChB,IAAI,OAAO,IAAI,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;YAAE,OAAO,OAAO,CAAC;QAClE,UAAU,KAAK,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YACtC,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;YACd,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC,CAAC,CAAC;QACH,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAQD,6EAA6E;AAC7E,MAAM,UAAU,mBAAmB,CACjC,MAAwC,EACxC,UAAmD;IAEnD,OAAO;QACL,SAAS,EACP,OAAO,MAAM,KAAK,UAAU;eACzB,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,UAAU,IAAI,MAAM,CAAC;QAC5E,UAAU;KACX,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,wBAAwB,CACtC,MAAqB,EACrB,OAGC;IAED,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,OAAO,gCAAgC,CACrC,qBAAqB,CAAC,MAAM,CAAC,EAC7B,OAAO,CAAC,uBAAuB,CAChC,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,UAAU,IAAI,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC;IACjD,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,mBAAmB,CAC3B,yEAAyE,EACzE,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,kBAAkB,EAAE,CACvD,CAAC;IACJ,CAAC;IACD,OAAO,gCAAgC,CAAC,gCAAgC,CAAC,MAAM,CAAC,QAAQ,EAAE;QACxF,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;KAC1C,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC;AACvC,CAAC"}

package/dist/transport/connection/index.d.ts

@@ -1,5 +1,4 @@
 /** Shared connection lifecycle boundary. */
 export * from './manager.js';
-export * from './credentialLifecycle.js';
 export * from './networkProbe.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/transport/connection/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transport/connection/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transport/connection/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC"}

package/dist/transport/connection/index.js

@@ -1,5 +1,4 @@
 /** Shared connection lifecycle boundary. */
 export * from './manager.js';
-export * from './credentialLifecycle.js';
 export * from './networkProbe.js';
 //# sourceMappingURL=index.js.map

package/dist/transport/connection/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/transport/connection/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/transport/connection/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC"}

package/dist/transport/connection/manager.d.ts

@@ -41,7 +41,7 @@
  */
 import { probeNetwork, type ProbeResult } from './networkProbe.js';
 import type { AuthTokenGetter } from '../../auth/credentialSource.js';
-import type { CredentialRefreshOutcome } from './credentialLifecycle.js';
+import type { CredentialRefreshOutcome } from '../../sessions/lifecycle.js';
 import { type Logger } from '../../logger.js';
 import { type TransportObservability } from '../../observability.js';
 export type ConnectionState = 'connected' | 'offline' | 'probing_network' | 'validating_session' | 'refreshing_credential' | 'reconnecting' | 'backoff' | 'waiting_for_network' | 'auth_blocked' | 'session_expired';

package/dist/transport/connection/manager.d.ts.map

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

package/dist/transport/http/client.d.ts

@@ -1,10 +1,13 @@
 import type { HttpClientConfig } from './options.js';
-import type { CommitResource, HttpClaimApi, HttpClaimsResource, HttpLogsResource, ModelReadOptions, ModelList, SessionResource } from '../../client/resources/httpResources.js';
+import type { CommitResource, HttpClaimApi, HttpClaimsResource, HttpLogsResource, ModelReadOptions, ModelList } from '../../client/resources/httpResources.js';
 import type { ModelCreateParams, ModelCreateManyParams, ModelDeleteParams, ServerReadOptions, ListAllOptions, ModelReadParams, ModelUpdateParams } from '../../client/resources/modelOperations.js';
 import type { Schema, SchemaRecord, InferModel, InferCreate } from '../../schema/schema.js';
 import { type ModelUpdater, type FunctionalUpdateOptions } from '../../client/resources/functionalUpdate.js';
+import type { JsonValue } from '../../types/streams.js';
 import type { ReadDependency } from '../../coordination/schema.js';
 import type { EffectiveAuthority } from '../../auth/capability.js';
+import type { WebSocketObservedDelta } from '../websocket/sessionContract.js';
+import type { CoreSyncEventMap } from '../websocket/transport.js';
 export interface AbloHttpClientOptions<S extends SchemaRecord> extends HttpClientConfig<S> {
     /**
      * Per-request deadline. A black-holed HTTP request otherwise has no platform
@@ -12,6 +15,16 @@ export interface AbloHttpClientOptions<S extends SchemaRecord> extends HttpClien
      * @default 30_000
      */
     readonly timeoutMs?: number;
+    /** Initial groups observed by a session-backed WebSocket client. */
+    readonly groups?: readonly string[];
+    /** Application frame names accepted by `subscribe` on the WebSocket transport. */
+    readonly collaborationEvents?: readonly string[];
+    /** Durable resume position for WebSocket observation. */
+    readonly cursorStore?: import('../../client/contract.js').ObserveCursorStore;
+    readonly cursorKey?: string;
+    readonly reconnectDelay?: number;
+    readonly maxReconnectDelay?: number;
+    readonly connectTimeoutMs?: number;
 }
 declare const capturedRowBrand: unique symbol;
 /** A point-read row whose exact watermark is privately retained by its client. */
@@ -30,7 +43,7 @@ export type HttpModelMutationParams<P> = Omit<P, 'reads'> & {
  * coordinated writes.
  * It deliberately omits the stateful client's local-only
  * reads (the `local` namespace) and live subscriptions (`onChange`), which need
- * a resident graph and a persistent socket; those are absent from the type, so
+ * a local graph and a persistent socket; those are absent from the type, so
  * reaching for one is a compile error rather than a runtime gap.
  *
  * This is also the base the reactive per-model surface is composed from, rather
@@ -101,7 +114,7 @@ export interface HttpModelClient<T, C = T> {
 }
 /**
  * The type of the stateless HTTP client: a typed {@link HttpModelClient} per
- * schema model, plus `commits`, `dispose`, and the session-mint surface. It
+ * schema model, plus `commits` and lifecycle operations. It
  * exposes only what request/response transport can do, so reaching for a
  * stateful-only capability — the `local` reads, `onChange`, or the synchronous
  * `claim.state`/`queue`/`reorder` reads — is a compile error rather than a value
@@ -134,21 +147,36 @@ export type AbloHttpClient<S extends SchemaRecord> = {
     dispose(): Promise<void>;
     /** Resolves the bearer credential this client authenticates with, or `null` if none is set. */
     getAuthToken(): Promise<string | null>;
-    /**
-     * Mints a short-lived, scoped session token. Minting is itself a stateless
-     * request, so it is available here even though the local-cache reads are not.
-     * Pass `{ user }` to mint an end-user key (`ek_`) or `{ agent, can }` to mint a
-     * scoped agent key (`rk_`). See {@link CreateSessionParams}.
-    */
-    readonly sessions: SessionResource<S>;
+};
+/** The same typed resource client, with server-pushed capabilities carried by WebSocket. */
+export type AbloWebSocketClient<S extends SchemaRecord> = AbloHttpClient<S> & {
+    observe(options?: {
+        signal?: AbortSignal;
+    }): AsyncIterable<WebSocketObservedDelta>;
+    subscribe<K extends keyof CoreSyncEventMap>(event: K, listener: (...args: CoreSyncEventMap[K]) => void): () => void;
+    updateSubscription(groups: readonly string[], options?: {
+        timeoutMs?: number;
+    }): Promise<{
+        groups: string[];
+    }>;
+    readonly presence: {
+        update(input?: {
+            readonly status?: 'online' | 'away' | 'offline';
+            readonly customStatus?: string;
+            readonly timezone?: string;
+            readonly activity?: Readonly<Record<string, JsonValue>>;
+        }): Promise<void>;
+    };
+    readonly collaboration: {
+        send(event: string, payload: Readonly<Record<string, JsonValue>>): Promise<void>;
+    };
 };
 /**
- * Builds the stateless, typed HTTP client. Each `client.<model>` resolves to the
- * protocol client's model accessor, while `commits`, `dispose`, and the other
- * protocol members pass through unchanged. No socket is ever opened; the bearer
- * credential is the identity.
+ * Builds the typed headless client. An API-key identity uses HTTP. A session
+ * identity uses one lazily opened WebSocket by default for commits and live
+ * coordination until `dispose()`; point reads and administration remain HTTP.
  */
-/** @internal Constructed only through the public `Ablo({ transport: 'http' })` factory. */
-export declare function createAbloHttpClient<S extends SchemaRecord>(options: AbloHttpClientOptions<S>): AbloHttpClient<S>;
+/** @internal Constructed only through the public `Ablo()` factory. */
+export declare function createAbloHttpClient<S extends SchemaRecord>(options: AbloHttpClientOptions<S>): AbloHttpClient<S> | AbloWebSocketClient<S>;
 export {};
 //# sourceMappingURL=client.d.ts.map

package/dist/transport/http/client.d.ts.map

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

package/dist/transport/http/client.js

@@ -18,14 +18,15 @@
  * stateful client offers.
  */
 import { createHttpTransport, } from './transport.js';
-import { modelWireNames } from '../../auth/capability.js';
 import { collectModelList, modelList } from '../../client/resources/httpResources.js';
 import { resolveCreateId } from '../../client/resources/modelCreate.js';
 import { omittedModelError } from '../../schema/select.js';
 import { reconcileFunctionalUpdate, } from '../../client/resources/functionalUpdate.js';
 import { AbloConnectionError, AbloValidationError } from '../../errors.js';
 import { capturePointRead, createReadSetContext, kReadEvidence, prepareReadSet, } from '../../commit/readSetContext.js';
-import { recordHttpCommitReceipt } from '../../commit/recordRuntime.js';
+import { recordHttpCommitReceipt, recordWebSocketCommitReceipt, } from '../../commit/recordRuntime.js';
+import { createWebSocketSession, } from '../websocket/session.js';
+import { subscribeWebSocketReadChanges } from '../websocket/contextSubscription.js';
 /**
  * Private transport members that pass straight through the facade. Everything
  * else must be a declared schema model; there is no dynamic fallback namespace.
@@ -39,7 +40,6 @@ const PROTOCOL_MEMBERS = new Set([
     'logs',
     'identity',
     'getAuthToken',
-    'sessions',
 ]);
 /** Narrows a bare property name to a transport key so the facade can index it typed. */
 function isProtocolMember(prop) {
@@ -189,29 +189,95 @@ function createHttpModelClient(protocol, modelName, clientIdentity, readSetConte
     };
 }
 /**
- * Builds the stateless, typed HTTP client. Each `client.<model>` resolves to the
- * protocol client's model accessor, while `commits`, `dispose`, and the other
- * protocol members pass through unchanged. No socket is ever opened; the bearer
- * credential is the identity.
+ * Builds the typed headless client. An API-key identity uses HTTP. A session
+ * identity uses one lazily opened WebSocket by default for commits and live
+ * coordination until `dispose()`; point reads and administration remain HTTP.
  */
-/** @internal Constructed only through the public `Ablo({ transport: 'http' })` factory. */
+/** @internal Constructed only through the public `Ablo()` factory. */
 export function createAbloHttpClient(options) {
     const { schema, onCommitReceipt, ...rest } = options;
+    const usesWebSocket = options.transport === 'websocket'
+        || (options.transport === undefined && options.session != null);
     const readSetContext = createReadSetContext();
     const transport = createHttpTransport({
         ...rest,
-        // Derived from the schema this client is bound to, never assembled by hand
-        // — see `auth/capability.ts`.
-        modelTypenames: modelWireNames(schema.models),
         onCommitReceipt: (observation) => {
             recordHttpCommitReceipt(readSetContext, observation);
             onCommitReceipt?.(observation);
         },
+        ...(usesWebSocket ? {
+            dispatchCommit: async (input) => {
+                const receipt = await (await webSocketSession()).commit(input);
+                recordWebSocketCommitReceipt(readSetContext, {
+                    receipt,
+                    operations: input.operations,
+                    reads: input.reads,
+                });
+                return receipt;
+            },
+            dispatchClaim: async (input) => (await webSocketSession()).claim(input),
+            releaseDispatchedClaim: (input) => {
+                void webSocketSession().then((session) => session.release(input));
+            },
+        } : {}),
     });
     const schemaModels = new Set(Object.keys(schema.models));
     const clientIdentity = {};
     const omittedModels = new Set(schema.omittedModels ?? []);
     const models = new Map();
+    let webSocket = null;
+    let webSocketPromise = null;
+    const webSocketOpen = new AbortController();
+    let disposed = false;
+    const webSocketSession = () => {
+        if (disposed) {
+            return Promise.reject(new AbloConnectionError('This Ablo client is disposed.'));
+        }
+        if (webSocket)
+            return Promise.resolve(webSocket);
+        if (webSocketPromise)
+            return webSocketPromise;
+        webSocketPromise = (async () => {
+            await transport.ready();
+            const session = await createWebSocketSession({
+                baseUrl: rest.baseURL ?? undefined,
+                access: transport.access,
+                syncGroups: options.groups,
+                collaborationEvents: options.collaborationEvents,
+                cursorStore: options.cursorStore,
+                cursorKey: options.cursorKey,
+                reconnectDelay: options.reconnectDelay,
+                maxReconnectDelay: options.maxReconnectDelay,
+                connectTimeoutMs: options.connectTimeoutMs,
+            }, webSocketOpen.signal);
+            if (disposed) {
+                await session.close();
+                throw new AbloConnectionError('This Ablo client is disposed.');
+            }
+            webSocket = session;
+            return session;
+        })().finally(() => {
+            webSocketPromise = null;
+        });
+        return webSocketPromise;
+    };
+    const ready = async () => {
+        await transport.ready();
+        if (usesWebSocket)
+            await webSocketSession();
+    };
+    const dispose = async () => {
+        if (disposed)
+            return;
+        disposed = true;
+        webSocketOpen.abort();
+        const opening = webSocketPromise;
+        if (webSocket)
+            await webSocket.close();
+        else
+            await opening?.then((session) => session.close()).catch(() => undefined);
+        await transport.dispose();
+    };
     const model = (name) => {
         const cached = models.get(name);
         if (cached)
@@ -243,13 +309,51 @@ export function createAbloHttpClient(options) {
                 return {
                     context: readSetContext,
                     client: clientIdentity,
-                    onChange: transport.onChange,
+                    onChange: (reads, listener) => usesWebSocket
+                        ? subscribeWhenConnected(webSocketSession, reads, listener)
+                        : transport.onChange(reads, listener),
                 };
             }
             if (typeof prop !== 'string')
                 return undefined;
             if (prop === 'commits')
                 return commits;
+            if (prop === 'ready')
+                return ready;
+            if (prop === 'dispose')
+                return dispose;
+            if (usesWebSocket && prop === 'observe') {
+                return async function* (observeOptions) {
+                    yield* (await webSocketSession()).observe(observeOptions);
+                };
+            }
+            if (usesWebSocket && prop === 'subscribe') {
+                return (event, listener) => {
+                    let stop;
+                    let cancelled = false;
+                    void webSocketSession().then((session) => {
+                        if (!cancelled)
+                            stop = session.subscribe(event, listener);
+                    });
+                    return () => { cancelled = true; stop?.(); };
+                };
+            }
+            if (usesWebSocket && prop === 'updateSubscription') {
+                return async (groups, subscriptionOptions) => {
+                    const result = await (await webSocketSession()).updateSubscription(groups, subscriptionOptions);
+                    return { groups: result.syncGroups };
+                };
+            }
+            if (usesWebSocket && prop === 'presence') {
+                return {
+                    update: async (input) => (await webSocketSession()).presence.update(input),
+                };
+            }
+            if (usesWebSocket && prop === 'collaboration') {
+                return {
+                    send: async (event, payload) => (await webSocketSession()).collaboration.send(event, payload),
+                };
+            }
             // Real protocol members pass through unchanged.
             if (isProtocolMember(prop)) {
                 return transport[prop];
@@ -271,4 +375,13 @@ export function createAbloHttpClient(options) {
     // method on this type is missing at runtime.
     return facade;
 }
+function subscribeWhenConnected(session, reads, listener) {
+    let stop;
+    let cancelled = false;
+    void session().then((connected) => {
+        if (!cancelled)
+            stop = subscribeWebSocketReadChanges(connected, reads, listener);
+    });
+    return () => { cancelled = true; stop?.(); };
+}
 //# sourceMappingURL=client.js.map