create-bcp-app 0.2.14 → 0.2.15

package/README.md

@@ -69,17 +69,17 @@ Select storage provider:
 
 New projects include `bcp.project.json`.
 
-Example for the `0.2.14` target:
+Example for the `0.2.15` target:
 
 ```json
 {
   "schemaVersion": 1,
   "framework": "bcp",
   "projectName": "my-app",
-  "frameworkPackage": "npm:@chidchanun/bcp@0.2.14",
+  "frameworkPackage": "npm:@chidchanun/bcp@0.2.15",
   "createdWith": {
     "package": "create-bcp-app",
-    "version": "0.2.14"
+    "version": "0.2.15"
   },
   "packageManager": "npm",
   "presets": {
@@ -314,6 +314,59 @@ runTestMiddleware()
 
 `bcp/testing` is server-only. It can be used with Node `node:test`, Vitest, Jest or another runner; BCP does not install those runners as framework dependencies.
 
+## Plugin & Module Platform — 0.2.15+
+
+Use `bcp/plugins` to compose reusable server-side application modules with explicit lifecycle and dependencies.
+
+```ts
+import {
+    createPluginHost,
+    defineModule,
+    definePlugin,
+} from "bcp/plugins";
+
+const databasePlugin =
+    definePlugin({
+        name: "database",
+        setup(context) {
+            context.services.provide(
+                "database",
+                db
+            );
+        },
+    });
+
+const jobsPlugin =
+    definePlugin({
+        name: "jobs",
+        requires: [
+            "database",
+        ],
+    });
+
+const backendModule =
+    defineModule({
+        name: "backend",
+        plugins: [
+            databasePlugin,
+            jobsPlugin,
+        ],
+    });
+
+const host =
+    createPluginHost({
+        modules: [
+            backendModule,
+        ],
+    });
+
+await host.start();
+```
+
+Plugins can use `setup/start/stop/dispose`, typed config parsers, a shared service registry and an awaited in-process hook bus. Required dependencies start first; shutdown runs in reverse order.
+
+`bcp/plugins` is server-only and cannot be imported into page/client bundles.
+
 ## Storage providers
 
 Supported presets are Local Server, Amazon S3 and Cloudflare R2. Storage credentials are server-only and must not use `BCP_PUBLIC_*` variables.
@@ -352,5 +405,5 @@ npm run generate -- migration create_users
 For prerelease/local package verification:
 
 ```bash
-npx create-bcp-app my-app --bcp file:../chidchanun-bcp-0.2.14.tgz
+npx create-bcp-app my-app --bcp file:../chidchanun-bcp-0.2.15.tgz
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-bcp-app",
-  "version": "0.2.14",
+  "version": "0.2.15",
   "description": "Create a new BCP Framework application.",
   "type": "module",
   "license": "MIT",

package/template/README.md

@@ -240,10 +240,54 @@ await withTestTransaction(
 );
 ```
 
-Additional helpers include job/workflow/outbox harnesses, `runTestMiddleware()`, fake clocks and IDs, a fake `RealtimeSocket`, realtime event assertions and `readSseEvents()`.
+Additional helpers include job/workflow/outbox harnesses, `runTestMiddleware()`, page loader/guard/action helpers, fake clocks and IDs, a fake `RealtimeSocket`, realtime event assertions and `readSseEvents()`.
 
 BCP does not require Jest or Vitest; these helpers work with Node `node:test` or another runner.
 
+## Plugin & Module Platform — BCP 0.2.15+
+
+Use `bcp/plugins` to compose reusable server-only application services with explicit dependencies.
+
+```ts
+import {
+    createPluginHost,
+    definePlugin,
+} from "bcp/plugins";
+
+const databasePlugin =
+    definePlugin({
+        name: "database",
+        setup(context) {
+            context.services.provide(
+                "database",
+                db
+            );
+        },
+    });
+
+const jobsPlugin =
+    definePlugin({
+        name: "jobs",
+        requires: [
+            "database",
+        ],
+    });
+
+export const plugins =
+    createPluginHost({
+        plugins: [
+            jobsPlugin,
+            databasePlugin,
+        ],
+    });
+```
+
+Plugin startup follows dependency order and shutdown reverses it. Plugins can use `setup/start/stop/dispose`, config parsers, shared services and async hooks.
+
+Use `defineModule()` when a reusable package needs to bundle multiple plugin definitions into one named module.
+
+`bcp/plugins` is server-only and cannot be imported from page/client bundles.
+
 ## Generate framework files
 
 ```bash