@newhomestar/sdk 0.4.7 → 0.4.8

package/dist/index.d.ts

@@ -13,6 +13,32 @@ export interface ActionDef<I extends ZodTypeAny, O extends ZodTypeAny> {
     };
     method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
     path?: string;
+    capabilities?: Array<{
+        type: 'webhook';
+        eventTypes: string[];
+        source: string;
+        endpoint?: string;
+        headers?: Record<string, string>;
+        authentication?: {
+            type: 'bearer' | 'basic' | 'api_key' | 'signature';
+            config?: Record<string, any>;
+        };
+    } | {
+        type: 'scheduled';
+        cron: string;
+        timezone?: string;
+        description?: string;
+    } | {
+        type: 'queue';
+        topics: string[];
+        queueName?: string;
+        consumerGroup?: string;
+    } | {
+        type: 'stream';
+        streamName: string;
+        eventTypes?: string[];
+        consumerGroup?: string;
+    }>;
 }
 export interface ActionCtx {
     jobId: string;
@@ -30,6 +56,32 @@ export declare function action<I extends ZodTypeAny, O extends ZodTypeAny>(cfg:
     };
     method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
     path?: string;
+    capabilities?: Array<{
+        type: 'webhook';
+        eventTypes: string[];
+        source: string;
+        endpoint?: string;
+        headers?: Record<string, string>;
+        authentication?: {
+            type: 'bearer' | 'basic' | 'api_key' | 'signature';
+            config?: Record<string, any>;
+        };
+    } | {
+        type: 'scheduled';
+        cron: string;
+        timezone?: string;
+        description?: string;
+    } | {
+        type: 'queue';
+        topics: string[];
+        queueName?: string;
+        consumerGroup?: string;
+    } | {
+        type: 'stream';
+        streamName: string;
+        eventTypes?: string[];
+        consumerGroup?: string;
+    }>;
     handler: (input: z.infer<I>, ctx: ActionCtx) => Promise<z.infer<O>>;
 }): ActionDef<I, O>;
 import type { NovaSpec } from './parseSpec.js';
