@crossdelta/platform-sdk 0.20.1 → 0.21.0

package/bin/cli.mjs

@@ -427,7 +427,7 @@ export default handleEvent(${Lr(o)}Contract, async (data) => {
   console.log('Processing ${o}:', data)
   // TODO: Implement handler logic
 })
-    `.trim();return{success:!0,message:`Would create handler for ${o}`,changes:[{type:"create",path:n,description:`Create event handler for ${o}`,preview:i.slice(0,500)}]}}return t.logger.debug(`Handler created: ${o} at ${n} (service: ${s})`),{success:!0}},vm={"stream.wired":fm,"contract.created":hm,"handler.created":ym},Wr=(e,t,r)=>e.map(n=>{let o=vm[n.kind];return o?o(n,t,r):(t.logger.warn(`Unknown effect kind: ${n.kind}`),{success:!1,message:`Unknown effect kind: ${n.kind}`})});import{join as Rt}from"path";import{deriveEventNames as ad}from"@crossdelta/cloudevents";var Hr=(e,t,r={})=>({ok:!0,operation:e,summary:t,artifacts:r.artifacts??[],changes:r.changes??[],diagnostics:r.diagnostics??[],next:r.next,data:r.data});f();import{join as Gr}from"path";import{readFileSync as km}from"fs";import{join as Cm}from"path";import xm from"handlebars";var fe=(e,t)=>ho(e,t??`Templates directory not found. Searched in: ${e.join(", ")}`),Br=(e,t={})=>{let r=km(e,"utf-8");return xm.compile(r)(t)},Tt=e=>(t,r={})=>{let n=Cm(e,t);return Br(n,r)};var G=e=>e.toUpperCase().replace(/-/g,"_");var Ss=e=>e.split("-").map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join(" ");var wm=()=>typeof import.meta?.url=="string"?W(import.meta.url):typeof __dirname=="string"?__dirname:process.cwd(),Pm=()=>{let e=wm(),t=ee();return fe([Gr(e,"templates","hono-microservice"),Gr(e,"..","hono-microservice","templates"),Gr(t,"bin","templates","hono-microservice")],"Hono templates directory not found.")},$t=(e,t={})=>Tt(Pm())(e,t);function bs(){return $t("tsconfig.json.hbs")}function Es(e="1.2.23"){return $t("Dockerfile.hbs",{bunVersion:e})}function Ts(){return $t("biome.json.hbs")}function $s(e,t=[]){return $t("src/config/env.ts.hbs",{envKey:G(e),envVars:t})}var Sm=e=>{let t=["import './config/env'","import '@crossdelta/telemetry'",""];return e&&t.push("import { consumeJetStreams } from '@crossdelta/cloudevents'"),t.push("import { Hono } from 'hono'"),t},bm=e=>[`const port = Number(process.env.${e}_PORT) || 8080`,"const app = new Hono()","","app.get('/health', (c) => {","  return c.json({ status: 'ok' })","})"],Em=(e,t)=>["","// Start NATS JetStream consumer","consumeJetStreams({",`  streams: [${t.map(r=>`'${r}'`).join(", ")}],`,`  consumer: '${e}',`,"  discover: './src/events/**/*.handler.ts',","})"],Tm=()=>["","Bun.serve({","  port,","  fetch: app.fetch,","})","","console.log(`\u{1F680} Service ready at http://localhost:${port}`)"],$m=e=>{let t=G(e.serviceName);return`${[...Sm(e.hasEvents),"",...bm(t),...e.hasEvents?Em(e.serviceName,e.streams):[],...Tm()].join(`
+    `.trim();return{success:!0,message:`Would create handler for ${o}`,changes:[{type:"create",path:n,description:`Create event handler for ${o}`,preview:i.slice(0,500)}]}}return t.logger.debug(`Handler created: ${o} at ${n} (service: ${s})`),{success:!0}},vm={"stream.wired":fm,"contract.created":hm,"handler.created":ym},Wr=(e,t,r)=>e.map(n=>{let o=vm[n.kind];return o?o(n,t,r):(t.logger.warn(`Unknown effect kind: ${n.kind}`),{success:!1,message:`Unknown effect kind: ${n.kind}`})});import{join as Rt}from"path";import{deriveEventNames as ad}from"@crossdelta/cloudevents";var Hr=(e,t,r={})=>({ok:!0,operation:e,summary:t,artifacts:r.artifacts??[],changes:r.changes??[],diagnostics:r.diagnostics??[],next:r.next,data:r.data});f();import{join as Gr}from"path";import{readFileSync as km}from"fs";import{join as Cm}from"path";import xm from"handlebars";var fe=(e,t)=>ho(e,t??`Templates directory not found. Searched in: ${e.join(", ")}`),Br=(e,t={})=>{let r=km(e,"utf-8");return xm.compile(r)(t)},Tt=e=>(t,r={})=>{let n=Cm(e,t);return Br(n,r)};var G=e=>e.toUpperCase().replace(/-/g,"_");var Ss=e=>e.split("-").map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join(" ");var wm=()=>typeof import.meta?.url=="string"?W(import.meta.url):typeof __dirname=="string"?__dirname:process.cwd(),Pm=()=>{let e=wm(),t=ee();return fe([Gr(e,"templates","hono-microservice"),Gr(e,"..","hono-microservice","templates"),Gr(t,"bin","templates","hono-microservice")],"Hono templates directory not found.")},$t=(e,t={})=>Tt(Pm())(e,t);function bs(){return $t("tsconfig.json.hbs")}function Es(e="1.2.23"){return $t("Dockerfile.hbs",{bunVersion:e})}function Ts(){return $t("biome.json.hbs")}function $s(e,t=[]){return $t("src/config/env.ts.hbs",{envKey:G(e),envVars:t})}var Sm=e=>{let t=["import './config/env'","import '@crossdelta/telemetry'",""];return e&&t.push("import { consumeJetStreams, isConsumerConnected } from '@crossdelta/cloudevents'"),t.push("import { Hono } from 'hono'"),t},bm=(e,t)=>{let r=[`const port = Number(process.env.${e}_PORT) || 8080`,"const app = new Hono()","","app.get('/health', (c) => {","  return c.json({ status: 'ok' })","})"];return t&&r.push("","app.get('/health/ready', (c) => {","  const ready = isConsumerConnected()","  return c.json({ status: ready ? 'ok' : 'not-ready' }, ready ? 200 : 503)","})"),r},Em=(e,t)=>["","// Start NATS JetStream consumer","consumeJetStreams({",`  streams: [${t.map(r=>`'${r}'`).join(", ")}],`,`  consumer: '${e}',`,"  discover: './src/events/**/*.handler.ts',","})"],Tm=()=>["","Bun.serve({","  port,","  fetch: app.fetch,","})","","console.log(`\u{1F680} Service ready at http://localhost:${port}`)"],$m=e=>{let t=G(e.serviceName);return`${[...Sm(e.hasEvents),"",...bm(t,e.hasEvents),...e.hasEvents?Em(e.serviceName,e.streams):[],...Tm()].join(`
 `)}
 `},Am=e=>{let t={hono:"^4.6.14","@crossdelta/telemetry":"workspace:*",zod:"^4.1.0",[`${e.workspaceScope}/contracts`]:"workspace:*"};e.hasEvents&&(t["@crossdelta/cloudevents"]="workspace:*");let r={name:e.packageName,version:"0.0.1",type:"module",scripts:{"start:dev":"bun --watch src/index.ts",start:"bun src/index.ts",test:"bun test"},dependencies:t,devDependencies:{"@types/bun":"^1.2.23"}};return JSON.stringify(r,null,2)},Im=e=>`# ${e.serviceName}
 

package/bin/docs/generators/hono-bun.md

@@ -60,7 +60,7 @@ console.log(`Service running on http://localhost:${port}`)
 import './config/env'
 import '@crossdelta/telemetry'
 
