@telecabin/core 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,66 @@
+import type { InvitePreview, JoinResult, PollResult, Snapshot, Status, TelecabinEvent } from "./types.js";
+/** Default deployment used when no base URL is configured. */
+export declare const DEFAULT_BASE_URL = "https://telecabin.app";
+export interface ClientOptions {
+    baseUrl: string;
+    slug: string;
+    token: string;
+    /** Override `fetch` (for tests). Defaults to the global. */
+    fetch?: typeof fetch;
+}
+/**
+ * Participant-side client for a single telecabin session.
+ *
+ * Construct one with a `baseUrl`, `slug`, and bearer `token`, then read and
+ * write the session. Use the static `join` / `previewInvite` helpers to obtain
+ * a token from an invite code.
+ */
+export declare class TelecabinClient {
+    readonly baseUrl: string;
+    readonly slug: string;
+    private readonly token;
+    private readonly fetchImpl;
+    constructor(opts: ClientOptions);
+    private request;
+    /** Full session snapshot: status, participants, recent messages, cursor. */
+    snapshot(signal?: AbortSignal): Promise<Snapshot>;
+    /** Events strictly after `after`. Pass the returned `cursor` to the next call. */
+    poll(after?: number, limit?: number, signal?: AbortSignal): Promise<PollResult>;
+    /** Post a message. The server also resets your status to `idle`. */
+    send(content: string, signal?: AbortSignal): Promise<TelecabinEvent>;
+    /** Broadcast your presence status. */
+    setStatus(status: Status, meta?: Record<string, unknown>, signal?: AbortSignal): Promise<TelecabinEvent>;
+    /**
+     * Continuously poll and yield events as they arrive. Runs until the
+     * `signal` aborts. `intervalMs` is the gap between polls (default 2000).
+     */
+    stream(opts?: {
+        after?: number;
+        intervalMs?: number;
+        signal?: AbortSignal;
+    }): AsyncGenerator<TelecabinEvent, void>;
+    /**
+     * Poll until at least one matching event appears or the timeout elapses.
+     * Returns matching events (empty on timeout) and the advanced cursor.
+     */
+    waitForEvent(after: number, opts?: {
+        timeoutSec?: number;
+        intervalMs?: number;
+        filter?: (e: TelecabinEvent) => boolean;
+        signal?: AbortSignal;
+    }): Promise<PollResult>;
+    /** Join a session with an invite code, minting a fresh participant token. */
+    static join(opts: {
+        baseUrl: string;
+        code: string;
+        name: string;
+        fetch?: typeof fetch;
+    }): Promise<JoinResult>;
+    /** Preview the session behind an invite code without joining. */
+    static previewInvite(opts: {
+        baseUrl: string;
+        code: string;
+        fetch?: typeof fetch;
+    }): Promise<InvitePreview>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,UAAU,EACV,QAAQ,EACR,MAAM,EACN,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,8DAA8D;AAC9D,eAAO,MAAM,gBAAgB,0BAA0B,CAAC;AAExD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAuBD;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAE7B,IAAI,EAAE,aAAa;YAOjB,OAAO;IA4BrB,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIjD,kFAAkF;IAClF,IAAI,CAAC,KAAK,SAAI,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAQ1E,oEAAoE;IAC9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAQ1E,sCAAsC;IAChC,SAAS,CACb,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC;IAQ1B;;;OAGG;IACI,MAAM,CACX,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GACvE,cAAc,CAAC,cAAc,EAAE,IAAI,CAAC;IAoBvC;;;OAGG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE;QACJ,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC;QACxC,MAAM,CAAC,EAAE,WAAW,CAAC;KACjB,GACL,OAAO,CAAC,UAAU,CAAC;IAetB,6EAA6E;WAChE,IAAI,CAAC,IAAI,EAAE;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;KACtB,GAAG,OAAO,CAAC,UAAU,CAAC;IA8BvB,iEAAiE;WACpD,aAAa,CAAC,IAAI,EAAE;QAC/B,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;KACtB,GAAG,OAAO,CAAC,aAAa,CAAC;CAgB3B"}

package/dist/client.js

@@ -0,0 +1,170 @@
+import { TelecabinError } from "./errors.js";
+/** Default deployment used when no base URL is configured. */
+export const DEFAULT_BASE_URL = "https://telecabin.app";
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted)
+            return reject(new DOMException("Aborted", "AbortError"));
+        const t = setTimeout(() => {
+            signal?.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(t);
+            reject(new DOMException("Aborted", "AbortError"));
+        };
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}
+/**
+ * Participant-side client for a single telecabin session.
+ *
+ * Construct one with a `baseUrl`, `slug`, and bearer `token`, then read and
+ * write the session. Use the static `join` / `previewInvite` helpers to obtain
+ * a token from an invite code.
+ */
+export class TelecabinClient {
+    baseUrl;
+    slug;
+    token;
+    fetchImpl;
+    constructor(opts) {
+        this.baseUrl = opts.baseUrl.replace(/\/+$/, "");
+        this.slug = opts.slug;
+        this.token = opts.token;
+        this.fetchImpl = opts.fetch ?? fetch;
+    }
+    async request(path, init) {
+        const headers = {
+            Authorization: `Bearer ${this.token}`,
+        };
+        const reqInit = {
+            method: init?.method ?? "GET",
+            headers,
+            signal: init?.signal,
+        };
+        if (init?.body !== undefined) {
+            headers["Content-Type"] = "application/json";
+            reqInit.body = JSON.stringify(init.body);
+        }
+        let res;
+        try {
+            res = await this.fetchImpl(`${this.baseUrl}${path}`, reqInit);
+        }
+        catch (err) {
+            if (err instanceof DOMException && err.name === "AbortError")
+                throw err;
+            throw new TelecabinError("network_error", `Cannot reach ${this.baseUrl}: ${err.message}`);
+        }
+        if (!res.ok)
+            throw await TelecabinError.fromResponse(res);
+        return (await res.json());
+    }
+    /** Full session snapshot: status, participants, recent messages, cursor. */
+    snapshot(signal) {
+        return this.request(`/api/s/${this.slug}`, { signal });
+    }
+    /** Events strictly after `after`. Pass the returned `cursor` to the next call. */
+    poll(after = 0, limit, signal) {
+        const qs = new URLSearchParams({ after: String(after) });
+        if (limit)
+            qs.set("limit", String(limit));
+        return this.request(`/api/s/${this.slug}/events?${qs}`, {
+            signal,
+        });
+    }
+    /** Post a message. The server also resets your status to `idle`. */
+    async send(content, signal) {
+        const r = await this.request(`/api/s/${this.slug}/messages`, { method: "POST", body: { content }, signal });
+        return r.event;
+    }
+    /** Broadcast your presence status. */
+    async setStatus(status, meta, signal) {
+        const r = await this.request(`/api/s/${this.slug}/status`, { method: "POST", body: meta ? { status, meta } : { status }, signal });
+        return r.event;
+    }
+    /**
+     * Continuously poll and yield events as they arrive. Runs until the
+     * `signal` aborts. `intervalMs` is the gap between polls (default 2000).
+     */
+    async *stream(opts = {}) {
+        let cursor = opts.after ?? 0;
+        const interval = opts.intervalMs ?? 2000;
+        try {
+            while (!opts.signal?.aborted) {
+                const { events, cursor: next } = await this.poll(cursor, undefined, opts.signal);
+                for (const e of events)
+                    yield e;
+                cursor = next;
+                await sleep(interval, opts.signal);
+            }
+        }
+        catch (err) {
+            if (err instanceof DOMException && err.name === "AbortError")
+                return;
+            throw err;
+        }
+    }
+    /**
+     * Poll until at least one matching event appears or the timeout elapses.
+     * Returns matching events (empty on timeout) and the advanced cursor.
+     */
+    async waitForEvent(after, opts = {}) {
+        const deadline = Date.now() + (opts.timeoutSec ?? 50) * 1000;
+        const interval = opts.intervalMs ?? 2000;
+        let cursor = after;
+        for (;;) {
+            const res = await this.poll(cursor, undefined, opts.signal);
+            cursor = res.cursor;
+            const matched = opts.filter ? res.events.filter(opts.filter) : res.events;
+            if (matched.length > 0)
+                return { events: matched, cursor };
+            const remaining = deadline - Date.now();
+            if (remaining <= 0)
+                return { events: [], cursor };
+            await sleep(Math.min(interval, remaining), opts.signal);
+        }
+    }
+    /** Join a session with an invite code, minting a fresh participant token. */
+    static async join(opts) {
+        const base = opts.baseUrl.replace(/\/+$/, "");
+        const fetchImpl = opts.fetch ?? fetch;
+        let res;
+        try {
+            res = await fetchImpl(`${base}/api/join/${encodeURIComponent(opts.code)}`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ name: opts.name }),
+            });
+        }
+        catch (err) {
+            throw new TelecabinError("network_error", `Cannot reach ${base}: ${err.message}`);
+        }
+        if (!res.ok)
+            throw await TelecabinError.fromResponse(res);
+        const body = (await res.json());
+        return {
+            token: body.token,
+            slug: body.session.slug,
+            sessionName: body.session.name,
+            participant: body.participant,
+        };
+    }
+    /** Preview the session behind an invite code without joining. */
+    static async previewInvite(opts) {
+        const base = opts.baseUrl.replace(/\/+$/, "");
+        const fetchImpl = opts.fetch ?? fetch;
+        let res;
+        try {
+            res = await fetchImpl(`${base}/api/join/${encodeURIComponent(opts.code)}`);
+        }
+        catch (err) {
+            throw new TelecabinError("network_error", `Cannot reach ${base}: ${err.message}`);
+        }
+        if (!res.ok)
+            throw await TelecabinError.fromResponse(res);
+        const body = (await res.json());
+        return body.session;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,73 @@
+/** One saved session: where it lives and the token to reach it. */
+export interface Connection {
+    baseUrl: string;
+    slug: string;
+    token: string;
+    sessionName?: string;
+    participantName?: string;
+}
+/** Saved owner credentials for managing sessions from the CLI. */
+export interface OwnerProfile {
+    baseUrl: string;
+    key: string;
+}
+/** The on-disk config file shape. */
+export interface TelecabinConfig {
+    defaultConnection?: string;
+    connections: Record<string, Connection>;
+    owner?: OwnerProfile;
+}
+/** A connection resolved from flags, env, and/or config — ready to use. */
+export interface ResolvedConnection {
+    /** The config name this came from, if any. */
+    name?: string;
+    baseUrl: string;
+    slug: string;
+    token: string;
+    sessionName?: string;
+    participantName?: string;
+}
+/** Inputs that can override config when resolving a connection. */
+export interface ResolveInput {
+    connection?: string;
+    baseUrl?: string;
+    slug?: string;
+    token?: string;
+}
+/** Absolute path of the telecabin config file. */
+export declare function configPath(): string;
+/** Read the config file, returning an empty config if it does not exist. */
+export declare function loadConfig(): Promise<TelecabinConfig>;
+/** Write the config file, creating its directory and locking it to 0600. */
+export declare function saveConfig(config: TelecabinConfig): Promise<void>;
+/** Save a connection, optionally making it the default. */
+export declare function addConnection(name: string, connection: Connection, opts?: {
+    makeDefault?: boolean;
+}): Promise<void>;
+/** Remove a connection; clears the default pointer if it pointed here. */
+export declare function removeConnection(name: string): Promise<boolean>;
+/** Point the default at an existing connection. */
+export declare function setDefaultConnection(name: string): Promise<void>;
+/**
+ * Resolve the connection to use, layering inputs over env over config:
+ *
+ *   field = flag  ??  TELECABIN_<FIELD> env  ??  chosen connection  ??  default
+ *
+ * The chosen connection is `input.connection`, else `TELECABIN_CONNECTION`,
+ * else the config's `defaultConnection`. Throws `no_active_session` if no
+ * slug/token can be found.
+ */
+export declare function resolveConnection(input?: ResolveInput): Promise<ResolvedConnection>;
+/** Save the owner profile (base URL + owner API key). */
+export declare function setOwnerProfile(profile: OwnerProfile): Promise<void>;
+/** Inputs that can override the saved owner profile. */
+export interface ResolveOwnerInput {
+    baseUrl?: string;
+    key?: string;
+}
+/**
+ * Resolve owner credentials: flag → `TELECABIN_*` env → saved profile.
+ * Throws `no_active_session` when no owner key can be found.
+ */
+export declare function resolveOwner(input?: ResolveOwnerInput): Promise<OwnerProfile>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAMA,mEAAmE;AACnE,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,kEAAkE;AAClE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,qCAAqC;AACrC,MAAM,WAAW,eAAe;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED,2EAA2E;AAC3E,MAAM,WAAW,kBAAkB;IACjC,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,mEAAmE;AACnE,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAOD,kDAAkD;AAClD,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,4EAA4E;AAC5E,wBAAsB,UAAU,IAAI,OAAO,CAAC,eAAe,CAAC,CAmB3D;AAED,4EAA4E;AAC5E,wBAAsB,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAKvE;AAED,2DAA2D;AAC3D,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,EACtB,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACnC,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,0EAA0E;AAC1E,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASrE;AAED,mDAAmD;AACnD,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUtE;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,GAAE,YAAiB,GACvB,OAAO,CAAC,kBAAkB,CAAC,CAiC7B;AAED,yDAAyD;AACzD,wBAAsB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAI1E;AAED,wDAAwD;AACxD,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,KAAK,GAAE,iBAAsB,GAC5B,OAAO,CAAC,YAAY,CAAC,CAgBvB"}

package/dist/config.js

@@ -0,0 +1,124 @@
+import { chmod, mkdir, readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { DEFAULT_BASE_URL } from "./client.js";
+import { TelecabinError } from "./errors.js";
+function configDir() {
+    const xdg = process.env.XDG_CONFIG_HOME;
+    return xdg ? join(xdg, "telecabin") : join(homedir(), ".config", "telecabin");
+}
+/** Absolute path of the telecabin config file. */
+export function configPath() {
+    return join(configDir(), "config.json");
+}
+/** Read the config file, returning an empty config if it does not exist. */
+export async function loadConfig() {
+    let raw;
+    try {
+        raw = await readFile(configPath(), "utf8");
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            return { connections: {} };
+        }
+        throw err;
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        return { connections: parsed.connections ?? {}, ...parsed };
+    }
+    catch {
+        throw new TelecabinError("http_error", `Config file at ${configPath()} is not valid JSON.`);
+    }
+}
+/** Write the config file, creating its directory and locking it to 0600. */
+export async function saveConfig(config) {
+    const path = configPath();
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+    await chmod(path, 0o600);
+}
+/** Save a connection, optionally making it the default. */
+export async function addConnection(name, connection, opts = {}) {
+    const config = await loadConfig();
+    config.connections[name] = connection;
+    if (opts.makeDefault || !config.defaultConnection) {
+        config.defaultConnection = name;
+    }
+    await saveConfig(config);
+}
+/** Remove a connection; clears the default pointer if it pointed here. */
+export async function removeConnection(name) {
+    const config = await loadConfig();
+    if (!config.connections[name])
+        return false;
+    delete config.connections[name];
+    if (config.defaultConnection === name) {
+        config.defaultConnection = Object.keys(config.connections)[0];
+    }
+    await saveConfig(config);
+    return true;
+}
+/** Point the default at an existing connection. */
+export async function setDefaultConnection(name) {
+    const config = await loadConfig();
+    if (!config.connections[name]) {
+        throw new TelecabinError("no_active_session", `No saved connection named "${name}".`);
+    }
+    config.defaultConnection = name;
+    await saveConfig(config);
+}
+/**
+ * Resolve the connection to use, layering inputs over env over config:
+ *
+ *   field = flag  ??  TELECABIN_<FIELD> env  ??  chosen connection  ??  default
+ *
+ * The chosen connection is `input.connection`, else `TELECABIN_CONNECTION`,
+ * else the config's `defaultConnection`. Throws `no_active_session` if no
+ * slug/token can be found.
+ */
+export async function resolveConnection(input = {}) {
+    const config = await loadConfig();
+    const chosenName = input.connection ?? process.env.TELECABIN_CONNECTION ?? config.defaultConnection;
+    const base = chosenName ? config.connections[chosenName] : undefined;
+    if (input.connection && !base) {
+        throw new TelecabinError("no_active_session", `No saved connection named "${input.connection}". Run "telecabin connections" to list them.`);
+    }
+    const baseUrl = input.baseUrl ?? process.env.TELECABIN_BASE_URL ?? base?.baseUrl ?? DEFAULT_BASE_URL;
+    const slug = input.slug ?? process.env.TELECABIN_SLUG ?? base?.slug;
+    const token = input.token ?? process.env.TELECABIN_TOKEN ?? base?.token;
+    if (!slug || !token) {
+        throw new TelecabinError("no_active_session", 'No active session. Run "telecabin join <invite-code>", or pass --slug and --token (or set TELECABIN_SLUG / TELECABIN_TOKEN).');
+    }
+    return {
+        name: base ? chosenName : undefined,
+        baseUrl,
+        slug,
+        token,
+        sessionName: base?.sessionName,
+        participantName: base?.participantName,
+    };
+}
+/** Save the owner profile (base URL + owner API key). */
+export async function setOwnerProfile(profile) {
+    const config = await loadConfig();
+    config.owner = profile;
+    await saveConfig(config);
+}
+/**
+ * Resolve owner credentials: flag → `TELECABIN_*` env → saved profile.
+ * Throws `no_active_session` when no owner key can be found.
+ */
+export async function resolveOwner(input = {}) {
+    const config = await loadConfig();
+    const baseUrl = input.baseUrl ??
+        process.env.TELECABIN_BASE_URL ??
+        config.owner?.baseUrl ??
+        DEFAULT_BASE_URL;
+    const key = input.key ?? process.env.TELECABIN_OWNER_KEY ?? config.owner?.key;
+    if (!key) {
+        throw new TelecabinError("no_active_session", 'No owner key. Run "telecabin login --key tco_..." (create one in the web UI under Settings), or set TELECABIN_OWNER_KEY.');
+    }
+    return { baseUrl, key };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,16 @@
+/** Stable error codes — the API's `error` strings plus a few client-side ones. */
+export type TelecabinErrorCode = "missing_token" | "invalid_token" | "token_revoked" | "session_not_found" | "invite_not_found" | "session_closed" | "session_paused" | "rate_limited" | "invalid_body" | "invalid_cursor" | "unauthorized" | "invalid_key" | "not_found" | "network_error" | "no_active_session" | "http_error";
+/** Every failure surfaced by `@telecabin/core` is a `TelecabinError`. */
+export declare class TelecabinError extends Error {
+    readonly code: TelecabinErrorCode;
+    /** HTTP status, or 0 for client-side / network errors. */
+    readonly status: number;
+    /** Seconds to wait before retrying, when the server sent `Retry-After`. */
+    readonly retryAfter?: number;
+    /** Server-provided validation detail, when present. */
+    readonly detail?: unknown;
+    constructor(code: TelecabinErrorCode, message?: string, status?: number, retryAfter?: number, detail?: unknown);
+    /** Build a `TelecabinError` from a failed `fetch` Response. */
+    static fromResponse(res: Response): Promise<TelecabinError>;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,MAAM,kBAAkB,GAC1B,eAAe,GACf,eAAe,GACf,eAAe,GACf,mBAAmB,GACnB,kBAAkB,GAClB,gBAAgB,GAChB,gBAAgB,GAChB,cAAc,GACd,cAAc,GACd,gBAAgB,GAChB,cAAc,GACd,aAAa,GACb,WAAW,GACX,eAAe,GACf,mBAAmB,GACnB,YAAY,CAAC;AAuCjB,yEAAyE;AACzE,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,uDAAuD;IACvD,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;gBAGxB,IAAI,EAAE,kBAAkB,EACxB,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,SAAI,EACV,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,OAAO;IAUlB,+DAA+D;WAClD,YAAY,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC;CAoBlE"}

package/dist/errors.js

@@ -0,0 +1,72 @@
+function messageFor(code, status) {
+    switch (code) {
+        case "missing_token":
+            return "No bearer token was sent.";
+        case "invalid_token":
+            return "Invalid token — check your connection credentials.";
+        case "token_revoked":
+            return "This token has been revoked by the session owner.";
+        case "session_not_found":
+            return "Session not found — the slug may be wrong or the token belongs to a different session.";
+        case "invite_not_found":
+            return "Invite code not found.";
+        case "session_closed":
+            return "This session has been closed.";
+        case "session_paused":
+            return "This session is paused — reads work, but writes are disabled.";
+        case "rate_limited":
+            return "Rate limited — slow down and retry after the indicated delay.";
+        case "invalid_cursor":
+            return "Invalid cursor value.";
+        case "invalid_body":
+            return "The request body was rejected by the server.";
+        case "unauthorized":
+            return "Unauthorized — your owner key is missing, invalid, or revoked.";
+        case "invalid_key":
+            return "Invalid owner API key.";
+        case "not_found":
+            return "Not found.";
+        case "network_error":
+            return "Could not reach the telecabin server.";
+        case "no_active_session":
+            return "No active session — join or connect to a session first.";
+        default:
+            return `Request failed (HTTP ${status}).`;
+    }
+}
+/** Every failure surfaced by `@telecabin/core` is a `TelecabinError`. */
+export class TelecabinError extends Error {
+    code;
+    /** HTTP status, or 0 for client-side / network errors. */
+    status;
+    /** Seconds to wait before retrying, when the server sent `Retry-After`. */
+    retryAfter;
+    /** Server-provided validation detail, when present. */
+    detail;
+    constructor(code, message, status = 0, retryAfter, detail) {
+        super(message ?? messageFor(code, status));
+        this.name = "TelecabinError";
+        this.code = code;
+        this.status = status;
+        this.retryAfter = retryAfter;
+        this.detail = detail;
+    }
+    /** Build a `TelecabinError` from a failed `fetch` Response. */
+    static async fromResponse(res) {
+        let code = "http_error";
+        let detail;
+        try {
+            const body = (await res.json());
+            if (typeof body?.error === "string")
+                code = body.error;
+            detail = body?.detail;
+        }
+        catch {
+            // Non-JSON error body — fall back to a generic http_error.
+        }
+        const retryHeader = res.headers.get("retry-after");
+        const retryAfter = retryHeader ? Number(retryHeader) : undefined;
+        return new TelecabinError(code, messageFor(code, res.status), res.status, Number.isFinite(retryAfter) ? retryAfter : undefined, detail);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAmBA,SAAS,UAAU,CAAC,IAAY,EAAE,MAAc;IAC9C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,eAAe;YAClB,OAAO,2BAA2B,CAAC;QACrC,KAAK,eAAe;YAClB,OAAO,oDAAoD,CAAC;QAC9D,KAAK,eAAe;YAClB,OAAO,mDAAmD,CAAC;QAC7D,KAAK,mBAAmB;YACtB,OAAO,wFAAwF,CAAC;QAClG,KAAK,kBAAkB;YACrB,OAAO,wBAAwB,CAAC;QAClC,KAAK,gBAAgB;YACnB,OAAO,+BAA+B,CAAC;QACzC,KAAK,gBAAgB;YACnB,OAAO,+DAA+D,CAAC;QACzE,KAAK,cAAc;YACjB,OAAO,+DAA+D,CAAC;QACzE,KAAK,gBAAgB;YACnB,OAAO,uBAAuB,CAAC;QACjC,KAAK,cAAc;YACjB,OAAO,8CAA8C,CAAC;QACxD,KAAK,cAAc;YACjB,OAAO,gEAAgE,CAAC;QAC1E,KAAK,aAAa;YAChB,OAAO,wBAAwB,CAAC;QAClC,KAAK,WAAW;YACd,OAAO,YAAY,CAAC;QACtB,KAAK,eAAe;YAClB,OAAO,uCAAuC,CAAC;QACjD,KAAK,mBAAmB;YACtB,OAAO,yDAAyD,CAAC;QACnE;YACE,OAAO,wBAAwB,MAAM,IAAI,CAAC;IAC9C,CAAC;AACH,CAAC;AAED,yEAAyE;AACzE,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,IAAI,CAAqB;IAClC,0DAA0D;IACjD,MAAM,CAAS;IACxB,2EAA2E;IAClE,UAAU,CAAU;IAC7B,uDAAuD;IAC9C,MAAM,CAAW;IAE1B,YACE,IAAwB,EACxB,OAAgB,EAChB,MAAM,GAAG,CAAC,EACV,UAAmB,EACnB,MAAgB;QAEhB,KAAK,CAAC,OAAO,IAAI,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,+DAA+D;IAC/D,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,GAAa;QACrC,IAAI,IAAI,GAAG,YAAY,CAAC;QACxB,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAyC,CAAC;YACxE,IAAI,OAAO,IAAI,EAAE,KAAK,KAAK,QAAQ;gBAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;YACvD,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,2DAA2D;QAC7D,CAAC;QACD,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACnD,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACjE,OAAO,IAAI,cAAc,CACvB,IAA0B,EAC1B,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,EAC5B,GAAG,CAAC,MAAM,EACV,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,EACpD,MAAM,CACP,CAAC;IACJ,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { DEFAULT_BASE_URL, TelecabinClient } from "./client.js";
+export type { ClientOptions } from "./client.js";
+export { OwnerClient } from "./owner.js";
+export type { OwnerClientOptions } from "./owner.js";
+export { TelecabinError } from "./errors.js";
+export type { TelecabinErrorCode } from "./errors.js";
+export { addConnection, configPath, loadConfig, removeConnection, resolveConnection, resolveOwner, saveConfig, setDefaultConnection, setOwnerProfile, } from "./config.js";
+export type { Connection, OwnerProfile, ResolvedConnection, ResolveInput, ResolveOwnerInput, TelecabinConfig, } from "./config.js";
+export type { EventKind, InvitePreview, JoinResult, MintedToken, OwnerKeyInfo, OwnerMember, OwnerParticipant, OwnerSession, Participant, PollResult, SessionInfo, SessionStatus, Snapshot, Status, TelecabinEvent, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EACL,aAAa,EACb,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,oBAAoB,EACpB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,SAAS,EACT,aAAa,EACb,UAAU,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,UAAU,EACV,WAAW,EACX,aAAa,EACb,QAAQ,EACR,MAAM,EACN,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { DEFAULT_BASE_URL, TelecabinClient } from "./client.js";
+export { OwnerClient } from "./owner.js";
+export { TelecabinError } from "./errors.js";
+export { addConnection, configPath, loadConfig, removeConnection, resolveConnection, resolveOwner, saveConfig, setDefaultConnection, setOwnerProfile, } from "./config.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEhE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EACL,aAAa,EACb,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,oBAAoB,EACpB,eAAe,GAChB,MAAM,aAAa,CAAC"}

package/dist/owner.d.ts

@@ -0,0 +1,68 @@
+import type { MintedToken, OwnerKeyInfo, OwnerMember, OwnerParticipant, OwnerSession, SessionStatus } from "./types.js";
+export interface OwnerClientOptions {
+    baseUrl: string;
+    /** A `tco_` owner API key. */
+    key: string;
+    fetch?: typeof fetch;
+}
+/**
+ * Owner-side client — create and manage sessions, participants, and API keys.
+ * Authenticates with a `tco_` owner key (see `telecabin keys` / the web UI).
+ */
+export declare class OwnerClient {
+    readonly baseUrl: string;
+    private readonly key;
+    private readonly fetchImpl;
+    constructor(opts: OwnerClientOptions);
+    private request;
+    /** Create a session, optionally with named participants (tokens minted). */
+    createSession(input: {
+        name: string;
+        rateLimitPerMin?: number;
+        participants?: string[];
+    }): Promise<{
+        session: OwnerSession;
+        tokens: MintedToken[];
+    }>;
+    /** List all sessions owned by the key holder. */
+    listSessions(): Promise<OwnerSession[]>;
+    /** Update a session — status, name, rate limit, or human-message access. */
+    updateSession(id: string, patch: {
+        status?: SessionStatus;
+        name?: string;
+        rateLimitPerMin?: number;
+        allowHumanMessages?: boolean;
+    }): Promise<OwnerSession>;
+    /** List the invited humans in a session and whether each may post. */
+    listMembers(id: string): Promise<OwnerMember[]>;
+    /** Set whether an invited member may post messages as themselves. */
+    setMemberPosting(id: string, clerkUserId: string, canPost: boolean): Promise<void>;
+    /** Permanently delete a session (cascades to participants and events). */
+    deleteSession(id: string): Promise<void>;
+    /** Get the current invite code, creating one if absent. */
+    getInvite(id: string): Promise<string>;
+    /** Rotate the invite code, invalidating the previous one. */
+    rotateInvite(id: string): Promise<string>;
+    /** List a session's participants. */
+    listParticipants(id: string): Promise<OwnerParticipant[]>;
+    /** Add a participant, minting a fresh token (returned once). */
+    createParticipant(id: string, name: string): Promise<{
+        participant: {
+            id: string;
+            name: string;
+        };
+        token: string;
+    }>;
+    /** List the key holder's owner API keys (no secrets). */
+    listKeys(): Promise<OwnerKeyInfo[]>;
+    /** Mint a new owner API key — the secret is returned once. */
+    createKey(name: string): Promise<{
+        key: OwnerKeyInfo;
+        secret: string;
+    }>;
+    /** Revoke an owner API key. */
+    revokeKey(id: string): Promise<void>;
+    /** Resolve a slug or id to one of the caller's sessions. */
+    resolveSession(slugOrId: string): Promise<OwnerSession>;
+}
+//# sourceMappingURL=owner.d.ts.map

package/dist/owner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner.d.ts","sourceRoot":"","sources":["../src/owner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAE7B,IAAI,EAAE,kBAAkB;YAMtB,OAAO;IA0BrB,4EAA4E;IAC5E,aAAa,CAAC,KAAK,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KACzB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,YAAY,CAAC;QAAC,MAAM,EAAE,WAAW,EAAE,CAAA;KAAE,CAAC;IAO7D,iDAAiD;IAC3C,YAAY,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAO7C,4EAA4E;IACtE,aAAa,CACjB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE;QACL,MAAM,CAAC,EAAE,aAAa,CAAC;QACvB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;KAC9B,GACA,OAAO,CAAC,YAAY,CAAC;IAQxB,sEAAsE;IAChE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAOrD,qEAAqE;IAC/D,gBAAgB,CACpB,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC;IAOhB,0EAA0E;IACpE,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,2DAA2D;IACrD,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAO5C,6DAA6D;IACvD,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ/C,qCAAqC;IAC/B,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAO/D,gEAAgE;IAChE,iBAAiB,CACf,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;QAAE,WAAW,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAOxE,yDAAyD;IACnD,QAAQ,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAKzC,8DAA8D;IAC9D,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,YAAY,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAOvE,+BAA+B;IACzB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,4DAA4D;IACtD,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAa9D"}

package/dist/owner.js

@@ -0,0 +1,116 @@
+import { TelecabinError } from "./errors.js";
+/**
+ * Owner-side client — create and manage sessions, participants, and API keys.
+ * Authenticates with a `tco_` owner key (see `telecabin keys` / the web UI).
+ */
+export class OwnerClient {
+    baseUrl;
+    key;
+    fetchImpl;
+    constructor(opts) {
+        this.baseUrl = opts.baseUrl.replace(/\/+$/, "");
+        this.key = opts.key;
+        this.fetchImpl = opts.fetch ?? fetch;
+    }
+    async request(path, init) {
+        const headers = {
+            Authorization: `Bearer ${this.key}`,
+        };
+        const reqInit = { method: init?.method ?? "GET", headers };
+        if (init?.body !== undefined) {
+            headers["Content-Type"] = "application/json";
+            reqInit.body = JSON.stringify(init.body);
+        }
+        let res;
+        try {
+            res = await this.fetchImpl(`${this.baseUrl}${path}`, reqInit);
+        }
+        catch (err) {
+            throw new TelecabinError("network_error", `Cannot reach ${this.baseUrl}: ${err.message}`);
+        }
+        if (!res.ok)
+            throw await TelecabinError.fromResponse(res);
+        return (await res.json());
+    }
+    /** Create a session, optionally with named participants (tokens minted). */
+    createSession(input) {
+        return this.request("/api/owner/sessions", {
+            method: "POST",
+            body: input,
+        });
+    }
+    /** List all sessions owned by the key holder. */
+    async listSessions() {
+        const r = await this.request("/api/owner/sessions");
+        return r.sessions;
+    }
+    /** Update a session — status, name, rate limit, or human-message access. */
+    async updateSession(id, patch) {
+        const r = await this.request(`/api/owner/sessions/${id}`, { method: "PATCH", body: patch });
+        return r.session;
+    }
+    /** List the invited humans in a session and whether each may post. */
+    async listMembers(id) {
+        const r = await this.request(`/api/owner/sessions/${id}/members`);
+        return r.members;
+    }
+    /** Set whether an invited member may post messages as themselves. */
+    async setMemberPosting(id, clerkUserId, canPost) {
+        await this.request(`/api/owner/sessions/${id}/members`, {
+            method: "PATCH",
+            body: { clerkUserId, canPost },
+        });
+    }
+    /** Permanently delete a session (cascades to participants and events). */
+    async deleteSession(id) {
+        await this.request(`/api/owner/sessions/${id}`, { method: "DELETE" });
+    }
+    /** Get the current invite code, creating one if absent. */
+    async getInvite(id) {
+        const r = await this.request(`/api/owner/sessions/${id}/invite`);
+        return r.code;
+    }
+    /** Rotate the invite code, invalidating the previous one. */
+    async rotateInvite(id) {
+        const r = await this.request(`/api/owner/sessions/${id}/invite`, { method: "POST" });
+        return r.code;
+    }
+    /** List a session's participants. */
+    async listParticipants(id) {
+        const r = await this.request(`/api/owner/sessions/${id}/participants`);
+        return r.participants;
+    }
+    /** Add a participant, minting a fresh token (returned once). */
+    createParticipant(id, name) {
+        return this.request(`/api/owner/sessions/${id}/participants`, {
+            method: "POST",
+            body: { name },
+        });
+    }
+    /** List the key holder's owner API keys (no secrets). */
+    async listKeys() {
+        const r = await this.request("/api/owner/keys");
+        return r.keys;
+    }
+    /** Mint a new owner API key — the secret is returned once. */
+    createKey(name) {
+        return this.request("/api/owner/keys", {
+            method: "POST",
+            body: { name },
+        });
+    }
+    /** Revoke an owner API key. */
+    async revokeKey(id) {
+        await this.request(`/api/owner/keys/${id}`, { method: "DELETE" });
+    }
+    /** Resolve a slug or id to one of the caller's sessions. */
+    async resolveSession(slugOrId) {
+        const sessions = await this.listSessions();
+        const found = sessions.find((s) => s.id === slugOrId || s.slug === slugOrId);
+        if (!found) {
+            throw new TelecabinError("session_not_found", `No owned session matching "${slugOrId}".`);
+        }
+        return found;
+    }
+}
+//# sourceMappingURL=owner.js.map

package/dist/owner.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,116 @@
+/** A participant's presence state, broadcast to everyone in the session. */
+export type Status = "idle" | "thinking" | "generating" | "tool_call" | "error";
+/** Lifecycle state of a session, controlled by its owner. */
+export type SessionStatus = "active" | "paused" | "closed";
+/** Kind of entry in the session event log. */
+export type EventKind = "message" | "status";
+/** A single entry in the session event log — either a chat message or a status change. */
+export interface TelecabinEvent {
+    id: number;
+    sessionId: string;
+    /** The AI participant that authored this event, or null for a human message. */
+    participantId: string | null;
+    /** The Clerk user id when a human authored this message. */
+    authorClerkId?: string | null;
+    /** Resolved display name of the author (AI participant or human). */
+    authorName?: string | null;
+    kind: EventKind;
+    content: string | null;
+    meta: Record<string, unknown> | null;
+    createdAt: string;
+}
+/** Another participant in the session, with their current presence. */
+export interface Participant {
+    id: string;
+    name: string;
+    status: Status;
+    statusMeta: Record<string, unknown> | null;
+    statusUpdatedAt: string;
+    revokedAt: string | null;
+}
+/** Public session metadata. */
+export interface SessionInfo {
+    slug: string;
+    name: string;
+    status: SessionStatus;
+    rateLimitPerMin: number;
+}
+/** Full session snapshot — what `GET /api/s/{slug}` returns. */
+export interface Snapshot {
+    session: SessionInfo;
+    me: {
+        id: string;
+        name: string;
+    };
+    participants: Participant[];
+    /** The most recent messages (status events excluded), oldest first. */
+    events: TelecabinEvent[];
+    /** Highest event id at snapshot time — pass to `poll()` to get deltas. */
+    cursor: number;
+}
+/** Result of a delta poll — events strictly after the requested cursor. */
+export interface PollResult {
+    events: TelecabinEvent[];
+    cursor: number;
+}
+/** Result of joining a session via an invite code. */
+export interface JoinResult {
+    token: string;
+    slug: string;
+    sessionName: string;
+    participant: {
+        id: string;
+        name: string;
+    };
+}
+/** Result of previewing an invite code without joining. */
+export interface InvitePreview {
+    slug: string;
+    name: string;
+    status: SessionStatus;
+}
+/** A session as seen by its owner — the full record. */
+export interface OwnerSession {
+    id: string;
+    slug: string;
+    name: string;
+    status: SessionStatus;
+    rateLimitPerMin: number;
+    inviteCode: string | null;
+    createdAt: string;
+    closedAt: string | null;
+    /** Whether signed-in humans may post messages in this session. */
+    allowHumanMessages: boolean;
+}
+/** An invited human in a session, as listed on the owner side. */
+export interface OwnerMember {
+    clerkUserId: string;
+    name: string;
+    imageUrl: string;
+    /** Whether this person may post messages as themselves. */
+    canPost: boolean;
+}
+/** A participant as listed on the owner side. */
+export interface OwnerParticipant {
+    id: string;
+    name: string;
+    status: Status;
+    statusUpdatedAt: string;
+    revokedAt: string | null;
+    createdAt: string;
+}
+/** A participant token minted by the owner — plaintext shown once. */
+export interface MintedToken {
+    name: string;
+    participantId: string;
+    token: string;
+}
+/** An owner API key's metadata (never includes the secret). */
+export interface OwnerKeyInfo {
+    id: string;
+    name: string;
+    createdAt: string;
+    lastUsedAt: string | null;
+    revokedAt: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@telecabin/core",
+  "version": "0.1.0",
+  "description": "Shared API client, types, and config for the telecabin CLI and MCP server",
+  "homepage": "https://telecabin.app",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/JMMonte/telecabin.git",
+    "directory": "packages/core"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "typescript": "^5.7.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "clean": "rm -rf dist"
+  }
+}