indiecrm-cli 0.1.0 → 0.2.1

package/dist/icp-templates.js

@@ -0,0 +1,171 @@
+import { IcpSchema } from "./domain.js";
+const DEEL_SHARED_TEMPLATE = {
+    name: "Deel ICP",
+    description: "Mid-market and enterprise companies that hire or pay across borders and feel payroll, compliance, HRIS, onboarding, or contractor complexity.",
+    industries: [
+        "Software",
+        "Financial Services",
+        "Manufacturing",
+        "Retail",
+        "Logistics & Supply Chain",
+        "Healthcare",
+        "Information Technology & Services",
+        "Management Consulting"
+    ],
+    companySizes: ["200-499", "500+"],
+    titles: [
+        "Chief People Officer",
+        "CHRO",
+        "VP People",
+        "Head of People",
+        "Head of People Operations",
+        "Head of People & Culture",
+        "VP HR",
+        "Head of HR",
+        "Head of Human Resources",
+        "HR Director",
+        "People Operations Manager",
+        "HR Operations Manager",
+        "Personalleitung",
+        "Leitung Personal",
+        "Leiter Personal",
+        "Leiter der Personalabteilung",
+        "Bereichsleiter Personal",
+        "Leiterin Personal",
+        "Head of Talent Acquisition",
+        "VP Talent Acquisition",
+        "Head of Payroll",
+        "Payroll Manager",
+        "HRIS Manager",
+        "CFO",
+        "Finance Director",
+        "General Counsel",
+        "Legal Operations Manager"
+    ],
+    pains: [
+        "international hiring",
+        "global payroll",
+        "local compliance",
+        "worker classification",
+        "entity setup delays",
+        "multi-country onboarding",
+        "fragmented HR systems"
+    ],
+    requiredSignals: [
+        "international expansion",
+        "multi-country payroll",
+        "distributed workforce",
+        "cross-border hiring",
+        "contractor workforce"
+    ],
+    excludedSignals: ["single-country only", "local-only hiring"],
+    keywords: [
+        "global payroll",
+        "international hiring",
+        "global hiring",
+        "employer of record",
+        "EOR",
+        "contractor management",
+        "worker compliance",
+        "HRIS",
+        "onboarding",
+        "benefits",
+        "global mobility"
+    ],
+    excludedKeywords: ["staffing agency", "recruitment agency", "temporary labor"]
+};
+const DEEL_MARKETS = {
+    global: {
+        regions: ["Global"],
+        countries: []
+    },
+    europe: {
+        regions: ["Europe"],
+        countries: ["DE", "AT", "CH", "NL", "GB", "FR", "SE", "DK"]
+    },
+    dach: {
+        regions: ["Europe", "DACH"],
+        countries: ["DE", "AT", "CH"]
+    }
+};
+const DEEL_HISTORICAL_HR_TITLE_EXPANSION = [
+    "Head of HR",
+    "Head of Human Resources",
+    "Head of People",
+    "Head of People Operations",
+    "Head of People & Culture",
+    "Head of People Relations",
+    "Head of Payroll",
+    "Head of HR Payroll",
+    "Head of HR Germany",
+    "Head of HR Business Partner",
+    "Head of HR Business Partners",
+    "Head of HR Management",
+    "Head of HR Administration",
+    "Head of HR Processes",
+    "Head of People Development",
+    "Leiter Personal",
+    "Leiter der Personalabteilung",
+    "Personalleitung",
+    "Geschaeftsbereichsleiter Personal",
+    "Geschaeftsbereichsleiter Personal",
+    "Bereichsleiter Personal",
+    "HR Director",
+    "Director HR",
+    "CHRO",
+    "Chief People Officer"
+];
+function mapHeadcountToIcpBucket(value) {
+    const normalized = value.trim();
+    if (normalized === "201-500") {
+        return "200-499";
+    }
+    if (["501-1000", "1001-5000", "5001-10,000", "5001-10.000", "10,000+", "10.000+", "10,001+"].includes(normalized)) {
+        return "500+";
+    }
+    return null;
+}
+export function buildHistoricalVendorIcp(vendor, market, report) {
+    if (vendor !== "deel") {
+        throw new Error(`Unsupported vendor template: ${vendor}`);
+    }
+    const includesHumanResources = report.functionValuesTop.some((entry) => entry.text === "Human Resources" && entry.selection === "INCLUDED");
+    if (!includesHumanResources) {
+        throw new Error("historical report does not contain included Human Resources function filters");
+    }
+    const marketTemplate = DEEL_MARKETS[market];
+    const companySizes = Array.from(new Set(report.headcountValuesTop
+        .filter((entry) => entry.selection === "INCLUDED")
+        .map((entry) => mapHeadcountToIcpBucket(entry.text))
+        .filter((value) => value !== null)));
+    return IcpSchema.parse({
+        name: `Deel Historical ICP ${market.toUpperCase()}`,
+        description: "DACH historical HR search pattern for Deel. Built from LinkedIn Sales Navigator query history and expanded to the observed HR leadership title family in the lead pool.",
+        industries: [],
+        companySizes: companySizes.length > 0 ? companySizes : ["200-499", "500+"],
+        regions: marketTemplate.regions,
+        countries: marketTemplate.countries,
+        titles: Array.from(new Set(DEEL_HISTORICAL_HR_TITLE_EXPANSION)),
+        pains: ["international hiring", "global payroll", "local compliance", "multi-country onboarding"],
+        requiredSignals: [
+            "human resources function",
+            "mid-market or enterprise company",
+            "DACH headquarters or operations"
+        ],
+        excludedSignals: [],
+        keywords: [],
+        excludedKeywords: []
+    });
+}
+export function buildVendorIcp(vendor, market) {
+    if (vendor !== "deel") {
+        throw new Error(`Unsupported vendor template: ${vendor}`);
+    }
+    const marketTemplate = DEEL_MARKETS[market];
+    return IcpSchema.parse({
+        ...DEEL_SHARED_TEMPLATE,
+        name: market === "global" ? "Deel ICP" : `Deel ICP ${market.toUpperCase()}`,
+        regions: marketTemplate.regions,
+        countries: marketTemplate.countries
+    });
+}

