@mmapp/react-compiler 0.1.0-alpha.1 → 0.1.0-alpha.4

package/dist/server-VW6UPCHO.mjs

@@ -0,0 +1,277 @@
+import {
+  __require
+} from "./chunk-CIESM3BP.mjs";
+
+// src/cli/server.ts
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { resolve } from "path";
+var BINARY_SEARCH_PATHS = [
+  "engine/target/release/mm-server",
+  "engine/target/debug/mm-server",
+  "mm-core/target/release/mm-server",
+  "mm-core/target/debug/mm-server",
+  "target/release/mm-server",
+  "target/debug/mm-server"
+];
+function findServerBinary(explicitPath) {
+  if (explicitPath) {
+    return existsSync(explicitPath) ? explicitPath : null;
+  }
+  for (const rel of BINARY_SEARCH_PATHS) {
+    const abs = resolve(process.cwd(), rel);
+    if (existsSync(abs)) return abs;
+  }
+  try {
+    const { execSync } = __require("child_process");
+    const result = execSync("which mm-server 2>/dev/null || which mm-api 2>/dev/null", {
+      encoding: "utf-8",
+      timeout: 5e3
+    }).trim();
+    if (result) return result;
+  } catch {
+  }
+  return null;
+}
+async function serverStart(options) {
+  const binary = findServerBinary(options.binary);
+  if (!binary) {
+    console.error("[mmrc] Error: MindMatrix server binary not found.\n");
+    console.error("To get the server binary, choose one of:");
+    console.error("");
+    console.error("  1. Build from source:");
+    console.error("     cd engine && cargo build --release -p mm-api");
+    console.error("");
+    console.error("  2. Docker:");
+    console.error("     docker pull mindmatrix/mm-server:latest");
+    console.error("     docker run -p 4200:4200 mindmatrix/mm-server:latest");
+    console.error("");
+    console.error("  3. Download from releases:");
+    console.error("     https://github.com/mindmatrix/mm-server/releases");
+    console.error("");
+    console.error("  4. Specify path directly:");
+    console.error("     mmrc server start --binary /path/to/mm-server");
+    process.exit(1);
+  }
+  console.log(`[mmrc] Starting server: ${binary}`);
+  const args = [];
+  const configPath = options.config ?? findConfigFile();
+  if (configPath) {
+    args.push("--config", configPath);
+    console.log(`[mmrc] Config: ${configPath}`);
+  }
+  if (options.port) {
+    process.env.PORT = String(options.port);
+    console.log(`[mmrc] Port: ${options.port}`);
+  }
+  if (options.migrate) {
+    console.log("[mmrc] Running migrations...");
+    process.env.MM_RUN_MIGRATIONS = "true";
+  }
+  const { spawn } = __require("child_process");
+  const child = spawn(binary, args, {
+    stdio: "inherit",
+    env: { ...process.env, MM_CONFIG_PATH: configPath ?? "" }
+  });
+  child.on("error", (err) => {
+    console.error(`[mmrc] Failed to start server: ${err.message}`);
+    process.exit(1);
+  });
+  child.on("exit", (code) => {
+    process.exit(code ?? 0);
+  });
+  const forward = (signal) => {
+    process.on(signal, () => child.kill(signal));
+  };
+  forward("SIGINT");
+  forward("SIGTERM");
+}
+async function serverMigrate(options) {
+  const apiUrl = options.apiUrl ?? "http://localhost:4200";
+  try {
+    console.log(`[mmrc] Requesting migration on ${apiUrl}...`);
+    const res = await fetch(`${apiUrl}/api/v1/admin/migrate`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" }
+    });
+    if (res.ok) {
+      const data = await res.json();
+      console.log(`[mmrc] Migration complete: ${JSON.stringify(data)}`);
+      return;
+    }
+    if (res.status !== 404) {
+      console.warn(`[mmrc] Migration request failed: ${res.status}`);
+    }
+  } catch {
+  }
+  const binary = findServerBinary();
+  if (!binary) {
+    console.error("[mmrc] Error: Server not running and binary not found.");
+    console.error("  Start the server first: mmrc server start");
+    console.error("  Or build from source: cd engine && cargo build --release -p mm-api");
+    process.exit(1);
+  }
+  console.log(`[mmrc] Running migrations via ${binary}...`);
+  const { execSync } = __require("child_process");
+  try {
+    const configPath = options.config ?? findConfigFile();
+    const env = { ...process.env, MM_RUN_MIGRATIONS: "true" };
+    if (configPath) env.MM_CONFIG_PATH = configPath;
+    execSync(`${binary} --migrate-only`, { stdio: "inherit", env });
+    console.log("[mmrc] Migrations complete.");
+  } catch (e) {
+    console.error(`[mmrc] Migration failed: ${e.message}`);
+    process.exit(1);
+  }
+}
+function serverInit(options) {
+  const output = options.output ?? "mm-server.toml";
+  const mode = options.mode ?? "standalone";
+  const db = options.db ?? "$env:DATABASE_URL";
+  if (existsSync(output) && output !== "/dev/stdout") {
+    console.error(`[mmrc] Error: ${output} already exists. Use --output to specify a different path.`);
+    process.exit(1);
+  }
+  const content = generateServerToml(mode, db);
+  writeFileSync(output, content, "utf-8");
+  console.log(`[mmrc] Generated ${output} (mode: ${mode})`);
+  console.log(`[mmrc] Edit the file, then run: mmrc server start`);
+}
+function generateServerToml(mode = "standalone", db = "$env:DATABASE_URL") {
+  const lines = [];
+  lines.push(`# MindMatrix Server Configuration`);
+  lines.push(`# Generated by: mmrc server init --mode ${mode}`);
+  lines.push(`# Docs: https://docs.mindmatrix.dev/server/configuration`);
+  lines.push(`#`);
+  lines.push(`# Environment variables can be referenced as $env:VAR_NAME`);
+  lines.push(``);
+  lines.push(`[server]`);
+  lines.push(`# Server mode: "standalone" (all-in-one), "gateway" (API + routing), "worker" (action execution)`);
+  lines.push(`mode = "${mode}"`);
+  lines.push(`# Listen port (also configurable via PORT env var)`);
+  lines.push(`port = 4200`);
+  lines.push(`# Bind address`);
+  lines.push(`host = "0.0.0.0"`);
+  lines.push(``);
+  lines.push(`[database]`);
+  lines.push(`# PostgreSQL connection URL`);
+  lines.push(`url = "${db}"`);
+  lines.push(`# Connection pool size`);
+  lines.push(`max_connections = 10`);
+  lines.push(``);
+  lines.push(`[auth]`);
+  lines.push(`# JWT signing secret (also configurable via JWT_SECRET env var)`);
+  lines.push(`jwt_secret = "$env:JWT_SECRET"`);
+  lines.push(``);
+  lines.push(`[telemetry]`);
+  lines.push(`# Log output format: "pretty" (human-readable) or "json" (structured)`);
+  lines.push(`log_format = "pretty"`);
+  lines.push(`# Log level filter (RUST_LOG syntax)`);
+  lines.push(`log_level = "mm_api=info,mm_storage=info,mm_engine=info"`);
+  lines.push(`# OpenTelemetry OTLP endpoint (optional \u2014 enables distributed tracing)`);
+  lines.push(`# otlp_endpoint = "http://localhost:4317"`);
+  lines.push(``);
+  if (mode === "gateway") {
+    lines.push(`[gateway]`);
+    lines.push(`# Worker pool for routing action execution`);
+    lines.push(`pool = "default"`);
+    lines.push(`# Maximum concurrent actions per worker`);
+    lines.push(`max_concurrent = 16`);
+    lines.push(`# Worker heartbeat interval`);
+    lines.push(`heartbeat = "30s"`);
+    lines.push(``);
+  }
+  if (mode !== "standalone") {
+    lines.push(`[redis]`);
+    lines.push(`# Redis URL for cross-instance communication`);
+    lines.push(`url = "$env:REDIS_URL"`);
+    lines.push(``);
+  }
+  lines.push(`[secrets]`);
+  lines.push(`# Secret provider: "env" (environment variables) or "vault" (HashiCorp Vault)`);
+  lines.push(`provider = "env"`);
+  lines.push(``);
+  lines.push(`# \u2500\u2500 Services \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`);
+  lines.push(`# Register external services for action routing.`);
+  lines.push(`# Each [[services]] block declares a service that can handle workflow actions.`);
+  lines.push(`#`);
+  lines.push(`# [[services]]`);
+  lines.push(`# name = "email"`);
+  lines.push(`# type = "webhook"`);
+  lines.push(`# url = "https://hooks.example.com/email"`);
+  lines.push(`# actions = ["send_email", "send_sms"]`);
+  lines.push(`# [services.labels]`);
+  lines.push(`# tier = "essential"`);
+  lines.push(``);
+  return lines.join("\n");
+}
+async function serverStatus(options) {
+  const apiUrl = options.apiUrl ?? "http://localhost:4200";
+  console.log(`[mmrc] Checking server at ${apiUrl}...`);
+  try {
+    const res = await fetch(`${apiUrl}/health`, { signal: AbortSignal.timeout(5e3) });
+    if (!res.ok) {
+      const result2 = {
+        reachable: true,
+        status: `unhealthy (HTTP ${res.status})`
+      };
+      console.log(`[mmrc] Server: ${result2.status}`);
+      return result2;
+    }
+    const data = await res.json();
+    const result = {
+      reachable: true,
+      status: data.status ?? "ok",
+      version: data.version,
+      uptime: data.uptime,
+      database: data.database ?? data.db ?? void 0
+    };
+    console.log(`[mmrc] Server:   ${result.status}`);
+    if (result.version) console.log(`[mmrc] Version:  ${result.version}`);
+    if (result.uptime) console.log(`[mmrc] Uptime:   ${result.uptime}`);
+    if (result.database) console.log(`[mmrc] Database: ${result.database}`);
+    return result;
+  } catch (e) {
+    const error = e.message;
+    const result = { reachable: false, error };
+    console.error(`[mmrc] Server unreachable: ${error}`);
+    console.error(`[mmrc] Is the server running? Try: mmrc server start`);
+    return result;
+  }
+}
+function serverConfig(options) {
+  const configPath = options.config ?? findConfigFile();
+  if (!configPath) {
+    console.log("[mmrc] No mm-server.toml found.");
+    console.log("[mmrc] Generate one with: mmrc server init");
+    return;
+  }
+  console.log(`[mmrc] Config file: ${configPath}
+`);
+  const raw = readFileSync(configPath, "utf-8");
+  const resolved = raw.replace(/\$env:(\w+)/g, (_match, varName) => {
+    const val = process.env[varName];
+    return val ? `${val}  # \u2190 $env:${varName}` : `(unset)  # \u2190 $env:${varName}`;
+  });
+  console.log(resolved);
+}
+function findConfigFile() {
+  const candidates = [
+    "mm-server.toml",
+    "engine/mm-server.toml",
+    "mm-core/mm-server.toml"
+  ];
+  for (const c of candidates) {
+    const abs = resolve(process.cwd(), c);
+    if (existsSync(abs)) return abs;
+  }
+  return null;
+}
+export {
+  findServerBinary,
+  generateServerToml,
+  serverConfig,
+  serverInit,
+  serverMigrate,
+  serverStart,
+  serverStatus
+};

