@anyday/sanity-workspace-manager 0.1.1 → 0.4.0

package/README.md

@@ -27,8 +27,9 @@ From the root of the site repo:
 # 1. Export the Studio's schema (writes sanity.schema.json)
 cd studio && npx sanity schema extract && cd ..
 
-# 2. Draft the manifest, reading theme defaults and three starter pages from the live project
-npx @anyday/sanity-workspace-manager init --live --starter home,about,contact
+# 2. Draft the manifest from the repo and the live project; it lists the site's pages to pick
+#    starter content from
+npx @anyday/sanity-workspace-manager init --live
 
 # 3. Review workspace-manager.json, then commit it next to the schema
 
@@ -42,15 +43,16 @@ npx @anyday/sanity-workspace-manager register --api https://anyday-workspace-man
 npx @anyday/sanity-workspace-manager init [dir] [options]
 ```
 
-`dir` is the site repo, and defaults to the current folder. `init` asks four questions, each with a
+`dir` is the site repo, and defaults to the current folder. `init` asks five questions, each with a
 suggestion you can accept with Enter:
 
-| Question                                    | Suggested from                                                     |
-| ------------------------------------------- | ------------------------------------------------------------------ |
-| Project type id, short and lowercase        | The repo name in the git remote, e.g. `acme-site`                  |
-| Name shown in the app                       | The same repo name, capitalised                                    |
-| Sanity project to copy schemas from         | A `projectId: '…'` written in the Studio's config, if there is one |
-| Sanity organisation to create workspaces in | Looked up from that project with your login                        |
+| Question                                    | Suggested from                                                                        |
+| ------------------------------------------- | ------------------------------------------------------------------------------------- |
+| Project type id, short and lowercase        | The repo name in the git remote, e.g. `acme-site`                                     |
+| Name shown in the app                       | The same repo name, capitalised                                                       |
+| Sanity project to copy schemas from         | A `projectId: '…'` written in the Studio's config, if there is one                    |
+| Sanity organisation to create workspaces in | Looked up from that project with your login                                           |
+| Vercel team for the sites                   | Nothing: press Enter for Anyday's team; give a team id only for the client's own team |
 
 The id is permanent: jobs store it and it prefixes each site's Vercel project. Registering a
 different id later creates a second project type instead of updating this one.
@@ -62,27 +64,47 @@ different id later creates a second project type instead of updating this one.
 | git remote and default branch   | `site.repo`, `site.branch`, the suggested id and name                                                |
 | `.env.example`, names only      | `siteEnv`, the variables each new site needs                                                         |
 | `sanity.schema.json`            | copy sections, singletons, home page, language documents, settings fields, colour and font templates |
-| the live project, with `--live` | theme defaults, colour defaults and starter pages (`--starter <ids>`)                                |
+| the live project, with `--live` | theme defaults, colour defaults, starter pages, and its deployed Studio for `studioOrigins`          |
 
 `sanity.schema.json` is looked for in the repo root, `frontend`, `web`, `site`, `studio`, `apps`
 and each folder in `apps`.
 
 ### Options
 
-| Option             | Does                                                                        |
-| ------------------ | --------------------------------------------------------------------------- |
-| `--yes`            | Accepts the suggested id, name and project without asking                   |
-| `--project <id>`   | The Sanity project new workspaces copy their schema from                    |
-| `--org <id>`       | The Sanity organisation new workspaces are created in (found with `--live`) |
-| `--live`           | Reads the current theme, settings and starter pages from that project       |
-| `--dataset <name>` | The dataset `--live` reads (default `production`)                           |
-| `--starter <ids>`  | Comma-separated document ids to use as starter content (needs `--live`)     |
-| `--force`          | Replaces an existing `workspace-manager.json`                               |
-| `--print`          | Prints the draft instead of writing it                                      |
-
-Without `--starter`, new workspaces start from one empty home page. Starter pages get
-`{{siteName}}` and `{{language}}` where the source site's name and language were. Font files are
-never copied into theme defaults, since fonts are often licensed per brand.
+| Option               | Does                                                                                            |
+| -------------------- | ----------------------------------------------------------------------------------------------- |
+| `--yes`              | Accepts the suggested id, name and project without asking                                       |
+| `--project <id>`     | The Sanity project new workspaces copy their schema from                                        |
+| `--org <id>`         | The Sanity organisation new workspaces are created in (found with `--live`)                     |
+| `--vercel-team <id>` | The client's own Vercel team for the sites; leave out for Anyday's team                         |
+| `--studio <origin>`  | The Studio that opens new workspaces, e.g. `https://acme.sanity.studio` (found with `--live`)   |
+| `--live`             | Reads the current theme, settings and starter pages from that project                           |
+| `--dataset <name>`   | The dataset `--live` reads (default `production`)                                               |
+| `--starter <pages>`  | Starter pages without the list: `home`, slugs or document ids, comma-separated (needs `--live`) |
+| `--force`            | Replaces an existing `workspace-manager.json`                                                   |
+| `--print`            | Prints the draft instead of writing it                                                          |
+
+### Starter pages
+
+Starter pages are what a new workspace starts with when it doesn't copy another workspace. With
+`--live`, `init` lists the live site's pages in the home page's language, home first:
+
+```text
+Pages of the live site:
+  1. Home (/home)  ← home
+  2. About us (/about-us)
+  3. Accessibility (/accessibility)
+Starter pages, by number (e.g. 1,3; Enter for one empty home page):
+```
+
+Pick by number, or press Enter for one empty home page. To skip the list, name the pages with
+`--starter`: `home` means whichever page the settings mark as the home page, and any other entry
+is a page's slug or document id, e.g. `--starter home,about-us`. When translations share a
+slug, the home page's language wins. With `--yes` and no `--starter`, the starter is one empty
+home page.
+
+Starter pages get `{{siteName}}` and `{{language}}` where the source site's name and language
+were. Font files are never copied into theme defaults, since fonts are often licensed per brand.
 
 ### Review before registering
 
