@kuralle-syrinx/server-websocket 4.4.1 → 4.5.0

package/dist/websocket-lifecycle.d.ts

@@ -0,0 +1,29 @@
+import { WebSocket } from "ws";
+export declare class WebSocketStartupTimeoutError extends Error {
+    constructor(timeoutMs: number);
+}
+export declare function withWebSocketStartupTimeout<T>(promise: Promise<T>, timeoutMs: number): Promise<T>;
+export declare function startWebSocketHeartbeat(socket: WebSocket, heartbeatIntervalMs: number, disposers: Array<() => void>): void;
+/** Minimal closable shape: a voice websocket server (or any server) that drains on graceful close. */
+export interface GracefulClosable {
+    close(opts?: {
+        graceful?: boolean;
+        drainDeadlineMs?: number;
+    }): Promise<void>;
+}
+/**
+ * Wire process termination signals to the server's graceful drain so a deploy/scale-down
+ * drains active calls instead of killing them (Hard Rule: "drain, don't kill"). Idempotent
+ * (a second signal during shutdown is ignored). Returns a disposer that removes the handlers.
+ *
+ * Production hosts call this once after creating the server:
+ *   installGracefulShutdown(server, { drainDeadlineMs: 10_000, onClosed: () => process.exit(0) });
+ */
+export declare function installGracefulShutdown(server: GracefulClosable, opts?: {
+    readonly drainDeadlineMs?: number;
+    readonly signals?: readonly NodeJS.Signals[];
+    readonly onClosed?: () => void;
+    readonly onError?: (err: unknown) => void;
+}): () => void;
+export declare function startWebSocketMaxSessionDuration(socket: WebSocket, maxSessionDurationMs: number, disposers: Array<() => void>, onTimeout?: () => void): void;
+//# sourceMappingURL=websocket-lifecycle.d.ts.map

package/dist/websocket-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-lifecycle.d.ts","sourceRoot":"","sources":["../src/websocket-lifecycle.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAG/B,qBAAa,4BAA6B,SAAQ,KAAK;gBACzC,SAAS,EAAE,MAAM;CAI9B;AAED,wBAAsB,2BAA2B,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAavG;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,EACjB,mBAAmB,EAAE,MAAM,EAC3B,SAAS,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,GAC3B,IAAI,CAoBN;AAED,sGAAsG;AACtG,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/E;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,gBAAgB,EACxB,IAAI,CAAC,EAAE;IACL,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,CAAC,OAAO,EAAE,CAAC;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;CAC3C,GACA,MAAM,IAAI,CAgBZ;AAED,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,SAAS,EACjB,oBAAoB,EAAE,MAAM,EAC5B,SAAS,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,EAC5B,SAAS,CAAC,EAAE,MAAM,IAAI,GACrB,IAAI,CAON"}

package/dist/websocket-lifecycle.js

