@fragments-sdk/cli 0.14.3 → 0.15.1

package/src/commands/push-contracts.ts

@@ -0,0 +1,112 @@
+/**
+ * fragments push-contracts
+ *
+ * Push compiled component contracts to Fragments Cloud.
+ * Reads fragments.json from the project root (or builds it from .contract.json files)
+ * and posts the contract registry to the Cloud ingest endpoint.
+ */
+
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import pc from 'picocolors';
+import { BRAND } from '../core/index.js';
+
+export interface PushContractsOptions {
+  /** Path to fragments.json or directory containing .contract.json files */
+  input?: string;
+  /** Fragments Cloud URL */
+  url?: string;
+  /** API key (defaults to FRAGMENTS_API_KEY env var) */
+  apiKey?: string;
+  /** Suppress output */
+  quiet?: boolean;
+}
+
+export async function pushContracts(
+  options: PushContractsOptions = {},
+): Promise<{ exitCode: number }> {
+  const quiet = options.quiet ?? false;
+  const apiKey = options.apiKey ?? process.env.FRAGMENTS_API_KEY;
+
+  if (!apiKey) {
+    console.error(
+      pc.red('No API key found. Set FRAGMENTS_API_KEY or pass --api-key.'),
+    );
+    return { exitCode: 1 };
+  }
+
+  if (!quiet) {
+    console.log(pc.cyan(`\n${BRAND.name} Push Contracts\n`));
+  }
+
+  // 1. Find contract registry
+  const inputPath = options.input
+    ? resolve(options.input)
+    : resolve('fragments.json');
+
+  if (!existsSync(inputPath)) {
+    console.error(
+      pc.red(`Contract registry not found at ${inputPath}`),
+    );
+    console.error(
+      pc.dim('Run `fragments build` or `fragments scan` to generate fragments.json first.'),
+    );
+    return { exitCode: 1 };
+  }
+
+  // 2. Parse and validate
+  let contractRegistry: string;
+  let componentCount = 0;
+
+  try {
+    const raw = readFileSync(inputPath, 'utf-8');
+    const parsed = JSON.parse(raw);
+    const fragments = parsed.fragments ?? parsed;
+
+    if (!Array.isArray(fragments)) {
+      console.error(pc.red('Invalid contract registry: expected fragments array'));
+      return { exitCode: 1 };
+    }
+
+    componentCount = fragments.length;
+    contractRegistry = JSON.stringify({ fragments });
+  } catch (error) {
+    console.error(
+      pc.red('Failed to parse contract registry:'),
+      error instanceof Error ? error.message : 'unknown error',
+    );
+    return { exitCode: 1 };
+  }
+
+  if (componentCount === 0) {
+    console.warn(pc.yellow('No components found in contract registry. Nothing to push.'));
+    return { exitCode: 0 };
+  }
+
+  if (!quiet) {
+    console.log(pc.dim(`  Found ${componentCount} component contracts\n`));
+    console.log(pc.dim('  Pushing to Fragments Cloud...\n'));
+  }
+
+  // 3. Push to Cloud
+  const { pushContracts: push } = await import('@fragments-sdk/govern');
+
+  const result = await push({
+    contractRegistry,
+    url: options.url,
+    apiKey,
+  });
+
+  if (!result.ok) {
+    console.error(pc.red(`Failed to push contracts: ${result.error}`));
+    return { exitCode: 1 };
+  }
+
+  if (!quiet) {
+    console.log(
+      pc.green(`  ✓ Pushed ${componentCount} component contracts to Fragments Cloud\n`),
+    );
+  }
+
+  return { exitCode: 0 };
+}