@madewithremy/admin 0.1.51 → 0.1.53

package/dist/prod.js

@@ -1023,7 +1023,7 @@ async function dashboardLive(ctx) {
     "GET",
     `/_internal/v2/apps/${ctx.appId}/dashboard`
   );
-  return dashboard.liveRelease;
+  return dashboard.liveRelease ? { ...dashboard.liveRelease, primaryUrl: dashboard.primaryUrl } : null;
 }
 async function primaryUrl(ctx) {
   const dashboard = await call(
@@ -1041,7 +1041,8 @@ function summarizeRelease(release) {
     status: release.status,
     buildDurationMs: release.buildDurationMs ?? null,
     publishedAt: release.publishedAt ?? null,
-    ...release.previewUrl ? { previewUrl: release.previewUrl } : {}
+    ...release.previewUrl ? { previewUrl: release.previewUrl } : {},
+    ...release.primaryUrl ? { primaryUrl: release.primaryUrl } : {}
   };
   const readers = (release.dataSources ?? []).filter((d) => d.reader);
   if (readers.length > 0 && release.status === "live") {
@@ -1285,7 +1286,7 @@ var releasesHelp = `remy-admin releases \u2014 View and monitor releases.
 Subcommands:
   list      List releases, newest first (--limit N, default 20, max 100)
   get       Get full details of a specific release
-  current   Get the currently live release
+  current   Get the currently live release, with the address it's served on
   status    Check a release's status by id (optionally poll until complete)
   wait      Wait for the release built from a commit to go live
 
@@ -1298,8 +1299,11 @@ Usage:
 
 'releases wait' is the "publish and wait until live" primitive. After a
 'git push', run it to block until the pushed commit's release is terminal.
-A push to a non-default branch resolves to status 'preview' and the result
-carries 'previewUrl' \u2014 the gated URL that build is reachable at.
+A push to the default branch that goes live carries 'primaryUrl', the
+address the app is served on (its custom domain, else its subdomain, else
+its id's own host), which 'releases current' also returns. A push to a
+non-default branch resolves to status 'preview' and the result carries
+'previewUrl' \u2014 the gated URL that build is reachable at.
 --commit defaults to the workspace HEAD; abbreviated SHAs (7+ hex chars,
 e.g. from push output) are accepted. It prints one JSON object and sets
 the exit code so you can branch on $? without parsing:
@@ -2008,6 +2012,12 @@ Usage:
   remy-admin domains zone add acmebakery.com --type TXT --host @ --answer "google-site-verification=abc"
 
 Notes:
+  - 'check' says why a subdomain isn't available: reason 'reserved' (the
+    platform's own, never any app's: offer a different name), 'taken' (another
+    app has it, freed only from that app) or 'invalid' (not 1 to 63 letters,
+    digits and hyphens, or shaped like an app's ID). 'set' refuses the same
+    names, with subdomain_not_allowed (reserved or invalid) or unavailable
+    (taken), and says which.
   - 'add' with an apex (e.g. acme.com) auto-creates the www.apex pair and
     returns both. 'remove' on an apex also removes its paired www.
   - 'list'/'records'/'status' read a CF-synced cache that can be up to ~5
@@ -3179,7 +3189,7 @@ Notes:
   - '--app <appId>' targets another app in the same workspace. Every app there is reachable
     with this credential, so it is a targeting flag: the issue lands in THAT app's tracker,
     and 'originAppId' on the row records that this app filed it. Cross-reference it in prose
-    as 'app#42'.
+    as 'app#42'. 'remy-admin apps list --search <name>' finds another app's id by its name.
   - 'list' shows what was filed IN an app; 'filed' shows what an app sent OUT to others \u2014
     the whole fan-out in one call instead of one call per app.
   - '--label' repeats ('--label a --label b') or takes a comma-separated list ('--label a,b').
@@ -3196,6 +3206,82 @@ Examples:
   remy-admin issues comment 42 "Fixed in the latest release."
   remy-admin issues close 42 --comment "Already fixed in v3 \u2014 no change needed."`;
 
+// src/ops/apps.ts
+var PAGE_SIZE = 500;
+async function list9(ctx, params = {}) {
+  const words = (params.search ?? "").toLowerCase().split(/\s+/).filter(Boolean);
+  const apps = [];
+  let cursor;
+  while (true) {
+    const page = await call(
+      ctx,
+      "GET",
+      `/_internal/v2/apps${qs({ status: params.status, limit: PAGE_SIZE, cursor })}`
+    );
+    for (const app of page.apps) {
+      const text = `${app.name} ${app.customSubdomain ?? ""}`.toLowerCase();
+      if (words.every((word) => text.includes(word))) {
+        apps.push({
+          appId: app.appId,
+          name: app.name,
+          subdomain: app.customSubdomain,
+          isPublished: app.isPublished,
+          lastDeployedAt: app.lastDeployedAt,
+          createdBy: app.createdBy.name
+        });
+      }
+    }
+    if (!page.nextCursor) {
+      return { apps };
+    }
+    cursor = page.nextCursor;
+  }
+}
+
+// src/commands/apps.ts
+var appsSpecs = {
+  "apps list": {
+    usage: "Usage: remy-admin apps list [--search <words>] [--status draft|published]",
+    flags: {
+      search: { type: "string" },
+      status: { type: "string", choices: ["draft", "published"] }
+    }
+  }
+};
+async function appsList(ctx, a) {
+  out(
+    await list9(ctx, {
+      search: a.str("search"),
+      status: a.str("status")
+    })
+  );
+}
+var appsHandlers = {
+  "apps list": appsList
+};
+var appsHelp = `remy-admin apps \u2014 The apps in this app's workspace.
+
+Subcommands:
+  list   List the workspace's apps, last active first, with their ids
+
+Usage:
+  remy-admin apps list [--search <words>] [--status draft|published]
+
+Notes:
+  - Lists every published app in the workspace, and your own drafts (another
+    member's draft isn't listed). This app is in it too.
+  - Each app has appId, name, subdomain (null if it has none), isPublished,
+    lastDeployedAt and createdBy. Its appId is what '--app' takes elsewhere,
+    as in 'issues create --app <appId>'.
+  - '--search' keeps the apps whose name or subdomain contains every word, in
+    any case. When the user names an app, search for it rather than asking for
+    its id; when more than one matches, ask which.
+
+Examples:
+  remy-admin apps list
+  remy-admin apps list --search "marketing site"
+  remy-admin apps list --status published`;
+
 // src/ops/prerender.ts
 function pages(ctx, params = {}) {
   return call(
@@ -3808,7 +3894,7 @@ async function waitForCandidate(ctx, params) {
   const timeoutMs = params.timeoutMs ?? DEFAULT_WAIT_TIMEOUT_MS;
   const outcome = await pollUntil(
     async () => {
-      const { dataSources } = await list9(ctx);
+      const { dataSources } = await list10(ctx);
       const source = dataSources.find((s) => s.slug === params.slug);
       if (!source) {
         throw new Error(`Data source "${params.slug}" not found.`);
@@ -3890,7 +3976,7 @@ async function allDocuments(ctx, params) {
   }
   return out2;
 }
-function list9(ctx) {
+function list10(ctx) {
   return call(ctx, "GET", base(ctx.appId));
 }
 function search2(ctx, params) {
@@ -4009,7 +4095,7 @@ async function waitForMove(ctx, params) {
   const timeoutMs = params.timeoutMs ?? DEFAULT_WAIT_TIMEOUT_MS;
   const outcome = await pollUntil(
     async () => {
-      const { dataSources } = await list9(ctx);
+      const { dataSources } = await list10(ctx);
       const source2 = dataSources.find((s) => s.slug === params.slug);
       if (!source2) {
         throw new Error(`Data source "${params.slug}" not found.`);
@@ -4210,7 +4296,7 @@ async function uploadManifest(ctx, params) {
   await uploadDirect(token.upload, params.content, "manifest.jsonl");
   return { key: token.key };
 }
-function list10(ctx, params) {
+function list11(ctx, params) {
   return call(
     ctx,
     "GET",
@@ -4649,7 +4735,7 @@ async function waitForHydration(ctx, params) {
   const timeoutMs = params.timeoutMs ?? DEFAULT_WAIT_TIMEOUT_MS3;
   const outcome = await pollUntil(
     async () => {
-      const { dataSources } = await list9(ctx);
+      const { dataSources } = await list10(ctx);
       const source2 = dataSources.find((s) => s.slug === params.slug);
       if (!source2) {
         throw new Error(`Data source "${params.slug}" not found.`);
@@ -5626,7 +5712,7 @@ async function jobsStart(ctx, a) {
 }
 async function jobsList(ctx, a) {
   const slug = a.str("source");
-  out(await list10(ctx, slug ? { slug } : void 0));
+  out(await list11(ctx, slug ? { slug } : void 0));
 }
 async function jobsStatus(ctx, a) {
   const id = a.req("id");
@@ -6643,7 +6729,7 @@ async function dataSourcesAdd(ctx, a) {
   });
 }
 async function dataSourcesList(ctx) {
-  out(await list9(ctx));
+  out(await list10(ctx));
 }
 async function dataSourcesStatus(ctx, a) {
   const slug = sourceOf(a);
@@ -6662,7 +6748,7 @@ async function dataSourcesStatus(ctx, a) {
     });
     return;
   }
-  const { dataSources: sources2 } = await list9(ctx);
+  const { dataSources: sources2 } = await list10(ctx);
   const source = sources2.find((s) => s.slug === slug);
   if (!source) {
     out({ dataSource: slug, exists: false });
@@ -7525,7 +7611,7 @@ Subcommands:
   numbers list      The app's dedicated phone number(s) and their status
   numbers search    Search available US numbers by area code / locality
   numbers buy       Buy + attach a dedicated number ($1/month \u2014 confirm with the user first)
-  numbers release   Release the number (permanent \u2014 the rental stops, no refund, ~15-day carrier quarantine)
+  numbers release   Release a number (permanent \u2014 the rental stops, no refund, ~15-day carrier quarantine)
   numbers set-name  Set/clear the outbound caller-ID display name (CNAM)
   sessions list     Call log (web, phone-out, phone-in), newest first
   sessions get      One session with full transcript and cost breakdown
@@ -7549,9 +7635,11 @@ Examples:
 
 Notes:
   Buying a number starts a recurring $1/month workspace charge \u2014 never run
-  'numbers buy' without the user's explicit confirmation. The dedicated number
-  is both the outbound caller ID for voice.call() and the app's inbound line
-  (inbound calls answer the LIVE release's voice agent). A 'pending' number
+  'numbers buy' without the user's explicit confirmation. An app can hold
+  several numbers (one per tenant, say), up to its workspace's limit
+  (phone_number_limit_reached past it; support raises it). Each is an inbound
+  line (answered by the LIVE release's voice agent) and a caller ID for
+  voice.call(), which takes 'from' once there are several. A 'pending' number
   usually activates within seconds \u2014 poll 'numbers list'. The display name
   (CNAM) is 1-15 letters/numbers/spaces and takes 12-72h to propagate.
   'settings set' merges \u2014 settings you don't pass keep their current values.
@@ -7636,7 +7724,7 @@ Notes:
   and error. Client tools run in the browser, so they have no requestId.`;
 
 // src/ops/tasks.ts
-function list11(ctx, params = {}) {
+function list12(ctx, params = {}) {
   return call(
     ctx,
     "GET",
@@ -7665,9 +7753,9 @@ var tasksSpecs = {
     positionals: [{ name: "traceId", required: true }]
   }
 };
-async function list12(ctx, a) {
+async function list13(ctx, a) {
   out(
-    await list11(ctx, {
+    await list12(ctx, {
       limit: a.num("limit"),
       cursor: a.str("cursor")
     })
@@ -7677,7 +7765,7 @@ async function get10(ctx, a) {
   out(await get9(ctx, a.req("traceId")));
 }
 var tasksHandlers = {
-  "tasks list": list12,
+  "tasks list": list13,
   "tasks get": get10
 };
 var tasksHelp = `remy-admin tasks \u2014 Log of the app's task agents (runTask), kept 90 days.
@@ -8663,7 +8751,7 @@ async function resolveDomainId(ctx, direction, domain) {
   }
   return match.id;
 }
-function list13(ctx, params = {}) {
+function list14(ctx, params = {}) {
   return call(
     ctx,
     "GET",
@@ -8862,7 +8950,7 @@ var emailSpecs = {
 };
 async function emailList(ctx, a) {
   out(
-    await list13(ctx, {
+    await list14(ctx, {
       status: a.str("status"),
       kind: a.str("kind"),
       recipient: a.str("recipient"),
@@ -9033,7 +9121,12 @@ Custom domains \u2014 two independent directions:
                      bounces.<domain>) \u2014 hand these to the user to create at
                      their DNS host, then 'verify <domain>' to re-check now.
                      'list' also returns effectiveSender: what the app currently
-                     sends as, and which tier that address comes from.
+                     sends as, which tier that address comes from, and
+                     anyRecipient. anyRecipient false is the shared platform
+                     address, which only mails the app's verified users and its
+                     workspace's members, in dev and live alike (anyone else is
+                     refused with unverified_recipients). A subdomain
+                     ('domains set') or a verified sending domain lifts it.
   'inbound-domains'  receive mail at the user's own domain via one MX record
                      ('check' returns it up front \u2014 no registration needed to
                      see it). Apps already receive at *@<slug>.madewithremy.com
@@ -9060,7 +9153,7 @@ Examples:
 `;
 
 // src/ops/cron.ts
-function list14(ctx, params = {}) {
+function list15(ctx, params = {}) {
   return call(
     ctx,
     "GET",
@@ -9089,7 +9182,7 @@ var cronSpecs = {
   }
 };
 async function cronList(ctx, a) {
-  out(await list14(ctx, { runs: a.num("runs") }));
+  out(await list15(ctx, { runs: a.num("runs") }));
 }
 async function cronRun(ctx, a) {
   out(await run2(ctx, a.req("route")));
@@ -9190,7 +9283,7 @@ var POLL_MS5 = 3e3;
 function base7(appId) {
   return `/_internal/v2/apps/${appId}/infra`;
 }
-function list15(ctx, params) {
+function list16(ctx, params) {
   return call(
     ctx,
     "GET",
@@ -9382,7 +9475,7 @@ async function waitAndReport2(ctx, a, id, phases, summary2, until) {
   }
 }
 async function infraList(ctx, a) {
-  out(await list15(ctx, { includeDestroyed: a.bool("include-destroyed") }));
+  out(await list16(ctx, { includeDestroyed: a.bool("include-destroyed") }));
 }
 async function infraGet(ctx, a) {
   out(await get12(ctx, { id: a.req("id") }));
@@ -9874,6 +9967,7 @@ var SPECS = {
   ...methodsSpecs,
   ...dataSpecs,
   ...issuesSpecs,
+  ...appsSpecs,
   ...prerenderSpecs,
   ...filesSpecs,
   ...dataSourcesSpecs,
@@ -9909,6 +10003,7 @@ var HANDLERS = {
   ...methodsHandlers,
   ...dataHandlers,
   ...issuesHandlers,
+  ...appsHandlers,
   ...prerenderHandlers,
   ...filesHandlers,
   ...dataSourcesHandlers,
@@ -9944,6 +10039,7 @@ var GROUP_HELP = {
   methods: methodsHelp,
   data: dataHelp,
   issues: issuesHelp,
+  apps: appsHelp,
   prerender: prerenderHelp,
   files: filesHelp,
   datasources: dataSourcesHelp,
@@ -10030,6 +10126,7 @@ Commands:
   methods       List and invoke methods
   data          Sync databases between dev and live (lift-from-dev / lift-from-live)
   issues        File and manage issues, in this app or another app in the workspace
+  apps          The workspace's apps by name, with the ids '--app' takes
   prerender     Manage + verify prerendered snapshots served to bots/crawlers
   files         Store, retrieve, share (signed links) + manage files in the app's stores
   datasources   Build and query searchable document corpora (RAG)
@@ -10067,6 +10164,7 @@ var GROUPS = [
   "methods",
   "data",
   "issues",
+  "apps",
   "prerender",
   "files",
   "datasources",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@madewithremy/admin",
-  "version": "0.1.51",
+  "version": "0.1.53",
   "description": "Admin SDK + CLI for managing production Remy apps",
   "type": "module",
   "main": "./dist/index.js",