commitments-of-traders 1.0.0

package/LICENSE

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

package/README.md

@@ -0,0 +1,65 @@
+# commitments-of-traders
+
+Typed, zero-dependency client for the **CFTC Commitments of Traders (COT)** reports — Legacy, Disaggregated, and Traders in Financial Futures, futures-only or combined — via the official [Socrata API](https://publicreporting.cftc.gov/). **No API key required.**
+
+```
+npm install commitments-of-traders
+```
+
+## Why
+
+The weekly COT report is one of the most-watched positioning datasets in futures and FX — how commercials, large speculators, and managed money are positioned across every US futures market. The CFTC publishes it through a free Socrata API, but building the SoQL queries (market filters, date ranges, the six different report datasets) by hand is tedious, and npm had no client library — only an MCP server. This is the library.
+
+```ts
+import { getCotReport, latestForMarket, num } from "commitments-of-traders";
+
+// Latest E-mini S&P 500 large-speculator positioning:
+const es = await latestForMarket("legacy", "E-MINI S&P 500");
+const net = num(es.noncomm_positions_long_all) - num(es.noncomm_positions_short_all);
+
+// Managed-money gold positioning (disaggregated, futures + options):
+const gold = await getCotReport("disaggregated", "combined", { market: "GOLD", limit: 1 });
+num(gold[0].m_money_positions_long_all);
+
+// A full year of one market, with a raw SoQL filter ANDed in:
+const history = await getCotReport("tff", "futures-only", {
+  market: "10-YEAR U.S. TREASURY",
+  since: "2025-01-01",
+  where: "open_interest_all > 1000000",
+});
+```
+
+## Reports
+
+All three families, in both futures-only and combined (futures + options) forms — six datasets, all wired up:
+
+| `report` | `include: "futures-only"` | `include: "combined"` |
+| --- | --- | --- |
+| `"legacy"` | Legacy — Futures Only | Legacy — Combined |
+| `"disaggregated"` | Disaggregated — Futures Only | Disaggregated — Combined |
+| `"tff"` | TFF — Futures Only | TFF — Combined |
+
+(The exact Socrata resource IDs are exported as `DATASETS` and were verified against publicreporting.cftc.gov.)
+
+## API
+
+Every function takes an optional final `options`: `{ fetch?, baseUrl?, appToken? }` — inject `fetch` for tests, or a Socrata app token to raise rate limits (not required).
+
+- **`getCotReport(report, include?, params?)`** — query a report family (`include` defaults to `"futures-only"`).
+- **`latestForMarket(report, market, include?)`** — the single most recent row for a market, or `null`.
+- **`queryDataset(datasetId, params?)`** — query by raw Socrata id.
+- **`num(value)`** — Socrata returns every column as a string; `num` converts to `number | null`.
+
+**`params`**: `market` (case-insensitive contains-match), `contractMarketCode`, `since` / `until` (YYYY-MM-DD), `where` (raw SoQL, ANDed in), `select`, `order`, `limit`, `offset`. Market names and codes are safely escaped. Failures throw `CotError` with `status` and `url`.
+
+Rows are typed for the always-present identity columns (market, report date, codes, open interest) with an index signature for the hundreds of position columns that vary by report family. The mocked test suite runs offline; `npm run smoke` exercises the live API.
+
+## Related
+
+By the same author, a fixed-income & markets toolkit: [`treasurydirect`](https://github.com/moshejs/treasurydirect) · [`treasury-fiscaldata`](https://github.com/moshejs/treasury-fiscaldata) · [`newyorkfed`](https://github.com/moshejs/newyorkfed) · [`tbill`](https://github.com/moshejs/tbill) · [`compounded-sofr`](https://github.com/moshejs/compounded-sofr) · [`instrument-identifiers`](https://github.com/moshejs/instrument-identifiers) · [`32nds`](https://github.com/moshejs/32nds).
+
+## Author
+
+Built by **[Moshe Malka](https://moshemalka.com)** — engineering leader in New York City. Studio work at [Quentin.Code](https://www.quentin.software/).
+
+MIT © Moshe Malka

package/dist/index.cjs

@@ -0,0 +1,134 @@
+"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, {
+  CotError: () => CotError,
+  DATASETS: () => DATASETS,
+  getCotReport: () => getCotReport,
+  latestForMarket: () => latestForMarket,
+  num: () => num,
+  queryDataset: () => queryDataset
+});
+module.exports = __toCommonJS(index_exports);
+var DATASETS = {
+  legacy: { "futures-only": "6dca-aqww", combined: "jun7-fc8e" },
+  disaggregated: { "futures-only": "72hh-3qpy", combined: "kh3c-gbw2" },
+  tff: { "futures-only": "gpe5-46if", combined: "yw9f-hn96" }
+};
+var CotError = class extends Error {
+  constructor(status, url) {
+    super(`CFTC COT request failed with HTTP ${status}: ${url}`);
+    this.name = "CotError";
+    this.status = status;
+    this.url = url;
+  }
+};
+var DEFAULT_BASE = "https://publicreporting.cftc.gov";
+var ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+function soqlString(value) {
+  return `'${value.replace(/'/g, "''")}'`;
+}
+function checkDate(d, label) {
+  if (!ISO_DATE_RE.test(d)) throw new RangeError(`Invalid ${label}: "${d}" (expected YYYY-MM-DD)`);
+}
+function buildWhere(params) {
+  const clauses = [];
+  if (params.market !== void 0) {
+    clauses.push(`upper(market_and_exchange_names) like upper(${soqlString(`%${params.market}%`)})`);
+  }
+  if (params.contractMarketCode !== void 0) {
+    clauses.push(`cftc_contract_market_code = ${soqlString(params.contractMarketCode)}`);
+  }
+  if (params.since !== void 0) {
+    checkDate(params.since, "since");
+    clauses.push(`report_date_as_yyyy_mm_dd >= '${params.since}T00:00:00.000'`);
+  }
+  if (params.until !== void 0) {
+    checkDate(params.until, "until");
+    clauses.push(`report_date_as_yyyy_mm_dd <= '${params.until}T23:59:59.999'`);
+  }
+  if (params.where !== void 0) clauses.push(`(${params.where})`);
+  return clauses.length ? clauses.join(" AND ") : void 0;
+}
+function resolveDataset(report, include) {
+  const byInclude = DATASETS[report];
+  if (!byInclude) throw new RangeError(`Unknown report "${report}"`);
+  const id = byInclude[include];
+  if (!id) throw new RangeError(`Unknown include "${include}"`);
+  return id;
+}
+async function request(datasetId, params, opts) {
+  const doFetch = opts.fetch ?? globalThis.fetch;
+  const base = opts.baseUrl ?? DEFAULT_BASE;
+  const sp = new URLSearchParams();
+  if (params.select && params.select.length) sp.set("$select", params.select.join(","));
+  const where = buildWhere(params);
+  if (where) sp.set("$where", where);
+  sp.set("$order", params.order ?? "report_date_as_yyyy_mm_dd DESC");
+  if (params.limit !== void 0) {
+    if (!Number.isInteger(params.limit) || params.limit <= 0 || params.limit > 5e4) {
+      throw new RangeError(`limit must be an integer in 1\u201350000, got ${params.limit}`);
+    }
+    sp.set("$limit", String(params.limit));
+  } else {
+    sp.set("$limit", "1000");
+  }
+  if (params.offset !== void 0) {
+    if (!Number.isInteger(params.offset) || params.offset < 0) {
+      throw new RangeError(`offset must be a non-negative integer, got ${params.offset}`);
+    }
+    sp.set("$offset", String(params.offset));
+  }
+  const url = `${base}/resource/${datasetId}.json?${sp.toString()}`;
+  const headers = { accept: "application/json" };
+  if (opts.appToken) headers["X-App-Token"] = opts.appToken;
+  const res = await doFetch(url, { headers });
+  if (!res.ok) throw new CotError(res.status, url);
+  return await res.json();
+}
+async function getCotReport(report, include = "futures-only", params = {}, opts = {}) {
+  return request(resolveDataset(report, include), params, opts);
+}
+async function latestForMarket(report, market, include = "futures-only", opts = {}) {
+  const rows = await request(
+    resolveDataset(report, include),
+    { market, limit: 1, order: "report_date_as_yyyy_mm_dd DESC" },
+    opts
+  );
+  return rows[0] ?? null;
+}
+function queryDataset(datasetId, params = {}, opts = {}) {
+  return request(datasetId, params, opts);
+}
+function num(value) {
+  if (value === void 0 || value.trim() === "") return null;
+  const n = Number(value);
+  return Number.isFinite(n) ? n : null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CotError,
+  DATASETS,
+  getCotReport,
+  latestForMarket,
+  num,
+  queryDataset
+});

