@chidchanun/bcp 0.3.0 → 0.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (24) hide show
  1. package/README.md +135 -111
  2. package/docs/README.md +53 -78
  3. package/docs/api-freeze-snapshot.json +24 -2
  4. package/docs/api-manifest.json +29 -13
  5. package/docs/api-reference.md +195 -197
  6. package/docs/application-platform.md +141 -171
  7. package/docs/docs-web-manifest.json +9 -5
  8. package/docs/migration-0.3.md +189 -68
  9. package/docs/module-system-v2.md +386 -0
  10. package/docs/platform-contract.md +53 -37
  11. package/docs/platform-manifest.json +36 -4
  12. package/docs/releases/0.3.1.md +116 -0
  13. package/docs/releases/0.3.2.md +125 -0
  14. package/docs/service-container.md +333 -0
  15. package/package.json +13 -1
  16. package/packages/bundler/src/client-boundary.ts +2 -0
  17. package/packages/client/src/application.mjs +1004 -34
  18. package/packages/client/src/container.mjs +573 -0
  19. package/packages/client/src/container.ts +24 -0
  20. package/packages/client/src/modules.mjs +392 -0
  21. package/packages/client/src/modules.ts +17 -0
  22. package/packages/server/src/application.ts +171 -11
  23. package/packages/server/src/container.ts +970 -0
  24. package/packages/server/src/modules.ts +682 -0
package/docs/api-manifest.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
3
  "framework": "bcp",
4
- "version": "0.3.0",
4
+ "version": "0.3.2",
5
5
  "releaseState": "unreleased",
6
6
  "coverage": "public-entrypoints",
7
7
  "entrypoints": [
@@ -59,7 +59,7 @@
59
59
  "environment": "server",
60
60
  "route": "/docs/api-reference#bcp-database",
61
61
  "summary": "Provider-neutral MySQL, PostgreSQL and SQLite query, transaction, lifecycle and migration primitives.",
62
- "guides": ["/docs/database", "/docs/database-migrations", "/docs/transactional-outbox-events", "/docs/testing-platform", "/docs/observability-v3", "/docs/deployment-platform-v2", "/docs/application-platform"]
62
+ "guides": ["/docs/database", "/docs/database-migrations", "/docs/transactional-outbox-events", "/docs/testing-platform", "/docs/observability-v3", "/docs/deployment-platform-v2", "/docs/application-platform", "/docs/service-container", "/docs/module-system-v2"]
63
63
  },
64
64
  {
65
65
  "package": "bcp/auth",
@@ -67,7 +67,7 @@
67
67
  "environment": "server",
68
68
  "route": "/docs/api-reference#bcp-auth",
69
69
  "summary": "Authentication Platform v2 plus permission checks, authorization policies and auth/guest/role/permission route guards, published with a compiled Node runtime.",
70
- "guides": ["/docs/authentication", "/docs/auth-session-store", "/docs/auth-route-guards", "/docs/authorization-security", "/docs/session-auth", "/docs/testing-platform", "/docs/deployment-platform-v2", "/docs/application-platform"]
70
+ "guides": ["/docs/authentication", "/docs/auth-session-store", "/docs/auth-route-guards", "/docs/authorization-security", "/docs/session-auth", "/docs/testing-platform", "/docs/deployment-platform-v2", "/docs/application-platform", "/docs/service-container", "/docs/module-system-v2"]
71
71
  },
72
72
  {
73
73
  "package": "bcp/jobs",
@@ -75,7 +75,7 @@
75
75
  "environment": "server",
76
76
  "route": "/docs/api-reference#bcp-jobs",
77
77
  "summary": "Background queues and schedules with visibility leases, heartbeats, stale recovery, DLQ maintenance and Redis-compatible durable adapters.",
78
- "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", "/docs/application-platform"]
78
+ "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", "/docs/application-platform", "/docs/service-container", "/docs/module-system-v2"]
79
79
  },
80
80
  {
81
81
  "package": "bcp/workflow",
@@ -83,7 +83,7 @@
83
83
  "environment": "server",
84
84
  "route": "/docs/api-reference#bcp-workflow",
85
85
  "summary": "Persistent workflow orchestration with sequential and parallel steps, retries, delays, compensation, run leases and optional durable queue execution.",
86
- "guides": ["/docs/workflow-orchestration", "/docs/durable-jobs", "/docs/realtime-platform", "/docs/testing-platform", "/docs/observability-v3", "/docs/deployment-platform-v2", "/docs/application-platform"]
86
+ "guides": ["/docs/workflow-orchestration", "/docs/durable-jobs", "/docs/realtime-platform", "/docs/testing-platform", "/docs/observability-v3", "/docs/deployment-platform-v2", "/docs/application-platform", "/docs/service-container", "/docs/module-system-v2"]
87
87
  },
88
88
  {
89
89
  "package": "bcp/events",
@@ -91,7 +91,7 @@
91
91
  "environment": "server",
92
92
  "route": "/docs/api-reference#bcp-events",
93
93
  "summary": "Transactional outbox and event delivery APIs with SQL persistence, dispatcher leases, retries, stale recovery, queue handoff and in-process event bus delivery.",
94
- "guides": ["/docs/transactional-outbox-events", "/docs/database", "/docs/durable-jobs", "/docs/realtime-platform", "/docs/testing-platform", "/docs/observability-v3", "/docs/deployment-platform-v2", "/docs/application-platform"]
94
+ "guides": ["/docs/transactional-outbox-events", "/docs/database", "/docs/durable-jobs", "/docs/realtime-platform", "/docs/testing-platform", "/docs/observability-v3", "/docs/deployment-platform-v2", "/docs/application-platform", "/docs/service-container", "/docs/module-system-v2"]
95
95
  },
