@lunora/errors 1.0.0-alpha.2 → 1.0.0-alpha.4

package/dist/index.d.mts

@@ -125,6 +125,23 @@ declare const ERROR_CATALOG: {
     readonly status: 403;
     readonly title: "RLS policy required";
   };
+  readonly RUN_DEPTH_EXCEEDED: {
+    readonly internal: true;
+    readonly status: 500;
+    readonly title: "Run depth exceeded";
+  };
+  readonly MIGRATION_NOT_FOUND: {
+    readonly status: 404;
+    readonly title: "Data migration not found";
+  };
+  readonly UNKNOWN_TABLE: {
+    readonly status: 404;
+    readonly title: "Unknown table";
+  };
+  readonly GLOBAL_TABLE_NOT_EDITABLE: {
+    readonly status: 400;
+    readonly title: "Global table is not editable";
+  };
   readonly SHARD_ERROR: {
     readonly status: 503;
     readonly title: "Shard error";
@@ -278,7 +295,7 @@ declare class LunoraError extends Error {
   readonly title: string | undefined;
   /** Source location, when known (mirrors `VisulimaError.loc`). */
   readonly loc: ErrorLocation | undefined;
-  /** Machine-readable reason, keyed into {@link ERROR_CATALOG}. */
+  /** Machine-readable reason, keyed into `ERROR_CATALOG`. */
   readonly code: string;
   /** HTTP/RPC status for the transport mappers. */
   readonly status: number;
@@ -295,8 +312,15 @@ interface LunoraErrorLike extends Error {
   docsUrl?: string;
   hint?: ErrorHint;
   status: number;
+  /** Wire brand that distinguishes real `LunoraError`s from foreign errors. */
+  type: "VisulimaError";
 }
-/** True when `error` carries the Lunora transport shape (string `code` + numeric `status`). */
+/**
+* True when `error` carries the Lunora transport shape (string `code` + numeric
+* `status` + the `VisulimaError` brand). The `type` brand is what distinguishes
+* a real `LunoraError` (or its wire-decoded twin) from a foreign error that
+* happens to carry `code`/`status` — see plan 119 for the full rationale.
+*/
 declare const isLunoraError: (error: unknown) => error is LunoraErrorLike;
 /** Throw an `INTERNAL` {@link LunoraError} when `condition` is falsy. */
 declare const invariant: (condition: unknown, message: string) => asserts condition;

package/dist/index.d.ts

@@ -125,6 +125,23 @@ declare const ERROR_CATALOG: {
     readonly status: 403;
     readonly title: "RLS policy required";
   };
+  readonly RUN_DEPTH_EXCEEDED: {
+    readonly internal: true;
+    readonly status: 500;
+    readonly title: "Run depth exceeded";
+  };
+  readonly MIGRATION_NOT_FOUND: {
+    readonly status: 404;
+    readonly title: "Data migration not found";
+  };
+  readonly UNKNOWN_TABLE: {
+    readonly status: 404;
+    readonly title: "Unknown table";
+  };
+  readonly GLOBAL_TABLE_NOT_EDITABLE: {
+    readonly status: 400;
+    readonly title: "Global table is not editable";
+  };
   readonly SHARD_ERROR: {
     readonly status: 503;
     readonly title: "Shard error";
@@ -278,7 +295,7 @@ declare class LunoraError extends Error {
   readonly title: string | undefined;
   /** Source location, when known (mirrors `VisulimaError.loc`). */
   readonly loc: ErrorLocation | undefined;
-  /** Machine-readable reason, keyed into {@link ERROR_CATALOG}. */
+  /** Machine-readable reason, keyed into `ERROR_CATALOG`. */
   readonly code: string;
   /** HTTP/RPC status for the transport mappers. */
   readonly status: number;
@@ -295,8 +312,15 @@ interface LunoraErrorLike extends Error {
   docsUrl?: string;
   hint?: ErrorHint;
   status: number;
+  /** Wire brand that distinguishes real `LunoraError`s from foreign errors. */
+  type: "VisulimaError";
 }
-/** True when `error` carries the Lunora transport shape (string `code` + numeric `status`). */
+/**
+* True when `error` carries the Lunora transport shape (string `code` + numeric
+* `status` + the `VisulimaError` brand). The `type` brand is what distinguishes
+* a real `LunoraError` (or its wire-decoded twin) from a foreign error that
+* happens to carry `code`/`status` — see plan 119 for the full rationale.
+*/
 declare const isLunoraError: (error: unknown) => error is LunoraErrorLike;
 /** Throw an `INTERNAL` {@link LunoraError} when `condition` is falsy. */
 declare const invariant: (condition: unknown, message: string) => asserts condition;

package/dist/index.mjs

@@ -1,5 +1,5 @@
-export { LunoraError } from './packem_shared/LunoraError-Dg03M4uC.mjs';
-export { ERROR_CATALOG, MESSAGE_SOLUTIONS, findSolutionByMessage, flattenHint, isInternalCode, resolveHint } from './packem_shared/ERROR_CATALOG-DAg3Unhb.mjs';
-export { isLunoraError } from './packem_shared/isLunoraError-BvsoKcWE.mjs';
-export { invariant, unreachable } from './packem_shared/invariant-BsrkuTaN.mjs';
-export { toErrorBody } from './packem_shared/toErrorBody-BbR2r6pO.mjs';
+export { LunoraError } from './packem_shared/LunoraError-Cdb2-Hda.mjs';
+export { ERROR_CATALOG, MESSAGE_SOLUTIONS, findSolutionByMessage, flattenHint, isInternalCode, resolveHint } from './packem_shared/ERROR_CATALOG-pJvm6SQP.mjs';
+export { isLunoraError } from './packem_shared/isLunoraError-CSQtYMrF.mjs';
+export { invariant, unreachable } from './packem_shared/invariant-HhlkSkbP.mjs';
+export { toErrorBody } from './packem_shared/toErrorBody-BXvKCSrv.mjs';

package/dist/packem_shared/{ERROR_CATALOG-DAg3Unhb.mjs → ERROR_CATALOG-pJvm6SQP.mjs}

@@ -48,6 +48,10 @@ const ERROR_CATALOG = {
     status: 403,
     title: "RLS policy required"
   },
+  RUN_DEPTH_EXCEEDED: { internal: true, status: 500, title: "Run depth exceeded" },
+  MIGRATION_NOT_FOUND: { status: 404, title: "Data migration not found" },
+  UNKNOWN_TABLE: { status: 404, title: "Unknown table" },
+  GLOBAL_TABLE_NOT_EDITABLE: { status: 400, title: "Global table is not editable" },
   SHARD_ERROR: { status: 503, title: "Shard error" },
   SHARD_UNAVAILABLE: { status: 503, title: "Shard unavailable" },
   OFFLINE_IDENTITY_CHANGED: { status: 409, title: "Offline identity changed" },
@@ -69,7 +73,8 @@ const ERROR_CATALOG = {
   R2_SQL_ERROR: { status: 502, title: "R2 SQL API error" },
   WORKFLOWS_REST_ERROR: { status: 502, title: "Cloudflare Workflows REST API error" }
 };
-const isInternalCode = (code) => ERROR_CATALOG[code]?.internal === true;
+const getCatalogEntry = (code) => Object.hasOwn(ERROR_CATALOG, code) ? ERROR_CATALOG[code] : void 0;
+const isInternalCode = (code) => getCatalogEntry(code)?.internal === true;
 const MESSAGE_SOLUTIONS = [
   {
     body: [
@@ -209,7 +214,7 @@ const resolveHint = (input) => {
     return input.hint;
   }
   if (input.code !== void 0) {
-    const entry = ERROR_CATALOG[input.code];
+    const entry = getCatalogEntry(input.code);
     if (entry?.hint !== void 0) {
       return entry.hint;
     }
@@ -217,4 +222,4 @@ const resolveHint = (input) => {
   return input.message === void 0 ? void 0 : findSolutionByMessage(input.message)?.body;
 };
 
-export { ERROR_CATALOG, MESSAGE_SOLUTIONS, findSolutionByMessage, flattenHint, isInternalCode, resolveHint };
+export { ERROR_CATALOG, MESSAGE_SOLUTIONS, findSolutionByMessage, flattenHint, getCatalogEntry, isInternalCode, resolveHint };

package/dist/packem_shared/{LunoraError-Dg03M4uC.mjs → LunoraError-Cdb2-Hda.mjs}

@@ -1,4 +1,4 @@
-import { ERROR_CATALOG } from './ERROR_CATALOG-DAg3Unhb.mjs';
+import { getCatalogEntry } from './ERROR_CATALOG-pJvm6SQP.mjs';
 
 class LunoraError extends Error {
   /**
@@ -13,7 +13,7 @@ class LunoraError extends Error {
   title;
   /** Source location, when known (mirrors `VisulimaError.loc`). */
   loc;
-  /** Machine-readable reason, keyed into {@link ERROR_CATALOG}. */
+  /** Machine-readable reason, keyed into `ERROR_CATALOG`. */
   code;
   /** HTTP/RPC status for the transport mappers. */
   status;
@@ -22,8 +22,8 @@ class LunoraError extends Error {
   /** Optional structured payload propagated verbatim to the client. */
   data;
   constructor(code, message, options = {}) {
-    const entry = ERROR_CATALOG[code];
-    super(message ?? code, { cause: options.cause });
+    const entry = getCatalogEntry(code);
+    super(message ?? code, options.cause === void 0 ? void 0 : { cause: options.cause });
     this.name = options.name ?? "LunoraError";
     this.hint = options.hint ?? entry?.hint;
     this.title = options.title ?? entry?.title;

package/dist/packem_shared/{invariant-BsrkuTaN.mjs → invariant-HhlkSkbP.mjs}

@@ -1,4 +1,4 @@
-import { LunoraError } from './LunoraError-Dg03M4uC.mjs';
+import { LunoraError } from './LunoraError-Cdb2-Hda.mjs';
 
 const invariant = (condition, message) => {
   if (!condition) {

package/dist/packem_shared/{isLunoraError-BvsoKcWE.mjs → isLunoraError-CSQtYMrF.mjs}

@@ -3,7 +3,7 @@ const isLunoraError = (error) => {
     return false;
   }
   const candidate = error;
-  return typeof candidate.code === "string" && typeof candidate.status === "number";
+  return candidate.type === "VisulimaError" && typeof candidate.code === "string" && typeof candidate.status === "number";
 };
 
 export { isLunoraError };

package/dist/packem_shared/{toErrorBody-BbR2r6pO.mjs → toErrorBody-BXvKCSrv.mjs}

@@ -1,5 +1,5 @@
-import { isInternalCode, resolveHint } from './ERROR_CATALOG-DAg3Unhb.mjs';
-import { isLunoraError } from './isLunoraError-BvsoKcWE.mjs';
+import { isInternalCode, resolveHint } from './ERROR_CATALOG-pJvm6SQP.mjs';
+import { isLunoraError } from './isLunoraError-CSQtYMrF.mjs';
 
 const toErrorBody = (error, options = {}) => {
   const redactedMessage = options.redactedMessage ?? "Internal error";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/errors",
-  "version": "1.0.0-alpha.2",
+  "version": "1.0.0-alpha.4",
   "description": "Unified error layer for Lunora: one LunoraError base + a central catalog of codes, statuses, and actionable hints, rendered across CLI, overlay, Studio, and the client",
   "keywords": [
     "cloudflare",