leadmeteor 0.0.1

package/LICENSE

@@ -0,0 +1,19 @@
+Copyright (C) 2026 Leadmeteor, SAS. (https://leadmeteor.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,35 @@
+# Leadmeteor Node.js SDK
+
+The official Node.js SDK for the [Leadmeteor](https://leadmeteor.com) API.
+
+## Installation
+
+```bash
+npm install leadmeteor
+```
+
+## Usage
+
+```typescript
+import Leadmeteor from "leadmeteor";
+
+const leadmeteor = new Leadmeteor("sk_your_api_key");
+
+// Verify an email
+const { status, checks } = await leadmeteor.emails.verify({
+  email: "john@example.com",
+});
+
+// Look up a domain
+const domain = await leadmeteor.domains.lookup({
+  domain: "example.com",
+});
+```
+
+## Requirements
+
+- Node.js 18+
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,10 @@
+export type ClientOptions = {
+    apiKey: string;
+    baseUrl?: string;
+};
+export declare class Client {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(options: ClientOptions);
+    request<T>(method: string, path: string, params?: Record<string, string>): Promise<T>;
+}

package/dist/client.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Client = void 0;
+const error_1 = require("./error");
+class Client {
+    apiKey;
+    baseUrl;
+    constructor(options) {
+        if (!options.apiKey) {
+            throw new error_1.LeadmeteorError("API key is required", 0);
+        }
+        this.apiKey = options.apiKey;
+        this.baseUrl = (options.baseUrl ?? "https://api.leadmeteor.com").replace(/\/+$/, "");
+    }
+    async request(method, path, params) {
+        let url = `${this.baseUrl}${path}`;
+        if (params) {
+            const query = new URLSearchParams(params).toString();
+            url += `?${query}`;
+        }
+        const response = await fetch(url, {
+            method,
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+            },
+        });
+        const body = (await response.json());
+        if (!response.ok || !body.success) {
+            const error = !body.success ? body.error : `Request failed with status ${response.status}`;
+            throw new error_1.LeadmeteorError(error, response.status);
+        }
+        return body.data;
+    }
+}
+exports.Client = Client;

package/dist/error.d.ts

@@ -0,0 +1,4 @@
+export declare class LeadmeteorError extends Error {
+    readonly status: number;
+    constructor(message: string, status: number);
+}

package/dist/error.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LeadmeteorError = void 0;
+class LeadmeteorError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.name = "LeadmeteorError";
+        this.status = status;
+    }
+}
+exports.LeadmeteorError = LeadmeteorError;

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+import { type ClientOptions } from "./client";
+import { People } from "./resources/people";
+import { Companies } from "./resources/companies";
+import * as _EmailsModule from "./types/emails";
+import * as _DomainsModule from "./types/domains";
+declare class Leadmeteor {
+    readonly emails: Leadmeteor.Emails;
+    readonly people: People;
+    readonly companies: Companies;
+    readonly domains: Leadmeteor.Domains;
+    constructor(apiKey: string, options?: Omit<ClientOptions, "apiKey">);
+}
+declare namespace Leadmeteor {
+    export import Emails = _EmailsModule.Emails;
+    interface Emails {
+        verify(params: Emails.EmailVerificationParams): Promise<Emails.EmailVerification>;
+        lookup(params: Emails.LookupParams): Promise<unknown>;
+        search(params: Emails.SearchParams): Promise<unknown>;
+    }
+    export import Domains = _DomainsModule.Domains;
+    interface Domains {
+        lookup(params: Domains.DomainLookupParams): Promise<Domains.DomainLookup>;
+    }
+}
+export default Leadmeteor;
+export { Leadmeteor };
+export { LeadmeteorError } from "./error";

package/dist/index.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LeadmeteorError = exports.Leadmeteor = void 0;
+const client_1 = require("./client");
+const emails_1 = require("./resources/emails");
+const people_1 = require("./resources/people");
+const companies_1 = require("./resources/companies");
+const domains_1 = require("./resources/domains");
+class Leadmeteor {
+    emails;
+    people;
+    companies;
+    domains;
+    constructor(apiKey, options) {
+        const client = new client_1.Client({ apiKey, ...options });
+        this.emails = new emails_1.EmailsResource(client);
+        this.people = new people_1.People(client);
+        this.companies = new companies_1.Companies(client);
+        this.domains = new domains_1.DomainsResource(client);
+    }
+}
+exports.Leadmeteor = Leadmeteor;
+(function (Leadmeteor) {
+})(Leadmeteor || (exports.Leadmeteor = Leadmeteor = {}));
+exports.default = Leadmeteor;
+var error_1 = require("./error");
+Object.defineProperty(exports, "LeadmeteorError", { enumerable: true, get: function () { return error_1.LeadmeteorError; } });

package/dist/resources/companies.d.ts

@@ -0,0 +1,7 @@
+import type { Client } from "../client";
+export declare class Companies {
+    private readonly client;
+    constructor(client: Client);
+    lookup(params: Record<string, string>): Promise<unknown>;
+    search(params: Record<string, string>): Promise<unknown>;
+}

