chainlesschain 0.37.10 → 0.37.12

package/src/lib/app-builder.js

@@ -0,0 +1,377 @@
+/**
+ * Low-Code App Builder — create, design, preview, publish, and manage
+ * low-code applications with built-in components and data sources.
+ */
+
+import crypto from "crypto";
+
+/** @type {Map<string, object>} In-memory app cache */
+const _apps = new Map();
+
+/** @type {Map<string, object>} In-memory data sources */
+const _dataSources = new Map();
+
+/** @type {Map<string, object[]>} In-memory version history */
+const _versions = new Map();
+
+/** @type {object[]|null} Cached built-in component list */
+let _components = null;
+
+/**
+ * Return the 15 built-in components, initializing on first call.
+ *
+ * @returns {object[]}
+ */
+export function listComponents() {
+  if (!_components) {
+    _components = [
+      {
+        name: "Form",
+        category: "input",
+        props: ["fields", "onSubmit", "validation"],
+      },
+      {
+        name: "DataTable",
+        category: "display",
+        props: ["columns", "data", "pagination", "sortable"],
+      },
+      {
+        name: "BarChart",
+        category: "chart",
+        props: ["data", "xAxis", "yAxis", "colors"],
+      },
+      {
+        name: "LineChart",
+        category: "chart",
+        props: ["data", "xAxis", "yAxis", "smooth"],
+      },
+      {
+        name: "PieChart",
+        category: "chart",
+        props: ["data", "labels", "colors"],
+      },
+      {
+        name: "Dashboard",
+        category: "layout",
+        props: ["widgets", "layout", "refreshInterval"],
+      },
+      {
+        name: "Button",
+        category: "input",
+        props: ["label", "onClick", "variant", "disabled"],
+      },
+      {
+        name: "TextInput",
+        category: "input",
+        props: ["placeholder", "value", "onChange", "type"],
+      },
+      {
+        name: "Select",
+        category: "input",
+        props: ["options", "value", "onChange", "multiple"],
+      },
+      {
+        name: "Modal",
+        category: "overlay",
+        props: ["visible", "title", "onClose", "width"],
+      },
+      {
+        name: "Card",
+        category: "layout",
+        props: ["title", "content", "footer"],
+      },
+      {
+        name: "List",
+        category: "display",
+        props: ["items", "renderItem", "pagination"],
+      },
+      {
+        name: "Image",
+        category: "display",
+        props: ["src", "alt", "width", "height"],
+      },
+      {
+        name: "Tabs",
+        category: "layout",
+        props: ["tabs", "activeKey", "onChange"],
+      },
+      {
+        name: "Calendar",
+        category: "display",
+        props: ["events", "view", "onSelect"],
+      },
+    ];
+  }
+  return _components;
+}
+
+/**
+ * Ensure low-code tables exist in the database.
+ *
+ * @param {object} db
+ */
+export function ensureLowcodeTables(db) {
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS lowcode_apps (
+      id TEXT PRIMARY KEY,
+      name TEXT NOT NULL,
+      description TEXT,
+      design TEXT,
+      status TEXT DEFAULT 'draft',
+      version INTEGER DEFAULT 1,
+      platform TEXT DEFAULT 'web',
+      created_at TEXT DEFAULT (datetime('now')),
+      updated_at TEXT DEFAULT (datetime('now'))
+    )
+  `);
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS lowcode_datasources (
+      id TEXT PRIMARY KEY,
+      app_id TEXT NOT NULL,
+      name TEXT NOT NULL,
+      type TEXT NOT NULL,
+      config TEXT,
+      status TEXT DEFAULT 'active',
+      created_at TEXT DEFAULT (datetime('now'))
+    )
+  `);
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS lowcode_versions (
+      id TEXT PRIMARY KEY,
+      app_id TEXT NOT NULL,
+      version INTEGER NOT NULL,
+      snapshot TEXT,
+      created_at TEXT DEFAULT (datetime('now'))
+    )
+  `);
+}
+
+/**
+ * Create a new low-code application.
+ *
+ * @param {object} db
+ * @param {{ name: string, description?: string, platform?: string, design?: object }} definition
+ * @returns {{ id: string, name: string, status: string }}
+ */
+export function createApp(db, definition) {
+  const id = crypto.randomUUID().slice(0, 12);
+  const name = definition.name || "Untitled App";
+  const description = definition.description || "";
+  const platform = definition.platform || "web";
+  const design = definition.design || { components: [], layout: {} };
+
+  const stmt = db.prepare(
+    `INSERT INTO lowcode_apps (id, name, description, design, status, version, platform)
+     VALUES (?, ?, ?, ?, ?, ?, ?)`,
+  );
+  stmt.run(id, name, description, JSON.stringify(design), "draft", 1, platform);
+
+  const app = {
+    id,
+    name,
+    description,
+    platform,
+    design,
+    status: "draft",
+    version: 1,
+  };
+  _apps.set(id, app);
+
+  // Create initial version snapshot
+  const versionId = crypto.randomUUID().slice(0, 12);
+  const vStmt = db.prepare(
+    `INSERT INTO lowcode_versions (id, app_id, version, snapshot)
+     VALUES (?, ?, ?, ?)`,
+  );
+  vStmt.run(versionId, id, 1, JSON.stringify(design));
+
+  if (!_versions.has(id)) _versions.set(id, []);
+  _versions
+    .get(id)
+    .push({ id: versionId, app_id: id, version: 1, snapshot: design });
+
+  return { id, name, status: "draft" };
+}
+
+/**
+ * Save a new design for an app, bump the version, and create a snapshot.
+ *
+ * @param {object} db
+ * @param {string} appId
+ * @param {object} design
+ * @returns {{ appId: string, version: number }}
+ */
+export function saveDesign(db, appId, design) {
+  // Get current version
+  const row = db
+    .prepare(`SELECT version FROM lowcode_apps WHERE id = ?`)
+    .get(appId);
+  const currentVersion = row ? row.version || 1 : 1;
+  const newVersion = currentVersion + 1;
+
+  db.prepare(
+    `UPDATE lowcode_apps SET design = ?, version = ?, updated_at = datetime('now') WHERE id = ?`,
+  ).run(JSON.stringify(design), newVersion, appId);
+
+  // Create version snapshot
+  const versionId = crypto.randomUUID().slice(0, 12);
+  db.prepare(
+    `INSERT INTO lowcode_versions (id, app_id, version, snapshot) VALUES (?, ?, ?, ?)`,
+  ).run(versionId, appId, newVersion, JSON.stringify(design));
+
+  if (!_versions.has(appId)) _versions.set(appId, []);
+  _versions
+    .get(appId)
+    .push({
+      id: versionId,
+      app_id: appId,
+      version: newVersion,
+      snapshot: design,
+    });
+
+  if (_apps.has(appId)) {
+    _apps.get(appId).design = design;
+    _apps.get(appId).version = newVersion;
+  }
+
+  return { appId, version: newVersion };
+}
+
+/**
+ * Get preview info for an application.
+ *
+ * @param {string} appId
+ * @returns {{ appId: string, design: object, previewUrl: string, platform: string }}
+ */
+export function previewApp(appId) {
+  const app = _apps.get(appId);
+  const design = app ? app.design : { components: [], layout: {} };
+  const platform = app ? app.platform : "web";
+
+  return {
+    appId,
+    design,
+    previewUrl: `http://localhost:5173/lowcode/preview/${appId}`,
+    platform,
+  };
+}
+
+/**
+ * Publish an application (set status to 'published').
+ *
+ * @param {object} db
+ * @param {string} appId
+ * @returns {{ appId: string, status: string }}
+ */
+export function publishApp(db, appId) {
+  db.prepare(
+    `UPDATE lowcode_apps SET status = ?, updated_at = datetime('now') WHERE id = ?`,
+  ).run("published", appId);
+
+  if (_apps.has(appId)) {
+    _apps.get(appId).status = "published";
+  }
+
+  return { appId, status: "published" };
+}
+
+/**
+ * Add a data source to an application.
+ *
+ * @param {object} db
+ * @param {string} appId
+ * @param {string} name
+ * @param {string} type - e.g. "rest", "graphql", "database", "csv"
+ * @param {object} config
+ * @returns {{ id: string, appId: string, name: string, type: string }}
+ */
+export function addDataSource(db, appId, name, type, config) {
+  const id = crypto.randomUUID().slice(0, 12);
+  const stmt = db.prepare(
+    `INSERT INTO lowcode_datasources (id, app_id, name, type, config, status)
+     VALUES (?, ?, ?, ?, ?, ?)`,
+  );
+  stmt.run(id, appId, name, type, JSON.stringify(config || {}), "active");
+
+  _dataSources.set(id, { id, appId, name, type, config, status: "active" });
+
+  return { id, appId, name, type };
+}
+
+/**
+ * Get version history for an application.
+ *
+ * @param {string} appId
+ * @returns {object[]}
+ */
+export function getVersions(appId) {
+  return _versions.get(appId) || [];
+}
+
+/**
+ * Rollback an application to a previous version.
+ *
+ * @param {object} db
+ * @param {string} appId
+ * @param {number} version
+ * @returns {{ appId: string, version: number, restored: boolean }}
+ */
+export function rollbackApp(db, appId, version) {
+  const versions = _versions.get(appId) || [];
+  const target = versions.find((v) => v.version === version);
+
+  if (!target) {
+    return { appId, version, restored: false };
+  }
+
+  const design = target.snapshot;
+  db.prepare(
+    `UPDATE lowcode_apps SET design = ?, version = ?, updated_at = datetime('now') WHERE id = ?`,
+  ).run(JSON.stringify(design), version, appId);
+
+  if (_apps.has(appId)) {
+    _apps.get(appId).design = design;
+    _apps.get(appId).version = version;
+  }
+
+  return { appId, version, restored: true };
+}
+
+/**
+ * Export an app definition with data sources.
+ *
+ * @param {string} appId
+ * @returns {{ appId: string, app: object|null, dataSources: object[], versions: object[] }}
+ */
+export function exportApp(appId) {
+  const app = _apps.get(appId) || null;
+  const dataSources = [];
+  for (const [, ds] of _dataSources) {
+    if (ds.appId === appId) dataSources.push(ds);
+  }
+  const versions = _versions.get(appId) || [];
+
+  return { appId, app, dataSources, versions };
+}
+
+/**
+ * List all applications from the database.
+ *
+ * @param {object} db
+ * @returns {object[]}
+ */
+export function listApps(db) {
+  const rows = db
+    .prepare(`SELECT * FROM lowcode_apps ORDER BY updated_at DESC`)
+    .all();
+  return rows.map((r) => ({
+    id: r.id,
+    name: r.name,
+    description: r.description,
+    status: r.status,
+    version: r.version,
+    platform: r.platform,
+    created_at: r.created_at,
+    updated_at: r.updated_at,
+  }));
+}

