@fias/plugin-dev-harness 1.1.0

package/dist/bridge/mock-handler.test.js

@@ -0,0 +1,322 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const mock_handler_1 = require("./mock-handler");
+const theme_1 = require("../mocks/theme");
+describe('bridge/MockBridgeHandler', () => {
+    const defaultOptions = {
+        mockUser: {
+            userId: 'test_user_001',
+            displayName: 'Test User',
+            avatar: null,
+        },
+        mockTheme: 'dark',
+    };
+    let handler;
+    beforeEach(() => {
+        jest.useFakeTimers();
+        handler = new mock_handler_1.MockBridgeHandler({ ...defaultOptions });
+    });
+    afterEach(() => {
+        jest.useRealTimers();
+    });
+    describe('get_user', () => {
+        it('returns the configured mock user', async () => {
+            const result = await handler.handle({ type: 'get_user', payload: {} });
+            expect(result).toEqual({
+                userId: 'test_user_001',
+                displayName: 'Test User',
+                avatar: null,
+            });
+        });
+        it('returns mock user with custom avatar', async () => {
+            const customHandler = new mock_handler_1.MockBridgeHandler({
+                ...defaultOptions,
+                mockUser: {
+                    userId: 'user_2',
+                    displayName: 'Another User',
+                    avatar: 'https://example.com/avatar.png',
+                },
+            });
+            const result = await customHandler.handle({ type: 'get_user', payload: {} });
+            expect(result).toEqual({
+                userId: 'user_2',
+                displayName: 'Another User',
+                avatar: 'https://example.com/avatar.png',
+            });
+        });
+    });
+    describe('get_theme', () => {
+        it('returns dark theme when mockTheme is dark', async () => {
+            const result = await handler.handle({ type: 'get_theme', payload: {} });
+            expect(result).toEqual(theme_1.DARK_THEME);
+        });
+        it('returns light theme when mockTheme is light', async () => {
+            const lightHandler = new mock_handler_1.MockBridgeHandler({
+                ...defaultOptions,
+                mockTheme: 'light',
+            });
+            const result = await lightHandler.handle({ type: 'get_theme', payload: {} });
+            expect(result).toEqual(theme_1.LIGHT_THEME);
+        });
+    });
+    describe('entity_invoke', () => {
+        it('returns mock response with default delay', async () => {
+            const promise = handler.handle({
+                type: 'entity_invoke',
+                payload: { entityId: 'entity_test', input: 'hello world' },
+            });
+            // Advance past the default 1000ms delay
+            jest.advanceTimersByTime(1000);
+            const result = (await promise);
+            expect(result.output).toContain('[Mock]');
+            expect(result.output).toContain('entity_test');
+            expect(result.output).toContain('hello world');
+            expect(result.metadata).toEqual({
+                entityId: 'entity_test',
+                tokensUsed: 0,
+                cost: 0,
+            });
+        });
+        it('throws when entityId is missing', async () => {
+            await expect(handler.handle({
+                type: 'entity_invoke',
+                payload: { input: 'hello' },
+            })).rejects.toThrow('entityId and input are required');
+        });
+        it('throws when input is missing', async () => {
+            await expect(handler.handle({
+                type: 'entity_invoke',
+                payload: { entityId: 'entity_test' },
+            })).rejects.toThrow('entityId and input are required');
+        });
+        it('throws when both entityId and input are missing', async () => {
+            await expect(handler.handle({
+                type: 'entity_invoke',
+                payload: {},
+            })).rejects.toThrow('entityId and input are required');
+        });
+        it('uses custom mock entity response when configured', async () => {
+            const customHandler = new mock_handler_1.MockBridgeHandler({
+                ...defaultOptions,
+                mockEntities: {
+                    entity_summarize: {
+                        response: 'Custom summary result',
+                        delay: 500,
+                    },
+                },
+            });
+            const promise = customHandler.handle({
+                type: 'entity_invoke',
+                payload: { entityId: 'entity_summarize', input: 'some text' },
+            });
+            jest.advanceTimersByTime(500);
+            const result = (await promise);
+            expect(result.output).toBe('Custom summary result');
+            expect(result.metadata.entityId).toBe('entity_summarize');
+        });
+        it('uses default delay of 1000 when custom mock has no delay specified', async () => {
+            const customHandler = new mock_handler_1.MockBridgeHandler({
+                ...defaultOptions,
+                mockEntities: {
+                    entity_no_delay: {
+                        response: 'Response without delay config',
+                    },
+                },
+            });
+            const promise = customHandler.handle({
+                type: 'entity_invoke',
+                payload: { entityId: 'entity_no_delay', input: 'test' },
+            });
+            // Should not resolve before 1000ms
+            jest.advanceTimersByTime(999);
+            // The promise should still be pending
+            jest.advanceTimersByTime(1);
+            const result = (await promise);
+            expect(result.output).toBe('Response without delay config');
+        });
+        it('falls back to default mock when entityId not in custom mocks', async () => {
+            const customHandler = new mock_handler_1.MockBridgeHandler({
+                ...defaultOptions,
+                mockEntities: {
+                    entity_summarize: { response: 'Summary' },
+                },
+            });
+            const promise = customHandler.handle({
+                type: 'entity_invoke',
+                payload: { entityId: 'entity_other', input: 'hello' },
+            });
+            jest.advanceTimersByTime(1000);
+            const result = (await promise);
+            expect(result.output).toContain('[Mock]');
+            expect(result.output).toContain('entity_other');
+        });
+    });
+    describe('storage_write and storage_read', () => {
+        it('writes and reads back content', async () => {
+            await handler.handle({
+                type: 'storage_write',
+                payload: { path: 'test.txt', content: 'Hello World' },
+            });
+            const result = (await handler.handle({
+                type: 'storage_read',
+                payload: { path: 'test.txt' },
+            }));
+            expect(result.exists).toBe(true);
+            expect(result.content).toBe('Hello World');
+            expect(result.sizeBytes).toBe(Buffer.byteLength('Hello World'));
+        });
+        it('returns success and s3Key on write', async () => {
+            const result = (await handler.handle({
+                type: 'storage_write',
+                payload: { path: 'data/file.json', content: '{"key":"value"}' },
+            }));
+            expect(result.success).toBe(true);
+            expect(result.s3Key).toBe('mock/data/file.json');
+        });
+        it('throws when path is missing on write', async () => {
+            await expect(handler.handle({
+                type: 'storage_write',
+                payload: { content: 'data' },
+            })).rejects.toThrow('path is required');
+        });
+        it('throws when content is missing on write (undefined)', async () => {
+            await expect(handler.handle({
+                type: 'storage_write',
+                payload: { path: 'test.txt' },
+            })).rejects.toThrow('content is required');
+        });
+        it('allows writing empty string as content', async () => {
+            const writeResult = (await handler.handle({
+                type: 'storage_write',
+                payload: { path: 'empty.txt', content: '' },
+            }));
+            expect(writeResult.success).toBe(true);
+            const readResult = (await handler.handle({
+                type: 'storage_read',
+                payload: { path: 'empty.txt' },
+            }));
+            expect(readResult.exists).toBe(true);
+            expect(readResult.content).toBe('');
+        });
+    });
+    describe('storage_read', () => {
+        it('returns content: null and exists: false for nonexistent file', async () => {
+            const result = (await handler.handle({
+                type: 'storage_read',
+                payload: { path: 'nonexistent.txt' },
+            }));
+            expect(result.content).toBeNull();
+            expect(result.exists).toBe(false);
+        });
+        it('throws when path is missing', async () => {
+            await expect(handler.handle({
+                type: 'storage_read',
+                payload: {},
+            })).rejects.toThrow('path is required');
+        });
+    });
+    describe('storage_list', () => {
+        it('returns all stored keys when no prefix given', async () => {
+            await handler.handle({
+                type: 'storage_write',
+                payload: { path: 'a.txt', content: 'a' },
+            });
+            await handler.handle({
+                type: 'storage_write',
+                payload: { path: 'b.txt', content: 'b' },
+            });
+            await handler.handle({
+                type: 'storage_write',
+                payload: { path: 'dir/c.txt', content: 'c' },
+            });
+            const result = (await handler.handle({
+                type: 'storage_list',
+                payload: {},
+            }));
+            expect(result.files).toHaveLength(3);
+            expect(result.files).toContain('a.txt');
+            expect(result.files).toContain('b.txt');
+            expect(result.files).toContain('dir/c.txt');
+        });
+        it('filters by prefix', async () => {
+            await handler.handle({
+                type: 'storage_write',
+                payload: { path: 'images/photo.png', content: 'img1' },
+            });
+            await handler.handle({
+                type: 'storage_write',
+                payload: { path: 'images/avatar.png', content: 'img2' },
+            });
+            await handler.handle({
+                type: 'storage_write',
+                payload: { path: 'docs/readme.md', content: 'doc' },
+            });
+            const result = (await handler.handle({
+                type: 'storage_list',
+                payload: { prefix: 'images/' },
+            }));
+            expect(result.files).toHaveLength(2);
+            expect(result.files).toContain('images/photo.png');
+            expect(result.files).toContain('images/avatar.png');
+        });
+        it('returns empty array when no files match prefix', async () => {
+            await handler.handle({
+                type: 'storage_write',
+                payload: { path: 'data.txt', content: 'data' },
+            });
+            const result = (await handler.handle({
+                type: 'storage_list',
+                payload: { prefix: 'nope/' },
+            }));
+            expect(result.files).toHaveLength(0);
+        });
+        it('returns empty array when storage is empty', async () => {
+            const result = (await handler.handle({
+                type: 'storage_list',
+                payload: {},
+            }));
+            expect(result.files).toHaveLength(0);
+        });
+    });
+    describe('storage_delete', () => {
+        it('removes a stored file', async () => {
+            await handler.handle({
+                type: 'storage_write',
+                payload: { path: 'to-delete.txt', content: 'bye' },
+            });
+            const deleteResult = (await handler.handle({
+                type: 'storage_delete',
+                payload: { path: 'to-delete.txt' },
+            }));
+            expect(deleteResult.success).toBe(true);
+            const readResult = (await handler.handle({
+                type: 'storage_read',
+                payload: { path: 'to-delete.txt' },
+            }));
+            expect(readResult.exists).toBe(false);
+            expect(readResult.content).toBeNull();
+        });
+        it('succeeds even if file does not exist (no-op delete)', async () => {
+            const result = (await handler.handle({
+                type: 'storage_delete',
+                payload: { path: 'nonexistent.txt' },
+            }));
+            expect(result.success).toBe(true);
+        });
+        it('throws when path is missing', async () => {
+            await expect(handler.handle({
+                type: 'storage_delete',
+                payload: {},
+            })).rejects.toThrow('path is required');
+        });
+    });
+    describe('unknown type', () => {
+        it('throws error for unknown bridge call type', async () => {
+            await expect(handler.handle({
+                type: 'unknown_operation',
+                payload: {},
+            })).rejects.toThrow('Unknown bridge call type: unknown_operation');
+        });
+    });
+});
+//# sourceMappingURL=mock-handler.test.js.map

