@syncular/cli 0.0.0-44

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@syncular/cli",
+  "version": "0.0.0-44",
+  "description": "Unified CLI for Syncular OSS and Spaces workflows",
+  "license": "MIT",
+  "author": "Benjamin Kniffler",
+  "homepage": "https://syncular.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/syncular/syncular-spaces.git",
+    "directory": "cli/bin"
+  },
+  "bugs": {
+    "url": "https://github.com/syncular/syncular-spaces/issues"
+  },
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "bin": {
+    "syncular": "./src/index.ts",
+    "synclr": "./src/index.ts"
+  },
+  "files": [
+    "src"
+  ],
+  "scripts": {
+    "tsgo": "tsgo --noEmit",
+    "test": "bun test test",
+    "doctor": "bun src/index.ts doctor",
+    "console": "bun src/index.ts console",
+    "login": "bun src/index.ts login",
+    "logout": "bun src/index.ts logout",
+    "whoami": "bun src/index.ts whoami",
+    "create:space": "bun src/index.ts create-space",
+    "create": "bun src/index.ts create",
+    "dev": "bun src/index.ts dev",
+    "typegen": "bun src/index.ts typegen",
+    "migrate:status": "bun src/index.ts migrate-status",
+    "migrate:up": "bun src/index.ts migrate-up",
+    "build": "bun src/index.ts build",
+    "eject": "bun src/index.ts eject",
+    "target": "bun src/index.ts target",
+    "deploy": "bun src/index.ts deploy",
+    "verify": "bun src/index.ts verify",
+    "deployments:list": "bun src/index.ts deployments",
+    "rollback": "bun src/index.ts rollback",
+    "release": "bun ../config/bin/publish.ts"
+  },
+  "dependencies": {
+    "@syncular/cli-buildpack-contract-worker": "0.0.0-44",
+    "@syncular/cli-core": "0.0.0-44",
+    "@syncular/cli-runtime-dev": "0.0.0-44",
+    "@syncular/cli-template-spaces-app": "0.0.0-44",
+    "@syncular/cli-template-spaces-demo": "0.0.0-44",
+    "@syncular/cli-template-syncular-demo": "0.0.0-44",
+    "@syncular/cli-template-syncular-libraries": "0.0.0-44",
+    "cross-keychain": "^1.1.0",
+    "ink": "^6.8.0",
+    "react": "^19.2.4",
+    "syncular": "*"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.9",
+    "@types/react": "^19.2.14"
+  }
+}

package/src/args.ts

@@ -0,0 +1,112 @@
+import process from 'node:process';
+import type { ParsedArgs, RootCommand } from './types';
+
+const IMPLICIT_TRUE_FLAGS = new Set([
+  '--help',
+  '--version',
+  '--interactive',
+  '--no-interactive',
+  '--forms',
+  '--json',
+  '--force',
+  '--watch',
+  '--open',
+  '--dry-run',
+  '--yes',
+]);
+
+export function parseArgs(argv: string[]): ParsedArgs {
+  const flags = new Set<string>();
+  const flagValues = new Map<string, string>();
+  const positionals: string[] = [];
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (!arg) {
+      continue;
+    }
+
+    if (!arg.startsWith('-')) {
+      positionals.push(arg);
+      continue;
+    }
+
+    if (arg.startsWith('--')) {
+      const eqIndex = arg.indexOf('=');
+      if (eqIndex > 0) {
+        const key = arg.slice(0, eqIndex);
+        const value = arg.slice(eqIndex + 1);
+        flags.add(key);
+        flagValues.set(key, value);
+        continue;
+      }
+
+      flags.add(arg);
+      const next = argv[index + 1];
+      if (
+        typeof next === 'string' &&
+        next.length > 0 &&
+        !next.startsWith('-')
+      ) {
+        flagValues.set(arg, next);
+        index += 1;
+      } else if (IMPLICIT_TRUE_FLAGS.has(arg)) {
+        flagValues.set(arg, 'true');
+      }
+      continue;
+    }
+
+    flags.add(arg);
+  }
+
+  const commandCandidate = positionals[0] ?? null;
+  const subcommand = positionals[1] ?? null;
+
+  return {
+    command: normalizeRootCommand(commandCandidate),
+    subcommand,
+    flags,
+    flagValues,
+    positionals,
+  };
+}
+
+function normalizeRootCommand(value: string | null): RootCommand | null {
+  if (!value) {
+    return null;
+  }
+
+  if (value === 'help') return 'help';
+  if (value === 'version') return 'version';
+  if (value === 'doctor') return 'doctor';
+  if (value === 'console') return 'console';
+  if (value === 'login') return 'login';
+  if (value === 'logout') return 'logout';
+  if (value === 'whoami') return 'whoami';
+  if (value === 'create-space') return 'create-space';
+  if (value === 'create') return 'create';
+  if (value === 'dev') return 'dev';
+  if (value === 'typegen') return 'typegen';
+  if (value === 'migrate-status') return 'migrate-status';
+  if (value === 'migrate-up') return 'migrate-up';
+  if (value === 'build') return 'build';
+  if (value === 'eject') return 'eject';
+  if (value === 'target') return 'target';
+  if (value === 'deploy') return 'deploy';
+  if (value === 'verify') return 'verify';
+  if (value === 'rollback') return 'rollback';
+  if (value === 'deployments') return 'deployments';
+  if (value === 'interactive') return 'interactive';
+
+  return null;
+}
+
+export function shouldRunInteractive(args: ParsedArgs): boolean {
+  if (args.flags.has('--no-interactive')) {
+    return false;
+  }
+  if (args.flags.has('--interactive')) {
+    return true;
+  }
+  return process.stdout.isTTY === true;
+}

