@hostwebhook/node-types 1.55.3 → 1.56.0

package/dist/index.d.ts

@@ -3,8 +3,9 @@ export { singleMeta, iterableMeta } from './types';
 export { NODE_CONNECTIONS, canReceiveFrom, canReceiveFromNodes, canSendToNodes, isTerminal, isNodeType, ALL_NODE_TYPES, } from './connections';
 export { NODE_UI, PREFIX_TO_TYPE, resolveNodeId, } from './ui';
 export { NODE_DISPATCH, getAllNodeCollections, getNodeDispatchConfig, } from './dispatch';
-export type { NodeRegistryEntry, NodeGroup } from './registry';
+export type { NodeRegistryEntry, NodeGroup, NodeVersionSpec, VersionCatalog, } from './registry';
 export { NODE_REGISTRY, getNodeRegistryEntry, NODE_DETAIL_PATHS, NODE_COLORS, NODE_STATE_KEYS, PREFIX_TO_NODE_TYPE, NODE_TYPE_TO_PREFIX, } from './registry';
+export { isVersioned, versionsOf, versionSpec, currentVersion, fieldsLostBetween, fieldsLost, versionCatalogErrors, } from './registry';
 export { GMAIL_OPERATIONS, GMAIL_OPERATION_SPECS, GMAIL_OPERATION_GROUPS, GMAIL_DROPDOWN_OPERATIONS, GMAIL_TOOLKIT_OPERATIONS, GMAIL_TOOLKIT_SPECS, GMAIL_ALL_TOOLKIT_SPECS, GMAIL_SEND_AND_WAIT_TOOL_SPEC, NATIVE_EMAIL_TOOLKIT_SPECS, GMAIL_TOOLKIT_BY_TOOL_NAME, NATIVE_EMAIL_TOOLKIT_BY_TOOL_NAME, GMAIL_SEND_LEGACY_FIELDS, resolveGmailSendFields, isGmailOperation, } from './gmail-operations';
 export type { GmailOperation, GmailOperationGroup, GmailParamType, GmailParamSpec, GmailOperationSpec, GmailToolkitParameter, GmailToolkitSpec, GmailSendFieldSource, GmailSendFields, } from './gmail-operations';
 export { GOOGLE_CALENDAR_OPERATIONS, GOOGLE_CALENDAR_OPERATION_SPECS, isGoogleCalendarOperation, } from './calendar-operations';

