@semiont/api-client 0.5.4 → 0.5.5

package/dist/index.d.ts

@@ -1,23 +1,226 @@
+import { KyInstance } from 'ky';
+import { Observable, BehaviorSubject } from 'rxjs';
+import { ConnectionState, SemiontError, TransportErrorCode, ITransport, IBackendOperations, BaseUrl, AccessToken, Logger, EventMap, ResourceId, EventBus, Email, components, GoogleCredential, RefreshToken, UserResponse, ListUsersResponse, UserDID, UpdateUserRequest, UpdateUserResponse, BackendDownload, ProgressEvent, HealthCheckResponse, StatusResponse, IContentTransport, PutBinaryRequest, PutBinaryOptions, ContentFormat } from '@semiont/core';
+
+/** Minimal StateUnit surface — anything with a `dispose()` method. */
+interface StateUnit {
+    dispose(): void;
+}
+
+interface BusEvent {
+    channel: string;
+    payload: Record<string, unknown>;
+    scope?: string;
+}
+interface ActorStateUnitOptions {
+    baseUrl: string;
+    token: string | (() => string);
+    channels: string[];
+    scope?: string;
+    reconnectMs?: number;
+}
+/** Time in the `reconnecting` state before transitioning to `degraded`. */
+declare const DEGRADED_THRESHOLD_MS = 3000;
+interface ActorStateUnit extends StateUnit {
+    on$<T = Record<string, unknown>>(channel: string): Observable<T>;
+    emit(channel: string, payload: Record<string, unknown>, emitScope?: string): Promise<void>;
+    state$: Observable<ConnectionState>;
+    addChannels(channels: string[], scope?: string): void;
+    removeChannels(channels: string[]): void;
+    start(): void;
+    stop(): void;
+}
+declare function createActorStateUnit(options: ActorStateUnitOptions): ActorStateUnit;
+
 /**
- * @semiont/api-client
+ * HttpTransport — the HTTP/SSE implementation of ITransport.
  *
- * HTTP-specific transport adapters for the Semiont SDK. The dev-facing
- * surface (`SemiontClient`, namespaces, session, state units, helpers)
- * lives in `@semiont/sdk`. The shared transport contract
- * (`ITransport`, `IContentTransport`, `BRIDGED_CHANNELS`,
- * `ConnectionState`, response types) lives in `@semiont/core`.
+ * Phase 1 of TRANSPORT-ABSTRACTION. Owns everything that crosses the wire
+ * in remote mode: the bus actor (SSE + POST /bus/emit), auth/admin/exchange/
+ * system HTTP endpoints, and connection-state plumbing.
  *
- * Most consumers do not import from this package directly — `@semiont/sdk`
- * re-exports the HTTP adapters so a typical app does:
+ * Does NOT own the local coordination bus — that lives on `SemiontClient`.
+ * `bridgeInto(bus)` wires SSE-received events into the caller-supplied bus
+ * once at construction.
+ */
+
+type AuthResponse = components['schemas']['AuthResponse'];
+type TokenRefreshResponse = components['schemas']['TokenRefreshResponse'];
+type AdminUserStatsResponse = components['schemas']['AdminUserStatsResponse'];
+type OAuthConfigResponse = components['schemas']['OAuthConfigResponse'];
+declare class APIError extends SemiontError {
+    code: TransportErrorCode;
+    readonly status: number;
+    readonly statusText: string;
+    constructor(message: string, status: number, statusText: string, body?: unknown);
+}
+type TokenRefresher = () => Promise<string | null>;
+interface HttpTransportConfig {
+    baseUrl: BaseUrl;
+    /** Observable token source; headers read the current value. */
+    token$?: BehaviorSubject<AccessToken | null>;
+    timeout?: number;
+    retry?: number;
+    logger?: Logger;
+    /** Optional 401-recovery hook. See {@link TokenRefresher}. */
+    tokenRefresher?: TokenRefresher;
+}
+declare class HttpTransport implements ITransport, IBackendOperations {
+    readonly baseUrl: BaseUrl;
+    private readonly http;
+    private readonly token$;
+    private readonly logger?;
+    private readonly errorsSubject;
+    /**
+     * Stream of `APIError` instances surfaced from any HTTP request just
+     * before the transport throws to the caller. Satisfies the `ITransport`
+     * `errors$` contract — see `@semiont/core/transport.ts`.
+     */
+    readonly errors$: Observable<SemiontError>;
+    private _actor;
+    private _actorStarted;
+    private disposed;
+    private activeResource;
+    /** Buses we've been asked to bridge wire events into. */
+    private readonly bridges;
+    constructor(config: HttpTransportConfig);
+    get actor(): ActorStateUnit;
+    emit<K extends keyof EventMap>(channel: K, payload: EventMap[K], resourceScope?: ResourceId): Promise<void>;
+    on<K extends keyof EventMap>(channel: K, handler: (payload: EventMap[K]) => void): () => void;
+    stream<K extends keyof EventMap>(channel: K): Observable<EventMap[K]>;
+    /**
+     * Wire this transport's SSE fan-in into the given bus. Every channel
+     * in `BRIDGED_CHANNELS` (and subsequently per-resource scoped channels
+     * opened by `subscribeToResource`) is published on the bus. Safe to
+     * call multiple times — each bus is added to the fan-out list.
+     */
+    bridgeInto(bus: EventBus): void;
+    subscribeToResource(resourceId: ResourceId): () => void;
+    private makeUnsubscriber;
+    get state$(): Observable<ConnectionState>;
+    dispose(): void;
+    /**
+     * Route a transport-level error onto `errors$`. Used by sibling adapters
+     * (e.g. `HttpContentTransport`'s XHR upload path) that don't go through
+     * the `ky` `beforeError` hook and need to surface failures on the same
+     * stream the rest of the transport publishes to.
+     */
+    pushError(error: SemiontError): void;
+    private authHeaders;
+    authenticatePassword(email: Email, password: string): Promise<AuthResponse>;
+    authenticateGoogle(credential: GoogleCredential): Promise<AuthResponse>;
+    refreshAccessToken(token: RefreshToken): Promise<TokenRefreshResponse>;
+    logout(): Promise<void>;
+    acceptTerms(): Promise<void>;
+    getCurrentUser(): Promise<UserResponse>;
+    generateMcpToken(): Promise<{
+        token: string;
+    }>;
+    getMediaToken(resourceId: ResourceId): Promise<{
+        token: string;
+    }>;
+    listUsers(): Promise<ListUsersResponse>;
+    getUserStats(): Promise<AdminUserStatsResponse>;
+    updateUser(id: UserDID, data: UpdateUserRequest): Promise<UpdateUserResponse>;
+    getOAuthConfig(): Promise<OAuthConfigResponse>;
+    backupKnowledgeBase(): Promise<BackendDownload>;
+    restoreKnowledgeBase(file: File): Observable<ProgressEvent>;
+    exportKnowledgeBase(params?: {
+        includeArchived?: boolean;
+    }): Promise<BackendDownload>;
+    importKnowledgeBase(file: File): Observable<ProgressEvent>;
+    /**
+     * POST a file to a server-sent-events endpoint and surface each `data:`
+     * frame as an Observable emission. Completes when the stream closes;
+     * errors if the request itself fails or the SSE stream is aborted.
+     * The returned Observable is cold — the POST happens on subscribe and
+     * is aborted via `AbortController` on unsubscribe.
+     */
+    private sseProgressStream;
+    healthCheck(): Promise<HealthCheckResponse>;
+    getStatus(): Promise<StatusResponse>;
+    /**
+     * Temporary escape hatch for the ongoing transport migration: namespaces
+     * that still need to issue ad-hoc HTTP calls (e.g. legacy browse/mark
+     * HTTP fallbacks) can borrow the configured `ky` instance here. Will be
+     * deleted once all namespaces route through bus channels or through
+     * typed methods on this transport.
+     */
+    get rawHttp(): KyInstance;
+    /**
+     * Current access token (synchronously read from the BehaviorSubject).
+     * Used by content-transport and legacy namespace HTTP fallbacks that
+     * need to pass `auth: token` through some code paths.
+     */
+    getToken(): AccessToken | undefined;
+}
+
+/**
+ * HttpContentTransport — binary I/O over HTTP.
+ *
+ * Phase 1 of TRANSPORT-ABSTRACTION. Narrow by design because binary has
+ * different backpressure and streaming characteristics than typed command
+ * payloads. Uses the HttpTransport's underlying ky instance + token, so
+ * retries, logging, and auth behave identically to the rest of the wire.
+ *
+ * Two `putBinary` paths live side by side, selected by runtime
+ * environment + caller intent:
+ *   - **ky path (default + Node)** — the original `ky.post(...)` path.
+ *     Keeps retry-with-refresh, beforeError → APIError, observability
+ *     spans intact. Hits when no `onProgress`/`signal` is passed, OR
+ *     when `XMLHttpRequest` isn't available in the runtime (Node
+ *     workers, the CLI). On Node-side `signal`-aborts: the in-flight
+ *     `fetch` continues in the background and the `cancelled` flag in
+ *     `yield.resource` suppresses the resolve/reject callbacks.
+ *   - **XHR path (browsers with `onProgress` or `signal`)** — hand-rolled
+ *     because `ky` wraps `fetch` which can't observe upload byte-
+ *     progress today (`Request({ duplex: 'half' })` is the long-term
+ *     direction; not yet widely available across the webviews this
+ *     codepath needs to run in). Threads auth + traceparent headers,
+ *     emits `onProgress` from `xhr.upload.onprogress`, supports
+ *     cancellation via the `signal` option (calling `xhr.abort()`),
+ *     and routes failures onto the same `transport.errors$` stream
+ *     the ky path uses.
  *
- * ```ts
- * import { SemiontClient, HttpTransport, HttpContentTransport } from '@semiont/sdk';
- * ```
+ * The runtime check on `XMLHttpRequest` is the load-bearing seam: a
+ * Node worker calling `client.yield.resource(...)` (which always passes
+ * a `signal` for unsubscribe-aborts) must NOT take the XHR path —
+ * `XMLHttpRequest` is undefined and the upload throws synchronously.
+ * Browsers always have it; Node does not.
  *
- * Direct imports are appropriate when constructing the transport stack
- * by hand (CLI factories, MCP entrypoints, worker pools).
+ * v1 limitation: the XHR path does NOT auto-refresh on 401. Mitigation:
+ * the session's proactive refresh fires before token expiry, so an
+ * upload that *starts* with a fresh token usually completes. An upload
+ * spanning the narrow window between expiry and proactive-refresh would
+ * fail; the existing `errors$` → modal path surfaces it as session-
+ * expired. If retry-with-refresh on the upload path becomes a real
+ * complaint, wire a manual retry loop here that reads `token$` afresh.
  */
