@kard-financial/sdk 3.2.0 → 3.2.2

package/dist/cjs/helpers/hem.d.ts

@@ -1,13 +1,3 @@
-/**
- * Normalize an email address for Hashed Email (HEM) generation.
- *
- * Follows UID2/LiveRamp industry standards:
- * - Remove all whitespace
- * - Lowercase
- * - Gmail/Googlemail only: remove dots from local-part, strip '+' suffix
- * - Canonicalize googlemail.com → gmail.com
- */
-export declare function normalizeEmail(raw: string): string;
 /**
  * Generate a Hashed Email (HEM) from a raw email address.
  * Returns the lowercase hex SHA-256 digest of the normalized, UTF-8-encoded email.

package/dist/cjs/helpers/hem.js

@@ -1,6 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.normalizeEmail = normalizeEmail;
 exports.generateHEM = generateHEM;
 const crypto_1 = require("crypto");
 const GMAIL_DOMAINS = new Set(["gmail.com", "googlemail.com"]);

package/dist/esm/helpers/hem.d.mts

@@ -1,13 +1,3 @@
-/**
- * Normalize an email address for Hashed Email (HEM) generation.
- *
- * Follows UID2/LiveRamp industry standards:
- * - Remove all whitespace
- * - Lowercase
- * - Gmail/Googlemail only: remove dots from local-part, strip '+' suffix
- * - Canonicalize googlemail.com → gmail.com
- */
-export declare function normalizeEmail(raw: string): string;
 /**
  * Generate a Hashed Email (HEM) from a raw email address.
  * Returns the lowercase hex SHA-256 digest of the normalized, UTF-8-encoded email.

package/dist/esm/helpers/hem.mjs

@@ -9,7 +9,7 @@ const GMAIL_DOMAINS = new Set(["gmail.com", "googlemail.com"]);
  * - Gmail/Googlemail only: remove dots from local-part, strip '+' suffix
  * - Canonicalize googlemail.com → gmail.com
  */
-export function normalizeEmail(raw) {
+function normalizeEmail(raw) {
     const email = raw.replace(/\s/g, "").toLowerCase();
     const atIndex = email.indexOf("@");
     if (atIndex < 1 || atIndex !== email.lastIndexOf("@") || atIndex === email.length - 1) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@kard-financial/sdk",
-    "version": "3.2.0",
+    "version": "3.2.2",
     "private": false,
     "repository": "github:KardFinancial/kard-node-sdk",
     "type": "commonjs",
@@ -72,5 +72,12 @@
     "engines": {
         "node": ">=18.0.0"
     },
-    "sideEffects": false
+    "sideEffects": false,
+    "typesVersions": {
+        "*": {
+            "helpers/hem": [
+                "dist/cjs/helpers/hem.d.ts"
+            ]
+        }
+    }
 }

package/reference.md

@@ -1888,9 +1888,9 @@ await client.users.uploads.update("organization-123", "user-123", "upload-123",
 ## Custom Helper Functions
 ### hem
 
-**Import:** `import { normalizeEmail, generateHEM } from "@kard-financial/sdk/helpers/hem";`
+**Import:** `import { generateHEM } from "@kard-financial/sdk/helpers/hem";`
 
-<details><summary><code><a href="/src/helpers/hem.ts">normalizeEmail(raw: string): string</a></code></summary>
+<details><summary><code><a href="/src/helpers/hem.ts">generateHEM(raw: string): string</a></code></summary>
 <dl>
 <dd>
 
@@ -1905,37 +1905,22 @@ Follows UID2/LiveRamp industry standards:
 - Lowercase
 - Gmail/Googlemail only: remove dots from local-part, strip '+' suffix
 - Canonicalize googlemail.com → gmail.com
-
-</dd>
-</dl>
-
-#### 🔌 Usage
-
-<dl>
-<dd>
-
-```typescript
-import { normalizeEmail } from "@kard-financial/sdk/helpers/hem";
-
-const result = normalizeEmail(/* raw: string */);
-```
-
-</dd>
-</dl>
-
-</dd>
-</dl>
-</details>
-
-<details><summary><code><a href="/src/helpers/hem.ts">generateHEM(raw: string): string</a></code></summary>
-<dl>
-<dd>
-
-#### 📝 Description
-
-<dl>
-<dd>
-
+/
+function normalizeEmail(raw: string): string {
+const email = raw.replace(/\s/g, "").toLowerCase();
+const atIndex = email.indexOf("@");
+if (atIndex < 1 || atIndex !== email.lastIndexOf("@") || atIndex === email.length - 1) {
+throw new TypeError(`Invalid email address: ${JSON.stringify(raw)}`);
+}
+const localPart = email.slice(0, atIndex);
+const domain = email.slice(atIndex + 1);
+if (GMAIL_DOMAINS.has(domain)) {
+const base = localPart.split("+")[0].replace(/\./g, "");
+return `${base}@gmail.com`;
+}
+return `${localPart}@${domain}`;
+}
+/**
 Generate a Hashed Email (HEM) from a raw email address.
 Returns the lowercase hex SHA-256 digest of the normalized, UTF-8-encoded email.