sqlite-zod-orm 3.26.0 → 3.26.1

package/README.md

@@ -228,6 +228,21 @@ db.exec('UPDATE users SET score = 0 WHERE role = ?', 'guest');
 - Debug mode (SQL logging)
 - Raw SQL escape hatch
 
+## Contributing
+
+SatiDB is opinionated by design. Before proposing new features, understand what it intentionally does **not** do:
+
+| ❌ Don't add | Why |
+|---|---|
+| Tagged SQL templates | The whole point is "zero SQL" — `db.raw()` is the escape hatch |
+| FTS5 wrapper | Wrapping it poorly is worse than not wrapping it — use `db.raw()` |
+| Query middleware | `measure-fn` handles observability, `hooks` handle lifecycle |
+| Cursor pagination | Offset pagination covers SQLite's single-process use case |
+| Schema introspection API | Zod schemas are compile-time known — runtime reflection invites dynamic queries |
+| Migration CLI | Auto-migration handles additive changes; use `db.exec()` for destructive ones |
+
+**The rule:** if the query builder can already do it, don't add a new API surface for it.
+
 ## Requirements
 
 - **Bun** ≥ 1.0 (uses `bun:sqlite` native bindings)

package/dist/index.js

@@ -23,8 +23,9 @@ var toAlpha = (num) => {
   } while (n >= 0);
   return result;
 };