-export { HttpTransport, type HttpTransportConfig, type TokenRefresher, APIError, } from './transport/http-transport';
-export { HttpContentTransport } from './transport/http-content-transport';
-export { createActorStateUnit, type ActorStateUnit, type BusEvent, type ActorStateUnitOptions, DEGRADED_THRESHOLD_MS, } from './transport/actor-state-unit';
-//# sourceMappingURL=index.d.ts.map
+
+declare class HttpContentTransport implements IContentTransport {
+    private readonly transport;
+    constructor(transport: HttpTransport);
+    putBinary(request: PutBinaryRequest, options?: PutBinaryOptions): Promise<{
+        resourceId: ResourceId;
+    }>;
+    getBinary(resourceId: ResourceId, options?: {
+        accept?: ContentFormat | string;
+        auth?: AccessToken;
+    }): Promise<{
+        data: ArrayBuffer;
+        contentType: string;
+    }>;
+    getBinaryStream(resourceId: ResourceId, options?: {
+        accept?: ContentFormat | string;
+        auth?: AccessToken;
+    }): Promise<{
+        stream: ReadableStream<Uint8Array>;
+        contentType: string;
+    }>;
+    dispose(): void;
+    /** Auth header + W3C trace propagation for the active span. */
+    private requestHeaders;
+}
+
+export { APIError, DEGRADED_THRESHOLD_MS, HttpContentTransport, HttpTransport, createActorStateUnit };
+export type { ActorStateUnit, ActorStateUnitOptions, BusEvent, HttpTransportConfig, TokenRefresher };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@semiont/api-client",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "description": "Semiont API SDK - types, client, and utilities",
   "type": "module",
   "main": "dist/index.js",
