@aotter/mantle 0.0.11-alpha.73 → 0.1.0-alpha.10

package/docs/deferred-lifecycle-queues.md

@@ -94,68 +94,47 @@ retry_delay = 60
 dead_letter_queue = "mantle-internal-dlq"
 ```
 
-Wire the producer into `CmsConfig.bindings` and export the consumer alongside
+Wire the producer into `MantleCloudflareConfig.bindings` and export the consumer alongside
 the existing HTTP/OAuth handler. The same Worker may be both producer and
 consumer:
 
 ```ts
 import type { DeferredHookEnvelope } from "@aotter/mantle/runtime";
 import {
-  AssetsAssetServer,
-  D1DatabaseDriver,
-  KvCacheBinding,
   WorkersQueueHookDispatcher,
-  createCmsRef,
+  createMantleWorker,
   createQueueHandler,
-  createOAuthProvider,
+  type MantleCloudflareEnv,
 } from "@aotter/mantle/cloudflare";
 
-interface Env {
+interface Env extends MantleCloudflareEnv {
   DB: D1Database;
-  KV: KVNamespace;
-  ASSETS: Fetcher;
   MANTLE_INTERNAL_QUEUE: Queue<DeferredHookEnvelope>;
 }
 
-function buildWorker(env: Env) {
-  const cms = createCmsRef({
-    manifests,
-    handlers,
-    auth: createSiteAuth(env),
-    bindings: {
-      db: new D1DatabaseDriver(env.DB),
-      kv: new KvCacheBinding(env.KV),
-      assets: new AssetsAssetServer(env.ASSETS),
-      deferredHookDispatcher: new WorkersQueueHookDispatcher(
-        env.MANTLE_INTERNAL_QUEUE,
-      ),
-    },
-  });
-
-  const http = createOAuthProvider<Env>({
-    defaultHandler: createSiteHttpHandler(cms),
-    apiHandlers: createSiteMcpHandlers(cms),
-  });
-
-  return { http, consumeMantle: createQueueHandler<Env>(cms) };
-}
-
-let built: ReturnType<typeof buildWorker> | undefined;
-const worker = (env: Env) => built ??= buildWorker(env);
+const worker = createMantleWorker<Env>({
+  plan,
+  handlers,
+  bindings: (env, conventional) => ({
+    ...conventional,
+    deferredHookDispatcher: new WorkersQueueHookDispatcher(
+      env.MANTLE_INTERNAL_QUEUE,
+    ),
+  }),
+});
 
 export default {
-  fetch(request, env, ctx) {
-    return worker(env).http.fetch(request, env, ctx);
-  },
+  fetch: worker.fetch,
   queue(batch, env) {
-    return worker(env).consumeMantle(batch, env);
+    return createQueueHandler<Env>({
+      get: () => worker.getRuntime(env),
+    })(batch, env);
   },
 } satisfies ExportedHandler<Env>;
 ```
 
-`createSiteAuth`, `createSiteHttpHandler`, and `createSiteMcpHandlers` above
-stand for the site's existing adapter assembly; Queue opt-in adds only the
-dispatcher binding and `queue` export.
+Queue opt-in adds only the dispatcher binding and `queue` export; the facade
+keeps Auth, MCP, cache, and runtime assembly on the standard path.
 
 ## Idempotent handlers