package/dist/index.d.cts

@@ -0,0 +1,91 @@
+/**
+ * commitments-of-traders — typed, zero-dependency client for the CFTC's
+ * Commitments of Traders (COT) reports via the official Socrata API at
+ * publicreporting.cftc.gov.
+ *
+ * Covers all three report families (Legacy, Disaggregated, Traders in
+ * Financial Futures) in both futures-only and combined (futures + options)
+ * forms, with SoQL filtering, sorting, and pagination. No API key required.
+ */
+/** COT report family. */
+type CotReport = "legacy" | "disaggregated" | "tff";
+/** Whether to include options: futures only, or futures + options combined. */
+type CotInclude = "futures-only" | "combined";
+/** Socrata dataset resource IDs, confirmed against publicreporting.cftc.gov. */
+declare const DATASETS: Record<CotReport, Record<CotInclude, string>>;
+interface CotOptions {
+    /** Custom fetch implementation (testing, proxies). Defaults to global fetch. */
+    fetch?: typeof globalThis.fetch;
+    /** Base URL. Defaults to "https://publicreporting.cftc.gov". */
+    baseUrl?: string;
+    /** Optional Socrata app token (raises rate limits; not required). */
+    appToken?: string;
+}
+/**
+ * A COT report row. All values are strings, as Socrata returns them; the
+ * columns differ by report family (Legacy ~120, Disaggregated ~190, TFF ~90),
+ * so only the always-present identity columns are typed — everything else is
+ * reachable through the index signature. Use {@link num} for numeric columns.
+ */
+interface CotRow {
+    market_and_exchange_names: string;
+    report_date_as_yyyy_mm_dd: string;
+    yyyy_report_week_ww: string;
+    contract_market_name: string;
+    cftc_contract_market_code: string;
+    cftc_commodity_code: string;
+    open_interest_all: string;
+    [column: string]: string | undefined;
+}
+interface QueryParams {
+    /** Filter to one market name (SoQL `like %…%`, case-insensitive contains). */
+    market?: string;
+    /** Exact CFTC contract market code. */
+    contractMarketCode?: string;
+    /** Report date lower bound (inclusive), YYYY-MM-DD. */
+    since?: string;
+    /** Report date upper bound (inclusive), YYYY-MM-DD. */
+    until?: string;
+    /** Raw SoQL `$where` clause; ANDed with the structured filters above. */
+    where?: string;
+    /** Columns to select (SoQL `$select`). Default all. */
+    select?: string[];
+    /** Sort column and direction. Default report date descending. */
+    order?: string;
+    /** Row cap (Socrata `$limit`). Default 1000. */
+    limit?: number;
+    /** Row offset (Socrata `$offset`). */
+    offset?: number;
+}
+declare class CotError extends Error {
+    readonly status: number;
+    readonly url: string;
+    constructor(status: number, url: string);
+}
+/**
+ * Query a COT report family.
+ *
+ * ```ts
+ * // The latest E-mini S&P 500 legacy report:
+ * const [row] = await getCotReport("legacy", "futures-only", {
+ *   market: "E-MINI S&P 500",
+ *   limit: 1,
+ * });
+ * num(row.noncomm_positions_long_all);
+ * ```
+ */
+declare function getCotReport(report: CotReport, include?: CotInclude, params?: QueryParams, opts?: CotOptions): Promise<CotRow[]>;
+/**
+ * The single most recent report row for a market in a report family.
+ * Returns null if the market matches nothing.
+ */
+declare function latestForMarket(report: CotReport, market: string, include?: CotInclude, opts?: CotOptions): Promise<CotRow | null>;
+/** Query directly by Socrata dataset id (escape hatch for exotic needs). */
+declare function queryDataset(datasetId: string, params?: QueryParams, opts?: CotOptions): Promise<CotRow[]>;
+/**
+ * Parse a COT column string to a number, or null when empty/non-numeric.
+ * `num("123456")` → 123456; `num("")` → null.
+ */
+declare function num(value: string | undefined): number | null;
+
+export { CotError, type CotInclude, type CotOptions, type CotReport, type CotRow, DATASETS, type QueryParams, getCotReport, latestForMarket, num, queryDataset };

