@lunora/errors 1.0.0-alpha.23 → 1.0.0-alpha.24

package/dist/index.d.mts

@@ -884,6 +884,27 @@ declare const isLunoraError: (error: unknown) => error is LunoraErrorLike;
 declare const invariant: (condition: unknown, message: string) => asserts condition;
 /** Throw an `INTERNAL` {@link LunoraError} for an unreachable branch. */
 declare const unreachable: (message: string) => never;
+/**
+ * Throw a {@link LunoraError} from expression position.
+ *
+ * `throw` is a statement, so it cannot sit on the right of `??` or in a ternary
+ * arm — the two places a missing value is most naturally rejected. Unlike
+ * {@link invariant} and {@link unreachable}, which are pinned to `INTERNAL`, this
+ * takes the code, which is what a client-actionable failure needs.
+ *
+ * Any string is a valid `code`. A well-known `ERROR_CATALOG` key fills in the
+ * status, title and hint; a package-specific code with no catalog entry defaults
+ * to status 500 and no hint, so pass those in `options` instead.
+ * @param code machine-readable reason
+ * @param message human-readable detail; defaults to `code`
+ * @param options status/title/hint/data overrides
+ * @example
+ * ```ts
+ * const thread = (await ctx.db.threads.get(id)) ?? raise("NOT_FOUND", `thread ${id}`);
+ * // thread is non-nullable here
+ * ```
+ */
+declare const raise: (code: LunoraErrorCodeInput, message?: string, options?: LunoraErrorOptions) => never;
 /** The client-facing error envelope body. */
 interface ErrorBody {
   code: string;
@@ -949,4 +970,4 @@ type LunoraErrorCodeInput, type LunoraErrorLike,
  * renderer (`renderLunoraError`, using `@visulima/error`'s `renderError`) lives
  * in `@lunora/cli`, which already depends on `@visulima/error`.
  */
-type LunoraErrorOptions, MESSAGE_SOLUTIONS, type Solution, type SolutionRule, type ToErrorBodyOptions, type ToErrorBodyResult, findCloudflarePlatformSolution, findIssueSolution, findSolutionByMessage, flattenHint, invariant, isInternalCode, isLunoraError, resolveHint, toErrorBody, unreachable };
+type LunoraErrorOptions, MESSAGE_SOLUTIONS, type Solution, type SolutionRule, type ToErrorBodyOptions, type ToErrorBodyResult, findCloudflarePlatformSolution, findIssueSolution, findSolutionByMessage, flattenHint, invariant, isInternalCode, isLunoraError, raise, resolveHint, toErrorBody, unreachable };

package/dist/index.d.ts

@@ -884,6 +884,27 @@ declare const isLunoraError: (error: unknown) => error is LunoraErrorLike;
 declare const invariant: (condition: unknown, message: string) => asserts condition;
 /** Throw an `INTERNAL` {@link LunoraError} for an unreachable branch. */
 declare const unreachable: (message: string) => never;
+/**
+ * Throw a {@link LunoraError} from expression position.
+ *
+ * `throw` is a statement, so it cannot sit on the right of `??` or in a ternary
+ * arm — the two places a missing value is most naturally rejected. Unlike
+ * {@link invariant} and {@link unreachable}, which are pinned to `INTERNAL`, this
+ * takes the code, which is what a client-actionable failure needs.
+ *
+ * Any string is a valid `code`. A well-known `ERROR_CATALOG` key fills in the
+ * status, title and hint; a package-specific code with no catalog entry defaults
+ * to status 500 and no hint, so pass those in `options` instead.
+ * @param code machine-readable reason
+ * @param message human-readable detail; defaults to `code`
+ * @param options status/title/hint/data overrides
+ * @example
+ * ```ts
+ * const thread = (await ctx.db.threads.get(id)) ?? raise("NOT_FOUND", `thread ${id}`);
+ * // thread is non-nullable here
+ * ```
+ */
+declare const raise: (code: LunoraErrorCodeInput, message?: string, options?: LunoraErrorOptions) => never;
 /** The client-facing error envelope body. */
 interface ErrorBody {
   code: string;
@@ -949,4 +970,4 @@ type LunoraErrorCodeInput, type LunoraErrorLike,
  * renderer (`renderLunoraError`, using `@visulima/error`'s `renderError`) lives
  * in `@lunora/cli`, which already depends on `@visulima/error`.
  */
-type LunoraErrorOptions, MESSAGE_SOLUTIONS, type Solution, type SolutionRule, type ToErrorBodyOptions, type ToErrorBodyResult, findCloudflarePlatformSolution, findIssueSolution, findSolutionByMessage, flattenHint, invariant, isInternalCode, isLunoraError, resolveHint, toErrorBody, unreachable };
+type LunoraErrorOptions, MESSAGE_SOLUTIONS, type Solution, type SolutionRule, type ToErrorBodyOptions, type ToErrorBodyResult, findCloudflarePlatformSolution, findIssueSolution, findSolutionByMessage, flattenHint, invariant, isInternalCode, isLunoraError, raise, resolveHint, toErrorBody, unreachable };