package/dist/index.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TELEGRAM_TOOLKIT_SPECS = exports.isTelegramOperation = exports.TELEGRAM_OPERATION_SPECS = exports.TELEGRAM_OPERATIONS = exports.DRIVE_TOOLKIT_BY_TOOL_NAME = exports.DRIVE_TOOLKIT_SPECS = exports.isDriveOperation = exports.DRIVE_OPERATION_SPECS = exports.DRIVE_OPERATIONS = exports.GOOGLE_CALENDAR_TOOLKIT_BY_TOOL_NAME = exports.GOOGLE_CALENDAR_TOOLKIT_SPECS = exports.isGoogleCalendarOperation = exports.GOOGLE_CALENDAR_OPERATION_SPECS = exports.GOOGLE_CALENDAR_OPERATIONS = exports.isGmailOperation = exports.resolveGmailSendFields = exports.GMAIL_SEND_LEGACY_FIELDS = exports.NATIVE_EMAIL_TOOLKIT_BY_TOOL_NAME = exports.GMAIL_TOOLKIT_BY_TOOL_NAME = exports.NATIVE_EMAIL_TOOLKIT_SPECS = exports.GMAIL_SEND_AND_WAIT_TOOL_SPEC = exports.GMAIL_ALL_TOOLKIT_SPECS = exports.GMAIL_TOOLKIT_SPECS = exports.GMAIL_TOOLKIT_OPERATIONS = exports.GMAIL_DROPDOWN_OPERATIONS = exports.GMAIL_OPERATION_GROUPS = exports.GMAIL_OPERATION_SPECS = exports.GMAIL_OPERATIONS = exports.NODE_TYPE_TO_PREFIX = exports.PREFIX_TO_NODE_TYPE = exports.NODE_STATE_KEYS = exports.NODE_COLORS = exports.NODE_DETAIL_PATHS = exports.getNodeRegistryEntry = exports.NODE_REGISTRY = exports.getNodeDispatchConfig = exports.getAllNodeCollections = exports.NODE_DISPATCH = exports.resolveNodeId = exports.PREFIX_TO_TYPE = exports.NODE_UI = exports.ALL_NODE_TYPES = exports.isNodeType = exports.isTerminal = exports.canSendToNodes = exports.canReceiveFromNodes = exports.canReceiveFrom = exports.NODE_CONNECTIONS = exports.iterableMeta = exports.singleMeta = void 0;
-exports.isCredentialType = exports.getCredentialType = exports.credentialTypeValues = exports.CREDENTIAL_TYPE_VALUES = exports.CREDENTIAL_TYPES = exports.getModelLabel = exports.getDefaultModel = exports.getModelsFor = exports.MODEL_CONTEXT_WINDOWS = exports.LLM_MODELS = exports.LLM_PROVIDERS = exports.DOCS_TOOLKIT_DEFAULTABLE = exports.DOCS_TOOLKIT_BY_TOOL_NAME = exports.DOCS_TOOLKIT_SPECS = exports.isDocsOperation = exports.DOCS_OPERATION_SPECS = exports.DOCS_OPERATIONS = exports.isMongoOperation = exports.MONGO_OPERATION_SPECS = exports.MONGO_OPERATIONS = exports.isPostgresOperation = exports.POSTGRES_OPERATION_SPECS = exports.POSTGRES_MODES = exports.POSTGRES_OPERATIONS = exports.isGoogleContactsOperation = exports.GOOGLE_CONTACTS_DEFAULT_PERSON_FIELDS = exports.GOOGLE_CONTACTS_OPERATION_GROUPS = exports.GOOGLE_CONTACTS_OPERATION_SPECS = exports.GOOGLE_CONTACTS_OPERATIONS_V2 = exports.GOOGLE_CONTACTS_OPERATIONS_V1 = exports.GOOGLE_CONTACTS_OPERATIONS = exports.SHEETS_TOOLKIT_DEFAULTABLE = exports.SHEETS_TOOLKIT_BY_TOOL_NAME = exports.SHEETS_TOOLKIT_SPECS = exports.isSheetsOperation = exports.SHEETS_OPERATION_SPECS = exports.SHEETS_OPERATIONS = exports.isSlackOperation = exports.SLACK_OPERATION_SPECS = exports.SLACK_OPERATIONS = exports.isDiscordOperation = exports.DISCORD_OPERATION_SPECS = exports.DISCORD_OPERATIONS = exports.isWhatsAppOperation = exports.WHATSAPP_OPERATIONS = exports.TELEGRAM_TOOLKIT_BY_TOOL_NAME = void 0;
+exports.DRIVE_OPERATION_SPECS = exports.DRIVE_OPERATIONS = exports.GOOGLE_CALENDAR_TOOLKIT_BY_TOOL_NAME = exports.GOOGLE_CALENDAR_TOOLKIT_SPECS = exports.isGoogleCalendarOperation = exports.GOOGLE_CALENDAR_OPERATION_SPECS = exports.GOOGLE_CALENDAR_OPERATIONS = exports.isGmailOperation = exports.resolveGmailSendFields = exports.GMAIL_SEND_LEGACY_FIELDS = exports.NATIVE_EMAIL_TOOLKIT_BY_TOOL_NAME = exports.GMAIL_TOOLKIT_BY_TOOL_NAME = exports.NATIVE_EMAIL_TOOLKIT_SPECS = exports.GMAIL_SEND_AND_WAIT_TOOL_SPEC = exports.GMAIL_ALL_TOOLKIT_SPECS = exports.GMAIL_TOOLKIT_SPECS = exports.GMAIL_TOOLKIT_OPERATIONS = exports.GMAIL_DROPDOWN_OPERATIONS = exports.GMAIL_OPERATION_GROUPS = exports.GMAIL_OPERATION_SPECS = exports.GMAIL_OPERATIONS = exports.versionCatalogErrors = exports.fieldsLost = exports.fieldsLostBetween = exports.currentVersion = exports.versionSpec = exports.versionsOf = exports.isVersioned = exports.NODE_TYPE_TO_PREFIX = exports.PREFIX_TO_NODE_TYPE = exports.NODE_STATE_KEYS = exports.NODE_COLORS = exports.NODE_DETAIL_PATHS = exports.getNodeRegistryEntry = exports.NODE_REGISTRY = exports.getNodeDispatchConfig = exports.getAllNodeCollections = exports.NODE_DISPATCH = exports.resolveNodeId = exports.PREFIX_TO_TYPE = exports.NODE_UI = exports.ALL_NODE_TYPES = exports.isNodeType = exports.isTerminal = exports.canSendToNodes = exports.canReceiveFromNodes = exports.canReceiveFrom = exports.NODE_CONNECTIONS = exports.iterableMeta = exports.singleMeta = void 0;
+exports.CREDENTIAL_TYPE_VALUES = exports.CREDENTIAL_TYPES = exports.getModelLabel = exports.getDefaultModel = exports.getModelsFor = exports.MODEL_CONTEXT_WINDOWS = exports.LLM_MODELS = exports.LLM_PROVIDERS = exports.DOCS_TOOLKIT_DEFAULTABLE = exports.DOCS_TOOLKIT_BY_TOOL_NAME = exports.DOCS_TOOLKIT_SPECS = exports.isDocsOperation = exports.DOCS_OPERATION_SPECS = exports.DOCS_OPERATIONS = exports.isMongoOperation = exports.MONGO_OPERATION_SPECS = exports.MONGO_OPERATIONS = exports.isPostgresOperation = exports.POSTGRES_OPERATION_SPECS = exports.POSTGRES_MODES = exports.POSTGRES_OPERATIONS = exports.isGoogleContactsOperation = exports.GOOGLE_CONTACTS_DEFAULT_PERSON_FIELDS = exports.GOOGLE_CONTACTS_OPERATION_GROUPS = exports.GOOGLE_CONTACTS_OPERATION_SPECS = exports.GOOGLE_CONTACTS_OPERATIONS_V2 = exports.GOOGLE_CONTACTS_OPERATIONS_V1 = exports.GOOGLE_CONTACTS_OPERATIONS = exports.SHEETS_TOOLKIT_DEFAULTABLE = exports.SHEETS_TOOLKIT_BY_TOOL_NAME = exports.SHEETS_TOOLKIT_SPECS = exports.isSheetsOperation = exports.SHEETS_OPERATION_SPECS = exports.SHEETS_OPERATIONS = exports.isSlackOperation = exports.SLACK_OPERATION_SPECS = exports.SLACK_OPERATIONS = exports.isDiscordOperation = exports.DISCORD_OPERATION_SPECS = exports.DISCORD_OPERATIONS = exports.isWhatsAppOperation = exports.WHATSAPP_OPERATIONS = exports.TELEGRAM_TOOLKIT_BY_TOOL_NAME = exports.TELEGRAM_TOOLKIT_SPECS = exports.isTelegramOperation = exports.TELEGRAM_OPERATION_SPECS = exports.TELEGRAM_OPERATIONS = exports.DRIVE_TOOLKIT_BY_TOOL_NAME = exports.DRIVE_TOOLKIT_SPECS = exports.isDriveOperation = void 0;
+exports.isCredentialType = exports.getCredentialType = exports.credentialTypeValues = void 0;
 var types_1 = require("./types");
 Object.defineProperty(exports, "singleMeta", { enumerable: true, get: function () { return types_1.singleMeta; } });
 Object.defineProperty(exports, "iterableMeta", { enumerable: true, get: function () { return types_1.iterableMeta; } });
