@madewithremy/admin 0.1.42 → 0.1.44

package/dist/prod.js

@@ -1313,6 +1313,99 @@ Examples:
   remy-admin releases wait --commit 91ca67a --timeout 600
   remy-admin releases list --limit 1`;
 
+// src/ops/previews.ts
+function share(ctx, params) {
+  return call(
+    ctx,
+    "POST",
+    `/_internal/v2/apps/${ctx.appId}/preview/shares`,
+    { branch: params.branch, days: params.days, label: params.label }
+  );
+}
+function list4(ctx, branch) {
+  return call(
+    ctx,
+    "GET",
+    `/_internal/v2/apps/${ctx.appId}/preview/shares${qs({ branch })}`
+  );
+}
+function revoke(ctx, shareId) {
+  return call(
+    ctx,
+    "POST",
+    `/_internal/v2/apps/${ctx.appId}/preview/shares/${seg(shareId)}/revoke`
+  );
+}
+
+// src/commands/previews.ts
+var previewsSpecs = {
+  "previews share": {
+    usage: "Usage: remy-admin previews share <branch> [--days <n>] [--label <text>]",
+    positionals: [{ name: "branch", required: true }],
+    flags: {
+      days: { type: "number", min: 1, max: 30 },
+      label: { type: "string" }
+    }
+  },
+  "previews list": {
+    usage: "Usage: remy-admin previews list <branch>",
+    positionals: [{ name: "branch", required: true }]
+  },
+  "previews revoke": {
+    usage: "Usage: remy-admin previews revoke <shareId>",
+    positionals: [{ name: "shareId", required: true }]
+  }
+};
+async function previewsShare(ctx, a) {
+  out(
+    await share(ctx, {
+      branch: a.req("branch"),
+      days: a.num("days"),
+      label: a.str("label")
+    })
+  );
+}
+async function previewsList(ctx, a) {
+  out(await list4(ctx, a.req("branch")));
+}
+async function previewsRevoke(ctx, a) {
+  out(await revoke(ctx, a.req("shareId")));
+}
+var previewsHandlers = {
+  "previews share": previewsShare,
+  "previews list": previewsList,
+  "previews revoke": previewsRevoke
+};
+var previewsHelp = `remy-admin previews \u2014 Share links to a branch's preview, for people and for API clients.
+
+Subcommands:
+  share    Make a share link to a branch's preview
+  list     A branch's share links (revoked and expired included)
+  revoke   Revoke a share link
+
+Usage:
+  remy-admin previews share <branch> [--days <n>] [--label <text>]   --days 1-30 (default 14)
+  remy-admin previews list <branch>
+  remy-admin previews revoke <shareId>                                <shareId> is a link's id, from 'list'
+
+Notes:
+  - A preview runs on a copy of live data, so a link is a credential: make one only
+    for what needs it, with the shortest --days that serves, and revoke it when done.
+  - 'share' returns { link, url, token, previewUrl }, once. A person opens url. A
+    client with no cookie jar (curl, git, CI, a test run) sends token as the
+    X-Remy-Preview header on each request to previewUrl, beside the app's own
+    Authorization where a route needs one. Neither can be shown again.
+  - A link follows its branch: after another push, the same link shows the new preview.
+  - 'revoke' shuts out the link and its token at once.
+  - Errors: missing_branch, no_preview_for_branch (the branch has no preview build yet:
+    push it first), share_link_not_found.
+
+Examples:
+  remy-admin previews share feature-x --days 1 --label "API smoke test"
+  curl -H "X-Remy-Preview: <token>" -H "Authorization: Bearer sk_..." <previewUrl>/_/api/vendors
+  remy-admin previews list feature-x
+  remy-admin previews revoke 3f2c...`;
+
 // src/ops/diagnostics.ts
 async function getLiveReleaseId(ctx) {
   const live2 = await dashboardLive(ctx);
@@ -1926,8 +2019,9 @@ Notes:
     domain's legal owner. ICANN emails that address to verify it within 15
     days, or the domain stops resolving; tell the user to watch for it.
   - Other refusals: registrant_contact_required, insufficient_credits/*,
-    entitlement_required:registered_domains (the plan holds no more domains:
-    a paid plan holds 20), domain_registration_rate (3 in any 30 days),
+    entitlement_required:remy_build (the workspace doesn't build in Remy),
+    domain_limit_reached (it holds as many as it may: 20 unless support
+    raised it), domain_registration_rate (3 in any 30 days),
     domain_unavailable, tld_not_supported,
     trademark_claim, registrar_busy (try again), registrar_payment (temporarily
     unavailable), namecom_not_configured (this deployment doesn't sell domains).
@@ -1940,7 +2034,7 @@ Notes:
     can't be changed; they go when the connection is removed.`;
 
 // src/ops/users.ts
