@sendbird/cli 0.0.0-stage → 0.4.0

package/PROVENANCE.md

@@ -0,0 +1,15 @@
+# Implementation provenance
+
+This separate CLI follows the approved Sendbird Chat alpha scope. Its registry, runner and CLI are implemented here; Dashbird was inspected as an internal design reference for authentication, HTTP requests, profiles, JSON output, inventory auditing and agent distribution.
+
+- Dashbird reference checkout: `dashbird-cli-unified`, commit `11ddbd6` (local checkout, not a release claim).
+- Dashboard baseline: `f29b7c5cfcb87e67aa572f8c5fe9e9dda44fad31`.
+- Exact Dashboard file/symbol/line/hash mappings and discovered axios call sites are in `references/dashboard-inventory.json`.
+- API source and React form source were both inspected. Notable cases: Supergroup path switching, multipart channel/user bodies, metadata upsert, org creation returning `organizations[]`, session cookie names, support case Salesforce-style field names.
+- No Delight role bypass or generated Delight API surface is included.
+
+The first-party CLI is proprietary; see LICENSE. Dependency terms are preserved in NOTICE.md and the upstream packages. Reference repositories do not by themselves establish ownership or redistribution permission. Public distribution remains subject to rights and license review; earlier grants are not revoked by this notice.
+
+SDK extension (`0.2.0-alpha.1`): uses the official `@sendbird/chat` package pinned at 4.22.13, including its Node transport support. SDK method/type mappings are tracked separately in `references/sdk-commands.json`; they are not claimed as Dashboard API wrappers. The worker boundary isolates SDK background timers and keeps diagnostic logs out of CLI data output. [Official authentication](https://sendbird.com/docs/chat/sdk/v4/javascript/application/authenticating-a-user/authentication) and [message documentation](https://sendbird.com/docs/chat/sdk/v4/javascript/message/overview-message) were used alongside the installed declaration files.
+
+The Pro extension keeps SDK mappings separate from Dashboard HTTP provenance. `references/dashboard-inventory.json` records the current Dashboard revision, exact source symbols and hashes of the owned validation/normalization modules. Offline CI checks those hashes; a Dashboard source audit is still a separate check and neither proves deployed Gate routing nor live entitlement. No Bot/GDPR proxy route is inferred from the presence of an internal handler.

package/README.md

@@ -1,3 +1,45 @@
-# Temporary Holding Version
+# Sendbird CLI
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Manage Sendbird apps and Chat from your terminal or AI coding agent.
+
+## Install
+
+```sh
+npm install -g @sendbird/cli
+```
+
+Requires Node.js 22.23.4+ (22.x) or 24.22.1+ (24.x). Supports macOS, Linux and Windows.
+The 0.4 release begins the officially supported release line.
+
+## Get started
+
+```sh
+sendbird setup
+sendbird app list
+sendbird --help
+```
+
+Sign in through your browser and select an organization and app.
+Use `--json` for scripts and `--dry-run` to preview supported changes.
+
+## AI coding agents
+
+Register the bundled Skill for your coding tool:
+
+```sh
+sendbird skills install --agent claude --scope project
+# Or, for Codex:
+sendbird skills install --agent codex --scope project
+```
+
+See the [Claude Code](https://github.com/sendbird/sendbird-cli/blob/main/onboarding/claude-code.md) or [Codex](https://github.com/sendbird/sendbird-cli/blob/main/onboarding/codex.md) setup guide for plugin installation.
+
+## Documentation
+
+- [Command reference](https://github.com/sendbird/sendbird-cli/blob/main/references/commands.md)
+- [Windows setup](https://github.com/sendbird/sendbird-cli/blob/main/docs/windows.md)
+- [Development](https://github.com/sendbird/sendbird-cli/blob/main/docs/development.md)
+- [Release notes](https://github.com/sendbird/sendbird-cli/blob/main/CHANGELOG.md)
+- [Security](https://github.com/sendbird/sendbird-cli/blob/main/SECURITY.md)
+
+Proprietary software. See [LICENSE](https://github.com/sendbird/sendbird-cli/blob/main/LICENSE) and [third-party notices](https://github.com/sendbird/sendbird-cli/blob/main/NOTICE.md).

package/dist/acl.d.ts

@@ -0,0 +1,2 @@
+/** Dashboard levels are hierarchical only inside the same permission namespace. */
+export declare function permissionMatches(granted: string, required: string): boolean;

package/dist/acl.js

@@ -0,0 +1,12 @@
+/** Dashboard levels are hierarchical only inside the same permission namespace. */
+export function permissionMatches(granted, required) {
+    if (granted === required)
+        return true;
+    const g = granted.split("."), r = required.split("."), levels = ["view", "chat", "moderate", "all"];
+    if (g.length !== r.length ||
+        g.slice(0, -1).join(".") !== r.slice(0, -1).join("."))
+        return false;
+    const gi = levels.indexOf(g.at(-1)), ri = levels.indexOf(r.at(-1));
+    return gi >= 0 && ri >= 0 && gi >= ri;
+}
+//# sourceMappingURL=acl.js.map

package/dist/acl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acl.js","sourceRoot":"","sources":["../src/acl.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,QAAgB;IACjE,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAC1B,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,EACvB,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;IAC/C,IACE,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QACrB,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAErD,OAAO,KAAK,CAAC;IACf,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,EAClC,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC;IACjC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;AACxC,CAAC"}

package/dist/billing-plan.d.ts

@@ -0,0 +1,68 @@
+import { z } from "zod";
+import { type Transport } from "./core.js";
+export declare const billingVerificationSchema: z.ZodObject<{
+    change_state: z.ZodEnum<{
+        scheduled: "scheduled";
+        current: "current";
+        not_reflected: "not_reflected";
+    }>;
+    product: z.ZodLiteral<"CHAT">;
+    requested_plan: z.ZodString;
+    mutation_sent: z.ZodLiteral<false>;
+    current_subscription: z.ZodNullable<z.ZodObject<{
+        subscription_name: z.ZodString;
+        apply_date: z.ZodNullable<z.ZodString>;
+        next_billing_date: z.ZodNullable<z.ZodString>;
+        end_date: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    future_subscription: z.ZodNullable<z.ZodObject<{
+        subscription_name: z.ZodString;
+        apply_date: z.ZodNullable<z.ZodString>;
+        next_billing_date: z.ZodNullable<z.ZodString>;
+        end_date: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    next: z.ZodString;
+    next_argv: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const billingHandoffSchema: z.ZodObject<{
+    organization: z.ZodObject<{
+        uid: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    selection_state: z.ZodEnum<{
+        requires_dashboard_review: "requires_dashboard_review";
+        catalog_candidate: "catalog_candidate";
+    }>;
+    reasons: z.ZodArray<z.ZodString>;
+    payment_method: z.ZodString;
+    card_present: z.ZodNullable<z.ZodBoolean>;
+    quote: z.ZodNull;
+    effective_at: z.ZodNull;
+    change_completed: z.ZodLiteral<false>;
+    handoff: z.ZodObject<{
+        url: z.ZodString;
+        required: z.ZodLiteral<true>;
+        instruction: z.ZodString;
+    }, z.core.$strip>;
+    product: z.ZodLiteral<"CHAT">;
+    requested_plan: z.ZodString;
+    mutation_sent: z.ZodLiteral<false>;
+    current_subscription: z.ZodNullable<z.ZodObject<{
+        subscription_name: z.ZodString;
+        apply_date: z.ZodNullable<z.ZodString>;
+        next_billing_date: z.ZodNullable<z.ZodString>;
+        end_date: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    future_subscription: z.ZodNullable<z.ZodObject<{
+        subscription_name: z.ZodString;
+        apply_date: z.ZodNullable<z.ZodString>;
+        next_billing_date: z.ZodNullable<z.ZodString>;
+        end_date: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    next: z.ZodString;
+    next_argv: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/** No quote contract exists in Gate. These commands prepare a web handoff;
+ * they never submit subscribe, start a trial, or collect payment credentials.
+ * runner.ts verifies the authenticated organization and role before calling. */
+export declare function billingPlan(command: string, input: Record<string, unknown>, orgId: string, t: Transport, profileName?: string): Promise<unknown>;

package/dist/billing-plan.js

@@ -0,0 +1,235 @@
+import { shellCommand } from "./shell.js";
+import { z } from "zod";
+import { CliError, encodeSegment, redact, request, } from "./core.js";
+function response(schema, value) {
+    const parsed = schema.safeParse(value);
+    if (!parsed.success)
+        throw new CliError("E_SCHEMA", "Billing response lacks required identity or policy fields; inspect Dashboard", 8);
+    return parsed.data;
+}
+const subscriptionSummary = z
+    .object({
+    subscription_name: z.string(),
+    apply_date: z.string().nullable(),
+    next_billing_date: z.string().nullable(),
+    end_date: z.string().nullable(),
+})
+    .nullable();
+const sharedResult = {
+    product: z.literal("CHAT"),
+    requested_plan: z.string(),
+    mutation_sent: z.literal(false),
+    current_subscription: subscriptionSummary,
+    future_subscription: subscriptionSummary,
+    next: z.string(),
+    next_argv: z.array(z.string()),
+};
+export const billingVerificationSchema = z.object({
+    ...sharedResult,
+    change_state: z.enum(["current", "scheduled", "not_reflected"]),
+});
+export const billingHandoffSchema = z.object({
+    ...sharedResult,
+    organization: z.object({ uid: z.string(), name: z.string() }),
+    selection_state: z.enum(["requires_dashboard_review", "catalog_candidate"]),
+    reasons: z.array(z.string()),
+    payment_method: z.string(),
+    card_present: z.boolean().nullable(),
+    quote: z.null(),
+    effective_at: z.null(),
+    change_completed: z.literal(false),
+    handoff: z.object({
+        url: z.string().url(),
+        required: z.literal(true),
+        instruction: z.string(),
+    }),
+});
+const subscription = z
+    .object({
+    subscription_name: z.string().min(1),
+    subscription_type: z.string().min(1),
+    product: z.literal("CHAT").optional(),
+    is_aws_marketplace: z.boolean().optional(),
+    apply_date: z.string().nullable().optional(),
+    next_billing_date: z.string().nullable().optional(),
+    end_date: z.string().nullable().optional(),
+})
+    .passthrough();
+const infoSchema = z.object({
+    current_subscription: subscription.nullable(),
+    future_subscription: subscription.nullable(),
+});
+const orgSchema = z.object({
+    uid: z.string().min(1),
+    name: z.string().min(1),
+    payment_method: z.enum(["CARD", "WIRE", "MANUAL", "SHOPIFY"]),
+    is_self_serve: z.boolean(),
+    status: z.enum(["ACTIVE", "INACTIVE", "ARCHIVED"]),
+});
+const catalogSchema = z.record(z.string(), z.object({
+    plan: z.object({}).passthrough(),
+    product: z.string().optional(),
+    subscription_name: z.string().optional(),
+    subscription_type: z.string().optional(),
+    billing_cycle_months: z.number().int().nonnegative().optional(),
+}));
+/** No quote contract exists in Gate. These commands prepare a web handoff;
+ * they never submit subscribe, start a trial, or collect payment credentials.
+ * runner.ts verifies the authenticated organization and role before calling. */
+export async function billingPlan(command, input, orgId, t, profileName) {
+    const read = (path, query, allowEmpty = false) => request(t, { method: "GET", path, query, allowEmpty });
+    const info = response(infoSchema, await read("/dashboard_api/billing/subscriptions/info/", {
+        product: "CHAT",
+    }));
+    const plan = String(input.plan);
+    const prefix = [
+        "sendbird",
+        ...(profileName ? ["--profile", profileName] : []),
+        "--org-id",
+        orgId,
+    ];
+    const nextArgv = command === "billing plan verify"
+        ? [...prefix, "billing", "plan", "current"]
+        : [...prefix, "billing", "plan", "verify", "--plan", plan];
+    const nextCommand = shellCommand(nextArgv, /^[a-zA-Z0-9_./:-]+$/);
+    if (command === "billing plan verify") {
+        const state = info.current_subscription?.subscription_name === plan
+            ? "current"
+            : info.future_subscription?.subscription_name === plan
+                ? "scheduled"
+                : "not_reflected";
+        return {
+            product: "CHAT",
+            requested_plan: plan,
+            change_state: state,
+            current_subscription: summary(info.current_subscription),
+            future_subscription: summary(info.future_subscription),
+            // Observing a matching plan is not proof that this CLI caused a change.
+            mutation_sent: false,
+            next: nextCommand,
+            next_argv: nextArgv,
+        };
+    }
+    const org = response(orgSchema, await read(`/dashboard_api/organizations/${encodeSegment(orgId)}/`));
+    if (org.uid !== orgId)
+        throw new CliError("E_CONTEXT", "Billing organization identity does not match the selected organization", 5);
+    if (command === "billing plan change" && input.confirm_org_name !== org.name)
+        throw new CliError("E_CONFIRMATION", "--confirm-org-name must exactly match the organization's current name; inspect billing plan check first", 2);
+    const catalog = response(catalogSchema, await read("/dashboard_api/billing/plans/", { organization_uid: orgId }));
+    if (!Object.hasOwn(catalog, plan))
+        throw new CliError("E_VALIDATION", "Requested plan is not in this organization's catalog; use billing plan list", 2);
+    const selected = catalog[plan];
+    if (selected.subscription_name && selected.subscription_name !== plan)
+        throw new CliError("E_SCHEMA", "Plan catalog identity does not match the requested plan", 8);
+    if (selected.product && selected.product !== "CHAT")
+        throw new CliError("E_VALIDATION", "Requested catalog entry is not a Chat product", 2);
+    const reasons = [];
+    const current = info.current_subscription;
+    if (current?.subscription_type === "SALES_CUSTOM")
+        reasons.push("sales_contract");
+    if (current &&
+        !["SALES_CUSTOM", "SELF_SERVE"].includes(current.subscription_type))
+        reasons.push("subscription_type_requires_review");
+    if (selected.subscription_type === "SALES_CUSTOM")
+        reasons.push("sales_plan");
+    if (current?.is_aws_marketplace)
+        reasons.push("aws_marketplace");
+    // Fail closed on an inconsistent Shopify tuple, rather than bypassing its
+    // external billing path when shop information happens to be absent.
+    if (org.payment_method === "SHOPIFY")
+        reasons.push("shopify_billing");
+    if (org.status !== "ACTIVE")
+        reasons.push("organization_inactive");
+    if (!org.is_self_serve)
+        reasons.push("legacy_organization");
+    if (org.payment_method === "WIRE" || org.payment_method === "MANUAL")
+        reasons.push("managed_payment");
+    if (info.future_subscription)
+        reasons.push("scheduled_subscription");
+    if (current?.end_date && current.subscription_name !== "free_trial")
+        reasons.push("cancellation_scheduled");
+    if (current?.subscription_name === plan)
+        reasons.push("already_current");
+    // Dashboard's picker exposes Starter/Pro families; catalog also contains
+    // support and sales-only entries. A catalog entry alone is not eligibility.
+    // Match Dashboard's TALK_TO_SALES_PLAN_NAMES, including 50K monthly/annual.
+    const salesPlan = [
+        "enterprise",
+        "plan_a_50k",
+        "plan_a_50k_annual",
+        "plan_a_100k",
+        "plan_b_50k",
+        "plan_b_50k_annual",
+        "plan_b_100k",
+    ].includes(plan);
+    if (salesPlan && !reasons.includes("sales_plan"))
+        reasons.push("sales_plan");
+    const selfServePlan = /^(?:plan_a_1k|plan_[ab]_(?:5|10|25)k(?:_annual)?)$/.test(plan);
+    if (!selfServePlan && !salesPlan)
+        reasons.push("dashboard_selection_required");
+    let cardPresent = null;
+    if (org.payment_method === "CARD" && reasons.length === 0) {
+        const card = response(z.union([
+            z.object({}).strict(),
+            z
+                .object({
+                brand: z.string().min(1),
+                last4: z.string().regex(/^\d{4}$/),
+            })
+                .passthrough(),
+            z.null(),
+        ]), await read(`/dashboard_api/organizations/${encodeSegment(orgId)}/card/`, undefined, true));
+        cardPresent = card !== null && "brand" in card;
+        if (!cardPresent)
+            reasons.push("payment_method_required");
+    }
+    // Never copy Shopify URLs or other untrusted server links into an agent
+    // handoff. Dashboard performs channel-specific navigation after login.
+    const dashboard = t.env === "staging"
+        ? "https://dashboard-dev.sendbird.com"
+        : "https://dashboard.sendbird.com";
+    const destination = reasons.some((r) => ["sales_contract", "sales_plan", "aws_marketplace"].includes(r))
+        ? "/settings/contact_us"
+        : reasons.includes("shopify_billing")
+            ? "/settings/general"
+            : "/settings/general/plans/chat";
+    return redact({
+        product: "CHAT",
+        requested_plan: plan,
+        organization: { uid: org.uid, name: org.name },
+        current_subscription: summary(current),
+        future_subscription: summary(info.future_subscription),
+        selection_state: reasons.length
+            ? "requires_dashboard_review"
+            : "catalog_candidate",
+        reasons,
+        payment_method: org.payment_method,
+        card_present: cardPresent,
+        quote: null,
+        effective_at: null,
+        handoff: {
+            url: `${dashboard}${destination}`,
+            required: true,
+            instruction: destination === "/settings/contact_us"
+                ? "Sign in to the same organization and request a plan review through Dashboard. This contract or target plan requires Sales or marketplace handling."
+                : destination === "/settings/general"
+                    ? "Sign in to the same organization and follow Dashboard's Shopify billing link. Review and confirm in the external billing channel."
+                    : "Sign in to the same organization, select the requested Chat plan, review the price and effective date, and confirm in Dashboard.",
+        },
+        mutation_sent: false,
+        change_completed: false,
+        next: nextCommand,
+        next_argv: nextArgv,
+    });
+}
+function summary(value) {
+    if (!value)
+        return null;
+    return {
+        subscription_name: value.subscription_name,
+        apply_date: value.apply_date ?? null,
+        next_billing_date: value.next_billing_date ?? null,
+        end_date: value.end_date ?? null,
+    };
+}
+//# sourceMappingURL=billing-plan.js.map

package/dist/billing-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-plan.js","sourceRoot":"","sources":["../src/billing-plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,QAAQ,EACR,aAAa,EACb,MAAM,EACN,OAAO,GAER,MAAM,WAAW,CAAC;AAEnB,SAAS,QAAQ,CAAI,MAAoB,EAAE,KAAc;IACvD,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,OAAO;QACjB,MAAM,IAAI,QAAQ,CAChB,UAAU,EACV,8EAA8E,EAC9E,CAAC,CACF,CAAC;IACJ,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AACD,MAAM,mBAAmB,GAAG,CAAC;KAC1B,MAAM,CAAC;IACN,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC7B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC;KACD,QAAQ,EAAE,CAAC;AACd,MAAM,YAAY,GAAG;IACnB,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IAC1B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAC/B,oBAAoB,EAAE,mBAAmB;IACzC,mBAAmB,EAAE,mBAAmB;IACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC/B,CAAC;AACF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,GAAG,YAAY;IACf,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;CAChE,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,GAAG,YAAY;IACf,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IAC7D,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,2BAA2B,EAAE,mBAAmB,CAAC,CAAC;IAC3E,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC5B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACpC,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE;IACf,YAAY,EAAE,CAAC,CAAC,IAAI,EAAE;IACtB,gBAAgB,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;QACrB,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;QACzB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;KACxB,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,CAAC;KACnB,MAAM,CAAC;IACN,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE;IACrC,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC1C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC5C,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACnD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC3C,CAAC;KACD,WAAW,EAAE,CAAC;AACjB,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,oBAAoB,EAAE,YAAY,CAAC,QAAQ,EAAE;IAC7C,mBAAmB,EAAE,YAAY,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAC;AACH,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IACzB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC7D,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE;IAC1B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;CACnD,CAAC,CAAC;AACH,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAC5B,CAAC,CAAC,MAAM,EAAE,EACV,CAAC,CAAC,MAAM,CAAC;IACP,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxC,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;CAChE,CAAC,CACH,CAAC;AAEF;;gFAEgF;AAChF,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAe,EACf,KAA8B,EAC9B,KAAa,EACb,CAAY,EACZ,WAAoB;IAEpB,MAAM,IAAI,GAAG,CACX,IAAY,EACZ,KAA+B,EAC/B,UAAU,GAAG,KAAK,EAClB,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,QAAQ,CACnB,UAAU,EACV,MAAM,IAAI,CAAC,4CAA4C,EAAE;QACvD,OAAO,EAAE,MAAM;KAChB,CAAC,CACH,CAAC;IACF,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG;QACb,UAAU;QACV,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,UAAU;QACV,KAAK;KACN,CAAC;IACF,MAAM,QAAQ,GACZ,OAAO,KAAK,qBAAqB;QAC/B,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC;QAC3C,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC/D,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,qBAAqB,CAAC,CAAC;IAClE,IAAI,OAAO,KAAK,qBAAqB,EAAE,CAAC;QACtC,MAAM,KAAK,GACT,IAAI,CAAC,oBAAoB,EAAE,iBAAiB,KAAK,IAAI;YACnD,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,IAAI,CAAC,mBAAmB,EAAE,iBAAiB,KAAK,IAAI;gBACpD,CAAC,CAAC,WAAW;gBACb,CAAC,CAAC,eAAe,CAAC;QACxB,OAAO;YACL,OAAO,EAAE,MAAM;YACf,cAAc,EAAE,IAAI;YACpB,YAAY,EAAE,KAAK;YACnB,oBAAoB,EAAE,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC;YACxD,mBAAmB,EAAE,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC;YACtD,wEAAwE;YACxE,aAAa,EAAE,KAAK;YACpB,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE,QAAQ;SACpB,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,QAAQ,CAClB,SAAS,EACT,MAAM,IAAI,CAAC,gCAAgC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CACpE,CAAC;IACF,IAAI,GAAG,CAAC,GAAG,KAAK,KAAK;QACnB,MAAM,IAAI,QAAQ,CAChB,WAAW,EACX,wEAAwE,EACxE,CAAC,CACF,CAAC;IACJ,IAAI,OAAO,KAAK,qBAAqB,IAAI,KAAK,CAAC,gBAAgB,KAAK,GAAG,CAAC,IAAI;QAC1E,MAAM,IAAI,QAAQ,CAChB,gBAAgB,EAChB,yGAAyG,EACzG,CAAC,CACF,CAAC;IAEJ,MAAM,OAAO,GAAG,QAAQ,CACtB,aAAa,EACb,MAAM,IAAI,CAAC,+BAA+B,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC,CACzE,CAAC;IACF,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC;QAC/B,MAAM,IAAI,QAAQ,CAChB,cAAc,EACd,6EAA6E,EAC7E,CAAC,CACF,CAAC;IAEJ,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,QAAQ,CAAC,iBAAiB,IAAI,QAAQ,CAAC,iBAAiB,KAAK,IAAI;QACnE,MAAM,IAAI,QAAQ,CAChB,UAAU,EACV,yDAAyD,EACzD,CAAC,CACF,CAAC;IACJ,IAAI,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,KAAK,MAAM;QACjD,MAAM,IAAI,QAAQ,CAChB,cAAc,EACd,+CAA+C,EAC/C,CAAC,CACF,CAAC;IACJ,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,oBAAoB,CAAC;IAC1C,IAAI,OAAO,EAAE,iBAAiB,KAAK,cAAc;QAC/C,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACjC,IACE,OAAO;QACP,CAAC,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC;QAEnE,OAAO,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IACpD,IAAI,QAAQ,CAAC,iBAAiB,KAAK,cAAc;QAAE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC9E,IAAI,OAAO,EAAE,kBAAkB;QAAE,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACjE,0EAA0E;IAC1E,oEAAoE;IACpE,IAAI,GAAG,CAAC,cAAc,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACtE,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACnE,IAAI,CAAC,GAAG,CAAC,aAAa;QAAE,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAC5D,IAAI,GAAG,CAAC,cAAc,KAAK,MAAM,IAAI,GAAG,CAAC,cAAc,KAAK,QAAQ;QAClE,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAClC,IAAI,IAAI,CAAC,mBAAmB;QAAE,OAAO,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACrE,IAAI,OAAO,EAAE,QAAQ,IAAI,OAAO,CAAC,iBAAiB,KAAK,YAAY;QACjE,OAAO,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACzC,IAAI,OAAO,EAAE,iBAAiB,KAAK,IAAI;QAAE,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAEzE,yEAAyE;IACzE,4EAA4E;IAC5E,4EAA4E;IAC5E,MAAM,SAAS,GAAG;QAChB,YAAY;QACZ,YAAY;QACZ,mBAAmB;QACnB,aAAa;QACb,YAAY;QACZ,mBAAmB;QACnB,aAAa;KACd,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjB,IAAI,SAAS,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC7E,MAAM,aAAa,GACjB,oDAAoD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClE,IAAI,CAAC,aAAa,IAAI,CAAC,SAAS;QAC9B,OAAO,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC/C,IAAI,WAAW,GAAmB,IAAI,CAAC;IACvC,IAAI,GAAG,CAAC,cAAc,KAAK,MAAM,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,QAAQ,CACnB,CAAC,CAAC,KAAK,CAAC;YACN,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;YACrB,CAAC;iBACE,MAAM,CAAC;gBACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBACxB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;aACnC,CAAC;iBACD,WAAW,EAAE;YAChB,CAAC,CAAC,IAAI,EAAE;SACT,CAAC,EACF,MAAM,IAAI,CACR,gCAAgC,aAAa,CAAC,KAAK,CAAC,QAAQ,EAC5D,SAAS,EACT,IAAI,CACL,CACF,CAAC;QACF,WAAW,GAAG,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,IAAI,CAAC;QAC/C,IAAI,CAAC,WAAW;YAAE,OAAO,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IAC5D,CAAC;IACD,wEAAwE;IACxE,uEAAuE;IACvE,MAAM,SAAS,GACb,CAAC,CAAC,GAAG,KAAK,SAAS;QACjB,CAAC,CAAC,oCAAoC;QACtC,CAAC,CAAC,gCAAgC,CAAC;IACvC,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACrC,CAAC,gBAAgB,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAChE;QACC,CAAC,CAAC,sBAAsB;QACxB,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YACnC,CAAC,CAAC,mBAAmB;YACrB,CAAC,CAAC,8BAA8B,CAAC;IACrC,OAAO,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM;QACf,cAAc,EAAE,IAAI;QACpB,YAAY,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE;QAC9C,oBAAoB,EAAE,OAAO,CAAC,OAAO,CAAC;QACtC,mBAAmB,EAAE,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC;QACtD,eAAe,EAAE,OAAO,CAAC,MAAM;YAC7B,CAAC,CAAC,2BAA2B;YAC7B,CAAC,CAAC,mBAAmB;QACvB,OAAO;QACP,cAAc,EAAE,GAAG,CAAC,cAAc;QAClC,YAAY,EAAE,WAAW;QACzB,KAAK,EAAE,IAAI;QACX,YAAY,EAAE,IAAI;QAClB,OAAO,EAAE;YACP,GAAG,EAAE,GAAG,SAAS,GAAG,WAAW,EAAE;YACjC,QAAQ,EAAE,IAAI;YACd,WAAW,EACT,WAAW,KAAK,sBAAsB;gBACpC,CAAC,CAAC,oJAAoJ;gBACtJ,CAAC,CAAC,WAAW,KAAK,mBAAmB;oBACnC,CAAC,CAAC,mIAAmI;oBACrI,CAAC,CAAC,kIAAkI;SAC3I;QACD,aAAa,EAAE,KAAK;QACpB,gBAAgB,EAAE,KAAK;QACvB,IAAI,EAAE,WAAW;QACjB,SAAS,EAAE,QAAQ;KACpB,CAAC,CAAC;AACL,CAAC;AACD,SAAS,OAAO,CAAC,KAA0C;IACzD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO;QACL,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;QAC1C,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI;QACpC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,IAAI,IAAI;QAClD,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;KACjC,CAAC;AACJ,CAAC"}

package/dist/browser.d.ts

@@ -0,0 +1 @@
+export declare function openBrowser(url: string): void;

package/dist/browser.js

@@ -0,0 +1,20 @@
+/** Browser launch is best effort: the caller always prints the same URL. */
+import { spawn } from "node:child_process";
+import { powershell } from "./windows.js";
+export function openBrowser(url) {
+    if (new URL(url).protocol !== "https:")
+        return;
+    if (process.platform === "win32") {
+        try {
+            powershell(`$u=[Uri]$r.url; if($u.Scheme -ne 'https'){throw 'Expected HTTPS'}; $p=New-Object Diagnostics.ProcessStartInfo; $p.FileName=$u.AbsoluteUri; $p.UseShellExecute=$true; [Diagnostics.Process]::Start($p) | Out-Null`, { url });
+        }
+        catch {
+            /* The printed URL remains available for manual opening. */
+        }
+        return;
+    }
+    const child = spawn(process.platform === "darwin" ? "open" : "xdg-open", [url], { stdio: "ignore" });
+    child.on("error", () => { });
+    child.unref();
+}
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO;IAC/C,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,UAAU,CACR,kNAAkN,EAClN,EAAE,GAAG,EAAE,CACR,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,2DAA2D;QAC7D,CAAC;QACD,OAAO;IACT,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CACjB,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,EACnD,CAAC,GAAG,CAAC,EACL,EAAE,KAAK,EAAE,QAAQ,EAAE,CACpB,CAAC;IACF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC5B,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC"}

package/dist/calls-catalog.d.ts

@@ -0,0 +1,79 @@
+import { z } from "zod";
+import type { Definition } from "./catalog.js";
+export declare const pushTypes: readonly ["apns_voip", "calls_apns_remote", "fcm_voip", "huawei_voip"];
+export declare const relayMethodDescription = "Direct calls: stun&turn tries direct P2P/STUN first and falls back to TURN relay; turn uses TURN server relay only. Direct-call cloud recording prevents relay changes.";
+export declare const callsActivationStateSchema: z.ZodObject<{
+    app_id: z.ZodString;
+    is_calls_enabled: z.ZodNullable<z.ZodBoolean>;
+    calls_flag_source: z.ZodEnum<{
+        unknown: "unknown";
+        is_calls_enabled: "is_calls_enabled";
+        "attrs.sendbird_calls.enabled": "attrs.sendbird_calls.enabled";
+        conflict: "conflict";
+    }>;
+    push_enabled: z.ZodNullable<z.ZodBoolean>;
+    region: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const callsDefinitions: Definition[];
+export declare const pushRecord: z.ZodObject<{
+    id: z.ZodString;
+    push_type: z.ZodOptional<z.ZodString>;
+    is_sandbox: z.ZodOptional<z.ZodBoolean>;
+    apns_env_cert_type: z.ZodOptional<z.ZodString>;
+    apns_expiration: z.ZodOptional<z.ZodNumber>;
+    apns_name: z.ZodOptional<z.ZodString>;
+    apns_type: z.ZodOptional<z.ZodString>;
+    apns_key_id: z.ZodOptional<z.ZodString>;
+    apns_team_id: z.ZodOptional<z.ZodString>;
+    content_available: z.ZodOptional<z.ZodBoolean>;
+    mutable_content: z.ZodOptional<z.ZodBoolean>;
+    has_unread_count_badge: z.ZodOptional<z.ZodNumber>;
+    push_sound: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    project_id: z.ZodOptional<z.ZodString>;
+    private_key_id: z.ZodOptional<z.ZodString>;
+    use_v1_api: z.ZodOptional<z.ZodBoolean>;
+    created_at: z.ZodOptional<z.ZodNumber>;
+    huawei_app_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const callsPushListSchema: z.ZodObject<{
+    push_configurations: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        push_type: z.ZodOptional<z.ZodString>;
+        is_sandbox: z.ZodOptional<z.ZodBoolean>;
+        apns_env_cert_type: z.ZodOptional<z.ZodString>;
+        apns_expiration: z.ZodOptional<z.ZodNumber>;
+        apns_name: z.ZodOptional<z.ZodString>;
+        apns_type: z.ZodOptional<z.ZodString>;
+        apns_key_id: z.ZodOptional<z.ZodString>;
+        apns_team_id: z.ZodOptional<z.ZodString>;
+        content_available: z.ZodOptional<z.ZodBoolean>;
+        mutable_content: z.ZodOptional<z.ZodBoolean>;
+        has_unread_count_badge: z.ZodOptional<z.ZodNumber>;
+        push_sound: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        project_id: z.ZodOptional<z.ZodString>;
+        private_key_id: z.ZodOptional<z.ZodString>;
+        use_v1_api: z.ZodOptional<z.ZodBoolean>;
+        created_at: z.ZodOptional<z.ZodNumber>;
+        huawei_app_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    total_count: z.ZodOptional<z.ZodNumber>;
+    next: z.ZodOptional<z.ZodString>;
+    prev: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const pushBody: z.ZodObject<{
+    format: z.ZodOptional<z.ZodEnum<{
+        p8: "p8";
+        p12: "p12";
+    }>>;
+    environment: z.ZodOptional<z.ZodEnum<{
+        production: "production";
+        development: "development";
+    }>>;
+    apns_bundle_id: z.ZodOptional<z.ZodString>;
+    apns_key_id: z.ZodOptional<z.ZodString>;
+    apns_team_id: z.ZodOptional<z.ZodString>;
+    apns_cert_password: z.ZodOptional<z.ZodString>;
+    huawei_app_id: z.ZodOptional<z.ZodString>;
+    huawei_app_secret: z.ZodOptional<z.ZodString>;
+    push_sound: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;