crispctl 0.0.0 → 0.1.0

package/dist/help.js

@@ -0,0 +1,175 @@
+export const usage = {
+    authSet: "crispctl auth set [--profile <name>] --identifier <id> --key <key> --tier <website|plugin> --website <website_id>",
+    authShow: "crispctl auth show [--profile <name>]",
+    conversationsList: "crispctl conversations list [--page <n>]",
+    conversationsGet: "crispctl conversations get <session>",
+    conversationsSearch: "crispctl conversations search <query> [--page <n>] [--search-type text|segment]",
+    messagesList: "crispctl messages list <session>",
+    reply: "crispctl reply <session> (--text <message> | --note <note>)",
+    resolve: "crispctl resolve <session>",
+    reopen: "crispctl reopen <session>",
+    assign: "crispctl assign <session> (--user <id> | --unassign)",
+    segments: "crispctl segments <session> --set <a,b>",
+    read: "crispctl read <session>",
+    peopleGet: "crispctl people get <id|email>",
+    operatorsList: "crispctl operators list",
+    listen: "crispctl listen",
+};
+const globals = "Global flags: --json, --profile <name>, --website <id>";
+export const ROOT_HELP = `crispctl — agent-friendly Crisp REST CLI
+
+Usage:
+  crispctl [--json] [--profile <name>] [--website <id>] <command> [args]
+
+${globals}
+
+Commands:
+  auth set                 Save identifier, key, tier, and website_id
+  auth show                Show the resolved profile (key redacted)
+  conversations list       List conversations
+  conversations get        Get one conversation
+  conversations search     Search conversations
+  messages list            List messages in a session
+  reply                    Send an operator message or private note
+  resolve                  Set conversation state to resolved
+  reopen                   Set conversation state to unresolved
+  assign                   Assign or unassign an operator
+  segments                 Replace conversation segments
+  read                     Mark the conversation read for the operator
+  people get               Get a people profile by id or email
+  operators list           List website operators
+  listen                   Stub. RTM is not implemented
+
+Profiles:
+  Named profiles live in the config file. "default" and "sandbox" are the usual names.
+  --profile and CRISPCTL_PROFILE select one. The file remembers the last profile written by auth set.
+
+Environment (overrides the selected profile):
+  CRISPCTL_PROFILE
+  CRISPCTL_IDENTIFIER or CRISP_IDENTIFIER
+  CRISPCTL_KEY or CRISP_KEY
+  CRISPCTL_WEBSITE_ID or CRISP_WEBSITE_ID
+  CRISPCTL_TIER or CRISP_TIER
+  CRISPCTL_CONFIG          Config file path (default: $XDG_CONFIG_HOME/crispctl/config.json)
+
+The token key is never printed. A config file written by crispctl is mode 0600.
+
+Sandbox: use the Cos Crisp sandbox website only. Never point crispctl at production Teachify.
+`;
+const HELP = {
+    auth: `crispctl auth
+
+  auth set     Save a profile
+  auth show    Show the resolved profile with the key redacted
+
+${usage.authSet}
+${usage.authShow}
+`,
+    "auth set": `${usage.authSet}
+
+Writes the selected profile and makes it current. Flags win, then CRISPCTL_* / CRISP_* env, then the existing profile.
+--website and --website-id both set website_id. Tier is website or plugin.
+`,
+    "auth show": `${usage.authShow}
+
+Prints profile, identifier, tier, website_id, whether the key is set, and where each value came from.
+The key value is not included.
+`,
+    conversations: `crispctl conversations
+
+  conversations list
+  conversations get <session>
+  conversations search <query>
+`,
+    "conversations list": `${usage.conversationsList}
+
+GET /v1/website/{website_id}/conversations/{page}
+`,
+    "conversations get": `${usage.conversationsGet}
+
+GET /v1/website/{website_id}/conversation/{session}
+`,
+    "conversations search": `${usage.conversationsSearch}
+
+GET /v1/website/{website_id}/conversations/{page}?search_query&search_type
+search_type is text (default) or segment.
+`,
+    messages: `crispctl messages list <session>
+
+${usage.messagesList}
+`,
+    "messages list": `${usage.messagesList}
+
+GET /v1/website/{website_id}/conversation/{session}/messages
+`,
+    reply: `${usage.reply}
+
+POST /v1/website/{website_id}/conversation/{session}/message
+--text sends {"type":"text","from":"operator","origin":"chat","content":"..."}
+--note sends {"type":"note","from":"operator","origin":"chat","content":"..."}
+`,
+    resolve: `${usage.resolve}
+
+PATCH /v1/website/{website_id}/conversation/{session}/state
+Body: {"state":"resolved"}
+`,
+    reopen: `${usage.reopen}
+
+PATCH /v1/website/{website_id}/conversation/{session}/state
+Body: {"state":"unresolved"}
+`,
+    assign: `${usage.assign}
+
+PATCH /v1/website/{website_id}/conversation/{session}/routing
+--user sends {"assigned":{"user_id":"<id>"}}
+--unassign sends {"assigned":null}
+`,
+    segments: `${usage.segments}
+
+PATCH /v1/website/{website_id}/conversation/{session}/meta
+Body: {"segments":["a","b"]}
+`,
+    read: `${usage.read}
+
+PATCH /v1/website/{website_id}/conversation/{session}/read
+Body: {"from":"operator","origin":"chat"}
+`,
+    people: `crispctl people get <id|email>
+
+${usage.peopleGet}
+`,
+    "people get": `${usage.peopleGet}
+
+A people id calls GET /v1/website/{website_id}/people/profile/{people_id}.
+An email is not placed on that path. crispctl searches
+GET /v1/website/{website_id}/people/profiles/1?search_text=<email>
+and then fetches the people_id whose email matches exactly.
+`,
+    operators: `crispctl operators list
+
+${usage.operatorsList}
+`,
+    "operators list": `${usage.operatorsList}
+
+GET /v1/website/{website_id}/operators/list
+`,
+    listen: `${usage.listen}
+
+RTM listen is not implemented. See the command output for the website-tier connect-endpoints pitfall.
+`,
+};
+export function renderHelp(positionals) {
+    const key = positionals.join(" ");
+    if (!key) {
+        return ROOT_HELP;
+    }
+    if (HELP[key]) {
+        return HELP[key];
+    }
+    const head = positionals[0];
+    if (head && HELP[head]) {
+        return HELP[head];
+    }
+    return `${ROOT_HELP}\nUnknown command: ${positionals[0] ?? ""}\n`;
+}
+//# sourceMappingURL=help.js.map

