@ibgib/node-gib 0.0.9 → 0.0.13

package/dist/assumptions.respec.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"assumptions.respec.mjs","sourceRoot":"","sources":["../src/assumptions.respec.mts"],"names":[],"mappings":"AAAA,OAAO,EACsB,IAAI,EAElB,OAAO,EAAE,WAAW,EAClC,MAAM,kDAAkD,CAAC;AAC1D,MAAM,IAAI,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC;AAGhD;;;;;;;GAOG;AACH,KAAK,UAAU,gBAAgB,CAAC,EAC5B,CAAC,EACD,SAAS,GAAG,SAAS,GAIxB;IACG,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC;IACnC,IAAI,CAAC,CAAC,EAAE,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,IAAI,gBAAgB,CAAC,IAAI,iBAAiB,CAAC,CAAA;IAAC,CAAC;IACvE,IAAI,CAAC,SAAS,EAAE,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,IAAI,gBAAgB,CAAC,IAAI,yBAAyB,CAAC,CAAA;IAAC,CAAC;IACvF,IAAI,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACxD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QACnD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC;IACZ,CAAC;AACL,CAAC;AAED,MAAM,WAAW,CAAC,GAAG,EAAE,sCAAsC,EAAE,KAAK,IAAI,EAAE;IAEtE,MAAM,IAAI,CAAC,GAAG,EAAE,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACjG,IAAI,CAAC,GAAG,MAAM,gBAAgB,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,kEAAkE,CAAC,CAAC;IAC7G,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,CAAC,GAAG,EAAE,mFAAmF,EAAE,KAAK,IAAI,EAAE;QAC5G,IAAI,KAAK,GAAa,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;QAC/C,IAAI,CAAC,GAAG,MAAM,gBAAgB,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,mEAAmE;QACjI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,kEAAkE,CAAC,CAAC;IACjH,CAAC,CAAC,CAAC;AAEP,CAAC,CAAC,CAAC"}
+{"version":3,"file":"assumptions.respec.mjs","sourceRoot":"","sources":["../src/assumptions.respec.mts"],"names":[],"mappings":"AAAA,OAAO,EACsB,IAAI,EAElB,OAAO,EAAE,WAAW,EAClC,MAAM,kDAAkD,CAAC;AAC1D,MAAM,IAAI,GAAG,IAAI,OAAO,IAAI,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC;AAGhD;;;;;;;GAOG;AACH,KAAK,UAAU,gBAAgB,CAAC,EAC5B,CAAC,EACD,SAAS,GAAG,SAAS,GAIxB;IACG,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC;IACnC,IAAI,CAAC,CAAC,EAAE,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,IAAI,gBAAgB,CAAC,IAAI,iBAAiB,CAAC,CAAA;IAAC,CAAC;IACvE,IAAI,CAAC,SAAS,EAAE,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,IAAI,gBAAgB,CAAC,IAAI,yBAAyB,CAAC,CAAA;IAAC,CAAC;IACvF,IAAI,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACxD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QACnD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC;IACZ,CAAC;AACL,CAAC;AAED,MAAM,WAAW,CAAC,GAAG,EAAE,sCAAsC,EAAE,KAAK,IAAI,EAAE;IAEtE,MAAM,IAAI,CAAC,GAAG,EAAE,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACjG,IAAI,CAAC,GAAG,MAAM,gBAAgB,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,kEAAkE,CAAC,CAAC;IAC7G,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,CAAC,GAAG,EAAE,mFAAmF,EAAE,KAAK,IAAI,EAAE;QAC5G,IAAI,KAAK,GAAa,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;QAC/C,IAAI,CAAC,GAAG,MAAM,gBAAgB,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,mEAAmE;QACjI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,kEAAkE,CAAC,CAAC;IACjH,CAAC,CAAC,CAAC;AAEP,CAAC,CAAC,CAAC"}

