@pingroom/sdk 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,262 @@
+/**
+ * Public types for the PingRoom SDK.
+ *
+ * Request payload field names mirror the HTTP API verbatim (snake_case) so the
+ * SDK is a faithful, reviewable wrapper — what you pass is what the API sees.
+ * SDK-only knobs (timeouts, signals, callbacks) use camelCase.
+ */
+/** A plain JSON object — the shape the API accepts for structured `data`. */
+export type JsonObject = Record<string, unknown>;
+/** Minimal fetch signature the SDK depends on (Node >= 18, browsers, workers, Deno, Bun). */
+export type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
+/** The scopes an agent credential can hold. */
+export type AgentScope = 'pingroom:rooms:read' | 'pingroom:rooms:write' | 'pingroom:rooms:publish' | 'pingroom:rooms:join' | 'pingroom:actions:write' | 'pingroom:actions:trigger' | 'pingroom:broadcast:send' | 'pingroom:notifications:read' | 'pingroom:agents:ping' | 'pingroom:approvals:request' | 'pingroom:profile:write';
+/** A known scope, or any forward-compatible string (keeps autocomplete on the knowns). */
+export type ScopeInput = AgentScope | (string & {});
+export interface PingRoomOptions {
+    /** Agent credential (Bearer JWT). Optional — public reads (directory) work without it. */
+    token?: string | null;
+    /** API base URL. Defaults to env PINGROOM_API_URL/PINGROOM_BASE_URL, else https://api.pingroom.io. */
+    baseUrl?: string;
+    /** Default per-request timeout in ms (long-poll calls extend this automatically). Default 30000. */
+    timeoutMs?: number;
+    /** Custom fetch implementation (for tests or non-global-fetch runtimes). */
+    fetch?: FetchLike;
+    /** Override the User-Agent header. */
+    userAgent?: string;
+    /** Allow plain-http base URLs to non-loopback hosts. Off by default — credentials require https. */
+    allowInsecure?: boolean;
+}
+export type AgentRegisterType = 'identity_assertion' | 'anonymous';
+export type AgentAssertionType = 'urn:ietf:params:oauth:token-type:id-jag' | 'verified_email';
+export interface RegisterParams {
+    type: AgentRegisterType;
+    assertion_type?: AgentAssertionType;
+    assertion?: string;
+    scopes?: ScopeInput[];
+    agent_label?: string;
+}
+export interface Credential {
+    credential: string;
+    credential_type: 'pre_claim' | 'active';
+    expires_in: number;
+    scopes: string[];
+    handle?: string;
+    claim?: {
+        start_uri: string;
+        complete_uri: string;
+    };
+}
+export interface ClaimStartParams {
+    email: string;
+}
+export interface ClaimCompleteParams {
+    email: string;
+    otp: string;
+    scopes?: ScopeInput[];
+}
+export interface QuickActionInput {
+    action_number: number;
+    label: string;
+    icon: string;
+    sound?: string | null;
+    haptic_style?: string | null;
+}
+export interface CreateRoomInput {
+    name: string;
+    icon: string;
+    color: string;
+    description?: string;
+    everyone_can_trigger?: boolean;
+    is_password_protected?: boolean;
+    password?: string;
+    actions?: QuickActionInput[];
+}
+export interface CreatePublicRoomInput extends CreateRoomInput {
+    handle: string;
+    category?: string;
+    show_owner?: boolean;
+}
+export interface JoinRoomInput {
+    invite_code: string;
+    password?: string;
+}
+export interface UpdateQuickActionInput {
+    label: string;
+    icon: string;
+    sound?: string | null;
+    haptic_style?: string | null;
+}
+export interface QuickAction {
+    id?: string;
+    action_number: number;
+    label: string;
+    icon: string;
+    sound?: string | null;
+    haptic_style?: string | null;
+    [key: string]: unknown;
+}
+export interface Room {
+    id: string;
+    name: string;
+    icon: string | null;
+    color: string | null;
+    invite_code: string;
+    is_public?: boolean;
+    handle?: string | null;
+    quick_actions?: QuickAction[];
+    [key: string]: unknown;
+}
+/** The body of a ping — used for broadcasts and agent-to-agent direct pings. */
+export interface PingInput {
+    message: string;
+    action_number?: number;
+    action_icon?: string;
+    data?: JsonObject;
+    correlation_id?: string;
+    reply_to?: string;
+}
+export interface TriggerInput {
+    trigger_source?: string;
+}
+export interface PingResult {
+    id: string;
+    message: string;
+    action_number: number | null;
+    action_icon: string | null;
+    trigger_source: string | null;
+    data?: JsonObject | null;
+    correlation_id?: string | null;
+    reply_to?: string | null;
+    created_at: string;
+    recipient_count?: number;
+    muted_count?: number;
+    [key: string]: unknown;
+}
+export interface DirectPingResult {
+    id: string;
+    target_handle: string;
+    room_code: string;
+    message: string;
+    correlation_id: string | null;
+    reply_to: string | null;
+    created_at: string;
+    [key: string]: unknown;
+}
+export interface AgentNotification {
+    id: string;
+    message: string;
+    action_number: number | null;
+    action_icon: string | null;
+    trigger_source: string | null;
+    data?: JsonObject | null;
+    correlation_id?: string | null;
+    reply_to?: string | null;
+    created_at: string;
+    room?: {
+        code: string;
+        name: string;
+        icon: string | null;
+        color: string | null;
+    };
+    sender?: {
+        id: string;
+        name: string | null;
+    };
+}
+export interface ListNotificationsInput {
+    type?: string;
+    room_id?: string;
+    date?: string;
+    notifications_per_page?: number;
+}
+export interface WaitInput {
+    /** Cursor (a notification id). Omit to start from the current head. */
+    after?: string;
+    /** Seconds to hold the connection (0–30, default 20). */
+    timeout?: number;
+    /** Max notifications to return (1–100, default 50). */
+    limit?: number;
+    signal?: AbortSignal;
+}
+export interface WaitResult {
+    notifications: AgentNotification[];
+    cursor: string;
+}
+export interface ListenInput {
+    after?: string;
+    timeout?: number;
+    limit?: number;
+    signal?: AbortSignal;
+    /** Called on a transient error instead of throwing; the loop backs off and retries. */
+    onError?: (err: unknown) => void;
+    /** Backoff after a handled error, in ms (default 1000). */
+    backoffMs?: number;
+}
+export interface ApprovalInput {
+    question: string;
+    title?: string;
+    options?: string[];
+    correlation_id?: string;
+    data?: JsonObject;
+    ttl?: number;
+}
+export interface Approval {
+    id: string;
+    status: 'pending' | 'approved' | 'denied' | 'expired' | (string & {});
+    question: string;
+    title: string | null;
+    options: string[];
+    decision: string | null;
+    decided_at: string | null;
+    expires_at: string | null;
+    correlation_id: string | null;
+    data: JsonObject | null;
+    room_code: string;
+    [key: string]: unknown;
+}
+export interface WaitApprovalInput {
+    /** Seconds the server holds the connection (0–30, default 20). */
+    timeout?: number;
+    signal?: AbortSignal;
+}
+export interface RotateHandleResult {
+    handle: string;
+    [key: string]: unknown;
+}
+export type PingPolicy = 'open' | 'members' | 'closed' | (string & {});
+export type ActivityBucket = 'active_now' | 'today' | 'this_week' | 'quiet' | (string & {});
+export interface DirectoryEntry {
+    handle: string;
+    display_name: string;
+    tagline: string;
+    tags: string[];
+    icon: string | null;
+    color: string | null;
+    ping_policy: PingPolicy;
+    is_featured: boolean;
+    operated_by: string | null;
+    last_active: ActivityBucket;
+}
+export interface DirectoryProfile extends DirectoryEntry {
+    description: string | null;
+    listed_at: string | null;
+    card_url: string | null;
+}
+export interface DirectoryListInput {
+    search?: string;
+    tag?: string;
+    per_page?: number;
+    page?: number;
+}
+export interface Paginated<T> {
+    current_page: number;
+    data: T[];
+    per_page: number;
+    total: number;
+    last_page: number;
+    next_page_url: string | null;
+    prev_page_url: string | null;
+    [key: string]: unknown;
+}
+//# 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":"AAAA;;;;;;GAMG;AAEH,6EAA6E;AAC7E,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,6FAA6F;AAC7F,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEjF,+CAA+C;AAC/C,MAAM,MAAM,UAAU,GAClB,qBAAqB,GACrB,sBAAsB,GACtB,wBAAwB,GACxB,qBAAqB,GACrB,wBAAwB,GACxB,0BAA0B,GAC1B,yBAAyB,GACzB,6BAA6B,GAC7B,sBAAsB,GACtB,4BAA4B,GAC5B,wBAAwB,CAAC;AAE7B,0FAA0F;AAC1F,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAIpD,MAAM,WAAW,eAAe;IAC9B,0FAA0F;IAC1F,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,sGAAsG;IACtG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oGAAoG;IACpG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oGAAoG;IACpG,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAID,MAAM,MAAM,iBAAiB,GAAG,oBAAoB,GAAG,WAAW,CAAC;AACnE,MAAM,MAAM,kBAAkB,GAAG,yCAAyC,GAAG,gBAAgB,CAAC;AAE9F,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,iBAAiB,CAAC;IACxB,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,WAAW,GAAG,QAAQ,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;CACrD;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;CACvB;AAID,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAID,gFAAgF;AAChF,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACjF,MAAM,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CAC9C;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,SAAS;IACxB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,iBAAiB,EAAE,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,uFAAuF;IACvF,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAID,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAID,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AACvE,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE5F,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,UAAU,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,cAAc,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/types.js