package/dist/index.mjs

@@ -1 +1 @@
-import{LunoraError as e}from"./packem_shared/LunoraError-CR7IPzzZ.mjs";import{CLOUDFLARE_PLATFORM_ERRORS as t,ERROR_CATALOG as i,MESSAGE_SOLUTIONS as a,findCloudflarePlatformSolution as f,findIssueSolution as l,findSolutionByMessage as u,flattenHint as E,isInternalCode as R,resolveHint as S}from"./packem_shared/CLOUDFLARE_PLATFORM_ERRORS-B4sZMTxz.mjs";import{isLunoraError as L}from"./packem_shared/isLunoraError-kpNg-Mxd.mjs";import{invariant as d,unreachable as m}from"./packem_shared/invariant-WzvDTkJF.mjs";import{toErrorBody as x}from"./packem_shared/toErrorBody-yckaoqWe.mjs";export{t as CLOUDFLARE_PLATFORM_ERRORS,i as ERROR_CATALOG,e as LunoraError,a as MESSAGE_SOLUTIONS,f as findCloudflarePlatformSolution,l as findIssueSolution,u as findSolutionByMessage,E as flattenHint,d as invariant,R as isInternalCode,L as isLunoraError,S as resolveHint,x as toErrorBody,m as unreachable};
+import{LunoraError as e}from"./packem_shared/LunoraError-CR7IPzzZ.mjs";import{CLOUDFLARE_PLATFORM_ERRORS as t,ERROR_CATALOG as i,MESSAGE_SOLUTIONS as a,findCloudflarePlatformSolution as f,findIssueSolution as l,findSolutionByMessage as s,flattenHint as u,isInternalCode as E,resolveHint as R}from"./packem_shared/CLOUDFLARE_PLATFORM_ERRORS-B4sZMTxz.mjs";import{isLunoraError as L}from"./packem_shared/isLunoraError-kpNg-Mxd.mjs";import{invariant as d,raise as m,unreachable as p}from"./packem_shared/invariant-9lKACd-S.mjs";import{toErrorBody as A}from"./packem_shared/toErrorBody-yckaoqWe.mjs";export{t as CLOUDFLARE_PLATFORM_ERRORS,i as ERROR_CATALOG,e as LunoraError,a as MESSAGE_SOLUTIONS,f as findCloudflarePlatformSolution,l as findIssueSolution,s as findSolutionByMessage,u as flattenHint,d as invariant,E as isInternalCode,L as isLunoraError,m as raise,R as resolveHint,A as toErrorBody,p as unreachable};

package/dist/packem_shared/invariant-9lKACd-S.mjs

@@ -0,0 +1 @@
+import{LunoraError as o}from"./LunoraError-CR7IPzzZ.mjs";const e=(r,n)=>{if(!r)throw new o("INTERNAL",n,{name:"InvariantError"})},i=r=>{throw new o("INTERNAL",r,{name:"InvariantError"})},w=(r,n,a)=>{throw new o(r,n,a)};export{e as invariant,w as raise,i as unreachable};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/errors",
-  "version": "1.0.0-alpha.23",
+  "version": "1.0.0-alpha.24",
   "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",

package/dist/packem_shared/invariant-WzvDTkJF.mjs

@@ -1 +0,0 @@
-import{LunoraError as n}from"./LunoraError-CR7IPzzZ.mjs";const t=(r,a)=>{if(!r)throw new n("INTERNAL",a,{name:"InvariantError"})},e=r=>{throw new n("INTERNAL",r,{name:"InvariantError"})};export{t as invariant,e as unreachable};