@ravi-hq/ravi 0.1.0

package/dist/cli.js

@@ -0,0 +1,390 @@
+import { execFile } from "node:child_process";
+import { createInterface } from "node:readline";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir, platform } from "node:os";
+import { RAVI_API_URL } from "./config.js";
+import { RaviClient, RaviApiError } from "./client.js";
+/** Try to open a URL in the user's default browser. Non-fatal on failure. */
+function openBrowser(url) {
+    const cmd = platform() === "darwin" ? "open" :
+        platform() === "win32" ? "cmd" :
+            "xdg-open";
+    const args = platform() === "win32" ? ["/c", "start", url] : [url];
+    execFile(cmd, args, () => {
+        // Silently ignore errors — user can open the URL manually
+    });
+}
+/**
+ * Prompt the user for a 6-digit PIN via stdin (hidden input).
+ * Matches the CLI's interactive PIN prompt behavior.
+ */
+async function promptPIN(prompt) {
+    return new Promise((resolve, reject) => {
+        const rl = createInterface({ input: process.stdin, output: process.stderr });
+        // Mute output to hide PIN typing (write prompt to stderr like the CLI)
+        process.stderr.write(prompt);
+        const stdin = process.stdin;
+        const wasRaw = stdin.isRaw;
+        if (stdin.isTTY && stdin.setRawMode) {
+            stdin.setRawMode(true);
+        }
+        let pin = "";
+        const onData = (key) => {
+            const ch = key.toString();
+            if (ch === "\r" || ch === "\n") {
+                // Done
+                if (stdin.isTTY && stdin.setRawMode)
+                    stdin.setRawMode(wasRaw ?? false);
+                stdin.removeListener("data", onData);
+                process.stderr.write("\n");
+                rl.close();
+                resolve(pin);
+            }
+            else if (ch === "\x03") {
+                // Ctrl+C
+                if (stdin.isTTY && stdin.setRawMode)
+                    stdin.setRawMode(wasRaw ?? false);
+                stdin.removeListener("data", onData);
+                rl.close();
+                reject(new Error("Cancelled"));
+            }
+            else if (ch === "\x7f" || ch === "\b") {
+                // Backspace
+                pin = pin.slice(0, -1);
+            }
+            else if (ch.length === 1 && ch >= " ") {
+                pin += ch;
+            }
+        };
+        stdin.on("data", onData);
+    });
+}
+/**
+ * Prompt for PIN with choose + confirm (first-time setup),
+ * or just enter PIN (returning user). Validates 6-digit format.
+ */
+async function promptAndConfirmPIN() {
+    const pin = await promptPIN("Choose a 6-digit encryption PIN: ");
+    if (!/^\d{6}$/.test(pin)) {
+        throw new Error("PIN must be exactly 6 digits.");
+    }
+    const confirm = await promptPIN("Confirm PIN: ");
+    if (pin !== confirm) {
+        throw new Error("PINs do not match.");
+    }
+    return pin;
+}
+async function promptExistingPIN() {
+    const pin = await promptPIN("Enter your 6-digit encryption PIN: ");
+    if (!/^\d{6}$/.test(pin)) {
+        throw new Error("PIN must be exactly 6 digits.");
+    }
+    return pin;
+}
+/**
+ * Save recovery key to ~/.ravi/recovery-key.txt (same location as CLI).
+ * Creates ~/.ravi/ directory if needed. File permissions: 0600.
+ */
+function saveRecoveryKey(recoveryKey) {
+    const raviDir = join(homedir(), ".ravi");
+    mkdirSync(raviDir, { recursive: true, mode: 0o700 });
+    const filePath = join(raviDir, "recovery-key.txt");
+    writeFileSync(filePath, recoveryKey + "\n", { mode: 0o600 });
+    return filePath;
+}
+// ─── Command Definitions ────────────────────────────────────────────────────
+/**
+ * All CLI commands exposed by the Ravi plugin.
+ *
+ * OpenClaw registers these so the user can run `openclaw ravi login`,
+ * `openclaw ravi status`, etc.
+ */
+export const cliCommands = [
+    // ── login ───────────────────────────────────────────────────────────────
+    {
+        name: "login",
+        description: "Authenticate with Ravi using device code flow. Opens a browser for login.",
+        handler: async (_args, config) => {
+            const apiUrl = RAVI_API_URL;
+            // Step 1: Initiate device code flow
+            const response = await fetch(`${apiUrl}/api/auth/device/`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+            });
+            if (!response.ok) {
+                const detail = await response.text().catch(() => "");
+                throw new Error(`Failed to initiate device code flow (HTTP ${response.status}): ${detail}`);
+            }
+            const data = (await response.json());
+            // Step 2: Open browser and display user code
+            // Pass user_code as query param so the verify page auto-fills it
+            const verifyUrl = `${data.verification_uri}?user_code=${data.user_code}`;
+            openBrowser(verifyUrl);
+            let output = `\nTo authenticate, visit: ${verifyUrl}\n`;
+            output += `Code: ${data.user_code}\n`;
+            output += `(Attempting to open browser automatically)\n\n`;
+            output += `Waiting for authorization...\n`;
+            // Step 3: Poll for token until authorized or expired
+            const intervalMs = (data.interval || 5) * 1000;
+            const deadline = Date.now() + data.expires_in * 1000;
+            let consecutiveNetworkErrors = 0;
+            while (Date.now() < deadline) {
+                await new Promise((resolve) => setTimeout(resolve, intervalMs));
+                let tokenResponse;
+                try {
+                    tokenResponse = await fetch(`${apiUrl}/api/auth/device/token/`, {
+                        method: "POST",
+                        headers: { "Content-Type": "application/json" },
+                        body: JSON.stringify({ device_code: data.device_code }),
+                    });
+                }
+                catch {
+                    consecutiveNetworkErrors++;
+                    if (consecutiveNetworkErrors >= 3) {
+                        throw new Error(`Network error during login — failed ${consecutiveNetworkErrors} consecutive times. ` +
+                            `Check your network connection and that ${apiUrl} is reachable.`);
+                    }
+                    continue;
+                }
+                consecutiveNetworkErrors = 0;
+                if (tokenResponse.ok) {
+                    const tokenData = (await tokenResponse.json());
+                    // Step 4: Check encryption status and handle PIN setup/verification
+                    const client = new RaviClient({ apiUrl, token: tokenData.access });
+                    output += `\nAuthenticated as ${tokenData.user.email}\n\n`;
+                    // Track PIN resolved during this session (from config or prompted)
+                    let resolvedPin = config.pin;
+                    // Check encryption status
+                    // Backend uses get_or_create — always returns 200 with empty public_key for new users
+                    let meta = null;
+                    try {
+                        meta = await client.getEncryptionMeta();
+                    }
+                    catch (err) {
+                        const msg = err instanceof Error ? err.message : String(err);
+                        output += `WARNING: Could not check encryption status: ${msg}\n`;
+                        output += `Encryption features may not work correctly.\n\n`;
+                    }
+                    if (meta && !meta.public_key) {
+                        // First-time setup — prompt for PIN if not in config
+                        if (!resolvedPin) {
+                            try {
+                                resolvedPin = await promptAndConfirmPIN();
+                            }
+                            catch (err) {
+                                const msg = err instanceof Error ? err.message : String(err);
+                                output += `PIN setup cancelled: ${msg}\n`;
+                                output += `Run 'openclaw ravi login' again to set up encryption.\n\n`;
+                            }
+                        }
+                        if (resolvedPin) {
+                            try {
+                                const { setupEncryption } = await import("./crypto.js");
+                                const setup = await setupEncryption(resolvedPin);
+                                // Save recovery key to ~/.ravi/recovery-key.txt (same as CLI)
+                                const recoveryPath = saveRecoveryKey(setup.recoveryKey);
+                                // Register with server
+                                await client.updateEncryptionMeta({
+                                    salt: setup.salt,
+                                    public_key: setup.publicKey,
+                                    verifier: setup.verifier,
+                                });
+                                output += `E2E encryption set up successfully!\n`;
+                                output += `Recovery key saved to ${recoveryPath} — back this up!\n\n`;
+                            }
+                            catch (err) {
+                                const msg = err instanceof Error ? err.message : String(err);
+                                output += `Failed to set up encryption: ${msg}\n`;
+                                output += `You can try again by running 'openclaw ravi login'.\n\n`;
+                            }
+                        }
+                    }
+                    else if (meta && meta.public_key) {
+                        // Existing encryption — verify PIN (prompt if not in config)
+                        if (!resolvedPin) {
+                            try {
+                                resolvedPin = await promptExistingPIN();
+                            }
+                            catch (err) {
+                                const msg = err instanceof Error ? err.message : String(err);
+                                output += `PIN entry cancelled: ${msg}\n\n`;
+                            }
+                        }
+                        if (resolvedPin) {
+                            try {
+                                const { deriveKeyPair, verify } = await import("./crypto.js");
+                                const kp = await deriveKeyPair(resolvedPin, meta.salt);
+                                const valid = await verify(kp, meta.verifier);
+                                if (valid) {
+                                    output += `PIN verified — E2E encryption is ready.\n\n`;
+                                }
+                                else {
+                                    output += `WARNING: PIN does not match! Check your PIN.\n\n`;
+                                }
+                            }
+                            catch (err) {
+                                const msg = err instanceof Error ? err.message : String(err);
+                                output += `PIN verification failed: ${msg}\n\n`;
+                            }
+                        }
+                    }
+                    // Fetch identities to auto-include identityUuid
+                    let identityUuidLine = "";
+                    try {
+                        const identities = await client.listIdentities();
+                        if (identities.length === 1) {
+                            identityUuidLine = `          "identityUuid": "${identities[0].uuid}",\n`;
+                            output += `Auto-selected identity: ${identities[0].name} (${identities[0].uuid})\n\n`;
+                        }
+                        else if (identities.length > 1) {
+                            output += `Multiple identities found. Add one to your config as "identityUuid":\n`;
+                            for (const identity of identities) {
+                                output += `  - ${identity.name}: ${identity.uuid}\n`;
+                            }
+                            output += `\n`;
+                        }
+                        else {
+                            output += `No identities found. Create one first, then add its UUID to config as "identityUuid".\n\n`;
+                        }
+                    }
+                    catch {
+                        // Can't list identities — skip auto-include
+                    }
+                    // Output config snippet
+                    output += `Plugin config:\n\n`;
+                    output += `{\n`;
+                    output += `  "plugins": {\n`;
+                    output += `    "entries": {\n`;
+                    output += `      "ravi": {\n`;
+                    output += `        "enabled": true,\n`;
+                    output += `        "config": {\n`;
+                    // apiUrl is baked in at build time — not part of user config
+                    output += `          "token": "${tokenData.access}",\n`;
+                    output += `          "refreshToken": "${tokenData.refresh}",\n`;
+                    output += identityUuidLine;
+                    output += `          "pin": "${resolvedPin ?? "YOUR_6_DIGIT_PIN"}"\n`;
+                    output += `        }\n`;
+                    output += `      }\n`;
+                    output += `    }\n`;
+                    output += `  }\n`;
+                    output += `}\n\n`;
+                    output += `Run 'openclaw ravi setup' to configure channels.\n`;
+                    return output;
+                }
+                // Check whether the error is "still waiting" or a terminal failure
+                const error = (await tokenResponse.json().catch(() => ({})));
+                if (error.error !== "authorization_pending") {
+                    throw new Error(`Device code flow failed: ${error.error ?? `HTTP ${tokenResponse.status}`}`);
+                }
+            }
+            throw new Error("Device code expired. Please try again.");
+        },
+    },
+    // ── status ──────────────────────────────────────────────────────────────
+    {
+        name: "status",
+        description: "Show authentication status and available identities.",
+        handler: async (_args, config) => {
+            if (!config.token) {
+                return `Not configured. Run 'openclaw ravi login' to authenticate.`;
+            }
+            const apiUrl = RAVI_API_URL;
+            const client = new RaviClient({ apiUrl, token: config.token });
+            try {
+                const identities = await client.listIdentities();
+                let output = `Authenticated to ${apiUrl}\n`;
+                output += `PIN configured: ${config.pin ? "Yes" : "No"}\n`;
+                output += `\nIdentities (${identities.length}):\n`;
+                for (const identity of identities) {
+                    output += `  - ${identity.name} (${identity.uuid})\n`;
+                    if (identity.email)
+                        output += `    Email: ${identity.email}\n`;
+                    if (identity.phone)
+                        output += `    Phone: ${identity.phone}\n`;
+                }
+                if (!config.pin) {
+                    output += `\nWARNING: No PIN configured — encrypted data (passwords, vault) will not be readable.\n`;
+                    output += `Add your PIN to the plugin config to enable E2E decryption.\n`;
+                }
+                return output;
+            }
+            catch (err) {
+                if (err instanceof RaviApiError && (err.status === 401 || err.status === 403)) {
+                    return `Token expired or invalid. Run 'openclaw ravi login' to re-authenticate.`;
+                }
+                if (err instanceof RaviApiError && err.status === 402) {
+                    return `Billing issue (HTTP 402). Please check your Ravi subscription.`;
+                }
+                const message = err instanceof Error ? err.message : String(err);
+                return `Failed to fetch status: ${message}\n\nIf this persists, check your network connection and API URL.`;
+            }
+        },
+    },
+    // ── setup ───────────────────────────────────────────────────────────────
+    {
+        name: "setup",
+        description: "Interactive setup for email and SMS channels.",
+        handler: async (_args, config) => {
+            const apiUrl = RAVI_API_URL;
+            const client = new RaviClient({ apiUrl, token: config.token });
+            const identities = await client.listIdentities();
+            if (identities.length === 0) {
+                return "No identities found. Create one first with the 'ravi_identity_create' tool.";
+            }
+            let output = "Channel Configuration\n";
+            output += "=====================\n\n";
+            // Suggest identityUuid for plugin config
+            if (identities.length === 1) {
+                output += `Tip: Add this to your plugin config to scope all tools to this identity:\n`;
+                output += `  "identityUuid": "${identities[0].uuid}"\n\n`;
+            }
+            else {
+                output += `Tip: Add "identityUuid" to your plugin config to scope all tools to one identity:\n`;
+                for (const identity of identities) {
+                    output += `  - ${identity.name}: "${identity.uuid}"\n`;
+                }
+                output += `\n`;
+            }
+            output += "Add this to your OpenClaw config under the 'channels' key.\n\n";
+            output += `"channels": {\n`;
+            // Email accounts
+            const emailIdentities = identities.filter(i => i.email);
+            if (emailIdentities.length > 0) {
+                output += `  "ravi-email": {\n`;
+                output += `    "accounts": {\n`;
+                for (const [idx, identity] of emailIdentities.entries()) {
+                    output += `      "${identity.uuid}": {\n`;
+                    output += `        "identityUuid": "${identity.uuid}",\n`;
+                    output += `        "identityName": "${identity.name}",\n`;
+                    output += `        "email": "${identity.email}"\n`;
+                    output += `      }${idx < emailIdentities.length - 1 ? "," : ""}\n`;
+                }
+                output += `    }\n`;
+                output += `  },\n`;
+            }
+            // SMS accounts
+            const phoneIdentities = identities.filter(i => i.phone);
+            if (phoneIdentities.length > 0) {
+                output += `  "ravi-sms": {\n`;
+                output += `    "accounts": {\n`;
+                for (const [idx, identity] of phoneIdentities.entries()) {
+                    output += `      "${identity.uuid}": {\n`;
+                    output += `        "identityUuid": "${identity.uuid}",\n`;
+                    output += `        "identityName": "${identity.name}",\n`;
+                    output += `        "phone": "${identity.phone}"\n`;
+                    output += `      }${idx < phoneIdentities.length - 1 ? "," : ""}\n`;
+                }
+                output += `    }\n`;
+                output += `  }\n`;
+            }
+            output += `}\n\n`;
+            output += `NOTE: Messages from your personal email (owner) and other Ravi identities (self)\n`;
+            output += `give the agent full access. Messages from unknown senders (external) are delivered\n`;
+            output += `as read-only context — the agent can see them but cannot respond or use write tools.\n`;
+            output += `To allow someone full access, add them as a personal email on the Ravi dashboard.\n`;
+            return output;
+        },
+    },
+];
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGvD,6EAA6E;AAC7E,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,GAAG,GACP,QAAQ,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAClC,QAAQ,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAChC,UAAU,CAAC;IACb,MAAM,IAAI,GAAG,QAAQ,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACnE,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE;QACvB,0DAA0D;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,SAAS,CAAC,MAAc;IACrC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7E,uEAAuE;QACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC;QAC3B,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACpC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAED,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,CAAC,GAAW,EAAE,EAAE;YAC7B,MAAM,EAAE,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC1B,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBAC/B,OAAO;gBACP,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU;oBAAE,KAAK,CAAC,UAAU,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC;gBACvE,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC3B,EAAE,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,CAAC,GAAG,CAAC,CAAC;YACf,CAAC;iBAAM,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;gBACzB,SAAS;gBACT,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU;oBAAE,KAAK,CAAC,UAAU,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC;gBACvE,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACrC,EAAE,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;YACjC,CAAC;iBAAM,IAAI,EAAE,KAAK,MAAM,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBACxC,YAAY;gBACZ,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACzB,CAAC;iBAAM,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC;gBACxC,GAAG,IAAI,EAAE,CAAC;YACZ,CAAC;QACH,CAAC,CAAC;QACF,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,mBAAmB;IAChC,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,mCAAmC,CAAC,CAAC;IACjE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,eAAe,CAAC,CAAC;IACjD,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,KAAK,UAAU,iBAAiB;IAC9B,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,qCAAqC,CAAC,CAAC;IACnE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,WAAmB;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IACzC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;IACnD,aAAa,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7D,OAAO,QAAQ,CAAC;AAClB,CAAC;AAoBD,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAiB;IACvC,2EAA2E;IAC3E;QACE,IAAI,EAAE,OAAO;QACb,WAAW,EACT,2EAA2E;QAC7E,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YAC/B,MAAM,MAAM,GAAG,YAAY,CAAC;YAE5B,oCAAoC;YACpC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,mBAAmB,EAAE;gBACzD,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;aAChD,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;gBACrD,MAAM,IAAI,KAAK,CACb,6CAA6C,QAAQ,CAAC,MAAM,MAAM,MAAM,EAAE,CAC3E,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAMlC,CAAC;YAEF,6CAA6C;YAC7C,iEAAiE;YACjE,MAAM,SAAS,GAAG,GAAG,IAAI,CAAC,gBAAgB,cAAc,IAAI,CAAC,SAAS,EAAE,CAAC;YACzE,WAAW,CAAC,SAAS,CAAC,CAAC;YAEvB,IAAI,MAAM,GAAG,6BAA6B,SAAS,IAAI,CAAC;YACxD,MAAM,IAAI,SAAS,IAAI,CAAC,SAAS,IAAI,CAAC;YACtC,MAAM,IAAI,gDAAgD,CAAC;YAC3D,MAAM,IAAI,gCAAgC,CAAC;YAE3C,qDAAqD;YACrD,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;YAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YACrD,IAAI,wBAAwB,GAAG,CAAC,CAAC;YAEjC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;gBAC7B,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;gBAEhE,IAAI,aAAuB,CAAC;gBAC5B,IAAI,CAAC;oBACH,aAAa,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,yBAAyB,EAAE;wBAC9D,MAAM,EAAE,MAAM;wBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;wBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;qBACxD,CAAC,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,wBAAwB,EAAE,CAAC;oBAC3B,IAAI,wBAAwB,IAAI,CAAC,EAAE,CAAC;wBAClC,MAAM,IAAI,KAAK,CACb,uCAAuC,wBAAwB,sBAAsB;4BACrF,0CAA0C,MAAM,gBAAgB,CACjE,CAAC;oBACJ,CAAC;oBACD,SAAS;gBACX,CAAC;gBAED,wBAAwB,GAAG,CAAC,CAAC;gBAE7B,IAAI,aAAa,CAAC,EAAE,EAAE,CAAC;oBACrB,MAAM,SAAS,GAAG,CAAC,MAAM,aAAa,CAAC,IAAI,EAAE,CAI5C,CAAC;oBAEF,oEAAoE;oBACpE,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;oBAEnE,MAAM,IAAI,sBAAsB,SAAS,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC;oBAE3D,mEAAmE;oBACnE,IAAI,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC;oBAE7B,0BAA0B;oBAC1B,sFAAsF;oBACtF,IAAI,IAAI,GAAkE,IAAI,CAAC;oBAC/E,IAAI,CAAC;wBACH,IAAI,GAAG,MAAM,MAAM,CAAC,iBAAiB,EAAE,CAAC;oBAC1C,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;wBAC7D,MAAM,IAAI,+CAA+C,GAAG,IAAI,CAAC;wBACjE,MAAM,IAAI,iDAAiD,CAAC;oBAC9D,CAAC;oBAED,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;wBAC7B,qDAAqD;wBACrD,IAAI,CAAC,WAAW,EAAE,CAAC;4BACjB,IAAI,CAAC;gCACH,WAAW,GAAG,MAAM,mBAAmB,EAAE,CAAC;4BAC5C,CAAC;4BAAC,OAAO,GAAG,EAAE,CAAC;gCACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gCAC7D,MAAM,IAAI,wBAAwB,GAAG,IAAI,CAAC;gCAC1C,MAAM,IAAI,2DAA2D,CAAC;4BACxE,CAAC;wBACH,CAAC;wBAED,IAAI,WAAW,EAAE,CAAC;4BAChB,IAAI,CAAC;gCACH,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;gCACxD,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC;gCAEjD,8DAA8D;gCAC9D,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;gCAExD,uBAAuB;gCACvB,MAAM,MAAM,CAAC,oBAAoB,CAAC;oCAChC,IAAI,EAAE,KAAK,CAAC,IAAI;oCAChB,UAAU,EAAE,KAAK,CAAC,SAAS;oCAC3B,QAAQ,EAAE,KAAK,CAAC,QAAQ;iCACzB,CAAC,CAAC;gCAEH,MAAM,IAAI,uCAAuC,CAAC;gCAClD,MAAM,IAAI,yBAAyB,YAAY,sBAAsB,CAAC;4BACxE,CAAC;4BAAC,OAAO,GAAG,EAAE,CAAC;gCACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gCAC7D,MAAM,IAAI,gCAAgC,GAAG,IAAI,CAAC;gCAClD,MAAM,IAAI,yDAAyD,CAAC;4BACtE,CAAC;wBACH,CAAC;oBACH,CAAC;yBAAM,IAAI,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;wBACnC,6DAA6D;wBAC7D,IAAI,CAAC,WAAW,EAAE,CAAC;4BACjB,IAAI,CAAC;gCACH,WAAW,GAAG,MAAM,iBAAiB,EAAE,CAAC;4BAC1C,CAAC;4BAAC,OAAO,GAAG,EAAE,CAAC;gCACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gCAC7D,MAAM,IAAI,wBAAwB,GAAG,MAAM,CAAC;4BAC9C,CAAC;wBACH,CAAC;wBAED,IAAI,WAAW,EAAE,CAAC;4BAChB,IAAI,CAAC;gCACH,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;gCAC9D,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gCACvD,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;gCAE9C,IAAI,KAAK,EAAE,CAAC;oCACV,MAAM,IAAI,6CAA6C,CAAC;gCAC1D,CAAC;qCAAM,CAAC;oCACN,MAAM,IAAI,kDAAkD,CAAC;gCAC/D,CAAC;4BACH,CAAC;4BAAC,OAAO,GAAG,EAAE,CAAC;gCACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gCAC7D,MAAM,IAAI,4BAA4B,GAAG,MAAM,CAAC;4BAClD,CAAC;wBACH,CAAC;oBACH,CAAC;oBAED,gDAAgD;oBAChD,IAAI,gBAAgB,GAAG,EAAE,CAAC;oBAC1B,IAAI,CAAC;wBACH,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC;wBACjD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;4BAC5B,gBAAgB,GAAG,8BAA8B,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;4BAC1E,MAAM,IAAI,2BAA2B,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;wBACxF,CAAC;6BAAM,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BACjC,MAAM,IAAI,wEAAwE,CAAC;4BACnF,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;gCAClC,MAAM,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,IAAI,CAAC;4BACvD,CAAC;4BACD,MAAM,IAAI,IAAI,CAAC;wBACjB,CAAC;6BAAM,CAAC;4BACN,MAAM,IAAI,2FAA2F,CAAC;wBACxG,CAAC;oBACH,CAAC;oBAAC,MAAM,CAAC;wBACP,4CAA4C;oBAC9C,CAAC;oBAED,wBAAwB;oBACxB,MAAM,IAAI,oBAAoB,CAAC;oBAC/B,MAAM,IAAI,KAAK,CAAC;oBAChB,MAAM,IAAI,kBAAkB,CAAC;oBAC7B,MAAM,IAAI,oBAAoB,CAAC;oBAC/B,MAAM,IAAI,mBAAmB,CAAC;oBAC9B,MAAM,IAAI,4BAA4B,CAAC;oBACvC,MAAM,IAAI,uBAAuB,CAAC;oBAClC,6DAA6D;oBAC7D,MAAM,IAAI,uBAAuB,SAAS,CAAC,MAAM,MAAM,CAAC;oBACxD,MAAM,IAAI,8BAA8B,SAAS,CAAC,OAAO,MAAM,CAAC;oBAChE,MAAM,IAAI,gBAAgB,CAAC;oBAC3B,MAAM,IAAI,qBAAqB,WAAW,IAAI,kBAAkB,KAAK,CAAC;oBACtE,MAAM,IAAI,aAAa,CAAC;oBACxB,MAAM,IAAI,WAAW,CAAC;oBACtB,MAAM,IAAI,SAAS,CAAC;oBACpB,MAAM,IAAI,OAAO,CAAC;oBAClB,MAAM,IAAI,OAAO,CAAC;oBAClB,MAAM,IAAI,oDAAoD,CAAC;oBAC/D,OAAO,MAAM,CAAC;gBAChB,CAAC;gBAED,mEAAmE;gBACnE,MAAM,KAAK,GAAG,CAAC,MAAM,aAAa,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAE1D,CAAC;gBACF,IAAI,KAAK,CAAC,KAAK,KAAK,uBAAuB,EAAE,CAAC;oBAC5C,MAAM,IAAI,KAAK,CACb,4BAA4B,KAAK,CAAC,KAAK,IAAI,QAAQ,aAAa,CAAC,MAAM,EAAE,EAAE,CAC5E,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;KACF;IAED,2EAA2E;IAC3E;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,sDAAsD;QACnE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBAClB,OAAO,4DAA4D,CAAC;YACtE,CAAC;YAED,MAAM,MAAM,GAAG,YAAY,CAAC;YAC5B,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YAE/D,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC;gBAEjD,IAAI,MAAM,GAAG,oBAAoB,MAAM,IAAI,CAAC;gBAC5C,MAAM,IAAI,mBAAmB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;gBAC3D,MAAM,IAAI,iBAAiB,UAAU,CAAC,MAAM,MAAM,CAAC;gBAEnD,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;oBAClC,MAAM,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,KAAK,CAAC;oBACtD,IAAI,QAAQ,CAAC,KAAK;wBAAE,MAAM,IAAI,cAAc,QAAQ,CAAC,KAAK,IAAI,CAAC;oBAC/D,IAAI,QAAQ,CAAC,KAAK;wBAAE,MAAM,IAAI,cAAc,QAAQ,CAAC,KAAK,IAAI,CAAC;gBACjE,CAAC;gBAED,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;oBAChB,MAAM,IAAI,0FAA0F,CAAC;oBACrG,MAAM,IAAI,+DAA+D,CAAC;gBAC5E,CAAC;gBAED,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,YAAY,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,EAAE,CAAC;oBAC9E,OAAO,yEAAyE,CAAC;gBACnF,CAAC;gBACD,IAAI,GAAG,YAAY,YAAY,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;oBACtD,OAAO,gEAAgE,CAAC;gBAC1E,CAAC;gBACD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,OAAO,2BAA2B,OAAO,kEAAkE,CAAC;YAC9G,CAAC;QACH,CAAC;KACF;IAED,2EAA2E;IAC3E;QACE,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,+CAA+C;QAC5D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YAC/B,MAAM,MAAM,GAAG,YAAY,CAAC;YAC5B,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YAE/D,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC;YAEjD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC5B,OAAO,6EAA6E,CAAC;YACvF,CAAC;YAED,IAAI,MAAM,GAAG,yBAAyB,CAAC;YACvC,MAAM,IAAI,2BAA2B,CAAC;YAEtC,yCAAyC;YACzC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC5B,MAAM,IAAI,4EAA4E,CAAC;gBACvF,MAAM,IAAI,sBAAsB,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;YAC5D,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,qFAAqF,CAAC;gBAChG,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;oBAClC,MAAM,IAAI,OAAO,QAAQ,CAAC,IAAI,MAAM,QAAQ,CAAC,IAAI,KAAK,CAAC;gBACzD,CAAC;gBACD,MAAM,IAAI,IAAI,CAAC;YACjB,CAAC;YAED,MAAM,IAAI,gEAAgE,CAAC;YAE3E,MAAM,IAAI,iBAAiB,CAAC;YAE5B,iBAAiB;YACjB,MAAM,eAAe,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACxD,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,qBAAqB,CAAC;gBAChC,MAAM,IAAI,qBAAqB,CAAC;gBAChC,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,eAAe,CAAC,OAAO,EAAE,EAAE,CAAC;oBACxD,MAAM,IAAI,UAAU,QAAQ,CAAC,IAAI,QAAQ,CAAC;oBAC1C,MAAM,IAAI,4BAA4B,QAAQ,CAAC,IAAI,MAAM,CAAC;oBAC1D,MAAM,IAAI,4BAA4B,QAAQ,CAAC,IAAI,MAAM,CAAC;oBAC1D,MAAM,IAAI,qBAAqB,QAAQ,CAAC,KAAK,KAAK,CAAC;oBACnD,MAAM,IAAI,UAAU,GAAG,GAAG,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;gBACtE,CAAC;gBACD,MAAM,IAAI,SAAS,CAAC;gBACpB,MAAM,IAAI,QAAQ,CAAC;YACrB,CAAC;YAED,eAAe;YACf,MAAM,eAAe,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACxD,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,mBAAmB,CAAC;gBAC9B,MAAM,IAAI,qBAAqB,CAAC;gBAChC,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,eAAe,CAAC,OAAO,EAAE,EAAE,CAAC;oBACxD,MAAM,IAAI,UAAU,QAAQ,CAAC,IAAI,QAAQ,CAAC;oBAC1C,MAAM,IAAI,4BAA4B,QAAQ,CAAC,IAAI,MAAM,CAAC;oBAC1D,MAAM,IAAI,4BAA4B,QAAQ,CAAC,IAAI,MAAM,CAAC;oBAC1D,MAAM,IAAI,qBAAqB,QAAQ,CAAC,KAAK,KAAK,CAAC;oBACnD,MAAM,IAAI,UAAU,GAAG,GAAG,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;gBACtE,CAAC;gBACD,MAAM,IAAI,SAAS,CAAC;gBACpB,MAAM,IAAI,OAAO,CAAC;YACpB,CAAC;YAED,MAAM,IAAI,OAAO,CAAC;YAElB,MAAM,IAAI,oFAAoF,CAAC;YAC/F,MAAM,IAAI,sFAAsF,CAAC;YACjG,MAAM,IAAI,wFAAwF,CAAC;YACnG,MAAM,IAAI,qFAAqF,CAAC;YAEhG,OAAO,MAAM,CAAC;QAChB,CAAC;KACF;CACF,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,174 @@
+import type { Identity, EmailThread, EmailMessage, SmsConversation, SmsMessage, PasswordEntry, SecretEntry, EncryptionMeta } from "./types.js";
+/** Options for constructing a {@link RaviClient}. */
+export interface RaviClientConfig {
+    /** Base URL of the Ravi API (e.g. "https://api.ravi.dev"). */
+    apiUrl: string;
+    /** JWT bearer token for authentication. */
+    token: string;
+    /** Optional refresh token for automatic access token renewal on 401. */
+    refreshToken?: string;
+    /** Optional identity UUID — sets the `X-Ravi-Identity` header on scoped requests. */
+    identityUuid?: string;
+}
+/**
+ * Error thrown when the Ravi API returns a non-OK response.
+ *
+ * Includes the HTTP status code and response body for programmatic handling
+ * (e.g. distinguishing 402 billing errors from 404s).
+ */
+export declare class RaviApiError extends Error {
+    readonly method: string;
+    readonly path: string;
+    readonly status: number;
+    readonly body: string;
+    constructor(method: string, path: string, status: number, body: string);
+}
+/**
+ * Typed HTTP client for the Ravi REST API.
+ *
+ * Handles authentication, identity scoping via `X-Ravi-Identity`, and
+ * provides methods for every Ravi API endpoint. All methods return typed
+ * promises and throw {@link RaviApiError} on non-OK responses.
+ *
+ * @example
+ * ```ts
+ * const client = new RaviClient({ apiUrl: "https://api.ravi.dev", token: "ey..." });
+ * const identities = await client.listIdentities();
+ * client.setIdentity(identities[0].uuid);
+ * const threads = await client.listEmailThreads();
+ * ```
+ */
+export declare class RaviClient {
+    private apiUrl;
+    private token;
+    private refreshToken?;
+    private identityUuid?;
+    private isRefreshing;
+    constructor(config: RaviClientConfig);
+    /**
+     * Set the identity UUID used for scoped requests.
+     *
+     * Once set, all subsequent requests include the `X-Ravi-Identity` header
+     * so the server knows which identity the request is scoped to.
+     */
+    setIdentity(uuid: string): void;
+    /**
+     * Internal helper that executes an authenticated HTTP request against the
+     * Ravi API and returns the parsed JSON response.
+     *
+     * On a 401 response, if a refresh token is available, automatically
+     * attempts to refresh the access token and retries the request once.
+     *
+     * @throws {RaviApiError} When the server returns a non-2xx status code.
+     */
+    private request;
+    /** List all identities belonging to the authenticated user. */
+    listIdentities(): Promise<Identity[]>;
+    /** Create a new identity with the given name. */
+    createIdentity(name: string): Promise<Identity>;
+    /** Get the email address for the current identity. Returns empty string if none. */
+    getEmail(): Promise<string>;
+    /** Get the phone number for the current identity. Returns empty string if none. */
+    getPhone(): Promise<string>;
+    /**
+     * List email threads for the current identity.
+     *
+     * @param unread - When `true`, only return threads with unread messages.
+     */
+    listEmailThreads(unread?: boolean): Promise<EmailThread[]>;
+    /**
+     * Get all messages in an email thread.
+     *
+     * @param threadId - The thread identifier.
+     */
+    getEmailThread(threadId: string): Promise<EmailMessage[]>;
+    /**
+     * List SMS conversations for the current identity.
+     *
+     * @param unread - When `true`, only return conversations with unread messages.
+     */
+    listSmsConversations(unread?: boolean): Promise<SmsConversation[]>;
+    /**
+     * Get all messages in an SMS conversation.
+     *
+     * @param conversationId - The conversation identifier.
+     */
+    listSmsMessages(conversationId: string): Promise<SmsMessage[]>;
+    /**
+     * Compose and send a new email from the current identity's inbox.
+     *
+     * Automatically discovers the identity's inbox ID before sending.
+     *
+     * @param to - Recipient email address.
+     * @param subject - Email subject line.
+     * @param body - HTML body content.
+     * @throws {Error} When the identity has no email inbox provisioned.
+     */
+    composeEmail(to: string, subject: string, body: string): Promise<EmailMessage>;
+    /**
+     * Reply to an existing email message.
+     *
+     * @param messageId - The numeric ID of the message to reply to.
+     * @param body - HTML body content for the reply.
+     * @param replyAll - When `true`, reply to all recipients (default: `false`).
+     */
+    replyToEmail(messageId: number, body: string, replyAll?: boolean): Promise<EmailMessage>;
+    /**
+     * Send an SMS message from the current identity's phone number.
+     *
+     * @param toNumber - Recipient phone number in E.164 format.
+     * @param body - Message text.
+     */
+    sendSms(toNumber: string, body: string): Promise<SmsMessage>;
+    /** List all password entries for the current identity. Fields may be E2E encrypted. */
+    listPasswords(): Promise<PasswordEntry[]>;
+    /** Get a single password entry by UUID. */
+    getPassword(uuid: string): Promise<PasswordEntry>;
+    /**
+     * Create a new password entry.
+     *
+     * @param data - Password fields. `domain` is required; other fields are optional.
+     */
+    createPassword(data: {
+        domain: string;
+        username?: string;
+        password?: string;
+        notes?: string;
+    }): Promise<PasswordEntry>;
+    /** Delete a password entry by UUID. */
+    deletePassword(uuid: string): Promise<void>;
+    /** List all vault secrets for the current identity. */
+    listSecrets(): Promise<SecretEntry[]>;
+    /**
+     * Get a single vault secret by key.
+     *
+     * Uses the `?key=` filter on the list endpoint (backend lookup_field is uuid,
+     * not key). Returns the first match or throws 404-like error.
+     *
+     * @param key - The secret's key name.
+     */
+    getSecret(key: string): Promise<SecretEntry>;
+    /**
+     * Create or update a vault secret.
+     *
+     * @param key - The secret's key name.
+     * @param value - The secret value (will be E2E encrypted by the crypto layer).
+     */
+    setSecret(key: string, value: string): Promise<SecretEntry>;
+    /** Delete a vault secret by UUID. */
+    deleteSecret(uuid: string): Promise<void>;
+    /**
+     * Get the encryption metadata for the current identity.
+     *
+     * Returns the salt, verifier, and public key needed to derive the
+     * E2E encryption key from the user's PIN.
+     */
+    getEncryptionMeta(): Promise<EncryptionMeta>;
+    /** Update (or initialize) the user's encryption metadata. */
+    updateEncryptionMeta(data: {
+        salt?: string;
+        public_key?: string;
+        verifier?: string;
+    }): Promise<EncryptionMeta>;
+}
+//# 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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"}