is-academic-email 1.0.0 → 1.0.1

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export type SwotDataPacked = {
+    institutions: Record<string, string[]>;
+    stoplist: string[];
+    tlds: string[];
+};
+export type SwotData = {
+    institutions: Map<string, string[]>;
+    stoplist: Set<string>;
+    tlds: Set<string>;
+};
+export declare function isUnderTLD(emailOrDomain: string): boolean;
+export declare function isStoplisted(emailOrDomain: string): boolean;
+export declare function findSchoolNames(emailOrDomain: string): string[];
+export declare function isAcademic(email: string): boolean;
+export { SWOT_METADATA } from './swot-metadata';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACpC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACnB,CAAC;AA4CF,wBAAgB,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CAS/D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAOjD;AAED,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,70 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { brotliDecompressSync } from 'node:zlib';
+import { fileURLToPath } from 'node:url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+function loadData() {
+    const dataPath = path.join(__dirname, '..', 'data.json.br');
+    let packed;
+    try {
+        const compressed = fs.readFileSync(dataPath);
+        const decompressed = brotliDecompressSync(compressed);
+        packed = JSON.parse(decompressed.toString('utf8'));
+    }
+    catch {
+        packed = { institutions: {}, stoplist: [], tlds: [] };
+    }
+    return {
+        institutions: new Map(Object.entries(packed.institutions)),
+        stoplist: new Set(packed.stoplist.map((s) => s.toLowerCase())),
+        tlds: new Set(packed.tlds.map((s) => s.toLowerCase())),
+    };
+}
+const DATA = loadData();
+function domainParts(emailOrDomain) {
+    const raw = emailOrDomain.trim().toLowerCase();
+    const host = raw
+        .substring(raw.indexOf('@') + 1)
+        .replace(/^[a-z]+:\/\//, '')
+        .replace(/^[^/]*@/, '')
+        .split('/')[0]
+        .split(':')[0];
+    if (!host)
+        return [];
+    return host.split('.').reverse();
+}
+function checkSet(set, parts) {
+    let subj = '';
+    for (const part of parts) {
+        subj = subj ? `${part}.${subj}` : part;
+        if (set.has(subj))
+            return true;
+    }
+    return false;
+}
+export function isUnderTLD(emailOrDomain) {
+    return checkSet(DATA.tlds, domainParts(emailOrDomain));
+}
+export function isStoplisted(emailOrDomain) {
+    return checkSet(DATA.stoplist, domainParts(emailOrDomain));
+}
+export function findSchoolNames(emailOrDomain) {
+    const parts = domainParts(emailOrDomain);
+    let subj = '';
+    for (const part of parts) {
+        subj = subj ? `${part}.${subj}` : part;
+        const names = DATA.institutions.get(subj);
+        if (names && names.length)
+            return names.slice();
+    }
+    return [];
+}
+export function isAcademic(email) {
+    const valid = /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);
+    if (!valid)
+        return false;
+    return (!isStoplisted(email) &&
+        (isUnderTLD(email) || findSchoolNames(email).length > 0));
+}
+export { SWOT_METADATA } from './swot-metadata';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/swot-metadata.d.ts

@@ -0,0 +1,7 @@
+export declare const SWOT_METADATA: {
+    readonly commit: "8866dac84c80b27b3918c3a15d6f8707dbf84740";
+    readonly date: "2025-09-07 16:53:42 +0300";
+    readonly url: "https://github.com/jetbrains/swot";
+    readonly updatedAt: "2025-09-07T16:49:40.654Z";
+};
+//# sourceMappingURL=swot-metadata.d.ts.map

package/dist/swot-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swot-metadata.d.ts","sourceRoot":"","sources":["../src/swot-metadata.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC"}

package/dist/swot-metadata.js

@@ -0,0 +1,8 @@
+// This file was automatically generated on 2025-09-07T16:49:43.499Z
+export const SWOT_METADATA = {
+    "commit": "8866dac84c80b27b3918c3a15d6f8707dbf84740",
+    "date": "2025-09-07 16:53:42 +0300",
+    "url": "https://github.com/jetbrains/swot",
+    "updatedAt": "2025-09-07T16:49:40.654Z"
+};
+//# sourceMappingURL=swot-metadata.js.map

package/dist/swot-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swot-metadata.js","sourceRoot":"","sources":["../src/swot-metadata.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,QAAQ,EAAE,0CAA0C;IACpD,MAAM,EAAE,2BAA2B;IACnC,KAAK,EAAE,mCAAmC;IAC1C,WAAW,EAAE,0BAA0B;CAC/B,CAAC"}

package/package.json

@@ -1,12 +1,37 @@
 {
   "name": "is-academic-email",
-  "version": "1.0.0",
-  "description": "",
-  "main": "index.js",
-  "keywords": [],
-  "author": "",
-  "license": "MIT",
+  "version": "1.0.1",
+  "description": "Fast academic email validation using the JetBrains swot database",
+  "repository": {
+    "url": "https://github.com/amplitudesxd/is-academic-email"
+  },
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "data.json.br"
+  ],
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "bundle-data": "tsx scripts/bundle-data.ts",
+    "build": "pnpm run bundle-data && tsc"
+  },
+  "author": "amplitudesxd",
+  "license": "MIT",
+  "packageManager": "pnpm@10.15.1",
+  "devDependencies": {
+    "typescript": "^5.9.2",
+    "@types/node": "^24.3.1",
+    "tsx": "^4.20.5"
+  },
+  "engines": {
+    "node": ">=18"
   }
-}
+}