@forumulate/cli 0.4.0 → 0.8.0

package/dist/content/types-gen.js

@@ -0,0 +1,200 @@
+"use strict";
+/**
+ * TypeScript from a content library's `schema.json` (plan P4-T1, spec 7):
+ * `forumulate content types --library acme-site --out src/forumulate.d.ts`.
+ *
+ * The schema names everything already: `type.<key>` is a content type's
+ * `fields`, `entry.<key>` the delivery envelope around them (marked
+ * `x-forumulate-global` for a global), `block.<key>` a block type, and
+ * `json.*` the hoisted definitions of a json field's own schema. Each becomes
+ * one named type, so a `json` field is typed from its schema, a blocks
+ * field is a union discriminated on `blockType`, and a reference to an
+ * author is an `AuthorFields`.
+ *
+ * One deliberate departure from the schema: objects are CLOSED here. The
+ * schema says `additionalProperties: true` so a site keeps working while a
+ * field is being renamed; the types say exactly what the model has, so code
+ * that still reads the old name fails to compile after the model changes.
+ * That compile error is the point of generating types at all.
+ *
+ * Pure and deterministic: same schema, same bytes.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pascal = pascal;
+exports.defName = defName;
+exports.toType = toType;
+exports.generateTypes = generateTypes;
+const isObj = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+const IDENT = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+function pascal(s) {
+    const out = s
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .split(/[^A-Za-z0-9]+/)
+        .filter(Boolean)
+        .map((w) => w[0].toUpperCase() + w.slice(1))
+        .join('');
+    return /^[0-9]/.test(out) ? `T${out}` : out || 'T';
+}
+/** The TypeScript name of a `$defs` entry. */
+function defName(def) {
+    const dot = def.indexOf('.');
+    const kind = def.slice(0, dot);
+    const rest = def.slice(dot + 1);
+    if (kind === 'type')
+        return `${pascal(rest)}Fields`;
+    if (kind === 'entry')
+        return `${pascal(rest)}Entry`;
+    if (kind === 'block')
+        return `${pascal(rest)}Block`;
+    return `Json${pascal(rest.replace(/~/g, ' '))}`;
+}
+const literal = (v) => JSON.stringify(v);
+const key = (k) => (IDENT.test(k) ? k : JSON.stringify(k));
+/** Parenthesised when a union or intersection sits at its top level (`(A | B)[]`). */
+function paren(t) {
+    let depth = 0;
+    for (let i = 0; i < t.length; i++) {
+        const c = t[i];
+        if (c === '{' || c === '(' || c === '[' || c === '<')
+            depth++;
+        else if (c === '}' || c === ')' || c === ']' || c === '>')
+            depth--;
+        else if (c === '"') {
+            // Skip a string literal, escapes included: an enum value may hold a `|`.
+            for (i++; i < t.length && t[i] !== '"'; i++)
+                if (t[i] === '\\')
+                    i++;
+        }
+        else if (depth === 0 && (c === '|' || c === '&'))
+            return `(${t})`;
+    }
+    return t;
+}
+function comment(s, indent) {
+    const text = [s.title, s.description].filter((x) => typeof x === 'string' && x.length > 0);
+    const uniq = [...new Set(text)];
+    if (!uniq.length)
+        return '';
+    return `${indent}/** ${uniq.join(' — ').replace(/\*\//g, '*\\/').replace(/\n/g, ' ')} */\n`;
+}
+/** One schema as a TypeScript type expression. */
+function toType(s, indent = '') {
+    if (s === true || s === undefined)
+        return 'unknown';
+    if (s === false)
+        return 'never';
+    if (!isObj(s))
+        return 'unknown';
+    if (typeof s.$ref === 'string') {
+        const m = /^#\/\$defs\/(.+)$/.exec(s.$ref);
+        return m ? defName(m[1]) : 'unknown';
+    }
+    if ('const' in s)
+        return literal(s.const);
+    if (Array.isArray(s.enum))
+        return s.enum.length ? s.enum.map(literal).join(' | ') : 'never';
+    for (const k of ['oneOf', 'anyOf']) {
+        if (Array.isArray(s[k])) {
+            const parts = [...new Set(s[k].map((x) => toType(x, indent)))];
+            return parts.length ? parts.join(' | ') : 'never';
+        }
+    }
+    if (Array.isArray(s.allOf))
+        return s.allOf.map((x) => paren(toType(x, indent))).join(' & ');
+    const types = Array.isArray(s.type) ? s.type : typeof s.type === 'string' ? [s.type] : [];
+    if (!types.length) {
+        if (isObj(s.properties) || s.additionalProperties !== undefined)
+            return objectType(s, indent);
+        if (s.items !== undefined)
+            return arrayType(s, indent);
+        return 'unknown';
+    }
+    const parts = types.map((t) => {
+        switch (t) {
+            case 'string':
+                return 'string';
+            case 'number':
+            case 'integer':
+                return 'number';
+            case 'boolean':
+                return 'boolean';
+            case 'null':
+                return 'null';
+            case 'array':
+                return arrayType(s, indent);
+            case 'object':
+                return objectType(s, indent);
+            default:
+                return 'unknown';
+        }
+    });
+    return [...new Set(parts)].join(' | ');
+}
+function arrayType(s, indent) {
+    if (Array.isArray(s.items))
+        return `[${s.items.map((x) => toType(x, indent)).join(', ')}]`;
+    return `${paren(toType(s.items, indent))}[]`;
+}
+function objectType(s, indent) {
+    const props = isObj(s.properties) ? s.properties : {};
+    const names = Object.keys(props);
+    if (!names.length) {
+        // A map: its values are typed when the schema says how.
+        return isObj(s.additionalProperties) ? `Record<string, ${toType(s.additionalProperties, indent)}>` : 'Record<string, unknown>';
+    }
+    return `{\n${members(s, indent + '  ')}${indent}}`;
+}
+function members(s, indent) {
+    const props = (isObj(s.properties) ? s.properties : {});
+    const required = new Set(Array.isArray(s.required) ? s.required : []);
+    let out = '';
+    for (const [name, prop] of Object.entries(props)) {
+        out += isObj(prop) ? comment(prop, indent) : '';
+        out += `${indent}${key(name)}${required.has(name) ? '' : '?'}: ${toType(prop, indent)};\n`;
+    }
+    return out;
+}
+/**
+ * A `$defs` entry as a declaration. Always a type alias, never an interface:
+ * an interface is not assignable to `Record<string, unknown>` (it has no
+ * implicit index signature), and that is the constraint every generic
+ * content helper puts on `fields` (`Entry<T = Record<string, unknown>>`).
+ */
+function declaration(def, s) {
+    const doc = isObj(s) ? comment(s, '') : '';
+    return `${doc}export type ${defName(def)} = ${toType(s)};\n`;
+}
+/** The whole `forumulate.d.ts` for a library schema. */
+function generateTypes(schema, opts = {}) {
+    if (!isObj(schema) || !isObj(schema.$defs))
+        throw new Error('This is not a content library schema: it has no `$defs`.');
+    const defs = schema.$defs;
+    const entries = Object.keys(defs).filter((d) => d.startsWith('entry.'));
+    const isGlobal = (k) => isObj(defs[`entry.${k}`]) && defs[`entry.${k}`]['x-forumulate-global'] === true;
+    const typeKeys = Object.keys(defs).filter((d) => d.startsWith('type.')).map((d) => d.slice(5));
+    const blockKeys = Object.keys(defs).filter((d) => d.startsWith('block.')).map((d) => d.slice(6));
+    const collections = typeKeys.filter((k) => !isGlobal(k));
+    const globals = typeKeys.filter((k) => isGlobal(k));
+    const parts = [
+        '/* eslint-disable */',
+        '// Generated by `forumulate content types`. Do not edit: regenerate after a model change',
+        `// (${opts.command ?? 'forumulate content types --library <id> --out <file>'}).`,
+        ...(opts.libraryId ? [`// Content library: ${opts.libraryId}`] : []),
+        '// Fields are optional because an entry may leave them empty; objects are closed so a',
+        '// field removed or renamed in the model is a compile error wherever code still reads it.',
+        '',
+    ];
+    // Fields, then entries, then blocks, then json schemas: the order a reader looks for them.
+    const order = ['type.', 'entry.', 'block.', 'json.'];
+    const sorted = Object.keys(defs).sort((a, b) => {
+        const ra = order.findIndex((p) => a.startsWith(p));
+        const rb = order.findIndex((p) => b.startsWith(p));
+        return (ra < 0 ? 9 : ra) - (rb < 0 ? 9 : rb);
+    });
+    for (const def of sorted)
+        parts.push(declaration(def, defs[def]));
+    const map = (name, keys, suffix, doc) => `/** ${doc} */\nexport type ${name} = {\n${keys.map((k) => `  ${key(k)}: ${suffix(k)};\n`).join('')}};\n`;
+    parts.push(`/** Every block type, discriminated on \`blockType\`. */\nexport type Block = ${blockKeys.length ? blockKeys.map((k) => defName(`block.${k}`)).join(' | ') : 'never'};\n`, "export type BlockTypeKey = Block['blockType'];\n", map('Blocks', blockKeys, (k) => defName(`block.${k}`), 'Block types by key.'), map('ContentTypes', collections, (k) => defName(`type.${k}`), 'The fields of each collection (a content type with many entries), by key.'), map('Globals', globals, (k) => defName(`type.${k}`), 'The fields of each global (one entry per locale), by key.'), map('Entries', entries.map((d) => d.slice(6)), (k) => defName(`entry.${k}`), 'The delivery envelope of each content type, by key.'), 'export type ContentTypeKey = keyof ContentTypes;\n', 'export type GlobalKey = keyof Globals;\n', '/** Everything at once, for a client typed against this library. */\nexport type ForumulateContent = {\n  types: ContentTypes;\n  globals: Globals;\n  blocks: Blocks;\n  entries: Entries;\n};\n');
+    return { source: parts.join('\n'), types: collections, globals, blocks: blockKeys };
+}
+//# sourceMappingURL=types-gen.js.map

