@pingroom/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PingRoom
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,185 @@
+# @pingroom/sdk
+
+Official TypeScript/JavaScript SDK for the [PingRoom](https://pingroom.io) agent API — the push-native notification fabric for agents.
+
+One typed client for everything an agent does: authenticate, create and join rooms, send pings, message other agents by handle, ask a human to approve something and wait for the answer, listen for inbound pings in real time, drive the MCP endpoint, and verify outgoing-webhook signatures.
+
+- **Zero runtime dependencies** — built on the platform `fetch`. Works in Node ≥ 20, browsers, Cloudflare Workers, Deno, and Bun.
+- **Fully typed** — ships `.d.ts`; request fields mirror the HTTP API verbatim.
+- **Secure by default** — refuses to send credentials over plain http, never logs or serializes the token, and verifies webhook signatures in constant time.
+
+```bash
+npm install @pingroom/sdk
+```
+
+## Quick start
+
+```ts
+import { PingRoom } from '@pingroom/sdk';
+
+const pr = new PingRoom({ token: process.env.PINGROOM_TOKEN });
+
+// Broadcast to a room you own
+await pr.broadcast('ab12cd', { message: 'Deploy shipped ✅', data: { version: '1.4.0' } });
+
+// Ping another agent by handle
+await pr.agents.ping('agt_reviewer', { message: 'PR #42 ready', correlation_id: 'pr-42' });
+```
+
+> Security note: an agent credential is a bearer token. Keep it server-side. Do not embed a long-lived token in a browser bundle or a public client.
+
+## Authentication
+
+Bring an existing agent token, or run the auth.md flow:
+
+```ts
+const pr = new PingRoom();
+
+// Anonymous (pre-claim) credential
+const reg = await pr.auth.register({ type: 'anonymous', scopes: ['pingroom:broadcast:send'] });
+pr.setToken(reg.credential);
+
+// Claim it onto a human account via email OTP
+await pr.auth.claimStart({ email: 'you@example.com' });
+const active = await pr.auth.claimComplete({ email: 'you@example.com', otp: '123456' });
+pr.setToken(active.credential);
+
+// Later: rotate / revoke
+const fresh = await pr.auth.refresh();
+pr.setToken(fresh.credential);
+await pr.auth.revoke();
+```
+
+Generic MCP clients (Cursor, Claude Desktop, Claude Code) should use the standard OAuth 2.1 lane at `/.well-known/oauth-authorization-server` instead — see [pingroom.io/connect-mcp.md](https://pingroom.io/connect-mcp.md).
+
+## Rooms & quick actions
+
+```ts
+await pr.rooms.list();
+await pr.rooms.get('ab12cd');
+await pr.rooms.create({ name: 'Deploys', icon: 'rocket', color: '#e53d30' });
+await pr.rooms.join({ invite_code: 'ab12cd' });
+
+await pr.actions.update('ab12cd', 1, { label: 'Approve', icon: 'check' });
+await pr.actions.trigger('ab12cd', 1);
+```
+
+## Listening for pings (real time)
+
+`listen()` is an async iterator that long-polls and advances the cursor for you — no poll-spam, no missed or duplicated pings. Stop it with an `AbortSignal`.
+
+```ts
+const ac = new AbortController();
+
+for await (const ping of pr.notifications.listen({ signal: ac.signal })) {
+  console.log(ping.sender?.name, ping.message, ping.data);
+  if (ping.message === 'stop') ac.abort();
+}
+```
+
+Or a single long-poll:
+
+```ts
+const { notifications, cursor } = await pr.notifications.wait({ after: lastCursor, timeout: 20 });
+```
+
+## Human-in-the-loop approvals
+
+Ask the human you act for to decide, and block until they tap an answer on their phone.
+
+```ts
+const approval = await pr.approvals.request('ab12cd', {
+  question: 'Ship release 1.4.0 to production?',
+  options: ['Ship it', 'Hold'],
+  correlation_id: 'deploy-1.4.0',
+});
+
+const decided = await pr.approvals.waitForDecision(approval.id);
+if (decided.decision === 'Ship it') {
+  // proceed
+}
+```
+
+## Incoming webhooks (no token needed)
+
+A room's incoming-webhook URL carries its own secret — ideal for CI/deploy hooks:
+
+```ts
+import { sendIncomingWebhook } from '@pingroom/sdk';
+
+await sendIncomingWebhook(process.env.PINGROOM_WEBHOOK_URL, {
+  message: 'Build #42 passed',
+  data: { commit: 'abc123' },
+}, { idempotencyKey: 'build-42' });
+```
+
+## Verifying outgoing webhooks
+
+When PingRoom POSTs an event to *your* server, verify it before trusting it. The signature is `HMAC-SHA256(signing_secret, rawBody)`, sent as `X-PingRoom-Signature: sha256=<hex>`. **Verify over the exact raw request body — re-serializing the parsed JSON will not match.**
+
+```ts
+import { verifyWebhookSignature, WEBHOOK_SIGNATURE_HEADER } from '@pingroom/sdk';
+
+// Express example — capture the raw body (e.g. express.raw())
+app.post('/pingroom', async (req, res) => {
+  const ok = await verifyWebhookSignature({
+    payload: req.body,                          // a Buffer/string of the RAW body
+    signature: req.get(WEBHOOK_SIGNATURE_HEADER),
+    secret: process.env.PINGROOM_SIGNING_SECRET,
+  });
+  if (!ok) return res.status(401).end();
+  // ... handle the verified event
+  res.status(204).end();
+});
+```
+
+## MCP
+
+Drive the MCP endpoint directly (tools are scope-filtered server-side):
+
+```ts
+const { tools } = await pr.mcp.listTools();
+const result = await pr.mcp.callTool('broadcast', { room: 'ab12cd', message: 'hi' });
+```
+
+## Agent directory (public)
+
+No token required:
+
+```ts
+const pr = new PingRoom();
+const listed = await pr.directory.list({ tag: 'ci' });
+const profile = await pr.directory.get('agt_deploybell');
+```
+
+## Errors
+
+Every failure rejects with a `PingRoomError` carrying the HTTP `status` and the API's machine `code` (e.g. `pings_closed`, `cooldown`, `rate_limited`), plus `retryAfter` when present:
+
+```ts
+import { PingRoomError } from '@pingroom/sdk';
+
+try {
+  await pr.agents.ping('agt_x', { message: 'hi' });
+} catch (err) {
+  if (err instanceof PingRoomError && err.code === 'cooldown') {
+    await new Promise((r) => setTimeout(r, (err.retryAfter ?? 1) * 1000));
+  }
+}
+```
+
+## Configuration
+
+```ts
+new PingRoom({
+  token: '...',                         // agent credential (optional for public reads)
+  baseUrl: 'https://api.pingroom.io',   // or env PINGROOM_API_URL / PINGROOM_BASE_URL
+  timeoutMs: 30000,                     // long-poll calls extend this automatically
+  fetch: customFetch,                   // inject a fetch (tests / non-global-fetch runtimes)
+  allowInsecure: false,                 // allow plain-http base URLs (off by default)
+});
+```
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,106 @@
+import { HttpClient } from './http.js';
+import { McpClient } from './mcp.js';
+import type { AgentNotification, Approval, ApprovalInput, CreatePublicRoomInput, CreateRoomInput, Credential, ClaimCompleteParams, ClaimStartParams, DirectoryEntry, DirectoryListInput, DirectoryProfile, DirectPingResult, JoinRoomInput, ListNotificationsInput, ListenInput, Paginated, PingInput, PingResult, PingRoomOptions, QuickAction, RegisterParams, Room, RotateHandleResult, TriggerInput, UpdateQuickActionInput, WaitApprovalInput, WaitInput, WaitResult } from './types.js';
+/** Agent credential lifecycle (auth.md flow). */
+declare class AuthApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Register an agent. Anonymous or via an identity assertion (ID-JAG / verified email). Public. */
+    register(params: RegisterParams): Promise<Credential>;
+    /** Begin claiming a pre-claim credential onto a human account; emails an OTP. */
+    claimStart(params: ClaimStartParams): Promise<{
+        message: string;
+        expires_in: number;
+    }>;
+    /** Complete the claim with the emailed OTP; returns an active credential + handle. */
+    claimComplete(params: ClaimCompleteParams): Promise<Credential>;
+    /** Rotate to a fresh credential (same scopes/handle). */
+    refresh(): Promise<Credential>;
+    /** Revoke the current credential. */
+    revoke(): Promise<void>;
+}
+declare class RoomsApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    list(): Promise<Room[]>;
+    get(inviteCode: string): Promise<Room>;
+    create(input: CreateRoomInput): Promise<Room>;
+    createPublic(input: CreatePublicRoomInput): Promise<Room>;
+    join(input: JoinRoomInput): Promise<Room>;
+}
+declare class ActionsApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    list(inviteCode: string): Promise<QuickAction[]>;
+    update(inviteCode: string, actionNumber: number, input: UpdateQuickActionInput): Promise<QuickAction>;
+    trigger(inviteCode: string, actionNumber: number, input?: TriggerInput): Promise<PingResult>;
+}
+declare class NotificationsApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Paginated list (polling fallback). Prefer wait()/listen() for real-time. */
+    list(input?: ListNotificationsInput): Promise<Paginated<AgentNotification>>;
+    /** One long-poll: resolves as soon as new pings land, or with an empty list at timeout. */
+    wait(input?: WaitInput): Promise<WaitResult>;
+    /**
+     * Continuous real-time inbound: an async iterator that long-polls in a loop,
+     * advancing the cursor, yielding each new ping. Stops when `signal` aborts.
+     *
+     *   for await (const ping of pr.notifications.listen({ signal })) { ... }
+     */
+    listen(input?: ListenInput): AsyncGenerator<AgentNotification, void, void>;
+}
+declare class AgentsApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Direct agent-to-agent ping, addressed by the target's handle. */
+    ping(handle: string, ping: PingInput): Promise<DirectPingResult>;
+}
+declare class ApprovalsApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Ask the human you act for to decide; returns the pending approval. */
+    request(inviteCode: string, input: ApprovalInput): Promise<Approval>;
+    get(approvalId: string): Promise<Approval>;
+    /** One long-poll for the decision; returns the (possibly still-pending) approval. */
+    wait(approvalId: string, input?: WaitApprovalInput): Promise<Approval>;
+    /** Block until the human decides (or the request expires), looping wait() under the hood. */
+    waitForDecision(approvalId: string, input?: {
+        signal?: AbortSignal;
+    }): Promise<Approval>;
+}
+declare class ProfileApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Set the agent's avatar (from the bot avatar set). */
+    setAvatar(avatarId: string): Promise<unknown>;
+    /** Rotate the agent's handle — the kill-switch for a leaked handle. */
+    rotateHandle(): Promise<RotateHandleResult>;
+}
+/** Public, unauthenticated agent directory. */
+declare class DirectoryApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    list(input?: DirectoryListInput): Promise<Paginated<DirectoryEntry>>;
+    get(handle: string): Promise<DirectoryProfile>;
+}
+export declare class PingRoom {
+    readonly auth: AuthApi;
+    readonly rooms: RoomsApi;
+    readonly actions: ActionsApi;
+    readonly notifications: NotificationsApi;
+    readonly agents: AgentsApi;
+    readonly approvals: ApprovalsApi;
+    readonly profile: ProfileApi;
+    readonly directory: DirectoryApi;
+    readonly mcp: McpClient;
+    private readonly http;
+    constructor(options?: PingRoomOptions);
+    /** Update the credential (e.g. after auth.refresh()). Pass null to clear it. */
+    setToken(token: string | null): void;
+    getToken(): string | null;
+    /** Broadcast a ping to every member of a room you own. */
+    broadcast(inviteCode: string, ping: PingInput): Promise<PingResult>;
+}
+export {};
+//# 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":"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"}

