@lunora/platform-node 1.0.0-alpha.44 → 1.0.0-alpha.46

package/dist/index.d.mts

@@ -360,13 +360,17 @@ interface NodePlatform<Queues extends Record<string, {
   /** What this target supports — see `NODE_CAPABILITIES` in `@lunora/platform`. */
   capabilities: PlatformCapabilities;
   /**
-   * Tear this platform instance down: clears the shard host's pending alarm
-   * timer and closes its `better-sqlite3` database (and, with it, `kv`'s
-   * table — both live on the same connection), then clears every armed
-   * scheduler job timer. Nothing in this package closes these resources on
-   * its own — a `NodePlatform` a caller stops using without calling `close()`
-   * leaks the open file handle (plus its WAL/SHM sidecar files) and keeps
-   * the process alive on outstanding timers. Safe to call more than once.
+   * Tear this platform instance down: every resource this root built, in
+   * reverse construction order — the global store's own connection, every
+   * armed scheduler job timer, the registry's live shards, and last the shard
+   * host's pending alarm timer and its `better-sqlite3` database (and, with
+   * it, `kv`'s table — both live on the same connection). Nothing in this
+   * package closes these resources on its own — a `NodePlatform` a caller
+   * stops using without calling `close()` leaks the open file handles (plus
+   * their WAL/SHM sidecar files) and keeps the process alive on outstanding
+   * timers. Safe to call more than once. A `createNodePlatform` that throws
+   * unwinds the same list itself, so a failed construction leaks nothing and
+   * leaves nothing to call this on.
    *
    * **`close()` is a terminal state, not merely a cleanup step.** After it
    * runs: `scheduler.schedule()` throws instead of arming a fresh timer
@@ -394,14 +398,27 @@ interface NodePlatform<Queues extends Record<string, {
    * shutdown is `await platform.drain()` then `platform.close()`.
    */
   drain: () => Promise<void>;
-  /** Durable key-value storage backed by the same `better-sqlite3` database as `shard`. */
-  kv: ShardKvStore;
   /**
-   * The local-filesystem bucket, or `undefined` when the caller named no
-   * bucket directory. Same reasoning as `queues`: `objectStorage` is rated
-   * `emulated`, so codegen emits `ctx.storage` for this target, and a bucket
-   * nobody bound fails at the first `put` with nothing upstream to warn.
+   * The `.global()` backend, or `undefined` when the caller named no database
+   * file for it. There is no default path, because a global store silently
+   * rooted at `:memory:` loses every row when the process exits.
+   *
+   * **A building block, not a wiring.** Unlike its three siblings, nothing
+   * downstream of this composition root reads it: a `.global()` read or write
+   * reaches its backend through exactly one seam, `createShardCtxDb({ globalDb
+   * })`, and the only thing that passes `globalDb` is the generated `shard.ts`,
+   * from its `d1` / `hyperdriveGlobal` config thunks. `createNodePlatform`
+   * constructs no shard DO, so it cannot make that hop itself. A caller that
+   * wants `.global()` on this host makes it: after `migrate(schema)` has
+   * provisioned the tables, give the generated `createShardDO` a `d1` thunk
+   * returning `platform.globalTables.writer({ schema, … })` — `writer` builds
+   * the `createSqlCtxDb` facade that seam expects, and `node-platform.test.ts`
+   * round-trips a row through exactly that object.
    */
+  globalTables?: NodeGlobalStore;
+  /** Durable key-value storage backed by the same `better-sqlite3` database as `shard`. */
+  kv: ShardKvStore;
+  /** The local-filesystem bucket, or `undefined` when the caller named no bucket directory. */
   objectStorage?: R2BucketLike;
   /**
    * The declared queues, or `undefined` when the caller declared none.
@@ -433,15 +450,21 @@ interface NodePlatform<Queues extends Record<string, {
  * directory resolves for fan-out file-backed too, and `onAlarm` gives their
  * durable alarms somewhere to land.
  *
- * `queues`, `workflows` and `objectStorageDirectory` are the three
- * declarations: each binds its half of an `emulated` capability, and each is
- * absent from the returned platform when its declaration is omitted.
+ * `queues`, `workflows`, `objectStorageDirectory` and `globalTablesPath` are the
+ * four declarations — each is absent from the returned platform when omitted.
  */
 type NodePlatformOptions<Queues extends Record<string, {
   isLunoraQueue: true;
 }> = Record<string, never>, Workflows extends Record<string, {
   isLunoraWorkflow: true;
 }> = Record<string, never>> = {
+  /**
+   * Database file the `.global()` tables live in — its own file, never a
+   * shard's, because a table every shard reads must not be inside any one of
+   * them. Omit when the app declares no `.global()` table; there is no
+   * default, for the same reason the bucket has none.
+   */
+  globalTablesPath?: string;
   /**
    * Directory the object-storage bucket keeps its objects in, one file per
    * key. Omit when the app declares no buckets — there is no default,

package/dist/index.d.ts

@@ -360,13 +360,17 @@ interface NodePlatform<Queues extends Record<string, {
   /** What this target supports — see `NODE_CAPABILITIES` in `@lunora/platform`. */
   capabilities: PlatformCapabilities;
   /**
-   * Tear this platform instance down: clears the shard host's pending alarm
-   * timer and closes its `better-sqlite3` database (and, with it, `kv`'s
-   * table — both live on the same connection), then clears every armed
-   * scheduler job timer. Nothing in this package closes these resources on
-   * its own — a `NodePlatform` a caller stops using without calling `close()`
-   * leaks the open file handle (plus its WAL/SHM sidecar files) and keeps
-   * the process alive on outstanding timers. Safe to call more than once.
+   * Tear this platform instance down: every resource this root built, in
+   * reverse construction order — the global store's own connection, every
+   * armed scheduler job timer, the registry's live shards, and last the shard
+   * host's pending alarm timer and its `better-sqlite3` database (and, with
+   * it, `kv`'s table — both live on the same connection). Nothing in this
+   * package closes these resources on its own — a `NodePlatform` a caller
+   * stops using without calling `close()` leaks the open file handles (plus
+   * their WAL/SHM sidecar files) and keeps the process alive on outstanding
+   * timers. Safe to call more than once. A `createNodePlatform` that throws
+   * unwinds the same list itself, so a failed construction leaks nothing and
+   * leaves nothing to call this on.
    *
    * **`close()` is a terminal state, not merely a cleanup step.** After it
    * runs: `scheduler.schedule()` throws instead of arming a fresh timer
@@ -394,14 +398,27 @@ interface NodePlatform<Queues extends Record<string, {
    * shutdown is `await platform.drain()` then `platform.close()`.
    */
   drain: () => Promise<void>;
-  /** Durable key-value storage backed by the same `better-sqlite3` database as `shard`. */
-  kv: ShardKvStore;
   /**
-   * The local-filesystem bucket, or `undefined` when the caller named no
-   * bucket directory. Same reasoning as `queues`: `objectStorage` is rated
-   * `emulated`, so codegen emits `ctx.storage` for this target, and a bucket
-   * nobody bound fails at the first `put` with nothing upstream to warn.
+   * The `.global()` backend, or `undefined` when the caller named no database
+   * file for it. There is no default path, because a global store silently
+   * rooted at `:memory:` loses every row when the process exits.
+   *
+   * **A building block, not a wiring.** Unlike its three siblings, nothing
+   * downstream of this composition root reads it: a `.global()` read or write
+   * reaches its backend through exactly one seam, `createShardCtxDb({ globalDb
+   * })`, and the only thing that passes `globalDb` is the generated `shard.ts`,
+   * from its `d1` / `hyperdriveGlobal` config thunks. `createNodePlatform`
+   * constructs no shard DO, so it cannot make that hop itself. A caller that
+   * wants `.global()` on this host makes it: after `migrate(schema)` has
+   * provisioned the tables, give the generated `createShardDO` a `d1` thunk
+   * returning `platform.globalTables.writer({ schema, … })` — `writer` builds
+   * the `createSqlCtxDb` facade that seam expects, and `node-platform.test.ts`
+   * round-trips a row through exactly that object.
    */
+  globalTables?: NodeGlobalStore;
+  /** Durable key-value storage backed by the same `better-sqlite3` database as `shard`. */
+  kv: ShardKvStore;
+  /** The local-filesystem bucket, or `undefined` when the caller named no bucket directory. */
   objectStorage?: R2BucketLike;
   /**
    * The declared queues, or `undefined` when the caller declared none.
@@ -433,15 +450,21 @@ interface NodePlatform<Queues extends Record<string, {
  * directory resolves for fan-out file-backed too, and `onAlarm` gives their
  * durable alarms somewhere to land.
  *
- * `queues`, `workflows` and `objectStorageDirectory` are the three
- * declarations: each binds its half of an `emulated` capability, and each is
- * absent from the returned platform when its declaration is omitted.
+ * `queues`, `workflows`, `objectStorageDirectory` and `globalTablesPath` are the
+ * four declarations — each is absent from the returned platform when omitted.
  */
 type NodePlatformOptions<Queues extends Record<string, {
   isLunoraQueue: true;
 }> = Record<string, never>, Workflows extends Record<string, {
   isLunoraWorkflow: true;
 }> = Record<string, never>> = {
+  /**
+   * Database file the `.global()` tables live in — its own file, never a
+   * shard's, because a table every shard reads must not be inside any one of
+   * them. Omit when the app declares no `.global()` table; there is no
+   * default, for the same reason the bucket has none.
+   */
+  globalTablesPath?: string;
   /**
    * Directory the object-storage bucket keeps its objects in, one file per
    * key. Omit when the app declares no buckets — there is no default,

package/dist/index.mjs

@@ -1 +1 @@
-import{createNodeGlobalStore as r,createNodeSqlExec as t}from"./packem_shared/createNodeGlobalStore-Cwi33XOk.mjs";import{createNodeShardKvStore as d}from"./packem_shared/createNodeShardKvStore-DVi1OsvH.mjs";import{createNodePlatform as f}from"./packem_shared/createNodePlatform-BGoxuZCi.mjs";import{createNodeQueueHost as x}from"./packem_shared/createNodeQueueHost--mBLGSxF.mjs";import{createNodeR2Bucket as p}from"./packem_shared/createNodeR2Bucket-BzNH1lBp.mjs";import{createNodeSchedulerHost as l}from"./packem_shared/createNodeSchedulerHost-BEAX6I4m.mjs";import{createNodeShardHost as h}from"./packem_shared/createNodeShardHost-B76kaXz-.mjs";import{createNodeShardRegistry as k}from"./packem_shared/createNodeShardRegistry-Dj1mXStS.mjs";import{createNodeShardState as w}from"./packem_shared/createNodeShardState-D6XMWbFs.mjs";import{createNodeSocketHost as W}from"./packem_shared/createNodeSocketHost-DQs85G7W.mjs";import{createNodeWorkflowHost as g}from"./packem_shared/createNodeWorkflowHost-CTVBYiuj.mjs";import{createNodeWorkflowStore as q}from"./packem_shared/createNodeWorkflowStore-CL7RYP6H.mjs";export{r as createNodeGlobalStore,f as createNodePlatform,x as createNodeQueueHost,p as createNodeR2Bucket,l as createNodeSchedulerHost,h as createNodeShardHost,d as createNodeShardKvStore,k as createNodeShardRegistry,w as createNodeShardState,W as createNodeSocketHost,t as createNodeSqlExec,g as createNodeWorkflowHost,q as createNodeWorkflowStore};
+import{createNodeGlobalStore as r,createNodeSqlExec as t}from"./packem_shared/createNodeGlobalStore-Cwi33XOk.mjs";import{createNodeShardKvStore as d}from"./packem_shared/createNodeShardKvStore-DVi1OsvH.mjs";import{createNodePlatform as f}from"./packem_shared/createNodePlatform-DifFt1nR.mjs";import{createNodeQueueHost as x}from"./packem_shared/createNodeQueueHost--mBLGSxF.mjs";import{createNodeR2Bucket as p}from"./packem_shared/createNodeR2Bucket-BzNH1lBp.mjs";import{createNodeSchedulerHost as l}from"./packem_shared/createNodeSchedulerHost-BEAX6I4m.mjs";import{createNodeShardHost as h}from"./packem_shared/createNodeShardHost-B76kaXz-.mjs";import{createNodeShardRegistry as k}from"./packem_shared/createNodeShardRegistry-Dj1mXStS.mjs";import{createNodeShardState as w}from"./packem_shared/createNodeShardState-D6XMWbFs.mjs";import{createNodeSocketHost as W}from"./packem_shared/createNodeSocketHost-DQs85G7W.mjs";import{createNodeWorkflowHost as g}from"./packem_shared/createNodeWorkflowHost-CTVBYiuj.mjs";import{createNodeWorkflowStore as q}from"./packem_shared/createNodeWorkflowStore-CL7RYP6H.mjs";export{r as createNodeGlobalStore,f as createNodePlatform,x as createNodeQueueHost,p as createNodeR2Bucket,l as createNodeSchedulerHost,h as createNodeShardHost,d as createNodeShardKvStore,k as createNodeShardRegistry,w as createNodeShardState,W as createNodeSocketHost,t as createNodeSqlExec,g as createNodeWorkflowHost,q as createNodeWorkflowStore};

package/dist/packem_shared/createNodePlatform-DifFt1nR.mjs

@@ -0,0 +1 @@
+import{LunoraError as S}from"@lunora/errors";import{NODE_CAPABILITIES as b}from"@lunora/platform";import{createNodeGlobalStore as N}from"./createNodeGlobalStore-Cwi33XOk.mjs";import{createNodeShardKvStore as k}from"./createNodeShardKvStore-DVi1OsvH.mjs";import{createNodeQueueHost as g}from"./createNodeQueueHost--mBLGSxF.mjs";import{createNodeR2Bucket as y}from"./createNodeR2Bucket-BzNH1lBp.mjs";import{createNodeSchedulerHost as R}from"./createNodeSchedulerHost-BEAX6I4m.mjs";import{createNodeShardHost as q}from"./createNodeShardHost-B76kaXz-.mjs";import{createNodeShardRegistry as B}from"./createNodeShardRegistry-Dj1mXStS.mjs";import{createNodeSocketHost as H}from"./createNodeSocketHost-DQs85G7W.mjs";import{createNodeWorkflowHost as I}from"./createNodeWorkflowHost-CTVBYiuj.mjs";import{createNodeWorkflowStore as P}from"./createNodeWorkflowStore-CL7RYP6H.mjs";const G=(o={})=>{const e=[],{database:r,dispose:d,drain:u,host:i}=q(o);e.push(d);try{const s=k(r),t=B(o);e.push(()=>{t.close()});const{directory:l}=t,{socket:h}=H(r),{dispose:m,scheduler:f}=R(r,o);e.push(m);const n=o.queues===void 0?void 0:g(r,{onBatch:o.onQueueBatch??(()=>{throw new S("VALIDATION_ERROR","@lunora/platform-node: createNodePlatform was given `queues` without `onQueueBatch`, so a delivered batch has nowhere to go — pass dispatchQueueBatch from @lunora/queue")}),queues:o.queues}),p=o.objectStorageDirectory===void 0?void 0:y({directory:o.objectStorageDirectory}),a=o.globalTablesPath===void 0?void 0:N({path:o.globalTablesPath});a!==void 0&&e.push(()=>{a.dispose()});const w=o.workflows===void 0?void 0:I({store:P(r),workflows:o.workflows}),c=()=>{for(const v of e.toReversed())v()};return{capabilities:b,close:c,directory:l,drain:u,globalTables:a,kv:s,objectStorage:p,queues:n,scheduler:f,shard:i,sockets:h,workflows:w,[Symbol.dispose]:c}}catch(s){for(const t of e.toReversed())try{t()}catch{}throw s}};export{G as createNodePlatform};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/platform-node",
-  "version": "1.0.0-alpha.44",
+  "version": "1.0.0-alpha.46",
   "description": "Node implementation of the Lunora platform contracts: ShardHost, SocketHost, ShardDirectory, ShardKvStore, SchedulerHost over better-sqlite3 and an in-process socket registry (dev/test target)",
   "keywords": [
     "better-sqlite3",
@@ -46,12 +46,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/d1": "1.0.0-alpha.104",
-    "@lunora/errors": "1.0.0-alpha.30",
-    "@lunora/platform": "1.0.0-alpha.25",
-    "@lunora/queue": "1.0.0-alpha.43",
-    "@lunora/sql-store": "1.0.0-alpha.106",
-    "@lunora/workflow": "1.0.0-alpha.43",
+    "@lunora/d1": "1.0.0-alpha.106",
+    "@lunora/errors": "1.0.0-alpha.31",
+    "@lunora/platform": "1.0.0-alpha.26",
+    "@lunora/queue": "1.0.0-alpha.45",
+    "@lunora/sql-store": "1.0.0-alpha.108",
+    "@lunora/workflow": "1.0.0-alpha.44",
     "@visulima/workflow": "3.0.0",
     "better-sqlite3": "^13.0.3",
     "cron-parser": "5.8.1"

package/dist/packem_shared/createNodePlatform-BGoxuZCi.mjs

@@ -1 +0,0 @@
-import{LunoraError as n}from"@lunora/errors";import{NODE_CAPABILITIES as S}from"@lunora/platform";import{createNodeShardKvStore as N}from"./createNodeShardKvStore-DVi1OsvH.mjs";import{createNodeQueueHost as p}from"./createNodeQueueHost--mBLGSxF.mjs";import{createNodeR2Bucket as k}from"./createNodeR2Bucket-BzNH1lBp.mjs";import{createNodeSchedulerHost as v}from"./createNodeSchedulerHost-BEAX6I4m.mjs";import{createNodeShardHost as b}from"./createNodeShardHost-B76kaXz-.mjs";import{createNodeShardRegistry as g}from"./createNodeShardRegistry-Dj1mXStS.mjs";import{createNodeSocketHost as y}from"./createNodeSocketHost-DQs85G7W.mjs";import{createNodeWorkflowHost as q}from"./createNodeWorkflowHost-CTVBYiuj.mjs";import{createNodeWorkflowStore as B}from"./createNodeWorkflowStore-CL7RYP6H.mjs";const T=(e={})=>{const{database:o,dispose:c,drain:s,host:a}=b(e),d=N(o),r=g(e),{directory:u}=r,{socket:i}=y(o),{dispose:m,scheduler:f}=v(o,e),h=e.queues===void 0?void 0:p(o,{onBatch:e.onQueueBatch??(()=>{throw new n("VALIDATION_ERROR","@lunora/platform-node: createNodePlatform was given `queues` without `onQueueBatch`, so a delivered batch has nowhere to go — pass dispatchQueueBatch from @lunora/queue")}),queues:e.queues}),l=e.objectStorageDirectory===void 0?void 0:k({directory:e.objectStorageDirectory}),w=e.workflows===void 0?void 0:q({store:B(o),workflows:e.workflows}),t=()=>{m(),c(),r.close()};return{capabilities:S,close:t,directory:u,drain:s,kv:d,objectStorage:l,queues:h,scheduler:f,shard:a,sockets:i,workflows:w,[Symbol.dispose]:t}};export{T as createNodePlatform};