@micacms/runtime 0.4.1 → 0.5.0-rc.2

package/dist/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Reads the content model from `.mica/schema.json` in the content repository.\n * The Astro project writes it. The manifest is untrusted input (another core\n * version, hand-edited or truncated), so it is validated again here.\n */\n\nimport {\n  checkCompatibility,\n  defineSite,\n  isFieldKind,\n  isProtocolManifest,\n  MANIFEST_PATH,\n  PROTOCOL_VERSION,\n  type Collection,\n  type ContentSource,\n  type FieldMap,\n  type Singleton,\n  type Site,\n} from \"@micacms/core\";\n\nexport class SchemaError extends Error {\n  override name = \"SchemaError\";\n}\n\n/** Where a model came from, for logs and the system screen. */\nexport function schemaOrigin(source: ContentSource): string {\n  return `${source.origin}/${MANIFEST_PATH}`;\n}\n\n/**\n * Reads the model from the content repository. A missing file gets a long\n * message because a first deployment hits it.\n */\nexport async function loadSchema(source: ContentSource): Promise<Site> {\n  const origin = schemaOrigin(source);\n\n  let text: string | null;\n  try {\n    text = await source.read(MANIFEST_PATH);\n  } catch (error) {\n    // An unreachable repository is not a bad model; the fixes are different.\n    throw new SchemaError(\n      `Could not read the content model from ${source.origin}.\\n` +\n        `  ${(error as Error).message}\\n` +\n        `  The repository has to be reachable before Mica can start: the model\\n` +\n        `  lives in it, at ${MANIFEST_PATH}.`,\n    );\n  }\n\n  if (text === null) throw new SchemaError(describeMissing(origin));\n\n  let raw: unknown;\n  try {\n    raw = JSON.parse(text);\n  } catch (error) {\n    throw new SchemaError(`${origin} is not valid JSON: ${(error as Error).message}`);\n  }\n\n  return checkSchema(raw, origin);\n}\n\nfunction describeMissing(origin: string): string {\n  return (\n    `No content model at ${origin}.\\n` +\n    `  Mica ships without one — the Astro project defines it and writes it here.\\n` +\n    `  In the project:  npx astro build   (or start the dev server once)\\n` +\n    `  then commit ${MANIFEST_PATH} and push it to the branch Mica is reading.`\n  );\n}\n\n/**\n * Runs the `defineSite` checks, and also refuses an unknown field `kind`, which\n * `defineSite` does not check. This turns a core version mismatch into a\n * startup error, not a later failure on an editor's screen.\n */\nexport function checkSchema(raw: unknown, origin = \"the schema\"): Site {\n  if (raw === null || typeof raw !== \"object\") {\n    throw new SchemaError(`${origin} is ${raw === null ? \"null\" : typeof raw}, expected an object.`);\n  }\n\n  // A bare `{ collections }` without the protocol envelope is also accepted.\n  if (isProtocolManifest(raw)) {\n    const compatibility = checkCompatibility(raw);\n    if (!compatibility.ok && compatibility.reason === \"newer\") {\n      throw new SchemaError(\n        `${origin} follows protocol version ${compatibility.version}; this build of Mica ` +\n          `understands version ${PROTOCOL_VERSION}.\\n` +\n          `  The project was built against a newer @micacms/astro. Upgrade Mica.`,\n      );\n    }\n  }\n\n  const candidate = raw as { collections?: unknown; singletons?: unknown };\n\n  if (candidate.collections === null || typeof candidate.collections !== \"object\") {\n    throw new SchemaError(`${origin} has no \\`collections\\`. Expected defineSite({ collections: { ... } }).`);\n  }\n\n  const rawSingletons = candidate.singletons;\n  if (rawSingletons !== undefined && (rawSingletons === null || typeof rawSingletons !== \"object\")) {\n    throw new SchemaError(`${origin} has a \\`singletons\\` that is not an object.`);\n  }\n\n  const collections = candidate.collections as Record<string, Collection>;\n  const singletons = (rawSingletons ?? {}) as Record<string, Singleton>;\n\n  for (const [name, def] of Object.entries(collections)) {\n    assertFieldMap(def?.fields, `collections.${name}`, origin);\n  }\n  for (const [name, def] of Object.entries(singletons)) {\n    assertFieldMap(def?.fields, `singletons.${name}`, origin);\n  }\n\n  // Drop, do not refuse, a default sort on an undeclared field: only the list order is affected.\n  for (const def of Object.values(collections)) {\n    const field = def?.defaultSort?.field;\n    if (field && field !== \"position\" && !def.fields?.[field]) delete def.defaultSort;\n  }\n\n  try {\n    return defineSite({ collections, singletons });\n  } catch (error) {\n    throw new SchemaError(`${origin} is not a valid content model.\\n  ${(error as Error).message}`);\n  }\n}\n\nfunction assertFieldMap(fields: unknown, at: string, origin: string): void {\n  if (fields === null || typeof fields !== \"object\") {\n    throw new SchemaError(`${origin}: \"${at}\" has no \\`fields\\` object.`);\n  }\n\n  for (const [key, field] of Object.entries(fields as FieldMap)) {\n    const here = `${at}.${key}`;\n\n    if (field === null || typeof field !== \"object\") {\n      throw new SchemaError(`${origin}: field \"${here}\" is not an object.`);\n    }\n    if (!isFieldKind(field.kind)) {\n      throw new SchemaError(\n        `${origin}: field \"${here}\" has unknown kind \"${String(field.kind)}\".\\n` +\n          `  This build of Mica does not support it — the project may have been built\\n` +\n          `  against a newer @micacms/astro than the server is running.`,\n      );\n    }\n    if (field.kind === \"object\" || field.kind === \"repeater\") {\n      assertFieldMap(field.fields, here, origin);\n    }\n  }\n}\n\n/**\n * A short digest of a model, to show drift. Field order counts, because it is\n * the order of the admin form.\n */\nexport async function schemaFingerprint(site: Site): Promise<string> {\n  const { createHash } = await import(\"node:crypto\");\n  return createHash(\"sha256\").update(JSON.stringify(site)).digest(\"hex\").slice(0, 12);\n}\n"]}

