@nuvin/session 0.1.0-rc.10

package/dist/client/daemon-client.d.ts

@@ -0,0 +1,50 @@
+import type { DaemonDataClient } from "./data-client.ts";
+import type { DirectoryServerConfig } from "./directory.ts";
+import { type SessionClient } from "./session-client.ts";
+import { type TransportSocket } from "./socket.ts";
+import { type WebSocketClientTransport, type WebSocketTransportOptions } from "./websocket.ts";
+export type DaemonTarget = {
+    kind: "local";
+    id: string;
+    name: string;
+    socketPath: string;
+    token: string;
+} | {
+    kind: "direct";
+    id: string;
+    name: string;
+    wsUrl: string;
+    token: string;
+} | {
+    kind: "relay";
+    id: string;
+    name: string;
+    apiBaseUrl: string;
+    getAccessToken: () => Promise<string>;
+    refreshAccessToken: () => Promise<string>;
+};
+export type DaemonClientDeps = {
+    udsFetch?: (socketPath: string) => typeof fetch;
+    fetchImpl?: typeof fetch;
+    socketFactory?: (url: string) => TransportSocket;
+};
+export type DropDaemonId<F> = F extends (daemonId: string, ...args: infer A) => infer R ? (...args: A) => R : never;
+export type BoundDaemonDataClient = {
+    [K in keyof DaemonDataClient]: DropDaemonId<DaemonDataClient[K]>;
+};
+export type SessionConnection = {
+    client: SessionClient;
+    transport: WebSocketClientTransport;
+    close(): void;
+};
+export type SessionConnectionOptions = Pick<WebSocketTransportOptions, "onDetached" | "onRejected">;
+export interface DaemonClient {
+    readonly target: DaemonTarget;
+    readonly data: BoundDaemonDataClient;
+    directoryEndpoint(): DirectoryServerConfig;
+    openSession(sessionId: string, options?: SessionConnectionOptions): SessionConnection;
+    close(): void;
+}
+export declare function bindDaemonDataClient(client: DaemonDataClient, daemonId: string): BoundDaemonDataClient;
+export declare function createDaemonClient(target: DaemonTarget, deps?: DaemonClientDeps): DaemonClient;
+//# sourceMappingURL=daemon-client.d.ts.map

package/dist/client/daemon-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-client.d.ts","sourceRoot":"","sources":["../../src/client/daemon-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE5D,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAEzE,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC/B,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,YAAY,GACpB;IACE,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,kBAAkB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3C,CAAC;AAEN,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,KAAK,CAAC;IAChD,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,eAAe,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC,GACnF,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,GACjB,KAAK,CAAC;AAEV,MAAM,MAAM,qBAAqB,GAAG;KACjC,CAAC,IAAI,MAAM,gBAAgB,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;CACjE,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,wBAAwB,CAAC;IACpC,KAAK,IAAI,IAAI,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,IAAI,CAAC,yBAAyB,EAAE,YAAY,GAAG,YAAY,CAAC,CAAC;AAEpG,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,iBAAiB,IAAI,qBAAqB,CAAC;IAC3C,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,iBAAiB,CAAC;IACtF,KAAK,IAAI,IAAI,CAAC;CACf;AASD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,MAAM,GACf,qBAAqB,CAiBvB;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,IAAI,GAAE,gBAAqB,GAC1B,YAAY,CA8Md"}

package/dist/client/data-client.d.ts

