@quenty/studio-bridge 0.7.1 → 0.8.0

package/dist/src/commands/disconnect.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Handler for the `disconnect` command. Signals disconnection from
+ * the active session in terminal mode.
+ */
+export interface DisconnectResult {
+    summary: string;
+}
+export declare function disconnectHandler(): DisconnectResult;
+//# sourceMappingURL=disconnect.d.ts.map

package/dist/src/commands/disconnect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disconnect.d.ts","sourceRoot":"","sources":["../../../src/commands/disconnect.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,iBAAiB,IAAI,gBAAgB,CAEpD"}

package/dist/src/commands/disconnect.js

@@ -0,0 +1,8 @@
+/**
+ * Handler for the `disconnect` command. Signals disconnection from
+ * the active session in terminal mode.
+ */
+export function disconnectHandler() {
+    return { summary: 'Disconnected from session.' };
+}
+//# sourceMappingURL=disconnect.js.map

package/dist/src/commands/disconnect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disconnect.js","sourceRoot":"","sources":["../../../src/commands/disconnect.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC;AACnD,CAAC"}

package/dist/src/commands/disconnect.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for the disconnect command handler.
+ */
+export {};
+//# sourceMappingURL=disconnect.test.d.ts.map

package/dist/src/commands/disconnect.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disconnect.test.d.ts","sourceRoot":"","sources":["../../../src/commands/disconnect.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/src/commands/disconnect.test.js

@@ -0,0 +1,17 @@
+/**
+ * Unit tests for the disconnect command handler.
+ */
+import { describe, it, expect } from 'vitest';
+import { disconnectHandler } from './disconnect.js';
+describe('disconnectHandler', () => {
+    it('returns a summary message', () => {
+        const result = disconnectHandler();
+        expect(result.summary).toBe('Disconnected from session.');
+    });
+    it('returns an object with summary field', () => {
+        const result = disconnectHandler();
+        expect(result).toHaveProperty('summary');
+        expect(typeof result.summary).toBe('string');
+    });
+});
+//# sourceMappingURL=disconnect.test.js.map

package/dist/src/commands/disconnect.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disconnect.test.js","sourceRoot":"","sources":["../../../src/commands/disconnect.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;QAEnC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;QAEnC,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,CAAC,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/commands/explorer/query/query.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `explorer query` — query the Roblox DataModel instance tree from a
+ * connected Studio session.
+ */
+import type { BridgeSession } from '../../../bridge/index.js';
+import type { DataModelInstance } from '../../../bridge/index.js';
+export type { DataModelInstance };
+export interface QueryOptions {
+    path: string;
+    children?: boolean;
+    descendants?: boolean;
+    depth?: number;
+    properties?: boolean;
+    attributes?: boolean;
+}
+export interface DataModelNode {
+    name: string;
+    className: string;
+    path: string;
+    properties?: Record<string, unknown>;
+    attributes?: Record<string, unknown>;
+    children?: DataModelNode[];
+}
+export interface QueryResult {
+    node: DataModelNode;
+    summary: string;
+}
+export declare function queryDataModelHandlerAsync(session: BridgeSession, options: QueryOptions): Promise<QueryResult>;
+export declare function formatQueryText(result: QueryResult): string;
+export declare const queryCommand: import("../../framework/define-command.js").CommandDefinition<QueryOptions, QueryResult>;
+//# sourceMappingURL=query.d.ts.map

package/dist/src/commands/explorer/query/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../../../src/commands/explorer/query/query.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAEV,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAElC,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AA+BD,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,CA8BtB;AAyBD,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAE3D;AAED,eAAO,MAAM,YAAY,0FA0BvB,CAAC"}

package/dist/src/commands/explorer/query/query.js

