@sanity/cli 5.1.1-next.6 → 6.0.0-alpha.3

package/dist/commands/docs/__tests__/search.test.js

@@ -0,0 +1,254 @@
+import { runCommand } from '@oclif/test';
+import { isInteractive } from '@sanity/cli-core';
+import { select } from '@sanity/cli-core/ux';
+import { testCommand } from '@sanity/cli-test';
+import nock from 'nock';
+import { afterEach, describe, expect, test, vi } from 'vitest';
+import { DocsSearchCommand } from '../search.js';
+vi.mock('@sanity/cli-core/ux', async ()=>{
+    const actual = await vi.importActual('@sanity/cli-core/ux');
+    return {
+        ...actual,
+        select: vi.fn()
+    };
+});
+vi.mock('../../../../../cli-core/src/util/isInteractive.js', async ()=>{
+    return {
+        isInteractive: vi.fn()
+    };
+});
+const mockedSelect = vi.mocked(select);
+const mockedIsInteractive = vi.mocked(isInteractive);
+afterEach(()=>{
+    const pending = nock.pendingMocks();
+    nock.cleanAll();
+    expect(pending, 'pending mocks').toEqual([]);
+    vi.resetAllMocks();
+});
+describe('#docs:search', ()=>{
+    test('--help works', async ()=>{
+        const { stdout } = await runCommand('docs search --help');
+        expect(stdout).toMatchInlineSnapshot(`
+      "Search Sanity docs
+
+      USAGE
+        $ sanity docs search QUERY [--limit <value>]
+
+      ARGUMENTS
+        QUERY  Search query for documentation
+
+      FLAGS
+        --limit=<value>  [default: 10] Maximum number of results to return
+
+      DESCRIPTION
+        Search Sanity docs
+
+      EXAMPLES
+        Search for documentation about schemas
+
+          $ sanity docs search schema
+
+        Search with phrase
+
+          $ sanity docs search "groq functions"
+
+        Limit search results
+
+          $ sanity docs search "deployment" --limit=5
+
+      "
+    `);
+    });
+    test('searches and displays results', async ()=>{
+        const searchResponse = [
+            {
+                description: 'Learn how to install Sanity Studio',
+                path: '/docs/studio/installation',
+                title: 'Studio Installation Guide'
+            },
+            {
+                description: 'Understanding Sanity schemas',
+                path: '/docs/schemas/overview',
+                title: 'Schema Overview'
+            }
+        ];
+        nock('https://www.sanity.io').get('/docs/api/search/semantic').query({
+            query: 'studio'
+        }).reply(200, searchResponse);
+        const { stdout } = await testCommand(DocsSearchCommand, [
+            'studio'
+        ]);
+        expect(stdout).toContain('Searching documentation for: "studio"');
+        expect(stdout).toContain('Found 2 result(s):');
+        expect(stdout).toContain('1. Studio Installation Guide');
+        expect(stdout).toContain('URL: https://www.sanity.io/docs/studio/installation');
+        expect(stdout).toContain('Learn how to install Sanity Studio');
+        expect(stdout).toContain('2. Schema Overview');
+    });
+    test('handles no results', async ()=>{
+        nock('https://www.sanity.io').get('/docs/api/search/semantic').query({
+            query: 'nonexistent'
+        }).reply(200, []);
+        const { stdout } = await testCommand(DocsSearchCommand, [
+            'nonexistent'
+        ]);
+        expect(stdout).toContain('Searching documentation for: "nonexistent"');
+        expect(stdout).toContain('No results found. Try a different search term.');
+    });
+    test('handles API errors', async ()=>{
+        nock('https://www.sanity.io').get('/docs/api/search/semantic').query({
+            query: 'test'
+        }).reply(500, 'Internal Server Error');
+        const { error } = await testCommand(DocsSearchCommand, [
+            'test'
+        ]).catch((err)=>err);
+        expect(error.message).toBe('The documentation search API is currently unavailable. Please try again later.');
+        expect(error.oclif?.exit).toBe(1);
+    });
+    test('respects limit flag', async ()=>{
+        const searchResponse = [
+            {
+                description: 'Learn how to install Sanity Studio 1',
+                path: '/docs/studio/installation',
+                title: 'Studio Installation Guide'
+            },
+            {
+                description: 'Learn how to install Sanity Studio 2',
+                path: '/docs/studio/installation',
+                title: 'Studio Installation Guide'
+            },
+            {
+                description: 'Learn how to install Sanity Studio 3',
+                path: '/docs/studio/installation',
+                title: 'Studio Installation Guide'
+            },
+            {
+                description: 'Learn how to install Sanity Studio 4',
+                path: '/docs/studio/installation',
+                title: 'Studio Installation Guide'
+            },
+            {
+                description: 'Learn how to install Sanity Studio 5',
+                path: '/docs/studio/installation',
+                title: 'Studio Installation Guide'
+            },
+            {
+                description: 'Learn how to install Sanity Studio 6',
+                path: '/docs/studio/installation',
+                title: 'Studio Installation Guide'
+            }
+        ];
+        nock('https://www.sanity.io').get('/docs/api/search/semantic').query({
+            query: 'studio'
+        }).reply(200, searchResponse);
+        const { stdout } = await testCommand(DocsSearchCommand, [
+            'studio',
+            '--limit=3'
+        ]);
+        expect(stdout).toContain('Found 3 result(s):');
+        expect(stdout).toContain('1. Studio Installation Guide');
+        expect(stdout).toContain('2. Studio Installation Guide');
+        expect(stdout).toContain('3. Studio Installation Guide');
+    });
+    test('handles results with empty descriptions', async ()=>{
+        const searchResponse = [
+            {
+                description: '',
+                path: '/docs/studio/installation',
+                title: 'Studio Installation Guide'
+            },
+            {
+                description: '',
+                path: '/docs/schemas/overview',
+                title: 'Schema Overview'
+            }
+        ];
+        nock('https://www.sanity.io').get('/docs/api/search/semantic').query({
+            query: 'studio'
+        }).reply(200, searchResponse);
+        const { stdout } = await testCommand(DocsSearchCommand, [
+            'studio'
+        ]);
+        expect(stdout).toContain('Searching documentation for: "studio"');
+        expect(stdout).toContain('Found 2 result(s):');
+        expect(stdout).toContain('1. Studio Installation Guide');
+        expect(stdout).toContain('URL: https://www.sanity.io/docs/studio/installation');
+        expect(stdout).toContain('2. Schema Overview');
+        // Should not show empty description lines
+        expect(stdout).not.toContain('Learn how to install');
+        expect(stdout).not.toContain('Understanding Sanity schemas');
+    });
+    test('shows usage hints in non-interactive mode', async ()=>{
+        mockedIsInteractive.mockReturnValue(false);
+        const searchResponse = [
+            {
+                description: 'Learn how to install Sanity Studio',
+                path: '/docs/studio/installation',
+                title: 'Studio Installation Guide'
+            }
+        ];
+        nock('https://www.sanity.io').get('/docs/api/search/semantic').query({
+            query: 'studio'
+        }).reply(200, searchResponse);
+        const { stdout } = await testCommand(DocsSearchCommand, [
+            'studio'
+        ]);
+        expect(stdout).toContain('Found 1 result(s):');
+        expect(stdout).toContain('Use `sanity docs read <url>` to read an article in terminal.');
+        expect(stdout).toContain('Use `sanity docs read <path>` to follow links found within articles.');
+    });
+    test('handles network errors with default message', async ()=>{
+        nock('https://www.sanity.io').get('/docs/api/search/semantic').query({
+            query: 'test'
+        }).reply(500, 'Internal Server Error');
+        const { error } = await testCommand(DocsSearchCommand, [
+            'test'
+        ]).catch((err)=>err);
+        expect(error.message).toBe('The documentation search API is currently unavailable. Please try again later.');
+        expect(error.oclif?.exit).toBe(1);
+    });
+    test('handles interactive mode article selection', async ()=>{
+        mockedIsInteractive.mockReturnValue(true);
+        mockedSelect.mockResolvedValue(0);
+        const searchResponse = [
+            {
+                description: 'Learn how to install Sanity Studio',
+                path: '/docs/studio/installation',
+                title: 'Studio Installation Guide'
+            }
+        ];
+        nock('https://www.sanity.io').get('/docs/api/search/semantic').query({
+            query: 'studio'
+        }).reply(200, searchResponse);
+        nock('https://www.sanity.io').get('/docs/studio/installation.md').reply(200, '# Studio Installation\n\nThis is how you install the studio.');
+        const { stdout } = await testCommand(DocsSearchCommand, [
+            'studio'
+        ]);
+        expect(stdout).toContain('Found 1 result(s):');
+        expect(stdout).toContain('---');
+        expect(stdout).toContain('# Studio Installation');
+        expect(stdout).toContain('This is how you install the studio.');
+    });
+    test('handles interactive mode exit selection', async ()=>{
+        mockedIsInteractive.mockReturnValue(true);
+        mockedSelect.mockResolvedValue(-1); // User selects exit option
+        const searchResponse = [
+            {
+                description: 'Learn how to install Sanity Studio',
+                path: '/docs/studio/installation',
+                title: 'Studio Installation Guide'
+            }
+        ];
+        nock('https://www.sanity.io').get('/docs/api/search/semantic').query({
+            query: 'studio'
+        }).reply(200, searchResponse);
+        const { stdout } = await testCommand(DocsSearchCommand, [
+            'studio'
+        ]);
+        expect(stdout).toContain('Found 1 result(s):');
+        expect(stdout).not.toContain('---'); // Should not show article content
+        expect(stdout).not.toContain('# Studio Installation');
+    });
+});
+
+//# sourceMappingURL=search.test.js.map