@@ -31,9 +31,9 @@
   "scripts": {
     "pretypecheck": "npm run build --workspace=@semiont/core --if-present && npm run build --workspace=@semiont/observability --if-present",
     "typecheck": "tsc --noEmit",
-    "build": "npm run typecheck && tsup && tsc -p tsconfig.build.json",
+    "build": "npm run typecheck && tsup && tsc -p tsconfig.build.json && rollup -c rollup.dts.config.mjs && rm -rf dist-types",
     "watch": "tsup --watch",
-    "clean": "rm -rf dist",
+    "clean": "rm -rf dist dist-types",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage"
@@ -46,6 +46,8 @@
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.1.0",
+    "rollup": "^4.60.3",
+    "rollup-plugin-dts": "^6.4.1",
     "tsup": "^8.5.1",
     "typescript": "^6.0.2"
   },

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EACL,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,QAAQ,GACT,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAO1E,OAAO,EACL,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAC1B,qBAAqB,GACtB,MAAM,8BAA8B,CAAC"}

package/dist/transport/actor-state-unit.d.ts

@@ -1,32 +0,0 @@
-import { Observable } from 'rxjs';
-import { type ConnectionState } from '@semiont/core';
-/** Minimal StateUnit surface — anything with a `dispose()` method. */
-interface StateUnit {
-    dispose(): void;
-}
-export type { ConnectionState };
-export interface BusEvent {
-    channel: string;
-    payload: Record<string, unknown>;
-    scope?: string;
-}
-export interface ActorStateUnitOptions {
-    baseUrl: string;
-    token: string | (() => string);
-    channels: string[];
-    scope?: string;
-    reconnectMs?: number;
-}
-/** Time in the `reconnecting` state before transitioning to `degraded`. */
-export declare const DEGRADED_THRESHOLD_MS = 3000;
-export interface ActorStateUnit extends StateUnit {
-    on$<T = Record<string, unknown>>(channel: string): Observable<T>;
-    emit(channel: string, payload: Record<string, unknown>, emitScope?: string): Promise<void>;
-    state$: Observable<ConnectionState>;
-    addChannels(channels: string[], scope?: string): void;
-    removeChannels(channels: string[]): void;
-    start(): void;
-    stop(): void;
-}
-export declare function createActorStateUnit(options: ActorStateUnitOptions): ActorStateUnit;
-//# sourceMappingURL=actor-state-unit.d.ts.map