package/dist/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,OAAO,EAAE,mHAAmH;IAC5H,QAAQ,EAAE,uCAAuC;IACjD,iBAAiB,EAAE,0CAA0C;IAC7D,gBAAgB,EAAE,sCAAsC;IACxD,mBAAmB,EAAE,iFAAiF;IACtG,YAAY,EAAE,kCAAkC;IAChD,KAAK,EAAE,6DAA6D;IACpE,OAAO,EAAE,4BAA4B;IACrC,MAAM,EAAE,2BAA2B;IACnC,MAAM,EAAE,sDAAsD;IAC9D,QAAQ,EAAE,yCAAyC;IACnD,IAAI,EAAE,yBAAyB;IAC/B,SAAS,EAAE,gCAAgC;IAC3C,aAAa,EAAE,yBAAyB;IACxC,MAAM,EAAE,iBAAiB;CACjB,CAAA;AAEV,MAAM,OAAO,GAAG,wDAAwD,CAAA;AAExE,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;EAKvB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCR,CAAA;AAED,MAAM,IAAI,GAA2B;IACnC,IAAI,EAAE;;;;;EAKN,KAAK,CAAC,OAAO;EACb,KAAK,CAAC,QAAQ;CACf;IACC,UAAU,EAAE,GAAG,KAAK,CAAC,OAAO;;;;CAI7B;IACC,WAAW,EAAE,GAAG,KAAK,CAAC,QAAQ;;;;CAI/B;IACC,aAAa,EAAE;;;;;CAKhB;IACC,oBAAoB,EAAE,GAAG,KAAK,CAAC,iBAAiB;;;CAGjD;IACC,mBAAmB,EAAE,GAAG,KAAK,CAAC,gBAAgB;;;CAG/C;IACC,sBAAsB,EAAE,GAAG,KAAK,CAAC,mBAAmB;;;;CAIrD;IACC,QAAQ,EAAE;;EAEV,KAAK,CAAC,YAAY;CACnB;IACC,eAAe,EAAE,GAAG,KAAK,CAAC,YAAY;;;CAGvC;IACC,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK;;;;;CAKtB;IACC,OAAO,EAAE,GAAG,KAAK,CAAC,OAAO;;;;CAI1B;IACC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM;;;;CAIxB;IACC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM;;;;;CAKxB;IACC,QAAQ,EAAE,GAAG,KAAK,CAAC,QAAQ;;;;CAI5B;IACC,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI;;;;CAIpB;IACC,MAAM,EAAE;;EAER,KAAK,CAAC,SAAS;CAChB;IACC,YAAY,EAAE,GAAG,KAAK,CAAC,SAAS;;;;;;CAMjC;IACC,SAAS,EAAE;;EAEX,KAAK,CAAC,aAAa;CACpB;IACC,gBAAgB,EAAE,GAAG,KAAK,CAAC,aAAa;;;CAGzC;IACC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM;;;CAGxB;CACA,CAAA;AAED,MAAM,UAAU,UAAU,CAAC,WAA8B;IACvD,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACjC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACd,OAAO,IAAI,CAAC,GAAG,CAAC,CAAA;IAClB,CAAC;IACD,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAA;IAC3B,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC,IAAI,CAAC,CAAA;IACnB,CAAC;IACD,OAAO,GAAG,SAAS,sBAAsB,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAA;AACnE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export declare function isDirectInvocation(entry?: string, moduleUrl?: string): boolean;