@@ -32,6 +33,16 @@ Object.defineProperty(exports, "NODE_COLORS", { enumerable: true, get: function
 Object.defineProperty(exports, "NODE_STATE_KEYS", { enumerable: true, get: function () { return registry_1.NODE_STATE_KEYS; } });
 Object.defineProperty(exports, "PREFIX_TO_NODE_TYPE", { enumerable: true, get: function () { return registry_1.PREFIX_TO_NODE_TYPE; } });
 Object.defineProperty(exports, "NODE_TYPE_TO_PREFIX", { enumerable: true, get: function () { return registry_1.NODE_TYPE_TO_PREFIX; } });
+// ── Node version catalog (ALL repos) ──
+// See docs/ADR-0002-node-versioning.md in the api repo.
+var registry_2 = require("./registry");
+Object.defineProperty(exports, "isVersioned", { enumerable: true, get: function () { return registry_2.isVersioned; } });
+Object.defineProperty(exports, "versionsOf", { enumerable: true, get: function () { return registry_2.versionsOf; } });
+Object.defineProperty(exports, "versionSpec", { enumerable: true, get: function () { return registry_2.versionSpec; } });
+Object.defineProperty(exports, "currentVersion", { enumerable: true, get: function () { return registry_2.currentVersion; } });
+Object.defineProperty(exports, "fieldsLostBetween", { enumerable: true, get: function () { return registry_2.fieldsLostBetween; } });
+Object.defineProperty(exports, "fieldsLost", { enumerable: true, get: function () { return registry_2.fieldsLost; } });
+Object.defineProperty(exports, "versionCatalogErrors", { enumerable: true, get: function () { return registry_2.versionCatalogErrors; } });
 // ── Per-service operation enums (ALL repos) ──
 var gmail_operations_1 = require("./gmail-operations");
 Object.defineProperty(exports, "GMAIL_OPERATIONS", { enumerable: true, get: function () { return gmail_operations_1.GMAIL_OPERATIONS; } });

package/dist/registry.d.ts

@@ -41,6 +41,51 @@ export interface NodeRegistryEntry {
      * Predicate must be pure (no side effects) — called on every render.
      */
     isToolOnly?: (entity: Record<string, unknown>) => boolean;
+    /**
+     * The versions this node type ships, when it ships more than one.
+     *
+     * Absent means the type does not version, which is true of every type
+     * today. A node type only declares this the day its provider deprecates
+     * something and a second version has to live alongside the first.
+     *
+     * See `docs/ADR-0002-node-versioning.md` in the api repo.
+     */
+    versions?: NodeVersionSpec[];
+}
+/**
+ * One version of a node type.
+ *
+ * Deliberately NOT a schema. The api's DTO stays the validator; all this
+ * needs to know is WHICH config fields a version understands, because that
+ * is what answers the only question the UI has to ask: switching from here
+ * to there, what does the user lose?
+ */
+export interface NodeVersionSpec {
+    /** The number the user sees. Unique within a type. */
+    v: number;
+    /** Shown next to the number in the picker, e.g. "Discord API v10". */
+    label?: string;
+    /**
+     * `current` is what a new node is born on — exactly one per type.
+     * `legacy` still runs but is on its way out. `beta` is opt-in.
+     */
+    status: 'current' | 'legacy' | 'beta';
+    /**
+     * The config fields this version understands.
+     *
+     * Only fields the user configures. Identity and topology — name,
+     * inputNodes, outputNodes, isActive, canvas position — never belong
+     * here: they survive a version change untouched, and listing them
+     * would put them at risk of being unset.
+     */
+    fields: string[];
+    /**
+     * Entering this version keeps nothing. For the case where "v2" is
+     * really a different integration wearing the same node's name.
+     */
+    cleanBreak?: boolean;
+    /** Why it was retired, or what it brings. Shown in picker and dialog. */
+    note?: string;
 }
 export declare const NODE_REGISTRY: Record<NodeType, NodeRegistryEntry>;
 /** Get registry entry by canonical type */
@@ -55,3 +100,61 @@ export declare const NODE_STATE_KEYS: Record<string, [string, string]>;
 export declare const PREFIX_TO_NODE_TYPE: Record<string, NodeType>;
 /** type → prefix */
 export declare const NODE_TYPE_TO_PREFIX: Record<string, string>;
+/**
+ * The catalog these helpers read. Every one of them takes it as an
+ * optional last argument defaulting to the real registry: consumers never
+ * pass it, and the tests can exercise a versioned type without waiting
+ * for a real one to exist.
+ */
+export type VersionCatalog = Record<string, Pick<NodeRegistryEntry, 'type' | 'versions'>>;
+/** True when this type ships more than one version. False for every type today. */
+export declare function isVersioned(type: string, catalog?: VersionCatalog): boolean;
+/**
+ * Every declared version, newest first — the order a picker wants.
+ * Empty for a type that does not version.
+ */
+export declare function versionsOf(type: string, catalog?: VersionCatalog): NodeVersionSpec[];
+/** One version's spec, or undefined when the type or the number is unknown. */
+export declare function versionSpec(type: string, v: number, catalog?: VersionCatalog): NodeVersionSpec | undefined;
+/**
+ * The version a new node of this type is born on.
+ *
+ * Returns 1 for a type that does not version, which is also how an entity
+ * with no `nodeVersion` is read. A node created before its type ever
+ * versioned was calling the original endpoints, so calling it version 1
+ * is not a convention — it is the truth.
+ */
+export declare function currentVersion(type: string, catalog?: VersionCatalog): number;
+/**
+ * Config fields present in `from` that `to` does not declare — the exact
+ * list a confirmation dialog should name, and the exact list the server
+ * should unset.
+ *
+ * Returns `null` when the question cannot be answered: the type does not
+ * version, or one of the two versions is not declared. `null` is not the
+ * same as "nothing is lost", and callers must not treat it that way — a
+ * dialog should refuse to offer the switch, and the api should reject the
+ * request. Returning `null` rather than `[]` is what stops "I don't know"
+ * from being read as "nothing".
+ *
+ * This lives here rather than in each consumer because the dialog that
+ * ANNOUNCES the loss and the server that PERFORMS it have to give the
+ * same answer. Two implementations would agree right until the day they
+ * did not, and that day the dialog lies.
+ */
+export declare function fieldsLostBetween(type: string, from: number, to: number, catalog?: VersionCatalog): string[] | null;
+/**
+ * The same answer for two specs already in hand — what `fieldsLostBetween`
+ * delegates to once it has resolved both, and what a caller that already
+ * holds them from `versionsOf()` can use without a second lookup.
+ */
+export declare function fieldsLost(from: NodeVersionSpec, to: NodeVersionSpec): string[];
+/**
+ * Declaration mistakes in the version catalogs, as readable lines.
+ *
+ * A guard rather than a line in a document: what this codebase learned
+ * from fifteen nodes skipping a checklist point everyone had read is that
+ * the written rule prevented nothing and the guard did. Empty means every
+ * catalog is well-formed.
+ */
+export declare function versionCatalogErrors(catalog?: VersionCatalog): string[];

package/dist/registry.js

@@ -9,6 +9,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NODE_TYPE_TO_PREFIX = exports.PREFIX_TO_NODE_TYPE = exports.NODE_STATE_KEYS = exports.NODE_COLORS = exports.NODE_DETAIL_PATHS = exports.NODE_REGISTRY = void 0;
 exports.getNodeRegistryEntry = getNodeRegistryEntry;
+exports.isVersioned = isVersioned;
+exports.versionsOf = versionsOf;
+exports.versionSpec = versionSpec;
+exports.currentVersion = currentVersion;
+exports.fieldsLostBetween = fieldsLostBetween;
+exports.fieldsLost = fieldsLost;
+exports.versionCatalogErrors = versionCatalogErrors;
 exports.NODE_REGISTRY = {
     // ── Sources ──
     webhook: {
@@ -370,3 +377,108 @@ exports.NODE_STATE_KEYS = Object.fromEntries(Object.values(exports.NODE_REGISTRY
 exports.PREFIX_TO_NODE_TYPE = Object.fromEntries(Object.values(exports.NODE_REGISTRY).map(n => [n.prefix, n.type]));
 /** type → prefix */
 exports.NODE_TYPE_TO_PREFIX = Object.fromEntries(Object.values(exports.NODE_REGISTRY).map(n => [n.type, n.prefix]));
+function specsFor(type, catalog) {
+    return catalog[type]?.versions;
+}
+/** True when this type ships more than one version. False for every type today. */
+function isVersioned(type, catalog = exports.NODE_REGISTRY) {
+    return (specsFor(type, catalog)?.length ?? 0) > 0;
+}
+/**
+ * Every declared version, newest first — the order a picker wants.
+ * Empty for a type that does not version.
+ */
+function versionsOf(type, catalog = exports.NODE_REGISTRY) {
+    const declared = specsFor(type, catalog);
+    if (!declared)
+        return [];
+    return [...declared].sort((a, b) => b.v - a.v);
+}
+/** One version's spec, or undefined when the type or the number is unknown. */
+function versionSpec(type, v, catalog = exports.NODE_REGISTRY) {
+    return specsFor(type, catalog)?.find(s => s.v === v);
+}
+/**
+ * The version a new node of this type is born on.
+ *
+ * Returns 1 for a type that does not version, which is also how an entity
+ * with no `nodeVersion` is read. A node created before its type ever
+ * versioned was calling the original endpoints, so calling it version 1
+ * is not a convention — it is the truth.
+ */
+function currentVersion(type, catalog = exports.NODE_REGISTRY) {
+    const current = specsFor(type, catalog)?.find(s => s.status === 'current');
+    return current?.v ?? 1;
+}
+/**
+ * Config fields present in `from` that `to` does not declare — the exact
+ * list a confirmation dialog should name, and the exact list the server
+ * should unset.
+ *
+ * Returns `null` when the question cannot be answered: the type does not
+ * version, or one of the two versions is not declared. `null` is not the
+ * same as "nothing is lost", and callers must not treat it that way — a
+ * dialog should refuse to offer the switch, and the api should reject the
+ * request. Returning `null` rather than `[]` is what stops "I don't know"
+ * from being read as "nothing".
+ *
+ * This lives here rather than in each consumer because the dialog that
+ * ANNOUNCES the loss and the server that PERFORMS it have to give the
+ * same answer. Two implementations would agree right until the day they
+ * did not, and that day the dialog lies.
+ */
+function fieldsLostBetween(type, from, to, catalog = exports.NODE_REGISTRY) {
+    const a = versionSpec(type, from, catalog);
+    const b = versionSpec(type, to, catalog);
+    if (!a || !b)
+        return null;
+    return fieldsLost(a, b);
+}
+/**
+ * The same answer for two specs already in hand — what `fieldsLostBetween`
+ * delegates to once it has resolved both, and what a caller that already
+ * holds them from `versionsOf()` can use without a second lookup.
+ */
+function fieldsLost(from, to) {
+    if (from.v === to.v)
+        return [];
+    if (to.cleanBreak)
+        return [...from.fields];
+    const kept = new Set(to.fields);
+    return from.fields.filter(f => !kept.has(f));
+}
+/**
+ * Declaration mistakes in the version catalogs, as readable lines.
+ *
+ * A guard rather than a line in a document: what this codebase learned
+ * from fifteen nodes skipping a checklist point everyone had read is that
+ * the written rule prevented nothing and the guard did. Empty means every
+ * catalog is well-formed.
+ */
+function versionCatalogErrors(catalog = exports.NODE_REGISTRY) {
+    const errors = [];
+    for (const entry of Object.values(catalog)) {
+        const versions = entry.versions;
+        if (!versions)
+            continue;
+        if (versions.length === 0) {
+            errors.push(`${entry.type}: declares an empty versions array — omit the field instead`);
+            continue;
+        }
+        const numbers = versions.map(s => s.v);
+        const repeatedNumbers = [...new Set(numbers.filter((n, i) => numbers.indexOf(n) !== i))];
+        if (repeatedNumbers.length)
+            errors.push(`${entry.type}: repeated version number ${repeatedNumbers.join(', ')}`);
+        for (const spec of versions) {
+            if (!Number.isInteger(spec.v) || spec.v < 1)
+                errors.push(`${entry.type}: version "${spec.v}" is not a positive integer`);
+            const repeatedFields = [...new Set(spec.fields.filter((f, i) => spec.fields.indexOf(f) !== i))];
+            if (repeatedFields.length)
+                errors.push(`${entry.type} v${spec.v}: repeated field ${repeatedFields.join(', ')}`);
+        }
+        const current = versions.filter(s => s.status === 'current');
+        if (current.length !== 1)
+            errors.push(`${entry.type}: needs exactly one version with status "current", found ${current.length}`);
+    }
+    return errors;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hostwebhook/node-types",
-  "version": "1.55.3",
+  "version": "1.56.0",
   "description": "Shared node type definitions, connection rules, and dispatch config for HostWebhook",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -9,6 +9,7 @@
   ],
   "scripts": {
     "build": "tsc",
+    "test": "vitest run",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
@@ -18,6 +19,7 @@
   ],
   "license": "MIT",
   "devDependencies": {
-    "typescript": "^5.0.0"
+    "typescript": "^5.0.0",
+    "vitest": "^3.0.0"
   }
 }