package/dist/transport/actor-state-unit.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"actor-state-unit.d.ts","sourceRoot":"","sources":["../../src/transport/actor-state-unit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,UAAU,EAAW,MAAM,MAAM,CAAC;AAE5D,OAAO,EAAU,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAS7D,sEAAsE;AACtE,UAAU,SAAS;IACjB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,2EAA2E;AAC3E,eAAO,MAAM,qBAAqB,OAAQ,CAAC;AAE3C,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IACjE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3F,MAAM,EAAE,UAAU,CAAC,eAAe,CAAC,CAAC;IACpC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtD,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACzC,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;CACd;AAYD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CA8TnF"}

package/dist/transport/http-content-transport.d.ts

@@ -1,69 +0,0 @@
-/**
- * HttpContentTransport — binary I/O over HTTP.
- *
- * Phase 1 of TRANSPORT-ABSTRACTION. Narrow by design because binary has
- * different backpressure and streaming characteristics than typed command
- * payloads. Uses the HttpTransport's underlying ky instance + token, so
- * retries, logging, and auth behave identically to the rest of the wire.
- *
- * Two `putBinary` paths live side by side, selected by runtime
- * environment + caller intent:
- *   - **ky path (default + Node)** — the original `ky.post(...)` path.
- *     Keeps retry-with-refresh, beforeError → APIError, observability
- *     spans intact. Hits when no `onProgress`/`signal` is passed, OR
- *     when `XMLHttpRequest` isn't available in the runtime (Node
- *     workers, the CLI). On Node-side `signal`-aborts: the in-flight
- *     `fetch` continues in the background and the `cancelled` flag in
- *     `yield.resource` suppresses the resolve/reject callbacks.
- *   - **XHR path (browsers with `onProgress` or `signal`)** — hand-rolled
- *     because `ky` wraps `fetch` which can't observe upload byte-
- *     progress today (`Request({ duplex: 'half' })` is the long-term
- *     direction; not yet widely available across the webviews this
- *     codepath needs to run in). Threads auth + traceparent headers,
- *     emits `onProgress` from `xhr.upload.onprogress`, supports
- *     cancellation via the `signal` option (calling `xhr.abort()`),
- *     and routes failures onto the same `transport.errors$` stream
- *     the ky path uses.
- *
- * The runtime check on `XMLHttpRequest` is the load-bearing seam: a
- * Node worker calling `client.yield.resource(...)` (which always passes
- * a `signal` for unsubscribe-aborts) must NOT take the XHR path —
- * `XMLHttpRequest` is undefined and the upload throws synchronously.
- * Browsers always have it; Node does not.
- *
- * v1 limitation: the XHR path does NOT auto-refresh on 401. Mitigation:
- * the session's proactive refresh fires before token expiry, so an
- * upload that *starts* with a fresh token usually completes. An upload
- * spanning the narrow window between expiry and proactive-refresh would
- * fail; the existing `errors$` → modal path surfaces it as session-
- * expired. If retry-with-refresh on the upload path becomes a real
- * complaint, wire a manual retry loop here that reads `token$` afresh.
- */
-import type { AccessToken, ContentFormat, ResourceId, PutBinaryOptions } from '@semiont/core';
-import type { HttpTransport } from './http-transport';
-import type { IContentTransport, PutBinaryRequest } from '@semiont/core';
-export declare class HttpContentTransport implements IContentTransport {
-    private readonly transport;
-    constructor(transport: HttpTransport);
-    putBinary(request: PutBinaryRequest, options?: PutBinaryOptions): Promise<{
-        resourceId: ResourceId;
-    }>;
-    getBinary(resourceId: ResourceId, options?: {
-        accept?: ContentFormat | string;
-        auth?: AccessToken;
-    }): Promise<{
-        data: ArrayBuffer;
-        contentType: string;
-    }>;
-    getBinaryStream(resourceId: ResourceId, options?: {
-        accept?: ContentFormat | string;
-        auth?: AccessToken;
-    }): Promise<{
-        stream: ReadableStream<Uint8Array>;
-        contentType: string;
-    }>;
-    dispose(): void;
-    /** Auth header + W3C trace propagation for the active span. */
-    private requestHeaders;
-}
-//# sourceMappingURL=http-content-transport.d.ts.map

