@crossdelta/platform-sdk 0.2.24 → 0.2.26

package/bin/integration.collection.json

@@ -1,18 +1,18 @@
 [
     {
         "name": "@crossdelta/cloudevents",
-        "description": "CrossDelta CloudEvents SDK for TypeScript",
-        "link": "https://github.com/orderboss/platform/blob/main/packages/cloudevents/README.md",
-        "install": "@crossdelta/cloudevents@^0.1.0",
+        "description": "Type-safe event-driven microservices with NATS and Zod validation",
+        "link": "https://www.npmjs.com/package/@crossdelta/cloudevents",
+        "install": "@crossdelta/cloudevents@^0.3.1",
         "run": [],
         "initial": true
     },
     {
         "name": "@crossdelta/telemetry",
         "description": "Zero-config OpenTelemetry instrumentation for TypeScript services",
-        "link": "https://github.com/orderboss/platform/blob/main/packages/telemetry/README.md",
+        "link": "https://www.npmjs.com/package/@crossdelta/telemetry",
         "install": "@crossdelta/telemetry@latest",
         "run": [],
         "initial": true
     }
-]
+]

package/bin/templates/hono-microservice/Dockerfile.hbs

@@ -0,0 +1,16 @@
+# syntax=docker/dockerfile:1.7-labs
+ARG BUN_VERSION={{bunVersion}}
+
+FROM oven/bun:${BUN_VERSION}-alpine AS production
+WORKDIR /app
+
+COPY bunfig.toml package.json ./
+COPY src ./src
+
+RUN --mount=type=secret,id=NPM_TOKEN \
+  export NPM_TOKEN="$(cat /run/secrets/NPM_TOKEN)" && \
+  bun install --production --omit=optional
+
+USER bun
+
+CMD ["bun", "run", "src/index.ts"]

package/bin/templates/hono-microservice/src/index.ts.hbs

@@ -0,0 +1,18 @@
+// IMPORTANT: telemetry must be imported first to patch modules before they're loaded
+import '@crossdelta/telemetry'
+
+import { Hono } from 'hono'
+
+const port = Number(process.env.PORT || process.env.{{envKey}}_PORT) || 8080
+const app = new Hono()
+
+app.get('/health', (c) => {
+  return c.json({ status: 'ok' })
+})
+
+console.log('Starting {{serviceName}} service on port', port)
+
+Bun.serve({
+  port,
+  fetch: app.fetch,
+})

package/bin/templates/hono-microservice/tsconfig.json.hbs

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "moduleResolution": "Bundler",
+    "strict": true,
+    "jsx": "react-jsx",
+    "jsxImportSource": "hono/jsx",
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  }
+}

package/bin/templates/nest-microservice/Dockerfile.hbs

@@ -0,0 +1,37 @@
+ARG NODE_VERSION={{nodeVersion}}
+ARG BUN_VERSION={{bunVersion}}
+
+# STAGE 1 — Build
+FROM oven/bun:${BUN_VERSION}-alpine AS builder
+WORKDIR /app
+
+COPY package.json tsconfig*.json nest-cli.json ./
+COPY src ./src
+
+RUN --mount=type=secret,id=NPM_TOKEN \
+  export NPM_TOKEN="$(cat /run/secrets/NPM_TOKEN)" && \
+  bun install
+
+RUN bun run build
+
+# STAGE 2 — Production dependencies
+FROM oven/bun:${BUN_VERSION}-alpine AS deps
+WORKDIR /app
+
+COPY package.json ./
+
+RUN --mount=type=secret,id=NPM_TOKEN \
+  export NPM_TOKEN="$(cat /run/secrets/NPM_TOKEN)" && \
+  bun install --production --omit=optional
+
+# STAGE 3 — Runtime
+FROM node:${NODE_VERSION}-alpine AS production
+WORKDIR /app
+
+COPY --from=builder /app/dist ./dist
+COPY --from=deps /app/node_modules ./node_modules
+
+USER node
+ENV NODE_ENV=production
+
+CMD ["node", "dist/main.js"]

