@sanity/cli 8.22.1 → 8.23.0

package/dist/services/context.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/services/context.ts"],"sourcesContent":["import {getGlobalCliClient} from '@sanity/cli-core'\nimport {type Context} from '@sanity/client'\n\nconst CONTEXT_API_VERSION = 'v2026-08-25'\n\n/**\n * Knowledge-base-scoped methods on `client.context` (imports, builds, jobs)\n * operate on the client's configured `resource`; collection-level methods\n * (`client.context.knowledgeBases.*`) are addressed per call and need none.\n */\nasync function getContextClient(knowledgeBaseId?: string) {\n  return getGlobalCliClient({\n    apiVersion: CONTEXT_API_VERSION,\n    requireUser: true,\n    ...(knowledgeBaseId === undefined\n      ? {}\n      : {resource: {id: knowledgeBaseId, type: 'knowledge-base' as const}}),\n  })\n}\n\n/**\n * Create a knowledge base in an organization\n */\nexport async function createKnowledgeBase(\n  params: Context.CreateKnowledgeBaseParams,\n): Promise<Context.KnowledgeBase> {\n  const client = await getContextClient()\n  return client.context.knowledgeBases.create(params)\n}\n\n/**\n * List all knowledge bases in an organization (drains pagination)\n */\nexport async function listKnowledgeBases(organizationId: string): Promise<Context.KnowledgeBase[]> {\n  const client = await getContextClient()\n\n  const knowledgeBases: Context.KnowledgeBase[] = []\n  let cursor: string | undefined\n  do {\n    const page = await client.context.knowledgeBases.list({cursor, organizationId})\n    knowledgeBases.push(...page.data)\n    cursor = page.nextCursor ?? undefined\n  } while (cursor !== undefined)\n\n  return knowledgeBases\n}\n\n/**\n * Get a single knowledge base by ID\n */\nexport async function getKnowledgeBase(knowledgeBaseId: string): Promise<Context.KnowledgeBase> {\n  const client = await getContextClient()\n  return client.context.knowledgeBases.get(knowledgeBaseId)\n}\n\n/**\n * Update a knowledge base's configuration\n */\nexport async function updateKnowledgeBase(\n  knowledgeBaseId: string,\n  params: Context.EditKnowledgeBaseParams,\n): Promise<Context.KnowledgeBase> {\n  const client = await getContextClient()\n  return client.context.knowledgeBases.edit(knowledgeBaseId, params)\n}\n\n/**\n * Delete a knowledge base and its generated content\n */\nexport async function deleteKnowledgeBase(knowledgeBaseId: string): Promise<void> {\n  const client = await getContextClient()\n  await client.context.knowledgeBases.delete(knowledgeBaseId)\n}\n\n/**\n * Import content into a knowledge base. File imports are staged and uploaded\n * to signed storage by the client.\n */\nexport async function createImport(\n  knowledgeBaseId: string,\n  params: Context.CreateFileImportParams | Context.CreateImportParams,\n): Promise<Context.JobAccepted> {\n  const client = await getContextClient(knowledgeBaseId)\n  return client.context.imports.create(params)\n}\n\n/**\n * List all imports for a knowledge base (drains pagination)\n */\nexport async function listImports(knowledgeBaseId: string): Promise<Context.Import[]> {\n  const client = await getContextClient(knowledgeBaseId)\n\n  const imports: Context.Import[] = []\n  let cursor: string | undefined\n  do {\n    const page = await client.context.imports.list({cursor})\n    imports.push(...page.data)\n    cursor = page.nextCursor ?? undefined\n  } while (cursor !== undefined)\n\n  return imports\n}\n\n/**\n * Get a single import by ID\n */\nexport async function getImport(\n  knowledgeBaseId: string,\n  importId: string,\n): Promise<Context.ImportDetail> {\n  const client = await getContextClient(knowledgeBaseId)\n  return client.context.imports.get({importId})\n}\n\n/**\n * Get a short-lived signed URL for an import's original uploaded bytes\n */\nexport async function downloadImport(\n  knowledgeBaseId: string,\n  importId: string,\n): Promise<Context.ImportDownloadResponse> {\n  const client = await getContextClient(knowledgeBaseId)\n  return client.context.imports.download({importId})\n}\n\n/**\n * Delete an import from a knowledge base\n */\nexport async function deleteImport(knowledgeBaseId: string, importId: string): Promise<void> {\n  const client = await getContextClient(knowledgeBaseId)\n  await client.context.imports.delete({importId})\n}\n\n/**\n * Start a build of a knowledge base\n */\nexport async function buildKnowledgeBase(knowledgeBaseId: string): Promise<Context.JobAccepted> {\n  const client = await getContextClient(knowledgeBaseId)\n  return client.context.build()\n}\n\n/**\n * Cancel the running build of a knowledge base, if any\n */\nexport async function cancelKnowledgeBaseBuild(\n  knowledgeBaseId: string,\n): Promise<{cancelled: boolean}> {\n  const client = await getContextClient(knowledgeBaseId)\n  return client.context.cancelBuild()\n}\n\n/**\n * Run an incremental refresh: re-check sources and apply what changed\n */\nexport async function refreshKnowledgeBase(\n  knowledgeBaseId: string,\n): Promise<{jobId: string; started: boolean}> {\n  const client = await getContextClient(knowledgeBaseId)\n  return client.context.refresh()\n}\n\n/**\n * Get an async job (build, import) by ID\n */\nexport async function getJob(knowledgeBaseId: string, jobId: string): Promise<Context.Job> {\n  const client = await getContextClient(knowledgeBaseId)\n  return client.context.jobs.get({jobId})\n}\n"],"names":["getGlobalCliClient","CONTEXT_API_VERSION","getContextClient","knowledgeBaseId","apiVersion","requireUser","undefined","resource","id","type","createKnowledgeBase","params","client","context","knowledgeBases","create","listKnowledgeBases","organizationId","cursor","page","list","push","data","nextCursor","getKnowledgeBase","get","updateKnowledgeBase","edit","deleteKnowledgeBase","delete","createImport","imports","listImports","getImport","importId","downloadImport","download","deleteImport","buildKnowledgeBase","build","cancelKnowledgeBaseBuild","cancelBuild","refreshKnowledgeBase","refresh","getJob","jobId","jobs"],"mappings":"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"}
+{"version":3,"sources":["../../src/services/context.ts"],"sourcesContent":["import {getGlobalCliClient} from '@sanity/cli-core'\nimport {type Context} from '@sanity/client'\n\nconst CONTEXT_API_VERSION = 'v2026-08-25'\n\n/**\n * Knowledge-base-scoped methods on `client.context` operate on the client's\n * configured `resource`; collection-level methods\n * (`client.context.knowledgeBases.*`) are addressed per call and need none.\n * GROQ-backed reads also need `context.organizationId`.\n */\nasync function getContextClient(knowledgeBaseId?: string, organizationId?: string) {\n  return getGlobalCliClient({\n    apiVersion: CONTEXT_API_VERSION,\n    requireUser: true,\n    ...(knowledgeBaseId === undefined\n      ? {}\n      : {resource: {id: knowledgeBaseId, type: 'knowledge-base' as const}}),\n    ...(organizationId === undefined ? {} : {context: {organizationId}}),\n  })\n}\n\n/**\n * GROQ-backed reads (issues, entries) query the organization's\n * document store, where documents are keyed by the knowledge base's public ID.\n * Fetching the knowledge base resolves both, whichever of its IDs was passed.\n */\nasync function getContextStoreClient(knowledgeBaseId: string) {\n  const {organizationId, publicId} = await getKnowledgeBase(knowledgeBaseId)\n  return getContextClient(publicId, organizationId)\n}\n\n/**\n * Create a knowledge base in an organization\n */\nexport async function createKnowledgeBase(\n  params: Context.CreateKnowledgeBaseParams,\n): Promise<Context.KnowledgeBase> {\n  const client = await getContextClient()\n  return client.context.knowledgeBases.create(params)\n}\n\n/**\n * List all knowledge bases in an organization (drains pagination)\n */\nexport async function listKnowledgeBases(organizationId: string): Promise<Context.KnowledgeBase[]> {\n  const client = await getContextClient()\n\n  const knowledgeBases: Context.KnowledgeBase[] = []\n  let cursor: string | undefined\n  do {\n    const page = await client.context.knowledgeBases.list({cursor, organizationId})\n    knowledgeBases.push(...page.data)\n    cursor = page.nextCursor ?? undefined\n  } while (cursor !== undefined)\n\n  return knowledgeBases\n}\n\n/**\n * Get a single knowledge base by ID\n */\nexport async function getKnowledgeBase(knowledgeBaseId: string): Promise<Context.KnowledgeBase> {\n  const client = await getContextClient()\n  return client.context.knowledgeBases.get(knowledgeBaseId)\n}\n\n/**\n * Update a knowledge base's configuration\n */\nexport async function updateKnowledgeBase(\n  knowledgeBaseId: string,\n  params: Context.EditKnowledgeBaseParams,\n): Promise<Context.KnowledgeBase> {\n  const client = await getContextClient()\n  return client.context.knowledgeBases.edit(knowledgeBaseId, params)\n}\n\n/**\n * Delete a knowledge base and its generated content\n */\nexport async function deleteKnowledgeBase(knowledgeBaseId: string): Promise<void> {\n  const client = await getContextClient()\n  await client.context.knowledgeBases.delete(knowledgeBaseId)\n}\n\n/**\n * Import content into a knowledge base. File imports are staged and uploaded\n * to signed storage by the client.\n */\nexport async function createImport(\n  knowledgeBaseId: string,\n  params: Context.CreateFileImportParams | Context.CreateImportParams,\n): Promise<Context.JobAccepted> {\n  const client = await getContextClient(knowledgeBaseId)\n  return client.context.imports.create(params)\n}\n\n/**\n * List all imports for a knowledge base (drains pagination)\n */\nexport async function listImports(knowledgeBaseId: string): Promise<Context.Import[]> {\n  const client = await getContextClient(knowledgeBaseId)\n\n  const imports: Context.Import[] = []\n  let cursor: string | undefined\n  do {\n    const page = await client.context.imports.list({cursor})\n    imports.push(...page.data)\n    cursor = page.nextCursor ?? undefined\n  } while (cursor !== undefined)\n\n  return imports\n}\n\n/**\n * Get a single import by ID\n */\nexport async function getImport(\n  knowledgeBaseId: string,\n  importId: string,\n): Promise<Context.ImportDetail> {\n  const client = await getContextClient(knowledgeBaseId)\n  return client.context.imports.get({importId})\n}\n\n/**\n * Get a short-lived signed URL for an import's original uploaded bytes\n */\nexport async function downloadImport(\n  knowledgeBaseId: string,\n  importId: string,\n): Promise<Context.ImportDownloadResponse> {\n  const client = await getContextClient(knowledgeBaseId)\n  return client.context.imports.download({importId})\n}\n\n/**\n * Delete an import from a knowledge base\n */\nexport async function deleteImport(knowledgeBaseId: string, importId: string): Promise<void> {\n  const client = await getContextClient(knowledgeBaseId)\n  await client.context.imports.delete({importId})\n}\n\n/**\n * Start a build of a knowledge base\n */\nexport async function buildKnowledgeBase(knowledgeBaseId: string): Promise<Context.JobAccepted> {\n  const client = await getContextClient(knowledgeBaseId)\n  return client.context.build()\n}\n\n/**\n * Cancel the running build of a knowledge base, if any\n */\nexport async function cancelKnowledgeBaseBuild(\n  knowledgeBaseId: string,\n): Promise<{cancelled: boolean}> {\n  const client = await getContextClient(knowledgeBaseId)\n  return client.context.cancelBuild()\n}\n\n/**\n * Run an incremental refresh: re-check sources and apply what changed\n */\nexport async function refreshKnowledgeBase(\n  knowledgeBaseId: string,\n): Promise<{jobId: string; started: boolean}> {\n  const client = await getContextClient(knowledgeBaseId)\n  return client.context.refresh()\n}\n\n/**\n * Get an async job (build, import) by ID\n */\nexport async function getJob(knowledgeBaseId: string, jobId: string): Promise<Context.Job> {\n  const client = await getContextClient(knowledgeBaseId)\n  return client.context.jobs.get({jobId})\n}\n\n/**\n * List all issues for a knowledge base, optionally narrowed to one status\n */\nexport async function listIssues(\n  knowledgeBaseId: string,\n  status?: Context.IssueDoc['status'],\n): Promise<Context.IssueDoc[]> {\n  const client = await getContextStoreClient(knowledgeBaseId)\n  return client.context.issues.list({status})\n}\n\n/**\n * Get a single issue by ID, or `null` when it does not exist\n */\nexport async function getIssue(\n  knowledgeBaseId: string,\n  issueId: string,\n): Promise<Context.IssueDoc | null> {\n  const client = await getContextStoreClient(knowledgeBaseId)\n  return client.context.issues.get({issueId})\n}\n\n/**\n * Resolve a conflict issue by choosing one of its sides (by index). Choosing\n * a side other than the entry's current content starts a rewrite job.\n */\nexport async function resolveIssue(\n  knowledgeBaseId: string,\n  issueId: string,\n  resolution: number,\n): Promise<Context.ResolveIssueResponse> {\n  const client = await getContextClient(knowledgeBaseId)\n  return client.context.issues.resolve({issueId, resolution})\n}\n\n/**\n * Dismiss an issue\n */\nexport async function dismissIssue(\n  knowledgeBaseId: string,\n  issueId: string,\n): Promise<Context.DismissIssueResponse> {\n  const client = await getContextClient(knowledgeBaseId)\n  return client.context.issues.dismiss({issueId})\n}\n\n/**\n * Reopen a resolved conflict issue\n */\nexport async function reopenIssue(\n  knowledgeBaseId: string,\n  issueId: string,\n): Promise<Context.ReopenIssueResponse> {\n  const client = await getContextClient(knowledgeBaseId)\n  return client.context.issues.reopen({issueId})\n}\n\n/**\n * Apply accepted issues to a knowledge base in one batch\n */\nexport async function applyIssues(\n  knowledgeBaseId: string,\n  issueIds: string[],\n): Promise<Context.ApplyIssuesResponse> {\n  const client = await getContextClient(knowledgeBaseId)\n  return client.context.issues.apply({issueIds})\n}\n\n/**\n * List all entries for a knowledge base, path-ordered, without bodies\n */\nexport async function listEntries(knowledgeBaseId: string): Promise<Context.Entry[]> {\n  const client = await getContextStoreClient(knowledgeBaseId)\n  return client.context.entries.list()\n}\n\n/**\n * Get a single entry with its body and citations by outline path, or `null`\n * when no entry sits at that path\n */\nexport async function getEntry(\n  knowledgeBaseId: string,\n  path: string,\n): Promise<Context.EntryDoc | null> {\n  const client = await getContextStoreClient(knowledgeBaseId)\n  return client.context.entries.get({path})\n}\n\n/**\n * Rebuild one entry from its sources by outline path\n */\nexport async function rebuildEntry(\n  knowledgeBaseId: string,\n  path: string,\n): Promise<Context.RebuildEntryResponse> {\n  const client = await getContextClient(knowledgeBaseId)\n  return client.context.entries.rebuild({path})\n}\n\n/**\n * Run a GROQ query against an organization's Context documents\n */\nexport async function queryContext(\n  organizationId: string,\n  query: string,\n  params?: Record<string, unknown>,\n): Promise<unknown> {\n  const client = await getContextClient(undefined, organizationId)\n  return client.context.fetch(query, params)\n}\n"],"names":["getGlobalCliClient","CONTEXT_API_VERSION","getContextClient","knowledgeBaseId","organizationId","apiVersion","requireUser","undefined","resource","id","type","context","getContextStoreClient","publicId","getKnowledgeBase","createKnowledgeBase","params","client","knowledgeBases","create","listKnowledgeBases","cursor","page","list","push","data","nextCursor","get","updateKnowledgeBase","edit","deleteKnowledgeBase","delete","createImport","imports","listImports","getImport","importId","downloadImport","download","deleteImport","buildKnowledgeBase","build","cancelKnowledgeBaseBuild","cancelBuild","refreshKnowledgeBase","refresh","getJob","jobId","jobs","listIssues","status","issues","getIssue","issueId","resolveIssue","resolution","resolve","dismissIssue","dismiss","reopenIssue","reopen","applyIssues","issueIds","apply","listEntries","entries","getEntry","path","rebuildEntry","rebuild","queryContext","query","fetch"],"mappings":"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"}