package/dist/transport/http-content-transport.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"http-content-transport.d.ts","sourceRoot":"","sources":["../../src/transport/http-content-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAG9F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEzE,qBAAa,oBAAqB,YAAW,iBAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAE/C,SAAS,CACb,OAAO,EAAE,gBAAgB,EACzB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC;QAAE,UAAU,EAAE,UAAU,CAAA;KAAE,CAAC;IAoDhC,SAAS,CACb,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,WAAW,CAAA;KAAE,GAChE,OAAO,CAAC;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAmBhD,eAAe,CACnB,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,WAAW,CAAA;KAAE,GAChE,OAAO,CAAC;QAAE,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAwBvE,OAAO,IAAI,IAAI;IAKf,+DAA+D;IAC/D,OAAO,CAAC,cAAc;CAUvB"}

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

@@ -1,130 +0,0 @@
-/**
- * HttpTransport — the HTTP/SSE implementation of ITransport.
- *
- * Phase 1 of TRANSPORT-ABSTRACTION. Owns everything that crosses the wire
- * in remote mode: the bus actor (SSE + POST /bus/emit), auth/admin/exchange/
- * system HTTP endpoints, and connection-state plumbing.
- *
- * Does NOT own the local coordination bus — that lives on `SemiontClient`.
- * `bridgeInto(bus)` wires SSE-received events into the caller-supplied bus
- * once at construction.
- */
-import { type KyInstance } from 'ky';
-import { BehaviorSubject, Observable } from 'rxjs';
-import type { AccessToken, BaseUrl, Email, EventBus, EventMap, GoogleCredential, Logger, RefreshToken, ResourceId, UserDID, components } from '@semiont/core';
-import { SemiontError } from '@semiont/core';
-import type { TransportErrorCode } from '@semiont/core';
-import { type ActorStateUnit } from './actor-state-unit';
-import type { BackendDownload, ConnectionState, IBackendOperations, ITransport, HealthCheckResponse, StatusResponse, UserResponse, UpdateUserRequest, UpdateUserResponse, ListUsersResponse, ProgressEvent } from '@semiont/core';
-type AuthResponse = components['schemas']['AuthResponse'];
-type TokenRefreshResponse = components['schemas']['TokenRefreshResponse'];
-type AdminUserStatsResponse = components['schemas']['AdminUserStatsResponse'];
-type OAuthConfigResponse = components['schemas']['OAuthConfigResponse'];
-export declare class APIError extends SemiontError {
-    code: TransportErrorCode;
-    readonly status: number;
-    readonly statusText: string;
-    constructor(message: string, status: number, statusText: string, body?: unknown);
-}
-export type TokenRefresher = () => Promise<string | null>;
-export interface HttpTransportConfig {
-    baseUrl: BaseUrl;
-    /** Observable token source; headers read the current value. */
-    token$?: BehaviorSubject<AccessToken | null>;
-    timeout?: number;
-    retry?: number;
-    logger?: Logger;
-    /** Optional 401-recovery hook. See {@link TokenRefresher}. */
-    tokenRefresher?: TokenRefresher;
-}
-export declare class HttpTransport implements ITransport, IBackendOperations {
-    readonly baseUrl: BaseUrl;
-    private readonly http;
-    private readonly token$;
-    private readonly logger?;
-    private readonly errorsSubject;
-    /**
-     * Stream of `APIError` instances surfaced from any HTTP request just
-     * before the transport throws to the caller. Satisfies the `ITransport`
-     * `errors$` contract — see `@semiont/core/transport.ts`.
-     */
-    readonly errors$: Observable<SemiontError>;
-    private _actor;
-    private _actorStarted;
-    private disposed;
-    private activeResource;
-    /** Buses we've been asked to bridge wire events into. */
-    private readonly bridges;
-    constructor(config: HttpTransportConfig);
-    get actor(): ActorStateUnit;
-    emit<K extends keyof EventMap>(channel: K, payload: EventMap[K], resourceScope?: ResourceId): Promise<void>;
-    on<K extends keyof EventMap>(channel: K, handler: (payload: EventMap[K]) => void): () => void;
-    stream<K extends keyof EventMap>(channel: K): Observable<EventMap[K]>;
-    /**
-     * Wire this transport's SSE fan-in into the given bus. Every channel
-     * in `BRIDGED_CHANNELS` (and subsequently per-resource scoped channels
-     * opened by `subscribeToResource`) is published on the bus. Safe to
-     * call multiple times — each bus is added to the fan-out list.
-     */
-    bridgeInto(bus: EventBus): void;
-    subscribeToResource(resourceId: ResourceId): () => void;
-    private makeUnsubscriber;
-    get state$(): Observable<ConnectionState>;
-    dispose(): void;
-    /**
-     * Route a transport-level error onto `errors$`. Used by sibling adapters
-     * (e.g. `HttpContentTransport`'s XHR upload path) that don't go through
-     * the `ky` `beforeError` hook and need to surface failures on the same
-     * stream the rest of the transport publishes to.
-     */
-    pushError(error: SemiontError): void;
-    private authHeaders;
-    authenticatePassword(email: Email, password: string): Promise<AuthResponse>;
-    authenticateGoogle(credential: GoogleCredential): Promise<AuthResponse>;
-    refreshAccessToken(token: RefreshToken): Promise<TokenRefreshResponse>;
-    logout(): Promise<void>;
-    acceptTerms(): Promise<void>;
-    getCurrentUser(): Promise<UserResponse>;
-    generateMcpToken(): Promise<{
-        token: string;
-    }>;
-    getMediaToken(resourceId: ResourceId): Promise<{
-        token: string;
-    }>;
-    listUsers(): Promise<ListUsersResponse>;
-    getUserStats(): Promise<AdminUserStatsResponse>;
-    updateUser(id: UserDID, data: UpdateUserRequest): Promise<UpdateUserResponse>;
-    getOAuthConfig(): Promise<OAuthConfigResponse>;
-    backupKnowledgeBase(): Promise<BackendDownload>;
-    restoreKnowledgeBase(file: File): Observable<ProgressEvent>;
-    exportKnowledgeBase(params?: {
-        includeArchived?: boolean;
-    }): Promise<BackendDownload>;
-    importKnowledgeBase(file: File): Observable<ProgressEvent>;
-    /**
-     * POST a file to a server-sent-events endpoint and surface each `data:`
-     * frame as an Observable emission. Completes when the stream closes;
-     * errors if the request itself fails or the SSE stream is aborted.
-     * The returned Observable is cold — the POST happens on subscribe and
-     * is aborted via `AbortController` on unsubscribe.
-     */
-    private sseProgressStream;
-    healthCheck(): Promise<HealthCheckResponse>;
-    getStatus(): Promise<StatusResponse>;
-    /**
-     * Temporary escape hatch for the ongoing transport migration: namespaces
-     * that still need to issue ad-hoc HTTP calls (e.g. legacy browse/mark
-     * HTTP fallbacks) can borrow the configured `ky` instance here. Will be
-     * deleted once all namespaces route through bus channels or through
-     * typed methods on this transport.
-     */
-    get rawHttp(): KyInstance;
-    /**
-     * Current access token (synchronously read from the BehaviorSubject).
-     * Used by content-transport and legacy namespace HTTP fallbacks that
-     * need to pass `auth: token` through some code paths.
-     */
-    getToken(): AccessToken | undefined;
-}
-export type { ConnectionState } from '@semiont/core';
-//# sourceMappingURL=http-transport.d.ts.map

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

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