@@ -96,6 +118,9 @@ listed afterwards. Check these in particular:
 - **Colour roles** come with empty descriptions. Add a short one each, saying where the colour is
   used, so whoever sets up a brand knows what they are picking.
 - **Language documents and singletons** are guessed from type names (`…Settings`, `l10n.locale`).
+- **Vercel team:** sites go to Anyday's team unless you gave a team id. A client's own team needs
+  its token on the API as `VERCEL_TOKEN_<team id>` (a secret, added on Vercel by Anyday, never in
+  the manifest); `register` warns while it is missing.
 
 ## register
 
@@ -111,6 +136,7 @@ workspace manager. The live API is `https://anyday-workspace-manager-sanity-api.
 - Registering again replaces the saved copy for that `id`, so a changed manifest needs no delete
   first.
 - It prints `Registered <name> (<id>)` when saved.
+- It warns when the manifest names a Vercel team the API has no token for yet.
 
 ## Signing in
 

package/dist/cli.mjs

@@ -236,6 +236,14 @@ var workspace_manager_schema_default = {
       description: "The Sanity project whose latest deployed Studio schema each workspace gets.",
       $ref: "#/definitions/name"
     },
+    studioOrigins: {
+      description: "Origins of the Studios that open these workspaces, e.g. https://acme.sanity.studio; every new workspace allows them.",
+      type: "array",
+      items: {
+        type: "string",
+        pattern: "^https?://[^/]+$"
+      }
+    },
     languages: {
       type: "object",
       required: ["document", "setupTypes"],
@@ -411,6 +419,7 @@ function configFrom(manifest) {
     site: manifest.site,
     siteEnv: manifest.siteEnv,
     schemaSourceProjectId: manifest.schemaSourceProjectId,
+    studioOrigins: manifest.studioOrigins ?? [],
     languageDocument: languages && ((code) => fill(languages.document, {
       code,
       codeUpper: code.toUpperCase(),
@@ -431,6 +440,7 @@ function configFrom(manifest) {
     },
     brand: {
       colorRoles: brand.colorRoles,
+      fonts: brand.theme.font !== void 0,
       documents: (values, homePageId) => brandDocuments(brand, values, homePageId)
     }
   };
@@ -558,11 +568,18 @@ function draftManifest(repo, answers, live = {}) {
   );
   if (!repo.repo) note("No GitHub remote found: set site.repo to owner/name");
   if (!repo.hasRevalidateRoute) note("No /api/revalidate route found: check site.revalidatePath");
+  if (answers.vercelTeamId)
+    note(
+      `Sites go to Vercel team ${answers.vercelTeamId}: the API needs VERCEL_TOKEN_${answers.vercelTeamId} before setups reach Vercel`
+    );
+  if (answers.studioOrigins?.length) note(`Studio: ${answers.studioOrigins.join(", ")}`);
+  else note('No Studio found: add studioOrigins, e.g. ["https://acme.sanity.studio"]');
   return {
     manifest: {
       id: answers.id,
       title: answers.title,
       organizationId: answers.organizationId,
+      ...answers.vercelTeamId ? { vercelTeamId: answers.vercelTeamId } : {},
       site: {
         repo: repo.repo ?? "owner/name",
         branch: repo.branch ?? "main",
@@ -570,6 +587,7 @@ function draftManifest(repo, answers, live = {}) {
       },
       siteEnv,
       schemaSourceProjectId: answers.schemaSourceProjectId,
+      ...answers.studioOrigins?.length ? { studioOrigins: answers.studioOrigins } : {},
       ...languages ? { languages } : {},
       content: {
         sections,
@@ -642,7 +660,7 @@ function draftStarter(schema, home, live, note) {
   const page = { _id: "starter-home", _type: type };
   if ("title" in fields) page.title = "{{siteName}}";
   if ("language" in fields) page.language = "{{language}}";
-  note("Starter is one empty home page: pass --starter <ids> with --live to copy real pages");
+  note("Starter is one empty home page: run with --live to pick real pages instead");
   return { homeId: "starter-home", documents: [page] };
 }
 function draftBrand(schema, home, live, note) {
@@ -785,22 +803,51 @@ function sanityToken() {
   if (!existsSync(config)) return null;
   return JSON.parse(readFileSync(config, "utf8")).authToken ?? null;
 }
-async function organizationOf(projectId, token) {
+async function projectInfo(projectId, token) {
   const response = await fetch(`https://api.sanity.io/v2021-06-07/projects/${projectId}`, {
     headers: { Authorization: `Bearer ${token}` }
   });
   if (!response.ok) throw new Error(`Couldn't read project ${projectId}: ${response.status}`);
