@beryl-so/cli 0.17.0 → 0.21.4

package/dist/commands/inboxes.js

@@ -1,145 +0,0 @@
-import { extractCode } from "../email-extract.js";
-import { dim, green } from "../output.js";
-import { arg, flagBool, flagNum, flagStr } from "./util.js";
-export const inboxCommands = [
-    {
-        name: "inbox create",
-        summary: "Mint an email inbox that Beryl receives mail for",
-        groupSummary: "Email inboxes for testing flows that send mail — signups, OTPs, receipts.",
-        description: "Creates a receiving address under Beryl's inbound email domain and returns it. " +
-            "Use it wherever a test needs a real, readable mailbox — e.g. as the --email for " +
-            "`beryl signup`, then read the code back with `beryl inbox read --extract-code`. " +
-            "Pass --permanent to mint the workspace's single permanent mailbox (no TTL).",
-        scope: "workspace",
-        flags: [
-            {
-                name: "permanent",
-                type: "boolean",
-                description: "Mint the workspace's permanent mailbox (no TTL); one per workspace",
-            },
-            {
-                name: "ttl-hours",
-                type: "number",
-                description: "Hours before the inbox expires and stops receiving (1-168, default 24; ignored with --permanent)",
-            },
-            { name: "project", type: "string", description: "Attach the inbox to a project id" },
-        ],
-        examples: [
-            "beryl inbox create --json",
-            "beryl inbox create --ttl-hours 2",
-            "beryl inbox create --permanent",
-        ],
-        async run(ctx, input) {
-            const ws = await ctx.requireWorkspace(input);
-            const inbox = (await ctx.client.post(`/workspaces/${ws}/inboxes`, {
-                ttl_hours: flagBool(input, "permanent") ? null : (flagNum(input, "ttl-hours") ?? 24),
-                project_id: flagStr(input, "project") ?? null,
-            }));
-            return {
-                data: inbox,
-                human: `${green("Created")} inbox ${inbox.id}\n\n  ${inbox.address}\n\n` +
-                    dim(`Read it with: beryl inbox read ${inbox.id}`),
-            };
-        },
-    },
-    {
-        name: "inbox list",
-        summary: "List the workspace's inboxes, newest first",
-        description: "Every inbox the workspace has minted with `beryl inbox create`. Expired inboxes " +
-            "stop receiving and are hard-deleted by a background sweep, so they drop off " +
-            "this list shortly after their TTL. Pass --permanent for just the permanent mailbox.",
-        scope: "workspace",
-        flags: [
-            {
-                name: "permanent",
-                type: "boolean",
-                description: "Only the workspace's permanent mailbox (no TTL, not run/project scoped)",
-            },
-        ],
-        async run(ctx, input) {
-            const ws = await ctx.requireWorkspace(input);
-            const query = flagBool(input, "permanent") ? { permanent: true } : undefined;
-            return { data: await ctx.client.get(`/workspaces/${ws}/inboxes`, query) };
-        },
-    },
-    {
-        name: "inbox delete",
-        summary: "Delete an inbox and every email it has received",
-        scope: "workspace",
-        args: [{ name: "inbox-id", description: "Inbox id from `beryl inbox create`", required: true }],
-        flags: [{ name: "force", type: "boolean", description: "Skip the confirmation prompt" }],
-        async run(ctx, input) {
-            const ws = await ctx.requireWorkspace(input);
-            const id = arg(input, "inbox-id");
-            await ctx.confirm(`Delete inbox ${id} and its emails?`, flagBool(input, "force"));
-            await ctx.client.del(`/workspaces/${ws}/inboxes/${id}`);
-            return { human: "Deleted." };
-        },
-    },
-    {
-        name: "inbox read",
-        summary: "Read the latest email from an inbox (waits for one to arrive)",
-        description: "Waits up to --timeout-s for a matching email and returns it (one blocking request; " +
-            "the server caps the wait at 50s — re-run to keep waiting). With --extract-code, " +
-            "also pulls the one-time code (4-8 digits) out of the body/subject — handy for " +
-            "completing `beryl login --email <addr> --code <code>` unattended. Exits non-zero " +
-            "if nothing arrives before the timeout.",
-        scope: "workspace",
-        args: [{ name: "inbox-id", description: "Inbox id from `beryl inbox create`", required: true }],
-        flags: [
-            {
-                name: "timeout-s",
-                type: "number",
-                description: "Seconds to wait for a matching email (0 = don't wait; max 50, default 30)",
-            },
-            { name: "since", type: "string", description: "Only emails received after this ISO timestamp" },
-            { name: "from-contains", type: "string", description: "Only emails whose sender contains this" },
-            {
-                name: "subject-contains",
-                type: "string",
-                description: "Only emails whose subject contains this",
-            },
-            {
-                name: "extract-code",
-                type: "boolean",
-                description: "Also return the one-time code found in the email as `code`",
-            },
-        ],
-        examples: [
-            "beryl inbox read ibx_123 --timeout-s 45 --json",
-            "beryl inbox read ibx_123 --subject-contains code --extract-code --json",
-        ],
-        async run(ctx, input) {
-            const ws = await ctx.requireWorkspace(input);
-            const email = (await ctx.client.get(`/workspaces/${ws}/inboxes/${arg(input, "inbox-id")}/emails/latest`, {
-                timeout_s: flagNum(input, "timeout-s"),
-                since: flagStr(input, "since"),
-                from_contains: flagStr(input, "from-contains"),
-                subject_contains: flagStr(input, "subject-contains"),
-            }));
-            if (!flagBool(input, "extract-code"))
-                return { data: email };
-            return { data: { ...email, code: extractCode(email) } };
-        },
-    },
-    {
-        name: "inbox emails",
-        summary: "List the emails an inbox has received",
-        scope: "workspace",
-        args: [{ name: "inbox-id", description: "Inbox id from `beryl inbox create`", required: true }],
-        flags: [
-            { name: "since", type: "string", description: "Only emails received after this ISO timestamp" },
-            {
-                name: "limit",
-                type: "number",
-                description: "Return only the most recent N emails (newest first)",
-            },
-        ],
-        async run(ctx, input) {
-            const ws = await ctx.requireWorkspace(input);
-            return {
-                data: await ctx.client.get(`/workspaces/${ws}/inboxes/${arg(input, "inbox-id")}/emails`, { since: flagStr(input, "since"), limit: flagNum(input, "limit") }),
-            };
-        },
-    },
-];