package/src/lib/bi-engine.js

@@ -0,0 +1,299 @@
+/**
+ * BI Engine — Business intelligence with NL→SQL queries, dashboards,
+ * reports, anomaly detection, trend prediction, and scheduling.
+ */
+
+import crypto from "crypto";
+
+/* ── In-memory stores ──────────────────────────────────────── */
+const _dashboards = new Map();
+const _reports = new Map();
+const _scheduledReports = new Map();
+
+const _templates = [
+  {
+    id: "tpl-kpi",
+    name: "KPI Dashboard",
+    description: "Key performance indicators overview",
+    widgets: ["metric-card", "sparkline", "gauge"],
+  },
+  {
+    id: "tpl-sales",
+    name: "Sales Report",
+    description: "Sales pipeline and revenue analysis",
+    widgets: ["bar-chart", "funnel", "table"],
+  },
+  {
+    id: "tpl-ops",
+    name: "Operations Dashboard",
+    description: "System health and operational metrics",
+    widgets: ["heatmap", "timeline", "alert-list"],
+  },
+  {
+    id: "tpl-hr",
+    name: "HR Analytics",
+    description: "Workforce analytics and headcount",
+    widgets: ["pie-chart", "trend-line", "scorecard"],
+  },
+  {
+    id: "tpl-finance",
+    name: "Financial Overview",
+    description: "Revenue, expenses, and cash flow",
+    widgets: ["waterfall", "stacked-bar", "summary-table"],
+  },
+];
+
+/* ── Schema ────────────────────────────────────────────────── */
+
+export function ensureBITables(db) {
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS bi_dashboards (
+      id TEXT PRIMARY KEY,
+      name TEXT NOT NULL,
+      widgets TEXT,
+      layout TEXT,
+      created_at TEXT DEFAULT (datetime('now')),
+      updated_at TEXT DEFAULT (datetime('now'))
+    )
+  `);
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS bi_reports (
+      id TEXT PRIMARY KEY,
+      name TEXT NOT NULL,
+      query TEXT,
+      result TEXT,
+      format TEXT DEFAULT 'pdf',
+      created_at TEXT DEFAULT (datetime('now'))
+    )
+  `);
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS bi_scheduled (
+      id TEXT PRIMARY KEY,
+      report_id TEXT NOT NULL,
+      cron TEXT NOT NULL,
+      recipients TEXT,
+      last_run TEXT,
+      status TEXT DEFAULT 'active'
+    )
+  `);
+}
+
+/* ── NL → SQL Query ────────────────────────────────────────── */
+
+export function nlQuery(query) {
+  if (!query || typeof query !== "string") {
+    throw new Error("Query must be a non-empty string");
+  }
+
+  // Mock NL→SQL translation: generate a SELECT LIKE query
+  const sanitized = query.replace(/['"]/g, "").trim();
+  const words = sanitized.split(/\s+/).slice(0, 3).join("_").toLowerCase();
+  const generatedSQL = `SELECT * FROM data WHERE content LIKE '%${words}%'`;
+
+  const id = crypto.randomUUID();
+  const results = [];
+  const visualization = {
+    type: "table",
+    title: query,
+    columns: ["id", "content", "value"],
+  };
+
+  return {
+    id,
+    query,
+    generatedSQL,
+    results,
+    rowCount: results.length,
+    visualization,
+  };
+}
+
+/* ── Reports ───────────────────────────────────────────────── */
+
+export function generateReport(db, name, options) {
+  const id = crypto.randomUUID();
+  const now = new Date().toISOString();
+  const format = (options && options.format) || "pdf";
+
+  const sectionNames = (options && options.sections) || [
+    "summary",
+    "details",
+    "conclusion",
+  ];
+  const sections = sectionNames.map((s) => ({
+    name: s,
+    content: `Auto-generated ${s} section`,
+    generatedAt: now,
+  }));
+
+  const report = {
+    id,
+    name,
+    format,
+    sections,
+    generatedAt: now,
+  };
+
+  _reports.set(id, report);
+
+  db.prepare(
+    `INSERT INTO bi_reports (id, name, query, result, format, created_at)
+     VALUES (?, ?, ?, ?, ?, ?)`,
+  ).run(id, name, "", JSON.stringify(report), format, now);
+
+  return report;
+}
+
+/* ── Dashboards ────────────────────────────────────────────── */
+
+export function createDashboard(db, name, widgets, layout) {
+  const id = crypto.randomUUID();
+  const now = new Date().toISOString();
+
+  const dashboard = {
+    id,
+    name,
+    widgets: widgets || [],
+    layout: layout || { type: "grid", columns: 2 },
+    createdAt: now,
+  };
+
+  _dashboards.set(id, dashboard);
+
+  db.prepare(
+    `INSERT INTO bi_dashboards (id, name, widgets, layout, created_at, updated_at)
+     VALUES (?, ?, ?, ?, ?, ?)`,
+  ).run(
+    id,
+    name,
+    JSON.stringify(dashboard.widgets),
+    JSON.stringify(dashboard.layout),
+    now,
+    now,
+  );
+
+  return dashboard;
+}
+
+/* ── Anomaly Detection ─────────────────────────────────────── */
+
+export function detectAnomaly(data, options) {
+  if (!Array.isArray(data) || data.length === 0) {
+    throw new Error("Data must be a non-empty array of numbers");
+  }
+
+  const threshold = (options && options.threshold) || 2;
+  const n = data.length;
+  const mean = data.reduce((s, v) => s + v, 0) / n;
+  const variance = data.reduce((s, v) => s + (v - mean) ** 2, 0) / n;
+  const std = Math.sqrt(variance);
+
+  const anomalies = [];
+  if (std > 0) {
+    for (let i = 0; i < data.length; i++) {
+      const zScore = Math.abs((data[i] - mean) / std);
+      if (zScore > threshold) {
+        anomalies.push({ index: i, value: data[i], zScore });
+      }
+    }
+  }
+
+  return { anomalies, mean, std, threshold };
+}
+
+/* ── Trend Prediction ──────────────────────────────────────── */
+
+export function predictTrend(data, periods) {
+  if (!Array.isArray(data) || data.length < 2) {
+    throw new Error("Data must be an array with at least 2 points");
+  }
+
+  const n = data.length;
+  const periodsToPredict = periods || 3;
+
+  // Simple linear regression: y = slope * x + intercept
+  let sumX = 0;
+  let sumY = 0;
+  let sumXY = 0;
+  let sumX2 = 0;
+
+  for (let i = 0; i < n; i++) {
+    sumX += i;
+    sumY += data[i];
+    sumXY += i * data[i];
+    sumX2 += i * i;
+  }
+
+  const slope = (n * sumXY - sumX * sumY) / (n * sumX2 - sumX * sumX);
+  const intercept = (sumY - slope * sumX) / n;
+
+  const predictions = [];
+  for (let i = 0; i < periodsToPredict; i++) {
+    const x = n + i;
+    predictions.push(Math.round((slope * x + intercept) * 100) / 100);
+  }
+
+  let trend;
+  if (Math.abs(slope) < 0.001) {
+    trend = "flat";
+  } else if (slope > 0) {
+    trend = "up";
+  } else {
+    trend = "down";
+  }
+
+  return { predictions, trend, slope: Math.round(slope * 1000) / 1000 };
+}
+
+/* ── Templates ─────────────────────────────────────────────── */
+
+export function listTemplates() {
+  return [..._templates];
+}
+
+/* ── Scheduling ────────────────────────────────────────────── */
+
+export function scheduleReport(db, reportId, cron, recipients) {
+  const id = crypto.randomUUID();
+  const schedule = {
+    id,
+    reportId,
+    cron,
+    recipients: recipients || [],
+    lastRun: null,
+    status: "active",
+  };
+
+  _scheduledReports.set(id, schedule);
+
+  db.prepare(
+    `INSERT INTO bi_scheduled (id, report_id, cron, recipients, last_run, status)
+     VALUES (?, ?, ?, ?, ?, ?)`,
+  ).run(id, reportId, cron, JSON.stringify(schedule.recipients), "", "active");
+
+  return schedule;
+}
+
+/* ── Export ─────────────────────────────────────────────────── */
+
+export function exportReport(reportId, format) {
+  const report = _reports.get(reportId);
+  if (!report) throw new Error(`Report not found: ${reportId}`);
+
+  const exportFormat = format || report.format || "pdf";
+  return {
+    reportId,
+    format: exportFormat,
+    filename: `${report.name.replace(/\s+/g, "_")}.${exportFormat}`,
+    size: 0,
+    exportedAt: new Date().toISOString(),
+  };
+}
+
+/* ── Reset (for testing) ───────────────────────────────────── */
+
+export function _resetState() {
+  _dashboards.clear();
+  _reports.clear();
+  _scheduledReports.clear();
+}