npm - @gravito/flux - Versions diffs - 1.0.0-beta.1 → 1.0.0-beta.3 - Mend

@gravito/flux 1.0.0-beta.1 → 1.0.0-beta.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (69) hide show

package/README.zh-TW.md +409 -1
package/assets/flux-branching.svg +84 -0
package/bin/flux.js +96 -0
package/dev/viewer/app.js +131 -0
package/dev/viewer/index.html +52 -0
package/dev/viewer/styles.css +163 -0
package/dist/bun.cjs +7 -0
package/dist/bun.cjs.map +1 -0
package/dist/{storage/BunSQLiteStorage.d.ts → bun.d.cts} +8 -5
package/dist/bun.d.ts +72 -5
package/dist/bun.js +2 -2
package/dist/bun.js.map +1 -0
package/dist/chunk-J37UUMLM.js +858 -0
package/dist/chunk-J37UUMLM.js.map +1 -0
package/dist/chunk-RPECIW7O.cjs +858 -0
package/dist/chunk-RPECIW7O.cjs.map +1 -0
package/dist/chunk-SJSPR4ZU.cjs +173 -0
package/dist/chunk-SJSPR4ZU.cjs.map +1 -0
package/dist/{chunk-qjdtqchy.js → chunk-ZAMVC732.js} +35 -7
package/dist/chunk-ZAMVC732.js.map +1 -0
package/dist/index.cjs +121 -0
package/dist/index.cjs.map +1 -0
package/dist/index.d.cts +43 -0
package/dist/index.d.ts +40 -35
package/dist/index.js +102 -460
package/dist/index.js.map +1 -0
package/dist/index.node.cjs +28 -0
package/dist/index.node.cjs.map +1 -0
package/dist/index.node.d.cts +499 -0
package/dist/index.node.d.ts +494 -13
package/dist/index.node.js +28 -0
package/dist/index.node.js.map +1 -0
package/dist/{types.d.ts → types-DvVHBmP6.d.cts} +59 -18
package/dist/types-DvVHBmP6.d.ts +235 -0
package/package.json +32 -21
package/dist/builder/WorkflowBuilder.d.ts +0 -96
package/dist/builder/WorkflowBuilder.d.ts.map +0 -1
package/dist/builder/index.d.ts +0 -2
package/dist/builder/index.d.ts.map +0 -1
package/dist/bun.d.ts.map +0 -1
package/dist/core/ContextManager.d.ts +0 -40
package/dist/core/ContextManager.d.ts.map +0 -1
package/dist/core/StateMachine.d.ts +0 -43
package/dist/core/StateMachine.d.ts.map +0 -1
package/dist/core/StepExecutor.d.ts +0 -34
package/dist/core/StepExecutor.d.ts.map +0 -1
package/dist/core/index.d.ts +0 -4
package/dist/core/index.d.ts.map +0 -1
package/dist/engine/FluxEngine.d.ts +0 -66
package/dist/engine/FluxEngine.d.ts.map +0 -1
package/dist/engine/index.d.ts +0 -2
package/dist/engine/index.d.ts.map +0 -1
package/dist/index.d.ts.map +0 -1
package/dist/index.node.d.ts.map +0 -1
package/dist/logger/FluxLogger.d.ts +0 -40
package/dist/logger/FluxLogger.d.ts.map +0 -1
package/dist/logger/index.d.ts +0 -2
package/dist/logger/index.d.ts.map +0 -1
package/dist/node/index.mjs +0 -619
package/dist/orbit/OrbitFlux.d.ts +0 -107
package/dist/orbit/OrbitFlux.d.ts.map +0 -1
package/dist/orbit/index.d.ts +0 -2
package/dist/orbit/index.d.ts.map +0 -1
package/dist/storage/BunSQLiteStorage.d.ts.map +0 -1
package/dist/storage/MemoryStorage.d.ts +0 -28
package/dist/storage/MemoryStorage.d.ts.map +0 -1
package/dist/storage/index.d.ts +0 -3
package/dist/storage/index.d.ts.map +0 -1
package/dist/types.d.ts.map +0 -1

package/dev/viewer/app.js ADDED Viewed