package/dist/email/aws/aws-sigv4-helper.d.mts

@@ -0,0 +1,26 @@
+/**
+ * AWS Signature Version 4 helper using native Node.js crypto module.
+ * Zero-dependency implementation for signing REST requests to AWS services (e.g., SES).
+ */
+export interface AwsSigV4Options {
+    method: string;
+    url: string;
+    region: string;
+    service: string;
+    accessKeyId: string;
+    secretAccessKey: string;
+    body?: string | Buffer;
+    headers?: Record<string, string>;
+    timestamp?: Date;
+}
+export interface AwsSigV4Result {
+    headers: Record<string, string>;
+    amzDate: string;
+    signature: string;
+    authorization: string;
+}
+/**
+ * Computes AWS SigV4 signed headers for an HTTP request.
+ */
+export declare function createAwsSigV4Headers(options: AwsSigV4Options): AwsSigV4Result;
+//# sourceMappingURL=aws-sigv4-helper.d.mts.map

package/dist/email/aws/aws-sigv4-helper.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aws-sigv4-helper.d.mts","sourceRoot":"","sources":["../../../src/email/aws/aws-sigv4-helper.mts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,eAAe;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACzB;AAcD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAiG9E"}

package/dist/email/aws/aws-sigv4-helper.mjs

