@stacksjs/error-handling 0.75.15 → 0.75.17

package/dist/bughq.d.ts

@@ -0,0 +1,11 @@
+import type { BugHqMonitoringOptions, ErrorReporter } from '@stacksjs/types';
+/**
+ * Create the BugHQ reporter used by `config/monitoring.ts`.
+ *
+ * Error paths only enqueue through the SDK. Network failures stay inside the
+ * client, and the framework drains its in-flight requests through `log.flush()`.
+ */
+export declare function createBugHqReporter(options: CreateBugHqReporterOptions): ErrorReporter | null;
+export declare interface CreateBugHqReporterOptions extends BugHqMonitoringOptions {
+  environment: string
+}

package/dist/bughq.js

@@ -0,0 +1 @@
+import{BugHQClient}from"@bughq/sdk";export function createBugHqReporter(options){const key=options.key?.trim(),dsn=options.dsn?.trim();if(!key&&!dsn)return null;const client=new BugHQClient({key:key||void 0,dsn:dsn||void 0,host:options.host?.trim()||void 0,project:options.project?.trim()||void 0,release:options.release?.trim()||void 0,environment:options.environment,enabled:options.enabled,sampleRate:options.sampleRate,dedupeMs:options.dedupeMs,maxRetries:options.maxRetries,framework:"stacks",sdkName:"bughq.stacks",userAgent:"@stacksjs/error-handling (+server; Bun)",autoInstrument:!1,captureUnhandled:!1,heartbeat:!1});return{name:"bughq",report(event){client.captureException(event.error,event.context)},async flush(){await client.flush(options.flushTimeout)}}}

package/dist/handler.d.ts

@@ -1,4 +1,5 @@
 import * as path from '@stacksjs/path';
+import type { ErrorReportContext } from '@stacksjs/types';
 import type { LogErrorOptions } from '@stacksjs/logging';
 // Function to update the default log path when config is available
 export declare function setLogPath(path: string): void;
