@letsping/sdk 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,128 @@
+# @letsping/sdk
+
+The official Node.js/TypeScript SDK for [LetsPing](https://letsping.co).
+
+LetsPing is the Human-in-the-Loop control plane for autonomous agents — the durable state layer that pauses execution before sensitive actions, persists encrypted agent state, and resumes only after explicit human approval (or rejection/correction).
+
+## Requirements
+
+- Node.js 18+
+- TypeScript 5+ (recommended)
+
+## Installation
+
+```bash
+npm install @letsping/sdk
+```
+
+## Usage
+
+### Blocking Request (`ask`)
+
+Execution suspends until the request is approved, rejected, or times out.
+
+```typescript
+import { LetsPing } from "@letsping/sdk";
+
+const lp = new LetsPing(process.env.LETSPING_API_KEY!);
+
+async function processRefund(userId: string, amount: number) {
+  try {
+    const decision = await lp.ask({
+      service: "billing-service",
+      action: "refund_user",
+      priority: "high",
+      payload: { userId, amount },
+
+      // Optional: JSON Schema to render an editable form in the dashboard
+      // (If using Zod: convert via zodToJsonSchema(mySchema))
+      schema: {
+        type: "object",
+        properties: {
+          amount: { type: "number", maximum: 5000 }
+        },
+        required: ["amount"]
+      },
+
+      // Optional override (default: 24 hours)
+      timeoutMs: 30 * 60 * 1000, // 30 minutes
+    });
+
+    if (decision.status === "APPROVED") {
+      // Prefer patched_payload if human edited values
+      const data = decision.patched_payload ?? decision.payload;
+      await stripe.refunds.create({
+        charge: data.userId,
+        amount: Math.round(data.amount * 100),
+      });
+      console.log("Refund executed");
+    } else {
+      console.log(`Refund ${decision.status.toLowerCase()} by operator`);
+    }
+  } catch (error) {
+    console.error("Approval failed or timed out:", error);
+  }
+}
+```
+
+### Non-Blocking Request (`defer`)
+
+Queues the request immediately and returns; ideal for serverless or event-driven flows.
+
+```typescript
+const { id } = await lp.defer({
+  service: "notification-agent",
+  action: "send_email",
+  payload: {
+    to: "user@example.com",
+    subject: "Your invoice is ready",
+    amount: 249.99
+  },
+  priority: "medium"
+});
+
+console.log(`Approval request queued → ${id}`);
+```
+
+## API Reference
+
+### `new LetsPing(apiKey, options?)`
+
+- `apiKey` (string) — **required** — Service Role or Project API key from LetsPing dashboard
+- `options.baseUrl` (string) — optional — Override endpoint (self-hosted / staging)
+
+### `lp.ask(options): Promise<Decision>`
+
+Blocks until resolved (approve / reject / timeout).
+
+| Property     | Type                            | Description                                                                 |
+|--------------|---------------------------------|-----------------------------------------------------------------------------|
+| `service`    | `string`                        | Service / module identifier (e.g. "billing", "compliance")                  |
+| `action`     | `string`                        | Action name (e.g. "refund", "transfer_funds")                               |
+| `payload`    | `Record<string, any>`           | Context passed to human operator (and returned in Decision)                 |
+| `priority`   | `"low" \| "medium" \| "high" \| "critical"` | Routing priority in dashboard                                               |
+| `schema`     | `object`                        | JSON Schema (draft 07) — generates editable form in dashboard               |
+| `timeoutMs`  | `number`                        | Max wait time (default: 86_400_000 ms = 24 hours)                           |
+
+### `lp.defer(options): Promise<{ id: string }>`
+
+Fire-and-forget: queues request and returns request ID immediately. Same options shape as `ask`.
+
+### Decision Type
+
+```typescript
+interface Decision {
+  status: "APPROVED" | "REJECTED";
+  payload: Record<string, any>;          // Original payload sent by agent
+  patched_payload?: Record<string, any>; // Human-edited values (if modified)
+  metadata: {
+    actor_id: string;                    // ID/email of the approving/rejecting human
+    resolved_at: string;                 // ISO 8601 timestamp
+  };
+}
+```
+
+For full documentation, request schema examples, error codes, and dashboard integration see:  
+https://letsping.co/docs#sdk
+
+Deploy agents with confidence.

package/dist/index.d.mts

@@ -0,0 +1,37 @@
+type Priority = "low" | "medium" | "high" | "critical";
+interface RequestOptions {
+    service: string;
+    action: string;
+    payload: Record<string, any>;
+    priority?: Priority;
+    schema?: Record<string, any>;
+    timeoutMs?: number;
+}
+interface Decision {
+    status: "APPROVED" | "REJECTED";
+    payload: any;
+    patched_payload?: any;
+    metadata?: {
+        resolved_at: string;
+        actor_id: string;
+        method?: string;
+    };
+}
+declare class LetsPingError extends Error {
+    status?: number | undefined;
+    constructor(message: string, status?: number | undefined);
+}
+declare class LetsPing {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(apiKey?: string, options?: {
+        baseUrl?: string;
+    });
+    ask(options: RequestOptions): Promise<Decision>;
+    defer(options: RequestOptions): Promise<{
+        id: string;
+    }>;
+    private request;
+}
+
+export { type Decision, LetsPing, LetsPingError, type Priority, type RequestOptions };

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+type Priority = "low" | "medium" | "high" | "critical";
+interface RequestOptions {
+    service: string;
+    action: string;
+    payload: Record<string, any>;
+    priority?: Priority;
+    schema?: Record<string, any>;
+    timeoutMs?: number;
+}
+interface Decision {
+    status: "APPROVED" | "REJECTED";
+    payload: any;
+    patched_payload?: any;
+    metadata?: {
+        resolved_at: string;
+        actor_id: string;
+        method?: string;
+    };
+}
+declare class LetsPingError extends Error {
+    status?: number | undefined;
+    constructor(message: string, status?: number | undefined);
+}
+declare class LetsPing {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(apiKey?: string, options?: {
+        baseUrl?: string;
+    });
+    ask(options: RequestOptions): Promise<Decision>;
+    defer(options: RequestOptions): Promise<{
+        id: string;
+    }>;
+    private request;
+}
+
+export { type Decision, LetsPing, LetsPingError, type Priority, type RequestOptions };

package/dist/index.js

@@ -0,0 +1,154 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  LetsPing: () => LetsPing,
+  LetsPingError: () => LetsPingError
+});
+module.exports = __toCommonJS(index_exports);
+var LetsPingError = class extends Error {
+  constructor(message, status) {
+    super(message);
+    this.status = status;
+    this.name = "LetsPingError";
+  }
+};
+var LetsPing = class {
+  constructor(apiKey, options) {
+    const key = apiKey || process.env.LETSPING_API_KEY;
+    if (!key) throw new Error("LetsPing: API Key is required. Pass it to the constructor or set LETSPING_API_KEY env var.");
+    this.apiKey = key;
+    this.baseUrl = options?.baseUrl || "https://letsping.co/api";
+  }
+  async ask(options) {
+    if (options.schema && options.schema._def) {
+      throw new LetsPingError("LetsPing Error: Raw Zod schema detected. You must convert it to JSON Schema (e.g. using 'zod-to-json-schema') before passing it to the SDK.");
+    }
+    const { id } = await this.request("POST", "/ingest", {
+      service: options.service,
+      action: options.action,
+      payload: options.payload,
+      priority: options.priority || "medium",
+      schema: options.schema,
+      metadata: {
+        role: options.role,
+        sdk: "node"
+      }
+    });
+    const timeout = options.timeoutMs || 24 * 60 * 60 * 1e3;
+    const start = Date.now();
+    let delay = 1e3;
+    const maxDelay = 1e4;
+    while (Date.now() - start < timeout) {
+      try {
+        const check = await this.request("GET", `/status/${id}`);
+        if (check.status === "APPROVED" || check.status === "REJECTED") {
+          return {
+            status: check.status,
+            payload: options.payload,
+            patched_payload: check.patched_payload || options.payload,
+            metadata: {
+              resolved_at: check.resolved_at,
+              actor_id: check.actor_id
+            }
+          };
+        }
+      } catch (e) {
+        const status = e.status;
+        if (status && status >= 400 && status < 500 && status !== 404 && status !== 429) {
+          throw e;
+        }
+      }
+      const jitter = Math.random() * 200;
+      await new Promise((r) => setTimeout(r, delay + jitter));
+      delay = Math.min(delay * 1.5, maxDelay);
+    }
+    throw new LetsPingError(`Request ${id} timed out waiting for approval.`);
+  }
+  async defer(options) {
+    return this.request("POST", "/ingest", options);
+  }
+  async request(method, path, body) {
+    const headers = {
+      "Authorization": `Bearer ${this.apiKey}`,
+      "Content-Type": "application/json",
+      "User-Agent": "letsping-node/0.1.2"
+    };
+    try {
+      const response = await fetch(`${this.baseUrl}${path}`, {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : void 0
+      });
+      if (!response.ok) {
+        const errorText = await response.text();
+        let message = errorText;
+        try {
+          const json = JSON.parse(errorText);
+          if (json.message) message = json.message;
+        } catch {
+        }
+        throw new LetsPingError(`API Error [${response.status}]: ${message}`, response.status);
+      }
+      return response.json();
+    } catch (e) {
+      if (e instanceof LetsPingError) throw e;
+      throw new LetsPingError(`Network Error: ${e.message}`);
+    }
+  }
+  tool(service, action, priority = "medium") {
+    return async (context) => {
+      let payload;
+      try {
+        if (typeof context === "string") {
+          try {
+            payload = JSON.parse(context);
+          } catch {
+            payload = { raw_context: context };
+          }
+        } else if (typeof context === "object" && context !== null) {
+          payload = context;
+        } else {
+          payload = { raw_context: String(context) };
+        }
+        const result = await this.ask({
+          service,
+          action,
+          payload,
+          priority
+        });
+        if (result.status === "REJECTED") {
+          return `STOP: Action Rejected by Human.`;
+        }
+        const finalPayload = result.patched_payload || result.payload;
+        return JSON.stringify(finalPayload);
+      } catch (e) {
+        return `ERROR: System Failure: ${e.message}`;
+      }
+    };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LetsPing,
+  LetsPingError
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type Priority = \"low\" | \"medium\" | \"high\" | \"critical\";\r\n\r\n/**\r\n * Options for configuring a LetsPing approval request.\r\n */\r\nexport interface RequestOptions {\r\n    /** Name of the agent or service (e.g., \"billing-agent\") */\r\n    service: string;\r\n    /** Specific action being requested (e.g., \"refund_user\") */\r\n    action: string;\r\n    /** The data payload to be reviewed by the human */\r\n    payload: Record<string, any>;\r\n    /** Urgency level affecting notification routing (default: \"medium\") */\r\n    priority?: Priority;\r\n    /** JSON Schema (Draft 7) for rendering a structured form in the dashboard */\r\n    schema?: Record<string, any>;\r\n    /** Maximum time to wait for approval in milliseconds (default: 24h) */\r\n    timeoutMs?: number;\r\n    /** (Enterprise) Specific role required for approval (e.g., \"finance\") */\r\n    role?: string;\r\n}\r\n\r\n/**\r\n * The result of a human approval decision.\r\n */\r\nexport interface Decision {\r\n    status: \"APPROVED\" | \"REJECTED\";\r\n    /** The original payload submitted */\r\n    payload: any;\r\n    /** The modified payload if the human edited values during approval */\r\n    patched_payload?: any;\r\n    metadata?: {\r\n        resolved_at: string;\r\n        actor_id: string;\r\n        method?: string;\r\n    };\r\n}\r\n\r\nexport class LetsPingError extends Error {\r\n    constructor(message: string, public status?: number) {\r\n        super(message);\r\n        this.name = \"LetsPingError\";\r\n    }\r\n}\r\n\r\nexport class LetsPing {\r\n    private readonly apiKey: string;\r\n    private readonly baseUrl: string;\r\n\r\n    constructor(apiKey?: string, options?: { baseUrl?: string }) {\r\n        const key = apiKey || process.env.LETSPING_API_KEY;\r\n        if (!key) throw new Error(\"LetsPing: API Key is required. Pass it to the constructor or set LETSPING_API_KEY env var.\");\r\n\r\n        this.apiKey = key;\r\n        this.baseUrl = options?.baseUrl || \"https://letsping.co/api\";\r\n    }\r\n\r\n    async ask(options: RequestOptions): Promise<Decision> {\r\n        if (options.schema && (options.schema as any)._def) {\r\n            throw new LetsPingError(\"LetsPing Error: Raw Zod schema detected. You must convert it to JSON Schema (e.g. using 'zod-to-json-schema') before passing it to the SDK.\");\r\n        }\r\n\r\n        const { id } = await this.request<{ id: string }>(\"POST\", \"/ingest\", {\r\n            service: options.service,\r\n            action: options.action,\r\n            payload: options.payload,\r\n            priority: options.priority || \"medium\",\r\n            schema: options.schema,\r\n            metadata: {\r\n                role: options.role,\r\n                sdk: \"node\"\r\n            }\r\n        });\r\n\r\n        const timeout = options.timeoutMs || 24 * 60 * 60 * 1000;\r\n        const start = Date.now();\r\n        let delay = 1000;\r\n        const maxDelay = 10000;\r\n\r\n        while (Date.now() - start < timeout) {\r\n            try {\r\n                const check = await this.request<any>(\"GET\", `/status/${id}`);\r\n\r\n                if (check.status === \"APPROVED\" || check.status === \"REJECTED\") {\r\n                    return {\r\n                        status: check.status,\r\n                        payload: options.payload,\r\n                        patched_payload: check.patched_payload || options.payload,\r\n                        metadata: {\r\n                            resolved_at: check.resolved_at,\r\n                            actor_id: check.actor_id\r\n                        }\r\n                    };\r\n                }\r\n            } catch (e: any) {\r\n                // Retry on:\r\n                // 1. Network errors (status is undefined)\r\n                // 2. 404 (not found yet)\r\n                // 3. 429 (rate limit)\r\n                // 4. 5xx (server error)\r\n                // Fail on: 400, 401, 403 (client errors)\r\n                const status = e.status;\r\n                if (status && status >= 400 && status < 500 && status !== 404 && status !== 429) {\r\n                    throw e;\r\n                }\r\n            }\r\n\r\n            const jitter = Math.random() * 200;\r\n            await new Promise(r => setTimeout(r, delay + jitter));\r\n            delay = Math.min(delay * 1.5, maxDelay);\r\n        }\r\n\r\n        throw new LetsPingError(`Request ${id} timed out waiting for approval.`);\r\n    }\r\n\r\n    async defer(options: RequestOptions): Promise<{ id: string }> {\r\n        return this.request<{ id: string }>(\"POST\", \"/ingest\", options);\r\n    }\r\n\r\n    private async request<T>(method: string, path: string, body?: any): Promise<T> {\r\n        // Shared headers\r\n        const headers: Record<string, string> = {\r\n            \"Authorization\": `Bearer ${this.apiKey}`,\r\n            \"Content-Type\": \"application/json\",\r\n            \"User-Agent\": \"letsping-node/0.1.2\"\r\n        };\r\n\r\n        try {\r\n            const response = await fetch(`${this.baseUrl}${path}`, {\r\n                method,\r\n                headers,\r\n                body: body ? JSON.stringify(body) : undefined,\r\n            });\r\n\r\n            if (!response.ok) {\r\n                const errorText = await response.text();\r\n                // Try parsing JSON error message\r\n                let message = errorText;\r\n                try {\r\n                    const json = JSON.parse(errorText);\r\n                    if (json.message) message = json.message;\r\n                } catch { }\r\n\r\n                throw new LetsPingError(`API Error [${response.status}]: ${message}`, response.status);\r\n            }\r\n\r\n            return response.json() as Promise<T>;\r\n        } catch (e: any) {\r\n            if (e instanceof LetsPingError) throw e;\r\n            // Fetch/Network errors\r\n            throw new LetsPingError(`Network Error: ${e.message}`);\r\n        }\r\n    }\r\n    tool(service: string, action: string, priority: Priority = \"medium\"): (context: string | Record<string, any>) => Promise<string> {\r\n        return async (context: string | Record<string, any>): Promise<string> => {\r\n            let payload: Record<string, any>;\r\n            try {\r\n                if (typeof context === 'string') {\r\n                    try {\r\n                        payload = JSON.parse(context);\r\n                    } catch {\r\n                        payload = { raw_context: context };\r\n                    }\r\n                } else if (typeof context === 'object' && context !== null) {\r\n                    payload = context;\r\n                } else {\r\n                    // Handle numbers, booleans, undefined, etc.\r\n                    payload = { raw_context: String(context) };\r\n                }\r\n\r\n                const result = await this.ask({\r\n                    service,\r\n                    action,\r\n                    payload,\r\n                    priority\r\n                });\r\n\r\n                if (result.status === \"REJECTED\") {\r\n                    return `STOP: Action Rejected by Human.`;\r\n                }\r\n\r\n                const finalPayload = result.patched_payload || result.payload;\r\n                return JSON.stringify(finalPayload);\r\n            } catch (e: any) {\r\n                return `ERROR: System Failure: ${e.message}`;\r\n            }\r\n        };\r\n    }\r\n}"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAsCO,IAAM,gBAAN,cAA4B,MAAM;AAAA,EACrC,YAAY,SAAwB,QAAiB;AACjD,UAAM,OAAO;AADmB;AAEhC,SAAK,OAAO;AAAA,EAChB;AACJ;AAEO,IAAM,WAAN,MAAe;AAAA,EAIlB,YAAY,QAAiB,SAAgC;AACzD,UAAM,MAAM,UAAU,QAAQ,IAAI;AAClC,QAAI,CAAC,IAAK,OAAM,IAAI,MAAM,4FAA4F;AAEtH,SAAK,SAAS;AACd,SAAK,UAAU,SAAS,WAAW;AAAA,EACvC;AAAA,EAEA,MAAM,IAAI,SAA4C;AAClD,QAAI,QAAQ,UAAW,QAAQ,OAAe,MAAM;AAChD,YAAM,IAAI,cAAc,6IAA6I;AAAA,IACzK;AAEA,UAAM,EAAE,GAAG,IAAI,MAAM,KAAK,QAAwB,QAAQ,WAAW;AAAA,MACjE,SAAS,QAAQ;AAAA,MACjB,QAAQ,QAAQ;AAAA,MAChB,SAAS,QAAQ;AAAA,MACjB,UAAU,QAAQ,YAAY;AAAA,MAC9B,QAAQ,QAAQ;AAAA,MAChB,UAAU;AAAA,QACN,MAAM,QAAQ;AAAA,QACd,KAAK;AAAA,MACT;AAAA,IACJ,CAAC;AAED,UAAM,UAAU,QAAQ,aAAa,KAAK,KAAK,KAAK;AACpD,UAAM,QAAQ,KAAK,IAAI;AACvB,QAAI,QAAQ;AACZ,UAAM,WAAW;AAEjB,WAAO,KAAK,IAAI,IAAI,QAAQ,SAAS;AACjC,UAAI;AACA,cAAM,QAAQ,MAAM,KAAK,QAAa,OAAO,WAAW,EAAE,EAAE;AAE5D,YAAI,MAAM,WAAW,cAAc,MAAM,WAAW,YAAY;AAC5D,iBAAO;AAAA,YACH,QAAQ,MAAM;AAAA,YACd,SAAS,QAAQ;AAAA,YACjB,iBAAiB,MAAM,mBAAmB,QAAQ;AAAA,YAClD,UAAU;AAAA,cACN,aAAa,MAAM;AAAA,cACnB,UAAU,MAAM;AAAA,YACpB;AAAA,UACJ;AAAA,QACJ;AAAA,MACJ,SAAS,GAAQ;AAOb,cAAM,SAAS,EAAE;AACjB,YAAI,UAAU,UAAU,OAAO,SAAS,OAAO,WAAW,OAAO,WAAW,KAAK;AAC7E,gBAAM;AAAA,QACV;AAAA,MACJ;AAEA,YAAM,SAAS,KAAK,OAAO,IAAI;AAC/B,YAAM,IAAI,QAAQ,OAAK,WAAW,GAAG,QAAQ,MAAM,CAAC;AACpD,cAAQ,KAAK,IAAI,QAAQ,KAAK,QAAQ;AAAA,IAC1C;AAEA,UAAM,IAAI,cAAc,WAAW,EAAE,kCAAkC;AAAA,EAC3E;AAAA,EAEA,MAAM,MAAM,SAAkD;AAC1D,WAAO,KAAK,QAAwB,QAAQ,WAAW,OAAO;AAAA,EAClE;AAAA,EAEA,MAAc,QAAW,QAAgB,MAAc,MAAwB;AAE3E,UAAM,UAAkC;AAAA,MACpC,iBAAiB,UAAU,KAAK,MAAM;AAAA,MACtC,gBAAgB;AAAA,MAChB,cAAc;AAAA,IAClB;AAEA,QAAI;AACA,YAAM,WAAW,MAAM,MAAM,GAAG,KAAK,OAAO,GAAG,IAAI,IAAI;AAAA,QACnD;AAAA,QACA;AAAA,QACA,MAAM,OAAO,KAAK,UAAU,IAAI,IAAI;AAAA,MACxC,CAAC;AAED,UAAI,CAAC,SAAS,IAAI;AACd,cAAM,YAAY,MAAM,SAAS,KAAK;AAEtC,YAAI,UAAU;AACd,YAAI;AACA,gBAAM,OAAO,KAAK,MAAM,SAAS;AACjC,cAAI,KAAK,QAAS,WAAU,KAAK;AAAA,QACrC,QAAQ;AAAA,QAAE;AAEV,cAAM,IAAI,cAAc,cAAc,SAAS,MAAM,MAAM,OAAO,IAAI,SAAS,MAAM;AAAA,MACzF;AAEA,aAAO,SAAS,KAAK;AAAA,IACzB,SAAS,GAAQ;AACb,UAAI,aAAa,cAAe,OAAM;AAEtC,YAAM,IAAI,cAAc,kBAAkB,EAAE,OAAO,EAAE;AAAA,IACzD;AAAA,EACJ;AAAA,EACA,KAAK,SAAiB,QAAgB,WAAqB,UAAsE;AAC7H,WAAO,OAAO,YAA2D;AACrE,UAAI;AACJ,UAAI;AACA,YAAI,OAAO,YAAY,UAAU;AAC7B,cAAI;AACA,sBAAU,KAAK,MAAM,OAAO;AAAA,UAChC,QAAQ;AACJ,sBAAU,EAAE,aAAa,QAAQ;AAAA,UACrC;AAAA,QACJ,WAAW,OAAO,YAAY,YAAY,YAAY,MAAM;AACxD,oBAAU;AAAA,QACd,OAAO;AAEH,oBAAU,EAAE,aAAa,OAAO,OAAO,EAAE;AAAA,QAC7C;AAEA,cAAM,SAAS,MAAM,KAAK,IAAI;AAAA,UAC1B;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACJ,CAAC;AAED,YAAI,OAAO,WAAW,YAAY;AAC9B,iBAAO;AAAA,QACX;AAEA,cAAM,eAAe,OAAO,mBAAmB,OAAO;AACtD,eAAO,KAAK,UAAU,YAAY;AAAA,MACtC,SAAS,GAAQ;AACb,eAAO,0BAA0B,EAAE,OAAO;AAAA,MAC9C;AAAA,IACJ;AAAA,EACJ;AACJ;","names":[]}

package/dist/index.mjs

@@ -0,0 +1,128 @@
+// src/index.ts
+var LetsPingError = class extends Error {
+  constructor(message, status) {
+    super(message);
+    this.status = status;
+    this.name = "LetsPingError";
+  }
+};
+var LetsPing = class {
+  constructor(apiKey, options) {
+    const key = apiKey || process.env.LETSPING_API_KEY;
+    if (!key) throw new Error("LetsPing: API Key is required. Pass it to the constructor or set LETSPING_API_KEY env var.");
+    this.apiKey = key;
+    this.baseUrl = options?.baseUrl || "https://letsping.co/api";
+  }
+  async ask(options) {
+    if (options.schema && options.schema._def) {
+      throw new LetsPingError("LetsPing Error: Raw Zod schema detected. You must convert it to JSON Schema (e.g. using 'zod-to-json-schema') before passing it to the SDK.");
+    }
+    const { id } = await this.request("POST", "/ingest", {
+      service: options.service,
+      action: options.action,
+      payload: options.payload,
+      priority: options.priority || "medium",
+      schema: options.schema,
+      metadata: {
+        role: options.role,
+        sdk: "node"
+      }
+    });
+    const timeout = options.timeoutMs || 24 * 60 * 60 * 1e3;
+    const start = Date.now();
+    let delay = 1e3;
+    const maxDelay = 1e4;
+    while (Date.now() - start < timeout) {
+      try {
+        const check = await this.request("GET", `/status/${id}`);
+        if (check.status === "APPROVED" || check.status === "REJECTED") {
+          return {
+            status: check.status,
+            payload: options.payload,
+            patched_payload: check.patched_payload || options.payload,
+            metadata: {
+              resolved_at: check.resolved_at,
+              actor_id: check.actor_id
+            }
+          };
+        }
+      } catch (e) {
+        const status = e.status;
+        if (status && status >= 400 && status < 500 && status !== 404 && status !== 429) {
+          throw e;
+        }
+      }
+      const jitter = Math.random() * 200;
+      await new Promise((r) => setTimeout(r, delay + jitter));
+      delay = Math.min(delay * 1.5, maxDelay);
+    }
+    throw new LetsPingError(`Request ${id} timed out waiting for approval.`);
+  }
+  async defer(options) {
+    return this.request("POST", "/ingest", options);
+  }
+  async request(method, path, body) {
+    const headers = {
+      "Authorization": `Bearer ${this.apiKey}`,
+      "Content-Type": "application/json",
+      "User-Agent": "letsping-node/0.1.2"
+    };
+    try {
+      const response = await fetch(`${this.baseUrl}${path}`, {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : void 0
+      });
+      if (!response.ok) {
+        const errorText = await response.text();
+        let message = errorText;
+        try {
+          const json = JSON.parse(errorText);
+          if (json.message) message = json.message;
+        } catch {
+        }
+        throw new LetsPingError(`API Error [${response.status}]: ${message}`, response.status);
+      }
+      return response.json();
+    } catch (e) {
+      if (e instanceof LetsPingError) throw e;
+      throw new LetsPingError(`Network Error: ${e.message}`);
+    }
+  }
+  tool(service, action, priority = "medium") {
+    return async (context) => {
+      let payload;
+      try {
+        if (typeof context === "string") {
+          try {
+            payload = JSON.parse(context);
+          } catch {
+            payload = { raw_context: context };
+          }
+        } else if (typeof context === "object" && context !== null) {
+          payload = context;
+        } else {
+          payload = { raw_context: String(context) };
+        }
+        const result = await this.ask({
+          service,
+          action,
+          payload,
+          priority
+        });
+        if (result.status === "REJECTED") {
+          return `STOP: Action Rejected by Human.`;
+        }
+        const finalPayload = result.patched_payload || result.payload;
+        return JSON.stringify(finalPayload);
+      } catch (e) {
+        return `ERROR: System Failure: ${e.message}`;
+      }
+    };
+  }
+};
+export {
+  LetsPing,
+  LetsPingError
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type Priority = \"low\" | \"medium\" | \"high\" | \"critical\";\r\n\r\n/**\r\n * Options for configuring a LetsPing approval request.\r\n */\r\nexport interface RequestOptions {\r\n    /** Name of the agent or service (e.g., \"billing-agent\") */\r\n    service: string;\r\n    /** Specific action being requested (e.g., \"refund_user\") */\r\n    action: string;\r\n    /** The data payload to be reviewed by the human */\r\n    payload: Record<string, any>;\r\n    /** Urgency level affecting notification routing (default: \"medium\") */\r\n    priority?: Priority;\r\n    /** JSON Schema (Draft 7) for rendering a structured form in the dashboard */\r\n    schema?: Record<string, any>;\r\n    /** Maximum time to wait for approval in milliseconds (default: 24h) */\r\n    timeoutMs?: number;\r\n    /** (Enterprise) Specific role required for approval (e.g., \"finance\") */\r\n    role?: string;\r\n}\r\n\r\n/**\r\n * The result of a human approval decision.\r\n */\r\nexport interface Decision {\r\n    status: \"APPROVED\" | \"REJECTED\";\r\n    /** The original payload submitted */\r\n    payload: any;\r\n    /** The modified payload if the human edited values during approval */\r\n    patched_payload?: any;\r\n    metadata?: {\r\n        resolved_at: string;\r\n        actor_id: string;\r\n        method?: string;\r\n    };\r\n}\r\n\r\nexport class LetsPingError extends Error {\r\n    constructor(message: string, public status?: number) {\r\n        super(message);\r\n        this.name = \"LetsPingError\";\r\n    }\r\n}\r\n\r\nexport class LetsPing {\r\n    private readonly apiKey: string;\r\n    private readonly baseUrl: string;\r\n\r\n    constructor(apiKey?: string, options?: { baseUrl?: string }) {\r\n        const key = apiKey || process.env.LETSPING_API_KEY;\r\n        if (!key) throw new Error(\"LetsPing: API Key is required. Pass it to the constructor or set LETSPING_API_KEY env var.\");\r\n\r\n        this.apiKey = key;\r\n        this.baseUrl = options?.baseUrl || \"https://letsping.co/api\";\r\n    }\r\n\r\n    async ask(options: RequestOptions): Promise<Decision> {\r\n        if (options.schema && (options.schema as any)._def) {\r\n            throw new LetsPingError(\"LetsPing Error: Raw Zod schema detected. You must convert it to JSON Schema (e.g. using 'zod-to-json-schema') before passing it to the SDK.\");\r\n        }\r\n\r\n        const { id } = await this.request<{ id: string }>(\"POST\", \"/ingest\", {\r\n            service: options.service,\r\n            action: options.action,\r\n            payload: options.payload,\r\n            priority: options.priority || \"medium\",\r\n            schema: options.schema,\r\n            metadata: {\r\n                role: options.role,\r\n                sdk: \"node\"\r\n            }\r\n        });\r\n\r\n        const timeout = options.timeoutMs || 24 * 60 * 60 * 1000;\r\n        const start = Date.now();\r\n        let delay = 1000;\r\n        const maxDelay = 10000;\r\n\r\n        while (Date.now() - start < timeout) {\r\n            try {\r\n                const check = await this.request<any>(\"GET\", `/status/${id}`);\r\n\r\n                if (check.status === \"APPROVED\" || check.status === \"REJECTED\") {\r\n                    return {\r\n                        status: check.status,\r\n                        payload: options.payload,\r\n                        patched_payload: check.patched_payload || options.payload,\r\n                        metadata: {\r\n                            resolved_at: check.resolved_at,\r\n                            actor_id: check.actor_id\r\n                        }\r\n                    };\r\n                }\r\n            } catch (e: any) {\r\n                // Retry on:\r\n                // 1. Network errors (status is undefined)\r\n                // 2. 404 (not found yet)\r\n                // 3. 429 (rate limit)\r\n                // 4. 5xx (server error)\r\n                // Fail on: 400, 401, 403 (client errors)\r\n                const status = e.status;\r\n                if (status && status >= 400 && status < 500 && status !== 404 && status !== 429) {\r\n                    throw e;\r\n                }\r\n            }\r\n\r\n            const jitter = Math.random() * 200;\r\n            await new Promise(r => setTimeout(r, delay + jitter));\r\n            delay = Math.min(delay * 1.5, maxDelay);\r\n        }\r\n\r\n        throw new LetsPingError(`Request ${id} timed out waiting for approval.`);\r\n    }\r\n\r\n    async defer(options: RequestOptions): Promise<{ id: string }> {\r\n        return this.request<{ id: string }>(\"POST\", \"/ingest\", options);\r\n    }\r\n\r\n    private async request<T>(method: string, path: string, body?: any): Promise<T> {\r\n        // Shared headers\r\n        const headers: Record<string, string> = {\r\n            \"Authorization\": `Bearer ${this.apiKey}`,\r\n            \"Content-Type\": \"application/json\",\r\n            \"User-Agent\": \"letsping-node/0.1.2\"\r\n        };\r\n\r\n        try {\r\n            const response = await fetch(`${this.baseUrl}${path}`, {\r\n                method,\r\n                headers,\r\n                body: body ? JSON.stringify(body) : undefined,\r\n            });\r\n\r\n            if (!response.ok) {\r\n                const errorText = await response.text();\r\n                // Try parsing JSON error message\r\n                let message = errorText;\r\n                try {\r\n                    const json = JSON.parse(errorText);\r\n                    if (json.message) message = json.message;\r\n                } catch { }\r\n\r\n                throw new LetsPingError(`API Error [${response.status}]: ${message}`, response.status);\r\n            }\r\n\r\n            return response.json() as Promise<T>;\r\n        } catch (e: any) {\r\n            if (e instanceof LetsPingError) throw e;\r\n            // Fetch/Network errors\r\n            throw new LetsPingError(`Network Error: ${e.message}`);\r\n        }\r\n    }\r\n    tool(service: string, action: string, priority: Priority = \"medium\"): (context: string | Record<string, any>) => Promise<string> {\r\n        return async (context: string | Record<string, any>): Promise<string> => {\r\n            let payload: Record<string, any>;\r\n            try {\r\n                if (typeof context === 'string') {\r\n                    try {\r\n                        payload = JSON.parse(context);\r\n                    } catch {\r\n                        payload = { raw_context: context };\r\n                    }\r\n                } else if (typeof context === 'object' && context !== null) {\r\n                    payload = context;\r\n                } else {\r\n                    // Handle numbers, booleans, undefined, etc.\r\n                    payload = { raw_context: String(context) };\r\n                }\r\n\r\n                const result = await this.ask({\r\n                    service,\r\n                    action,\r\n                    payload,\r\n                    priority\r\n                });\r\n\r\n                if (result.status === \"REJECTED\") {\r\n                    return `STOP: Action Rejected by Human.`;\r\n                }\r\n\r\n                const finalPayload = result.patched_payload || result.payload;\r\n                return JSON.stringify(finalPayload);\r\n            } catch (e: any) {\r\n                return `ERROR: System Failure: ${e.message}`;\r\n            }\r\n        };\r\n    }\r\n}"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@letsping/sdk",
-    "version": "0.1.0",
+    "version": "0.1.2",
     "description": "The Human-in-the-Loop SDK for Autonomous Agents",
     "main": "./dist/index.js",
     "module": "./dist/index.mjs",
@@ -20,8 +20,8 @@
     "dependencies": {},
     "devDependencies": {
         "tsup": "^8.0.0",
-        "typescript": "^5.0.0",
-        "@types/node": "^20.0.0"
+        "typescript": "^5.7.2",
+        "@types/node": "^22.0.0"
     },
     "publishConfig": {
         "access": "public"

package/src/index.d.ts

@@ -0,0 +1,35 @@
+export type Priority = "low" | "medium" | "high" | "critical";
+export interface RequestOptions {
+    service: string;
+    action: string;
+    payload: Record<string, any>;
+    priority?: Priority;
+    schema?: Record<string, any>;
+    timeoutMs?: number;
+}
+export interface Decision {
+    status: "APPROVED" | "REJECTED";
+    payload: any;
+    patched_payload?: any;
+    metadata?: {
+        resolved_at: string;
+        actor_id: string;
+        method?: string;
+    };
+}
+export declare class LetsPingError extends Error {
+    status?: number | undefined;
+    constructor(message: string, status?: number | undefined);
+}
+export declare class LetsPing {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(apiKey?: string, options?: {
+        baseUrl?: string;
+    });
+    ask(options: RequestOptions): Promise<Decision>;
+    defer(options: RequestOptions): Promise<{
+        id: string;
+    }>;
+    private request;
+}

package/src/index.ts

@@ -1,21 +1,33 @@
 export type Priority = "low" | "medium" | "high" | "critical";
 
+/**
+ * Options for configuring a LetsPing approval request.
+ */
 export interface RequestOptions {
+    /** Name of the agent or service (e.g., "billing-agent") */
     service: string;
+    /** Specific action being requested (e.g., "refund_user") */
     action: string;
+    /** The data payload to be reviewed by the human */
     payload: Record<string, any>;
+    /** Urgency level affecting notification routing (default: "medium") */
     priority?: Priority;
-    /**
-     * JSON Schema object defining the structure of the payload for the Human UI.
-     * Note: If using Zod, use `zod-to-json-schema` before passing it here.
-     */
+    /** JSON Schema (Draft 7) for rendering a structured form in the dashboard */
     schema?: Record<string, any>;
+    /** Maximum time to wait for approval in milliseconds (default: 24h) */
     timeoutMs?: number;
+    /** (Enterprise) Specific role required for approval (e.g., "finance") */
+    role?: string;
 }
 
+/**
+ * The result of a human approval decision.
+ */
 export interface Decision {
     status: "APPROVED" | "REJECTED";
+    /** The original payload submitted */
     payload: any;
+    /** The modified payload if the human edited values during approval */
     patched_payload?: any;
     metadata?: {
         resolved_at: string;
@@ -44,9 +56,8 @@ export class LetsPing {
     }
 
     async ask(options: RequestOptions): Promise<Decision> {
-        // Warn if a raw Zod object is passed, as it serializes to {}
         if (options.schema && (options.schema as any)._def) {
-            console.warn("\x1b[33m%s\x1b[0m", "⚠️ LetsPing Warning: It looks like you passed a raw Zod object to 'schema'. This will result in an empty form. Please convert it to JSON Schema first (e.g. using 'zod-to-json-schema').");
+            throw new LetsPingError("LetsPing Error: Raw Zod schema detected. You must convert it to JSON Schema (e.g. using 'zod-to-json-schema') before passing it to the SDK.");
         }
 
         const { id } = await this.request<{ id: string }>("POST", "/ingest", {
@@ -54,7 +65,11 @@ export class LetsPing {
             action: options.action,
             payload: options.payload,
             priority: options.priority || "medium",
-            schema: options.schema
+            schema: options.schema,
+            metadata: {
+                role: options.role,
+                sdk: "node"
+            }
         });
 
         const timeout = options.timeoutMs || 24 * 60 * 60 * 1000;
@@ -78,8 +93,16 @@ export class LetsPing {
                     };
                 }
             } catch (e: any) {
-                // Ignore 404 (pending) and 429 (rate limit), throw everything else
-                if (e.status !== 404 && e.status !== 429) throw e;
+                // Retry on:
+                // 1. Network errors (status is undefined)
+                // 2. 404 (not found yet)
+                // 3. 429 (rate limit)
+                // 4. 5xx (server error)
+                // Fail on: 400, 401, 403 (client errors)
+                const status = e.status;
+                if (status && status >= 400 && status < 500 && status !== 404 && status !== 429) {
+                    throw e;
+                }
             }
 
             const jitter = Math.random() * 200;
@@ -95,10 +118,11 @@ export class LetsPing {
     }
 
     private async request<T>(method: string, path: string, body?: any): Promise<T> {
+        // Shared headers
         const headers: Record<string, string> = {
             "Authorization": `Bearer ${this.apiKey}`,
             "Content-Type": "application/json",
-            "User-Agent": "letsping-node/0.1.0"
+            "User-Agent": "letsping-node/0.1.2"
         };
 
         try {
@@ -110,13 +134,56 @@ export class LetsPing {
 
             if (!response.ok) {
                 const errorText = await response.text();
-                throw new LetsPingError(`LetsPing API Error [${response.status}]: ${errorText}`, response.status);
+                // Try parsing JSON error message
+                let message = errorText;
+                try {
+                    const json = JSON.parse(errorText);
+                    if (json.message) message = json.message;
+                } catch { }
+
+                throw new LetsPingError(`API Error [${response.status}]: ${message}`, response.status);
             }
 
             return response.json() as Promise<T>;
         } catch (e: any) {
             if (e instanceof LetsPingError) throw e;
+            // Fetch/Network errors
             throw new LetsPingError(`Network Error: ${e.message}`);
         }
     }
+    tool(service: string, action: string, priority: Priority = "medium"): (context: string | Record<string, any>) => Promise<string> {
+        return async (context: string | Record<string, any>): Promise<string> => {
+            let payload: Record<string, any>;
+            try {
+                if (typeof context === 'string') {
+                    try {
+                        payload = JSON.parse(context);
+                    } catch {
+                        payload = { raw_context: context };
+                    }
+                } else if (typeof context === 'object' && context !== null) {
+                    payload = context;
+                } else {
+                    // Handle numbers, booleans, undefined, etc.
+                    payload = { raw_context: String(context) };
+                }
+
+                const result = await this.ask({
+                    service,
+                    action,
+                    payload,
+                    priority
+                });
+
+                if (result.status === "REJECTED") {
+                    return `STOP: Action Rejected by Human.`;
+                }
+
+                const finalPayload = result.patched_payload || result.payload;
+                return JSON.stringify(finalPayload);
+            } catch (e: any) {
+                return `ERROR: System Failure: ${e.message}`;
+            }
+        };
+    }
 }

package/tsc_error.log

@@ -0,0 +1,213 @@
+npm warn Unknown user config "email". This will stop working in the next major version of npm.
+../../node_modules/@types/node/globals.d.ts(95,18): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(95,27): error TS1005: ')' expected.
+../../node_modules/@types/node/globals.d.ts(96,18): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(96,27): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(97,31): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(97,35): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(97,43): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(98,22): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(99,27): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(100,29): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(100,38): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(100,97): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(100,107): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(101,33): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(102,38): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(102,46): error TS1228: A type predicate is only allowed in return type position for functions and methods.
+../../node_modules/@types/node/globals.d.ts(102,49): error TS1434: Unexpected keyword or identifier.
+../../node_modules/@types/node/globals.d.ts(102,53): error TS1128: Declaration or statement expected.
+../../node_modules/@types/node/globals.d.ts(102,68): error TS1005: '(' expected.
+../../node_modules/@types/node/globals.d.ts(102,83): error TS1005: ')' expected.
+../../node_modules/@types/node/globals.d.ts(102,105): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(102,112): error TS1434: Unexpected keyword or identifier.
+../../node_modules/@types/node/globals.d.ts(102,117): error TS1434: Unexpected keyword or identifier.
+../../node_modules/@types/node/globals.d.ts(103,21): error TS1003: Identifier expected.
+../../node_modules/@types/node/globals.d.ts(103,22): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(104,38): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(109,20): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(110,18): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(111,18): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(112,9): error TS1128: Declaration or statement expected.
+../../node_modules/@types/node/globals.d.ts(116,14): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(116,23): error TS1005: ')' expected.
+../../node_modules/@types/node/globals.d.ts(117,14): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(117,23): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(118,19): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(118,23): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(118,49): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(119,28): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(119,32): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(119,40): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(120,22): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(121,22): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(123,27): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(124,30): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(124,39): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(124,154): error TS1109: Expression expected.
+../../node_modules/@types/node/globals.d.ts(126,36): error TS1005: ',' expected.
+../../node_modules/@types/node/globals.d.ts(127,38): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(127,47): error TS1005: ')' expected.
+../../node_modules/@types/node/globals.d.ts(128,42): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(128,51): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(129,54): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(129,58): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(129,66): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(130,46): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(132,51): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(133,53): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(133,62): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(133,103): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(133,112): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(133,126): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(134,57): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(135,65): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(135,70): error TS1435: Unknown keyword or identifier. Did you mean 'get'?
+../../node_modules/@types/node/globals.d.ts(135,76): error TS1434: Unexpected keyword or identifier.
+../../node_modules/@types/node/globals.d.ts(135,86): error TS1434: Unexpected keyword or identifier.
+../../node_modules/@types/node/globals.d.ts(135,90): error TS1434: Unexpected keyword or identifier.
+../../node_modules/@types/node/globals.d.ts(135,94): error TS1434: Unexpected keyword or identifier.
+../../node_modules/@types/node/globals.d.ts(135,99): error TS1434: Unexpected keyword or identifier.
+../../node_modules/@types/node/globals.d.ts(135,102): error TS1434: Unexpected keyword or identifier.
+../../node_modules/@types/node/globals.d.ts(135,112): error TS1434: Unexpected keyword or identifier.
+../../node_modules/@types/node/globals.d.ts(135,114): error TS1434: Unexpected keyword or identifier.
+../../node_modules/@types/node/globals.d.ts(135,124): error TS1434: Unexpected keyword or identifier.
+../../node_modules/@types/node/globals.d.ts(135,138): error TS1434: Unexpected keyword or identifier.
+../../node_modules/@types/node/globals.d.ts(135,143): error TS1434: Unexpected keyword or identifier.
+../../node_modules/@types/node/globals.d.ts(136,29): error TS1003: Identifier expected.
+../../node_modules/@types/node/globals.d.ts(136,30): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(137,62): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(141,18): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(141,27): error TS1005: ')' expected.
+../../node_modules/@types/node/globals.d.ts(142,30): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(142,34): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(142,66): error TS1109: Expression expected.
+../../node_modules/@types/node/globals.d.ts(143,38): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(144,22): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(145,25): error TS1128: Declaration or statement expected.
+../../node_modules/@types/node/globals.d.ts(149,29): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(149,36): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(153,30): error TS1005: ',' expected.
+../../node_modules/@types/node/globals.d.ts(153,44): error TS1005: ',' expected.
+../../node_modules/@types/node/globals.d.ts(153,71): error TS1005: ',' expected.
+../../node_modules/@types/node/globals.d.ts(153,72): error TS1109: Expression expected.
+../../node_modules/@types/node/globals.d.ts(153,74): error TS1109: Expression expected.
+../../node_modules/@types/node/globals.d.ts(155,2): error TS1110: Type expected.
+../../node_modules/@types/node/globals.d.ts(156,6): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(157,17): error TS1128: Declaration or statement expected.
+../../node_modules/@types/node/globals.d.ts(157,18): error TS1128: Declaration or statement expected.
+../../node_modules/@types/node/globals.d.ts(161,14): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(161,23): error TS1005: ')' expected.
+../../node_modules/@types/node/globals.d.ts(162,18): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(162,27): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(163,21): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(163,30): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(163,69): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(163,78): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(164,25): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(164,68): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(164,73): error TS1434: Unexpected keyword or identifier.
+../../node_modules/@types/node/globals.d.ts(164,98): error TS1005: ',' expected.
+../../node_modules/@types/node/globals.d.ts(164,112): error TS1351: An identifier or keyword cannot immediately follow a numeric literal.
+../../node_modules/@types/node/globals.d.ts(164,122): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(164,126): error TS1434: Unexpected keyword or identifier.
+../../node_modules/@types/node/globals.d.ts(164,131): error TS1434: Unexpected keyword or identifier.
+../../node_modules/@types/node/globals.d.ts(164,135): error TS1434: Unexpected keyword or identifier.
+../../node_modules/@types/node/globals.d.ts(164,146): error TS1003: Identifier expected.
+../../node_modules/@types/node/globals.d.ts(164,147): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(165,26): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(167,31): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(168,34): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(168,43): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(170,37): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(170,42): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(171,17): error TS1005: ':' expected.
+../../node_modules/@types/node/globals.d.ts(173,21): error TS1005: ':' expected.
+../../node_modules/@types/node/globals.d.ts(174,10): error TS1109: Expression expected.
+../../node_modules/@types/node/globals.d.ts(175,10): error TS1110: Type expected.
+../../node_modules/@types/node/globals.d.ts(176,10): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(178,15): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(179,18): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(179,27): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(180,23): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(180,32): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(180,106): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(180,117): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(181,22): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(183,27): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(184,31): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(184,40): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(186,30): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(191,15): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(191,19): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(191,27): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(192,14): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(193,14): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(194,14): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(197,16): error TS1136: Property assignment expected.
+../../node_modules/@types/node/globals.d.ts(197,19): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(202,6): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(203,6): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(204,17): error TS1128: Declaration or statement expected.
+../../node_modules/@types/node/globals.d.ts(204,18): error TS1128: Declaration or statement expected.
+../../node_modules/@types/node/globals.d.ts(208,14): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(208,23): error TS1005: ')' expected.
+../../node_modules/@types/node/globals.d.ts(209,18): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(209,27): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(210,21): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(210,30): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(210,71): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(210,83): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(211,25): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(211,69): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(211,83): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(211,88): error TS1434: Unexpected keyword or identifier.
+../../node_modules/@types/node/globals.d.ts(211,93): error TS1434: Unexpected keyword or identifier.
+../../node_modules/@types/node/globals.d.ts(211,98): error TS1434: Unexpected keyword or identifier.
+../../node_modules/@types/node/globals.d.ts(211,112): error TS1434: Unexpected keyword or identifier.
+../../node_modules/@types/node/globals.d.ts(211,116): error TS1434: Unexpected keyword or identifier.
+../../node_modules/@types/node/globals.d.ts(211,119): error TS1434: Unexpected keyword or identifier.
+../../node_modules/@types/node/globals.d.ts(211,133): error TS1003: Identifier expected.
+../../node_modules/@types/node/globals.d.ts(211,134): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(212,26): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(214,31): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(216,33): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(220,20): error TS1005: ':' expected.
+../../node_modules/@types/node/globals.d.ts(222,17): error TS1136: Property assignment expected.
+../../node_modules/@types/node/globals.d.ts(222,21): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(226,6): error TS1109: Expression expected.
+../../node_modules/@types/node/globals.d.ts(227,6): error TS1110: Type expected.
+../../node_modules/@types/node/globals.d.ts(231,14): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(231,23): error TS1005: ')' expected.
+../../node_modules/@types/node/globals.d.ts(232,26): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(232,30): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(232,38): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(233,18): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(234,25): error TS1128: Declaration or statement expected.
+../../node_modules/@types/node/globals.d.ts(237,6): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(237,15): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(239,33): error TS1005: '>' expected.
+../../node_modules/@types/node/globals.d.ts(239,40): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(240,24): error TS1005: ',' expected.
+../../node_modules/@types/node/globals.d.ts(240,50): error TS1128: Declaration or statement expected.
+../../node_modules/@types/node/globals.d.ts(243,26): error TS1005: ',' expected.
+../../node_modules/@types/node/globals.d.ts(243,40): error TS1005: ',' expected.
+../../node_modules/@types/node/globals.d.ts(243,67): error TS1005: ',' expected.
+../../node_modules/@types/node/globals.d.ts(243,68): error TS1109: Expression expected.
+../../node_modules/@types/node/globals.d.ts(243,70): error TS1109: Expression expected.
+../../node_modules/@types/node/globals.d.ts(243,91): error TS1128: Declaration or statement expected.
+../../node_modules/@types/node/globals.d.ts(244,2): error TS1110: Type expected.
+../../node_modules/@types/node/globals.d.ts(247,12): error TS1136: Property assignment expected.
+../../node_modules/@types/node/globals.d.ts(247,15): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(247,33): error TS1128: Declaration or statement expected.
+../../node_modules/@types/node/globals.d.ts(250,10): error TS1005: ';' expected.
+../../node_modules/@types/node/globals.d.ts(250,13): error TS1434: Unexpected keyword or identifier.
+../../node_modules/@types/node/globals.d.ts(251,10): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(252,10): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(253,10): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(254,17): error TS1128: Declaration or statement expected.
+../../node_modules/@types/node/globals.d.ts(254,18): error TS1128: Declaration or statement expected.
+../../node_modules/@types/node/globals.d.ts(255,2): error TS1110: Type expected.
+../../node_modules/@types/node/globals.d.ts(256,6): error TS1161: Unterminated regular expression literal.
+../../node_modules/@types/node/globals.d.ts(257,5): error TS1128: Declaration or statement expected.
+../../node_modules/@types/node/globals.d.ts(258,1): error TS1128: Declaration or statement expected.

package/tsconfig.json

@@ -8,7 +8,14 @@
         "esModuleInterop": true,
         "skipLibCheck": true,
         "forceConsistentCasingInFileNames": true,
-        "baseUrl": "."
+        "baseUrl": ".",
+        "lib": [
+            "ES2020",
+            "DOM"
+        ],
+        "types": [
+            "node"
+        ]
     },
     "include": [
         "src"