@@ -0,0 +1,94 @@
+/**
+ * AWS Signature Version 4 helper using native Node.js crypto module.
+ * Zero-dependency implementation for signing REST requests to AWS services (e.g., SES).
+ */
+import crypto from 'node:crypto';
+function sha256Hex(data) {
+    return crypto.createHash('sha256').update(data).digest('hex');
+}
+function hmac(key, data) {
+    return crypto.createHmac('sha256', key).update(data, 'utf8').digest();
+}
+function encodeRfc3986(str) {
+    return encodeURIComponent(str).replace(/[!'()*]/g, c => `%${c.charCodeAt(0).toString(16).toUpperCase()}`);
+}
+/**
+ * Computes AWS SigV4 signed headers for an HTTP request.
+ */
+export function createAwsSigV4Headers(options) {
+    const { method, url: urlStr, region, service, accessKeyId, secretAccessKey, body = '', headers: extraHeaders = {}, timestamp = new Date(), } = options;
+    const parsedUrl = new URL(urlStr);
+    const amzDate = timestamp.toISOString().replace(/[:-]/g, '').replace(/\.\d{3}/, '');
+    const dateStamp = amzDate.slice(0, 8);
+    const headersToSign = {
+        host: parsedUrl.host,
+        'x-amz-date': amzDate,
+    };
+    for (const [k, v] of Object.entries(extraHeaders)) {
+        headersToSign[k.toLowerCase()] = v.trim().replace(/\s+/g, ' ');
+    }
+    const sortedHeaderKeys = Object.keys(headersToSign).sort();
+    const canonicalHeaders = sortedHeaderKeys.map(k => `${k}:${headersToSign[k]}\n`).join('');
+    const signedHeaders = sortedHeaderKeys.join(';');
+    // Canonical URI
+    let canonicalUri = parsedUrl.pathname;
+    if (!canonicalUri) {
+        canonicalUri = '/';
+    }
+    else {
+        canonicalUri = canonicalUri
+            .split('/')
+            .map(segment => encodeRfc3986(segment))
+            .join('/');
+    }
+    // Canonical Query String
+    const queryParams = [];
+    parsedUrl.searchParams.forEach((val, key) => {
+        queryParams.push([encodeRfc3986(key), encodeRfc3986(val)]);
+    });
+    queryParams.sort(([k1, v1], [k2, v2]) => {
+        if (k1 === k2) {
+            return v1.localeCompare(v2);
+        }
+        return k1.localeCompare(k2);
+    });
+    const canonicalQueryString = queryParams.map(([k, v]) => `${k}=${v}`).join('&');
+    const payloadHash = sha256Hex(body);
+    const canonicalRequest = [
+        method.toUpperCase(),
+        canonicalUri,
+        canonicalQueryString,
+        canonicalHeaders,
+        signedHeaders,
+        payloadHash,
+    ].join('\n');
+    const hashedCanonicalRequest = sha256Hex(canonicalRequest);
+    const credentialScope = `${dateStamp}/${region}/${service}/aws4_request`;
+    const stringToSign = [
+        'AWS4-HMAC-SHA256',
+        amzDate,
+        credentialScope,
+        hashedCanonicalRequest,
+    ].join('\n');
+    const kDate = hmac(`AWS4${secretAccessKey}`, dateStamp);
+    const kRegion = hmac(kDate, region);
+    const kService = hmac(kRegion, service);
+    const kSigning = hmac(kService, 'aws4_request');
+    const signature = crypto.createHmac('sha256', kSigning).update(stringToSign, 'utf8').digest('hex');
+    const authorization = `AWS4-HMAC-SHA256 Credential=${accessKeyId}/${credentialScope}, SignedHeaders=${signedHeaders}, Signature=${signature}`;
+    const resultHeaders = {
+        Host: parsedUrl.host,
+        'X-Amz-Date': amzDate,
+        Authorization: authorization,
+    };
+    for (const [k, v] of Object.entries(extraHeaders)) {
+        resultHeaders[k] = v;
+    }
+    return {
+        headers: resultHeaders,
+        amzDate,
+        signature,
+        authorization,
+    };
+}
+//# sourceMappingURL=aws-sigv4-helper.mjs.map

package/dist/email/aws/aws-sigv4-helper.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"aws-sigv4-helper.mjs","sourceRoot":"","sources":["../../../src/email/aws/aws-sigv4-helper.mts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,MAAM,MAAM,aAAa,CAAC;AAqBjC,SAAS,SAAS,CAAC,IAAqB;IACpC,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,IAAI,CAAC,GAAoB,EAAE,IAAY;IAC5C,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC;AAC1E,CAAC;AAED,SAAS,aAAa,CAAC,GAAW;IAC9B,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AAC9G,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAwB;IAC1D,MAAM,EACF,MAAM,EACN,GAAG,EAAE,MAAM,EACX,MAAM,EACN,OAAO,EACP,WAAW,EACX,eAAe,EACf,IAAI,GAAG,EAAE,EACT,OAAO,EAAE,YAAY,GAAG,EAAE,EAC1B,SAAS,GAAG,IAAI,IAAI,EAAE,GACzB,GAAG,OAAO,CAAC;IAEZ,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACpF,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEtC,MAAM,aAAa,GAA2B;QAC1C,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,YAAY,EAAE,OAAO;KACxB,CAAC;IAEF,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QAChD,aAAa,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3D,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1F,MAAM,aAAa,GAAG,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEjD,gBAAgB;IAChB,IAAI,YAAY,GAAG,SAAS,CAAC,QAAQ,CAAC;IACtC,IAAI,CAAC,YAAY,EAAE,CAAC;QAChB,YAAY,GAAG,GAAG,CAAC;IACvB,CAAC;SAAM,CAAC;QACJ,YAAY,GAAG,YAAY;aACtB,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;aACtC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,yBAAyB;IACzB,MAAM,WAAW,GAAuB,EAAE,CAAC;IAC3C,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QACxC,WAAW,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IACH,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE;QACpC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAAC,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QAAC,CAAC;QAC/C,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IACH,MAAM,oBAAoB,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEhF,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAEpC,MAAM,gBAAgB,GAAG;QACrB,MAAM,CAAC,WAAW,EAAE;QACpB,YAAY;QACZ,oBAAoB;QACpB,gBAAgB;QAChB,aAAa;QACb,WAAW;KACd,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,sBAAsB,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAAC;IAC3D,MAAM,eAAe,GAAG,GAAG,SAAS,IAAI,MAAM,IAAI,OAAO,eAAe,CAAC;IAEzE,MAAM,YAAY,GAAG;QACjB,kBAAkB;QAClB,OAAO;QACP,eAAe;QACf,sBAAsB;KACzB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,eAAe,EAAE,EAAE,SAAS,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAEhD,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnG,MAAM,aAAa,GAAG,+BAA+B,WAAW,IAAI,eAAe,mBAAmB,aAAa,eAAe,SAAS,EAAE,CAAC;IAE9I,MAAM,aAAa,GAA2B;QAC1C,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,YAAY,EAAE,OAAO;QACrB,aAAa,EAAE,aAAa;KAC/B,CAAC;IAEF,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QAChD,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,OAAO;QACH,OAAO,EAAE,aAAa;QACtB,OAAO;QACP,SAAS;QACT,aAAa;KAChB,CAAC;AACN,CAAC"}

package/dist/email/aws/email-receiver-aws.d.mts

@@ -0,0 +1,13 @@
+/**
+ * AWS SES concrete driver implementation of EmailReceiverBase.
+ * Parses SES notification webhooks (SNS / S3) and evaluates spam/SPF/DKIM/virus verdicts.
+ */
+import { EmailReceiverBase } from '../email-receiver.mjs';
+import { InboundEmail } from '../email-types.mjs';
+export declare class EmailReceiverAws extends EmailReceiverBase {
+    /**
+     * Parses an incoming AWS SES webhook or SNS notification payload into a normalized InboundEmail object.
+     */
+    parseInboundPayload(payload: any): Promise<InboundEmail>;
+}
+//# sourceMappingURL=email-receiver-aws.d.mts.map

package/dist/email/aws/email-receiver-aws.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-receiver-aws.d.mts","sourceRoot":"","sources":["../../../src/email/aws/email-receiver-aws.mts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAqB,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAErE,qBAAa,gBAAiB,SAAQ,iBAAiB;IACnD;;OAEG;IACG,mBAAmB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC,CA4F7D;CACJ"}

package/dist/email/aws/email-receiver-aws.mjs

@@ -0,0 +1,97 @@
+/**
+ * AWS SES concrete driver implementation of EmailReceiverBase.
+ * Parses SES notification webhooks (SNS / S3) and evaluates spam/SPF/DKIM/virus verdicts.
+ */
+import { parseEmailAddress, sanitizeHeaderValue } from '../email-helpers.mjs';
+import { EmailReceiverBase } from '../email-receiver.mjs';
+export class EmailReceiverAws extends EmailReceiverBase {
+    /**
+     * Parses an incoming AWS SES webhook or SNS notification payload into a normalized InboundEmail object.
+     */
+    async parseInboundPayload(payload) {
+        let rawData = payload;
+        if (typeof rawData === 'string') {
+            try {
+                rawData = JSON.parse(rawData);
+            }
+            catch {
+                throw new Error('Invalid JSON string in AWS inbound payload. (E: 6f7890123456789abcdef6a7b8c9d0e1)');
+            }
+        }
+        // Validate SNS SigningCertURL domain if present (prevents SSRF / unauthenticated cert host spoofing)
+        if (rawData && typeof rawData === 'object' && rawData.SigningCertURL) {
+            try {
+                const certUrl = new URL(rawData.SigningCertURL);
+                if (certUrl.protocol !== 'https:' || !certUrl.hostname.endsWith('.amazonaws.com')) {
+                    throw new Error(`Invalid SNS SigningCertURL host: ${rawData.SigningCertURL} (E: a9b8c7d6e5f432109876543210fedcba)`);
+                }
+            }
+            catch (err) {
+                if (err?.message?.includes('(E: ')) {
+                    throw err;
+                }
+                throw new Error(`Invalid SNS SigningCertURL: ${err?.message || String(err)} (E: b8c7d6e5f432109876543210fedcba9)`);
+            }
+        }
+        // If payload is wrapped inside an SNS message: { Type: 'Notification', Message: '{...}' }
+        if (rawData && typeof rawData === 'object' && rawData.Message && typeof rawData.Message === 'string') {
+            try {
+                rawData = JSON.parse(rawData.Message);
+            }
+            catch {
+                // If Message is not JSON, retain outer object
+            }
+        }
+        if (!rawData || typeof rawData !== 'object') {
+            throw new Error('Invalid payload structure for AWS SES email parsing. (E: 7890123456789abcdef7a8b9c0d1e2f3)');
+        }
+        const mail = rawData.mail || {};
+        const receipt = rawData.receipt || {};
+        const messageId = mail.messageId || rawData.messageId || `aws-${Date.now()}-${Math.random().toString(36).substring(2, 8)}`;
+        const receivedAt = mail.timestamp || receipt.timestamp || new Date().toISOString();
+        // Extract From
+        let fromRaw = mail.source || mail.commonHeaders?.from?.[0] || rawData.from || 'unknown@unknown.com';
+        if (Array.isArray(fromRaw)) {
+            fromRaw = fromRaw[0];
+        }
+        const from = parseEmailAddress(fromRaw);
+        // Extract To
+        const toRawList = mail.destination || mail.commonHeaders?.to || rawData.to || [];
+        const toList = Array.isArray(toRawList) ? toRawList : [toRawList];
+        const to = toList.map(t => parseEmailAddress(t));
+        // Extract Cc
+        const ccRawList = mail.commonHeaders?.cc || rawData.cc;
+        const cc = ccRawList ? (Array.isArray(ccRawList) ? ccRawList : [ccRawList]).map(c => parseEmailAddress(c)) : undefined;
+        // Subject (sanitized against header injection)
+        const subjectRaw = mail.commonHeaders?.subject || rawData.subject || '(No Subject)';
+        const subject = sanitizeHeaderValue(subjectRaw);
+        // Extract Verdicts
+        const spamVerdicts = {
+            spamVerdict: receipt.spamVerdict?.status || rawData.spamVerdict || 'PASS',
+            virusVerdict: receipt.virusVerdict?.status || rawData.virusVerdict || 'PASS',
+            spfVerdict: receipt.spfVerdict?.status || rawData.spfVerdict || 'PASS',
+            dkimVerdict: receipt.dkimVerdict?.status || rawData.dkimVerdict || 'PASS',
+            dmarcVerdict: receipt.dmarcVerdict?.status || rawData.dmarcVerdict || 'PASS',
+        };
+        const folder = this.evaluateSpamVerdicts(spamVerdicts);
+        const textBody = rawData.textBody || rawData.content || undefined;
+        const htmlBody = rawData.htmlBody || undefined;
+        const rawMime = rawData.rawMime || (typeof rawData.content === 'string' ? rawData.content : undefined);
+        const inboundEmail = {
+            messageId,
+            from,
+            to,
+            cc,
+            subject,
+            textBody,
+            htmlBody,
+            rawMime,
+            receivedAt,
+            spamVerdicts,
+            folder,
+            headers: mail.commonHeaders || rawData.headers,
+        };
+        return inboundEmail;
+    }
+}
+//# sourceMappingURL=email-receiver-aws.mjs.map

package/dist/email/aws/email-receiver-aws.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-receiver-aws.mjs","sourceRoot":"","sources":["../../../src/email/aws/email-receiver-aws.mts"],"names":[],"mappings":"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"}

package/dist/email/aws/email-sender-aws.d.mts

@@ -0,0 +1,23 @@
+/**
+ * AWS SES concrete driver implementation of EmailSenderBase.
+ */
+import { EmailSenderBase } from '../email-sender.mjs';
+import { EmailSendResult, OutboundEmail } from '../email-types.mjs';
+export interface EmailSenderAwsOptions {
+    accessKeyId: string;
+    secretAccessKey: string;
+    region?: string;
+    endpoint?: string;
+    /** Custom fetch implementation (optional, defaults to globalThis.fetch) */
+    fetchFn?: typeof fetch;
+}
+export declare class EmailSenderAws extends EmailSenderBase {
+    private accessKeyId;
+    private secretAccessKey;
+    private region;
+    private endpoint;
+    private fetchFn;
+    constructor(options: EmailSenderAwsOptions);
+    sendEmail(email: OutboundEmail): Promise<EmailSendResult>;
+}
+//# sourceMappingURL=email-sender-aws.d.mts.map

package/dist/email/aws/email-sender-aws.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-sender-aws.d.mts","sourceRoot":"","sources":["../../../src/email/aws/email-sender-aws.mts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGpE,MAAM,WAAW,qBAAqB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,qBAAa,cAAe,SAAQ,eAAe;IAC/C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAe;IAE9B,YAAY,OAAO,EAAE,qBAAqB,EAUzC;IAEK,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CA0F9D;CACJ"}

package/dist/email/aws/email-sender-aws.mjs

@@ -0,0 +1,106 @@
+/**
+ * AWS SES concrete driver implementation of EmailSenderBase.
+ */
+import { DEFAULT_AWS_REGION, DEFAULT_AWS_SERVICE } from '../email-constants.mjs';
+import { formatEmailAddress } from '../email-helpers.mjs';
+import { EmailSenderBase } from '../email-sender.mjs';
+import { createAwsSigV4Headers } from './aws-sigv4-helper.mjs';
+export class EmailSenderAws extends EmailSenderBase {
+    accessKeyId;
+    secretAccessKey;
+    region;
+    endpoint;
+    fetchFn;
+    constructor(options) {
+        super();
+        if (!options.accessKeyId || !options.secretAccessKey) {
+            throw new Error('EmailSenderAws requires accessKeyId and secretAccessKey. (E: 5e6f7890123456789abcdef5a6b7c8d9)');
+        }
+        this.accessKeyId = options.accessKeyId;
+        this.secretAccessKey = options.secretAccessKey;
+        this.region = options.region || DEFAULT_AWS_REGION;
+        this.endpoint = options.endpoint || `https://email.${this.region}.amazonaws.com`;
+        this.fetchFn = options.fetchFn || globalThis.fetch;
+    }
+    async sendEmail(email) {
+        try {
+            this.validateOutboundEmail(email);
+            const params = new URLSearchParams();
+            params.append('Action', 'SendEmail');
+            params.append('Version', '2010-12-01');
+            params.append('Source', formatEmailAddress(email.from));
+            email.to.forEach((addr, idx) => {
+                params.append(`Destination.ToAddresses.member.${idx + 1}`, formatEmailAddress(addr));
+            });
+            if (email.cc && email.cc.length > 0) {
+                email.cc.forEach((addr, idx) => {
+                    params.append(`Destination.CcAddresses.member.${idx + 1}`, formatEmailAddress(addr));
+                });
+            }
+            if (email.bcc && email.bcc.length > 0) {
+                email.bcc.forEach((addr, idx) => {
+                    params.append(`Destination.BccAddresses.member.${idx + 1}`, formatEmailAddress(addr));
+                });
+            }
+            if (email.replyTo) {
+                params.append('ReplyToAddresses.member.1', formatEmailAddress(email.replyTo));
+            }
+            params.append('Message.Subject.Data', email.subject);
+            params.append('Message.Subject.Charset', 'UTF-8');
+            if (email.textBody) {
+                params.append('Message.Body.Text.Data', email.textBody);
+                params.append('Message.Body.Text.Charset', 'UTF-8');
+            }
+            if (email.htmlBody) {
+                params.append('Message.Body.Html.Data', email.htmlBody);
+                params.append('Message.Body.Html.Charset', 'UTF-8');
+            }
+            const bodyString = params.toString();
+            const headers = {
+                'Content-Type': 'application/x-www-form-urlencoded',
+            };
+            const sigV4Result = createAwsSigV4Headers({
+                method: 'POST',
+                url: this.endpoint,
+                region: this.region,
+                service: DEFAULT_AWS_SERVICE,
+                accessKeyId: this.accessKeyId,
+                secretAccessKey: this.secretAccessKey,
+                body: bodyString,
+                headers,
+            });
+            const response = await this.fetchFn(this.endpoint, {
+                method: 'POST',
+                headers: sigV4Result.headers,
+                body: bodyString,
+            });
+            const responseText = await response.text();
+            if (response.ok) {
+                // Parse MessageId from XML response: <MessageId>010001...</MessageId>
+                const messageIdMatch = responseText.match(/<MessageId>(.*?)<\/MessageId>/);
+                const messageId = messageIdMatch ? messageIdMatch[1] : undefined;
+                return {
+                    success: true,
+                    messageId,
+                    statusCode: response.status,
+                };
+            }
+            else {
+                const errorMatch = responseText.match(/<Message>(.*?)<\/Message>/);
+                const errorMsg = errorMatch ? errorMatch[1] : responseText;
+                return {
+                    success: false,
+                    error: `AWS SES Error (${response.status}): ${errorMsg}`,
+                    statusCode: response.status,
+                };
+            }
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error?.message || String(error),
+            };
+        }
+    }
+}
+//# sourceMappingURL=email-sender-aws.mjs.map

package/dist/email/aws/email-sender-aws.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-sender-aws.mjs","sourceRoot":"","sources":["../../../src/email/aws/email-sender-aws.mts"],"names":[],"mappings":"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"}

package/dist/email/aws/index.d.mts

@@ -0,0 +1,7 @@
+/**
+ * AWS email driver exports.
+ */
+export * from './aws-sigv4-helper.mjs';
+export * from './email-sender-aws.mjs';
+export * from './email-receiver-aws.mjs';
+//# sourceMappingURL=index.d.mts.map

package/dist/email/aws/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/email/aws/index.mts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC"}

package/dist/email/aws/index.mjs

@@ -0,0 +1,7 @@
+/**
+ * AWS email driver exports.
+ */
+export * from './aws-sigv4-helper.mjs';
+export * from './email-sender-aws.mjs';
+export * from './email-receiver-aws.mjs';
+//# sourceMappingURL=index.mjs.map

package/dist/email/aws/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/email/aws/index.mts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC"}

package/dist/email/email-constants.d.mts

@@ -0,0 +1,15 @@
+/**
+ * Constants for email infrastructure in node-gib.
+ */
+export declare const DEFAULT_EMAIL_CHARSET = "UTF-8";
+export declare const EMAIL_MODE_AWS = "aws";
+export declare const EMAIL_MODE_MOCK = "mock";
+export declare const DEFAULT_AWS_REGION = "us-east-1";
+export declare const DEFAULT_AWS_SES_ENDPOINT = "https://email.us-east-1.amazonaws.com";
+export declare const DEFAULT_AWS_SERVICE = "ses";
+export declare const VERDICT_PASS = "PASS";
+export declare const VERDICT_FAIL = "FAIL";
+export declare const VERDICT_GRAY = "GRAY";
+export declare const FOLDER_INBOX = "inbox";
+export declare const FOLDER_JUNK = "junk";
+//# sourceMappingURL=email-constants.d.mts.map

package/dist/email/email-constants.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-constants.d.mts","sourceRoot":"","sources":["../../src/email/email-constants.mts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAC7C,eAAO,MAAM,cAAc,QAAQ,CAAC;AACpC,eAAO,MAAM,eAAe,SAAS,CAAC;AAEtC,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAC9C,eAAO,MAAM,wBAAwB,0CAA0C,CAAC;AAChF,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAEzC,eAAO,MAAM,YAAY,SAAS,CAAC;AACnC,eAAO,MAAM,YAAY,SAAS,CAAC;AACnC,eAAO,MAAM,YAAY,SAAS,CAAC;AAEnC,eAAO,MAAM,YAAY,UAAU,CAAC;AACpC,eAAO,MAAM,WAAW,SAAS,CAAC"}

package/dist/email/email-constants.mjs

@@ -0,0 +1,15 @@
+/**
+ * Constants for email infrastructure in node-gib.
+ */
+export const DEFAULT_EMAIL_CHARSET = 'UTF-8';
+export const EMAIL_MODE_AWS = 'aws';
+export const EMAIL_MODE_MOCK = 'mock';
+export const DEFAULT_AWS_REGION = 'us-east-1';
+export const DEFAULT_AWS_SES_ENDPOINT = 'https://email.us-east-1.amazonaws.com';
+export const DEFAULT_AWS_SERVICE = 'ses';
+export const VERDICT_PASS = 'PASS';
+export const VERDICT_FAIL = 'FAIL';
+export const VERDICT_GRAY = 'GRAY';
+export const FOLDER_INBOX = 'inbox';
+export const FOLDER_JUNK = 'junk';
+//# sourceMappingURL=email-constants.mjs.map

package/dist/email/email-constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-constants.mjs","sourceRoot":"","sources":["../../src/email/email-constants.mts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAO,CAAC;AAC7C,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC;AACpC,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AAEtC,MAAM,CAAC,MAAM,kBAAkB,GAAG,WAAW,CAAC;AAC9C,MAAM,CAAC,MAAM,wBAAwB,GAAG,uCAAuC,CAAC;AAChF,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAEzC,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC;AACnC,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC;AACnC,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC;AAEnC,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC;AACpC,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC"}

package/dist/email/email-helpers.d.mts

@@ -0,0 +1,35 @@
+/**
+ * Helper functions for email parsing, validation, and MIME string formatting.
+ */
+import { EmailAddress, OutboundEmail } from './email-types.mjs';
+/**
+ * Validates whether an email string matches standard email formatting.
+ */
+export declare function validateEmail(email: string): boolean;
+/** Alias for validateEmail for email address format checking. */
+export declare function validateEmailAddress(email: string): boolean;
+/**
+ * Sanitizes header values by stripping carriage return (\r) and newline (\n) characters
+ * to prevent MIME header injection.
+ */
+export declare function sanitizeHeaderValue(val: string): string;
+/**
+ * Parses a string or EmailAddress object into a normalized EmailAddress object.
+ * Examples:
+ * - "Alice <alice@example.com>" -> { name: "Alice", address: "alice@example.com" }
+ * - "alice@example.com" -> { address: "alice@example.com" }
+ */
+export declare function parseEmailAddress(addr: EmailAddress | string): EmailAddress;
+/**
+ * Formats an EmailAddress or string into RFC 2822 format (e.g. `"Alice" <alice@example.com>`).
+ */
+export declare function formatEmailAddress(addr: EmailAddress | string): string;
+/**
+ * Parses raw MIME headers string or header record into a key-value record with normalized header names.
+ */
+export declare function parseRawMimeHeaders(raw: string | Record<string, string>): Record<string, string>;
+/**
+ * Formats an OutboundEmail object into a raw MIME string (RFC 2822).
+ */
+export declare function formatRawMimeString(email: OutboundEmail, charset?: string): string;
+//# sourceMappingURL=email-helpers.d.mts.map

package/dist/email/email-helpers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-helpers.d.mts","sourceRoot":"","sources":["../../src/email/email-helpers.mts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIhE;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGpD;AAED,iEAAiE;AACjE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE3D;AAGD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,GAAG,YAAY,CAoB3E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,GAAG,MAAM,CAMtE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwBhG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,GAAE,MAA8B,GAAG,MAAM,CAwDzG"}