@superdoc-dev/sdk 1.0.0-alpha.1 → 1.0.0-alpha.3

package/src/runtime/spawn.ts

@@ -1,190 +0,0 @@
-import { spawn } from 'node:child_process';
-import { CONTRACT } from '../generated/contract';
-import { SuperDocCliError } from './errors';
-import { buildOperationArgv, resolveInvocation, type InvokeOptions, type OperationSpec } from './transport-common';
-
-type CliEnvelopeSuccess = {
-  ok: true;
-  command: string;
-  data: Record<string, unknown>;
-  meta?: {
-    version?: string;
-  };
-};
-
-type CliEnvelopeError = {
-  ok: false;
-  error: {
-    code: string;
-    message: string;
-    details?: unknown;
-  };
-  meta?: {
-    version?: string;
-  };
-};
-
-type CliEnvelope = CliEnvelopeSuccess | CliEnvelopeError;
-
-function parseEnvelope(stdout: string, stderr: string): CliEnvelope {
-  const output = stdout || stderr;
-  if (!output.trim()) {
-    throw new SuperDocCliError('CLI returned no JSON envelope.', {
-      code: 'COMMAND_FAILED',
-      details: { stdout, stderr },
-    });
-  }
-
-  const attempts: string[] = [output.trim()];
-  const lines = output.split(/\r?\n/);
-  for (let index = 0; index < lines.length; index += 1) {
-    if (!lines[index]?.trim().startsWith('{')) continue;
-    attempts.push(lines.slice(index).join('\n').trim());
-  }
-
-  for (const candidate of attempts) {
-    if (!candidate) continue;
-    try {
-      const parsed = JSON.parse(candidate) as CliEnvelope;
-      if (typeof parsed === 'object' && parsed != null && 'ok' in parsed) {
-        return parsed;
-      }
-    } catch {
-      // try next candidate
-    }
-  }
-
-  try {
-    return JSON.parse(output.trim()) as CliEnvelope;
-  } catch (error) {
-    throw new SuperDocCliError('CLI returned invalid JSON envelope.', {
-      code: 'JSON_PARSE_ERROR',
-      details: {
-        stdout,
-        stderr,
-        message: error instanceof Error ? error.message : String(error),
-      },
-    });
-  }
-}
-
-function parseSemver(version: string): [number, number, number] | null {
-  const core = version.split('-', 1)[0];
-  const [majorText, minorText, patchText] = core.split('.');
-  if (!majorText || !minorText || !patchText) return null;
-
-  const major = Number(majorText);
-  const minor = Number(minorText);
-  const patch = Number(patchText);
-  if (!Number.isInteger(major) || !Number.isInteger(minor) || !Number.isInteger(patch)) {
-    return null;
-  }
-  return [major, minor, patch];
-}
-
-function isVersionLessThan(actual: string, minimum: string): boolean {
-  const actualParsed = parseSemver(actual);
-  const minimumParsed = parseSemver(minimum);
-  if (!actualParsed || !minimumParsed) return false;
-
-  if (actualParsed[0] !== minimumParsed[0]) return actualParsed[0] < minimumParsed[0];
-  if (actualParsed[1] !== minimumParsed[1]) return actualParsed[1] < minimumParsed[1];
-  return actualParsed[2] < minimumParsed[2];
-}
-
-function assertCompatibleCliVersion(envelope: CliEnvelope): void {
-  const actualVersion = envelope.meta?.version;
-  const minimumVersion = CONTRACT.cli.minVersion;
-  if (!actualVersion || !minimumVersion) return;
-  if (actualVersion === '0.0.0') return;
-
-  if (isVersionLessThan(actualVersion, minimumVersion)) {
-    throw new SuperDocCliError(
-      `CLI version ${actualVersion} is older than minimum required ${minimumVersion}.`,
-      {
-        code: 'CLI_VERSION_UNSUPPORTED',
-        details: {
-          cliVersion: actualVersion,
-          minVersion: minimumVersion,
-        },
-      },
-    );
-  }
-}
-
-export class SpawnTransport {
-  private readonly cliBin: string;
-  private readonly env?: Record<string, string | undefined>;
-
-  constructor(options: { cliBin: string; env?: Record<string, string | undefined> }) {
-    this.cliBin = options.cliBin;
-    this.env = options.env;
-  }
-
-  async invoke<TData extends Record<string, unknown>>(
-    operation: OperationSpec,
-    params: Record<string, unknown> = {},
-    options: InvokeOptions = {},
-  ): Promise<TData> {
-    const { command, prefixArgs } = resolveInvocation(this.cliBin);
-    const commandArgs = buildOperationArgv(operation, params, options, undefined, true);
-    const args: string[] = [...prefixArgs, ...commandArgs];
-
-    const spawned = spawn(command, args, {
-      env: {
-        ...process.env,
-        ...(this.env ?? {}),
-      },
-      stdio: ['pipe', 'pipe', 'pipe'],
-    });
-
-    let stdout = '';
-    let stderr = '';
-
-    const stdoutPromise = new Promise<void>((resolve) => {
-      spawned.stdout.on('data', (chunk) => {
-        stdout += String(chunk);
-      });
-      spawned.stdout.on('end', () => resolve());
-    });
-
-    const stderrPromise = new Promise<void>((resolve) => {
-      spawned.stderr.on('data', (chunk) => {
-        stderr += String(chunk);
-      });
-      spawned.stderr.on('end', () => resolve());
-    });
-
-    if (options.stdinBytes) {
-      spawned.stdin.write(options.stdinBytes);
-    }
-    spawned.stdin.end();
-
-    const exitCode = await new Promise<number>((resolve, reject) => {
-      spawned.on('error', reject);
-      spawned.on('close', (code) => resolve(code ?? 1));
-    });
-
-    await Promise.all([stdoutPromise, stderrPromise]);
-
-    const envelope = parseEnvelope(stdout, stderr);
-    assertCompatibleCliVersion(envelope);
-    if (envelope.ok) {
-      return envelope.data as TData;
-    }
-
-    throw new SuperDocCliError(envelope.error.message, {
-      code: envelope.error.code,
-      details: envelope.error.details,
-      exitCode,
-    });
-  }
-
-  async connect(): Promise<void> {
-    // no-op in one-shot spawn mode
-  }
-
-  async dispose(): Promise<void> {
-    // no-op in one-shot spawn mode
-  }
-}