@syncular/cli 0.0.0-44 → 0.0.0-48

package/src/dev-logging.tsx

@@ -1,415 +0,0 @@
-import { spawn } from 'node:child_process';
-import { dirname } from 'node:path';
-import process from 'node:process';
-import type {
-  SpaceDevLogEvent,
-  SpaceDevLogger,
-} from '@syncular/cli-runtime-dev';
-import { Box, renderToString, Text } from 'ink';
-import type { ReactNode } from 'react';
-import {
-  configureSyncTelemetry,
-  getSyncTelemetry,
-  type SyncTelemetry,
-  type SyncTelemetryEvent,
-} from 'syncular/core';
-
-function writeStdout(node: ReactNode): void {
-  const rendered = renderToString(node, {
-    columns: Math.max(process.stdout.columns ?? 120, 120),
-  });
-  process.stdout.write(rendered);
-  if (!rendered.endsWith('\n')) {
-    process.stdout.write('\n');
-  }
-}
-
-function writeStderr(node: ReactNode): void {
-  const rendered = renderToString(node, {
-    columns: Math.max(process.stderr.columns ?? 120, 120),
-  });
-  process.stderr.write(rendered);
-  if (!rendered.endsWith('\n')) {
-    process.stderr.write('\n');
-  }
-}
-
-function nowStamp(): string {
-  return new Date().toISOString().slice(11, 19);
-}
-
-function clearTerminalScreen(): void {
-  if (!process.stdout.isTTY) {
-    return;
-  }
-  process.stdout.write('\x1b[2J\x1b[H');
-}
-
-async function openInBrowser(url: string): Promise<void> {
-  await new Promise<void>((resolvePromise, rejectPromise) => {
-    let command = '';
-    let commandArgs: string[] = [];
-
-    if (process.platform === 'darwin') {
-      command = 'open';
-      commandArgs = [url];
-    } else if (process.platform === 'win32') {
-      command = 'cmd';
-      commandArgs = ['/c', 'start', '', url];
-    } else {
-      command = 'xdg-open';
-      commandArgs = [url];
-    }
-
-    const child = spawn(command, commandArgs, {
-      stdio: 'ignore',
-      detached: true,
-    });
-
-    child.once('error', rejectPromise);
-    child.once('spawn', () => {
-      child.unref();
-      resolvePromise();
-    });
-  });
-}
-
-function levelColor(
-  level: 'info' | 'warn' | 'error'
-): 'cyan' | 'yellow' | 'redBright' {
-  if (level === 'error') return 'redBright';
-  if (level === 'warn') return 'yellow';
-  return 'cyan';
-}
-
-function detectLevelFromSyncEvent(
-  event: SyncTelemetryEvent
-): 'info' | 'warn' | 'error' {
-  const level = event.level ?? (event.error ? 'error' : 'info');
-  if (level === 'warn') return 'warn';
-  if (level === 'error' || level === 'fatal') return 'error';
-  return 'info';
-}
-
-function summarizeSyncEvent(event: SyncTelemetryEvent): string {
-  if (event.event === 'sync.push') {
-    const status = typeof event.status === 'string' ? event.status : 'unknown';
-    const operationCount =
-      typeof event.operationCount === 'number' ? event.operationCount : 0;
-    const commitSeq =
-      typeof event.commitSeq === 'number' ? ` commit#${event.commitSeq}` : '';
-    const duration =
-      typeof event.durationMs === 'number' ? ` ${event.durationMs}ms` : '';
-    return `push ${status} ops=${operationCount}${commitSeq}${duration}`;
-  }
-
-  if (event.event === 'sync.pull') {
-    const subscriptionCount =
-      typeof event.subscriptionCount === 'number' ? event.subscriptionCount : 0;
-    const cursor =
-      typeof event.clientCursor === 'number'
-        ? ` cursor=${event.clientCursor}`
-        : '';
-    const duration =
-      typeof event.durationMs === 'number' ? ` ${event.durationMs}ms` : '';
-    return `pull subs=${subscriptionCount}${cursor}${duration}`;
-  }
-
-  if (event.event === 'sync.realtime.connect') {
-    return 'realtime connected';
-  }
-
-  if (event.event === 'sync.realtime.disconnect') {
-    return 'realtime disconnected';
-  }
-
-  if (event.event === 'sync.realtime.rejected') {
-    const reason =
-      typeof event.reason === 'string' ? ` reason=${event.reason}` : '';
-    return `realtime rejected${reason}`;
-  }
-
-  if (event.event === 'sync.exception') {
-    return `exception ${String(event.error ?? 'unknown error')}`;
-  }
-
-  const duration =
-    typeof event.durationMs === 'number' ? ` ${event.durationMs}ms` : '';
-  return `${event.event}${duration}`;
-}
-
-function printSyncEventLine(args: {
-  level: 'info' | 'warn' | 'error';
-  eventName: string;
-  summary: string;
-  actorId?: string;
-}): void {
-  const tag = args.level.toUpperCase();
-  const color = levelColor(args.level);
-  writeStdout(
-    <Box>
-      <Text dimColor>[{nowStamp()}] </Text>
-      <Text color={color} bold>
-        {tag.padEnd(5)}
-      </Text>
-      <Text color="magentaBright"> sync </Text>
-      <Text color="gray">{args.eventName} </Text>
-      <Text>{args.summary}</Text>
-      {args.actorId ? <Text dimColor> actor={args.actorId}</Text> : null}
-    </Box>
-  );
-}
-
-function summarizeDevEvent(event: SpaceDevLogEvent): string {
-  if (event.type === 'reloading') {
-    return event.reason ?? 'source change';
-  }
-
-  if (event.type === 'watching') {
-    return event.watchRoot ?? '(watch root)';
-  }
-
-  if (event.type === 'startup_failed' || event.type === 'restart_failed') {
-    const detail = event.error ?? event.message;
-    const firstLine = detail.split('\n')[0];
-    return firstLine ? firstLine.trim() : 'runtime error';
-  }
-
-  if (event.type === 'starting') {
-    return `${event.reason ?? 'start'} -> ${event.host ?? '127.0.0.1'}:${String(event.port ?? 0)}`;
-  }
-
-  if (event.type === 'stopping') {
-    return event.url ?? 'runtime server';
-  }
-
-  if (event.type === 'stopped') {
-    return event.url ?? 'runtime server';
-  }
-
-  return event.message;
-}
-
-function renderDatabaseDetails(event: SpaceDevLogEvent): ReactNode {
-  if (!event.provider) {
-    return <Text color="gray">database: unknown</Text>;
-  }
-
-  if (event.provider === 'sqlite') {
-    return (
-      <Text color="gray">
-        database: sqlite path={event.databaseDetails ?? '(unknown)'}
-      </Text>
-    );
-  }
-
-  return (
-    <Text color="gray">
-      database: {event.provider}{' '}
-      {event.databaseDetails ? `(${event.databaseDetails})` : ''}
-    </Text>
-  );
-}
-
-function renderStartedPanel(event: SpaceDevLogEvent): void {
-  const projectPath =
-    event.cwd || (event.modulePath ? dirname(event.modulePath) : '(unknown)');
-  const listenUrl =
-    event.url ||
-    `http://${event.host ?? '127.0.0.1'}:${String(event.port ?? 0)}`;
-  const consoleUrl = event.consoleUrl ?? `${listenUrl}/console`;
-
-  writeStdout(
-    <Box
-      flexDirection="column"
-      borderStyle="round"
-      borderColor="greenBright"
-      paddingX={1}
-      paddingY={0}
-    >
-      <Text color="greenBright" bold>
-        syncular dev started
-      </Text>
-      <Text color="gray">project: {projectPath}</Text>
-      <Text color="gray">module: {event.module ?? '(unknown)'}</Text>
-      <Text color="gray">listen: {listenUrl}</Text>
-      <Text color="gray">console: {consoleUrl}</Text>
-      {renderDatabaseDetails(event)}
-    </Box>
-  );
-}
-
-function printDevEvent(event: SpaceDevLogEvent): void {
-  if (event.type === 'started') {
-    clearTerminalScreen();
-    renderStartedPanel(event);
-    return;
-  }
-
-  const color = levelColor(event.level);
-  const tag = event.level.toUpperCase();
-  writeStdout(
-    <Box flexDirection="column">
-      <Box>
-        <Text dimColor>[{nowStamp()}] </Text>
-        <Text color={color} bold>
-          {tag.padEnd(5)}
-        </Text>
-        <Text color="cyanBright"> dev </Text>
-        <Text color="gray">{event.type} </Text>
-        <Text>{summarizeDevEvent(event)}</Text>
-      </Box>
-    </Box>
-  );
-}
-
-export function createSpacesDevLogger(options?: {
-  openConsoleOnStarted?: boolean;
-}): SpaceDevLogger {
-  let consoleOpened = false;
-  return {
-    info(message) {
-      printDevEvent({
-        level: 'info',
-        type: 'starting',
-        message,
-      });
-    },
-    error(message) {
-      writeStderr(
-        <Box>
-          <Text dimColor>[{nowStamp()}] </Text>
-          <Text color="redBright" bold>
-            ERROR
-          </Text>
-          <Text color="redBright"> dev </Text>
-          <Text>{message}</Text>
-        </Box>
-      );
-    },
-    event(event) {
-      printDevEvent(event);
-      if (options?.openConsoleOnStarted && event.type === 'started') {
-        if (consoleOpened) {
-          return;
-        }
-
-        consoleOpened = true;
-        const listenUrl =
-          event.url ||
-          `http://${event.host ?? '127.0.0.1'}:${String(event.port ?? 0)}`;
-        const consoleUrl = event.consoleUrl ?? `${listenUrl}/console`;
-
-        void openInBrowser(consoleUrl).catch((error: unknown) => {
-          const message =
-            error instanceof Error ? error.message : String(error);
-          writeStderr(
-            <Box>
-              <Text dimColor>[{nowStamp()}] </Text>
-              <Text color="yellow">WARN </Text>
-              <Text color="yellow">dev </Text>
-              <Text>unable to open browser automatically: {message}</Text>
-            </Box>
-          );
-          writeStderr(
-            <Box>
-              <Text dimColor>[{nowStamp()}] </Text>
-              <Text color="yellow">WARN </Text>
-              <Text color="yellow">dev </Text>
-              <Text>open manually: {consoleUrl}</Text>
-            </Box>
-          );
-        });
-      }
-    },
-  };
-}
-
-export function configureSpacesDevTelemetry(): () => void {
-  const previousTelemetry = getSyncTelemetry();
-  let lastPullCursor: number | null = null;
-  let lastPullLogAt = 0;
-  let suppressedPullCount = 0;
-
-  const telemetry: SyncTelemetry = {
-    log(event) {
-      if (event.event === 'console.stats') {
-        return;
-      }
-
-      if (event.event === 'sync.pull') {
-        const cursor =
-          typeof event.clientCursor === 'number' ? event.clientCursor : null;
-        const now = Date.now();
-        const isRepetitive =
-          cursor !== null &&
-          cursor === lastPullCursor &&
-          now - lastPullLogAt < 2_000;
-
-        if (isRepetitive) {
-          suppressedPullCount += 1;
-          return;
-        }
-
-        lastPullCursor = cursor;
-        lastPullLogAt = now;
-      }
-
-      const summary = summarizeSyncEvent(event);
-      const level = detectLevelFromSyncEvent(event);
-      const actorId =
-        typeof event.userId === 'string' && event.userId.length > 0
-          ? event.userId
-          : undefined;
-      const eventName = event.event;
-
-      if (suppressedPullCount > 0 && event.event !== 'sync.pull') {
-        printSyncEventLine({
-          level: 'info',
-          eventName: 'sync.pull',
-          summary: `suppressed ${suppressedPullCount} repetitive pull logs`,
-        });
-        suppressedPullCount = 0;
-      }
-
-      printSyncEventLine({
-        level,
-        eventName,
-        summary,
-        actorId,
-      });
-    },
-    tracer: previousTelemetry.tracer,
-    metrics: previousTelemetry.metrics,
-    captureException(error, context) {
-      const message =
-        error instanceof Error
-          ? error.message
-          : `Unknown error: ${String(error)}`;
-      writeStderr(
-        <Box flexDirection="column">
-          <Box>
-            <Text dimColor>[{nowStamp()}] </Text>
-            <Text color="redBright" bold>
-              ERROR
-            </Text>
-            <Text color="magentaBright"> sync </Text>
-            <Text>{message}</Text>
-          </Box>
-          {context ? (
-            <Box paddingLeft={16}>
-              <Text color="gray">{JSON.stringify(context)}</Text>
-            </Box>
-          ) : null}
-        </Box>
-      );
-      previousTelemetry.captureException(error, context);
-    },
-  };
-
-  configureSyncTelemetry(telemetry);
-
-  return () => {
-    configureSyncTelemetry(previousTelemetry);
-  };
-}