@@ -0,0 +1,87 @@
+// SPDX-License-Identifier: MIT
+import { WebSocket } from "ws";
+import { closeWebSocketWithFallback } from "./websocket-close.js";
+export class WebSocketStartupTimeoutError extends Error {
+    constructor(timeoutMs) {
+        super(`websocket session startup exceeded ${String(timeoutMs)}ms`);
+        this.name = "WebSocketStartupTimeoutError";
+    }
+}
+export async function withWebSocketStartupTimeout(promise, timeoutMs) {
+    if (timeoutMs <= 0)
+        return await promise;
+    let timeout = null;
+    try {
+        return await Promise.race([
+            promise,
+            new Promise((_resolve, reject) => {
+                timeout = setTimeout(() => reject(new WebSocketStartupTimeoutError(timeoutMs)), timeoutMs);
+            }),
+        ]);
+    }
+    finally {
+        if (timeout)
+            clearTimeout(timeout);
+    }
+}
+export function startWebSocketHeartbeat(socket, heartbeatIntervalMs, disposers) {
+    if (heartbeatIntervalMs <= 0)
+        return;
+    let alive = true;
+    const onPong = () => {
+        alive = true;
+    };
+    socket.on("pong", onPong);
+    const interval = setInterval(() => {
+        if (socket.readyState !== WebSocket.OPEN)
+            return;
+        if (!alive) {
+            socket.terminate();
+            return;
+        }
+        alive = false;
+        socket.ping();
+    }, heartbeatIntervalMs);
+    disposers.push(() => {
+        clearInterval(interval);
+        socket.off("pong", onPong);
+    });
+}
+/**
+ * Wire process termination signals to the server's graceful drain so a deploy/scale-down
+ * drains active calls instead of killing them (Hard Rule: "drain, don't kill"). Idempotent
+ * (a second signal during shutdown is ignored). Returns a disposer that removes the handlers.
+ *
+ * Production hosts call this once after creating the server:
+ *   installGracefulShutdown(server, { drainDeadlineMs: 10_000, onClosed: () => process.exit(0) });
+ */
+export function installGracefulShutdown(server, opts) {
+    const drainDeadlineMs = opts?.drainDeadlineMs ?? 10_000;
+    const signals = opts?.signals ?? ["SIGTERM", "SIGINT"];
+    let shuttingDown = false;
+    const handler = () => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        server
+            .close({ graceful: true, drainDeadlineMs })
+            .then(() => opts?.onClosed?.())
+            .catch((err) => (opts?.onError ? opts.onError(err) : opts?.onClosed?.()));
+    };
+    for (const signal of signals)
+        process.once(signal, handler);
+    return () => {
+        for (const signal of signals)
+            process.removeListener(signal, handler);
+    };
+}
+export function startWebSocketMaxSessionDuration(socket, maxSessionDurationMs, disposers, onTimeout) {
+    if (maxSessionDurationMs <= 0)
+        return;
+    const timeout = setTimeout(() => {
+        onTimeout?.();
+        closeWebSocketWithFallback(socket, 1000, "websocket max session duration exceeded");
+    }, maxSessionDurationMs);
+    disposers.push(() => clearTimeout(timeout));
+}
+//# sourceMappingURL=websocket-lifecycle.js.map

package/dist/websocket-lifecycle.js.map

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

package/dist/websocket-upgrade.d.ts

@@ -0,0 +1,9 @@
+import type { Server as HttpServer } from "node:http";
+import { WebSocketServer } from "ws";
+import { type TransportAdmissionOptions } from "./transport-host.js";
+export interface RoutedWebSocketServer {
+    readonly wsServer: WebSocketServer;
+    readonly detach: () => void;
+}
+export declare function createRoutedWebSocketServer(httpServer: HttpServer, path: string, admission?: TransportAdmissionOptions): RoutedWebSocketServer;
+//# sourceMappingURL=websocket-upgrade.d.ts.map

package/dist/websocket-upgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-upgrade.d.ts","sourceRoot":"","sources":["../src/websocket-upgrade.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAmB,MAAM,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvE,OAAO,EAAE,eAAe,EAAE,MAAM,IAAI,CAAC;AACrC,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;CAC7B;AA+CD,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,yBAAyB,GACpC,qBAAqB,CAwDvB"}

package/dist/websocket-upgrade.js