package/dist/bridge/mock-handler.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-handler.test.js","sourceRoot":"","sources":["../../src/bridge/mock-handler.test.ts"],"names":[],"mappings":"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"}

package/dist/bridge/types.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Bridge Handler Types
+ *
+ * Shared interface for mock and live bridge handlers.
+ */
+export interface BridgeRequest {
+    type: string;
+    payload: Record<string, unknown>;
+}
+export interface BridgeResponse {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+}
+export interface BridgeHandler {
+    handle(request: BridgeRequest): Promise<unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/bridge/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/bridge/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAClD"}

package/dist/bridge/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Bridge Handler Types
+ *
+ * Shared interface for mock and live bridge handlers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/bridge/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/bridge/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/cli/dev.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `fias-dev` Command — Start the dev harness server
+ *
+ * Launches an Express server that serves the harness host page,
+ * which embeds the plugin iframe and handles bridge communication.
+ *
+ * Usage:
+ *   npx fias-dev                     # Mock mode (default)
+ *   npx fias-dev --live              # Live mode (real AI, costs credits)
+ *   npx fias-dev --port 3200         # Custom port
+ *   npx fias-dev --plugin-url http://localhost:3100
+ */
+import { Command } from 'commander';
+export declare function registerDevCommand(program: Command): void;
+//# sourceMappingURL=dev.d.ts.map

package/dist/cli/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/cli/dev.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkDzD"}

package/dist/cli/dev.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * `fias-dev` Command — Start the dev harness server
+ *
+ * Launches an Express server that serves the harness host page,
+ * which embeds the plugin iframe and handles bridge communication.
+ *
+ * Usage:
+ *   npx fias-dev                     # Mock mode (default)
+ *   npx fias-dev --live              # Live mode (real AI, costs credits)
+ *   npx fias-dev --port 3200         # Custom port
+ *   npx fias-dev --plugin-url http://localhost:3100
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDevCommand = registerDevCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const config_loader_1 = require("../config/config-loader");
+const credentials_1 = require("../config/credentials");
+const harness_server_1 = require("../server/harness-server");
+function registerDevCommand(program) {
+    program
+        .command('dev', { isDefault: true })
+        .description('Start the dev harness server')
+        .option('--live', 'Enable live mode (real AI, costs credits)', false)
+        .option('--port <port>', 'Harness server port', '3200')
+        .option('--plugin-url <url>', 'Plugin dev server URL')
+        .action(async (options) => {
+        const config = (0, config_loader_1.loadConfig)();
+        const port = parseInt(options.port, 10) || config.port;
+        const pluginUrl = options.pluginUrl || config.pluginUrl;
+        const isLive = options.live;
+        if (isLive) {
+            const credentials = (0, credentials_1.loadCredentials)();
+            if (!credentials.apiKey) {
+                console.error(chalk_1.default.red('No API key found. Run `fias-dev login` first to save your API key.'));
+                process.exit(1);
+            }
+        }
+        const credentials = isLive ? (0, credentials_1.loadCredentials)() : { apiKey: '' };
+        console.log(chalk_1.default.bold('\n  FIAS Plugin Dev Harness\n'));
+        console.log(`  Mode:       ${isLive ? chalk_1.default.yellow('LIVE (credits will be used)') : chalk_1.default.green('MOCK (free, offline)')}`);
+        console.log(`  Plugin:     ${chalk_1.default.cyan(pluginUrl)}`);
+        console.log(`  Harness:    ${chalk_1.default.cyan(`http://localhost:${port}`)}`);
+        if (isLive) {
+            console.log(`  API:        ${chalk_1.default.dim(config.apiUrl)}`);
+        }
+        console.log('');
+        await (0, harness_server_1.startHarnessServer)({
+            port,
+            pluginUrl,
+            isLive,
+            apiKey: credentials.apiKey,
+            apiUrl: config.apiUrl,
+            permissions: config.permissions,
+            mockUser: config.mockUser,
+            mockTheme: config.mockTheme,
+            mockEntities: config.mockEntities,
+        });
+    });
+}
+//# sourceMappingURL=dev.js.map

package/dist/cli/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../src/cli/dev.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;;;AAQH,gDAkDC;AAvDD,kDAA0B;AAC1B,2DAAqD;AACrD,uDAAwD;AACxD,6DAA8D;AAE9D,SAAgB,kBAAkB,CAAC,OAAgB;IACjD,OAAO;SACJ,OAAO,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;SACnC,WAAW,CAAC,8BAA8B,CAAC;SAC3C,MAAM,CAAC,QAAQ,EAAE,2CAA2C,EAAE,KAAK,CAAC;SACpE,MAAM,CAAC,eAAe,EAAE,qBAAqB,EAAE,MAAM,CAAC;SACtD,MAAM,CAAC,oBAAoB,EAAE,uBAAuB,CAAC;SACrD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,MAAM,GAAG,IAAA,0BAAU,GAAE,CAAC;QAE5B,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC;QACvD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC;QACxD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;QAE5B,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,WAAW,GAAG,IAAA,6BAAe,GAAE,CAAC;YACtC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;gBACxB,OAAO,CAAC,KAAK,CACX,eAAK,CAAC,GAAG,CAAC,oEAAoE,CAAC,CAChF,CAAC;gBACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,IAAA,6BAAe,GAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAEhE,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CACT,iBAAiB,MAAM,CAAC,CAAC,CAAC,eAAK,CAAC,MAAM,CAAC,6BAA6B,CAAC,CAAC,CAAC,CAAC,eAAK,CAAC,KAAK,CAAC,sBAAsB,CAAC,EAAE,CAC9G,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,iBAAiB,eAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,iBAAiB,eAAK,CAAC,IAAI,CAAC,oBAAoB,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QAEvE,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,GAAG,CAAC,iBAAiB,eAAK,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,MAAM,IAAA,mCAAkB,EAAC;YACvB,IAAI;YACJ,SAAS;YACT,MAAM;YACN,MAAM,EAAE,WAAW,CAAC,MAAM;YAC1B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,YAAY,EAAE,MAAM,CAAC,YAAY;SAClC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/dev.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dev.test.d.ts.map

package/dist/cli/dev.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.test.d.ts","sourceRoot":"","sources":["../../src/cli/dev.test.ts"],"names":[],"mappings":""}

package/dist/cli/dev.test.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+jest.mock('../config/config-loader', () => ({
+    loadConfig: jest.fn(),
+}));
+jest.mock('../config/credentials', () => ({
+    loadCredentials: jest.fn(),
+}));
+jest.mock('../server/harness-server', () => ({
+    startHarnessServer: jest.fn(),
+}));
+const commander_1 = require("commander");
+const dev_1 = require("./dev");
+const config_loader_1 = require("../config/config-loader");
+const credentials_1 = require("../config/credentials");
+const harness_server_1 = require("../server/harness-server");
+const mockedLoadConfig = jest.mocked(config_loader_1.loadConfig);
+const mockedLoadCredentials = jest.mocked(credentials_1.loadCredentials);
+const mockedStartHarnessServer = jest.mocked(harness_server_1.startHarnessServer);
+describe('cli/dev', () => {
+    let program;
+    let mockExit;
+    let consoleSpy;
+    let consoleErrorSpy;
+    const defaultConfig = {
+        pluginUrl: 'http://localhost:3100',
+        port: 3200,
+        permissions: ['theme:read', 'entities:invoke'],
+        mockUser: { userId: 'dev_user_001', displayName: 'Dev User', avatar: null },
+        mockTheme: 'light',
+        apiUrl: 'https://api.fias.app/v1',
+    };
+    beforeEach(() => {
+        jest.clearAllMocks();
+        program = new commander_1.Command();
+        program.exitOverride();
+        (0, dev_1.registerDevCommand)(program);
+        mockExit = jest.spyOn(process, 'exit').mockImplementation(((code) => {
+            throw new Error(`process.exit(${code})`);
+        }));
+        consoleSpy = jest.spyOn(console, 'log').mockImplementation(() => { });
+        consoleErrorSpy = jest.spyOn(console, 'error').mockImplementation(() => { });
+        mockedLoadConfig.mockReturnValue({ ...defaultConfig });
+        mockedLoadCredentials.mockReturnValue({ apiKey: '' });
+        mockedStartHarnessServer.mockResolvedValue();
+    });
+    afterEach(() => {
+        mockExit.mockRestore();
+        consoleSpy.mockRestore();
+        consoleErrorSpy.mockRestore();
+    });
+    it('starts harness server in mock mode by default', async () => {
+        await program.parseAsync(['dev'], { from: 'user' });
+        expect(mockedStartHarnessServer).toHaveBeenCalledWith(expect.objectContaining({
+            port: 3200,
+            pluginUrl: 'http://localhost:3100',
+            isLive: false,
+            apiKey: '',
+        }));
+    });
+    it('starts harness server with custom port', async () => {
+        await program.parseAsync(['dev', '--port', '4000'], { from: 'user' });
+        expect(mockedStartHarnessServer).toHaveBeenCalledWith(expect.objectContaining({
+            port: 4000,
+        }));
+    });
+    it('starts harness server with custom plugin URL', async () => {
+        await program.parseAsync(['dev', '--plugin-url', 'http://localhost:5555'], {
+            from: 'user',
+        });
+        expect(mockedStartHarnessServer).toHaveBeenCalledWith(expect.objectContaining({
+            pluginUrl: 'http://localhost:5555',
+        }));
+    });
+    it('exits with error in live mode when no API key is saved', async () => {
+        mockedLoadCredentials.mockReturnValue({ apiKey: '' });
+        await expect(program.parseAsync(['dev', '--live'], { from: 'user' })).rejects.toThrow('process.exit(1)');
+        expect(consoleErrorSpy).toHaveBeenCalledWith(expect.stringContaining('No API key found'));
+        expect(mockedStartHarnessServer).not.toHaveBeenCalled();
+    });
+    it('starts harness server in live mode with API key', async () => {
+        mockedLoadCredentials.mockReturnValue({ apiKey: 'fias_sk_live_key' });
+        await program.parseAsync(['dev', '--live'], { from: 'user' });
+        expect(mockedStartHarnessServer).toHaveBeenCalledWith(expect.objectContaining({
+            isLive: true,
+            apiKey: 'fias_sk_live_key',
+        }));
+    });
+    it('logs live mode info', async () => {
+        mockedLoadCredentials.mockReturnValue({ apiKey: 'fias_sk_live_key' });
+        await program.parseAsync(['dev', '--live'], { from: 'user' });
+        const allLogs = consoleSpy.mock.calls.map((c) => c[0]).join('\n');
+        expect(allLogs).toContain('LIVE');
+    });
+    it('passes config properties to harness server', async () => {
+        mockedLoadConfig.mockReturnValue({
+            ...defaultConfig,
+            permissions: ['theme:read', 'storage:sandbox'],
+            mockTheme: 'dark',
+            mockEntities: {
+                entity_custom: { response: 'Custom', delay: 100 },
+            },
+        });
+        await program.parseAsync(['dev'], { from: 'user' });
+        expect(mockedStartHarnessServer).toHaveBeenCalledWith(expect.objectContaining({
+            permissions: ['theme:read', 'storage:sandbox'],
+            mockTheme: 'dark',
+            mockEntities: {
+                entity_custom: { response: 'Custom', delay: 100 },
+            },
+        }));
+    });
+});
+//# sourceMappingURL=dev.test.js.map

package/dist/cli/dev.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.test.js","sourceRoot":"","sources":["../../src/cli/dev.test.ts"],"names":[],"mappings":"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"}

package/dist/cli/entities.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `fias-dev entities` Command — Browse available entities
+ *
+ * Lists entities available for invocation from plugins,
+ * fetched from the FIAS production API.
+ */
+import { Command } from 'commander';
+export declare function registerEntitiesCommand(program: Command): void;
+//# sourceMappingURL=entities.d.ts.map

package/dist/cli/entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../src/cli/entities.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuE9D"}