@core-tecnologias-empresariales/core-mail 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -2,4 +2,4 @@ export { createMailer, MailDeliveryError } from "./mailer.js";
 export type { Mailer } from "./mailer.js";
 export { createSmtpTransport } from "./smtp-transport.js";
 export type { SmtpConfig } from "./smtp-transport.js";
-export type { MailMessage, MailTransport } from "./transport.js";
+export type { MailAttachment, MailMessage, MailTransport } from "./transport.js";

package/dist/mailer.test.js

@@ -32,4 +32,33 @@ test("throws MailDeliveryError listing every attempted transport when all fail",
 test("createMailer requires at least one transport", () => {
     assert.throws(() => createMailer([]));
 });
+/** Los adjuntos tienen que llegar INTACTOS al transporte (2026-09-12). Nace de un caso real: el
+ * documento tributario que CorePyme le manda al cliente en PDF. Un adjunto que se pierda o llegue
+ * corrompido no da error — el correo sale igual, sin el archivo — así que el test compara el
+ * contenido byte a byte y no sólo que la propiedad exista. */
+test("los adjuntos llegan al transporte con su contenido intacto", async () => {
+    let recibido;
+    const transporteEspia = {
+        name: "espia",
+        async send(m) {
+            recibido = m;
+        },
+    };
+    const pdf = Buffer.from("%PDF-1.4 contenido binario con bytes altos: \xff\xfe", "binary");
+    await createMailer([transporteEspia]).send({
+        ...message,
+        attachments: [{ filename: "boleta-39-1847.pdf", content: pdf, contentType: "application/pdf" }],
+    });
+    assert.equal(recibido?.attachments?.length, 1);
+    assert.equal(recibido?.attachments?.[0]?.filename, "boleta-39-1847.pdf");
+    assert.equal(recibido?.attachments?.[0]?.contentType, "application/pdf");
+    assert.ok(Buffer.isBuffer(recibido?.attachments?.[0]?.content), "el contenido debe seguir siendo un Buffer");
+    assert.deepEqual(recibido?.attachments?.[0]?.content, pdf, "el contenido no puede alterarse en el camino");
+});
+test("un mensaje sin adjuntos sigue funcionando igual que antes", async () => {
+    let recibido;
+    const transporteEspia = { name: "espia", async send(m) { recibido = m; } };
+    await createMailer([transporteEspia]).send(message);
+    assert.equal(recibido?.attachments, undefined);
+});
 //# sourceMappingURL=mailer.test.js.map

package/dist/mailer.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"mailer.test.js","sourceRoot":"","sources":["../src/mailer.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAG9D,SAAS,aAAa,CAAC,IAAY,EAAE,QAAuB;IAC1D,OAAO;QACL,IAAI;QACJ,KAAK,CAAC,IAAI;YACR,IAAI,QAAQ,KAAK,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,CAAC;QAC3D,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,GAAgB,EAAE,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAEnG,IAAI,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;IACvD,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAChG,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AAC5C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;IACvE,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAClG,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AAC9C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,0EAA0E,EAAE,KAAK,IAAI,EAAE;IAC1F,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,aAAa,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACpG,MAAM,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAc,EAAE,EAAE;QAClE,MAAM,CAAC,EAAE,CAAC,KAAK,YAAY,iBAAiB,CAAC,CAAC;QAC9C,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,mBAAmB,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;QACtE,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,8CAA8C,EAAE,GAAG,EAAE;IACxD,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC;AACxC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"mailer.test.js","sourceRoot":"","sources":["../src/mailer.test.ts"],"names":[],"mappings":"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"}

package/dist/transport.d.ts

@@ -1,3 +1,29 @@
+/**
+ * Un archivo adjunto del correo (2026-09-12).
+ *
+ * Nace de un caso real: CorePyme tiene que mandarle al cliente su documento tributario (boleta o
+ * factura) en PDF, y un DTE se manda ADJUNTO, no por un enlace — es el documento del cliente, tiene
+ * que poder guardarlo y reenviarlo a su contador sin depender de que una URL nuestra siga viva. El
+ * propio instructivo del SII describe el intercambio entre contribuyentes como correo "con un
+ * archivo adjunto". Sin esto en el contrato, ese producto tuvo que saltarse `core-mail` y usar
+ * `nodemailer` directo, que es justo lo que este paquete existe para evitar.
+ *
+ * Es un SUBCONJUNTO deliberado de lo que acepta Nodemailer, no un passthrough: lo que se declara
+ * acá es lo que CUALQUIER transporte futuro tiene que saber soportar. `path` y `href` quedaron
+ * fuera a propósito — hacen que el transporte lea del disco o de la red por su cuenta, y eso no es
+ * algo que un envío de correo deba hacer a espaldas de quien lo llama.
+ */
+export interface MailAttachment {
+    /** Nombre con el que el destinatario ve el archivo. */
+    filename: string;
+    /** El contenido, ya en memoria. */
+    content: Buffer | string;
+    /** Tipo MIME. Si se omite, se infiere de la extensión de `filename`. */
+    contentType?: string;
+    /** Content-ID para incrustar una imagen en el HTML (`<img src="cid:...">`) en vez de adjuntarla
+     * como archivo suelto. */
+    cid?: string;
+}
 export interface MailMessage {
     to: string | string[];
     from: string;
@@ -5,6 +31,7 @@ export interface MailMessage {
     html?: string;
     text?: string;
     replyTo?: string;
+    attachments?: MailAttachment[];
 }
 /** Un canal de envío concreto (un SMTP configurado). `core-mail` orquesta varios vía `createMailer()`. */
 export interface MailTransport {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@core-tecnologias-empresariales/core-mail",
-  "version": "0.1.0",
-  "description": "Envío de correo con múltiples SMTP y fallback para el ecosistema Core Tecnología Empresarial.",
+  "version": "0.2.0",
+  "description": "Envío de correo con múltiples SMTP, fallback y adjuntos para el ecosistema Core Tecnología Empresarial.",
   "license": "UNLICENSED",
   "publishConfig": {
     "access": "public"