@quaillogistics/inbox 0.2.0

package/dist/types.d.ts

@@ -0,0 +1,234 @@
+export type Provider = "gmail" | "outlook" | "imap";
+export type AccountStatus = "active" | "revoked" | "disabled";
+export type TriageState = "NEEDS_REVIEW" | "WAITING" | "SNOOZED" | "DONE";
+export type Priority = "HIGH" | "MEDIUM" | "LOW";
+export type Direction = "INBOUND" | "OUTBOUND";
+export type MessageStatus = "UNPROCESSED" | "PROCESSED" | "ERROR";
+export type WebhookStatus = "active" | "inactive" | "disabled";
+export type DeliveryStatus = "pending" | "delivered" | "failed";
+export type ApiKeyStatus = "active" | "revoked";
+export type PipelineStep = "classify" | "extract" | "summarize";
+/** Connected email account (credentials are never returned) */
+export interface Account {
+    id: string;
+    ownerId: string;
+    provider: Provider;
+    email: string;
+    displayName: string | null;
+    status: AccountStatus;
+    syncCursor: string | null;
+    syncState: string | null;
+    lastSyncAt: string | null;
+    watchExpiry: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Conversation {
+    id: string;
+    accountId: string;
+    externalId: string;
+    subject: string;
+    lastMessageAt: string;
+    isRead: boolean;
+    isArchived: boolean;
+    deletedAt: string | null;
+    triageState: TriageState;
+    priority: Priority | null;
+    followUpAt: string | null;
+    snoozedUntil: string | null;
+    classification: string | null;
+    classificationConfidence: number | null;
+    aiSummary: string | null;
+    aiSummaryMessageCount: number | null;
+    suggestedActions: unknown | null;
+    extraction: Record<string, unknown> | null;
+    lastProcessedMessageId: string | null;
+    lastSummarizedAt: string | null;
+    linkedEntityType: string | null;
+    linkedEntityId: string | null;
+    linkedEntityRef: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Recipient {
+    email: string;
+    name?: string;
+}
+export interface Recipients {
+    to: Recipient[];
+    cc: Recipient[];
+    bcc: Recipient[];
+}
+export interface Message {
+    id: string;
+    conversationId: string;
+    externalId: string;
+    direction: Direction;
+    sender: string;
+    senderName: string | null;
+    recipients: Recipients;
+    subject: string;
+    bodyText: string | null;
+    bodyHtml: string | null;
+    sentAt: string;
+    status: MessageStatus;
+    classification: string | null;
+    classificationConfidence: number | null;
+    processingError: string | null;
+    processingDurationMs: number | null;
+    retryCount: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Attachment {
+    id: string;
+    messageId: string;
+    externalId: string | null;
+    filename: string;
+    contentType: string;
+    size: number;
+    bucketPath: string | null;
+    createdAt: string;
+}
+export interface MessageWithAttachments extends Message {
+    attachments: Attachment[];
+}
+export interface ConversationWithMessages extends Conversation {
+    messages: MessageWithAttachments[];
+}
+export interface Contact {
+    id: string;
+    ownerId: string;
+    email: string;
+    displayName: string | null;
+    frequency: number;
+    lastContactedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface WebhookSubscription {
+    id: string;
+    ownerId: string;
+    url: string;
+    secret: string;
+    events: string[];
+    status: WebhookStatus;
+    consecutiveFailures: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface WebhookDelivery {
+    id: string;
+    subscriptionId: string;
+    eventType: string;
+    payload: unknown;
+    status: DeliveryStatus;
+    httpStatus: number | null;
+    responseBody: string | null;
+    durationMs: number | null;
+    attempts: number;
+    nextRetryAt: string | null;
+    createdAt: string;
+}
+export interface ApiKey {
+    id: string;
+    keyPrefix: string;
+    label: string | null;
+    lastUsedAt: string | null;
+    expiresAt: string | null;
+    status: ApiKeyStatus;
+    createdAt: string;
+}
+/** Only returned once at creation — key is never shown again */
+export interface CreatedApiKey {
+    id: string;
+    key: string;
+    key_prefix: string;
+    label: string | null;
+}
+export interface User {
+    id: string;
+    email: string;
+    owner_id: string;
+    display_name: string | null;
+}
+export interface PipelineCategory {
+    name: string;
+    description: string;
+    extract: boolean;
+    priority_default?: Priority | null;
+    priority?: Priority | null;
+}
+export interface PipelineActionType {
+    type: string;
+    label: string;
+}
+export interface PipelineConfig {
+    categories: PipelineCategory[];
+    extraction_schema: Record<string, unknown> | null;
+    system_prompts: Record<string, string> | null;
+    action_types: PipelineActionType[] | null;
+    model_config: Record<string, unknown> | null;
+}
+export interface ConversationCounts {
+    all: number;
+    unread: number;
+    needs_review: number;
+    waiting: number;
+    snoozed: number;
+    done: number;
+    archived: number;
+    linked: number;
+    priority_high: number;
+    priority_medium: number;
+    priority_low: number;
+}
+export interface ConversationTriageSummary {
+    id: string;
+    externalId: string;
+    triageState: TriageState;
+    priority: Priority | null;
+    classification: string | null;
+    linkedEntityType: string | null;
+    linkedEntityId: string | null;
+    linkedEntityRef: string | null;
+}
+export interface HealthStatus {
+    status: "ok" | "degraded" | "error";
+    version: string;
+    postgres: boolean;
+    redis: boolean;
+}
+export type ConversationFilter = "all" | "unread" | "archived" | "needs_review" | "waiting" | "snoozed" | "done" | "linked" | `classified:${string}`;
+export interface ConversationListParams {
+    filter?: ConversationFilter;
+    priority?: Priority;
+    classification?: string;
+    search?: string;
+    page?: number;
+    pageSize?: number;
+}
+export interface TriageParams {
+    triage_state?: TriageState;
+    priority?: Priority | null;
+    follow_up_at?: string | null;
+    snoozed_until?: string | null;
+    is_read?: boolean;
+    is_archived?: boolean;
+}
+export interface LinkParams {
+    type: string;
+    id: string;
+    ref?: string;
+}
+export interface DraftParams {
+    intent?: string;
+}
+export interface UpdatePipelineConfigParams {
+    categories?: PipelineCategory[];
+    extraction_schema?: Record<string, unknown> | null;
+    system_prompts?: Record<string, string> | null;
+    action_types?: PipelineActionType[] | null;
+    model_config?: Record<string, unknown> | 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,3 @@
+// ─── Enums ────────────────────────────────────────────────────────────────────
+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,iFAAiF"}

package/dist/webhooks/types.d.ts

@@ -0,0 +1,111 @@
+import type { Priority, TriageState } from "../types.js";
+/** Base shape for every webhook event delivered by the Inbox API. */
+export interface WebhookEnvelope<T extends string, D> {
+    event: T;
+    timestamp: string;
+    data: D;
+}
+export interface ConversationCreatedPayload {
+    conversation_id: string;
+    subject: string;
+    sender: string;
+    account_id: string;
+}
+export interface ConversationClassifiedPayload {
+    conversation_id: string;
+    classification: string;
+    confidence: number;
+    priority: Priority | null;
+    /** Populated when the pipeline is configured to extract structured data. */
+    extraction: Record<string, unknown> | null;
+}
+export interface ConversationSummarizedPayload {
+    conversation_id: string;
+    summary: string;
+    suggested_actions: unknown[] | null;
+}
+export interface ConversationUpdatedPayload {
+    conversation_id: string;
+    changes: {
+        triage_state?: TriageState;
+        priority?: Priority | null;
+        follow_up_at?: string | null;
+        snoozed_until?: string | null;
+        is_read?: boolean;
+        is_archived?: boolean;
+    };
+}
+export interface ConversationLinkedPayload {
+    conversation_id: string;
+    linked_entity: {
+        type: string;
+        id: string;
+        ref?: string;
+    };
+}
+export interface ConversationUnlinkedPayload {
+    conversation_id: string;
+}
+export interface MessageReceivedPayload {
+    conversation_id: string;
+    message_id: string;
+    sender: string;
+}
+export interface MessageSentPayload {
+    conversation_id: string;
+    message_id: string;
+}
+export interface MessageProcessedPayload {
+    message_id: string;
+    conversation_id: string;
+    classification: string | null;
+    confidence: number | null;
+}
+export interface AccountConnectedPayload {
+    account_id: string;
+    provider: string;
+    email: string;
+}
+export interface AccountSyncCompletedPayload {
+    account_id: string;
+    new_messages: number;
+    new_conversations: number;
+}
+export interface AccountErrorPayload {
+    account_id: string;
+    error_type: string;
+    error_message: string;
+}
+export interface TestPayload {
+    message: string;
+}
+export type ConversationCreatedEvent = WebhookEnvelope<"conversation.created", ConversationCreatedPayload>;
+export type ConversationClassifiedEvent = WebhookEnvelope<"conversation.classified", ConversationClassifiedPayload>;
+export type ConversationSummarizedEvent = WebhookEnvelope<"conversation.summarized", ConversationSummarizedPayload>;
+export type ConversationUpdatedEvent = WebhookEnvelope<"conversation.updated", ConversationUpdatedPayload>;
+export type ConversationLinkedEvent = WebhookEnvelope<"conversation.linked", ConversationLinkedPayload>;
+export type ConversationUnlinkedEvent = WebhookEnvelope<"conversation.unlinked", ConversationUnlinkedPayload>;
+export type MessageReceivedEvent = WebhookEnvelope<"message.received", MessageReceivedPayload>;
+export type MessageSentEvent = WebhookEnvelope<"message.sent", MessageSentPayload>;
+export type MessageProcessedEvent = WebhookEnvelope<"message.processed", MessageProcessedPayload>;
+export type AccountConnectedEvent = WebhookEnvelope<"account.connected", AccountConnectedPayload>;
+export type AccountSyncCompletedEvent = WebhookEnvelope<"account.sync_completed", AccountSyncCompletedPayload>;
+export type AccountErrorEvent = WebhookEnvelope<"account.error", AccountErrorPayload>;
+export type TestEvent = WebhookEnvelope<"test", TestPayload>;
+/**
+ * All webhook events emitted by the Inbox API.
+ * Narrow by `event.event` to get a fully typed payload.
+ *
+ * @example
+ * function handleWebhook(event: InboxWebhookEvent) {
+ *   switch (event.event) {
+ *     case "conversation.classified":
+ *       if (event.data.classification === "LOAD_TENDER") {
+ *         createLoadFromExtraction(event.data.extraction);
+ *       }
+ *       break;
+ *   }
+ * }
+ */
+export type InboxWebhookEvent = ConversationCreatedEvent | ConversationClassifiedEvent | ConversationSummarizedEvent | ConversationUpdatedEvent | ConversationLinkedEvent | ConversationUnlinkedEvent | MessageReceivedEvent | MessageSentEvent | MessageProcessedEvent | AccountConnectedEvent | AccountSyncCompletedEvent | AccountErrorEvent | TestEvent;
+//# sourceMappingURL=types.d.ts.map

package/dist/webhooks/types.d.ts.map

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

package/dist/webhooks/types.js

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

package/dist/webhooks/types.js.map

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

package/dist/webhooks/verify.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Verify the HMAC-SHA256 signature on an incoming Inbox webhook request.
+ *
+ * The server signs the raw JSON body with the subscription secret using
+ * HMAC-SHA256 and sends the result in the `X-Inbox-Signature` header as
+ * `sha256=<hex>`.
+ *
+ * Uses the Web Crypto API (`globalThis.crypto.subtle`) — available in
+ * Node 18+, Bun, Deno, Cloudflare Workers, and all modern browsers.
+ *
+ * @example
+ * // Express / Hono webhook handler
+ * const isValid = await verifyWebhookSignature({
+ *   payload: rawBody,          // string — the raw request body before JSON.parse
+ *   signature: req.headers["x-inbox-signature"],
+ *   secret: process.env.INBOX_WEBHOOK_SECRET,
+ * });
+ * if (!isValid) return res.status(401).send("Bad signature");
+ * const event: InboxWebhookEvent = JSON.parse(rawBody);
+ */
+export declare function verifyWebhookSignature(params: {
+    /** Raw request body string (before JSON.parse). */
+    payload: string;
+    /** Value of the `X-Inbox-Signature` header. */
+    signature: string | null | undefined;
+    /** Webhook subscription secret (from `webhooks.create()` or stored at subscription time). */
+    secret: string;
+}): Promise<boolean>;
+//# sourceMappingURL=verify.d.ts.map

package/dist/webhooks/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/webhooks/verify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE;IACnD,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrC,6FAA6F;IAC7F,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,OAAO,CAAC,CA+BnB"}

package/dist/webhooks/verify.js

@@ -0,0 +1,48 @@
+/**
+ * Verify the HMAC-SHA256 signature on an incoming Inbox webhook request.
+ *
+ * The server signs the raw JSON body with the subscription secret using
+ * HMAC-SHA256 and sends the result in the `X-Inbox-Signature` header as
+ * `sha256=<hex>`.
+ *
+ * Uses the Web Crypto API (`globalThis.crypto.subtle`) — available in
+ * Node 18+, Bun, Deno, Cloudflare Workers, and all modern browsers.
+ *
+ * @example
+ * // Express / Hono webhook handler
+ * const isValid = await verifyWebhookSignature({
+ *   payload: rawBody,          // string — the raw request body before JSON.parse
+ *   signature: req.headers["x-inbox-signature"],
+ *   secret: process.env.INBOX_WEBHOOK_SECRET,
+ * });
+ * if (!isValid) return res.status(401).send("Bad signature");
+ * const event: InboxWebhookEvent = JSON.parse(rawBody);
+ */
+export async function verifyWebhookSignature(params) {
+    const { payload, signature, secret } = params;
+    if (!signature)
+        return false;
+    // Expected format: "sha256=<hex>"
+    const match = /^sha256=([0-9a-f]+)$/i.exec(signature);
+    if (!match)
+        return false;
+    const expectedHex = match[1];
+    const enc = new TextEncoder();
+    const keyMaterial = await globalThis.crypto.subtle.importKey("raw", enc.encode(secret), { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
+    const signatureBuffer = await globalThis.crypto.subtle.sign("HMAC", keyMaterial, enc.encode(payload));
+    const actualHex = Array.from(new Uint8Array(signatureBuffer))
+        .map((b) => b.toString(16).padStart(2, "0"))
+        .join("");
+    // Constant-time comparison to prevent timing attacks
+    return constantTimeEqual(actualHex, expectedHex.toLowerCase());
+}
+function constantTimeEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    let result = 0;
+    for (let i = 0; i < a.length; i++) {
+        result |= a.charCodeAt(i) ^ b.charCodeAt(i);
+    }
+    return result === 0;
+}
+//# sourceMappingURL=verify.js.map

package/dist/webhooks/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/webhooks/verify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,MAO5C;IACC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAE9C,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAE7B,kCAAkC;IAClC,MAAM,KAAK,GAAG,uBAAuB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtD,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;IAE9B,MAAM,GAAG,GAAG,IAAI,WAAW,EAAE,CAAC;IAC9B,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAC1D,KAAK,EACL,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAClB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,EACjC,KAAK,EACL,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,MAAM,eAAe,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CACzD,MAAM,EACN,WAAW,EACX,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CACpB,CAAC;IAEF,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,eAAe,CAAC,CAAC;SAC1D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;SAC3C,IAAI,CAAC,EAAE,CAAC,CAAC;IAEZ,qDAAqD;IACrD,OAAO,iBAAiB,CAAC,SAAS,EAAE,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,iBAAiB,CAAC,CAAS,EAAE,CAAS;IAC7C,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,MAAM,KAAK,CAAC,CAAC;AACtB,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@quaillogistics/inbox",
+  "version": "0.2.0",
+  "description": "TypeScript SDK for the Inbox API",
+  "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"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "bunx tsc",
+    "typecheck": "bunx tsc --noEmit",
+    "dev": "bunx tsc --noEmit --watch"
+  },
+  "keywords": [
+    "email",
+    "inbox",
+    "triage",
+    "sdk"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/quaillogistics/inbox.git",
+    "directory": "packages/sdk"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.3"
+  }
+}