package/dist/index.d.ts

@@ -0,0 +1,91 @@
+/**
+ * commitments-of-traders — typed, zero-dependency client for the CFTC's
+ * Commitments of Traders (COT) reports via the official Socrata API at
+ * publicreporting.cftc.gov.
+ *
+ * Covers all three report families (Legacy, Disaggregated, Traders in
+ * Financial Futures) in both futures-only and combined (futures + options)
+ * forms, with SoQL filtering, sorting, and pagination. No API key required.
+ */
+/** COT report family. */
+type CotReport = "legacy" | "disaggregated" | "tff";
+/** Whether to include options: futures only, or futures + options combined. */
+type CotInclude = "futures-only" | "combined";
+/** Socrata dataset resource IDs, confirmed against publicreporting.cftc.gov. */
+declare const DATASETS: Record<CotReport, Record<CotInclude, string>>;
+interface CotOptions {
+    /** Custom fetch implementation (testing, proxies). Defaults to global fetch. */
+    fetch?: typeof globalThis.fetch;
+    /** Base URL. Defaults to "https://publicreporting.cftc.gov". */
+    baseUrl?: string;
+    /** Optional Socrata app token (raises rate limits; not required). */
+    appToken?: string;
+}
+/**
+ * A COT report row. All values are strings, as Socrata returns them; the
+ * columns differ by report family (Legacy ~120, Disaggregated ~190, TFF ~90),
+ * so only the always-present identity columns are typed — everything else is
+ * reachable through the index signature. Use {@link num} for numeric columns.
+ */
+interface CotRow {
+    market_and_exchange_names: string;
+    report_date_as_yyyy_mm_dd: string;
+    yyyy_report_week_ww: string;
+    contract_market_name: string;
+    cftc_contract_market_code: string;
+    cftc_commodity_code: string;
+    open_interest_all: string;
+    [column: string]: string | undefined;
+}
+interface QueryParams {
+    /** Filter to one market name (SoQL `like %…%`, case-insensitive contains). */
+    market?: string;
+    /** Exact CFTC contract market code. */
+    contractMarketCode?: string;
+    /** Report date lower bound (inclusive), YYYY-MM-DD. */
+    since?: string;
+    /** Report date upper bound (inclusive), YYYY-MM-DD. */
+    until?: string;
+    /** Raw SoQL `$where` clause; ANDed with the structured filters above. */
+    where?: string;
+    /** Columns to select (SoQL `$select`). Default all. */
+    select?: string[];
+    /** Sort column and direction. Default report date descending. */
+    order?: string;
+    /** Row cap (Socrata `$limit`). Default 1000. */
+    limit?: number;
+    /** Row offset (Socrata `$offset`). */
+    offset?: number;
+}
+declare class CotError extends Error {
+    readonly status: number;
+    readonly url: string;
+    constructor(status: number, url: string);
+}
+/**
+ * Query a COT report family.
+ *
+ * ```ts
+ * // The latest E-mini S&P 500 legacy report:
+ * const [row] = await getCotReport("legacy", "futures-only", {
+ *   market: "E-MINI S&P 500",
+ *   limit: 1,
+ * });
+ * num(row.noncomm_positions_long_all);
+ * ```
+ */
+declare function getCotReport(report: CotReport, include?: CotInclude, params?: QueryParams, opts?: CotOptions): Promise<CotRow[]>;
+/**
+ * The single most recent report row for a market in a report family.
+ * Returns null if the market matches nothing.
+ */
+declare function latestForMarket(report: CotReport, market: string, include?: CotInclude, opts?: CotOptions): Promise<CotRow | null>;
+/** Query directly by Socrata dataset id (escape hatch for exotic needs). */
+declare function queryDataset(datasetId: string, params?: QueryParams, opts?: CotOptions): Promise<CotRow[]>;
+/**
+ * Parse a COT column string to a number, or null when empty/non-numeric.
+ * `num("123456")` → 123456; `num("")` → null.
+ */
+declare function num(value: string | undefined): number | null;
+
+export { CotError, type CotInclude, type CotOptions, type CotReport, type CotRow, DATASETS, type QueryParams, getCotReport, latestForMarket, num, queryDataset };

