@hasna/contacts 0.6.34 → 0.6.36

package/dist/lib/apple-contacts.d.ts

@@ -0,0 +1,3 @@
+export declare function exportFromApple(): Promise<string>;
+export declare function importToApple(vcfData: string): Promise<void>;
+//# sourceMappingURL=apple-contacts.d.ts.map

package/dist/lib/apple-contacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apple-contacts.d.ts","sourceRoot":"","sources":["../../src/lib/apple-contacts.ts"],"names":[],"mappings":"AAAA,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAQvD;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMlE"}

package/dist/lib/audience-contract.d.ts

@@ -0,0 +1,215 @@
+/**
+ * Vendored minimal mirror of the `hasna.audience.v1` contract from
+ * @hasna/contracts (branch feat/distribution-schemas). The upstream package is
+ * not published yet, so this file mirrors the schema shape 1:1 (strict object,
+ * contract base fields, predicate refinement rules). Once @hasna/contracts
+ * ships, this mirror can be replaced with:
+ *
+ *   import { AudienceSchema, parseContract, SCHEMA_IDS } from "@hasna/contracts/schemas";
+ *   parseContract(SCHEMA_IDS.audience, value);
+ */
+import { z } from "zod";
+import type { Audience } from "../types/index.js";
+export declare const AUDIENCE_CONTRACT_SCHEMA_ID: "hasna.audience.v1";
+export declare const AudiencePredicateContractSchema: z.ZodEffects<z.ZodObject<{
+    kind: z.ZodEnum<["tag", "attribute", "group"]>;
+    key: z.ZodOptional<z.ZodString>;
+    op: z.ZodDefault<z.ZodEnum<["eq", "neq", "in", "not_in", "exists", "not_exists"]>>;
+    value: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+    values: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    values: (string | number | boolean)[];
+    kind: "tag" | "attribute" | "group";
+    op: "eq" | "neq" | "in" | "not_in" | "exists" | "not_exists";
+    key?: string | undefined;
+    value?: string | number | boolean | undefined;
+}, {
+    kind: "tag" | "attribute" | "group";
+    values?: (string | number | boolean)[] | undefined;
+    key?: string | undefined;
+    value?: string | number | boolean | undefined;
+    op?: "eq" | "neq" | "in" | "not_in" | "exists" | "not_exists" | undefined;
+}>, {
+    values: (string | number | boolean)[];
+    kind: "tag" | "attribute" | "group";
+    op: "eq" | "neq" | "in" | "not_in" | "exists" | "not_exists";
+    key?: string | undefined;
+    value?: string | number | boolean | undefined;
+}, {
+    kind: "tag" | "attribute" | "group";
+    values?: (string | number | boolean)[] | undefined;
+    key?: string | undefined;
+    value?: string | number | boolean | undefined;
+    op?: "eq" | "neq" | "in" | "not_in" | "exists" | "not_exists" | undefined;
+}>;
+export declare const AudienceDefinitionContractSchema: z.ZodObject<{
+    match: z.ZodDefault<z.ZodEnum<["all", "any"]>>;
+    predicates: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        kind: z.ZodEnum<["tag", "attribute", "group"]>;
+        key: z.ZodOptional<z.ZodString>;
+        op: z.ZodDefault<z.ZodEnum<["eq", "neq", "in", "not_in", "exists", "not_exists"]>>;
+        value: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        values: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        values: (string | number | boolean)[];
+        kind: "tag" | "attribute" | "group";
+        op: "eq" | "neq" | "in" | "not_in" | "exists" | "not_exists";
+        key?: string | undefined;
+        value?: string | number | boolean | undefined;
+    }, {
+        kind: "tag" | "attribute" | "group";
+        values?: (string | number | boolean)[] | undefined;
+        key?: string | undefined;
+        value?: string | number | boolean | undefined;
+        op?: "eq" | "neq" | "in" | "not_in" | "exists" | "not_exists" | undefined;
+    }>, {
+        values: (string | number | boolean)[];
+        kind: "tag" | "attribute" | "group";
+        op: "eq" | "neq" | "in" | "not_in" | "exists" | "not_exists";
+        key?: string | undefined;
+        value?: string | number | boolean | undefined;
+    }, {
+        kind: "tag" | "attribute" | "group";
+        values?: (string | number | boolean)[] | undefined;
+        key?: string | undefined;
+        value?: string | number | boolean | undefined;
+        op?: "eq" | "neq" | "in" | "not_in" | "exists" | "not_exists" | undefined;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    match: "all" | "any";
+    predicates: {
+        values: (string | number | boolean)[];
+        kind: "tag" | "attribute" | "group";
+        op: "eq" | "neq" | "in" | "not_in" | "exists" | "not_exists";
+        key?: string | undefined;
+        value?: string | number | boolean | undefined;
+    }[];
+}, {
+    predicates: {
+        kind: "tag" | "attribute" | "group";
+        values?: (string | number | boolean)[] | undefined;
+        key?: string | undefined;
+        value?: string | number | boolean | undefined;
+        op?: "eq" | "neq" | "in" | "not_in" | "exists" | "not_exists" | undefined;
+    }[];
+    match?: "all" | "any" | undefined;
+}>;
+export declare const ConsentPolicyContractSchema: z.ZodEnum<["opt_in", "opt_out", "transactional", "none"]>;
+export declare const AudienceContractSchema: z.ZodObject<{
+    schema: z.ZodLiteral<"hasna.audience.v1">;
+    id: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    audienceId: z.ZodString;
+    name: z.ZodString;
+    definition: z.ZodObject<{
+        match: z.ZodDefault<z.ZodEnum<["all", "any"]>>;
+        predicates: z.ZodArray<z.ZodEffects<z.ZodObject<{
+            kind: z.ZodEnum<["tag", "attribute", "group"]>;
+            key: z.ZodOptional<z.ZodString>;
+            op: z.ZodDefault<z.ZodEnum<["eq", "neq", "in", "not_in", "exists", "not_exists"]>>;
+            value: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+            values: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>, "many">>;
+        }, "strict", z.ZodTypeAny, {
+            values: (string | number | boolean)[];
+            kind: "tag" | "attribute" | "group";
+            op: "eq" | "neq" | "in" | "not_in" | "exists" | "not_exists";
+            key?: string | undefined;
+            value?: string | number | boolean | undefined;
+        }, {
+            kind: "tag" | "attribute" | "group";
+            values?: (string | number | boolean)[] | undefined;
+            key?: string | undefined;
+            value?: string | number | boolean | undefined;
+            op?: "eq" | "neq" | "in" | "not_in" | "exists" | "not_exists" | undefined;
+        }>, {
+            values: (string | number | boolean)[];
+            kind: "tag" | "attribute" | "group";
+            op: "eq" | "neq" | "in" | "not_in" | "exists" | "not_exists";
+            key?: string | undefined;
+            value?: string | number | boolean | undefined;
+        }, {
+            kind: "tag" | "attribute" | "group";
+            values?: (string | number | boolean)[] | undefined;
+            key?: string | undefined;
+            value?: string | number | boolean | undefined;
+            op?: "eq" | "neq" | "in" | "not_in" | "exists" | "not_exists" | undefined;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        match: "all" | "any";
+        predicates: {
+            values: (string | number | boolean)[];
+            kind: "tag" | "attribute" | "group";
+            op: "eq" | "neq" | "in" | "not_in" | "exists" | "not_exists";
+            key?: string | undefined;
+            value?: string | number | boolean | undefined;
+        }[];
+    }, {
+        predicates: {
+            kind: "tag" | "attribute" | "group";
+            values?: (string | number | boolean)[] | undefined;
+            key?: string | undefined;
+            value?: string | number | boolean | undefined;
+            op?: "eq" | "neq" | "in" | "not_in" | "exists" | "not_exists" | undefined;
+        }[];
+        match?: "all" | "any" | undefined;
+    }>;
+    consentPolicy: z.ZodEnum<["opt_in", "opt_out", "transactional", "none"]>;
+    suppressionSyncedAt: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    id: string;
+    schema: "hasna.audience.v1";
+    createdAt: string;
+    audienceId: string;
+    definition: {
+        match: "all" | "any";
+        predicates: {
+            values: (string | number | boolean)[];
+            kind: "tag" | "attribute" | "group";
+            op: "eq" | "neq" | "in" | "not_in" | "exists" | "not_exists";
+            key?: string | undefined;
+            value?: string | number | boolean | undefined;
+        }[];
+    };
+    consentPolicy: "opt_in" | "opt_out" | "transactional" | "none";
+    metadata?: Record<string, unknown> | undefined;
+    updatedAt?: string | null | undefined;
+    suppressionSyncedAt?: string | undefined;
+}, {
+    name: string;
+    id: string;
+    schema: "hasna.audience.v1";
+    createdAt: string;
+    audienceId: string;
+    definition: {
+        predicates: {
+            kind: "tag" | "attribute" | "group";
+            values?: (string | number | boolean)[] | undefined;
+            key?: string | undefined;
+            value?: string | number | boolean | undefined;
+            op?: "eq" | "neq" | "in" | "not_in" | "exists" | "not_exists" | undefined;
+        }[];
+        match?: "all" | "any" | undefined;
+    };
+    consentPolicy: "opt_in" | "opt_out" | "transactional" | "none";
+    metadata?: Record<string, unknown> | undefined;
+    updatedAt?: string | null | undefined;
+    suppressionSyncedAt?: string | undefined;
+}>;
+export type AudienceContract = z.infer<typeof AudienceContractSchema>;
+/** Map a stored audience row to a hasna.audience.v1 contract document. */
+export declare function toAudienceContract(audience: Audience): AudienceContract;
+/** Validate an arbitrary value against the vendored hasna.audience.v1 mirror. */
+export declare function validateAudienceContract(value: unknown): {
+    ok: true;
+    value: AudienceContract;
+} | {
+    ok: false;
+    issues: {
+        path: string;
+        message: string;
+    }[];
+};
+//# sourceMappingURL=audience-contract.d.ts.map

package/dist/lib/audience-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audience-contract.d.ts","sourceRoot":"","sources":["../../src/lib/audience-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,eAAO,MAAM,2BAA2B,EAAG,mBAA4B,CAAC;AAUxE,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBxC,CAAC;AAEL,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKlC,CAAC;AAEZ,eAAO,MAAM,2BAA2B,2DAAyD,CAAC;AAElG,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAaxB,CAAC;AAEZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,gBAAgB,CAwBvE;AAED,iFAAiF;AACjF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAO3J"}

package/dist/lib/audit.d.ts

@@ -0,0 +1,12 @@
+import type { ContactsDatabase } from "../db/database.js";
+import type { ContactWithDetails } from "../types/index.js";
+export interface AuditResult {
+    contact_id: string;
+    display_name: string;
+    score: number;
+    missing: string[];
+    suggestions: string[];
+}
+export declare function auditContact(contact: ContactWithDetails): AuditResult;
+export declare function listContactAudit(db?: ContactsDatabase): Promise<AuditResult[]>;
+//# sourceMappingURL=audit.d.ts.map

package/dist/lib/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/lib/audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAG5D,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CA2BrE;AAED,wBAAsB,gBAAgB,CAAC,EAAE,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAMpF"}

package/dist/lib/brief.d.ts

@@ -0,0 +1,3 @@
+import type { ContactsDatabase } from "../db/database.js";
+export declare function generateBrief(contactId: string, db?: ContactsDatabase): string;
+//# sourceMappingURL=brief.d.ts.map

package/dist/lib/brief.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brief.d.ts","sourceRoot":"","sources":["../../src/lib/brief.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAQ1D,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,MAAM,CA0D9E"}

package/dist/lib/config.d.ts

@@ -0,0 +1,7 @@
+interface ContactsConfig {
+    db_path?: string;
+}
+export declare function readConfig(): ContactsConfig;
+export declare function writeConfig(config: ContactsConfig): void;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAOA,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,UAAU,IAAI,cAAc,CAG3C;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAGxD"}

package/dist/lib/connector.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Generic connector runner — the scalable foundation for all external service
+ * integrations. Any connector (Gmail, Google Contacts, HubSpot, Salesforce…)
+ * uses this same interface; only the `name` and `args` differ.
+ *
+ * Prerequisites: the target connector must be globally installed and authed:
+ *   bun install -g @hasnaxyz/connect-{name}
+ *   connect-{name} auth login
+ */
+export interface ConnectorRunOptions {
+    /** Connector profile to use (default: "default") */
+    profile?: string;
+    /** Timeout in ms (default: 30_000) */
+    timeout?: number;
+}
+export declare class ConnectorNotInstalledError extends Error {
+    readonly connectorName: string;
+    constructor(connectorName: string);
+}
+export declare class ConnectorAuthError extends Error {
+    readonly connectorName: string;
+    constructor(connectorName: string, detail?: string);
+}
+/**
+ * Execute any connector operation and return the parsed JSON output.
+ *
+ * Usage:
+ *   const messages = await runConnector("gmail", ["messages", "list", "-q", "from:acme.com"]);
+ *   const contacts = await runConnector("googlecontacts", ["contacts", "list"]);
+ */
+export declare function runConnector(name: string, args: string[], opts?: ConnectorRunOptions): Promise<unknown>;
+/**
+ * Returns the path to a connector's token file.
+ * Useful for implementations that need direct API access with refreshed tokens.
+ * Checks canonical path first, then legacy fallback.
+ */
+export declare function getConnectorTokenPath(name: string, profile?: string): string | null;
+/**
+ * Read and parse connector tokens from disk.
+ * Useful when a library needs a raw access token (e.g. for batched REST calls
+ * that would be too slow to do one-at-a-time through the CLI).
+ */
+export declare function readConnectorTokens(name: string, profile?: string): Record<string, unknown>;
+//# sourceMappingURL=connector.d.ts.map

package/dist/lib/connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../src/lib/connector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,mBAAmB;IAClC,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,0BAA2B,SAAQ,KAAK;aACvB,aAAa,EAAE,MAAM;gBAArB,aAAa,EAAE,MAAM;CAOlD;AAED,qBAAa,kBAAmB,SAAQ,KAAK;aACf,aAAa,EAAE,MAAM;gBAArB,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAQnE;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE,mBAAwB,GAC7B,OAAO,CAAC,OAAO,CAAC,CAyDlB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,SAAY,GAAG,MAAM,GAAG,IAAI,CAUtF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,SAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQ9F"}

package/dist/lib/context.d.ts

@@ -0,0 +1,5 @@
+import type { ContactsDatabase } from "../db/database.js";
+export declare function getContactCard(contactId: string, db?: ContactsDatabase): object;
+export declare function getContactBrief(contactId: string, taskContext?: string, db?: ContactsDatabase): object;
+export declare function assembleContext(contactIds: string[], format?: 'meeting_prep' | 'deal_review' | 'outreach' | 'research', db?: ContactsDatabase): Promise<object>;
+//# sourceMappingURL=context.d.ts.map

package/dist/lib/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/lib/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAK1D,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAc/E;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAkCtG;AAED,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,MAAM,GAAE,cAAc,GAAG,aAAa,GAAG,UAAU,GAAG,UAA2B,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAOrL"}

package/dist/lib/dedup.d.ts

@@ -0,0 +1,10 @@
+import type { ContactsDatabase } from "../db/database.js";
+export declare function findEmailDuplicates(db: ContactsDatabase): Array<{
+    email: string;
+    contact_ids: string[];
+}>;
+export declare function findNameDuplicates(db: ContactsDatabase): Array<{
+    contact_ids: [string, string];
+    similarity: number;
+}>;
+//# sourceMappingURL=dedup.d.ts.map

package/dist/lib/dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../../src/lib/dedup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,gBAAgB,GAAG,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CASzG;AAeD,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,gBAAgB,GAAG,KAAK,CAAC;IAAE,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAYrH"}

package/dist/lib/document-scanner.d.ts

@@ -0,0 +1,8 @@
+export interface DocumentScanResult {
+    fields: Record<string, string>;
+    raw_text: string;
+    document_type: string;
+    confidence: number;
+}
+export declare function scanDocument(imageSource: string, docType?: string): Promise<DocumentScanResult>;
+//# sourceMappingURL=document-scanner.d.ts.map

package/dist/lib/document-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-scanner.d.ts","sourceRoot":"","sources":["../../src/lib/document-scanner.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAoGrG"}

package/dist/lib/embeddings.d.ts

@@ -0,0 +1,9 @@
+import type { ContactsDatabase } from "../db/database.js";
+export declare function buildContactEmbeddingText(contact: Record<string, unknown>): string;
+export declare function embedContact(contactId: string, db?: ContactsDatabase): Promise<void>;
+export declare function embedAllContacts(db?: ContactsDatabase): Promise<number>;
+export declare function semanticSearch(query: string, limit?: number, db?: ContactsDatabase): Array<{
+    contact_id: string;
+    score: number;
+}>;
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/lib/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../src/lib/embeddings.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAuB1D,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAclF;AAED,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAW1F;AAED,wBAAsB,gBAAgB,CAAC,EAAE,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAO7E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,KAAK,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAgB7H"}

package/dist/lib/export.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Export contacts to CSV, vCard (.vcf), or JSON formats.
+ * Accepts ContactWithDetails from src/types/index.ts.
+ */
+import type { ContactWithDetails } from "../types/index.js";
+export type ExportContact = ContactWithDetails;
+export declare function exportContacts(format: "json" | "csv" | "vcf", contacts: ExportContact[]): Promise<string>;
+//# sourceMappingURL=export.d.ts.map

package/dist/lib/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/lib/export.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,MAAM,aAAa,GAAG,kBAAkB,CAAC;AAqK/C,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,EAC9B,QAAQ,EAAE,aAAa,EAAE,GACxB,OAAO,CAAC,MAAM,CAAC,CAWjB"}

package/dist/lib/freshness.d.ts

@@ -0,0 +1,19 @@
+import type { ContactsDatabase } from "../db/database.js";
+export interface FreshnessResult {
+    contact_id: string;
+    score: number;
+    breakdown: Record<string, {
+        confidence: string;
+        last_verified?: string;
+        days_ago?: number;
+    }>;
+    needs_enrichment: boolean;
+}
+export declare function getFreshnessScore(contactId: string, db?: ContactsDatabase): FreshnessResult;
+export declare function getStaleContacts(_threshold?: number, db?: ContactsDatabase): Array<{
+    id: string;
+    display_name: string;
+    score: number;
+}>;
+export declare function markFieldVerified(contactId: string, fieldName: string, source: string, db?: ContactsDatabase): void;
+//# sourceMappingURL=freshness.d.ts.map

package/dist/lib/freshness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"freshness.d.ts","sourceRoot":"","sources":["../../src/lib/freshness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7F,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,eAAe,CAoD3F;AAED,wBAAgB,gBAAgB,CAC9B,UAAU,SAAK,EACf,EAAE,CAAC,EAAE,gBAAgB,GACpB,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAW5D;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,EAAE,CAAC,EAAE,gBAAgB,GACpB,IAAI,CAON"}

package/dist/lib/gmail-import.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Gmail contact import — fetches messages matching a query via the connect-gmail
+ * connector, extracts unique senders/recipients, and returns them as
+ * CreateContactInput objects ready to upsert into the local DB.
+ *
+ * Auth: connect-gmail auth login   (run once per profile)
+ * Install: bun install -g @hasnaxyz/connect-gmail
+ */
+import type { CreateContactInput } from "../types/index.js";
+/**
+ * Parse a single RFC 5322 address header value into { name, email } pairs.
+ * Handles: "Name <email>", "<email>", "email", and comma-separated lists.
+ */
+export declare function parseAddressHeader(header: string): Array<{
+    name: string;
+    email: string;
+}>;
+/**
+ * Infer a company name from an email domain.
+ * Returns null for personal/generic domains (gmail, yahoo, hotmail, etc.).
+ */
+export declare function domainToCompany(email: string): string | null;
+/**
+ * Parse display name into first/last name.
+ */
+export declare function parseName(displayName: string): {
+    first_name?: string;
+    last_name?: string;
+};
+export interface GmailImportOptions {
+    query: string;
+    /** Max messages to scan (default 200, max 500) */
+    max_messages?: number;
+    /** Gmail profile to use (default: "default") */
+    gmail_profile?: string;
+    tag_ids?: string[];
+    group_id?: string;
+}
+export interface ExtractedContact {
+    email: string;
+    name: string;
+    company_hint: string | null;
+    contact_input: CreateContactInput;
+}
+/**
+ * Fetch messages matching `query` from Gmail and extract unique contacts.
+ * Uses connect-gmail's stored tokens for auth — no API keys needed in code.
+ * Does NOT write to the database — returns prepared CreateContactInput objects.
+ */
+export declare function extractContactsFromGmail(opts: GmailImportOptions): Promise<ExtractedContact[]>;
+//# sourceMappingURL=gmail-import.d.ts.map

package/dist/lib/gmail-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmail-import.d.ts","sourceRoot":"","sources":["../../src/lib/gmail-import.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAK5D;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAmBzF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgB5D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAO1F;AAID,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,kBAAkB,CAAC;CACnC;AAQD;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAsF7B"}

package/dist/lib/google-contacts.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Google Contacts sync — bidirectional sync between local DB and Google Contacts
+ * via the connect-googlecontacts connector.
+ *
+ * Auth: connect-googlecontacts auth login   (run once per profile)
+ * Install: bun install -g @hasnaxyz/connect-googlecontacts
+ *
+ * Data format: Google People API
+ *   https://developers.google.com/people/api/rest/v1/people
+ */
+import type { ContactWithDetails, CreateContactInput } from "../types/index.js";
+import { ConnectorRunOptions } from "./connector.js";
+interface PeopleName {
+    displayName?: string;
+    givenName?: string;
+    familyName?: string;
+    middleName?: string;
+}
+interface PeopleEmail {
+    value?: string;
+    type?: string;
+    formattedType?: string;
+}
+interface PeoplePhone {
+    value?: string;
+    type?: string;
+    formattedType?: string;
+}
+interface PeopleOrg {
+    name?: string;
+    title?: string;
+    department?: string;
+}
+interface PeopleAddress {
+    streetAddress?: string;
+    city?: string;
+    region?: string;
+    postalCode?: string;
+    country?: string;
+    type?: string;
+}
+interface PeopleBio {
+    value?: string;
+}
+interface PeopleUrl {
+    value?: string;
+    type?: string;
+}
+export interface GooglePerson {
+    resourceName: string;
+    etag?: string;
+    names?: PeopleName[];
+    emailAddresses?: PeopleEmail[];
+    phoneNumbers?: PeoplePhone[];
+    organizations?: PeopleOrg[];
+    addresses?: PeopleAddress[];
+    biographies?: PeopleBio[];
+    urls?: PeopleUrl[];
+    birthdays?: Array<{
+        date?: {
+            year?: number;
+            month?: number;
+            day?: number;
+        };
+    }>;
+}
+export interface GoogleContactsSyncOptions extends ConnectorRunOptions {
+    /** Max contacts to pull per page (connector handles pagination automatically) */
+    page_size?: number;
+    /** Only import contacts matching this query */
+    query?: string;
+}
+export interface GoogleContactsPushOptions extends ConnectorRunOptions {
+    /** If true, update existing Google contact if resourceName is stored in custom_fields */
+    update_existing?: boolean;
+}
+export interface SyncResult {
+    imported: number;
+    updated: number;
+    skipped: number;
+    errors: string[];
+}
+/**
+ * Convert a Google People API person to a CreateContactInput.
+ */
+export declare function googlePersonToContactInput(person: GooglePerson): CreateContactInput;
+/**
+ * Convert a local ContactWithDetails to Google People API create/update args.
+ * Returns the CLI flags for `connect-googlecontacts contacts create`.
+ */
+export declare function contactToGoogleArgs(contact: ContactWithDetails): string[];
+/**
+ * List all contacts from Google Contacts.
+ */
+export declare function listGoogleContacts(opts?: GoogleContactsSyncOptions): Promise<GooglePerson[]>;
+/**
+ * Search contacts in Google Contacts.
+ */
+export declare function searchGoogleContacts(query: string, opts?: ConnectorRunOptions): Promise<GooglePerson[]>;
+/**
+ * Create a new contact in Google Contacts from a local contact.
+ * Returns the Google resource name (e.g. "people/c12345").
+ */
+export declare function pushContactToGoogle(contact: ContactWithDetails, opts?: GoogleContactsPushOptions): Promise<{
+    resourceName: string;
+    action: "created" | "updated";
+}>;
+/**
+ * Sync all Google Contacts into the local database.
+ * Caller is responsible for the actual upsert (pass a db upsert function).
+ * Returns structured CreateContactInput objects ready for upsert.
+ */
+export declare function pullGoogleContactsAsInputs(opts?: GoogleContactsSyncOptions): Promise<CreateContactInput[]>;
+export {};
+//# sourceMappingURL=google-contacts.d.ts.map

package/dist/lib/google-contacts.d.ts.map

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

package/dist/lib/images.d.ts

@@ -0,0 +1,30 @@
+export declare function getImagesDir(): string;
+/**
+ * Save an image for a contact or company.
+ * Accepts a file path (copies it) or base64 data (writes it).
+ * Returns the stored filename (e.g. "abc123.jpg")
+ */
+export declare function saveImage(entityId: string, source: string, options?: {
+    format?: string;
+}): string;
+/**
+ * Get the image path for an entity. Returns null if no image exists.
+ */
+export declare function getImagePath(entityId: string): string | null;
+/**
+ * Get image as base64 data URI for embedding in responses.
+ */
+export declare function getImageAsBase64(entityId: string): string | null;
+/**
+ * Delete an entity's image.
+ */
+export declare function deleteImage(entityId: string): boolean;
+/**
+ * List all stored images.
+ */
+export declare function listImages(): Array<{
+    entity_id: string;
+    filename: string;
+    path: string;
+}>;
+//# sourceMappingURL=images.d.ts.map

package/dist/lib/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../../src/lib/images.ts"],"names":[],"mappings":"AAcA,wBAAgB,YAAY,IAAI,MAAM,CAGrC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5B,MAAM,CAuCR;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOhE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAWrD;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAQzF"}

package/dist/lib/import.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Import contacts from CSV, vCard (.vcf), or JSON formats.
+ * Returns an array of CreateContactInput objects (matching src/types/index.ts).
+ */
+import type { CreateContactInput } from "../types/index.js";
+export type { CreateContactInput };
+export declare function importFromCsv(data: string): CreateContactInput[];
+export declare function parseLinkedIn(csv: string): CreateContactInput[];
+export declare function importContacts(format: "json" | "csv" | "vcf", data: string): Promise<CreateContactInput[]>;
+//# sourceMappingURL=import.d.ts.map

package/dist/lib/import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../src/lib/import.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,kBAAkB,EASnB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAgHnC,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAGhE;AAuND,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAkD/D;AAUD,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,EAC9B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAa/B"}