package/dist/content/types-gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-gen.js","sourceRoot":"","sources":["../../src/content/types-gen.ts"],"names":[],"mappings":"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"}

package/dist/help.d.ts

@@ -0,0 +1,3 @@
+/** `forumulate help`. The resource groups print their own (`forumulate spaces --help`). */
+export declare const HELP = "forumulate \u2014 Forumulate command-line interface\n\nUsage:\n  forumulate <command> [args]\n\nCommands:\n  login [--token <pat>]              Store a token for this API, so every other\n                                     command stops needing FORUMULATE_TOKEN in\n                                     the environment\n  logout                             Forget the stored token\n  whoami                             Show the authenticated user\n  config set|get|unset|list          Defaults: org, space, library, api-version\n                                     (`forumulate config set org acme`)\n\nEvery API operation:\n  api list [--tag t] [--search w]    Discover operations and their summaries\n  api describe <operationId>         Parameters and body schema, as flags\n  api <operationId> [args] [flags]   Call it: --<param> value, --data @f.json,\n  api <METHOD> <path> [flags]        --field a.b=v, --paginate, --json\n\nResources (each: <group> --help lists its verbs and the operation each calls):\n  Org:      orgs | members | invites | groups | roles | service-accounts (bots)\n            tokens (pats) | webhooks | extensions | audit\n  Spaces:   spaces | snapshots | shape | domains | assets | space-types (types)\n  Docs:     items (pages) | docs | collections | versions | change-requests (crs)\n            openapi | sdks | github (git)\n  Content:  blog | forum | changelog | roadmap | status | events | course\n            careers | forms   (blog/forum/changelog/status: translations \u2026)\n  CMS:      libraries | entries | media | releases | environments (envs)\n  Site:     theme | sites | reader\n  search <query...> [--org]          e.g. spaces create Docs --slug docs --type DOCS\n                                          items create --space docs --file a.md --publish\n                                          docs schedule set <pageId> <when> --space docs\n                                          webhooks deliveries <id>; webhooks replay <id> <d>\n      --out <file>  where a file answer goes (SDK archive, PDF, CSV export)\n  completion bash|zsh|fish           Shell completion script\n\nOlder forms, unchanged:\n  orgs                               List your organizations\n  spaces <orgId>                     List spaces in an org\n  items <orgId> <spaceId>            List what is in a space, with where each\n                                     piece's content lives\n  search <orgId> <query...>          Unified search across docs/forum/blog\n  publish <folder>                   Publish a folder of Markdown: one folder per\n                                     collection, front matter, assets, order,\n                                     and a forumulate.yaml manifest for space,\n                                     site, theme, OpenAPI and monitors. Re-runs\n                                     change only what changed, then read back.\n      --org <id|slug> --space <id|slug>   (or org:/space: in the manifest)\n      --dry-run   print the plan, write nothing (no token needed for a\n                  public space)\n      --prune     remove pages/posts/collections with no file (to the trash)\n      --only a,b  just these slugs, files, folders, or manifest parts\n                  (site, theme, settings, openapi, monitors)\n      --force     re-send every page even if it looks unchanged\n      --no-verify skip the read-back      --pace <ms> gap between writes\n      --manifest <file>  a manifest somewhere else\n  publish <orgId> <spaceId> <pageId> Publish a page\n  publish <orgId> <spaceId> <dir>    The folder form, with org and space given\n  domains <orgId> <spaceId>          List this space's domains and their state\n  domains verify <orgId> <spaceId> <hostname>\n                                     Re-run verification and say what is missing\n  snapshot <orgId> <spaceId> <label> Create a space version snapshot\n  content types --library <id|slug>  TypeScript for a content library's model:\n                                     collections, globals, the block union\n      [--org <id|slug>] [--out forumulate.d.ts] [--preview] [--schema <file>]\n      [--check]   fail (exit 1) when the file is out of date, write nothing\n  content pull --library <id|slug>   Write the model to forumulate.content.json\n      [--format json|payload] [--out <file>]   (payload: forumulate.payload.ts)\n  content push [file]                Show the diff against the library, then\n                                     apply it as a new model version\n      [--library \u2026] [--dry-run] [--yes] [--force]\n      [--rename type.field=new | block:hero.field=new | library:field=new]\n      [--rename-type old=new] [--rename-block old=new]\n  import <payload|contentful|sanity|strapi|wordpress> <export path>\n                                     Bring another CMS's content into a library:\n                                     model, media, entries, references (always\n                                     shows a dry run first)\n                                     Re-running updates entries a\n                                     previous import made. strapi takes a\n                                     folder or an unencrypted export .tar.gz\n      --library <id|slug> [--org \u2026] [--dry-run] [--yes]\n      [--config payload.config.ts]   (payload) the config that becomes the model\n      [--publish source|all|none]    what to publish (default: what was live)\n      [--allow-model-removals] [--pace <ms>] [--base-url <url>] (strapi uploads)\n  translations (alias i18n)          Every translation capability, one vocabulary\n      locales list|add|relabel|remove|set   a space's (--space) or library's\n                  (--library) languages; set es=Espa\u00F1ol fr [--prune] is exact\n      status      each piece \u00D7 language: missing/draft/published/outdated\n                  [--locale es,fr] [--fail-on missing,outdated] (exit 1)\n      pull        one Markdown file per piece per language \u2192 [--out translations]\n                  [--locale \u2026] [--only slug,\u2026] [--include-missing] (stubs)\n      push [dir]  diff the files against the API, write what changed [--dry-run]\n      auto        machine-translate with YOUR DeepL/AI key --locale es\n                  [--state missing,outdated] [--only \u2026] [--force] [--publish]\n                  [--library \u2026 --entry id,\u2026] [--dry-run]\n      labels pull|push [file]       chrome words (--site <id> | --space \u2026)\n      overrides pull|push [file]    org UI string overrides [--prune]\n                  [--format json|xliff] for labels and overrides\n      item-locale <itemId> <locale|none>  correct a piece's declared language\n      remove <pieceId> <locale>     one translation (--yes)\n      entry <entryId> <locale>      a library entry's twin [--fields f.json]\n      name <locale> <name\u2026>         a space's (or --collection's) name\n      switcher get|set <f.json>     the org's reader language switcher\n      provider status|connect|disconnect   your DeepL key (DEEPL_API_KEY)\n  conformance <collectionUrl>        Run the Content Sync Protocol suite against\n                                     any platform's collection endpoint\n  doctor <readerUrl>                 Check a live site from the outside: health,\n                                     public read, canonical, cache headers,\n                                     crawler access, feeds, HTML rewriting\n  help                               Show this help\n\nEnvironment:\n  FORUMULATE_TOKEN   Personal Access Token (Bearer). Overrides a stored one, so\n                     CI keeps working exactly as it did. Mint one at\n                     https://forumulate.com/account/tokens\n  FORUMULATE_URL     The site (default https://forumulate.com); the API is its\n                     /api, i.e. https://forumulate.com/api. A value already\n                     ending in /api is used as-is.\n  FORUMULATE_API_URL Exact API base, for a local API with no /api prefix\n                     (http://localhost:4000). Wins over FORUMULATE_URL.\n  FORUMULATE_ORG, FORUMULATE_SPACE, FORUMULATE_LIBRARY\n                     Defaults for --org, --space and --library; they beat\n                     `forumulate config set`, a flag beats both.\n  FORUMULATE_API_VERSION\n                     Forumulate-Version for api/resource commands\n                     (default 2026-12-01).\n\nThe SDK (ForumulateClient.fromEnv) and the MCP server (@forumulate/mcp) read\nthe same variables. Guide: https://forumulate.com/guides/api-tokens-and-scopes\n\nFlags:\n  --json          Emit raw JSON instead of a formatted summary\n  --dry-run       (api, resources) print the request instead of sending it\n  --dry-run       Plan the work and write nothing (publish of a directory)\n  --version       Print the CLI version\n";
+//# sourceMappingURL=help.d.ts.map