package/dist/index.js

@@ -0,0 +1,104 @@
+// src/index.ts
+var DATASETS = {
+  legacy: { "futures-only": "6dca-aqww", combined: "jun7-fc8e" },
+  disaggregated: { "futures-only": "72hh-3qpy", combined: "kh3c-gbw2" },
+  tff: { "futures-only": "gpe5-46if", combined: "yw9f-hn96" }
+};
+var CotError = class extends Error {
+  constructor(status, url) {
+    super(`CFTC COT request failed with HTTP ${status}: ${url}`);
+    this.name = "CotError";
+    this.status = status;
+    this.url = url;
+  }
+};
+var DEFAULT_BASE = "https://publicreporting.cftc.gov";
+var ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+function soqlString(value) {
+  return `'${value.replace(/'/g, "''")}'`;
+}
+function checkDate(d, label) {
+  if (!ISO_DATE_RE.test(d)) throw new RangeError(`Invalid ${label}: "${d}" (expected YYYY-MM-DD)`);
+}
+function buildWhere(params) {
+  const clauses = [];
+  if (params.market !== void 0) {
+    clauses.push(`upper(market_and_exchange_names) like upper(${soqlString(`%${params.market}%`)})`);
+  }
+  if (params.contractMarketCode !== void 0) {
+    clauses.push(`cftc_contract_market_code = ${soqlString(params.contractMarketCode)}`);
+  }
+  if (params.since !== void 0) {
+    checkDate(params.since, "since");
+    clauses.push(`report_date_as_yyyy_mm_dd >= '${params.since}T00:00:00.000'`);
+  }
+  if (params.until !== void 0) {
+    checkDate(params.until, "until");
+    clauses.push(`report_date_as_yyyy_mm_dd <= '${params.until}T23:59:59.999'`);
+  }
+  if (params.where !== void 0) clauses.push(`(${params.where})`);
+  return clauses.length ? clauses.join(" AND ") : void 0;
+}
+function resolveDataset(report, include) {
+  const byInclude = DATASETS[report];
+  if (!byInclude) throw new RangeError(`Unknown report "${report}"`);
+  const id = byInclude[include];
+  if (!id) throw new RangeError(`Unknown include "${include}"`);
+  return id;
+}
+async function request(datasetId, params, opts) {
+  const doFetch = opts.fetch ?? globalThis.fetch;
+  const base = opts.baseUrl ?? DEFAULT_BASE;
+  const sp = new URLSearchParams();
+  if (params.select && params.select.length) sp.set("$select", params.select.join(","));
+  const where = buildWhere(params);
+  if (where) sp.set("$where", where);
+  sp.set("$order", params.order ?? "report_date_as_yyyy_mm_dd DESC");
+  if (params.limit !== void 0) {
+    if (!Number.isInteger(params.limit) || params.limit <= 0 || params.limit > 5e4) {
+      throw new RangeError(`limit must be an integer in 1\u201350000, got ${params.limit}`);
+    }
+    sp.set("$limit", String(params.limit));
+  } else {
+    sp.set("$limit", "1000");
+  }
+  if (params.offset !== void 0) {
+    if (!Number.isInteger(params.offset) || params.offset < 0) {
+      throw new RangeError(`offset must be a non-negative integer, got ${params.offset}`);
+    }
+    sp.set("$offset", String(params.offset));
+  }
+  const url = `${base}/resource/${datasetId}.json?${sp.toString()}`;
+  const headers = { accept: "application/json" };
+  if (opts.appToken) headers["X-App-Token"] = opts.appToken;
+  const res = await doFetch(url, { headers });
+  if (!res.ok) throw new CotError(res.status, url);
+  return await res.json();
+}
+async function getCotReport(report, include = "futures-only", params = {}, opts = {}) {
+  return request(resolveDataset(report, include), params, opts);
+}
+async function latestForMarket(report, market, include = "futures-only", opts = {}) {
+  const rows = await request(
+    resolveDataset(report, include),
+    { market, limit: 1, order: "report_date_as_yyyy_mm_dd DESC" },
+    opts
+  );
+  return rows[0] ?? null;
+}
+function queryDataset(datasetId, params = {}, opts = {}) {
+  return request(datasetId, params, opts);
+}
+function num(value) {
+  if (value === void 0 || value.trim() === "") return null;
+  const n = Number(value);
+  return Number.isFinite(n) ? n : null;
+}
+export {
+  CotError,
+  DATASETS,
+  getCotReport,
+  latestForMarket,
+  num,
+  queryDataset
+};

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "commitments-of-traders",
+  "version": "1.0.0",
+  "description": "Typed, zero-dependency client for the CFTC Commitments of Traders (COT) reports — Legacy, Disaggregated, and Traders in Financial Futures, futures-only or combined, via the official Socrata API. No API key required.",
+  "keywords": [
+    "cftc",
+    "commitments-of-traders",
+    "cot",
+    "cot-report",
+    "futures",
+    "positioning",
+    "traders-in-financial-futures",
+    "disaggregated",
+    "finance",
+    "trading",
+    "api-client",
+    "socrata"
+  ],
+  "homepage": "https://moshemalka.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/moshejs/commitments-of-traders.git"
+  },
+  "bugs": "https://github.com/moshejs/commitments-of-traders/issues",
+  "author": "Moshe Malka <hello@moshemalka.com> (https://moshemalka.com)",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "smoke": "node scripts/smoke.mjs",
+    "prepublishOnly": "npm run typecheck && npm run test && npm run build"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.2.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}