package/src/extensions/index.ts

@@ -1 +0,0 @@
-export * from './manifest';

package/src/extensions/manifest.ts

@@ -1,37 +0,0 @@
-import { contractWorkerBuildpack } from '@syncular/cli-buildpack-contract-worker';
-import type { ContractBuildpack } from '@syncular/cli-core';
-import { spacesAppTemplate } from '@syncular/cli-template-spaces-app';
-import { spacesDemoTemplate } from '@syncular/cli-template-spaces-demo';
-import { syncularDemoTemplate } from '@syncular/cli-template-syncular-demo';
-import { syncularLibrariesTemplate } from '@syncular/cli-template-syncular-libraries';
-
-interface BuildpackExtensionManifestEntry {
-  packageName: string;
-  buildpack: ContractBuildpack;
-}
-
-export const TEMPLATE_EXTENSION_MANIFEST = {
-  spacesApp: {
-    packageName: '@syncular/cli-template-spaces-app',
-    template: spacesAppTemplate,
-  },
-  spacesDemo: {
-    packageName: '@syncular/cli-template-spaces-demo',
-    template: spacesDemoTemplate,
-  },
-  syncularDemo: {
-    packageName: '@syncular/cli-template-syncular-demo',
-    template: syncularDemoTemplate,
-  },
-  syncularLibraries: {
-    packageName: '@syncular/cli-template-syncular-libraries',
-    template: syncularLibrariesTemplate,
-  },
-} as const;
-
-export const BUILDPACK_EXTENSION_MANIFEST = {
-  contractWorker: {
-    packageName: '@syncular/cli-buildpack-contract-worker',
-    buildpack: contractWorkerBuildpack,
-  },
-} as const satisfies Record<string, BuildpackExtensionManifestEntry>;

package/src/help.tsx

@@ -1,236 +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)',
-    ],
-  },
-  {
-    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',
-      '--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',
-    ],
-  },
-];
-
-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();