@myna-sh/cli 0.1.3 → 0.2.0

package/dist/main.js

@@ -223,7 +223,9 @@ function renderField(field, depth) {
   const optional = field.required ? "" : "?";
   const doc = field.description ? `${indent}/** ${escapeComment(field.description)} */
 ` : "";
-  return `${doc}${indent}${safeKey(field.key)}${optional}: ${fieldType(field, depth)};`;
+  const base = fieldType(field, depth);
+  const type = field.localized ? `{ [locale: string]: ${base} }` : base;
+  return `${doc}${indent}${safeKey(field.key)}${optional}: ${type};`;
 }
 function fieldType(field, depth) {
   switch (field.type) {
@@ -250,6 +252,21 @@ function fieldType(field, depth) {
       return renderObject(field, depth);
     case "list":
       return `${listItemType(field.item, depth)}[]`;
+    case "richText":
+      return "RichTextDoc";
+    case "blocks": {
+      const inner = "  ".repeat(depth + 1);
+      const options = field.blocks.map((b) => {
+        const lines = b.fields.map((f) => renderField(f, depth + 2));
+        return `{ type: ${JSON.stringify(b.key)}; fields: {
+${lines.join("\n")}
+${inner}} }`;
+      });
+      return `Array<
+${inner}${options.join(`
+${inner}| `)}
+${"  ".repeat(depth)}>`;
+    }
     default:
       return "unknown";
   }
@@ -291,7 +308,12 @@ ${closingIndent}}`;
       return "unknown";
   }
 }
-var JSON_VALUE = "export type JsonValue = string | number | boolean | null | JsonValue[] | { [key: string]: JsonValue };";
+var JSON_VALUE = [
+  "export type JsonValue = string | number | boolean | null | JsonValue[] | { [key: string]: JsonValue };",
+  "",
+  "/** Portable rich-text document tree (never rendered HTML). */",
+  'export interface RichTextDoc { type: "doc"; content: Array<{ type: string; [key: string]: unknown }>; }'
+].join("\n");
 function generateTypesModule(collections) {
   return `${JSON_VALUE}
 
@@ -368,7 +390,12 @@ var ManagementClient = class {
     create: (organization, body) => this.mutate("POST", `/organizations/${enc(organization)}/projects`, body),
     get: (project, signal) => this.get(`/projects/${enc(project)}`, void 0, signal),
     update: (project, body) => this.mutate("PATCH", `/projects/${enc(project)}`, body),
-    archive: (project) => this.mutate("POST", `/projects/${enc(project)}/archive`)
+    archive: (project) => this.mutate("POST", `/projects/${enc(project)}/archive`),
+    /** Full project export: schemas, entries (draft + published), asset metadata. */
+    export: (project, signal) => this.get(`/projects/${enc(project)}/export`, void 0, signal),
+    views: (project, signal) => this.get(`/projects/${enc(project)}/views`, void 0, signal),
+    createView: (project, body) => this.mutate("POST", `/projects/${enc(project)}/views`, body),
+    deleteView: (project, view) => this.mutate("DELETE", `/projects/${enc(project)}/views/${enc(view)}`)
   };
   // --- Schema ---------------------------------------------------------------
   schema = {
@@ -380,6 +407,13 @@ var ManagementClient = class {
       collections,
       allowDestructive: opts.allowDestructive ?? false,
       changeSummary: opts.changeSummary
+    }),
+    // Environments as projects
+    drift: (project, against, signal) => this.get(`/projects/${enc(project)}/schema/drift`, { against }, signal),
+    promote: (project, fromProject, opts = {}) => this.mutate("POST", `/projects/${enc(project)}/schema/promote`, {
+      fromProject,
+      allowDestructive: opts.allowDestructive ?? false,
+      confirm: true
     })
   };
   // --- Entries & revisions --------------------------------------------------
