@chidchanun/bcp 0.2.16 → 0.2.18

package/docs/README.md

@@ -2,7 +2,7 @@
 
 The `docs/` directory is the documentation source of truth for BCP Framework and is organized for **`bcp-docs-web`**.
 
-> **Documentation target:** BCP Framework `0.2.16 — Cache Platform v2`
+> **Documentation target:** BCP Framework `0.2.18 — Deployment Platform v2`
 >
 > **Release state:** unreleased development target until RC validation, tagging and npm publication complete.
 
@@ -42,60 +42,58 @@ Framework source and tests remain authoritative for runtime behavior.
 | `0.2.14` | Testing Platform |
 | `0.2.15` | Plugin & Module Platform |
 | `0.2.16` | Cache Platform v2 |
+| `0.2.17` | Observability Platform v3 |
+| `0.2.18` | Deployment Platform v2 |
 
-## 0.2.16 — Cache Platform v2
+## 0.2.18 — Deployment Platform v2
 
-`0.2.16` extends the existing `bcp/cache` public entrypoint while keeping its original process-local APIs backward compatible.
+`0.2.18` adds the server-only `bcp/deployment` entrypoint and completes compiled production runtime coverage for key server package surfaces.
 
-Primary Cache Store v2 APIs:
+Primary APIs:
 
 ```ts
 import {
-    createCacheMetrics,
-    createCacheStore,
-    createMemoryCacheAdapter,
-    createMemoryCacheLockAdapter,
-    createRedisCacheAdapter,
-    createRedisCacheLockAdapter,
-} from "bcp/cache";
+    createDeploymentDiagnosticsResponse,
+    createDeploymentReadinessResponse,
+    createDeploymentRuntime,
+} from "bcp/deployment";
 ```
 
 Runtime model:
 
 ```text
-Application
+process start
     |
     v
-CacheStore
+DeploymentRuntime
     |
-    +-- CacheAdapter
-    |      +-- memory
-    |      +-- Redis-compatible
+    +-- resource start order
+    +-- readiness checks
+    +-- diagnostics
+    +-- deployment metadata
+    +-- SIGTERM / SIGINT
     |
-    +-- CacheLockAdapter
-    |      +-- memory
-    |      +-- Redis-compatible
+    v
+state = ready
+    |
+shutdown/drain
     |
-    +-- local singleflight
-    +-- distributed cache-fill lease
-    +-- TTL / tags / paths
-    +-- metrics sink
+    v
+reverse-order resource stop
 ```
 
-`getOrSet()` deduplicates cache fills inside one process. With a shared lock adapter, multiple processes coordinate cache misses through owner-scoped leases, optional lock renewal and wait/poll behavior.
-
-The Redis reference adapter uses the default hash-tagged namespace `bcp:{cache}` and does not install or own a Redis client.
+Prepared npm runtime targets now include compiled ESM for `bcp/config`, `bcp/auth`, `bcp/deployment`, `bcp/server` and `bcp/middleware` in addition to the server entrypoints compiled in earlier releases.
 
 New/updated sources:
 
 | Source | Purpose |
 | --- | --- |
-| `cache-platform-v2.md` | Adapter contracts, Redis cache/locks, stampede protection, TTL/invalidation and metrics |
-| `api-reference.md` | `bcp/cache` Cache Platform v2 APIs |
-| `platform-manifest.json` | Cache v2 capability flags |
-| `api-manifest.json` | Updated `bcp/cache` source/guide ownership |
-| `docs-web-manifest.json` | Cache v2 docs navigation and `0.2.16` release route |
-| `releases/0.2.16.md` | Cache Platform v2 release notes |
+| `deployment-platform-v2.md` | Runtime lifecycle, readiness, diagnostics, metadata and graceful shutdown |
+| `api-reference.md` | `bcp/deployment` APIs |
+| `platform-manifest.json` | Deployment/compiled-runtime capability flags |
+| `api-manifest.json` | `bcp/deployment` source/guide ownership |
+| `docs-web-manifest.json` | Deployment v2 navigation and `0.2.18` release route |
+| `releases/0.2.18.md` | Deployment Platform v2 release notes |
 
 ## Update rule
 