-import { consumeJetStreams } from '@crossdelta/cloudevents'
+import { consumeJetStreams, isConsumerConnected } from '@crossdelta/cloudevents'
 import { Hono } from 'hono'
 
 // Replace MY_SERVICE with actual service name in SCREAMING_SNAKE_CASE
@@ -69,6 +69,11 @@ const app = new Hono()
 
 app.get('/health', (c) => c.json({ status: 'ok' }))
 
+app.get('/health/ready', (c) => {
+  const ready = isConsumerConnected()
+  return c.json({ status: ready ? 'ok' : 'not-ready' }, ready ? 200 : 503)
+})
+
 Bun.serve({ port, fetch: app.fetch })
 console.log(`Service running on http://localhost:${port}`)
 

package/bin/docs/generators/service.md

@@ -82,6 +82,29 @@ const port = Number(process.env.MY_HONO_SERVICE_PORT) || 8080
 
 ---
 
+## 🚨 CRITICAL: Readiness Probes
+
+Every event-consuming service **must** expose a readiness endpoint:
+
+```typescript
+import { consumeJetStreams, isConsumerConnected } from '@crossdelta/cloudevents'
+
+app.get('/health/ready', (c) => {
+  const ready = isConsumerConnected()
+  return c.json({ status: ready ? 'ok' : 'not-ready' }, ready ? 200 : 503)
+})
+```
+
+The infra config must include `readinessPath`:
+
+```typescript
+healthCheck: { httpPath: '/health', readinessPath: '/health/ready' },
+```
+
+This ensures Kubernetes only routes traffic to pods with a live NATS connection.
+
+---
+
 ## 🚨 CRITICAL: Stream Architecture
 
 > **Services NEVER create streams!**