package/src/auth-storage.ts

@@ -0,0 +1,57 @@
+import { deletePassword, getPassword, setPassword } from 'cross-keychain';
+
+const SYNCULAR_CLI_KEYCHAIN_SERVICE = 'syncular-cli';
+
+function sanitizeAccountSegment(value: string): string {
+  const sanitized = value.replace(/[^A-Za-z0-9._@-]/g, '-');
+  const collapsed = sanitized.replace(/-+/g, '-').replace(/^-+|-+$/g, '');
+  return collapsed.length > 0 ? collapsed : 'default';
+}
+
+function controlPlaneAccount(controlPlaneBase: string): string {
+  try {
+    const url = new URL(controlPlaneBase);
+    return `control-plane-${sanitizeAccountSegment(url.host)}`;
+  } catch {
+    return `control-plane-${sanitizeAccountSegment(controlPlaneBase)}`;
+  }
+}
+
+export async function readStoredControlPlaneToken(
+  controlPlaneBase: string
+): Promise<string | null> {
+  try {
+    const token = await getPassword(
+      SYNCULAR_CLI_KEYCHAIN_SERVICE,
+      controlPlaneAccount(controlPlaneBase)
+    );
+    const normalized = token?.trim() ?? '';
+    return normalized.length > 0 ? normalized : null;
+  } catch {
+    return null;
+  }
+}
+
+export async function writeStoredControlPlaneToken(args: {
+  controlPlaneBase: string;
+  token: string;
+}): Promise<void> {
+  await setPassword(
+    SYNCULAR_CLI_KEYCHAIN_SERVICE,
+    controlPlaneAccount(args.controlPlaneBase),
+    args.token
+  );
+}
+
+export async function clearStoredControlPlaneToken(
+  controlPlaneBase: string
+): Promise<void> {
+  try {
+    await deletePassword(
+      SYNCULAR_CLI_KEYCHAIN_SERVICE,
+      controlPlaneAccount(controlPlaneBase)
+    );
+  } catch {
+    // ignore missing keychain entries
+  }
+}

package/src/buildpacks/index.ts

@@ -0,0 +1,2 @@
+export * from './registry';
+export * from './types';

package/src/buildpacks/registry.ts

@@ -0,0 +1,47 @@
+import type { ContractBuildpack } from '@syncular/cli-core';
+import { BUILDPACK_EXTENSION_MANIFEST } from '../extensions';
+
+type BuildpackManifest = typeof BUILDPACK_EXTENSION_MANIFEST;
+
+function buildBuildpackRegistry(manifest: BuildpackManifest) {
+  const entries = Object.entries(manifest);
+  const seenBuildpackIds = new Set<string>();
+
+  for (const [registryKey, manifestEntry] of entries) {
+    const buildpackId = manifestEntry.buildpack.id;
+    if (buildpackId.length === 0) {
+      throw new Error(`Buildpack "${registryKey}" has an empty id.`);
+    }
+
+    if (seenBuildpackIds.has(buildpackId)) {
+      throw new Error(`Duplicate buildpack id in manifest: "${buildpackId}".`);
+    }
+    seenBuildpackIds.add(buildpackId);
+  }
+
+  return Object.freeze(
+    Object.fromEntries(
+      entries.map(([registryKey, manifestEntry]) => [
+        registryKey,
+        manifestEntry.buildpack,
+      ])
+    )
+  ) as {
+    [K in keyof BuildpackManifest]: BuildpackManifest[K]['buildpack'];
+  };
+}
+
+const buildpackRegistry = buildBuildpackRegistry(BUILDPACK_EXTENSION_MANIFEST);
+
+const REGISTERED_BUILDPACKS = Object.freeze(Object.values(buildpackRegistry));
+const BUILDPACK_IDS = Object.freeze(
+  REGISTERED_BUILDPACKS.map((buildpack) => buildpack.id)
+) as readonly string[];
+
+export function listBuildpackIds(): readonly string[] {
+  return BUILDPACK_IDS;
+}
+
+export function getBuildpackById(id: string): ContractBuildpack | null {
+  return REGISTERED_BUILDPACKS.find((buildpack) => buildpack.id === id) ?? null;
+}

package/src/buildpacks/types.ts

@@ -0,0 +1 @@
+export type { ContractBuildpack } from '@syncular/cli-core';