package/bin/templates/nest-microservice/src/main.ts.hbs

@@ -0,0 +1,25 @@
+// IMPORTANT: telemetry must be imported first to patch modules before they're loaded
+import '@crossdelta/telemetry'
+
+import { env } from 'node:process'
+import { ConsoleLogger } from '@nestjs/common'
+import { NestFactory } from '@nestjs/core'
+import { AppModule } from './app.module'
+
+const port = Number(process.env.PORT || process.env.{{envKey}}_PORT) || {{defaultPort}}
+const serviceName = '{{displayName}}'
+
+const logger = new ConsoleLogger({
+  json: env.JSON_LOGS === 'true',
+  prefix: serviceName,
+})
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule, { logger })
+
+  await app
+    .listen(port)
+    .then(() => logger.log(`${serviceName} is running on port ${port}`))
+}
+
+bootstrap()

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

@@ -0,0 +1,60 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.3.7/schema.json",
+  "formatter": {
+    "indentStyle": "space"
+  },
+  "assist": {
+    "actions": {
+      "source": {
+        "organizeImports": "on"
+      }
+    }
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "security": {
+        "recommended": true
+      },
+      "style": {
+        "recommended": true,
+        "useAsConstAssertion": "warn",
+        "noUselessElse": "error",
+        "useConst": "error"
+      },
+      "complexity": {
+        "recommended": true,
+        "noUselessEmptyExport": "error",
+        "noExcessiveCognitiveComplexity": {
+          "level": "warn",
+          "options": {
+            "maxAllowedComplexity": 15
+          }
+        }
+      }
+    }
+  },
+  "javascript": {
+    "formatter": {
+      "indentWidth": 2,
+      "quoteStyle": "single",
+      "semicolons": "asNeeded",
+      "lineWidth": 120,
+      "trailingCommas": "all",
+      "arrowParentheses": "always"
+    }
+  },
+  "files": {
+    "includes": [
+      "**/src/**/*.ts",
+      "infra/**/*.ts",
+      "!**/vendor",
+      "!**/dist",
+      "!**/node_modules",
+      "!reports",
+      "!coverage",
+      "!stryker-tmp",
+      "!**/.stryker-tmp"
+    ]
+  }
+}

package/bin/templates/workspace/bunfig.toml.hbs

@@ -0,0 +1,5 @@
+[install]
+workspaces = ["packages/*", "apps/*", "services/*"]
+
+[install.scopes]
+"@{{projectName}}" = { url = "https://npm.pkg.github.com", token = "$NPM_TOKEN" }

package/bin/templates/workspace/editorconfig.hbs

@@ -0,0 +1,9 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true

package/bin/templates/workspace/gitignore.hbs

@@ -0,0 +1,15 @@
+out/
+.env
+.turbo
+.idea/
+.temp
+.vscode/
+.env.local
+.temp/
+node_modules
+.artifacts/
+.changed/
+.nats-data
+dist/
+coverage/
+*.log

package/bin/templates/workspace/infra/Pulumi.dev.yaml.hbs

@@ -0,0 +1,5 @@
+config:
+  {{projectName}}-infra:logtailToken:
+    secure: # Add your encrypted token here
+  {{projectName}}-infra:registryCredentials:
+    secure: # Add your encrypted credentials here

package/bin/templates/workspace/infra/Pulumi.yaml.hbs

@@ -0,0 +1,6 @@
+name: {{projectName}}-infra
+runtime:
+  name: nodejs
+  options:
+    packagemanager: bun
+description: Infrastructure as Code for {{projectName}}

package/bin/templates/workspace/infra/index.ts.hbs

