@kryshtop/bstack 1.0.0

package/dist/cli/runCli.js

@@ -0,0 +1,31 @@
+import { asError } from '../utils/errors.js';
+import { CommandRuntime } from './context.js';
+import { createProgram } from './program.js';
+export async function runCli(argv = process.argv) {
+    const { config } = await import('dotenv');
+    config({ quiet: true });
+    const runtime = new CommandRuntime({
+        json: argv.includes('--json'),
+        debugHttp: argv.includes('--debug-http'),
+        verbose: argv.includes('--verbose'),
+        allowPlainStorage: argv.includes('--allow-plain-storage'),
+        masterKey: getOptionValue(argv, '--master-key'),
+        baseUrl: getOptionValue(argv, '--base-url'),
+    });
+    const program = createProgram(runtime);
+    try {
+        await program.parseAsync(argv);
+    }
+    catch (error) {
+        runtime.output.error(asError(error).message);
+        process.exitCode = 1;
+    }
+}
+function getOptionValue(argv, flag) {
+    const index = argv.indexOf(flag);
+    if (index === -1) {
+        return undefined;
+    }
+    return argv[index + 1];
+}
+//# sourceMappingURL=runCli.js.map

package/dist/cli/runCli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runCli.js","sourceRoot":"","sources":["../../src/cli/runCli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI;IAC9C,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAExB,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC;QACjC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC7B,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;QACxC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;QACnC,iBAAiB,EAAE,IAAI,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QACzD,SAAS,EAAE,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC;QAC/C,OAAO,EAAE,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC;KAC5C,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IAEvC,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC;QAC7C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,IAAc,EAAE,IAAY;IAClD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACjB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;AACzB,CAAC"}

package/dist/commands/auth.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+import type { CommandRuntime } from '../cli/context.js';
+export declare function createAuthCommands(runtime: CommandRuntime): Command;

package/dist/commands/auth.js

@@ -0,0 +1,73 @@
+import { Command } from 'commander';
+import { promptForLogin } from '../prompts/authPrompts.js';
+export function createAuthCommands(runtime) {
+    const auth = new Command('auth').description('Authentication and session management');
+    auth
+        .command('login')
+        .description('Login with BrowserStack username and access key')
+        .option('-u, --username <username>', 'BrowserStack username')
+        .option('-k, --access-key <accessKey>', 'BrowserStack access key')
+        .option('--storage <strategy>', 'Storage strategy: auto, keychain, encrypted-file, plain-file', 'auto')
+        .option('--master-key <masterKey>', 'Master key for encrypted-file storage')
+        .option('--allow-plain-storage', 'Allow plain-text session storage')
+        .action(async (options) => {
+        const prompted = !options.username || !options.accessKey ? await promptForLogin() : undefined;
+        const spinner = runtime.spinner('Validating BrowserStack credentials');
+        try {
+            const status = await runtime.auth.login({
+                username: options.username ?? prompted?.username,
+                accessKey: options.accessKey ?? prompted?.accessKey,
+                storageStrategy: options.storage ?? prompted?.storageStrategy ?? 'auto',
+                masterKey: options.masterKey ?? runtime.options.masterKey ?? prompted?.masterKey,
+                allowPlainText: Boolean(options.allowPlainStorage) ||
+                    runtime.options.allowPlainStorage === true ||
+                    prompted?.allowPlainText === true,
+            });
+            spinner.succeed('Credentials validated and saved');
+            runtime.output.emit(status);
+        }
+        catch (error) {
+            spinner.fail(error instanceof Error ? error.message : String(error));
+            throw error;
+        }
+    });
+    auth
+        .command('logout')
+        .description('Clear the saved BrowserStack session')
+        .action(async () => {
+        await runtime.auth.logout();
+        runtime.output.success('Saved session removed.');
+    });
+    auth
+        .command('status')
+        .description('Show saved session status')
+        .action(async () => {
+        const status = await runtime.auth.status();
+        runtime.output.emit(status);
+    });
+    auth
+        .command('validate')
+        .description('Validate the saved credentials against BrowserStack')
+        .action(async () => {
+        const session = await runtime.requireSession();
+        const status = await runtime.auth.validate(session);
+        await runtime.saveLastResponse({
+            command: 'auth validate',
+            framework: 'auth',
+            resource: 'auth',
+            operation: 'validate',
+            payload: status,
+        });
+        runtime.output.emit(status);
+    });
+    auth
+        .command('whoami')
+        .description('Alias for auth validate')
+        .action(async () => {
+        const session = await runtime.requireSession();
+        const status = await runtime.auth.validate(session);
+        runtime.output.emit(status);
+    });
+    return auth;
+}
+//# sourceMappingURL=auth.js.map

package/dist/commands/auth.js.map

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

package/dist/commands/explorer.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+import type { CommandRuntime } from '../cli/context.js';
+export declare function createExplorerCommand(runtime: CommandRuntime): Command;

package/dist/commands/explorer.js

