@preply/ds-ai-cli 11.1.0

package/dist/create-command.d.ts

@@ -0,0 +1,3 @@
+import { Tool } from '@preply/ds-ai-core';
+export declare function createCommand(name: string, tool: Tool<any, any>): import('commander').Command;
+//# sourceMappingURL=create-command.d.ts.map

package/dist/create-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-command.d.ts","sourceRoot":"","sources":["../src/create-command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,IAAI,EAAiB,MAAM,oBAAoB,CAAC;AAG9D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,+BAoB/D"}

package/package.json

@@ -0,0 +1,32 @@
+{
+    "name": "@preply/ds-ai-cli",
+    "description": "CLI for querying the Preply Design System",
+    "version": "11.1.0",
+    "publishConfig": {
+        "access": "public"
+    },
+    "type": "module",
+    "bin": {
+        "ds-ai": "./dist/bin.js"
+    },
+    "scripts": {
+        "clean": "rm -rf dist",
+        "check:types": "run --top-level tsc --noEmit",
+        "lint": "run --top-level eslint .",
+        "build": "vite build",
+        "dev": "vite build --watch"
+    },
+    "devDependencies": {
+        "@types/node": "^24.12.0",
+        "vite": "^8.0.0",
+        "vite-plugin-dts": "^4.5.4"
+    },
+    "dependencies": {
+        "@preply/ds-ai-core": "11.1.0",
+        "commander": "^14.0.0",
+        "zod": "^4.3.6",
+        "zod-commander": "^0.1.0",
+        "zod-opts": "^1.0.0"
+    },
+    "gitHead": "a5330f56c6c03a557b29efefcabacb41d67f4b63"
+}

package/src/__tests__/create-command.test.ts

@@ -0,0 +1,66 @@
+import { describe, expect, it, vi } from 'vitest';
+import { Command } from 'commander';
+import * as z from 'zod';
+import { createCommand } from '../create-command';
+
+vi.mock(import('@preply/ds-ai-core'), async importOriginal => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        identify: vi.fn(),
+        trackToolCall: vi.fn(),
+    };
+});
+
+function makeTool(overrides = {}) {
+    return {
+        name: 'test_tool',
+        description: 'A test tool',
+        arguments: z.object({ name: z.string() }),
+        callback: vi.fn(() => ['result line 1', 'result line 2']),
+        ...overrides,
+    };
+}
+
+describe('createCommand', () => {
+    it('creates a Commander command with correct name and description', () => {
+        const tool = makeTool();
+        const cmd = createCommand('my-cmd', tool);
+
+        expect(cmd).toBeInstanceOf(Command);
+        expect(cmd.name()).toBe('my-cmd');
+        expect(cmd.description()).toBe('A test tool');
+    });
+
+    it('invokes tool callback when action runs', async () => {
+        const tool = makeTool();
+        const cmd = createCommand('run', tool);
+
+        const parent = new Command();
+        parent.addCommand(cmd);
+        parent.exitOverride();
+
+        await parent.parseAsync(['node', 'test', 'run', 'search-query']);
+
+        expect(tool.callback).toHaveBeenCalled();
+    });
+
+    it('sets exitCode to 1 when tool callback throws', async () => {
+        const tool = makeTool({
+            callback: vi.fn(() => {
+                throw new Error('boom');
+            }),
+        });
+        const cmd = createCommand('fail', tool);
+
+        const parent = new Command();
+        parent.addCommand(cmd);
+        parent.exitOverride();
+
+        const originalExitCode = process.exitCode;
+        await parent.parseAsync(['node', 'test', 'fail', 'arg']);
+
+        expect(process.exitCode).toBe(1);
+        process.exitCode = originalExitCode;
+    });
+});

package/src/bin.ts

@@ -0,0 +1,34 @@
+import { program } from 'commander';
+import pkg from '../package.json' with { type: 'json' };
+import { tools, shutdownEventTracking, identify } from '@preply/ds-ai-core';
+import { createCommand } from './create-command';
+
+identify();
+
+// prettier-ignore
+program
+    .name(Object.keys(pkg.bin)[0])
+    .description(pkg.description)
+    .version(pkg.version, '-v, --version', 'Output the version number')
+    .usage('<command> [options]');
+
+program
+    .command('components')
+    .description('Query documentation for components')
+    .addCommand(createCommand('list', tools.listComponents))
+    .addCommand(createCommand('docs', tools.getComponentDocs));
+
+program
+    .command('icons')
+    .description('Search for icons')
+    .addCommand(createCommand('search', tools.searchIcon));
+
+program
+    .command('tokens')
+    .description('Search for tokens')
+    .addCommand(createCommand('search-by-name', tools.searchTokenByName))
+    .addCommand(createCommand('search-by-value', tools.searchTokenByValue));
+
+program.parse();
+
+await shutdownEventTracking();

package/src/create-command.ts

@@ -0,0 +1,25 @@
+import { zodCommand } from 'zod-commander';
+import { type Tool, trackToolCall } from '@preply/ds-ai-core';
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function createCommand(name: string, tool: Tool<any, any>) {
+    return zodCommand({
+        name,
+        description: tool.description,
+        args: tool.arguments?.shape,
+        opts: tool.options?.shape,
+        action: (args, opts) => {
+            try {
+                const toolArgs = {
+                    ...tool.arguments?.parse(args),
+                    ...tool.options?.parse(opts),
+                };
+                tool.callback(toolArgs).forEach(text => console.log('\n', text));
+                trackToolCall(tool.name, toolArgs, { invocationMethod: 'cli' });
+            } catch (error) {
+                console.error('An error occurred while executing the command', error);
+                process.exitCode = 1;
+            }
+        },
+    });
+}

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+    "extends": "../../tsconfig.json",
+    "include": ["src", "package.json", "vite.config.ts"],
+    "exclude": ["node_modules", "dist"],
+    "compilerOptions": {
+        "resolveJsonModule": true,
+        "module": "esnext",
+        "target": "esnext",
+        "types": ["vitest/globals", "node"]
+    }
+}

package/vite.config.ts

@@ -0,0 +1,20 @@
+import { defineConfig } from 'vite';
+import dts from 'vite-plugin-dts';
+
+export default defineConfig({
+    plugins: [dts({ exclude: ['vite.config.ts'], entryRoot: 'src' })],
+    build: {
+        target: 'esnext',
+        ssr: true,
+        lib: {
+            entry: 'src/bin.ts',
+            formats: ['es'],
+        },
+        rolldownOptions: {
+            output: {
+                entryFileNames: '[name].js',
+                banner: '#!/usr/bin/env node',
+            },
+        },
+    },
+});