@chidchanun/bcp 0.2.16 → 0.2.18

package/docs/releases/0.2.18.md

@@ -0,0 +1,136 @@
+# BCP Framework 0.2.18 — Deployment Platform v2
+
+Status: **unreleased**
+
+`0.2.18` adds a framework-native deployment lifecycle and hardens prepared npm runtime entrypoints for standalone Node production use.
+
+## Highlights
+
+### New `bcp/deployment` entrypoint
+
+```ts
+import {
+    createDeploymentRuntime,
+} from "bcp/deployment";
+```
+
+Deployment runtime provides:
+
+- ordered resource startup;
+- reverse-order graceful shutdown;
+- startup rollback;
+- readiness checks;
+- deployment/process diagnostics;
+- deployment/instance/release metadata;
+- `SIGTERM` / `SIGINT` handling;
+- integration with existing BCP shutdown hooks.
+
+### Readiness endpoints
+
+```ts
+return createDeploymentReadinessResponse(
+    deployment
+);
+```
+
+Ready runtime returns `200`; non-ready/draining/failed runtime returns `503`.
+
+### Diagnostics
+
+```ts
+return createDeploymentDiagnosticsResponse(
+    deployment
+);
+```
+
+Diagnostics include process/runtime identity, uptime and resource lifecycle state plus optional resource diagnostics.
+
+### Runtime identity
+
+Supported runtime environment values:
+
+```text
+BCP_DEPLOYMENT_ID
+BCP_INSTANCE_ID
+BCP_RELEASE
+NODE_ENV
+BCP_SHUTDOWN_TIMEOUT_MS
+```
+
+### Compiled production entrypoints
+
+Prepared framework packages now use compiled ESM runtime files for additional server-side entrypoints:
+
+```text
+bcp/config       -> config.mjs
+bcp/auth         -> auth.mjs
+bcp/deployment   -> deployment.mjs
+bcp/server       -> server.mjs
+bcp/middleware   -> middleware.mjs
+```
+
+Existing compiled server runtimes such as cache/database/jobs/workflow/events/realtime/testing/plugins/observability remain compiled as before.
+
+This closes a packaging gap where several server entrypoints still resolved directly to TypeScript in the published package.
+
+## Public API additions
+
+```text
+createDeploymentRuntime
+createDeploymentReadinessResponse
+createDeploymentDiagnosticsResponse
+
+DeploymentRuntime
+DeploymentRuntimeOptions
+DeploymentRuntimeState
+DeploymentResource
+DeploymentResourceContext
+DeploymentResourceStatus
+DeploymentReadinessResult
+DeploymentReadinessReport
+DeploymentDiagnosticsReport
+DeploymentMetadata
+DeploymentSignalOptions
+DeploymentShutdownOptions
+```
+
+## Lifecycle model
+
+```text
+idle
+  ↓
+starting
+  ↓
+ready
+  ↓
+draining
+  ↓
+stopped
+```
+
+Failures move the runtime to `failed`.
+
+## Compatibility
+
+There are no intentional breaking changes from `0.2.17`.
+
+Existing production hardening APIs, shutdown hooks, `bcp build`, `bcp package` and application package manifests remain supported.
+
+`bcp/deployment` is additive.
+
+## Validation
+
+Before tagging/publishing:
+
+```bash
+npm run typecheck
+npm run test:unit
+npm run test:integration
+npm run test:e2e
+npm run test:package
+npm run rc:check
+```
+
+The `0.2.18` package smoke validates the compiled deployment runtime plus compiled config/auth/server/middleware entrypoints from the prepared `.package/bcp` staging directory.
+
+Do not tag/publish until the final commit passes the complete RC sequence.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chidchanun/bcp",
-  "version": "0.2.16",
+  "version": "0.2.18",
   "description": "BCP Framework - a React full-stack framework with file-based routing, SSR, APIs, middleware, islands, caching and standalone production builds.",
   "type": "module",
   "license": "MIT",
@@ -42,7 +42,7 @@
     },
     "./config": {
       "types": "./packages/client/src/config.ts",
-      "default": "./packages/client/src/config.ts"
+      "default": "./packages/client/src/config.mjs"
     },
     "./validation": {
       "types": "./packages/client/src/validation.ts",
@@ -60,7 +60,7 @@
     "./auth": {
       "types": "./packages/client/src/auth.ts",
       "browser": "./packages/client/src/server-only.browser.mjs",
-      "default": "./packages/client/src/auth.ts"
+      "default": "./packages/client/src/auth.mjs"
     },
     "./jobs": {
       "types": "./packages/client/src/jobs.ts",
@@ -95,12 +95,17 @@
     "./observability": {
       "types": "./packages/client/src/observability.ts",
       "browser": "./packages/client/src/server-only.browser.mjs",
-      "default": "./packages/client/src/observability.ts"
+      "default": "./packages/client/src/observability.mjs"
+    },
+    "./deployment": {
+      "types": "./packages/client/src/deployment.ts",
+      "browser": "./packages/client/src/server-only.browser.mjs",
+      "default": "./packages/client/src/deployment.mjs"
     },
     "./server": {
       "types": "./packages/client/src/server.ts",
       "browser": "./packages/client/src/server-only.browser.mjs",
-      "default": "./packages/client/src/server.ts"
+      "default": "./packages/client/src/server.mjs"
     },
     "./server-only": {
       "types": "./packages/client/src/server-only.d.ts",
@@ -109,7 +114,7 @@
     },
     "./middleware": {
       "types": "./packages/server/src/middleware.ts",
-      "default": "./packages/server/src/middleware.ts"
+      "default": "./packages/server/src/middleware.mjs"
     },
     "./package.json": "./package.json"
   },

package/packages/bundler/src/client-boundary.ts

@@ -35,6 +35,7 @@ const SERVER_ONLY_IMPORTS =
         "bcp/testing",
         "bcp/plugins",
         "bcp/observability",
+        "bcp/deployment",
     ]);
 
 export function validateClientBoundaries(