@@ -0,0 +1,9 @@
+/**
+ * Public types for the PingRoom SDK.
+ *
+ * Request payload field names mirror the HTTP API verbatim (snake_case) so the
+ * SDK is a faithful, reviewable wrapper — what you pass is what the API sees.
+ * SDK-only knobs (timeouts, signals, callbacks) use camelCase.
+ */
+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":"AAAA;;;;;;GAMG"}

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+/** SDK version, surfaced in the User-Agent and the MCP clientInfo. Keep in sync with package.json. */
+export declare const VERSION = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,3 @@
+/** SDK version, surfaced in the User-Agent and the MCP clientInfo. Keep in sync with package.json. */
+export const VERSION = '0.1.0';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/dist/webhooks.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Webhook helpers — usable standalone, no client/token required.
+ *
+ *  - verifyWebhookSignature: verify an OUTGOING webhook PingRoom sent you.
+ *    PingRoom signs `HMAC-SHA256(signing_secret, rawBody)` and sends it as
+ *    `X-PingRoom-Signature: sha256=<hex>`. Verify over the EXACT raw request
+ *    body bytes — re-serializing the parsed JSON will not match.
+ *
+ *  - sendIncomingWebhook: fire a room's INCOMING webhook (the URL carries its
+ *    own secret, so no agent token is needed) — the one-line CI/deploy ping.
+ */
+import type { FetchLike, JsonObject } from './types.js';
+export declare const WEBHOOK_SIGNATURE_HEADER = "X-PingRoom-Signature";
+export declare const WEBHOOK_TIMESTAMP_HEADER = "X-PingRoom-Timestamp";
+export declare const WEBHOOK_DELIVERY_HEADER = "X-PingRoom-Delivery";
+export declare const WEBHOOK_EVENT_HEADER = "X-PingRoom-Event";
+export interface VerifyWebhookSignatureOptions {
+    /** The raw request body — the exact bytes received, NOT a re-stringified object. */
+    payload: string | ArrayBuffer | Uint8Array;
+    /** The X-PingRoom-Signature header value (with or without the `sha256=` prefix). */
+    signature: string | null | undefined;
+    /** The webhook's signing_secret. */
+    secret: string;
+}
+/**
+ * Constant-time verification of an outgoing-webhook signature. Returns a
+ * boolean and never throws on mismatch.
+ */
+export declare function verifyWebhookSignature(opts: VerifyWebhookSignatureOptions): Promise<boolean>;
+export interface IncomingWebhookPayload {
+    message?: string;
+    title?: string;
+    /** Quick-action slot to attribute the ping to (1–4). */
+    action?: number;
+    data?: JsonObject;
+    correlation_id?: string;
+    reply_to?: string;
+}
+export interface SendIncomingWebhookOptions {
+    /** Sent as the Idempotency-Key header; identical keys within ~1h replay the first result. */
+    idempotencyKey?: string;
+    timeoutMs?: number;
+    fetch?: FetchLike;
+    signal?: AbortSignal;
+    /** Allow plain-http webhook URLs to non-loopback hosts (off by default). */
+    allowInsecure?: boolean;
+}
+export interface IncomingWebhookResult {
+    success: boolean;
+    notification_id?: string;
+    message?: string;
+    [key: string]: unknown;
+}
+/** POST to a room's incoming-webhook URL (which embeds the secret in its path). */
+export declare function sendIncomingWebhook(webhookUrl: string, payload: IncomingWebhookPayload, options?: SendIncomingWebhookOptions): Promise<IncomingWebhookResult>;
+//# sourceMappingURL=webhooks.d.ts.map

