@lectico/api 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Contenfo LLC (Lectico)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,193 @@
+# @lectico/api
+
+[![npm](https://img.shields.io/npm/v/@lectico/api.svg)](https://www.npmjs.com/package/@lectico/api)
+[![license](https://img.shields.io/npm/l/@lectico/api.svg)](./LICENSE)
+
+Official Node.js SDK for the [Lectico](https://lectico.com) API — create AI assistants trained on your content, manage conversations, capture leads, and receive webhooks.
+
+> **Beta / Early Access.** This SDK is pre-1.0 and the surface may change. Pin to an exact version in production. Breaking changes will be called out in release notes until `1.0.0`.
+
+## Installation
+
+```bash
+npm install @lectico/api
+```
+
+Requires Node.js 18 or newer. ESM only.
+
+## Quick start
+
+```ts
+import Lectico from "@lectico/api";
+
+const lectico = new Lectico({ apiKey: process.env.LECTICO_API_KEY! });
+
+// Create an agent
+const agent = await lectico.agents.create({
+  type: "support",
+  name: "Helpdesk Bot",
+});
+
+// Send a message (streaming by default)
+const stream = await lectico.agents.messages.create(agent.id, {
+  message: "How do I reset my password?",
+});
+
+for await (const ev of stream as AsyncIterable<any>) {
+  if (ev.type === "token") process.stdout.write(ev.content ?? "");
+}
+```
+
+Get a test API key (`sk_test_*`) from the [Lectico dashboard](https://app.lectico.com).
+
+## Streaming vs JSON responses
+
+Chat messages stream Server-Sent Events by default. Pass `stream: false` for a single JSON response:
+
+```ts
+const reply = await lectico.agents.messages.create(agent.id, {
+  message: "Hello",
+  stream: false,
+});
+// reply is a ChatMessage
+```
+
+Stream event types include `token`, `sources`, `chunks`, `done`, `expert_thinking`, `escalation_offer`, `support_contact`, `error`.
+
+## Webhook signature verification
+
+Webhooks are signed with HMAC-SHA256. Verify the signature before trusting the payload:
+
+```ts
+import express from "express";
+import { constructEvent, WebhookSignatureError } from "@lectico/api/webhooks";
+
+const app = express();
+
+app.post(
+  "/webhooks/lectico",
+  express.raw({ type: "application/json" }),
+  (req, res) => {
+    try {
+      const event = constructEvent(
+        req.body,                              // Buffer (raw body)
+        req.header("Lectico-Signature"),
+        process.env.LECTICO_WEBHOOK_SECRET!,   // whsec_... from dashboard
+      );
+
+      switch (event.type) {
+        case "agent.created":
+          // ...
+          break;
+        case "lead.captured":
+          // ...
+          break;
+      }
+
+      res.status(200).json({ received: true });
+    } catch (err) {
+      if (err instanceof WebhookSignatureError) {
+        return res.status(400).send(`Invalid signature: ${err.message}`);
+      }
+      throw err;
+    }
+  },
+);
+```
+
+`constructEvent` validates the `t=...,v1=...` signature and rejects payloads older than 5 minutes (configurable via `toleranceSeconds`) to prevent replay attacks.
+
+## Pagination
+
+Lists are cursor-paginated. Iterate all results with `iterAll`:
+
+```ts
+for await (const agent of lectico.agents.iterAll({ type: "support" })) {
+  console.log(agent.id, agent.name);
+}
+```
+
+Or page manually:
+
+```ts
+const page = await lectico.agents.list({ limit: 50 });
+if (page.meta.pagination.has_more) {
+  const next = await lectico.agents.list({
+    limit: 50,
+    starting_after: page.meta.pagination.next_cursor,
+  });
+}
+```
+
+## Error handling
+
+All API errors extend `LecticoError`. Check the specific class to react appropriately:
+
+| Class                    | HTTP | Meaning                              |
+| ------------------------ | ---- | ------------------------------------ |
+| `AuthenticationError`    | 401  | Invalid or missing API key           |
+| `PaymentRequiredError`   | 402  | Out of credits / plan limit reached  |
+| `PermissionDeniedError`  | 403  | Key lacks permission for the resource|
+| `NotFoundError`          | 404  | Resource does not exist              |
+| `ConflictError`          | 409  | Slug collision, idempotency mismatch |
+| `InvalidRequestError`    | 400  | Bad input — see `.param`             |
+| `RateLimitError`         | 429  | Too many requests — see `.retryAfterSeconds` |
+| `InternalServerError`    | 5xx  | Transient or unexpected server error |
+
+```ts
+import { RateLimitError, NotFoundError } from "@lectico/api";
+
+try {
+  await lectico.agents.get("agt_missing");
+} catch (err) {
+  if (err instanceof NotFoundError) {
+    // ...
+  } else if (err instanceof RateLimitError) {
+    await sleep(err.retryAfterSeconds * 1000);
+  } else {
+    throw err;
+  }
+}
+```
+
+The client automatically retries `429` and `5xx` responses with exponential backoff (default: 2 retries). Configure with `maxRetries` in the constructor.
+
+## Idempotency
+
+Pass an `idempotencyKey` to safely retry `POST` requests:
+
+```ts
+await lectico.agents.create(
+  { type: "support", name: "Bot" },
+  { idempotencyKey: crypto.randomUUID() },
+);
+```
+
+## Configuration
+
+```ts
+new Lectico({
+  apiKey: "sk_live_...",           // required
+  baseUrl: "https://api.lectico.com", // default
+  timeoutMs: 30000,                // per-request timeout
+  maxRetries: 2,                   // 429/5xx retries
+});
+```
+
+## Resources available
+
+- `agents` — create, list, get, update, delete, `iterAll`, `messages.create` (streaming)
+- `knowledge` — list, create, delete
+- `conversations` — list, get
+- `leads` — list, get, delete
+- `webhooks` — create, list, get, update, delete, deliveries, test
+- `files` — create (presigned URL), get, delete
+- `usage` — summary (plan + usage)
+
+## Documentation
+
+Full API reference: **coming soon at [docs.lectico.com/api](https://docs.lectico.com/api)**.
+
+## License
+
+[MIT](./LICENSE) © Contenfo LLC (Lectico)

package/dist/client.d.ts

@@ -0,0 +1,52 @@
+import type { ApiResponse, ApiList } from "./types.js";
+export interface LecticoOptions {
+    /** API key. Use sk_live_* in production, sk_test_* in sandbox. */
+    apiKey: string;
+    /** Override the API base URL. Defaults to https://api.lectico.com. */
+    baseUrl?: string;
+    /** Per-request timeout in milliseconds. Default 30000 (30s). */
+    timeoutMs?: number;
+    /**
+     * Maximum number of automatic retries for transient errors (429, 5xx).
+     * Default: 2. Set 0 to disable.
+     */
+    maxRetries?: number;
+    /** Custom fetch (for testing). Defaults to global fetch. */
+    fetch?: typeof fetch;
+}
+export interface RequestOptions {
+    /** Idempotency-Key header for safe retry of POST requests. */
+    idempotencyKey?: string;
+    /** Override per-request timeout. */
+    timeoutMs?: number;
+    /** Override per-request retry count. */
+    maxRetries?: number;
+    /** AbortSignal for cancellation. */
+    signal?: AbortSignal;
+}
+export declare class HttpClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly defaultTimeoutMs;
+    private readonly defaultMaxRetries;
+    private readonly fetchImpl;
+    constructor(opts: LecticoOptions);
+    /** Build standard headers for every request */
+    private headers;
+    /**
+     * Core fetch with retry on transient errors (429, 5xx).
+     * Returns the parsed JSON body. Throws LecticoError on non-2xx after retries.
+     */
+    request<T>(method: string, path: string, opts?: {
+        body?: unknown;
+        query?: Record<string, string | number | undefined | null>;
+        headers?: Record<string, string>;
+    } & RequestOptions): Promise<T>;
+    /** Make a streaming POST request — returns the raw Response. Used by chat. */
+    stream(path: string, body: unknown, opts?: RequestOptions): Promise<Response>;
+    private buildUrl;
+    private parseErrorBody;
+    private isRetryable;
+}
+export type { ApiResponse, ApiList };
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAgB,WAAW,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAIrE,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAE7B,IAAI,EAAE,cAAc;IAShC,+CAA+C;IAC/C,OAAO,CAAC,OAAO;IAUf;;;OAGG;IACG,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;QACJ,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC;QAC3D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC,GAAG,cAAmB,GACtB,OAAO,CAAC,CAAC,CAAC;IA6Db,8EAA8E;IACxE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAuBvF,OAAO,CAAC,QAAQ;YAeF,cAAc;IAwB5B,OAAO,CAAC,WAAW;CAMpB;AAiCD,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC"}

package/dist/client.js

@@ -0,0 +1,191 @@
+// REQ-083 — HTTP client wrapper for the Lectico API
+import { mapHttpToError, RateLimitError, InternalServerError } from "./errors.js";
+const SDK_VERSION = "0.1.0";
+export class HttpClient {
+    apiKey;
+    baseUrl;
+    defaultTimeoutMs;
+    defaultMaxRetries;
+    fetchImpl;
+    constructor(opts) {
+        if (!opts.apiKey)
+            throw new Error("LecticoClient: apiKey is required");
+        this.apiKey = opts.apiKey;
+        this.baseUrl = (opts.baseUrl ?? "https://api.lectico.com").replace(/\/+$/, "");
+        this.defaultTimeoutMs = opts.timeoutMs ?? 30_000;
+        this.defaultMaxRetries = opts.maxRetries ?? 2;
+        this.fetchImpl = opts.fetch ?? fetch;
+    }
+    /** Build standard headers for every request */
+    headers(extra) {
+        return {
+            "Authorization": `Bearer ${this.apiKey}`,
+            "Content-Type": "application/json",
+            "Accept": "application/json",
+            "User-Agent": `lectico-sdk-node/${SDK_VERSION}`,
+            ...extra,
+        };
+    }
+    /**
+     * Core fetch with retry on transient errors (429, 5xx).
+     * Returns the parsed JSON body. Throws LecticoError on non-2xx after retries.
+     */
+    async request(method, path, opts = {}) {
+        const url = this.buildUrl(path, opts.query);
+        const headers = this.headers(opts.headers);
+        if (opts.idempotencyKey)
+            headers["Idempotency-Key"] = opts.idempotencyKey;
+        const body = opts.body !== undefined ? JSON.stringify(opts.body) : undefined;
+        const maxRetries = opts.maxRetries ?? this.defaultMaxRetries;
+        const timeoutMs = opts.timeoutMs ?? this.defaultTimeoutMs;
+        let attempt = 0;
+        let lastError;
+        while (attempt <= maxRetries) {
+            attempt++;
+            const ctrl = new AbortController();
+            const timer = setTimeout(() => ctrl.abort(), timeoutMs);
+            const signal = opts.signal
+                ? combineSignals(ctrl.signal, opts.signal)
+                : ctrl.signal;
+            let res;
+            try {
+                res = await this.fetchImpl(url, { method, headers, body, signal });
+            }
+            catch (err) {
+                clearTimeout(timer);
+                if (attempt > maxRetries)
+                    throw err;
+                await sleep(backoffMs(attempt));
+                continue;
+            }
+            clearTimeout(timer);
+            if (res.ok) {
+                if (res.status === 204)
+                    return undefined;
+                const text = await res.text();
+                if (!text)
+                    return undefined;
+                try {
+                    return JSON.parse(text);
+                }
+                catch {
+                    throw new Error(`Lectico API returned non-JSON response: ${text.slice(0, 200)}`);
+                }
+            }
+            // Non-2xx — parse error body, decide retry
+            const errBody = await this.parseErrorBody(res);
+            const apiErr = mapHttpToError(res.status, errBody, res.headers.get("retry-after"));
+            lastError = apiErr;
+            if (attempt > maxRetries || !this.isRetryable(apiErr)) {
+                throw apiErr;
+            }
+            // Wait before retry
+            const waitMs = apiErr instanceof RateLimitError && apiErr.retryAfterSeconds
+                ? apiErr.retryAfterSeconds * 1000
+                : backoffMs(attempt);
+            await sleep(waitMs);
+        }
+        throw lastError ?? new Error("Lectico request failed for unknown reason");
+    }
+    /** Make a streaming POST request — returns the raw Response. Used by chat. */
+    async stream(path, body, opts = {}) {
+        const url = this.buildUrl(path);
+        const headers = this.headers({ "Accept": "text/event-stream" });
+        if (opts.idempotencyKey)
+            headers["Idempotency-Key"] = opts.idempotencyKey;
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), opts.timeoutMs ?? this.defaultTimeoutMs);
+        const signal = opts.signal ? combineSignals(ctrl.signal, opts.signal) : ctrl.signal;
+        const res = await this.fetchImpl(url, {
+            method: "POST",
+            headers,
+            body: JSON.stringify(body),
+            signal,
+        });
+        clearTimeout(timer);
+        if (!res.ok) {
+            const errBody = await this.parseErrorBody(res);
+            throw mapHttpToError(res.status, errBody, res.headers.get("retry-after"));
+        }
+        return res;
+    }
+    buildUrl(path, query) {
+        let url = `${this.baseUrl}${path.startsWith("/") ? path : "/" + path}`;
+        if (query) {
+            const params = new URLSearchParams();
+            for (const [k, v] of Object.entries(query)) {
+                if (v !== undefined && v !== null && v !== "") {
+                    params.set(k, String(v));
+                }
+            }
+            const q = params.toString();
+            if (q)
+                url += "?" + q;
+        }
+        return url;
+    }
+    async parseErrorBody(res) {
+        const text = await res.text();
+        if (!text) {
+            return {
+                error: { type: "internal_error", code: "empty_body", message: `HTTP ${res.status}` },
+            };
+        }
+        try {
+            const parsed = JSON.parse(text);
+            if (parsed.error?.type)
+                return parsed;
+            return {
+                error: {
+                    type: "internal_error",
+                    code: "unknown",
+                    message: typeof parsed === "string" ? parsed : text.slice(0, 200),
+                },
+            };
+        }
+        catch {
+            return {
+                error: { type: "internal_error", code: "non_json", message: text.slice(0, 200) },
+            };
+        }
+    }
+    isRetryable(err) {
+        // Retry on rate-limit and 5xx
+        if (err instanceof RateLimitError)
+            return true;
+        if (err instanceof InternalServerError && err.status >= 500)
+            return true;
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+function backoffMs(attempt) {
+    // Exponential with jitter: 500ms, 1500ms, 4500ms, ...
+    const base = Math.min(500 * Math.pow(3, attempt - 1), 30_000);
+    const jitter = Math.random() * 200;
+    return base + jitter;
+}
+/** Combine multiple AbortSignals so the request aborts if ANY fires. */
+function combineSignals(...signals) {
+    if (signals.length === 1)
+        return signals[0];
+    // Node 20+ has AbortSignal.any
+    const anyFn = AbortSignal.any;
+    if (typeof anyFn === "function")
+        return anyFn(signals);
+    // Fallback for older runtimes
+    const ctrl = new AbortController();
+    for (const s of signals) {
+        if (s.aborted)
+            ctrl.abort(s.reason);
+        else
+            s.addEventListener("abort", () => ctrl.abort(s.reason), { once: true });
+    }
+    return ctrl.signal;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,46 @@
+import type { ApiErrorBody } from "./types.js";
+export declare class LecticoError extends Error {
+    readonly type: ApiErrorBody["error"]["type"];
+    readonly code: string;
+    readonly status: number;
+    readonly param?: string;
+    readonly docUrl?: string;
+    readonly requestId?: string;
+    constructor(status: number, body: ApiErrorBody);
+}
+/** 401 — invalid or missing API key */
+export declare class AuthenticationError extends LecticoError {
+    constructor(status: number, body: ApiErrorBody);
+}
+/** 402 — out of credits / plan limit reached */
+export declare class PaymentRequiredError extends LecticoError {
+    constructor(status: number, body: ApiErrorBody);
+}
+/** 403 — API key lacks scope */
+export declare class PermissionDeniedError extends LecticoError {
+    constructor(status: number, body: ApiErrorBody);
+}
+/** 404 — resource not found */
+export declare class NotFoundError extends LecticoError {
+    constructor(status: number, body: ApiErrorBody);
+}
+/** 409 — conflict (idempotency mismatch, slug collision, etc.) */
+export declare class ConflictError extends LecticoError {
+    constructor(status: number, body: ApiErrorBody);
+}
+/** 400 / 422 — invalid input */
+export declare class InvalidRequestError extends LecticoError {
+    constructor(status: number, body: ApiErrorBody);
+}
+/** 429 — rate limit exceeded */
+export declare class RateLimitError extends LecticoError {
+    readonly retryAfterSeconds?: number;
+    constructor(status: number, body: ApiErrorBody, retryAfter?: string | null);
+}
+/** 5xx — Lectico-side internal error */
+export declare class InternalServerError extends LecticoError {
+    constructor(status: number, body: ApiErrorBody);
+}
+/** Map an HTTP status + parsed body to the correct error class */
+export declare function mapHttpToError(status: number, body: ApiErrorBody, retryAfterHeader?: string | null): LecticoError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEhB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY;CAU/C;AAED,uCAAuC;AACvC,qBAAa,mBAAoB,SAAQ,YAAY;gBACvC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY;CAI/C;AAED,gDAAgD;AAChD,qBAAa,oBAAqB,SAAQ,YAAY;gBACxC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY;CAI/C;AAED,gCAAgC;AAChC,qBAAa,qBAAsB,SAAQ,YAAY;gBACzC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY;CAI/C;AAED,+BAA+B;AAC/B,qBAAa,aAAc,SAAQ,YAAY;gBACjC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY;CAI/C;AAED,kEAAkE;AAClE,qBAAa,aAAc,SAAQ,YAAY;gBACjC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY;CAI/C;AAED,gCAAgC;AAChC,qBAAa,mBAAoB,SAAQ,YAAY;gBACvC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY;CAI/C;AAED,gCAAgC;AAChC,qBAAa,cAAe,SAAQ,YAAY;IAC9C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;gBACxB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;CAQ3E;AAED,wCAAwC;AACxC,qBAAa,mBAAoB,SAAQ,YAAY;gBACvC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY;CAI/C;AAED,kEAAkE;AAClE,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,YAAY,EAClB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,GAC/B,YAAY,CAoBd"}

package/dist/errors.js

@@ -0,0 +1,104 @@
+// REQ-083 — SDK error classes (typed by API error type)
+export class LecticoError extends Error {
+    type;
+    code;
+    status;
+    param;
+    docUrl;
+    requestId;
+    constructor(status, body) {
+        super(body.error.message);
+        this.name = "LecticoError";
+        this.type = body.error.type;
+        this.code = body.error.code;
+        this.status = status;
+        this.param = body.error.param;
+        this.docUrl = body.error.doc_url;
+        this.requestId = body.meta?.request_id;
+    }
+}
+/** 401 — invalid or missing API key */
+export class AuthenticationError extends LecticoError {
+    constructor(status, body) {
+        super(status, body);
+        this.name = "AuthenticationError";
+    }
+}
+/** 402 — out of credits / plan limit reached */
+export class PaymentRequiredError extends LecticoError {
+    constructor(status, body) {
+        super(status, body);
+        this.name = "PaymentRequiredError";
+    }
+}
+/** 403 — API key lacks scope */
+export class PermissionDeniedError extends LecticoError {
+    constructor(status, body) {
+        super(status, body);
+        this.name = "PermissionDeniedError";
+    }
+}
+/** 404 — resource not found */
+export class NotFoundError extends LecticoError {
+    constructor(status, body) {
+        super(status, body);
+        this.name = "NotFoundError";
+    }
+}
+/** 409 — conflict (idempotency mismatch, slug collision, etc.) */
+export class ConflictError extends LecticoError {
+    constructor(status, body) {
+        super(status, body);
+        this.name = "ConflictError";
+    }
+}
+/** 400 / 422 — invalid input */
+export class InvalidRequestError extends LecticoError {
+    constructor(status, body) {
+        super(status, body);
+        this.name = "InvalidRequestError";
+    }
+}
+/** 429 — rate limit exceeded */
+export class RateLimitError extends LecticoError {
+    retryAfterSeconds;
+    constructor(status, body, retryAfter) {
+        super(status, body);
+        this.name = "RateLimitError";
+        if (retryAfter) {
+            const parsed = Number.parseInt(retryAfter, 10);
+            if (!Number.isNaN(parsed))
+                this.retryAfterSeconds = parsed;
+        }
+    }
+}
+/** 5xx — Lectico-side internal error */
+export class InternalServerError extends LecticoError {
+    constructor(status, body) {
+        super(status, body);
+        this.name = "InternalServerError";
+    }
+}
+/** Map an HTTP status + parsed body to the correct error class */
+export function mapHttpToError(status, body, retryAfterHeader) {
+    switch (status) {
+        case 400:
+        case 422:
+            return new InvalidRequestError(status, body);
+        case 401:
+            return new AuthenticationError(status, body);
+        case 402:
+            return new PaymentRequiredError(status, body);
+        case 403:
+            return new PermissionDeniedError(status, body);
+        case 404:
+            return new NotFoundError(status, body);
+        case 409:
+            return new ConflictError(status, body);
+        case 429:
+            return new RateLimitError(status, body, retryAfterHeader);
+        default:
+            return new InternalServerError(status, body);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+import { type LecticoOptions } from "./client.js";
+import { AgentsResource } from "./resources/agents.js";
+import { KnowledgeResource } from "./resources/knowledge.js";
+import { ConversationsResource } from "./resources/conversations.js";
+import { LeadsResource } from "./resources/leads.js";
+import { WebhooksResource } from "./resources/webhooks.js";
+import { FilesResource } from "./resources/files.js";
+import { UsageResource } from "./resources/usage.js";
+export default class Lectico {
+    readonly agents: AgentsResource;
+    readonly knowledge: KnowledgeResource;
+    readonly conversations: ConversationsResource;
+    readonly leads: LeadsResource;
+    readonly webhooks: WebhooksResource;
+    readonly files: FilesResource;
+    readonly usage: UsageResource;
+    private readonly client;
+    constructor(opts: LecticoOptions);
+}
+export { Lectico };
+export * from "./errors.js";
+export * from "./types.js";
+export { constructEvent, WebhookSignatureError } from "./webhooks.js";
+export type { StreamEvent } from "./resources/agents.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,CAAC,OAAO,OAAO,OAAO;IAC1B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAE9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;gBAExB,IAAI,EAAE,cAAc;CAUjC;AAED,OAAO,EAAE,OAAO,EAAE,CAAC;AACnB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC"}