@sanity/cli 8.7.0 → 8.8.0

package/README.md

@@ -33,6 +33,19 @@ Code for sanity cli
 - [`sanity blueprints stacks`](#sanity-blueprints-stacks)
 - [`sanity build [OUTPUTDIR]`](#sanity-build-outputdir)
 - [`sanity codemod [CODEMODNAME]`](#sanity-codemod-codemodname)
+- [`sanity context build KNOWLEDGEBASEID`](#sanity-context-build-knowledgebaseid)
+- [`sanity context create`](#sanity-context-create)
+- [`sanity context delete KNOWLEDGEBASEID`](#sanity-context-delete-knowledgebaseid)
+- [`sanity context get KNOWLEDGEBASEID`](#sanity-context-get-knowledgebaseid)
+- [`sanity context imports create KNOWLEDGEBASEID`](#sanity-context-imports-create-knowledgebaseid)
+- [`sanity context imports delete KNOWLEDGEBASEID IMPORTID`](#sanity-context-imports-delete-knowledgebaseid-importid)
+- [`sanity context imports download KNOWLEDGEBASEID IMPORTID`](#sanity-context-imports-download-knowledgebaseid-importid)
+- [`sanity context imports get KNOWLEDGEBASEID IMPORTID`](#sanity-context-imports-get-knowledgebaseid-importid)
+- [`sanity context imports list KNOWLEDGEBASEID`](#sanity-context-imports-list-knowledgebaseid)
+- [`sanity context jobs get KNOWLEDGEBASEID JOBID`](#sanity-context-jobs-get-knowledgebaseid-jobid)
+- [`sanity context list`](#sanity-context-list)
+- [`sanity context refresh KNOWLEDGEBASEID`](#sanity-context-refresh-knowledgebaseid)
+- [`sanity context update KNOWLEDGEBASEID`](#sanity-context-update-knowledgebaseid)
 - [`sanity cors add ORIGIN`](#sanity-cors-add-origin)
 - [`sanity cors delete [ORIGIN]`](#sanity-cors-delete-origin)
 - [`sanity cors list`](#sanity-cors-list)
@@ -950,6 +963,389 @@ EXAMPLES
     $ sanity codemod reactIconsV3 --dry
 ```
 
+## `sanity context build KNOWLEDGEBASEID`
+
+Build a knowledge base from its imported content
+
+```
+USAGE
+  $ sanity context build KNOWLEDGEBASEID [--cancel | --watch]
+
+ARGUMENTS
+  KNOWLEDGEBASEID  Knowledge base ID
+
+FLAGS
+  --cancel  Cancel the running build instead of starting one
+  --watch   Wait for the build to finish, exiting non-zero if it fails
+
+DESCRIPTION
+  Build a knowledge base from its imported content
+
+EXAMPLES
+  Start a build and return the job ID
+
+    $ sanity context build kb-abc123
+
+  Start a build and wait for it to finish (non-zero exit on failure)
+
+    $ sanity context build kb-abc123 --watch
+
+  Cancel the running build, if any
+
+    $ sanity context build kb-abc123 --cancel
+```
+
+## `sanity context create`
+
+Create a knowledge base
+
+```
+USAGE
+  $ sanity context create [--organization <id>] [--description <value>] [--title <value>]
+
+FLAGS
+  --description=<value>  Knowledge base description
+  --title=<value>        Knowledge base title
+
+OVERRIDE FLAGS
+  --organization=<id>  Organization to create the knowledge base in (overrides CLI configuration)
+
+DESCRIPTION
+  Create a knowledge base
+
+EXAMPLES
+  Interactively create a knowledge base
+
+    $ sanity context create
+
+  Create a knowledge base in a specific organization
+
+    $ sanity context create --organization org-abc123 --title "Support docs" --description "Product docs and \
+      troubleshooting guides"
+```
+
+## `sanity context delete KNOWLEDGEBASEID`
+
+Delete a knowledge base and its generated content
+
+```
+USAGE
+  $ sanity context delete KNOWLEDGEBASEID [-y]
+
+ARGUMENTS
+  KNOWLEDGEBASEID  Knowledge base ID
+
+FLAGS
+  -y, --yes  Skip confirmation prompt (unattended mode)
+
+DESCRIPTION
+  Delete a knowledge base and its generated content
+
+EXAMPLES
+  Delete a knowledge base after confirmation
+
+    $ sanity context delete kb-abc123
+
+  Delete a knowledge base without confirmation prompt
+
+    $ sanity context delete kb-abc123 --yes
+```
+
+## `sanity context get KNOWLEDGEBASEID`
+
+Get details of a knowledge base
+
+```
+USAGE
+  $ sanity context get KNOWLEDGEBASEID [--json]
+
+ARGUMENTS
+  KNOWLEDGEBASEID  Knowledge base ID
+
+FLAGS
+  --json  Output the knowledge base in JSON format
+
+DESCRIPTION
+  Get details of a knowledge base
+
+EXAMPLES
+  Get details of a specific knowledge base
+
+    $ sanity context get kb-abc123
+
+  Output the knowledge base as JSON
+
+    $ sanity context get kb-abc123 --json
+```
+
+## `sanity context imports create KNOWLEDGEBASEID`
+
+Import content into a knowledge base
+
+```
+USAGE
+  $ sanity context imports create KNOWLEDGEBASEID [--content-type <mime>] [--file <path> | --text <value> | --url <url> |
+    --query <value>] [--sanity-dataset <name> ] [--sanity-project <id> ] [--title <value> ]
+
+ARGUMENTS
+  KNOWLEDGEBASEID  Knowledge base ID
+
+FLAGS
+  --content-type=<mime>    Content type of the import (--text: text/markdown or text/plain; --file: any MIME type,
+                           inferred from the file extension when omitted)
+  --file=<path>            Path to a local file to import
+  --query=<value>          GROQ query binding a Sanity dataset as a source
+  --sanity-dataset=<name>  Sanity dataset for a dataset import
+  --sanity-project=<id>    Sanity project ID for a dataset import
+  --text=<value>           Inline text content to import (requires --title)
+  --title=<value>          Title for an inline text import
+  --url=<url>              Website URL to crawl
+
+DESCRIPTION
+  Import content into a knowledge base
+
+EXAMPLES
+  Import inline text
+
+    $ sanity context imports create kb-abc123 --text "Refunds are processed within 5 days" --title "Refund policy"
+
+  Upload and import a local file
+
+    $ sanity context imports create kb-abc123 --file ./handbook.pdf
+
+  Crawl a website
+
+    $ sanity context imports create kb-abc123 --url https://example.com/docs
+
+  Bind a Sanity dataset as a source
+
+    $ sanity context imports create kb-abc123 --query '*[_type == "article"]' --sanity-project abc123 \
+      --sanity-dataset production
+```
+
+## `sanity context imports delete KNOWLEDGEBASEID IMPORTID`
+
+Delete an import from a knowledge base
+
+```
+USAGE
+  $ sanity context imports delete KNOWLEDGEBASEID IMPORTID [-y]
+
+ARGUMENTS
+  KNOWLEDGEBASEID  Knowledge base ID
+  IMPORTID         Import ID
+
+FLAGS
+  -y, --yes  Skip confirmation prompt (unattended mode)
+
+DESCRIPTION
+  Delete an import from a knowledge base
+
+EXAMPLES
+  Delete an import after confirmation
+
+    $ sanity context imports delete kb-abc123 import-def456
+
+  Delete an import without confirmation prompt
+
+    $ sanity context imports delete kb-abc123 import-def456 --yes
+```
+
+## `sanity context imports download KNOWLEDGEBASEID IMPORTID`
+
+Get a short-lived signed URL for the original uploaded bytes of a file import
+
+```
+USAGE
+  $ sanity context imports download KNOWLEDGEBASEID IMPORTID [--json]
+
+ARGUMENTS
+  KNOWLEDGEBASEID  Knowledge base ID
+  IMPORTID         Import ID
+
+FLAGS
+  --json  Output the download URL in JSON format
+
+DESCRIPTION
+  Get a short-lived signed URL for the original uploaded bytes of a file import
+
+EXAMPLES
+  Get a download URL for an uploaded file
+
+    $ sanity context imports download kb-abc123 import-def456
+```
+
+## `sanity context imports get KNOWLEDGEBASEID IMPORTID`
+
+Get details of an import
+
+```
+USAGE
+  $ sanity context imports get KNOWLEDGEBASEID IMPORTID [--json]
+
+ARGUMENTS
+  KNOWLEDGEBASEID  Knowledge base ID
+  IMPORTID         Import ID
+
+FLAGS
+  --json  Output the import in JSON format
+
+DESCRIPTION
+  Get details of an import
+
+EXAMPLES
+  Get details of a specific import
+
+    $ sanity context imports get kb-abc123 import-def456
+
+  Output the import as JSON
+
+    $ sanity context imports get kb-abc123 import-def456 --json
+```
+
+## `sanity context imports list KNOWLEDGEBASEID`
+
+List imports for a knowledge base
+
+```
+USAGE
+  $ sanity context imports list KNOWLEDGEBASEID [--json]
+
+ARGUMENTS
+  KNOWLEDGEBASEID  Knowledge base ID
+
+FLAGS
+  --json  Output imports in JSON format
+
+DESCRIPTION
+  List imports for a knowledge base
+
+EXAMPLES
+  List all imports for a knowledge base
+
+    $ sanity context imports list kb-abc123
+
+  Output imports as JSON
+
+    $ sanity context imports list kb-abc123 --json
+```
+
+## `sanity context jobs get KNOWLEDGEBASEID JOBID`
+
+Get the status of a knowledge base job
+
+```
+USAGE
+  $ sanity context jobs get KNOWLEDGEBASEID JOBID [--json] [--watch]
+
+ARGUMENTS
+  KNOWLEDGEBASEID  Knowledge base ID
+  JOBID            Job ID
+
+FLAGS
+  --json   Output the job in JSON format
+  --watch  Poll until the job reaches a terminal state
+
+DESCRIPTION
+  Get the status of a knowledge base job
+
+EXAMPLES
+  Get the current status of a job
+
+    $ sanity context jobs get kb-abc123 job-def456
+
+  Wait for the job to finish (non-zero exit if it does not succeed)
+
+    $ sanity context jobs get kb-abc123 job-def456 --watch
+```
+
+## `sanity context list`
+
+List knowledge bases in an organization
+
+```
+USAGE
+  $ sanity context list [--organization <id>] [--json]
+
+FLAGS
+  --json  Output knowledge bases in JSON format
+
+OVERRIDE FLAGS
+  --organization=<id>  Organization to list knowledge bases for (overrides CLI configuration)
+
+DESCRIPTION
+  List knowledge bases in an organization
+
+EXAMPLES
+  List knowledge bases, selecting the organization interactively
+
+    $ sanity context list
+
+  List knowledge bases in a specific organization
+
+    $ sanity context list --organization org-abc123
+
+  Output knowledge bases as JSON
+
+    $ sanity context list --organization org-abc123 --json
+```
+
+## `sanity context refresh KNOWLEDGEBASEID`
+
+Refresh a knowledge base: re-check sources and apply what changed
+
+```
+USAGE
+  $ sanity context refresh KNOWLEDGEBASEID
+
+ARGUMENTS
+  KNOWLEDGEBASEID  Knowledge base ID
+
+DESCRIPTION
+  Refresh a knowledge base: re-check sources and apply what changed
+
+EXAMPLES
+  Start an incremental refresh
+
+    $ sanity context refresh kb-abc123
+```
+
+## `sanity context update KNOWLEDGEBASEID`
+
+Update a knowledge base
+
+```
+USAGE
+  $ sanity context update KNOWLEDGEBASEID [--description <value>] [--refresh-enabled] [--refresh-frequency
+    weekly|monthly] [--title <value>]
+
+ARGUMENTS
+  KNOWLEDGEBASEID  Knowledge base ID
+
+FLAGS
+  --description=<value>         New knowledge base description
+  --[no-]refresh-enabled        Enable scheduled refresh (--no-refresh-enabled to disable)
+  --refresh-frequency=<option>  How often scheduled refresh runs
+                                <options: weekly|monthly>
+  --title=<value>               New knowledge base title
+
+DESCRIPTION
+  Update a knowledge base
+
+EXAMPLES
+  Rename a knowledge base
+
+    $ sanity context update kb-abc123 --title "New title"
+
+  Enable weekly scheduled refresh
+
+    $ sanity context update kb-abc123 --refresh-enabled --refresh-frequency weekly
+
+  Disable scheduled refresh
+
+    $ sanity context update kb-abc123 --no-refresh-enabled
+```
+
 ## `sanity cors add ORIGIN`
 
 Add a CORS origin to the project

package/dist/actions/api/distillApiRoutes.js

@@ -88,7 +88,7 @@ import { API_VERSION_SEGMENT_RE } from './constants.js';
     const [pathPart = ''] = path.split('?');
     const segments = pathPart.split('/').filter((segment)=>segment !== '');
     let version;
-    if (segments[0] === '{apiVersion}') {
+    if (segments[0] === '{apiVersion}' || segments[0] === '{apiV}') {
         segments.shift();
     } else if (segments.length > 0 && API_VERSION_SEGMENT_RE.test(segments[0])) {
         version = segments.shift();

package/dist/actions/api/distillApiRoutes.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/api/distillApiRoutes.ts"],"sourcesContent":["import {API_VERSION_SEGMENT_RE} from './constants.js'\nimport {type ApiHost, type ApiRouteEntry, type OpenApiDocument} from './types.js'\n\n/**\n * A fetched OpenAPI specification, ready for distillation.\n */\nexport interface SpecSource {\n  document: OpenApiDocument\n  slug: string\n  title: string\n}\n\ninterface ServerBase {\n  host: ApiHost\n  segments: string[]\n\n  defaultApiVersion?: string\n}\n\n/**\n * Distill fetched OpenAPI specifications into the routing manifest used by\n * `sanity api` to decide which host serves a request path and which API\n * version to default to.\n *\n * The output is deterministic (sorted) so the generated manifest can be\n * compared against a fresh distillation to detect drift.\n */\nexport function distillApiRoutes(specs: SpecSource[]): ApiRouteEntry[] {\n  const entries: ApiRouteEntry[] = []\n\n  for (const {document, slug, title} of specs) {\n    const servers = document.servers ?? []\n    const paths = Object.keys(document.paths ?? {})\n    if (servers.length === 0 || paths.length === 0) continue\n\n    // A spec may be served on both hosts (eg the Applications API). Emit one\n    // entry per host, each carrying the full set of path patterns.\n    const byHost = new Map<ApiHost, ServerBase>()\n    for (const server of servers) {\n      const base = parseServerUrl(server.url, server.variables)\n      if (!base) continue\n      if (!byHost.has(base.host)) byHost.set(base.host, base)\n    }\n\n    for (const base of byHost.values()) {\n      const patterns = new Set<string>()\n      let defaultApiVersion = base.defaultApiVersion\n\n      for (const path of paths) {\n        const {segments, version} = normalizePathSegments(path)\n        defaultApiVersion = defaultApiVersion ?? version\n        const pattern = [...base.segments, ...segments].join('/')\n        if (pattern !== '') patterns.add(pattern)\n      }\n\n      if (patterns.size === 0) continue\n\n      entries.push({\n        ...(defaultApiVersion === undefined ? {} : {defaultApiVersion}),\n        host: base.host,\n        pathPatterns: [...patterns].toSorted(),\n        slug,\n        title,\n      })\n    }\n  }\n\n  return entries.toSorted((a, b) => a.slug.localeCompare(b.slug) || a.host.localeCompare(b.host))\n}\n\n/**\n * Parse an OpenAPI server URL template (eg\n * `https://{projectId}.api.sanity.io/{apiVersion}/agent/action`) into a host\n * classification, base path segments and a default API version.\n *\n * Returns `undefined` for URLs that don't look like a Sanity API host.\n */\nfunction parseServerUrl(\n  url: string,\n  variables?: Record<string, {default?: string}>,\n): ServerBase | undefined {\n  const withoutScheme = url.replace(/^https?:\\/\\//, '')\n  const [hostname = '', ...pathSegments] = withoutScheme.split('/')\n\n  if (!hostname.includes('api.sanity.io') && !hostname.includes('api.sanity.work')) {\n    return undefined\n  }\n\n  const host: ApiHost = hostname.includes('{projectId}') ? 'project' : 'global'\n\n  let defaultApiVersion = normalizeVersion(variables?.apiVersion?.default)\n  const segments: string[] = []\n  for (const segment of pathSegments) {\n    if (segment === '') continue\n    if (segment === '{apiVersion}') continue\n    if (API_VERSION_SEGMENT_RE.test(segment)) {\n      defaultApiVersion = defaultApiVersion ?? segment\n      continue\n    }\n    segments.push(segment)\n  }\n\n  return {defaultApiVersion, host, segments}\n}\n\n/**\n * Normalize an OpenAPI path template into version-less path segments, plus the\n * API version if one was embedded in the path (eg `/v2024-07-01/access/...`).\n *\n * Some specs carry a stray query marker in the path key (eg `/foo/{id}?`) -\n * anything from `?` on is not part of the path and is dropped.\n */\nfunction normalizePathSegments(path: string): {segments: string[]; version?: string} {\n  const [pathPart = ''] = path.split('?')\n  const segments = pathPart.split('/').filter((segment) => segment !== '')\n  let version: string | undefined\n\n  if (segments[0] === '{apiVersion}') {\n    segments.shift()\n  } else if (segments.length > 0 && API_VERSION_SEGMENT_RE.test(segments[0])) {\n    version = segments.shift()\n  }\n\n  return {segments, version}\n}\n\nfunction normalizeVersion(version: string | undefined): string | undefined {\n  if (!version) return undefined\n  return API_VERSION_SEGMENT_RE.test(version) ? version : undefined\n}\n"],"names":["API_VERSION_SEGMENT_RE","distillApiRoutes","specs","entries","document","slug","title","servers","paths","Object","keys","length","byHost","Map","server","base","parseServerUrl","url","variables","has","host","set","values","patterns","Set","defaultApiVersion","path","segments","version","normalizePathSegments","pattern","join","add","size","push","undefined","pathPatterns","toSorted","a","b","localeCompare","withoutScheme","replace","hostname","pathSegments","split","includes","normalizeVersion","apiVersion","default","segment","test","pathPart","filter","shift"],"mappings":"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"}
+{"version":3,"sources":["../../../src/actions/api/distillApiRoutes.ts"],"sourcesContent":["import {API_VERSION_SEGMENT_RE} from './constants.js'\nimport {type ApiHost, type ApiRouteEntry, type OpenApiDocument} from './types.js'\n\n/**\n * A fetched OpenAPI specification, ready for distillation.\n */\nexport interface SpecSource {\n  document: OpenApiDocument\n  slug: string\n  title: string\n}\n\ninterface ServerBase {\n  host: ApiHost\n  segments: string[]\n\n  defaultApiVersion?: string\n}\n\n/**\n * Distill fetched OpenAPI specifications into the routing manifest used by\n * `sanity api` to decide which host serves a request path and which API\n * version to default to.\n *\n * The output is deterministic (sorted) so the generated manifest can be\n * compared against a fresh distillation to detect drift.\n */\nexport function distillApiRoutes(specs: SpecSource[]): ApiRouteEntry[] {\n  const entries: ApiRouteEntry[] = []\n\n  for (const {document, slug, title} of specs) {\n    const servers = document.servers ?? []\n    const paths = Object.keys(document.paths ?? {})\n    if (servers.length === 0 || paths.length === 0) continue\n\n    // A spec may be served on both hosts (eg the Applications API). Emit one\n    // entry per host, each carrying the full set of path patterns.\n    const byHost = new Map<ApiHost, ServerBase>()\n    for (const server of servers) {\n      const base = parseServerUrl(server.url, server.variables)\n      if (!base) continue\n      if (!byHost.has(base.host)) byHost.set(base.host, base)\n    }\n\n    for (const base of byHost.values()) {\n      const patterns = new Set<string>()\n      let defaultApiVersion = base.defaultApiVersion\n\n      for (const path of paths) {\n        const {segments, version} = normalizePathSegments(path)\n        defaultApiVersion = defaultApiVersion ?? version\n        const pattern = [...base.segments, ...segments].join('/')\n        if (pattern !== '') patterns.add(pattern)\n      }\n\n      if (patterns.size === 0) continue\n\n      entries.push({\n        ...(defaultApiVersion === undefined ? {} : {defaultApiVersion}),\n        host: base.host,\n        pathPatterns: [...patterns].toSorted(),\n        slug,\n        title,\n      })\n    }\n  }\n\n  return entries.toSorted((a, b) => a.slug.localeCompare(b.slug) || a.host.localeCompare(b.host))\n}\n\n/**\n * Parse an OpenAPI server URL template (eg\n * `https://{projectId}.api.sanity.io/{apiVersion}/agent/action`) into a host\n * classification, base path segments and a default API version.\n *\n * Returns `undefined` for URLs that don't look like a Sanity API host.\n */\nfunction parseServerUrl(\n  url: string,\n  variables?: Record<string, {default?: string}>,\n): ServerBase | undefined {\n  const withoutScheme = url.replace(/^https?:\\/\\//, '')\n  const [hostname = '', ...pathSegments] = withoutScheme.split('/')\n\n  if (!hostname.includes('api.sanity.io') && !hostname.includes('api.sanity.work')) {\n    return undefined\n  }\n\n  const host: ApiHost = hostname.includes('{projectId}') ? 'project' : 'global'\n\n  let defaultApiVersion = normalizeVersion(variables?.apiVersion?.default)\n  const segments: string[] = []\n  for (const segment of pathSegments) {\n    if (segment === '') continue\n    if (segment === '{apiVersion}') continue\n    if (API_VERSION_SEGMENT_RE.test(segment)) {\n      defaultApiVersion = defaultApiVersion ?? segment\n      continue\n    }\n    segments.push(segment)\n  }\n\n  return {defaultApiVersion, host, segments}\n}\n\n/**\n * Normalize an OpenAPI path template into version-less path segments, plus the\n * API version if one was embedded in the path (eg `/v2024-07-01/access/...`).\n *\n * Some specs carry a stray query marker in the path key (eg `/foo/{id}?`) -\n * anything from `?` on is not part of the path and is dropped.\n */\nfunction normalizePathSegments(path: string): {segments: string[]; version?: string} {\n  const [pathPart = ''] = path.split('?')\n  const segments = pathPart.split('/').filter((segment) => segment !== '')\n  let version: string | undefined\n\n  if (segments[0] === '{apiVersion}' || segments[0] === '{apiV}') {\n    segments.shift()\n  } else if (segments.length > 0 && API_VERSION_SEGMENT_RE.test(segments[0])) {\n    version = segments.shift()\n  }\n\n  return {segments, version}\n}\n\nfunction normalizeVersion(version: string | undefined): string | undefined {\n  if (!version) return undefined\n  return API_VERSION_SEGMENT_RE.test(version) ? version : undefined\n}\n"],"names":["API_VERSION_SEGMENT_RE","distillApiRoutes","specs","entries","document","slug","title","servers","paths","Object","keys","length","byHost","Map","server","base","parseServerUrl","url","variables","has","host","set","values","patterns","Set","defaultApiVersion","path","segments","version","normalizePathSegments","pattern","join","add","size","push","undefined","pathPatterns","toSorted","a","b","localeCompare","withoutScheme","replace","hostname","pathSegments","split","includes","normalizeVersion","apiVersion","default","segment","test","pathPart","filter","shift"],"mappings":"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"}

package/dist/actions/api/resolveEndpoint.js

@@ -23,7 +23,7 @@ const ALLOWED_URL_HOST_RE = /(?:^|\.)api\.sanity\.(?:io|work)$/;
     // An API version embedded in the path (eg `v2021-06-07/projects`) is peeled
     // off and re-applied as the version segment of the final URL.
     let embeddedVersion;
-    if (segments[0] === '{apiVersion}') {
+    if (segments[0] === '{apiVersion}' || segments[0] === '{apiV}') {
         segments.shift();
     } else if (segments.length > 0 && API_VERSION_SEGMENT_RE.test(segments[0])) {
         embeddedVersion = segments.shift();

package/dist/actions/api/resolveEndpoint.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/api/resolveEndpoint.ts"],"sourcesContent":["import {parse} from 'node:querystring'\n\nimport {API_DEFAULT_VERSION, API_VERSION_SEGMENT_RE} from './constants.js'\nimport {ApiUsageError, ProjectIdRequiredError} from './errors.js'\nimport {type ApiHost, type ApiRouteEntry} from './types.js'\n\n/**\n * Options for {@link resolveEndpoint}.\n */\nexport interface ResolveEndpointOptions {\n  /** The endpoint argument: a path, optionally with placeholders, or a full URL. */\n  endpoint: string\n\n  /** The generated routing manifest. */\n  routes: ApiRouteEntry[]\n\n  /** Explicit API version (`--api-version`), wins over everything else. */\n  apiVersion?: string\n\n  /** Dataset used to fill `{dataset}` / `{datasetName}` placeholders. */\n  dataset?: string\n\n  /** Force a host family (`--global` / `--project-hosted`), restricting route matching to it. */\n  forceHost?: ApiHost\n\n  /** Project ID used to fill `{projectId}` placeholders and project-hosted requests. */\n  projectId?: string\n}\n\n/**\n * A fully resolved request target.\n */\nexport type ResolvedEndpoint =\n  | {\n      /** API version path segment, eg `v2021-06-07`. */\n      apiVersion: string\n      host: ApiHost\n      kind: 'path'\n      /** Slug of the OpenAPI spec whose paths matched, if any. */\n      matchedSlug?: string\n      /** Version-less path, without leading slash. */\n      path: string\n      /** Project ID; always set when `host` is `project`. */\n      projectId?: string\n      /** Query parameters parsed from the endpoint argument. */\n      query: Record<string, string | string[]>\n    }\n  | {\n      kind: 'url'\n      query: Record<string, string | string[]>\n      /** Absolute URL, used verbatim (query string stripped into `query`). */\n      url: string\n    }\n\nconst PLACEHOLDER_RE = /^\\{([^{}]+)\\}$/\n\nconst ALLOWED_URL_HOST_RE = /(?:^|\\.)api\\.sanity\\.(?:io|work)$/\n\n/**\n * Resolve the endpoint argument of `sanity api` into a concrete request\n * target: substitute placeholders, split off the query string, determine the\n * host family (via the generated OpenAPI routing manifest) and the API\n * version.\n *\n * Throws {@link ProjectIdRequiredError} when the request needs a project ID\n * that hasn't been provided - the command catches this to resolve one (flags,\n * CLI config or interactive prompt) and retries.\n */\nexport function resolveEndpoint(options: ResolveEndpointOptions): ResolvedEndpoint {\n  const {apiVersion, dataset, endpoint, forceHost, projectId, routes} = options\n\n  if (/^https?:\\/\\//.test(endpoint)) {\n    return resolveUrlEndpoint(endpoint)\n  }\n\n  const [pathPart = '', ...queryParts] = endpoint.split('?')\n  const query = parseQueryString(queryParts.join('?'))\n\n  const segments = pathPart.split('/').filter((segment) => segment !== '')\n\n  // An API version embedded in the path (eg `v2021-06-07/projects`) is peeled\n  // off and re-applied as the version segment of the final URL.\n  let embeddedVersion: string | undefined\n  if (segments[0] === '{apiVersion}') {\n    segments.shift()\n  } else if (segments.length > 0 && API_VERSION_SEGMENT_RE.test(segments[0])) {\n    embeddedVersion = segments.shift()\n  }\n\n  // Checked after version peeling so a bare version (eg `v2025-02-19`) is\n  // also rejected as an empty path.\n  if (segments.length === 0) {\n    throw new ApiUsageError('Endpoint path is empty')\n  }\n\n  const unresolved: string[] = []\n  const substituted = segments.map((segment, index) => {\n    const placeholder = PLACEHOLDER_RE.exec(segment)?.[1]\n    if (!placeholder) return segment\n    if (placeholder === 'projectId') {\n      if (!projectId) throw new ProjectIdRequiredError()\n      return projectId\n    }\n    // The projects spec names the dataset placeholder `{name}` (eg\n    // `projects/{projectId}/datasets/{name}`) - only that context is a\n    // dataset; `{name}` elsewhere (eg video renditions) stays unresolved.\n    const isDatasetName = placeholder === 'name' && segments[index - 1] === 'datasets'\n    if (placeholder === 'dataset' || placeholder === 'datasetName' || isDatasetName) {\n      if (!dataset) {\n        throw new ApiUsageError(\n          `Unable to resolve {${placeholder}} - provide a dataset with --dataset or configure one in sanity.cli.ts`,\n        )\n      }\n      return dataset\n    }\n    unresolved.push(segment)\n    return segment\n  })\n\n  if (unresolved.length > 0) {\n    throw new ApiUsageError(\n      `Unable to resolve placeholder(s) ${unresolved.join(', ')} - replace them with actual values`,\n    )\n  }\n\n  // Forcing a host restricts matching to specs served on that host, so the\n  // matched spec's default API version still applies when one exists there.\n  const candidates = forceHost ? routes.filter((entry) => entry.host === forceHost) : routes\n  const match = matchRoutes(substituted, candidates)\n  const host = forceHost ?? match?.host ?? 'global'\n\n  if (host === 'project' && !projectId) {\n    throw new ProjectIdRequiredError()\n  }\n\n  return {\n    apiVersion: apiVersion ?? embeddedVersion ?? match?.defaultApiVersion ?? API_DEFAULT_VERSION,\n    host,\n    kind: 'path',\n    matchedSlug: match?.slug,\n    path: substituted.join('/'),\n    ...(host === 'project' ? {projectId} : {}),\n    query,\n  }\n}\n\nfunction resolveUrlEndpoint(endpoint: string): ResolvedEndpoint {\n  let url: URL\n  try {\n    url = new URL(endpoint)\n  } catch {\n    throw new ApiUsageError(`Invalid URL \"${endpoint}\"`)\n  }\n\n  // Never put the token on the wire unencrypted\n  if (url.protocol !== 'https:') {\n    throw new ApiUsageError(\n      `Refusing to send requests over \"${url.protocol}//\" - only https:// URLs are supported`,\n    )\n  }\n\n  if (!ALLOWED_URL_HOST_RE.test(url.hostname)) {\n    throw new ApiUsageError(\n      `Refusing to send authenticated requests to \"${url.hostname}\" - only *.api.sanity.io hosts are supported`,\n    )\n  }\n\n  const query = parseQueryString(url.search.replace(/^\\?/, ''))\n  url.search = ''\n\n  return {kind: 'url', query, url: url.toString()}\n}\n\ninterface RouteMatch {\n  host: ApiHost\n  score: number\n  slug: string\n\n  defaultApiVersion?: string\n}\n\n/**\n * Find the route entry whose path pattern best matches the request segments.\n *\n * A pattern only matches when the request path consumes it completely, and\n * segments are compared pairwise: literal matches score higher than\n * placeholder matches, and a literal mismatch disqualifies the pattern. On\n * equal scores across hosts the global host wins (APIs served on both hosts\n * don't need a project ID there); on equal scores within the same host the\n * first entry wins, keeping the result independent of later entries.\n */\nfunction matchRoutes(segments: string[], routes: ApiRouteEntry[]): RouteMatch | undefined {\n  let best: RouteMatch | undefined\n\n  for (const entry of routes) {\n    for (const pattern of entry.pathPatterns) {\n      const score = scorePattern(segments, pattern.split('/'))\n      if (score === 0) continue\n      const isBetter =\n        !best ||\n        score > best.score ||\n        (score === best.score && best.host === 'project' && entry.host === 'global')\n      if (isBetter) {\n        best = {\n          defaultApiVersion: entry.defaultApiVersion,\n          host: entry.host,\n          score,\n          slug: entry.slug,\n        }\n      }\n    }\n  }\n\n  return best\n}\n\nfunction scorePattern(segments: string[], patternSegments: string[]): number {\n  // A pattern only matches when the request path consumes it completely - a\n  // request that is a mere prefix of a longer pattern (eg `data` vs\n  // `data/query/{dataset}`) must not inherit that route's host or version.\n  if (patternSegments.length > segments.length) return 0\n\n  let score = 0\n  let literalMatches = 0\n\n  for (const [index, patternSegment] of patternSegments.entries()) {\n    if (PLACEHOLDER_RE.test(patternSegment)) {\n      score += 1\n    } else if (patternSegment === segments[index]) {\n      score += 2\n      literalMatches += 1\n    } else {\n      return 0\n    }\n  }\n\n  // Require at least one literal segment match so a placeholder-only pattern\n  // like `{resourceType}/{resourceId}` can't capture arbitrary paths.\n  return literalMatches === 0 ? 0 : score\n}\n\nfunction parseQueryString(queryString: string): Record<string, string | string[]> {\n  // node:querystring collects repeated keys into arrays and returns a\n  // null-prototype object, so user-supplied keys like `__proto__` stay\n  // ordinary own properties. Parsed values are never `undefined`, hence the\n  // narrowing cast.\n  return parse(queryString) as Record<string, string | string[]>\n}\n"],"names":["parse","API_DEFAULT_VERSION","API_VERSION_SEGMENT_RE","ApiUsageError","ProjectIdRequiredError","PLACEHOLDER_RE","ALLOWED_URL_HOST_RE","resolveEndpoint","options","apiVersion","dataset","endpoint","forceHost","projectId","routes","test","resolveUrlEndpoint","pathPart","queryParts","split","query","parseQueryString","join","segments","filter","segment","embeddedVersion","shift","length","unresolved","substituted","map","index","placeholder","exec","isDatasetName","push","candidates","entry","host","match","matchRoutes","defaultApiVersion","kind","matchedSlug","slug","path","url","URL","protocol","hostname","search","replace","toString","best","pattern","pathPatterns","score","scorePattern","isBetter","patternSegments","literalMatches","patternSegment","entries","queryString"],"mappings":"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"}
+{"version":3,"sources":["../../../src/actions/api/resolveEndpoint.ts"],"sourcesContent":["import {parse} from 'node:querystring'\n\nimport {API_DEFAULT_VERSION, API_VERSION_SEGMENT_RE} from './constants.js'\nimport {ApiUsageError, ProjectIdRequiredError} from './errors.js'\nimport {type ApiHost, type ApiRouteEntry} from './types.js'\n\n/**\n * Options for {@link resolveEndpoint}.\n */\nexport interface ResolveEndpointOptions {\n  /** The endpoint argument: a path, optionally with placeholders, or a full URL. */\n  endpoint: string\n\n  /** The generated routing manifest. */\n  routes: ApiRouteEntry[]\n\n  /** Explicit API version (`--api-version`), wins over everything else. */\n  apiVersion?: string\n\n  /** Dataset used to fill `{dataset}` / `{datasetName}` placeholders. */\n  dataset?: string\n\n  /** Force a host family (`--global` / `--project-hosted`), restricting route matching to it. */\n  forceHost?: ApiHost\n\n  /** Project ID used to fill `{projectId}` placeholders and project-hosted requests. */\n  projectId?: string\n}\n\n/**\n * A fully resolved request target.\n */\nexport type ResolvedEndpoint =\n  | {\n      /** API version path segment, eg `v2021-06-07`. */\n      apiVersion: string\n      host: ApiHost\n      kind: 'path'\n      /** Slug of the OpenAPI spec whose paths matched, if any. */\n      matchedSlug?: string\n      /** Version-less path, without leading slash. */\n      path: string\n      /** Project ID; always set when `host` is `project`. */\n      projectId?: string\n      /** Query parameters parsed from the endpoint argument. */\n      query: Record<string, string | string[]>\n    }\n  | {\n      kind: 'url'\n      query: Record<string, string | string[]>\n      /** Absolute URL, used verbatim (query string stripped into `query`). */\n      url: string\n    }\n\nconst PLACEHOLDER_RE = /^\\{([^{}]+)\\}$/\n\nconst ALLOWED_URL_HOST_RE = /(?:^|\\.)api\\.sanity\\.(?:io|work)$/\n\n/**\n * Resolve the endpoint argument of `sanity api` into a concrete request\n * target: substitute placeholders, split off the query string, determine the\n * host family (via the generated OpenAPI routing manifest) and the API\n * version.\n *\n * Throws {@link ProjectIdRequiredError} when the request needs a project ID\n * that hasn't been provided - the command catches this to resolve one (flags,\n * CLI config or interactive prompt) and retries.\n */\nexport function resolveEndpoint(options: ResolveEndpointOptions): ResolvedEndpoint {\n  const {apiVersion, dataset, endpoint, forceHost, projectId, routes} = options\n\n  if (/^https?:\\/\\//.test(endpoint)) {\n    return resolveUrlEndpoint(endpoint)\n  }\n\n  const [pathPart = '', ...queryParts] = endpoint.split('?')\n  const query = parseQueryString(queryParts.join('?'))\n\n  const segments = pathPart.split('/').filter((segment) => segment !== '')\n\n  // An API version embedded in the path (eg `v2021-06-07/projects`) is peeled\n  // off and re-applied as the version segment of the final URL.\n  let embeddedVersion: string | undefined\n  if (segments[0] === '{apiVersion}' || segments[0] === '{apiV}') {\n    segments.shift()\n  } else if (segments.length > 0 && API_VERSION_SEGMENT_RE.test(segments[0])) {\n    embeddedVersion = segments.shift()\n  }\n\n  // Checked after version peeling so a bare version (eg `v2025-02-19`) is\n  // also rejected as an empty path.\n  if (segments.length === 0) {\n    throw new ApiUsageError('Endpoint path is empty')\n  }\n\n  const unresolved: string[] = []\n  const substituted = segments.map((segment, index) => {\n    const placeholder = PLACEHOLDER_RE.exec(segment)?.[1]\n    if (!placeholder) return segment\n    if (placeholder === 'projectId') {\n      if (!projectId) throw new ProjectIdRequiredError()\n      return projectId\n    }\n    // The projects spec names the dataset placeholder `{name}` (eg\n    // `projects/{projectId}/datasets/{name}`) - only that context is a\n    // dataset; `{name}` elsewhere (eg video renditions) stays unresolved.\n    const isDatasetName = placeholder === 'name' && segments[index - 1] === 'datasets'\n    if (placeholder === 'dataset' || placeholder === 'datasetName' || isDatasetName) {\n      if (!dataset) {\n        throw new ApiUsageError(\n          `Unable to resolve {${placeholder}} - provide a dataset with --dataset or configure one in sanity.cli.ts`,\n        )\n      }\n      return dataset\n    }\n    unresolved.push(segment)\n    return segment\n  })\n\n  if (unresolved.length > 0) {\n    throw new ApiUsageError(\n      `Unable to resolve placeholder(s) ${unresolved.join(', ')} - replace them with actual values`,\n    )\n  }\n\n  // Forcing a host restricts matching to specs served on that host, so the\n  // matched spec's default API version still applies when one exists there.\n  const candidates = forceHost ? routes.filter((entry) => entry.host === forceHost) : routes\n  const match = matchRoutes(substituted, candidates)\n  const host = forceHost ?? match?.host ?? 'global'\n\n  if (host === 'project' && !projectId) {\n    throw new ProjectIdRequiredError()\n  }\n\n  return {\n    apiVersion: apiVersion ?? embeddedVersion ?? match?.defaultApiVersion ?? API_DEFAULT_VERSION,\n    host,\n    kind: 'path',\n    matchedSlug: match?.slug,\n    path: substituted.join('/'),\n    ...(host === 'project' ? {projectId} : {}),\n    query,\n  }\n}\n\nfunction resolveUrlEndpoint(endpoint: string): ResolvedEndpoint {\n  let url: URL\n  try {\n    url = new URL(endpoint)\n  } catch {\n    throw new ApiUsageError(`Invalid URL \"${endpoint}\"`)\n  }\n\n  // Never put the token on the wire unencrypted\n  if (url.protocol !== 'https:') {\n    throw new ApiUsageError(\n      `Refusing to send requests over \"${url.protocol}//\" - only https:// URLs are supported`,\n    )\n  }\n\n  if (!ALLOWED_URL_HOST_RE.test(url.hostname)) {\n    throw new ApiUsageError(\n      `Refusing to send authenticated requests to \"${url.hostname}\" - only *.api.sanity.io hosts are supported`,\n    )\n  }\n\n  const query = parseQueryString(url.search.replace(/^\\?/, ''))\n  url.search = ''\n\n  return {kind: 'url', query, url: url.toString()}\n}\n\ninterface RouteMatch {\n  host: ApiHost\n  score: number\n  slug: string\n\n  defaultApiVersion?: string\n}\n\n/**\n * Find the route entry whose path pattern best matches the request segments.\n *\n * A pattern only matches when the request path consumes it completely, and\n * segments are compared pairwise: literal matches score higher than\n * placeholder matches, and a literal mismatch disqualifies the pattern. On\n * equal scores across hosts the global host wins (APIs served on both hosts\n * don't need a project ID there); on equal scores within the same host the\n * first entry wins, keeping the result independent of later entries.\n */\nfunction matchRoutes(segments: string[], routes: ApiRouteEntry[]): RouteMatch | undefined {\n  let best: RouteMatch | undefined\n\n  for (const entry of routes) {\n    for (const pattern of entry.pathPatterns) {\n      const score = scorePattern(segments, pattern.split('/'))\n      if (score === 0) continue\n      const isBetter =\n        !best ||\n        score > best.score ||\n        (score === best.score && best.host === 'project' && entry.host === 'global')\n      if (isBetter) {\n        best = {\n          defaultApiVersion: entry.defaultApiVersion,\n          host: entry.host,\n          score,\n          slug: entry.slug,\n        }\n      }\n    }\n  }\n\n  return best\n}\n\nfunction scorePattern(segments: string[], patternSegments: string[]): number {\n  // A pattern only matches when the request path consumes it completely - a\n  // request that is a mere prefix of a longer pattern (eg `data` vs\n  // `data/query/{dataset}`) must not inherit that route's host or version.\n  if (patternSegments.length > segments.length) return 0\n\n  let score = 0\n  let literalMatches = 0\n\n  for (const [index, patternSegment] of patternSegments.entries()) {\n    if (PLACEHOLDER_RE.test(patternSegment)) {\n      score += 1\n    } else if (patternSegment === segments[index]) {\n      score += 2\n      literalMatches += 1\n    } else {\n      return 0\n    }\n  }\n\n  // Require at least one literal segment match so a placeholder-only pattern\n  // like `{resourceType}/{resourceId}` can't capture arbitrary paths.\n  return literalMatches === 0 ? 0 : score\n}\n\nfunction parseQueryString(queryString: string): Record<string, string | string[]> {\n  // node:querystring collects repeated keys into arrays and returns a\n  // null-prototype object, so user-supplied keys like `__proto__` stay\n  // ordinary own properties. Parsed values are never `undefined`, hence the\n  // narrowing cast.\n  return parse(queryString) as Record<string, string | string[]>\n}\n"],"names":["parse","API_DEFAULT_VERSION","API_VERSION_SEGMENT_RE","ApiUsageError","ProjectIdRequiredError","PLACEHOLDER_RE","ALLOWED_URL_HOST_RE","resolveEndpoint","options","apiVersion","dataset","endpoint","forceHost","projectId","routes","test","resolveUrlEndpoint","pathPart","queryParts","split","query","parseQueryString","join","segments","filter","segment","embeddedVersion","shift","length","unresolved","substituted","map","index","placeholder","exec","isDatasetName","push","candidates","entry","host","match","matchRoutes","defaultApiVersion","kind","matchedSlug","slug","path","url","URL","protocol","hostname","search","replace","toString","best","pattern","pathPatterns","score","scorePattern","isBetter","patternSegments","literalMatches","patternSegment","entries","queryString"],"mappings":"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"}

package/dist/actions/backup/archiveDir.js

@@ -1,6 +1,6 @@
 import { createWriteStream } from 'node:fs';
 import { createGzip } from 'node:zlib';
-import { pack } from 'tar-fs';
+import { c as createTar } from 'tar';
 import { backupDownloadDebug } from './backupDownloadDebug.js';
 /**
  * Creates a compressed tarball of the given directory and writes it to the specified file path
@@ -25,9 +25,13 @@ import { backupDownloadDebug } from './backupDownloadDebug.js';
             backupDownloadDebug('Gzip stream error: %s', err.message);
             reject(err);
         });
-        const tarStream = pack(tmpOutDir);
+        const tarStream = createTar({
+            cwd: tmpOutDir
+        }, [
+            '.'
+        ]);
         tarStream.on('error', (err)=>{
-            backupDownloadDebug('Tar stream error: %s', err.message);
+            backupDownloadDebug('Tar stream error: %s', err instanceof Error ? err.message : String(err));
             reject(err);
         });
         // Track progress by listening to data events

package/dist/actions/backup/archiveDir.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/backup/archiveDir.ts"],"sourcesContent":["import {createWriteStream} from 'node:fs'\nimport {createGzip} from 'node:zlib'\n\nimport {pack} from 'tar-fs'\n\nimport {backupDownloadDebug} from './backupDownloadDebug.js'\n\n// ProgressCb is a callback that is called with the number of bytes processed so far.\ntype ProgressCb = (processedBytes: number) => void\n\n/**\n * Creates a compressed tarball of the given directory and writes it to the specified file path\n *\n * @param tmpOutDir - The directory to archive\n * @param outFilePath - The output file path for the compressed tarball\n * @param progressCb - Callback function called with the number of bytes processed\n */\nexport function archiveDir(\n  tmpOutDir: string,\n  outFilePath: string,\n  progressCb: ProgressCb,\n): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const archiveDestination = createWriteStream(outFilePath)\n    const gzipStream = createGzip()\n    let processedBytes = 0\n\n    archiveDestination.on('error', (err: Error) => {\n      backupDownloadDebug('Archive destination error: %s', err.message)\n      reject(err)\n    })\n\n    archiveDestination.on('close', () => {\n      backupDownloadDebug('Archive completed successfully')\n      resolve()\n    })\n\n    gzipStream.on('error', (err: Error) => {\n      backupDownloadDebug('Gzip stream error: %s', err.message)\n      reject(err)\n    })\n\n    const tarStream = pack(tmpOutDir)\n\n    tarStream.on('error', (err: Error) => {\n      backupDownloadDebug('Tar stream error: %s', err.message)\n      reject(err)\n    })\n\n    // Track progress by listening to data events\n    tarStream.on('data', (chunk: Buffer) => {\n      processedBytes += chunk.length\n      progressCb(processedBytes)\n    })\n\n    // Pipe tar -> gzip -> file\n    tarStream.pipe(gzipStream).pipe(archiveDestination)\n  })\n}\n"],"names":["createWriteStream","createGzip","pack","backupDownloadDebug","archiveDir","tmpOutDir","outFilePath","progressCb","Promise","resolve","reject","archiveDestination","gzipStream","processedBytes","on","err","message","tarStream","chunk","length","pipe"],"mappings":"AAAA,SAAQA,iBAAiB,QAAO,UAAS;AACzC,SAAQC,UAAU,QAAO,YAAW;AAEpC,SAAQC,IAAI,QAAO,SAAQ;AAE3B,SAAQC,mBAAmB,QAAO,2BAA0B;AAK5D;;;;;;CAMC,GACD,OAAO,SAASC,WACdC,SAAiB,EACjBC,WAAmB,EACnBC,UAAsB;IAEtB,OAAO,IAAIC,QAAQ,CAACC,SAASC;QAC3B,MAAMC,qBAAqBX,kBAAkBM;QAC7C,MAAMM,aAAaX;QACnB,IAAIY,iBAAiB;QAErBF,mBAAmBG,EAAE,CAAC,SAAS,CAACC;YAC9BZ,oBAAoB,iCAAiCY,IAAIC,OAAO;YAChEN,OAAOK;QACT;QAEAJ,mBAAmBG,EAAE,CAAC,SAAS;YAC7BX,oBAAoB;YACpBM;QACF;QAEAG,WAAWE,EAAE,CAAC,SAAS,CAACC;YACtBZ,oBAAoB,yBAAyBY,IAAIC,OAAO;YACxDN,OAAOK;QACT;QAEA,MAAME,YAAYf,KAAKG;QAEvBY,UAAUH,EAAE,CAAC,SAAS,CAACC;YACrBZ,oBAAoB,wBAAwBY,IAAIC,OAAO;YACvDN,OAAOK;QACT;QAEA,6CAA6C;QAC7CE,UAAUH,EAAE,CAAC,QAAQ,CAACI;YACpBL,kBAAkBK,MAAMC,MAAM;YAC9BZ,WAAWM;QACb;QAEA,2BAA2B;QAC3BI,UAAUG,IAAI,CAACR,YAAYQ,IAAI,CAACT;IAClC;AACF"}
+{"version":3,"sources":["../../../src/actions/backup/archiveDir.ts"],"sourcesContent":["import {createWriteStream} from 'node:fs'\nimport {createGzip} from 'node:zlib'\n\nimport {c as createTar} from 'tar'\n\nimport {backupDownloadDebug} from './backupDownloadDebug.js'\n\n// ProgressCb is a callback that is called with the number of bytes processed so far.\ntype ProgressCb = (processedBytes: number) => void\n\n/**\n * Creates a compressed tarball of the given directory and writes it to the specified file path\n *\n * @param tmpOutDir - The directory to archive\n * @param outFilePath - The output file path for the compressed tarball\n * @param progressCb - Callback function called with the number of bytes processed\n */\nexport function archiveDir(\n  tmpOutDir: string,\n  outFilePath: string,\n  progressCb: ProgressCb,\n): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const archiveDestination = createWriteStream(outFilePath)\n    const gzipStream = createGzip()\n    let processedBytes = 0\n\n    archiveDestination.on('error', (err: Error) => {\n      backupDownloadDebug('Archive destination error: %s', err.message)\n      reject(err)\n    })\n\n    archiveDestination.on('close', () => {\n      backupDownloadDebug('Archive completed successfully')\n      resolve()\n    })\n\n    gzipStream.on('error', (err: Error) => {\n      backupDownloadDebug('Gzip stream error: %s', err.message)\n      reject(err)\n    })\n\n    const tarStream = createTar({cwd: tmpOutDir}, ['.'])\n\n    tarStream.on('error', (err) => {\n      backupDownloadDebug('Tar stream error: %s', err instanceof Error ? err.message : String(err))\n      reject(err)\n    })\n\n    // Track progress by listening to data events\n    tarStream.on('data', (chunk: Buffer) => {\n      processedBytes += chunk.length\n      progressCb(processedBytes)\n    })\n\n    // Pipe tar -> gzip -> file\n    tarStream.pipe(gzipStream).pipe(archiveDestination)\n  })\n}\n"],"names":["createWriteStream","createGzip","c","createTar","backupDownloadDebug","archiveDir","tmpOutDir","outFilePath","progressCb","Promise","resolve","reject","archiveDestination","gzipStream","processedBytes","on","err","message","tarStream","cwd","Error","String","chunk","length","pipe"],"mappings":"AAAA,SAAQA,iBAAiB,QAAO,UAAS;AACzC,SAAQC,UAAU,QAAO,YAAW;AAEpC,SAAQC,KAAKC,SAAS,QAAO,MAAK;AAElC,SAAQC,mBAAmB,QAAO,2BAA0B;AAK5D;;;;;;CAMC,GACD,OAAO,SAASC,WACdC,SAAiB,EACjBC,WAAmB,EACnBC,UAAsB;IAEtB,OAAO,IAAIC,QAAQ,CAACC,SAASC;QAC3B,MAAMC,qBAAqBZ,kBAAkBO;QAC7C,MAAMM,aAAaZ;QACnB,IAAIa,iBAAiB;QAErBF,mBAAmBG,EAAE,CAAC,SAAS,CAACC;YAC9BZ,oBAAoB,iCAAiCY,IAAIC,OAAO;YAChEN,OAAOK;QACT;QAEAJ,mBAAmBG,EAAE,CAAC,SAAS;YAC7BX,oBAAoB;YACpBM;QACF;QAEAG,WAAWE,EAAE,CAAC,SAAS,CAACC;YACtBZ,oBAAoB,yBAAyBY,IAAIC,OAAO;YACxDN,OAAOK;QACT;QAEA,MAAME,YAAYf,UAAU;YAACgB,KAAKb;QAAS,GAAG;YAAC;SAAI;QAEnDY,UAAUH,EAAE,CAAC,SAAS,CAACC;YACrBZ,oBAAoB,wBAAwBY,eAAeI,QAAQJ,IAAIC,OAAO,GAAGI,OAAOL;YACxFL,OAAOK;QACT;QAEA,6CAA6C;QAC7CE,UAAUH,EAAE,CAAC,QAAQ,CAACO;YACpBR,kBAAkBQ,MAAMC,MAAM;YAC9Bf,WAAWM;QACb;QAEA,2BAA2B;QAC3BI,UAAUM,IAAI,CAACX,YAAYW,IAAI,CAACZ;IAClC;AACF"}

package/dist/actions/context/resolveOrganizationId.js

@@ -0,0 +1,17 @@
+import { promptForOrganization } from '../../prompts/promptForOrganization.js';
+/** The organization could not be determined and prompting is not possible. */ export class MissingOrganizationError extends Error {
+}
+/**
+ * Resolve the organization to operate on: the `--organization` flag wins,
+ * then the CLI config's `app.organizationId`, then an interactive prompt.
+ */ export async function resolveOrganizationId(options) {
+    const { configuredOrganizationId, flagOrganizationId, unattended } = options;
+    if (flagOrganizationId) return flagOrganizationId;
+    if (configuredOrganizationId) return configuredOrganizationId;
+    if (unattended) {
+        throw new MissingOrganizationError('Organization ID is required. Provide it with the --organization flag.');
+    }
+    return promptForOrganization();
+}
+
+//# sourceMappingURL=resolveOrganizationId.js.map

package/dist/actions/context/resolveOrganizationId.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/actions/context/resolveOrganizationId.ts"],"sourcesContent":["import {promptForOrganization} from '../../prompts/promptForOrganization.js'\n\n/** The organization could not be determined and prompting is not possible. */\nexport class MissingOrganizationError extends Error {}\n\n/**\n * Resolve the organization to operate on: the `--organization` flag wins,\n * then the CLI config's `app.organizationId`, then an interactive prompt.\n */\nexport async function resolveOrganizationId(options: {\n  configuredOrganizationId: string | undefined\n  flagOrganizationId: string | undefined\n  unattended: boolean\n}): Promise<string> {\n  const {configuredOrganizationId, flagOrganizationId, unattended} = options\n\n  if (flagOrganizationId) return flagOrganizationId\n  if (configuredOrganizationId) return configuredOrganizationId\n\n  if (unattended) {\n    throw new MissingOrganizationError(\n      'Organization ID is required. Provide it with the --organization flag.',\n    )\n  }\n\n  return promptForOrganization()\n}\n"],"names":["promptForOrganization","MissingOrganizationError","Error","resolveOrganizationId","options","configuredOrganizationId","flagOrganizationId","unattended"],"mappings":"AAAA,SAAQA,qBAAqB,QAAO,yCAAwC;AAE5E,4EAA4E,GAC5E,OAAO,MAAMC,iCAAiCC;AAAO;AAErD;;;CAGC,GACD,OAAO,eAAeC,sBAAsBC,OAI3C;IACC,MAAM,EAACC,wBAAwB,EAAEC,kBAAkB,EAAEC,UAAU,EAAC,GAAGH;IAEnE,IAAIE,oBAAoB,OAAOA;IAC/B,IAAID,0BAA0B,OAAOA;IAErC,IAAIE,YAAY;QACd,MAAM,IAAIN,yBACR;IAEJ;IAEA,OAAOD;AACT"}

package/dist/actions/context/waitForJob.js

@@ -0,0 +1,24 @@
+import { setTimeout as sleep } from 'node:timers/promises';
+import { getJob } from '../../services/context.js';
+const JOB_POLL_INTERVAL_MS = 5000;
+const TERMINAL_JOB_STATUSES = new Set([
+    'cancelled',
+    'failed',
+    'succeeded'
+]);
+/**
+ * Poll a knowledge base job until it reaches a terminal state
+ * (succeeded, failed or cancelled), resolving with the final job.
+ */ export async function waitForJob(knowledgeBaseId, jobId, options) {
+    const pollIntervalMs = options?.pollIntervalMs ?? JOB_POLL_INTERVAL_MS;
+    while(true){
+        const job = await getJob(knowledgeBaseId, jobId);
+        if (TERMINAL_JOB_STATUSES.has(job.status)) {
+            return job;
+        }
+        options?.onPoll?.(job);
+        await sleep(pollIntervalMs);
+    }
+}
+
+//# sourceMappingURL=waitForJob.js.map

package/dist/actions/context/waitForJob.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/actions/context/waitForJob.ts"],"sourcesContent":["import {setTimeout as sleep} from 'node:timers/promises'\n\nimport {type Context} from '@sanity/client'\n\nimport {getJob} from '../../services/context.js'\n\nconst JOB_POLL_INTERVAL_MS = 5000\n\nconst TERMINAL_JOB_STATUSES: ReadonlySet<Context.Job['status']> = new Set([\n  'cancelled',\n  'failed',\n  'succeeded',\n])\n\n/**\n * Poll a knowledge base job until it reaches a terminal state\n * (succeeded, failed or cancelled), resolving with the final job.\n */\nexport async function waitForJob(\n  knowledgeBaseId: string,\n  jobId: string,\n  options?: {\n    onPoll?: (job: Context.Job) => void\n    pollIntervalMs?: number\n  },\n): Promise<Context.Job> {\n  const pollIntervalMs = options?.pollIntervalMs ?? JOB_POLL_INTERVAL_MS\n\n  while (true) {\n    const job = await getJob(knowledgeBaseId, jobId)\n    if (TERMINAL_JOB_STATUSES.has(job.status)) {\n      return job\n    }\n    options?.onPoll?.(job)\n    await sleep(pollIntervalMs)\n  }\n}\n"],"names":["setTimeout","sleep","getJob","JOB_POLL_INTERVAL_MS","TERMINAL_JOB_STATUSES","Set","waitForJob","knowledgeBaseId","jobId","options","pollIntervalMs","job","has","status","onPoll"],"mappings":"AAAA,SAAQA,cAAcC,KAAK,QAAO,uBAAsB;AAIxD,SAAQC,MAAM,QAAO,4BAA2B;AAEhD,MAAMC,uBAAuB;AAE7B,MAAMC,wBAA4D,IAAIC,IAAI;IACxE;IACA;IACA;CACD;AAED;;;CAGC,GACD,OAAO,eAAeC,WACpBC,eAAuB,EACvBC,KAAa,EACbC,OAGC;IAED,MAAMC,iBAAiBD,SAASC,kBAAkBP;IAElD,MAAO,KAAM;QACX,MAAMQ,MAAM,MAAMT,OAAOK,iBAAiBC;QAC1C,IAAIJ,sBAAsBQ,GAAG,CAACD,IAAIE,MAAM,GAAG;YACzC,OAAOF;QACT;QACAF,SAASK,SAASH;QAClB,MAAMV,MAAMS;IACd;AACF"}

package/dist/actions/context/watchJob.js

@@ -0,0 +1,32 @@
+import { spinner } from '@sanity/cli-core/ux';
+import { waitForJob } from './waitForJob.js';
+/**
+ * Watch a knowledge base job with a spinner until it reaches a terminal
+ * state, updating the spinner text with the job status on each poll.
+ *
+ * Fails the spinner and rethrows on polling errors, and fails it when the
+ * terminal status is not `succeeded` — turning either outcome into a
+ * command error (and exit code) is the caller's responsibility.
+ */ export async function watchJob(knowledgeBaseId, jobId, options) {
+    const { label, successText } = options;
+    const spin = spinner(label).start();
+    let job;
+    try {
+        job = await waitForJob(knowledgeBaseId, jobId, {
+            onPoll: (pending)=>{
+                spin.text = `${label} (${pending.status})`;
+            }
+        });
+    } catch (error) {
+        spin.fail();
+        throw error;
+    }
+    if (job.status === 'succeeded') {
+        spin.succeed(successText);
+    } else {
+        spin.fail();
+    }
+    return job;
+}
+
+//# sourceMappingURL=watchJob.js.map