package/dist/commands/docs/__tests__/search.test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/commands/docs/__tests__/search.test.ts"],"sourcesContent":["import {runCommand} from '@oclif/test'\nimport {isInteractive} from '@sanity/cli-core'\nimport {select} from '@sanity/cli-core/ux'\nimport {testCommand} from '@sanity/cli-test'\nimport nock from 'nock'\nimport {afterEach, describe, expect, test, vi} from 'vitest'\n\nimport {DocsSearchCommand} from '../search.js'\n\nvi.mock('@sanity/cli-core/ux', async () => {\n  const actual = await vi.importActual<typeof import('@sanity/cli-core/ux')>('@sanity/cli-core/ux')\n  return {\n    ...actual,\n    select: vi.fn(),\n  }\n})\n\nvi.mock('../../../../../cli-core/src/util/isInteractive.js', async () => {\n  return {\n    isInteractive: vi.fn(),\n  }\n})\n\nconst mockedSelect = vi.mocked(select)\nconst mockedIsInteractive = vi.mocked(isInteractive)\n\nafterEach(() => {\n  const pending = nock.pendingMocks()\n  nock.cleanAll()\n  expect(pending, 'pending mocks').toEqual([])\n  vi.resetAllMocks()\n})\n\ndescribe('#docs:search', () => {\n  test('--help works', async () => {\n    const {stdout} = await runCommand('docs search --help')\n    expect(stdout).toMatchInlineSnapshot(`\n      \"Search Sanity docs\n\n      USAGE\n        $ sanity docs search QUERY [--limit <value>]\n\n      ARGUMENTS\n        QUERY  Search query for documentation\n\n      FLAGS\n        --limit=<value>  [default: 10] Maximum number of results to return\n\n      DESCRIPTION\n        Search Sanity docs\n\n      EXAMPLES\n        Search for documentation about schemas\n\n          $ sanity docs search schema\n\n        Search with phrase\n\n          $ sanity docs search \"groq functions\"\n\n        Limit search results\n\n          $ sanity docs search \"deployment\" --limit=5\n\n      \"\n    `)\n  })\n\n  test('searches and displays results', async () => {\n    const searchResponse = [\n      {\n        description: 'Learn how to install Sanity Studio',\n        path: '/docs/studio/installation',\n        title: 'Studio Installation Guide',\n      },\n      {\n        description: 'Understanding Sanity schemas',\n        path: '/docs/schemas/overview',\n        title: 'Schema Overview',\n      },\n    ]\n\n    nock('https://www.sanity.io')\n      .get('/docs/api/search/semantic')\n      .query({query: 'studio'})\n      .reply(200, searchResponse)\n\n    const {stdout} = await testCommand(DocsSearchCommand, ['studio'])\n\n    expect(stdout).toContain('Searching documentation for: \"studio\"')\n    expect(stdout).toContain('Found 2 result(s):')\n    expect(stdout).toContain('1. Studio Installation Guide')\n    expect(stdout).toContain('URL: https://www.sanity.io/docs/studio/installation')\n    expect(stdout).toContain('Learn how to install Sanity Studio')\n    expect(stdout).toContain('2. Schema Overview')\n  })\n\n  test('handles no results', async () => {\n    nock('https://www.sanity.io')\n      .get('/docs/api/search/semantic')\n      .query({query: 'nonexistent'})\n      .reply(200, [])\n\n    const {stdout} = await testCommand(DocsSearchCommand, ['nonexistent'])\n\n    expect(stdout).toContain('Searching documentation for: \"nonexistent\"')\n    expect(stdout).toContain('No results found. Try a different search term.')\n  })\n\n  test('handles API errors', async () => {\n    nock('https://www.sanity.io')\n      .get('/docs/api/search/semantic')\n      .query({query: 'test'})\n      .reply(500, 'Internal Server Error')\n\n    const {error} = await testCommand(DocsSearchCommand, ['test']).catch((err) => err)\n    expect(error.message).toBe(\n      'The documentation search API is currently unavailable. Please try again later.',\n    )\n    expect(error.oclif?.exit).toBe(1)\n  })\n\n  test('respects limit flag', async () => {\n    const searchResponse = [\n      {\n        description: 'Learn how to install Sanity Studio 1',\n        path: '/docs/studio/installation',\n        title: 'Studio Installation Guide',\n      },\n      {\n        description: 'Learn how to install Sanity Studio 2',\n        path: '/docs/studio/installation',\n        title: 'Studio Installation Guide',\n      },\n      {\n        description: 'Learn how to install Sanity Studio 3',\n        path: '/docs/studio/installation',\n        title: 'Studio Installation Guide',\n      },\n\n      {\n        description: 'Learn how to install Sanity Studio 4',\n        path: '/docs/studio/installation',\n        title: 'Studio Installation Guide',\n      },\n      {\n        description: 'Learn how to install Sanity Studio 5',\n        path: '/docs/studio/installation',\n        title: 'Studio Installation Guide',\n      },\n      {\n        description: 'Learn how to install Sanity Studio 6',\n        path: '/docs/studio/installation',\n        title: 'Studio Installation Guide',\n      },\n    ]\n\n    nock('https://www.sanity.io')\n      .get('/docs/api/search/semantic')\n      .query({query: 'studio'})\n      .reply(200, searchResponse)\n\n    const {stdout} = await testCommand(DocsSearchCommand, ['studio', '--limit=3'])\n\n    expect(stdout).toContain('Found 3 result(s):')\n    expect(stdout).toContain('1. Studio Installation Guide')\n    expect(stdout).toContain('2. Studio Installation Guide')\n    expect(stdout).toContain('3. Studio Installation Guide')\n  })\n\n  test('handles results with empty descriptions', async () => {\n    const searchResponse = [\n      {\n        description: '', // Empty description\n        path: '/docs/studio/installation',\n        title: 'Studio Installation Guide',\n      },\n      {\n        description: '', // Empty description\n        path: '/docs/schemas/overview',\n        title: 'Schema Overview',\n      },\n    ]\n\n    nock('https://www.sanity.io')\n      .get('/docs/api/search/semantic')\n      .query({query: 'studio'})\n      .reply(200, searchResponse)\n\n    const {stdout} = await testCommand(DocsSearchCommand, ['studio'])\n\n    expect(stdout).toContain('Searching documentation for: \"studio\"')\n    expect(stdout).toContain('Found 2 result(s):')\n    expect(stdout).toContain('1. Studio Installation Guide')\n    expect(stdout).toContain('URL: https://www.sanity.io/docs/studio/installation')\n    expect(stdout).toContain('2. Schema Overview')\n    // Should not show empty description lines\n    expect(stdout).not.toContain('Learn how to install')\n    expect(stdout).not.toContain('Understanding Sanity schemas')\n  })\n\n  test('shows usage hints in non-interactive mode', async () => {\n    mockedIsInteractive.mockReturnValue(false)\n\n    const searchResponse = [\n      {\n        description: 'Learn how to install Sanity Studio',\n        path: '/docs/studio/installation',\n        title: 'Studio Installation Guide',\n      },\n    ]\n\n    nock('https://www.sanity.io')\n      .get('/docs/api/search/semantic')\n      .query({query: 'studio'})\n      .reply(200, searchResponse)\n\n    const {stdout} = await testCommand(DocsSearchCommand, ['studio'])\n\n    expect(stdout).toContain('Found 1 result(s):')\n    expect(stdout).toContain('Use `sanity docs read <url>` to read an article in terminal.')\n    expect(stdout).toContain('Use `sanity docs read <path>` to follow links found within articles.')\n  })\n\n  test('handles network errors with default message', async () => {\n    nock('https://www.sanity.io')\n      .get('/docs/api/search/semantic')\n      .query({query: 'test'})\n      .reply(500, 'Internal Server Error')\n\n    const {error} = await testCommand(DocsSearchCommand, ['test']).catch((err) => err)\n    expect(error.message).toBe(\n      'The documentation search API is currently unavailable. Please try again later.',\n    )\n    expect(error.oclif?.exit).toBe(1)\n  })\n\n  test('handles interactive mode article selection', async () => {\n    mockedIsInteractive.mockReturnValue(true)\n    mockedSelect.mockResolvedValue(0)\n\n    const searchResponse = [\n      {\n        description: 'Learn how to install Sanity Studio',\n        path: '/docs/studio/installation',\n        title: 'Studio Installation Guide',\n      },\n    ]\n\n    nock('https://www.sanity.io')\n      .get('/docs/api/search/semantic')\n      .query({query: 'studio'})\n      .reply(200, searchResponse)\n\n    nock('https://www.sanity.io')\n      .get('/docs/studio/installation.md')\n      .reply(200, '# Studio Installation\\n\\nThis is how you install the studio.')\n\n    const {stdout} = await testCommand(DocsSearchCommand, ['studio'])\n\n    expect(stdout).toContain('Found 1 result(s):')\n    expect(stdout).toContain('---')\n    expect(stdout).toContain('# Studio Installation')\n    expect(stdout).toContain('This is how you install the studio.')\n  })\n\n  test('handles interactive mode exit selection', async () => {\n    mockedIsInteractive.mockReturnValue(true)\n    mockedSelect.mockResolvedValue(-1) // User selects exit option\n\n    const searchResponse = [\n      {\n        description: 'Learn how to install Sanity Studio',\n        path: '/docs/studio/installation',\n        title: 'Studio Installation Guide',\n      },\n    ]\n\n    nock('https://www.sanity.io')\n      .get('/docs/api/search/semantic')\n      .query({query: 'studio'})\n      .reply(200, searchResponse)\n\n    const {stdout} = await testCommand(DocsSearchCommand, ['studio'])\n\n    expect(stdout).toContain('Found 1 result(s):')\n    expect(stdout).not.toContain('---') // Should not show article content\n    expect(stdout).not.toContain('# Studio Installation')\n  })\n})\n"],"names":["runCommand","isInteractive","select","testCommand","nock","afterEach","describe","expect","test","vi","DocsSearchCommand","mock","actual","importActual","fn","mockedSelect","mocked","mockedIsInteractive","pending","pendingMocks","cleanAll","toEqual","resetAllMocks","stdout","toMatchInlineSnapshot","searchResponse","description","path","title","get","query","reply","toContain","error","catch","err","message","toBe","oclif","exit","not","mockReturnValue","mockResolvedValue"],"mappings":"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"}

package/dist/commands/docs/browse.d.ts

@@ -0,0 +1,6 @@
+import { Command } from '@oclif/core';
+export declare class DocsBrowseCommand extends Command {
+    static description: string;
+    static flags: {};
+    run(): Promise<void>;
+}

package/dist/commands/docs/browse.js

@@ -0,0 +1,15 @@
+import { Command } from '@oclif/core';
+import open from 'open';
+export class DocsBrowseCommand extends Command {
+    static description = 'Open Sanity docs in a web browser';
+    static flags = {};
+    async run() {
+        // Parse to ensure no invalid flags are passed
+        await this.parse(DocsBrowseCommand);
+        const url = 'https://www.sanity.io/docs';
+        this.log(`Opening ${url}`);
+        await open(url);
+    }
+}
+
+//# sourceMappingURL=browse.js.map

package/dist/commands/docs/browse.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/commands/docs/browse.ts"],"sourcesContent":["import {Command} from '@oclif/core'\nimport {type FlagInput} from '@oclif/core/interfaces'\nimport open from 'open'\n\nexport class DocsBrowseCommand extends Command {\n  static override description = 'Open Sanity docs in a web browser'\n  static override flags = {} satisfies FlagInput\n\n  public async run(): Promise<void> {\n    // Parse to ensure no invalid flags are passed\n    await this.parse(DocsBrowseCommand)\n\n    const url = 'https://www.sanity.io/docs'\n\n    this.log(`Opening ${url}`)\n    await open(url)\n  }\n}\n"],"names":["Command","open","DocsBrowseCommand","description","flags","run","parse","url","log"],"mappings":"AAAA,SAAQA,OAAO,QAAO,cAAa;AAEnC,OAAOC,UAAU,OAAM;AAEvB,OAAO,MAAMC,0BAA0BF;IACrC,OAAgBG,cAAc,oCAAmC;IACjE,OAAgBC,QAAQ,CAAC,EAAqB;IAE9C,MAAaC,MAAqB;QAChC,8CAA8C;QAC9C,MAAM,IAAI,CAACC,KAAK,CAACJ;QAEjB,MAAMK,MAAM;QAEZ,IAAI,CAACC,GAAG,CAAC,CAAC,QAAQ,EAAED,KAAK;QACzB,MAAMN,KAAKM;IACb;AACF"}

package/dist/commands/docs/read.d.ts

@@ -0,0 +1,15 @@
+import { SanityCommand } from '@sanity/cli-core';
+export declare class DocsReadCommand extends SanityCommand<typeof DocsReadCommand> {
+    static args: {
+        path: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: {
+        command: string;
+        description: string;
+    }[];
+    static flags: {
+        web: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/docs/read.js

@@ -0,0 +1,81 @@
+import { Args, Flags } from '@oclif/core';
+import { SanityCommand } from '@sanity/cli-core';
+import open from 'open';
+import { normalizeDocsPath } from '../../actions/docs/normalizeDocsPath.js';
+import { readDoc } from '../../services/docs.js';
+export class DocsReadCommand extends SanityCommand {
+    static args = {
+        path: Args.string({
+            description: 'Path or URL to article, found in search results and docs content as links',
+            required: true
+        })
+    };
+    static description = 'Read an article in terminal';
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %> /docs/studio/installation',
+            description: 'Read as markdown in terminal'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> https://www.sanity.io/docs/studio/installation',
+            description: 'Read using full URL'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> /docs/studio/installation --web',
+            description: 'Open in web browser'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> https://www.sanity.io/docs/studio/installation -w',
+            description: 'Open using full URL in web browser'
+        }
+    ];
+    static flags = {
+        web: Flags.boolean({
+            aliases: [
+                'w'
+            ],
+            description: 'Open in a web browser'
+        })
+    };
+    async run() {
+        const { args, flags } = await this.parse(DocsReadCommand);
+        const { path: input } = args;
+        const { web } = flags;
+        // Normalize URL to path
+        const path = normalizeDocsPath(input);
+        // Validate the normalized path
+        if (!path.startsWith('/')) {
+            this.error('Invalid path or URL. Expected a Sanity docs path or URL.\nExamples:\n  /docs/studio/installation\n  https://www.sanity.io/docs/studio/installation', {
+                exit: 1
+            });
+        }
+        // Enhanced validation for security and correctness
+        if (path.includes('..') || !path.startsWith('/docs/')) {
+            this.error('Invalid path. Must be a valid Sanity docs path starting with /docs/\nExample: /docs/studio/installation', {
+                exit: 1
+            });
+        }
+        // Open in web browser if --web or -w flag is provided
+        if (web) {
+            const url = `https://www.sanity.io${path}`;
+            this.log(`Opening ${url}`);
+            await open(url);
+            return;
+        }
+        // Default behavior: read as markdown in terminal
+        this.log(`Reading article: ${path}`);
+        try {
+            const content = await readDoc({
+                path
+            });
+            this.log('\n---\n');
+            this.log(content);
+        } catch (error) {
+            this.error(error instanceof Error ? error.message : 'Failed to read article', {
+                exit: 1
+            });
+        }
+    }
+}
+
+//# sourceMappingURL=read.js.map

package/dist/commands/docs/read.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/commands/docs/read.ts"],"sourcesContent":["import {Args, Flags} from '@oclif/core'\nimport {SanityCommand} from '@sanity/cli-core'\nimport open from 'open'\n\nimport {normalizeDocsPath} from '../../actions/docs/normalizeDocsPath.js'\nimport {readDoc} from '../../services/docs.js'\n\nexport class DocsReadCommand extends SanityCommand<typeof DocsReadCommand> {\n  static override args = {\n    path: Args.string({\n      description: 'Path or URL to article, found in search results and docs content as links',\n      required: true,\n    }),\n  }\n\n  static override description = 'Read an article in terminal'\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %> /docs/studio/installation',\n      description: 'Read as markdown in terminal',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> https://www.sanity.io/docs/studio/installation',\n      description: 'Read using full URL',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> /docs/studio/installation --web',\n      description: 'Open in web browser',\n    },\n    {\n      command:\n        '<%= config.bin %> <%= command.id %> https://www.sanity.io/docs/studio/installation -w',\n      description: 'Open using full URL in web browser',\n    },\n  ]\n\n  static override flags = {\n    web: Flags.boolean({\n      aliases: ['w'],\n      description: 'Open in a web browser',\n    }),\n  }\n\n  public async run(): Promise<void> {\n    const {args, flags} = await this.parse(DocsReadCommand)\n    const {path: input} = args\n    const {web} = flags\n\n    // Normalize URL to path\n    const path = normalizeDocsPath(input)\n\n    // Validate the normalized path\n    if (!path.startsWith('/')) {\n      this.error(\n        'Invalid path or URL. Expected a Sanity docs path or URL.\\nExamples:\\n  /docs/studio/installation\\n  https://www.sanity.io/docs/studio/installation',\n        {\n          exit: 1,\n        },\n      )\n    }\n\n    // Enhanced validation for security and correctness\n    if (path.includes('..') || !path.startsWith('/docs/')) {\n      this.error(\n        'Invalid path. Must be a valid Sanity docs path starting with /docs/\\nExample: /docs/studio/installation',\n        {\n          exit: 1,\n        },\n      )\n    }\n\n    // Open in web browser if --web or -w flag is provided\n    if (web) {\n      const url = `https://www.sanity.io${path}`\n      this.log(`Opening ${url}`)\n      await open(url)\n      return\n    }\n\n    // Default behavior: read as markdown in terminal\n    this.log(`Reading article: ${path}`)\n\n    try {\n      const content = await readDoc({path})\n      this.log('\\n---\\n')\n      this.log(content)\n    } catch (error) {\n      this.error(error instanceof Error ? error.message : 'Failed to read article', {\n        exit: 1,\n      })\n    }\n  }\n}\n"],"names":["Args","Flags","SanityCommand","open","normalizeDocsPath","readDoc","DocsReadCommand","args","path","string","description","required","examples","command","flags","web","boolean","aliases","run","parse","input","startsWith","error","exit","includes","url","log","content","Error","message"],"mappings":"AAAA,SAAQA,IAAI,EAAEC,KAAK,QAAO,cAAa;AACvC,SAAQC,aAAa,QAAO,mBAAkB;AAC9C,OAAOC,UAAU,OAAM;AAEvB,SAAQC,iBAAiB,QAAO,0CAAyC;AACzE,SAAQC,OAAO,QAAO,yBAAwB;AAE9C,OAAO,MAAMC,wBAAwBJ;IACnC,OAAgBK,OAAO;QACrBC,MAAMR,KAAKS,MAAM,CAAC;YAChBC,aAAa;YACbC,UAAU;QACZ;IACF,EAAC;IAED,OAAgBD,cAAc,8BAA6B;IAE3D,OAAgBE,WAAW;QACzB;YACEC,SAAS;YACTH,aAAa;QACf;QACA;YACEG,SAAS;YACTH,aAAa;QACf;QACA;YACEG,SAAS;YACTH,aAAa;QACf;QACA;YACEG,SACE;YACFH,aAAa;QACf;KACD,CAAA;IAED,OAAgBI,QAAQ;QACtBC,KAAKd,MAAMe,OAAO,CAAC;YACjBC,SAAS;gBAAC;aAAI;YACdP,aAAa;QACf;IACF,EAAC;IAED,MAAaQ,MAAqB;QAChC,MAAM,EAACX,IAAI,EAAEO,KAAK,EAAC,GAAG,MAAM,IAAI,CAACK,KAAK,CAACb;QACvC,MAAM,EAACE,MAAMY,KAAK,EAAC,GAAGb;QACtB,MAAM,EAACQ,GAAG,EAAC,GAAGD;QAEd,wBAAwB;QACxB,MAAMN,OAAOJ,kBAAkBgB;QAE/B,+BAA+B;QAC/B,IAAI,CAACZ,KAAKa,UAAU,CAAC,MAAM;YACzB,IAAI,CAACC,KAAK,CACR,sJACA;gBACEC,MAAM;YACR;QAEJ;QAEA,mDAAmD;QACnD,IAAIf,KAAKgB,QAAQ,CAAC,SAAS,CAAChB,KAAKa,UAAU,CAAC,WAAW;YACrD,IAAI,CAACC,KAAK,CACR,2GACA;gBACEC,MAAM;YACR;QAEJ;QAEA,sDAAsD;QACtD,IAAIR,KAAK;YACP,MAAMU,MAAM,CAAC,qBAAqB,EAAEjB,MAAM;YAC1C,IAAI,CAACkB,GAAG,CAAC,CAAC,QAAQ,EAAED,KAAK;YACzB,MAAMtB,KAAKsB;YACX;QACF;QAEA,iDAAiD;QACjD,IAAI,CAACC,GAAG,CAAC,CAAC,iBAAiB,EAAElB,MAAM;QAEnC,IAAI;YACF,MAAMmB,UAAU,MAAMtB,QAAQ;gBAACG;YAAI;YACnC,IAAI,CAACkB,GAAG,CAAC;YACT,IAAI,CAACA,GAAG,CAACC;QACX,EAAE,OAAOL,OAAO;YACd,IAAI,CAACA,KAAK,CAACA,iBAAiBM,QAAQN,MAAMO,OAAO,GAAG,0BAA0B;gBAC5EN,MAAM;YACR;QACF;IACF;AACF"}

package/dist/commands/docs/search.d.ts

@@ -0,0 +1,15 @@
+import { SanityCommand } from '@sanity/cli-core';
+export declare class DocsSearchCommand extends SanityCommand<typeof DocsSearchCommand> {
+    static args: {
+        query: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: {
+        command: string;
+        description: string;
+    }[];
+    static flags: {
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/docs/search.js

@@ -0,0 +1,110 @@
+import { Args, Flags } from '@oclif/core';
+import { isInteractive, SanityCommand, subdebug } from '@sanity/cli-core';
+import { chalk, select } from '@sanity/cli-core/ux';
+import { readDoc, searchDocs } from '../../services/docs.js';
+const searchDebug = subdebug('docs:search');
+export class DocsSearchCommand extends SanityCommand {
+    static args = {
+        query: Args.string({
+            description: 'Search query for documentation',
+            required: true
+        })
+    };
+    static description = 'Search Sanity docs';
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %> schema',
+            description: 'Search for documentation about schemas'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> "groq functions"',
+            description: 'Search with phrase'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> "deployment" --limit=5',
+            description: 'Limit search results'
+        }
+    ];
+    static flags = {
+        limit: Flags.integer({
+            default: 10,
+            description: 'Maximum number of results to return',
+            min: 1
+        })
+    };
+    async run() {
+        const { args, flags } = await this.parse(DocsSearchCommand);
+        const { query } = args;
+        const { limit } = flags;
+        this.log(`Searching documentation for: "${query}"`);
+        let results;
+        try {
+            results = await searchDocs({
+                limit,
+                query
+            });
+            if (results.length === 0) {
+                this.log('No results found. Try a different search term.');
+                return;
+            }
+        } catch (error) {
+            searchDebug('error fetching results', error);
+            const message = error instanceof Error ? error.message : 'The documentation search API is currently unavailable. Please try again later.';
+            this.error(message, {
+                exit: 1
+            });
+        }
+        this.log(`\nFound ${results.length} result(s):\n`);
+        for (const [index, result] of results.entries()){
+            this.log(`${index + 1}. ${result.title}`);
+            this.log(`   ${chalk.cyan(`URL: https://www.sanity.io${result.path}`)}`);
+            if (result.description) {
+                this.log(`   ${result.description}`);
+            }
+            this.log('');
+        }
+        // Show usage hint in non-interactive mode
+        if (!isInteractive()) {
+            this.log('Use `sanity docs read <url>` to read an article in terminal.');
+            this.log('Use `sanity docs read <path>` to follow links found within articles.');
+            this.log('');
+            return;
+        }
+        // Interactive selection (only in interactive environments)
+        if (results.length > 0) {
+            const choices = results.map((result, index)=>({
+                    description: result.description,
+                    name: `${index + 1}. ${result.title} (${result.path})`,
+                    value: index
+                }));
+            const selectedIndex = await select({
+                choices: [
+                    ...choices,
+                    {
+                        description: 'Exit without reading',
+                        name: 'Exit',
+                        value: -1
+                    }
+                ],
+                message: 'Select an article to read in terminal:'
+            });
+            if (typeof selectedIndex === 'number' && selectedIndex >= 0) {
+                const selected = results[selectedIndex];
+                try {
+                    // Read and display the article
+                    const content = await readDoc({
+                        path: selected.path
+                    });
+                    this.log('\n---\n');
+                    this.log(content);
+                } catch (error) {
+                    this.error(`Failed to read article: ${error instanceof Error ? error.message : 'Unknown error'}`, {
+                        exit: 1
+                    });
+                }
+            }
+        }
+    }
+}
+
+//# sourceMappingURL=search.js.map

package/dist/commands/docs/search.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/commands/docs/search.ts"],"sourcesContent":["import {Args, Flags} from '@oclif/core'\nimport {isInteractive, SanityCommand, subdebug} from '@sanity/cli-core'\nimport {chalk, select} from '@sanity/cli-core/ux'\n\nimport {readDoc, searchDocs, type SearchResult} from '../../services/docs.js'\n\nconst searchDebug = subdebug('docs:search')\n\nexport class DocsSearchCommand extends SanityCommand<typeof DocsSearchCommand> {\n  static override args = {\n    query: Args.string({\n      description: 'Search query for documentation',\n      required: true,\n    }),\n  }\n\n  static override description = 'Search Sanity docs'\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %> schema',\n      description: 'Search for documentation about schemas',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> \"groq functions\"',\n      description: 'Search with phrase',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> \"deployment\" --limit=5',\n      description: 'Limit search results',\n    },\n  ]\n\n  static override flags = {\n    limit: Flags.integer({\n      default: 10,\n      description: 'Maximum number of results to return',\n      min: 1,\n    }),\n  }\n\n  public async run(): Promise<void> {\n    const {args, flags} = await this.parse(DocsSearchCommand)\n    const {query} = args\n    const {limit} = flags\n\n    this.log(`Searching documentation for: \"${query}\"`)\n\n    let results: SearchResult[]\n    try {\n      results = await searchDocs({\n        limit,\n        query,\n      })\n\n      if (results.length === 0) {\n        this.log('No results found. Try a different search term.')\n        return\n      }\n    } catch (error) {\n      searchDebug('error fetching results', error)\n      const message =\n        error instanceof Error\n          ? error.message\n          : 'The documentation search API is currently unavailable. Please try again later.'\n      this.error(message, {\n        exit: 1,\n      })\n    }\n\n    this.log(`\\nFound ${results.length} result(s):\\n`)\n\n    for (const [index, result] of results.entries()) {\n      this.log(`${index + 1}. ${result.title}`)\n      this.log(`   ${chalk.cyan(`URL: https://www.sanity.io${result.path}`)}`)\n      if (result.description) {\n        this.log(`   ${result.description}`)\n      }\n      this.log('')\n    }\n\n    // Show usage hint in non-interactive mode\n    if (!isInteractive()) {\n      this.log('Use `sanity docs read <url>` to read an article in terminal.')\n      this.log('Use `sanity docs read <path>` to follow links found within articles.')\n      this.log('')\n      return\n    }\n\n    // Interactive selection (only in interactive environments)\n    if (results.length > 0) {\n      const choices = results.map((result, index) => ({\n        description: result.description,\n        name: `${index + 1}. ${result.title} (${result.path})`,\n        value: index,\n      }))\n\n      const selectedIndex = await select({\n        choices: [...choices, {description: 'Exit without reading', name: 'Exit', value: -1}],\n        message: 'Select an article to read in terminal:',\n      })\n\n      if (typeof selectedIndex === 'number' && selectedIndex >= 0) {\n        const selected = results[selectedIndex]\n\n        try {\n          // Read and display the article\n          const content = await readDoc({path: selected.path})\n          this.log('\\n---\\n')\n          this.log(content)\n        } catch (error) {\n          this.error(\n            `Failed to read article: ${error instanceof Error ? error.message : 'Unknown error'}`,\n            {\n              exit: 1,\n            },\n          )\n        }\n      }\n    }\n  }\n}\n"],"names":["Args","Flags","isInteractive","SanityCommand","subdebug","chalk","select","readDoc","searchDocs","searchDebug","DocsSearchCommand","args","query","string","description","required","examples","command","flags","limit","integer","default","min","run","parse","log","results","length","error","message","Error","exit","index","result","entries","title","cyan","path","choices","map","name","value","selectedIndex","selected","content"],"mappings":"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"}