@sanity/cli 8.22.1 → 8.24.0

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":"AAAA;;;;;;;;;CASC,GAGD,SAAQA,QAAQ,QAAO,OAAM;AAI7B,MAAMC,YAAY;AAkBlB;;;;CAIC,GACD,SAASC,aAAaC,KAAc,EAAEC,KAAuB;IAC3D,IAAIC,MAAMC,OAAO,CAACH,QAAQ;QACxB,KAAK,MAAMI,QAAQJ,MAAOD,aAAaK,MAAMH;QAC7C;IACF;IACA,IAAI,OAAOD,UAAU,YAAYA,UAAU,MAAM;IACjD,IAAI,AAACA,MAA2BK,IAAI,KAAK,kBAAkB;QACzD,MAAMC,OAAON;QACb,IAAIM,KAAKC,MAAM,CAACF,IAAI,KAAK,gBAAgBC,KAAKC,MAAM,CAACC,IAAI,KAAKV,WAAW;YACvEG,MAAMQ,IAAI,CAACH;QACb;IACF;IACA,KAAK,MAAMI,SAASC,OAAOC,MAAM,CAACZ,OAAQ;QACxC,IAAI,OAAOU,UAAU,UAAUX,aAAaW,OAAOT;IACrD;AACF;AAEA,0DAA0D,GAC1D,SAASY,iBAAiBC,IAAwB;IAChD,IAAIA,KAAKT,IAAI,KAAK,cAAcS,KAAKC,QAAQ,EAAE,OAAO;IACtD,MAAM,EAACC,GAAG,EAAC,GAAGF;IACd,OACE,AAACE,IAAIX,IAAI,KAAK,gBAAgBW,IAAIR,IAAI,KAAK,YAC1CQ,IAAIX,IAAI,KAAK,aAAaW,IAAIhB,KAAK,KAAK;AAE7C;AAEA;;;;;;CAMC,GACD,SAASiB,qBAAqBC,MAAc,EAAEC,IAAY,EAAEC,EAAU;IACpE,IAAIC,QAAQF;IACZ,MAAOE,QAAQD,GAAI;QACjB,MAAME,OAAOJ,MAAM,CAACG,MAAM;QAC1B,IAAIC,SAAS,KAAK,OAAOD;QACzB,IAAIC,SAAS,OAAOJ,MAAM,CAACG,QAAQ,EAAE,KAAK,KAAK;YAC7C,MAAME,UAAUL,OAAOM,OAAO,CAAC,MAAMH;YACrC,IAAIE,YAAY,CAAC,KAAKA,WAAWH,IAAI,OAAO,CAAC;YAC7CC,QAAQE,UAAU;YAClB;QACF;QACA,IAAID,SAAS,OAAOJ,MAAM,CAACG,QAAQ,EAAE,KAAK,KAAK;YAC7CA,QAAQH,OAAOM,OAAO,CAAC,MAAMH,QAAQ,KAAK;YAC1C;QACF;QACAA;IACF;IACA,OAAO,CAAC;AACV;AAEA,SAASI,kBAAkBP,MAAc;IACvC,4EAA4E;IAC5E,uCAAuC;IACvC,IAAIQ;IACJ,IAAI;QACFA,UAAU7B,SAASqB,QAAQ;YAACS,MAAM;QAAI;IACxC,EAAE,OAAM;QACN,OAAO;YAACC,QAAQ;QAAyC;IAC3D;IAEA,yEAAyE;IACzE,8BAA8B;IAC9B,MAAM3B,QAA0B,EAAE;IAClCF,aAAa2B,QAAQG,IAAI,EAAE5B;IAC3B,IAAIA,MAAM6B,MAAM,KAAK,GAAG;QACtB,OAAO;YAACF,QAAQ;QAAkD;IACpE;IACA,IAAI3B,MAAM6B,MAAM,GAAG,GAAG;QACpB,OAAO;YAACF,QAAQ;QAA6D;IAC/E;IAEA,MAAM,CAACG,OAAO,GAAG9B,KAAK,CAAC,EAAE,CAAC+B,SAAS;IACnC,IAAID,QAAQ1B,SAAS,oBAAoB;QACvC,OAAO;YAACuB,QAAQ;QAA0E;IAC5F;IAEA,wEAAwE;IACxE,uEAAuE;IACvE,yEAAyE;IACzE,gBAAgB;IAChB,MAAMK,cAAcF,OAAOG,UAAU,CAACC,MAAM,CAAC,CAACrB,OAASD,iBAAiBC;IACxE,IAAImB,YAAYH,MAAM,KAAK,GAAG;QAC5B,OAAO;YAACF,QAAQ;QAAyE;IAC3F;IACA,IAAIK,YAAYH,MAAM,GAAG,GAAG;QAC1B,OAAO;YACLF,QAAQ;QACV;IACF;IAEA,MAAMQ,SAASH,WAAW,CAAC,EAAE;IAC7B,MAAMI,QAAQD,OAAOpC,KAAK;IAC1B,IAAIqC,MAAMhC,IAAI,KAAK,mBAAmB;QACpC,yEAAyE;QACzE,qEAAqE;QACrE,OAAO;YAACuB,QAAQ;QAA4C;IAC9D;IAEA,MAAMU,OAAOD,MAAME,KAAK;IACxB,MAAMC,QAAQH,MAAMI,GAAG,GAAG;IAC1B,MAAMC,OAAOL,MAAMM,QAAQ,CAACC,EAAE,CAAC,CAAC;IAEhC,IAAIF,SAAS,MAAM;QACjB,OAAO;YAACd,QAAQ;QAAuC;IACzD;IAEA,IAAIiB,iBAAiBP,OAAO;IAC5B,IAAII,MAAM;QACR,MAAMI,QAAQ7B,qBAAqBC,QAAQwB,KAAKD,GAAG,EAAED;QACrDK,iBAAiBC,UAAU,CAAC,IAAIJ,KAAKD,GAAG,GAAGK,QAAQ;IACrD;IAEA,MAAMC,YAAY7B,OAAO8B,WAAW,CAAC,MAAMZ,OAAOG,KAAK,IAAI;IAC3D,MAAMU,SAAS,UAAUC,IAAI,CAAChC,OAAOiC,KAAK,CAACJ,WAAWX,OAAOG,KAAK,IAAI,CAAC,EAAE,IAAI;IAE7E,OAAO;QAACC;QAAOS;QAAQJ;QAAgBP;IAAI;AAC7C;AAEA;;;;CAIC,GACD,OAAO,SAASc,mBAAmBlC,MAAc,EAAEmC,UAAoB;IACrE,MAAMC,UAAU7B,kBAAkBP;IAClC,IAAI,YAAYoC,SAAS,OAAO;QAACC,IAAI;QAAO3B,QAAQ0B,QAAQ1B,MAAM;IAAA;IAElE,MAAM,EAACqB,MAAM,EAAEJ,cAAc,EAAEP,IAAI,EAAC,GAAGgB;IACvC,MAAME,cAAc,GAAGP,OAAO,EAAE,CAAC;IACjC,MAAMQ,QAAQJ,WAAWK,GAAG,CAAC,CAACC,OAASH,cAAcG,MAAMC,IAAI,CAAC;IAEhE,IAAIf,mBAAmBP,OAAO,GAAG;QAC/B,MAAMuB,QAAQ3C,OAAOiC,KAAK,CAACb,OAAO,GAAGgB,QAAQd,KAAK;QAClD,IAAIqB,MAAMC,IAAI,OAAO,IAAI;YACvB,4DAA4D;YAC5D,OAAO;gBAACP,IAAI;gBAAO3B,QAAQ;YAA2C;QACxE;QACA,MAAMmC,UAAU,GAAG7C,OAAOiC,KAAK,CAAC,GAAGb,OAAO,GAAG,EAAE,EAAEmB,MAAM,EAAE,EAAER,SAAS/B,OAAOiC,KAAK,CAACG,QAAQd,KAAK,GAAG;QACjG,OAAO;YAACe,IAAI;YAAMQ;QAAO;IAC3B;IAEA,MAAMjB,QAAQ5B,MAAM,CAAC2B,iBAAiB,EAAE,KAAK,MAAM,KAAK;IACxD,MAAMkB,UAAU,GAAG7C,OAAOiC,KAAK,CAAC,GAAGN,kBAAkBC,MAAM,EAAE,EAAEW,QAAQvC,OAAOiC,KAAK,CAACN,iBAAiB;IACrG,OAAO;QAACU,IAAI;QAAMQ;IAAO;AAC3B;AAEA,8EAA8E,GAC9E,OAAO,SAASC,oBAAoB9C,MAAc,EAAEmC,UAAoB;IACtE,MAAMC,UAAU7B,kBAAkBP;IAClC,IAAI,YAAYoC,SAAS,OAAO;QAACC,IAAI;QAAO3B,QAAQ0B,QAAQ1B,MAAM;IAAA;IAElE,MAAM,EAACY,KAAK,EAAES,MAAM,EAAEX,IAAI,EAAC,GAAGgB;IAC9B,MAAME,cAAc,GAAGP,OAAO,EAAE,CAAC;IACjC,MAAMQ,QAAQJ,WAAWK,GAAG,CAAC,CAACC,OAASH,cAAcG,MAAMC,IAAI,CAAC;IAEhE,MAAMG,UAAU,GAAG7C,OAAOiC,KAAK,CAAC,GAAGb,OAAO,GAAG,EAAE,EAAEmB,MAAM,EAAE,EAAER,SAAS/B,OAAOiC,KAAK,CAACX,QAAQ;IACzF,OAAO;QAACe,IAAI;QAAMQ;IAAO;AAC3B"}