package/dist/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,eAAO,MAAM,IAAI,ipRAwIhB,CAAC"}

package/dist/help.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
+/** `forumulate help`. The resource groups print their own (`forumulate spaces --help`). */
+exports.HELP = `forumulate — Forumulate command-line interface
+
+Usage:
+  forumulate <command> [args]
+
+Commands:
+  login [--token <pat>]              Store a token for this API, so every other
+                                     command stops needing FORUMULATE_TOKEN in
+                                     the environment
+  logout                             Forget the stored token
+  whoami                             Show the authenticated user
+  config set|get|unset|list          Defaults: org, space, library, api-version
+                                     (\`forumulate config set org acme\`)
+
+Every API operation:
+  api list [--tag t] [--search w]    Discover operations and their summaries
+  api describe <operationId>         Parameters and body schema, as flags
+  api <operationId> [args] [flags]   Call it: --<param> value, --data @f.json,
+  api <METHOD> <path> [flags]        --field a.b=v, --paginate, --json
+
+Resources (each: <group> --help lists its verbs and the operation each calls):
+  Org:      orgs | members | invites | groups | roles | service-accounts (bots)
+            tokens (pats) | webhooks | extensions | audit
+  Spaces:   spaces | snapshots | shape | domains | assets | space-types (types)
+  Docs:     items (pages) | docs | collections | versions | change-requests (crs)
+            openapi | sdks | github (git)
+  Content:  blog | forum | changelog | roadmap | status | events | course
+            careers | forms   (blog/forum/changelog/status: translations …)
+  CMS:      libraries | entries | media | releases | environments (envs)
+  Site:     theme | sites | reader
+  search <query...> [--org]          e.g. spaces create Docs --slug docs --type DOCS
+                                          items create --space docs --file a.md --publish
+                                          docs schedule set <pageId> <when> --space docs
+                                          webhooks deliveries <id>; webhooks replay <id> <d>
+      --out <file>  where a file answer goes (SDK archive, PDF, CSV export)
+  completion bash|zsh|fish           Shell completion script
+
+Older forms, unchanged:
+  orgs                               List your organizations
+  spaces <orgId>                     List spaces in an org
+  items <orgId> <spaceId>            List what is in a space, with where each
+                                     piece's content lives
+  search <orgId> <query...>          Unified search across docs/forum/blog
+  publish <folder>                   Publish a folder of Markdown: one folder per
+                                     collection, front matter, assets, order,
+                                     and a forumulate.yaml manifest for space,
+                                     site, theme, OpenAPI and monitors. Re-runs
+                                     change only what changed, then read back.
+      --org <id|slug> --space <id|slug>   (or org:/space: in the manifest)
+      --dry-run   print the plan, write nothing (no token needed for a
+                  public space)
+      --prune     remove pages/posts/collections with no file (to the trash)
+      --only a,b  just these slugs, files, folders, or manifest parts
+                  (site, theme, settings, openapi, monitors)
+      --force     re-send every page even if it looks unchanged
+      --no-verify skip the read-back      --pace <ms> gap between writes
+      --manifest <file>  a manifest somewhere else
+  publish <orgId> <spaceId> <pageId> Publish a page
+  publish <orgId> <spaceId> <dir>    The folder form, with org and space given
+  domains <orgId> <spaceId>          List this space's domains and their state
+  domains verify <orgId> <spaceId> <hostname>
+                                     Re-run verification and say what is missing
+  snapshot <orgId> <spaceId> <label> Create a space version snapshot
+  content types --library <id|slug>  TypeScript for a content library's model:
+                                     collections, globals, the block union
+      [--org <id|slug>] [--out forumulate.d.ts] [--preview] [--schema <file>]
+      [--check]   fail (exit 1) when the file is out of date, write nothing
+  content pull --library <id|slug>   Write the model to forumulate.content.json
+      [--format json|payload] [--out <file>]   (payload: forumulate.payload.ts)
+  content push [file]                Show the diff against the library, then
+                                     apply it as a new model version
+      [--library …] [--dry-run] [--yes] [--force]
+      [--rename type.field=new | block:hero.field=new | library:field=new]
+      [--rename-type old=new] [--rename-block old=new]
+  import <payload|contentful|sanity|strapi|wordpress> <export path>
+                                     Bring another CMS's content into a library:
+                                     model, media, entries, references (always
+                                     shows a dry run first)
+                                     Re-running updates entries a
+                                     previous import made. strapi takes a
+                                     folder or an unencrypted export .tar.gz
+      --library <id|slug> [--org …] [--dry-run] [--yes]
+      [--config payload.config.ts]   (payload) the config that becomes the model
+      [--publish source|all|none]    what to publish (default: what was live)
+      [--allow-model-removals] [--pace <ms>] [--base-url <url>] (strapi uploads)
+  translations (alias i18n)          Every translation capability, one vocabulary
+      locales list|add|relabel|remove|set   a space's (--space) or library's
+                  (--library) languages; set es=Español fr [--prune] is exact
+      status      each piece × language: missing/draft/published/outdated
+                  [--locale es,fr] [--fail-on missing,outdated] (exit 1)
+      pull        one Markdown file per piece per language → [--out translations]
+                  [--locale …] [--only slug,…] [--include-missing] (stubs)
+      push [dir]  diff the files against the API, write what changed [--dry-run]
+      auto        machine-translate with YOUR DeepL/AI key --locale es
+                  [--state missing,outdated] [--only …] [--force] [--publish]
+                  [--library … --entry id,…] [--dry-run]
+      labels pull|push [file]       chrome words (--site <id> | --space …)
+      overrides pull|push [file]    org UI string overrides [--prune]
+                  [--format json|xliff] for labels and overrides
+      item-locale <itemId> <locale|none>  correct a piece's declared language
+      remove <pieceId> <locale>     one translation (--yes)
+      entry <entryId> <locale>      a library entry's twin [--fields f.json]
+      name <locale> <name…>         a space's (or --collection's) name
+      switcher get|set <f.json>     the org's reader language switcher
+      provider status|connect|disconnect   your DeepL key (DEEPL_API_KEY)
+  conformance <collectionUrl>        Run the Content Sync Protocol suite against
+                                     any platform's collection endpoint
+  doctor <readerUrl>                 Check a live site from the outside: health,
+                                     public read, canonical, cache headers,
+                                     crawler access, feeds, HTML rewriting
+  help                               Show this help
+
+Environment:
+  FORUMULATE_TOKEN   Personal Access Token (Bearer). Overrides a stored one, so
+                     CI keeps working exactly as it did. Mint one at
+                     https://forumulate.com/account/tokens
+  FORUMULATE_URL     The site (default https://forumulate.com); the API is its
+                     /api, i.e. https://forumulate.com/api. A value already
+                     ending in /api is used as-is.
+  FORUMULATE_API_URL Exact API base, for a local API with no /api prefix
+                     (http://localhost:4000). Wins over FORUMULATE_URL.
+  FORUMULATE_ORG, FORUMULATE_SPACE, FORUMULATE_LIBRARY
+                     Defaults for --org, --space and --library; they beat
+                     \`forumulate config set\`, a flag beats both.
+  FORUMULATE_API_VERSION
+                     Forumulate-Version for api/resource commands
+                     (default 2026-12-01).
+
+The SDK (ForumulateClient.fromEnv) and the MCP server (@forumulate/mcp) read
+the same variables. Guide: https://forumulate.com/guides/api-tokens-and-scopes
+
+Flags:
+  --json          Emit raw JSON instead of a formatted summary
+  --dry-run       (api, resources) print the request instead of sending it
+  --dry-run       Plan the work and write nothing (publish of a directory)
+  --version       Print the CLI version
+`;
+//# sourceMappingURL=help.js.map

