@hasna/contacts 0.8.1 → 0.9.0

package/dist/cli/status-domain.preload.d.ts

@@ -1,2 +1,2 @@
-declare const originalFetch: typeof fetch;
+export {};
 //# sourceMappingURL=status-domain.preload.d.ts.map

package/dist/cli/status-domain.preload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status-domain.preload.d.ts","sourceRoot":"","sources":["../../src/cli/status-domain.preload.ts"],"names":[],"mappings":"AAKA,QAAA,MAAM,aAAa,cAAmB,CAAC"}
+{"version":3,"file":"status-domain.preload.d.ts","sourceRoot":"","sources":["../../src/cli/status-domain.preload.ts"],"names":[],"mappings":""}

package/dist/cli/status-fixture.d.ts

@@ -0,0 +1,17 @@
+export type StatusFixtureMode = "unconfigured" | "failure" | "success";
+export declare const fixtureStation = "contacts-status-fixture";
+export declare const envFixtureKey = "status-fixture-key";
+export declare const diskFixtureKey = "disk-key-not-a-real-secret";
+export declare function statusFixtureEnv(): Record<string, string>;
+export declare function statusFixtureCommand(home: string, command: string[]): string[];
+export declare function runStatusFixture(args: string[], env: Record<string, string>, mode?: StatusFixtureMode): {
+    exitCode: number | null;
+    pid: number;
+    output: (string | null)[];
+    stdout: string;
+    stderr: string;
+    status: number | null;
+    signal: NodeJS.Signals | null;
+    error?: Error;
+};
+//# sourceMappingURL=status-fixture.d.ts.map

package/dist/cli/status-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-fixture.d.ts","sourceRoot":"","sources":["../../src/cli/status-fixture.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,SAAS,GAAG,SAAS,CAAC;AACvE,eAAO,MAAM,cAAc,4BAA4B,CAAC;AACxD,eAAO,MAAM,aAAa,uBAAuB,CAAC;AAClD,eAAO,MAAM,cAAc,+BAA+B,CAAC;AAE3D,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWzD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAuB9E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,GAAE,iBAAkC;;;;;;;;;EAYrH"}

package/dist/index.js

@@ -316,6 +316,39 @@ function stripUndefined(input) {
   return out;
 }
 