@@ -0,0 +1,56 @@
+import { join } from 'node:path'
+import {
+  buildExternalUrls,
+  buildIngressRules,
+  buildInternalUrls,
+  buildServicePortEnvs,
+  buildServices,
+  buildServiceUrlEnvs,
+  discoverServices,
+} from '@crossdelta/infrastructure'
+import { App } from '@pulumi/digitalocean'
+import { Config, getStack } from '@pulumi/pulumi'
+
+const allServiceConfigs = discoverServices(join(__dirname, 'services'))
+const serviceConfigs = allServiceConfigs.filter((config) => !config.skip)
+const cfg = new Config()
+const logtailToken = cfg.requireSecret('logtailToken')
+const registryCredentials = cfg.requireSecret('registryCredentials')
+
+const stack = getStack()
+
+const doAppName = `{{projectName}}-${stack}`
+
+const app = new App('{{projectName}}', {
+  spec: {
+    name: doAppName,
+    region: 'fra',
+
+    alerts: [{ rule: 'DEPLOYMENT_FAILED' }, { rule: 'DOMAIN_FAILED' }],
+
+    features: ['buildpack-stack=ubuntu-22'],
+
+    envs: [
+      ...buildServiceUrlEnvs(serviceConfigs),
+      ...buildServicePortEnvs(serviceConfigs),
+    ],
+
+    services: buildServices({
+      serviceConfigs,
+      registryCredentials,
+      logtailToken,
+    }),
+
+    ingress: {
+      rules: buildIngressRules(serviceConfigs),
+    },
+  },
+})
+
+// Outputs
+export const appId = app.id
+export const appDefaultIngress = app.defaultIngress
+export const internalUrls = buildInternalUrls(serviceConfigs)
+export const serviceUrls = app.defaultIngress.apply((baseUrl) =>
+  buildExternalUrls(serviceConfigs, baseUrl ?? ''),
+)

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

@@ -0,0 +1,20 @@
+{
+  "name": "infra",
+  "private": true,
+  "scripts": {
+    "generate-env": "echo '# Generated .env.local' > ../.env.local",
+    "lint": "biome lint --fix",
+    "pulumi": "pulumi"
+  },
+  "dependencies": {
+    "@crossdelta/infrastructure": "latest",
+    "@pulumi/digitalocean": "^4.55.0",
+    "@pulumi/pulumi": "^3.208.0",
+    "tsx": "^4.19.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.7",
+    "@types/node": "^24.10.1",
+    "typescript": "^5.9.3"
+  }
+}

package/bin/templates/workspace/infra/services/example.ts.hbs

@@ -0,0 +1,21 @@
+import type { ServiceConfig } from '@crossdelta/infrastructure'
+
+/**
+ * Example service configuration.
+ *
+ * See ServiceConfig type for all available options:
+ * - httpPort: Public port with ingress routing
+ * - internalPorts: Internal-only ports
+ * - ingressPrefix: URL path prefix (e.g., '/api')
+ * - healthCheck: Health check configuration
+ */
+const config: ServiceConfig = {
+  name: 'example-service',
+  instanceSizeSlug: 'apps-s-1vcpu-0.5gb',
+  environmentSlug: 'node-js',
+  httpPort: 3000,
+  ingressPrefix: '/',
+  skip: true, // Set to false when ready to deploy
+}
+
+export default config

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

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "commonjs",
+    "lib": ["ES2022"],
+    "moduleResolution": "node",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "outDir": "./dist"
+  },
+  "include": ["**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/bin/templates/workspace/npmrc.hbs

@@ -0,0 +1,2 @@
+# Add private registry scopes here if needed
+# @your-org:registry=https://npm.pkg.github.com

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

@@ -0,0 +1,28 @@
+{
+  "name": "{{projectName}}",
+  "private": true,
+  "scripts": {
+    "dev": "bun pf dev",
+    "generate-env": "turbo run generate-env --ui=stream",
+    "build": "bun --env-file .env.local turbo run build",
+    "preview": "bun --env-file .env.local turbo run preview",
+    "lint": "bun turbo run lint",
+    "format": "bun turbo run format",
+    "pulumi": "turbo run pulumi --",
+    "test": "bun --env-file .env.local turbo run test"
+  },
+  "pf": {
+    "registry": "{{projectName}}/platform",
+    "dev": {
+      "watchDirs": ["infra/services"],
+      "watchPackages": ["services", "apps"]
+    }
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.7",
+    "@crossdelta/platform-sdk": "latest",
+    "turbo": "^2.5.6"
+  },
+  "packageManager": "bun@1.2.7",
+  "workspaces": ["packages/*", "apps/*", "services/*", "infra"]
+}

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

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://turborepo.org/schema.json",
+  "tasks": {
+    "start:dev": {
+      "cache": false,
+      "persistent": true
+    },
+    "generate-env": {
+      "cache": false
+    },
+    "pulumi": {},
+    "build": {
+      "cache": false
+    },
+    "test": {
+      "cache": false
+    },
+    "format": {
+      "cache": false
+    },
+    "lint": {
+      "cache": false
+    },
+    "preview": {
+      "cache": false,
+      "persistent": true
+    }
+  },
+  "ui": "tui",
+  "concurrency": "50",
+  "globalPassThroughEnv": ["*"]
+}

