@klozeo/sdk 0.1.0

package/dist/types/resources/scoring.d.ts

@@ -0,0 +1,35 @@
+import type { ScoringRule, ScoringRuleListResult, CreateScoringRuleInput, UpdateScoringRuleInput, RecalculateScoreResult } from "../types";
+import type { HttpClient } from "../client";
+/**
+ * Resource class for scoring rule and lead score operations.
+ */
+export declare class ScoringResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List all scoring rules for this account.
+     */
+    listRules(): Promise<ScoringRuleListResult>;
+    /**
+     * Create a new scoring rule.
+     */
+    createRule(input: CreateScoringRuleInput): Promise<ScoringRule>;
+    /**
+     * Retrieve a single scoring rule by ID.
+     */
+    getRule(id: string): Promise<ScoringRule>;
+    /**
+     * Update a scoring rule. Only the supplied fields are changed.
+     */
+    updateRule(id: string, input: UpdateScoringRuleInput): Promise<void>;
+    /**
+     * Delete a scoring rule.
+     */
+    deleteRule(id: string): Promise<void>;
+    /**
+     * Recalculate and persist the score for a single lead.
+     * Returns the new score value.
+     */
+    recalculate(leadId: string): Promise<RecalculateScoreResult>;
+}
+//# sourceMappingURL=scoring.d.ts.map

package/dist/types/resources/scoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../../src/resources/scoring.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C;;GAEG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,qBAAqB,CAAC;IASjD;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC;IAKrE;;OAEG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAK/C;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1E;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C;;;OAGG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;CASnE"}

package/dist/types/resources/webhooks.d.ts

@@ -0,0 +1,25 @@
+import type { Webhook, WebhookListResult, CreateWebhookInput } from "../types";
+import type { HttpClient } from "../client";
+/**
+ * Resource class for webhook subscription operations.
+ */
+export declare class WebhooksResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List all webhooks for this account.
+     */
+    list(): Promise<WebhookListResult>;
+    /**
+     * Create a new webhook subscription.
+     * The `secret` field (if provided) is used only for payload signing and
+     * is never returned by the API.
+     */
+    create(input: CreateWebhookInput): Promise<Webhook>;
+    /**
+     * Delete a webhook subscription permanently.
+     * @param id - UUID of the webhook to delete
+     */
+    delete(id: string): Promise<void>;
+}
+//# sourceMappingURL=webhooks.d.ts.map

package/dist/types/resources/webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../../src/resources/webhooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C;;GAEG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,iBAAiB,CAAC;IASxC;;;;OAIG;IACG,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAKzD;;;OAGG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGxC"}

package/dist/types/types.d.ts

