@syncular/cli 0.0.0-108 → 0.0.0-113

package/src/help.tsx

@@ -1,239 +0,0 @@
-import process from 'node:process';
-import { Box, renderToString, Text } from 'ink';
-import type { ReactElement } from 'react';
-import { listBuildpackIds } from './buildpacks';
-import { USAGE_LINES } from './command-registry';
-import { CLI_NAME, CLI_VERSION } from './constants';
-import { listTemplateIds } from './templates';
-
-interface HelpSection {
-  title: string;
-  lines: string[];
-}
-
-const TEMPLATE_ID_LIST = listTemplateIds().join('|');
-const DEFAULT_BUILDPACK_ID = listBuildpackIds()[0] ?? 'contract-worker';
-
-const HELP_SECTIONS: HelpSection[] = [
-  {
-    title: 'Auth Flags',
-    lines: [
-      '--control-plane <url>       Control plane base URL',
-      '--token <jwt>               Clerk CLI JWT token',
-      '--token-stdin               Read token from stdin',
-      '--json                      whoami/create-space: print JSON output',
-      '--callback-host <host>      Browser callback host for login (default: 127.0.0.1)',
-      '--callback-port <port>      Browser callback port for login (default: random)',
-      '--auth-url <url>            Browser auth bridge URL (default: <control-plane>/cli-login)',
-      '--timeout-seconds <n>       Login browser wait timeout (default: 180)',
-    ],
-  },
-  {
-    title: 'Create Space Flags',
-    lines: [
-      '--name <name>               Space name',
-      '--database-provider <id>    sqlite|neon|postgres (default: sqlite)',
-      '--connection-string <url>   Required when database-provider is neon/postgres',
-      '--region <id>               auto|enam|wnam|weur|eeur|apac|oc (default: auto)',
-      '--json                      Print response as JSON (console token redacted)',
-    ],
-  },
-  {
-    title: 'Create Flags',
-    lines: [
-      `--template <id>             Template id: ${TEMPLATE_ID_LIST}`,
-      '--dir <path>                Scaffold target directory (template-specific default)',
-      '--name <name>               Project display/name override (spaces-app only)',
-      '--targets <csv>             syncular-libraries targets (server,react,vanilla,expo,react-native,electron,proxy-api)',
-      '--server-dialect <id>       syncular-libraries server dialect sqlite|postgres',
-      '--react-dialect <id>        syncular-libraries react dialect wa-sqlite|pglite|bun-sqlite|better-sqlite3|sqlite3',
-      '--vanilla-dialect <id>      syncular-libraries vanilla dialect wa-sqlite|pglite|bun-sqlite|better-sqlite3|sqlite3',
-      '--electron-dialect <id>     syncular-libraries electron dialect electron-sqlite|better-sqlite3',
-      '--force <true|false>        Overwrite scaffold files (default: false)',
-    ],
-  },
-  {
-    title: 'Dev Flags',
-    lines: [
-      '--host <host>               Bind host (default: 127.0.0.1)',
-      '--port <port>               Bind port (default: 4312)',
-      '--db-provider <kind>        Local DB provider sqlite|neon|postgres',
-      '--db <path>                 Local sqlite db path override',
-      '--connection-string <url>   Local Postgres/Neon connection string override',
-      '--watch <true|false>        Watch source files and restart (default: true)',
-      '--open <true|false>         Open embedded console in browser after start',
-      '--console-token <token>     Bearer token for /api/console',
-    ],
-  },
-  {
-    title: 'Shared Flags',
-    lines: [
-      '--space <id>                Space id to deploy/verify/list/rollback',
-      '--target <id>               Target profile spaces',
-      '--control-plane <url>       Control plane base URL',
-      '--control-token <token>     Bearer token for control-plane auth',
-      '--actor-id <id>             Actor id fallback when token is missing (dev only)',
-    ],
-  },
-  {
-    title: 'Migrate Status Flags',
-    lines: [
-      '--config <path>             Config file path (default: syncular.config.json)',
-    ],
-  },
-  {
-    title: 'Typegen Flags',
-    lines: [
-      '--config <path>             Config file path (default: syncular.config.ts)',
-      '--out <path>                Output file path (default: ./src/types.generated.ts)',
-      '--dialect <id>              sqlite|postgres (default: sqlite)',
-      '--tables <csv>              Restrict generation to table names',
-      '--extends-sync-client-db <true|false>  Extend SyncClientDb (default: true)',
-      '--include-version-history <true|false> Include versioned DB interfaces (default: false)',
-      '--syncular-import-type <id> scoped|umbrella (default: umbrella)',
-    ],
-  },
-  {
-    title: 'Migrate Up Flags',
-    lines: [
-      '--config <path>             Config file path (default: syncular.config.json)',
-      '--on-checksum-mismatch <id> error|reset (default: error)',
-      '--dry-run <true|false>      Plan migration without applying',
-      '--yes <true|false>          Confirm reset mode when using --on-checksum-mismatch reset',
-    ],
-  },
-  {
-    title: 'Console Flags',
-    lines: [
-      '--host <host>               Bind host (default: 127.0.0.1)',
-      '--port <port>               Bind port (default: 4310, 0 for random)',
-      '--open <true|false>         Open browser after server starts',
-      '--server-url <url>          Preconfigure console API server URL',
-      '--token <token>             Preconfigure console API token',
-      '--token-env <name>          Read console API token from env var',
-    ],
-  },
-  {
-    title: 'Build Flags',
-    lines: [
-      '--target <id>               Target profile spaces',
-      `--buildpack <id>            Buildpack id (default: ${DEFAULT_BUILDPACK_ID})`,
-      '--config <path>             Contract config path (target default)',
-      '--entry <path>              Explicit worker entry override (advanced)',
-      '--out <path>                Artifact output path',
-      '--manifest <path>           Build manifest output path',
-      '--force <true|false>        Overwrite output files (default: false)',
-    ],
-  },
-  {
-    title: 'Eject Flags',
-    lines: [
-      '--target <id>               Target profile spaces',
-      `--buildpack <id>            Buildpack id (default: ${DEFAULT_BUILDPACK_ID})`,
-      '--config <path>             Contract config path (target default)',
-      '--entry <path>              Explicit worker entry override (advanced)',
-      '--out-dir <path>            Eject output directory',
-      '--force <true|false>        Overwrite output files (default: false)',
-    ],
-  },
-  {
-    title: 'Target Flags',
-    lines: ['--set <id>                  Set default target profile (spaces)'],
-  },
-  {
-    title: 'Deploy Flags',
-    lines: [
-      '--target <id>               Target profile spaces (default from state)',
-      '--config <path>             Contract config path (target default)',
-      '--entry <path>              Explicit worker entry override (advanced)',
-      '--script-name <name>        Override target script name',
-      '--source <label>            Deployment source label (spaces target only, default: syncular-cli)',
-      '--dry-run <true|false>      Bundle + metadata validation only (no deploy)',
-    ],
-  },
-  {
-    title: 'Verify Flags',
-    lines: [
-      '--target <id>               Target profile spaces (default from state)',
-      '--base-url <url>            Runtime base URL (default from control-plane runtime)',
-      '--origin <url>              CORS preflight origin to validate (default: http://127.0.0.1:4320)',
-    ],
-  },
-  {
-    title: 'Deployments Flags',
-    lines: [
-      '--limit <n>                 Number of deployment records to list (default: 20)',
-    ],
-  },
-  {
-    title: 'Rollback Flags',
-    lines: [
-      '--to <deploymentId>         Target deployment id to rollback to',
-      '--reason <text>             Optional rollback reason',
-    ],
-  },
-  {
-    title: 'Global Flags',
-    lines: [
-      '--interactive               Force interactive TUI',
-      '--no-interactive            Disable interactive TUI',
-      '--no-update-check           Skip npm update check for this run',
-      '--forms                     Enable interactive command input forms',
-      '--help                      Show help',
-      '--version                   Show version',
-    ],
-  },
-  {
-    title: 'Env Fallbacks',
-    lines: [
-      'SPACES_CONTROL_PLANE_BASE_URL, SPACES_TEST_ACTOR_ID,',
-      'SPACES_CONTROL_PLANE_TOKEN, SPACES_CONTROL_TOKEN,',
-      'SYNCULAR_DB_PROVIDER, SPACES_SQLITE_PATH,',
-      'SYNCULAR_PG_CONNECTION_STRING, DATABASE_URL,',
-      'SYNCULAR_CLI_DISABLE_UPDATE_CHECK',
-    ],
-  },
-];
-
-function HelpView(): ReactElement {
-  return (
-    <Box flexDirection="column">
-      <Text color="cyanBright" bold>
-        {CLI_NAME} CLI v{CLI_VERSION}
-      </Text>
-      <Text dimColor>
-        Interactive by default in TTY. Use --no-interactive for script mode.
-      </Text>
-      <Box marginTop={1} flexDirection="column">
-        <Text color="yellowBright" bold>
-          Usage
-        </Text>
-        {USAGE_LINES.map((line) => (
-          <Text key={line} color="cyan">
-            {line}
-          </Text>
-        ))}
-      </Box>
-      {HELP_SECTIONS.map((section) => (
-        <Box key={section.title} marginTop={1} flexDirection="column">
-          <Text color="yellowBright" bold>
-            {section.title}
-          </Text>
-          {section.lines.map((line) => (
-            <Text key={`${section.title}:${line}`}>{line}</Text>
-          ))}
-        </Box>
-      ))}
-    </Box>
-  );
-}
-
-export function printHelp(): void {
-  const rendered = renderToString(<HelpView />, {
-    columns: Math.max(process.stdout.columns ?? 140, 140),
-  });
-  process.stdout.write(rendered);
-  if (!rendered.endsWith('\n')) {
-    process.stdout.write('\n');
-  }
-}

