@sonicjs-cms/core 2.19.0 → 3.0.0-beta.10

package/dist/templates.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunk4ZSNJDLS_cjs = require('./chunk-4ZSNJDLS.cjs');
-var chunkOHYBNCVL_cjs = require('./chunk-OHYBNCVL.cjs');
-var chunkUYJ6TJHX_cjs = require('./chunk-UYJ6TJHX.cjs');
+var chunkCRGUD4KC_cjs = require('./chunk-CRGUD4KC.cjs');
+var chunkPXNTCCPE_cjs = require('./chunk-PXNTCCPE.cjs');
+var chunkK623Q6WD_cjs = require('./chunk-K623Q6WD.cjs');
 require('./chunk-MNWKYY5E.cjs');
 require('./chunk-IGJUBJBW.cjs');
 
@@ -10,71 +10,59 @@ require('./chunk-IGJUBJBW.cjs');
 
 Object.defineProperty(exports, "renderFilterBar", {
   enumerable: true,
-  get: function () { return chunk4ZSNJDLS_cjs.renderFilterBar; }
+  get: function () { return chunkCRGUD4KC_cjs.renderFilterBar; }
 });
 Object.defineProperty(exports, "renderFormsDocsPage", {
   enumerable: true,
-  get: function () { return chunk4ZSNJDLS_cjs.renderFormsDocsPage; }
+  get: function () { return chunkCRGUD4KC_cjs.renderFormsDocsPage; }
 });
 Object.defineProperty(exports, "renderFormsExamplesPage", {
   enumerable: true,
-  get: function () { return chunk4ZSNJDLS_cjs.renderFormsExamplesPage; }
+  get: function () { return chunkCRGUD4KC_cjs.renderFormsExamplesPage; }
 });
 Object.defineProperty(exports, "getConfirmationDialogScript", {
   enumerable: true,
-  get: function () { return chunkOHYBNCVL_cjs.getConfirmationDialogScript; }
+  get: function () { return chunkPXNTCCPE_cjs.getConfirmationDialogScript; }
 });
 Object.defineProperty(exports, "renderAdminLayout", {
   enumerable: true,
-  get: function () { return chunkOHYBNCVL_cjs.renderAdminLayout; }
+  get: function () { return chunkPXNTCCPE_cjs.renderAdminLayout; }
 });
 Object.defineProperty(exports, "renderAlert", {
   enumerable: true,
-  get: function () { return chunkOHYBNCVL_cjs.renderAlert; }
+  get: function () { return chunkPXNTCCPE_cjs.renderAlert; }
 });
 Object.defineProperty(exports, "renderCheckboxPage", {
   enumerable: true,
-  get: function () { return chunkOHYBNCVL_cjs.renderCheckboxPage; }
-});
-Object.defineProperty(exports, "renderCodeExamplesList", {
-  enumerable: true,
-  get: function () { return chunkOHYBNCVL_cjs.renderCodeExamplesList; }
+  get: function () { return chunkPXNTCCPE_cjs.renderCheckboxPage; }
 });
 Object.defineProperty(exports, "renderConfirmationDialog", {
   enumerable: true,
-  get: function () { return chunkOHYBNCVL_cjs.renderConfirmationDialog; }
-});
-Object.defineProperty(exports, "renderDesignPage", {
-  enumerable: true,
-  get: function () { return chunkOHYBNCVL_cjs.renderDesignPage; }
+  get: function () { return chunkPXNTCCPE_cjs.renderConfirmationDialog; }
 });
 Object.defineProperty(exports, "renderForm", {
   enumerable: true,
-  get: function () { return chunkOHYBNCVL_cjs.renderForm; }
+  get: function () { return chunkPXNTCCPE_cjs.renderForm; }
 });
 Object.defineProperty(exports, "renderFormField", {
   enumerable: true,
-  get: function () { return chunkOHYBNCVL_cjs.renderFormField; }
+  get: function () { return chunkPXNTCCPE_cjs.renderFormField; }
 });
 Object.defineProperty(exports, "renderPagination", {
   enumerable: true,
-  get: function () { return chunkOHYBNCVL_cjs.renderPagination; }
+  get: function () { return chunkPXNTCCPE_cjs.renderPagination; }
 });
 Object.defineProperty(exports, "renderTable", {
   enumerable: true,
-  get: function () { return chunkOHYBNCVL_cjs.renderTable; }
-});
-Object.defineProperty(exports, "renderTestimonialsList", {
-  enumerable: true,
-  get: function () { return chunkOHYBNCVL_cjs.renderTestimonialsList; }
+  get: function () { return chunkPXNTCCPE_cjs.renderTable; }
 });
 Object.defineProperty(exports, "renderAdminLayoutCatalyst", {
   enumerable: true,
-  get: function () { return chunkUYJ6TJHX_cjs.renderAdminLayoutCatalyst; }
+  get: function () { return chunkK623Q6WD_cjs.renderAdminLayoutCatalyst; }
 });
 Object.defineProperty(exports, "renderLogo", {
   enumerable: true,
-  get: function () { return chunkUYJ6TJHX_cjs.renderLogo; }
+  get: function () { return chunkK623Q6WD_cjs.renderLogo; }
 });
 //# sourceMappingURL=templates.cjs.map
 //# sourceMappingURL=templates.cjs.map

