khotan-data 0.0.1 → 0.1.1

package/dist/templates/catch.ts

@@ -0,0 +1,119 @@
+// ============================================================================
+// Catch — durable webhook event processing via Vercel Workflow
+// Generated by khotan CLI · https://github.com/khotan-data
+//
+// This file defines the catchEvent() builder and types. Create per-service
+// catch files (e.g. pollinate-catch.ts) using this builder to handle verified
+// webhook events with durable, retryable workflow steps.
+//
+// Catch workflows receive a CatchContext with the parsed event payload,
+// event type, and headers. Steps have full Node.js access — import your
+// own db, services, etc.
+// ============================================================================
+
+// ---------------------------------------------------------------------------
+// Context — serializable data passed to the workflow
+// ---------------------------------------------------------------------------
+
+export interface CatchContext {
+  /** Parsed webhook payload */
+  event: Record<string, unknown>;
+  /** Event type extracted from payload (e.g. "order.created") */
+  eventType: string;
+  /** Incoming request headers */
+  headers: Record<string, string>;
+  /** Khotan run ID created for this webhook handler execution */
+  khotanRunId: string;
+  /** Internal Khotan instance identifier for helper APIs */
+  khotanInstanceId: string;
+}
+
+// ---------------------------------------------------------------------------
+// Workflow type — the function signature your workflow must conform to
+// ---------------------------------------------------------------------------
+
+export type CatchWorkflow = (ctx: CatchContext) => Promise<void>;
+
+// ---------------------------------------------------------------------------
+// Config — passed to the catchEvent() builder
+// ---------------------------------------------------------------------------
+
+export interface CatchConfig {
+  /** Unique name for this catch handler (used for DB tracking and Hub display) */
+  name: string;
+  /** Event types this catch should receive */
+  events?: string[];
+  /** Workflow function that processes the event */
+  workflow: CatchWorkflow;
+}
+
+// ---------------------------------------------------------------------------
+// Registration — returned by catchEvent(), consumed by factory config
+// ---------------------------------------------------------------------------
+
+export interface CatchRegistration {
+  type: "catch";
+  name: string;
+  events?: string[];
+  workflow: CatchWorkflow;
+}
+
+// ---------------------------------------------------------------------------
+// Builder
+// ---------------------------------------------------------------------------
+
+export function catchEvent(config: CatchConfig): CatchRegistration {
+  return {
+    type: "catch",
+    name: config.name,
+    events: config.events,
+    workflow: config.workflow,
+  };
+}
+
+// ---------------------------------------------------------------------------
+// Usage Example (create a file like webhooks/pollinate-catch.ts)
+// ---------------------------------------------------------------------------
+//
+// import { khotanCache } from "khotan-data/factory";
+// import { catchEvent, type CatchContext } from "./catch";
+// Khotan already records webhook deliveries in khotan_webhook_events and links
+// them to khotan_runs. Use your catch workflow for app-specific side effects
+// and optionally khotanCache(ctx, "name") for dedupe or cursor state.
+//
+// async function pollinateCatchWorkflow(ctx: CatchContext) {
+//   "use workflow";
+//
+//   async function notifyOps() {
+//     "use step";
+//     const cache = khotanCache(ctx, "pollinate-webhook-markers");
+//     const eventId = String(ctx.event["id"] ?? "");
+//     if (eventId && (await cache.get<boolean>(eventId))) return;
+//
+//     console.log("Handled webhook", {
+//       eventType: ctx.eventType,
+//       khotanRunId: ctx.khotanRunId,
+//     });
+//
+//     if (eventId) {
+//       await cache.set(eventId, true);
+//     }
+//   }
+//
+//   await notifyOps();
+// }
+//
+// export const pollinateCatch = catchEvent({
+//   name: "pollinate-orders",
+//   events: ["order.created"],
+//   workflow: pollinateCatchWorkflow,
+// });
+//
+// Then register in your khotan config:
+//
+// plugs: [{
+//   name: "pollinate",
+//   plug: pollinatePlug,
+//   wires: [pollinateWire],
+//   catches: [pollinateCatch],
+// }]

package/dist/templates/config-page.tsx

@@ -0,0 +1,20 @@
+import { KhotanHub } from "@/components/khotan/hub";
+
+function getWebhookUrl(): string {
+  return (
+    process.env.KHOTAN_WEBHOOK_URL ||
+    process.env.NGROK_URL ||
+    process.env.NEXT_PUBLIC_APP_URL ||
+    "http://localhost:3000"
+  );
+}
+
+export default function KhotanConfigPage() {
+  const webhookUrl = getWebhookUrl();
+
+  return (
+    <main className="container mx-auto max-w-5xl px-4 py-10">
+      <KhotanHub webhookUrl={webhookUrl} />
+    </main>
+  );
+}

package/dist/templates/debug-index-page.tsx