@@ -0,0 +1,131 @@
+const pathEl = document.getElementById('tracePath')
+const updateEl = document.getElementById('lastUpdate')
+const pathElContainer = document.getElementById('path')
+const statusEl = document.getElementById('status')
+const eventsEl = document.getElementById('events')
+const state = {
+  events: [],
+  lastHash: '',
+}
+const formatTime = (ts) => new Date(ts).toLocaleTimeString()
+const parseNdjson = (text) =>
+  text
+    .split('\n')
+    .map((line) => line.trim())
+    .filter(Boolean)
+    .map((line) => {
+      try {
+        return JSON.parse(line)
+      } catch {
+        return null
+      }
+    })
+    .filter(Boolean)
+const hashText = (text) => {
+  let hash = 0
+  for (let i = 0; i < text.length; i += 1) {
+    hash = (hash << 5) - hash + text.charCodeAt(i)
+    hash |= 0
+  }
+  return String(hash)
+}
+const renderPath = (events) => {
+  const steps = []
+  const seen = new Set()
+  for (const event of events) {
+    if (event.stepName && event.type.startsWith('step:')) {
+      if (!seen.has(event.stepName)) {
+        seen.add(event.stepName)
+        steps.push(event.stepName)
+      }
+    }
+  }
+  if (!steps.length) {
+    pathElContainer.innerHTML = '<div class="empty">No execution data yet.</div>'
+    return
+  }
+  pathElContainer.innerHTML = steps
+    .map((step, index) => {
+      const node = `<span class="node">${step}</span>`
+      const arrow = index < steps.length - 1 ? '<span class="arrow">-&gt;</span>' : ''
+      return `${node}${arrow}`
+    })
+    .join('')
+}
+const renderStatus = (events) => {
+  if (!events.length) {
+    statusEl.innerHTML = '<div class="empty">No trace events.</div>'
+    return
+  }
+  const lastWorkflow = [...events]
+    .reverse()
+    .find((event) => event.type.startsWith('workflow:'))
+  const status = lastWorkflow?.status ?? 'unknown'
+  const badgeClass = status === 'completed' ? 'ok' : status === 'failed' ? 'fail' : ''
+  statusEl.innerHTML = `
+    <div>Workflow: <span class="badge ${badgeClass}">${status}</span></div>
+    <div>Workflow ID: ${lastWorkflow?.workflowId ?? '-'}</div>
+    <div>Workflow Name: ${lastWorkflow?.workflowName ?? '-'}</div>
+    <div>Duration: ${lastWorkflow?.duration ? `${lastWorkflow.duration}ms` : '-'}</div>
+  `
+}
+const renderEvents = (events) => {
+  if (!events.length) {
+    eventsEl.innerHTML = '<tr><td colspan="6" class="empty">No events yet.</td></tr>'
+    return
+  }
+  eventsEl.innerHTML = events
+    .slice()
+    .reverse()
+    .map((event) => {
+      const retry =
+        typeof event.retries === 'number'
+          ? `${event.retries}${event.maxRetries ? `/${event.maxRetries}` : ''}`
+          : '-'
+      const duration = event.duration ? `${event.duration}ms` : '-'
+      const msg = event.error ?? ''
+      return `
+        <tr>
+          <td>${formatTime(event.timestamp)}</td>
+          <td>${event.type}</td>
+          <td>${event.stepName ?? '-'}</td>
+          <td>${retry}</td>
+          <td>${duration}</td>
+          <td>${msg}</td>
+        </tr>
+      `
+    })
+    .join('')
+}
+const refresh = async () => {
+  const res = await fetch('/trace', { cache: 'no-store' })
+  const text = await res.text()
+  const hash = hashText(text)
+  if (hash === state.lastHash) return
+  state.lastHash = hash
+  state.events = parseNdjson(text)
+  pathEl.textContent = 'Trace: /trace'
+  updateEl.textContent = `Updated: ${new Date().toLocaleTimeString()}`
+  renderPath(state.events)
+  renderStatus(state.events)
+  renderEvents(state.events)
+}
+refresh()
+setInterval(refresh, 1500)

package/dev/viewer/index.html ADDED Viewed

@@ -0,0 +1,52 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width,initial-scale=1" />
+    <title>Flux Dev Viewer</title>
+    <link rel="stylesheet" href="/styles.css" />
+  </head>
+  <body>
+    <header class="topbar">
+      <div>
+        <h1>Flux Dev Viewer</h1>
+        <p class="subtitle">Local workflow trace explorer</p>
+      </div>
+      <div class="meta">
+        <div id="tracePath">Trace: -</div>
+        <div id="lastUpdate">Updated: -</div>
+      </div>
+    </header>
+    <main class="grid">
+      <section class="card">
+        <h2>Execution Path</h2>
+        <div id="path" class="path"></div>
+      </section>
+      <section class="card">
+        <h2>Status</h2>
+        <div id="status" class="status"></div>
+      </section>
+      <section class="card full">
+        <h2>Timeline</h2>
+        <table class="timeline">
+          <thead>
+            <tr>
+              <th>Time</th>
+              <th>Event</th>
+              <th>Step</th>
+              <th>Retry</th>
+              <th>Duration</th>
+              <th>Message</th>
+            </tr>
+          </thead>
+          <tbody id="events"></tbody>
+        </table>
+      </section>
+    </main>
+    <script src="/app.js"></script>
+  </body>
+</html>