package/dist/indiecrm/commands.js

@@ -0,0 +1,108 @@
+import { connect, hasSession, login, logout } from "./auth.js";
+function positiveInt(value) {
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 1 || parsed > 200)
+        throw new Error("Limit must be between 1 and 200");
+    return parsed;
+}
+function nonnegativeNumber(value) {
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || parsed < 0)
+        throw new Error("Value must be a nonnegative number");
+    return parsed;
+}
+function print(value) {
+    console.log(JSON.stringify(value, null, 2));
+}
+async function call(name, args) {
+    const client = await connect();
+    try {
+        const result = await client.callTool({ name, arguments: args });
+        if (result.isError) {
+            const message = result.content.filter((part) => part.type === "text").map((part) => part.text).join("\n");
+            throw new Error(message || `${name} failed`);
+        }
+        if (result.structuredContent) {
+            print(result.structuredContent);
+            return;
+        }
+        const text = result.content.filter((part) => part.type === "text").map((part) => part.text).join("\n");
+        try {
+            print(JSON.parse(text));
+        }
+        catch {
+            console.log(text);
+        }
+    }
+    finally {
+        await client.close();
+    }
+}
+export function registerCrmCommands(program) {
+    const existingCommands = new Set(program.commands);
+    program.command("login").description("Sign in through indiecrm.app").action(login);
+    program.command("logout").description("Remove the local sign-in session").action(async () => {
+        await logout();
+        console.log("Signed out of IndieCRM CLI.");
+    });
+    program.command("status").description("Show whether a local session is available").action(async () => {
+        print({ signedIn: await hasSession() });
+    });
+    program.command("workspaces").description("List workspaces and app IDs").action(() => call("list_workspaces", {}));
+    program.command("pipeline <app-id>").description("List pipelines and stages for an app")
+        .action((appId) => call("list_pipeline", { appId }));
+    program.command("deals <app-id>").description("List deals for an app")
+        .option("--status <status>", "open, won, or lost")
+        .option("--limit <n>", "maximum rows (1-200)", positiveInt)
+        .action((appId, options) => {
+        if (options.status && !["open", "won", "lost"].includes(options.status))
+            throw new Error("Status must be open, won, or lost");
+        return call("list_deals", { appId, ...options });
+    });
+    program.command("contacts <app-id>").description("List or search contacts")
+        .option("--search <name>", "case-insensitive name search")
+        .option("--limit <n>", "maximum rows (1-200)", positiveInt)
+        .action((appId, options) => call("list_contacts", { appId, ...options }));
+    program.command("companies <app-id>").description("List or search companies")
+        .option("--search <name>", "case-insensitive name search")
+        .option("--limit <n>", "maximum rows (1-200)", positiveInt)
+        .action((appId, options) => call("list_companies", { appId, ...options }));
+    program.command("deal:create <app-id> <title>").description("Create a deal")
+        .option("--value <amount>", "deal value", nonnegativeNumber)
+        .option("--currency <code>", "three-letter currency code")
+        .option("--stage <id>", "stage ID")
+        .option("--contact <id>", "contact ID")
+        .option("--company <id>", "company ID")
+        .option("--notes <text>", "notes")
+        .action((appId, title, options) => {
+        const { stage, contact, company, ...rest } = options;
+        return call("create_deal", { appId, title, ...rest, ...(stage ? { stageId: stage } : {}), ...(contact ? { contactId: contact } : {}), ...(company ? { companyId: company } : {}) });
+    });
+    program.command("deal:move <deal-id> <stage-id>").description("Move a deal to another stage")
+        .action((dealId, stageId) => call("move_deal", { dealId, stageId }));
+    program.command("activity:log <app-id> <deal-id> <body>").description("Add a note, call, email, or meeting to a deal")
+        .option("--kind <kind>", "note, call, email, or meeting", "note")
+        .action((appId, dealId, body, options) => {
+        if (!["note", "call", "email", "meeting"].includes(options.kind))
+            throw new Error("Kind must be note, call, email, or meeting");
+        return call("log_activity", { appId, dealId, body, kind: options.kind });
+    });
+    program.command("tools").description("List the live IndieCRM API tools").action(async () => {
+        const client = await connect();
+        try {
+            print((await client.listTools()).tools.map(({ name, description, inputSchema }) => ({ name, description, inputSchema })));
+        }
+        finally {
+            await client.close();
+        }
+    });
+    program.command("call <tool>").description("Call an IndieCRM API tool with JSON arguments")
+        .requiredOption("--input <json>", "JSON object matching the tool schema")
+        .action((tool, options) => {
+        const input = JSON.parse(options.input);
+        if (!input || Array.isArray(input) || typeof input !== "object")
+            throw new Error("Input must be a JSON object");
+        return call(tool, input);
+    });
+    return new Set(program.commands.filter((command) => !existingCommands.has(command)));
+}

