@acpfx/node-sdk 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,20 @@
+# @acpfx/node-sdk
+
+## 0.2.0
+
+### Minor Changes
+
+- d757640: Initial release: type-safe contracts, Rust orchestrator, manifest-driven event filtering
+
+  - Rust schema crate as canonical event type source of truth with codegen to TypeScript + Zod
+  - Node manifests (manifest.yaml) declaring consumes/emits contracts
+  - Orchestrator event filtering: nodes only receive declared events
+  - Rust orchestrator with ratatui TUI (--ui flag)
+  - node-sdk with structured logging helpers
+  - CI/CD with GitHub Actions and changesets
+  - Platform-specific npm packages for Rust binaries (esbuild-style distribution)
+
+### Patch Changes
+
+- Updated dependencies [d757640]
+  - @acpfx/core@0.2.0

package/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "@acpfx/node-sdk",
+  "version": "0.2.0",
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "dependencies": {
+    "@acpfx/core": "0.2.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,53 @@
+/**
+ * Node SDK — shared helpers for acpfx TS nodes.
+ *
+ * Provides emit(), log(), onEvent(), and handleManifestFlag().
+ * log() emits structured log events on stdout (not stderr).
+ */
+
+import { createInterface, type Interface } from "node:readline";
+/**
+ * Re-export handleManifestFlag from core — handles the --manifest flag.
+ * If --manifest is in process.argv, prints the manifest as JSON and exits.
+ */
+export { handleManifestFlag } from "@acpfx/core";
+
+const NODE_NAME = process.env.ACPFX_NODE_NAME ?? "unknown";
+
+/** Emit an NDJSON event on stdout. */
+export function emit(event: Record<string, unknown>): void {
+  process.stdout.write(JSON.stringify(event) + "\n");
+}
+
+/** Emit a structured log event on stdout. */
+export function log(level: "info" | "warn" | "error" | "debug", message: string): void {
+  emit({ type: "log", level, component: NODE_NAME, message });
+}
+
+/** Convenience: log.info / log.warn / log.error / log.debug */
+log.info = (message: string): void => log("info", message);
+log.warn = (message: string): void => log("warn", message);
+log.error = (message: string): void => log("error", message);
+log.debug = (message: string): void => log("debug", message);
+
+export type EventHandler = (event: Record<string, unknown>) => void;
+
+/**
+ * Listen for NDJSON events on stdin. Returns the readline interface
+ * for attaching close handlers.
+ */
+export function onEvent(handler: EventHandler): Interface {
+  const rl = createInterface({ input: process.stdin });
+
+  rl.on("line", (line) => {
+    if (!line.trim()) return;
+    try {
+      const event = JSON.parse(line);
+      handler(event);
+    } catch {
+      // ignore malformed JSON
+    }
+  });
+
+  return rl;
+}