@@ -0,0 +1,91 @@
+// SPDX-License-Identifier: MIT
+import { WebSocketServer } from "ws";
+import { rejectWebSocketAdmission, } from "./transport-host.js";
+const routers = new WeakMap();
+function getOrCreateRouter(httpServer) {
+    const existing = routers.get(httpServer);
+    if (existing)
+        return existing;
+    const handlers = new Map();
+    const listener = (request, socket, head) => {
+        const pathname = requestPathname(request);
+        const handler = handlers.get(pathname);
+        if (handler) {
+            handler(request, socket, head);
+            return;
+        }
+        if (httpServer.listenerCount("upgrade") > 1) {
+            return;
+        }
+        socket.destroy();
+    };
+    httpServer.on("upgrade", listener);
+    const router = { handlers, servers: new Set(), listener };
+    routers.set(httpServer, router);
+    return router;
+}
+function requestPathname(request) {
+    try {
+        return new URL(request.url ?? "/", "http://localhost").pathname;
+    }
+    catch {
+        return "/";
+    }
+}
+export function createRoutedWebSocketServer(httpServer, path, admission) {
+    const wsServer = new WebSocketServer({
+        noServer: true,
+        perMessageDeflate: false,
+    });
+    const router = getOrCreateRouter(httpServer);
+    const accept = (request, socket, head) => {
+        const maxConcurrentSessions = admission?.maxConcurrentSessions;
+        const scope = admission?.maxConcurrentSessionsScope ?? "path";
+        const activeSessions = scope === "server"
+            ? [...router.servers].reduce((sum, server) => sum + server.clients.size, 0)
+            : wsServer.clients.size;
+        if (maxConcurrentSessions !== undefined
+            && activeSessions >= maxConcurrentSessions) {
+            admission?.onAdmissionRejected?.();
+            rejectWebSocketAdmission(wsServer, request, socket, head);
+            return;
+        }
+        wsServer.handleUpgrade(request, socket, head, (websocket) => {
+            wsServer.emit("connection", websocket, request);
+        });
+    };
+    const handler = (request, socket, head) => {
+        if (!admission?.authorize) {
+            accept(request, socket, head);
+            return;
+        }
+        // Authorize before completing the upgrade; reject with 4401 on failure/throw.
+        void Promise.resolve()
+            .then(() => admission.authorize(request))
+            .then((ok) => {
+            if (ok) {
+                accept(request, socket, head);
+            }
+            else {
+                rejectWebSocketAdmission(wsServer, request, socket, head, 4401, "unauthorized");
+            }
+        })
+            .catch(() => {
+            rejectWebSocketAdmission(wsServer, request, socket, head, 4401, "unauthorized");
+        });
+    };
+    router.handlers.set(path, handler);
+    router.servers.add(wsServer);
+    return {
+        wsServer,
+        detach: () => {
+            router.handlers.delete(path);
+            router.servers.delete(wsServer);
+            if (router.handlers.size === 0) {
+                httpServer.off("upgrade", router.listener);
+                routers.delete(httpServer);
+            }
+        },
+    };
+}
+//# sourceMappingURL=websocket-upgrade.js.map

package/dist/websocket-upgrade.js.map

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

package/dist/wire-carrier-control.d.ts

@@ -0,0 +1,27 @@
+import { type VoiceAgentSession } from "@kuralle-syrinx/core";
+import { type FetchLike, type TelnyxRestCredentials, type TwilioRestCredentials, type WarmTransferSummarizer } from "./carrier-commands.js";
+export interface TwilioCarrierControlOptions {
+    readonly carrier: "twilio";
+    /** Call SID for the active media stream (injected; may resolve lazily). */
+    getCallSid: () => string | undefined;
+    readonly credentials?: TwilioRestCredentials;
+    readonly fetchImpl?: FetchLike;
+    readonly redirectUrl?: string;
+    readonly warmSummarizer?: WarmTransferSummarizer;
+}
+export interface TelnyxCarrierControlOptions {
+    readonly carrier: "telnyx";
+    getCallControlId: () => string | undefined;
+    readonly credentials?: TelnyxRestCredentials;
+    readonly fetchImpl?: FetchLike;
+    readonly webhookUrl?: string;
+    readonly warmSummarizer?: WarmTransferSummarizer;
+}
+export type CarrierControlOptions = TwilioCarrierControlOptions | TelnyxCarrierControlOptions;
+/**
+ * Subscribe to `dtmf.send` and `call.transfer` on the session bus.
+ * When credentials are absent, still builds the command and emits a metric so
+ * unit tests can assert the constructor path without live HTTP.
+ */
+export declare function wireCarrierControl(session: VoiceAgentSession, disposers: Array<() => void>, options: CarrierControlOptions): void;
+//# sourceMappingURL=wire-carrier-control.d.ts.map

