@ductape/cli 0.2.22 → 0.3.0

package/src/index.ts

@@ -1,523 +0,0 @@
-#!/usr/bin/env node
-import { Command } from 'commander';
-import { readFileSync } from 'node:fs';
-import { fileURLToPath } from 'node:url';
-import path from 'node:path';
-import { runLogin } from './commands/login.js';
-import { runLogout } from './commands/logout.js';
-import { runWhoami } from './commands/whoami.js';
-import { runProfilesList, runProfilesUse } from './commands/profiles.js';
-import { runLink } from './commands/link.js';
-import { runUnlink } from './commands/unlink.js';
-import { runInit } from './commands/init.js';
-import { runInstall } from './commands/install.js';
-import { runStart, runStop, runStatus } from './commands/platform.js';
-import { runResourceCrud, runResourcesList, runEventTopicCrud, runNotificationMessageCrud } from './commands/resources.js';
-import { runCloud } from './commands/cloud.js';
-import { runDb, runDbContext } from './commands/db.js';
-import { runDbMigrate, runDbMigrateStatus, runDbMigrateRollback } from './commands/db-migrate.js';
-import { runDbSchemaGenerate, runDbSchemaPush } from './commands/db-schema.js';
-import { runGraph } from './commands/graph.js';
-import { runSecrets } from './commands/secrets.js';
-import {
-  runWorkspacesCurrent,
-  runWorkspacesList,
-  runWorkspacesRefresh,
-  runWorkspacesUse,
-} from './commands/workspaces.js';
-import { runGeneratePayload, runGenerateSnippet } from './commands/generate.js';
-import { runCompletion } from './commands/completion.js';
-import { runProducts, runProductApps, runProductComponents, runProductEnvironments } from './commands/products.js';
-import { runApps } from './commands/apps.js';
-import { runAppsImport } from './commands/apps-import.js';
-import { runApply, type ApplyType } from './commands/apply.js';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const pkg = JSON.parse(
-  readFileSync(path.join(__dirname, '../package.json'), 'utf8'),
-) as { version: string };
-
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-function wrap(fn: (...args: any[]) => void | Promise<void>) {
-  return (...args: any[]) => {
-    Promise.resolve(fn(...args)).catch((err: unknown) => {
-      console.error(err instanceof Error ? err.message : err);
-      process.exit(1);
-    });
-  };
-}
-
-const program = new Command();
-program
-  .name('ductape')
-  .description(
-    'Ductape CLI — local platform, auth, project linking, and resource CRUD via Workbench-compatible encrypted proxy',
-  )
-  .version(pkg.version);
-
-program
-  .command('login')
-  .description('Log in (email/password, OAuth token, or browser OAuth)')
-  .option('-e, --email <email>')
-  .option('-p, --password <password>')
-  .option('--token <token>', 'OAuth callback token from browser redirect URL')
-  .option('--browser [provider]', 'Open browser for Google OAuth (google|github)')
-  .option('--profile <name>', 'API profile', 'cloud')
-  .option('-w, --workspace <id>', 'Workspace index, name, or id (skips interactive picker)')
-  .option('--skip-workspace-select', 'Keep prior active workspace or default without prompting')
-  .action(
-    wrap((opts) =>
-      runLogin({
-        email: opts.email,
-        password: opts.password,
-        profile: opts.profile,
-        token: opts.token,
-        browser: opts.browser === true ? 'google' : opts.browser,
-        workspace: opts.workspace,
-        skipWorkspaceSelect: Boolean(opts.skipWorkspaceSelect),
-      }),
-    ),
-  );
-
-program.command('logout').description('Clear local credentials').action(wrap(runLogout));
-
-program
-  .command('whoami')
-  .description('Show login and linked project')
-  .option('--json', 'JSON output')
-  .action(wrap((opts) => runWhoami(Boolean(opts.json))));
-
-program
-  .command('install')
-  .description('Check Docker/Node prerequisites and prepare platform .env')
-  .action(wrap(runInstall));
-
-const profiles = program.command('profiles').description('Manage API profiles (cloud / local)');
-
-profiles
-  .command('list')
-  .option('--json', 'JSON output')
-  .action(wrap((opts) => runProfilesList(Boolean(opts.json))));
-
-profiles.command('use <name>').action(wrap((name: string) => runProfilesUse(name)));
-
-const workspaces = program
-  .command('workspaces')
-  .description('List and switch active workspace (workspace_id is stored globally at login)');
-
-workspaces
-  .command('list')
-  .description('List workspaces (marks active)')
-  .option('--profile <name>')
-  .option('--json', 'JSON output')
-  .action(wrap((opts) => runWorkspacesList({ profile: opts.profile, json: opts.json })));
-
-workspaces
-  .command('current')
-  .description('Show active workspace')
-  .option('--json', 'JSON output')
-  .action(wrap((opts) => runWorkspacesCurrent(Boolean(opts.json))));
-
-workspaces
-  .command('use [selector]')
-  .description('Switch active workspace (interactive picker). Updates linked .ductape/config.json if present')
-  .option('--profile <name>')
-  .option('-C, --dir <path>', 'Project directory to sync', process.cwd())
-  .option('--json', 'JSON output')
-  .action(wrap((selector: string | undefined, opts) => runWorkspacesUse(selector, opts)));
-
-workspaces
-  .command('switch [selector]')
-  .description('Alias for workspaces use')
-  .option('--profile <name>')
-  .option('-C, --dir <path>', 'Project directory to sync', process.cwd())
-  .option('--json', 'JSON output')
-  .action(wrap((selector: string | undefined, opts) => runWorkspacesUse(selector, opts)));
-
-workspaces
-  .command('refresh')
-  .description('Refresh workspace list from API')
-  .option('--profile <name>')
-  .option('--json', 'JSON output')
-  .action(wrap((opts) => runWorkspacesRefresh(opts)));
-
-program
-  .command('link')
-  .option('-w, --workspace <id>')
-  .option('--product <tag>')
-  .option('--env <slug>')
-  .option('--profile <name>')
-  .option('-C, --dir <path>', 'Project directory', process.cwd())
-  .action(
-    wrap((opts) =>
-      runLink({
-        workspace: opts.workspace,
-        product: opts.product,
-        env: opts.env,
-        profile: opts.profile,
-        dir: opts.dir,
-      }),
-    ),
-  );
-
-program
-  .command('unlink')
-  .option('-C, --dir <path>', 'Project directory', process.cwd())
-  .action(wrap((opts) => runUnlink({ dir: opts.dir })));
-
-program
-  .command('init')
-  .option('--link', 'Run link after init')
-  .option('-w, --workspace <id>')
-  .option('--product <tag>')
-  .option('--env <slug>')
-  .option('--language <lang>', 'typescript|python|go|dotnet')
-  .action(
-    wrap((opts) =>
-      runInit({
-        link: Boolean(opts.link),
-        workspace: opts.workspace,
-        product: opts.product,
-        env: opts.env,
-        language: opts.language,
-      }),
-    ),
-  );
-
-const APPLY_TYPES = ['sessions', 'notifications', 'events'] as const;
-
-program
-  .command('apply')
-  .description('Sync declared sessions, notifications and events to your product')
-  .argument('[type]', `${APPLY_TYPES.join(' | ')}`)
-  .option('--dry-run', 'Print what would be created/updated without applying')
-  .action(
-    wrap((type: string | undefined, opts) => {
-      if (type && !(APPLY_TYPES as readonly string[]).includes(type)) {
-        throw new Error(`Unknown type "${type}". Use: ${APPLY_TYPES.join(', ')}`);
-      }
-      return runApply(type as ApplyType | undefined, { dryRun: Boolean(opts.dryRun) });
-    }),
-  );
-
-program
-  .command('start')
-  .description('Start platform via docker compose')
-  .option('--backend-only', 'Backend without workbench UI')
-  .option('--remote', 'Workbench UI only, built against cloud API (no local Nest/Mongo/Kafka)')
-  .option('--build', 'Build images before start')
-  .action(
-    wrap((opts) =>
-      runStart({
-        backendOnly: Boolean(opts.backendOnly),
-        remote: Boolean(opts.remote),
-        build: Boolean(opts.build),
-      }),
-    ),
-  );
-
-program.command('stop').action(wrap(runStop));
-
-program.command('status').option('--json', 'JSON output').action(wrap((opts) => runStatus(Boolean(opts.json))));
-
-const products = program
-  .command('products')
-  .description('Workspace products CRUD (REST + sdk-proxy update)')
-  .argument('[verb]', 'list | get | create | update | delete')
-  .option('--profile <name>')
-  .option('--status <status>', 'Filter for list: all, active, draft, …', 'all')
-  .option('--id <id>', 'Product _id (get, delete)')
-  .option('-t, --tag <tag>', 'Product tag (get, update)')
-  .option('-f, --file <path>', 'JSON body (create, update)')
-  .option('-i, --interactive', 'Prompt for fields (default in TTY when -f omitted)')
-  .option('--no-interactive', 'Require -f JSON for create/update')
-  .option('--json', 'JSON output')
-  .action(
-    wrap((verb: string | undefined, opts) => {
-      if (!verb) throw new Error('Specify a verb: list | get | create | update | delete');
-      return runProducts(verb, opts, []);
-    }),
-  );
-
-const productApps = products.command('apps').description('Apps connected to a product');
-
-productApps
-  .command('list')
-  .option('--profile <name>')
-  .option('--product <id>', 'Product _id')
-  .option('--json', 'JSON output')
-  .action(wrap((opts) => runProductApps('list', opts, [])));
-
-const productComponents = products
-  .command('components')
-  .description('Compact, non-secret product component inventory');
-
-productComponents
-  .command('list')
-  .requiredOption('-t, --tag <tag>', 'Product tag')
-  .option('--profile <name>')
-  .option('--json', 'JSON output')
-  .action(wrap((opts) => runProductComponents('list', opts)));
-
-productComponents
-  .command('get')
-  .requiredOption('-t, --tag <tag>', 'Product tag')
-  .requiredOption('--type <type>', 'Component type, e.g. notifications or events')
-  .option('--profile <name>')
-  .option('--json', 'JSON output')
-  .action(wrap((opts) => runProductComponents('get', opts)));
-
-const productEnvironments = products
-  .command('environments')
-  .description('Product environments (list, get)');
-
-productEnvironments
-  .command('list [product_tag]')
-  .description('List all environments for a product')
-  .option('--product <tag>', 'Product tag (defaults to linked project)')
-  .option('--json', 'JSON output')
-  .action(wrap((productTagArg: string | undefined, opts) =>
-    runProductEnvironments('list', { product: opts.product ?? productTagArg, json: opts.json }, []),
-  ));
-
-productEnvironments
-  .command('get <product_tag> [slug]')
-  .description('Fetch a single product environment by slug')
-  .option('--slug <slug>', 'Environment slug')
-  .option('--json', 'JSON output')
-  .action(wrap((productTagArg: string, slugArg: string | undefined, opts) =>
-    runProductEnvironments('get', { product: productTagArg, slug: opts.slug ?? slugArg, json: opts.json }, []),
-  ));
-
-const apps = program
-  .command('apps')
-  .description('Workspace integration apps CRUD (REST)')
-  .argument('[verb]', 'list | get | create | update | delete')
-  .option('--profile <name>')
-  .option('--status <status>', 'Filter for list', 'all')
-  .option('--id <id>', 'App _id')
-  .option('-t, --tag <tag>', 'App tag (get; update with --proxy)')
-  .option('--proxy', 'Update via sdk-proxy (use with --tag)')
-  .option('-f, --file <path>', 'JSON body')
-  .option('-i, --interactive', 'Prompt for fields (default in TTY when -f omitted)')
-  .option('--no-interactive', 'Require -f JSON for create/update')
-  .option('--json', 'JSON output')
-  .action(
-    wrap((verb: string | undefined, opts) => {
-      if (!verb) throw new Error('Specify a verb: list | get | create | update | delete');
-      return runApps(verb, opts, []);
-    }),
-  );
-
-apps
-  .command('import <file>')
-  .description('Import Postman v2.1 or OpenAPI 3.0 into a new or existing app')
-  .requiredOption(
-    '-t, --type <format>',
-    'postman | openapi (Postman Collection v2.1 or OpenAPI 3.0)',
-  )
-  .option('--profile <name>')
-  .option('--app-id <id>', 'Update existing app by _id')
-  .option('--app-tag <tag>', 'Update existing app by tag')
-  .option('--update', 'Replace/update if app already exists')
-  .option('--version <tag>', 'App version tag', '0.0.1')
-  .option('--json', 'JSON output')
-  .action(
-    wrap((file: string, opts) =>
-      runAppsImport(file, {
-        profile: opts.profile,
-        type: opts.type,
-        appId: opts.appId,
-        appTag: opts.appTag,
-        update: Boolean(opts.update),
-        version: opts.version,
-        json: opts.json,
-      }),
-    ),
-  );
-
-const events = program.command('events').description('Message broker CRUD (sdk-proxy, requires access key login)');
-
-const eventTopics = events.command('topics').description('Topic CRUD for a message broker');
-
-eventTopics
-  .argument('<verb>', 'list | get | create | update | delete')
-  .option('-t, --tag <tag>', 'Broker tag (list) or topic tag in broker:topic form (get, update, delete)')
-  .option('-f, --file <path>', 'JSON body (create, update)')
-  .option('-i, --interactive', 'Prompt for fields (default in TTY when -f omitted)')
-  .option('--no-interactive', 'Require -f JSON for create/update')
-  .option('--json', 'JSON output')
-  .action(wrap((verb: string, opts) => runEventTopicCrud(verb, opts, [])));
-
-const resources = program.command('resources').description('Component CRUD (sdk-proxy)');
-
-const notificationMessages = program.command('notifications').description('Notification templates');
-notificationMessages
-  .command('messages <verb>')
-  .option('-t, --tag <tag>', 'Full notification:message tag')
-  .option('-n, --notification <tag>', 'Notification tag for list')
-  .option('-f, --file <path>', 'JSON template body for create/update')
-  .option('--json', 'JSON output')
-  .action(wrap((verb: string, opts) => runNotificationMessageCrud(verb, opts)));
-
-resources.command('types').option('--json', 'JSON output').action(wrap((opts) => runResourcesList(Boolean(opts.json))));
-
-resources
-  .argument('<type>', 'Resource type (e.g. storage, database, cache …)')
-  .argument('<verb>', 'list | get | create | update | delete | connect')
-  .option('-t, --tag <tag>')
-  .option('-f, --file <path>', 'JSON body (or use interactive prompts)')
-  .option('-i, --interactive', 'Prompt for fields (default in TTY when -f omitted)')
-  .option('--no-interactive', 'Require -f JSON for create/update/connect')
-  .option('--json', 'JSON output')
-  .action(
-    wrap((type: string, verb: string, opts) => runResourceCrud(type, verb, opts, [])),
-  );
-
-const cloud = program.command('cloud').description('Cloud connections & resources');
-
-cloud
-  .command('connections <verb> [id]')
-  .option('-f, --file <path>')
-  .option('--json', 'JSON output')
-  .action(
-    wrap((verb: string, id: string | undefined, opts) =>
-      runCloud('connections', verb, { id, file: opts.file, json: opts.json }, []),
-    ),
-  );
-
-cloud
-  .command('resources <verb>')
-  .option('-f, --file <path>')
-  .option('--tier <name>', 'Tier name from `cloud tiers list` (e.g. db.t3.micro, Standard_B1ms, M0)')
-  .option('--json', 'JSON output')
-  .action(wrap((verb: string, opts) => runCloud('resources', verb, { file: opts.file, tier: opts.tier, json: opts.json }, [])));
-
-cloud
-  .command('tiers')
-  .description('List available cloud resource tiers and estimated costs')
-  .option('--provider <name>', 'Filter by provider: aws, gcp, azure, mongodb_atlas, neo4j_aura')
-  .option('--type <resource_type>', 'Filter by resource type: database, storage, graph')
-  .option('--db-type <db_type>', 'Filter by database type: postgresql, mysql, mongodb, dynamodb, neo4j')
-  .option('--json', 'JSON output')
-  .action(wrap((opts) => runCloud('tiers', 'list', { provider: opts.provider, type: opts.type, dbType: opts.dbType, json: opts.json }, [])));
-
-const db = program.command('db').description('Database runtime (db-proxy)');
-
-db.command('context').option('--json', 'JSON output').action(wrap((opts) => runDbContext(Boolean(opts.json))));
-
-const dbMigrate = db
-  .command('migrate')
-  .description('Run pending migrations from ductape/database/migrations/')
-  .option('--env <tag>', 'Override environment slug')
-  .option('--db <tag>', 'Limit to one db entry from schema.json')
-  .option('--dry-run', 'Print what would run without applying')
-  .action(wrap((opts) => runDbMigrate({ env: opts.env, db: opts.db, dryRun: Boolean(opts.dryRun) })));
-
-dbMigrate
-  .command('status')
-  .description('Show applied vs pending migrations')
-  .option('--env <tag>', 'Override environment slug')
-  .option('--db <tag>', 'Limit to one db entry')
-  .option('--json', 'JSON output')
-  .action(wrap((opts) => runDbMigrateStatus({ env: opts.env, db: opts.db, json: Boolean(opts.json) })));
-
-dbMigrate
-  .command('rollback')
-  .description('Roll back the last N migrations')
-  .option('--env <tag>', 'Override environment slug')
-  .option('--db <tag>', 'Limit to one db entry')
-  .option('-n <count>', 'Number of migrations to roll back', '1')
-  .action(wrap((opts) => runDbMigrateRollback({ env: opts.env, db: opts.db, n: Number(opts.n) })));
-
-const dbSchema = db.command('schema').description('Schema management for ductape/database/schema.json');
-
-dbSchema
-  .command('generate')
-  .description('Diff schema.json vs applied migrations and write new migration files')
-  .option('--db <tag>', 'Limit to one db entry from schema.json')
-  .option('--destructive', 'Also generate drop migrations for removed fields/tables')
-  .action(wrap((opts) => runDbSchemaGenerate({ db: opts.db, destructive: Boolean(opts.destructive) })));
-
-dbSchema
-  .command('push')
-  .description('Read live table schema from the database and sync it to the Ductape server (enables AI field guidance)')
-  .requiredOption('--db <tag>', 'Database tag to sync')
-  .requiredOption('--env <slug>', 'Environment slug (e.g. snd, prd) whose live database to read from')
-  .action(wrap((opts) => runDbSchemaPush({ db: opts.db, env: opts.env })));
-
-db
-  .argument('[verb]', 'connect | query | …')
-  .option('-f, --file <path>')
-  .option('--json', 'JSON output')
-  .action(
-    wrap((verb: string | undefined, opts) => {
-      if (!verb) throw new Error('Specify a verb: connect | query');
-      return runDb(verb, { file: opts.file, json: opts.json });
-    }),
-  );
-
-const graph = program.command('graph').description('Graph runtime (graph-proxy)');
-
-graph
-  .argument('<verb>', 'connect | query | …')
-  .option('-f, --file <path>')
-  .option('--json', 'JSON output')
-  .action(wrap((verb: string, opts) => runGraph(verb, { file: opts.file, json: opts.json })));
-
-program
-  .command('secrets <verb>')
-  .description('Workspace secrets CRUD')
-  .option('-k, --key <key>')
-  .option('-f, --file <path>')
-  .option('-i, --interactive', 'Prompt for fields (default in TTY when -f omitted)')
-  .option('--no-interactive', 'Require -f JSON for create/update')
-  .option('--json', 'JSON output')
-  .action(
-    wrap((verb: string, opts) =>
-      runSecrets(verb, opts),
-    ),
-  );
-
-const generate = program.command('generate').description('Payload templates & code snippets');
-
-generate
-  .command('payload <family> <method>')
-  .option('-f, --file <path>', 'targets JSON')
-  .option('--json', 'JSON output')
-  .action(
-    wrap((family: string, method: string, opts) =>
-      runGeneratePayload({ family, method, file: opts.file, json: opts.json }),
-    ),
-  );
-
-generate
-  .command('snippet <family> <method>')
-  .requiredOption('-l, --language <lang>', 'typescript|python|go|dotnet')
-  .option('-f, --file <path>')
-  .option('-o, --out <path>', 'Write snippet to file')
-  .option('--json', 'JSON output')
-  .action(
-    wrap((family: string, method: string, opts) =>
-      runGenerateSnippet({
-        family,
-        method,
-        language: opts.language,
-        file: opts.file,
-        json: opts.json,
-        out: opts.out,
-      }),
-    ),
-  );
-
-program
-  .command('completion <shell>')
-  .description('Print shell completions (bash|zsh)')
-  .action(wrap((shell: string) => {
-    if (shell !== 'bash' && shell !== 'zsh' && shell !== 'fish') {
-      throw new Error('Shell must be bash, zsh, or fish');
-    }
-    runCompletion(shell);
-  }));
-
-program.parse();