-  return (await response.json()).organizationId ?? "";
+  return await response.json();
+}
+async function organizationOf(projectId, token) {
+  return (await projectInfo(projectId, token)).organizationId ?? "";
+}
+async function studioOriginsOf(projectId, token) {
+  const response = await fetch(
+    `https://api.sanity.io/v2024-08-01/projects/${projectId}/user-applications`,
+    { headers: { Authorization: `Bearer ${token}` } }
+  );
+  if (!response.ok) throw new Error(`Couldn't list ${projectId}'s Studios: ${response.status}`);
+  const apps = await response.json();
+  const origins = apps.filter((app) => app.type === "studio").map(
+    (app) => app.urlType === "external" ? new URL(app.appHost).origin : `https://${app.appHost}.sanity.studio`
+  );
+  const { studioHost } = await projectInfo(projectId, token);
+  if (studioHost) origins.push(`https://${studioHost}.sanity.studio`);
+  return [...new Set(origins)];
+}
+var liveClient = ({ projectId, dataset, token }) => createClient({
+  projectId,
+  dataset,
+  token,
+  apiVersion: "2026-08-15",
+  useCdn: false,
+  perspective: "published"
+});
+async function listPages(options) {
+  const { settings, pages } = await liveClient(options).fetch(
+    `{
+      "settings": *[_id == $settingsId][0],
+      "pages": *[_type == $type && defined(slug.current)]{_id, title, "slug": slug.current, language}
+    }`,
+    { settingsId: options.home.documentId, type: options.pageType }
+  );
+  const homeId = settings?.[options.home.field]?._ref ?? null;
+  return { pages, homeId };
 }
 async function readLive(options) {
-  const client = createClient({
-    projectId: options.projectId,
-    dataset: options.dataset,
-    token: options.token,
-    apiVersion: "2026-08-15",
-    useCdn: false,
-    perspective: "published"
-  });
+  const client = liveClient(options);
   const docs = await client.fetch("*[_id in $ids]", {
     ids: [options.settingsId, options.themeId, ...options.starterIds]
   });
@@ -861,6 +908,39 @@ function readRepo(root) {
   };
 }
 
