totalum-sdk 0.1.0-dev.7 → 0.1.0-dev.8

package/dist/d1/index.d.ts

@@ -97,8 +97,9 @@ declare function withTotalumSession<E extends object>(request: Request, env: E,
 
 /**
  * A `D1Database` for the project's own database wherever the code runs (A3.4, plan 05 §3): the bound
- * `TOTALUM_DB` inside a Worker, the libsql adapter when the environment moved to Turso, and an HTTPS client to
- * SDK-API everywhere else. Detection happens on the first statement, never at call time (§3.1).
+ * `TOTALUM_DB` inside a Worker, the libsql adapter when the environment moved to Turso, the local D1 that
+ * `initOpenNextCloudflareForDev()` binds under `next dev`, and an HTTPS client to SDK-API everywhere else.
+ * Detection happens on the first statement, never at call time (§3.1).
  */
 declare function totalumD1(options?: TotalumD1Options): D1Database;
 

package/dist/d1/index.js

@@ -9,8 +9,9 @@ export { TotalumD1Error, isTotalumD1Error } from './errors.js';
 export { READ_YOUR_WRITES_COOKIE, withTotalumSession } from './session.js';
 /**
  * A `D1Database` for the project's own database wherever the code runs (A3.4, plan 05 §3): the bound
- * `TOTALUM_DB` inside a Worker, the libsql adapter when the environment moved to Turso, and an HTTPS client to
- * SDK-API everywhere else. Detection happens on the first statement, never at call time (§3.1).
+ * `TOTALUM_DB` inside a Worker, the libsql adapter when the environment moved to Turso, the local D1 that
+ * `initOpenNextCloudflareForDev()` binds under `next dev`, and an HTTPS client to SDK-API everywhere else.
+ * Detection happens on the first statement, never at call time (§3.1).
  */
 export function totalumD1(options = {}) {
     return lazyD1(() => resolveTarget(options), options.mode === 'migrate');
@@ -18,8 +19,8 @@ export function totalumD1(options = {}) {
 async function resolveTarget(options) {
     if (options.binding)
         return options.binding;
-    if (inWorker() && options.transport !== 'https') {
-        if (readEnv('TOTALUM_DB_PROVIDER') === 'turso')
+    if (options.transport !== 'https') {
+        if (inWorker() && readEnv('TOTALUM_DB_PROVIDER') === 'turso')
             return await tursoTarget();
         const binding = await openNextBinding();
         if (binding)
@@ -38,7 +39,8 @@ async function resolveTarget(options) {
     });
 }
 /**
- * OpenNext exposes the request's bindings; absent (a laptop) or outside a request, there is no binding. The executor
+ * OpenNext exposes the request's bindings, in a Worker and under `next dev` (Miniflare's local D1); absent (`next
+ * start`, a script) or outside a request, there is no binding. The executor
  * reads `TOTALUM_DB` again on every statement: it is the current request's database — the plain binding, or the
  * read-replica session `withTotalumSession` put there — never the first request's for the isolate's life.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "totalum-sdk",
-  "version": "0.1.0-dev.7",
+  "version": "0.1.0-dev.8",
   "description": "The SDK generated Totalum apps import: every integration namespace over SDK-API (totalum-sdk, or one subpath each: /files, /ai, /web, …) and totalum-sdk/d1, the D1 driver",
   "license": "UNLICENSED",
   "type": "module",

package/totalum-sdk.md

@@ -78,8 +78,9 @@ totalumD1(options?: TotalumD1Options): D1Database
 ```
 
 A `D1Database` for the project's own database wherever the code runs: the bound
-`TOTALUM_DB` inside a Worker, the libsql adapter when the environment moved to Turso, and an HTTPS client to
-SDK-API everywhere else. Detection happens on the first statement, never at call time.
+`TOTALUM_DB` inside a Worker, the libsql adapter when the environment moved to Turso, the local D1 that
+`initOpenNextCloudflareForDev()` binds under `next dev`, and an HTTPS client to SDK-API everywhere else.
+Detection happens on the first statement, never at call time.
 
 ## `totalum-sdk/files`