@@ -0,0 +1,106 @@
+/**
+ * `explorer query` — query the Roblox DataModel instance tree from a
+ * connected Studio session.
+ */
+import { defineCommand } from '../../framework/define-command.js';
+import { arg } from '../../framework/arg-builder.js';
+import { OutputHelper } from '@quenty/cli-output-helpers';
+function normalizePath(path) {
+    if (path.startsWith('game.') || path === 'game') {
+        return path;
+    }
+    return `game.${path}`;
+}
+function toDataModelNode(instance) {
+    const node = {
+        name: instance.name,
+        className: instance.className,
+        path: instance.path,
+    };
+    if (instance.properties && Object.keys(instance.properties).length > 0) {
+        node.properties = instance.properties;
+    }
+    if (instance.attributes && Object.keys(instance.attributes).length > 0) {
+        node.attributes = instance.attributes;
+    }
+    if (instance.children && instance.children.length > 0) {
+        node.children = instance.children.map(toDataModelNode);
+    }
+    return node;
+}
+export async function queryDataModelHandlerAsync(session, options) {
+    const normalizedPath = normalizePath(options.path);
+    // --depth wins when explicitly set; otherwise fall back to flag-driven defaults.
+    const depth = options.depth !== undefined
+        ? options.depth
+        : options.descendants
+            ? 10
+            : options.children
+                ? 1
+                : 0;
+    const result = await session.queryDataModelAsync({
+        path: normalizedPath,
+        depth,
+        properties: options.properties ? undefined : [],
+        includeAttributes: options.attributes,
+    });
+    if (!result.instance) {
+        throw new Error(`Instance not found at path '${options.path}'`);
+    }
+    const node = toDataModelNode(result.instance);
+    return {
+        node,
+        summary: `${node.name} (${node.className}) at ${node.path}`,
+    };
+}
+function formatNode(node, depth) {
+    const indent = '  '.repeat(depth);
+    const lines = [
+        `${indent}${node.name} (${OutputHelper.formatDim(node.className)}) ${OutputHelper.formatDim(node.path)}`,
+    ];
+    if (node.properties) {
+        for (const [key, val] of Object.entries(node.properties)) {
+            lines.push(`${indent}  ${key}: ${JSON.stringify(val)}`);
+        }
+    }
+    if (node.attributes) {
+        for (const [key, val] of Object.entries(node.attributes)) {
+            lines.push(`${indent}  @${key}: ${JSON.stringify(val)}`);
+        }
+    }
+    for (const child of node.children ?? []) {
+        lines.push(formatNode(child, depth + 1));
+    }
+    return lines.join('\n');
+}
+export function formatQueryText(result) {
+    return formatNode(result.node, 0);
+}
+export const queryCommand = defineCommand({
+    group: 'explorer',
+    name: 'query',
+    description: 'Query the Roblox DataModel instance tree',
+    category: 'execution',
+    safety: 'read',
+    scope: 'session',
+    args: {
+        path: arg.positional({
+            description: 'DataModel path (e.g. "Workspace" or "game.Workspace")',
+        }),
+        depth: arg.option({
+            description: 'Levels of descendants to include',
+            type: 'number',
+        }),
+        properties: arg.flag({ description: 'Include instance properties' }),
+        attributes: arg.flag({ description: 'Include instance attributes' }),
+        children: arg.flag({ description: 'Include direct children' }),
+        descendants: arg.flag({ description: 'Include all descendants' }),
+    },
+    cli: {
+        format: formatQueryText,
+    },
+    handler: async (session, args) => {
+        return queryDataModelHandlerAsync(session, args);
+    },
+});
+//# sourceMappingURL=query.js.map

package/dist/src/commands/explorer/query/query.js.map

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

package/dist/src/commands/explorer/query/query.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for the query command handler.
+ */
+export {};
+//# sourceMappingURL=query.test.d.ts.map

package/dist/src/commands/explorer/query/query.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.test.d.ts","sourceRoot":"","sources":["../../../../../src/commands/explorer/query/query.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/src/commands/explorer/query/query.test.js