@@ -7,15 +8,7 @@ export declare function handleError(err: string | Error | object | unknown, opti
 /**
  * Context information attached to errors for better debugging.
  */
-export declare interface ErrorContext {
-  requestId?: string
-  url?: string
-  method?: string
-  userId?: string | number
-  ip?: string
-  userAgent?: string
-  [key: string]: unknown
-}
+export declare interface ErrorContext extends ErrorReportContext {}
 declare interface WriteOptions {
   logFile?: string
 }

package/dist/handler.js

@@ -1,7 +1,7 @@
-import fs from"node:fs";import{dirname}from"node:path";import*as process from"node:process";function italic(str){return`\x1B[3m${str}\x1B[23m`}function stripAnsi(str){return str.replace(/\x1B\[[0-9;]*m/g,"")}import*as path from"@stacksjs/path";import{ExitCode}from"@stacksjs/types/exit-code";export class ErrorHandler{static isTestEnvironment=!1;static shouldExitProcess=!1;static handle(err,options){if(!this.isTestEnvironment)this.shouldExitProcess=options?.shouldExit===!0;if(options?.silent!==!0)this.writeErrorToConsole(err);let errorMessage;if(options?.message)errorMessage=options.message;else if(err instanceof Error)errorMessage=err.message;else if(typeof err==="string")errorMessage=err;else errorMessage=JSON.stringify(err);const error=err instanceof Error&&errorMessage===err.message?err:Error(errorMessage,err instanceof Error?{cause:err.cause??err}:void 0);if(err instanceof Error&&error!==err){Object.assign(error,err);if(err.stack)error.stack=`${error.name}: ${errorMessage}
+import fs from"node:fs";import{dirname}from"node:path";import*as process from"node:process";function italic(str){return`\x1B[3m${str}\x1B[23m`}function stripAnsi(str){return str.replace(/\x1B\[[0-9;]*m/g,"")}import*as path from"@stacksjs/path";import{ExitCode}from"@stacksjs/types/exit-code";import{captureError}from"./reporters";export class ErrorHandler{static isTestEnvironment=!1;static shouldExitProcess=!1;static handle(err,options){if(!this.isTestEnvironment)this.shouldExitProcess=options?.shouldExit===!0;if(options?.silent!==!0)this.writeErrorToConsole(err);let errorMessage;if(options?.message)errorMessage=options.message;else if(err instanceof Error)errorMessage=err.message;else if(typeof err==="string")errorMessage=err;else errorMessage=JSON.stringify(err);const error=err instanceof Error&&errorMessage===err.message?err:Error(errorMessage,err instanceof Error?{cause:err.cause??err}:void 0);if(err instanceof Error&&error!==err){Object.assign(error,err);if(err.stack)error.stack=`${error.name}: ${errorMessage}
 ${err.stack.split(`
 `).slice(1).join(`
-`)}`}this.writeErrorToFile(error).catch((e)=>console.error(e));return error}static handleError(err,options){this.handle(err,options);return err}static async writeErrorToFile(err,context){if(!(err instanceof Error)){console.error("Error is not an instance of Error:",err);return}const contextStr=context?` | url=${context.url||"N/A"} method=${context.method||"N/A"} user=${context.userId||"anonymous"}`:"",stackLine=err.stack?`
+`)}`}captureError(error);this.writeErrorToFile(error).catch((e)=>console.error(e));return error}static handleError(err,options){this.handle(err,options);return err}static async writeErrorToFile(err,context){if(!(err instanceof Error)){console.error("Error is not an instance of Error:",err);return}const contextStr=context?` | url=${context.url||"N/A"} method=${context.method||"N/A"} user=${context.userId||"anonymous"}`:"",stackLine=err.stack?`
 ${err.stack.split(`
 `).slice(1,4).join(`
 `)}`:"",formattedError=`[${new Date().toISOString()}] ${err.name}: ${err.message}${contextStr}${stackLine}
@@ -11,4 +11,4 @@ Context: ${JSON.stringify(serializableContext(contextData),null,2)}`;if(cause?.s
 Caused by: ${stripAnsi(cause.stack)}`;writeToLogFile(logMessage).catch((err)=>{console.error("Failed to write error log:",err)});const error=cause?Error(errorMessage,{cause}):Error(errorMessage);if(err instanceof Error)Object.assign(error,err);if(cause?.stack)error.stack=`${error.name}: ${errorMessage}
 ${cause.stack.split(`
 `).slice(1).join(`
-`)}`;return ErrorHandler.handle(error,errorOptions)}
+`)}`;if(contextData)captureError(error,contextData);return ErrorHandler.handle(error,errorOptions)}

package/dist/index.d.ts

@@ -22,9 +22,11 @@ export type {
   StackFrame,
   UserContext,
 } from './error-page';
+export * from './bughq';
 export * from './handler';
 export * from './http';
 export * from './model';
+export * from './reporters';
 export * from './utils';
 export {
   err,

package/dist/index.js

@@ -1 +1 @@
-export*from"./handler";export*from"./http";export*from"./model";export*from"./utils";export{err,fromPromise,ok}from"ts-error-handling";export{ERROR_ILLUSTRATIONS,errorIllustration,illustrationForStatus}from"./error-illustrations";export{createErrorHandler,ERROR_PAGE_CSS,ErrorPageHandler,errorResponse,HTTP_ERRORS,renderError,renderErrorPage,renderHttpErrorHints,renderProductionErrorPage}from"./error-page";
+export*from"./bughq";export*from"./handler";export*from"./http";export*from"./model";export*from"./reporters";export*from"./utils";export{err,fromPromise,ok}from"ts-error-handling";export{ERROR_ILLUSTRATIONS,errorIllustration,illustrationForStatus}from"./error-illustrations";export{createErrorHandler,ERROR_PAGE_CSS,ErrorPageHandler,errorResponse,HTTP_ERRORS,renderError,renderErrorPage,renderHttpErrorHints,renderProductionErrorPage}from"./error-page";

package/dist/reporters.d.ts

@@ -0,0 +1,15 @@
+import type { ErrorReportContext, ErrorReporter } from '@stacksjs/types';
+/** Attach a reporter and return a function that detaches it. */
+export declare function registerErrorReporter(reporter: ErrorReporter): () => void;
+/** A copy of the reporters attached to this process. */
+export declare function reporters(): readonly ErrorReporter[];
+/**
+ * Deliver one exception without ever throwing back onto its handling path.
+ *
+ * Error identity is the deduplication key. The same exception may pass through
+ * an action boundary, the router boundary, and a process boundary, but it is
+ * still one failure and each reporter receives it once.
+ */
+export declare function captureError(value: unknown, context?: ErrorReportContext): Error;
+/** Drain every buffering reporter without turning shutdown into a failure. */
+export declare function flushErrorReporters(): Promise<void>;

package/dist/reporters.js

@@ -0,0 +1,3 @@
+import process from"node:process";const registered=[],reported=new WeakSet,broken=new WeakSet,configuredSeen=new Set,CONFIG_OVERRIDES_KEY=Symbol.for("@stacksjs/config:overrides");function attachConfiguredReporters(){const configured=globalThis[CONFIG_OVERRIDES_KEY]?.monitoring?.reporters;if(!Array.isArray(configured))return;for(const reporter of configured){if(configuredSeen.has(reporter))continue;configuredSeen.add(reporter);if(!registered.includes(reporter))registerErrorReporter(reporter)}}function asError(value){if(value instanceof Error)return value;if(typeof value==="string")return Error(value);try{return Error(JSON.stringify(value))}catch{return Error(String(value))}}export function registerErrorReporter(reporter){if(!reporter||typeof reporter.name!=="string"||!reporter.name||typeof reporter.report!=="function"){process.stderr.write(`[error-reporting] Ignoring a reporter without a name and report() function.
+`);return()=>{}}registered.push(reporter);return()=>{const at=registered.indexOf(reporter);if(at!==-1)registered.splice(at,1)}}export function reporters(){attachConfiguredReporters();return[...registered]}export function captureError(value,context){attachConfiguredReporters();const error=asError(value);if(registered.length===0||reported.has(error))return error;reported.add(error);const event={error,...context?{context}:{}};for(const reporter of registered)try{reporter.report(event)}catch(cause){if(broken.has(reporter))continue;broken.add(reporter);const reason=cause instanceof Error?cause.message:String(cause);process.stderr.write(`[error-reporting] Reporter "${reporter.name}" threw: ${reason}. Further throws from it are silent.
+`)}return error}export async function flushErrorReporters(){attachConfiguredReporters();const pending=registered.filter((reporter)=>typeof reporter.flush==="function").map((reporter)=>Promise.resolve().then(()=>reporter.flush()));if(pending.length>0)await Promise.allSettled(pending)}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/error-handling",
   "type": "module",
-  "version": "0.75.15",
+  "version": "0.75.17",
   "description": "Type safe error handling.",
   "author": "Chris Breuer",
   "contributors": [
@@ -57,16 +57,17 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/path": "0.75.15",
-    "@stacksjs/stx": "^0.2.321",
-    "@stacksjs/types": "0.75.15",
+    "@bughq/sdk": "^0.2.2",
+    "@stacksjs/path": "0.75.17",
+    "@stacksjs/stx": "^0.2.324",
+    "@stacksjs/types": "0.75.17",
     "ts-error-handling": "^0.1.1",
     "ts-syntax-highlighter": "^0.2.1"
   },
   "devDependencies": {
-    "@stacksjs/cli": "0.75.15",
-    "@stacksjs/config": "0.75.15",
-    "@stacksjs/validation": "0.75.15",
+    "@stacksjs/cli": "0.75.17",
+    "@stacksjs/config": "0.75.17",
+    "@stacksjs/validation": "0.75.17",
     "better-dx": "^0.2.24"
   },
   "sideEffects": false