@@ -0,0 +1,79 @@
+import type { AddProviderInput, ConfigMutationResult, DaemonDirectoryRow, HistoryPage, ProfileSummary, ProviderConfigSummary, ProviderCredentialInput, SessionSnapshot, UpdateWorkspaceInput, WorkspaceConfigSummary } from "../protocol/index.ts";
+import type { TransportCredential } from "./endpoint.ts";
+/** Discovery payload: the daemon directory (account-scoped cloud, machine-scoped local). */
+export type DaemonDirectory = {
+    daemons: DaemonDirectoryRow[];
+    defaultSessionId?: string;
+};
+/**
+ * Live-attach endpoint for one daemon: ws URL + credential for the session
+ * socket. `credential` is exactly the transport's `TransportCredential`
+ * ({token} local / {grant} cloud), so a directory `getEndpoint` is a trivial
+ * wrapper over `acquireEndpoint`.
+ */
+export type DaemonEndpoint = {
+    url: string;
+    credential: TransportCredential;
+};
+/**
+ * Discovery: where daemons come from and how to dial them. Implemented by the
+ * HTTP client for both web modes (GET /api/daemons + POST /connect). The TUI
+ * does NOT use this half — its discovery is config `servers:` + UDS conventions.
+ */
+export interface DaemonDirectoryClient {
+    listDaemons(): Promise<DaemonDirectory>;
+    acquireEndpoint(daemonId: string): Promise<DaemonEndpoint>;
+}
+/**
+ * Per-daemon reads + stateless management — the plane shared by ALL clients
+ * (spec: data-plane unification). Method-for-method the client projection of
+ * DataRpcSchema. No HTTP status codes, URL shapes, or fetch types appear here.
+ * Terminal conditions throw `TerminalEndpointError` with a
+ * `DataClientTerminalReason`; `createWorkspace` failures carry the server's
+ * message; everything else is a plain `Error`.
+ */
+export interface DaemonDataClient {
+    fetchTranscript(daemonId: string, historyId: string, opts?: {
+        workspace?: string;
+        profile?: string;
+    }): Promise<SessionSnapshot>;
+    fetchHistory(daemonId: string, opts?: {
+        profile?: string;
+        cwd?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<HistoryPage>;
+    listWorkspaces(daemonId: string, opts?: {
+        profile?: string;
+    }): Promise<WorkspaceConfigSummary[]>;
+    createWorkspace(daemonId: string, opts: {
+        name: string;
+        root?: string;
+        profile?: string;
+    }): Promise<WorkspaceConfigSummary>;
+    deleteSession(daemonId: string, historyId: string, opts?: {
+        workspace?: string;
+        profile?: string;
+    }): Promise<void>;
+    listProfiles(daemonId: string): Promise<ProfileSummary[]>;
+    listProviders(daemonId: string, opts?: {
+        profile?: string;
+    }): Promise<ProviderConfigSummary[]>;
+    addProvider(daemonId: string, input: AddProviderInput): Promise<ConfigMutationResult<ProviderConfigSummary>>;
+    removeProvider(daemonId: string, providerId: string, opts?: {
+        profile?: string;
+    }): Promise<ConfigMutationResult<null>>;
+    setDefaultProvider(daemonId: string, providerId: string, opts?: {
+        profile?: string;
+    }): Promise<ConfigMutationResult<null>>;
+    setProviderAuth(daemonId: string, providerId: string, credential: ProviderCredentialInput, opts?: {
+        profile?: string;
+    }): Promise<ConfigMutationResult<null>>;
+    clearProviderAuth(daemonId: string, providerId: string, opts?: {
+        profile?: string;
+    }): Promise<ConfigMutationResult<null>>;
+    updateWorkspace(daemonId: string, name: string, patch: UpdateWorkspaceInput): Promise<ConfigMutationResult<WorkspaceConfigSummary>>;
+}
+/** The full client both web modes compose (spec §4.2). */
+export type DataClient = DaemonDirectoryClient & DaemonDataClient;
+//# sourceMappingURL=data-client.d.ts.map

package/dist/client/data-client.d.ts.map

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

package/dist/client/directory.d.ts

@@ -0,0 +1,99 @@
+import type { SessionDescriptor } from "../protocol/types.ts";
+import type { GetEndpoint } from "./endpoint.ts";
+import { type TransportSocket } from "./socket.ts";
+/**
+ * A configured daemon endpoint. Two forms (web spec §6):
+ * - static: `{url, token}` resolved upfront (local UDS / LAN TCP, unchanged);
+ * - endpoint provider: `getEndpoint()` resolves a FRESH `{url, credential}`
+ *   per connection attempt (cloud relay: POST /api/daemons/:id/connect).
+ */
+export type DirectoryServerConfig = {
+    name: string;
+    url?: string;
+    token?: string;
+    getEndpoint?: GetEndpoint;
+    /** Per-server socket factory (e.g. ws-over-UDS for the local daemon, spec §7). */
+    socketFactory?: (url: string) => TransportSocket;
+};
+/**
+ * Per-server panel status (spec §7): the merged view fills in incrementally
+ * and an unreachable server never blocks the panel.
+ */
+export type DirectoryServerStatus = {
+    state: "connecting";
+} | {
+    state: "online";
+    sessions: SessionDescriptor[];
+} | {
+    state: "offline";
+    error: string;
+};
+export type DirectoryServerView = {
+    name: string;
+    url: string;
+    status: DirectoryServerStatus;
+};
+export type DirectoryView = {
+    servers: DirectoryServerView[];
+};
+export type ServerDirectoryOptions = {
+    servers: DirectoryServerConfig[];
+    /** Test seam / socket override. Defaults to the global WHATWG WebSocket (browsers, node >= 22). */
+    socketFactory?: (url: string) => TransportSocket;
+    /** Connect + handshake deadline per server (ms). Default 5000. */
+    connectTimeoutMs?: number;
+};
+/**
+ * Multi-server session listing for the picker (spec §7). One directory socket
+ * per configured server: hello/welcome handshake (token in the hello frame,
+ * NEVER the URL — spec §4.1), then `list-sessions` and the pre-attach
+ * commands. Directory sockets never carry session traffic —
+ * attaching to a picked session opens a fresh WebSocketTransport.
+ *
+ * Failure policy (spec §8): auth/version rejections, timeouts, and dropped
+ * connections mark THAT server offline with an actionable message and reject
+ * its in-flight commands; other servers are untouched. There is no automatic
+ * reconnect loop — `refresh()` retries offline servers on demand.
+ */
+export interface ServerDirectory {
+    /** Stable reference between change notifications — safe for useSyncExternalStore. */
+    getView(): DirectoryView;
+    subscribe(listener: () => void): () => void;
+    /** Reconnect offline servers and re-issue list-sessions on online ones. */
+    refresh(): void;
+    /**
+     * Diff-update the server set (web cloud spec §6: the daemon list is re-polled).
+     * New names are added and connected; missing names are closed and removed
+     * (pending commands reject); kept names get their config replaced so future
+     * reconnects use the fresh endpoint provider. Live sockets of kept servers
+     * are untouched.
+     */
+    setServers(configs: DirectoryServerConfig[]): void;
+    createSession(server: string, options: {
+        cwd: string;
+        name?: string;
+        workspace?: string;
+        profile?: string;
+    }): Promise<SessionDescriptor>;
+    /**
+     * Switch-and-resume a cold session (spec §3/§5): issues `resume-session` and
+     * resolves the live `SessionDescriptor` the daemon rehydrated. The cold
+     * transcript carries no cwd, so the caller supplies the cwd the rehydrated
+     * runtime runs in. Idempotent daemon-side (an already-live id resolves to the
+     * existing live session).
+     */
+    resumeSession(server: string, historyId: string, options: {
+        cwd: string;
+        name?: string;
+        workspace?: string;
+        profile?: string;
+    }): Promise<SessionDescriptor>;
+    killSession(server: string, sessionId: string, options?: {
+        delete?: boolean;
+    }): Promise<void>;
+    /** Remote cwd completion for the new-session flow (spec §7). */
+    completePath(server: string, prefix: string): Promise<string[]>;
+    close(): void;
+}
+export declare function createServerDirectory(options: ServerDirectoryOptions): ServerDirectory;
+//# sourceMappingURL=directory.d.ts.map

package/dist/client/directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.d.ts","sourceRoot":"","sources":["../../src/client/directory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAuB,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEnF,OAAO,KAAK,EAAE,WAAW,EAAqB,MAAM,eAAe,CAAC;AACpE,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAEzE;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,kFAAkF;IAClF,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,eAAe,CAAC;CAClD,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,KAAK,EAAE,YAAY,CAAA;CAAE,GACvB;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,iBAAiB,EAAE,CAAA;CAAE,GAClD;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAExC,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,qBAAqB,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAAE,OAAO,EAAE,mBAAmB,EAAE,CAAA;CAAE,CAAC;AAE/D,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,mGAAmG;IACnG,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,eAAe,CAAC;IACjD,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B,qFAAqF;IACrF,OAAO,IAAI,aAAa,CAAC;IACzB,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5C,2EAA2E;IAC3E,OAAO,IAAI,IAAI,CAAC;IAChB;;;;;;OAMG;IACH,UAAU,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,IAAI,CAAC;IACnD,aAAa,CACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5E,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9B;;;;;;OAMG;IACH,aAAa,CACX,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5E,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9B,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9F,gEAAgE;IAChE,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAChE,KAAK,IAAI,IAAI,CAAC;CACf;AAqDD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CA8YtF"}

package/dist/client/endpoint.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Endpoint-provider seam (relay spec §9.1, web spec §6). Relay connections
+ * cannot know their URL or credential upfront: every attempt POSTs the
+ * server's connect endpoint for a fresh single-use channel URL + grant.
+ * `getEndpoint()` is that hook — the transport/directory call it before EVERY
+ * connection attempt (initial and each reconnect) so the reconnect loop itself
+ * stays unchanged. Static LAN/UDS configs keep passing `{url, token}` and
+ * never touch this. The credential is an opaque string either way — grant
+ * crypto never enters browser-safe client code.
+ */
+export type TransportCredential = {
+    token: string;
+} | {
+    grant: string;
+};
+export type TransportEndpoint = {
+    url: string;
+    credential: TransportCredential;
+};
+export type GetEndpoint = () => Promise<TransportEndpoint>;
+/**
+ * Thrown by a GetEndpoint when the failure is PERMANENT — the daemon is
+ * revoked/unregistered (connect endpoint 404s), so backoff retries can never
+ * succeed (web spec §10 "Revoked daemon"). The transport treats it like a
+ * server-initiated detach: terminal close + onDetached(reason). Transient
+ * failures (network, 409 daemon-offline, 5xx) stay plain errors and keep the
+ * normal retry-with-backoff behavior.
+ */
+export declare class TerminalEndpointError extends Error {
+    readonly reason: string;
+    constructor(reason: string, message?: string);
+}
+/**
+ * Terminal reasons a DataClient method may throw (as TerminalEndpointError):
+ * conditions where retry can never succeed. "unauthorized" = auth expired
+ * (cloud) or daemon token rotated (local) — re-auth, don't retry.
+ */
+export type DataClientTerminalReason = "transcript-not-found" | "session-not-found" | "daemon-revoked" | "unauthorized";
+//# sourceMappingURL=endpoint.d.ts.map

package/dist/client/endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../../src/client/endpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE,MAAM,MAAM,iBAAiB,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAEjF,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAE3D;;;;;;;GAOG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAK7C;AAED;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAChC,sBAAsB,GACtB,mBAAmB,GACnB,gBAAgB,GAChB,cAAc,CAAC"}

package/dist/client/http-data-client.d.ts

@@ -0,0 +1,23 @@
+import type { DataClient } from "./data-client.ts";
+export type HttpDataClientOptions = {
+    /** "" / absent ⇒ same-origin (local). Absolute relay origin ⇒ cloud. */
+    baseUrl?: string;
+    /** Cloud: fresh Clerk JWT per request. Absent ⇒ no bearer on discovery. */
+    getToken?: () => Promise<string | null>;
+    /** Cloud relay: force-refresh after the first rejected /connect token. */
+    refreshAccessToken?: () => Promise<string | null>;
+    /** Cloud: 401 anywhere ⇒ route to /sign-in with return-to. */
+    onUnauthorized?: () => void;
+    fetchImpl?: typeof fetch;
+};
+/** Derive the daemon's HTTP origin from its ws url: ws→http, wss→https. */
+export declare function httpBaseFromWsUrl(wsUrl: string): string;
+/**
+ * The single HTTP DataClient for BOTH web modes (spec §4.3). Local: same-origin
+ * discovery, per-row daemon base + static bearer for data methods, static
+ * endpoints. Cloud: relay base, Clerk bearer, POST /connect for endpoints.
+ * Mode is entirely captured in `options` + the row shapes returned by
+ * GET /api/daemons; there is one code path.
+ */
+export declare function createHttpDataClient(options?: HttpDataClientOptions): DataClient;
+//# sourceMappingURL=http-data-client.d.ts.map

package/dist/client/http-data-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-data-client.d.ts","sourceRoot":"","sources":["../../src/client/http-data-client.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAmC,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGpF,MAAM,MAAM,qBAAqB,GAAG;IAClC,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxC,0EAA0E;IAC1E,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAClD,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,CAAC;AAEF,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIvD;AA0CD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,qBAA0B,GAAG,UAAU,CAuSpF"}

package/dist/client/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./daemon-client.ts";
+export * from "./data-client.ts";
+export * from "./directory.ts";
+export * from "./endpoint.ts";
+export * from "./http-data-client.ts";
+export * from "./session-client.ts";
+export * from "./socket.ts";
+export * from "./transport.ts";
+export * from "./uds-socket.ts";
+export * from "./websocket.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}