create-bcp-app 0.2.15 → 0.2.16

package/README.md

@@ -69,17 +69,17 @@ Select storage provider:
 
 New projects include `bcp.project.json`.
 
-Example for the `0.2.15` target:
+Example for the `0.2.16` target:
 
 ```json
 {
   "schemaVersion": 1,
   "framework": "bcp",
   "projectName": "my-app",
-  "frameworkPackage": "npm:@chidchanun/bcp@0.2.15",
+  "frameworkPackage": "npm:@chidchanun/bcp@0.2.16",
   "createdWith": {
     "package": "create-bcp-app",
-    "version": "0.2.15"
+    "version": "0.2.16"
   },
   "packageManager": "npm",
   "presets": {
@@ -367,6 +367,63 @@ Plugins can use `setup/start/stop/dispose`, typed config parsers, a shared servi
 
 `bcp/plugins` is server-only and cannot be imported into page/client bundles.
 
+## Cache Platform v2 — 0.2.16+
+
+Use the existing `bcp/cache` entrypoint for provider-neutral shared caching while keeping the original `cache()` and `dedupe()` APIs available.
+
+```ts
+import {
+    createCacheStore,
+} from "bcp/cache";
+
+export const cache =
+    createCacheStore();
+```
+
+Cache-aside loading:
+
+```ts
+const user =
+    await cache.getOrSet(
+        "user:42",
+        () => loadUser(42),
+        {
+            ttlMs: 60_000,
+            tags: ["users"],
+            paths: ["/users/42"],
+        }
+    );
+```
+
+For multi-instance deployments, applications can supply Redis-compatible cache and lock adapters:
+
+```ts
+import {
+    createRedisCacheAdapter,
+    createRedisCacheLockAdapter,
+} from "bcp/cache";
+
+const redisCache =
+    createRedisCacheAdapter({
+        client: redisClient,
+    });
+
+const redisLock =
+    createRedisCacheLockAdapter({
+        client: redisClient,
+    });
+
+export const cache =
+    createCacheStore({
+        adapter: redisCache,
+        lock: redisLock,
+    });
+```
+
+BCP does not install or own the Redis client. Applications remain responsible for credentials, TLS, Cluster/Sentinel configuration, reconnect behavior and connection shutdown.
+
+`getOrSet()` provides local singleflight and can use distributed lock leases with heartbeat renewal to reduce cache stampedes across instances.
+
 ## Storage providers
 
 Supported presets are Local Server, Amazon S3 and Cloudflare R2. Storage credentials are server-only and must not use `BCP_PUBLIC_*` variables.
@@ -405,5 +462,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.15.tgz
+npx create-bcp-app my-app --bcp file:../chidchanun-bcp-0.2.16.tgz
 ```

package/package.json

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

package/template/README.md

@@ -288,6 +288,59 @@ Use `defineModule()` when a reusable package needs to bundle multiple plugin def
 
 `bcp/plugins` is server-only and cannot be imported from page/client bundles.
 
+## Cache Platform v2 — BCP 0.2.16+
+
+Use `createCacheStore()` for async cache-aside loading, shared adapters and distributed cache-fill coordination.
+
+```ts
+import {
+    createCacheStore,
+} from "bcp/cache";
+
+export const cache =
+    createCacheStore();
+```
+
+```ts
+const user =
+    await cache.getOrSet(
+        "user:42",
+        () => loadUser(42),
+        {
+            ttlMs: 60_000,
+            tags: ["users"],
+            paths: ["/users/42"],
+        }
+    );
+```
+
+For multiple instances, connect a shared cache and lock provider:
+
+```ts
+import {
+    createRedisCacheAdapter,
+    createRedisCacheLockAdapter,
+} from "bcp/cache";
+
+const redisCache =
+    createRedisCacheAdapter({
+        client: redisClient,
+    });
+
+const redisLock =
+    createRedisCacheLockAdapter({
+        client: redisClient,
+    });
+
+export const cache =
+    createCacheStore({
+        adapter: redisCache,
+        lock: redisLock,
+    });
+```
+
+BCP does not install or own a Redis client. The default adapter namespace is `bcp:{cache}`. The original `cache()` and `dedupe()` APIs remain available for backward-compatible process-local caching.
+
 ## Generate framework files
 
 ```bash