package/dist/templates.d.cts

@@ -1,4 +1,4 @@
-export { A as AlertData, C as ConfirmationDialogOptions, F as Filter, a as FilterBarData, b as FilterOption, c as FormData, d as FormField, P as PaginationData, T as TableColumn, e as TableData, g as getConfirmationDialogScript, r as renderAlert, f as renderConfirmationDialog, h as renderFilterBar, i as renderForm, j as renderFormField, k as renderPagination, l as renderTable } from './filter-bar.template-DlVYMk-T.cjs';
+export { A as AdminLayoutCatalystData, a as AlertData, C as ConfirmationDialogOptions, F as Filter, b as FilterBarData, c as FilterOption, d as FormData, e as FormField, P as PaginationData, T as TableColumn, f as TableData, g as getConfirmationDialogScript, r as renderAdminLayoutCatalyst, h as renderAlert, i as renderConfirmationDialog, j as renderFilterBar, k as renderForm, l as renderFormField, m as renderPagination, n as renderTable } from './admin-layout-catalyst.template-DrwDUfsE.cjs';
 import { HtmlEscapedString } from 'hono/utils/html';
 
 interface AdminLayoutData {
@@ -23,28 +23,6 @@ interface AdminLayoutData {
 }
 declare function renderAdminLayout(data: AdminLayoutData): string;
 
-interface AdminLayoutCatalystData {
-    title: string;
-    pageTitle?: string;
-    currentPath?: string;
-    version?: string;
-    enableExperimentalFeatures?: boolean;
-    user?: {
-        name: string;
-        email: string;
-        role: string;
-    };
-    scripts?: string[];
-    styles?: string[];
-    content: string | HtmlEscapedString;
-    dynamicMenuItems?: Array<{
-        label: string;
-        path: string;
-        icon: string;
-    }>;
-}
-declare function renderAdminLayoutCatalyst(data: AdminLayoutCatalystData): string;
-
 interface LogoData {
     size?: 'sm' | 'md' | 'lg' | 'xl';
     variant?: 'default' | 'white' | 'dark';
@@ -56,16 +34,6 @@ interface LogoData {
 }
 declare function renderLogo(data?: LogoData): string;
 
-interface DesignPageData {
-    user?: {
-        name: string;
-        email: string;
-        role: string;
-    };
-    version?: string;
-}
-declare function renderDesignPage(data: DesignPageData): string;
-
 interface CheckboxPageData {
     user?: {
         name: string;
@@ -75,61 +43,6 @@ interface CheckboxPageData {
 }
 declare function renderCheckboxPage(data: CheckboxPageData): string;
 
-interface Testimonial {
-    id: number;
-    author_name: string;
-    author_title?: string;
-    author_company?: string;
-    testimonial_text: string;
-    rating?: number;
-    isPublished: boolean;
-    sortOrder: number;
-    created_at: number;
-    updated_at: number;
-}
-interface TestimonialsListData {
-    testimonials: Testimonial[];
-    totalCount: number;
-    currentPage: number;
-    totalPages: number;
-    user?: {
-        name: string;
-        email: string;
-        role: string;
-    };
-    message?: string;
-    messageType?: 'success' | 'error' | 'warning' | 'info';
-}
-declare function renderTestimonialsList(data: TestimonialsListData): string;
-
-interface CodeExample {
-    id: number;
-    title: string;
-    description?: string;
-    code: string;
-    language: string;
-    category?: string;
-    tags?: string;
-    isPublished: boolean;
-    sortOrder: number;
-    created_at: number;
-    updated_at: number;
-}
-interface CodeExamplesListData {
-    codeExamples: CodeExample[];
-    totalCount: number;
-    currentPage: number;
-    totalPages: number;
-    user?: {
-        name: string;
-        email: string;
-        role: string;
-    };
-    message?: string;
-    messageType?: 'success' | 'error' | 'warning' | 'info';
-}
-declare function renderCodeExamplesList(data: CodeExamplesListData): string;
-
 interface FormsDocsPageData {
     user?: {
         name: string;
@@ -150,4 +63,4 @@ interface FormsExamplesPageData {
 }
 declare function renderFormsExamplesPage(data: FormsExamplesPageData): string;
 
-export { type AdminLayoutCatalystData, type AdminLayoutData, type CheckboxPageData, type DesignPageData, type FormsDocsPageData, type FormsExamplesPageData, renderAdminLayout, renderAdminLayoutCatalyst, renderCheckboxPage, renderCodeExamplesList, renderDesignPage, renderFormsDocsPage, renderFormsExamplesPage, renderLogo, renderTestimonialsList };
+export { type AdminLayoutData, type CheckboxPageData, type FormsDocsPageData, type FormsExamplesPageData, renderAdminLayout, renderCheckboxPage, renderFormsDocsPage, renderFormsExamplesPage, renderLogo };

package/dist/templates.d.ts

@@ -1,4 +1,4 @@
-export { A as AlertData, C as ConfirmationDialogOptions, F as Filter, a as FilterBarData, b as FilterOption, c as FormData, d as FormField, P as PaginationData, T as TableColumn, e as TableData, g as getConfirmationDialogScript, r as renderAlert, f as renderConfirmationDialog, h as renderFilterBar, i as renderForm, j as renderFormField, k as renderPagination, l as renderTable } from './filter-bar.template-DlVYMk-T.js';
+export { A as AdminLayoutCatalystData, a as AlertData, C as ConfirmationDialogOptions, F as Filter, b as FilterBarData, c as FilterOption, d as FormData, e as FormField, P as PaginationData, T as TableColumn, f as TableData, g as getConfirmationDialogScript, r as renderAdminLayoutCatalyst, h as renderAlert, i as renderConfirmationDialog, j as renderFilterBar, k as renderForm, l as renderFormField, m as renderPagination, n as renderTable } from './admin-layout-catalyst.template-DrwDUfsE.js';
 import { HtmlEscapedString } from 'hono/utils/html';
 
 interface AdminLayoutData {
@@ -23,28 +23,6 @@ interface AdminLayoutData {
 }
 declare function renderAdminLayout(data: AdminLayoutData): string;
 
-interface AdminLayoutCatalystData {
-    title: string;
-    pageTitle?: string;
-    currentPath?: string;
-    version?: string;
-    enableExperimentalFeatures?: boolean;
-    user?: {
-        name: string;
-        email: string;
-        role: string;
-    };
-    scripts?: string[];
-    styles?: string[];
-    content: string | HtmlEscapedString;
-    dynamicMenuItems?: Array<{
-        label: string;
-        path: string;
-        icon: string;
-    }>;
-}
-declare function renderAdminLayoutCatalyst(data: AdminLayoutCatalystData): string;
-
 interface LogoData {
     size?: 'sm' | 'md' | 'lg' | 'xl';
     variant?: 'default' | 'white' | 'dark';
@@ -56,16 +34,6 @@ interface LogoData {
 }
 declare function renderLogo(data?: LogoData): string;
 
-interface DesignPageData {
-    user?: {
-        name: string;
-        email: string;
-        role: string;
-    };
-    version?: string;
-}
-declare function renderDesignPage(data: DesignPageData): string;
-
 interface CheckboxPageData {
     user?: {
         name: string;
@@ -75,61 +43,6 @@ interface CheckboxPageData {
 }
 declare function renderCheckboxPage(data: CheckboxPageData): string;
 
-interface Testimonial {
-    id: number;
-    author_name: string;
-    author_title?: string;
-    author_company?: string;
-    testimonial_text: string;
-    rating?: number;
-    isPublished: boolean;
-    sortOrder: number;
-    created_at: number;
-    updated_at: number;
-}
-interface TestimonialsListData {
-    testimonials: Testimonial[];
-    totalCount: number;
-    currentPage: number;
-    totalPages: number;
-    user?: {
-        name: string;
-        email: string;
-        role: string;
-    };
-    message?: string;
-    messageType?: 'success' | 'error' | 'warning' | 'info';
-}
-declare function renderTestimonialsList(data: TestimonialsListData): string;
-
-interface CodeExample {
-    id: number;
-    title: string;
-    description?: string;
-    code: string;
-    language: string;
-    category?: string;
-    tags?: string;
-    isPublished: boolean;
-    sortOrder: number;
-    created_at: number;
-    updated_at: number;
-}
-interface CodeExamplesListData {
-    codeExamples: CodeExample[];
-    totalCount: number;
-    currentPage: number;
-    totalPages: number;
-    user?: {
-        name: string;
-        email: string;
-        role: string;
-    };
-    message?: string;
-    messageType?: 'success' | 'error' | 'warning' | 'info';
-}
-declare function renderCodeExamplesList(data: CodeExamplesListData): string;
-
 interface FormsDocsPageData {
     user?: {
         name: string;
@@ -150,4 +63,4 @@ interface FormsExamplesPageData {
 }
 declare function renderFormsExamplesPage(data: FormsExamplesPageData): string;
 
-export { type AdminLayoutCatalystData, type AdminLayoutData, type CheckboxPageData, type DesignPageData, type FormsDocsPageData, type FormsExamplesPageData, renderAdminLayout, renderAdminLayoutCatalyst, renderCheckboxPage, renderCodeExamplesList, renderDesignPage, renderFormsDocsPage, renderFormsExamplesPage, renderLogo, renderTestimonialsList };
+export { type AdminLayoutData, type CheckboxPageData, type FormsDocsPageData, type FormsExamplesPageData, renderAdminLayout, renderCheckboxPage, renderFormsDocsPage, renderFormsExamplesPage, renderLogo };

package/dist/templates.js

@@ -1,6 +1,6 @@
-export { renderFilterBar, renderFormsDocsPage, renderFormsExamplesPage } from './chunk-ON5ZMSU4.js';
-export { getConfirmationDialogScript, renderAdminLayout, renderAlert, renderCheckboxPage, renderCodeExamplesList, renderConfirmationDialog, renderDesignPage, renderForm, renderFormField, renderPagination, renderTable, renderTestimonialsList } from './chunk-XWIA3HVX.js';
-export { renderAdminLayoutCatalyst, renderLogo } from './chunk-55RDMDOP.js';
+export { renderFilterBar, renderFormsDocsPage, renderFormsExamplesPage } from './chunk-JQISFW6U.js';
+export { getConfirmationDialogScript, renderAdminLayout, renderAlert, renderCheckboxPage, renderConfirmationDialog, renderForm, renderFormField, renderPagination, renderTable } from './chunk-OBA2RYZN.js';
+export { renderAdminLayoutCatalyst, renderLogo } from './chunk-5V62WT6M.js';
 import './chunk-TQABQWOP.js';
 import './chunk-V4OQ3NZ2.js';
 //# sourceMappingURL=templates.js.map

package/dist/types-Dea1eNxU.d.cts

@@ -0,0 +1,286 @@
+/**
+ * Typed hook event catalog
+ *
+ * The single source of truth for which lifecycle events a plugin may subscribe
+ * to, and the payload shape each one carries. Subscribing through the typed
+ * facade (`createTypedHooks`) gives a plugin the narrowed payload type with no
+ * casting — TypeScript rejects a wrong field name at the `.on()` call site.
+ *
+ * Scope note: this catalog lists the events that are (or are being) dispatched
+ * in production. The legacy string-keyed `HOOKS` map in `../types` declared many
+ * more events than were ever fired; reconciling that list down to what actually
+ * dispatches is tracked in the plugin-overhaul plan. Add an event here only when
+ * a real dispatch site exists (or is landing in the same change).
+ */
+/**
+ * The acting user on a hook event. ONE canonical shape across every event —
+ * always `id` (never `userId`), so a plugin reading `payload.user.id` works on
+ * content events and auth events alike.
+ */
+interface HookActor {
+    id: string;
+    email: string;
+    role?: string;
+}
+/** Common shape for content lifecycle events. */
+interface ContentEventPayload {
+    /** Collection / content-type slug the event is about. */
+    collection: string;
+    /** Content row id, when known (absent for pre-create events). */
+    id?: string;
+    /** The content data being read/written. Mutable by `before` handlers in the chain. */
+    data: Record<string, unknown>;
+    /** The acting user, when the event originates from an authenticated request. */
+    user?: HookActor;
+}
+/** Emitted after a user completes self-registration. */
+interface AuthRegistrationCompletedPayload {
+    user: HookActor;
+}
+/** Emitted when a password reset is requested (carries the reset token internally). */
+interface AuthPasswordResetRequestedPayload {
+    user: HookActor;
+    /** Single-use reset token. Never expose this in an API response. */
+    resetToken: string;
+}
+/** Emitted after a password reset is confirmed. */
+interface AuthPasswordResetCompletedPayload {
+    user: HookActor;
+}
+/** Emitted after a magic-link sign-in link is successfully consumed. */
+interface AuthMagicLinkConsumedPayload {
+    user: HookActor;
+}
+/** Emitted after an OTP code is successfully verified. */
+interface AuthOtpVerifiedPayload {
+    user: HookActor;
+}
+/**
+ * The catalog: event name → payload type.
+ *
+ * Keep keys in sync with `HookEventName` (derived below) and with the dispatch
+ * sites. This is an interface (not a const) so it participates in type-level
+ * lookups and can be augmented via declaration merging if a downstream package
+ * needs to extend it.
+ */
+interface HookEventPayloads {
+    'content:read': ContentEventPayload;
+    'content:before:create': ContentEventPayload;
+    'content:before:update': ContentEventPayload;
+    'content:before:delete': ContentEventPayload;
+    'content:after:create': ContentEventPayload;
+    'content:after:update': ContentEventPayload;
+    'content:after:delete': ContentEventPayload;
+    'content:after:publish': ContentEventPayload;
+    'auth:registration:completed': AuthRegistrationCompletedPayload;
+    'auth:password-reset:requested': AuthPasswordResetRequestedPayload;
+    'auth:password-reset:completed': AuthPasswordResetCompletedPayload;
+    'auth:magic-link:consumed': AuthMagicLinkConsumedPayload;
+    'auth:otp:verified': AuthOtpVerifiedPayload;
+}
+/** Union of all catalog event names. */
+type HookEventName = keyof HookEventPayloads;
+/** The payload type for a given event name. */
+type HookPayload<E extends HookEventName> = HookEventPayloads[E];
+/**
+ * Runtime list of catalog event names.
+ *
+ * Useful for validation (e.g. "is this a known event?") and for diagnostics.
+ * Kept as a typed tuple so it can't silently drift from the interface: any new
+ * key added to `HookEventPayloads` should be added here too, and the
+ * `satisfies` check below fails the build if the list references an unknown
+ * event.
+ */
+declare const HOOK_EVENT_NAMES: readonly ["content:read", "content:before:create", "content:before:update", "content:before:delete", "content:after:create", "content:after:update", "content:after:delete", "content:after:publish", "auth:registration:completed", "auth:password-reset:requested", "auth:password-reset:completed", "auth:magic-link:consumed", "auth:otp:verified"];
+/** True if `name` is a canonical catalog event. */
+declare function isKnownHookEvent(name: string): name is HookEventName;
+/** Deprecated event names mapped to their canonical payload type. */
+interface LegacyHookEventPayloads {
+    'content:create': ContentEventPayload;
+    'content:update': ContentEventPayload;
+    'content:delete': ContentEventPayload;
+    'content:publish': ContentEventPayload;
+    /** No after-only successor; folded into update. */
+    'content:save': ContentEventPayload;
+}
+/** Map each deprecated name to the canonical name it resolves to. */
+declare const LEGACY_EVENT_ALIASES: {
+    readonly 'content:create': "content:after:create";
+    readonly 'content:update': "content:after:update";
+    readonly 'content:delete': "content:after:delete";
+    readonly 'content:publish': "content:after:publish";
+    readonly 'content:save': "content:after:update";
+};
+/** A deprecated event name accepted (with a warning) at subscribe time. */
+type LegacyHookEventName = keyof LegacyHookEventPayloads;
+/** True if `name` is a deprecated alias. */
+declare function isLegacyHookEvent(name: string): name is LegacyHookEventName;
+/**
+ * Resolve a subscribe-time event name to its canonical form: returns the name
+ * itself if canonical, the aliased canonical name if deprecated, or `undefined`
+ * if unknown.
+ */
+declare function resolveHookEventName(name: string): HookEventName | undefined;
+
+/**
+ * Typed hook facade
+ *
+ * Wraps the (string-keyed, untyped) hook system in a catalog-aware API:
+ *
+ *   const hooks = createTypedHooks(hookSystem)
+ *   hooks.on('auth:registration:completed', (payload) => {
+ *     payload.user.email   // ✓ narrowed — no cast
+ *     payload.user.nope    // ✗ type error
+ *   })
+ *   await hooks.dispatch('auth:registration:completed', { user: {...} })
+ *
+ * The facade is intentionally structural about the underlying hook system (see
+ * `HookSystemLike`) so both `HookSystemImpl` and `ScopedHookSystem` — and the
+ * `src`/`dist` duplicate type identities — all satisfy it without casts.
+ */
+
+/** A name accepted at subscribe time: a canonical event or a deprecated alias. */
+type SubscribableEvent = HookEventName | LegacyHookEventName;
+/** The payload type for a subscribable name — canonical payload, even for aliases. */
+type PayloadForEvent<E extends SubscribableEvent> = E extends HookEventName ? HookPayload<E> : E extends LegacyHookEventName ? LegacyHookEventPayloads[E] : never;
+/**
+ * Minimal structural contract the typed facade needs from a hook system.
+ * Satisfied by `HookSystemImpl` and `ScopedHookSystem`.
+ */
+interface HookSystemLike {
+    register(hookName: string, handler: (data: any, context: any) => any, priority?: number): void;
+    execute(hookName: string, data: any, context?: any): Promise<any>;
+    unregister?(hookName: string, handler: (data: any, context: any) => any): void;
+}
+/** Context passed to a typed hook handler (kept loose; mirrors the legacy HookContext). */
+interface TypedHookContext {
+    /** Plugin that registered the hook, if known. */
+    plugin?: string;
+    /** Cancel the remaining hook chain. */
+    cancel?: () => void;
+    [key: string]: unknown;
+}
+/**
+ * A typed hook handler. May mutate and return the payload (threaded to the next
+ * handler), or return nothing (the current payload is preserved).
+ */
+type TypedHookHandler<E extends HookEventName> = (payload: HookPayload<E>, context: TypedHookContext) => HookPayload<E> | void | Promise<HookPayload<E> | void>;
+interface TypedHooks {
+    /**
+     * Subscribe to a catalog event. Accepts canonical names and (for one release)
+     * deprecated aliases — an alias resolves to its canonical name and emits a
+     * one-time deprecation warning. Lower priority runs earlier (default 10).
+     */
+    on<E extends SubscribableEvent>(event: E, handler: (payload: PayloadForEvent<E>, context: TypedHookContext) => PayloadForEvent<E> | void | Promise<PayloadForEvent<E> | void>, priority?: number): void;
+    /**
+     * Dispatch a catalog event through the handler chain. Canonical names only —
+     * the host owns dispatch sites. Returns the (possibly mutated) payload.
+     */
+    dispatch<E extends HookEventName>(event: E, payload: HookPayload<E>, context?: TypedHookContext): Promise<HookPayload<E>>;
+}
+/**
+ * Build a typed facade over a hook system.
+ *
+ * `on()` resolves deprecated aliases to canonical names (warning once), then
+ * registers under the canonical name so a legacy subscriber fires when the host
+ * dispatches the canonical event. Returning `void` from a handler preserves the
+ * current payload in the chain (the underlying `execute()` threads whatever each
+ * handler returns, so we coalesce `undefined` back to the incoming data).
+ */
+declare function createTypedHooks(hookSystem: HookSystemLike): TypedHooks;
+
+/**
+ * Provider-agnostic email types
+ *
+ * The whole point of this layer: a SonicJS app sends mail through one
+ * `EmailService` chokepoint, and the *transport* is a swappable `EmailProvider`.
+ * Built-ins ship for Resend and SendGrid, but a developer can drop in any
+ * implementation of `EmailProvider` (Postmark, SES, an internal relay, a mock in
+ * tests) without touching call sites. Every send is recorded in `email_log`.
+ */
+/** A message as authored by a caller. `from` is optional (the service fills a default). */
+interface EmailMessage {
+    to: string | string[];
+    subject: string;
+    html?: string;
+    text?: string;
+    /** Overrides the service's default from-address. */
+    from?: string;
+    replyTo?: string;
+    cc?: string | string[];
+    bcc?: string | string[];
+    /** Extra transport headers. */
+    headers?: Record<string, string>;
+    /**
+     * Logical flow this send belongs to (e.g. `'password-reset'`, `'otp'`,
+     * `'magic-link'`, `'welcome'`, `'test'`). Recorded in `email_log.flow` for
+     * observability; does not affect delivery.
+     */
+    flow?: string;
+    /** Free-form metadata recorded (as JSON) in `email_log.metadata`. */
+    metadata?: Record<string, unknown>;
+}
+/** A message after the service has resolved defaults — what a provider receives. */
+interface NormalizedEmailMessage extends Omit<EmailMessage, 'to' | 'cc' | 'bcc'> {
+    to: string[];
+    from: string;
+    cc?: string[];
+    bcc?: string[];
+}
+/** Outcome of a single send attempt. */
+interface SendResult {
+    ok: boolean;
+    /** Provider that handled (or attempted) the send. */
+    provider: string;
+    /** Provider-side message id, when the transport returns one. */
+    providerId?: string;
+    /** Error message when `ok` is false. */
+    error?: string;
+    /** id of the `email_log` row written for this attempt, when logging is enabled. */
+    logId?: string;
+}
+/**
+ * A swappable email transport.
+ *
+ * Implement this to support any provider. `isConfigured()` lets the service (and
+ * `resolveEmailProvider`) decide whether a provider is usable before attempting a
+ * send — e.g. a Resend provider with no API key reports `false`.
+ */
+/**
+ * An email_log entry as seen by the reconciliation method.
+ * Derived from the documents row data JSON for type_id='email_log'.
+ * `id` is the document root_id used to identify the row.
+ */
+interface EmailLogRow {
+    id: string;
+    provider_id?: string | null;
+    provider: string;
+    status: 'sent' | 'failed' | string;
+    delivery_state?: string | null;
+}
+interface EmailProvider {
+    /** Stable identifier recorded in `email_log.provider` (e.g. `'resend'`). */
+    readonly name: string;
+    /** True if the provider has everything it needs to send (credentials, etc.). */
+    isConfigured(): boolean;
+    /** Attempt delivery. Must not throw for ordinary failures — return `ok: false`. */
+    send(message: NormalizedEmailMessage): Promise<SendResult>;
+    /**
+     * Optional: reconcile delivery state for a batch of recently-sent messages.
+     *
+     * Called by the core `email-reconciliation` cron. Providers that expose a
+     * delivery/event API (e.g. Cloudflare Email with delivery webhooks) implement
+     * this to backfill `delivery_state`. Providers without delivery status APIs
+     * (e.g. Resend, SendGrid at the current integration level) leave this undefined
+     * — those rows stay with `delivery_state = null`.
+     *
+     * Returning an array of `{ id, delivery_state }` updates the matching rows in
+     * `email_log`. Errors do not propagate (cron is fire-and-log).
+     */
+    reconcile?(rows: EmailLogRow[]): Promise<Array<{
+        id: string;
+        delivery_state: string;
+    }>>;
+}
+
+export { type AuthMagicLinkConsumedPayload as A, type ContentEventPayload as C, type EmailProvider as E, HOOK_EVENT_NAMES as H, LEGACY_EVENT_ALIASES as L, type NormalizedEmailMessage as N, type PayloadForEvent as P, type SubscribableEvent as S, type TypedHookContext as T, type AuthOtpVerifiedPayload as a, type AuthPasswordResetCompletedPayload as b, type AuthPasswordResetRequestedPayload as c, type AuthRegistrationCompletedPayload as d, type HookActor as e, type HookEventName as f, type HookEventPayloads as g, type HookPayload as h, type HookSystemLike as i, type LegacyHookEventName as j, type LegacyHookEventPayloads as k, type TypedHookHandler as l, type TypedHooks as m, createTypedHooks as n, isKnownHookEvent as o, isLegacyHookEvent as p, type SendResult as q, resolveHookEventName as r, type EmailLogRow as s, type EmailMessage as t };