@sanity/cli 8.22.1 → 8.23.0

package/dist/actions/media/aspectSync/contract.js

@@ -0,0 +1,163 @@
+/**
+ * The Media Library configuration lifecycle — pure serialization and mirror
+ * semantics, vendored from huey's `@repo/media-library-config` (the package
+ * that proved the contract). Keep the two copies behaviorally identical until
+ * huey's standalone sync bin is retired in favor of `sanity deploy`.
+ *
+ * A media library's aspect fields are declared as *field modules* in a config
+ * app's `sanity.cli.ts` (`unstable_defineMediaLibrary({fields: [...]})`).
+ * Environments that evaluate the config app live (the Workbench) get the full
+ * definitions — custom inputs, validation callbacks, initial-value resolvers.
+ * Everything else (Studio plugin mode, standalone dashboard, Gradient) reads
+ * stored `sanity.asset.aspect` documents instead.
+ *
+ * This module owns the contract between those two worlds:
+ *
+ * - **Serialization** (`serializeField`): field modules are live JS, stored
+ *   aspect documents are JSON. Literal values pass through; functions and
+ *   component references are stripped deterministically, with every stripped
+ *   path reported so the capability gap is explicit.
+ * - **Mirror semantics** (`computeMirrorDiff`, `buildSyncMutations`): the
+ *   config app is the source of truth for the aspect namespace. A sync
+ *   upserts every config field; stored aspect documents without a matching
+ *   config field are *stale* and are deleted to complete the mirror. Deleting
+ *   an aspect document removes the definition, not asset data — values remain
+ *   on assets under `aspects.<name>` and reappear if the field is restored.
+ *
+ * This module is pure (no I/O); composition with the CLI's API services lives
+ * in `./syncAspects.ts`.
+ */ import { VALID_ASPECT_NAME } from '../aspectName.js';
+/** The document type stored aspect definitions use. */ export const ASPECT_TYPE = 'sanity.asset.aspect';
+/**
+ * Serialize a field module's live `defineField(...)` value into a stored
+ * aspect document.
+ *
+ * The `_id` convention is the field/aspect name, matching the legacy
+ * `sanity media deploy-aspect` command (its delete targets `id == name`).
+ */ export function serializeField(entry, definition) {
+    if (!VALID_ASPECT_NAME.test(entry.name)) {
+        throw new Error(`"${entry.name}" is not a valid aspect name (${VALID_ASPECT_NAME}) — it becomes the document _id and the aspects.<name> key on assets`);
+    }
+    if (!definition || typeof definition !== 'object' || typeof definition.name !== 'string' || typeof definition.type !== 'string') {
+        throw new Error(`Field "${entry.name}" must be a defineField(...) value (an object with name and type)`);
+    }
+    const definitionName = definition.name;
+    // A mismatch must not serialize: `entry.name` becomes the document _id
+    // (mirror upserts/deletes) while `definition.name` becomes the
+    // aspects.<name> data key on assets — a document carrying both would have
+    // its data under one name and its lifecycle under another.
+    if (definitionName !== entry.name) {
+        throw new Error(`Field "${entry.name}": its field module defines name "${definitionName}" — the names must match`);
+    }
+    const stripped = [];
+    const serialized = serializeValue(definition, 'definition', stripped);
+    return {
+        document: {
+            _id: entry.name,
+            _type: ASPECT_TYPE,
+            definition: serialized,
+            // Strict boolean check, mirroring the read-side guard in the Media
+            // Library app: `entry` is a runtime value from a config app, and a
+            // mistyped `public: 'false'` must not serialize into the stored doc
+            // where later Boolean(...) coercion would flip the aspect to public.
+            ...typeof entry.public === 'boolean' ? {
+                public: entry.public
+            } : {}
+        },
+        stripped
+    };
+}
+/**
+ * Deterministic strip rule: literal values pass through; functions (initial
+ * value resolvers, validation callbacks, input components) and other
+ * non-JSON values are dropped with their path recorded. The `components` key
+ * is dropped wholesale — it is UI-only and never meaningful in a stored doc.
+ *
+ * `ancestors` holds the objects on the current recursion path: revisiting one
+ * means a cycle, which is stripped like any other non-JSON value (instead of
+ * overflowing the stack). Shared acyclic references serialize at every site.
+ */ function serializeValue(value, atPath, stripped, ancestors = new Set()) {
+    if (value === null) return null;
+    const kind = typeof value;
+    if (kind === 'string' || kind === 'number' || kind === 'boolean') return value;
+    if (kind === 'function' || kind === 'symbol' || kind === 'bigint' || kind === 'undefined') {
+        stripped.push(atPath);
+        return undefined;
+    }
+    if (ancestors.has(value)) {
+        stripped.push(atPath);
+        return undefined;
+    }
+    if (Array.isArray(value)) {
+        ancestors.add(value);
+        const out = [];
+        for (const [index, item] of value.entries()){
+            const serialized = serializeValue(item, `${atPath}[${index}]`, stripped, ancestors);
+            if (serialized !== undefined) out.push(serialized);
+        }
+        ancestors.delete(value);
+        return out;
+    }
+    if (kind === 'object') {
+        // React elements / memo components etc. are tagged objects, not plain data
+        if (value.$$typeof) {
+            stripped.push(atPath);
+            return undefined;
+        }
+        // Dates, RegExps, Maps etc. would walk to `{}` (no enumerable own keys)
+        // without ever being reported — strip anything that isn't a plain object
+        // so the "every stripped path reported" contract holds.
+        const proto = Object.getPrototypeOf(value);
+        if (proto !== Object.prototype && proto !== null) {
+            stripped.push(atPath);
+            return undefined;
+        }
+        ancestors.add(value);
+        const out = {};
+        for (const [key, entryValue] of Object.entries(value)){
+            if (key === 'components') {
+                stripped.push(`${atPath}.components`);
+                continue;
+            }
+            const serialized = serializeValue(entryValue, `${atPath}.${key}`, stripped, ancestors);
+            if (serialized !== undefined) out[key] = serialized;
+        }
+        ancestors.delete(value);
+        return out;
+    }
+    stripped.push(atPath);
+    return undefined;
+}
+/**
+ * Mirror semantics: given the documents a config declares and the ids stored
+ * in the library, compute which stored documents are stale (present in the
+ * library, absent from the config) and must be deleted for the library to
+ * mirror the config.
+ */ export function computeMirrorDiff(configDocuments, storedIds) {
+    const configIds = new Set(configDocuments.map((doc)=>doc._id));
+    return {
+        staleIds: storedIds.filter((id)=>!configIds.has(id))
+    };
+}
+/**
+ * Build the mutation transaction for one sync: upsert every config document,
+ * delete every stale stored document. The delete shape matches the CLI's
+ * `deleteAspect` (`sanity media delete-aspect`).
+ */ export function buildSyncMutations(configDocuments, staleIds) {
+    return [
+        ...configDocuments.map((document)=>({
+                createOrReplace: document
+            })),
+        ...staleIds.map((id)=>({
+                delete: {
+                    params: {
+                        id,
+                        type: ASPECT_TYPE
+                    },
+                    query: `*[_type == $type && _id == $id]`
+                }
+            }))
+    ];
+}
+
+//# sourceMappingURL=contract.js.map

