@crossdelta/platform-sdk 0.7.10 → 0.7.12

package/README.md

@@ -33,17 +33,42 @@
 <br />
 
 ---
-## 🚀 Quick Start
+
+## Installation
+
+```bash
+# Pick your package manager
+bun add -g @crossdelta/platform-sdk
+npm install -g @crossdelta/platform-sdk
+pnpm add -g @crossdelta/platform-sdk
+```
+
+<details>
+<summary>Alternative: Auto-installer or use without installing</summary>
+
+```bash
+# Auto-installer (detects package manager, offers to install Bun if needed)
+curl -fsSL https://unpkg.com/@crossdelta/platform-sdk@latest/install.sh | bash
+
+# Or run directly without global install
+bunx @crossdelta/platform-sdk new workspace my-platform
+npx @crossdelta/platform-sdk new workspace my-platform
+```
+
+</details>
+
+---
+
+## Quick Start
 
 ```bash
-# Create workspace (works with bunx/npx/pnpm dlx/yarn dlx)
-bunx @crossdelta/platform-sdk new workspace my-platform -y
+# Create workspace
+pf new workspace my-platform -y
 cd my-platform
 
 # Generate microservice with AI
-# (first time: run `pf setup --ai` to configure provider)
-bunx @crossdelta/platform-sdk new hono-micro services/orders --ai \
-  -d "Handle order creation and payment"
+pf setup --ai                    # Configure AI provider (first time only)
+pf new hono-micro services/orders --ai -d "Handle order creation and payment"
 
 # Start development
 pf dev
@@ -71,43 +96,8 @@ pf pulumi up    # → runs in infra/ directory
 
 **Why:** Keeps commands consistent across the team and works from any subdirectory.
 
-**How it works:** `pf` walks up to find your workspace root, then proxies to your scripts. Configured commands via `pf.commands` can override the working directory or command. Registered `pf` commands (like `pf new`) take precedence.
-
 > **📖 Note:** You can be productive with `pf` in minutes using the commands above. The sections below are reference documentation—explore them when you need specific details.
 
-### No runtime installed?
-
-If you don't have a JavaScript runtime, use our installer that sets everything up.
-**The installer is optional** — you can always use `bunx`/`npx` or a global install.
-
-```bash
-# Auto-installer (detects bun/pnpm/yarn/npm; if none found it can install Bun)
-curl -fsSL https://unpkg.com/@crossdelta/platform-sdk@latest/install.sh | bash
-
-# Then use short commands
-pf new workspace my-platform
-pf new hono-micro services/orders --ai -d "..."
-```
-
-> **Security:** The installer asks permission before installing Bun (if needed) and does not run any workspace commands automatically.
-
-<details>
-<summary><strong>🔍 What does the installer do?</strong></summary>
-
-The script ([view source](https://unpkg.com/@crossdelta/platform-sdk@latest/install.sh)):
-1. Checks for bun/pnpm/yarn/npm
-2. If none found, **asks permission** to install Bun
-3. Installs `pf` CLI globally
-
-**Manual installation:**
-```bash
-# With Bun/npm/yarn/pnpm
-bun add -g @crossdelta/platform-sdk
-# or: npm install -g @crossdelta/platform-sdk
-```
-
-</details>
-
 <br />
 
 ---
@@ -161,30 +151,23 @@ When you create a workspace with `pf`, you get a **Turborepo monorepo** with thi
 
 ```
 my-platform/
-├── services/         # Microservices (Hono, NestJS)
-│   ├── orders/       # Example: Order processing service (Event Publisher)
-│   ├── notifications/# Example: Notification service (Event Consumer)
+├── services/         # Microservices (generate with pf new hono-micro)
 │   └── nats/         # NATS message broker (auto-scaffolded)
-├── apps/             # Frontend apps (optional: Qwik, Next.js, etc.)
+├── apps/             # Frontend apps (optional)
 ├── packages/         # Shared libraries