package/dist/server.d.ts

@@ -1,11 +1,6 @@
 /**
- * Listening, and stopping.
- *
- * The shared half of every app's entry point: bind the Hono app to a socket,
- * shut down cleanly on SIGTERM/SIGINT, and turn the one most likely first-run
- * failure — a busy port — into a message instead of a stack trace. What the
- * apps keep for themselves is what to *say* when the server is up, because
- * that is where a laptop and a container genuinely differ.
+ * Binds the app to a socket and shuts down cleanly on SIGTERM and SIGINT. Each
+ * app keeps its own startup message.
  */
 import type { Hono } from "hono";
 import type { Env } from "./http.js";
@@ -15,13 +10,10 @@ export interface StartServerOptions {
     host: string;
     port: number;
     logger: Logger;
-    /** Called once the socket is listening — the banner or the log line. */
     onListening(info: {
         port: number;
     }): void;
-    /** The message for a busy port. Defaults to a plain sentence. */
     portInUseMessage?(): string;
-    /** Releases what the composition holds — timers, the database. */
     shutdown(): Promise<void>;
 }
 export declare function startServer(options: StartServerOptions): void;

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,WAAW,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1C,iEAAiE;IACjE,gBAAgB,CAAC,IAAI,MAAM,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CA+C7D"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1C,gBAAgB,CAAC,IAAI,MAAM,CAAC;IAC5B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CA8C7D"}

package/dist/server.js