@@ -0,0 +1,409 @@
+/**
+ * Attribute value types supported by the API.
+ */
+export type AttributeValue = string | number | boolean | string[] | Record<string, unknown>;
+/**
+ * Supported attribute types.
+ */
+export type AttributeType = "text" | "number" | "bool" | "list" | "object";
+/**
+ * A dynamic attribute attached to a lead.
+ */
+export interface Attribute {
+    /** Unique identifier (returned by API) */
+    id?: string;
+    /** Attribute name */
+    name: string;
+    /** Attribute type */
+    type: AttributeType;
+    /** Attribute value */
+    value: AttributeValue;
+}
+/**
+ * A compiled filter ready to be serialized to a query string.
+ */
+export interface CompiledFilter {
+    /** Filter logic: "and" or "or" */
+    logic: "and" | "or";
+    /** Filter operator (e.g. "eq", "gte", "array_contains") */
+    operator: string;
+    /** Field name (e.g. "city", "rating", "attr:industry") */
+    field: string;
+    /** Filter value (empty string for no-value operators like "is_empty") */
+    value: string;
+    /** Serialize to "logic.operator.field.value" */
+    toString(): string;
+}
+/**
+ * Sortable field names accepted by the API.
+ */
+export type SortField = "name" | "city" | "country" | "state" | "category" | "source" | "email" | "phone" | "website" | "rating" | "review_count" | "created_at" | "updated_at" | "last_interaction_at" | `attr:${string}`;
+/**
+ * Export format options.
+ */
+export declare enum ExportFormat {
+    CSV = "csv",
+    JSON = "json",
+    XLSX = "xlsx"
+}
+/**
+ * A lead object as returned by the API.
+ */
+export interface Lead {
+    /** Unique lead identifier (format: "cl_...") */
+    id: string;
+    /** Lead name */
+    name: string;
+    /** Lead source */
+    source: string;
+    /** Calculated score (0–100) */
+    score: number;
+    /** Unix timestamp of creation */
+    createdAt: number;
+    /** Unix timestamp of last structural update */
+    updatedAt: number;
+    /** Unix timestamp of last interaction or push */
+    lastInteractionAt: number;
+    /** Description */
+    description?: string;
+    /** Street address */
+    address?: string;
+    /** City */
+    city?: string;
+    /** State / province */
+    state?: string;
+    /** Country */
+    country?: string;
+    /** Postal code */
+    postalCode?: string;
+    /** Latitude */
+    latitude?: number;
+    /** Longitude */
+    longitude?: number;
+    /** Phone number */
+    phone?: string;
+    /** Email address */
+    email?: string;
+    /** Website URL */
+    website?: string;
+    /** Star rating (0–5) */
+    rating?: number;
+    /** Review count */
+    reviewCount?: number;
+    /** Category */
+    category?: string;
+    /** Tags array */
+    tags?: string[];
+    /** External source identifier */
+    sourceId?: string;
+    /** Logo URL */
+    logoUrl?: string;
+    /** Dynamic attributes */
+    attributes?: Attribute[];
+}
+/**
+ * Input for creating a new lead.
+ */
+export interface CreateLeadInput {
+    /** Lead name (required) */
+    name: string;
+    /** Lead source (required) */
+    source: string;
+    /** Description */
+    description?: string;
+    /** Street address */
+    address?: string;
+    /** City */
+    city?: string;
+    /** State / province */
+    state?: string;
+    /** Country */
+    country?: string;
+    /** Postal code */
+    postalCode?: string;
+    /** Latitude */
+    latitude?: number;
+    /** Longitude */
+    longitude?: number;
+    /** Phone number */
+    phone?: string;
+    /** Email address */
+    email?: string;
+    /** Website URL */
+    website?: string;
+    /** Star rating (0–5) */
+    rating?: number;
+    /** Review count */
+    reviewCount?: number;
+    /** Category */
+    category?: string;
+    /** Tags array */
+    tags?: string[];
+    /** External source identifier */
+    sourceId?: string;
+    /** Logo URL */
+    logoUrl?: string;
+    /** Dynamic attributes */
+    attributes?: Attribute[];
+}
+/**
+ * Input for updating an existing lead. All fields are optional.
+ */
+export type UpdateLeadInput = Partial<Omit<CreateLeadInput, "name" | "source">> & {
+    name?: string;
+    source?: string;
+};
+/**
+ * Response from a create-lead request.
+ */
+export interface CreateResponse {
+    /** ID of the created or merged lead */
+    id: string;
+    /** Human-readable message */
+    message: string;
+    /** Unix timestamp of creation */
+    createdAt: number;
+    /** True if an existing lead was merged (deduplication hit) */
+    duplicate?: boolean;
+    /** ID of a potential low-confidence duplicate */
+    potentialDuplicateId?: string;
+}
+/**
+ * A page of leads returned by the list endpoint.
+ */
+export interface LeadPage {
+    /** Leads in this page */
+    leads: Lead[];
+    /** Opaque cursor to fetch the next page (pass as `cursor` in the next call) */
+    nextCursor?: string;
+    /** True if more pages exist */
+    hasMore: boolean;
+    /** Number of leads in this page */
+    count: number;
+}
+/**
+ * Options for listing leads.
+ */
+export interface ListOptions {
+    /** Filters to apply (AND / OR logic per filter) */
+    filters?: CompiledFilter[];
+    /** Field to sort by */
+    sortBy?: SortField;
+    /** Sort direction */
+    sortOrder?: "asc" | "desc";
+    /** Maximum number of results per page (default 50, max 1000) */
+    limit?: number;
+    /** Pagination cursor from a previous response */
+    cursor?: string;
+}
+/**
+ * Options for exporting leads.
+ */
+export interface ExportOptions {
+    /** Filters to apply */
+    filters?: CompiledFilter[];
+    /** Field to sort by */
+    sortBy?: SortField;
+    /** Sort direction */
+    sortOrder?: "asc" | "desc";
+}
+/**
+ * One item in a batch-create result.
+ */
+export interface BatchCreatedItem {
+    /** Zero-based index in the input array */
+    index: number;
+    /** Created lead ID */
+    id: string;
+    /** Unix timestamp */
+    createdAt: number;
+}
+/**
+ * One error in a batch-create result.
+ */
+export interface BatchErrorItem {
+    /** Zero-based index in the input array */
+    index: number;
+    /** Error description */
+    message: string;
+}
+/**
+ * Response from a batch-create request.
+ */
+export interface BatchCreateResult {
+    /** Successfully created items */
+    created: BatchCreatedItem[];
+    /** Failed items */
+    errors: BatchErrorItem[];
+    /** Total number of inputs */
+    total: number;
+    /** Number of successes */
+    success: number;
+    /** Number of failures */
+    failed: number;
+}
+/**
+ * One item in a batch-update or batch-delete result.
+ */
+export interface BatchResultItem {
+    /** Zero-based index in the input array */
+    index: number;
+    /** Lead ID */
+    id: string;
+    /** True if the operation succeeded */
+    success: boolean;
+    /** Error description (only present when success is false) */
+    message?: string;
+}
+/**
+ * Response from a batch-update or batch-delete request.
+ */
+export interface BatchResult {
+    /** Per-item results */
+    results: BatchResultItem[];
+    /** Total number of inputs */
+    total: number;
+    /** Number of successes */
+    success: number;
+    /** Number of failures */
+    failed: number;
+}
+/**
+ * Input for a batch-update request.
+ */
+export interface BatchUpdateInput {
+    /** IDs of leads to update */
+    ids: string[];
+    /** Partial update to apply to all specified leads */
+    data: UpdateLeadInput;
+}
+/**
+ * A note attached to a lead.
+ */
+export interface Note {
+    /** Unique note identifier (format: "note_...") */
+    id: string;
+    /** ID of the parent lead */
+    leadId: string;
+    /** Note content */
+    content: string;
+    /** Unix timestamp of creation */
+    createdAt: number;
+    /** Unix timestamp of last update */
+    updatedAt: number;
+}
+/**
+ * Response from a list-notes request.
+ */
+export interface NoteListResult {
+    /** Notes for the lead */
+    notes: Note[];
+}
+/**
+ * A scoring rule object.
+ */
+export interface ScoringRule {
+    /** Unique rule identifier */
+    id: string;
+    /** Rule name */
+    name: string;
+    /** Expression evaluated per lead */
+    expression: string;
+    /** Priority (lower = higher priority) */
+    priority: number;
+    /** Unix timestamp of creation */
+    createdAt: number;
+    /** Unix timestamp of last update */
+    updatedAt: number;
+}
+/**
+ * Input for creating a scoring rule.
+ */
+export interface CreateScoringRuleInput {
+    /** Rule name */
+    name: string;
+    /** Scoring expression */
+    expression: string;
+    /** Priority (lower = higher priority, defaults to 0) */
+    priority?: number;
+}
+/**
+ * Input for updating a scoring rule. All fields are optional.
+ */
+export type UpdateScoringRuleInput = Partial<CreateScoringRuleInput>;
+/**
+ * Response from a list-scoring-rules request.
+ */
+export interface ScoringRuleListResult {
+    /** All scoring rules for this account */
+    rules: ScoringRule[];
+}
+/**
+ * Response from a recalculate-score request.
+ */
+export interface RecalculateScoreResult {
+    /** Lead ID */
+    id: string;
+    /** New calculated score */
+    score: number;
+}
+/**
+ * Supported webhook event types.
+ */
+export type WebhookEvent = "lead.created" | "lead.updated" | "lead.deleted";
+/**
+ * A webhook subscription object.
+ */
+export interface Webhook {
+    /** Unique webhook identifier */
+    id: string;
+    /** Destination URL */
+    url: string;
+    /** Subscribed event types */
+    events: WebhookEvent[];
+    /** Whether the webhook is active */
+    active: boolean;
+    /** ISO timestamp of creation */
+    createdAt: string;
+}
+/**
+ * Input for creating a webhook.
+ */
+export interface CreateWebhookInput {
+    /** Destination URL (required) */
+    url: string;
+    /** Event types to subscribe to */
+    events?: WebhookEvent[];
+    /** Optional signing secret */
+    secret?: string;
+}
+/**
+ * Response from a list-webhooks request.
+ */
+export interface WebhookListResult {
+    /** All webhooks for this account */
+    webhooks: Webhook[];
+}
+/**
+ * Options for the Klozeo client.
+ */
+export interface KlozeoOptions {
+    /** Override the API base URL (default: "https://app.klozeo.com/api/v1") */
+    baseUrl?: string;
+    /** Per-request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Maximum number of retries on 429 / 5xx (default: 3) */
+    maxRetries?: number;
+    /** Custom fetch implementation (defaults to global fetch) */
+    fetch?: typeof fetch;
+}
+/**
+ * Rate limit state updated from response headers.
+ */
+export interface RateLimitState {
+    /** Maximum requests per window */
+    limit: number;
+    /** Remaining requests in the current window */
+    remaining: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,EAAE,GACR,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,0CAA0C;IAC1C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,IAAI,EAAE,aAAa,CAAC;IACpB,sBAAsB;IACtB,KAAK,EAAE,cAAc,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,QAAQ,IAAI,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,SAAS,GACT,OAAO,GACP,UAAU,GACV,QAAQ,GACR,OAAO,GACP,OAAO,GACP,SAAS,GACT,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,YAAY,GACZ,qBAAqB,GACrB,QAAQ,MAAM,EAAE,CAAC;AAErB;;GAEG;AACH,oBAAY,YAAY;IACtB,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,IAAI,SAAS;CACd;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,iBAAiB,EAAE,MAAM,CAAC;IAE1B,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,GAAG;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iDAAiD;IACjD,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,yBAAyB;IACzB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,uBAAuB;IACvB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,qBAAqB;IACrB,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC3B,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uBAAuB;IACvB,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,uBAAuB;IACvB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,qBAAqB;IACrB,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iCAAiC;IACjC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,mBAAmB;IACnB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,cAAc;IACd,EAAE,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,qDAAqD;IACrD,IAAI,EAAE,eAAe,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yBAAyB;IACzB,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,yCAAyC;IACzC,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,cAAc;IACd,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,cAAc,GAAG,cAAc,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,6BAA6B;IAC7B,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,oCAAoC;IACpC,MAAM,EAAE,OAAO,CAAC;IAChB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,kCAAkC;IAClC,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IACxB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/utils.d.ts

@@ -0,0 +1,49 @@
+import type { CompiledFilter, SortField } from "./types";
+import { KlozeoError } from "./errors";
+/**
+ * Append filter, sort, and pagination params to a URLSearchParams instance.
+ */
+export declare function buildQueryParams(params: URLSearchParams, opts: {
+    filters?: CompiledFilter[];
+    sortBy?: SortField;
+    sortOrder?: "asc" | "desc";
+    limit?: number;
+    cursor?: string;
+    format?: string;
+}): void;
+/**
+ * Parse an API error response body and produce a typed KlozeoError.
+ */
+export declare function parseError(response: Response): Promise<KlozeoError>;
+/**
+ * Sleep for the given number of milliseconds.
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Compute exponential back-off delay with jitter.
+ * @param attempt - Zero-based attempt index.
+ * @param baseMs - Base delay in milliseconds (default 500).
+ */
+export declare function backoffDelay(attempt: number, baseMs?: number): number;
+/**
+ * Convert a snake_case API lead object to a camelCase Lead.
+ */
+export declare function deserializeLead(raw: Record<string, any>): import("./types.js").Lead;
+/**
+ * Convert a camelCase CreateLeadInput / UpdateLeadInput to the snake_case
+ * body expected by the API.
+ */
+export declare function serializeLeadInput(input: Record<string, any>): Record<string, any>;
+/**
+ * Deserialize a raw note object from the API.
+ */
+export declare function deserializeNote(raw: Record<string, any>): import("./types.js").Note;
+/**
+ * Deserialize a raw scoring rule from the API.
+ */
+export declare function deserializeScoringRule(raw: Record<string, any>): import("./types.js").ScoringRule;
+/**
+ * Deserialize a raw webhook from the API.
+ */
+export declare function deserializeWebhook(raw: Record<string, any>): import("./types.js").Webhook;
+//# sourceMappingURL=utils.d.ts.map

package/dist/types/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EACL,WAAW,EAMZ,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE;IACJ,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GACA,IAAI,CAqBN;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,WAAW,CAAC,CA4BtB;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAM,GAAG,MAAM,CAMlE;AAED;;GAEG;AAEH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,YAAY,EAAE,IAAI,CA4BnF;AAED;;;GAGG;AAEH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAalF;AAED;;GAEG;AAEH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,YAAY,EAAE,IAAI,CAQnF;AAED;;GAEG;AAEH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,YAAY,EAAE,WAAW,CASjG;AAED;;GAEG;AAEH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,YAAY,EAAE,OAAO,CAQzF"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@klozeo/sdk",
+  "version": "0.1.0",
+  "description": "Official TypeScript SDK for the Klozeo API",
+  "license": "MIT",
+  "author": "Klozeo <hello@klozeo.com>",
+  "homepage": "https://github.com/lbframe/sdk-typescript",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lbframe/sdk-typescript"
+  },
+  "keywords": [
+    "klozeo",
+    "sdk",
+    "leads",
+    "crm",
+    "api"
+  ],
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "types": "./dist/types/index.d.ts"
+    },
+    "./filters": {
+      "import": "./dist/esm/filters/index.js",
+      "require": "./dist/cjs/filters/index.js",
+      "types": "./dist/types/filters/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && tsc -p tsconfig.cjs.json && node scripts/postbuild.mjs",
+    "build:esm": "tsc -p tsconfig.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "lint": "tsc --noEmit -p tsconfig.json",
+    "clean": "rm -rf dist"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0"
+  }
+}