-│   ├── contracts/    # Event contracts (Schema Registry - created when generating Event Consumers)
-│   │   └── src/
-│   │       └── index.ts       # Export all contracts
-│   ├── cloudevents/  # Event publishing/consuming toolkit
-│   ├── telemetry/    # OpenTelemetry setup
-│   └── infrastructure/ # Pulumi utilities and K8s builders
+│   └── contracts/    # Event contracts (Schema Registry)
+│       └── src/
+│           └── index.ts
 ├── infra/            # Pulumi Infrastructure-as-Code
 │   ├── index.ts      # Main Pulumi program
-│   └── services/     # Per-service K8s configs
-│       ├── orders.ts
-│       └── notifications.ts
+│   └── services/     # Per-service K8s configs (auto-generated)
 ├── .github/
-│   └── workflows/    # CI/CD pipelines (auto-generated)
+│   └── workflows/    # CI/CD pipelines
 ├── turbo.json        # Turborepo task orchestration
 └── .env.local        # Auto-generated from infra configs
 ```
 
-> **Note:** The `packages/contracts` package starts with just an `index.ts`. Event contract files (e.g., `events/order-created.ts`) are automatically generated when you create **Event Consumer** services with `pf new hono-micro --ai`.
+> **Note:** Services use external packages (`@crossdelta/cloudevents`, `@crossdelta/telemetry`, `@crossdelta/infrastructure`) installed via npm. Only `packages/contracts` is local to your workspace.
 
 ### Key Architectural Decisions
 
@@ -201,11 +184,11 @@ my-platform/
 Services communicate via **CloudEvents** over **NATS JetStream** using the **Schema Registry** as single source of truth:
 
 ```typescript
-// packages/contracts/src/events/order-created.ts (Schema Registry)
+// packages/contracts/src/events/orders-created.ts (Schema Registry)
 import { createContract } from '@crossdelta/cloudevents'
 import { z } from 'zod'
 