@@ -77,16 +129,33 @@ export declare function runHttpServer<T extends WorkerDef>(def: T, opts?: {
 export type { ZodTypeAny as SchemaAny, ZodTypeAny };
 export { parseNovaSpec } from "./parseSpec.js";
 export type { NovaSpec } from "./parseSpec.js";
-import { parseNovaSpec as parseNovaSpecFunction } from "./parseSpec.js";
-declare const _default: {
-    defineWorker: typeof defineWorker;
-    action: typeof action;
-    enqueue: typeof enqueue;
-    runHttpServer: typeof runHttpServer;
-    runORPCServer: typeof runORPCServer;
-    runWorker: typeof runWorker;
-    generateOpenAPISpec: typeof generateOpenAPISpec;
-    createORPCRouter: typeof createORPCRouter;
-    parseNovaSpec: typeof parseNovaSpecFunction;
+export type WebhookCapability = {
+    type: 'webhook';
+    eventTypes: string[];
+    source: string;
+    endpoint?: string;
+    headers?: Record<string, string>;
+    authentication?: {
+        type: 'bearer' | 'basic' | 'api_key' | 'signature';
+        config?: Record<string, any>;
+    };
+};
+export type ScheduledCapability = {
+    type: 'scheduled';
+    cron: string;
+    timezone?: string;
+    description?: string;
+};
+export type QueueCapability = {
+    type: 'queue';
+    topics: string[];
+    queueName?: string;
+    consumerGroup?: string;
+};
+export type StreamCapability = {
+    type: 'stream';
+    streamName: string;
+    eventTypes?: string[];
+    consumerGroup?: string;
 };
-export default _default;
+export type Capability = WebhookCapability | ScheduledCapability | QueueCapability | StreamCapability;

package/dist/index.js

@@ -1,3 +1,12 @@
+// nova-sdk-esm – Modern ESM Nova SDK with full oRPC integration (v0.4.2)
+// =====================================================
+// 1. Public API – action(), defineWorker(), enqueue() - SAME AS BEFORE
+// 2. Enhanced HTTP server with REST endpoints and custom routing
+// 3. Full oRPC integration with OpenAPI spec generation
+// 4. Runtime harness for *worker* pipelines using Supabase RPC
+// 5. Modern ESM architecture for future compatibility
+// -----------------------------------------------------------
+import { z } from "zod";
 import dotenv from "dotenv";
 import { createClient } from "@supabase/supabase-js";
 import { OpenFgaClient } from "@openfga/sdk";
@@ -6,6 +15,7 @@ import { createServer } from "node:http";
 import { os } from "@orpc/server";
 import { RPCHandler } from "@orpc/server/node";
 import { CORSPlugin } from "@orpc/server/plugins";
+import { OpenAPIHandler } from "@orpc/openapi/fetch";
 if (!process.env.RUNTIME_SUPABASE_URL) {
     // local dev – read .env.local
     dotenv.config({ path: ".env.local", override: true });
@@ -294,16 +304,3 @@ export function runHttpServer(def, opts = {}) {
 }
 // YAML spec parsing utility
 export { parseNovaSpec } from "./parseSpec.js";
-// Default export for compatibility
-import { parseNovaSpec as parseNovaSpecFunction } from "./parseSpec.js";
-export default {
-    defineWorker,
-    action,
-    enqueue,
-    runHttpServer,
-    runORPCServer,
-    runWorker,
-    generateOpenAPISpec,
-    createORPCRouter,
-    parseNovaSpec: parseNovaSpecFunction
-};

package/dist/parseSpec.d.ts

@@ -43,7 +43,69 @@ export declare const NovaSpecSchema: z.ZodObject<{
                 resourceType: z.ZodString;
                 relation: z.ZodString;
             }, z.core.$strip>>;
+            capabilities: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"webhook">;
+                eventTypes: z.ZodArray<z.ZodString>;
+                source: z.ZodString;
+                endpoint: z.ZodOptional<z.ZodString>;
+                headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                authentication: z.ZodOptional<z.ZodObject<{
+                    type: z.ZodEnum<{
+                        bearer: "bearer";
+                        basic: "basic";
+                        api_key: "api_key";
+                        signature: "signature";
+                    }>;
+                    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"scheduled">;
+                cron: z.ZodString;
+                timezone: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"queue">;
+                topics: z.ZodArray<z.ZodString>;
+                queueName: z.ZodOptional<z.ZodString>;
+                consumerGroup: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"stream">;
+                streamName: z.ZodString;
+                eventTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                consumerGroup: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>]>>>;
         }, z.core.$strip>>;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"webhook">;
+            eventTypes: z.ZodArray<z.ZodString>;
+            source: z.ZodString;
+            endpoint: z.ZodOptional<z.ZodString>;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            authentication: z.ZodOptional<z.ZodObject<{
+                type: z.ZodEnum<{
+                    bearer: "bearer";
+                    basic: "basic";
+                    api_key: "api_key";
+                    signature: "signature";
+                }>;
+                config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"scheduled">;
+            cron: z.ZodString;
+            timezone: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"queue">;
+            topics: z.ZodArray<z.ZodString>;
+            queueName: z.ZodOptional<z.ZodString>;
+            consumerGroup: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"stream">;
+            streamName: z.ZodString;
+            eventTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            consumerGroup: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>]>>>;
     }, z.core.$strip>;
     build: z.ZodOptional<z.ZodObject<{
         dockerfile: z.ZodString;

package/dist/parseSpec.js

@@ -1,5 +1,41 @@
 import { parse as parseYAML } from "yaml";
 import { z } from "zod";
+// Capability schemas
+const WebhookCapabilitySchema = z.object({
+    type: z.literal('webhook'),
+    eventTypes: z.array(z.string()),
+    source: z.string(),
+    endpoint: z.string().optional(),
+    headers: z.record(z.string(), z.string()).optional(),
+    authentication: z.object({
+        type: z.enum(['bearer', 'basic', 'api_key', 'signature']),
+        config: z.record(z.string(), z.unknown()).optional(),
+    }).optional(),
+});
+const ScheduledCapabilitySchema = z.object({
+    type: z.literal('scheduled'),
+    cron: z.string(),
+    timezone: z.string().optional(),
+    description: z.string().optional(),
+});
+const QueueCapabilitySchema = z.object({
+    type: z.literal('queue'),
+    topics: z.array(z.string()),
+    queueName: z.string().optional(),
+    consumerGroup: z.string().optional(),
+});
+const StreamCapabilitySchema = z.object({
+    type: z.literal('stream'),
+    streamName: z.string(),
+    eventTypes: z.array(z.string()).optional(),
+    consumerGroup: z.string().optional(),
+});
+const CapabilitySchema = z.discriminatedUnion('type', [
+    WebhookCapabilitySchema,
+    ScheduledCapabilitySchema,
+    QueueCapabilitySchema,
+    StreamCapabilitySchema,
+]);
 // Zod schema for nova.yaml
 export const NovaSpecSchema = z.object({
     apiVersion: z.string(),
@@ -45,7 +81,9 @@ export const NovaSpecSchema = z.object({
                 resourceType: z.string(),
                 relation: z.string(),
             }).optional(),
+            capabilities: z.array(CapabilitySchema).optional(),
         })),
+        capabilities: z.array(CapabilitySchema).optional(), // Worker-level capabilities
     }),
     build: z.object({
         dockerfile: z.string(),

package/dist/workerSchema.d.ts

@@ -40,6 +40,37 @@ export declare const WorkerDefSchema: z.ZodObject<{
             resourceIdKey: z.ZodOptional<z.ZodString>;
             policy: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            type: z.ZodLiteral<"webhook">;
+            eventTypes: z.ZodArray<z.ZodString>;
+            source: z.ZodString;
+            endpoint: z.ZodOptional<z.ZodString>;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            authentication: z.ZodOptional<z.ZodObject<{
+                type: z.ZodEnum<{
+                    bearer: "bearer";
+                    basic: "basic";
+                    api_key: "api_key";
+                    signature: "signature";
+                }>;
+                config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"scheduled">;
+            cron: z.ZodString;
+            timezone: z.ZodDefault<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"queue">;
+            topics: z.ZodArray<z.ZodString>;
+            queueName: z.ZodOptional<z.ZodString>;
+            consumerGroup: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"stream">;
+            streamName: z.ZodString;
+            eventTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            consumerGroup: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>]>>>;
         handler: z.ZodAny;
     }, z.core.$strip>>;
 }, z.core.$strip>;

package/dist/workerSchema.js

@@ -33,6 +33,38 @@ export const WorkerDefSchema = z.object({
             resourceIdKey: z.string().optional(),
             policy: z.string().optional(),
         }).optional(),
+        // NEW: Capabilities array for event subscriptions and external triggers
+        capabilities: z.array(z.union([
+            z.object({
+                type: z.literal('webhook'),
+                eventTypes: z.array(z.string()),
+                source: z.string(),
+                endpoint: z.string().optional(),
+                headers: z.record(z.string(), z.string()).optional(),
+                authentication: z.object({
+                    type: z.enum(['bearer', 'basic', 'api_key', 'signature']),
+                    config: z.record(z.string(), z.any()).optional()
+                }).optional()
+            }),
+            z.object({
+                type: z.literal('scheduled'),
+                cron: z.string(),
+                timezone: z.string().default('UTC'),
+                description: z.string().optional()
+            }),
+            z.object({
+                type: z.literal('queue'),
+                topics: z.array(z.string()),
+                queueName: z.string().optional(),
+                consumerGroup: z.string().optional()
+            }),
+            z.object({
+                type: z.literal('stream'),
+                streamName: z.string(),
+                eventTypes: z.array(z.string()).optional(),
+                consumerGroup: z.string().optional()
+            })
+        ])).optional(),
         handler: z.any(), // function with signature (input, ctx) => Promise<…>
     })),
 });