+class ContactsApiResponseError extends Error {
+  constructor(operation, detail) {
+    super(`contacts: malformed /v1 response for ${operation}: ${detail}`);
+    this.name = "ContactsApiResponseError";
+  }
+}
+function requireAppendedContact(response, contactId, collection, matchKey, value) {
+  const operation = collection === "emails" ? "addEmailToContact" : "addPhoneToContact";
+  const contact = pick(response, "contact");
+  if (!contact || typeof contact !== "object" || Array.isArray(contact)) {
+    throw new ContactsApiResponseError(operation, "expected an object at response.contact");
+  }
+  if (contact.id !== contactId) {
+    throw new ContactsApiResponseError(operation, "response.contact.id did not match the requested contact");
+  }
+  const items = contact[collection];
+  if (!Array.isArray(items)) {
+    throw new ContactsApiResponseError(operation, `response.contact.${collection} was not an array`);
+  }
+  const normalize = collection === "emails" ? (input) => input.toLowerCase() : (input) => input;
+  const wanted = normalize(value);
+  const appended = items.find((item) => {
+    if (!item || typeof item !== "object" || Array.isArray(item))
+      return false;
+    const record = item;
+    return typeof record.id === "string" && record.contact_id === contactId && typeof record[matchKey] === "string" && normalize(record[matchKey]) === wanted;
+  });
+  if (!appended) {
+    throw new ContactsApiResponseError(operation, `response.contact.${collection} did not contain the requested value`);
+  }
+  return contact;
+}
+
 class ApiStore {
   client;
   mode = "api";
@@ -385,11 +418,17 @@ class ApiStore {
   async mergeContacts() {
     return unavailable("mergeContacts");
   }
-  async addEmailToContact() {
-    return unavailable("addEmailToContact");
+  async addEmailToContact(contactId, email) {
+    const res = await this.patch(`/contacts/${this.enc(contactId)}`, {
+      emails_add: [stripUndefined(email)]
+    });
+    return requireAppendedContact(res, contactId, "emails", "address", email.address);
   }
-  async addPhoneToContact() {
-    return unavailable("addPhoneToContact");
+  async addPhoneToContact(contactId, phone) {
+    const res = await this.patch(`/contacts/${this.enc(contactId)}`, {
+      phones_add: [stripUndefined(phone)]
+    });
+    return requireAppendedContact(res, contactId, "phones", "number", phone.number);
   }
   async archiveContact() {
     return unavailable("archiveContact");

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

@@ -19,8 +19,8 @@ export declare const AudiencePredicateContractSchema: z.ZodEffects<z.ZodObject<{
     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";
+    kind: "tag" | "attribute" | "group";
     key?: string | undefined;
     value?: string | number | boolean | undefined;
 }, {
@@ -31,8 +31,8 @@ export declare const AudiencePredicateContractSchema: z.ZodEffects<z.ZodObject<{
     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";
+    kind: "tag" | "attribute" | "group";
     key?: string | undefined;
     value?: string | number | boolean | undefined;
 }, {
@@ -52,8 +52,8 @@ export declare const AudienceDefinitionContractSchema: z.ZodObject<{
         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";
+        kind: "tag" | "attribute" | "group";
         key?: string | undefined;
         value?: string | number | boolean | undefined;
     }, {
@@ -64,8 +64,8 @@ export declare const AudienceDefinitionContractSchema: z.ZodObject<{
         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";
+        kind: "tag" | "attribute" | "group";
         key?: string | undefined;
         value?: string | number | boolean | undefined;
     }, {
@@ -79,8 +79,8 @@ export declare const AudienceDefinitionContractSchema: z.ZodObject<{
     match: "all" | "any";
     predicates: {
         values: (string | number | boolean)[];
-        kind: "tag" | "attribute" | "group";
         op: "eq" | "neq" | "in" | "not_in" | "exists" | "not_exists";
+        kind: "tag" | "attribute" | "group";
         key?: string | undefined;
         value?: string | number | boolean | undefined;
     }[];
@@ -113,8 +113,8 @@ export declare const AudienceContractSchema: z.ZodObject<{
             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";
+            kind: "tag" | "attribute" | "group";
             key?: string | undefined;
             value?: string | number | boolean | undefined;
         }, {
@@ -125,8 +125,8 @@ export declare const AudienceContractSchema: z.ZodObject<{
             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";
+            kind: "tag" | "attribute" | "group";
             key?: string | undefined;
             value?: string | number | boolean | undefined;
         }, {
@@ -140,8 +140,8 @@ export declare const AudienceContractSchema: z.ZodObject<{
         match: "all" | "any";
         predicates: {
             values: (string | number | boolean)[];
-            kind: "tag" | "attribute" | "group";
             op: "eq" | "neq" | "in" | "not_in" | "exists" | "not_exists";
+            kind: "tag" | "attribute" | "group";
             key?: string | undefined;
             value?: string | number | boolean | undefined;
         }[];
@@ -167,8 +167,8 @@ export declare const AudienceContractSchema: z.ZodObject<{
         match: "all" | "any";
         predicates: {
             values: (string | number | boolean)[];
-            kind: "tag" | "attribute" | "group";
             op: "eq" | "neq" | "in" | "not_in" | "exists" | "not_exists";
+            kind: "tag" | "attribute" | "group";
             key?: string | undefined;
             value?: string | number | boolean | undefined;
         }[];

package/dist/lib/compact-output.d.ts

@@ -0,0 +1,67 @@
+import type { ContactWithDetails } from "../types/index.js";
+export declare const CONTACTS_COMPACT_LIMIT = 20;
+export declare const CONTACTS_MAX_LIMIT = 500;
+export declare function normalizeContactsLimit(value: unknown, fallback?: number): number;
+export declare function normalizeContactsOffset(value: unknown): number;
+export declare function summarizeContact(contact: ContactWithDetails): {
+    id: string;
+    display_name: string;
+    job_title: string | null;
+    company: {
+        id: string;
+        name: string;
+    } | null;
+    primary_email: string;
+    primary_phone: string;
+    status: import("../index.js").ContactStatus;
+    follow_up_at: string | null;
+    last_contacted_at: string | null;
+    archived: boolean;
+    sensitivity: import("../index.js").Sensitivity;
+    tags: {
+        id: string;
+        name: string;
+    }[];
+    updated_at: string;
+};
+export declare function compareContactsByDisplayNameAndId(left: Pick<ContactWithDetails, "display_name" | "id">, right: Pick<ContactWithDetails, "display_name" | "id">): number;
+export declare function compactContactsPage(contacts: ContactWithDetails[], options: {
+    total: number;
+    limit: number;
+    offset: number;
+}): {
+    contacts: {
+        id: string;
+        display_name: string;
+        job_title: string | null;
+        company: {
+            id: string;
+            name: string;
+        } | null;
+        primary_email: string;
+        primary_phone: string;
+        status: import("../index.js").ContactStatus;
+        follow_up_at: string | null;
+        last_contacted_at: string | null;
+        archived: boolean;
+        sensitivity: import("../index.js").Sensitivity;
+        tags: {
+            id: string;
+            name: string;
+        }[];
+        updated_at: string;
+    }[];
+    count: number;
+    total: number;
+    limit: number;
+    cursor: number;
+    next_cursor: number | null;
+    has_more: boolean;
+    compact: true;
+    sort: {
+        fields: string[];
+        direction: "asc";
+    };
+    hint: string;
+};
+//# sourceMappingURL=compact-output.d.ts.map

package/dist/lib/compact-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact-output.d.ts","sourceRoot":"","sources":["../../src/lib/compact-output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAyB,GAAG,MAAM,CAIhG;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI9D;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB;;;;;;;;;;;;;;;;;;;;EAgB3D;AAED,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,IAAI,CAAC,kBAAkB,EAAE,cAAc,GAAG,IAAI,CAAC,EACrD,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE,cAAc,GAAG,IAAI,CAAC,GACrD,MAAM,CAER;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,kBAAkB,EAAE,EAC9B,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkB1D"}

package/dist/mcp/handlers/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/mcp/handlers/core.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA2C9C,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CA+YpD,CAAC"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/mcp/handlers/core.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA4C9C,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CA0YpD,CAAC"}

package/dist/mcp/index.d.ts

@@ -1,6 +1,7 @@
 #!/usr/bin/env bun
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function buildServer(): McpServer;
+import { type ContactsMcpProfile } from "./profile.js";
+export declare function buildServer(profile?: ContactsMcpProfile): McpServer;
 /**
  * Classify early-exit arguments before any http-mode parse, server build, or
  * stdio bind. `--help` / `--version` answer with rc=0 and the MCP server never

package/dist/mcp/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiBpE,wBAAgB,WAAW,IAAI,SAAS,CAKvC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAI5E;AAED,wBAAgB,QAAQ,IAAI,MAAM,CASjC;AA0CD,wBAAgB,gBAAgB,CAAC,KAAK,SAAkB,GAAG,OAAO,CAIjE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,OAAO,EAA6B,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAYlF,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAA2B,GAAG,SAAS,CAQ3E;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAI5E;AAED,wBAAgB,QAAQ,IAAI,MAAM,CAWjC;AA4CD,wBAAgB,gBAAgB,CAAC,KAAK,SAAkB,GAAG,OAAO,CAIjE"}