@crossdelta/cloudevents 0.6.7 → 0.6.8

package/bin/cli.js

@@ -4,7 +4,7 @@ import * as fs from 'fs';
 import { existsSync, readdirSync, statSync } from 'fs';
 import * as path from 'path';
 import { join } from 'path';
-import { createFlow, createGenerationResult, input, initGenerationContext, trackChange, printGenerationSummary, change, runFlow } from '@crossdelta/flowcore';
+import { createFlow, createGenerationResult, input, initGenerationContext, trackChange, printGenerationSummary, runFlow, change } from '@crossdelta/flowcore';
 import 'url';
 import 'glob';
 import 'zod';

package/dist/index.cjs

@@ -2168,7 +2168,7 @@ function cloudEvents(options = {}) {
 // package.json
 var package_default = {
   name: "@crossdelta/cloudevents",
-  version: "0.6.7",
+  version: "0.6.8",
   description: "CloudEvents toolkit for TypeScript - Zod validation, handler discovery, NATS JetStream"};
 
 // src/plugin.ts

package/dist/index.d.cts

@@ -2,7 +2,6 @@ import { Context } from 'hono';
 import { CloudEventV1 } from 'cloudevents';
 import { ZodTypeAny, z } from 'zod';
 import { ChangeResult, FlowContext, FsContextMixin, GenerationContextMixin, FlowStep } from '@crossdelta/flowcore';
-import { PfPlugin } from '@crossdelta/platform-sdk';
 import { ConsumerMessages, Subscription } from 'nats';
 
 /**
@@ -1176,6 +1175,109 @@ interface CloudEventsOptions {
  */
 declare function cloudEvents(options?: CloudEventsOptions): (ctx: Context, next: () => Promise<void>) => Promise<void | Response>;
 
+/**
+ * Plugin System Types
+ *
+ * pf owns and defines these interfaces.
+ * Plugins MUST adapt to these interfaces.
+ * pf is strict and predictable - no duck-typing, no fallbacks.
+ */
+/**
+ * Base effect type - all domain effects must have a kind
+ * pf handles effects generically via kind-based handler registry
+ */
+interface PfEffect {
+    readonly kind: string;
+}
+/**
+ * Result of running a command
+ */
+interface PfCommandResult {
+    /** Domain effects to be applied by the runtime */
+    effects: PfEffect[];
+    /** Optional output to display (for read-only commands) */
+    output?: string | string[];
+}
+/**
+ * Command argument definition
+ */
+interface PfCommandArg {
+    name: string;
+    description: string;
+    required: boolean;
+}
+/**
+ * Command option definition
+ */
+interface PfCommandOption {
+    flags: string;
+    description: string;
+    default?: unknown;
+}
+/**
+ * A CLI command provided by a plugin
+ *
+ * Plugins MUST implement this exact interface.
+ */
+interface PfCommand {
+    name: string;
+    description: string;
+    args: PfCommandArg[];
+    options: PfCommandOption[];
+    run(args: Record<string, unknown>, options: Record<string, unknown>): Promise<PfCommandResult>;
+}
+/**
+ * An interactive flow provided by a plugin
+ */
+interface PfFlow {
+    name: string;
+    description: string;
+    getSteps(initialContext?: Record<string, unknown>): Promise<unknown[]>;
+}
+/**
+ * Workspace context with all discovered information
+ * pf owns this - plugins receive it during setup
+ */
+interface PfWorkspaceContext {
+    /** Absolute path to workspace root */
+    workspaceRoot: string;
+    /** Discovered services (relative paths like 'services/api-gateway') */
+    availableServices: string[];
+    /** Contracts package configuration */
+    contracts: {
+        /** Relative path to contracts source (e.g., 'packages/contracts/src') */
+        path: string;
+        /** Package name (e.g., '@my-platform/contracts') */
+        packageName?: string;
+    };
+}
+/**
+ * Plugin context provided by pf during setup
+ */
+interface PfPluginContext {
+    workspace: PfWorkspaceContext;
+    logger: {
+        debug: (message: string) => void;
+        info: (message: string) => void;
+        warn: (message: string) => void;
+        error: (message: string) => void;
+    };
+}
+/**
+ * A plugin that can be loaded by pf
+ *
+ * Plugins MUST implement this exact interface.
+ * If a plugin has a different internal API, it must provide an adapter.
+ */
+interface PfPlugin {
+    name: string;
+    version: string;
+    description?: string;
+    commands: PfCommand[];
+    flows: PfFlow[];
+    setup: (context: PfPluginContext) => Promise<void> | void;
+}
+
 /**
  * PfPlugin Adapter
  *

package/dist/index.d.ts

@@ -2,7 +2,6 @@ import { Context } from 'hono';
 import { CloudEventV1 } from 'cloudevents';
 import { ZodTypeAny, z } from 'zod';
 import { ChangeResult, FlowContext, FsContextMixin, GenerationContextMixin, FlowStep } from '@crossdelta/flowcore';
-import { PfPlugin } from '@crossdelta/platform-sdk';
 import { ConsumerMessages, Subscription } from 'nats';
 
 /**
@@ -1176,6 +1175,109 @@ interface CloudEventsOptions {
  */
 declare function cloudEvents(options?: CloudEventsOptions): (ctx: Context, next: () => Promise<void>) => Promise<void | Response>;
 
+/**
+ * Plugin System Types
+ *
+ * pf owns and defines these interfaces.
+ * Plugins MUST adapt to these interfaces.
+ * pf is strict and predictable - no duck-typing, no fallbacks.
+ */
+/**
+ * Base effect type - all domain effects must have a kind
+ * pf handles effects generically via kind-based handler registry
+ */
+interface PfEffect {
+    readonly kind: string;
+}
+/**
+ * Result of running a command
+ */
+interface PfCommandResult {
+    /** Domain effects to be applied by the runtime */
+    effects: PfEffect[];
+    /** Optional output to display (for read-only commands) */
+    output?: string | string[];
+}
+/**
+ * Command argument definition
+ */
+interface PfCommandArg {
+    name: string;
+    description: string;
+    required: boolean;
+}
+/**
+ * Command option definition
+ */
+interface PfCommandOption {
+    flags: string;
+    description: string;
+    default?: unknown;
+}
+/**
+ * A CLI command provided by a plugin
+ *
+ * Plugins MUST implement this exact interface.
+ */
+interface PfCommand {
+    name: string;
+    description: string;
+    args: PfCommandArg[];
+    options: PfCommandOption[];
+    run(args: Record<string, unknown>, options: Record<string, unknown>): Promise<PfCommandResult>;
+}
+/**
+ * An interactive flow provided by a plugin
+ */
+interface PfFlow {
+    name: string;
+    description: string;
+    getSteps(initialContext?: Record<string, unknown>): Promise<unknown[]>;
+}
+/**
+ * Workspace context with all discovered information
+ * pf owns this - plugins receive it during setup
+ */
+interface PfWorkspaceContext {
+    /** Absolute path to workspace root */
+    workspaceRoot: string;
+    /** Discovered services (relative paths like 'services/api-gateway') */
+    availableServices: string[];
+    /** Contracts package configuration */
+    contracts: {
+        /** Relative path to contracts source (e.g., 'packages/contracts/src') */
+        path: string;
+        /** Package name (e.g., '@my-platform/contracts') */
+        packageName?: string;
+    };
+}
+/**
+ * Plugin context provided by pf during setup
+ */
+interface PfPluginContext {
+    workspace: PfWorkspaceContext;
+    logger: {
+        debug: (message: string) => void;
+        info: (message: string) => void;
+        warn: (message: string) => void;
+        error: (message: string) => void;
+    };
+}
+/**
+ * A plugin that can be loaded by pf
+ *
+ * Plugins MUST implement this exact interface.
+ * If a plugin has a different internal API, it must provide an adapter.
+ */
+interface PfPlugin {
+    name: string;
+    version: string;
+    description?: string;
+    commands: PfCommand[];
+    flows: PfFlow[];
+    setup: (context: PfPluginContext) => Promise<void> | void;
+}
+
 /**
  * PfPlugin Adapter
  *

package/dist/index.js

@@ -4,7 +4,7 @@ import * as fs from 'fs';
 import { existsSync, readdirSync, statSync } from 'fs';
 import * as path from 'path';
 import { join, dirname } from 'path';
-import { createFlow, createGenerationResult, input, initGenerationContext, trackChange, printGenerationSummary, change, runFlow } from '@crossdelta/flowcore';
+import { createFlow, createGenerationResult, input, initGenerationContext, trackChange, printGenerationSummary, runFlow, change } from '@crossdelta/flowcore';
 import { fileURLToPath } from 'url';
 import { glob } from 'glob';
 import { z } from 'zod';
@@ -2143,7 +2143,7 @@ function cloudEvents(options = {}) {
 // package.json
 var package_default = {
   name: "@crossdelta/cloudevents",
-  version: "0.6.7",
+  version: "0.6.8",
   description: "CloudEvents toolkit for TypeScript - Zod validation, handler discovery, NATS JetStream"};
 
 // src/plugin.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crossdelta/cloudevents",
-  "version": "0.6.7",
+  "version": "0.6.8",
   "description": "CloudEvents toolkit for TypeScript - Zod validation, handler discovery, NATS JetStream",
   "author": "crossdelta",
   "license": "MIT",
@@ -56,7 +56,7 @@
   "peerDependencies": {
     "@faker-js/faker": ">=9.0.0",
     "@google-cloud/pubsub": ">=4.0.0",
-    "hono": "^4.11.4",
+    "hono": "^4.12.3",
     "zod": "^4.0.0"
   },
   "peerDependenciesMeta": {
@@ -71,13 +71,12 @@
     }
   },
   "devDependencies": {
-    "@crossdelta/platform-sdk": "0.19.5",
     "@faker-js/faker": "^9.7.0",
     "@google-cloud/pubsub": "^4.9.0",
     "@stryker-mutator/core": "^9.1.1",
     "@types/bun": "^1.3.3",
     "@types/pluralize": "^0.0.33",
-    "hono": "^4.12.0",
+    "hono": "^4.12.3",
     "stryker-mutator-bun-runner": "^0.4.0",
     "tsup": "^8.3.5",
     "typescript": "^5.9.2"