package/dist/wire-carrier-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-carrier-control.d.ts","sourceRoot":"","sources":["../src/wire-carrier-control.ts"],"names":[],"mappings":"AAKA,OAAO,EAAuD,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACnH,OAAO,EAQL,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC5B,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,2EAA2E;IAC3E,UAAU,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,qBAAqB,CAAC;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,sBAAsB,CAAC;CAClD;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,gBAAgB,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,qBAAqB,CAAC;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,sBAAsB,CAAC;CAClD;AAED,MAAM,MAAM,qBAAqB,GAAG,2BAA2B,GAAG,2BAA2B,CAAC;AAE9F;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,iBAAiB,EAC1B,SAAS,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,EAC5B,OAAO,EAAE,qBAAqB,GAC7B,IAAI,CASN"}

package/dist/wire-carrier-control.js

@@ -0,0 +1,116 @@
+// SPDX-License-Identifier: MIT
+//
+// Bus wiring for dtmf.send + call.transfer → pure constructor + injectable dispatch.
+// Mechanism unit-tested; live carrier HTTP unverified.
+import { Route } from "@kuralle-syrinx/core";
+import { buildTelnyxSendDtmf, buildTelnyxTransfer, buildTwilioSendDigits, buildTwilioTransfer, dispatchTelnyxCommand, dispatchTwilioCommand, resolveTransferSummary, } from "./carrier-commands.js";
+/**
+ * Subscribe to `dtmf.send` and `call.transfer` on the session bus.
+ * When credentials are absent, still builds the command and emits a metric so
+ * unit tests can assert the constructor path without live HTTP.
+ */
+export function wireCarrierControl(session, disposers, options) {
+    disposers.push(session.bus.on("dtmf.send", (pkt) => {
+        void handleDtmfSend(session, pkt, options);
+    }), session.bus.on("call.transfer", (pkt) => {
+        void handleCallTransfer(session, pkt, options);
+    }));
+}
+async function handleDtmfSend(session, pkt, options) {
+    try {
+        if (options.carrier === "twilio") {
+            const callSid = options.getCallSid();
+            if (!callSid) {
+                emitMetric(session, pkt.contextId, "carrier.dtmf_send.missing_call_handle", "twilio");
+                return;
+            }
+            const command = buildTwilioSendDigits(callSid, pkt);
+            emitMetric(session, pkt.contextId, "carrier.dtmf_send.built", JSON.stringify({ carrier: "twilio", digits: command.form.SendDigits }));
+            if (!options.credentials) {
+                emitMetric(session, pkt.contextId, "carrier.dtmf_send.no_credentials", "twilio");
+                return;
+            }
+            const res = await dispatchTwilioCommand(options.credentials, command, options.fetchImpl);
+            emitMetric(session, pkt.contextId, "carrier.dtmf_send.dispatched", String(res.status));
+            return;
+        }
+        const callControlId = options.getCallControlId();
+        if (!callControlId) {
+            emitMetric(session, pkt.contextId, "carrier.dtmf_send.missing_call_handle", "telnyx");
+            return;
+        }
+        const command = buildTelnyxSendDtmf(callControlId, pkt);
+        emitMetric(session, pkt.contextId, "carrier.dtmf_send.built", JSON.stringify({ carrier: "telnyx", digits: command.json.digits }));
+        if (!options.credentials) {
+            emitMetric(session, pkt.contextId, "carrier.dtmf_send.no_credentials", "telnyx");
+            return;
+        }
+        const res = await dispatchTelnyxCommand(options.credentials, command, options.fetchImpl);
+        emitMetric(session, pkt.contextId, "carrier.dtmf_send.dispatched", String(res.status));
+    }
+    catch (err) {
+        emitMetric(session, pkt.contextId, "carrier.dtmf_send.error", err instanceof Error ? err.message : String(err));
+    }
+}
+async function handleCallTransfer(session, pkt, options) {
+    try {
+        const summary = await resolveTransferSummary(pkt, options.warmSummarizer);
+        const resolved = summary !== undefined ? { ...pkt, summary } : pkt;
+        if (options.carrier === "twilio") {
+            const callSid = options.getCallSid();
+            if (!callSid) {
+                emitMetric(session, pkt.contextId, "carrier.transfer.missing_call_handle", "twilio");
+                return;
+            }
+            const command = buildTwilioTransfer(callSid, resolved, {
+                redirectUrl: options.redirectUrl,
+            });
+            emitMetric(session, pkt.contextId, "carrier.transfer.built", JSON.stringify({
+                carrier: "twilio",
+                mode: command.mode,
+                target: resolved.target,
+                summary: command.summary ?? null,
+            }));
+            if (!options.credentials) {
+                emitMetric(session, pkt.contextId, "carrier.transfer.no_credentials", "twilio");
+                return;
+            }
+            const res = await dispatchTwilioCommand(options.credentials, command, options.fetchImpl);
+            emitMetric(session, pkt.contextId, "carrier.transfer.dispatched", String(res.status));
+            return;
+        }
+        const callControlId = options.getCallControlId();
+        if (!callControlId) {
+            emitMetric(session, pkt.contextId, "carrier.transfer.missing_call_handle", "telnyx");
+            return;
+        }
+        const command = buildTelnyxTransfer(callControlId, resolved, {
+            webhookUrl: options.webhookUrl,
+        });
+        emitMetric(session, pkt.contextId, "carrier.transfer.built", JSON.stringify({
+            carrier: "telnyx",
+            mode: command.mode,
+            target: command.json.to,
+            summary: command.summary ?? null,
+        }));
+        if (!options.credentials) {
+            emitMetric(session, pkt.contextId, "carrier.transfer.no_credentials", "telnyx");
+            return;
+        }
+        const res = await dispatchTelnyxCommand(options.credentials, command, options.fetchImpl);
+        emitMetric(session, pkt.contextId, "carrier.transfer.dispatched", String(res.status));
+    }
+    catch (err) {
+        emitMetric(session, pkt.contextId, "carrier.transfer.error", err instanceof Error ? err.message : String(err));
+    }
+}
+function emitMetric(session, contextId, name, value) {
+    session.bus.push(Route.Background, {
+        kind: "metric.conversation",
+        contextId,
+        timestampMs: Date.now(),
+        name,
+        value,
+    });
+}
+//# sourceMappingURL=wire-carrier-control.js.map

