@syncular/cli 0.0.0-108 → 0.0.0-114

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/flags.ts

@@ -1,92 +0,0 @@
-const TRUE_FLAG_VALUES = new Set(['1', 'true', 'yes', 'on']);
-const FALSE_FLAG_VALUES = new Set(['0', 'false', 'no', 'off']);
-
-export function parseBooleanInput(value: string): boolean | null {
-  const normalized = value.trim().toLowerCase();
-  if (TRUE_FLAG_VALUES.has(normalized)) {
-    return true;
-  }
-  if (FALSE_FLAG_VALUES.has(normalized)) {
-    return false;
-  }
-  return null;
-}
-
-export function optionalFlag(
-  flagValues: Map<string, string>,
-  flag: string,
-  fallback: string
-): string {
-  const value = flagValues.get(flag)?.trim();
-  return value && value.length > 0 ? value : fallback;
-}
-
-export function optionalNullableFlag(
-  flagValues: Map<string, string>,
-  flag: string
-): string | null {
-  const value = flagValues.get(flag)?.trim();
-  return value && value.length > 0 ? value : null;
-}
-
-export function optionalBooleanFlag(
-  flagValues: Map<string, string>,
-  flag: string,
-  fallback: boolean
-): boolean {
-  const value = flagValues.get(flag);
-  if (!value) {
-    return fallback;
-  }
-
-  const parsed = parseBooleanInput(value);
-  if (parsed !== null) {
-    return parsed;
-  }
-
-  throw new Error(
-    `Invalid ${flag} value "${value}". Use true/false, yes/no, on/off, or 1/0.`
-  );
-}
-
-export function optionalIntegerFlag(
-  flagValues: Map<string, string>,
-  flag: string,
-  fallback: number,
-  options?: { min?: number }
-): number {
-  const raw = flagValues.get(flag)?.trim();
-  if (!raw) {
-    return fallback;
-  }
-
-  const parsed = Number.parseInt(raw, 10);
-  const minimum = options?.min ?? 1;
-  if (!Number.isFinite(parsed) || parsed < minimum) {
-    throw new Error(`Invalid ${flag} value: ${raw}`);
-  }
-
-  return parsed;
-}
-
-export function optionalEnumFlag<T extends string>(
-  flagValues: Map<string, string>,
-  flag: string,
-  allowed: readonly T[],
-  fallback: T
-): T {
-  const rawValue = flagValues.get(flag)?.trim();
-  if (!rawValue) {
-    return fallback;
-  }
-
-  for (const candidate of allowed) {
-    if (candidate === rawValue) {
-      return candidate;
-    }
-  }
-
-  throw new Error(
-    `Invalid ${flag} value "${rawValue}". Use: ${allowed.join(', ')}`
-  );
-}