package/bin/templates/workspace/infra/package.json.hbs

@@ -7,7 +7,7 @@
     "pulumi": "pulumi"
   },
   "dependencies": {
-    "@crossdelta/cloudevents": "^0.7.11",
+    "@crossdelta/cloudevents": "^0.7.12",
     "@crossdelta/infrastructure": "^0.7.6",
     "{{scope}}/contracts": "workspace:*",
     "@pulumi/digitalocean": "^4.55.0",

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

@@ -19,7 +19,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@crossdelta/cloudevents": "^0.7.11",
+    "@crossdelta/cloudevents": "^0.7.12",
     "@crossdelta/infrastructure": "^0.7.6",
     "zod": "^4.0.0"
   },

package/dist/facade.js

@@ -1352,19 +1352,31 @@ var generateImports = (hasEvents) => {
     ""
   ];
   if (hasEvents) {
-    imports.push("import { consumeJetStreams } from '@crossdelta/cloudevents'");
+    imports.push("import { consumeJetStreams, isConsumerConnected } from '@crossdelta/cloudevents'");
   }
   imports.push("import { Hono } from 'hono'");
   return imports;
 };
-var generateServerSetup = (envKey) => [
-  `const port = Number(process.env.${envKey}_PORT) || 8080`,
-  "const app = new Hono()",
-  "",
-  "app.get('/health', (c) => {",
-  "  return c.json({ status: 'ok' })",
-  "})"
-];
+var generateServerSetup = (envKey, hasEvents) => {
+  const lines = [
+    `const port = Number(process.env.${envKey}_PORT) || 8080`,
+    "const app = new Hono()",
+    "",
+    "app.get('/health', (c) => {",
+    "  return c.json({ status: 'ok' })",
+    "})"
+  ];
+  if (hasEvents) {
+    lines.push(
+      "",
+      "app.get('/health/ready', (c) => {",
+      "  const ready = isConsumerConnected()",
+      "  return c.json({ status: ready ? 'ok' : 'not-ready' }, ready ? 200 : 503)",
+      "})"
+    );
+  }
+  return lines;
+};
 var generateJetStreamConsumer = (serviceName, streams) => [
   "",
   "// Start NATS JetStream consumer",
@@ -1388,7 +1400,7 @@ var generateIndexTs = (vars) => {
   const parts = [
     ...generateImports(vars.hasEvents),
     "",
-    ...generateServerSetup(envKey),
+    ...generateServerSetup(envKey, vars.hasEvents),
     ...vars.hasEvents ? generateJetStreamConsumer(vars.serviceName, vars.streams) : [],
     ...generateBunServe()
   ];

package/dist/facade.mjs

@@ -1282,19 +1282,31 @@ var generateImports = (hasEvents) => {
     ""
   ];
   if (hasEvents) {
-    imports.push("import { consumeJetStreams } from '@crossdelta/cloudevents'");
+    imports.push("import { consumeJetStreams, isConsumerConnected } from '@crossdelta/cloudevents'");
   }
   imports.push("import { Hono } from 'hono'");
   return imports;
 };
-var generateServerSetup = (envKey) => [
-  `const port = Number(process.env.${envKey}_PORT) || 8080`,
-  "const app = new Hono()",
-  "",
-  "app.get('/health', (c) => {",
-  "  return c.json({ status: 'ok' })",
-  "})"
-];
+var generateServerSetup = (envKey, hasEvents) => {
+  const lines = [
+    `const port = Number(process.env.${envKey}_PORT) || 8080`,
+    "const app = new Hono()",
+    "",
+    "app.get('/health', (c) => {",
+    "  return c.json({ status: 'ok' })",
+    "})"
+  ];
+  if (hasEvents) {
+    lines.push(
+      "",
+      "app.get('/health/ready', (c) => {",
+      "  const ready = isConsumerConnected()",
+      "  return c.json({ status: ready ? 'ok' : 'not-ready' }, ready ? 200 : 503)",
+      "})"
+    );
+  }
+  return lines;
+};
 var generateJetStreamConsumer = (serviceName, streams) => [
   "",
   "// Start NATS JetStream consumer",
@@ -1318,7 +1330,7 @@ var generateIndexTs = (vars) => {
   const parts = [
     ...generateImports(vars.hasEvents),
     "",
-    ...generateServerSetup(envKey),
+    ...generateServerSetup(envKey, vars.hasEvents),
     ...vars.hasEvents ? generateJetStreamConsumer(vars.serviceName, vars.streams) : [],
     ...generateBunServe()
   ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crossdelta/platform-sdk",
-  "version": "0.20.1",
+  "version": "0.21.0",
   "description": "Platform toolkit for event-driven microservices — keeping code and infrastructure in lockstep.",
   "keywords": [
     "cli",