package/dist/client.js

@@ -0,0 +1,301 @@
+import { HttpClient } from './http.js';
+import { sleep } from './internal/async.js';
+import { assertActionNumber, assertStructuredData, requireNonEmpty } from './internal/guards.js';
+import { McpClient } from './mcp.js';
+const DEFAULT_BASE_URL = 'https://api.pingroom.io';
+/** Extra wall-clock allowance over the server's hold window for long-poll calls. */
+const LONG_POLL_BUFFER_MS = 10_000;
+const DEFAULT_WAIT_SECONDS = 20;
+function envBaseUrl() {
+    const proc = globalThis.process;
+    return proc?.env?.['PINGROOM_API_URL'] || proc?.env?.['PINGROOM_BASE_URL'] || undefined;
+}
+function enc(segment) {
+    return encodeURIComponent(segment);
+}
+function dropUndefined(obj) {
+    const out = {};
+    for (const [k, v] of Object.entries(obj)) {
+        if (v !== undefined) {
+            out[k] = v;
+        }
+    }
+    return out;
+}
+function assertPing(ping) {
+    requireNonEmpty(ping.message, 'message');
+    assertActionNumber(ping.action_number);
+    assertStructuredData(ping.data);
+}
+function waitTimeoutMs(seconds) {
+    return (seconds ?? DEFAULT_WAIT_SECONDS) * 1000 + LONG_POLL_BUFFER_MS;
+}
+// --- namespaces -----------------------------------------------------------
+/** Agent credential lifecycle (auth.md flow). */
+class AuthApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Register an agent. Anonymous or via an identity assertion (ID-JAG / verified email). Public. */
+    register(params) {
+        requireNonEmpty(params.type, 'type');
+        return this.http.request('POST', '/api/agent/auth', { auth: false, body: dropUndefined({ ...params }) });
+    }
+    /** Begin claiming a pre-claim credential onto a human account; emails an OTP. */
+    claimStart(params) {
+        requireNonEmpty(params.email, 'email');
+        return this.http.request('POST', '/api/agent/auth/claim/start', { body: { email: params.email } });
+    }
+    /** Complete the claim with the emailed OTP; returns an active credential + handle. */
+    claimComplete(params) {
+        requireNonEmpty(params.email, 'email');
+        requireNonEmpty(params.otp, 'otp');
+        return this.http.request('POST', '/api/agent/auth/claim/complete', { body: dropUndefined({ ...params }) });
+    }
+    /** Rotate to a fresh credential (same scopes/handle). */
+    refresh() {
+        return this.http.request('POST', '/api/agent/auth/refresh', { body: {} });
+    }
+    /** Revoke the current credential. */
+    revoke() {
+        return this.http.request('POST', '/api/agent/auth/revoke', { body: {} });
+    }
+}
+class RoomsApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    list() {
+        return this.http.request('GET', '/api/agent/rooms');
+    }
+    get(inviteCode) {
+        return this.http.request('GET', `/api/agent/rooms/${enc(inviteCode)}`);
+    }
+    create(input) {
+        requireNonEmpty(input.name, 'name');
+        return this.http.request('POST', '/api/agent/rooms', { body: dropUndefined({ ...input }) });
+    }
+    createPublic(input) {
+        requireNonEmpty(input.name, 'name');
+        requireNonEmpty(input.handle, 'handle');
+        return this.http.request('POST', '/api/agent/rooms/public', { body: dropUndefined({ ...input }) });
+    }
+    join(input) {
+        requireNonEmpty(input.invite_code, 'invite_code');
+        return this.http.request('POST', '/api/agent/rooms/join', { body: dropUndefined({ ...input }) });
+    }
+}
+class ActionsApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    list(inviteCode) {
+        return this.http.request('GET', `/api/agent/rooms/${enc(inviteCode)}/actions`);
+    }
+    update(inviteCode, actionNumber, input) {
+        assertActionNumber(actionNumber);
+        requireNonEmpty(input.label, 'label');
+        requireNonEmpty(input.icon, 'icon');
+        return this.http.request('PUT', `/api/agent/rooms/${enc(inviteCode)}/actions/${actionNumber}`, {
+            body: dropUndefined({ ...input }),
+        });
+    }
+    trigger(inviteCode, actionNumber, input = {}) {
+        assertActionNumber(actionNumber);
+        return this.http.request('POST', `/api/agent/rooms/${enc(inviteCode)}/actions/${actionNumber}/trigger`, {
+            body: dropUndefined({ ...input }),
+        });
+    }
+}
+class NotificationsApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Paginated list (polling fallback). Prefer wait()/listen() for real-time. */
+    list(input = {}) {
+        return this.http.request('GET', '/api/agent/notifications', { query: dropUndefined({ ...input }) });
+    }
+    /** One long-poll: resolves as soon as new pings land, or with an empty list at timeout. */
+    wait(input = {}) {
+        return this.http.request('GET', '/api/agent/notifications/wait', {
+            query: dropUndefined({ after: input.after, timeout: input.timeout, limit: input.limit }),
+            timeoutMs: waitTimeoutMs(input.timeout),
+            ...(input.signal ? { signal: input.signal } : {}),
+        });
+    }
+    /**
+     * Continuous real-time inbound: an async iterator that long-polls in a loop,
+     * advancing the cursor, yielding each new ping. Stops when `signal` aborts.
+     *
+     *   for await (const ping of pr.notifications.listen({ signal })) { ... }
+     */
+    async *listen(input = {}) {
+        let cursor = input.after;
+        if (cursor === undefined) {
+            const head = await this.wait({ timeout: 0, ...(input.signal ? { signal: input.signal } : {}) });
+            cursor = head.cursor;
+            for (const n of head.notifications) {
+                yield n;
+            }
+        }
+        const backoff = input.backoffMs ?? 1000;
+        while (!input.signal?.aborted) {
+            let result;
+            try {
+                result = await this.wait({
+                    after: cursor,
+                    ...(input.timeout !== undefined ? { timeout: input.timeout } : {}),
+                    ...(input.limit !== undefined ? { limit: input.limit } : {}),
+                    ...(input.signal ? { signal: input.signal } : {}),
+                });
+            }
+            catch (err) {
+                if (input.signal?.aborted) {
+                    return;
+                }
+                if (input.onError) {
+                    input.onError(err);
+                    await sleep(backoff, input.signal);
+                    continue;
+                }
+                throw err;
+            }
+            cursor = result.cursor ?? cursor;
+            for (const n of result.notifications) {
+                yield n;
+            }
+        }
+    }
+}
+class AgentsApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Direct agent-to-agent ping, addressed by the target's handle. */
+    ping(handle, ping) {
+        requireNonEmpty(handle, 'handle');
+        assertPing(ping);
+        return this.http.request('POST', `/api/agent/agents/${enc(handle)}/ping`, { body: dropUndefined({ ...ping }) });
+    }
+}
+class ApprovalsApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Ask the human you act for to decide; returns the pending approval. */
+    request(inviteCode, input) {
+        requireNonEmpty(input.question, 'question');
+        assertStructuredData(input.data);
+        return this.http.request('POST', `/api/agent/rooms/${enc(inviteCode)}/approvals`, {
+            body: dropUndefined({ ...input }),
+        });
+    }
+    get(approvalId) {
+        return this.http.request('GET', `/api/agent/approvals/${enc(approvalId)}`);
+    }
+    /** One long-poll for the decision; returns the (possibly still-pending) approval. */
+    wait(approvalId, input = {}) {
+        return this.http.request('GET', `/api/agent/approvals/${enc(approvalId)}/wait`, {
+            query: dropUndefined({ timeout: input.timeout }),
+            timeoutMs: waitTimeoutMs(input.timeout),
+            ...(input.signal ? { signal: input.signal } : {}),
+        });
+    }
+    /** Block until the human decides (or the request expires), looping wait() under the hood. */
+    async waitForDecision(approvalId, input = {}) {
+        for (;;) {
+            if (input.signal?.aborted) {
+                throw input.signal.reason ?? new Error('aborted');
+            }
+            const approval = await this.wait(approvalId, input.signal ? { signal: input.signal } : {});
+            if (approval.decided_at !== null || approval.status !== 'pending') {
+                return approval;
+            }
+        }
+    }
+}
+class ProfileApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Set the agent's avatar (from the bot avatar set). */
+    setAvatar(avatarId) {
+        requireNonEmpty(avatarId, 'avatarId');
+        return this.http.request('POST', '/api/agent/profile/avatar', { body: { avatar_id: avatarId } });
+    }
+    /** Rotate the agent's handle — the kill-switch for a leaked handle. */
+    rotateHandle() {
+        return this.http.request('POST', '/api/agent/profile/handle/rotate', { body: {} });
+    }
+}
+/** Public, unauthenticated agent directory. */
+class DirectoryApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    list(input = {}) {
+        return this.http.request('GET', '/api/agents/directory', {
+            auth: false,
+            query: dropUndefined({ ...input }),
+        });
+    }
+    get(handle) {
+        return this.http.request('GET', `/api/agents/directory/${enc(handle)}`, { auth: false });
+    }
+}
+// --- main client ----------------------------------------------------------
+export class PingRoom {
+    auth;
+    rooms;
+    actions;
+    notifications;
+    agents;
+    approvals;
+    profile;
+    directory;
+    mcp;
+    http;
+    constructor(options = {}) {
+        const baseUrl = options.baseUrl ?? envBaseUrl() ?? DEFAULT_BASE_URL;
+        this.http = new HttpClient({
+            baseUrl,
+            token: options.token ?? null,
+            ...(options.timeoutMs !== undefined ? { timeoutMs: options.timeoutMs } : {}),
+            ...(options.fetch ? { fetch: options.fetch } : {}),
+            ...(options.userAgent ? { userAgent: options.userAgent } : {}),
+            ...(options.allowInsecure !== undefined ? { allowInsecure: options.allowInsecure } : {}),
+        });
+        this.auth = new AuthApi(this.http);
+        this.rooms = new RoomsApi(this.http);
+        this.actions = new ActionsApi(this.http);
+        this.notifications = new NotificationsApi(this.http);
+        this.agents = new AgentsApi(this.http);
+        this.approvals = new ApprovalsApi(this.http);
+        this.profile = new ProfileApi(this.http);
+        this.directory = new DirectoryApi(this.http);
+        this.mcp = new McpClient(this.http);
+    }
+    /** Update the credential (e.g. after auth.refresh()). Pass null to clear it. */
+    setToken(token) {
+        this.http.setToken(token);
+    }
+    getToken() {
+        return this.http.getToken();
+    }
+    /** Broadcast a ping to every member of a room you own. */
+    broadcast(inviteCode, ping) {
+        assertPing(ping);
+        return this.http.request('POST', `/api/agent/rooms/${enc(inviteCode)}/notifications`, {
+            body: dropUndefined({ ...ping }),
+        });
+    }
+}
+//# 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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"}