@slates/cli 1.0.0-rc.10

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@slates/cli",
+  "version": "1.0.0-rc.10",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "src/**",
+    "dist/**",
+    "README.md",
+    "package.json"
+  ],
+  "author": "Tobias Herber",
+  "license": "FSL 1.1",
+  "type": "module",
+  "source": "src/cli.ts",
+  "bin": "./src/cli.ts",
+  "exports": {
+    "default": "./src/cli.ts"
+  },
+  "scripts": {
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit",
+    "biome:check": "biome check --write src"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.4.0",
+    "@slates/client": "1.0.0-rc.12",
+    "@slates/oauth-microsoft": "1.0.0-rc.5",
+    "@slates/profiles": "1.0.0-rc.10",
+    "sade": "^1.8.1"
+  },
+  "devDependencies": {
+    "@slates/tsconfig": "1.0.0-rc.1",
+    "typescript": "5.8.2",
+    "vitest": "^3.1.2"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,291 @@
+#!/usr/bin/env bun
+
+import sade from 'sade';
+import {
+  addOAuthCredentials,
+  addProfile,
+  callTool,
+  getAuth,
+  getConfig,
+  getConfigSchema,
+  getProfile,
+  getTool,
+  listAuth,
+  listOAuthCredentials,
+  listProfiles,
+  listTools,
+  refreshAuth,
+  removeProfile,
+  runAllIntegrationTests,
+  runVitestWithProfile,
+  setConfig,
+  setupAuth,
+  setupIntegration,
+  startRepl,
+  useProfile
+} from './commands';
+
+let printResult = async (cb: () => Promise<unknown>) => {
+  try {
+    let result = await cb();
+    if (result !== undefined) {
+      console.log(JSON.stringify(result, null, 2));
+    }
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+};
+
+let cli = sade('slates');
+let argv = process.argv.slice(2);
+let isGlobalTestCommand = argv[0] === 'test';
+let integration = isGlobalTestCommand ? null : argv[0];
+
+if (!isGlobalTestCommand && (!integration || integration.startsWith('-'))) {
+  console.error('Usage: slates <integration> <command>\n       slates test');
+  process.exit(1);
+}
+
+if (isGlobalTestCommand) {
+  cli.command('test').action(() =>
+    printResult(async () => {
+      let separatorIndex = process.argv.indexOf('--');
+      return runAllIntegrationTests({
+        vitestArgs: separatorIndex === -1 ? [] : process.argv.slice(separatorIndex + 1)
+      });
+    })
+  );
+
+  cli.parse([process.argv[0] ?? 'bun', process.argv[1] ?? 'slates', ...argv]);
+} else {
+  cli
+    .command('profiles add')
+    .option('--name', 'Profile name')
+    .option('--entry', 'Local slate entry file')
+    .option('--export-name', 'Named export for the local slate provider')
+    .option('--default', 'Use this profile as the default')
+    .action(opts =>
+      printResult(() =>
+        addProfile({
+          integration: integration!,
+          name: opts.name,
+          entry: opts.entry,
+          exportName: opts.exportName,
+          useAsDefault: Boolean(opts.default)
+        })
+      )
+    );
+
+  cli
+    .command('profiles list')
+    .action(() => printResult(() => listProfiles({ integration: integration! })));
+
+  cli
+    .command('profiles get [profile]')
+    .action((profile: string | undefined) =>
+      printResult(() => getProfile({ integration: integration!, profile }))
+    );
+
+  cli
+    .command('profiles use [profile]')
+    .action((profile: string | undefined) =>
+      printResult(() => useProfile({ integration: integration!, profile }))
+    );
+
+  cli
+    .command('profiles remove [profile]')
+    .action((profile: string | undefined) =>
+      printResult(() => removeProfile({ integration: integration!, profile }))
+    );
+
+  cli
+    .command('setup')
+    .option('--name', 'Profile name')
+    .option('--export-name', 'Named export for the local slate provider')
+    .action(opts =>
+      printResult(() =>
+        setupIntegration({
+          integration: integration!,
+          name: opts.name,
+          exportName: opts.exportName
+        })
+      )
+    );
+
+  cli
+    .command('tools list')
+    .option('--profile', 'Profile ID or name')
+    .action(opts =>
+      printResult(() =>
+        listTools({
+          integration: integration!,
+          profile: opts.profile
+        })
+      )
+    );
+
+  cli
+    .command('tools get [toolId]')
+    .option('--profile', 'Profile ID or name')
+    .action((toolId: string | undefined, opts) =>
+      printResult(() =>
+        getTool({
+          integration: integration!,
+          profile: opts.profile,
+          toolId
+        })
+      )
+    );
+
+  cli
+    .command('tools schema [toolId]')
+    .option('--profile', 'Profile ID or name')
+    .action((toolId: string | undefined, opts) =>
+      printResult(async () => {
+        let tool = await getTool({
+          integration: integration!,
+          profile: opts.profile,
+          toolId
+        });
+        return tool.inputSchema;
+      })
+    );
+
+  cli
+    .command('tools call [toolId]')
+    .option('--profile', 'Profile ID or name')
+    .option('--input', 'JSON input object')
+    .option('--auth-method-id', 'Preferred auth method ID')
+    .action((toolId: string | undefined, opts) =>
+      printResult(() =>
+        callTool({
+          integration: integration!,
+          profile: opts.profile,
+          toolId,
+          input: opts.input,
+          authMethodId: opts.authMethodId
+        })
+      )
+    );
+
+  cli
+    .command('auth list')
+    .option('--profile', 'Profile ID or name')
+    .action(opts =>
+      printResult(() => listAuth({ integration: integration!, profile: opts.profile }))
+    );
+
+  cli
+    .command('auth get [authMethodId]')
+    .option('--profile', 'Profile ID or name')
+    .action((authMethodId: string | undefined, opts) =>
+      printResult(() =>
+        getAuth({ integration: integration!, profile: opts.profile, authMethodId })
+      )
+    );
+
+  cli
+    .command('auth setup [authMethodId]')
+    .option('--profile', 'Profile ID or name')
+    .option('--input', 'JSON auth input object')
+    .option('--oauth-credential', 'OAuth credential ID or name')
+    .option('--client-id', 'OAuth client ID')
+    .option('--client-secret', 'OAuth client secret')
+    .option('--scopes', 'Comma-separated OAuth scopes')
+    .action((authMethodId: string | undefined, opts) =>
+      printResult(() =>
+        setupAuth({
+          integration: integration!,
+          profile: opts.profile,
+          authMethodId,
+          input: opts.input,
+          oauthCredential: opts.oauthCredential,
+          clientId: opts.clientId,
+          clientSecret: opts.clientSecret,
+          scopes: opts.scopes
+        })
+      )
+    );
+
+  cli
+    .command('auth credentials list [authMethodId]')
+    .action((authMethodId: string | undefined) =>
+      printResult(() => listOAuthCredentials({ integration: integration!, authMethodId }))
+    );
+
+  cli
+    .command('auth credentials add [authMethodId]')
+    .option('--name', 'Credential name')
+    .option('--client-id', 'OAuth client ID')
+    .option('--client-secret', 'OAuth client secret')
+    .action((authMethodId: string | undefined, opts) =>
+      printResult(() =>
+        addOAuthCredentials({
+          integration: integration!,
+          authMethodId,
+          name: opts.name,
+          clientId: opts.clientId,
+          clientSecret: opts.clientSecret
+        })
+      )
+    );
+
+  cli
+    .command('auth refresh [authMethodId]')
+    .option('--profile', 'Profile ID or name')
+    .action((authMethodId: string | undefined, opts) =>
+      printResult(() =>
+        refreshAuth({ integration: integration!, profile: opts.profile, authMethodId })
+      )
+    );
+
+  cli
+    .command('config get')
+    .option('--profile', 'Profile ID or name')
+    .action(opts =>
+      printResult(() => getConfig({ integration: integration!, profile: opts.profile }))
+    );
+
+  cli
+    .command('config set')
+    .option('--profile', 'Profile ID or name')
+    .option('--input', 'JSON config object')
+    .action(opts =>
+      printResult(() =>
+        setConfig({ integration: integration!, profile: opts.profile, input: opts.input })
+      )
+    );
+
+  cli
+    .command('config schema')
+    .option('--profile', 'Profile ID or name')
+    .action(opts =>
+      printResult(() => getConfigSchema({ integration: integration!, profile: opts.profile }))
+    );
+
+  cli
+    .command('test')
+    .option('--profile', 'Profile ID or name')
+    .action(opts =>
+      printResult(async () => {
+        let separatorIndex = process.argv.indexOf('--');
+        await runVitestWithProfile({
+          integration: integration!,
+          profile: opts.profile,
+          vitestArgs: separatorIndex === -1 ? [] : process.argv.slice(separatorIndex + 1)
+        });
+
+        return { success: true };
+      })
+    );
+
+  cli
+    .command('repl')
+    .option('--profile', 'Profile ID or name')
+    .action(opts =>
+      printResult(() => startRepl({ integration: integration!, profile: opts.profile }))
+    );
+
+  cli.parse([process.argv[0] ?? 'bun', process.argv[1] ?? 'slates', ...argv.slice(1)]);
+}

package/src/commands/auth.test.ts

@@ -0,0 +1,60 @@
+import { describe, expect, it } from 'vitest';
+import { normalizeCallbackRedirectUriForIntegration } from './auth';
+
+describe('normalizeCallbackRedirectUriForIntegration', () => {
+  it('normalizes Notion loopback redirects to localhost', () => {
+    expect(
+      normalizeCallbackRedirectUriForIntegration('notion', 'http://127.0.0.1:45873/callback')
+    ).toBe('http://localhost:45873/callback');
+  });
+
+  it('normalizes Intercom loopback redirects to localhost', () => {
+    expect(
+      normalizeCallbackRedirectUriForIntegration('intercom', 'http://127.0.0.1:45873/callback')
+    ).toBe('http://localhost:45873/callback');
+  });
+
+  it('normalizes Typeform loopback redirects to localhost', () => {
+    expect(
+      normalizeCallbackRedirectUriForIntegration('typeform', 'http://127.0.0.1:45873/callback')
+    ).toBe('http://localhost:45873/callback');
+  });
+
+  it('normalizes Xero loopback redirects to localhost', () => {
+    expect(
+      normalizeCallbackRedirectUriForIntegration('xero', 'http://127.0.0.1:45873/callback')
+    ).toBe('http://localhost:45873/callback');
+  });
+
+  it('normalizes Zendesk loopback redirects to localhost', () => {
+    expect(
+      normalizeCallbackRedirectUriForIntegration('zendesk', 'http://127.0.0.1:45873/callback')
+    ).toBe('http://localhost:45873/callback');
+  });
+
+  it('leaves unrelated integration redirects unchanged', () => {
+    expect(
+      normalizeCallbackRedirectUriForIntegration('attio', 'http://127.0.0.1:45873/callback')
+    ).toBe('http://127.0.0.1:45873/callback');
+  });
+
+  it('normalizes HubSpot developer platform OAuth redirects to localhost', () => {
+    expect(
+      normalizeCallbackRedirectUriForIntegration(
+        'hubspot',
+        'http://127.0.0.1:45873/callback',
+        'developer_platform_oauth'
+      )
+    ).toBe('http://localhost:45873/callback');
+  });
+
+  it('leaves HubSpot legacy OAuth redirects unchanged', () => {
+    expect(
+      normalizeCallbackRedirectUriForIntegration(
+        'hubspot',
+        'http://127.0.0.1:45873/callback',
+        'oauth'
+      )
+    ).toBe('http://127.0.0.1:45873/callback');
+  });
+});