package/dist/index.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+import { realpathSync } from "node:fs";
+import { pathToFileURL } from "node:url";
+import { run } from "./cli.js";
+export function isDirectInvocation(entry = process.argv[1], moduleUrl = import.meta.url) {
+    if (!entry)
+        return false;
+    try {
+        return moduleUrl === pathToFileURL(realpathSync(entry)).href;
+    }
+    catch {
+        return false;
+    }
+}
+if (isDirectInvocation()) {
+    process.exitCode = await run(process.argv.slice(2));
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAE9B,MAAM,UAAU,kBAAkB,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG;IACrF,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IACxB,IAAI,CAAC;QACH,OAAO,SAAS,KAAK,aAAa,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAA;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,IAAI,kBAAkB,EAAE,EAAE,CAAC;IACzB,OAAO,CAAC,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AACrD,CAAC"}

package/dist/output.d.ts

@@ -0,0 +1,11 @@
+export type ErrorPayload = {
+    ok: false;
+    error: string;
+    message: string;
+    status?: number;
+    reason?: string;
+    retry_after?: string;
+};
+export declare function writeOut(stdout: (chunk: string) => void, json: boolean, value: unknown): void;
+export declare function errorPayload(err: unknown, secrets: readonly (string | undefined)[]): ErrorPayload;
+export declare function writeErr(stderr: (chunk: string) => void, json: boolean, err: unknown, secrets: readonly (string | undefined)[]): void;

package/dist/output.js

@@ -0,0 +1,50 @@
+import { CrispApiError, ConfigError, UsageError } from "./errors.js";
+import { redactSecrets } from "./redact.js";
+export function writeOut(stdout, json, value) {
+    if (!json && typeof value === "string") {
+        stdout(value.endsWith("\n") ? value : `${value}\n`);
+        return;
+    }
+    stdout(`${json ? JSON.stringify(value) : JSON.stringify(value, null, 2)}\n`);
+}
+export function errorPayload(err, secrets) {
+    if (err instanceof CrispApiError) {
+        const payload = {
+            ok: false,
+            error: err.reason,
+            status: err.status,
+            reason: err.reason,
+            message: redactSecrets(err.message, secrets),
+        };
+        if (err.retryAfter) {
+            payload.retry_after = err.retryAfter;
+        }
+        return payload;
+    }
+    if (err instanceof UsageError) {
+        return { ok: false, error: "usage", message: redactSecrets(err.message, secrets) };
+    }
+    if (err instanceof ConfigError) {
+        return { ok: false, error: "config", message: redactSecrets(err.message, secrets) };
+    }
+    const message = err instanceof Error ? err.message : "unknown error";
+    return { ok: false, error: "error", message: redactSecrets(message, secrets) };
+}
+export function writeErr(stderr, json, err, secrets) {
+    const payload = errorPayload(err, secrets);
+    if (json) {
+        stderr(`${JSON.stringify(payload)}\n`);
+        return;
+    }
+    if ((payload.error === "usage" || payload.error === "config") && payload.status === undefined) {
+        stderr(`error: ${payload.message}\n`);
+        return;
+    }
+    const head = [payload.status, payload.reason || payload.error].filter((part) => part !== undefined && part !== "").join(" ");
+    if (payload.message && payload.message !== payload.reason && payload.message !== payload.error) {
+        stderr(`error: ${head}: ${payload.message}\n`);
+        return;
+    }
+    stderr(`error: ${head}\n`);
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

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

package/dist/redact.d.ts

@@ -0,0 +1 @@
+export declare function redactSecrets(message: string, secrets: readonly (string | undefined)[]): string;

package/dist/redact.js

@@ -0,0 +1,12 @@
+export function redactSecrets(message, secrets) {
+    const present = [...new Set(secrets.filter((secret) => typeof secret === "string" && secret.length > 0))];
+    if (present.length === 0)
+        return message;
+    present.sort((left, right) => right.length - left.length);
+    const pattern = new RegExp(present.map(escapeRegExp).join("|"), "g");
+    return message.replace(pattern, "[redacted]");
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=redact.js.map

package/dist/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../src/redact.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,OAAwC;IACrF,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAoB,EAAE,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3H,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAA;IACxC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAA;IACzD,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAA;IACpE,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,CAAA;AAC/C,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAA;AACrD,CAAC"}

package/dist/rtm.d.ts

@@ -0,0 +1,4 @@
+export declare const SDK_WEBSITE_TIER_CONNECT_PATH = "/v1/website/connect/endpoints";
+export declare const PLUGIN_CONNECT_PATH = "/v1/plugin/connect/endpoints";
+export declare function connectEndpointsPath(tier: "website" | "plugin", websiteId: string): string;
+export declare function listenStubMessage(websiteId?: string): string;

package/dist/rtm.js

@@ -0,0 +1,25 @@
+export const SDK_WEBSITE_TIER_CONNECT_PATH = "/v1/website/connect/endpoints";
+export const PLUGIN_CONNECT_PATH = "/v1/plugin/connect/endpoints";
+export function connectEndpointsPath(tier, websiteId) {
+    if (tier === "plugin") {
+        return PLUGIN_CONNECT_PATH;
+    }
+    return `/v1/website/${encodeURIComponent(websiteId)}/connect/endpoints`;
+}
+export function listenStubMessage(websiteId) {
+    const correct = websiteId
+        ? connectEndpointsPath("website", websiteId)
+        : "/v1/website/{website_id}/connect/endpoints";
+    return [
+        "listen is not implemented (RTM is a follow-up).",
+        "",
+        "Website-tier pitfall: the official crisp-api Node SDK requests",
+        `GET ${SDK_WEBSITE_TIER_CONNECT_PATH}`,
+        "when the token tier is \"website\". That call omits website_id and does not work.",
+        `The correct website route is GET ${correct}.`,
+        `Plugin tier uses GET ${PLUGIN_CONNECT_PATH}, which the SDK does call.`,
+        "",
+        "Use the Cos Sandbox website only. Never point listen at production Teachify.",
+    ].join("\n");
+}
+//# sourceMappingURL=rtm.js.map

package/dist/rtm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtm.js","sourceRoot":"","sources":["../src/rtm.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,6BAA6B,GAAG,+BAA+B,CAAA;AAE5E,MAAM,CAAC,MAAM,mBAAmB,GAAG,8BAA8B,CAAA;AAEjE,MAAM,UAAU,oBAAoB,CAAC,IAA0B,EAAE,SAAiB;IAChF,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO,mBAAmB,CAAA;IAC5B,CAAC;IACD,OAAO,eAAe,kBAAkB,CAAC,SAAS,CAAC,oBAAoB,CAAA;AACzE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAAkB;IAClD,MAAM,OAAO,GAAG,SAAS;QACvB,CAAC,CAAC,oBAAoB,CAAC,SAAS,EAAE,SAAS,CAAC;QAC5C,CAAC,CAAC,4CAA4C,CAAA;IAChD,OAAO;QACL,iDAAiD;QACjD,EAAE;QACF,gEAAgE;QAChE,OAAO,6BAA6B,EAAE;QACtC,mFAAmF;QACnF,oCAAoC,OAAO,GAAG;QAC9C,wBAAwB,mBAAmB,4BAA4B;QACvE,EAAE;QACF,8EAA8E;KAC/E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const version: string;

package/dist/version.js

@@ -0,0 +1,7 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const here = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(here, "..", "package.json"), "utf8"));
+export const version = pkg.version;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAwB,CAAA;AAErG,MAAM,CAAC,MAAM,OAAO,GAAW,GAAG,CAAC,OAAO,CAAA"}

package/package.json

@@ -1,8 +1,57 @@
 {
   "name": "crispctl",
-  "version": "0.0.0",
-  "description": "Placeholder — crispctl is under development.",
+  "version": "0.1.0",
+  "description": "Agent-friendly CLI for Crisp support operations",
   "license": "MIT",
   "author": "linyiru",
-  "files": ["README.md"]
+  "type": "module",
+  "bin": {
+    "crispctl": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/solcreek/crisp-cli.git"
+  },
+  "homepage": "https://github.com/solcreek/crisp-cli#readme",
+  "bugs": "https://github.com/solcreek/crisp-cli/issues",
+  "keywords": [
+    "crisp",
+    "cli",
+    "support"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.test.json --noEmit",
+    "test": "c8 node --enable-source-maps --import tsx --test test/*.test.ts",
+    "test:live": "node --import tsx --test test/live/smoke.test.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "undici": "^6.21.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.3",
+    "c8": "^10.1.3",
+    "tsx": "^4.20.3",
+    "typescript": "^5.8.3"
+  },
+  "c8": {
+    "all": true,
+    "src": ["src"],
+    "include": ["src/**/*.ts"],
+    "reporter": ["text", "text-summary"],
+    "check-coverage": true,
+    "lines": 80,
+    "statements": 80,
+    "functions": 80,
+    "branches": 75
+  }
 }