+// src/init/starter.ts
+function resolveStarter(entries, pages, homeId) {
+  const home = pages.find((page) => page._id === homeId);
+  return entries.map((entry) => {
+    if (entry === "home") {
+      if (!homeId) throw new Error("The live settings name no home page: pass its slug instead");
+      return homeId;
+    }
+    if (pages.some((page) => page._id === entry)) return entry;
+    let matches = pages.filter((page) => page.slug === entry);
+    if (matches.length > 1 && home?.language)
+      matches = matches.filter((page) => page.language === home.language);
+    if (matches.length === 1) return matches[0]._id;
+    if (!matches.length) throw new Error(`No page with the slug or id "${entry}"`);
+    throw new Error(
+      `Several pages have the slug "${entry}": pass one of ${matches.map((page) => page._id).join(", ")}`
+    );
+  });
+}
+function pickable(pages, homeId) {
+  const home = pages.find((page) => page._id === homeId);
+  const shown = home?.language ? pages.filter((page) => page.language === home.language) : pages;
+  return [...shown].sort(
+    (a, b) => a._id === homeId ? -1 : b._id === homeId ? 1 : (a.title ?? "").localeCompare(b.title ?? "")
+  );
+}
+function parsePick(answer, count) {
+  const picked = answer.split(/[\s,]+/).filter(Boolean).map((part) => Number(part));
+  const wrong = picked.filter((n) => !Number.isInteger(n) || n < 1 || n > count);
+  if (wrong.length) throw new Error(`Pick numbers from 1 to ${count}`);
+  return [...new Set(picked)].map((n) => n - 1);
+}
+
 // src/register.ts
 import { readFileSync as readFileSync3 } from "node:fs";
 import { join as join3 } from "node:path";
@@ -894,9 +974,13 @@ Options:
   --yes              Accept the suggested id, title and project without asking
   --project <id>     The Sanity project new workspaces copy their schema from
   --org <id>         The Sanity organisation new workspaces are created in (found with --live)
