@holo-js/mail 0.1.4 → 0.1.6

package/dist/{chunk-UB6ANQ2F.mjs → chunk-BQCGZOVF.mjs}

@@ -1,9 +1,11 @@
-// src/contracts.ts
+// src/contracts-types.ts
 import { defineMailConfig } from "@holo-js/config";
 var HOLO_MAIL_DEFINITION_MARKER = /* @__PURE__ */ Symbol.for("holo-js.mail.definition");
 var BUILT_IN_MAIL_DRIVERS = ["preview", "log", "fake", "smtp"];
 var MAIL_PRIORITY_VALUES = ["high", "normal", "low"];
 var MAIL_ATTACHMENT_DISPOSITIONS = ["attachment", "inline"];
+
+// src/contracts.ts
 function isObject(value) {
   return !!value && typeof value === "object" && !Array.isArray(value);
 }
@@ -37,7 +39,13 @@ function normalizeDelayValue(value, label) {
   return value;
 }
 function normalizeJsonValue(value, label) {
-  if (value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+  if (value === null || typeof value === "string" || typeof value === "boolean") {
+    return value;
+  }
+  if (typeof value === "number") {
+    if (!Number.isFinite(value)) {
+      throw new Error(`[@holo-js/mail] ${label} must be JSON-serializable.`);
+    }
     return value;
   }
   if (Array.isArray(value)) {
@@ -495,45 +503,13 @@ function attachContent(content, options) {
     ...options
   });
 }
-var mailInternals = {
-  BUILT_IN_MAIL_DRIVERS,
-  HOLO_MAIL_DEFINITION_MARKER,
-  MAIL_ATTACHMENT_DISPOSITIONS,
-  MAIL_PRIORITY_VALUES,
-  attachContent,
-  attachFromPath,
-  attachFromStorage,
-  createAttachmentMetadata,
-  createAttachmentResolutionPlan,
-  createAttachmentResolutionPlans,
-  inferMimeTypeFromName,
-  inferAttachmentName,
-  inferAttachmentSource,
-  isObject,
-  isAttachmentQueueSafe,
-  isValidEmail,
-  mergeMailDefinitionInputs,
-  normalizeAddress,
-  normalizeAttachment,
-  normalizeAttachments,
-  normalizeDelayValue,
-  normalizeHeaders,
-  normalizeJsonValue,
-  normalizeMailDefinition,
-  normalizeOptionalString,
-  normalizePriority,
-  normalizeQueueOptions,
-  normalizeRecipients,
-  normalizeRenderSource,
-  normalizeRequiredString,
-  resolveAttachmentDefinition,
-  resolveNormalizedAttachment,
-  normalizeTags,
-  normalizeViewIdentifier
-};
 
 export {
   defineMailConfig,
+  HOLO_MAIL_DEFINITION_MARKER,
+  BUILT_IN_MAIL_DRIVERS,
+  MAIL_PRIORITY_VALUES,
+  MAIL_ATTACHMENT_DISPOSITIONS,
   inferMimeTypeFromName,
   createAttachmentMetadata,
   resolveNormalizedAttachment,
@@ -547,6 +523,5 @@ export {
   defineMail,
   attachFromPath,
   attachFromStorage,
-  attachContent,
-  mailInternals
+  attachContent
 };

package/dist/contracts.d.ts

@@ -1,6 +1,8 @@
 import { HoloAppEnv, NormalizedHoloMailConfig } from '@holo-js/config';
 export { defineMailConfig } from '@holo-js/config';
 
+declare const HOLO_MAIL_DEFINITION_MARKER: unique symbol;
+declare const BUILT_IN_MAIL_DRIVERS: readonly ["preview", "log", "fake", "smtp"];
 declare const MAIL_PRIORITY_VALUES: readonly ["high", "normal", "low"];
 declare const MAIL_ATTACHMENT_DISPOSITIONS: readonly ["attachment", "inline"];
 type MailJsonPrimitive = string | number | boolean | null;
@@ -248,31 +250,14 @@ interface PendingMailSend<TResult = MailSendResult> extends PromiseLike<TResult>
     catch<TResult1 = never>(onrejected?: ((reason: unknown) => TResult1 | PromiseLike<TResult1>) | null): Promise<TResult | TResult1>;
     finally(onfinally?: (() => void) | null): Promise<TResult>;
 }
-declare function isObject(value: unknown): value is Record<string, unknown>;
-declare function normalizeOptionalString(value: string | undefined, label: string): string | undefined;
-declare function normalizeRequiredString(value: string, label: string): string;
-declare function normalizeDelayValue(value: MailDelayValue, label: string): MailDelayValue;
-declare function normalizeJsonValue(value: unknown, label: string): MailJsonValue;
-declare function normalizeHeaders(headers: Readonly<Record<string, string>> | undefined): Readonly<Record<string, string>>;
-declare function normalizeTags(tags: readonly string[] | undefined): readonly string[];
-declare function normalizeViewIdentifier(value: string, label: string): string;
-declare function isValidEmail(value: string): boolean;
-declare function normalizeAddress(input: MailAddressInput, label: string): MailAddress;
-declare function normalizeRecipients(value: MailRecipientsInput | undefined, label: string, required: boolean): readonly MailAddress[];
-declare function normalizePriority(value: MailPriority | undefined): MailPriority | undefined;
-declare function inferAttachmentName(value: MailAttachmentInput): string | undefined;
+
 declare function inferMimeTypeFromName(name: string | undefined): string | undefined;
-declare function inferAttachmentSource(value: MailAttachmentInput): MailAttachmentMetadata['source'];
 declare function createAttachmentMetadata(attachment: MailAttachmentInput): MailAttachmentMetadata;
-declare function normalizeAttachment(input: MailAttachmentInput, index: number): MailAttachmentInput;
-declare function normalizeAttachments(attachments: readonly MailAttachmentInput[] | undefined): readonly MailAttachmentInput[];
 declare function resolveNormalizedAttachment(attachment: MailAttachmentInput): ResolvedMailAttachment;
 declare function isAttachmentQueueSafe(attachment: MailAttachmentInput): boolean;
 declare function resolveAttachmentDefinition(attachment: MailAttachmentInput): Promise<MailAttachmentInput>;
 declare function createAttachmentResolutionPlan(attachment: MailAttachmentInput, context: MailAttachmentResolutionContext): MailAttachmentResolutionPlan;
 declare function createAttachmentResolutionPlans(attachments: readonly MailAttachmentInput[], context: MailAttachmentResolutionContext): readonly MailAttachmentResolutionPlan[];
-declare function normalizeRenderSource(render: MailRenderSource | undefined): Readonly<MailRenderSource> | undefined;
-declare function normalizeQueueOptions(value: boolean | MailQueueOptions | undefined): boolean | Readonly<MailQueueOptions> | undefined;
 declare function isMailDefinition(value: unknown): value is MailDefinition;
 declare function mergeMailDefinitionInputs(base: MailDefinition | MailDefinitionInput, overrides: MailOverrideInput | undefined): MailDefinitionInput;
 declare function normalizeMailDefinition(input: MailDefinition | MailDefinitionInput): MailDefinition;
@@ -280,41 +265,5 @@ declare function defineMail<TMail extends MailDefinitionInput>(input: TMail): Ma
 declare function attachFromPath(path: string, options?: MailAttachmentHelperOptions): MailPathAttachment;
 declare function attachFromStorage(path: string, options?: MailStorageAttachmentHelperOptions): MailStorageAttachment;
 declare function attachContent(content: MailAttachmentContent, options: MailContentAttachmentHelperOptions): MailContentAttachment;
-declare const mailInternals: {
-    BUILT_IN_MAIL_DRIVERS: readonly ["preview", "log", "fake", "smtp"];
-    HOLO_MAIL_DEFINITION_MARKER: symbol;
-    MAIL_ATTACHMENT_DISPOSITIONS: readonly ["attachment", "inline"];
-    MAIL_PRIORITY_VALUES: readonly ["high", "normal", "low"];
-    attachContent: typeof attachContent;
-    attachFromPath: typeof attachFromPath;
-    attachFromStorage: typeof attachFromStorage;
-    createAttachmentMetadata: typeof createAttachmentMetadata;
-    createAttachmentResolutionPlan: typeof createAttachmentResolutionPlan;
-    createAttachmentResolutionPlans: typeof createAttachmentResolutionPlans;
-    inferMimeTypeFromName: typeof inferMimeTypeFromName;
-    inferAttachmentName: typeof inferAttachmentName;
-    inferAttachmentSource: typeof inferAttachmentSource;
-    isObject: typeof isObject;
-    isAttachmentQueueSafe: typeof isAttachmentQueueSafe;
-    isValidEmail: typeof isValidEmail;
-    mergeMailDefinitionInputs: typeof mergeMailDefinitionInputs;
-    normalizeAddress: typeof normalizeAddress;
-    normalizeAttachment: typeof normalizeAttachment;
-    normalizeAttachments: typeof normalizeAttachments;
-    normalizeDelayValue: typeof normalizeDelayValue;
-    normalizeHeaders: typeof normalizeHeaders;
-    normalizeJsonValue: typeof normalizeJsonValue;
-    normalizeMailDefinition: typeof normalizeMailDefinition;
-    normalizeOptionalString: typeof normalizeOptionalString;
-    normalizePriority: typeof normalizePriority;
-    normalizeQueueOptions: typeof normalizeQueueOptions;
-    normalizeRecipients: typeof normalizeRecipients;
-    normalizeRenderSource: typeof normalizeRenderSource;
-    normalizeRequiredString: typeof normalizeRequiredString;
-    resolveAttachmentDefinition: typeof resolveAttachmentDefinition;
-    resolveNormalizedAttachment: typeof resolveNormalizedAttachment;
-    normalizeTags: typeof normalizeTags;
-    normalizeViewIdentifier: typeof normalizeViewIdentifier;
-};
 
-export { type BuiltInMailDriverRegistry, type HoloMailDriverRegistry, type MailAddress, type MailAddressInput, type MailAttachmentBase, type MailAttachmentContent, type MailAttachmentDisposition, type MailAttachmentHelperOptions, type MailAttachmentInput, type MailAttachmentMetadata, type MailAttachmentResolutionContext, type MailAttachmentResolutionPlan, type MailContentAttachment, type MailContentAttachmentHelperOptions, type MailContentSourceKind, type MailDefinition, type MailDefinitionInput, type MailDelayValue, type MailDriver, type MailDriverExecutionContext, type MailDriverName, type MailDriverRegistry, type MailJsonObject, type MailJsonValue, type MailOverrideInput, type MailPathAttachment, type MailPreviewFormat, type MailPreviewInput, type MailPreviewPolicy, type MailPreviewResult, type MailPriority, type MailQueueOptions, type MailRecipientsInput, type MailRenderPreviewInput, type MailRenderSource, type MailResolvableAttachment, type MailResolvedAttachmentPayload, type MailRuntimeBindings, type MailSendInput, type MailSendOptions, type MailSendResult, type MailStorageAttachment, type MailStorageAttachmentHelperOptions, type MailViewRenderInput, type MailViewRenderer, type PendingMailSend, type RegisterMailDriverOptions, type RegisteredMailDriver, type ResolvedMail, type ResolvedMailAttachment, attachContent, attachFromPath, attachFromStorage, createAttachmentMetadata, createAttachmentResolutionPlan, createAttachmentResolutionPlans, defineMail, inferMimeTypeFromName, isAttachmentQueueSafe, isMailDefinition, mailInternals, mergeMailDefinitionInputs, normalizeMailDefinition, resolveAttachmentDefinition, resolveNormalizedAttachment };
+export { BUILT_IN_MAIL_DRIVERS, type BuiltInMailDriverRegistry, HOLO_MAIL_DEFINITION_MARKER, type HoloMailDriverRegistry, MAIL_ATTACHMENT_DISPOSITIONS, MAIL_PRIORITY_VALUES, type MailAddress, type MailAddressInput, type MailAttachmentBase, type MailAttachmentContent, type MailAttachmentDisposition, type MailAttachmentHelperOptions, type MailAttachmentInput, type MailAttachmentMetadata, type MailAttachmentResolutionContext, type MailAttachmentResolutionPlan, type MailContentAttachment, type MailContentAttachmentHelperOptions, type MailContentSourceKind, type MailDefinition, type MailDefinitionInput, type MailDelayValue, type MailDriver, type MailDriverExecutionContext, type MailDriverName, type MailDriverRegistry, type MailJsonObject, type MailJsonValue, type MailOverrideInput, type MailPathAttachment, type MailPreviewFormat, type MailPreviewInput, type MailPreviewPolicy, type MailPreviewResult, type MailPriority, type MailQueueOptions, type MailRecipientsInput, type MailRenderPreviewInput, type MailRenderSource, type MailResolvableAttachment, type MailResolvedAttachmentPayload, type MailRuntimeBindings, type MailSendInput, type MailSendOptions, type MailSendResult, type MailStorageAttachment, type MailStorageAttachmentHelperOptions, type MailViewRenderInput, type MailViewRenderer, type PendingMailSend, type RegisterMailDriverOptions, type RegisteredMailDriver, type ResolvedMail, type ResolvedMailAttachment, attachContent, attachFromPath, attachFromStorage, createAttachmentMetadata, createAttachmentResolutionPlan, createAttachmentResolutionPlans, defineMail, inferMimeTypeFromName, isAttachmentQueueSafe, isMailDefinition, mergeMailDefinitionInputs, normalizeMailDefinition, resolveAttachmentDefinition, resolveNormalizedAttachment };

package/dist/contracts.mjs

@@ -1,4 +1,8 @@
 import {
+  BUILT_IN_MAIL_DRIVERS,
+  HOLO_MAIL_DEFINITION_MARKER,
+  MAIL_ATTACHMENT_DISPOSITIONS,
+  MAIL_PRIORITY_VALUES,
   attachContent,
   attachFromPath,
   attachFromStorage,
@@ -10,13 +14,16 @@ import {
   inferMimeTypeFromName,
   isAttachmentQueueSafe,
   isMailDefinition,
-  mailInternals,
   mergeMailDefinitionInputs,
   normalizeMailDefinition,
   resolveAttachmentDefinition,
   resolveNormalizedAttachment
-} from "./chunk-UB6ANQ2F.mjs";
+} from "./chunk-BQCGZOVF.mjs";
 export {
+  BUILT_IN_MAIL_DRIVERS,
+  HOLO_MAIL_DEFINITION_MARKER,
+  MAIL_ATTACHMENT_DISPOSITIONS,
+  MAIL_PRIORITY_VALUES,
   attachContent,
   attachFromPath,
   attachFromStorage,
@@ -28,7 +35,6 @@ export {
   inferMimeTypeFromName,
   isAttachmentQueueSafe,
   isMailDefinition,
-  mailInternals,
   mergeMailDefinitionInputs,
   normalizeMailDefinition,
   resolveAttachmentDefinition,

package/dist/index.d.ts

@@ -1,163 +1,7 @@
-import * as _holo_js_config from '@holo-js/config';
-import { NormalizedHoloMailConfig, HoloAppEnv } from '@holo-js/config';
+import { ResolvedMail, MailDriverExecutionContext, MailSendResult, MailPreviewPolicy, MailPreviewFormat, MailRuntimeBindings, MailDefinition, MailDefinitionInput, MailOverrideInput, MailPreviewResult, PendingMailSend, RegisteredMailDriver, MailDriver, RegisterMailDriverOptions } from './contracts.js';
+export { BuiltInMailDriverRegistry, HoloMailDriverRegistry, MailAddress, MailAddressInput, MailAttachmentBase, MailAttachmentContent, MailAttachmentDisposition, MailAttachmentHelperOptions, MailAttachmentInput, MailAttachmentMetadata, MailAttachmentResolutionContext, MailAttachmentResolutionPlan, MailContentAttachment, MailContentAttachmentHelperOptions, MailContentSourceKind, MailDelayValue, MailDriverName, MailJsonObject, MailJsonValue, MailPathAttachment, MailPreviewInput, MailPriority, MailQueueOptions, MailRecipientsInput, MailRenderPreviewInput, MailRenderSource, MailResolvableAttachment, MailResolvedAttachmentPayload, MailSendInput, MailSendOptions, MailStorageAttachment, MailStorageAttachmentHelperOptions, MailViewRenderInput, MailViewRenderer, ResolvedMailAttachment, attachContent, attachFromPath, attachFromStorage, createAttachmentMetadata, createAttachmentResolutionPlan, createAttachmentResolutionPlans, defineMail, inferMimeTypeFromName, isAttachmentQueueSafe, isMailDefinition, mergeMailDefinitionInputs, normalizeMailDefinition, resolveAttachmentDefinition, resolveNormalizedAttachment } from './contracts.js';
 export { HoloMailConfig, NormalizedHoloMailConfig, defineMailConfig } from '@holo-js/config';
-import { ResolvedMail, MailDriverExecutionContext, MailSendResult, MailPreviewPolicy, MailPreviewFormat, MailRuntimeBindings, MailDefinition, MailDefinitionInput, MailOverrideInput, MailPreviewResult, PendingMailSend, MailDelayValue, MailDriver, ResolvedMailAttachment, MailAddress, MailJsonObject, MailRenderSource, MailViewRenderInput, RegisteredMailDriver, RegisterMailDriverOptions } from './contracts.js';
-export { BuiltInMailDriverRegistry, HoloMailDriverRegistry, MailAddressInput, MailAttachmentBase, MailAttachmentContent, MailAttachmentDisposition, MailAttachmentHelperOptions, MailAttachmentInput, MailAttachmentMetadata, MailAttachmentResolutionContext, MailAttachmentResolutionPlan, MailContentAttachment, MailContentAttachmentHelperOptions, MailContentSourceKind, MailDriverName, MailJsonValue, MailPathAttachment, MailPreviewInput, MailPriority, MailQueueOptions, MailRecipientsInput, MailRenderPreviewInput, MailResolvableAttachment, MailResolvedAttachmentPayload, MailSendInput, MailSendOptions, MailStorageAttachment, MailStorageAttachmentHelperOptions, MailViewRenderer, attachContent, attachFromPath, attachFromStorage, createAttachmentMetadata, createAttachmentResolutionPlan, createAttachmentResolutionPlans, defineMail, inferMimeTypeFromName, isAttachmentQueueSafe, isMailDefinition, mailInternals, mergeMailDefinitionInputs, normalizeMailDefinition, resolveAttachmentDefinition, resolveNormalizedAttachment } from './contracts.js';
 
-type RuntimeState = {
-    bindings?: MailRuntimeBindings;
-    fakeSent?: FakeSentMail[];
-    previewArtifacts?: MailPreviewArtifact[];
-    loadQueueModule?: () => Promise<QueueModule>;
-    loadDbModule?: () => Promise<DbModule | null>;
-    loadNodemailerModule?: () => Promise<NodemailerModule>;
-    loadStorageModule?: () => Promise<StorageModule>;
-};
-type MutableSendOptions = {
-    mailer?: string;
-    connection?: string;
-    queue?: string;
-    delay?: MailDelayValue;
-    afterCommit?: boolean;
-};
-type ResolvedEnvelope = {
-    readonly config: NormalizedHoloMailConfig;
-    readonly mailer: string;
-    readonly from: MailAddress;
-    readonly replyTo: MailAddress;
-    readonly to: readonly MailAddress[];
-    readonly cc: readonly MailAddress[];
-    readonly bcc: readonly MailAddress[];
-};
-type RenderedContent = {
-    readonly kind: 'text' | 'html' | 'markdown' | 'render';
-    readonly html?: string;
-    readonly text?: string;
-    readonly source: Readonly<{
-        readonly kind: 'text' | 'html' | 'markdown' | 'render';
-        readonly markdown?: string;
-        readonly rawHtml?: string;
-        readonly render?: Readonly<MailRenderSource>;
-    }>;
-};
-type PreviewComputation = ResolvedEnvelope & {
-    readonly preview: MailPreviewResult;
-};
-type SendPreparation = {
-    readonly attachments: readonly ResolvedMailAttachment[];
-};
-type ResolvedDriver = {
-    readonly mailer: string;
-    readonly driver: string;
-    readonly implementation: MailDriver;
-};
-type ResolvedQueuePlan = {
-    readonly queued: boolean;
-    readonly connection?: string;
-    readonly queue?: string;
-    readonly delay?: MailDelayValue;
-    readonly afterCommit: boolean;
-};
-type QueueDispatchChain = {
-    onConnection(name: string): QueueDispatchChain;
-    onQueue(name: string): QueueDispatchChain;
-    delay(value: number | Date): QueueDispatchChain;
-    dispatch(): Promise<unknown>;
-};
-type QueueModule = {
-    defineJob(definition: {
-        handle(payload: QueuedMailDeliveryPayload): Promise<unknown> | unknown;
-    }): unknown;
-    dispatch(jobName: string, payload: QueuedMailDeliveryPayload): QueueDispatchChain;
-    getRegisteredQueueJob(name: string): unknown;
-    registerQueueJob(definition: unknown, options: {
-        name: string;
-    }): void;
-};
-type DbModule = {
-    connectionAsyncContext: {
-        getActive(): {
-            connection: {
-                getScope(): {
-                    kind: string;
-                };
-                afterCommit(callback: () => Promise<void>): void;
-            };
-        } | undefined;
-    };
-};
-type NodemailerAddress = {
-    readonly address: string;
-    readonly name?: string;
-};
-type NodemailerAttachment = {
-    readonly filename: string;
-    readonly contentType?: string;
-    readonly contentDisposition?: string;
-    readonly cid?: string;
-    readonly path?: string;
-    readonly content?: string | Uint8Array;
-};
-type NodemailerMailMessage = {
-    readonly messageId: string;
-    readonly from: NodemailerAddress;
-    readonly replyTo: NodemailerAddress;
-    readonly to: readonly NodemailerAddress[];
-    readonly cc?: readonly NodemailerAddress[];
-    readonly bcc?: readonly NodemailerAddress[];
-    readonly subject: string;
-    readonly html?: string;
-    readonly text?: string;
-    readonly attachments?: readonly NodemailerAttachment[];
-    readonly headers?: Readonly<Record<string, string>>;
-};
-type NodemailerSendResult = {
-    readonly messageId?: string;
-    readonly response?: string;
-};
-type NodemailerTransport = {
-    sendMail(message: NodemailerMailMessage): Promise<NodemailerSendResult>;
-};
-type NodemailerModule = {
-    createTransport(options: Record<string, unknown>): NodemailerTransport;
-};
-type StorageDisk = {
-    readonly driver: string;
-    path(path: string): string;
-    getBytes(path: string): Promise<Uint8Array | null>;
-};
-type StorageModule = {
-    Storage: {
-        disk(diskName?: string): StorageDisk;
-    };
-};
-type SerializedQueuedAttachment = Readonly<{
-    readonly source: ResolvedMailAttachment['source'];
-    readonly name: string;
-    readonly contentType?: string;
-    readonly disposition: ResolvedMailAttachment['disposition'];
-    readonly contentId?: string;
-    readonly path?: string;
-    readonly storage?: {
-        readonly path: string;
-        readonly disk?: string;
-    };
-    readonly content?: string | Readonly<{
-        readonly encoding: 'base64';
-        readonly value: string;
-    }>;
-}>;
-type QueuedResolvedMailPayload = Readonly<Omit<ResolvedMail, 'attachments'> & {
-    readonly attachments: readonly SerializedQueuedAttachment[];
-}>;
-type QueuedMailDeliveryPayload = Readonly<{
-    readonly messageId: string;
-    readonly mailer: string;
-    readonly driver: string;
-    readonly queued: true;
-    readonly deferred?: boolean;
-    readonly mail: QueuedResolvedMailPayload;
-}>;
 interface FakeSentMail {
     readonly messageId: string;
     readonly createdAt: Date;
@@ -195,80 +39,6 @@ declare class MailSendError extends MailError {
         readonly message?: string;
     }, options?: ErrorOptions);
 }
-declare function getRuntimeState(): RuntimeState;
-declare function getRuntimeBindings(): MailRuntimeBindings;
-declare function dynamicImport<TModule>(specifier: string): Promise<TModule>;
-declare function loadQueueModule(): Promise<QueueModule>;
-declare function loadDbModule(): Promise<DbModule | null>;
-declare function resolveNodemailerModule(module: unknown): NodemailerModule;
-declare function loadNodemailerModule(): Promise<NodemailerModule>;
-declare function resolveStorageModule(module: unknown): StorageModule;
-declare function loadStorageModule(): Promise<StorageModule>;
-declare function getFakeSentState(): FakeSentMail[];
-declare function getPreviewArtifactState(): MailPreviewArtifact[];
-declare function normalizeExecutionString(value: string, label: string): string;
-declare function normalizeExecutionDelay(value: MailDelayValue): MailDelayValue;
-declare function getResolvedConfig(): NormalizedHoloMailConfig;
-declare function resolveCurrentEnvironment(): HoloAppEnv;
-declare function createPreviewPolicy(config?: NormalizedHoloMailConfig): MailPreviewPolicy;
-declare function assertPreviewEnabled(config?: NormalizedHoloMailConfig): void;
-declare function createPreviewHtml(preview: MailPreviewResult): string;
-declare function escapeHtml(value: string): string;
-declare function formatAddress(address: {
-    readonly email: string;
-    readonly name?: string;
-}): string;
-declare function renderPreviewResponse(preview: MailPreviewResult, format: MailPreviewFormat): Response;
-declare function getMailerConfig(mailer: string, config?: NormalizedHoloMailConfig): _holo_js_config.NormalizedHoloMailMailerConfig;
-declare function isQueueRequested(mail: MailDefinition, mailer: string, options: MutableSendOptions | Readonly<MutableSendOptions>, config?: NormalizedHoloMailConfig): boolean;
-declare function resolveQueuePlan(mail: MailDefinition, options: MutableSendOptions | Readonly<MutableSendOptions>, mailer: string, config?: NormalizedHoloMailConfig): ResolvedQueuePlan;
-declare function prepareMailSend(mail: MailDefinition, queued: boolean): Promise<SendPreparation>;
-declare function createResolvedMail(preview: MailPreviewResult, attachments: readonly ResolvedMailAttachment[]): ResolvedMail;
-declare function createSendContext(messageId: string, resolvedDriver: ResolvedDriver, queued: boolean, deferred?: boolean): MailDriverExecutionContext;
-declare function freezeSendResult(result: MailSendResult): Readonly<MailSendResult>;
-declare function createBaseSendResult(context: MailDriverExecutionContext, overrides?: Partial<MailSendResult>): Readonly<MailSendResult>;
-declare function normalizeDriverResult(result: MailSendResult | undefined, context: MailDriverExecutionContext): Readonly<MailSendResult>;
-declare function createMailRecord<TRecord extends FakeSentMail | MailPreviewArtifact>(context: MailDriverExecutionContext, mail: Readonly<ResolvedMail>, result: Readonly<MailSendResult>): TRecord;
-declare function persistPreviewArtifact(artifact: MailPreviewArtifact): Promise<void>;
-declare function createSmtpAddress(address: MailAddress): NodemailerAddress;
-declare function createSmtpHeaders(mail: Readonly<ResolvedMail>): Readonly<Record<string, string>> | undefined;
-declare function createSmtpAttachment(attachment: ResolvedMailAttachment): Promise<NodemailerAttachment>;
-declare function createSmtpMessage(mail: Readonly<ResolvedMail>, context: Readonly<MailDriverExecutionContext>): Promise<NodemailerMailMessage>;
-declare function sendViaSmtp(mail: Readonly<ResolvedMail>, context: Readonly<MailDriverExecutionContext>): Promise<Readonly<MailSendResult>>;
-declare function resolveDriver(mail: MailDefinition, options: MutableSendOptions | Readonly<MutableSendOptions>, config: NormalizedHoloMailConfig): ResolvedDriver;
-declare function resolveDriverByName(mailer: string, driver: string): ResolvedDriver;
-declare function serializeQueuedAttachment(attachment: ResolvedMailAttachment): SerializedQueuedAttachment;
-declare function deserializeQueuedAttachment(attachment: SerializedQueuedAttachment): ResolvedMailAttachment;
-declare function createQueuedMailPayload(mail: ResolvedMail, context: MailDriverExecutionContext): QueuedMailDeliveryPayload;
-declare function createResolvedMailFromQueuedPayload(payload: QueuedMailDeliveryPayload): ResolvedMail;
-declare function deliverResolvedMail(mail: ResolvedMail, resolvedDriver: ResolvedDriver, context: MailDriverExecutionContext): Promise<Readonly<MailSendResult>>;
-declare function runQueuedMailDelivery(payload: QueuedMailDeliveryPayload): Promise<Readonly<MailSendResult>>;
-declare function ensureMailQueueJobRegistered(queueModule?: QueueModule): Promise<QueueModule>;
-declare function dispatchQueuedMail(mail: ResolvedMail, context: MailDriverExecutionContext, plan: ResolvedQueuePlan): Promise<Readonly<MailSendResult>>;
-declare function deferSendUntilCommit(context: MailDriverExecutionContext, callback: () => Promise<Readonly<MailSendResult>>): Promise<Readonly<MailSendResult> | null>;
-declare function renderView(input: MailViewRenderInput): Promise<string>;
-declare function stripMarkdownSyntax(markdown: string): string;
-declare function renderMarkdownInline(markdown: string): string;
-declare function renderMarkdown(markdown: string): string;
-declare function resolveSourceKind(mail: MailDefinition): RenderedContent['kind'];
-declare function resolveMailerName(mail: MailDefinition, config: NormalizedHoloMailConfig): string;
-declare function resolveEnvelope(mail: MailDefinition): ResolvedEnvelope;
-declare function createMarkdownWrapperProps(mail: MailDefinition, envelope: ResolvedEnvelope, html: string, text: string): MailJsonObject;
-declare function renderContent(mail: MailDefinition, envelope: ResolvedEnvelope): Promise<RenderedContent>;
-declare function computePreview(mail: MailDefinition): Promise<PreviewComputation>;
-declare class PendingSend implements PendingMailSend<MailSendResult> {
-    #private;
-    constructor(mail: MailDefinition, options?: MutableSendOptions);
-    using(name: string): PendingSend;
-    onConnection(name: string): PendingSend;
-    onQueue(name: string): PendingSend;
-    delay(value: MailDelayValue): PendingSend;
-    afterCommit(): PendingSend;
-    then<TResult1 = MailSendResult, TResult2 = never>(onfulfilled?: ((value: MailSendResult) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
-    catch<TResult1 = never>(onrejected?: ((reason: unknown) => TResult1 | PromiseLike<TResult1>) | null): Promise<MailSendResult | TResult1>;
-    finally(onfinally?: (() => void) | null): Promise<MailSendResult>;
-    private execute;
-}
 interface MailRuntimeFacade {
     sendMail(mail: MailDefinition | MailDefinitionInput, overrides?: MailOverrideInput): PendingMailSend<MailSendResult>;
     previewMail(mail: MailDefinition | MailDefinitionInput, overrides?: MailOverrideInput): Promise<MailPreviewResult>;
@@ -278,7 +48,6 @@ declare function listFakeSentMails(): readonly FakeSentMail[];
 declare function resetFakeSentMails(): void;
 declare function listPreviewMailArtifacts(): readonly MailPreviewArtifact[];
 declare function resetPreviewMailArtifacts(): void;
-declare function resolveMailInput(mail: MailDefinition | MailDefinitionInput, overrides?: MailOverrideInput): MailDefinition;
 declare function configureMailRuntime(bindings?: MailRuntimeBindings): void;
 declare function getMailRuntimeBindings(): MailRuntimeBindings;
 declare function resetMailRuntime(): void;
@@ -286,78 +55,6 @@ declare function sendMail(mail: MailDefinition | MailDefinitionInput, overrides?
 declare function previewMail(mail: MailDefinition | MailDefinitionInput, overrides?: MailOverrideInput): Promise<MailPreviewResult>;
 declare function renderMailPreview(mail: MailDefinition | MailDefinitionInput, overrides?: MailOverrideInput, format?: MailPreviewFormat): Promise<Response>;
 declare function getMailRuntime(): MailRuntimeFacade;
-declare const mailRuntimeInternals: {
-    HOLO_MAIL_DELIVER_JOB: string;
-    MailSendError: typeof MailSendError;
-    MailError: typeof MailError;
-    MailPreviewDisabledError: typeof MailPreviewDisabledError;
-    MailPreviewFormatUnavailableError: typeof MailPreviewFormatUnavailableError;
-    PendingSend: typeof PendingSend;
-    assertPreviewEnabled: typeof assertPreviewEnabled;
-    builtInDrivers: Readonly<Record<string, MailDriver<MailSendResult>>>;
-    createBaseSendResult: typeof createBaseSendResult;
-    createMailRecord: typeof createMailRecord;
-    createQueuedMailPayload: typeof createQueuedMailPayload;
-    createResolvedMail: typeof createResolvedMail;
-    createSmtpAddress: typeof createSmtpAddress;
-    createSmtpAttachment: typeof createSmtpAttachment;
-    createSmtpHeaders: typeof createSmtpHeaders;
-    createSmtpMessage: typeof createSmtpMessage;
-    createSendContext: typeof createSendContext;
-    createResolvedMailFromQueuedPayload: typeof createResolvedMailFromQueuedPayload;
-    computePreview: typeof computePreview;
-    createMarkdownWrapperProps: typeof createMarkdownWrapperProps;
-    createPreviewHtml: typeof createPreviewHtml;
-    createPreviewPolicy: typeof createPreviewPolicy;
-    deferSendUntilCommit: typeof deferSendUntilCommit;
-    deliverResolvedMail: typeof deliverResolvedMail;
-    deserializeQueuedAttachment: typeof deserializeQueuedAttachment;
-    dispatchQueuedMail: typeof dispatchQueuedMail;
-    dynamicImport: typeof dynamicImport;
-    ensureMailQueueJobRegistered: typeof ensureMailQueueJobRegistered;
-    escapeHtml: typeof escapeHtml;
-    formatAddress: typeof formatAddress;
-    freezeSendResult: typeof freezeSendResult;
-    getFakeSentState: typeof getFakeSentState;
-    getMailerConfig: typeof getMailerConfig;
-    getPreviewArtifactState: typeof getPreviewArtifactState;
-    getResolvedConfig: typeof getResolvedConfig;
-    getRuntimeBindings: typeof getRuntimeBindings;
-    getRuntimeState: typeof getRuntimeState;
-    loadDbModule: typeof loadDbModule;
-    loadNodemailerModule: typeof loadNodemailerModule;
-    loadQueueModule: typeof loadQueueModule;
-    loadStorageModule: typeof loadStorageModule;
-    isQueueRequested: typeof isQueueRequested;
-    normalizeExecutionDelay: typeof normalizeExecutionDelay;
-    normalizeExecutionString: typeof normalizeExecutionString;
-    normalizeDriverResult: typeof normalizeDriverResult;
-    persistPreviewArtifact: typeof persistPreviewArtifact;
-    prepareMailSend: typeof prepareMailSend;
-    renderContent: typeof renderContent;
-    renderMarkdown: typeof renderMarkdown;
-    renderMarkdownInline: typeof renderMarkdownInline;
-    renderPreviewResponse: typeof renderPreviewResponse;
-    renderView: typeof renderView;
-    resolveDriver: typeof resolveDriver;
-    resolveDriverByName: typeof resolveDriverByName;
-    resolveCurrentEnvironment: typeof resolveCurrentEnvironment;
-    resolveEnvelope: typeof resolveEnvelope;
-    resolveQueuePlan: typeof resolveQueuePlan;
-    resolveMailInput: typeof resolveMailInput;
-    resolveMailerName: typeof resolveMailerName;
-    resolveNodemailerModule: typeof resolveNodemailerModule;
-    resolveSourceKind: typeof resolveSourceKind;
-    resolveStorageModule: typeof resolveStorageModule;
-    runQueuedMailDelivery: typeof runQueuedMailDelivery;
-    sendViaSmtp: typeof sendViaSmtp;
-    serializeQueuedAttachment: typeof serializeQueuedAttachment;
-    setDbModuleLoader(loader: (() => Promise<DbModule | null>) | undefined): void;
-    setNodemailerModuleLoader(loader: (() => Promise<NodemailerModule>) | undefined): void;
-    setQueueModuleLoader(loader: (() => Promise<QueueModule>) | undefined): void;
-    setStorageModuleLoader(loader: (() => Promise<StorageModule>) | undefined): void;
-    stripMarkdownSyntax: typeof stripMarkdownSyntax;
-};
 
 declare function normalizeDriverName(value: string): string;
 declare function getRegistry(): Map<string, RegisteredMailDriver>;
@@ -376,4 +73,4 @@ declare const mail: Readonly<{
     sendMail: typeof sendMail;
 }>;
 
-export { type FakeSentMail, MailAddress, MailDefinition, MailDefinitionInput, MailDelayValue, MailDriver, MailDriverExecutionContext, MailError, MailJsonObject, MailOverrideInput, type MailPreviewArtifact, MailPreviewDisabledError, MailPreviewFormat, MailPreviewFormatUnavailableError, MailPreviewPolicy, MailPreviewResult, MailRenderSource, MailRuntimeBindings, MailSendError, MailSendResult, MailViewRenderInput, PendingMailSend, RegisterMailDriverOptions, RegisteredMailDriver, ResolvedMail, ResolvedMailAttachment, configureMailRuntime, mail as default, getMailRuntime, getMailRuntimeBindings, getRegisteredMailDriver, listFakeSentMails, listPreviewMailArtifacts, listRegisteredMailDrivers, mailRegistryInternals, mailRuntimeInternals, previewMail, registerMailDriver, renderMailPreview, resetFakeSentMails, resetMailDriverRegistry, resetMailRuntime, resetPreviewMailArtifacts, sendMail };
+export { type FakeSentMail, MailDefinition, MailDefinitionInput, MailDriver, MailDriverExecutionContext, MailError, MailOverrideInput, type MailPreviewArtifact, MailPreviewDisabledError, MailPreviewFormat, MailPreviewFormatUnavailableError, MailPreviewPolicy, MailPreviewResult, MailRuntimeBindings, MailSendError, MailSendResult, PendingMailSend, RegisterMailDriverOptions, RegisteredMailDriver, ResolvedMail, configureMailRuntime, mail as default, getMailRuntime, getMailRuntimeBindings, getRegisteredMailDriver, listFakeSentMails, listPreviewMailArtifacts, listRegisteredMailDrivers, mailRegistryInternals, previewMail, registerMailDriver, renderMailPreview, resetFakeSentMails, resetMailDriverRegistry, resetMailRuntime, resetPreviewMailArtifacts, sendMail };

package/dist/index.mjs

@@ -9,17 +9,17 @@ import {
   inferMimeTypeFromName,
   isAttachmentQueueSafe,
   isMailDefinition,
-  mailInternals,
   mergeMailDefinitionInputs,
   normalizeMailDefinition,
   resolveAttachmentDefinition,
   resolveNormalizedAttachment
-} from "./chunk-UB6ANQ2F.mjs";
+} from "./chunk-BQCGZOVF.mjs";
 
 // src/runtime.ts
 import { randomUUID } from "crypto";
-import { mkdir, writeFile } from "fs/promises";
-import { join } from "path";
+import { mkdir, realpath, writeFile } from "fs/promises";
+import { tmpdir } from "os";
+import { join, resolve, sep } from "path";
 import {
   holoMailDefaults,
   normalizeAppEnv
@@ -68,6 +68,10 @@ var mailRegistryInternals = {
 
 // src/runtime.ts
 var HOLO_MAIL_DELIVER_JOB = "holo.mail.deliver";
+var LOCAL_ATTACHMENT_ROOTS = Object.freeze([
+  tmpdir(),
+  resolve(process.cwd(), "storage")
+]);
 var MailError = class extends Error {
   code;
   constructor(message, code = "MAIL_ERROR", options) {
@@ -128,53 +132,40 @@ function dynamicImport(specifier) {
     specifier
   );
 }
-async function loadQueueModule() {
-  const override = getRuntimeState().loadQueueModule;
-  if (override) {
-    try {
-      return await override();
-    } catch (error) {
-      if (error && typeof error === "object" && "code" in error && error.code === "ERR_MODULE_NOT_FOUND") {
-        throw new MailError(
-          "[@holo-js/mail] Queued or delayed mail delivery requires @holo-js/queue to be installed.",
-          "MAIL_QUEUE_MODULE_MISSING"
-        );
-      }
-      throw error;
-    }
-  }
+function isModuleNotFoundError(error) {
+  return !!(error && typeof error === "object" && "code" in error && error.code === "ERR_MODULE_NOT_FOUND");
+}
+async function loadPeerModule(options) {
   try {
-    return await dynamicImport("@holo-js/queue");
+    const module = options.loadOverride ? await options.loadOverride() : await dynamicImport(options.specifier);
+    return options.resolve ? options.resolve(module) : module;
   } catch (error) {
-    if (error && typeof error === "object" && "code" in error && error.code === "ERR_MODULE_NOT_FOUND") {
+    if (isModuleNotFoundError(error)) {
+      return options.missing(error);
+    }
+    throw error;
+  }
+}
+async function loadQueueModule() {
+  return loadPeerModule({
+    loadOverride: getRuntimeState().loadQueueModule,
+    specifier: "@holo-js/queue",
+    missing() {
       throw new MailError(
         "[@holo-js/mail] Queued or delayed mail delivery requires @holo-js/queue to be installed.",
         "MAIL_QUEUE_MODULE_MISSING"
       );
     }
-    throw error;
-  }
+  });
 }
 async function loadDbModule() {
-  const override = getRuntimeState().loadDbModule;
-  if (override) {
-    try {
-      return await override();
-    } catch (error) {
-      if (error && typeof error === "object" && "code" in error && error.code === "ERR_MODULE_NOT_FOUND") {
-        return null;
-      }
-      throw error;
-    }
-  }
-  try {
-    return await dynamicImport("@holo-js/db");
-  } catch (error) {
-    if (error && typeof error === "object" && "code" in error && error.code === "ERR_MODULE_NOT_FOUND") {
+  return loadPeerModule({
+    loadOverride: getRuntimeState().loadDbModule,
+    specifier: "@holo-js/db",
+    missing() {
       return null;
     }
-    throw error;
-  }
+  });
 }
 function resolveNodemailerModule(module) {
   if (module && typeof module === "object" && "createTransport" in module && typeof module.createTransport === "function") {
@@ -189,33 +180,18 @@ function resolveNodemailerModule(module) {
   );
 }
 async function loadNodemailerModule() {
-  const override = getRuntimeState().loadNodemailerModule;
-  if (override) {
-    try {
-      return resolveNodemailerModule(await override());
-    } catch (error) {
-      if (error && typeof error === "object" && "code" in error && error.code === "ERR_MODULE_NOT_FOUND") {
-        throw new MailError(
-          "[@holo-js/mail] SMTP delivery requires nodemailer to be installed.",
-          "MAIL_SMTP_MODULE_MISSING",
-          { cause: error }
-        );
-      }
-      throw error;
-    }
-  }
-  try {
-    return resolveNodemailerModule(await dynamicImport("nodemailer"));
-  } catch (error) {
-    if (error && typeof error === "object" && "code" in error && error.code === "ERR_MODULE_NOT_FOUND") {
+  return loadPeerModule({
+    loadOverride: getRuntimeState().loadNodemailerModule,
+    specifier: "nodemailer",
+    resolve: resolveNodemailerModule,
+    missing(error) {
       throw new MailError(
         "[@holo-js/mail] SMTP delivery requires nodemailer to be installed.",
         "MAIL_SMTP_MODULE_MISSING",
         { cause: error }
       );
     }
-    throw error;
-  }
+  });
 }
 function resolveStorageModule(module) {
   if (module && typeof module === "object" && "Storage" in module && module.Storage && typeof module.Storage?.disk === "function") {
@@ -227,33 +203,18 @@ function resolveStorageModule(module) {
   );
 }
 async function loadStorageModule() {
-  const override = getRuntimeState().loadStorageModule;
-  if (override) {
-    try {
-      return resolveStorageModule(await override());
-    } catch (error) {
-      if (error && typeof error === "object" && "code" in error && error.code === "ERR_MODULE_NOT_FOUND") {
-        throw new MailError(
-          "[@holo-js/mail] Storage-backed attachments require @holo-js/storage to be installed.",
-          "MAIL_STORAGE_MODULE_MISSING",
-          { cause: error }
-        );
-      }
-      throw error;
-    }
-  }
-  try {
-    return resolveStorageModule(await dynamicImport("@holo-js/storage"));
-  } catch (error) {
-    if (error && typeof error === "object" && "code" in error && error.code === "ERR_MODULE_NOT_FOUND") {
+  return loadPeerModule({
+    loadOverride: getRuntimeState().loadStorageModule,
+    specifier: "@holo-js/storage",
+    resolve: resolveStorageModule,
+    missing(error) {
       throw new MailError(
         "[@holo-js/mail] Storage-backed attachments require @holo-js/storage to be installed.",
         "MAIL_STORAGE_MODULE_MISSING",
         { cause: error }
       );
     }
-    throw error;
-  }
+  });
 }
 function getFakeSentState() {
   const state = getRuntimeState();
@@ -311,7 +272,7 @@ function createPreviewHtml(preview) {
     preview.cc.length > 0 ? `<p><strong>Cc:</strong> ${preview.cc.map(formatAddress).join(", ")}</p>` : "",
     preview.bcc.length > 0 ? `<p><strong>Bcc:</strong> ${preview.bcc.map(formatAddress).join(", ")}</p>` : ""
   ].filter(Boolean).join("");
-  const body = preview.html ? preview.html : preview.text ? `<pre>${escapeHtml(preview.text)}</pre>` : "<p>No rendered content is available.</p>";
+  const body = preview.html ? `<pre>${escapeHtml(preview.html)}</pre>` : preview.text ? `<pre>${escapeHtml(preview.text)}</pre>` : "<p>No rendered content is available.</p>";
   return `<!doctype html><html><head><meta charset="utf-8"><title>${escapeHtml(preview.subject)}</title></head><body>${header}${body}</body></html>`;
 }
 function escapeHtml(value) {
@@ -483,10 +444,10 @@ async function persistPreviewArtifact(artifact) {
   );
 }
 function createSmtpAddress(address) {
-  return Object.freeze({
+  return {
     address: address.email,
     ...typeof address.name === "string" ? { name: address.name } : {}
-  });
+  };
 }
 function createSmtpHeaders(mail2) {
   const headers = { ...mail2.headers };
@@ -519,19 +480,19 @@ async function createSmtpAttachment(attachment) {
     ...typeof attachment.contentId === "string" ? { cid: attachment.contentId } : {}
   };
   if (typeof attachment.path === "string") {
-    return Object.freeze({
+    return {
       ...base,
-      path: attachment.path
-    });
+      path: await resolveLocalAttachmentPath(attachment.path)
+    };
   }
   if (attachment.storage) {
     const storageModule = await loadStorageModule();
     const disk = storageModule.Storage.disk(attachment.storage.disk);
     if (disk.driver !== "s3") {
-      return Object.freeze({
+      return {
         ...base,
         path: disk.path(attachment.storage.path)
-      });
+      };
     }
     const bytes = await disk.getBytes(attachment.storage.path);
     if (!bytes) {
@@ -540,16 +501,16 @@ async function createSmtpAttachment(attachment) {
         "MAIL_STORAGE_ATTACHMENT_MISSING"
       );
     }
-    return Object.freeze({
+    return {
       ...base,
       content: bytes
-    });
+    };
   }
   if (typeof attachment.content !== "undefined") {
-    return Object.freeze({
+    return {
       ...base,
       content: attachment.content
-    });
+    };
   }
   throw new MailError(
     `[@holo-js/mail] Attachment "${attachment.name}" could not be translated for SMTP delivery.`,
@@ -557,21 +518,21 @@ async function createSmtpAttachment(attachment) {
   );
 }
 async function createSmtpMessage(mail2, context) {
-  const attachments = mail2.attachments.length > 0 ? Object.freeze(await Promise.all(mail2.attachments.map(createSmtpAttachment))) : void 0;
+  const attachments = mail2.attachments.length > 0 ? await Promise.all(mail2.attachments.map(createSmtpAttachment)) : void 0;
   const headers = createSmtpHeaders(mail2);
-  return Object.freeze({
+  return {
     messageId: context.messageId,
     from: createSmtpAddress(mail2.from),
     replyTo: createSmtpAddress(mail2.replyTo),
-    to: Object.freeze(mail2.to.map(createSmtpAddress)),
-    ...mail2.cc.length > 0 ? { cc: Object.freeze(mail2.cc.map(createSmtpAddress)) } : {},
-    ...mail2.bcc.length > 0 ? { bcc: Object.freeze(mail2.bcc.map(createSmtpAddress)) } : {},
+    to: mail2.to.map(createSmtpAddress),
+    ...mail2.cc.length > 0 ? { cc: mail2.cc.map(createSmtpAddress) } : {},
+    ...mail2.bcc.length > 0 ? { bcc: mail2.bcc.map(createSmtpAddress) } : {},
     subject: mail2.subject,
     ...typeof mail2.html === "string" ? { html: mail2.html } : {},
     ...typeof mail2.text === "string" ? { text: mail2.text } : {},
     ...attachments ? { attachments } : {},
     ...headers ? { headers } : {}
-  });
+  };
 }
 async function sendViaSmtp(mail2, context) {
   const nodemailer = await loadNodemailerModule();
@@ -860,7 +821,29 @@ function stripMarkdownSyntax(markdown) {
   return markdown.replace(/\[([^\]]+)\]\(([^)]+)\)/g, "$1 ($2)").replace(/`([^`]+)`/g, "$1").replace(/\*\*([^*]+)\*\*/g, "$1").replace(/\*([^*]+)\*/g, "$1").replace(/^#{1,6}\s+/gm, "").replace(/^[-*]\s+/gm, "").trim();
 }
 function renderMarkdownInline(markdown) {
-  return escapeHtml(markdown).replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<a href="$2">$1</a>').replace(/`([^`]+)`/g, "<code>$1</code>").replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>").replace(/\*([^*]+)\*/g, "<em>$1</em>");
+  return escapeHtml(markdown).replace(/\[([^\]]+)\]\(([^)]+)\)/g, (_match, label, href) => {
+    return isSafeMailHref(href) ? `<a href="${escapeHtml(href)}">${label}</a>` : label;
+  }).replace(/`([^`]+)`/g, "<code>$1</code>").replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>").replace(/\*([^*]+)\*/g, "<em>$1</em>");
+}
+async function resolveLocalAttachmentPath(path) {
+  const resolvedPath = await realpath(path);
+  const allowedRoots = await Promise.all(LOCAL_ATTACHMENT_ROOTS.map(async (root) => await realpath(root).catch(() => null)));
+  if (allowedRoots.some((root) => root && (resolvedPath === root || resolvedPath.startsWith(`${root}${sep}`)))) {
+    return resolvedPath;
+  }
+  throw new MailError("[@holo-js/mail] Path attachments must resolve inside an allowed attachment directory.", "MAIL_ATTACHMENT_UNSAFE_PATH");
+}
+function isSafeMailHref(href) {
+  const trimmed = href.trim();
+  if (trimmed.startsWith("#") || trimmed.startsWith("/") || trimmed.startsWith("./") || trimmed.startsWith("../")) {
+    return true;
+  }
+  try {
+    const url = new URL(trimmed);
+    return url.protocol === "https:" || url.protocol === "http:" || url.protocol === "mailto:";
+  } catch {
+    return false;
+  }
 }
 function renderMarkdown(markdown) {
   const blocks = markdown.trim().split(/\n\s*\n/g).map((block) => block.trim()).filter(Boolean);
@@ -881,18 +864,6 @@ function renderMarkdown(markdown) {
     return `<p>${lines.map(renderMarkdownInline).join("<br />")}</p>`;
   }).join("\n");
 }
-function resolveSourceKind(mail2) {
-  if (mail2.render) {
-    return "render";
-  }
-  if (typeof mail2.markdown === "string") {
-    return "markdown";
-  }
-  if (typeof mail2.html === "string") {
-    return "html";
-  }
-  return "text";
-}
 function resolveMailerName(mail2, config) {
   return mail2.mailer ?? config.default;
 }
@@ -1190,86 +1161,6 @@ function getMailRuntime() {
     renderMailPreview
   });
 }
-var mailRuntimeInternals = {
-  HOLO_MAIL_DELIVER_JOB,
-  MailSendError,
-  MailError,
-  MailPreviewDisabledError,
-  MailPreviewFormatUnavailableError,
-  PendingSend,
-  assertPreviewEnabled,
-  builtInDrivers,
-  createBaseSendResult,
-  createMailRecord,
-  createQueuedMailPayload,
-  createResolvedMail,
-  createSmtpAddress,
-  createSmtpAttachment,
-  createSmtpHeaders,
-  createSmtpMessage,
-  createSendContext,
-  createResolvedMailFromQueuedPayload,
-  computePreview,
-  createMarkdownWrapperProps,
-  createPreviewHtml,
-  createPreviewPolicy,
-  deferSendUntilCommit,
-  deliverResolvedMail,
-  deserializeQueuedAttachment,
-  dispatchQueuedMail,
-  dynamicImport,
-  ensureMailQueueJobRegistered,
-  escapeHtml,
-  formatAddress,
-  freezeSendResult,
-  getFakeSentState,
-  getMailerConfig,
-  getPreviewArtifactState,
-  getResolvedConfig,
-  getRuntimeBindings,
-  getRuntimeState,
-  loadDbModule,
-  loadNodemailerModule,
-  loadQueueModule,
-  loadStorageModule,
-  isQueueRequested,
-  normalizeExecutionDelay,
-  normalizeExecutionString,
-  normalizeDriverResult,
-  persistPreviewArtifact,
-  prepareMailSend,
-  renderContent,
-  renderMarkdown,
-  renderMarkdownInline,
-  renderPreviewResponse,
-  renderView,
-  resolveDriver,
-  resolveDriverByName,
-  resolveCurrentEnvironment,
-  resolveEnvelope,
-  resolveQueuePlan,
-  resolveMailInput,
-  resolveMailerName,
-  resolveNodemailerModule,
-  resolveSourceKind,
-  resolveStorageModule,
-  runQueuedMailDelivery,
-  sendViaSmtp,
-  serializeQueuedAttachment,
-  setDbModuleLoader(loader) {
-    getRuntimeState().loadDbModule = loader;
-  },
-  setNodemailerModuleLoader(loader) {
-    getRuntimeState().loadNodemailerModule = loader;
-  },
-  setQueueModuleLoader(loader) {
-    getRuntimeState().loadQueueModule = loader;
-  },
-  setStorageModuleLoader(loader) {
-    getRuntimeState().loadStorageModule = loader;
-  },
-  stripMarkdownSyntax
-};
 
 // src/index.ts
 import { defineMailConfig } from "@holo-js/config";
@@ -1303,9 +1194,7 @@ export {
   listFakeSentMails,
   listPreviewMailArtifacts,
   listRegisteredMailDrivers,
-  mailInternals,
   mailRegistryInternals,
-  mailRuntimeInternals,
   mergeMailDefinitionInputs,
   normalizeMailDefinition,
   previewMail,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holo-js/mail",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Holo-JS Framework - mail contracts, preview helpers, and fluent send helpers",
   "type": "module",
   "license": "MIT",
@@ -28,12 +28,12 @@
     "test": "vitest --run"
   },
   "dependencies": {
-    "@holo-js/config": "^0.1.4",
+    "@holo-js/config": "^0.1.6",
     "nodemailer": "^6.10.1"
   },
   "peerDependencies": {
-    "@holo-js/queue": "^0.1.4",
-    "@holo-js/storage": "^0.1.4"
+    "@holo-js/queue": "^0.1.6",
+    "@holo-js/storage": "^0.1.6"
   },
   "peerDependenciesMeta": {
     "@holo-js/queue": {
@@ -47,6 +47,6 @@
     "@types/node": "^22.10.2",
     "tsup": "^8.3.5",
     "typescript": "^5.7.2",
-    "vitest": "^2.1.8"
+    "vitest": "^4.1.5"
   }
 }