package/dist/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":";;;AAAA,2FAA2F;AAC9E,QAAA,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwInB,CAAC"}

package/dist/import/coerce.d.ts

@@ -0,0 +1,34 @@
+/**
+ * A record's source values as the values of the model's declared fields.
+ *
+ * Driven by the field's declared TYPE, never by guessing from the value: a
+ * number is an id only where the field is a reference. What a value means
+ * (a rich-text document, a file, a pointer) is the importer's to say
+ * (`ImportSource`); what the library wants it to look like is decided here, so
+ * five platforms produce one shape. Anything that cannot be converted is
+ * left out and counted, never stored wrong.
+ */
+import type { FieldDecl, ImageResolver, ImportSource, RefTarget } from './types';
+type Obj = Record<string, unknown>;
+export interface CoerceCtx {
+    source: ImportSource;
+    image: ImageResolver;
+    /** The library asset id for a source file, uploading it first if needed. */
+    asset(sourceId: string): {
+        id: string;
+        filename: string;
+    } | null;
+    /** The entry id for a source record, or null while it does not exist yet / is not in the export. */
+    entry(target: RefTarget): string | null;
+    blocks: Map<string, FieldDecl[]>;
+    /** `type.field` → values that fitted no declared field or could not be converted. */
+    dropped: Map<string, number>;
+    /** Set when a reference could not be resolved yet; the engine writes the field again once all entries exist. */
+    pendingRef: {
+        value: boolean;
+    };
+}
+export declare function coerceFields(fields: FieldDecl[], raw: Obj, ctx: CoerceCtx, path: string, skip?: ReadonlySet<string>): Obj;
+export declare function coerceValue(f: FieldDecl, raw: unknown, ctx: CoerceCtx, path: string): unknown;
+export {};
+//# sourceMappingURL=coerce.d.ts.map