package/package.json

@@ -1,45 +1,45 @@
-{
-  "name": "@newhomestar/sdk",
-  "version": "0.4.7",
-  "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": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "tsc"
-  },
-  "dependencies": {
-    "@openfga/sdk": "^0.9.0",
-    "@orpc/openapi": "1.7.4",
-    "@orpc/server": "1.7.4",
-    "@supabase/supabase-js": "^2.39.0",
-    "body-parser": "^1.20.2",
-    "dotenv": "^16.4.3",
-    "express": "^4.18.2",
-    "yaml": "^2.7.1",
-    "zod": "^4.0.5"
-  },
-  "devDependencies": {
-    "@types/node": "^20.11.17",
-    "typescript": "^5.4.4"
-  }
-}
+{
+  "name": "@newhomestar/sdk",
+  "version": "0.4.8",
+  "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": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@openfga/sdk": "^0.9.0",
+    "@orpc/openapi": "1.7.4",
+    "@orpc/server": "1.7.4",
+    "@supabase/supabase-js": "^2.39.0",
+    "body-parser": "^1.20.2",
+    "dotenv": "^16.4.3",
+    "express": "^4.18.2",
+    "yaml": "^2.7.1",
+    "zod": "^4.0.5"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.17",
+    "typescript": "^5.4.4"
+  }
+}