package/dist/indiecrm-cli.js

@@ -1,114 +1,12 @@
 #!/usr/bin/env node
 import { Command } from "commander";
-import { connect, hasSession, login, logout } from "./indiecrm/auth.js";
+import { registerCrmCommands } from "./indiecrm/commands.js";
 import { version } from "./indiecrm/version.js";
 const program = new Command()
     .name("indiecrm")
     .description("Work with your IndieCRM workspaces, contacts, companies, and deals.")
     .version(version);
-function positiveInt(value) {
-    const parsed = Number(value);
-    if (!Number.isInteger(parsed) || parsed < 1 || parsed > 200)
-        throw new Error("Limit must be between 1 and 200");
-    return parsed;
-}
-function nonnegativeNumber(value) {
-    const parsed = Number(value);
-    if (!Number.isFinite(parsed) || parsed < 0)
-        throw new Error("Value must be a nonnegative number");
-    return parsed;
-}
-function print(value) {
-    console.log(JSON.stringify(value, null, 2));
-}
-async function call(name, args) {
-    const client = await connect();
-    try {
-        const result = await client.callTool({ name, arguments: args });
-        if (result.isError) {
-            const message = result.content.filter((part) => part.type === "text").map((part) => part.text).join("\n");
-            throw new Error(message || `${name} failed`);
-        }
-        if (result.structuredContent) {
-            print(result.structuredContent);
-            return;
-        }
-        const text = result.content.filter((part) => part.type === "text").map((part) => part.text).join("\n");
-        try {
-            print(JSON.parse(text));
-        }
-        catch {
-            console.log(text);
-        }
-    }
-    finally {
-        await client.close();
-    }
-}
-program.command("login").description("Sign in through indiecrm.app").action(login);
-program.command("logout").description("Remove the local sign-in session").action(async () => {
-    await logout();
-    console.log("Signed out of IndieCRM CLI.");
-});
-program.command("status").description("Show whether a local session is available").action(async () => {
-    print({ signedIn: await hasSession() });
-});
-program.command("workspaces").description("List workspaces and app IDs").action(() => call("list_workspaces", {}));
-program.command("pipeline <app-id>").description("List pipelines and stages for an app")
-    .action((appId) => call("list_pipeline", { appId }));
-program.command("deals <app-id>").description("List deals for an app")
-    .option("--status <status>", "open, won, or lost")
-    .option("--limit <n>", "maximum rows (1-200)", positiveInt)
-    .action((appId, options) => {
-    if (options.status && !["open", "won", "lost"].includes(options.status))
-        throw new Error("Status must be open, won, or lost");
-    return call("list_deals", { appId, ...options });
-});
-program.command("contacts <app-id>").description("List or search contacts")
-    .option("--search <name>", "case-insensitive name search")
-    .option("--limit <n>", "maximum rows (1-200)", positiveInt)
-    .action((appId, options) => call("list_contacts", { appId, ...options }));
-program.command("companies <app-id>").description("List or search companies")
-    .option("--search <name>", "case-insensitive name search")
-    .option("--limit <n>", "maximum rows (1-200)", positiveInt)
-    .action((appId, options) => call("list_companies", { appId, ...options }));
-program.command("deal:create <app-id> <title>").description("Create a deal")
-    .option("--value <amount>", "deal value", nonnegativeNumber)
-    .option("--currency <code>", "three-letter currency code")
-    .option("--stage <id>", "stage ID")
-    .option("--contact <id>", "contact ID")
-    .option("--company <id>", "company ID")
-    .option("--notes <text>", "notes")
-    .action((appId, title, options) => {
-    const { stage, contact, company, ...rest } = options;
-    return call("create_deal", { appId, title, ...rest, ...(stage ? { stageId: stage } : {}), ...(contact ? { contactId: contact } : {}), ...(company ? { companyId: company } : {}) });
-});
-program.command("deal:move <deal-id> <stage-id>").description("Move a deal to another stage")
-    .action((dealId, stageId) => call("move_deal", { dealId, stageId }));
-program.command("activity:log <app-id> <deal-id> <body>").description("Add a note, call, email, or meeting to a deal")
-    .option("--kind <kind>", "note, call, email, or meeting", "note")
-    .action((appId, dealId, body, options) => {
-    if (!["note", "call", "email", "meeting"].includes(options.kind))
-        throw new Error("Kind must be note, call, email, or meeting");
-    return call("log_activity", { appId, dealId, body, kind: options.kind });
-});
-program.command("tools").description("List the live IndieCRM API tools").action(async () => {
-    const client = await connect();
-    try {
-        print((await client.listTools()).tools.map(({ name, description, inputSchema }) => ({ name, description, inputSchema })));
-    }
-    finally {
-        await client.close();
-    }
-});
-program.command("call <tool>").description("Call an IndieCRM API tool with JSON arguments")
-    .requiredOption("--input <json>", "JSON object matching the tool schema")
-    .action((tool, options) => {
-    const input = JSON.parse(options.input);
-    if (!input || Array.isArray(input) || typeof input !== "object")
-        throw new Error("Input must be a JSON object");
-    return call(tool, input);
-});
+registerCrmCommands(program);
 program.parseAsync(process.argv).catch((error) => {
     console.error(error instanceof Error ? error.message : String(error));
     process.exitCode = 1;

package/dist/instantly.js

@@ -0,0 +1,136 @@
+const DEFAULT_INSTANTLY_BASE_URL = process.env.SALESPROMPTER_INSTANTLY_BASE_URL ?? "https://api.instantly.ai/api/v2";
+function normalizeBaseUrl(baseUrl) {
+    return baseUrl.replace(/\/+$/, "");
+}
+function normalizeEmail(email) {
+    return email.trim().toLowerCase();
+}
+function splitContactName(contactName) {
+    const parts = contactName
+        .trim()
+        .split(/\s+/)
+        .filter((value) => value.length > 0);
+    if (parts.length === 0) {
+        return { firstName: "", lastName: "" };
+    }
+    return {
+        firstName: parts[0] ?? "",
+        lastName: parts.slice(1).join(" ")
+    };
+}
+function buildLeadPayload(lead, campaignId) {
+    const { firstName, lastName } = splitContactName(lead.contactName);
+    return {
+        email: lead.email,
+        first_name: firstName,
+        last_name: lastName,
+        company_name: lead.companyName,
+        campaign_id: campaignId,
+        custom_variables: {
+            companyName: lead.companyName,
+            companyName_original: lead.companyName,
+            companyName_cleaned: lead.companyName,
+            salesprompter_domain: lead.domain,
+            salesprompter_title: lead.title,
+            salesprompter_industry: lead.industry,
+            salesprompter_region: lead.region,
+            salesprompter_employee_count: lead.employeeCount,
+            salesprompter_source: lead.source,
+            salesprompter_score: lead.score,
+            salesprompter_grade: lead.grade,
+            salesprompter_buying_stage: lead.buyingStage,
+            salesprompter_crm_fit: lead.crmFit,
+            salesprompter_outreach_fit: lead.outreachFit,
+            salesprompter_signals: lead.signals.join(", "),
+            salesprompter_tech_stack: lead.techStack.join(", "),
+            salesprompter_rationale: lead.rationale.join(" | "),
+            ...(lead.customVariables ?? {})
+        }
+    };
+}
+async function instantlyRequest(baseUrl, apiKey, path, init) {
+    const response = await fetch(`${normalizeBaseUrl(baseUrl)}${path}`, {
+        ...init,
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            "Content-Type": "application/json",
+            ...(init.headers ?? {})
+        }
+    });
+    const raw = await response.text();
+    const payload = raw.length > 0 ? JSON.parse(raw) : {};
+    if (!response.ok) {
+        throw new Error(`Instantly ${response.status} ${path} -> ${raw}`);
+    }
+    return payload;
+}
+async function listCampaignEmails(baseUrl, apiKey, campaignId) {
+    const emails = new Set();
+    let cursor;
+    for (let page = 0; page < 200; page += 1) {
+        const body = { campaign_id: campaignId, limit: 100 };
+        if (cursor) {
+            body.starting_after = cursor;
+        }
+        const payload = await instantlyRequest(baseUrl, apiKey, "/leads/list", {
+            method: "POST",
+            body: JSON.stringify(body)
+        });
+        for (const item of payload.items ?? []) {
+            const email = normalizeEmail(String(item.email ?? ""));
+            if (email.length > 0) {
+                emails.add(email);
+            }
+        }
+        cursor = payload.next_starting_after;
+        if (!cursor) {
+            break;
+        }
+    }
+    return emails;
+}
+async function createInstantlyLead(baseUrl, apiKey, lead, campaignId) {
+    await instantlyRequest(baseUrl, apiKey, "/leads", {
+        method: "POST",
+        body: JSON.stringify(buildLeadPayload(lead, campaignId))
+    });
+}
+export class InstantlySyncProvider {
+    async sync(target, leads, options = {}) {
+        if (target !== "instantly") {
+            throw new Error(`InstantlySyncProvider cannot handle target: ${target}`);
+        }
+        const campaignId = options.instantlyCampaignId ?? process.env.INSTANTLY_CAMPAIGN_ID;
+        if (!campaignId) {
+            throw new Error("Instantly campaign id is required. Pass --campaign-id or set INSTANTLY_CAMPAIGN_ID.");
+        }
+        const apiKey = options.instantlyApiKey ?? process.env.INSTANTLY_API_KEY;
+        if (!apiKey) {
+            throw new Error("Instantly API key is required. Set INSTANTLY_API_KEY.");
+        }
+        const baseUrl = options.instantlyBaseUrl ?? DEFAULT_INSTANTLY_BASE_URL;
+        const existingEmails = options.allowDuplicates ? new Set() : await listCampaignEmails(baseUrl, apiKey, campaignId);
+        let skipped = 0;
+        let synced = 0;
+        for (const lead of leads) {
+            const email = normalizeEmail(lead.email);
+            if (!options.allowDuplicates && existingEmails.has(email)) {
+                skipped += 1;
+                continue;
+            }
+            if (options.apply) {
+                await createInstantlyLead(baseUrl, apiKey, lead, campaignId);
+            }
+            existingEmails.add(email);
+            synced += 1;
+        }
+        return {
+            target,
+            synced,
+            skipped,
+            dryRun: !options.apply,
+            provider: "instantly",
+            campaignId
+        };
+    }
+}

package/dist/io.js

@@ -0,0 +1,21 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+export async function readJsonFile(filePath, schema) {
+    const content = await readFile(filePath, "utf8");
+    const parsed = JSON.parse(content);
+    return schema.parse(parsed);
+}
+export async function writeJsonFile(filePath, value) {
+    await mkdir(path.dirname(filePath), { recursive: true });
+    await writeFile(filePath, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+}
+export async function writeTextFile(filePath, value) {
+    await mkdir(path.dirname(filePath), { recursive: true });
+    await writeFile(filePath, value, "utf8");
+}
+export function splitCsv(value) {
+    return value
+        .split(",")
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0);
+}