package/dist/import/coerce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coerce.d.ts","sourceRoot":"","sources":["../../src/import/coerce.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEjF,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAGnC,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,aAAa,CAAC;IACrB,4EAA4E;IAC5E,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACjE,oGAAoG;IACpG,KAAK,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAAC;IACxC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IACjC,qFAAqF;IACrF,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,gHAAgH;IAChH,UAAU,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;CAChC;AAYD,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAW,CAAC,MAAM,CAAa,GAAG,GAAG,CAUpI;AAWD,wBAAgB,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAsF7F"}

package/dist/import/coerce.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.coerceFields = coerceFields;
+exports.coerceValue = coerceValue;
+const isObj = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+const drop = (ctx, path) => ctx.dropped.set(path, (ctx.dropped.get(path) ?? 0) + 1);
+function many(field, raw, one) {
+    if (field.hasMany) {
+        const list = (Array.isArray(raw) ? raw : raw === undefined || raw === null ? [] : [raw]).map(one).filter((x) => x !== undefined);
+        return list;
+    }
+    return one(Array.isArray(raw) ? raw[0] : raw);
+}
+function coerceFields(fields, raw, ctx, path, skip = new Set()) {
+    const out = {};
+    const known = new Set(fields.map((f) => f.key));
+    for (const f of fields) {
+        if (skip.has(f.key) || raw[f.key] === undefined || raw[f.key] === null)
+            continue;
+        const v = coerceValue(f, raw[f.key], ctx, `${path}.${f.key}`);
+        if (v !== undefined && !(Array.isArray(v) && v.length === 0 && f.hasMany))
+            out[f.key] = v;
+    }
+    for (const k of Object.keys(raw))
+        if (!known.has(k) && !skip.has(k) && raw[k] !== undefined && raw[k] !== null)
+            drop(ctx, `${path}.${k}`);
+    return out;
+}
+/**
+ * A list of scalars or files is an array of one-field rows in the model. A raw
+ * list of strings, ids or file objects is wrapped into those rows; a raw row
+ * that already names the field is left as it is.
+ */
+const WRAPPED = new Set(['media', 'file', 'reference', 'richText', 'json']);
+const ISO = /^\d{4}-\d{2}-\d{2}/;
+function coerceValue(f, raw, ctx, path) {
+    const bad = () => {
+        drop(ctx, path);
+        return undefined;
+    };
+    switch (f.type) {
+        case 'text':
+        case 'textarea':
+        case 'email':
+        case 'select':
+        case 'multiselect':
+        case 'slug':
+        case 'color':
+        case 'url':
+        case 'phone':
+            return many(f, raw, (v) => (typeof v === 'string' ? v : typeof v === 'number' || typeof v === 'boolean' ? String(v) : undefined)) ?? bad();
+        case 'number':
+        case 'money':
+            return many(f, raw, (v) => (typeof v === 'number' && Number.isFinite(v) ? v : typeof v === 'string' && v.trim() !== '' && Number.isFinite(Number(v)) ? Number(v) : undefined)) ?? bad();
+        case 'boolean':
+            return typeof raw === 'boolean' ? raw : raw === 'true' ? true : raw === 'false' ? false : bad();
+        case 'datetime':
+        case 'date': {
+            const d = typeof raw === 'string' || typeof raw === 'number' ? new Date(raw) : null;
+            if (!d || Number.isNaN(d.getTime()))
+                return bad();
+            // A calendar day stays the day the source wrote, not that day in UTC shifted by a zone.
+            return f.type === 'date' ? (typeof raw === 'string' && ISO.test(raw) ? raw.slice(0, 10) : d.toISOString().slice(0, 10)) : d.toISOString();
+        }
+        case 'code':
+            if (typeof raw === 'string')
+                return { language: 'text', code: raw };
+            return isObj(raw) && typeof raw.code === 'string' ? { language: typeof raw.language === 'string' && raw.language ? raw.language : 'text', code: raw.code } : bad();
+        case 'json':
+            return raw;
+        case 'richText': {
+            const doc = ctx.source.richText(raw, ctx.image);
+            return doc ?? bad();
+        }
+        case 'media':
+        case 'file': {
+            const one = (v) => {
+                const id = ctx.source.mediaId(v);
+                const asset = id ? ctx.asset(id) : null;
+                if (!asset)
+                    return undefined;
+                const alt = isObj(v) && typeof v.alt === 'string' ? v.alt : undefined;
+                return f.type === 'file' ? { assetId: asset.id, name: asset.filename } : { assetId: asset.id, ...(alt ? { alt } : {}) };
+            };
+            return many(f, raw, one) ?? bad();
+        }
+        case 'reference': {
+            const targets = ctx.source.refs(raw, f);
+            const ids = [];
+            for (const t of targets) {
+                const id = ctx.entry(t);
+                if (id)
+                    ids.push({ kind: 'entry', id });
+                else
+                    ctx.pendingRef.value = true;
+            }
+            if (!targets.length)
+                return bad();
+            if (!ids.length)
+                return undefined;
+            return f.hasMany ? ids : ids[0];
+        }
+        case 'group':
+            return isObj(raw) ? coerceFields(f.fields ?? [], raw, ctx, path) : bad();
+        case 'array': {
+            if (!Array.isArray(raw))
+                return bad();
+            const only = f.fields?.length === 1 ? f.fields[0] : null;
+            return raw
+                .map((row) => (only && !(isObj(row) && only.key in row) && (!isObj(row) || WRAPPED.has(only.type)) ? { [only.key]: row } : row))
+                .filter(isObj)
+                .map((row, i) => coerceFields(f.fields ?? [], row, ctx, `${path}[${i}]`, new Set(['id'])));
+        }
+        case 'blocks': {
+            if (!Array.isArray(raw))
+                return bad();
+            const rows = [];
+            raw.forEach((row, i) => {
+                if (!isObj(row))
+                    return;
+                const bt = String(row.blockType ?? row._type ?? '');
+                const fields = ctx.blocks.get(bt);
+                if (!fields)
+                    return void drop(ctx, `${path}[${i}]<${bt || 'unnamed block'}>`);
+                rows.push({ blockType: bt, ...coerceFields(fields, row, ctx, `${path}[${i}]<${bt}>`, new Set(['id', 'blockType', 'blockName', '_type', '_key'])) });
+            });
+            return rows;
+        }
+        default:
+            // seo, link, form… have shapes only the author's model knows; a value already in that shape passes.
+            return raw;
+    }
+}
+//# sourceMappingURL=coerce.js.map