package/dist/webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../src/webhooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxD,eAAO,MAAM,wBAAwB,yBAAyB,CAAC;AAC/D,eAAO,MAAM,wBAAwB,yBAAyB,CAAC;AAC/D,eAAO,MAAM,uBAAuB,wBAAwB,CAAC;AAC7D,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AAEvD,MAAM,WAAW,6BAA6B;IAC5C,oFAAoF;IACpF,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;IAC3C,oFAAoF;IACpF,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrC,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,6BAA6B,GAAG,OAAO,CAAC,OAAO,CAAC,CAUlG;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,6FAA6F;IAC7F,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,mFAAmF;AACnF,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,sBAAsB,EAC/B,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,qBAAqB,CAAC,CAwDhC"}

package/dist/webhooks.js

@@ -0,0 +1,133 @@
+/**
+ * Webhook helpers — usable standalone, no client/token required.
+ *
+ *  - verifyWebhookSignature: verify an OUTGOING webhook PingRoom sent you.
+ *    PingRoom signs `HMAC-SHA256(signing_secret, rawBody)` and sends it as
+ *    `X-PingRoom-Signature: sha256=<hex>`. Verify over the EXACT raw request
+ *    body bytes — re-serializing the parsed JSON will not match.
+ *
+ *  - sendIncomingWebhook: fire a room's INCOMING webhook (the URL carries its
+ *    own secret, so no agent token is needed) — the one-line CI/deploy ping.
+ */
+import { PingRoomError } from './errors.js';
+import { combineSignals } from './internal/async.js';
+import { assertActionNumber, assertStructuredData } from './internal/guards.js';
+import { assertSecureUrl } from './internal/url.js';
+import { VERSION } from './version.js';
+export const WEBHOOK_SIGNATURE_HEADER = 'X-PingRoom-Signature';
+export const WEBHOOK_TIMESTAMP_HEADER = 'X-PingRoom-Timestamp';
+export const WEBHOOK_DELIVERY_HEADER = 'X-PingRoom-Delivery';
+export const WEBHOOK_EVENT_HEADER = 'X-PingRoom-Event';
+/**
+ * Constant-time verification of an outgoing-webhook signature. Returns a
+ * boolean and never throws on mismatch.
+ */
+export async function verifyWebhookSignature(opts) {
+    if (!opts.signature || !opts.secret) {
+        return false;
+    }
+    const provided = normalizeSignature(opts.signature).toLowerCase();
+    if (!/^[0-9a-f]{64}$/.test(provided)) {
+        return false;
+    }
+    const expected = await hmacSha256Hex(opts.secret, toMessageString(opts.payload));
+    return timingSafeEqualHex(provided, expected);
+}
+/** POST to a room's incoming-webhook URL (which embeds the secret in its path). */
+export async function sendIncomingWebhook(webhookUrl, payload, options = {}) {
+    assertSecureUrl(webhookUrl, options.allowInsecure ?? false);
+    assertActionNumber(payload.action);
+    assertStructuredData(payload.data);
+    const body = {};
+    if (payload.message !== undefined)
+        body.message = payload.message;
+    if (payload.title !== undefined)
+        body.title = payload.title;
+    if (payload.action !== undefined)
+        body.action = payload.action;
+    if (payload.data !== undefined)
+        body.data = payload.data;
+    if (payload.correlation_id !== undefined)
+        body.correlation_id = payload.correlation_id;
+    if (payload.reply_to !== undefined)
+        body.reply_to = payload.reply_to;
+    const headers = {
+        'Content-Type': 'application/json',
+        Accept: 'application/json',
+        'User-Agent': `pingroom-sdk/${VERSION}`,
+    };
+    if (options.idempotencyKey) {
+        headers['Idempotency-Key'] = options.idempotencyKey;
+    }
+    const fetchImpl = options.fetch ?? globalThis.fetch;
+    if (!fetchImpl) {
+        throw new PingRoomError('No fetch implementation available.', { code: 'no_fetch' });
+    }
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), options.timeoutMs ?? 30_000);
+    const signal = combineSignals(controller.signal, options.signal);
+    let res;
+    try {
+        res = await fetchImpl(webhookUrl, { method: 'POST', headers, body: JSON.stringify(body), signal });
+    }
+    catch (err) {
+        throw new PingRoomError(`Webhook request failed: ${err instanceof Error ? err.message : String(err)}`, {
+            code: 'network_error',
+        });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    const text = await res.text();
+    let json = null;
+    if (text) {
+        try {
+            json = JSON.parse(text);
+        }
+        catch {
+            json = text;
+        }
+    }
+    const result = json && typeof json === 'object' ? json : { success: res.ok };
+    if (!res.ok || result.success === false) {
+        throw PingRoomError.fromResponse(res.status, json, res.headers);
+    }
+    return result;
+}
+// --- internals ------------------------------------------------------------
+function normalizeSignature(sig) {
+    const s = sig.trim();
+    return s.startsWith('sha256=') ? s.slice('sha256='.length) : s;
+}
+function toMessageString(payload) {
+    if (typeof payload === 'string') {
+        return payload;
+    }
+    if (payload instanceof Uint8Array) {
+        return new TextDecoder().decode(payload);
+    }
+    return new TextDecoder().decode(new Uint8Array(payload));
+}
+async function hmacSha256Hex(secret, message) {
+    const enc = new TextEncoder();
+    const key = await crypto.subtle.importKey('raw', enc.encode(secret), { name: 'HMAC', hash: 'SHA-256' }, false, ['sign']);
+    const signature = await crypto.subtle.sign('HMAC', key, enc.encode(message));
+    const bytes = new Uint8Array(signature);
+    let hex = '';
+    for (const b of bytes) {
+        hex += b.toString(16).padStart(2, '0');
+    }
+    return hex;
+}
+/** Constant-time compare of two equal-length lowercase-hex strings. */
+function timingSafeEqualHex(a, b) {
+    if (a.length !== b.length) {
+        return false;
+    }
+    let diff = 0;
+    for (let i = 0; i < a.length; i++) {
+        diff |= a.charCodeAt(i) ^ b.charCodeAt(i);
+    }
+    return diff === 0;
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/webhooks.js.map

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

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@pingroom/sdk",
+  "version": "0.1.0",
+  "description": "Official TypeScript/JavaScript SDK for the PingRoom agent API — auth, rooms, pings, agent-to-agent messaging, human-in-the-loop approvals, real-time listen, MCP, and webhook signature verification.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc -p tsconfig.json",
+    "test": "npm run build && node --test \"test/*.test.mjs\"",
+    "prepublishOnly": "npm run clean && npm run build && npm test"
+  },
+  "keywords": [
+    "pingroom",
+    "notifications",
+    "push",
+    "agent",
+    "mcp",
+    "webhook",
+    "ci",
+    "sdk",
+    "typescript"
+  ],
+  "license": "MIT",
+  "homepage": "https://pingroom.io",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pingroom/sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/pingroom/sdk/issues"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0"
+  }
+}