@chidchanun/bcp 0.3.0 → 0.3.1

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 (19) hide show
  1. package/README.md +135 -111
  2. package/docs/README.md +53 -78
  3. package/docs/api-freeze-snapshot.json +13 -2
  4. package/docs/api-manifest.json +20 -12
  5. package/docs/api-reference.md +195 -197
  6. package/docs/application-platform.md +141 -171
  7. package/docs/docs-web-manifest.json +6 -4
  8. package/docs/migration-0.3.md +189 -68
  9. package/docs/platform-contract.md +53 -37
  10. package/docs/platform-manifest.json +21 -4
  11. package/docs/releases/0.3.1.md +116 -0
  12. package/docs/service-container.md +333 -0
  13. package/package.json +7 -1
  14. package/packages/bundler/src/client-boundary.ts +1 -0
  15. package/packages/client/src/application.mjs +586 -20
  16. package/packages/client/src/container.mjs +573 -0
  17. package/packages/client/src/container.ts +24 -0
  18. package/packages/server/src/application.ts +116 -5
  19. package/packages/server/src/container.ts +970 -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.1",
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"]
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"]
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"]
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"]
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"]
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"]
103
103
  },
104
104
  {
105
105
  "package": "bcp/testing",
@@ -107,7 +107,7 @@
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"]
111
111
  },
112
112
  {
113
113
  "package": "bcp/plugins",
@@ -115,7 +115,7 @@
115
115
  "environment": "server",
116
116
  "route": "/docs/api-reference#bcp-plugins",
117
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"]
118
+ "guides": ["/docs/plugin-module-platform", "/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,23 @@
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"]
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/application-platform", "/docs/testing-platform", "/docs/migration-0.3"]
135
143
  },
136
144
  {
137
145
  "package": "bcp/application",
138
146
  "source": "packages/client/src/application.ts",
139
147
  "environment": "server",
140
148
  "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"]
149
+ "summary": "Application Platform composition root for typed app config, dependency injection, legacy shared services, plugins/modules, deployment resources, lifecycle ordering, readiness, diagnostics and graceful shutdown.",
150
+ "guides": ["/docs/application-platform", "/docs/service-container", "/docs/plugin-module-platform", "/docs/deployment-platform-v2", "/docs/observability-v3", "/docs/migration-0.3"]
143
151
  },
144
152
  {
145
153
  "package": "bcp/server",