package/dist/import/coerce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coerce.js","sourceRoot":"","sources":["../../src/import/coerce.ts"],"names":[],"mappings":"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"}

package/dist/import/command.d.ts

@@ -0,0 +1,25 @@
+import type { ForumulateClient } from '@forumulate/sdk';
+import type { ImportFiles, ImportSource } from './types';
+/**
+ * `forumulate import <platform> <path> --library <id|slug>` (plan P4-T3, T4).
+ *
+ * Reads the export, shows what the model needs and what would land (a dry run
+ * is always the first step), and writes only after a yes or `--yes`. Talks to
+ * the library through the same management API every other client uses.
+ */
+export interface ImportDeps {
+    client: ForumulateClient;
+    out: (line: string) => void;
+    err: (line: string) => void;
+    env?: NodeJS.ProcessEnv;
+    ask?: (question: string) => Promise<string>;
+    upload?: (path: string, form: FormData) => Promise<unknown>;
+    sleep?: (ms: number) => Promise<void>;
+    files?: ImportFiles;
+    fetchBytes?: (url: string) => Promise<Uint8Array>;
+}
+export declare const IMPORT_PLATFORMS: readonly ["payload", "contentful", "sanity", "strapi", "wordpress"];
+export declare const IMPORT_VALUE_FLAGS: string[];
+export declare function readSource(platform: string, path: string, argv: readonly string[], files: ImportFiles): ImportSource;
+export declare function runImportCommand(argv: readonly string[], positional: readonly string[], deps: ImportDeps): Promise<number>;
+//# sourceMappingURL=command.d.ts.map

package/dist/import/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/import/command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAUxD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGzD;;;;;;GAMG;AAEH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,gBAAgB,CAAC;IACzB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CACnD;AAED,eAAO,MAAM,gBAAgB,qEAAsE,CAAC;AACpG,eAAO,MAAM,kBAAkB,UAAgE,CAAC;AAahG,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,WAAW,GAAG,YAAY,CAmBpH;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAoEhI"}