@@ -114,9 +112,8 @@ When framework behavior or public surface changes:
 
 | Website route | Markdown source |
 | --- | --- |
-| `/docs/authentication` | `authentication.md` |
-| `/docs/observability` | `observability.md` |
-| `/docs/background-jobs` | `background-jobs.md` |
+| `/docs/observability-v3` | `observability-v3.md` |
+| `/docs/deployment-platform-v2` | `deployment-platform-v2.md` |
 | `/docs/durable-jobs` | `durable-jobs.md` |
 | `/docs/workflow-orchestration` | `workflow-orchestration.md` |
 | `/docs/transactional-outbox-events` | `transactional-outbox-events.md` |
@@ -125,7 +122,7 @@ When framework behavior or public surface changes:
 | `/docs/plugin-module-platform` | `plugin-module-platform.md` |
 | `/docs/cache-platform-v2` | `cache-platform-v2.md` |
 | `/docs/api-reference` | `api-reference.md` |
-| `/releases/0.2.16` | `releases/0.2.16.md` |
+| `/releases/0.2.18` | `releases/0.2.18.md` |
 
 Every route/source pair is validated by unit tests.
 
@@ -147,6 +144,7 @@ bcp/realtime
 bcp/testing
 bcp/plugins
 bcp/observability
+bcp/deployment
 bcp/server
 bcp/server-only
 bcp/middleware
@@ -156,7 +154,7 @@ The API-manifest entrypoint set must match the platform public-entrypoint set ex
 
 ## Release validation
 
-Before publishing `0.2.16`:
+Before publishing `0.2.18`:
 
 ```bash
 npm run typecheck
@@ -167,6 +165,6 @@ npm run test:package
 npm run rc:check
 ```
 
-Cache Platform v2 validation covers TTL/tag/path invalidation, local singleflight, cross-store distributed locking, lock timeout behavior, Redis command contracts, metrics integration, compiled `cache.mjs` package execution and docs/platform/API parity.
+Deployment Platform v2 validation covers resource lifecycle ordering, startup rollback, readiness/diagnostics, runtime metadata, server-only boundaries, compiled production entrypoints and docs/platform/API parity.
 
 The final release tag must point to the exact commit that passed the complete RC sequence.