-var maxResultLen = 80;
-var safeStringify = (value) => {
+var maxResultLen = 0;
+var safeStringify = (value, limit) => {
+  const cap = limit ?? maxResultLen;
   if (value === undefined)
     return "";
   if (value === null)
@@ -37,7 +38,9 @@ var safeStringify = (value) => {
     return value.toString();
   if (typeof value === "string") {
     const q = JSON.stringify(value);
-    return q.length > maxResultLen ? q.slice(0, maxResultLen - 1) + '\u2026"' : q;
+    if (cap === 0)
+      return q;
+    return q.length > cap ? q.slice(0, cap - 1) + '\u2026"' : q;
   }
   try {
     const seen = new WeakSet;
@@ -53,7 +56,9 @@ var safeStringify = (value) => {
         return `${val}n`;
       return val;
     });
-    return str.length > maxResultLen ? str.slice(0, maxResultLen) + "\u2026" : str;
+    if (cap === 0)
+      return str;
+    return str.length > cap ? str.slice(0, cap) + "\u2026" : str;
   } catch {
     return String(value);
   }
@@ -67,7 +72,7 @@ var formatDuration = (ms) => {
   const secs = Math.round(ms % 60000 / 1000);
   return `${mins}m ${secs}s`;
 };
-var timestamps = process.env.MEASURE_TIMESTAMPS === "1" || process.env.MEASURE_TIMESTAMPS === "true";
+var timestamps = typeof process !== "undefined" && (process.env.MEASURE_TIMESTAMPS === "1" || process.env.MEASURE_TIMESTAMPS === "true");
 var ts = () => {
   if (!timestamps)
     return "";
@@ -78,7 +83,9 @@ var ts = () => {
   const ms = String(now.getMilliseconds()).padStart(3, "0");
   return `[${h}:${m}:${s}.${ms}] `;
 };
-var silent = process.env.MEASURE_SILENT === "1" || process.env.MEASURE_SILENT === "true";
+var silent = typeof process !== "undefined" && (process.env.MEASURE_SILENT === "1" || process.env.MEASURE_SILENT === "true");
+var dotEndLabel = true;
+var dotChar = "\xB7";
 var logger = null;
 var buildActionLabel = (actionInternal) => {
   return typeof actionInternal === "object" && actionInternal !== null && "label" in actionInternal ? String(actionInternal.label) : String(actionInternal);
@@ -90,6 +97,20 @@ var extractBudget = (actionInternal) => {
     return Number(actionInternal.budget);
   return;
 };
+var extractTimeout = (actionInternal) => {
+  if (typeof actionInternal !== "object" || actionInternal === null)
+    return;
+  if ("timeout" in actionInternal)
+    return Number(actionInternal.timeout);
+  return;
+};
+var extractMaxResultLength = (actionInternal) => {
+  if (typeof actionInternal !== "object" || actionInternal === null)
+    return;
+  if ("maxResultLength" in actionInternal)
+    return Number(actionInternal.maxResultLength);
+  return;
+};
 var extractMeta = (actionInternal) => {
   if (typeof actionInternal !== "object" || actionInternal === null)
     return;
@@ -98,6 +119,8 @@ var extractMeta = (actionInternal) => {
     delete details.label;
   if ("budget" in details)
     delete details.budget;
+  if ("maxResultLength" in details)
+    delete details.maxResultLength;
   if (Object.keys(details).length === 0)
     return;
   return details;
@@ -126,16 +149,18 @@ var defaultLogger = (event, prefix) => {
       console.log(`${t}${id} ... ${event.label}${formatMeta(event.meta)}`);
       break;
     case "success": {
-      const resultStr = event.result !== undefined ? safeStringify(event.result) : "";
+      const endLabel = dotEndLabel ? dotChar.repeat(event.label.length) : event.label;
+      const resultStr = event.result !== undefined ? safeStringify(event.result, event.maxResultLength) : "";
       const arrow = resultStr ? ` \u2192 ${resultStr}` : "";
       const budgetWarn = event.budget && event.duration > event.budget ? ` \u26A0 OVER BUDGET (${formatDuration(event.budget)})` : "";
-      console.log(`${t}${id} \u2713 ${event.label} ${formatDuration(event.duration)}${arrow}${budgetWarn}`);
+      console.log(`${t}${id} ${endLabel} ${formatDuration(event.duration)}${arrow}${budgetWarn}`);
       break;
     }
     case "error": {
+      const endLabel = dotEndLabel ? dotChar.repeat(event.label.length) : event.label;
       const errorMsg = event.error instanceof Error ? event.error.message : String(event.error);
       const budgetWarn = event.budget && event.duration > event.budget ? ` \u26A0 OVER BUDGET (${formatDuration(event.budget)})` : "";
-      console.log(`${t}${id} \u2717 ${event.label} ${formatDuration(event.duration)} (${errorMsg})${budgetWarn}`);
+      console.log(`${t}${id} \u2717 ${endLabel} ${formatDuration(event.duration)} (${errorMsg})${budgetWarn}`);
       if (event.error instanceof Error) {
         console.error(`${id}`, event.error.stack ?? event.error.message);
         if (event.error.cause) {
@@ -151,13 +176,14 @@ var defaultLogger = (event, prefix) => {
       break;
   }
 };
-var createNestedResolver = (isAsync, fullIdChain, childCounterRef, depth, resolver, prefix) => {
+var createNestedResolver = (isAsync, fullIdChain, childCounterRef, depth, resolver, prefix, inheritedMaxLen) => {
   return (...args) => {
     const label = args[0];
     const fn = args[1];
+    const onError = args[2];
     if (typeof fn === "function") {
       const childParentChain = [...fullIdChain, childCounterRef.value++];
-      return resolver(fn, label, childParentChain, depth + 1);
+      return resolver(fn, label, childParentChain, depth + 1, typeof onError === "function" ? onError : undefined, inheritedMaxLen);
     } else {
       emit({
         type: "annotation",
@@ -171,20 +197,24 @@ var createNestedResolver = (isAsync, fullIdChain, childCounterRef, depth, resolv
   };
 };
 var globalRootCounter = 0;
-var createMeasureImpl = (prefix, counterRef) => {
+var createMeasureImpl = (prefix, counterRef, scopeOpts) => {
   const counter = counterRef ?? { get value() {
     return globalRootCounter;
   }, set value(v) {
     globalRootCounter = v;
   } };
+  const scopeMaxLen = scopeOpts?.maxResultLength;
   let _lastError = null;
-  const _measureInternal = async (fnInternal, actionInternal, parentIdChain, depth) => {
+  const _measureInternal = async (fnInternal, actionInternal, parentIdChain, depth, onError, inheritedMaxLen) => {
     const start = performance.now();
     const childCounterRef = { value: 0 };
     const label = buildActionLabel(actionInternal);
     const budget = extractBudget(actionInternal);
-    const currentId = toAlpha(parentIdChain.pop() ?? 0);
-    const fullIdChain = [...parentIdChain, currentId];
+    const timeout = extractTimeout(actionInternal);
+    const localMaxLen = extractMaxResultLength(actionInternal);
+    const effectiveMaxLen = localMaxLen ?? inheritedMaxLen;
+    const currentId = toAlpha(Number(parentIdChain.pop() ?? 0));
+    const fullIdChain = [...parentIdChain.map(String), currentId];
     const idStr = fullIdChain.join("-");
     emit({
       type: "start",
@@ -193,27 +223,46 @@ var createMeasureImpl = (prefix, counterRef) => {
       depth,
       meta: extractMeta(actionInternal)
     }, prefix);
-    const measureForNextLevel = createNestedResolver(true, fullIdChain, childCounterRef, depth, _measureInternal, prefix);
+    const measureForNextLevel = createNestedResolver(true, fullIdChain, childCounterRef, depth, _measureInternal, prefix, effectiveMaxLen);
     try {
-      const result = await fnInternal(measureForNextLevel);
+      let result;
+      if (timeout && timeout > 0) {
+        result = await Promise.race([
+          fnInternal(measureForNextLevel),
+          new Promise((_, reject) => setTimeout(() => reject(new Error(`Timeout (${formatDuration(timeout)})`)), timeout))
+        ]);
+      } else {
+        result = await fnInternal(measureForNextLevel);
+      }
       const duration = performance.now() - start;
-      emit({ type: "success", id: idStr, label, depth, duration, result, budget }, prefix);
+      emit({ type: "success", id: idStr, label, depth, duration, result, budget, maxResultLength: effectiveMaxLen }, prefix);
       return result;
     } catch (error) {
       const duration = performance.now() - start;
-      emit({ type: "error", id: idStr, label, depth, duration, error, budget }, prefix);
+      emit({ type: "error", id: idStr, label, depth, duration, error, budget, maxResultLength: effectiveMaxLen }, prefix);
       _lastError = error;
+      if (onError) {
+        try {
+          return onError(error);
+        } catch (onErrorError) {
+          emit({ type: "error", id: idStr, label: `${label} (onError)`, depth, duration: performance.now() - start, error: onErrorError, budget, maxResultLength: effectiveMaxLen }, prefix);
+          _lastError = onErrorError;
+          return null;
+        }
+      }
       return null;
     }
   };
-  const _measureInternalSync = (fnInternal, actionInternal, parentIdChain, depth) => {
+  const _measureInternalSync = (fnInternal, actionInternal, parentIdChain, depth, _onError, inheritedMaxLen) => {
     const start = performance.now();
     const childCounterRef = { value: 0 };
     const label = buildActionLabel(actionInternal);
     const hasNested = fnInternal.length > 0;
     const budget = extractBudget(actionInternal);
-    const currentId = toAlpha(parentIdChain.pop() ?? 0);
-    const fullIdChain = [...parentIdChain, currentId];
+    const localMaxLen = extractMaxResultLength(actionInternal);
+    const effectiveMaxLen = localMaxLen ?? inheritedMaxLen;
+    const currentId = toAlpha(Number(parentIdChain.pop() ?? 0));
+    const fullIdChain = [...parentIdChain.map(String), currentId];
     const idStr = fullIdChain.join("-");
     if (hasNested) {
       emit({
@@ -224,22 +273,22 @@ var createMeasureImpl = (prefix, counterRef) => {
         meta: extractMeta(actionInternal)
       }, prefix);
     }
-    const measureForNextLevel = createNestedResolver(false, fullIdChain, childCounterRef, depth, _measureInternalSync, prefix);
+    const measureForNextLevel = createNestedResolver(false, fullIdChain, childCounterRef, depth, _measureInternalSync, prefix, effectiveMaxLen);
     try {
       const result = fnInternal(measureForNextLevel);
       const duration = performance.now() - start;
-      emit({ type: "success", id: idStr, label, depth, duration, result, budget }, prefix);
+      emit({ type: "success", id: idStr, label, depth, duration, result, budget, maxResultLength: effectiveMaxLen }, prefix);
       return result;
     } catch (error) {
       const duration = performance.now() - start;
-      emit({ type: "error", id: idStr, label, depth, duration, error, budget }, prefix);
+      emit({ type: "error", id: idStr, label, depth, duration, error, budget, maxResultLength: effectiveMaxLen }, prefix);
       _lastError = error;
       return null;
     }
   };
-  const measureFn = async (arg1, arg2) => {
+  const measureFn = async (arg1, arg2, arg3) => {
     if (typeof arg2 === "function") {
-      return _measureInternal(arg2, arg1, [counter.value++], 0);
+      return _measureInternal(arg2, arg1, [counter.value++], 0, arg3, scopeMaxLen);
     } else {
       const currentId = toAlpha(counter.value++);
       emit({
@@ -349,7 +398,7 @@ var createMeasureImpl = (prefix, counterRef) => {
   };
   const measureSyncFn = (arg1, arg2) => {
     if (typeof arg2 === "function") {
-      return _measureInternalSync(arg2, arg1, [counter.value++], 0);
+      return _measureInternalSync(arg2, arg1, [counter.value++], 0, undefined, scopeMaxLen);
     } else {
       const currentId = toAlpha(counter.value++);
       emit({
@@ -385,9 +434,9 @@ var createMeasureImpl = (prefix, counterRef) => {
 var globalInstance = createMeasureImpl();
 var measure = globalInstance.measure;
 var measureSync = globalInstance.measureSync;
-var createMeasure = (scopePrefix) => {
+var createMeasure = (scopePrefix, opts) => {
   const scopeCounter = { value: 0 };
-  const scoped = createMeasureImpl(scopePrefix, scopeCounter);
+  const scoped = createMeasureImpl(scopePrefix, scopeCounter, opts);
   return {
     ...scoped,
     resetCounter: () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sqlite-zod-orm",
-  "version": "3.26.0",
+  "version": "3.26.1",
   "description": "Type-safe SQLite ORM for Bun — Zod schemas, fluent queries, auto relationships, zero SQL",
   "type": "module",
   "main": "./dist/index.js",
@@ -49,10 +49,10 @@
     "typescript": "^5.0.0"
   },
   "dependencies": {
-    "measure-fn": "^3.3.0",
+    "measure-fn": "^3.10.0",
     "zod": "^3.25.67"
   },
   "engines": {
     "bun": ">=1.0.0"
   }
-}
+}