@luckystack/core 0.12.1 → 0.14.0

package/CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to `@luckystack/core` are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.14.0] - 2026-10-16
+
+### Added
+
+- **`EmailResult` failures can carry `code`, `status` and `blocksSender`.** `code` is the provider's own error name (Resend `daily_quota_exceeded`, nodemailer `EAUTH`), `status` the HTTP status or SMTP reply code, and `blocksSender: true` says the sender refuses every message until an operator acts. All three are optional; a custom adapter that sets none behaves as before.
+- **`dispatchHook` takes an optional `onError`** (third argument, type `DispatchHookOptions`). A throwing handler's error then goes to it instead of the default log line and tracker capture, so a caller can redact it or report many dispatches as one event; `@luckystack/email` uses it to keep addresses out of hook-error reports. Without it nothing changes; an `onError` that throws is ignored, like a failing reporter.
+
 ## [0.12.1] - 2026-10-15
 
 ### Fixed

package/dist/emailRegistry.d.ts

@@ -79,6 +79,16 @@ export type EmailResult = {
      * whose delivery semantics are adapter-specific.
      */
     deliveryOutcome?: EmailDeliveryOutcome;
+    /** The provider's own error code, e.g. Resend `daily_quota_exceeded` or nodemailer `EAUTH`. */
+    code?: string;
+    /** HTTP status for an API provider, SMTP reply code for SMTP. */
+    status?: number;
+    /**
+     * The sender refuses every message until an operator acts (quota used up,
+     * credentials rejected); retrying the next message is pointless.
+     * `sendEmailBatch` stops at the first such failure.
+     */
+    blocksSender?: boolean;
 };
 export interface EmailSendContext {
     /** Cooperative cancellation. Custom adapters should abort provider I/O when supported. */

package/dist/hooks/registry.d.ts

@@ -6,7 +6,14 @@ export type DispatchResult = {
     signal: HookStopSignal;
 };
 export declare const registerHook: <TName extends HookName>(name: TName, handler: HookHandler<HookPayloads[TName]>) => (() => void);
-export declare const dispatchHook: <TName extends HookName>(name: TName, payload: HookPayloads[TName]) => Promise<DispatchResult>;
+export interface DispatchHookOptions {
+    /**
+     * Receives a throwing handler's error instead of the default log line and
+     * tracker capture, e.g. to redact it or to report many dispatches at once.
+     */
+    onError?: (error: unknown) => void;
+}
+export declare const dispatchHook: <TName extends HookName>(name: TName, payload: HookPayloads[TName], options?: DispatchHookOptions) => Promise<DispatchResult>;
 export declare const clearAllHooks: () => void;
 export declare const registerSyncHook: <TName extends SyncHookName>(name: TName, handler: SyncHookHandler<SyncHookPayloads[TName]>) => (() => void);
 export declare const dispatchSyncHook: <TName extends SyncHookName>(name: TName, payload: SyncHookPayloads[TName]) => void;

package/dist/index.d.ts

@@ -106,5 +106,5 @@ export type { TestResetTarget } from './testResetTargets.js';
 export { issueOneTimeToken, consumeOneTimeToken, consumeOneTimeTokenJson, oneTimeTokenKey, } from './oneTimeToken.js';
 export type { OneTimeTokenHandle } from './oneTimeToken.js';
 export { registerHook, dispatchHook, clearAllHooks, registerSyncHook, dispatchSyncHook } from './hooks/registry.js';
-export type { DispatchResult } from './hooks/registry.js';
+export type { DispatchHookOptions, DispatchResult } from './hooks/registry.js';
 export type { HookSessionShape, HookStopSignal, HookResult, HookHandler, HookName, HookPayloads, PreApiValidatePayload, PostApiValidatePayload, PreApiExecutePayload, PostApiExecutePayload, PreApiRespondPayload, PostApiRespondPayload, ApiResponseEnvelope, PreHttpRequestPayload, PostHttpRequestPayload, PreSocketMessagePayload, PreSyncAuthorizePayload, PostSyncAuthorizePayload, PreSyncValidatePayload, PostSyncValidatePayload, PreSyncExecutePayload, PostSyncExecutePayload, PreSyncFanoutPayload, PostSyncFanoutPayload, PreSyncRecipientPayload, ApiErrorPayload, SyncErrorPayload, ApiAuthRejectedPayload, RateLimitExceededPayload, CorsRejectedPayload, CsrfMismatchPayload, PreSessionRefreshPayload, PostSessionRefreshPayload, SessionCreatedPayload, SessionRevokedPayload, OnUploadStartPayload, OnUploadCompletePayload, PreAvatarServePayload, PostAvatarServePayload, PreServerStopPayload, SyncHookName, SyncHookHandler, SyncHookPayloads, PreErrorNormalizePayload, PostErrorNormalizePayload, } from './hooks/types.js';

package/dist/index.js

@@ -170,13 +170,20 @@ var registerHook = (name, handler) => {
     if (index !== -1) handlers.splice(index, 1);
   };
 };
-var dispatchHook = async (name, payload) => {
+var dispatchHook = async (name, payload, options = {}) => {
   const handlers = hookHandlers.get(name) ?? [];
   for (const handler of handlers) {
     let result;
     try {
       result = await handler(payload);
     } catch (error) {
+      if (options.onError) {
+        try {
+          options.onError(error);
+        } catch {
+        }
+        continue;
+      }
       try {
         getLogger().error(`hook: handler for "${name}" threw`, error, { hook: name });
       } catch {