package/src/lib/api-client.ts

@@ -1,88 +0,0 @@
-import type { Credentials } from './config.js';
-import { getApiUrl } from './config.js';
-
-export interface ApiEnvelope<T> {
-  status?: boolean;
-  data?: T;
-  message?: string;
-}
-
-export class ApiClient {
-  constructor(
-    private readonly apiUrl: string,
-    private readonly token?: string,
-  ) {}
-
-  static forProfile(profileName?: string, creds?: Credentials | null): ApiClient {
-    return new ApiClient(getApiUrl(profileName), creds?.auth_token);
-  }
-
-  async request<T>(
-    method: string,
-    path: string,
-    body?: unknown,
-    extraHeaders?: Record<string, string>,
-  ): Promise<T> {
-    const url = `${this.apiUrl}${path.startsWith('/') ? path : `/${path}`}`;
-    const headers: Record<string, string> = {
-      'Content-Type': 'application/json',
-      ...extraHeaders,
-    };
-    if (this.token) {
-      headers.Authorization = `Bearer ${this.token}`;
-    }
-
-    const res = await fetch(url, {
-      method,
-      headers,
-      body: body !== undefined ? JSON.stringify(body) : undefined,
-    });
-
-    const text = await res.text();
-    let parsed: ApiEnvelope<T> & T;
-    try {
-      parsed = text ? JSON.parse(text) : {};
-    } catch {
-      throw new Error(`Invalid JSON from ${url}: ${text.slice(0, 200)}`);
-    }
-
-    if (!res.ok) {
-      const msg =
-        (parsed as ApiEnvelope<T>).message ??
-        (parsed as { error?: string }).error ??
-        `HTTP ${res.status}`;
-      throw new Error(msg);
-    }
-
-    if (typeof (parsed as ApiEnvelope<T>).status === 'boolean' && !(parsed as ApiEnvelope<T>).status) {
-      throw new Error((parsed as ApiEnvelope<T>).message ?? 'Request failed');
-    }
-
-    const data = (parsed as ApiEnvelope<{ result?: T }>).data;
-    if (data && typeof data === 'object' && 'result' in data) {
-      return (data as { result: T }).result;
-    }
-    return (data ?? parsed) as T;
-  }
-
-  post<T>(path: string, body?: unknown, headers?: Record<string, string>): Promise<T> {
-    return this.request<T>('POST', path, body, headers);
-  }
-
-  put<T>(path: string, body?: unknown, headers?: Record<string, string>): Promise<T> {
-    return this.request<T>('PUT', path, body, headers);
-  }
-
-  delete<T>(path: string, headers?: Record<string, string>): Promise<T> {
-    return this.request<T>('DELETE', path, undefined, headers);
-  }
-
-  get<T>(path: string, headers?: Record<string, string>): Promise<T> {
-    return this.request<T>('GET', path, undefined, headers);
-  }
-
-  getPath<T>(path: string, query?: Record<string, string>): Promise<T> {
-    const qs = query ? `?${new URLSearchParams(query).toString()}` : '';
-    return this.get<T>(`${path}${qs}`);
-  }
-}