-export const OrderCreatedContract = createContract({
+export const OrdersCreatedContract = createContract({
   type: 'orders.created',
   schema: z.object({
     orderId: z.string(),
@@ -214,24 +197,24 @@ export const OrderCreatedContract = createContract({
   }),
 })
 
-export type OrderCreatedData = z.infer<typeof OrderCreatedContract.schema>
+export type OrdersCreatedData = z.infer<typeof OrdersCreatedContract.schema>
 
 // Service A publishes an event (Event Publisher)
 import { publish } from '@crossdelta/cloudevents'
-import { OrderCreatedContract } from '@my-platform/contracts'
+import { OrdersCreatedContract } from '@my-platform/contracts'
 
-await publish(OrderCreatedContract, {
+await publish(OrdersCreatedContract, {
   orderId: '123',
   customerId: 'cust-456',
   total: 99.99
 })
 
 // Service B auto-discovers and handles it (Event Consumer)
-// File: services/notifications/src/events/order-created.event.ts
+// File: services/notifications/src/events/orders-created.event.ts
 import { handleEvent } from '@crossdelta/cloudevents'
-import { OrderCreatedContract, type OrderCreatedData } from '@my-platform/contracts'
+import { OrdersCreatedContract, type OrdersCreatedData } from '@my-platform/contracts'
 
-export default handleEvent(OrderCreatedContract, async (data: OrderCreatedData) => {
+export default handleEvent(OrdersCreatedContract, async (data: OrdersCreatedData) => {
   await sendNotification(data)
 })
 ```
@@ -467,21 +450,21 @@ await publish('orders.created', { orderId: 'ord_123', total: 99.99 })
 ### Consume Events (Auto-Discovered)
 
 ```typescript
-// services/notifications/src/events/order-created.event.ts
+// services/notifications/src/events/orders-created.event.ts
 import { handleEvent } from '@crossdelta/cloudevents'
 import { z } from 'zod'
 
-const OrderCreatedSchema = z.object({
+const OrdersCreatedSchema = z.object({
   orderId: z.string(),
   total: z.number(),
 })
 
 // Export type for use in use-cases
-export type OrderCreatedEvent = z.infer<typeof OrderCreatedSchema>
+export type OrdersCreatedEvent = z.infer<typeof OrdersCreatedSchema>
 
 export default handleEvent(
   {
-    schema: OrderCreatedSchema,
+    schema: OrdersCreatedSchema,
     type: 'orders.created',
   },
   async (data) => {

package/bin/cli.js

@@ -142,7 +142,7 @@ export type ${y} = z.infer<typeof ${g}.schema>
 `;(0,H.writeFileSync)(x,w,"utf-8");let v=(0,H.readFileSync)(l,"utf-8"),k=`export * from './events/${m}'`;if(!v.includes(k)){let M=v.split(`
 `),K=M.findLastIndex(Be=>Be.startsWith("export"));K>=0?M.splice(K+1,0,k):M.push("",k),v=M.join(`
 `),(0,H.writeFileSync)(l,v,"utf-8")}let O=(0,H.readFileSync)(r,"utf-8").replace(/import\s+\{[^}]*\}\s+from\s+['"]\.\.\/types\/[^'"]+['"]/,`import { ${g}, type ${y} } from '${p}/contracts'`).replace(/handleEvent\s*\(\s*\{[\s\S]*?type:\s*['"]([^'"]+)['"][\s\S]*?schema:\s*\w+Schema[\s\S]*?\}\s*,/,`handleEvent(${g},`).replace(new RegExp(`\\b${i.replace("Schema","Event")}\\b`,"g"),y);(0,H.writeFileSync)(r,O,"utf-8");let _=`${m}.mock.json`,C=(0,Se.join)(c,_),T={eventName:t,description:`Mock data for ${t} event`,data:n};Object.keys(o).length>0&&(T.faker=o),(0,H.writeFileSync)(C,JSON.stringify(T,null,2),"utf-8")},o5=async(r,e={})=>{let{outputDir:t,overwrite:s=!1}=e;if(!(0,H.existsSync)(r))return S.error(`Event handler not found: ${r}`),{mockPath:null};let i=(0,H.readFileSync)(r,"utf-8");if(i.includes("Contract")&&(i.includes("contracts'")||i.includes('contracts"')))return await i5(r,i,e);let n=Z4(i);if(!n)return S.error(`Could not parse event handler: ${r}`),{mockPath:null};let{eventType:o,schemaCode:a,schemaName:c}=n,l=a;if(!a){let y=(0,Se.dirname)(r),w=(0,Se.dirname)(y),v=(0,Se.join)(w,"types","events.ts");if((0,H.existsSync)(v)){let k=(0,H.readFileSync)(v,"utf-8"),A=k.indexOf(`export const ${c}`);if(A>=0){let O=k.indexOf("z.object(",A),_=k.indexOf("{",O),C=1,T=_+1;for(;T<k.length&&C>0;)k[T]==="{"&&C++,k[T]==="}"&&C--,T++;let M=k.indexOf(")",T);M>=0&&(l=k.substring(A,M+1).replace(/^export\s+/,""))}}if(!l)return S.error(`Could not load schema ${c} from types file`),{mockPath:null}}let{data:u,faker:h}=await Q4(l,c,r),f=ae();if((i.includes("from '../types/")||i.includes('from "../types/'))&&!t)return await n5(r,f,o,l,c,u,h),{mockPath:null,skipped:!0,reason:"Migrated to Advanced Mode (contracts)"};let p=t??lt().eventsPath;if(!(0,H.existsSync)(p))return S.error(`Contracts events directory not found: ${p}`),{mockPath:null};let b=`${Wg(o)}.mock.json`,x=(0,Se.join)(p,b);if((0,H.existsSync)(x)&&!s)return S.warn(`Mock file already exists: ${x}`),{mockPath:null};let g={eventName:o,description:`Mock data for ${o} event`,data:u};return Object.keys(h).length>0&&(g.faker=h),(0,H.writeFileSync)(x,JSON.stringify(g,null,2),"utf-8"),{mockPath:x}},Jo=async(r,e={})=>{let t=(0,Se.join)(r,"src","events");if(!(0,H.existsSync)(t))return{mockPaths:[],skippedHandlers:[]};let s=(0,H.readdirSync)(t).filter(a=>a.endsWith(".event.ts")).map(a=>(0,Se.join)(t,a)),i=await Promise.all(s.map(a=>o5(a,e))),n=i.filter(a=>a.mockPath!==null).map(a=>a.mockPath),o=i.filter(a=>a.skipped).map((a,c)=>`${(0,Se.basename)(s[c])} (${a.reason})`);return{mockPaths:n,skippedHandlers:o}};var Zr=require("node:fs"),s2=require("node:path"),O0=require("node:process"),i2=require("execa");var T0=require("node:child_process"),Qg=require("node:path"),e2=require("execa");var Yg=require("node:fs"),Jg=require("node:path"),Zg=E(Kg()),F0=(r,e)=>{let t=(0,Jg.resolve)(e,r);return(0,Yg.existsSync)(t)?(0,Zg.config)({path:t,processEnv:{}}).parsed||{}:{}},Xg=(r,e)=>{let t=F0(r,e),s=[];for(let[i,n]of Object.entries(t))if(i.endsWith("_PORT")&&n){let o=Number.parseInt(n,10);!Number.isNaN(o)&&o>0&&s.push(o)}return s};var E5={...process.env,NODE_NO_WARNINGS:"1"};async function vr(r,e,{cwd:t=process.cwd(),task:s,shell:i,context:n=r,quiet:o=!1,nonInteractive:a=!1,env:c}={}){try{e.length===0&&(e=r.split(" ").slice(1));let l=o?"pipe":s||a?["ignore","pipe","pipe"]:"inherit",u={...E5};c?u={...u,...c}:(s||a)&&(u={...u,CI:"true"});let h=(0,e2.execa)(r,e,{cwd:t,stdio:l,all:s||a?!0:void 0,shell:i??!0,env:u});h.all&&h.all.on("data",f=>{let d=f.toString().trim();s?(s.output=d,d.length&&S.storeLog(d,n)):a&&d.length&&console.log(d)}),await h}catch(l){let u=l instanceof Error?l.message:String(l),h=S5(u);throw new Error(h)}}var S5=r=>{let e=r.match(/error: (.+)/);return e?e[1].trim():r};function t2(r,e,t={}){let{cwd:s=process.cwd(),envFile:i,detached:n=!0,pipeStdout:o=!1,onStdout:a,onStderr:c,onExit:l}=t,u=i?F0(i,s):{},h=(0,Qg.resolve)(s,"node_modules",".bin"),f=process.env.PATH||"",d=`${h}:${f}`,p={...process.env,...u,PATH:d,FORCE_COLOR:"1"},m=(0,T0.spawn)(r,e,{cwd:s,env:p,stdio:["inherit",o?"pipe":"inherit","pipe"],detached:n});return a&&o&&m.stdout?.on("data",a),c&&m.stderr?.on("data",c),l&&m.on("exit",l),m}function P0(r,e,t={}){let{cwd:s=process.cwd()}=t;(0,T0.spawn)(r,e,{cwd:s,stdio:"inherit",shell:!0}).on("exit",n=>process.exit(n||0))}async function r2(r){let{execSync:e}=await import("node:child_process");for(let t of r)try{let i=e(`lsof -ti:${t}`,{encoding:"utf8",stdio:"pipe"}).trim().split(`
-`).filter(Boolean);for(let n of i)try{process.kill(Number.parseInt(n,10),"SIGKILL")}catch{}}catch{}}var Xo=r=>Mi(r);function n2(r){let e=(0,s2.join)(nn(),"node_modules",r);return(0,Zr.existsSync)(e)}var o2=r=>Object.keys(Dr.scripts??{}).includes(r);function I0(){if((0,Zr.existsSync)("bun.lock")||(0,Zr.existsSync)("bun.lockb"))return"bun";if((0,Zr.existsSync)("pnpm-lock.yaml"))return"pnpm";if((0,Zr.existsSync)("yarn.lock"))return"yarn";if((0,Zr.existsSync)("package-lock.json"))return"npm"}function Le(){return I0()??B0()}function B0(){return Xo("bun")?"bun":Xo("pnpm")?"pnpm":Xo("yarn")?"yarn":"npm"}function a2(){return["bun","pnpm","yarn","npm"].filter(Xo)}async function Cr(r,e){let t=k5(r,e),{mergedOptions:s,packages:i}=t,{cwd:n=process.cwd(),flags:o=[],task:a}=s,c=s.packageManager??Le(),l=[],u=Array.isArray(i)?i:[i];c==="bun"&&(u=u.map(f=>f.replace("git+ssh://",""))),c==="pnpm"&&(l.push("--config.engine-strict=false"),l.push("--no-frozen-lockfile")),["yarn","npm"].includes(c)&&l.push("--ignore-engines");let h=u.length?c==="npm"?["install",...o,...l,...u]:["add",...o,...l,...u]:["install",...l];await vr(c,h,{cwd:n,task:a})}async function c2(r){let e=["-g"],t=[...r.flags??[],...e];await Cr({...r,flags:t,packageManager:r.packageManager??Le()})}function l2(r,e,t){let{args:s,mergedOptions:i}=h2(e??[],t),n=i.manager??Le(),{command:o,args:a}=u2(n);(0,i2.execaSync)(o,[...a,r,...s],{cwd:i.cwd??(0,O0.cwd)(),stdio:"inherit",preferLocal:!0})}async function Mt(r,e,t){let{args:s,mergedOptions:i}=h2(e??[],t),n=i.manager??Le(),{command:o,args:a}=u2(n);await vr(o,[...a,r,...s],i)}async function Qo(r,e){let{script:t,mergedOptions:s}=_5(r,e),i=s.packageManager??Le();await vr(i,["run",t,...s.args??[]],{cwd:s.cwd??(0,O0.cwd)(),task:s.task})}function u2(r){let t={bun:"bunx",pnpm:"npx",yarn:"npx",npm:"npx"}[r];if(!t)throw new Error(`No executor found for the detected package manager: ${r}`);let[s,...i]=t.split(" ");return{command:s,args:i}}function k5(r,e){return Array.isArray(r)?{packages:r,mergedOptions:{...e,packages:r}}:{packages:r.packages??[],mergedOptions:r}}function h2(r,e){return Array.isArray(r)?{args:r,mergedOptions:e??{}}:{args:[],mergedOptions:r}}function _5(r,e){return typeof r=="string"?{script:r,mergedOptions:e??{}}:{script:r.script,mergedOptions:r}}function A5(r){let e=r.split(/\s+/),t=e[0],s=e.slice(1);if(t==="pf"){t=process.argv[1];let i=s.filter(o=>o.startsWith("-"));s=[...s.filter(o=>!o.startsWith("-")),...i]}return{executable:t,args:s}}async function F5(r,e){try{let{executable:t,args:s}=A5(r.command);return await vr(t,s,{cwd:e,shell:!1}),{command:r.command,success:!0}}catch(t){return{command:r.command,success:!1,error:t instanceof Error?t.message:String(t)}}}async function f2(r,e){let t=[];for(let s of r){let i=await F5(s,e);if(t.push(i),!i.success)break}return t}function d2(r){let e=[/^pf\s+new\s+/,/^pf\s+add\s+/,/^bun\s+pf\s+new\s+/,/^bun\s+pf\s+add\s+/];return r.filter(t=>e.some(s=>s.test(t.command)))}function p2(r){for(let e of r){let t=e.command.match(/(?:bun\s+)?pf\s+new\s+\S+\s+(\S+)/);if(t)return t[1]}return null}var qs=require("node:fs"),m2=require("node:path");var x2=r=>{let{eventsPath:e}=lt(r);if(!(0,qs.existsSync)(e))return[];let t=[];try{let s=(0,qs.readdirSync)(e).filter(i=>i.endsWith(".ts")&&!i.endsWith(".mock.json")&&i!=="index.ts");for(let i of s){let n=(0,m2.join)(e,i),o=(0,qs.readFileSync)(n,"utf-8"),a=T5(o,n);a&&t.push(a)}}catch(s){return console.warn("Warning: Could not scan contracts package:",s),[]}return t},T5=(r,e)=>{try{let t=r.match(/export const (\w+Contract) = createContract/);if(!t)return null;let s=t[1],i=r.match(/export type (\w+(?:Data|Event)) = z\.infer/);if(!i)return null;let n=i[1],o=r.match(/type:\s*['"]([^'"]+)['"]/);if(!o)return null;let a=o[1],c=P5(r);return{name:s,typeName:n,eventType:a,fields:c,filePath:e}}catch{return null}},P5=r=>{let e=[],t=r.match(/z\.object\({([^}]+)\}/);if(!t)return e;let s=t[1],i=/(\w+):\s*z\.(\w+)\([^)]*\)/g,n;for(;(n=i.exec(s))!==null;){let[,o,a]=n,l={string:"string",number:"number",boolean:"boolean",array:"array",object:"object",date:"date"}[a]||a;e.push(`${o}: ${l}`)}if(r.includes("z.array(")){let o=/(\w+):\s*z\.array\(/g;for(;(n=o.exec(r))!==null;){let a=n[1];e.some(c=>c.startsWith(a))||e.push(`${a}: array`)}}return e},g2=(r,e)=>{if(r.length===0)return`
+`).filter(Boolean);for(let n of i)try{process.kill(Number.parseInt(n,10),"SIGKILL")}catch{}}catch{}}var Xo=r=>Mi(r);function n2(r){let e=(0,s2.join)(nn(),"node_modules",r);return(0,Zr.existsSync)(e)}var o2=r=>Object.keys(Dr.scripts??{}).includes(r);function I0(){if((0,Zr.existsSync)("bun.lock")||(0,Zr.existsSync)("bun.lockb"))return"bun";if((0,Zr.existsSync)("pnpm-lock.yaml"))return"pnpm";if((0,Zr.existsSync)("yarn.lock"))return"yarn";if((0,Zr.existsSync)("package-lock.json"))return"npm"}function Le(){return I0()??B0()}function B0(){return Xo("bun")?"bun":Xo("pnpm")?"pnpm":Xo("yarn")?"yarn":"npm"}function a2(){return["bun","pnpm","yarn","npm"].filter(Xo)}async function Cr(r,e){let t=k5(r,e),{mergedOptions:s,packages:i}=t,{cwd:n=process.cwd(),flags:o=[],task:a}=s,c=s.packageManager??Le(),l=[],u=Array.isArray(i)?i:[i];c==="bun"&&(u=u.map(f=>f.replace("git+ssh://",""))),c==="pnpm"&&l.push("--config.engine-strict=false"),["yarn","npm"].includes(c)&&l.push("--ignore-engines");let h=u.length?c==="npm"?["install",...o,...l,...u]:["add",...o,...l,...u]:["install",...l];await vr(c,h,{cwd:n,task:a})}async function c2(r){let e=["-g"],t=[...r.flags??[],...e];await Cr({...r,flags:t,packageManager:r.packageManager??Le()})}function l2(r,e,t){let{args:s,mergedOptions:i}=h2(e??[],t),n=i.manager??Le(),{command:o,args:a}=u2(n);(0,i2.execaSync)(o,[...a,r,...s],{cwd:i.cwd??(0,O0.cwd)(),stdio:"inherit",preferLocal:!0})}async function Mt(r,e,t){let{args:s,mergedOptions:i}=h2(e??[],t),n=i.manager??Le(),{command:o,args:a}=u2(n);await vr(o,[...a,r,...s],i)}async function Qo(r,e){let{script:t,mergedOptions:s}=_5(r,e),i=s.packageManager??Le();await vr(i,["run",t,...s.args??[]],{cwd:s.cwd??(0,O0.cwd)(),task:s.task})}function u2(r){let t={bun:"bunx",pnpm:"npx",yarn:"npx",npm:"npx"}[r];if(!t)throw new Error(`No executor found for the detected package manager: ${r}`);let[s,...i]=t.split(" ");return{command:s,args:i}}function k5(r,e){return Array.isArray(r)?{packages:r,mergedOptions:{...e,packages:r}}:{packages:r.packages??[],mergedOptions:r}}function h2(r,e){return Array.isArray(r)?{args:r,mergedOptions:e??{}}:{args:[],mergedOptions:r}}function _5(r,e){return typeof r=="string"?{script:r,mergedOptions:e??{}}:{script:r.script,mergedOptions:r}}function A5(r){let e=r.split(/\s+/),t=e[0],s=e.slice(1);if(t==="pf"){t=process.argv[1];let i=s.filter(o=>o.startsWith("-"));s=[...s.filter(o=>!o.startsWith("-")),...i]}return{executable:t,args:s}}async function F5(r,e){try{let{executable:t,args:s}=A5(r.command);return await vr(t,s,{cwd:e,shell:!1}),{command:r.command,success:!0}}catch(t){return{command:r.command,success:!1,error:t instanceof Error?t.message:String(t)}}}async function f2(r,e){let t=[];for(let s of r){let i=await F5(s,e);if(t.push(i),!i.success)break}return t}function d2(r){let e=[/^pf\s+new\s+/,/^pf\s+add\s+/,/^bun\s+pf\s+new\s+/,/^bun\s+pf\s+add\s+/];return r.filter(t=>e.some(s=>s.test(t.command)))}function p2(r){for(let e of r){let t=e.command.match(/(?:bun\s+)?pf\s+new\s+\S+\s+(\S+)/);if(t)return t[1]}return null}var qs=require("node:fs"),m2=require("node:path");var x2=r=>{let{eventsPath:e}=lt(r);if(!(0,qs.existsSync)(e))return[];let t=[];try{let s=(0,qs.readdirSync)(e).filter(i=>i.endsWith(".ts")&&!i.endsWith(".mock.json")&&i!=="index.ts");for(let i of s){let n=(0,m2.join)(e,i),o=(0,qs.readFileSync)(n,"utf-8"),a=T5(o,n);a&&t.push(a)}}catch(s){return console.warn("Warning: Could not scan contracts package:",s),[]}return t},T5=(r,e)=>{try{let t=r.match(/export const (\w+Contract) = createContract/);if(!t)return null;let s=t[1],i=r.match(/export type (\w+(?:Data|Event)) = z\.infer/);if(!i)return null;let n=i[1],o=r.match(/type:\s*['"]([^'"]+)['"]/);if(!o)return null;let a=o[1],c=P5(r);return{name:s,typeName:n,eventType:a,fields:c,filePath:e}}catch{return null}},P5=r=>{let e=[],t=r.match(/z\.object\({([^}]+)\}/);if(!t)return e;let s=t[1],i=/(\w+):\s*z\.(\w+)\([^)]*\)/g,n;for(;(n=i.exec(s))!==null;){let[,o,a]=n,l={string:"string",number:"number",boolean:"boolean",array:"array",object:"object",date:"date"}[a]||a;e.push(`${o}: ${l}`)}if(r.includes("z.array(")){let o=/(\w+):\s*z\.array\(/g;for(;(n=o.exec(r))!==null;){let a=n[1];e.some(c=>c.startsWith(a))||e.push(`${a}: array`)}}return e},g2=(r,e)=>{if(r.length===0)return`
 **Available Contracts:**
 
 No contracts are currently defined. Use Basic Mode with inline schemas for all events.

package/bin/templates/workspace/packages/contracts/README.md.hbs

@@ -11,9 +11,9 @@ This package contains **shared event definitions** (contracts) for events that a
 ```
 src/
 ├── events/            # Event contracts and mock data
-│   ├── order-created.ts        # Contract definition
-│   ├── order-created.mock.json # Mock data for testing
-│   └── index.ts                # Re-exports
+│   ├── orders-created.ts        # Contract definition
+│   ├── orders-created.mock.json # Mock data for testing
+│   └── index.ts                 # Re-exports
 └── index.ts           # Main exports
 ```
 
@@ -29,9 +29,9 @@ src/
 
 ```ts
 import { handleEvent } from '@crossdelta/cloudevents'
-import { OrderCreatedContract, type OrderCreatedData } from '{{scope}}/contracts'
+import { OrdersCreatedContract, type OrdersCreatedData } from '{{scope}}/contracts'
 
-export default handleEvent(OrderCreatedContract, async (data: OrderCreatedData) => {
+export default handleEvent(OrdersCreatedContract, async (data: OrdersCreatedData) => {
   // data is fully typed from contract
   console.log(data.orderId, data.customerId)
 })
@@ -41,10 +41,10 @@ export default handleEvent(OrderCreatedContract, async (data: OrderCreatedData)
 
 ```ts
 import { publish } from '@crossdelta/cloudevents'
-import { OrderCreatedContract } from '{{scope}}/contracts'
+import { OrdersCreatedContract } from '{{scope}}/contracts'
 
 // Type-safe publishing with contract
-await publish(OrderCreatedContract, {
+await publish(OrdersCreatedContract, {
   orderId: 'order-123',
   customerId: 'cust-456',
   total: 99.99,
@@ -55,9 +55,9 @@ await publish(OrderCreatedContract, {
 ### In Use-Cases
 
 ```ts
-import type { OrderCreatedData } from '{{scope}}/contracts'
+import type { OrdersCreatedData } from '{{scope}}/contracts'
 
-export const processOrder = async (data: OrderCreatedData) => {
+export const processOrder = async (data: OrdersCreatedData) => {
   // Use typed event data
 }
 ```
@@ -68,25 +68,25 @@ Contracts are **auto-generated** when you create event handlers:
 
 ```bash
 # 1. Create service with event handler
-pf new hono-micro notifications --ai -d "Sends emails on order.created events"
+pf new hono-micro notifications --ai -d "Sends emails on orders.created events"
 
 # 2. Generate contract (if missing) and mock data
 pf event:generate services/notifications
 ```
 
 This creates:
-- `packages/contracts/src/events/order-created.ts` (contract)
-- `packages/contracts/src/events/order-created.mock.json` (mock)
+- `packages/contracts/src/events/orders-created.ts` (contract)
+- `packages/contracts/src/events/orders-created.mock.json` (mock)
 - Updates `packages/contracts/src/index.ts` (exports)
 
 ### Manual Contract Creation
 
 ```ts
-// packages/contracts/src/events/order-created.ts
+// packages/contracts/src/events/orders-created.ts
 import { createContract } from '@crossdelta/cloudevents'
 import { z } from 'zod'
 
-export const OrderCreatedSchema = z.object({
+export const OrdersCreatedSchema = z.object({
   orderId: z.string(),
   customerId: z.string(),
   total: z.number(),
@@ -97,12 +97,12 @@ export const OrderCreatedSchema = z.object({
   })),
 })
 
-export const OrderCreatedContract = createContract({
-  type: 'order.created',
-  schema: OrderCreatedSchema,
+export const OrdersCreatedContract = createContract({
+  type: 'orders.created',
+  schema: OrdersCreatedSchema,
 })
 
-export type OrderCreatedData = z.infer<typeof OrderCreatedContract.schema>
+export type OrdersCreatedData = z.infer<typeof OrdersCreatedContract.schema>
 ```
 
 ## Testing with Mocks
@@ -112,10 +112,10 @@ export type OrderCreatedData = z.infer<typeof OrderCreatedContract.schema>
 pf event:list
 
 # Publish mock event
-pf event:publish order.created
+pf event:publish orders.created
 
 # Publish with custom data
-pf event:publish order.created --data '{"orderId":"test-123"}'
+pf event:publish orders.created --data '{"orderId":"test-123"}'
 ```
 
 ## Guidelines
@@ -128,7 +128,7 @@ pf event:publish order.created --data '{"orderId":"test-123"}'
 - ❌ Don't include event handlers in this package
 
 **Naming conventions:**
-- Contracts: `OrderCreatedContract`
-- Types: `OrderCreatedData`
-- Files: `order-created.ts`
-- Event types: `order.created` (dot notation)
+- Contracts: `OrdersCreatedContract` (plural namespace)
+- Types: `OrdersCreatedData`
+- Files: `orders-created.ts`
+- Event types: `orders.created` (plural namespace, dot notation)

package/bin/templates/workspace/packages/contracts/package.json.hbs

@@ -9,7 +9,7 @@
     }
   },
   "dependencies": {
-    "@crossdelta/cloudevents": "^0.4.2",
+    "@crossdelta/cloudevents": "^0.4.21",
     "zod": "^4.0.0"
   },
   "devDependencies": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crossdelta/platform-sdk",
-  "version": "0.7.10",
+  "version": "0.7.12",
   "description": "Your AI-powered platform engineer. Scaffold complete Turborepo workspaces, generate microservice boilerplate with natural language, and deploy to the cloud — all from one CLI",
   "keywords": [
     "cli",