package/dist/services/mediaLibraries.js

@@ -1,5 +1,6 @@
 import { getGlobalCliClient } from '@sanity/cli-core';
 import { MEDIA_LIBRARY_ASSET_ASPECT_TYPE_NAME } from '@sanity/types';
+import { VALID_ASPECT_NAME } from '../actions/media/aspectName.js';
 import { ASSET_UPLOAD_REQUEST_TAG_PREFIX, URL_INGEST_TIMEOUT_MS } from './assets.js';
 export const MEDIA_LIBRARY_API_VERSION = 'v2025-02-19';
 async function getMediaLibraryClient(options = {}) {
@@ -39,22 +40,188 @@ async function getMediaLibraryClient(options = {}) {
         url: `/media-libraries/${mediaLibraryId}/mutate`
     });
 }
+/** One listing endpoint, scoped by either owner — only the query param differs. */ async function listActiveMediaLibraries(query) {
+    const client = await getMediaLibraryClient();
+    const response = await client.request({
+        method: 'GET',
+        query,
+        url: `/media-libraries`
+    });
+    return response.data.filter((library)=>library.status === 'active');
+}
 /**
- * Get a list of media libraries for a project
+ * Get a list of active media libraries for a project
  * @param projectId - The project ID
  * @returns A promise that resolves to the media libraries
  *
  * @internal
- */ export async function getMediaLibraries(projectId) {
+ */ export function getMediaLibraries(projectId) {
+    return listActiveMediaLibraries({
+        projectId
+    });
+}
+/**
+ * Get a list of active media libraries for an organization
+ * @param organizationId - The organization ID
+ * @returns A promise that resolves to the active media libraries
+ *
+ * @internal
+ */ export function getMediaLibrariesForOrganization(organizationId) {
+    return listActiveMediaLibraries({
+        organizationId
+    });
+}
+/** Query page size — see the cursor loop in `queryAllPages`. */ const QUERY_PAGE_SIZE = 1000;
+/**
+ * Run a media-library GROQ query to exhaustion, paging on an `_id` cursor:
+ * the query API caps single-response sizes, and a truncated read would
+ * silently drop documents. Only an *empty* page ends the loop — a short page
+ * is not trusted as exhaustion, in case the endpoint ever returns fewer rows
+ * than the requested slice; the cursor advances past the last returned id
+ * either way, so partial slices just mean extra round-trips.
+ */ async function queryAllPages(options) {
+    const { filter, mediaLibraryId, params, perspective = 'published', projection = '', tag } = options;
     const client = await getMediaLibraryClient();
-    const response = await client.request({
-        method: 'GET',
-        query: {
-            projectId
+    const documents = [];
+    let lastId = '';
+    for(;;){
+        const response = await client.request({
+            body: {
+                params: {
+                    ...params,
+                    lastId
+                },
+                query: `*[${filter} && _id > $lastId] | order(_id) [0...${QUERY_PAGE_SIZE}]${projection}`
+            },
+            method: 'POST',
+            // `published` is this API version's default; passed explicitly so a
+            // future default change can never silently surface `drafts.*`
+            // duplicates of published documents.
+            query: {
+                perspective
+            },
+            tag,
+            url: `/media-libraries/${mediaLibraryId}/query`
+        });
+        const page = response?.result ?? [];
+        documents.push(...page);
+        const last = page.at(-1);
+        if (!last) break;
+        lastId = last._id;
+    }
+    return documents;
+}
+/**
+ * Fetch the stored aspect documents of a media library
+ * @param mediaLibraryId - The media library ID
+ * @returns A promise that resolves to the aspect documents, ordered by id
+ *
+ * @internal
+ */ export function getAspects(mediaLibraryId) {
+    // An incomplete read here is destructive downstream: a pull would generate
+    // a config missing the dropped aspects, and its deploy deletes them.
+    return queryAllPages({
+        filter: '_type == $type',
+        mediaLibraryId,
+        params: {
+            type: MEDIA_LIBRARY_ASSET_ASPECT_TYPE_NAME
+        }
+    });
+}
+/**
+ * Fetch every stored aspect document `_id` of a media library. The consumer
+ * acts destructively on the result (mirror deletes), where a silently
+ * truncated list means reporting success while stale documents are left
+ * behind — `queryAllPages` reads to exhaustion.
+ *
+ * The `published` perspective (the helper's default) matters doubly here:
+ * stale detection must never see draft ids. The sync's upserts write
+ * published documents and its deletes match ids exactly, so drafts (not
+ * normally used for aspect docs) are out of scope either way — a
+ * default-perspective read could flag a `drafts.*` id as stale and target it
+ * for deletion.
+ *
+ * `tag` names the calling operation in request logs; it defaults to the
+ * deploy-time sync, the original consumer.
+ *
+ * @internal
+ */ export async function getStoredAspectIds(mediaLibraryId, tag = 'aspect-sync') {
+    const documents = await queryAllPages({
+        filter: '_type == $type',
+        mediaLibraryId,
+        params: {
+            type: MEDIA_LIBRARY_ASSET_ASPECT_TYPE_NAME
         },
-        url: `/media-libraries`
+        projection: '{_id}',
+        tag
+    });
+    return documents.map((doc)=>doc._id);
+}
+/**
+ * Fetch the `_id` of every asset document carrying a value under
+ * `aspects.<aspectName>`.
+ *
+ * Queried under the `raw` perspective so drafts are included alongside
+ * published documents — a prune that missed drafts would resurrect the data
+ * on publish.
+ *
+ * @internal
+ */ export async function getAspectDataCarrierIds(mediaLibraryId, aspectName) {
+    // Defense in depth: callers validate the name against the aspect-name rule,
+    // but this string is interpolated into GROQ, so re-guard here.
+    if (!VALID_ASPECT_NAME.test(aspectName)) {
+        throw new Error(`"${aspectName}" is not a valid aspect name`);
+    }
+    const documents = await queryAllPages({
+        filter: `_type == "sanity.asset" && defined(aspects["${aspectName}"])`,
+        mediaLibraryId,
+        params: {},
+        perspective: 'raw',
+        projection: '{_id}',
+        tag: 'prune-aspect-data'
+    });
+    return documents.map((doc)=>doc._id);
+}
+/**
+ * Remove `aspects.<aspectName>` from the given asset documents in one mutate
+ * request. Irreversible — this deletes aspect data, not a definition.
+ *
+ * @internal
+ */ export async function unsetAspectData(options) {
+    const { aspectName, assetIds, mediaLibraryId } = options;
+    const client = await getMediaLibraryClient();
+    await client.request({
+        body: {
+            mutations: assetIds.map((id)=>({
+                    patch: {
+                        id,
+                        unset: [
+                            `aspects.${aspectName}`
+                        ]
+                    }
+                }))
+        },
+        method: 'POST',
+        tag: 'prune-aspect-data',
+        url: `/media-libraries/${mediaLibraryId}/mutate`
+    });
+}
+/**
+ * Apply one aspect-sync transaction — the upsert/delete mutation list built by
+ * `buildSyncMutations` — to a media library in a single request.
+ *
+ * @internal
+ */ export async function mutateAspects(options) {
+    const { mediaLibraryId, mutations } = options;
+    const client = await getMediaLibraryClient();
+    return client.request({
+        body: {
+            mutations
+        },
+        method: 'POST',
+        tag: 'aspect-sync',
+        url: `/media-libraries/${mediaLibraryId}/mutate`
     });
-    return response.data.filter((library)=>library.status === 'active');
 }
 /**
  * Deploy one or more aspects to a media library

package/dist/services/mediaLibraries.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/services/mediaLibraries.ts"],"sourcesContent":["import {getGlobalCliClient} from '@sanity/cli-core'\nimport {\n  type FileAsset,\n  type ImageAsset,\n  MEDIA_LIBRARY_ASSET_ASPECT_TYPE_NAME,\n  type MediaLibraryAssetAspectDocument,\n  type SanityDocument,\n} from '@sanity/types'\n\nimport {ASSET_UPLOAD_REQUEST_TAG_PREFIX, URL_INGEST_TIMEOUT_MS} from './assets.js'\n\nexport const MEDIA_LIBRARY_API_VERSION = 'v2025-02-19'\n\nasync function getMediaLibraryClient(options: {requestTagPrefix?: string} = {}) {\n  const {requestTagPrefix} = options\n\n  return getGlobalCliClient({\n    apiVersion: MEDIA_LIBRARY_API_VERSION,\n    ...(requestTagPrefix ? {requestTagPrefix} : {}),\n    requireUser: true,\n  })\n}\n\ninterface DeleteAspectOptions {\n  aspectName: string\n  mediaLibraryId: string\n  projectId: string\n}\n\ninterface DeleteAspectResponse {\n  results: Array<{id: string}>\n}\n\n/**\n * Delete an aspect from a media library\n * @param options - The options for deleting an aspect\n * @returns A promise that resolves to the deletion response\n *\n * @internal\n */\nexport async function deleteAspect(options: DeleteAspectOptions): Promise<DeleteAspectResponse> {\n  const {aspectName, mediaLibraryId} = options\n\n  const client = await getMediaLibraryClient()\n\n  return client.request<DeleteAspectResponse>({\n    body: {\n      mutations: [\n        {\n          delete: {\n            params: {\n              id: aspectName,\n              type: MEDIA_LIBRARY_ASSET_ASPECT_TYPE_NAME,\n            },\n            query: `*[_type == $type && _id == $id]`,\n          },\n        },\n      ],\n    },\n    method: 'POST',\n    url: `/media-libraries/${mediaLibraryId}/mutate`,\n  })\n}\n\nexport interface MediaLibrary {\n  id: string\n  organizationId: string\n  status: 'active' | 'inactive'\n}\n\ninterface MediaLibrariesResponse {\n  data: MediaLibrary[]\n}\n\n/**\n * Get a list of media libraries for a project\n * @param projectId - The project ID\n * @returns A promise that resolves to the media libraries\n *\n * @internal\n */\nexport async function getMediaLibraries(projectId: string): Promise<MediaLibrary[]> {\n  const client = await getMediaLibraryClient()\n\n  const response = await client.request<MediaLibrariesResponse>({\n    method: 'GET',\n    query: {\n      projectId,\n    },\n    url: `/media-libraries`,\n  })\n\n  return response.data.filter((library) => library.status === 'active')\n}\n\ninterface DeployAspectsOptions {\n  aspects: MediaLibraryAssetAspectDocument[]\n  mediaLibraryId: string\n}\n\ninterface DeployAspectsResponse {\n  results: Array<{id: string; operation: string}>\n}\n\n/**\n * Deploy one or more aspects to a media library\n * @param options - The options for deploying aspects\n * @returns A promise that resolves to the deployment response\n *\n * @internal\n */\nexport async function deployAspects(options: DeployAspectsOptions): Promise<DeployAspectsResponse> {\n  const {aspects, mediaLibraryId} = options\n\n  const client = await getMediaLibraryClient()\n\n  return client.request<DeployAspectsResponse>({\n    body: {\n      mutations: aspects.map((aspect) => ({\n        createOrReplace: aspect,\n      })),\n    },\n    method: 'POST',\n    url: `/media-libraries/${mediaLibraryId}/mutate`,\n  })\n}\n\n/**\n * The pair of documents a media library creates for one asset: the\n * `sanity.asset` document that carries aspects, and the asset instance holding\n * the file metadata.\n *\n * @internal\n */\nexport interface MediaLibraryAsset {\n  asset: SanityDocument & {\n    _type: 'sanity.asset'\n    aspects: unknown\n    assetType: FileAsset['_type'] | ImageAsset['_type']\n  }\n  assetInstance: FileAsset | ImageAsset\n}\n\ninterface IngestMediaLibraryAssetFromUrlOptions {\n  mediaLibraryId: string\n  url: string\n\n  aspects?: Record<string, unknown>\n  filename?: string\n  signal?: AbortSignal\n}\n\n/**\n * Create a media library asset from a URL that Sanity fetches itself.\n *\n * Unlike the dataset equivalent in `./assets.ts`, the asset type is not part of\n * the request — the library derives it from the fetched content — and aspects\n * are set inline here rather than patched on afterwards.\n *\n * The source must be reachable without authentication from Sanity's side; a\n * presigned URL qualifies, a private one behind a login does not.\n *\n * @internal\n */\nexport async function ingestMediaLibraryAssetFromUrl({\n  aspects,\n  filename,\n  mediaLibraryId,\n  signal,\n  url,\n}: IngestMediaLibraryAssetFromUrlOptions): Promise<MediaLibraryAsset> {\n  signal?.throwIfAborted()\n\n  const client = await getMediaLibraryClient({\n    requestTagPrefix: ASSET_UPLOAD_REQUEST_TAG_PREFIX,\n  })\n\n  return client.request<MediaLibraryAsset>({\n    body: {\n      url,\n      ...(filename ? {filename} : {}),\n      ...(aspects ? {aspects} : {}),\n    },\n    method: 'POST',\n    signal,\n    tag: 'asset.upload.from-url',\n    timeout: URL_INGEST_TIMEOUT_MS,\n    url: `/media-libraries/${mediaLibraryId}/from-url`,\n  })\n}\n"],"names":["getGlobalCliClient","MEDIA_LIBRARY_ASSET_ASPECT_TYPE_NAME","ASSET_UPLOAD_REQUEST_TAG_PREFIX","URL_INGEST_TIMEOUT_MS","MEDIA_LIBRARY_API_VERSION","getMediaLibraryClient","options","requestTagPrefix","apiVersion","requireUser","deleteAspect","aspectName","mediaLibraryId","client","request","body","mutations","delete","params","id","type","query","method","url","getMediaLibraries","projectId","response","data","filter","library","status","deployAspects","aspects","map","aspect","createOrReplace","ingestMediaLibraryAssetFromUrl","filename","signal","throwIfAborted","tag","timeout"],"mappings":"AAAA,SAAQA,kBAAkB,QAAO,mBAAkB;AACnD,SAGEC,oCAAoC,QAG/B,gBAAe;AAEtB,SAAQC,+BAA+B,EAAEC,qBAAqB,QAAO,cAAa;AAElF,OAAO,MAAMC,4BAA4B,cAAa;AAEtD,eAAeC,sBAAsBC,UAAuC,CAAC,CAAC;IAC5E,MAAM,EAACC,gBAAgB,EAAC,GAAGD;IAE3B,OAAON,mBAAmB;QACxBQ,YAAYJ;QACZ,GAAIG,mBAAmB;YAACA;QAAgB,IAAI,CAAC,CAAC;QAC9CE,aAAa;IACf;AACF;AAYA;;;;;;CAMC,GACD,OAAO,eAAeC,aAAaJ,OAA4B;IAC7D,MAAM,EAACK,UAAU,EAAEC,cAAc,EAAC,GAAGN;IAErC,MAAMO,SAAS,MAAMR;IAErB,OAAOQ,OAAOC,OAAO,CAAuB;QAC1CC,MAAM;YACJC,WAAW;gBACT;oBACEC,QAAQ;wBACNC,QAAQ;4BACNC,IAAIR;4BACJS,MAAMnB;wBACR;wBACAoB,OAAO,CAAC,+BAA+B,CAAC;oBAC1C;gBACF;aACD;QACH;QACAC,QAAQ;QACRC,KAAK,CAAC,iBAAiB,EAAEX,eAAe,OAAO,CAAC;IAClD;AACF;AAYA;;;;;;CAMC,GACD,OAAO,eAAeY,kBAAkBC,SAAiB;IACvD,MAAMZ,SAAS,MAAMR;IAErB,MAAMqB,WAAW,MAAMb,OAAOC,OAAO,CAAyB;QAC5DQ,QAAQ;QACRD,OAAO;YACLI;QACF;QACAF,KAAK,CAAC,gBAAgB,CAAC;IACzB;IAEA,OAAOG,SAASC,IAAI,CAACC,MAAM,CAAC,CAACC,UAAYA,QAAQC,MAAM,KAAK;AAC9D;AAWA;;;;;;CAMC,GACD,OAAO,eAAeC,cAAczB,OAA6B;IAC/D,MAAM,EAAC0B,OAAO,EAAEpB,cAAc,EAAC,GAAGN;IAElC,MAAMO,SAAS,MAAMR;IAErB,OAAOQ,OAAOC,OAAO,CAAwB;QAC3CC,MAAM;YACJC,WAAWgB,QAAQC,GAAG,CAAC,CAACC,SAAY,CAAA;oBAClCC,iBAAiBD;gBACnB,CAAA;QACF;QACAZ,QAAQ;QACRC,KAAK,CAAC,iBAAiB,EAAEX,eAAe,OAAO,CAAC;IAClD;AACF;AA2BA;;;;;;;;;;;CAWC,GACD,OAAO,eAAewB,+BAA+B,EACnDJ,OAAO,EACPK,QAAQ,EACRzB,cAAc,EACd0B,MAAM,EACNf,GAAG,EACmC;IACtCe,QAAQC;IAER,MAAM1B,SAAS,MAAMR,sBAAsB;QACzCE,kBAAkBL;IACpB;IAEA,OAAOW,OAAOC,OAAO,CAAoB;QACvCC,MAAM;YACJQ;YACA,GAAIc,WAAW;gBAACA;YAAQ,IAAI,CAAC,CAAC;YAC9B,GAAIL,UAAU;gBAACA;YAAO,IAAI,CAAC,CAAC;QAC9B;QACAV,QAAQ;QACRgB;QACAE,KAAK;QACLC,SAAStC;QACToB,KAAK,CAAC,iBAAiB,EAAEX,eAAe,SAAS,CAAC;IACpD;AACF"}
+{"version":3,"sources":["../../src/services/mediaLibraries.ts"],"sourcesContent":["import {getGlobalCliClient} from '@sanity/cli-core'\nimport {\n  type FileAsset,\n  type ImageAsset,\n  MEDIA_LIBRARY_ASSET_ASPECT_TYPE_NAME,\n  type MediaLibraryAssetAspectDocument,\n  type SanityDocument,\n} from '@sanity/types'\n\nimport {VALID_ASPECT_NAME} from '../actions/media/aspectName.js'\nimport {ASSET_UPLOAD_REQUEST_TAG_PREFIX, URL_INGEST_TIMEOUT_MS} from './assets.js'\n\nexport const MEDIA_LIBRARY_API_VERSION = 'v2025-02-19'\n\nasync function getMediaLibraryClient(options: {requestTagPrefix?: string} = {}) {\n  const {requestTagPrefix} = options\n\n  return getGlobalCliClient({\n    apiVersion: MEDIA_LIBRARY_API_VERSION,\n    ...(requestTagPrefix ? {requestTagPrefix} : {}),\n    requireUser: true,\n  })\n}\n\ninterface DeleteAspectOptions {\n  aspectName: string\n  mediaLibraryId: string\n  projectId: string\n}\n\ninterface DeleteAspectResponse {\n  results: Array<{id: string}>\n}\n\n/**\n * Delete an aspect from a media library\n * @param options - The options for deleting an aspect\n * @returns A promise that resolves to the deletion response\n *\n * @internal\n */\nexport async function deleteAspect(options: DeleteAspectOptions): Promise<DeleteAspectResponse> {\n  const {aspectName, mediaLibraryId} = options\n\n  const client = await getMediaLibraryClient()\n\n  return client.request<DeleteAspectResponse>({\n    body: {\n      mutations: [\n        {\n          delete: {\n            params: {\n              id: aspectName,\n              type: MEDIA_LIBRARY_ASSET_ASPECT_TYPE_NAME,\n            },\n            query: `*[_type == $type && _id == $id]`,\n          },\n        },\n      ],\n    },\n    method: 'POST',\n    url: `/media-libraries/${mediaLibraryId}/mutate`,\n  })\n}\n\nexport interface MediaLibrary {\n  id: string\n  organizationId: string\n  status: 'active' | 'inactive'\n}\n\ninterface MediaLibrariesResponse {\n  data: MediaLibrary[]\n}\n\n/** One listing endpoint, scoped by either owner — only the query param differs. */\nasync function listActiveMediaLibraries(\n  query: {organizationId: string} | {projectId: string},\n): Promise<MediaLibrary[]> {\n  const client = await getMediaLibraryClient()\n\n  const response = await client.request<MediaLibrariesResponse>({\n    method: 'GET',\n    query,\n    url: `/media-libraries`,\n  })\n\n  return response.data.filter((library) => library.status === 'active')\n}\n\n/**\n * Get a list of active media libraries for a project\n * @param projectId - The project ID\n * @returns A promise that resolves to the media libraries\n *\n * @internal\n */\nexport function getMediaLibraries(projectId: string): Promise<MediaLibrary[]> {\n  return listActiveMediaLibraries({projectId})\n}\n\n/**\n * Get a list of active media libraries for an organization\n * @param organizationId - The organization ID\n * @returns A promise that resolves to the active media libraries\n *\n * @internal\n */\nexport function getMediaLibrariesForOrganization(organizationId: string): Promise<MediaLibrary[]> {\n  return listActiveMediaLibraries({organizationId})\n}\n\ninterface QueryResponse<T> {\n  result?: T\n}\n\n/**\n * A stored `sanity.asset.aspect` document as the query API returns it: `_id`\n * is guaranteed by the document store, everything else is validated by the\n * consumer (`aspectDocumentToFieldModule`).\n */\nexport interface StoredAspectDocument {\n  _id: string\n\n  assetType?: unknown\n  definition?: unknown\n  public?: unknown\n}\n\n/** Query page size — see the cursor loop in `queryAllPages`. */\nconst QUERY_PAGE_SIZE = 1000\n\n/**\n * Run a media-library GROQ query to exhaustion, paging on an `_id` cursor:\n * the query API caps single-response sizes, and a truncated read would\n * silently drop documents. Only an *empty* page ends the loop — a short page\n * is not trusted as exhaustion, in case the endpoint ever returns fewer rows\n * than the requested slice; the cursor advances past the last returned id\n * either way, so partial slices just mean extra round-trips.\n */\nasync function queryAllPages<T extends {_id: string}>(options: {\n  /** GROQ filter the `_id` cursor condition is appended to, e.g. `_type == $type`. */\n  filter: string\n  mediaLibraryId: string\n  params: Record<string, unknown>\n  /** `raw` includes drafts — call sites say why they need them. */\n  perspective?: 'published' | 'raw'\n  /** GROQ projection, e.g. `{_id}`. Omitted, the whole documents return. */\n  projection?: string\n  /** Request tag, e.g. `aspect-sync`. */\n  tag?: string\n}): Promise<T[]> {\n  const {filter, mediaLibraryId, params, perspective = 'published', projection = '', tag} = options\n  const client = await getMediaLibraryClient()\n\n  const documents: T[] = []\n  let lastId = ''\n  for (;;) {\n    const response = await client.request<QueryResponse<T[]> | undefined>({\n      body: {\n        params: {...params, lastId},\n        query: `*[${filter} && _id > $lastId] | order(_id) [0...${QUERY_PAGE_SIZE}]${projection}`,\n      },\n      method: 'POST',\n      // `published` is this API version's default; passed explicitly so a\n      // future default change can never silently surface `drafts.*`\n      // duplicates of published documents.\n      query: {perspective},\n      tag,\n      url: `/media-libraries/${mediaLibraryId}/query`,\n    })\n    const page = response?.result ?? []\n    documents.push(...page)\n    const last = page.at(-1)\n    if (!last) break\n    lastId = last._id\n  }\n\n  return documents\n}\n\n/**\n * Fetch the stored aspect documents of a media library\n * @param mediaLibraryId - The media library ID\n * @returns A promise that resolves to the aspect documents, ordered by id\n *\n * @internal\n */\nexport function getAspects(mediaLibraryId: string): Promise<StoredAspectDocument[]> {\n  // An incomplete read here is destructive downstream: a pull would generate\n  // a config missing the dropped aspects, and its deploy deletes them.\n  return queryAllPages<StoredAspectDocument>({\n    filter: '_type == $type',\n    mediaLibraryId,\n    params: {type: MEDIA_LIBRARY_ASSET_ASPECT_TYPE_NAME},\n  })\n}\n\n/**\n * Fetch every stored aspect document `_id` of a media library. The consumer\n * acts destructively on the result (mirror deletes), where a silently\n * truncated list means reporting success while stale documents are left\n * behind — `queryAllPages` reads to exhaustion.\n *\n * The `published` perspective (the helper's default) matters doubly here:\n * stale detection must never see draft ids. The sync's upserts write\n * published documents and its deletes match ids exactly, so drafts (not\n * normally used for aspect docs) are out of scope either way — a\n * default-perspective read could flag a `drafts.*` id as stale and target it\n * for deletion.\n *\n * `tag` names the calling operation in request logs; it defaults to the\n * deploy-time sync, the original consumer.\n *\n * @internal\n */\nexport async function getStoredAspectIds(\n  mediaLibraryId: string,\n  tag = 'aspect-sync',\n): Promise<string[]> {\n  const documents = await queryAllPages<{_id: string}>({\n    filter: '_type == $type',\n    mediaLibraryId,\n    params: {type: MEDIA_LIBRARY_ASSET_ASPECT_TYPE_NAME},\n    projection: '{_id}',\n    tag,\n  })\n  return documents.map((doc) => doc._id)\n}\n\n/**\n * Fetch the `_id` of every asset document carrying a value under\n * `aspects.<aspectName>`.\n *\n * Queried under the `raw` perspective so drafts are included alongside\n * published documents — a prune that missed drafts would resurrect the data\n * on publish.\n *\n * @internal\n */\nexport async function getAspectDataCarrierIds(\n  mediaLibraryId: string,\n  aspectName: string,\n): Promise<string[]> {\n  // Defense in depth: callers validate the name against the aspect-name rule,\n  // but this string is interpolated into GROQ, so re-guard here.\n  if (!VALID_ASPECT_NAME.test(aspectName)) {\n    throw new Error(`\"${aspectName}\" is not a valid aspect name`)\n  }\n  const documents = await queryAllPages<{_id: string}>({\n    filter: `_type == \"sanity.asset\" && defined(aspects[\"${aspectName}\"])`,\n    mediaLibraryId,\n    params: {},\n    perspective: 'raw',\n    projection: '{_id}',\n    tag: 'prune-aspect-data',\n  })\n  return documents.map((doc) => doc._id)\n}\n\n/**\n * Remove `aspects.<aspectName>` from the given asset documents in one mutate\n * request. Irreversible — this deletes aspect data, not a definition.\n *\n * @internal\n */\nexport async function unsetAspectData(options: {\n  aspectName: string\n  assetIds: string[]\n  mediaLibraryId: string\n}): Promise<void> {\n  const {aspectName, assetIds, mediaLibraryId} = options\n\n  const client = await getMediaLibraryClient()\n\n  await client.request({\n    body: {\n      mutations: assetIds.map((id) => ({\n        patch: {id, unset: [`aspects.${aspectName}`]},\n      })),\n    },\n    method: 'POST',\n    tag: 'prune-aspect-data',\n    url: `/media-libraries/${mediaLibraryId}/mutate`,\n  })\n}\n\ninterface MutateAspectsResponse {\n  results?: Array<{id: string; operation: string}>\n}\n\n/**\n * Apply one aspect-sync transaction — the upsert/delete mutation list built by\n * `buildSyncMutations` — to a media library in a single request.\n *\n * @internal\n */\nexport async function mutateAspects(options: {\n  mediaLibraryId: string\n  mutations: unknown[]\n}): Promise<MutateAspectsResponse> {\n  const {mediaLibraryId, mutations} = options\n\n  const client = await getMediaLibraryClient()\n\n  return client.request<MutateAspectsResponse>({\n    body: {mutations},\n    method: 'POST',\n    tag: 'aspect-sync',\n    url: `/media-libraries/${mediaLibraryId}/mutate`,\n  })\n}\n\ninterface DeployAspectsOptions {\n  aspects: MediaLibraryAssetAspectDocument[]\n  mediaLibraryId: string\n}\n\ninterface DeployAspectsResponse {\n  results: Array<{id: string; operation: string}>\n}\n\n/**\n * Deploy one or more aspects to a media library\n * @param options - The options for deploying aspects\n * @returns A promise that resolves to the deployment response\n *\n * @internal\n */\nexport async function deployAspects(options: DeployAspectsOptions): Promise<DeployAspectsResponse> {\n  const {aspects, mediaLibraryId} = options\n\n  const client = await getMediaLibraryClient()\n\n  return client.request<DeployAspectsResponse>({\n    body: {\n      mutations: aspects.map((aspect) => ({\n        createOrReplace: aspect,\n      })),\n    },\n    method: 'POST',\n    url: `/media-libraries/${mediaLibraryId}/mutate`,\n  })\n}\n\n/**\n * The pair of documents a media library creates for one asset: the\n * `sanity.asset` document that carries aspects, and the asset instance holding\n * the file metadata.\n *\n * @internal\n */\nexport interface MediaLibraryAsset {\n  asset: SanityDocument & {\n    _type: 'sanity.asset'\n    aspects: unknown\n    assetType: FileAsset['_type'] | ImageAsset['_type']\n  }\n  assetInstance: FileAsset | ImageAsset\n}\n\ninterface IngestMediaLibraryAssetFromUrlOptions {\n  mediaLibraryId: string\n  url: string\n\n  aspects?: Record<string, unknown>\n  filename?: string\n  signal?: AbortSignal\n}\n\n/**\n * Create a media library asset from a URL that Sanity fetches itself.\n *\n * Unlike the dataset equivalent in `./assets.ts`, the asset type is not part of\n * the request — the library derives it from the fetched content — and aspects\n * are set inline here rather than patched on afterwards.\n *\n * The source must be reachable without authentication from Sanity's side; a\n * presigned URL qualifies, a private one behind a login does not.\n *\n * @internal\n */\nexport async function ingestMediaLibraryAssetFromUrl({\n  aspects,\n  filename,\n  mediaLibraryId,\n  signal,\n  url,\n}: IngestMediaLibraryAssetFromUrlOptions): Promise<MediaLibraryAsset> {\n  signal?.throwIfAborted()\n\n  const client = await getMediaLibraryClient({\n    requestTagPrefix: ASSET_UPLOAD_REQUEST_TAG_PREFIX,\n  })\n\n  return client.request<MediaLibraryAsset>({\n    body: {\n      url,\n      ...(filename ? {filename} : {}),\n      ...(aspects ? {aspects} : {}),\n    },\n    method: 'POST',\n    signal,\n    tag: 'asset.upload.from-url',\n    timeout: URL_INGEST_TIMEOUT_MS,\n    url: `/media-libraries/${mediaLibraryId}/from-url`,\n  })\n}\n"],"names":["getGlobalCliClient","MEDIA_LIBRARY_ASSET_ASPECT_TYPE_NAME","VALID_ASPECT_NAME","ASSET_UPLOAD_REQUEST_TAG_PREFIX","URL_INGEST_TIMEOUT_MS","MEDIA_LIBRARY_API_VERSION","getMediaLibraryClient","options","requestTagPrefix","apiVersion","requireUser","deleteAspect","aspectName","mediaLibraryId","client","request","body","mutations","delete","params","id","type","query","method","url","listActiveMediaLibraries","response","data","filter","library","status","getMediaLibraries","projectId","getMediaLibrariesForOrganization","organizationId","QUERY_PAGE_SIZE","queryAllPages","perspective","projection","tag","documents","lastId","page","result","push","last","at","_id","getAspects","getStoredAspectIds","map","doc","getAspectDataCarrierIds","test","Error","unsetAspectData","assetIds","patch","unset","mutateAspects","deployAspects","aspects","aspect","createOrReplace","ingestMediaLibraryAssetFromUrl","filename","signal","throwIfAborted","timeout"],"mappings":"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"}