package/dist/resources/companies.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Companies = void 0;
+class Companies {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async lookup(params) {
+        return this.client.request("GET", "/v1/companies/lookup", params);
+    }
+    async search(params) {
+        return this.client.request("GET", "/v1/companies/search", params);
+    }
+}
+exports.Companies = Companies;

package/dist/resources/domains.d.ts

@@ -0,0 +1,7 @@
+import type { Client } from "../client";
+import type { Domains } from "../types/domains";
+export declare class DomainsResource {
+    private readonly client;
+    constructor(client: Client);
+    lookup(params: Domains.DomainLookupParams): Promise<Domains.DomainLookup>;
+}

package/dist/resources/domains.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DomainsResource = void 0;
+class DomainsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async lookup(params) {
+        return this.client.request("GET", "/v1/domains/lookup", {
+            domain: params.domain,
+        });
+    }
+}
+exports.DomainsResource = DomainsResource;

package/dist/resources/emails.d.ts

@@ -0,0 +1,9 @@
+import type { Client } from "../client";
+import type { Emails } from "../types/emails";
+export declare class EmailsResource {
+    private readonly client;
+    constructor(client: Client);
+    verify(params: Emails.EmailVerificationParams): Promise<Emails.EmailVerification>;
+    lookup(params: Emails.LookupParams): Promise<unknown>;
+    search(params: Emails.SearchParams): Promise<unknown>;
+}

package/dist/resources/emails.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailsResource = void 0;
+class EmailsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async verify(params) {
+        return this.client.request("GET", "/v1/emails/verify", {
+            email: params.email,
+        });
+    }
+    async lookup(params) {
+        const query = {};
+        if ("email" in params) {
+            query.email = params.email;
+        }
+        else if ("linkedin_url" in params) {
+            query.linkedin_url = params.linkedin_url;
+        }
+        else {
+            query.name = params.name;
+            query.company = params.company;
+        }
+        return this.client.request("GET", "/v1/emails/lookup", query);
+    }
+    async search(params) {
+        return this.client.request("GET", "/v1/emails/search", {
+            domain: params.domain,
+        });
+    }
+}
+exports.EmailsResource = EmailsResource;

package/dist/resources/people.d.ts

@@ -0,0 +1,7 @@
+import type { Client } from "../client";
+export declare class People {
+    private readonly client;
+    constructor(client: Client);
+    lookup(params: Record<string, string>): Promise<unknown>;
+    search(params: Record<string, string>): Promise<unknown>;
+}

package/dist/resources/people.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.People = void 0;
+class People {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async lookup(params) {
+        return this.client.request("GET", "/v1/people/lookup", params);
+    }
+    async search(params) {
+        return this.client.request("GET", "/v1/people/search", params);
+    }
+}
+exports.People = People;

package/dist/types/api.d.ts

@@ -0,0 +1,10 @@
+export type ApiSuccessResponse<T> = {
+    success: true;
+    data: T;
+};
+export type ApiErrorResponse = {
+    success: false;
+    error: string;
+};
+export type ApiResponse<T> = ApiSuccessResponse<T> | ApiErrorResponse;
+//# sourceMappingURL=api.d.ts.map

package/dist/types/api.js

@@ -0,0 +1,5 @@
+"use strict";
+// Auto-generated from API Zod schemas — do not edit manually.
+// Run `npm run build` to regenerate.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=api.js.map

package/dist/types/domains.d.ts

@@ -0,0 +1,11 @@
+export declare namespace Domains {
+    type DomainLookupParams = {
+        domain: string;
+    };
+    type DomainLookup = {
+        domain: string;
+        expires_at?: string;
+        registered_at?: string;
+        registrar?: string;
+    };
+}

package/dist/types/domains.js

@@ -0,0 +1,3 @@
+"use strict";
+// Auto-generated from our API
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/emails.d.ts

@@ -0,0 +1,33 @@
+export declare namespace Emails {
+    type EmailVerificationParams = {
+        email: string;
+    };
+    type EmailVerification = {
+        status: Status;
+        checks: Checks;
+    };
+    type LookupParams = EmailVerificationParams | {
+        name: string;
+        company: string;
+    } | {
+        linkedin_url: string;
+    };
+    type SearchParams = {
+        domain: string;
+        email?: string;
+    };
+    type CheckStatus = Status;
+    type Status = "valid" | "skipped" | "invalid" | "unknown" | "risky";
+    type CheckResult = {
+        status: Status;
+        passed: boolean;
+        reason?: string;
+    };
+    type Checks = {
+        format: CheckResult;
+        disposable: CheckResult;
+        dns: CheckResult;
+        mx: CheckResult;
+        smtp: CheckResult;
+    };
+}

package/dist/types/emails.js

@@ -0,0 +1,3 @@
+"use strict";
+// Auto-generated from our API
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./emails";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.js

@@ -0,0 +1,19 @@
+"use strict";
+// Auto-generated from our API
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./emails"), exports);
+//# sourceMappingURL=index.js.map

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "leadmeteor",
+  "version": "0.0.1",
+  "description": "Official Leadmeteor SDK for Node.js",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "prebuild": "node scripts/generate-types.mjs",
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["leadmeteor", "email-verification", "sdk"],
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}