@nekutima/biome-sdk 0.19.3 → 0.30.0

package/dist/contacts/contact.model.d.ts

@@ -0,0 +1,97 @@
+import type { Task } from '../tasks/task.model';
+export type ContactEmailType = 'home' | 'work' | 'other';
+export type ContactPhoneType = 'home' | 'work' | 'mobile' | 'other';
+export type ContactAddressType = 'home' | 'work' | 'other';
+export interface ContactEmail {
+    type: ContactEmailType;
+    value: string;
+}
+export interface ContactPhone {
+    type: ContactPhoneType;
+    value: string;
+}
+export interface ContactAddress {
+    type: ContactAddressType;
+    street?: string;
+    city?: string;
+    region?: string;
+    postalCode?: string;
+    country?: string;
+}
+export interface Contact {
+    id?: number;
+    ownerId: number;
+    /** Stable vCard UID, assigned once on creation. */
+    uid: string;
+    /** vCard FN (formatted name). */
+    displayName: string;
+    givenName?: string | null;
+    familyName?: string | null;
+    nickname?: string | null;
+    organization?: string | null;
+    jobTitle?: string | null;
+    emails: ContactEmail[];
+    phones: ContactPhone[];
+    addresses: ContactAddress[];
+    notes?: string | null;
+    /** Biome user account that is the same person as this contact, if associated. */
+    linkedUserId?: number | null;
+    createdAt?: Date | string;
+    /** Doubles as the vCard REV-equivalent value. */
+    updatedAt?: Date | string;
+}
+export interface CreateContactRequest {
+    displayName: string;
+    givenName?: string;
+    familyName?: string;
+    nickname?: string;
+    organization?: string;
+    jobTitle?: string;
+    emails?: ContactEmail[];
+    phones?: ContactPhone[];
+    addresses?: ContactAddress[];
+    notes?: string;
+}
+export interface UpdateContactRequest {
+    displayName?: string;
+    givenName?: string | null;
+    familyName?: string | null;
+    nickname?: string | null;
+    organization?: string | null;
+    jobTitle?: string | null;
+    emails?: ContactEmail[];
+    phones?: ContactPhone[];
+    addresses?: ContactAddress[];
+    notes?: string | null;
+}
+export interface ContactListResponse {
+    data: Contact[];
+    total: number;
+}
+export interface ContactCircleSummary {
+    id: number;
+    name: string;
+}
+/**
+ * A task the contact owner attached to a contact as a **private reminder**.
+ * Visible only to the contact owner (never to the linked user or task
+ * participants) — see ADR-0016.
+ */
+export interface ContactTask {
+    taskId: number;
+    /** The owner's private reminder text about this task/contact. */
+    note?: string | null;
+    /** Task summary for display (present on list/attach). */
+    task?: Task;
+}
+export interface AttachContactTaskRequest {
+    taskId: number;
+    note?: string;
+}
+/** Reverse view: one of the operator's contacts linked to a task (owner-private). */
+export interface ContactTaskLink {
+    contactId: number;
+    contactName: string;
+    note?: string | null;
+}
+//# sourceMappingURL=contact.model.d.ts.map

package/dist/contacts/contact.model.d.ts.map

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

package/dist/contacts/contact.model.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=contact.model.js.map

package/dist/contacts/contact.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contact.model.js","sourceRoot":"","sources":["../../src/contacts/contact.model.ts"],"names":[],"mappings":""}

package/dist/contacts/contact.schema.json

