@newhomestar/sdk 0.2.1

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+import { z, ZodTypeAny } from "zod";
+export interface ActionDef<I extends ZodTypeAny, O extends ZodTypeAny> {
+    name: string;
+    input: I;
+    output: O;
+    handler: (input: z.infer<I>, ctx: ActionCtx) => Promise<z.infer<O>>;
+}
+export interface ActionCtx {
+    jobId: string;
+    progress: (percent: number, meta?: unknown) => void;
+}
+export declare function action<I extends ZodTypeAny, O extends ZodTypeAny>(cfg: {
+    name?: string;
+    input: I;
+    output: O;
+    handler: (input: z.infer<I>, ctx: ActionCtx) => Promise<z.infer<O>>;
+}): ActionDef<I, O>;
+export interface WorkerDef {
+    name: string;
+    queue: string;
+    actions: Record<string, ActionDef<any, any>>;
+    envSpec?: {
+        name: string;
+        secret: boolean;
+        default?: string;
+    }[];
+}
+export declare function defineWorker<T extends WorkerDef>(def: T): T;
+/** Enqueue an async action and receive `{ job_id }` */
+export declare function enqueue<P extends object>(actionPath: `${string}.${string}`, payload: P): Promise<{
+    job_id: string;
+}>;
+export declare function runWorker(def: WorkerDef): Promise<void>;
+export type { ZodTypeAny as SchemaAny, ZodTypeAny };

package/dist/index.js

@@ -0,0 +1,104 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.action = action;
+exports.defineWorker = defineWorker;
+exports.enqueue = enqueue;
+exports.runWorker = runWorker;
+const dotenv_1 = __importDefault(require("dotenv"));
+const supabase_js_1 = require("@supabase/supabase-js");
+if (!process.env.RUNTIME_SUPABASE_URL) {
+    // local dev – read .env.local
+    dotenv_1.default.config({ path: ".env.local", override: true });
+}
+function action(cfg) {
+    return { name: cfg.name ?? "unnamed", ...cfg };
+}
+function defineWorker(def) {
+    return def; // identity – type info retained for CLI
+}
+/*──────────────────────*  Client‑side enqueue()  *──────────────────*/
+// CLIENT_SUPABASE_… vars exist in gateways / other services
+const CLIENT_SUPABASE_URL = process.env.CLIENT_SUPABASE_PUBLIC_URL;
+const CLIENT_SUPABASE_KEY = process.env.CLIENT_SUPABASE_SERVICE_ROLE_KEY;
+let clientSupabase;
+function getClient() {
+    if (!CLIENT_SUPABASE_URL || !CLIENT_SUPABASE_KEY)
+        throw new Error("CLIENT_SUPABASE_* env vars not set");
+    return (clientSupabase ?? (clientSupabase = (0, supabase_js_1.createClient)(CLIENT_SUPABASE_URL, CLIENT_SUPABASE_KEY)));
+}
+/** Enqueue an async action and receive `{ job_id }` */
+async function enqueue(actionPath, payload) {
+    const [pipeline, action] = actionPath.split(".");
+    const { data, error } = await getClient().rpc("nova_enqueue", {
+        pipeline_name: pipeline,
+        action_name: action,
+        p_payload: payload,
+    });
+    if (error)
+        throw error;
+    return data;
+}
+/*──────────────── Runtime harness (Supabase RPC) ───────────────*/
+const RUNTIME_SUPABASE_URL = process.env.RUNTIME_SUPABASE_URL;
+const RUNTIME_SUPABASE_KEY = process.env.RUNTIME_SUPABASE_SERVICE_ROLE_KEY;
+const runtime = RUNTIME_SUPABASE_URL && RUNTIME_SUPABASE_KEY
+    ? (0, supabase_js_1.createClient)(RUNTIME_SUPABASE_URL, RUNTIME_SUPABASE_KEY)
+    : undefined;
+async function runWorker(def) {
+    if (!runtime)
+        throw new Error("RUNTIME_SUPABASE_* env vars not configured");
+    console.log(`[nova] worker '${def.name}' polling ${def.queue}`);
+    // infinite loop – use pgmq read RPC
+    while (true) {
+        const { data, error } = await runtime
+            .schema("pgmq_public")
+            .rpc("read", {
+            queue_name: def.queue,
+            sleep_seconds: 30,
+            n: 1,
+        });
+        if (error) {
+            console.error(error);
+            await delay(2000);
+            continue;
+        }
+        if (!data?.length) {
+            await delay(1000);
+            continue;
+        }
+        for (const msg of data) {
+            const { jobId, action: actName, payload, user_id } = msg.message;
+            const act = def.actions[actName];
+            if (!act) {
+                await nack(msg.msg_id, def.queue);
+                continue;
+            }
+            try {
+                const parsedInput = act.input.parse(payload);
+                const ctx = {
+                    jobId,
+                    progress: (percent, meta) => runtime.from("job_events").insert({ job_id: jobId, percent, meta }),
+                };
+                const result = await act.handler(parsedInput, ctx);
+                act.output.parse(result);
+                await runtime.from("jobs").update({ status: "completed", result }).eq("id", jobId);
+                await ack(msg.msg_id, def.queue);
+            }
+            catch (err) {
+                console.error(err);
+                await runtime.from("jobs").update({ status: "failed", error: String(err) }).eq("id", jobId);
+                await nack(msg.msg_id, def.queue);
+            }
+        }
+    }
+}
+async function ack(id, q) {
+    await runtime.schema("pgmq_public").rpc("delete", { queue_name: q, message_id: id });
+}
+async function nack(id, q) {
+    await runtime.schema("pgmq_public").rpc("nack", { queue_name: q, message_id: id });
+}
+function delay(ms) { return new Promise(r => setTimeout(r, ms)); }

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@newhomestar/sdk",
+  "version": "0.2.1",
+  "description": "Type-safe SDK for building Nova pipelines (workers & functions)",
+  "homepage": "https://github.com/newhomestar/nova-node-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/newhomestar/nova-node-sdk/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/newhomestar/nova-node-sdk.git"
+  },
+  "license": "ISC",
+  "author": "Christian Gomez",
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@supabase/supabase-js": "^2.39.0",
+    "dotenv": "^16.4.3",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.4",
+    "@types/node": "^20.11.17"
+  }
+}