package/docs/api-manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "framework": "bcp",
-  "version": "0.2.16",
+  "version": "0.2.18",
   "releaseState": "unreleased",
   "coverage": "public-entrypoints",
   "entrypoints": [
@@ -27,15 +27,15 @@
       "environment": "server-preferred",
       "route": "/docs/api-reference#bcp-cache",
       "summary": "Backward-compatible request/data caching plus Cache Platform v2 adapters, Redis-compatible distributed cache and locks, stampede protection, TTL/tag/path invalidation and metrics integration.",
-      "guides": ["/docs/caching", "/docs/cache-platform-v2", "/docs/observability"]
+      "guides": ["/docs/caching", "/docs/cache-platform-v2", "/docs/observability-v3"]
     },
     {
       "package": "bcp/config",
       "source": "packages/client/src/config.ts",
       "environment": "server",
       "route": "/docs/api-reference#bcp-config",
-      "summary": "Typed BCP configuration, environment-schema validation and configuration diagnostics APIs.",
-      "guides": ["/docs/configuration", "/docs/environment-validation"]
+      "summary": "Typed BCP configuration, environment-schema validation and configuration diagnostics APIs with a compiled production runtime.",
+      "guides": ["/docs/configuration", "/docs/environment-validation", "/docs/deployment-platform-v2"]
     },
     {
       "package": "bcp/validation",
@@ -59,15 +59,15 @@
       "environment": "server",
       "route": "/docs/api-reference#bcp-database",
       "summary": "Provider-neutral MySQL, PostgreSQL and SQLite query, transaction, lifecycle and migration primitives.",
-      "guides": ["/docs/database", "/docs/database-migrations", "/docs/transactional-outbox-events", "/docs/testing-platform"]
+      "guides": ["/docs/database", "/docs/database-migrations", "/docs/transactional-outbox-events", "/docs/testing-platform", "/docs/observability-v3", "/docs/deployment-platform-v2"]
     },
     {
       "package": "bcp/auth",
       "source": "packages/client/src/auth.ts",
       "environment": "server",
       "route": "/docs/api-reference#bcp-auth",
-      "summary": "Authentication Platform v2 plus permission checks, authorization policies and auth/guest/role/permission route guards.",
-      "guides": ["/docs/authentication", "/docs/auth-session-store", "/docs/auth-route-guards", "/docs/authorization-security", "/docs/session-auth", "/docs/testing-platform"]
+      "summary": "Authentication Platform v2 plus permission checks, authorization policies and auth/guest/role/permission route guards, published with a compiled Node runtime.",
+      "guides": ["/docs/authentication", "/docs/auth-session-store", "/docs/auth-route-guards", "/docs/authorization-security", "/docs/session-auth", "/docs/testing-platform", "/docs/deployment-platform-v2"]
     },
     {
       "package": "bcp/jobs",
@@ -75,7 +75,7 @@
       "environment": "server",
       "route": "/docs/api-reference#bcp-jobs",
       "summary": "Background queues and schedules with visibility leases, heartbeats, stale recovery, DLQ maintenance and Redis-compatible durable adapters.",
-      "guides": ["/docs/background-jobs", "/docs/job-scheduling", "/docs/durable-jobs", "/docs/transactional-outbox-events", "/docs/realtime-platform", "/docs/testing-platform", "/docs/observability"]
+      "guides": ["/docs/background-jobs", "/docs/job-scheduling", "/docs/durable-jobs", "/docs/transactional-outbox-events", "/docs/realtime-platform", "/docs/testing-platform", "/docs/observability-v3", "/docs/deployment-platform-v2"]
     },
     {
       "package": "bcp/workflow",
@@ -83,7 +83,7 @@
       "environment": "server",
       "route": "/docs/api-reference#bcp-workflow",
       "summary": "Persistent workflow orchestration with sequential and parallel steps, retries, delays, compensation, run leases and optional durable queue execution.",
-      "guides": ["/docs/workflow-orchestration", "/docs/durable-jobs", "/docs/realtime-platform", "/docs/testing-platform", "/docs/observability"]
+      "guides": ["/docs/workflow-orchestration", "/docs/durable-jobs", "/docs/realtime-platform", "/docs/testing-platform", "/docs/observability-v3", "/docs/deployment-platform-v2"]
     },
     {
       "package": "bcp/events",
@@ -91,7 +91,7 @@
       "environment": "server",
       "route": "/docs/api-reference#bcp-events",
       "summary": "Transactional outbox and event delivery APIs with SQL persistence, dispatcher leases, retries, stale recovery, queue handoff and in-process event bus delivery.",
-      "guides": ["/docs/transactional-outbox-events", "/docs/database", "/docs/durable-jobs", "/docs/realtime-platform", "/docs/testing-platform", "/docs/observability"]
+      "guides": ["/docs/transactional-outbox-events", "/docs/database", "/docs/durable-jobs", "/docs/realtime-platform", "/docs/testing-platform", "/docs/observability-v3", "/docs/deployment-platform-v2"]
     },
     {
       "package": "bcp/realtime",
@@ -99,7 +99,7 @@
       "environment": "server",
       "route": "/docs/api-reference#bcp-realtime",
       "summary": "Realtime channels, cross-hub broker delivery, presence, channel authorization, WebSocket adapter integration, heartbeat handling and built-in Server-Sent Events responses.",
-      "guides": ["/docs/realtime-platform", "/docs/authentication", "/docs/testing-platform", "/docs/observability"]
+      "guides": ["/docs/realtime-platform", "/docs/authentication", "/docs/testing-platform", "/docs/observability-v3", "/docs/deployment-platform-v2"]
     },
     {
       "package": "bcp/testing",
@@ -107,7 +107,7 @@
       "environment": "server",
       "route": "/docs/api-reference#bcp-testing",
       "summary": "Framework-native testing utilities for Request/Response handlers, signed auth sessions, rollback transactions, page/server execution, middleware, jobs, workflows, outbox delivery, realtime sockets and SSE.",
-      "guides": ["/docs/testing-platform", "/docs/authentication", "/docs/database", "/docs/durable-jobs", "/docs/workflow-orchestration", "/docs/transactional-outbox-events", "/docs/realtime-platform"]
+      "guides": ["/docs/testing-platform", "/docs/authentication", "/docs/database", "/docs/durable-jobs", "/docs/workflow-orchestration", "/docs/transactional-outbox-events", "/docs/realtime-platform", "/docs/observability-v3"]
     },
     {
       "package": "bcp/plugins",
@@ -115,23 +115,31 @@
       "environment": "server",
       "route": "/docs/api-reference#bcp-plugins",
       "summary": "Plugin and module composition with dependency ordering, lifecycle hooks, typed config parsing, shared services and asynchronous extension hooks.",
-      "guides": ["/docs/plugin-module-platform", "/docs/configuration", "/docs/testing-platform", "/docs/observability"]
+      "guides": ["/docs/plugin-module-platform", "/docs/configuration", "/docs/testing-platform", "/docs/observability-v3", "/docs/deployment-platform-v2"]
     },
     {
       "package": "bcp/observability",
       "source": "packages/client/src/observability.ts",
       "environment": "server",
       "route": "/docs/api-reference#bcp-observability",
-      "summary": "In-process metrics, Prometheus exposition, request metrics middleware and health/readiness checks.",
-      "guides": ["/docs/observability", "/docs/development-logging", "/docs/cache-platform-v2"]
+      "summary": "Metrics, Prometheus output, health checks and Observability Platform v3 distributed tracing with W3C trace context, correlation IDs, request tracing, span exporters and trace-to-metrics integration.",
+      "guides": ["/docs/observability", "/docs/observability-v3", "/docs/development-logging", "/docs/cache-platform-v2", "/docs/deployment-platform-v2"]
+    },
+    {
+      "package": "bcp/deployment",
+      "source": "packages/client/src/deployment.ts",
+      "environment": "server",
+      "route": "/docs/api-reference#bcp-deployment",
+      "summary": "Deployment Platform v2 runtime lifecycle with resource startup/shutdown ordering, readiness, diagnostics, deployment metadata, signal handling and framework shutdown-hook integration.",
+      "guides": ["/docs/deployment-platform-v2", "/docs/application-packaging", "/docs/production-hardening", "/docs/observability-v3"]
     },
     {
       "package": "bcp/server",
       "source": "packages/client/src/server.ts",
       "environment": "server",
       "route": "/docs/api-reference#bcp-server",
-      "summary": "Request context, cookies, CSRF/same-origin protection, logging, production hardening, upload, storage, response and session APIs.",
-      "guides": ["/docs/server-request-apis", "/docs/authorization-security", "/docs/file-upload", "/docs/storage", "/docs/storage-ecosystem", "/docs/production-hardening", "/docs/testing-platform"]
+      "summary": "Request context, cookies, CSRF/same-origin protection, logging, production hardening, upload, storage, response and session APIs, published with a compiled Node runtime.",
+      "guides": ["/docs/server-request-apis", "/docs/authorization-security", "/docs/file-upload", "/docs/storage", "/docs/storage-ecosystem", "/docs/production-hardening", "/docs/testing-platform", "/docs/observability-v3", "/docs/deployment-platform-v2"]
     },
     {
       "package": "bcp/server-only",
@@ -146,8 +154,8 @@
       "source": "packages/server/src/middleware.ts",
       "environment": "server",
       "route": "/docs/api-reference#bcp-middleware",
-      "summary": "Middleware System v2 request/response pipeline types and helpers.",
-      "guides": ["/docs/middleware", "/docs/testing-platform"]
+      "summary": "Middleware System v2 request/response pipeline types and helpers, published with a compiled Node runtime.",
+      "guides": ["/docs/middleware", "/docs/testing-platform", "/docs/observability-v3", "/docs/deployment-platform-v2"]
     }
   ]
 }