package/dev/viewer/styles.css ADDED Viewed

@@ -0,0 +1,163 @@
+* {
+  box-sizing: border-box;
+}
+body {
+  margin: 0;
+  font-family: ui-sans-serif, system-ui, -apple-system, sans-serif;
+  background: #0c0f14;
+  color: #e6eaf2;
+}
+.topbar {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 20px 32px;
+  border-bottom: 1px solid #1d2330;
+  background: linear-gradient(120deg, #111826, #0f1420);
+}
+.topbar h1 {
+  margin: 0 0 6px;
+  font-size: 20px;
+  letter-spacing: 0.04em;
+}
+.subtitle {
+  margin: 0;
+  color: #93a0b4;
+  font-size: 13px;
+}
+.meta {
+  text-align: right;
+  font-size: 12px;
+  color: #9aa6ba;
+  line-height: 1.6;
+}
+.grid {
+  display: grid;
+  gap: 18px;
+  padding: 24px 32px 40px;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+}
+.card {
+  background: #131a26;
+  border: 1px solid #1d2330;
+  border-radius: 14px;
+  padding: 18px 18px 12px;
+  box-shadow: 0 10px 30px rgba(0, 0, 0, 0.25);
+}
+.card.full {
+  grid-column: 1 / -1;
+}
+.card h2 {
+  margin: 0 0 14px;
+  font-size: 14px;
+  color: #c7d1e6;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+}
+.path {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 10px;
+  align-items: center;
+}
+.node {
+  padding: 8px 12px;
+  border-radius: 999px;
+  background: #1a2333;
+  border: 1px solid #2b3a52;
+  font-size: 12px;
+  color: #d6deec;
+}
+.arrow {
+  color: #7c8da7;
+  font-size: 14px;
+}
+.status {
+  display: grid;
+  gap: 8px;
+  font-size: 13px;
+  color: #b9c5d9;
+}
+.badge {
+  display: inline-block;
+  padding: 2px 8px;
+  border-radius: 999px;
+  font-size: 11px;
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+  background: #1e2532;
+  color: #9db0cc;
+  border: 1px solid #2b364a;
+}
+.badge.ok {
+  background: rgba(34, 197, 94, 0.15);
+  color: #7ee4a6;
+  border-color: rgba(34, 197, 94, 0.3);
+}
+.badge.fail {
+  background: rgba(248, 113, 113, 0.15);
+  color: #fca5a5;
+  border-color: rgba(248, 113, 113, 0.3);
+}
+.timeline {
+  width: 100%;
+  border-collapse: collapse;
+  font-size: 12px;
+}
+.timeline th,
+.timeline td {
+  padding: 10px 8px;
+  border-bottom: 1px solid #1d2330;
+  text-align: left;
+}
+.timeline th {
+  color: #91a0b7;
+  font-weight: 600;
+  font-size: 11px;
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+}
+.timeline tr:last-child td {
+  border-bottom: none;
+}
+.empty {
+  color: #7f8ba3;
+  font-size: 12px;
+  padding: 10px 0;
+}
+@media (max-width: 900px) {
+  .grid {
+    grid-template-columns: 1fr;
+  }
+  .meta {
+    text-align: left;
+    margin-top: 10px;
+  }
+  .topbar {
+    flex-direction: column;
+    align-items: flex-start;
+    gap: 12px;
+  }
+}

package/dist/bun.cjs ADDED Viewed

@@ -0,0 +1,7 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+var _chunkSJSPR4ZUcjs = require('./chunk-SJSPR4ZU.cjs');
+exports.BunSQLiteStorage = _chunkSJSPR4ZUcjs.BunSQLiteStorage;
+//# sourceMappingURL=bun.cjs.map

package/dist/bun.cjs.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"sources":["/Users/carl/Dev/Carl/gravito-core/packages/flux/dist/bun.cjs"],"names":[],"mappings":"AAAA;AACE;AACF,wDAA6B;AAC7B;AACE;AACF,8DAAC","file":"/Users/carl/Dev/Carl/gravito-core/packages/flux/dist/bun.cjs"}

package/dist/{storage/BunSQLiteStorage.d.ts → bun.d.cts} RENAMED Viewed

@@ -1,3 +1,6 @@
+import { Database } from 'bun:sqlite';
+import { n as WorkflowStorage, l as WorkflowState, k as WorkflowFilter } from './types-DvVHBmP6.cjs';
 /**
  * @fileoverview Bun SQLite Storage Adapter
  *
@@ -5,12 +8,11 @@
  *
  * @module @gravito/flux/storage
  */
-import { Database } from 'bun:sqlite';
-import type { WorkflowFilter, WorkflowState, WorkflowStorage } from '../types';
 /**
  * SQLite Storage Options
  */
-export interface BunSQLiteStorageOptions {
+interface BunSQLiteStorageOptions {
     /** Database file path (default: ':memory:') */
     path?: string;
     /** Table name (default: 'flux_workflows') */
@@ -28,7 +30,7 @@ export interface BunSQLiteStorageOptions {
  * })
  * ```
  */
-export declare class BunSQLiteStorage implements WorkflowStorage {
+declare class BunSQLiteStorage implements WorkflowStorage {
     private db;
     private tableName;
     private initialized;
@@ -70,4 +72,5 @@ export declare class BunSQLiteStorage implements WorkflowStorage {
      */
     vacuum(): void;
 }
-//# sourceMappingURL=BunSQLiteStorage.d.ts.map
+export { BunSQLiteStorage, type BunSQLiteStorageOptions };

package/dist/bun.d.ts CHANGED Viewed

@@ -1,9 +1,76 @@
+import { Database } from 'bun:sqlite';
+import { n as WorkflowStorage, l as WorkflowState, k as WorkflowFilter } from './types-DvVHBmP6.js';
 /**
- * @fileoverview Bun-specific exports
+ * @fileoverview Bun SQLite Storage Adapter
  *
- * This entry exports Bun-optimized components.
+ * High-performance storage using Bun's built-in SQLite.
  *
- * @module @gravito/flux/bun
+ * @module @gravito/flux/storage
  */
-export { BunSQLiteStorage, type BunSQLiteStorageOptions } from './storage/BunSQLiteStorage';
-//# sourceMappingURL=bun.d.ts.map
+/**
+ * SQLite Storage Options
+ */
+interface BunSQLiteStorageOptions {
+    /** Database file path (default: ':memory:') */
+    path?: string;
+    /** Table name (default: 'flux_workflows') */
+    tableName?: string;
+}
+/**
+ * Bun SQLite Storage
+ *
+ * High-performance storage adapter using Bun's built-in SQLite.
+ *
+ * @example
+ * ```typescript
+ * const engine = new FluxEngine({
+ *   storage: new BunSQLiteStorage({ path: './data/flux.db' })
+ * })
+ * ```
+ */
+declare class BunSQLiteStorage implements WorkflowStorage {
+    private db;
+    private tableName;
+    private initialized;
+    constructor(options?: BunSQLiteStorageOptions);
+    /**
+     * Initialize storage (create tables)
+     */
+    init(): Promise<void>;
+    /**
+     * Save workflow state
+     */
+    save(state: WorkflowState): Promise<void>;
+    /**
+     * Load workflow state by ID
+     */
+    load(id: string): Promise<WorkflowState | null>;
+    /**
+     * List workflow states with optional filter
+     */
+    list(filter?: WorkflowFilter): Promise<WorkflowState[]>;
+    /**
+     * Delete workflow state
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Close database connection
+     */
+    close(): Promise<void>;
+    /**
+     * Convert SQLite row to WorkflowState
+     */
+    private rowToState;
+    /**
+     * Get raw database (for advanced usage)
+     */
+    getDatabase(): Database;
+    /**
+     * Run a vacuum to optimize database
+     */
+    vacuum(): void;
+}
+export { BunSQLiteStorage, type BunSQLiteStorageOptions };

package/dist/bun.js CHANGED Viewed

@@ -1,7 +1,7 @@
-// @bun
 import {
   BunSQLiteStorage
-} from "./chunk-qjdtqchy.js";
+} from "./chunk-ZAMVC732.js";
 export {
   BunSQLiteStorage
 };
+//# sourceMappingURL=bun.js.map

package/dist/bun.js.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}