@lunora/hyperdrive 1.0.0-alpha.82 → 1.0.0-alpha.83

package/dist/global.d.mts

@@ -9,10 +9,43 @@ import { M as Mysql2Like, S as SqlClient } from "./packem_shared/types.d-DE1NYxy
 type RowClient = SqlClient;
 /**
  * Minimal `mysql2/promise` connection/pool surface — `execute` resolves to
- * `[rows | ResultSetHeader, fields]`. Aliases {@link Mysql2Like} so the /global entry's
- * driver surface can never drift from the main entry's.
+ * `[rows | ResultSetHeader, fields]`. Aliases {@link Mysql2Like} so the /global
+ * entry's driver surface can never drift from the main entry's, widened with the
+ * (optional, structural) shape {@link assertFoundRows}'s `CLIENT_FOUND_ROWS`
+ * probe reads.
+ *
+ * A real `mysql2/promise` connection/pool exposes the merged client-flags
+ * bitmask synchronously, but at two different depths depending on which one it
+ * is, and NEITHER is in `mysql2`'s own `.d.ts` — its `Pool extends Connection`
+ * signature claims a top-level `config`, but at runtime a `mysql2/promise`
+ * `Pool` has none; the real value lives one level down, on the core pool it
+ * wraps:
+ *
+ * - a single `Connection`/`PoolConnection` → `connection.config.clientFlags`
+ * - a `Pool` (the `createPool({ flags: ["FOUND_ROWS"] })` example above) →
+ * `pool.pool.config.connectionConfig.clientFlags`
+ *
+ * Because those paths are undocumented driver internals, `global-dialect.test.ts`
+ * pins them against a REAL `mysql2` pool (built without connecting) rather than
+ * only against hand-written doubles — if a `mysql2` release relocates them, the
+ * probe would otherwise degrade silently to the warn branch and the OCC guard
+ * would go unchecked.
+ *
+ * Both fields are optional so a minimal `Mysql2Like` test double (only
+ * `execute`) safely resolves to "undeterminable" instead of a `TypeError`.
  */
-type Mysql2Execute = Mysql2Like;
+type Mysql2Execute = Mysql2Like & {
+  config?: {
+    clientFlags?: number;
+  };
+  pool?: {
+    config?: {
+      connectionConfig?: {
+        clientFlags?: number;
+      };
+    };
+  };
+};
 /**
  * Wrap a Postgres row-client (from `@lunora/hyperdrive`'s `fromPostgresJs` /
  * `fromNodePg`) as a {@link SqlExec}. The core already renders `$N` placeholders
@@ -42,7 +75,8 @@ declare const buildPgExec: (client: RowClient) => SqlExec;
  * **The connection MUST be created with the `CLIENT_FOUND_ROWS` flag**
  * (mysql2: `createPool({ flags: ["FOUND_ROWS"] })`). Without it, `affectedRows`
  * counts *changed* rows, so an idempotent `patch`/`replace` that re-writes the
- * same values reports 0 and the OCC guard raises a spurious conflict.
+ * same values reports 0 and the OCC guard raises a spurious conflict. Verified
+ * once here at construction — see {@link assertFoundRows} — never per statement.
  *
  * `batch` dispatches every statement concurrently (`Promise.all`), same
  * rationale as {@link buildPgExec}'s `batch` — `Mysql2Like` only exposes a

package/dist/global.d.ts

@@ -9,10 +9,43 @@ import { M as Mysql2Like, S as SqlClient } from "./packem_shared/types.d-DE1NYxy
 type RowClient = SqlClient;
 /**
  * Minimal `mysql2/promise` connection/pool surface — `execute` resolves to
- * `[rows | ResultSetHeader, fields]`. Aliases {@link Mysql2Like} so the /global entry's
- * driver surface can never drift from the main entry's.
+ * `[rows | ResultSetHeader, fields]`. Aliases {@link Mysql2Like} so the /global
+ * entry's driver surface can never drift from the main entry's, widened with the
+ * (optional, structural) shape {@link assertFoundRows}'s `CLIENT_FOUND_ROWS`
+ * probe reads.
+ *
+ * A real `mysql2/promise` connection/pool exposes the merged client-flags
+ * bitmask synchronously, but at two different depths depending on which one it
+ * is, and NEITHER is in `mysql2`'s own `.d.ts` — its `Pool extends Connection`
+ * signature claims a top-level `config`, but at runtime a `mysql2/promise`
+ * `Pool` has none; the real value lives one level down, on the core pool it
+ * wraps:
+ *
+ * - a single `Connection`/`PoolConnection` → `connection.config.clientFlags`
+ * - a `Pool` (the `createPool({ flags: ["FOUND_ROWS"] })` example above) →
+ * `pool.pool.config.connectionConfig.clientFlags`
+ *
+ * Because those paths are undocumented driver internals, `global-dialect.test.ts`
+ * pins them against a REAL `mysql2` pool (built without connecting) rather than
+ * only against hand-written doubles — if a `mysql2` release relocates them, the
+ * probe would otherwise degrade silently to the warn branch and the OCC guard
+ * would go unchecked.
+ *
+ * Both fields are optional so a minimal `Mysql2Like` test double (only
+ * `execute`) safely resolves to "undeterminable" instead of a `TypeError`.
  */
