@lunora/hyperdrive 1.0.0-alpha.208 → 1.0.0-alpha.209

package/dist/global.d.mts

@@ -1,3 +1,27 @@
+/**
+ * `@lunora/hyperdrive/global` — a Postgres/MySQL database reached through
+ * Cloudflare Hyperdrive (PlanetScale, Neon, RDS, …) as a **first-class,
+ * reactive** `.global()` storage backend for Lunora, alongside D1.
+ *
+ * Unlike the package's `ctx.sql` surface (an action-only, non-reactive escape
+ * hatch for an external DB), this makes Lunora the **owner** of the schema:
+ * `.global()` tables get a real column-per-field layout and all writes route
+ * through the shared store core (`createSqlCtxDb` from `@lunora/sql-store`) with
+ * a Postgres or MySQL {@link postgresDialect}/{@link mysqlDialect} and a
+ * Hyperdrive-backed {@link SqlExec}. The returned `DatabaseWriterLike` is
+ * injected as `globalDb` into `createShardCtxDb`, whose broadcast hook drives
+ * live queries — so subscriptions stay reactive with zero extra wiring,
+ * identical to D1.
+ *
+ * Drivers (`postgres`/`pg`/`mysql2`) are optional peer deps — bring your own,
+ * constructed from the `HYPERDRIVE` binding's connection string. The binding is
+ * reachable from inside the Durable Object that hosts the writer; cache the
+ * driver on the DO instance and rebuild it lazily after hibernation.
+ *
+ * **MySQL connections must enable `CLIENT_FOUND_ROWS`** (mysql2:
+ * `createPool({ flags: ["FOUND_ROWS"] })`) so the affected-rows OCC guard sees
+ * matched (not changed) rows — see {@link buildMysqlExec}.
+ */
 import { DatabaseWriterLike } from '@lunora/shard-engine';
 import { SqlExec, SqlDialect, SqlCtxDbOptions } from '@lunora/sql-store';
 import { M as Mysql2Like, S as SqlClient } from "./packem_shared/types.d-B2JdXSms.mjs";

package/dist/global.d.ts

@@ -1,3 +1,27 @@
+/**
+ * `@lunora/hyperdrive/global` — a Postgres/MySQL database reached through
+ * Cloudflare Hyperdrive (PlanetScale, Neon, RDS, …) as a **first-class,
+ * reactive** `.global()` storage backend for Lunora, alongside D1.
+ *
+ * Unlike the package's `ctx.sql` surface (an action-only, non-reactive escape
+ * hatch for an external DB), this makes Lunora the **owner** of the schema:
+ * `.global()` tables get a real column-per-field layout and all writes route
+ * through the shared store core (`createSqlCtxDb` from `@lunora/sql-store`) with
+ * a Postgres or MySQL {@link postgresDialect}/{@link mysqlDialect} and a
+ * Hyperdrive-backed {@link SqlExec}. The returned `DatabaseWriterLike` is
+ * injected as `globalDb` into `createShardCtxDb`, whose broadcast hook drives
+ * live queries — so subscriptions stay reactive with zero extra wiring,
+ * identical to D1.
+ *
+ * Drivers (`postgres`/`pg`/`mysql2`) are optional peer deps — bring your own,
+ * constructed from the `HYPERDRIVE` binding's connection string. The binding is
+ * reachable from inside the Durable Object that hosts the writer; cache the
+ * driver on the DO instance and rebuild it lazily after hibernation.
+ *
+ * **MySQL connections must enable `CLIENT_FOUND_ROWS`** (mysql2:
+ * `createPool({ flags: ["FOUND_ROWS"] })`) so the affected-rows OCC guard sees
+ * matched (not changed) rows — see {@link buildMysqlExec}.
+ */
 import { DatabaseWriterLike } from '@lunora/shard-engine';
 import { SqlExec, SqlDialect, SqlCtxDbOptions } from '@lunora/sql-store';
 import { M as Mysql2Like, S as SqlClient } from "./packem_shared/types.d-B2JdXSms.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/hyperdrive",
-  "version": "1.0.0-alpha.208",
+  "version": "1.0.0-alpha.209",
   "description": "Bring-your-own Postgres/MySQL for Lunora via Cloudflare Hyperdrive: a driver-agnostic, action-only ctx.sql",
   "keywords": [
     "cloudflare",
@@ -52,8 +52,8 @@
   "dependencies": {
     "@lunora/errors": ">=1.0.0-alpha.51 <2.0.0-0",
     "@lunora/platform": "1.0.0-alpha.75",
-    "@lunora/shard-engine": "1.0.0-alpha.162",
-    "@lunora/sql-store": "1.0.0-alpha.211",
+    "@lunora/shard-engine": "1.0.0-alpha.163",
+    "@lunora/sql-store": "1.0.0-alpha.212",
     "drizzle-orm": "1.0.0-rc.5"
   },
   "peerDependencies": {