+  --vercel-team <id> The client's own Vercel team for the sites (default: Anyday's team)
+  --studio <origin>  The Studio that opens new workspaces, e.g. https://acme.sanity.studio
+                     (found with --live from the project's deployed Studio)
   --live             Read the current theme, settings and starter pages from that project
   --dataset <name>   Dataset to read with --live (default: production)
-  --starter <ids>    Comma-separated document ids to use as starter content (needs --live)
+  --starter <pages>  Comma-separated pages to copy as starter content: \`home\`, slugs or
+                     document ids (needs --live; without it, --live offers a list to pick from)
   --force            Overwrite an existing workspace-manager.json
   --print            Print the draft instead of writing it
 
@@ -919,20 +1003,23 @@ async function registerCommand(argv) {
   if (!token) throw new Error("register needs SANITY_AUTH_TOKEN or `npx sanity login`");
   const saved = await register({ dir: dirOf(positionals[0]), api, token });
   console.log(`Registered ${saved.title} (${saved.id})`);
+  for (const warning of saved.warnings ?? []) console.error(`Warning: ${warning}`);
 }
 async function init(argv) {
   const { values, positionals } = parseArgs({
     args: argv,
     allowPositionals: true,
     options: {
-      yes: { type: "boolean", default: false },
-      project: { type: "string" },
-      org: { type: "string" },
-      live: { type: "boolean", default: false },
-      dataset: { type: "string", default: "production" },
-      starter: { type: "string" },
-      force: { type: "boolean", default: false },
-      print: { type: "boolean", default: false }
+      "yes": { type: "boolean", default: false },
+      "project": { type: "string" },
+      "org": { type: "string" },
+      "studio": { type: "string" },
+      "vercel-team": { type: "string" },
+      "live": { type: "boolean", default: false },
+      "dataset": { type: "string", default: "production" },
+      "starter": { type: "string" },
+      "force": { type: "boolean", default: false },
+      "print": { type: "boolean", default: false }
     }
   });
   const root = dirOf(positionals[0]);
@@ -945,7 +1032,11 @@ async function init(argv) {
   const orgFor = async (projectId) => values.org ?? (token && projectId ? await organizationOf(projectId, token) : "");
   const repo = readRepo(root);
   const suggested = { ...suggestNames(repo.repo), project: values.project ?? repo.projectId ?? "" };
-  const answers = values.yes ? { ...suggested, org: await orgFor(suggested.project) } : await ask(suggested, orgFor);
+  const answers = values.yes ? {
+    ...suggested,
+    org: await orgFor(suggested.project),
+    vercelTeam: values["vercel-team"] ?? ""
+  } : await ask({ ...suggested, vercelTeam: values["vercel-team"] ?? "" }, orgFor);
   if (!answers.project)
     throw new Error("Pass --project <id>: the Sanity project to copy schemas from");
   if (!answers.org) throw new Error("Pass --org <id>, or --live to read it from the project");
@@ -953,17 +1044,28 @@ async function init(argv) {
     id: answers.id,
     title: answers.title,
     organizationId: answers.org,
-    schemaSourceProjectId: answers.project
+    ...answers.vercelTeam ? { vercelTeamId: answers.vercelTeam } : {},
+    schemaSourceProjectId: answers.project,
+    studioOrigins: values.studio ? [values.studio.replace(/\/+$/, "")] : token ? await studioOriginsOf(answers.project, token) : []
   };
   let draft = draftManifest(repo, base);
   if (token) {
+    const project = { projectId: answers.project, dataset: values.dataset, token };
+    const { pages, homeId } = await listPages({
+      ...project,
+      pageType: draft.manifest.content.starter.documents[0]._type,
+      home: draft.manifest.content.homePage
+    });
+    const starterIds = values.starter ? resolveStarter(
+      values.starter.split(",").map((entry) => entry.trim()).filter(Boolean),
+      pages,
+      homeId
+    ) : values.yes ? [] : await pickStarter(pickable(pages, homeId), homeId);
     const live = await readLive({
-      projectId: answers.project,
-      dataset: values.dataset,
-      token,
+      ...project,
       settingsId: draft.manifest.brand.settings.documentId,
       themeId: draft.manifest.brand.theme.documentId,
-      starterIds: values.starter?.split(",").map((id) => id.trim()).filter(Boolean) ?? []
+      starterIds
     });
     draft = draftManifest(repo, base, live);
   }
@@ -978,14 +1080,35 @@ Check before registering:`);
   for (const note of draft.notes) console.error(`  - ${note}`);
 }
 async function ask(suggested, orgFor) {
-  const prompt = createInterface({ input: process.stdin, output: process.stdout });
+  const prompt = createInterface({ input: process.stdin, output: process.stderr });
   const question = async (label, fallback) => (await prompt.question(`${label}${fallback ? ` (${fallback})` : ""}: `)).trim() || fallback;
   try {
     const id = await question("Project type id, short and lowercase", suggested.id);
     const title = await question("Name shown in the app", suggested.title);
     const project = await question("Sanity project to copy schemas from", suggested.project);
     const org = await question("Sanity organisation to create workspaces in", await orgFor(project));
-    return { id, title, project, org };
+    const vercelTeam = await question(
+      "Vercel team for the sites, only if it's the client's own (Enter for Anyday's)",
+      suggested.vercelTeam
+    );
+    return { id, title, project, org, vercelTeam };
+  } finally {
+    prompt.close();
+  }
+}
+async function pickStarter(pages, homeId) {
+  if (!pages.length) return [];
+  console.error("\nPages of the live site:");
+  pages.forEach((page, index) => {
+    const label = `${page.title ?? page._id} (/${page.slug})`;
+    console.error(`  ${index + 1}. ${label}${page._id === homeId ? "  \u2190 home" : ""}`);
+  });
+  const prompt = createInterface({ input: process.stdin, output: process.stderr });
+  try {
+    const answer = await prompt.question(
+      "Starter pages, by number (e.g. 1,3; Enter for one empty home page): "
+    );
+    return parsePick(answer, pages.length).map((index) => pages[index]._id);
   } finally {
     prompt.close();
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anyday/sanity-workspace-manager",
-  "version": "0.1.1",
+  "version": "0.4.0",
   "description": "Drafts a site repo's workspace-manager.json for the Anyday workspace manager",
   "repository": {
     "type": "git",