-function list4(ctx, params = {}) {
+function list5(ctx, params = {}) {
   return call(
     ctx,
     "GET",
@@ -1994,7 +2088,7 @@ var usersSpecs = {
 };
 async function usersList(ctx, a) {
   out(
-    await list4(ctx, {
+    await list5(ctx, {
       limit: a.num("limit"),
       offset: a.num("offset")
     })
@@ -2095,7 +2189,7 @@ Notes:
     a statement may safely begin with a '--' comment. Always quote the SQL.`;
 
 // src/ops/secrets.ts
-function list5(ctx) {
+function list6(ctx) {
   return call(
     ctx,
     "GET",
@@ -2161,7 +2255,7 @@ var secretsSpecs = {
   }
 };
 async function secretsList(ctx) {
-  out(await list5(ctx));
+  out(await list6(ctx));
 }
 async function secretsGet(ctx, a) {
   out(await get5(ctx, a.req("key")));
@@ -2406,7 +2500,7 @@ async function tailSseToStdout(ctx, apiPath) {
 
 // src/ops/methods.ts
 var METHOD_RUN_TIMEOUT_MS = 6e5;
-async function list6(ctx) {
+async function list7(ctx) {
   const dashboard = await call(
     ctx,
     "GET",
@@ -2449,7 +2543,7 @@ var methodsSpecs = {
   }
 };
 async function methodsList(ctx) {
-  out(await list6(ctx));
+  out(await list7(ctx));
 }
 async function methodsInvoke(ctx, a) {
   const methodId = a.req("methodId");
@@ -2656,7 +2750,7 @@ function listQuery(params) {
     cursor: params.cursor
   });
 }
-function list7(ctx, params = {}) {
+function list8(ctx, params = {}) {
   return call(
     ctx,
     "GET",
@@ -2862,7 +2956,7 @@ function readStateFilter(a) {
 }
 async function issuesList(ctx, a) {
   out(
-    await list7(ctx, {
+    await list8(ctx, {
       status: readStateFilter(a),
       labels: a.list("label"),
       originAppId: a.str("from-app"),
@@ -3586,7 +3680,7 @@ async function waitForCandidate(ctx, params) {
   const timeoutMs = params.timeoutMs ?? DEFAULT_WAIT_TIMEOUT_MS;
   const outcome = await pollUntil(
     async () => {
-      const { dataSources } = await list8(ctx);
+      const { dataSources } = await list9(ctx);
       const source = dataSources.find((s) => s.slug === params.slug);
       if (!source) {
         throw new Error(`Data source "${params.slug}" not found.`);
@@ -3668,7 +3762,7 @@ async function allDocuments(ctx, params) {
   }
   return out2;
 }
-function list8(ctx) {
+function list9(ctx) {
   return call(ctx, "GET", base(ctx.appId));
 }
 function search2(ctx, params) {
@@ -3787,7 +3881,7 @@ async function waitForMove(ctx, params) {
   const timeoutMs = params.timeoutMs ?? DEFAULT_WAIT_TIMEOUT_MS;
   const outcome = await pollUntil(
     async () => {
-      const { dataSources } = await list8(ctx);
+      const { dataSources } = await list9(ctx);
       const source2 = dataSources.find((s) => s.slug === params.slug);
       if (!source2) {
         throw new Error(`Data source "${params.slug}" not found.`);
@@ -3988,7 +4082,7 @@ async function uploadManifest(ctx, params) {
   await uploadDirect(token.upload, params.content, "manifest.jsonl");
   return { key: token.key };
 }
-function list9(ctx, params) {
+function list10(ctx, params) {
   return call(
     ctx,
     "GET",
@@ -4427,7 +4521,7 @@ async function waitForHydration(ctx, params) {
   const timeoutMs = params.timeoutMs ?? DEFAULT_WAIT_TIMEOUT_MS3;
   const outcome = await pollUntil(
     async () => {
-      const { dataSources } = await list8(ctx);
+      const { dataSources } = await list9(ctx);
       const source2 = dataSources.find((s) => s.slug === params.slug);
       if (!source2) {
         throw new Error(`Data source "${params.slug}" not found.`);
@@ -5404,7 +5498,7 @@ async function jobsStart(ctx, a) {
 }
 async function jobsList(ctx, a) {
   const slug = a.str("source");
-  out(await list9(ctx, slug ? { slug } : void 0));
+  out(await list10(ctx, slug ? { slug } : void 0));
 }
 async function jobsStatus(ctx, a) {
   const id = a.req("id");
@@ -6421,7 +6515,7 @@ async function dataSourcesAdd(ctx, a) {
   });
 }
 async function dataSourcesList(ctx) {
-  out(await list8(ctx));
+  out(await list9(ctx));
 }
 async function dataSourcesStatus(ctx, a) {
   const slug = sourceOf(a);
@@ -6440,7 +6534,7 @@ async function dataSourcesStatus(ctx, a) {
     });
     return;
   }
-  const { dataSources: sources2 } = await list8(ctx);
+  const { dataSources: sources2 } = await list9(ctx);
   const source = sources2.find((s) => s.slug === slug);
   if (!source) {
     out({ dataSource: slug, exists: false });
@@ -7414,7 +7508,7 @@ Notes:
   and error. Client tools run in the browser, so they have no requestId.`;
 
 // src/ops/tasks.ts
-function list10(ctx, params = {}) {
+function list11(ctx, params = {}) {
   return call(
     ctx,
     "GET",
@@ -7443,9 +7537,9 @@ var tasksSpecs = {
     positionals: [{ name: "traceId", required: true }]
   }
 };
-async function list11(ctx, a) {
+async function list12(ctx, a) {
   out(
-    await list10(ctx, {
+    await list11(ctx, {
       limit: a.num("limit"),
       cursor: a.str("cursor")
     })
@@ -7455,7 +7549,7 @@ async function get10(ctx, a) {
   out(await get9(ctx, a.req("traceId")));
 }
 var tasksHandlers = {
-  "tasks list": list11,
+  "tasks list": list12,
   "tasks get": get10
 };
 var tasksHelp = `remy-admin tasks \u2014 Log of the app's task agents (runTask), kept 90 days.
@@ -8434,7 +8528,7 @@ async function resolveDomainId(ctx, direction, domain) {
   }
   return match.id;
 }
-function list12(ctx, params = {}) {
+function list13(ctx, params = {}) {
   return call(
     ctx,
     "GET",
@@ -8633,7 +8727,7 @@ var emailSpecs = {
 };
 async function emailList(ctx, a) {
   out(
-    await list12(ctx, {
+    await list13(ctx, {
       status: a.str("status"),
       kind: a.str("kind"),
       recipient: a.str("recipient"),
@@ -8825,7 +8919,7 @@ Examples:
 `;
 
 // src/ops/cron.ts
-function list13(ctx, params = {}) {
+function list14(ctx, params = {}) {
   return call(
     ctx,
     "GET",
@@ -8854,7 +8948,7 @@ var cronSpecs = {
   }
 };
 async function cronList(ctx, a) {
-  out(await list13(ctx, { runs: a.num("runs") }));
+  out(await list14(ctx, { runs: a.num("runs") }));
 }
 async function cronRun(ctx, a) {
   out(await run2(ctx, a.req("route")));
@@ -8893,7 +8987,7 @@ var POLL_MS5 = 3e3;
 function base7(appId) {
   return `/_internal/v2/apps/${appId}/infra`;
 }
-function list14(ctx, params) {
+function list15(ctx, params) {
   return call(
     ctx,
     "GET",
@@ -9085,7 +9179,7 @@ async function waitAndReport2(ctx, a, id, phases, summary2, until) {
   }
 }
 async function infraList(ctx, a) {
-  out(await list14(ctx, { includeDestroyed: a.bool("include-destroyed") }));
+  out(await list15(ctx, { includeDestroyed: a.bool("include-destroyed") }));
 }
 async function infraGet(ctx, a) {
   out(await get12(ctx, { id: a.req("id") }));
@@ -9568,6 +9662,7 @@ var SPECS = {
   ...crashesSpecs,
   ...analyticsSpecs,
   ...releasesSpecs,
+  ...previewsSpecs,
   ...diagnosticsSpecs,
   ...domainsSpecs,
   ...usersSpecs,
@@ -9601,6 +9696,7 @@ var HANDLERS = {
   ...crashesHandlers,
   ...analyticsHandlers,
   ...releasesHandlers,
+  ...previewsHandlers,
   ...diagnosticsHandlers,
   ...domainsHandlers,
   ...usersHandlers,
@@ -9634,6 +9730,7 @@ var GROUP_HELP = {
   crashes: crashesHelp,
   analytics: analyticsHelp,
   releases: releasesHelp,
+  previews: previewsHelp,
   diagnostics: diagnosticsHelp,
   domains: domainsHelp,
   users: usersHelp,
@@ -9718,6 +9815,7 @@ Commands:
   crashes       View frontend (browser) crash groups and events
   analytics     View traffic, top-N, geo, and AI-referral insights
   releases      View and monitor releases
+  previews      Share links to a branch preview, for people and API clients
   diagnostics   View the post-deploy Lighthouse audit (scores, issues, raw report)
   domains       Subdomain, custom domains, and buying a domain
   users         Manage app users and roles
@@ -9753,6 +9851,7 @@ var GROUPS = [
   "crashes",
   "analytics",
   "releases",
+  "previews",
   "diagnostics",
   "domains",
   "users",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@madewithremy/admin",
-  "version": "0.1.42",
+  "version": "0.1.44",
   "description": "Admin SDK + CLI for managing production Remy apps",
   "type": "module",
   "main": "./dist/index.js",
@@ -53,7 +53,7 @@
     "json5": "^2.2.3"
   },
   "devDependencies": {
-    "@types/node": "^26.6.1",
+    "@types/node": "^26.6.4",
     "@typescript/native": "npm:typescript@^7.0.2",
     "tsup": "^8",
     "typescript": "npm:@typescript/typescript6@^6.0.2"