package/dist/actions/media/aspectSync/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/actions/media/aspectSync/contract.ts"],"sourcesContent":["/**\n * The Media Library configuration lifecycle — pure serialization and mirror\n * semantics, vendored from huey's `@repo/media-library-config` (the package\n * that proved the contract). Keep the two copies behaviorally identical until\n * huey's standalone sync bin is retired in favor of `sanity deploy`.\n *\n * A media library's aspect fields are declared as *field modules* in a config\n * app's `sanity.cli.ts` (`unstable_defineMediaLibrary({fields: [...]})`).\n * Environments that evaluate the config app live (the Workbench) get the full\n * definitions — custom inputs, validation callbacks, initial-value resolvers.\n * Everything else (Studio plugin mode, standalone dashboard, Gradient) reads\n * stored `sanity.asset.aspect` documents instead.\n *\n * This module owns the contract between those two worlds:\n *\n * - **Serialization** (`serializeField`): field modules are live JS, stored\n *   aspect documents are JSON. Literal values pass through; functions and\n *   component references are stripped deterministically, with every stripped\n *   path reported so the capability gap is explicit.\n * - **Mirror semantics** (`computeMirrorDiff`, `buildSyncMutations`): the\n *   config app is the source of truth for the aspect namespace. A sync\n *   upserts every config field; stored aspect documents without a matching\n *   config field are *stale* and are deleted to complete the mirror. Deleting\n *   an aspect document removes the definition, not asset data — values remain\n *   on assets under `aspects.<name>` and reappear if the field is restored.\n *\n * This module is pure (no I/O); composition with the CLI's API services lives\n * in `./syncAspects.ts`.\n */\n\nimport {VALID_ASPECT_NAME} from '../aspectName.js'\n\n/** The document type stored aspect definitions use. */\nexport const ASPECT_TYPE = 'sanity.asset.aspect'\n\n/**\n * A field entry as declared in a media-library config app's `sanity.cli.ts`.\n */\nexport interface FieldEntry {\n  name: string\n  src: string\n\n  public?: boolean\n  title?: string\n}\n\n/**\n * The `sanity.asset.aspect` *write payload* produced by a sync.\n *\n * This is deliberately not `MediaLibraryAssetAspectDocument` from\n * `@sanity/types` — that is the read-side type: it carries required\n * server-assigned `_rev`/`_createdAt`/`_updatedAt` (which a to-be-written\n * document does not have) and types `definition` as a full `FieldDefinition`,\n * which the serializer's stripped-JSON output is only guaranteed to be after\n * schema validation. Read-side documents can be passed to\n * {@link computeMirrorDiff} (it only needs ids), but upserts via\n * {@link buildSyncMutations} require this write shape — echoing read-side\n * server metadata back into a `createOrReplace` would be a bug.\n */\nexport interface AspectDocument {\n  _id: string\n  _type: typeof ASPECT_TYPE\n  definition: Record<string, unknown>\n\n  public?: boolean\n}\n\n/**\n * Result of serializing a live field definition into a stored document.\n */\nexport interface SerializedField {\n  document: AspectDocument\n  /** Dot-paths of values dropped because they are not JSON-serializable. */\n  stripped: string[]\n}\n\n/** One mutation in a sync transaction (see {@link buildSyncMutations}). */\nexport type SyncMutation =\n  | {createOrReplace: AspectDocument}\n  | {delete: {params: {id: string; type: string}; query: string}}\n\n/**\n * Serialize a field module's live `defineField(...)` value into a stored\n * aspect document.\n *\n * The `_id` convention is the field/aspect name, matching the legacy\n * `sanity media deploy-aspect` command (its delete targets `id == name`).\n */\nexport function serializeField(entry: FieldEntry, definition: unknown): SerializedField {\n  if (!VALID_ASPECT_NAME.test(entry.name)) {\n    throw new Error(\n      `\"${entry.name}\" is not a valid aspect name (${VALID_ASPECT_NAME}) — it becomes the document _id and the aspects.<name> key on assets`,\n    )\n  }\n  if (\n    !definition ||\n    typeof definition !== 'object' ||\n    typeof (definition as {name?: unknown}).name !== 'string' ||\n    typeof (definition as {type?: unknown}).type !== 'string'\n  ) {\n    throw new Error(\n      `Field \"${entry.name}\" must be a defineField(...) value (an object with name and type)`,\n    )\n  }\n\n  const definitionName = (definition as {name: string}).name\n  // A mismatch must not serialize: `entry.name` becomes the document _id\n  // (mirror upserts/deletes) while `definition.name` becomes the\n  // aspects.<name> data key on assets — a document carrying both would have\n  // its data under one name and its lifecycle under another.\n  if (definitionName !== entry.name) {\n    throw new Error(\n      `Field \"${entry.name}\": its field module defines name \"${definitionName}\" — the names must match`,\n    )\n  }\n\n  const stripped: string[] = []\n  const serialized = serializeValue(definition, 'definition', stripped) as Record<string, unknown>\n\n  return {\n    document: {\n      _id: entry.name,\n      _type: ASPECT_TYPE,\n      definition: serialized,\n      // Strict boolean check, mirroring the read-side guard in the Media\n      // Library app: `entry` is a runtime value from a config app, and a\n      // mistyped `public: 'false'` must not serialize into the stored doc\n      // where later Boolean(...) coercion would flip the aspect to public.\n      ...(typeof entry.public === 'boolean' ? {public: entry.public} : {}),\n    },\n    stripped,\n  }\n}\n\n/**\n * Deterministic strip rule: literal values pass through; functions (initial\n * value resolvers, validation callbacks, input components) and other\n * non-JSON values are dropped with their path recorded. The `components` key\n * is dropped wholesale — it is UI-only and never meaningful in a stored doc.\n *\n * `ancestors` holds the objects on the current recursion path: revisiting one\n * means a cycle, which is stripped like any other non-JSON value (instead of\n * overflowing the stack). Shared acyclic references serialize at every site.\n */\nfunction serializeValue(\n  value: unknown,\n  atPath: string,\n  stripped: string[],\n  ancestors: Set<object> = new Set(),\n): unknown {\n  if (value === null) return null\n  const kind = typeof value\n  if (kind === 'string' || kind === 'number' || kind === 'boolean') return value\n  if (kind === 'function' || kind === 'symbol' || kind === 'bigint' || kind === 'undefined') {\n    stripped.push(atPath)\n    return undefined\n  }\n  if (ancestors.has(value as object)) {\n    stripped.push(atPath)\n    return undefined\n  }\n  if (Array.isArray(value)) {\n    ancestors.add(value)\n    const out: unknown[] = []\n    for (const [index, item] of value.entries()) {\n      const serialized = serializeValue(item, `${atPath}[${index}]`, stripped, ancestors)\n      if (serialized !== undefined) out.push(serialized)\n    }\n    ancestors.delete(value)\n    return out\n  }\n  if (kind === 'object') {\n    // React elements / memo components etc. are tagged objects, not plain data\n    if ((value as {$$typeof?: unknown}).$$typeof) {\n      stripped.push(atPath)\n      return undefined\n    }\n    // Dates, RegExps, Maps etc. would walk to `{}` (no enumerable own keys)\n    // without ever being reported — strip anything that isn't a plain object\n    // so the \"every stripped path reported\" contract holds.\n    const proto = Object.getPrototypeOf(value) as object | null\n    if (proto !== Object.prototype && proto !== null) {\n      stripped.push(atPath)\n      return undefined\n    }\n    ancestors.add(value as object)\n    const out: Record<string, unknown> = {}\n    for (const [key, entryValue] of Object.entries(value as Record<string, unknown>)) {\n      if (key === 'components') {\n        stripped.push(`${atPath}.components`)\n        continue\n      }\n      const serialized = serializeValue(entryValue, `${atPath}.${key}`, stripped, ancestors)\n      if (serialized !== undefined) out[key] = serialized\n    }\n    ancestors.delete(value as object)\n    return out\n  }\n  stripped.push(atPath)\n  return undefined\n}\n\n/**\n * Mirror semantics: given the documents a config declares and the ids stored\n * in the library, compute which stored documents are stale (present in the\n * library, absent from the config) and must be deleted for the library to\n * mirror the config.\n */\nexport function computeMirrorDiff(\n  configDocuments: readonly {_id: string}[],\n  storedIds: readonly string[],\n): {staleIds: string[]} {\n  const configIds = new Set(configDocuments.map((doc) => doc._id))\n  return {staleIds: storedIds.filter((id) => !configIds.has(id))}\n}\n\n/**\n * Build the mutation transaction for one sync: upsert every config document,\n * delete every stale stored document. The delete shape matches the CLI's\n * `deleteAspect` (`sanity media delete-aspect`).\n */\nexport function buildSyncMutations(\n  configDocuments: readonly AspectDocument[],\n  staleIds: readonly string[],\n): SyncMutation[] {\n  return [\n    ...configDocuments.map((document) => ({createOrReplace: document})),\n    ...staleIds.map((id) => ({\n      delete: {\n        params: {id, type: ASPECT_TYPE},\n        query: `*[_type == $type && _id == $id]`,\n      },\n    })),\n  ]\n}\n"],"names":["VALID_ASPECT_NAME","ASPECT_TYPE","serializeField","entry","definition","test","name","Error","type","definitionName","stripped","serialized","serializeValue","document","_id","_type","public","value","atPath","ancestors","Set","kind","push","undefined","has","Array","isArray","add","out","index","item","entries","delete","$$typeof","proto","Object","getPrototypeOf","prototype","key","entryValue","computeMirrorDiff","configDocuments","storedIds","configIds","map","doc","staleIds","filter","id","buildSyncMutations","createOrReplace","params","query"],"mappings":"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"}

package/dist/actions/media/aspectSync/syncAspects.js

@@ -0,0 +1,115 @@
+/**
+ * Composition of the pure aspect-sync contract (`./contract.ts`) with the
+ * CLI's Media Library API services, for `sanity deploy` of a media-library
+ * config app.
+ *
+ * Split into a read-only **plan** and a mutating **apply** so the deploy flow
+ * can report the plan — including the deletion list — in both dry-run and
+ * real mode before anything is written:
+ *
+ * - {@link planAspectSync}: evaluate + serialize + validate every config
+ *   field module, resolve the target media library, and diff against the
+ *   stored aspect ids. No mutations.
+ * - {@link applyAspectSync}: apply the plan's upserts and deletes as one
+ *   mutation transaction.
+ */ import path from 'node:path';
+import { exitCodes, importModule } from '@sanity/cli-core';
+import { validateMediaLibraryAssetAspect } from '@sanity/schema/_internal';
+import { getStoredAspectIds, mutateAspects } from '../../../services/mediaLibraries.js';
+import { resolveMediaLibrary } from '../resolveMediaLibraryId.js';
+import { buildSyncMutations, computeMirrorDiff, serializeField } from './contract.js';
+/**
+ * Build the sync plan: evaluate, serialize, and schema-validate every field
+ * module before touching the network, then resolve the target library and
+ * diff against its stored aspect ids. Read-only.
+ */ export async function planAspectSync(options) {
+    const { fields, mediaLibraryId: explicitMediaLibraryId, organizationId, workDir } = options;
+    // Evaluate + serialize + validate every field module before touching the
+    // network, collecting all failures so one broken module doesn't hide the next.
+    const documents = [];
+    const strippedByField = {};
+    const failures = [];
+    for (const entry of fields){
+        try {
+            // jsx: fields may be .tsx modules (custom input components) — the
+            // template ships one — and jiti does not parse JSX by default.
+            const definition = await importModule(path.resolve(workDir, entry.src), {
+                jsx: true
+            });
+            const { document, stripped } = serializeField(entry, definition);
+            const [valid, validationErrors] = validateMediaLibraryAssetAspect(document.definition);
+            if (!valid) {
+                const messages = validationErrors.flat().map((problem)=>problem.message);
+                failures.push(`${entry.name}: schema validation failed: ${messages.join('; ')}`);
+                continue;
+            }
+            documents.push(document);
+            if (stripped.length > 0) strippedByField[entry.name] = stripped;
+        } catch (error) {
+            failures.push(`${entry.name}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    if (failures.length > 0) {
+        return {
+            failure: {
+                exitCode: exitCodes.USAGE_ERROR,
+                message: `${failures.length === 1 ? 'A config field' : `${failures.length} config fields`} cannot sync to stored aspect documents:\n${failures.map((failure)=>`  - ${failure}`).join('\n')}`,
+                solution: 'Fix the field modules listed above, then deploy again'
+            }
+        };
+    }
+    const library = await resolveTargetMediaLibrary(organizationId, explicitMediaLibraryId);
+    if ('failure' in library) return library;
+    const storedIds = await getStoredAspectIds(library.mediaLibraryId);
+    const { staleIds } = computeMirrorDiff(documents, storedIds);
+    return {
+        plan: {
+            documents,
+            mediaLibraryId: library.mediaLibraryId,
+            staleIds,
+            strippedByField
+        }
+    };
+}
+/**
+ * Apply the plan as one mutation transaction: upsert every config document,
+ * delete every stale stored document. Definitions only — asset data under
+ * `aspects.<name>` is never touched.
+ */ export async function applyAspectSync(plan) {
+    await mutateAspects({
+        mediaLibraryId: plan.mediaLibraryId,
+        mutations: buildSyncMutations(plan.documents, plan.staleIds)
+    });
+}
+/**
+ * Shares the one resolution rule (`resolveMediaLibrary`) with the media
+ * commands, mapped to deploy-check failures. Ambiguity always fails here —
+ * deploy can run unattended (CI), so it never prompts, and a sync that
+ * guesses the target would mirror the config into the wrong library. Misuse
+ * (a bad flag value, a missing required flag) carries the usage exit code;
+ * a missing library is an environment problem and keeps the default.
+ */ async function resolveTargetMediaLibrary(organizationId, explicitMediaLibraryId) {
+    const resolution = await resolveMediaLibrary({
+        mediaLibraryIdFlag: explicitMediaLibraryId,
+        organizationId
+    });
+    if (resolution.type === 'resolved') {
+        return {
+            mediaLibraryId: resolution.mediaLibraryId
+        };
+    }
+    // Deploy-specific wording over the shared resolution's generic remedies:
+    // the install matters *before deploying the config*, and deploy never
+    // prompts, so the ambiguity message says the sync needs an explicit target.
+    return {
+        failure: {
+            ...resolution.type === 'none-active' ? {} : {
+                exitCode: exitCodes.USAGE_ERROR
+            },
+            message: resolution.type === 'ambiguous' ? `${resolution.message} — the sync needs an explicit target` : resolution.message,
+            solution: resolution.type === 'none-active' ? 'Install the Media Library for the organization before deploying its config' : resolution.solution
+        }
+    };
+}
+
+//# sourceMappingURL=syncAspects.js.map

package/dist/actions/media/aspectSync/syncAspects.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/actions/media/aspectSync/syncAspects.ts"],"sourcesContent":["/**\n * Composition of the pure aspect-sync contract (`./contract.ts`) with the\n * CLI's Media Library API services, for `sanity deploy` of a media-library\n * config app.\n *\n * Split into a read-only **plan** and a mutating **apply** so the deploy flow\n * can report the plan — including the deletion list — in both dry-run and\n * real mode before anything is written:\n *\n * - {@link planAspectSync}: evaluate + serialize + validate every config\n *   field module, resolve the target media library, and diff against the\n *   stored aspect ids. No mutations.\n * - {@link applyAspectSync}: apply the plan's upserts and deletes as one\n *   mutation transaction.\n */\n\nimport path from 'node:path'\n\nimport {exitCodes, importModule} from '@sanity/cli-core'\nimport {validateMediaLibraryAssetAspect} from '@sanity/schema/_internal'\n\nimport {getStoredAspectIds, mutateAspects} from '../../../services/mediaLibraries.js'\nimport {resolveMediaLibrary} from '../resolveMediaLibraryId.js'\nimport {\n  type AspectDocument,\n  buildSyncMutations,\n  computeMirrorDiff,\n  type FieldEntry,\n  serializeField,\n} from './contract.js'\n\n/** The read-only sync plan `sanity deploy` reports before mutating. */\nexport interface AspectSyncPlan {\n  /** The documents the sync upserts, one per config field. */\n  documents: AspectDocument[]\n  mediaLibraryId: string\n  /** Stored aspect ids with no matching config field — deleted by the sync. */\n  staleIds: string[]\n  /** Per-field dot-paths stripped during serialization, for fields that had any. */\n  strippedByField: Record<string, string[]>\n}\n\ninterface AspectSyncFailure {\n  message: string\n\n  /** Exit code a real deploy uses for this failure; defaults to 1. */\n  exitCode?: number\n  solution?: string\n}\n\nexport type AspectSyncPlanResult = {failure: AspectSyncFailure} | {plan: AspectSyncPlan}\n\n/**\n * Build the sync plan: evaluate, serialize, and schema-validate every field\n * module before touching the network, then resolve the target library and\n * diff against its stored aspect ids. Read-only.\n */\nexport async function planAspectSync(options: {\n  fields: readonly FieldEntry[]\n  mediaLibraryId?: string\n  organizationId: string\n  workDir: string\n}): Promise<AspectSyncPlanResult> {\n  const {fields, mediaLibraryId: explicitMediaLibraryId, organizationId, workDir} = options\n\n  // Evaluate + serialize + validate every field module before touching the\n  // network, collecting all failures so one broken module doesn't hide the next.\n  const documents: AspectDocument[] = []\n  const strippedByField: Record<string, string[]> = {}\n  const failures: string[] = []\n\n  for (const entry of fields) {\n    try {\n      // jsx: fields may be .tsx modules (custom input components) — the\n      // template ships one — and jiti does not parse JSX by default.\n      const definition = await importModule(path.resolve(workDir, entry.src), {jsx: true})\n      const {document, stripped} = serializeField(entry, definition)\n\n      const [valid, validationErrors] = validateMediaLibraryAssetAspect(document.definition)\n      if (!valid) {\n        const messages = validationErrors.flat().map((problem) => problem.message)\n        failures.push(`${entry.name}: schema validation failed: ${messages.join('; ')}`)\n        continue\n      }\n\n      documents.push(document)\n      if (stripped.length > 0) strippedByField[entry.name] = stripped\n    } catch (error) {\n      failures.push(`${entry.name}: ${error instanceof Error ? error.message : String(error)}`)\n    }\n  }\n\n  if (failures.length > 0) {\n    return {\n      failure: {\n        exitCode: exitCodes.USAGE_ERROR,\n        message: `${failures.length === 1 ? 'A config field' : `${failures.length} config fields`} cannot sync to stored aspect documents:\\n${failures.map((failure) => `  - ${failure}`).join('\\n')}`,\n        solution: 'Fix the field modules listed above, then deploy again',\n      },\n    }\n  }\n\n  const library = await resolveTargetMediaLibrary(organizationId, explicitMediaLibraryId)\n  if ('failure' in library) return library\n\n  const storedIds = await getStoredAspectIds(library.mediaLibraryId)\n  const {staleIds} = computeMirrorDiff(documents, storedIds)\n\n  return {plan: {documents, mediaLibraryId: library.mediaLibraryId, staleIds, strippedByField}}\n}\n\n/**\n * Apply the plan as one mutation transaction: upsert every config document,\n * delete every stale stored document. Definitions only — asset data under\n * `aspects.<name>` is never touched.\n */\nexport async function applyAspectSync(plan: AspectSyncPlan): Promise<void> {\n  await mutateAspects({\n    mediaLibraryId: plan.mediaLibraryId,\n    mutations: buildSyncMutations(plan.documents, plan.staleIds),\n  })\n}\n\n/**\n * Shares the one resolution rule (`resolveMediaLibrary`) with the media\n * commands, mapped to deploy-check failures. Ambiguity always fails here —\n * deploy can run unattended (CI), so it never prompts, and a sync that\n * guesses the target would mirror the config into the wrong library. Misuse\n * (a bad flag value, a missing required flag) carries the usage exit code;\n * a missing library is an environment problem and keeps the default.\n */\nasync function resolveTargetMediaLibrary(\n  organizationId: string,\n  explicitMediaLibraryId: string | undefined,\n): Promise<{failure: AspectSyncFailure} | {mediaLibraryId: string}> {\n  const resolution = await resolveMediaLibrary({\n    mediaLibraryIdFlag: explicitMediaLibraryId,\n    organizationId,\n  })\n  if (resolution.type === 'resolved') {\n    return {mediaLibraryId: resolution.mediaLibraryId}\n  }\n  // Deploy-specific wording over the shared resolution's generic remedies:\n  // the install matters *before deploying the config*, and deploy never\n  // prompts, so the ambiguity message says the sync needs an explicit target.\n  return {\n    failure: {\n      ...(resolution.type === 'none-active' ? {} : {exitCode: exitCodes.USAGE_ERROR}),\n      message:\n        resolution.type === 'ambiguous'\n          ? `${resolution.message} — the sync needs an explicit target`\n          : resolution.message,\n      solution:\n        resolution.type === 'none-active'\n          ? 'Install the Media Library for the organization before deploying its config'\n          : resolution.solution,\n    },\n  }\n}\n"],"names":["path","exitCodes","importModule","validateMediaLibraryAssetAspect","getStoredAspectIds","mutateAspects","resolveMediaLibrary","buildSyncMutations","computeMirrorDiff","serializeField","planAspectSync","options","fields","mediaLibraryId","explicitMediaLibraryId","organizationId","workDir","documents","strippedByField","failures","entry","definition","resolve","src","jsx","document","stripped","valid","validationErrors","messages","flat","map","problem","message","push","name","join","length","error","Error","String","failure","exitCode","USAGE_ERROR","solution","library","resolveTargetMediaLibrary","storedIds","staleIds","plan","applyAspectSync","mutations","resolution","mediaLibraryIdFlag","type"],"mappings":"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"}

package/dist/actions/media/cliConfigFields.js

@@ -0,0 +1,192 @@
+/**
+ * Locates and edits the `fields: [...]` array in a Media Library config app's
+ * `sanity.cli.ts` — appending entries (`sanity media pull-aspects`) or
+ * replacing them (the init-time pull). Deploying mirrors the declared fields
+ * into the library and deletes stored aspects left undeclared, so unsafe
+ * edits are refused rather than risked: the AST (vite's `parseAst`) locates
+ * the one array literal the deploy will read, the edit is a byte-preserving
+ * splice at its offsets, and any other shape returns a reason the caller
+ * turns into a paste-ready fallback.
+ */ import { parseAst } from 'vite';
+const CALL_NAME = 'unstable_defineMediaLibrary';
+/**
+ * Depth-first collection of every `unstable_defineMediaLibrary(...)` call in
+ * the (sub)tree at `value`. The one cast is guarded by the `type`
+ * discriminant it narrows on.
+ */ function collectCalls(value, calls) {
+    if (Array.isArray(value)) {
+        for (const item of value)collectCalls(item, calls);
+        return;
+    }
+    if (typeof value !== 'object' || value === null) return;
+    if (value.type === 'CallExpression') {
+        const call = value;
+        if (call.callee.type === 'Identifier' && call.callee.name === CALL_NAME) {
+            calls.push(call);
+        }
+    }
+    for (const child of Object.values(value)){
+        if (typeof child === 'object') collectCalls(child, calls);
+    }
+}
+/** Non-computed `fields` key — `fields:` or `'fields':`. */ function isFieldsProperty(prop) {
+    if (prop.type !== 'Property' || prop.computed) return false;
+    const { key } = prop;
+    return key.type === 'Identifier' && key.name === 'fields' || key.type === 'Literal' && key.value === 'fields';
+}
+/**
+ * The index of the `,` between a trailing array element ending at `from` and
+ * the `]` at `to`, or -1 when the element has no trailing comma. Only
+ * whitespace, comments, and at most one comma can sit in that gap, and the
+ * comments terminate (the source parsed), so this scan just has to not read a
+ * comma out of a comment.
+ */ function indexOfTrailingComma(source, from, to) {
+    let index = from;
+    while(index < to){
+        const char = source[index];
+        if (char === ',') return index;
+        if (char === '/' && source[index + 1] === '/') {
+            const newline = source.indexOf('\n', index);
+            if (newline === -1 || newline >= to) return -1;
+            index = newline + 1;
+            continue;
+        }
+        if (char === '/' && source[index + 1] === '*') {
+            index = source.indexOf('*/', index + 2) + 2;
+            continue;
+        }
+        index++;
+    }
+    return -1;
+}
+function locateFieldsArray(source) {
+    // Node offsets are UTF-16 string indices, so splicing `source` with them is
+    // exact even around non-ASCII content.
+    let program;
+    try {
+        program = parseAst(source, {
+            lang: 'ts'
+        });
+    } catch  {
+        return {
+            reason: 'the config does not parse as TypeScript'
+        };
+    }
+    // The import statement also mentions the identifier, but only call sites
+    // show up as CallExpressions.
+    const calls = [];
+    collectCalls(program.body, calls);
+    if (calls.length === 0) {
+        return {
+            reason: 'no `unstable_defineMediaLibrary(...)` call found'
+        };
+    }
+    if (calls.length > 1) {
+        return {
+            reason: 'more than one `unstable_defineMediaLibrary(...)` call found'
+        };
+    }
+    const [config] = calls[0].arguments;
+    if (config?.type !== 'ObjectExpression') {
+        return {
+            reason: 'the `unstable_defineMediaLibrary(...)` argument is not an object literal'
+        };
+    }
+    // Only the config object's own `fields` property may be edited — deploy
+    // evaluates exactly that one, so a `fields` array nested elsewhere (or
+    // sitting in a helper outside the call) must neither be edited nor block
+    // the real one.
+    const fieldsProps = config.properties.filter((prop)=>isFieldsProperty(prop));
+    if (fieldsProps.length === 0) {
+        return {
+            reason: 'no `fields` property in the `unstable_defineMediaLibrary({...})` config'
+        };
+    }
+    if (fieldsProps.length > 1) {
+        return {
+            reason: 'more than one `fields` property in the `unstable_defineMediaLibrary({...})` config'
+        };
+    }
+    const fields = fieldsProps[0];
+    const array = fields.value;
+    if (array.type !== 'ArrayExpression') {
+        // A computed value (`fields: sharedFields`) stays the user's to manage —
+        // deploy keeps evaluating it, so an "edit" elsewhere would be a lie.
+        return {
+            reason: 'the `fields` value is not an array literal'
+        };
+    }
+    const open = array.start;
+    const close = array.end - 1;
+    const last = array.elements.at(-1);
+    if (last === null) {
+        return {
+            reason: 'the `fields` array ends in an elision'
+        };
+    }
+    let lastContentEnd = open + 1;
+    if (last) {
+        const comma = indexOfTrailingComma(source, last.end, close);
+        lastContentEnd = comma === -1 ? last.end : comma + 1;
+    }
+    const lineStart = source.lastIndexOf('\n', fields.start) + 1;
+    const indent = /^[\t ]*/.exec(source.slice(lineStart, fields.start))?.[0] ?? '';
+    return {
+        close,
+        indent,
+        lastContentEnd,
+        open
+    };
+}
+/**
+ * Append `entryLines` (one rendered `{name, src, title},` object per line) to
+ * the config's `fields` array, preserving the existing entries and adding a
+ * trailing comma to the last one when needed.
+ */ export function appendFieldEntries(source, entryLines) {
+    const located = locateFieldsArray(source);
+    if ('reason' in located) return {
+        ok: false,
+        reason: located.reason
+    };
+    const { indent, lastContentEnd, open } = located;
+    const entryIndent = `${indent}  `;
+    const block = entryLines.map((line)=>entryIndent + line).join('\n');
+    if (lastContentEnd === open + 1) {
+        const inner = source.slice(open + 1, located.close);
+        if (inner.trim() !== '') {
+            // Only comments inside: rewriting would silently drop them.
+            return {
+                ok: false,
+                reason: 'the `fields` array contains only comments'
+            };
+        }
+        const updated = `${source.slice(0, open + 1)}\n${block}\n${indent}${source.slice(located.close)}`;
+        return {
+            ok: true,
+            updated
+        };
+    }
+    const comma = source[lastContentEnd - 1] === ',' ? '' : ',';
+    const updated = `${source.slice(0, lastContentEnd)}${comma}\n${block}${source.slice(lastContentEnd)}`;
+    return {
+        ok: true,
+        updated
+    };
+}
+/** Replace the config's `fields` array contents with `entryLines` wholesale. */ export function replaceFieldEntries(source, entryLines) {
+    const located = locateFieldsArray(source);
+    if ('reason' in located) return {
+        ok: false,
+        reason: located.reason
+    };
+    const { close, indent, open } = located;
+    const entryIndent = `${indent}  `;
+    const block = entryLines.map((line)=>entryIndent + line).join('\n');
+    const updated = `${source.slice(0, open + 1)}\n${block}\n${indent}${source.slice(close)}`;
+    return {
+        ok: true,
+        updated
+    };
+}
+
+//# sourceMappingURL=cliConfigFields.js.map

package/dist/actions/media/cliConfigFields.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/actions/media/cliConfigFields.ts"],"sourcesContent":["/**\n * Locates and edits the `fields: [...]` array in a Media Library config app's\n * `sanity.cli.ts` — appending entries (`sanity media pull-aspects`) or\n * replacing them (the init-time pull). Deploying mirrors the declared fields\n * into the library and deletes stored aspects left undeclared, so unsafe\n * edits are refused rather than risked: the AST (vite's `parseAst`) locates\n * the one array literal the deploy will read, the edit is a byte-preserving\n * splice at its offsets, and any other shape returns a reason the caller\n * turns into a paste-ready fallback.\n */\n\nimport {type CallExpression, type ObjectProperty, type ObjectPropertyKind} from '@oxc-project/types'\nimport {parseAst} from 'vite'\n\nexport type EditResult = {ok: false; reason: string} | {ok: true; updated: string}\n\nconst CALL_NAME = 'unstable_defineMediaLibrary'\n\ninterface LocatedArray {\n  /** Index of the `]`. */\n  close: number\n  /** Leading whitespace of the line containing the `fields` property. */\n  indent: string\n  /**\n   * Index just past the last element — past its trailing comma when there is\n   * one — or `open + 1` for an empty array. Appending inserts here, so a\n   * trailing comment never ends up with a comma after it (which would create\n   * a sparse-array hole).\n   */\n  lastContentEnd: number\n  /** Index of the `[`. */\n  open: number\n}\n\n/**\n * Depth-first collection of every `unstable_defineMediaLibrary(...)` call in\n * the (sub)tree at `value`. The one cast is guarded by the `type`\n * discriminant it narrows on.\n */\nfunction collectCalls(value: unknown, calls: CallExpression[]): void {\n  if (Array.isArray(value)) {\n    for (const item of value) collectCalls(item, calls)\n    return\n  }\n  if (typeof value !== 'object' || value === null) return\n  if ((value as {type?: unknown}).type === 'CallExpression') {\n    const call = value as CallExpression\n    if (call.callee.type === 'Identifier' && call.callee.name === CALL_NAME) {\n      calls.push(call)\n    }\n  }\n  for (const child of Object.values(value)) {\n    if (typeof child === 'object') collectCalls(child, calls)\n  }\n}\n\n/** Non-computed `fields` key — `fields:` or `'fields':`. */\nfunction isFieldsProperty(prop: ObjectPropertyKind): prop is ObjectProperty {\n  if (prop.type !== 'Property' || prop.computed) return false\n  const {key} = prop\n  return (\n    (key.type === 'Identifier' && key.name === 'fields') ||\n    (key.type === 'Literal' && key.value === 'fields')\n  )\n}\n\n/**\n * The index of the `,` between a trailing array element ending at `from` and\n * the `]` at `to`, or -1 when the element has no trailing comma. Only\n * whitespace, comments, and at most one comma can sit in that gap, and the\n * comments terminate (the source parsed), so this scan just has to not read a\n * comma out of a comment.\n */\nfunction indexOfTrailingComma(source: string, from: number, to: number): number {\n  let index = from\n  while (index < to) {\n    const char = source[index]\n    if (char === ',') return index\n    if (char === '/' && source[index + 1] === '/') {\n      const newline = source.indexOf('\\n', index)\n      if (newline === -1 || newline >= to) return -1\n      index = newline + 1\n      continue\n    }\n    if (char === '/' && source[index + 1] === '*') {\n      index = source.indexOf('*/', index + 2) + 2\n      continue\n    }\n    index++\n  }\n  return -1\n}\n\nfunction locateFieldsArray(source: string): LocatedArray | {reason: string} {\n  // Node offsets are UTF-16 string indices, so splicing `source` with them is\n  // exact even around non-ASCII content.\n  let program: ReturnType<typeof parseAst>\n  try {\n    program = parseAst(source, {lang: 'ts'})\n  } catch {\n    return {reason: 'the config does not parse as TypeScript'}\n  }\n\n  // The import statement also mentions the identifier, but only call sites\n  // show up as CallExpressions.\n  const calls: CallExpression[] = []\n  collectCalls(program.body, calls)\n  if (calls.length === 0) {\n    return {reason: 'no `unstable_defineMediaLibrary(...)` call found'}\n  }\n  if (calls.length > 1) {\n    return {reason: 'more than one `unstable_defineMediaLibrary(...)` call found'}\n  }\n\n  const [config] = calls[0].arguments\n  if (config?.type !== 'ObjectExpression') {\n    return {reason: 'the `unstable_defineMediaLibrary(...)` argument is not an object literal'}\n  }\n\n  // Only the config object's own `fields` property may be edited — deploy\n  // evaluates exactly that one, so a `fields` array nested elsewhere (or\n  // sitting in a helper outside the call) must neither be edited nor block\n  // the real one.\n  const fieldsProps = config.properties.filter((prop) => isFieldsProperty(prop))\n  if (fieldsProps.length === 0) {\n    return {reason: 'no `fields` property in the `unstable_defineMediaLibrary({...})` config'}\n  }\n  if (fieldsProps.length > 1) {\n    return {\n      reason: 'more than one `fields` property in the `unstable_defineMediaLibrary({...})` config',\n    }\n  }\n\n  const fields = fieldsProps[0]\n  const array = fields.value\n  if (array.type !== 'ArrayExpression') {\n    // A computed value (`fields: sharedFields`) stays the user's to manage —\n    // deploy keeps evaluating it, so an \"edit\" elsewhere would be a lie.\n    return {reason: 'the `fields` value is not an array literal'}\n  }\n\n  const open = array.start\n  const close = array.end - 1\n  const last = array.elements.at(-1)\n\n  if (last === null) {\n    return {reason: 'the `fields` array ends in an elision'}\n  }\n\n  let lastContentEnd = open + 1\n  if (last) {\n    const comma = indexOfTrailingComma(source, last.end, close)\n    lastContentEnd = comma === -1 ? last.end : comma + 1\n  }\n\n  const lineStart = source.lastIndexOf('\\n', fields.start) + 1\n  const indent = /^[\\t ]*/.exec(source.slice(lineStart, fields.start))?.[0] ?? ''\n\n  return {close, indent, lastContentEnd, open}\n}\n\n/**\n * Append `entryLines` (one rendered `{name, src, title},` object per line) to\n * the config's `fields` array, preserving the existing entries and adding a\n * trailing comma to the last one when needed.\n */\nexport function appendFieldEntries(source: string, entryLines: string[]): EditResult {\n  const located = locateFieldsArray(source)\n  if ('reason' in located) return {ok: false, reason: located.reason}\n\n  const {indent, lastContentEnd, open} = located\n  const entryIndent = `${indent}  `\n  const block = entryLines.map((line) => entryIndent + line).join('\\n')\n\n  if (lastContentEnd === open + 1) {\n    const inner = source.slice(open + 1, located.close)\n    if (inner.trim() !== '') {\n      // Only comments inside: rewriting would silently drop them.\n      return {ok: false, reason: 'the `fields` array contains only comments'}\n    }\n    const updated = `${source.slice(0, open + 1)}\\n${block}\\n${indent}${source.slice(located.close)}`\n    return {ok: true, updated}\n  }\n\n  const comma = source[lastContentEnd - 1] === ',' ? '' : ','\n  const updated = `${source.slice(0, lastContentEnd)}${comma}\\n${block}${source.slice(lastContentEnd)}`\n  return {ok: true, updated}\n}\n\n/** Replace the config's `fields` array contents with `entryLines` wholesale. */\nexport function replaceFieldEntries(source: string, entryLines: string[]): EditResult {\n  const located = locateFieldsArray(source)\n  if ('reason' in located) return {ok: false, reason: located.reason}\n\n  const {close, indent, open} = located\n  const entryIndent = `${indent}  `\n  const block = entryLines.map((line) => entryIndent + line).join('\\n')\n\n  const updated = `${source.slice(0, open + 1)}\\n${block}\\n${indent}${source.slice(close)}`\n  return {ok: true, updated}\n}\n"],"names":["parseAst","CALL_NAME","collectCalls","value","calls","Array","isArray","item","type","call","callee","name","push","child","Object","values","isFieldsProperty","prop","computed","key","indexOfTrailingComma","source","from","to","index","char","newline","indexOf","locateFieldsArray","program","lang","reason","body","length","config","arguments","fieldsProps","properties","filter","fields","array","open","start","close","end","last","elements","at","lastContentEnd","comma","lineStart","lastIndexOf","indent","exec","slice","appendFieldEntries","entryLines","located","ok","entryIndent","block","map","line","join","inner","trim","updated","replaceFieldEntries"],"mappings":"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"}