package/dist/wire-carrier-control.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kuralle-syrinx/server-websocket",
-  "version": "4.4.1",
+  "version": "4.5.0",
   "private": false,
   "description": "Node WebSocket voice host for Syrinx — browser transport plus Twilio/Telnyx/SmartPBX telephony adapters, background audio, admission control",
   "keywords": [
@@ -23,20 +23,35 @@
     "url": "https://github.com/kuralle/syrinx/issues"
   },
   "type": "module",
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts",
-    "./edge": "./src/edge.ts",
-    "./edge-twilio": "./src/edge-twilio.ts",
-    "./edge-telnyx": "./src/edge-telnyx.ts",
-    "./session-store": "./src/session-store.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./edge": {
+      "types": "./dist/edge.d.ts",
+      "default": "./dist/edge.js"
+    },
+    "./edge-twilio": {
+      "types": "./dist/edge-twilio.d.ts",
+      "default": "./dist/edge-twilio.js"
+    },
+    "./edge-telnyx": {
+      "types": "./dist/edge-telnyx.d.ts",
+      "default": "./dist/edge-telnyx.js"
+    },
+    "./session-store": {
+      "types": "./dist/session-store.d.ts",
+      "default": "./dist/session-store.js"
+    }
   },
   "dependencies": {
     "@evan/opus": "1.0.3",
     "ws": "^8.21.0",
-    "@kuralle-syrinx/core": "4.4.1",
-    "@kuralle-syrinx/ws": "4.4.1"
+    "@kuralle-syrinx/core": "4.5.0",
+    "@kuralle-syrinx/ws": "4.5.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
@@ -44,8 +59,14 @@
     "typescript": "^5.7.0",
     "vitest": "^3.2.6"
   },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
   "scripts": {
     "typecheck": "tsc --noEmit",
-    "test": "vitest run --fileParallelism=false"
+    "test": "vitest run --fileParallelism=false",
+    "build": "tsc -p tsconfig.build.json"
   }
 }