package/package.json

@@ -1,7 +1,21 @@
 {
   "name": "@crossdelta/platform-sdk",
-  "version": "0.2.24",
-  "description": "🚀 Crossdelta Platform SDK - build scalable projects faster",
+  "version": "0.2.26",
+  "description": "CLI toolkit for scaffolding Turborepo workspaces with Pulumi infrastructure and Hono/NestJS microservices",
+  "keywords": [
+    "cli",
+    "scaffolding",
+    "microservices",
+    "turborepo",
+    "monorepo",
+    "pulumi",
+    "infrastructure-as-code",
+    "hono",
+    "nestjs",
+    "bun",
+    "devtools"
+  ],
+  "homepage": "https://www.npmjs.com/package/@crossdelta/platform-sdk",
   "bin": {
     "platform": "./bin/cli.js",
     "pf": "./bin/cli.js"
@@ -20,10 +34,6 @@
   "exports": {
     "./schemas/event.schema.json": "./schemas/event.schema.json"
   },
-  "repository": {
-    "type": "git",
-    "url": "git@github.com:crossdelta/platform-sdk.git"
-  },
   "publishConfig": {
     "access": "public"
   },
@@ -34,7 +44,7 @@
   "scripts": {
     "start:dev": "DEBUG=true esbuild cli/src/index.ts --bundle --platform=node --format=cjs --outfile=bin/cli.js --banner:js=\"#!/usr/bin/env node\" --external:@crossdelta/infrastructure --watch",
     "build:cli": "esbuild cli/src/index.ts --minify --bundle --platform=node --format=cjs --outfile=bin/cli.js --banner:js=\"#!/usr/bin/env node\" --external:@crossdelta/infrastructure",
-    "build:cli:copy": "cp cli/integration.collection.json bin/integration.collection.json",
+    "build:cli:copy": "cp cli/integration.collection.json bin/integration.collection.json && rm -rf bin/templates && mkdir -p bin/templates && cp -r cli/src/commands/create/workspace/templates bin/templates/workspace && cp -r cli/src/commands/create/hono-microservice/templates bin/templates/hono-microservice && cp -r cli/src/commands/create/nest-microservice/templates bin/templates/nest-microservice",
     "build:schematics:transpile": "tsc --project tsconfig.schematics.json",
     "build:schematics:copy": "cp -R schematics/* dist/schematics && find dist/schematics -name '*.ts' -delete",
     "build:schematics": "npm run build:schematics:transpile && npm run build:schematics:copy",
@@ -58,6 +68,7 @@
     "execa": "^9.5.2",
     "fs-extra": "^11.3.0",
     "globby": "^14.1.0",
+    "handlebars": "^4.7.8",
     "listr2": "^8.3.2",
     "ora": "^8.2.0",
     "os": "^0.1.2",