@@ -0,0 +1,228 @@
+/**
+ * Unit tests for the query command handler.
+ */
+import { describe, it, expect, vi } from 'vitest';
+import { queryDataModelHandlerAsync } from './query.js';
+function createMockSession(dataModelResult) {
+    return {
+        queryDataModelAsync: vi.fn().mockResolvedValue(dataModelResult),
+    };
+}
+describe('queryDataModelHandlerAsync', () => {
+    it('returns node with summary', async () => {
+        const session = createMockSession({
+            instance: {
+                name: 'SpawnLocation',
+                className: 'SpawnLocation',
+                path: 'game.Workspace.SpawnLocation',
+                properties: { Anchored: true },
+                attributes: {},
+                childCount: 0,
+            },
+        });
+        const result = await queryDataModelHandlerAsync(session, {
+            path: 'Workspace.SpawnLocation',
+        });
+        expect(result.node.name).toBe('SpawnLocation');
+        expect(result.node.className).toBe('SpawnLocation');
+        expect(result.node.path).toBe('game.Workspace.SpawnLocation');
+        expect(result.summary).toContain('SpawnLocation');
+        expect(result.summary).toContain('game.Workspace.SpawnLocation');
+    });
+    it('prepends game. to path when not present', async () => {
+        const session = createMockSession({
+            instance: {
+                name: 'Workspace',
+                className: 'Workspace',
+                path: 'game.Workspace',
+                properties: {},
+                attributes: {},
+                childCount: 5,
+            },
+        });
+        await queryDataModelHandlerAsync(session, { path: 'Workspace' });
+        expect(session.queryDataModelAsync).toHaveBeenCalledWith(expect.objectContaining({ path: 'game.Workspace' }));
+    });
+    it('does not double-prepend game. when already present', async () => {
+        const session = createMockSession({
+            instance: {
+                name: 'Workspace',
+                className: 'Workspace',
+                path: 'game.Workspace',
+                properties: {},
+                attributes: {},
+                childCount: 0,
+            },
+        });
+        await queryDataModelHandlerAsync(session, { path: 'game.Workspace' });
+        expect(session.queryDataModelAsync).toHaveBeenCalledWith(expect.objectContaining({ path: 'game.Workspace' }));
+    });
+    it('passes children option as depth 1', async () => {
+        const session = createMockSession({
+            instance: {
+                name: 'Workspace',
+                className: 'Workspace',
+                path: 'game.Workspace',
+                properties: {},
+                attributes: {},
+                childCount: 2,
+                children: [
+                    {
+                        name: 'Part1',
+                        className: 'Part',
+                        path: 'game.Workspace.Part1',
+                        properties: {},
+                        attributes: {},
+                        childCount: 0,
+                    },
+                    {
+                        name: 'Part2',
+                        className: 'Part',
+                        path: 'game.Workspace.Part2',
+                        properties: {},
+                        attributes: {},
+                        childCount: 0,
+                    },
+                ],
+            },
+        });
+        const result = await queryDataModelHandlerAsync(session, {
+            path: 'Workspace',
+            children: true,
+        });
+        expect(session.queryDataModelAsync).toHaveBeenCalledWith(expect.objectContaining({ depth: 1 }));
+        expect(result.node.children).toHaveLength(2);
+        expect(result.node.children[0].name).toBe('Part1');
+        expect(result.node.children[1].name).toBe('Part2');
+    });
+    it('passes descendants option with default depth', async () => {
+        const session = createMockSession({
+            instance: {
+                name: 'Workspace',
+                className: 'Workspace',
+                path: 'game.Workspace',
+                properties: {},
+                attributes: {},
+                childCount: 0,
+            },
+        });
+        await queryDataModelHandlerAsync(session, {
+            path: 'Workspace',
+            descendants: true,
+        });
+        expect(session.queryDataModelAsync).toHaveBeenCalledWith(expect.objectContaining({ depth: 10 }));
+    });
+    it('respects explicit depth with descendants', async () => {
+        const session = createMockSession({
+            instance: {
+                name: 'Workspace',
+                className: 'Workspace',
+                path: 'game.Workspace',
+                properties: {},
+                attributes: {},
+                childCount: 0,
+            },
+        });
+        await queryDataModelHandlerAsync(session, {
+            path: 'Workspace',
+            descendants: true,
+            depth: 3,
+        });
+        expect(session.queryDataModelAsync).toHaveBeenCalledWith(expect.objectContaining({ depth: 3 }));
+    });
+    it('includes properties when requested', async () => {
+        const session = createMockSession({
+            instance: {
+                name: 'Part1',
+                className: 'Part',
+                path: 'game.Workspace.Part1',
+                properties: {
+                    Anchored: true,
+                    Position: { type: 'Vector3', value: [0, 5, 0] },
+                },
+                attributes: {},
+                childCount: 0,
+            },
+        });
+        const result = await queryDataModelHandlerAsync(session, {
+            path: 'Workspace.Part1',
+            properties: true,
+        });
+        expect(result.node.properties).toBeDefined();
+        expect(result.node.properties['Anchored']).toBe(true);
+    });
+    it('includes attributes when requested', async () => {
+        const session = createMockSession({
+            instance: {
+                name: 'Part1',
+                className: 'Part',
+                path: 'game.Workspace.Part1',
+                properties: {},
+                attributes: { health: 100, tag: 'enemy' },
+                childCount: 0,
+            },
+        });
+        const result = await queryDataModelHandlerAsync(session, {
+            path: 'Workspace.Part1',
+            attributes: true,
+        });
+        expect(result.node.attributes).toBeDefined();
+        expect(result.node.attributes['health']).toBe(100);
+        expect(result.node.attributes['tag']).toBe('enemy');
+    });
+    it('omits empty properties and attributes from node', async () => {
+        const session = createMockSession({
+            instance: {
+                name: 'Folder',
+                className: 'Folder',
+                path: 'game.Workspace.Folder',
+                properties: {},
+                attributes: {},
+                childCount: 0,
+            },
+        });
+        const result = await queryDataModelHandlerAsync(session, {
+            path: 'Workspace.Folder',
+        });
+        expect(result.node.properties).toBeUndefined();
+        expect(result.node.attributes).toBeUndefined();
+        expect(result.node.children).toBeUndefined();
+    });
+    it('propagates errors from session', async () => {
+        const session = {
+            queryDataModelAsync: vi
+                .fn()
+                .mockRejectedValue(new Error('Instance not found')),
+        };
+        await expect(queryDataModelHandlerAsync(session, { path: 'Workspace.NonExistent' })).rejects.toThrow('Instance not found');
+    });
+    it('handles path "game" as standalone', async () => {
+        const session = createMockSession({
+            instance: {
+                name: 'Game',
+                className: 'DataModel',
+                path: 'game',
+                properties: {},
+                attributes: {},
+                childCount: 10,
+            },
+        });
+        await queryDataModelHandlerAsync(session, { path: 'game' });
+        expect(session.queryDataModelAsync).toHaveBeenCalledWith(expect.objectContaining({ path: 'game' }));
+    });
+    it('without children or descendants uses depth 0', async () => {
+        const session = createMockSession({
+            instance: {
+                name: 'Workspace',
+                className: 'Workspace',
+                path: 'game.Workspace',
+                properties: {},
+                attributes: {},
+                childCount: 5,
+            },
+        });
+        await queryDataModelHandlerAsync(session, { path: 'Workspace' });
+        expect(session.queryDataModelAsync).toHaveBeenCalledWith(expect.objectContaining({ depth: 0 }));
+    });
+});
+//# sourceMappingURL=query.test.js.map

package/dist/src/commands/explorer/query/query.test.js.map

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

package/dist/src/commands/formatters.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Unit tests for per-command CLI formatters.
+ * Tests the formatResult callbacks in isolation with mock data.
+ */
+export {};
+//# sourceMappingURL=formatters.test.d.ts.map

package/dist/src/commands/formatters.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.test.d.ts","sourceRoot":"","sources":["../../../src/commands/formatters.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}