@@ -0,0 +1,312 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "definitions": {
+    "Contact": {
+      "additionalProperties": true,
+      "properties": {
+        "addresses": {
+          "items": {
+            "$ref": "#/definitions/ContactAddress"
+          },
+          "type": "array"
+        },
+        "createdAt": {
+          "anyOf": [
+            {
+              "format": "date-time",
+              "type": "string"
+            },
+            {
+              "type": "string"
+            }
+          ]
+        },
+        "displayName": {
+          "description": "vCard FN (formatted name).",
+          "type": "string"
+        },
+        "emails": {
+          "items": {
+            "$ref": "#/definitions/ContactEmail"
+          },
+          "type": "array"
+        },
+        "familyName": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "givenName": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "id": {
+          "type": "number"
+        },
+        "jobTitle": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "linkedUserId": {
+          "description": "Biome user account that is the same person as this contact, if associated.",
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "nickname": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "notes": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "organization": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "ownerId": {
+          "type": "number"
+        },
+        "phones": {
+          "items": {
+            "$ref": "#/definitions/ContactPhone"
+          },
+          "type": "array"
+        },
+        "uid": {
+          "description": "Stable vCard UID, assigned once on creation.",
+          "type": "string"
+        },
+        "updatedAt": {
+          "anyOf": [
+            {
+              "format": "date-time",
+              "type": "string"
+            },
+            {
+              "type": "string"
+            }
+          ],
+          "description": "Doubles as the vCard REV-equivalent value."
+        }
+      },
+      "required": [
+        "ownerId",
+        "uid",
+        "displayName",
+        "emails",
+        "phones",
+        "addresses"
+      ],
+      "type": "object"
+    },
+    "ContactAddress": {
+      "additionalProperties": true,
+      "properties": {
+        "city": {
+          "type": "string"
+        },
+        "country": {
+          "type": "string"
+        },
+        "postalCode": {
+          "type": "string"
+        },
+        "region": {
+          "type": "string"
+        },
+        "street": {
+          "type": "string"
+        },
+        "type": {
+          "$ref": "#/definitions/ContactAddressType"
+        }
+      },
+      "required": [
+        "type"
+      ],
+      "type": "object"
+    },
+    "ContactAddressType": {
+      "enum": [
+        "home",
+        "work",
+        "other"
+      ],
+      "type": "string"
+    },
+    "ContactEmail": {
+      "additionalProperties": true,
+      "properties": {
+        "type": {
+          "$ref": "#/definitions/ContactEmailType"
+        },
+        "value": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "type",
+        "value"
+      ],
+      "type": "object"
+    },
+    "ContactEmailType": {
+      "enum": [
+        "home",
+        "work",
+        "other"
+      ],
+      "type": "string"
+    },
+    "ContactPhone": {
+      "additionalProperties": true,
+      "properties": {
+        "type": {
+          "$ref": "#/definitions/ContactPhoneType"
+        },
+        "value": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "type",
+        "value"
+      ],
+      "type": "object"
+    },
+    "ContactPhoneType": {
+      "enum": [
+        "home",
+        "work",
+        "mobile",
+        "other"
+      ],
+      "type": "string"
+    },
+    "CreateContactRequest": {
+      "additionalProperties": false,
+      "properties": {
+        "addresses": {
+          "items": {
+            "$ref": "#/definitions/ContactAddress"
+          },
+          "type": "array"
+        },
+        "displayName": {
+          "type": "string"
+        },
+        "emails": {
+          "items": {
+            "$ref": "#/definitions/ContactEmail"
+          },
+          "type": "array"
+        },
+        "familyName": {
+          "type": "string"
+        },
+        "givenName": {
+          "type": "string"
+        },
+        "jobTitle": {
+          "type": "string"
+        },
+        "nickname": {
+          "type": "string"
+        },
+        "notes": {
+          "type": "string"
+        },
+        "organization": {
+          "type": "string"
+        },
+        "phones": {
+          "items": {
+            "$ref": "#/definitions/ContactPhone"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "displayName"
+      ],
+      "type": "object"
+    },
+    "UpdateContactRequest": {
+      "additionalProperties": false,
+      "properties": {
+        "addresses": {
+          "items": {
+            "$ref": "#/definitions/ContactAddress"
+          },
+          "type": "array"
+        },
+        "displayName": {
+          "type": "string"
+        },
+        "emails": {
+          "items": {
+            "$ref": "#/definitions/ContactEmail"
+          },
+          "type": "array"
+        },
+        "familyName": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "givenName": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "jobTitle": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "nickname": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "notes": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "organization": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "phones": {
+          "items": {
+            "$ref": "#/definitions/ContactPhone"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    }
+  }
+}

package/dist/contacts/contact.service.d.ts

@@ -0,0 +1,28 @@
+import { BiomeHttpClient } from '../core/http-client';
+import { Contact, ContactCircleSummary, ContactListResponse, ContactTask, AttachContactTaskRequest, CreateContactRequest, UpdateContactRequest } from './contact.model';
+export declare class BiomeContacts {
+    private http;
+    constructor(http: BiomeHttpClient);
+    list(): Promise<ContactListResponse>;
+    /**
+     * Searches the caller's own contacts by displayName/organization/nickname.
+     * Kept separate from list() so callers get an always-fresh, uncached call
+     * (list()'s FE wrapper caches its "give me everything" result).
+     */
+    search(keyword?: string, limit?: number): Promise<Contact[]>;
+    get(id: number): Promise<Contact>;
+    create(data: CreateContactRequest): Promise<Contact>;
+    update(id: number, data: UpdateContactRequest): Promise<Contact>;
+    delete(id: number): Promise<void>;
+    listCircles(id: number): Promise<ContactCircleSummary[]>;
+    /** Associates a contact with the Biome user account that is the same person. */
+    linkUser(id: number, userId: number): Promise<Contact>;
+    unlinkUser(id: number): Promise<Contact>;
+    /** The tasks the operator attached to this contact as private reminders. */
+    listTasks(id: number): Promise<ContactTask[]>;
+    /** Attach a task the operator is involved in to this contact, with an optional note. */
+    attachTask(id: number, data: AttachContactTaskRequest): Promise<ContactTask>;
+    updateTaskNote(id: number, taskId: number, note: string): Promise<ContactTask>;
+    detachTask(id: number, taskId: number): Promise<void>;
+}
+//# sourceMappingURL=contact.service.d.ts.map

package/dist/contacts/contact.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contact.service.d.ts","sourceRoot":"","sources":["../../src/contacts/contact.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,WAAW,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAExK,qBAAa,aAAa;IACV,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,eAAe;IAEnC,IAAI,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAM1C;;;;OAIG;IACG,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAkBxD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMjC,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAMpD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAShE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAM9D,gFAAgF;IAC1E,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMtD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ9C,4EAA4E;IACtE,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAMnD,wFAAwF;IAClF,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC;IAM5E,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAM9E,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAI9D"}

package/dist/contacts/contact.service.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BiomeContacts = void 0;
+const error_handler_1 = require("../core/error-handler");
+class BiomeContacts {
+    constructor(http) {
+        this.http = http;
+    }
+    async list() {
+        const response = await this.http.get('/contacts');
+        if (!response.isSuccess)
+            throw (0, error_handler_1.createSdkError)(response);
+        return response.payload;
+    }
+    /**
+     * Searches the caller's own contacts by displayName/organization/nickname.
+     * Kept separate from list() so callers get an always-fresh, uncached call
+     * (list()'s FE wrapper caches its "give me everything" result).
+     */
+    async search(keyword, limit = 20) {
+        // Whitespace-only keyword is a deliberate no-match, mirroring BiomeUsers.findUsers:
+        // '' is valid (returns all, respecting limit), but '   '/'\t' returns [] without a call.
+        if (keyword !== undefined && keyword.length > 0 && keyword.trim().length === 0) {
+            return [];
+        }
+        const params = new URLSearchParams();
+        if (keyword !== undefined && keyword.trim().length > 0) {
+            params.set('q', keyword);
+        }
+        params.set('limit', String(Math.min(Math.max(1, limit), 100)));
+        const response = await this.http.get(`/contacts?${params.toString()}`);
+        if (!response.isSuccess)
+            throw (0, error_handler_1.createSdkError)(response);
+        return response.payload.data;
+    }
+    async get(id) {
+        const response = await this.http.get(`/contact/${id}`);
+        if (!response.isSuccess)
+            throw (0, error_handler_1.createSdkError)(response);
+        return response.payload;
+    }
+    async create(data) {
+        const response = await this.http.post('/contact', data);
+        if (!response.isSuccess)
+            throw (0, error_handler_1.createSdkError)(response);
+        return response.payload;
+    }
+    async update(id, data) {
+        const response = await this.http.put(`/contact/${id}`, data);
+        if (!response.isSuccess)
+            throw (0, error_handler_1.createSdkError)(response);
+        return response.payload;
+    }
+    // BE responds 200 + a JSON ApiResponse body here (not a bare 204),
+    // deliberately sidestepping the empty-body isSuccess bug documented in
+    // sst/retrospectives/LOG.md for BiomeAgents.delete.
+    async delete(id) {
+        const response = await this.http.delete(`/contact/${id}`);
+        if (!response.isSuccess)
+            throw (0, error_handler_1.createSdkError)(response);
+    }
+    async listCircles(id) {
+        const response = await this.http.get(`/contact/${id}/circles`);
+        if (!response.isSuccess)
+            throw (0, error_handler_1.createSdkError)(response);
+        return response.payload;
+    }
+    /** Associates a contact with the Biome user account that is the same person. */
+    async linkUser(id, userId) {
+        const response = await this.http.post(`/contact/${id}/link-user`, { userId });
+        if (!response.isSuccess)
+            throw (0, error_handler_1.createSdkError)(response);
+        return response.payload;
+    }
+    async unlinkUser(id) {
+        const response = await this.http.delete(`/contact/${id}/link-user`);
+        if (!response.isSuccess)
+            throw (0, error_handler_1.createSdkError)(response);
+        return response.payload;
+    }
+    // ── Private task reminders (owner-only; ADR-0016) ──────────────────────────
+    /** The tasks the operator attached to this contact as private reminders. */
+    async listTasks(id) {
+        const response = await this.http.get(`/contact/${id}/tasks`);
+        if (!response.isSuccess)
+            throw (0, error_handler_1.createSdkError)(response);
+        return response.payload;
+    }
+    /** Attach a task the operator is involved in to this contact, with an optional note. */
+    async attachTask(id, data) {
+        const response = await this.http.post(`/contact/${id}/tasks`, data);
+        if (!response.isSuccess)
+            throw (0, error_handler_1.createSdkError)(response);
+        return response.payload;
+    }
+    async updateTaskNote(id, taskId, note) {
+        const response = await this.http.patch(`/contact/${id}/tasks/${taskId}`, { note });
+        if (!response.isSuccess)
+            throw (0, error_handler_1.createSdkError)(response);
+        return response.payload;
+    }
+    async detachTask(id, taskId) {
+        const response = await this.http.delete(`/contact/${id}/tasks/${taskId}`);
+        if (!response.isSuccess)
+            throw (0, error_handler_1.createSdkError)(response);
+    }
+}
+exports.BiomeContacts = BiomeContacts;
+//# sourceMappingURL=contact.service.js.map

package/dist/contacts/contact.service.js.map

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

package/dist/core/api-diagnostics.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Structured API failure diagnostics for BiomeSDK HTTP calls.
+ * Used by BiomeHttpClient to classify failures and surface them to consumers
+ * (e.g. Angular FE) via a CustomEvent + console logging.
+ */
+import type { RequestPriority, RequestSchedulerSnapshot } from "./request-scheduler";
+export declare const BIOME_API_ERROR_EVENT = "biome:api-error";
+export type ApiFailureKind = "timeout" | "queue_timeout" | "rate_limited" | "network" | "http_error" | "unknown";
+export interface RateLimitSnapshot {
+    limit?: number;
+    remaining?: number;
+    reset?: string;
+    retryAfterSeconds?: number;
+}
+export interface ApiFailureDiagnostic {
+    tag: "[BiomeSDK]";
+    kind: ApiFailureKind;
+    method?: string;
+    url?: string;
+    status?: number;
+    code?: string;
+    elapsedMs: number;
+    timeoutMs?: number;
+    message?: string;
+    rateLimit?: RateLimitSnapshot;
+    /** Present on `queue_timeout` — client RequestScheduler pressure at fail time. */
+    scheduler?: RequestSchedulerSnapshot;
+    /** Priority the timed-out waiter was using (when known). */
+    requestPriority?: RequestPriority;
+    timestamp: string;
+}
+/** Axios-like error shape used for classification without importing axios here. */
+export interface ClassifiableHttpError {
+    code?: string;
+    message?: string;
+    isQueueTimeout?: boolean;
+    priority?: RequestPriority;
+    maxWaitMs?: number;
+    scheduler?: RequestSchedulerSnapshot;
+    config?: {
+        url?: string;
+        method?: string;
+        timeout?: number;
+        baseURL?: string;
+        _startTime?: number;
+        biomePriority?: RequestPriority;
+    };
+    response?: {
+        status?: number;
+        headers?: Record<string, unknown>;
+        data?: {
+            message?: string;
+            payload?: {
+                message?: string;
+                retryAfter?: number;
+                data?: {
+                    retryAfter?: number;
+                };
+            };
+            data?: {
+                retryAfter?: number;
+            };
+        };
+    };
+}
+/**
+ * Extract rate-limit metadata from standard RateLimit-* / Retry-After headers
+ * and optional JSON body fields.
+ */
+export declare function extractRateLimitInfo(error: ClassifiableHttpError): RateLimitSnapshot | undefined;
+/**
+ * Classify an HTTP client failure for diagnostics and UX.
+ */
+export declare function classifyApiFailure(error: ClassifiableHttpError): ApiFailureKind;
+/**
+ * Build a structured diagnostic payload from an axios-like error.
+ */
+export declare function buildApiFailureDiagnostic(error: ClassifiableHttpError, elapsedMs?: number): ApiFailureDiagnostic;
+/**
+ * Log a failure diagnostic and dispatch `biome:api-error` for FE consumers.
+ */
+export declare function reportApiFailure(error: ClassifiableHttpError, elapsedMs?: number): ApiFailureDiagnostic;
+/**
+ * Map failure kind to stable SDK error codes used in BiomeSdkError.code.
+ */
+export declare function failureKindToErrorCode(kind: ApiFailureKind): string | undefined;
+/**
+ * User-facing message for timeout / network when the server did not respond.
+ */
+export declare function userMessageForTransportFailure(kind: ApiFailureKind, retryAfterSeconds?: number): string | undefined;
+//# sourceMappingURL=api-diagnostics.d.ts.map

package/dist/core/api-diagnostics.d.ts.map

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