@@ -394,6 +428,12 @@ var ManagementClient = class {
     delete: (project, entry, changeSetId) => this.mutate("DELETE", `/projects/${enc(project)}/entries/${enc(entry)}`, void 0, { changeSetId }),
     unpublish: (project, entry, changeSetId) => this.mutate("POST", `/projects/${enc(project)}/entries/${enc(entry)}/unpublish`, void 0, { changeSetId }),
     restore: (project, entry) => this.mutate("POST", `/projects/${enc(project)}/entries/${enc(entry)}/restore`),
+    duplicate: (project, entry, changeSetId) => this.mutate("POST", `/projects/${enc(project)}/entries/${enc(entry)}/duplicate`, {
+      changeSetId
+    }),
+    bulk: (project, body) => this.mutate("POST", `/projects/${enc(project)}/entries/bulk`, body),
+    import: (project, body) => this.mutate("POST", `/projects/${enc(project)}/entries/import`, body),
+    references: (project, entry, signal) => this.get(`/projects/${enc(project)}/entries/${enc(entry)}/references`, void 0, signal),
     revisions: (project, entry, signal) => this.get(`/projects/${enc(project)}/entries/${enc(entry)}/revisions`, void 0, signal),
     revision: (project, entry, revision, signal) => this.get(`/projects/${enc(project)}/entries/${enc(entry)}/revisions/${enc(revision)}`, void 0, signal),
     restoreRevision: (project, entry, revision) => this.mutate(
@@ -409,7 +449,48 @@ var ManagementClient = class {
     update: (project, changeSet, body) => this.mutate("PATCH", `/projects/${enc(project)}/change-sets/${enc(changeSet)}`, body),
     validate: (project, changeSet) => this.mutate("POST", `/projects/${enc(project)}/change-sets/${enc(changeSet)}/validate`),
     publish: (project, changeSet) => this.mutate("POST", `/projects/${enc(project)}/change-sets/${enc(changeSet)}/publish`, { confirm: true }),
-    close: (project, changeSet) => this.mutate("POST", `/projects/${enc(project)}/change-sets/${enc(changeSet)}/close`)
+    close: (project, changeSet) => this.mutate("POST", `/projects/${enc(project)}/change-sets/${enc(changeSet)}/close`),
+    // Scheduled publishing
+    schedule: (project, changeSet, publishAt) => this.mutate("POST", `/projects/${enc(project)}/change-sets/${enc(changeSet)}/schedule`, {
+      publishAt
+    }),
+    cancelSchedule: (project, changeSet) => this.mutate("DELETE", `/projects/${enc(project)}/change-sets/${enc(changeSet)}/schedule`),
+    // Reviews & approvals
+    reviews: (project, changeSet, signal) => this.get(
+      `/projects/${enc(project)}/change-sets/${enc(changeSet)}/reviews`,
+      void 0,
+      signal
+    ),
+    requestReview: (project, changeSet, body) => this.mutate("POST", `/projects/${enc(project)}/change-sets/${enc(changeSet)}/reviews`, body),
+    removeReviewer: (project, changeSet, reviewer) => this.mutate(
+      "DELETE",
+      `/projects/${enc(project)}/change-sets/${enc(changeSet)}/reviews/${enc(reviewer)}`
+    ),
+    approve: (project, changeSet, body = {}) => this.mutate("POST", `/projects/${enc(project)}/change-sets/${enc(changeSet)}/approve`, body),
+    requestChanges: (project, changeSet, body = {}) => this.mutate(
+      "POST",
+      `/projects/${enc(project)}/change-sets/${enc(changeSet)}/request-changes`,
+      body
+    ),
+    // Comments
+    comments: (project, changeSet, signal) => this.get(
+      `/projects/${enc(project)}/change-sets/${enc(changeSet)}/comments`,
+      void 0,
+      signal
+    ),
+    comment: (project, changeSet, body) => this.mutate("POST", `/projects/${enc(project)}/change-sets/${enc(changeSet)}/comments`, body),
+    resolveComment: (project, changeSet, comment, resolved = true) => this.mutate(
+      "PATCH",
+      `/projects/${enc(project)}/change-sets/${enc(changeSet)}/comments/${enc(comment)}`,
+      { resolved }
+    ),
+    // Automated checks
+    checks: (project, changeSet, signal) => this.get(
+      `/projects/${enc(project)}/change-sets/${enc(changeSet)}/checks`,
+      void 0,
+      signal
+    ),
+    runChecks: (project, changeSet) => this.mutate("POST", `/projects/${enc(project)}/change-sets/${enc(changeSet)}/checks/run`)
   };
   // --- Previews -------------------------------------------------------------
   previews = {
@@ -427,6 +508,7 @@ var ManagementClient = class {
     get: (project, asset, signal) => this.get(`/projects/${enc(project)}/assets/${enc(asset)}`, void 0, signal),
     usage: (project, asset, signal) => this.get(`/projects/${enc(project)}/assets/${enc(asset)}`, { usage: "true" }, signal),
     update: (project, asset, body) => this.mutate("PATCH", `/projects/${enc(project)}/assets/${enc(asset)}`, body),
+    replace: (project, asset, body) => this.mutate("POST", `/projects/${enc(project)}/assets/${enc(asset)}/replace`, body),
     delete: (project, asset) => this.mutate("DELETE", `/projects/${enc(project)}/assets/${enc(asset)}`),
     /** Full presigned upload flow: create → PUT bytes → complete. */
     upload: (project, input, meta = {}) => this.uploadAsset(project, input, meta)
@@ -1407,6 +1489,35 @@ function registerSchema(program) {
       emit(result, () => renderDiff(result));
     })
   );
+  schema.command("drift").description("Show schema drift between this project and another (e.g. staging)").requiredOption("--against <project>", "project id or slug to compare with").action(
+    handle(async (ctx, _args, opts) => {
+      const project = ctx.requireProject();
+      const result = await ctx.management().schema.drift(project, opts.against);
+      emit(result, () => {
+        if (result.inSync) diag("Schemas are in sync.");
+        else {
+          diag(`${result.ops.length} op(s) of drift (${result.classification}):`);
+          for (const op of result.ops) {
+            process.stderr.write(`  ${op.kind} ${op.collection}${op.field ? `.${op.field}` : ""} \u2014 ${op.detail}
+`);
+          }
+        }
+      });
+      if (!result.inSync) process.exitCode = 1;
+    })
+  );
+  schema.command("promote").description("Promote another project's deployed schemas into this project").requiredOption("--from <project>", "source project id or slug").option("--allow-destructive", "permit destructive schema changes", false).action(
+    handle(async (ctx, _args, opts) => {
+      const project = ctx.requireProject();
+      const result = await ctx.management().schema.promote(project, opts.from, {
+        allowDestructive: Boolean(opts.allowDestructive)
+      });
+      emit(result, () => {
+        renderDiff(result.diff);
+        diag(result.applied ? `Promoted ${result.versions.length} version(s).` : "Nothing to promote.");
+      });
+    })
+  );
   schema.command("push").description("Apply local schemas, creating immutable versions").option("--schema-dir <dir>", "schema directory").option("--allow-destructive", "permit destructive schema changes", false).option("--summary <text>", "change summary").action(
     handle(async (ctx, _args, opts) => {
       const project = ctx.requireProject();
@@ -1480,6 +1591,7 @@ function renderDiff(diff) {
 }
 
 // src/commands/entries.ts
+import { readFile as readFile2 } from "fs/promises";
 function registerEntries(program) {
   const entries = program.command("entries").description("Create, read, update, and manage entries");
   entries.command("list").description("List entries in a collection").argument("<collection>", "collection key").option("--status <status>", "filter by status").option("--limit <n>", "page size", "25").option("--cursor <cursor>", "pagination cursor").action(
@@ -1578,6 +1690,81 @@ function registerEntries(program) {
       );
     })
   );
+  entries.command("duplicate").description("Duplicate an entry into a new draft").argument("<ref>", "collection/slug or entry id").option("--change-set <id>", "stage on an explicit change set").action(
+    handle(async (ctx, args, opts) => {
+      const project = ctx.requireProject();
+      const id = await resolveEntryId(ctx.management(), project, args[0]);
+      const entry = await ctx.management().entries.duplicate(project, id, opts.changeSet);
+      emit(entry, () => diag(`Duplicated into ${entry.id} (${entry.slug ?? "no slug"}).`));
+    })
+  );
+  entries.command("bulk").description("Stage a delete or unpublish for many entries at once").requiredOption("--action <action>", "delete or unpublish").requiredOption("--ids <ids>", "comma-separated entry ids").option("--change-set <id>", "stage on an explicit change set").action(
+    handle(async (ctx, _args, opts) => {
+      const action = opts.action;
+      if (action !== "delete" && action !== "unpublish") {
+        throw new UsageError("--action must be delete or unpublish.");
+      }
+      const project = ctx.requireProject();
+      const result = await ctx.management().entries.bulk(project, {
+        action,
+        entryIds: opts.ids.split(",").map((s) => s.trim()).filter(Boolean),
+        changeSetId: opts.changeSet
+      });
+      emit(
+        result,
+        () => table(result.results, [
+          { header: "ENTRY", value: (r) => r.entryId },
+          { header: "OK", value: (r) => r.ok ? "yes" : "no" },
+          { header: "CHANGE SET", value: (r) => r.changeSetId ?? "\u2014" },
+          { header: "ERROR", value: (r) => r.error ?? "" }
+        ])
+      );
+      if (result.results.some((r) => !r.ok)) process.exitCode = 1;
+    })
+  );
+  entries.command("import").description("Import entries from a JSON file, with dry-run validation").argument("<file>", 'JSON file: { "collection": "posts", "entries": [{ "slug"?, "data" }] }').option("--dry-run", "validate without creating anything", false).action(
+    handle(async (ctx, args, opts) => {
+      const project = ctx.requireProject();
+      const raw = JSON.parse(await readFile2(args[0], "utf8"));
+      const result = await ctx.management().entries.import(project, {
+        collection: raw.collection,
+        entries: raw.entries,
+        dryRun: Boolean(opts.dryRun)
+      });
+      emit(result, () => {
+        diag(
+          result.dryRun ? `Dry run: ${result.valid ? "all rows valid" : "validation failed"}.` : `Imported ${result.results.filter((r) => r.ok).length}/${result.results.length} into change set ${result.changeSetId}.`
+        );
+        for (const row of result.results.filter((r) => !r.ok)) {
+          for (const e of row.errors ?? []) {
+            process.stderr.write(`  row ${row.index}${row.slug ? ` (${row.slug})` : ""}: ${e.path} ${e.message}
+`);
+          }
+        }
+      });
+      if (!result.valid) process.exitCode = 1;
+    })
+  );
+  entries.command("references").description("Show which entries reference this one and what it references").argument("<ref>", "collection/slug or entry id").action(
+    handle(async (ctx, args) => {
+      const project = ctx.requireProject();
+      const id = await resolveEntryId(ctx.management(), project, args[0]);
+      const refs = await ctx.management().entries.references(project, id);
+      emit(refs, () => {
+        diag(`Referenced by ${refs.referencedBy.length} entr(y/ies):`);
+        table(refs.referencedBy, [
+          { header: "ENTRY", value: (r) => `${r.collectionKey}/${r.slug ?? r.id}` },
+          { header: "IN DRAFT", value: (r) => r.inDraft ? "yes" : "no" },
+          { header: "IN PUBLISHED", value: (r) => r.inPublished ? "yes" : "no" }
+        ]);
+        diag(`References ${refs.references.length} entr(y/ies):`);
+        table(refs.references, [
+          { header: "ENTRY", value: (r) => r.collectionKey ? `${r.collectionKey}/${r.slug ?? r.id}` : r.id },
+          { header: "STATE", value: (r) => !r.exists ? "missing" : r.published ? "published" : "unpublished" }
+        ]);
+      });
+    })
+  );
   entries.command("restore").description("Restore a historical revision into a new draft").argument("<ref>", "collection/slug or entry id").requiredOption("--revision <id>", "revision id to restore").action(
     handle(async (ctx, args, opts) => {
       const project = ctx.requireProject();
@@ -1682,6 +1869,107 @@ function registerChanges(program) {
       emit(cs, () => diag(`Closed ${cs.id}.`));
     })
   );
+  changes.command("schedule").description("Schedule, reschedule, or cancel a change set's publish").argument("<id>", "change set id").option("--at <datetime>", "ISO 8601 datetime to publish at").option("--cancel", "cancel the scheduled publish", false).action(
+    handle(async (ctx, args, opts) => {
+      const project = ctx.requireProject();
+      if (Boolean(opts.at) === Boolean(opts.cancel)) {
+        throw new UsageError("Provide exactly one of --at <datetime> or --cancel.");
+      }
+      const client = ctx.management();
+      const cs = opts.cancel ? await client.changeSets.cancelSchedule(project, args[0]) : await client.changeSets.schedule(project, args[0], new Date(opts.at).toISOString());
+      emit(
+        cs,
+        () => diag(cs.scheduledAt ? `Scheduled to publish at ${cs.scheduledAt}.` : "Schedule cancelled.")
+      );
+    })
+  );
+  changes.command("reviews").description("List reviews and approvals for a change set").argument("<id>", "change set id").action(
+    handle(async (ctx, args) => {
+      const project = ctx.requireProject();
+      const reviews = await ctx.management().changeSets.reviews(project, args[0]);
+      emit(
+        reviews,
+        () => table(reviews, [
+          { header: "REVIEWER", value: (r) => `${r.reviewerType}:${r.reviewerId}` },
+          { header: "STATUS", value: (r) => r.status },
+          { header: "STALE", value: (r) => r.stale ? "yes" : "no" },
+          { header: "DECIDED", value: (r) => r.decidedAt ?? "\u2014" }
+        ])
+      );
+    })
+  );
+  changes.command("request-review").description("Assign a reviewer to a change set").argument("<id>", "change set id").requiredOption("--reviewer <id>", "reviewer id (user, api key, or agent id)").option("--reviewer-type <type>", "reviewer actor type", "user").action(
+    handle(async (ctx, args, opts) => {
+      const project = ctx.requireProject();
+      const reviews = await ctx.management().changeSets.requestReview(project, args[0], {
+        reviewerType: opts.reviewerType,
+        reviewerId: opts.reviewer
+      });
+      emit(reviews, () => diag(`Requested review from ${opts.reviewer}.`));
+    })
+  );
+  changes.command("approve").description("Approve a change set").argument("<id>", "change set id").option("--comment <text>", "optional review comment").action(
+    handle(async (ctx, args, opts) => {
+      const project = ctx.requireProject();
+      const reviews = await ctx.management().changeSets.approve(project, args[0], {
+        comment: opts.comment
+      });
+      emit(reviews, () => diag("Approved."));
+    })
+  );
+  changes.command("request-changes").description("Request changes on a change set").argument("<id>", "change set id").option("--comment <text>", "optional review comment").action(
+    handle(async (ctx, args, opts) => {
+      const project = ctx.requireProject();
+      const reviews = await ctx.management().changeSets.requestChanges(project, args[0], {
+        comment: opts.comment
+      });
+      emit(reviews, () => diag("Requested changes."));
+    })
+  );
+  changes.command("comments").description("List comments on a change set").argument("<id>", "change set id").action(
+    handle(async (ctx, args) => {
+      const project = ctx.requireProject();
+      const comments = await ctx.management().changeSets.comments(project, args[0]);
+      emit(
+        comments,
+        () => table(comments, [
+          { header: "AUTHOR", value: (c) => `${c.authorType}:${c.authorId ?? "\u2014"}` },
+          { header: "ANCHOR", value: (c) => c.resourceId ? `${c.resourceId}${c.fieldPath ? `#${c.fieldPath}` : ""}` : "\u2014" },
+          { header: "RESOLVED", value: (c) => c.resolvedAt ? "yes" : "no" },
+          { header: "BODY", value: (c) => c.body.length > 60 ? `${c.body.slice(0, 57)}...` : c.body }
+        ])
+      );
+    })
+  );
+  changes.command("comment").description("Comment on a change set (optionally anchored to a field)").argument("<id>", "change set id").argument("<body>", "comment body").option("--entry <id>", "anchor to an entry in the change set").option("--field <path>", "anchor to a field path, e.g. fields.title").action(
+    handle(async (ctx, args, opts) => {
+      const project = ctx.requireProject();
+      const comment = await ctx.management().changeSets.comment(project, args[0], {
+        body: args[1],
+        resourceType: opts.entry ? "entry" : void 0,
+        resourceId: opts.entry,
+        fieldPath: opts.field
+      });
+      emit(comment, () => diag(`Commented ${comment.id}.`));
+    })
+  );
+  changes.command("checks").description("Show the latest check run for a change set").argument("<id>", "change set id").option("--run", "run checks before showing results", false).action(
+    handle(async (ctx, args, opts) => {
+      const project = ctx.requireProject();
+      const client = ctx.management();
+      const checks = opts.run ? (await client.changeSets.runChecks(project, args[0])).checks : await client.changeSets.checks(project, args[0]);
+      emit(
+        checks,
+        () => table(checks, [
+          { header: "CHECK", value: (c) => c.name },
+          { header: "STATUS", value: (c) => c.status },
+          { header: "STALE", value: (c) => c.stale ? "yes" : "no" },
+          { header: "ISSUES", value: (c) => String(c.details?.length ?? 0) }
+        ])
+      );
+      if (checks.some((c) => c.status === "failed")) process.exitCode = 1;
+    })
+  );
 }
 
 // src/commands/previews.ts
@@ -1893,6 +2181,46 @@ function registerProjects(program) {
       );
     })
   );
+  projects.command("export").description("Export the full project (schemas, entries, asset metadata) as JSON").argument("[project]", "project id or slug").action(
+    handle(async (ctx, args) => {
+      const ref = args[0] ?? ctx.requireProject();
+      const data = await ctx.management().projects.export(ref);
+      process.stdout.write(`${JSON.stringify(data, null, 2)}
+`);
+    })
+  );
+  projects.command("update").description("Update project settings").argument("[project]", "project id or slug").option("--name <name>", "project name").option("--timezone <timezone>", "IANA timezone").option("--public-api <state>", "public API state (on|off)").option("--default-preview-template <template>", "default preview URL template").option("--clear-default-preview-template", "remove the default preview URL template").option("--origins <urls>", "comma-separated allowed origins").option("--clear-origins", "remove all allowed origins").action(
+    handle(async (ctx, args, opts) => {
+      const ref = args[0] ?? ctx.requireProject();
+      const patch = {};
+      if (opts.name !== void 0) patch.name = opts.name;
+      if (opts.timezone !== void 0) patch.timezone = opts.timezone;
+      if (opts.publicApi !== void 0) {
+        const state = String(opts.publicApi).toLowerCase();
+        if (!["on", "off", "true", "false"].includes(state)) {
+          throw new UsageError("--public-api must be on or off.");
+        }
+        patch.publicApiEnabled = state === "on" || state === "true";
+      }
+      if (opts.defaultPreviewTemplate !== void 0 && opts.clearDefaultPreviewTemplate) {
+        throw new UsageError("Use either --default-preview-template or --clear-default-preview-template, not both.");
+      }
+      if (opts.defaultPreviewTemplate !== void 0) {
+        patch.defaultPreviewTemplate = opts.defaultPreviewTemplate;
+      }
+      if (opts.clearDefaultPreviewTemplate) patch.defaultPreviewTemplate = null;
+      if (opts.origins !== void 0 && opts.clearOrigins) {
+        throw new UsageError("Use either --origins or --clear-origins, not both.");
+      }
+      if (opts.origins !== void 0) patch.origins = csv(opts.origins);
+      if (opts.clearOrigins) patch.origins = [];
+      if (Object.keys(patch).length === 0) {
+        throw new UsageError("Specify at least one project setting to update.");
+      }
+      const project = await ctx.management().projects.update(ref, patch);
+      emit(project, () => diag(`Updated ${project.slug}.`));
+    })
+  );
   projects.command("archive").description("Archive a project").argument("[project]", "project id or slug").action(
     handle(async (ctx, args) => {
       const ref = args[0] ?? ctx.requireProject();
@@ -2135,7 +2463,7 @@ function registerBilling(program) {
 }
 
 // src/main.ts
-var VERSION = "0.1.3";
+var VERSION = "0.2.0";
 var GLOBAL_VALUE_FLAGS = /* @__PURE__ */ new Set(["--project", "--organization", "--token", "--api-url"]);
 var GLOBAL_BOOL_FLAGS = /* @__PURE__ */ new Set(["--json", "--no-interactive", "--interactive"]);
 function normalizeGlobals(argv) {