@sanity/cli 8.6.0 → 8.8.0

package/dist/commands/context/get.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/commands/context/get.ts"],"sourcesContent":["import {Args, Flags} from '@oclif/core'\nimport {type FlagInput} from '@oclif/core/interfaces'\nimport {exitCodes, SanityCommand, subdebug} from '@sanity/cli-core'\nimport {getErrorMessage} from '@sanity/cli-core/errors'\nimport {isHttpError} from '@sanity/client'\n\nimport {formatKeyValue} from '../../actions/debug/output.js'\nimport {getKnowledgeBase} from '../../services/context.js'\n\nconst getContextDebug = subdebug('context:get')\n\nexport class GetKnowledgeBaseCommand extends SanityCommand<typeof GetKnowledgeBaseCommand> {\n  static override args = {\n    knowledgeBaseId: Args.string({\n      description: 'Knowledge base ID',\n      required: true,\n    }),\n  }\n\n  static override description = 'Get details of a knowledge base'\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123',\n      description: 'Get details of a specific knowledge base',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123 --json',\n      description: 'Output the knowledge base as JSON',\n    },\n  ]\n\n  static override flags = {\n    json: Flags.boolean({\n      default: false,\n      description: 'Output the knowledge base in JSON format',\n    }),\n  } satisfies FlagInput\n\n  public async run(): Promise<void> {\n    const {knowledgeBaseId} = this.args\n    const {json} = this.flags\n\n    let knowledgeBase\n    try {\n      knowledgeBase = await getKnowledgeBase(knowledgeBaseId)\n    } catch (error) {\n      getContextDebug('Error getting knowledge base', error)\n      if (isHttpError(error) && error.statusCode === 404) {\n        this.error(`Knowledge base \"${knowledgeBaseId}\" not found`, {\n          exit: exitCodes.RUNTIME_ERROR,\n        })\n      }\n      this.error(`Failed to get knowledge base: ${getErrorMessage(error)}`, {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n\n    if (json) {\n      this.log(JSON.stringify(knowledgeBase, null, 2))\n      return\n    }\n\n    const pending = knowledgeBase.pendingChanges\n    const padTo = 15 // \"Pending changes\" is the longest key\n    this.log(formatKeyValue('ID', knowledgeBase.publicId, {padTo}))\n    this.log(formatKeyValue('Title', knowledgeBase.title, {padTo}))\n    this.log(formatKeyValue('Description', knowledgeBase.description, {padTo}))\n    this.log(formatKeyValue('Organization', knowledgeBase.organizationId, {padTo}))\n    this.log(formatKeyValue('State', knowledgeBase.state, {padTo}))\n    this.log(formatKeyValue('Active job', knowledgeBase.activeJobId ?? '-', {padTo}))\n    this.log(\n      formatKeyValue(\n        'Pending changes',\n        pending\n          ? `${pending.added} added, ${pending.changed} changed, ${pending.removed} removed`\n          : '-',\n        {padTo},\n      ),\n    )\n    this.log(\n      formatKeyValue(\n        'Refresh',\n        knowledgeBase.refreshEnabled ? `enabled (${knowledgeBase.refreshFrequency})` : 'disabled',\n        {padTo},\n      ),\n    )\n    this.log(formatKeyValue('Open issues', knowledgeBase.openIssueCount, {padTo}))\n    this.log(formatKeyValue('Instructions', knowledgeBase.instructionCount, {padTo}))\n    this.log(formatKeyValue('Created', knowledgeBase.createdAt, {padTo}))\n    this.log(formatKeyValue('Updated', knowledgeBase.updatedAt, {padTo}))\n  }\n}\n"],"names":["Args","Flags","exitCodes","SanityCommand","subdebug","getErrorMessage","isHttpError","formatKeyValue","getKnowledgeBase","getContextDebug","GetKnowledgeBaseCommand","args","knowledgeBaseId","string","description","required","examples","command","flags","json","boolean","default","run","knowledgeBase","error","statusCode","exit","RUNTIME_ERROR","log","JSON","stringify","pending","pendingChanges","padTo","publicId","title","organizationId","state","activeJobId","added","changed","removed","refreshEnabled","refreshFrequency","openIssueCount","instructionCount","createdAt","updatedAt"],"mappings":"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"}

package/dist/commands/context/imports/create.js

@@ -0,0 +1,270 @@
+import { readFile } from 'node:fs/promises';
+import { basename, extname } from 'node:path';
+import { Args, Flags } from '@oclif/core';
+import { exitCodes, SanityCommand, subdebug } from '@sanity/cli-core';
+import { getErrorMessage } from '@sanity/cli-core/errors';
+import { spinner } from '@sanity/cli-core/ux';
+import { isHttpError } from '@sanity/client';
+import { formatKeyValue } from '../../../actions/debug/output.js';
+import { createImport } from '../../../services/context.js';
+import { defineCommandTelemetry } from '../../../util/telemetry/commandTelemetry.js';
+const createImportDebug = subdebug('context:imports:create');
+const TEXT_CONTENT_TYPES = [
+    'text/markdown',
+    'text/plain'
+];
+function isTextContentType(value) {
+    const textContentTypes = TEXT_CONTENT_TYPES;
+    return textContentTypes.includes(value);
+}
+const FILE_CONTENT_TYPES = {
+    '.csv': 'text/csv',
+    '.docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+    '.htm': 'text/html',
+    '.html': 'text/html',
+    '.json': 'application/json',
+    '.markdown': 'text/markdown',
+    '.md': 'text/markdown',
+    '.pdf': 'application/pdf',
+    '.txt': 'text/plain'
+};
+const flags = {
+    'content-type': Flags.string({
+        description: 'Content type of the import (--text: text/markdown or text/plain; --file: any MIME type, inferred from the file extension when omitted)',
+        helpValue: '<mime>',
+        parse: async (input)=>{
+            const trimmed = input.trim();
+            if (trimmed === '') {
+                throw new Error('`--content-type` cannot be empty if provided');
+            }
+            return trimmed;
+        },
+        required: false
+    }),
+    file: Flags.string({
+        description: 'Path to a local file to import',
+        exclusive: [
+            'text',
+            'url',
+            'query'
+        ],
+        helpValue: '<path>',
+        required: false
+    }),
+    query: Flags.string({
+        description: 'GROQ query binding a Sanity dataset as a source',
+        exclusive: [
+            'text',
+            'url',
+            'file'
+        ],
+        required: false
+    }),
+    'sanity-dataset': Flags.string({
+        dependsOn: [
+            'query'
+        ],
+        description: 'Sanity dataset for a dataset import',
+        helpValue: '<name>',
+        required: false
+    }),
+    'sanity-project': Flags.string({
+        dependsOn: [
+            'query'
+        ],
+        description: 'Sanity project ID for a dataset import',
+        helpValue: '<id>',
+        required: false
+    }),
+    text: Flags.string({
+        description: 'Inline text content to import (requires --title)',
+        exclusive: [
+            'file',
+            'url',
+            'query'
+        ],
+        required: false
+    }),
+    title: Flags.string({
+        dependsOn: [
+            'text'
+        ],
+        description: 'Title for an inline text import',
+        required: false
+    }),
+    url: Flags.string({
+        description: 'Website URL to crawl',
+        exclusive: [
+            'text',
+            'file',
+            'query'
+        ],
+        helpValue: '<url>',
+        required: false
+    })
+};
+export class CreateImportCommand extends SanityCommand {
+    static args = {
+        knowledgeBaseId: Args.string({
+            description: 'Knowledge base ID',
+            required: true
+        })
+    };
+    static description = 'Import content into a knowledge base';
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %> kb-abc123 --text "Refunds are processed within 5 days" --title "Refund policy"',
+            description: 'Import inline text'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> kb-abc123 --file ./handbook.pdf',
+            description: 'Upload and import a local file'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> kb-abc123 --url https://example.com/docs',
+            description: 'Crawl a website'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> kb-abc123 --query \'*[_type == "article"]\' --sanity-project abc123 --sanity-dataset production',
+            description: 'Bind a Sanity dataset as a source'
+        }
+    ];
+    static flags = flags;
+    static telemetry = defineCommandTelemetry(flags, {
+        redact: [
+            'text',
+            'file',
+            'url',
+            'title',
+            'query'
+        ]
+    });
+    async run() {
+        const { knowledgeBaseId } = this.args;
+        const params = await this.buildImportParams();
+        const spin = spinner('Creating import').start();
+        try {
+            const { jobId } = await createImport(knowledgeBaseId, params);
+            spin.succeed('Import created');
+            this.log(formatKeyValue('Job ID', jobId));
+            this.log(`Track it with: sanity context jobs get ${knowledgeBaseId} ${jobId}`);
+        } catch (error) {
+            spin.fail();
+            createImportDebug('Error creating import', error);
+            if (isHttpError(error) && error.statusCode === 404) {
+                this.error(`Knowledge base "${knowledgeBaseId}" not found`, {
+                    exit: exitCodes.RUNTIME_ERROR
+                });
+            }
+            this.error(`Failed to create import: ${getErrorMessage(error)}`, {
+                exit: exitCodes.RUNTIME_ERROR
+            });
+        }
+    }
+    async buildFileImportParams(filePath) {
+        const { 'content-type': contentType } = this.flags;
+        let fileContent;
+        try {
+            fileContent = await readFile(filePath);
+        } catch (error) {
+            createImportDebug('Error reading import file', error);
+            this.error(`Failed to read file "${filePath}": ${getErrorMessage(error)}`, {
+                exit: exitCodes.RUNTIME_ERROR
+            });
+        }
+        // The Context API signs the upload URL for a content-type header, so one
+        // must always be sent or the upload fails (API quirk found in live testing).
+        const inferredContentType = FILE_CONTENT_TYPES[extname(filePath).toLowerCase()] ?? 'application/octet-stream';
+        return {
+            contentType: contentType ?? inferredContentType,
+            file: fileContent,
+            filename: basename(filePath),
+            type: 'file'
+        };
+    }
+    async buildImportParams() {
+        const { 'content-type': contentType, file, query, 'sanity-dataset': sanityDataset, 'sanity-project': sanityProject, text, url } = this.flags;
+        const sources = [
+            [
+                '--text',
+                text
+            ],
+            [
+                '--file',
+                file
+            ],
+            [
+                '--url',
+                url
+            ],
+            [
+                '--query',
+                query
+            ]
+        ];
+        const provided = sources.filter(([, value])=>value !== undefined);
+        if (provided.length !== 1) {
+            this.error('Provide exactly one of --text, --file, --url or --query.', {
+                exit: exitCodes.USAGE_ERROR
+            });
+        }
+        const [sourceFlag, sourceValue] = provided[0];
+        if (!sourceValue?.trim()) {
+            this.error(`${sourceFlag} cannot be empty`, {
+                exit: exitCodes.USAGE_ERROR
+            });
+        }
+        if (sourceFlag === '--text') {
+            return this.buildTextImportParams(sourceValue);
+        }
+        if (sourceFlag === '--file') {
+            return this.buildFileImportParams(sourceValue);
+        }
+        if (contentType !== undefined) {
+            this.error('The --content-type flag only applies to --text and --file imports.', {
+                exit: exitCodes.USAGE_ERROR
+            });
+        }
+        if (sourceFlag === '--url') {
+            return {
+                type: 'crawl',
+                url: sourceValue
+            };
+        }
+        // Only --query remains; the checks above narrow `sourceFlag` to '--query'.
+        if (!sanityProject || !sanityDataset) {
+            this.error('Dataset imports require --sanity-project and --sanity-dataset alongside --query.', {
+                exit: exitCodes.USAGE_ERROR
+            });
+        }
+        return {
+            query: sourceValue,
+            sanityDatasetId: sanityDataset,
+            sanityProjectId: sanityProject,
+            type: 'dataset'
+        };
+    }
+    buildTextImportParams(text) {
+        const { 'content-type': contentType, title } = this.flags;
+        if (!title?.trim()) {
+            this.error('Title is required for text imports. Provide it with the --title flag.', {
+                exit: exitCodes.USAGE_ERROR
+            });
+        }
+        if (contentType !== undefined && !isTextContentType(contentType)) {
+            this.error(`Text imports support content types ${TEXT_CONTENT_TYPES.join(' and ')}, got "${contentType}".`, {
+                exit: exitCodes.USAGE_ERROR
+            });
+        }
+        return {
+            content: text,
+            title: title.trim(),
+            type: 'text',
+            ...contentType === undefined ? {} : {
+                contentType
+            }
+        };
+    }
+}
+
+//# sourceMappingURL=create.js.map

package/dist/commands/context/imports/create.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/commands/context/imports/create.ts"],"sourcesContent":["import {readFile} from 'node:fs/promises'\nimport {basename, extname} from 'node:path'\n\nimport {Args, Flags} from '@oclif/core'\nimport {type FlagInput} from '@oclif/core/interfaces'\nimport {exitCodes, SanityCommand, subdebug} from '@sanity/cli-core'\nimport {getErrorMessage} from '@sanity/cli-core/errors'\nimport {spinner} from '@sanity/cli-core/ux'\nimport {type Context, isHttpError} from '@sanity/client'\n\nimport {formatKeyValue} from '../../../actions/debug/output.js'\nimport {createImport} from '../../../services/context.js'\nimport {defineCommandTelemetry} from '../../../util/telemetry/commandTelemetry.js'\n\nconst createImportDebug = subdebug('context:imports:create')\n\nconst TEXT_CONTENT_TYPES = ['text/markdown', 'text/plain'] as const\n\nfunction isTextContentType(value: string): value is (typeof TEXT_CONTENT_TYPES)[number] {\n  const textContentTypes: readonly string[] = TEXT_CONTENT_TYPES\n  return textContentTypes.includes(value)\n}\n\nconst FILE_CONTENT_TYPES: Record<string, string> = {\n  '.csv': 'text/csv',\n  '.docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',\n  '.htm': 'text/html',\n  '.html': 'text/html',\n  '.json': 'application/json',\n  '.markdown': 'text/markdown',\n  '.md': 'text/markdown',\n  '.pdf': 'application/pdf',\n  '.txt': 'text/plain',\n}\n\nconst flags = {\n  'content-type': Flags.string({\n    description:\n      'Content type of the import (--text: text/markdown or text/plain; --file: any MIME type, inferred from the file extension when omitted)',\n    helpValue: '<mime>',\n    parse: async (input: string) => {\n      const trimmed = input.trim()\n      if (trimmed === '') {\n        throw new Error('`--content-type` cannot be empty if provided')\n      }\n      return trimmed\n    },\n    required: false,\n  }),\n  file: Flags.string({\n    description: 'Path to a local file to import',\n    exclusive: ['text', 'url', 'query'],\n    helpValue: '<path>',\n    required: false,\n  }),\n  query: Flags.string({\n    description: 'GROQ query binding a Sanity dataset as a source',\n    exclusive: ['text', 'url', 'file'],\n    required: false,\n  }),\n  'sanity-dataset': Flags.string({\n    dependsOn: ['query'],\n    description: 'Sanity dataset for a dataset import',\n    helpValue: '<name>',\n    required: false,\n  }),\n  'sanity-project': Flags.string({\n    dependsOn: ['query'],\n    description: 'Sanity project ID for a dataset import',\n    helpValue: '<id>',\n    required: false,\n  }),\n  text: Flags.string({\n    description: 'Inline text content to import (requires --title)',\n    exclusive: ['file', 'url', 'query'],\n    required: false,\n  }),\n  title: Flags.string({\n    dependsOn: ['text'],\n    description: 'Title for an inline text import',\n    required: false,\n  }),\n  url: Flags.string({\n    description: 'Website URL to crawl',\n    exclusive: ['text', 'file', 'query'],\n    helpValue: '<url>',\n    required: false,\n  }),\n} satisfies FlagInput\n\nexport class CreateImportCommand extends SanityCommand<typeof CreateImportCommand> {\n  static override args = {\n    knowledgeBaseId: Args.string({\n      description: 'Knowledge base ID',\n      required: true,\n    }),\n  }\n\n  static override description = 'Import content into a knowledge base'\n\n  static override examples = [\n    {\n      command:\n        '<%= config.bin %> <%= command.id %> kb-abc123 --text \"Refunds are processed within 5 days\" --title \"Refund policy\"',\n      description: 'Import inline text',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123 --file ./handbook.pdf',\n      description: 'Upload and import a local file',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123 --url https://example.com/docs',\n      description: 'Crawl a website',\n    },\n    {\n      command:\n        '<%= config.bin %> <%= command.id %> kb-abc123 --query \\'*[_type == \"article\"]\\' --sanity-project abc123 --sanity-dataset production',\n      description: 'Bind a Sanity dataset as a source',\n    },\n  ]\n\n  static override flags = flags\n\n  static telemetry = defineCommandTelemetry(flags, {\n    redact: ['text', 'file', 'url', 'title', 'query'],\n  })\n\n  public async run(): Promise<void> {\n    const {knowledgeBaseId} = this.args\n\n    const params = await this.buildImportParams()\n\n    const spin = spinner('Creating import').start()\n    try {\n      const {jobId} = await createImport(knowledgeBaseId, params)\n      spin.succeed('Import created')\n      this.log(formatKeyValue('Job ID', jobId))\n      this.log(`Track it with: sanity context jobs get ${knowledgeBaseId} ${jobId}`)\n    } catch (error) {\n      spin.fail()\n      createImportDebug('Error creating import', error)\n      if (isHttpError(error) && error.statusCode === 404) {\n        this.error(`Knowledge base \"${knowledgeBaseId}\" not found`, {\n          exit: exitCodes.RUNTIME_ERROR,\n        })\n      }\n      this.error(`Failed to create import: ${getErrorMessage(error)}`, {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n  }\n\n  private async buildFileImportParams(filePath: string): Promise<Context.CreateFileImportParams> {\n    const {'content-type': contentType} = this.flags\n\n    let fileContent: Buffer\n    try {\n      fileContent = await readFile(filePath)\n    } catch (error) {\n      createImportDebug('Error reading import file', error)\n      this.error(`Failed to read file \"${filePath}\": ${getErrorMessage(error)}`, {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n\n    // The Context API signs the upload URL for a content-type header, so one\n    // must always be sent or the upload fails (API quirk found in live testing).\n    const inferredContentType =\n      FILE_CONTENT_TYPES[extname(filePath).toLowerCase()] ?? 'application/octet-stream'\n\n    return {\n      contentType: contentType ?? inferredContentType,\n      file: fileContent,\n      filename: basename(filePath),\n      type: 'file',\n    }\n  }\n\n  private async buildImportParams(): Promise<\n    Context.CreateFileImportParams | Context.CreateImportParams\n  > {\n    const {\n      'content-type': contentType,\n      file,\n      query,\n      'sanity-dataset': sanityDataset,\n      'sanity-project': sanityProject,\n      text,\n      url,\n    } = this.flags\n\n    const sources: [flag: '--file' | '--query' | '--text' | '--url', value: string | undefined][] =\n      [\n        ['--text', text],\n        ['--file', file],\n        ['--url', url],\n        ['--query', query],\n      ]\n    const provided = sources.filter(([, value]) => value !== undefined)\n    if (provided.length !== 1) {\n      this.error('Provide exactly one of --text, --file, --url or --query.', {\n        exit: exitCodes.USAGE_ERROR,\n      })\n    }\n\n    const [sourceFlag, sourceValue] = provided[0]\n    if (!sourceValue?.trim()) {\n      this.error(`${sourceFlag} cannot be empty`, {exit: exitCodes.USAGE_ERROR})\n    }\n\n    if (sourceFlag === '--text') {\n      return this.buildTextImportParams(sourceValue)\n    }\n\n    if (sourceFlag === '--file') {\n      return this.buildFileImportParams(sourceValue)\n    }\n\n    if (contentType !== undefined) {\n      this.error('The --content-type flag only applies to --text and --file imports.', {\n        exit: exitCodes.USAGE_ERROR,\n      })\n    }\n\n    if (sourceFlag === '--url') {\n      return {type: 'crawl', url: sourceValue}\n    }\n\n    // Only --query remains; the checks above narrow `sourceFlag` to '--query'.\n    if (!sanityProject || !sanityDataset) {\n      this.error(\n        'Dataset imports require --sanity-project and --sanity-dataset alongside --query.',\n        {exit: exitCodes.USAGE_ERROR},\n      )\n    }\n\n    return {\n      query: sourceValue,\n      sanityDatasetId: sanityDataset,\n      sanityProjectId: sanityProject,\n      type: 'dataset',\n    }\n  }\n\n  private buildTextImportParams(text: string): Context.CreateImportParams {\n    const {'content-type': contentType, title} = this.flags\n\n    if (!title?.trim()) {\n      this.error('Title is required for text imports. Provide it with the --title flag.', {\n        exit: exitCodes.USAGE_ERROR,\n      })\n    }\n\n    if (contentType !== undefined && !isTextContentType(contentType)) {\n      this.error(\n        `Text imports support content types ${TEXT_CONTENT_TYPES.join(' and ')}, got \"${contentType}\".`,\n        {exit: exitCodes.USAGE_ERROR},\n      )\n    }\n\n    return {\n      content: text,\n      title: title.trim(),\n      type: 'text',\n      ...(contentType === undefined ? {} : {contentType}),\n    }\n  }\n}\n"],"names":["readFile","basename","extname","Args","Flags","exitCodes","SanityCommand","subdebug","getErrorMessage","spinner","isHttpError","formatKeyValue","createImport","defineCommandTelemetry","createImportDebug","TEXT_CONTENT_TYPES","isTextContentType","value","textContentTypes","includes","FILE_CONTENT_TYPES","flags","string","description","helpValue","parse","input","trimmed","trim","Error","required","file","exclusive","query","dependsOn","text","title","url","CreateImportCommand","args","knowledgeBaseId","examples","command","telemetry","redact","run","params","buildImportParams","spin","start","jobId","succeed","log","error","fail","statusCode","exit","RUNTIME_ERROR","buildFileImportParams","filePath","contentType","fileContent","inferredContentType","toLowerCase","filename","type","sanityDataset","sanityProject","sources","provided","filter","undefined","length","USAGE_ERROR","sourceFlag","sourceValue","buildTextImportParams","sanityDatasetId","sanityProjectId","join","content"],"mappings":"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"}

package/dist/commands/context/imports/delete.js

@@ -0,0 +1,73 @@
+import { Args, Flags } from '@oclif/core';
+import { exitCodes, SanityCommand, subdebug } from '@sanity/cli-core';
+import { getErrorMessage } from '@sanity/cli-core/errors';
+import { confirm } from '@sanity/cli-core/ux';
+import { isHttpError } from '@sanity/client';
+import { deleteImport } from '../../../services/context.js';
+const deleteImportDebug = subdebug('context:imports:delete');
+export class DeleteImportCommand extends SanityCommand {
+    static args = {
+        knowledgeBaseId: Args.string({
+            description: 'Knowledge base ID',
+            required: true
+        }),
+        // eslint-disable-next-line perfectionist/sort-objects -- positional order: knowledge base first
+        importId: Args.string({
+            description: 'Import ID',
+            required: true
+        })
+    };
+    static description = 'Delete an import from a knowledge base';
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %> kb-abc123 import-def456',
+            description: 'Delete an import after confirmation'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> kb-abc123 import-def456 --yes',
+            description: 'Delete an import without confirmation prompt'
+        }
+    ];
+    static flags = {
+        yes: Flags.boolean({
+            char: 'y',
+            default: false,
+            description: 'Skip confirmation prompt (unattended mode)'
+        })
+    };
+    async run() {
+        const { importId, knowledgeBaseId } = this.args;
+        const { yes: skipConfirmation } = this.flags;
+        if (this.isUnattended() && !skipConfirmation) {
+            this.error('Deletion requires confirmation. Pass `--yes` to delete the import.', {
+                exit: exitCodes.USAGE_ERROR
+            });
+        }
+        if (!skipConfirmation) {
+            const confirmed = await confirm({
+                default: false,
+                message: `Delete import "${importId}"?`
+            });
+            if (!confirmed) {
+                this.log('Import not deleted');
+                this.exit(exitCodes.USER_ABORT);
+            }
+        }
+        try {
+            await deleteImport(knowledgeBaseId, importId);
+            this.log('Import deleted');
+        } catch (error) {
+            deleteImportDebug('Error deleting import', error);
+            if (isHttpError(error) && error.statusCode === 404) {
+                this.error(`Import "${importId}" not found on knowledge base "${knowledgeBaseId}"`, {
+                    exit: exitCodes.RUNTIME_ERROR
+                });
+            }
+            this.error(`Failed to delete import: ${getErrorMessage(error)}`, {
+                exit: exitCodes.RUNTIME_ERROR
+            });
+        }
+    }
+}
+
+//# sourceMappingURL=delete.js.map

package/dist/commands/context/imports/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/commands/context/imports/delete.ts"],"sourcesContent":["import {Args, Flags} from '@oclif/core'\nimport {type FlagInput} from '@oclif/core/interfaces'\nimport {exitCodes, SanityCommand, subdebug} from '@sanity/cli-core'\nimport {getErrorMessage} from '@sanity/cli-core/errors'\nimport {confirm} from '@sanity/cli-core/ux'\nimport {isHttpError} from '@sanity/client'\n\nimport {deleteImport} from '../../../services/context.js'\n\nconst deleteImportDebug = subdebug('context:imports:delete')\n\nexport class DeleteImportCommand extends SanityCommand<typeof DeleteImportCommand> {\n  static override args = {\n    knowledgeBaseId: Args.string({\n      description: 'Knowledge base ID',\n      required: true,\n    }),\n    // eslint-disable-next-line perfectionist/sort-objects -- positional order: knowledge base first\n    importId: Args.string({\n      description: 'Import ID',\n      required: true,\n    }),\n  }\n\n  static override description = 'Delete an import from a knowledge base'\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123 import-def456',\n      description: 'Delete an import after confirmation',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123 import-def456 --yes',\n      description: 'Delete an import without confirmation prompt',\n    },\n  ]\n\n  static override flags = {\n    yes: Flags.boolean({\n      char: 'y',\n      default: false,\n      description: 'Skip confirmation prompt (unattended mode)',\n    }),\n  } satisfies FlagInput\n\n  public async run(): Promise<void> {\n    const {importId, knowledgeBaseId} = this.args\n    const {yes: skipConfirmation} = this.flags\n\n    if (this.isUnattended() && !skipConfirmation) {\n      this.error('Deletion requires confirmation. Pass `--yes` to delete the import.', {\n        exit: exitCodes.USAGE_ERROR,\n      })\n    }\n\n    if (!skipConfirmation) {\n      const confirmed = await confirm({\n        default: false,\n        message: `Delete import \"${importId}\"?`,\n      })\n\n      if (!confirmed) {\n        this.log('Import not deleted')\n        this.exit(exitCodes.USER_ABORT)\n      }\n    }\n\n    try {\n      await deleteImport(knowledgeBaseId, importId)\n      this.log('Import deleted')\n    } catch (error) {\n      deleteImportDebug('Error deleting import', error)\n      if (isHttpError(error) && error.statusCode === 404) {\n        this.error(`Import \"${importId}\" not found on knowledge base \"${knowledgeBaseId}\"`, {\n          exit: exitCodes.RUNTIME_ERROR,\n        })\n      }\n      this.error(`Failed to delete import: ${getErrorMessage(error)}`, {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n  }\n}\n"],"names":["Args","Flags","exitCodes","SanityCommand","subdebug","getErrorMessage","confirm","isHttpError","deleteImport","deleteImportDebug","DeleteImportCommand","args","knowledgeBaseId","string","description","required","importId","examples","command","flags","yes","boolean","char","default","run","skipConfirmation","isUnattended","error","exit","USAGE_ERROR","confirmed","message","log","USER_ABORT","statusCode","RUNTIME_ERROR"],"mappings":"AAAA,SAAQA,IAAI,EAAEC,KAAK,QAAO,cAAa;AAEvC,SAAQC,SAAS,EAAEC,aAAa,EAAEC,QAAQ,QAAO,mBAAkB;AACnE,SAAQC,eAAe,QAAO,0BAAyB;AACvD,SAAQC,OAAO,QAAO,sBAAqB;AAC3C,SAAQC,WAAW,QAAO,iBAAgB;AAE1C,SAAQC,YAAY,QAAO,+BAA8B;AAEzD,MAAMC,oBAAoBL,SAAS;AAEnC,OAAO,MAAMM,4BAA4BP;IACvC,OAAgBQ,OAAO;QACrBC,iBAAiBZ,KAAKa,MAAM,CAAC;YAC3BC,aAAa;YACbC,UAAU;QACZ;QACA,gGAAgG;QAChGC,UAAUhB,KAAKa,MAAM,CAAC;YACpBC,aAAa;YACbC,UAAU;QACZ;IACF,EAAC;IAED,OAAgBD,cAAc,yCAAwC;IAEtE,OAAgBG,WAAW;QACzB;YACEC,SAAS;YACTJ,aAAa;QACf;QACA;YACEI,SAAS;YACTJ,aAAa;QACf;KACD,CAAA;IAED,OAAgBK,QAAQ;QACtBC,KAAKnB,MAAMoB,OAAO,CAAC;YACjBC,MAAM;YACNC,SAAS;YACTT,aAAa;QACf;IACF,EAAqB;IAErB,MAAaU,MAAqB;QAChC,MAAM,EAACR,QAAQ,EAAEJ,eAAe,EAAC,GAAG,IAAI,CAACD,IAAI;QAC7C,MAAM,EAACS,KAAKK,gBAAgB,EAAC,GAAG,IAAI,CAACN,KAAK;QAE1C,IAAI,IAAI,CAACO,YAAY,MAAM,CAACD,kBAAkB;YAC5C,IAAI,CAACE,KAAK,CAAC,sEAAsE;gBAC/EC,MAAM1B,UAAU2B,WAAW;YAC7B;QACF;QAEA,IAAI,CAACJ,kBAAkB;YACrB,MAAMK,YAAY,MAAMxB,QAAQ;gBAC9BiB,SAAS;gBACTQ,SAAS,CAAC,eAAe,EAAEf,SAAS,EAAE,CAAC;YACzC;YAEA,IAAI,CAACc,WAAW;gBACd,IAAI,CAACE,GAAG,CAAC;gBACT,IAAI,CAACJ,IAAI,CAAC1B,UAAU+B,UAAU;YAChC;QACF;QAEA,IAAI;YACF,MAAMzB,aAAaI,iBAAiBI;YACpC,IAAI,CAACgB,GAAG,CAAC;QACX,EAAE,OAAOL,OAAO;YACdlB,kBAAkB,yBAAyBkB;YAC3C,IAAIpB,YAAYoB,UAAUA,MAAMO,UAAU,KAAK,KAAK;gBAClD,IAAI,CAACP,KAAK,CAAC,CAAC,QAAQ,EAAEX,SAAS,+BAA+B,EAAEJ,gBAAgB,CAAC,CAAC,EAAE;oBAClFgB,MAAM1B,UAAUiC,aAAa;gBAC/B;YACF;YACA,IAAI,CAACR,KAAK,CAAC,CAAC,yBAAyB,EAAEtB,gBAAgBsB,QAAQ,EAAE;gBAC/DC,MAAM1B,UAAUiC,aAAa;YAC/B;QACF;IACF;AACF"}

package/dist/commands/context/imports/download.js

@@ -0,0 +1,65 @@
+import { Args, Flags } from '@oclif/core';
+import { exitCodes, SanityCommand, subdebug } from '@sanity/cli-core';
+import { getErrorMessage } from '@sanity/cli-core/errors';
+import { isHttpError } from '@sanity/client';
+import { formatKeyValue } from '../../../actions/debug/output.js';
+import { downloadImport } from '../../../services/context.js';
+const downloadImportDebug = subdebug('context:imports:download');
+export class DownloadImportCommand extends SanityCommand {
+    static args = {
+        knowledgeBaseId: Args.string({
+            description: 'Knowledge base ID',
+            required: true
+        }),
+        // eslint-disable-next-line perfectionist/sort-objects -- positional order: knowledge base first
+        importId: Args.string({
+            description: 'Import ID',
+            required: true
+        })
+    };
+    static description = 'Get a short-lived signed URL for the original uploaded bytes of a file import';
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %> kb-abc123 import-def456',
+            description: 'Get a download URL for an uploaded file'
+        }
+    ];
+    static flags = {
+        json: Flags.boolean({
+            default: false,
+            description: 'Output the download URL in JSON format'
+        })
+    };
+    async run() {
+        const { importId, knowledgeBaseId } = this.args;
+        const { json } = this.flags;
+        let download;
+        try {
+            download = await downloadImport(knowledgeBaseId, importId);
+        } catch (error) {
+            downloadImportDebug('Error getting import download URL', error);
+            if (isHttpError(error) && error.statusCode === 404) {
+                this.error(`Import "${importId}" not found on knowledge base "${knowledgeBaseId}"`, {
+                    exit: exitCodes.RUNTIME_ERROR
+                });
+            }
+            this.error(`Failed to get import download URL: ${getErrorMessage(error)}`, {
+                exit: exitCodes.RUNTIME_ERROR
+            });
+        }
+        if (json) {
+            this.log(JSON.stringify(download, null, 2));
+            return;
+        }
+        const padTo = 7 // "Expires" is the longest key
+        ;
+        this.log(formatKeyValue('URL', download.url, {
+            padTo
+        }));
+        this.log(formatKeyValue('Expires', download.expiresAt, {
+            padTo
+        }));
+    }
+}
+
+//# sourceMappingURL=download.js.map

package/dist/commands/context/imports/download.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/commands/context/imports/download.ts"],"sourcesContent":["import {Args, Flags} from '@oclif/core'\nimport {type FlagInput} from '@oclif/core/interfaces'\nimport {exitCodes, SanityCommand, subdebug} from '@sanity/cli-core'\nimport {getErrorMessage} from '@sanity/cli-core/errors'\nimport {isHttpError} from '@sanity/client'\n\nimport {formatKeyValue} from '../../../actions/debug/output.js'\nimport {downloadImport} from '../../../services/context.js'\n\nconst downloadImportDebug = subdebug('context:imports:download')\n\nexport class DownloadImportCommand extends SanityCommand<typeof DownloadImportCommand> {\n  static override args = {\n    knowledgeBaseId: Args.string({\n      description: 'Knowledge base ID',\n      required: true,\n    }),\n    // eslint-disable-next-line perfectionist/sort-objects -- positional order: knowledge base first\n    importId: Args.string({\n      description: 'Import ID',\n      required: true,\n    }),\n  }\n\n  static override description =\n    'Get a short-lived signed URL for the original uploaded bytes of a file import'\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123 import-def456',\n      description: 'Get a download URL for an uploaded file',\n    },\n  ]\n\n  static override flags = {\n    json: Flags.boolean({\n      default: false,\n      description: 'Output the download URL in JSON format',\n    }),\n  } satisfies FlagInput\n\n  public async run(): Promise<void> {\n    const {importId, knowledgeBaseId} = this.args\n    const {json} = this.flags\n\n    let download\n    try {\n      download = await downloadImport(knowledgeBaseId, importId)\n    } catch (error) {\n      downloadImportDebug('Error getting import download URL', error)\n      if (isHttpError(error) && error.statusCode === 404) {\n        this.error(`Import \"${importId}\" not found on knowledge base \"${knowledgeBaseId}\"`, {\n          exit: exitCodes.RUNTIME_ERROR,\n        })\n      }\n      this.error(`Failed to get import download URL: ${getErrorMessage(error)}`, {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n\n    if (json) {\n      this.log(JSON.stringify(download, null, 2))\n      return\n    }\n\n    const padTo = 7 // \"Expires\" is the longest key\n    this.log(formatKeyValue('URL', download.url, {padTo}))\n    this.log(formatKeyValue('Expires', download.expiresAt, {padTo}))\n  }\n}\n"],"names":["Args","Flags","exitCodes","SanityCommand","subdebug","getErrorMessage","isHttpError","formatKeyValue","downloadImport","downloadImportDebug","DownloadImportCommand","args","knowledgeBaseId","string","description","required","importId","examples","command","flags","json","boolean","default","run","download","error","statusCode","exit","RUNTIME_ERROR","log","JSON","stringify","padTo","url","expiresAt"],"mappings":"AAAA,SAAQA,IAAI,EAAEC,KAAK,QAAO,cAAa;AAEvC,SAAQC,SAAS,EAAEC,aAAa,EAAEC,QAAQ,QAAO,mBAAkB;AACnE,SAAQC,eAAe,QAAO,0BAAyB;AACvD,SAAQC,WAAW,QAAO,iBAAgB;AAE1C,SAAQC,cAAc,QAAO,mCAAkC;AAC/D,SAAQC,cAAc,QAAO,+BAA8B;AAE3D,MAAMC,sBAAsBL,SAAS;AAErC,OAAO,MAAMM,8BAA8BP;IACzC,OAAgBQ,OAAO;QACrBC,iBAAiBZ,KAAKa,MAAM,CAAC;YAC3BC,aAAa;YACbC,UAAU;QACZ;QACA,gGAAgG;QAChGC,UAAUhB,KAAKa,MAAM,CAAC;YACpBC,aAAa;YACbC,UAAU;QACZ;IACF,EAAC;IAED,OAAgBD,cACd,gFAA+E;IAEjF,OAAgBG,WAAW;QACzB;YACEC,SAAS;YACTJ,aAAa;QACf;KACD,CAAA;IAED,OAAgBK,QAAQ;QACtBC,MAAMnB,MAAMoB,OAAO,CAAC;YAClBC,SAAS;YACTR,aAAa;QACf;IACF,EAAqB;IAErB,MAAaS,MAAqB;QAChC,MAAM,EAACP,QAAQ,EAAEJ,eAAe,EAAC,GAAG,IAAI,CAACD,IAAI;QAC7C,MAAM,EAACS,IAAI,EAAC,GAAG,IAAI,CAACD,KAAK;QAEzB,IAAIK;QACJ,IAAI;YACFA,WAAW,MAAMhB,eAAeI,iBAAiBI;QACnD,EAAE,OAAOS,OAAO;YACdhB,oBAAoB,qCAAqCgB;YACzD,IAAInB,YAAYmB,UAAUA,MAAMC,UAAU,KAAK,KAAK;gBAClD,IAAI,CAACD,KAAK,CAAC,CAAC,QAAQ,EAAET,SAAS,+BAA+B,EAAEJ,gBAAgB,CAAC,CAAC,EAAE;oBAClFe,MAAMzB,UAAU0B,aAAa;gBAC/B;YACF;YACA,IAAI,CAACH,KAAK,CAAC,CAAC,mCAAmC,EAAEpB,gBAAgBoB,QAAQ,EAAE;gBACzEE,MAAMzB,UAAU0B,aAAa;YAC/B;QACF;QAEA,IAAIR,MAAM;YACR,IAAI,CAACS,GAAG,CAACC,KAAKC,SAAS,CAACP,UAAU,MAAM;YACxC;QACF;QAEA,MAAMQ,QAAQ,EAAE,+BAA+B;;QAC/C,IAAI,CAACH,GAAG,CAACtB,eAAe,OAAOiB,SAASS,GAAG,EAAE;YAACD;QAAK;QACnD,IAAI,CAACH,GAAG,CAACtB,eAAe,WAAWiB,SAASU,SAAS,EAAE;YAACF;QAAK;IAC/D;AACF"}

package/dist/commands/context/imports/get.js

@@ -0,0 +1,93 @@
+import { Args, Flags } from '@oclif/core';
+import { exitCodes, SanityCommand, subdebug } from '@sanity/cli-core';
+import { getErrorMessage } from '@sanity/cli-core/errors';
+import { isHttpError } from '@sanity/client';
+import { formatKeyValue } from '../../../actions/debug/output.js';
+import { getImport } from '../../../services/context.js';
+const getImportDebug = subdebug('context:imports:get');
+export class GetImportCommand extends SanityCommand {
+    static args = {
+        knowledgeBaseId: Args.string({
+            description: 'Knowledge base ID',
+            required: true
+        }),
+        // eslint-disable-next-line perfectionist/sort-objects -- positional order: knowledge base first
+        importId: Args.string({
+            description: 'Import ID',
+            required: true
+        })
+    };
+    static description = 'Get details of an import';
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %> kb-abc123 import-def456',
+            description: 'Get details of a specific import'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> kb-abc123 import-def456 --json',
+            description: 'Output the import as JSON'
+        }
+    ];
+    static flags = {
+        json: Flags.boolean({
+            default: false,
+            description: 'Output the import in JSON format'
+        })
+    };
+    async run() {
+        const { importId, knowledgeBaseId } = this.args;
+        const { json } = this.flags;
+        let importDetail;
+        try {
+            importDetail = await getImport(knowledgeBaseId, importId);
+        } catch (error) {
+            getImportDebug('Error getting import', error);
+            if (isHttpError(error) && error.statusCode === 404) {
+                this.error(`Import "${importId}" not found on knowledge base "${knowledgeBaseId}"`, {
+                    exit: exitCodes.RUNTIME_ERROR
+                });
+            }
+            this.error(`Failed to get import: ${getErrorMessage(error)}`, {
+                exit: exitCodes.RUNTIME_ERROR
+            });
+        }
+        if (json) {
+            this.log(JSON.stringify(importDetail, null, 2));
+            return;
+        }
+        const padTo = 9 // "Completed" is the longest key
+        ;
+        this.log(formatKeyValue('ID', importDetail.id, {
+            padTo
+        }));
+        this.log(formatKeyValue('Name', importDetail.name ?? '-', {
+            padTo
+        }));
+        this.log(formatKeyValue('Kind', importDetail.sourceKind, {
+            padTo
+        }));
+        this.log(formatKeyValue('Status', importDetail.status, {
+            padTo
+        }));
+        this.log(formatKeyValue('Detail', importDetail.statusDetail ?? '-', {
+            padTo
+        }));
+        this.log(formatKeyValue('Error', importDetail.error ?? '-', {
+            padTo
+        }));
+        this.log(formatKeyValue('Sources', importDetail.sourceCount, {
+            padTo
+        }));
+        this.log(formatKeyValue('Distilled', `${importDetail.distilledCount}/${importDetail.totalDistillableCount}`, {
+            padTo
+        }));
+        this.log(formatKeyValue('Created', importDetail.createdAt, {
+            padTo
+        }));
+        this.log(formatKeyValue('Completed', importDetail.completedAt ?? '-', {
+            padTo
+        }));
+    }
+}
+
+//# sourceMappingURL=get.js.map

package/dist/commands/context/imports/get.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/commands/context/imports/get.ts"],"sourcesContent":["import {Args, Flags} from '@oclif/core'\nimport {type FlagInput} from '@oclif/core/interfaces'\nimport {exitCodes, SanityCommand, subdebug} from '@sanity/cli-core'\nimport {getErrorMessage} from '@sanity/cli-core/errors'\nimport {isHttpError} from '@sanity/client'\n\nimport {formatKeyValue} from '../../../actions/debug/output.js'\nimport {getImport} from '../../../services/context.js'\n\nconst getImportDebug = subdebug('context:imports:get')\n\nexport class GetImportCommand extends SanityCommand<typeof GetImportCommand> {\n  static override args = {\n    knowledgeBaseId: Args.string({\n      description: 'Knowledge base ID',\n      required: true,\n    }),\n    // eslint-disable-next-line perfectionist/sort-objects -- positional order: knowledge base first\n    importId: Args.string({\n      description: 'Import ID',\n      required: true,\n    }),\n  }\n\n  static override description = 'Get details of an import'\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123 import-def456',\n      description: 'Get details of a specific import',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123 import-def456 --json',\n      description: 'Output the import as JSON',\n    },\n  ]\n\n  static override flags = {\n    json: Flags.boolean({\n      default: false,\n      description: 'Output the import in JSON format',\n    }),\n  } satisfies FlagInput\n\n  public async run(): Promise<void> {\n    const {importId, knowledgeBaseId} = this.args\n    const {json} = this.flags\n\n    let importDetail\n    try {\n      importDetail = await getImport(knowledgeBaseId, importId)\n    } catch (error) {\n      getImportDebug('Error getting import', error)\n      if (isHttpError(error) && error.statusCode === 404) {\n        this.error(`Import \"${importId}\" not found on knowledge base \"${knowledgeBaseId}\"`, {\n          exit: exitCodes.RUNTIME_ERROR,\n        })\n      }\n      this.error(`Failed to get import: ${getErrorMessage(error)}`, {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n\n    if (json) {\n      this.log(JSON.stringify(importDetail, null, 2))\n      return\n    }\n\n    const padTo = 9 // \"Completed\" is the longest key\n    this.log(formatKeyValue('ID', importDetail.id, {padTo}))\n    this.log(formatKeyValue('Name', importDetail.name ?? '-', {padTo}))\n    this.log(formatKeyValue('Kind', importDetail.sourceKind, {padTo}))\n    this.log(formatKeyValue('Status', importDetail.status, {padTo}))\n    this.log(formatKeyValue('Detail', importDetail.statusDetail ?? '-', {padTo}))\n    this.log(formatKeyValue('Error', importDetail.error ?? '-', {padTo}))\n    this.log(formatKeyValue('Sources', importDetail.sourceCount, {padTo}))\n    this.log(\n      formatKeyValue(\n        'Distilled',\n        `${importDetail.distilledCount}/${importDetail.totalDistillableCount}`,\n        {padTo},\n      ),\n    )\n    this.log(formatKeyValue('Created', importDetail.createdAt, {padTo}))\n    this.log(formatKeyValue('Completed', importDetail.completedAt ?? '-', {padTo}))\n  }\n}\n"],"names":["Args","Flags","exitCodes","SanityCommand","subdebug","getErrorMessage","isHttpError","formatKeyValue","getImport","getImportDebug","GetImportCommand","args","knowledgeBaseId","string","description","required","importId","examples","command","flags","json","boolean","default","run","importDetail","error","statusCode","exit","RUNTIME_ERROR","log","JSON","stringify","padTo","id","name","sourceKind","status","statusDetail","sourceCount","distilledCount","totalDistillableCount","createdAt","completedAt"],"mappings":"AAAA,SAAQA,IAAI,EAAEC,KAAK,QAAO,cAAa;AAEvC,SAAQC,SAAS,EAAEC,aAAa,EAAEC,QAAQ,QAAO,mBAAkB;AACnE,SAAQC,eAAe,QAAO,0BAAyB;AACvD,SAAQC,WAAW,QAAO,iBAAgB;AAE1C,SAAQC,cAAc,QAAO,mCAAkC;AAC/D,SAAQC,SAAS,QAAO,+BAA8B;AAEtD,MAAMC,iBAAiBL,SAAS;AAEhC,OAAO,MAAMM,yBAAyBP;IACpC,OAAgBQ,OAAO;QACrBC,iBAAiBZ,KAAKa,MAAM,CAAC;YAC3BC,aAAa;YACbC,UAAU;QACZ;QACA,gGAAgG;QAChGC,UAAUhB,KAAKa,MAAM,CAAC;YACpBC,aAAa;YACbC,UAAU;QACZ;IACF,EAAC;IAED,OAAgBD,cAAc,2BAA0B;IAExD,OAAgBG,WAAW;QACzB;YACEC,SAAS;YACTJ,aAAa;QACf;QACA;YACEI,SAAS;YACTJ,aAAa;QACf;KACD,CAAA;IAED,OAAgBK,QAAQ;QACtBC,MAAMnB,MAAMoB,OAAO,CAAC;YAClBC,SAAS;YACTR,aAAa;QACf;IACF,EAAqB;IAErB,MAAaS,MAAqB;QAChC,MAAM,EAACP,QAAQ,EAAEJ,eAAe,EAAC,GAAG,IAAI,CAACD,IAAI;QAC7C,MAAM,EAACS,IAAI,EAAC,GAAG,IAAI,CAACD,KAAK;QAEzB,IAAIK;QACJ,IAAI;YACFA,eAAe,MAAMhB,UAAUI,iBAAiBI;QAClD,EAAE,OAAOS,OAAO;YACdhB,eAAe,wBAAwBgB;YACvC,IAAInB,YAAYmB,UAAUA,MAAMC,UAAU,KAAK,KAAK;gBAClD,IAAI,CAACD,KAAK,CAAC,CAAC,QAAQ,EAAET,SAAS,+BAA+B,EAAEJ,gBAAgB,CAAC,CAAC,EAAE;oBAClFe,MAAMzB,UAAU0B,aAAa;gBAC/B;YACF;YACA,IAAI,CAACH,KAAK,CAAC,CAAC,sBAAsB,EAAEpB,gBAAgBoB,QAAQ,EAAE;gBAC5DE,MAAMzB,UAAU0B,aAAa;YAC/B;QACF;QAEA,IAAIR,MAAM;YACR,IAAI,CAACS,GAAG,CAACC,KAAKC,SAAS,CAACP,cAAc,MAAM;YAC5C;QACF;QAEA,MAAMQ,QAAQ,EAAE,iCAAiC;;QACjD,IAAI,CAACH,GAAG,CAACtB,eAAe,MAAMiB,aAAaS,EAAE,EAAE;YAACD;QAAK;QACrD,IAAI,CAACH,GAAG,CAACtB,eAAe,QAAQiB,aAAaU,IAAI,IAAI,KAAK;YAACF;QAAK;QAChE,IAAI,CAACH,GAAG,CAACtB,eAAe,QAAQiB,aAAaW,UAAU,EAAE;YAACH;QAAK;QAC/D,IAAI,CAACH,GAAG,CAACtB,eAAe,UAAUiB,aAAaY,MAAM,EAAE;YAACJ;QAAK;QAC7D,IAAI,CAACH,GAAG,CAACtB,eAAe,UAAUiB,aAAaa,YAAY,IAAI,KAAK;YAACL;QAAK;QAC1E,IAAI,CAACH,GAAG,CAACtB,eAAe,SAASiB,aAAaC,KAAK,IAAI,KAAK;YAACO;QAAK;QAClE,IAAI,CAACH,GAAG,CAACtB,eAAe,WAAWiB,aAAac,WAAW,EAAE;YAACN;QAAK;QACnE,IAAI,CAACH,GAAG,CACNtB,eACE,aACA,GAAGiB,aAAae,cAAc,CAAC,CAAC,EAAEf,aAAagB,qBAAqB,EAAE,EACtE;YAACR;QAAK;QAGV,IAAI,CAACH,GAAG,CAACtB,eAAe,WAAWiB,aAAaiB,SAAS,EAAE;YAACT;QAAK;QACjE,IAAI,CAACH,GAAG,CAACtB,eAAe,aAAaiB,aAAakB,WAAW,IAAI,KAAK;YAACV;QAAK;IAC9E;AACF"}