package/dist/actions/media/pullAspects.js

@@ -0,0 +1,225 @@
+import { validateMediaLibraryAssetAspect } from '@sanity/schema/_internal';
+import startCase from 'lodash-es/startCase.js';
+import { VALID_ASPECT_NAME } from './aspectName.js';
+/** Keys whose object members are schema definitions, printed wrapped in a definer call. */ const DEFINER_BY_PARENT_KEY = {
+    fields: 'defineField',
+    of: 'defineArrayMember'
+};
+const IDENTIFIER_KEY = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+/** Scalar arrays shorter than this print inline (e.g. `options.list`). */ const INLINE_ARRAY_MAX_WIDTH = 60;
+/**
+ * Convert a page of stored aspect documents into field modules, one per field
+ * name. Two stored documents can resolve to the same name (a legacy document
+ * whose `_id` predates its `definition.name`), which would otherwise produce
+ * the same module twice — the document whose `_id` matches the name wins, the
+ * rest are reported as skipped. Shared by `sanity media pull-aspects` and the
+ * init-time pull offer.
+ *
+ * @internal
+ */ export function convertAspectDocuments(documents) {
+    const skipped = [];
+    // First pass: convert every stored document.
+    const candidates = [];
+    for (const doc of documents){
+        const outcome = aspectDocumentToFieldModule(doc);
+        if (outcome.status === 'skipped') {
+            skipped.push(outcome);
+        } else {
+            candidates.push({
+                module: outcome,
+                sourceId: String(doc._id)
+            });
+        }
+    }
+    // Second pass: pick one winner per name.
+    const byName = new Map();
+    for (const candidate of candidates){
+        const group = byName.get(candidate.module.name) ?? [];
+        group.push(candidate);
+        byName.set(candidate.module.name, group);
+    }
+    const modules = [];
+    for (const [name, group] of byName){
+        const winner = group.find((candidate)=>candidate.sourceId === name) ?? group[0];
+        modules.push(winner.module);
+        for (const loser of group){
+            if (loser === winner) continue;
+            skipped.push({
+                id: loser.sourceId,
+                reasons: [
+                    `Also defines "${name}" — generated from "${winner.sourceId}" instead`
+                ],
+                status: 'skipped',
+                validationErrors: []
+            });
+        }
+    }
+    return {
+        modules,
+        skipped
+    };
+}
+/**
+ * Codegen one stored aspect document into a `src/fields/<name>.tsx` field
+ * module for a Media Library config app.
+ *
+ * Stored aspects are migration-ready by construction: `definition` is the
+ * JSON-serialized `defineField(...)` value with functions and component
+ * references already stripped, so generation is mechanical pretty-printing
+ * into a `defineField({...})` call (nested `fields`/`of` members wrapped in
+ * `defineField`/`defineArrayMember`, matching hand-authored style).
+ *
+ * Edge cases handled here, not silently:
+ *
+ * - `_id` vs `definition.name` mismatch: the module is generated under
+ *   `definition.name` — the `aspects.<name>` key existing asset data lives
+ *   under. Normalizing onto `_id` instead would silently orphan that data.
+ *   The old document (keyed `_id`) is reported for manual deletion.
+ * - `assetType` has no equivalent in the config model; a document carrying it
+ *   generates with a warning that the scoping is lost.
+ * - Definitions failing current schema validation are skipped with the
+ *   validation errors, mirroring `sanity media deploy-aspect`.
+ *
+ * Pure (no I/O): the command decides where modules are written.
+ *
+ * @internal
+ */ export function aspectDocumentToFieldModule(doc) {
+    const { _id } = doc;
+    if (!isRecord(doc.definition)) {
+        return {
+            id: _id,
+            reasons: [
+                'The stored document has no field definition object'
+            ],
+            status: 'skipped',
+            validationErrors: []
+        };
+    }
+    const definitionName = typeof doc.definition.name === 'string' ? doc.definition.name : undefined;
+    const name = definitionName ?? _id;
+    if (!VALID_ASPECT_NAME.test(name)) {
+        return {
+            id: _id,
+            reasons: [
+                `"${name}" is not a valid field name (${VALID_ASPECT_NAME}) — it becomes the module name and the aspects.<name> key on assets`
+            ],
+            status: 'skipped',
+            validationErrors: []
+        };
+    }
+    const warnings = [];
+    if (definitionName === undefined) {
+        warnings.push(`The stored definition has no name — using the document _id "${_id}"`);
+    } else if (definitionName !== _id) {
+        warnings.push(`Stored _id "${_id}" and definition name "${definitionName}" differ. Generated as ` + `"${definitionName}" — the aspects.<name> key existing asset data lives under; using ` + `"${_id}" would orphan that data. Deploying the config creates "${definitionName}" ` + `and deletes the old "${_id}" document.`);
+    }
+    if (doc.assetType !== undefined && doc.assetType !== null) {
+        warnings.push(`The stored document scopes the aspect by assetType (${JSON.stringify(doc.assetType)}), ` + `which has no equivalent in the config model — the generated field applies to all ` + `asset types, and syncing the config drops the scoping.`);
+    }
+    // Normalize the name in before validating, so a document that only carries
+    // its name as `_id` isn't rejected for the missing property.
+    const definition = definitionName ? doc.definition : {
+        name,
+        ...doc.definition
+    };
+    const [valid, validationErrors] = validateMediaLibraryAssetAspect(definition);
+    if (!valid) {
+        return {
+            id: _id,
+            reasons: [
+                'The stored definition fails schema validation'
+            ],
+            status: 'skipped',
+            validationErrors
+        };
+    }
+    return {
+        // .tsx although the generated content has no JSX: field modules are
+        // expected to grow custom input components (the one thing the stored
+        // aspect could not carry), and a later rename would also mean fixing the
+        // `src:` entry in sanity.cli.ts. Matches the template's example modules.
+        filename: `${name}.tsx`,
+        name,
+        ...typeof doc.public === 'boolean' ? {
+            public: doc.public
+        } : {},
+        source: printFieldModule(definition),
+        status: 'generated',
+        title: typeof definition.title === 'string' ? definition.title : startCase(name),
+        warnings
+    };
+}
+/**
+ * The paste-ready `fields: [...]` entries for `sanity.cli.ts`, one line per
+ * generated module. When `writtenPaths` (module name to root-relative path)
+ * has an entry for a module, that path wins — the module may have replaced an
+ * existing file (e.g. a `.tsx` variant) rather than landing at the default
+ * `<srcDir>/<filename>` location.
+ *
+ * @internal
+ */ export function formatFieldEntries(modules, srcDir, writtenPaths) {
+    const dir = srcDir.replaceAll('\\', '/').replace(/\/+$/, '');
+    return modules.map((module)=>{
+        const src = writtenPaths?.get(module.name)?.replaceAll('\\', '/') ?? `${dir}/${module.filename}`;
+        const publicPart = module.public === undefined ? '' : `, public: ${module.public}`;
+        return `{name: '${module.name}', src: './${src}', title: ${quote(module.title)}${publicPart}},`;
+    }).join('\n');
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function printFieldModule(definition) {
+    const state = {
+        usesDefineArrayMember: false
+    };
+    const literal = printObject(definition, '', state);
+    const imports = state.usesDefineArrayMember ? 'defineArrayMember, defineField' : 'defineField';
+    return `import {${imports}} from 'sanity'\n\nexport default defineField(${literal})\n`;
+}
+function quote(value) {
+    const escaped = value.replaceAll('\\', '\\\\').replaceAll("'", String.raw`\'`).replaceAll('\n', String.raw`\n`).replaceAll('\r', String.raw`\r`).replaceAll('\t', String.raw`\t`);
+    return `'${escaped}'`;
+}
+function printKey(key) {
+    return IDENTIFIER_KEY.test(key) ? key : quote(key);
+}
+function printValue(value, indent, parentKey, state) {
+    if (value === null) return 'null';
+    if (typeof value === 'string') return quote(value);
+    if (typeof value === 'number' || typeof value === 'boolean') return String(value);
+    if (Array.isArray(value)) return printArray(value, indent, parentKey, state);
+    if (isRecord(value)) return printObject(value, indent, state);
+    // Stored definitions are JSON documents; anything else cannot occur.
+    throw new TypeError(`Cannot print value of type ${typeof value}`);
+}
+function printArray(items, indent, parentKey, state) {
+    if (items.length === 0) return '[]';
+    const allScalar = items.every((item)=>item === null || [
+            'boolean',
+            'number',
+            'string'
+        ].includes(typeof item));
+    if (allScalar) {
+        const inline = `[${items.map((item)=>printValue(item, indent, null, state)).join(', ')}]`;
+        if (inline.length <= INLINE_ARRAY_MAX_WIDTH) return inline;
+    }
+    const definer = parentKey === null ? undefined : DEFINER_BY_PARENT_KEY[parentKey];
+    const innerIndent = `${indent}  `;
+    const lines = items.map((item)=>{
+        if (definer !== undefined && isRecord(item)) {
+            if (definer === 'defineArrayMember') state.usesDefineArrayMember = true;
+            return `${innerIndent}${definer}(${printObject(item, innerIndent, state)}),`;
+        }
+        return `${innerIndent}${printValue(item, innerIndent, null, state)},`;
+    });
+    return `[\n${lines.join('\n')}\n${indent}]`;
+}
+function printObject(obj, indent, state) {
+    const entries = Object.entries(obj).filter(([, value])=>value !== undefined);
+    if (entries.length === 0) return '{}';
+    const innerIndent = `${indent}  `;
+    const lines = entries.map(([key, value])=>`${innerIndent}${printKey(key)}: ${printValue(value, innerIndent, key, state)},`);
+    return `{\n${lines.join('\n')}\n${indent}}`;
+}
+
+//# sourceMappingURL=pullAspects.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/actions/media/pullAspects.ts"],"sourcesContent":["import {validateMediaLibraryAssetAspect} from '@sanity/schema/_internal'\nimport {type SchemaValidationProblem} from '@sanity/types'\nimport startCase from 'lodash-es/startCase.js'\n\nimport {type StoredAspectDocument} from '../../services/mediaLibraries.js'\nimport {VALID_ASPECT_NAME} from './aspectName.js'\n\n/** Keys whose object members are schema definitions, printed wrapped in a definer call. */\nconst DEFINER_BY_PARENT_KEY: Record<string, string> = {\n  fields: 'defineField',\n  of: 'defineArrayMember',\n}\n\nconst IDENTIFIER_KEY = /^[A-Za-z_$][A-Za-z0-9_$]*$/\n\n/** Scalar arrays shorter than this print inline (e.g. `options.list`). */\nconst INLINE_ARRAY_MAX_WIDTH = 60\n\n/**\n * The stored `sanity.asset.aspect` document shape this migration reads.\n * Deliberately loose: documents may predate the config model (authored via\n * `sanity media deploy-aspect` or by hand) and carry fields the model has no\n * equivalent for.\n */\nexport type PullableAspectDocument = StoredAspectDocument\n\nexport interface GeneratedFieldModule {\n  filename: string\n  /** The `aspects.<name>` data key — module filename and config entry name. */\n  name: string\n  source: string\n  status: 'generated'\n  title: string\n  warnings: string[]\n\n  public?: boolean\n}\n\nexport interface SkippedAspect {\n  id: string\n  reasons: string[]\n  status: 'skipped'\n  validationErrors: SchemaValidationProblem[][]\n}\n\nexport type PullAspectOutcome = GeneratedFieldModule | SkippedAspect\n\n/**\n * Convert a page of stored aspect documents into field modules, one per field\n * name. Two stored documents can resolve to the same name (a legacy document\n * whose `_id` predates its `definition.name`), which would otherwise produce\n * the same module twice — the document whose `_id` matches the name wins, the\n * rest are reported as skipped. Shared by `sanity media pull-aspects` and the\n * init-time pull offer.\n *\n * @internal\n */\nexport function convertAspectDocuments(documents: PullableAspectDocument[]): {\n  modules: GeneratedFieldModule[]\n  skipped: SkippedAspect[]\n} {\n  const skipped: SkippedAspect[] = []\n\n  // First pass: convert every stored document.\n  const candidates: Array<{module: GeneratedFieldModule; sourceId: string}> = []\n  for (const doc of documents) {\n    const outcome = aspectDocumentToFieldModule(doc)\n    if (outcome.status === 'skipped') {\n      skipped.push(outcome)\n    } else {\n      candidates.push({module: outcome, sourceId: String(doc._id)})\n    }\n  }\n\n  // Second pass: pick one winner per name.\n  const byName = new Map<string, Array<{module: GeneratedFieldModule; sourceId: string}>>()\n  for (const candidate of candidates) {\n    const group = byName.get(candidate.module.name) ?? []\n    group.push(candidate)\n    byName.set(candidate.module.name, group)\n  }\n  const modules: GeneratedFieldModule[] = []\n  for (const [name, group] of byName) {\n    const winner = group.find((candidate) => candidate.sourceId === name) ?? group[0]\n    modules.push(winner.module)\n    for (const loser of group) {\n      if (loser === winner) continue\n      skipped.push({\n        id: loser.sourceId,\n        reasons: [`Also defines \"${name}\" — generated from \"${winner.sourceId}\" instead`],\n        status: 'skipped',\n        validationErrors: [],\n      })\n    }\n  }\n\n  return {modules, skipped}\n}\n\n/**\n * Codegen one stored aspect document into a `src/fields/<name>.tsx` field\n * module for a Media Library config app.\n *\n * Stored aspects are migration-ready by construction: `definition` is the\n * JSON-serialized `defineField(...)` value with functions and component\n * references already stripped, so generation is mechanical pretty-printing\n * into a `defineField({...})` call (nested `fields`/`of` members wrapped in\n * `defineField`/`defineArrayMember`, matching hand-authored style).\n *\n * Edge cases handled here, not silently:\n *\n * - `_id` vs `definition.name` mismatch: the module is generated under\n *   `definition.name` — the `aspects.<name>` key existing asset data lives\n *   under. Normalizing onto `_id` instead would silently orphan that data.\n *   The old document (keyed `_id`) is reported for manual deletion.\n * - `assetType` has no equivalent in the config model; a document carrying it\n *   generates with a warning that the scoping is lost.\n * - Definitions failing current schema validation are skipped with the\n *   validation errors, mirroring `sanity media deploy-aspect`.\n *\n * Pure (no I/O): the command decides where modules are written.\n *\n * @internal\n */\nexport function aspectDocumentToFieldModule(doc: PullableAspectDocument): PullAspectOutcome {\n  const {_id} = doc\n\n  if (!isRecord(doc.definition)) {\n    return {\n      id: _id,\n      reasons: ['The stored document has no field definition object'],\n      status: 'skipped',\n      validationErrors: [],\n    }\n  }\n\n  const definitionName = typeof doc.definition.name === 'string' ? doc.definition.name : undefined\n  const name = definitionName ?? _id\n\n  if (!VALID_ASPECT_NAME.test(name)) {\n    return {\n      id: _id,\n      reasons: [\n        `\"${name}\" is not a valid field name (${VALID_ASPECT_NAME}) — it becomes the module name and the aspects.<name> key on assets`,\n      ],\n      status: 'skipped',\n      validationErrors: [],\n    }\n  }\n\n  const warnings: string[] = []\n\n  if (definitionName === undefined) {\n    warnings.push(`The stored definition has no name — using the document _id \"${_id}\"`)\n  } else if (definitionName !== _id) {\n    warnings.push(\n      `Stored _id \"${_id}\" and definition name \"${definitionName}\" differ. Generated as ` +\n        `\"${definitionName}\" — the aspects.<name> key existing asset data lives under; using ` +\n        `\"${_id}\" would orphan that data. Deploying the config creates \"${definitionName}\" ` +\n        `and deletes the old \"${_id}\" document.`,\n    )\n  }\n\n  if (doc.assetType !== undefined && doc.assetType !== null) {\n    warnings.push(\n      `The stored document scopes the aspect by assetType (${JSON.stringify(doc.assetType)}), ` +\n        `which has no equivalent in the config model — the generated field applies to all ` +\n        `asset types, and syncing the config drops the scoping.`,\n    )\n  }\n\n  // Normalize the name in before validating, so a document that only carries\n  // its name as `_id` isn't rejected for the missing property.\n  const definition: Record<string, unknown> = definitionName\n    ? doc.definition\n    : {name, ...doc.definition}\n\n  const [valid, validationErrors] = validateMediaLibraryAssetAspect(definition)\n  if (!valid) {\n    return {\n      id: _id,\n      reasons: ['The stored definition fails schema validation'],\n      status: 'skipped',\n      validationErrors,\n    }\n  }\n\n  return {\n    // .tsx although the generated content has no JSX: field modules are\n    // expected to grow custom input components (the one thing the stored\n    // aspect could not carry), and a later rename would also mean fixing the\n    // `src:` entry in sanity.cli.ts. Matches the template's example modules.\n    filename: `${name}.tsx`,\n    name,\n    ...(typeof doc.public === 'boolean' ? {public: doc.public} : {}),\n    source: printFieldModule(definition),\n    status: 'generated',\n    title: typeof definition.title === 'string' ? definition.title : startCase(name),\n    warnings,\n  }\n}\n\n/**\n * The paste-ready `fields: [...]` entries for `sanity.cli.ts`, one line per\n * generated module. When `writtenPaths` (module name to root-relative path)\n * has an entry for a module, that path wins — the module may have replaced an\n * existing file (e.g. a `.tsx` variant) rather than landing at the default\n * `<srcDir>/<filename>` location.\n *\n * @internal\n */\nexport function formatFieldEntries(\n  modules: GeneratedFieldModule[],\n  srcDir: string,\n  writtenPaths?: Map<string, string>,\n): string {\n  const dir = srcDir.replaceAll('\\\\', '/').replace(/\\/+$/, '')\n  return modules\n    .map((module) => {\n      const src =\n        writtenPaths?.get(module.name)?.replaceAll('\\\\', '/') ?? `${dir}/${module.filename}`\n      const publicPart = module.public === undefined ? '' : `, public: ${module.public}`\n      return `{name: '${module.name}', src: './${src}', title: ${quote(module.title)}${publicPart}},`\n    })\n    .join('\\n')\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\ninterface PrinterState {\n  usesDefineArrayMember: boolean\n}\n\nfunction printFieldModule(definition: Record<string, unknown>): string {\n  const state: PrinterState = {usesDefineArrayMember: false}\n  const literal = printObject(definition, '', state)\n  const imports = state.usesDefineArrayMember ? 'defineArrayMember, defineField' : 'defineField'\n\n  return `import {${imports}} from 'sanity'\\n\\nexport default defineField(${literal})\\n`\n}\n\nfunction quote(value: string): string {\n  const escaped = value\n    .replaceAll('\\\\', '\\\\\\\\')\n    .replaceAll(\"'\", String.raw`\\'`)\n    .replaceAll('\\n', String.raw`\\n`)\n    .replaceAll('\\r', String.raw`\\r`)\n    .replaceAll('\\t', String.raw`\\t`)\n  return `'${escaped}'`\n}\n\nfunction printKey(key: string): string {\n  return IDENTIFIER_KEY.test(key) ? key : quote(key)\n}\n\nfunction printValue(\n  value: unknown,\n  indent: string,\n  parentKey: string | null,\n  state: PrinterState,\n): string {\n  if (value === null) return 'null'\n  if (typeof value === 'string') return quote(value)\n  if (typeof value === 'number' || typeof value === 'boolean') return String(value)\n  if (Array.isArray(value)) return printArray(value, indent, parentKey, state)\n  if (isRecord(value)) return printObject(value, indent, state)\n  // Stored definitions are JSON documents; anything else cannot occur.\n  throw new TypeError(`Cannot print value of type ${typeof value}`)\n}\n\nfunction printArray(\n  items: unknown[],\n  indent: string,\n  parentKey: string | null,\n  state: PrinterState,\n): string {\n  if (items.length === 0) return '[]'\n\n  const allScalar = items.every(\n    (item) => item === null || ['boolean', 'number', 'string'].includes(typeof item),\n  )\n  if (allScalar) {\n    const inline = `[${items.map((item) => printValue(item, indent, null, state)).join(', ')}]`\n    if (inline.length <= INLINE_ARRAY_MAX_WIDTH) return inline\n  }\n\n  const definer = parentKey === null ? undefined : DEFINER_BY_PARENT_KEY[parentKey]\n  const innerIndent = `${indent}  `\n  const lines = items.map((item) => {\n    if (definer !== undefined && isRecord(item)) {\n      if (definer === 'defineArrayMember') state.usesDefineArrayMember = true\n      return `${innerIndent}${definer}(${printObject(item, innerIndent, state)}),`\n    }\n    return `${innerIndent}${printValue(item, innerIndent, null, state)},`\n  })\n  return `[\\n${lines.join('\\n')}\\n${indent}]`\n}\n\nfunction printObject(obj: Record<string, unknown>, indent: string, state: PrinterState): string {\n  const entries = Object.entries(obj).filter(([, value]) => value !== undefined)\n  if (entries.length === 0) return '{}'\n\n  const innerIndent = `${indent}  `\n  const lines = entries.map(\n    ([key, value]) =>\n      `${innerIndent}${printKey(key)}: ${printValue(value, innerIndent, key, state)},`,\n  )\n  return `{\\n${lines.join('\\n')}\\n${indent}}`\n}\n"],"names":["validateMediaLibraryAssetAspect","startCase","VALID_ASPECT_NAME","DEFINER_BY_PARENT_KEY","fields","of","IDENTIFIER_KEY","INLINE_ARRAY_MAX_WIDTH","convertAspectDocuments","documents","skipped","candidates","doc","outcome","aspectDocumentToFieldModule","status","push","module","sourceId","String","_id","byName","Map","candidate","group","get","name","set","modules","winner","find","loser","id","reasons","validationErrors","isRecord","definition","definitionName","undefined","test","warnings","assetType","JSON","stringify","valid","filename","public","source","printFieldModule","title","formatFieldEntries","srcDir","writtenPaths","dir","replaceAll","replace","map","src","publicPart","quote","join","value","Array","isArray","state","usesDefineArrayMember","literal","printObject","imports","escaped","raw","printKey","key","printValue","indent","parentKey","printArray","TypeError","items","length","allScalar","every","item","includes","inline","definer","innerIndent","lines","obj","entries","Object","filter"],"mappings":"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"}

package/dist/actions/media/resolveMediaLibraryId.js

@@ -0,0 +1,83 @@
+import { CLIError } from '@oclif/core/errors';
+import { exitCodes } from '@sanity/cli-core';
+import { promptForMediaLibrary } from '../../prompts/promptForMediaLibrary.js';
+import { getMediaLibrariesForOrganization } from '../../services/mediaLibraries.js';
+/** @see MediaLibraryResolution */ export async function resolveMediaLibrary(options) {
+    const { mediaLibraryIdFlag, organizationId } = options;
+    const libraries = await getMediaLibrariesForOrganization(organizationId);
+    const libraryIds = libraries.map((library)=>library.id);
+    if (mediaLibraryIdFlag) {
+        if (!libraryIds.includes(mediaLibraryIdFlag)) {
+            return {
+                message: `Media library ${mediaLibraryIdFlag} is not an active library of organization ` + `${organizationId} (found: ${libraryIds.join(', ') || 'none'})`,
+                solution: 'Pass --media-library-id with one of the active library ids',
+                type: 'invalid-flag'
+            };
+        }
+        return {
+            mediaLibraryId: mediaLibraryIdFlag,
+            type: 'resolved'
+        };
+    }
+    if (libraries.length === 0) {
+        return {
+            message: `Organization ${organizationId} has no active media library`,
+            solution: 'Install the Media Library for the organization first',
+            type: 'none-active'
+        };
+    }
+    if (libraries.length > 1) {
+        return {
+            libraries,
+            message: `Organization ${organizationId} has ${libraries.length} active media libraries ` + `(${libraryIds.join(', ')})`,
+            solution: 'Pass --media-library-id with the library this config belongs to',
+            type: 'ambiguous'
+        };
+    }
+    return {
+        mediaLibraryId: libraries[0].id,
+        type: 'resolved'
+    };
+}
+/**
+ * Command-facing resolution: ambiguity prompts when interactive (Ctrl+C there
+ * raises `ExitPromptError`, which callers must let propagate to
+ * `SanityCommand.catch`); misuse — a bad flag value, a missing required flag
+ * in unattended mode — exits with the usage code. No active library is an
+ * environment problem, not misuse, so it keeps the runtime code.
+ */ export async function resolveMediaLibraryId(options) {
+    const { mediaLibraryIdFlag, organizationId, unattended } = options;
+    const resolution = await resolveMediaLibrary({
+        mediaLibraryIdFlag,
+        organizationId
+    });
+    switch(resolution.type){
+        case 'ambiguous':
+            {
+                if (!unattended) return promptForMediaLibrary({
+                    mediaLibraries: resolution.libraries
+                });
+                throw new CLIError(`${resolution.message}. ${resolution.solution}.`, {
+                    exit: exitCodes.USAGE_ERROR
+                });
+            }
+        case 'invalid-flag':
+            {
+                throw new CLIError(`${resolution.message}. ${resolution.solution}.`, {
+                    exit: exitCodes.USAGE_ERROR
+                });
+            }
+        case 'none-active':
+            {
+                throw new CLIError(`${resolution.message}. ${resolution.solution}.`, {
+                    exit: exitCodes.RUNTIME_ERROR
+                });
+            }
+        default:
+            {
+                return resolution.mediaLibraryId;
+            }
+    }
+}
+
+//# sourceMappingURL=resolveMediaLibraryId.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/actions/media/resolveMediaLibraryId.ts"],"sourcesContent":["import {CLIError} from '@oclif/core/errors'\nimport {exitCodes} from '@sanity/cli-core'\n\nimport {promptForMediaLibrary} from '../../prompts/promptForMediaLibrary.js'\nimport {getMediaLibrariesForOrganization, type MediaLibrary} from '../../services/mediaLibraries.js'\n\n/**\n * The target-library resolution config-app media operations share: the flag\n * wins (validated against the organization's active libraries), a single\n * active library is unambiguous, anything else is a verdict the caller turns\n * into its own failure shape — a prompt, a usage error, or a deploy check.\n */\nexport type MediaLibraryResolution =\n  | {\n      /** The active libraries a prompt would offer. */\n      libraries: MediaLibrary[]\n      message: string\n      solution: string\n      type: 'ambiguous'\n    }\n  | {mediaLibraryId: string; type: 'resolved'}\n  | {message: string; solution: string; type: 'invalid-flag'}\n  | {message: string; solution: string; type: 'none-active'}\n\n/** @see MediaLibraryResolution */\nexport async function resolveMediaLibrary(options: {\n  mediaLibraryIdFlag: string | undefined\n  organizationId: string\n}): Promise<MediaLibraryResolution> {\n  const {mediaLibraryIdFlag, organizationId} = options\n  const libraries = await getMediaLibrariesForOrganization(organizationId)\n  const libraryIds = libraries.map((library) => library.id)\n\n  if (mediaLibraryIdFlag) {\n    if (!libraryIds.includes(mediaLibraryIdFlag)) {\n      return {\n        message:\n          `Media library ${mediaLibraryIdFlag} is not an active library of organization ` +\n          `${organizationId} (found: ${libraryIds.join(', ') || 'none'})`,\n        solution: 'Pass --media-library-id with one of the active library ids',\n        type: 'invalid-flag',\n      }\n    }\n    return {mediaLibraryId: mediaLibraryIdFlag, type: 'resolved'}\n  }\n\n  if (libraries.length === 0) {\n    return {\n      message: `Organization ${organizationId} has no active media library`,\n      solution: 'Install the Media Library for the organization first',\n      type: 'none-active',\n    }\n  }\n  if (libraries.length > 1) {\n    return {\n      libraries,\n      message:\n        `Organization ${organizationId} has ${libraries.length} active media libraries ` +\n        `(${libraryIds.join(', ')})`,\n      solution: 'Pass --media-library-id with the library this config belongs to',\n      type: 'ambiguous',\n    }\n  }\n  return {mediaLibraryId: libraries[0].id, type: 'resolved'}\n}\n\n/**\n * Command-facing resolution: ambiguity prompts when interactive (Ctrl+C there\n * raises `ExitPromptError`, which callers must let propagate to\n * `SanityCommand.catch`); misuse — a bad flag value, a missing required flag\n * in unattended mode — exits with the usage code. No active library is an\n * environment problem, not misuse, so it keeps the runtime code.\n */\nexport async function resolveMediaLibraryId(options: {\n  mediaLibraryIdFlag: string | undefined\n  organizationId: string\n  unattended: boolean\n}): Promise<string> {\n  const {mediaLibraryIdFlag, organizationId, unattended} = options\n  const resolution = await resolveMediaLibrary({mediaLibraryIdFlag, organizationId})\n\n  switch (resolution.type) {\n    case 'ambiguous': {\n      if (!unattended) return promptForMediaLibrary({mediaLibraries: resolution.libraries})\n      throw new CLIError(`${resolution.message}. ${resolution.solution}.`, {\n        exit: exitCodes.USAGE_ERROR,\n      })\n    }\n    case 'invalid-flag': {\n      throw new CLIError(`${resolution.message}. ${resolution.solution}.`, {\n        exit: exitCodes.USAGE_ERROR,\n      })\n    }\n    case 'none-active': {\n      throw new CLIError(`${resolution.message}. ${resolution.solution}.`, {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n    default: {\n      return resolution.mediaLibraryId\n    }\n  }\n}\n"],"names":["CLIError","exitCodes","promptForMediaLibrary","getMediaLibrariesForOrganization","resolveMediaLibrary","options","mediaLibraryIdFlag","organizationId","libraries","libraryIds","map","library","id","includes","message","join","solution","type","mediaLibraryId","length","resolveMediaLibraryId","unattended","resolution","mediaLibraries","exit","USAGE_ERROR","RUNTIME_ERROR"],"mappings":"AAAA,SAAQA,QAAQ,QAAO,qBAAoB;AAC3C,SAAQC,SAAS,QAAO,mBAAkB;AAE1C,SAAQC,qBAAqB,QAAO,yCAAwC;AAC5E,SAAQC,gCAAgC,QAA0B,mCAAkC;AAoBpG,gCAAgC,GAChC,OAAO,eAAeC,oBAAoBC,OAGzC;IACC,MAAM,EAACC,kBAAkB,EAAEC,cAAc,EAAC,GAAGF;IAC7C,MAAMG,YAAY,MAAML,iCAAiCI;IACzD,MAAME,aAAaD,UAAUE,GAAG,CAAC,CAACC,UAAYA,QAAQC,EAAE;IAExD,IAAIN,oBAAoB;QACtB,IAAI,CAACG,WAAWI,QAAQ,CAACP,qBAAqB;YAC5C,OAAO;gBACLQ,SACE,CAAC,cAAc,EAAER,mBAAmB,0CAA0C,CAAC,GAC/E,GAAGC,eAAe,SAAS,EAAEE,WAAWM,IAAI,CAAC,SAAS,OAAO,CAAC,CAAC;gBACjEC,UAAU;gBACVC,MAAM;YACR;QACF;QACA,OAAO;YAACC,gBAAgBZ;YAAoBW,MAAM;QAAU;IAC9D;IAEA,IAAIT,UAAUW,MAAM,KAAK,GAAG;QAC1B,OAAO;YACLL,SAAS,CAAC,aAAa,EAAEP,eAAe,4BAA4B,CAAC;YACrES,UAAU;YACVC,MAAM;QACR;IACF;IACA,IAAIT,UAAUW,MAAM,GAAG,GAAG;QACxB,OAAO;YACLX;YACAM,SACE,CAAC,aAAa,EAAEP,eAAe,KAAK,EAAEC,UAAUW,MAAM,CAAC,wBAAwB,CAAC,GAChF,CAAC,CAAC,EAAEV,WAAWM,IAAI,CAAC,MAAM,CAAC,CAAC;YAC9BC,UAAU;YACVC,MAAM;QACR;IACF;IACA,OAAO;QAACC,gBAAgBV,SAAS,CAAC,EAAE,CAACI,EAAE;QAAEK,MAAM;IAAU;AAC3D;AAEA;;;;;;CAMC,GACD,OAAO,eAAeG,sBAAsBf,OAI3C;IACC,MAAM,EAACC,kBAAkB,EAAEC,cAAc,EAAEc,UAAU,EAAC,GAAGhB;IACzD,MAAMiB,aAAa,MAAMlB,oBAAoB;QAACE;QAAoBC;IAAc;IAEhF,OAAQe,WAAWL,IAAI;QACrB,KAAK;YAAa;gBAChB,IAAI,CAACI,YAAY,OAAOnB,sBAAsB;oBAACqB,gBAAgBD,WAAWd,SAAS;gBAAA;gBACnF,MAAM,IAAIR,SAAS,GAAGsB,WAAWR,OAAO,CAAC,EAAE,EAAEQ,WAAWN,QAAQ,CAAC,CAAC,CAAC,EAAE;oBACnEQ,MAAMvB,UAAUwB,WAAW;gBAC7B;YACF;QACA,KAAK;YAAgB;gBACnB,MAAM,IAAIzB,SAAS,GAAGsB,WAAWR,OAAO,CAAC,EAAE,EAAEQ,WAAWN,QAAQ,CAAC,CAAC,CAAC,EAAE;oBACnEQ,MAAMvB,UAAUwB,WAAW;gBAC7B;YACF;QACA,KAAK;YAAe;gBAClB,MAAM,IAAIzB,SAAS,GAAGsB,WAAWR,OAAO,CAAC,EAAE,EAAEQ,WAAWN,QAAQ,CAAC,CAAC,CAAC,EAAE;oBACnEQ,MAAMvB,UAAUyB,aAAa;gBAC/B;YACF;QACA;YAAS;gBACP,OAAOJ,WAAWJ,cAAc;YAClC;IACF;AACF"}

package/dist/commands/codemod.js

@@ -82,6 +82,7 @@ export class CodemodCommand extends SanityCommand {
         // We use npx to run jscodeshift, so verify that it exists and works before using it
         this.ensureNpx();
         const prepared = await mod.prepare?.({
+            dry: dryRun,
             output: this.output,
             workDir
         });