package/src/lib/app-import.ts

@@ -1,82 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import type { WorkspaceContext } from './workspace-context.js';
-
-/** Values accepted by POST /apps/v1/import `type` field */
-export const IMPORT_DOC_TYPES = {
-  postman: 'PostmanV2.1',
-  openapi: 'OpenApiV3.0',
-} as const;
-
-export type ImportFormat = keyof typeof IMPORT_DOC_TYPES;
-
-export function parseImportFormat(value: string): ImportFormat {
-  const v = value.toLowerCase().replace(/[_\s]/g, '');
-  if (v === 'postman' || v === 'postmanv21' || v === 'postman2.1' || v === 'postmanv2.1') {
-    return 'postman';
-  }
-  if (v === 'openapi' || v === 'openapiv30' || v === 'openapi3.0' || v === 'openapi3') {
-    return 'openapi';
-  }
-  throw new Error(
-    `Unknown import type "${value}". Use: postman (Postman Collection v2.1) or openapi (OpenAPI 3.0)`,
-  );
-}
-
-function uploadFilename(filePath: string): string {
-  const base = path.basename(filePath);
-  if (base.endsWith('.yaml') || base.endsWith('.yml')) return base;
-  if (base.endsWith('.json')) return base;
-  return `${base}.json`;
-}
-
-export async function importAppFromFile(
-  ctx: WorkspaceContext,
-  opts: {
-    filePath: string;
-    format: ImportFormat;
-    appId?: string;
-    update?: boolean;
-    version?: string;
-  },
-): Promise<unknown> {
-  const abs = path.resolve(opts.filePath);
-  if (!fs.existsSync(abs)) throw new Error(`File not found: ${abs}`);
-
-  const buffer = fs.readFileSync(abs);
-  const filename = uploadFilename(abs);
-  const form = new FormData();
-
-  form.append('file', new Blob([buffer]), filename);
-  form.append('workspace_id', ctx.workspaceId);
-  form.append('public_key', ctx.credentials.public_key);
-  form.append('user_id', ctx.credentials.user_id);
-  form.append('type', IMPORT_DOC_TYPES[opts.format]);
-  form.append('version', opts.version ?? '0.0.1');
-  form.append('update', opts.update ? 'true' : 'false');
-  if (opts.appId) form.append('app_id', opts.appId);
-
-  const url = `${ctx.apiUrl}/apps/v1/import`;
-  const res = await fetch(url, {
-    method: 'POST',
-    headers: { Authorization: `Bearer ${ctx.credentials.auth_token}` },
-    body: form,
-  });
-
-  const text = await res.text();
-  let parsed: { status?: boolean; data?: unknown; message?: string };
-  try {
-    parsed = text ? JSON.parse(text) : {};
-  } catch {
-    throw new Error(`Invalid JSON from import API: ${text.slice(0, 200)}`);
-  }
-
-  if (!res.ok) {
-    throw new Error(parsed.message ?? `Import failed (HTTP ${res.status})`);
-  }
-  if (parsed.status === false) {
-    throw new Error(parsed.message ?? 'Import failed');
-  }
-
-  return parsed.data ?? parsed;
-}