@cosmicdrift/kumiko-framework 0.16.0 → 0.19.0

package/src/stack/request-helper.ts

@@ -4,6 +4,44 @@ import type { SessionUser } from "../engine/types";
 
 export type BatchCommand = { type: string; payload: unknown };
 
+type WireErrorBody = {
+  readonly code?: string;
+  readonly details?: {
+    readonly causeName?: string;
+    readonly causeMessage?: string;
+    readonly causeStack?: string;
+  };
+};
+
+function formatWriteFailure(type: string, body: unknown): string {
+  const parsed = body as {
+    isSuccess?: boolean;
+    error?: WireErrorBody | string;
+  };
+  const code =
+    (typeof parsed.error === "object" ? parsed.error?.code : undefined) ??
+    (typeof parsed.error === "string" ? parsed.error : "unknown");
+  const details =
+    typeof parsed.error === "object" && parsed.error?.details !== undefined
+      ? parsed.error.details
+      : undefined;
+  const causeMessage =
+    details && typeof details === "object" && "causeMessage" in details
+      ? String((details as { causeMessage?: unknown }).causeMessage ?? "")
+      : "";
+  const causeName =
+    details && typeof details === "object" && "causeName" in details
+      ? String((details as { causeName?: unknown }).causeName ?? "")
+      : "";
+  if (code === "internal_error" && (causeMessage || causeName)) {
+    return `Expected write "${type}" to succeed but got error: ${code} (${causeName}: ${causeMessage})`;
+  }
+  if (details !== undefined) {
+    return `Expected write "${type}" to succeed but got error: ${code} — ${JSON.stringify(details)}`;
+  }
+  return `Expected write "${type}" to succeed but got error: ${code}`;
+}
+
 export type RequestHelper = {
   write: (
     type: string,
@@ -123,10 +161,7 @@ export function createRequestHelper(app: Hono, jwt: JwtHelper): RequestHelper {
       // follow the error-contract shape { error: { code, i18nKey, ... } } with
       // a 4xx/5xx status — no isSuccess flag. Detect either.
       if (body.isSuccess !== true) {
-        const code =
-          (typeof body.error === "object" ? body.error?.code : undefined) ??
-          (typeof body.error === "string" ? body.error : "unknown");
-        throw new Error(`Expected write "${type}" to succeed but got error: ${code}`);
+        throw new Error(formatWriteFailure(type, body));
       }
       return body.data as T; // @cast-boundary engine-bridge
     },

package/src/stack/table-helpers.ts

@@ -107,7 +107,7 @@ export async function unsafePushTables(
         if (!prevIdxNames.has(idx.name)) {
           const kind = idx.unique ? "UNIQUE INDEX" : "INDEX";
           const colList = idx.columns.map((c) => `"${c}"`).join(", ");
-          await createIndexIfNotExists(db, kind, idx.name, meta.tableName, colList);
+          await createIndexIfNotExists(db, kind, idx.name, meta.tableName, colList, idx.whereSql);
         }
       }
     } else {

package/src/utils/index.ts

@@ -4,5 +4,5 @@ export { readPositiveIntEnv } from "./env-parse";
 export { generateId } from "./ids";
 export { isPlainObject } from "./is-plain-object";
 export { parseStringArrayJson } from "./parse-string-array-json";
-export { parseJsonOrThrow, parseJsonSafe } from "./safe-json";
+export { parseJsonOrThrow, parseJsonSafe, stringifyJson } from "./safe-json";
 export { parseRoles } from "./serialization";

package/src/utils/safe-json.ts

@@ -28,3 +28,22 @@ export function parseJsonOrThrow<T>(raw: string, context: string): T {
     throw new Error(`Invalid JSON in ${context}: ${msg}`);
   }
 }
+
+/** JSON.stringify that survives BigInt / Temporal values from DB rows. */
+export function stringifyJson(value: unknown): string {
+  return JSON.stringify(value, (_key, v) => {
+    if (typeof v === "bigint") {
+      const asNumber = Number(v);
+      if (
+        asNumber <= Number.MAX_SAFE_INTEGER &&
+        asNumber >= Number.MIN_SAFE_INTEGER &&
+        BigInt(asNumber) === v
+      ) {
+        return asNumber;
+      }
+      return v.toString();
+    }
+    if (v instanceof Temporal.Instant) return v.toString();
+    return v;
+  });
+}