package/dist/testing/index.d.mts

@@ -1,5 +1,5 @@
-import * as _mindmatrix_player_core from '@mindmatrix/player-core';
-import { IRWorkflowDefinition } from '@mindmatrix/player-core';
+import * as _mmapp_player_core from '@mmapp/player-core';
+import { IRWorkflowDefinition } from '@mmapp/player-core';
 
 interface CompileOptions {
     /** Compilation mode. Default: 'infer' */
@@ -39,7 +39,7 @@ declare function compileRaw(code: string, options?: CompileOptions): {
 /**
  * Mock blueprint context for testing workflow components.
  *
- * Provides the minimal context shape that @mindmatrix/react hooks expect.
+ * Provides the minimal context shape that @mmapp/react hooks expect.
  * Does NOT render React — this is a data-only mock for unit testing IR output.
  */
 interface MockBlueprintProviderProps {
@@ -99,9 +99,9 @@ declare function createMockWorkflowContext(props?: MockWorkflowProviderProps): {
 /**
  * Convenience: compile + extract specific parts of the IR.
  */
-declare function extractFields(code: string, options?: CompileOptions): _mindmatrix_player_core.IRFieldDefinition[];
-declare function extractStates(code: string, options?: CompileOptions): _mindmatrix_player_core.IRStateDefinition[];
-declare function extractTransitions(code: string, options?: CompileOptions): _mindmatrix_player_core.IRTransitionDefinition[];
+declare function extractFields(code: string, options?: CompileOptions): _mmapp_player_core.IRFieldDefinition[];
+declare function extractStates(code: string, options?: CompileOptions): _mmapp_player_core.IRStateDefinition[];
+declare function extractTransitions(code: string, options?: CompileOptions): _mmapp_player_core.IRTransitionDefinition[];
 
 /**
  * IR Snapshot Utilities — snapshot and compare compiled IR for regression testing.
@@ -111,7 +111,7 @@ declare function extractTransitions(code: string, options?: CompileOptions): _mi
  * toMatchIR() matcher.
  *
  * Usage:
- *   import { snapshotIR, installIRMatchers } from '@mindmatrix/react-compiler/testing';
+ *   import { snapshotIR, installIRMatchers } from '@mmapp/react-compiler/testing';
  *
  *   // In vitest setup or test file:
  *   installIRMatchers();
@@ -203,7 +203,7 @@ interface IRMatcher {
  * Install the toMatchIR() custom matcher into vitest's expect.
  *
  * Call this once in your test setup file or at the top of a test file:
- *   import { installIRMatchers } from '@mindmatrix/react-compiler/testing';
+ *   import { installIRMatchers } from '@mmapp/react-compiler/testing';
  *   installIRMatchers();
  */
 declare function installIRMatchers(): void;

package/dist/testing/index.d.ts

@@ -1,5 +1,5 @@
-import * as _mindmatrix_player_core from '@mindmatrix/player-core';
-import { IRWorkflowDefinition } from '@mindmatrix/player-core';
+import * as _mmapp_player_core from '@mmapp/player-core';
+import { IRWorkflowDefinition } from '@mmapp/player-core';
 
 interface CompileOptions {
     /** Compilation mode. Default: 'infer' */
@@ -39,7 +39,7 @@ declare function compileRaw(code: string, options?: CompileOptions): {
 /**
  * Mock blueprint context for testing workflow components.
  *
- * Provides the minimal context shape that @mindmatrix/react hooks expect.
+ * Provides the minimal context shape that @mmapp/react hooks expect.
  * Does NOT render React — this is a data-only mock for unit testing IR output.
  */
 interface MockBlueprintProviderProps {
@@ -99,9 +99,9 @@ declare function createMockWorkflowContext(props?: MockWorkflowProviderProps): {
 /**
  * Convenience: compile + extract specific parts of the IR.
  */
-declare function extractFields(code: string, options?: CompileOptions): _mindmatrix_player_core.IRFieldDefinition[];
-declare function extractStates(code: string, options?: CompileOptions): _mindmatrix_player_core.IRStateDefinition[];
-declare function extractTransitions(code: string, options?: CompileOptions): _mindmatrix_player_core.IRTransitionDefinition[];
+declare function extractFields(code: string, options?: CompileOptions): _mmapp_player_core.IRFieldDefinition[];
+declare function extractStates(code: string, options?: CompileOptions): _mmapp_player_core.IRStateDefinition[];
+declare function extractTransitions(code: string, options?: CompileOptions): _mmapp_player_core.IRTransitionDefinition[];
 
 /**
  * IR Snapshot Utilities — snapshot and compare compiled IR for regression testing.
@@ -111,7 +111,7 @@ declare function extractTransitions(code: string, options?: CompileOptions): _mi
  * toMatchIR() matcher.
  *
  * Usage:
- *   import { snapshotIR, installIRMatchers } from '@mindmatrix/react-compiler/testing';
+ *   import { snapshotIR, installIRMatchers } from '@mmapp/react-compiler/testing';
  *
  *   // In vitest setup or test file:
  *   installIRMatchers();
@@ -203,7 +203,7 @@ interface IRMatcher {
  * Install the toMatchIR() custom matcher into vitest's expect.
  *
  * Call this once in your test setup file or at the top of a test file:
- *   import { installIRMatchers } from '@mindmatrix/react-compiler/testing';
+ *   import { installIRMatchers } from '@mmapp/react-compiler/testing';
  *   installIRMatchers();
  */
 declare function installIRMatchers(): void;