-type Mysql2Execute = Mysql2Like;
+type Mysql2Execute = Mysql2Like & {
+  config?: {
+    clientFlags?: number;
+  };
+  pool?: {
+    config?: {
+      connectionConfig?: {
+        clientFlags?: number;
+      };
+    };
+  };
+};
 /**
  * Wrap a Postgres row-client (from `@lunora/hyperdrive`'s `fromPostgresJs` /
  * `fromNodePg`) as a {@link SqlExec}. The core already renders `$N` placeholders
@@ -42,7 +75,8 @@ declare const buildPgExec: (client: RowClient) => SqlExec;
  * **The connection MUST be created with the `CLIENT_FOUND_ROWS` flag**
  * (mysql2: `createPool({ flags: ["FOUND_ROWS"] })`). Without it, `affectedRows`
  * counts *changed* rows, so an idempotent `patch`/`replace` that re-writes the
- * same values reports 0 and the OCC guard raises a spurious conflict.
+ * same values reports 0 and the OCC guard raises a spurious conflict. Verified
+ * once here at construction — see {@link assertFoundRows} — never per statement.
  *
  * `batch` dispatches every statement concurrently (`Promise.all`), same
  * rationale as {@link buildPgExec}'s `batch` — `Mysql2Like` only exposes a

package/dist/global.mjs

@@ -1 +1 @@
-import{createSqlCtxDb as l}from"@lunora/sql-store";import{postgresDialect as s,mysqlDialect as c}from"./packem_shared/mysqlDialect-DitNAlpV.mjs";import{buildMysqlExec as i,buildPgExec as a}from"./packem_shared/buildMysqlExec-DriYb1l9.mjs";const o=({engine:e,exec:t,...r})=>l({...r,dialect:e==="postgres"?s:c,exec:t}),p=(e,t)=>o({...t,engine:"postgres",exec:a(e)}),g=(e,t)=>o({...t,engine:"mysql",exec:i(e)});export{i as buildMysqlExec,a as buildPgExec,o as createHyperdriveGlobalCtxDb,g as createMysqlGlobalCtxDb,p as createPostgresGlobalCtxDb,c as mysqlDialect,s as postgresDialect};
+import{createSqlCtxDb as l}from"@lunora/sql-store";import{postgresDialect as s,mysqlDialect as c}from"./packem_shared/mysqlDialect-DitNAlpV.mjs";import{buildMysqlExec as i,buildPgExec as a}from"./packem_shared/buildMysqlExec-CPwtojyL.mjs";const o=({engine:e,exec:t,...r})=>l({...r,dialect:e==="postgres"?s:c,exec:t}),p=(e,t)=>o({...t,engine:"postgres",exec:a(e)}),g=(e,t)=>o({...t,engine:"mysql",exec:i(e)});export{i as buildMysqlExec,a as buildPgExec,o as createHyperdriveGlobalCtxDb,g as createMysqlGlobalCtxDb,p as createPostgresGlobalCtxDb,c as mysqlDialect,s as postgresDialect};

package/dist/packem_shared/buildMysqlExec-CPwtojyL.mjs

@@ -0,0 +1 @@
+import{LunoraError as o}from"@lunora/errors";const n=2,s=new WeakSet,i=r=>{const e=r.config?.clientFlags;if(typeof e=="number")return e;const t=r.pool?.config?.connectionConfig?.clientFlags;return typeof t=="number"?t:void 0},c=r=>{const e=i(r);if(e===void 0){if(s.has(r))return;s.add(r),console.warn('@lunora/hyperdrive: could not determine whether this MySQL connection negotiated CLIENT_FOUND_ROWS (the driver exposes no flag introspection). If it was NOT created with the `CLIENT_FOUND_ROWS` flag (mysql2: `createPool({ flags: ["FOUND_ROWS"] })`), an idempotent patch/replace that rewrites identical values may report 0 affectedRows and raise a spurious OCC ConflictError.');return}if((e&n)===0)throw new o("INTERNAL",'@lunora/hyperdrive: this MySQL connection was not created with the `CLIENT_FOUND_ROWS` flag (mysql2: `createPool({ flags: ["FOUND_ROWS"] })`). Without it, `affectedRows` counts changed (not matched) rows, so an idempotent patch/replace that rewrites identical values reports 0 and the OCC guard raises a spurious conflict.')},u=r=>({all:(e,t)=>r.query(e,t),batch:async e=>{await Promise.all(e.map(t=>r.query(t.sql,t.params)))},run:async(e,t)=>(await r.query(e,t),{rowsAffected:0})}),d=r=>(c(r),{all:async(e,t)=>{const[a]=await r.execute(e,t);return a},batch:async e=>{await Promise.all(e.map(t=>r.execute(t.sql,t.params)))},run:async(e,t)=>{const[a]=await r.execute(e,t);return{rowsAffected:a.affectedRows??0}}});export{d as buildMysqlExec,u as buildPgExec};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/hyperdrive",
-  "version": "1.0.0-alpha.82",
+  "version": "1.0.0-alpha.83",
   "description": "Bring-your-own Postgres/MySQL for Lunora via Cloudflare Hyperdrive: a driver-agnostic, action-only ctx.sql",
   "keywords": [
     "cloudflare",
@@ -50,8 +50,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/shard-engine": "1.0.0-alpha.30",
-    "@lunora/sql-store": "1.0.0-alpha.82",
+    "@lunora/errors": "1.0.0-alpha.22",
+    "@lunora/shard-engine": "1.0.0-alpha.31",
+    "@lunora/sql-store": "1.0.0-alpha.83",
     "drizzle-orm": "^0.45.2"
   },
   "peerDependencies": {

package/dist/packem_shared/buildMysqlExec-DriYb1l9.mjs

@@ -1 +0,0 @@
-const u=e=>({all:(r,a)=>e.query(r,a),batch:async r=>{await Promise.all(r.map(a=>e.query(a.sql,a.params)))},run:async(r,a)=>(await e.query(r,a),{rowsAffected:0})}),t=e=>({all:async(r,a)=>{const[s]=await e.execute(r,a);return s},batch:async r=>{await Promise.all(r.map(a=>e.execute(a.sql,a.params)))},run:async(r,a)=>{const[s]=await e.execute(r,a);return{rowsAffected:s.affectedRows??0}}});export{t as buildMysqlExec,u as buildPgExec};