96
96
  {
97
97
  "package": "bcp/realtime",
@@ -99,7 +99,7 @@
99
99
  "environment": "server",
100
100
  "route": "/docs/api-reference#bcp-realtime",
101
101
  "summary": "Realtime channels, cross-hub broker delivery, presence, channel authorization, WebSocket adapter integration, heartbeat handling and built-in Server-Sent Events responses.",
102
- "guides": ["/docs/realtime-platform", "/docs/authentication", "/docs/testing-platform", "/docs/observability-v3", "/docs/deployment-platform-v2", "/docs/application-platform"]
102
+ "guides": ["/docs/realtime-platform", "/docs/authentication", "/docs/testing-platform", "/docs/observability-v3", "/docs/deployment-platform-v2", "/docs/application-platform", "/docs/service-container", "/docs/module-system-v2"]
103
103
  },
104
104
  {
105
105
  "package": "bcp/testing",
@@ -107,15 +107,15 @@
107
107
  "environment": "server",
108
108
  "route": "/docs/api-reference#bcp-testing",
109
109
  "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.",
110
- "guides": ["/docs/testing-platform", "/docs/authentication", "/docs/database", "/docs/durable-jobs", "/docs/workflow-orchestration", "/docs/transactional-outbox-events", "/docs/realtime-platform", "/docs/observability-v3", "/docs/application-platform"]
110
+ "guides": ["/docs/testing-platform", "/docs/authentication", "/docs/database", "/docs/durable-jobs", "/docs/workflow-orchestration", "/docs/transactional-outbox-events", "/docs/realtime-platform", "/docs/observability-v3", "/docs/application-platform", "/docs/service-container", "/docs/module-system-v2"]
111
111
  },
112
112
  {
113
113
  "package": "bcp/plugins",
114
114
  "source": "packages/client/src/plugins.ts",
115
115
  "environment": "server",
116
116
  "route": "/docs/api-reference#bcp-plugins",
117
- "summary": "Plugin and module composition with dependency ordering, lifecycle hooks, typed config parsing, shared services and asynchronous extension hooks.",
118
- "guides": ["/docs/plugin-module-platform", "/docs/configuration", "/docs/testing-platform", "/docs/observability-v3", "/docs/deployment-platform-v2", "/docs/application-platform"]
117
+ "summary": "Plugin composition with dependency ordering, lifecycle hooks, typed config parsing, shared services and asynchronous extension hooks. Legacy plugin-group modules remain supported.",
118
+ "guides": ["/docs/plugin-module-platform", "/docs/module-system-v2", "/docs/configuration", "/docs/testing-platform", "/docs/observability-v3", "/docs/deployment-platform-v2", "/docs/application-platform", "/docs/service-container"]
119
119
  },
120
120
  {
121
121
  "package": "bcp/observability",
@@ -131,15 +131,31 @@
131
131
  "environment": "server",
132
132
  "route": "/docs/api-reference#bcp-deployment",
133
133
  "summary": "Deployment Platform v2 runtime lifecycle with resource startup/shutdown ordering, readiness, diagnostics, deployment metadata, signal handling and framework shutdown-hook integration.",
134
- "guides": ["/docs/deployment-platform-v2", "/docs/application-packaging", "/docs/production-hardening", "/docs/observability-v3", "/docs/application-platform"]
134
+ "guides": ["/docs/deployment-platform-v2", "/docs/application-packaging", "/docs/production-hardening", "/docs/observability-v3", "/docs/application-platform", "/docs/service-container", "/docs/module-system-v2"]
135
+ },
136
+ {
137
+ "package": "bcp/container",
138
+ "source": "packages/client/src/container.ts",
139
+ "environment": "server",
140
+ "route": "/docs/api-reference#bcp-container",
141
+ "summary": "Typed dependency injection and service container with value/factory/class providers, singleton/scoped/transient lifetimes, child scopes, test overrides, dependency graph diagnostics, circular-dependency detection and reverse disposal.",
142
+ "guides": ["/docs/service-container", "/docs/module-system-v2", "/docs/application-platform", "/docs/testing-platform", "/docs/migration-0.3"]
143
+ },
144
+ {
145
+ "package": "bcp/modules",
146
+ "source": "packages/client/src/modules.ts",
147
+ "environment": "server",
148
+ "route": "/docs/api-reference#bcp-modules",
149
+ "summary": "Module System v2 definitions and composition with dependency imports, DI provider exports/re-exports, plugins, shared services, deployment resources, lifecycle hooks, diagnostics and application integration.",
150
+ "guides": ["/docs/module-system-v2", "/docs/application-platform", "/docs/service-container", "/docs/plugin-module-platform", "/docs/migration-0.3"]
135
151
  },
136
152
  {
137
153
  "package": "bcp/application",
138
154
  "source": "packages/client/src/application.ts",
139
155
  "environment": "server",
140
156
  "route": "/docs/api-reference#bcp-application",
141
- "summary": "Application Platform composition root for typed app config, shared services, plugins/modules, deployment resources, lifecycle ordering, readiness, diagnostics and graceful shutdown.",
142
- "guides": ["/docs/application-platform", "/docs/plugin-module-platform", "/docs/deployment-platform-v2", "/docs/observability-v3", "/docs/migration-0.3"]
157
+ "summary": "Application Platform composition root for typed app config, dependency injection, Module System v2, legacy shared services/plugins/modules, deployment resources, lifecycle ordering, readiness, diagnostics and graceful shutdown.",
158
+ "guides": ["/docs/application-platform", "/docs/module-system-v2", "/docs/service-container", "/docs/plugin-module-platform", "/docs/deployment-platform-v2", "/docs/observability-v3", "/docs/migration-0.3"]
143
159
  },
144
160
  {
145
161
  "package": "bcp/server",