package/src/index.ts

@@ -1,4 +0,0 @@
-#!/usr/bin/env bun
-import { main } from './main';
-
-void main();

package/src/interactive.tsx

@@ -1,306 +0,0 @@
-import { Box, Text, useApp, useInput } from 'ink';
-import type { ReactElement } from 'react';
-import { useMemo, useState } from 'react';
-import { listInteractiveCommands } from './command-registry';
-import { CLI_NAME, CLI_VERSION } from './constants';
-import type { InteractiveCommand, RootCommand } from './types';
-
-interface InteractiveAppProps {
-  initialCommand: RootCommand | null;
-  allowForms: boolean;
-  onSubmit(argv: string[]): void;
-}
-
-type Screen = 'menu' | 'form';
-
-function parseBooleanInput(value: string): boolean | null {
-  const normalized = value.trim().toLowerCase();
-  if (
-    normalized === 'true' ||
-    normalized === '1' ||
-    normalized === 'yes' ||
-    normalized === 'on'
-  ) {
-    return true;
-  }
-  if (
-    normalized === 'false' ||
-    normalized === '0' ||
-    normalized === 'no' ||
-    normalized === 'off'
-  ) {
-    return false;
-  }
-  return null;
-}
-
-function validateFields(
-  command: InteractiveCommand,
-  values: Record<string, string>
-): string | null {
-  for (const field of command.fields ?? []) {
-    const value = values[field.id] ?? '';
-    if (field.required && value.trim().length === 0) {
-      return `${field.label} is required.`;
-    }
-
-    if (field.kind === 'number' && value.trim().length > 0) {
-      const parsed = Number(value.trim());
-      if (!Number.isFinite(parsed)) {
-        return `${field.label} must be a number.`;
-      }
-    }
-
-    if (field.kind === 'boolean' && value.trim().length > 0) {
-      if (parseBooleanInput(value) === null) {
-        return `${field.label} must be true/false, yes/no, on/off, or 1/0.`;
-      }
-    }
-  }
-  return null;
-}
-
-export function InteractiveApp(props: InteractiveAppProps): ReactElement {
-  const { exit } = useApp();
-  const commands = useMemo(
-    () => listInteractiveCommands(props.initialCommand),
-    [props.initialCommand]
-  );
-  const [screen, setScreen] = useState<Screen>('menu');
-  const [selectedIndex, setSelectedIndex] = useState(0);
-  const [activeCommand, setActiveCommand] = useState<InteractiveCommand | null>(
-    null
-  );
-  const [activeFieldIndex, setActiveFieldIndex] = useState(0);
-  const [fieldValues, setFieldValues] = useState<Record<string, string>>({});
-  const [hint, setHint] = useState<string | null>(null);
-
-  const submitArgv = (argv: string[] | null): void => {
-    if (!argv) {
-      exit();
-      return;
-    }
-    props.onSubmit(argv);
-    exit();
-  };
-
-  const startForm = (command: InteractiveCommand): void => {
-    const initialValues: Record<string, string> = {};
-    for (const field of command.fields ?? []) {
-      initialValues[field.id] = field.defaultValue ?? '';
-    }
-    setActiveCommand(command);
-    setActiveFieldIndex(0);
-    setFieldValues(initialValues);
-    setHint(null);
-    setScreen('form');
-  };
-
-  const submitForm = (): void => {
-    if (!activeCommand) {
-      return;
-    }
-
-    const validationError = validateFields(activeCommand, fieldValues);
-    if (validationError) {
-      setHint(validationError);
-      return;
-    }
-
-    submitArgv(activeCommand.buildArgv(fieldValues));
-  };
-
-  useInput((input, key) => {
-    if (input.toLowerCase() === 'q') {
-      exit();
-      return;
-    }
-
-    if (screen === 'menu') {
-      if (key.upArrow) {
-        setSelectedIndex((index) =>
-          index === 0 ? commands.length - 1 : index - 1
-        );
-        return;
-      }
-
-      if (key.downArrow) {
-        setSelectedIndex((index) =>
-          index === commands.length - 1 ? 0 : index + 1
-        );
-        return;
-      }
-
-      if (!key.return) {
-        return;
-      }
-
-      const selected = commands[selectedIndex];
-      if (!selected) {
-        return;
-      }
-
-      if ((selected.fields?.length ?? 0) === 0) {
-        submitArgv(selected.buildArgv({}));
-        return;
-      }
-
-      if (!props.allowForms) {
-        submitArgv(selected.buildArgv({}));
-        return;
-      }
-
-      startForm(selected);
-      return;
-    }
-
-    if (!activeCommand || screen !== 'form') {
-      return;
-    }
-
-    if (key.escape) {
-      setScreen('menu');
-      setActiveCommand(null);
-      setHint(null);
-      return;
-    }
-
-    const fields = activeCommand.fields ?? [];
-    if (fields.length === 0) {
-      submitArgv(activeCommand.buildArgv(fieldValues));
-      return;
-    }
-
-    const activeField = fields[activeFieldIndex];
-    if (!activeField) {
-      return;
-    }
-
-    if (key.upArrow) {
-      setActiveFieldIndex((index) =>
-        index === 0 ? fields.length - 1 : index - 1
-      );
-      return;
-    }
-
-    if (key.downArrow || key.tab) {
-      setActiveFieldIndex((index) =>
-        index === fields.length - 1 ? 0 : index + 1
-      );
-      return;
-    }
-
-    if (key.ctrl && input.toLowerCase() === 'r') {
-      submitForm();
-      return;
-    }
-
-    if (key.backspace || key.delete) {
-      setFieldValues((current) => ({
-        ...current,
-        [activeField.id]: (current[activeField.id] ?? '').slice(0, -1),
-      }));
-      setHint(null);
-      return;
-    }
-
-    if (key.return) {
-      if (activeFieldIndex === fields.length - 1) {
-        submitForm();
-      } else {
-        setActiveFieldIndex((index) => index + 1);
-      }
-      return;
-    }
-
-    if (!input || key.ctrl || key.meta) {
-      return;
-    }
-
-    setFieldValues((current) => ({
-      ...current,
-      [activeField.id]: `${current[activeField.id] ?? ''}${input}`,
-    }));
-    setHint(null);
-  });
-
-  return (
-    <Box flexDirection="column">
-      <Box borderStyle="round" borderColor="cyan" paddingX={1} paddingY={0}>
-        <Text color="cyanBright">
-          {CLI_NAME} interactive {`v${CLI_VERSION}`}
-        </Text>
-      </Box>
-      <Text color="gray">
-        {screen === 'menu'
-          ? props.allowForms
-            ? 'Up/Down: select  Enter: open form  q: quit'
-            : 'Up/Down: select  Enter: run  q: quit  (use --forms for input forms)'
-          : 'Type to edit  Up/Down: field  Enter: next/run  Ctrl+R: run  Esc: back'}
-      </Text>
-      <Box marginTop={1}>
-        {screen === 'menu' ? (
-          <Box flexDirection="column" width={88}>
-            {commands.map((command, index) => {
-              const active = index === selectedIndex;
-              return (
-                <Box key={command.id}>
-                  <Text color={active ? 'greenBright' : undefined}>
-                    {active ? '> ' : '  '}
-                    {command.label.padEnd(18)}
-                  </Text>
-                  <Text color={active ? 'white' : 'gray'}>
-                    {command.description}
-                  </Text>
-                </Box>
-              );
-            })}
-          </Box>
-        ) : (
-          <Box
-            flexDirection="column"
-            borderStyle="single"
-            borderColor="green"
-            paddingX={1}
-            paddingY={0}
-            width={88}
-          >
-            <Text color="greenBright">{activeCommand?.label}</Text>
-            <Box marginTop={1} flexDirection="column">
-              {(activeCommand?.fields ?? []).map((field, index) => {
-                const active = index === activeFieldIndex;
-                const value = fieldValues[field.id] ?? '';
-                const required = field.required ? ' *' : '';
-                return (
-                  <Box key={field.id}>
-                    <Text color={active ? 'yellowBright' : 'cyan'}>
-                      {active ? '> ' : '  '}
-                      {field.label}
-                      {required}:{' '}
-                    </Text>
-                    <Text color={value.length > 0 ? 'white' : 'gray'}>
-                      {value.length > 0
-                        ? value
-                        : (field.placeholder ?? field.defaultValue ?? '')}
-                    </Text>
-                  </Box>
-                );
-              })}
-            </Box>
-            <Box marginTop={1}>
-              <Text color="gray">
-                command:{' '}
-                {(activeCommand?.buildArgv(fieldValues) ?? ['']).join(' ')}
-              </Text>
-            </Box>
-            {hint ? (
-              <Box marginTop={1}>
-                <Text color="redBright">{hint}</Text>
-              </Box>
-            ) : null}
-          </Box>
-        )}
-      </Box>
-    </Box>
-  );
-}