@@ -0,0 +1,86 @@
+import { select, input } from '@inquirer/prompts';
+import { Command } from 'commander';
+export function createExplorerCommand(runtime) {
+    return new Command('explorer')
+        .description('Interactive raw endpoint explorer backed by the endpoint registry')
+        .action(async () => {
+        const service = await runtime.getResourceService();
+        const registry = service.getRegistry();
+        const definitions = registry.list().filter((definition) => definition.framework !== 'auth');
+        const framework = await select({
+            message: 'Framework',
+            choices: unique(definitions.map((definition) => definition.framework)).map((value) => ({
+                name: value,
+                value,
+            })),
+        });
+        const resource = await select({
+            message: 'Resource',
+            choices: unique(definitions
+                .filter((definition) => definition.framework === framework)
+                .map((definition) => definition.resource)).map((value) => ({ name: value, value })),
+        });
+        const operation = await select({
+            message: 'Operation',
+            choices: definitions
+                .filter((definition) => definition.framework === framework && definition.resource === resource)
+                .map((definition) => ({
+                name: `${definition.operation} (${definition.method} ${definition.pathTemplate})`,
+                value: definition.operation,
+            })),
+        });
+        const definition = registry.find(framework, resource, operation);
+        const pathParams = Object.fromEntries(await Promise.all((definition.pathParams ?? []).map(async (param) => [
+            param,
+            await input({ message: `Path param ${param}` }),
+        ])));
+        const query = Object.fromEntries(await Promise.all((definition.queryParams ?? []).map(async (param) => [
+            param,
+            await input({ message: `Query param ${param} (optional)` }),
+        ])));
+        let body;
+        let filePath;
+        let url;
+        if (definition.requestKind === 'json' && ['run', 'update-status'].includes(operation)) {
+            const raw = await input({ message: 'JSON body', default: '{}' });
+            body = JSON.parse(raw);
+        }
+        if (definition.requestKind === 'multipart') {
+            const source = await select({
+                message: 'Upload source',
+                choices: [
+                    { name: 'Local file', value: 'file' },
+                    { name: 'Public URL', value: 'url' },
+                ],
+            });
+            if (source === 'file') {
+                filePath = await input({ message: 'File path' });
+            }
+            else {
+                url = await input({ message: 'Public URL' });
+            }
+        }
+        const response = await service.execute({
+            framework,
+            resource,
+            operation,
+            pathParams,
+            query,
+            body,
+            filePath,
+            url,
+        });
+        await runtime.saveLastResponse({
+            command: 'explorer',
+            framework,
+            resource,
+            operation,
+            payload: response,
+        });
+        runtime.output.emit(response);
+    });
+}
+function unique(items) {
+    return [...new Set(items)];
+}
+//# sourceMappingURL=explorer.js.map

package/dist/commands/explorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explorer.js","sourceRoot":"","sources":["../../src/commands/explorer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,MAAM,UAAU,qBAAqB,CAAC,OAAuB;IAC3D,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;SAC3B,WAAW,CAAC,mEAAmE,CAAC;SAChF,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,kBAAkB,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC;QAE5F,MAAM,SAAS,GAAG,MAAM,MAAM,CAAe;YAC3C,OAAO,EAAE,WAAW;YACpB,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACrF,IAAI,EAAE,KAAK;gBACX,KAAK;aACN,CAAC,CAAC;SACJ,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAc;YACzC,OAAO,EAAE,UAAU;YACnB,OAAO,EAAE,MAAM,CACb,WAAW;iBACR,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,SAAS,KAAK,SAAS,CAAC;iBAC1D,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAC5C,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;SAC3C,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,MAAM,MAAM,CAAe;YAC3C,OAAO,EAAE,WAAW;YACpB,OAAO,EAAE,WAAW;iBACjB,MAAM,CACL,CAAC,UAAU,EAAE,EAAE,CACb,UAAU,CAAC,SAAS,KAAK,SAAS,IAAI,UAAU,CAAC,QAAQ,KAAK,QAAQ,CACzE;iBACA,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;gBACpB,IAAI,EAAE,GAAG,UAAU,CAAC,SAAS,KAAK,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,YAAY,GAAG;gBACjF,KAAK,EAAE,UAAU,CAAC,SAAS;aAC5B,CAAC,CAAC;SACN,CAAC,CAAC;QAEH,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QACjE,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CACnC,MAAM,OAAO,CAAC,GAAG,CACf,CAAC,UAAU,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC;YACjD,KAAK;YACL,MAAM,KAAK,CAAC,EAAE,OAAO,EAAE,cAAc,KAAK,EAAE,EAAE,CAAC;SAChD,CAAC,CACH,CACF,CAAC;QAEF,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAC9B,MAAM,OAAO,CAAC,GAAG,CACf,CAAC,UAAU,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC;YAClD,KAAK;YACL,MAAM,KAAK,CAAC,EAAE,OAAO,EAAE,eAAe,KAAK,aAAa,EAAE,CAAC;SAC5D,CAAC,CACH,CACF,CAAC;QAEF,IAAI,IAAa,CAAC;QAClB,IAAI,QAA4B,CAAC;QACjC,IAAI,GAAuB,CAAC;QAE5B,IAAI,UAAU,CAAC,WAAW,KAAK,MAAM,IAAI,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACtF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YACjE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;QACpC,CAAC;QAED,IAAI,UAAU,CAAC,WAAW,KAAK,WAAW,EAAE,CAAC;YAC3C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAiB;gBAC1C,OAAO,EAAE,eAAe;gBACxB,OAAO,EAAE;oBACP,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE;oBACrC,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE;iBACrC;aACF,CAAC,CAAC;YAEH,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;gBACtB,QAAQ,GAAG,MAAM,KAAK,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YACnD,CAAC;iBAAM,CAAC;gBACN,GAAG,GAAG,MAAM,KAAK,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC;YACrC,SAAS;YACT,QAAQ;YACR,SAAS;YACT,UAAU;YACV,KAAK;YACL,IAAI;YACJ,QAAQ;YACR,GAAG;SACJ,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,gBAAgB,CAAC;YAC7B,OAAO,EAAE,UAAU;YACnB,SAAS;YACT,QAAQ;YACR,SAAS;YACT,OAAO,EAAE,QAAQ;SAClB,CAAC,CAAC;QAEH,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,MAAM,CAAI,KAAU;IAC3B,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7B,CAAC"}

package/dist/commands/framework.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+import type { CommandRuntime } from '../cli/context.js';
+export declare function createFrameworkCommands(runtime: CommandRuntime): Command[];