@@ -0,0 +1,101 @@
+"use client";
+
+import { useEffect, useState } from "react";
+import Link from "next/link";
+
+// ============================================================================
+// Debug Index — Lists all registered plugs for debugging
+// Generated by khotan CLI · https://github.com/khotan-data
+//
+// Place at: app/debug/page.tsx
+// Requires KHOTAN_DEBUG env var to be set for the debug route to respond.
+// ============================================================================
+
+interface Plug {
+  id: string;
+  name: string;
+  baseUrl: string;
+  authType: string;
+  status: "connected" | "error" | "idle";
+}
+
+export default function DebugIndexPage() {
+  const [plugs, setPlugs] = useState<Plug[]>([]);
+  const [loading, setLoading] = useState(true);
+  const [debugEnabled, setDebugEnabled] = useState<boolean | null>(null);
+
+  useEffect(() => {
+    Promise.all([
+      fetch("/api/khotan/debug").then((r) => r.ok),
+      fetch("/api/khotan/plugs").then((r) => (r.ok ? r.json() : [])),
+    ])
+      .then(([enabled, data]) => {
+        setDebugEnabled(enabled);
+        setPlugs(data as Plug[]);
+      })
+      .catch(() => setDebugEnabled(false))
+      .finally(() => setLoading(false));
+  }, []);
+
+  if (loading) {
+    return (
+      <main className="container mx-auto max-w-3xl px-4 py-10">
+        <div className="h-8 w-48 animate-pulse rounded bg-muted" />
+      </main>
+    );
+  }
+
+  if (!debugEnabled) {
+    return (
+      <main className="container mx-auto max-w-3xl px-4 py-10">
+        <h1 className="text-2xl font-bold tracking-tight mb-4">Debug</h1>
+        <p className="text-muted-foreground">
+          Debug mode is not enabled. Set{" "}
+          <code className="bg-muted px-1.5 py-0.5 rounded text-sm">
+            KHOTAN_DEBUG=1
+          </code>{" "}
+          in your environment and restart the server.
+        </p>
+      </main>
+    );
+  }
+
+  return (
+    <main className="container mx-auto max-w-3xl px-4 py-10">
+      <div className="mb-6">
+        <a
+          href="/config"
+          className="text-sm text-muted-foreground hover:text-foreground"
+        >
+          ← Back to Hub
+        </a>
+      </div>
+      <h1 className="text-2xl font-bold tracking-tight mb-6">Debug</h1>
+      <p className="text-muted-foreground mb-6">
+        Select a plug to test requests through its real code path.
+      </p>
+      <div className="grid gap-3">
+        {plugs.map((plug) => (
+          <Link
+            key={plug.id}
+            href={`/debug/${plug.name}`}
+            className="flex items-center justify-between rounded-lg border border-border p-4 transition-colors hover:border-foreground/30 hover:bg-muted/50"
+          >
+            <div>
+              <p className="font-medium">{plug.name}</p>
+              <p className="text-xs text-muted-foreground truncate">
+                {plug.baseUrl}
+              </p>
+            </div>
+            <div className="flex items-center gap-2">
+              <span className="text-xs text-muted-foreground">
+                {plug.authType}
+              </span>
+              <span className="text-muted-foreground">→</span>
+            </div>
+          </Link>
+        ))}
+      </div>
+    </main>
+  );
+}

package/dist/templates/debug-page.tsx

@@ -0,0 +1,48 @@
+"use client";
+
+import { useParams } from "next/navigation";
+import { PlugDebugger } from "@/components/khotan/plug-debugger";
+
+// ============================================================================
+// Debug Page — Route for plug debugging
+// Generated by khotan CLI · https://github.com/khotan-data
+//
+// Place at: app/debug/[plugName]/page.tsx
+// Requires KHOTAN_DEBUG env var to be set for the debug route to respond.
+// ============================================================================
+
+export default function PlugDebugPage() {
+  const params = useParams<{ plugName: string }>();
+  const plugName = params.plugName;
+
+  if (!plugName) {
+    return (
+      <main className="container mx-auto max-w-6xl px-4 py-10">
+        <p className="text-muted-foreground">No plug specified.</p>
+      </main>
+    );
+  }
+
+  return (
+    <main className="container mx-auto max-w-6xl px-4 py-10">
+      <div className="flex items-center justify-between mb-6">
+        <a
+          href="/debug"
+          className="text-sm text-muted-foreground hover:text-foreground"
+        >
+          ← All Plugs
+        </a>
+        <a
+          href="/config"
+          className="text-xs text-muted-foreground hover:text-foreground"
+        >
+          Hub
+        </a>
+      </div>
+      <h1 className="text-2xl font-bold tracking-tight mb-6">
+        Debug: {plugName}
+      </h1>
+      <PlugDebugger plugName={plugName} />
+    </main>
+  );
+}

package/dist/templates/graph-page.tsx

@@ -0,0 +1,11 @@
+import { KhotanTopologyCanvas } from "@/components/khotan/topology-canvas";
+
+export default function KhotanGraphPage() {
+  return (
+    <main className="min-h-screen bg-[radial-gradient(circle_at_top,_rgba(248,250,252,0.94),_rgba(241,245,249,0.82)_38%,_rgba(226,232,240,0.7))]">
+      <div className="mx-auto max-w-[1720px] px-4 py-8 md:px-6 xl:py-10">
+        <KhotanTopologyCanvas />
+      </div>
+    </main>
+  );
+}