@@ -1,11 +1,6 @@
 /**
- * Listening, and stopping.
- *
- * The shared half of every app's entry point: bind the Hono app to a socket,
- * shut down cleanly on SIGTERM/SIGINT, and turn the one most likely first-run
- * failure — a busy port — into a message instead of a stack trace. What the
- * apps keep for themselves is what to *say* when the server is up, because
- * that is where a laptop and a container genuinely differ.
+ * Binds the app to a socket and shuts down cleanly on SIGTERM and SIGINT. Each
+ * app keeps its own startup message.
  */
 import { serve } from "@hono/node-server";
 export function startServer(options) {
@@ -25,14 +20,13 @@ export function startServer(options) {
             return;
         shuttingDown = true;
         logger.info("Shutting down", { signal });
-        // Stop accepting connections, then release whatever the app holds.
         server.close(() => {
             void options.shutdown().then(() => {
                 logger.info("Shutdown complete");
                 process.exit(0);
             });
         });
-        // Do not let a hung connection block a container restart indefinitely.
+        // A hung connection must not block a container restart.
         setTimeout(() => {
             logger.warn("Forcing exit after shutdown timeout");
             process.exit(1);

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAmB1C,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAE3B,MAAM,MAAM,GAAG,KAAK,CAClB,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,EACxE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CACnD,CAAC;IAEF,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAA4B,EAAE,EAAE;QAClD,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;YAAE,MAAM,KAAK,CAAC;QAE7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,OAAO,CAAC,gBAAgB,EAAE,EAAE;YAC1B,QAAQ,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,IAAI,qCAAqC;gBAC1E,yBAAyB,CAC9B,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,IAAI,YAAY,GAAG,KAAK,CAAC;IAEzB,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAQ,EAAE;QACxC,IAAI,YAAY;YAAE,OAAO;QACzB,YAAY,GAAG,IAAI,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAEzC,mEAAmE;QACnE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;YAChB,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;gBAChC,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;gBACjC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,uEAAuE;QACvE,UAAU,CAAC,GAAG,EAAE;YACd,MAAM,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;YACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IACjD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE/C,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;QAC1C,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAgB1C,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAE3B,MAAM,MAAM,GAAG,KAAK,CAClB,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,EACxE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CACnD,CAAC;IAEF,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAA4B,EAAE,EAAE;QAClD,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;YAAE,MAAM,KAAK,CAAC;QAE7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,OAAO,CAAC,gBAAgB,EAAE,EAAE;YAC1B,QAAQ,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,IAAI,qCAAqC;gBAC1E,yBAAyB,CAC9B,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,IAAI,YAAY,GAAG,KAAK,CAAC;IAEzB,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAQ,EAAE;QACxC,IAAI,YAAY;YAAE,OAAO;QACzB,YAAY,GAAG,IAAI,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAEzC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;YAChB,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;gBAChC,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;gBACjC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,wDAAwD;QACxD,UAAU,CAAC,GAAG,EAAE;YACd,MAAM,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;YACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IACjD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE/C,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;QAC1C,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["/**\n * Binds the app to a socket and shuts down cleanly on SIGTERM and SIGINT. Each\n * app keeps its own startup message.\n */\n\nimport { serve } from \"@hono/node-server\";\nimport type { Hono } from \"hono\";\n\nimport type { Env } from \"./http.js\";\nimport type { Logger } from \"./lib/logger.js\";\n\nexport interface StartServerOptions {\n  app: Hono<Env>;\n  host: string;\n  port: number;\n  logger: Logger;\n  onListening(info: { port: number }): void;\n  portInUseMessage?(): string;\n  shutdown(): Promise<void>;\n}\n\nexport function startServer(options: StartServerOptions): void {\n  const { logger } = options;\n\n  const server = serve(\n    { fetch: options.app.fetch, hostname: options.host, port: options.port },\n    (info) => options.onListening({ port: info.port }),\n  );\n\n  server.on(\"error\", (error: NodeJS.ErrnoException) => {\n    if (error.code !== \"EADDRINUSE\") throw error;\n\n    process.stderr.write(\n      options.portInUseMessage?.() ??\n        `Port ${options.port} on ${options.host} is already in use. Stop the other ` +\n          `process, or set PORT.\\n`,\n    );\n    process.exit(1);\n  });\n\n  let shuttingDown = false;\n\n  const shutdown = (signal: string): void => {\n    if (shuttingDown) return;\n    shuttingDown = true;\n    logger.info(\"Shutting down\", { signal });\n\n    server.close(() => {\n      void options.shutdown().then(() => {\n        logger.info(\"Shutdown complete\");\n        process.exit(0);\n      });\n    });\n\n    // A hung connection must not block a container restart.\n    setTimeout(() => {\n      logger.warn(\"Forcing exit after shutdown timeout\");\n      process.exit(1);\n    }, 15_000).unref();\n  };\n\n  process.on(\"SIGTERM\", () => shutdown(\"SIGTERM\"));\n  process.on(\"SIGINT\", () => shutdown(\"SIGINT\"));\n\n  process.on(\"unhandledRejection\", (reason) => {\n    logger.error(\"Unhandled promise rejection\", { reason: String(reason) });\n  });\n}\n"]}

package/dist/services/changes.d.ts

@@ -0,0 +1,150 @@
+/** The staging API types, the before/after comparison and the analysis of a pending change set. */
+import type { Author } from "../workspace/files.js";
+import { type ContentChange, type ContentSource, type FieldIssue, type PublishResult, type Site } from "@micacms/core";
+import type { SyncStatus } from "../workspace/policy.js";
+/** Where the change happened, in words an editor recognises. */
+export type ChangeOwner = {
+    kind: "entry";
+    collection: string;
+    slug: string;
+    label: string;
+    /** The slug before a pending rename. Set on the files of both slugs. */
+    renamedFrom?: string;
+} | {
+    kind: "singleton";
+    name: string;
+    label: string;
+} | {
+    kind: "order";
+    collection: string;
+    label: string;
+} | {
+    kind: "media";
+    label: string;
+} | {
+    kind: "other";
+    label: string;
+};
+export interface AnnotatedChange extends ContentChange {
+    owner: ChangeOwner;
+    /**
+     * The file's revision, null for a deletion. Publish sends it back, so a file
+     * saved after the review is not published unseen.
+     */
+    revision?: string | null;
+}
+/** One thing that would make the staged result unpublishable. */
+export interface StagingProblem {
+    /** The file the problem is about, relative to the content root. */
+    path: string;
+    label: string;
+    issues: FieldIssue[];
+}
+export interface StagingValidation {
+    ok: boolean;
+    problems: StagingProblem[];
+}
+export interface StagingStatus {
+    /** Whose working tree it is. The UI wording changes with it. */
+    owner: "developer" | "managed";
+    publish: {
+        enabled: boolean;
+        reason?: string;
+    };
+    /** The commit the pending changes sit on. */
+    head: string | null;
+    /** The branch a publication lands on, where the workspace knows it. */
+    branch: string | null;
+    /** Commits created and not yet pushed. */
+    ahead: number | null;
+    changes: AnnotatedChange[];
+    validation: StagingValidation;
+    /** Where a clone that Mica keeps stands against its remote. Null for the developer's checkout. */
+    sync: SyncStatus | null;
+}
+export interface PublishInput {
+    /** Subject line of the commit. */
+    message: string;
+    /**
+     * The reviewed paths, with the revision each had in the review. Only these
+     * are published; a file saved again since, or another file of the same entry,
+     * makes Publish refuse.
+     */
+    paths: Record<string, string | null>;
+    author?: Author;
+}
+/** What the System page shows about the repository. */
+export interface RepositoryInfo {
+    owner: "developer" | "managed";
+    branch: string | null;
+    head: string | null;
+    /** The remote, for a clone that Mica keeps. */
+    url: string | null;
+    cloneBytes: number | null;
+    sync: SyncStatus | null;
+}
+export interface ContentStagingService {
+    status(): Promise<StagingStatus>;
+    publish(input: PublishInput): Promise<PublishResult>;
+    discard(paths: string[]): Promise<{
+        discarded: string[];
+    }>;
+    /** Retries the push after `committed-pending-push`. */
+    push(): Promise<PublishResult>;
+    /**
+     * A document before and after a pending change. `origin` compares against the
+     * website's version, not the last commit.
+     */
+    compare(target: CompareTarget, against?: "head" | "origin"): Promise<Comparison>;
+    /** Brings a clone that Mica keeps up to date now. Refused for the developer's checkout. */
+    sync(): Promise<void>;
+    resolve(group: string, choice: "mine" | "website"): Promise<void>;
+    repository(): Promise<RepositoryInfo>;
+}
+/** What to compare on the Publish page. */
+export type CompareTarget = 
+/** `from` names the published slug of a renamed entry. */
+{
+    kind: "entry";
+    collection: string;
+    slug: string;
+    from?: string;
+} | {
+    kind: "singleton";
+    name: string;
+} | {
+    kind: "order";
+    collection: string;
+};
+/**
+ * Raw field data on both sides of a pending change. The editor renders the
+ * comparison from the model.
+ */
+export interface Comparison {
+    /** As the repository has it — null when the change creates the document. */
+    before: Record<string, unknown> | null;
+    /** As staged for publication — null when the change deletes it. */
+    after: Record<string, unknown> | null;
+}
+/**
+ * Reads one document from `published` and from `staged`. An order target
+ * becomes `{ order: [{ slug, title }] }` on each side, in position order.
+ */
+export declare function compareSources(model: Site, published: ContentSource, staged: ContentSource, target: CompareTarget): Promise<Comparison>;
+/**
+ * Annotates a change set with owners and validates the entries it touches, in
+ * one read of the affected collections. Only changed documents are validated: a
+ * broken entry committed earlier must not block an unrelated publication.
+ */
+export declare function analyseChanges(model: Site, source: ContentSource, changes: ContentChange[], 
+/** The repository's side. When given, renamed entries are detected. */
+published?: ContentSource): Promise<{
+    changes: AnnotatedChange[];
+    validation: StagingValidation;
+}>;
+/** Which piece of content a file belongs to, read from the model's path layout. */
+export declare function classifyPath(model: Site, path: string): ChangeOwner;
+export declare function describeProblems(problems: StagingProblem[]): string;
+/** Field issues with the file path folded in, for the flat API envelope. */
+export declare function flattenProblems(problems: StagingProblem[]): FieldIssue[];
+//# sourceMappingURL=changes.d.ts.map

package/dist/services/changes.d.ts.map

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

package/dist/services/changes.js

@@ -0,0 +1,339 @@
+/** The staging API types, the before/after comparison and the analysis of a pending change set. */
+import { ORDER_FILE, collectionEntryPath, entryLayout, entryTitle, isValidSlug, readCollection, readCollectionEntry, readSingleton, relativizeMedia, resolveSlugField, singletonPath, validateFields, } from "@micacms/core";
+import { badRequest } from "../lib/errors.js";
+/**
+ * Reads one document from `published` and from `staged`. An order target
+ * becomes `{ order: [{ slug, title }] }` on each side, in position order.
+ */
+export async function compareSources(model, published, staged, target) {
+    if (target.kind === "singleton") {
+        const def = model.singletons[target.name];
+        if (!def)
+            throw badRequest(`There is no singleton called "${target.name}".`);
+        return {
+            before: await readSingleton(published, def, target.name),
+            after: await readSingleton(staged, def, target.name),
+        };
+    }
+    const def = model.collections[target.collection];
+    if (!def)
+        throw badRequest(`There is no collection called "${target.collection}".`);
+    if (target.kind === "entry") {
+        const from = target.from ?? target.slug;
+        for (const slug of [target.slug, from]) {
+            if (!isValidSlug(slug))
+                throw badRequest(`"${slug}" is not a slug.`);
+        }
+        const before = await readCollectionEntry(published, def, target.collection, from);
+        const after = await readCollectionEntry(staged, def, target.collection, target.slug);
+        if (from === target.slug)
+            return { before, after };
+        // A rename: compare the on-disk form, where colocated media paths do not
+        // name the entry's folder.
+        return {
+            before: before && onDisk(def, target.collection, from, before),
+            after: after && onDisk(def, target.collection, target.slug, after),
+        };
+    }
+    const ordering = async (source) => {
+        const entries = await readCollection(source, def, target.collection);
+        if (entries.length === 0)
+            return null;
+        return {
+            order: entries.map((entry) => ({ slug: entry.slug, title: entryTitle(def, entry.data) })),
+        };
+    };
+    return { before: await ordering(published), after: await ordering(staged) };
+}
+/**
+ * Annotates a change set with owners and validates the entries it touches, in
+ * one read of the affected collections. Only changed documents are validated: a
+ * broken entry committed earlier must not block an unrelated publication.
+ */
+export async function analyseChanges(model, source, changes, 
+/** The repository's side. When given, renamed entries are detected. */
+published) {
+    const owners = changes.map((change) => classifyPath(model, change.path));
+    const collectionsToRead = new Set();
+    for (const owner of owners) {
+        if (owner.kind === "entry" || owner.kind === "order")
+            collectionsToRead.add(owner.collection);
+    }
+    const problems = [];
+    const titles = new Map();
+    const entriesByCollection = new Map();
+    for (const name of collectionsToRead) {
+        const def = model.collections[name];
+        try {
+            const entries = await readCollection(source, def, name);
+            const bySlug = new Map(entries.map((entry) => [entry.slug, entry.data]));
+            entriesByCollection.set(name, bySlug);
+            for (const [slug, data] of bySlug)
+                titles.set(`${name}/${slug}`, entryTitle(def, data));
+        }
+        catch (error) {
+            // An unreadable collection, possibly from an untouched file, is a problem
+            // at the path it names.
+            const path = error.path ?? name;
+            problems.push({
+                path,
+                label: def.label,
+                issues: [{ path: "", message: error.message }],
+            });
+        }
+    }
+    if (published) {
+        await detectRenames(model, published, source, changes, owners, entriesByCollection);
+    }
+    const validated = new Set();
+    for (const owner of owners) {
+        if (owner.kind === "entry") {
+            const key = `${owner.collection}/${owner.slug}`;
+            if (validated.has(key))
+                continue;
+            validated.add(key);
+            const def = model.collections[owner.collection];
+            // Absent means the change set deletes this entry.
+            const data = entriesByCollection.get(owner.collection)?.get(owner.slug);
+            if (!data)
+                continue;
+            const result = validateFields(def.fields, data, "storage");
+            if (!result.ok) {
+                problems.push({
+                    path: entryDataPath(def, owner.collection, owner.slug),
+                    label: labelEntry(def, owner.slug, titles.get(key)),
+                    issues: result.issues,
+                });
+            }
+        }
+        if (owner.kind === "singleton" && !validated.has(`singleton:${owner.name}`)) {
+            validated.add(`singleton:${owner.name}`);
+            const def = model.singletons[owner.name];
+            const dataPath = singletonPath(def.fields, owner.name);
+            try {
+                const data = await readSingleton(source, def, owner.name);
+                if (data === null)
+                    continue;
+                const result = validateFields(def.fields, data, "storage");
+                if (!result.ok) {
+                    problems.push({ path: dataPath, label: def.label, issues: result.issues });
+                }
+            }
+            catch (error) {
+                problems.push({
+                    path: error.path ?? dataPath,
+                    label: def.label,
+                    issues: [{ path: "", message: error.message }],
+                });
+            }
+        }
+    }
+    const annotated = changes.map((change, index) => {
+        const owner = owners[index];
+        if (owner.kind === "entry") {
+            const def = model.collections[owner.collection];
+            return {
+                ...change,
+                owner: { ...owner, label: labelEntry(def, owner.slug, titles.get(`${owner.collection}/${owner.slug}`)) },
+            };
+        }
+        return { ...change, owner };
+    });
+    return {
+        changes: annotated,
+        validation: { ok: problems.length === 0, problems },
+    };
+}
+/** Which piece of content a file belongs to, read from the model's path layout. */
+export function classifyPath(model, path) {
+    const segments = path.split("/");
+    const head = segments[0] ?? "";
+    const collection = model.collections[head];
+    if (collection && segments.length > 1) {
+        if (segments.length === 2 && segments[1] === ORDER_FILE) {
+            return { kind: "order", collection: head, label: `${collection.label}: order` };
+        }
+        if (entryLayout(collection.fields) === "directory") {
+            const slug = segments[1];
+            if (segments.length >= 3 && isValidSlug(slug)) {
+                return { kind: "entry", collection: head, slug, label: slug };
+            }
+        }
+        else if (segments.length === 2 && segments[1].endsWith(".json")) {
+            const slug = segments[1].slice(0, -".json".length);
+            if (isValidSlug(slug))
+                return { kind: "entry", collection: head, slug, label: slug };
+        }
+    }
+    const singletonDir = model.singletons[head];
+    if (singletonDir && segments.length > 1) {
+        return { kind: "singleton", name: head, label: singletonDir.label };
+    }
+    if (head.endsWith(".json")) {
+        const name = head.slice(0, -".json".length);
+        const singleton = model.singletons[name];
+        if (singleton && segments.length === 1) {
+            return { kind: "singleton", name, label: singleton.label };
+        }
+    }
+    if (head === "media")
+        return { kind: "media", label: "Shared media" };
+    return { kind: "other", label: path };
+}
+/** Content share that two versions of an entry need to count as one moved entry, as in Git. */
+const RENAME_SIMILARITY = 0.5;
+/**
+ * Marks renamed entries in place in `owners`. An entry has no identity but its
+ * slug, so deleted and created entries are paired by content, like Git's rename
+ * detection. An order file whose only change is the renamed slug joins the
+ * entry, so a discard cannot leave the order naming a slug that does not exist.
+ */
+async function detectRenames(model, published, source, changes, owners, staged) {
+    const kinds = new Map();
+    owners.forEach((owner, index) => {
+        if (owner.kind !== "entry")
+            return;
+        const bySlug = kinds.get(owner.collection) ?? new Map();
+        kinds.set(owner.collection, bySlug);
+        const set = bySlug.get(owner.slug) ?? new Set();
+        bySlug.set(owner.slug, set);
+        set.add(changes[index].kind);
+    });
+    for (const [name, bySlug] of kinds) {
+        const after = staged.get(name);
+        if (!after)
+            continue;
+        const only = (kind) => [...bySlug].filter(([, set]) => set.size === 1 && set.has(kind)).map(([slug]) => slug);
+        const deleted = only("delete").filter((slug) => !after.has(slug));
+        const created = only("create").filter((slug) => after.has(slug));
+        if (deleted.length === 0 || created.length === 0)
+            continue;
+        const def = model.collections[name];
+        let before;
+        try {
+            const entries = await readCollection(published, def, name);
+            before = new Map(entries.map((entry) => [entry.slug, entry.data]));
+        }
+        catch {
+            continue;
+        }
+        const candidates = [];
+        for (const from of deleted) {
+            const old = before.get(from);
+            if (!old)
+                continue;
+            for (const to of created) {
+                if (before.has(to))
+                    continue;
+                const score = similarity(def, onDisk(def, name, from, old), onDisk(def, name, to, after.get(to)));
+                if (score >= RENAME_SIMILARITY)
+                    candidates.push({ from, to, score });
+            }
+        }
+        const renamedTo = new Map();
+        const paired = new Set();
+        for (const { from, to } of candidates.sort((a, b) => b.score - a.score)) {
+            if (renamedTo.has(from) || paired.has(to))
+                continue;
+            renamedTo.set(from, to);
+            paired.add(to);
+        }
+        if (renamedTo.size === 0)
+            continue;
+        const renamedFrom = new Map([...renamedTo].map(([from, to]) => [to, from]));
+        const orderMovesOnlySlugs = await onlyRenamedInOrder(published, source, name, renamedTo);
+        const [firstFrom, firstTo] = [...renamedTo][0];
+        owners.forEach((owner, index) => {
+            if (owner.kind === "order" && owner.collection === name && orderMovesOnlySlugs) {
+                owners[index] = {
+                    kind: "entry",
+                    collection: name,
+                    slug: firstTo,
+                    label: firstTo,
+                    renamedFrom: firstFrom,
+                };
+            }
+            if (owner.kind !== "entry" || owner.collection !== name)
+                return;
+            const to = renamedTo.get(owner.slug);
+            if (to)
+                owners[index] = { ...owner, slug: to, label: to, renamedFrom: owner.slug };
+            const from = renamedFrom.get(owner.slug);
+            if (from)
+                owners[index] = { ...owner, renamedFrom: from };
+        });
+    }
+}
+/** True when a collection's staged order is the published one with the renamed slugs replaced. */
+async function onlyRenamedInOrder(published, staged, name, renamedTo) {
+    const path = `${name}/${ORDER_FILE}`;
+    const parse = (raw) => {
+        try {
+            return raw === null ? null : JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    };
+    const before = parse(await published.read(path));
+    const after = parse(await staged.read(path));
+    if (!Array.isArray(before) || !Array.isArray(after))
+        return false;
+    const expected = before.map((slug) => typeof slug === "string" ? (renamedTo.get(slug) ?? slug) : slug);
+    return canonical(expected) === canonical(after);
+}
+/** The share of non-empty fields, the slug aside, that two versions of an entry agree on. */
+function similarity(def, a, b) {
+    const slugKey = resolveSlugField(def);
+    let compared = 0;
+    let equal = 0;
+    for (const key of Object.keys(def.fields)) {
+        if (key === slugKey || (isEmpty(a[key]) && isEmpty(b[key])))
+            continue;
+        compared += 1;
+        if (canonical(a[key]) === canonical(b[key]))
+            equal += 1;
+    }
+    return compared === 0 ? 0 : equal / compared;
+}
+/**
+ * Entry data with media paths as the files store them: relative to the entry,
+ * where it has a folder.
+ */
+function onDisk(def, collection, slug, data) {
+    return entryLayout(def.fields) === "directory"
+        ? relativizeMedia(def.fields, data, collectionEntryPath(def.fields, collection, slug))
+        : data;
+}
+function isEmpty(value) {
+    return value === undefined || value === null || value === "" || (Array.isArray(value) && value.length === 0);
+}
+/** JSON with sorted keys, so two equal objects compare equal. */
+function canonical(value) {
+    return JSON.stringify(value ?? null, (_key, entry) => {
+        if (entry === null || typeof entry !== "object" || Array.isArray(entry))
+            return entry;
+        const record = entry;
+        return Object.fromEntries(Object.keys(record).sort().map((key) => [key, record[key]]));
+    });
+}
+function labelEntry(def, slug, title) {
+    return `${def.labelSingular ?? def.label}: ${title ?? slug}`;
+}
+function entryDataPath(def, collection, slug) {
+    const base = collectionEntryPath(def.fields, collection, slug);
+    return entryLayout(def.fields) === "directory" ? `${base}/index.json` : base;
+}
+export function describeProblems(problems) {
+    const names = problems.map((problem) => problem.label);
+    const listed = names.slice(0, 3).join(", ") + (names.length > 3 ? ", …" : "");
+    return `The pending changes cannot be published until they are valid: ${listed}.`;
+}
+/** Field issues with the file path folded in, for the flat API envelope. */
+export function flattenProblems(problems) {
+    return problems.flatMap((problem) => problem.issues.map((issue) => ({
+        path: issue.path ? `${problem.path}: ${issue.path}` : problem.path,
+        message: issue.message,
+    })));
+}
+//# sourceMappingURL=changes.js.map