@ekwo-ai/des 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ekwo AI
+
+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,131 @@
+# `@ekwo-ai/des`
+
+The French **DES** — *déclaration européenne de services* — in TypeScript, with
+no dependencies.
+
+Give it the rows of a recapitulative statement and it gives you the XML the
+DGDDI accepts, a name for it, and the list of what could not be put in it.
+
+```ts
+import { generateDes } from '@ekwo-ai/des';
+
+const { file, filename, violations } = generateDes(rows, {
+  vatNumber: 'FRKK999999999',
+  year: 2026,
+  month: 8,
+});
+```
+
+`StatementRow` is the row shape of the `ec_sales_list(company, from, to)`
+function of [Ekwo OS](https://github.com/Ekwo-ai/ekwo-os), declared here so
+that nothing is imported from it. Any book-keeping system that can produce
+those columns can use this package; it reads no database and knows no
+accounting.
+
+## It is the services half, and only the services half
+
+France splits the recapitulative statement in two. Services taxed where the
+customer is are declared here. Supplies of goods go on the **état
+récapitulatif TVA**, filed through DEBWEB2 in the INSTAT XML envelope, which is
+a different format and is not in this package — see the end of this file for
+why. A row of goods handed to `generateDes` comes back as a violation rather
+than being written into a declaration that has no field for it.
+
+## The specification this was written from
+
+| What | Where |
+|---|---|
+| DES — description des échanges DTI+ en XML (DGDDI/DNSCE) | <https://www.douane.gouv.fr/sites/default/files/uploads/files/2020-10/ManuelDesXML.pdf> |
+| Manuel utilisateur DES | <https://www.douane.gouv.fr/sites/default/files/uploads/files/2020-01/Manuel%20Utilisateur%20DES.pdf> |
+| The administration's own page | <https://www.douane.gouv.fr/fiche/la-declaration-europeenne-de-services-des> |
+| Rounding and the obligation itself | <https://bofip.impots.gouv.fr/bofip/979-PGP.html/identifiant=BOI-TVA-DECLA-20-20-40-20220216> |
+| Filing calendar | <https://www.douane.gouv.fr/fiche/calendrier-des-declarations-relatives-letat-recapitulatif-tva-et-aux-des> |
+
+Two things a reader should know about those documents:
+
+- **No XSD is published for the DES.** The only schema on the portal is the one
+  of DEBWEB2. The DES is described by a dictionary of tags and a table of
+  checks, and the checks in that table are what this package applies.
+- **The cahier des charges contradicts itself about the encoding.** Its
+  conventions section prescribes ISO-8859-1 and its own complete example
+  declares UTF-8. The file holds nothing but digits and the letters of a VAT
+  number, so the two are the same bytes; this package writes UTF-8, which is
+  the half of the document that was executed.
+
+The specification has not been reissued since 2014. That is not an oversight
+here: a targeted search of the portal found no later version.
+
+## The checks, from the table in the cahier des charges
+
+| Field | What it holds |
+|---|---|
+| `num_des` | 1 to 6 digits |
+| `num_tvaFr` | Thirteen characters: `FR`, a two-character key, nine digits of SIREN |
+| `mois_des` | `01` to `12` |
+| `an_des` | Four digits, 2010 or later |
+| `numlin_des` | Six digits, from 1 |
+| `valeur` | A whole number, never zero, between −9 999 999 999 and 99 999 999 999 |
+| `partner_des` | 4 to 14 characters, **country prefix included** |
+
+**The tags must appear in that order**, which the document says in as many
+words, and this package writes them in it.
+
+**Amounts are whole euros**, rounded away from zero at the half: below 0,50 €
+an amount is dropped, at 0,50 € or more it counts for one. **Negative values
+are allowed** on the DES, unlike on the état récapitulatif of goods, and a
+minoration is declared as one.
+
+## What it refuses and what it reports
+
+An exception, because it would make the whole file meaningless: a month outside
+1 to 12, a year before 2010, a declaration number outside 1 to 999 999, or a
+declarant number that is not the thirteen characters the specification fixes.
+
+A violation, because one line is wrong and the rest of the file is not:
+
+| `code` | Why |
+|---|---|
+| whatever the producer flagged | The row arrived with an `issue` on it |
+| `not_a_service` | Goods or a triangular operation: the état récapitulatif TVA, not this file |
+| `wrong_currency` | The DES is filed in euro and the line is not |
+| `no_vat_number` | A line is identified by the customer's number and this one has none |
+| `vat_country_is_the_declarant_country` | The customer is not in another Member State |
+| `partner_length` | Fewer than four or more than fourteen characters, prefix included |
+| `nil_value` | The value rounds to zero, which the format refuses |
+
+## The file name
+
+**The administration imposes none.** The manual describes a file picker and
+nothing else: no convention, no extension beyond `.xml`, no size limit.
+`desFileName` is a name of ours, and a caller is free to pick another.
+
+## Why the état récapitulatif TVA on goods is not here
+
+It is a real format with a published schema, and it was left out on purpose
+rather than forgotten. Two things in it do not come from a set of books:
+
+- **`envelopeId` is a habilitation number** issued by the collection centre to
+  a declarant who asked for one. A file writer cannot invent it, and a package
+  that took it as a parameter would be pretending the hard part is the XML.
+- **An `Item` carries statistical fields** — the CN8 commodity code, the net
+  mass, the mode of transport, the region — which an accounting core does not
+  hold. The fiscal-only declaration, `declarationTypeCode` 4, needs fewer of
+  them than the statistical one, but the published schema is shared with the
+  statistical flow and is more permissive than the regulation, so what is truly
+  required could not be settled from the documents alone.
+
+Whoever picks it up will want the DEBWEB2 cahier des charges,
+<https://www.douane.gouv.fr/sites/default/files/2022-02/15/DEB%20_Manuel_mode_DTI%2B_Xml_v1.3.8.pdf>,
+and its schema,
+<https://www.douane.gouv.fr/sites/default/files/2022-02/24/Sch%C3%A9maXSD.xsd>.
+The six régime codes of the fiscal declaration — 10, 20, 21, 25, 26 and 31 —
+are on <https://www.douane.gouv.fr/fiche/letat-recapitulatif-tva>.
+
+## What else is out of scope
+
+Filing. This package writes bytes; enregistrement on the portal is what makes a
+DES a declaration, and it is the portal's business. Note that the deposit is a
+**window** and not a deadline: a declaration may not be enregistrée before the
+first day of the month following the period, nor after the tenth working day.
+
+MIT.

package/dist/index.d.ts

@@ -0,0 +1,106 @@
+/**
+ * The French DES — *déclaration européenne de services*.
+ *
+ * One XML document, `fichier_des`, described by the cahier des charges the
+ * DGDDI publishes as *DES — description des échanges DTI+ en XML*. Give it the
+ * rows of a recapitulative statement and it writes the file, a name for it,
+ * and the list of what could not be put in it.
+ *
+ * **It is the services half and only the services half.** France splits the
+ * recapitulative statement in two: services are declared here, supplies of
+ * goods on the *état récapitulatif TVA* of DEBWEB2, which is a different file
+ * in a different format. A row of goods handed to this package comes back as a
+ * violation rather than being written into a declaration that has no place for
+ * it.
+ *
+ * Sources are in the README. This package depends on nothing, reads no
+ * database and knows no accounting.
+ */
+/**
+ * One line of a recapitulative statement, as `ec_sales_list(company, from,
+ * to)` of [Ekwo OS](https://github.com/Ekwo-ai/ekwo-os) returns it. Declared
+ * here so that nothing is imported from it.
+ */
+export interface StatementRow {
+    /** Country of the customer's VAT identification number, ISO 3166-1 alpha-2. */
+    vat_country: string | null;
+    /** The number itself, without its country prefix. */
+    vat_number: string | null;
+    /** `goods`, `services`, `triangular`. Only services reach this file. */
+    nature: string;
+    /** Taxable amount, credit notes already deducted. */
+    amount: string | number;
+    /** ISO 4217 code the amount is in. */
+    currency_code: string;
+    /** Why this line cannot be declared as it stands, or null when it can. */
+    issue?: string | null;
+    /** Names of the customers behind the line, for a message a human reads. */
+    contact_names?: string[] | null;
+}
+export interface DesOptions {
+    /**
+     * The declarant's own VAT number, thirteen characters: `FR`, a two-character
+     * key and the nine digits of the SIREN. The cahier des charges fixes the
+     * length and refuses anything else.
+     */
+    vatNumber: string;
+    /** The month the tax became chargeable in the customer's Member State. */
+    year: number;
+    month: number;
+    /** Number of the declaration inside the file, at most six digits. Default 1. */
+    declarationNumber?: number;
+}
+/** Something that does not add up, said in the terms of this format. */
+export interface Violation {
+    code: string;
+    message: string;
+    vatNumber?: string;
+}
+export interface Des {
+    /** The XML, as text. */
+    file: string;
+    /** A name for it. See the README: the administration imposes none. */
+    filename: string;
+    /** Everything that could not be put in the file, and why. */
+    violations: Violation[];
+}
+/** The nature this declaration carries. The others are another file's. */
+export declare const NATURE = "services";
+/** The DES has no currency field: the cahier des charges declares euro. */
+export declare const CURRENCY = "EUR";
+export declare class DesError extends Error {
+    name: string;
+}
+/**
+ * Euros, whole, rounded away from zero at the half.
+ *
+ * The BOFiP says it in words (BOI-TVA-DECLA-20-20-40 § 170): an amount below
+ * 0,50 € is dropped and one of 0,50 € or more counts for one. `Math.round`
+ * would send −0,5 to −0, which is the wrong direction for a minoration, so the
+ * sign is taken out and put back.
+ */
+export declare function roundToEuro(value: string | number): number;
+/**
+ * A name for the file.
+ *
+ * **The administration imposes none.** The manual describes a file picker and
+ * nothing else; no convention, no extension beyond `.xml`, no size limit. So
+ * this is a name of ours, and a caller is free to pick another.
+ */
+export declare function desFileName(vatNumber: string, year: number, month: number): string;
+/**
+ * Writes the declaration.
+ *
+ * Refuses, by exception, what would make the whole file meaningless: a month
+ * outside 1 to 12, a year before the first the format accepts, or a declarant
+ * number that is not the thirteen characters the cahier des charges fixes.
+ * Everything wrong with one line comes back in `violations`.
+ *
+ * The encoding is UTF-8. The cahier des charges contradicts itself — its
+ * conventions section prescribes ISO-8859-1 and its own complete example
+ * declares UTF-8 — and the file it describes holds nothing but digits and the
+ * letters of a VAT number, so the two are the same bytes. The example is the
+ * half of the document that was executed.
+ */
+export declare function generateDes(rows: StatementRow[], options: DesOptions): Des;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,+EAA+E;IAC/E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,qDAAqD;IACrD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,UAAU;IACzB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wEAAwE;AACxE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,GAAG;IAClB,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAED,0EAA0E;AAC1E,eAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,2EAA2E;AAC3E,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAK9B,qBAAa,QAAS,SAAQ,KAAK;IACxB,IAAI,SAAc;CAC5B;AAUD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAI1D;AAwFD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAElF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,UAAU,GAAG,GAAG,CA6C1E"}

package/dist/index.js

@@ -0,0 +1,183 @@
+/**
+ * The French DES — *déclaration européenne de services*.
+ *
+ * One XML document, `fichier_des`, described by the cahier des charges the
+ * DGDDI publishes as *DES — description des échanges DTI+ en XML*. Give it the
+ * rows of a recapitulative statement and it writes the file, a name for it,
+ * and the list of what could not be put in it.
+ *
+ * **It is the services half and only the services half.** France splits the
+ * recapitulative statement in two: services are declared here, supplies of
+ * goods on the *état récapitulatif TVA* of DEBWEB2, which is a different file
+ * in a different format. A row of goods handed to this package comes back as a
+ * violation rather than being written into a declaration that has no place for
+ * it.
+ *
+ * Sources are in the README. This package depends on nothing, reads no
+ * database and knows no accounting.
+ */
+/** The nature this declaration carries. The others are another file's. */
+export const NATURE = 'services';
+/** The DES has no currency field: the cahier des charges declares euro. */
+export const CURRENCY = 'EUR';
+/** `FR`, a two-character key, nine digits of SIREN. Thirteen characters. */
+const DECLARANT_NUMBER = /^FR[0-9A-Z]{2}[0-9]{9}$/;
+export class DesError extends Error {
+    name = 'DesError';
+}
+function escapeXml(value) {
+    return value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+function normalise(value) {
+    return value.replace(/[^A-Za-z0-9]/g, '').toUpperCase();
+}
+/**
+ * Euros, whole, rounded away from zero at the half.
+ *
+ * The BOFiP says it in words (BOI-TVA-DECLA-20-20-40 § 170): an amount below
+ * 0,50 € is dropped and one of 0,50 € or more counts for one. `Math.round`
+ * would send −0,5 to −0, which is the wrong direction for a minoration, so the
+ * sign is taken out and put back.
+ */
+export function roundToEuro(value) {
+    const n = typeof value === 'number' ? value : Number(value);
+    if (!Number.isFinite(n))
+        throw new DesError(`invalid amount: ${String(value)}`);
+    return Math.sign(n) * Math.round(Math.abs(n));
+}
+function linesOf(rows, options) {
+    const lines = [];
+    const violations = [];
+    const home = normalise(options.vatNumber).slice(0, 2);
+    for (const row of rows) {
+        const country = row.vat_country === null ? '' : normalise(row.vat_country);
+        const number = row.vat_number === null ? '' : normalise(row.vat_number);
+        const partner = `${country}${number}`;
+        const named = row.contact_names?.join(', ');
+        const about = named === undefined || named === '' ? partner : named;
+        if (row.issue !== null && row.issue !== undefined && row.issue !== '') {
+            violations.push({
+                code: row.issue,
+                message: `${about}: this supply cannot be declared — ${row.issue.replace(/_/g, ' ')}.`,
+                ...(partner === '' ? {} : { vatNumber: partner }),
+            });
+            continue;
+        }
+        if (row.nature !== NATURE) {
+            violations.push({
+                code: 'not_a_service',
+                message: `${about}: the DES declares services. A supply of ${row.nature} belongs to the état récapitulatif TVA, which is another file.`,
+                ...(partner === '' ? {} : { vatNumber: partner }),
+            });
+            continue;
+        }
+        if (row.currency_code.toUpperCase() !== CURRENCY) {
+            violations.push({
+                code: 'wrong_currency',
+                message: `${about}: the DES is filed in ${CURRENCY} and this line is in ${row.currency_code}. Convert it before declaring it.`,
+            });
+            continue;
+        }
+        if (country === '' || number === '') {
+            violations.push({
+                code: 'no_vat_number',
+                message: `${about}: a line of the DES is identified by the customer's VAT number and this one has none.`,
+            });
+            continue;
+        }
+        if (country === home) {
+            violations.push({
+                code: 'vat_country_is_the_declarant_country',
+                message: `${about}: the DES carries services supplied to another Member State, and ${country} is the declarant's own.`,
+                vatNumber: partner,
+            });
+            continue;
+        }
+        if (partner.length < 4 || partner.length > 14) {
+            violations.push({
+                code: 'partner_length',
+                message: `${about}: the cahier des charges holds between four and fourteen characters for a customer's number, prefix included, and this one has ${partner.length}.`,
+                vatNumber: partner,
+            });
+            continue;
+        }
+        const value = roundToEuro(row.amount);
+        if (value === 0) {
+            violations.push({
+                code: 'nil_value',
+                message: `${about}: the value of a line may not be zero, and this one rounds to nothing.`,
+                vatNumber: partner,
+            });
+            continue;
+        }
+        lines.push({ partner, value });
+    }
+    lines.sort((a, b) => a.partner.localeCompare(b.partner) || a.value - b.value);
+    return { lines, violations };
+}
+/**
+ * A name for the file.
+ *
+ * **The administration imposes none.** The manual describes a file picker and
+ * nothing else; no convention, no extension beyond `.xml`, no size limit. So
+ * this is a name of ours, and a caller is free to pick another.
+ */
+export function desFileName(vatNumber, year, month) {
+    return `DES-${normalise(vatNumber)}-${year}${String(month).padStart(2, '0')}.xml`;
+}
+/**
+ * Writes the declaration.
+ *
+ * Refuses, by exception, what would make the whole file meaningless: a month
+ * outside 1 to 12, a year before the first the format accepts, or a declarant
+ * number that is not the thirteen characters the cahier des charges fixes.
+ * Everything wrong with one line comes back in `violations`.
+ *
+ * The encoding is UTF-8. The cahier des charges contradicts itself — its
+ * conventions section prescribes ISO-8859-1 and its own complete example
+ * declares UTF-8 — and the file it describes holds nothing but digits and the
+ * letters of a VAT number, so the two are the same bytes. The example is the
+ * half of the document that was executed.
+ */
+export function generateDes(rows, options) {
+    if (!Number.isInteger(options.month) || options.month < 1 || options.month > 12) {
+        throw new DesError(`month out of range: ${options.month}`);
+    }
+    // The format's own floor. It was introduced for the declarations of 2010 and
+    // refuses a year before that rather than silently accepting one.
+    if (!Number.isInteger(options.year) || options.year < 2010) {
+        throw new DesError(`year out of range: ${options.year}`);
+    }
+    const declarant = normalise(options.vatNumber);
+    if (!DECLARANT_NUMBER.test(declarant)) {
+        throw new DesError(`the declarant's number is thirteen characters, FR then a key then nine digits: ${options.vatNumber}`);
+    }
+    const declaration = options.declarationNumber ?? 1;
+    if (!Number.isInteger(declaration) || declaration < 1 || declaration > 999999) {
+        throw new DesError(`declaration number out of range: ${options.declarationNumber}`);
+    }
+    const { lines, violations } = linesOf(rows, options);
+    const parts = [];
+    parts.push('<?xml version="1.0" encoding="UTF-8"?>');
+    parts.push('<fichier_des>');
+    parts.push('<declaration_des>');
+    parts.push(`<num_des>${String(declaration).padStart(5, '0')}</num_des>`);
+    parts.push(`<num_tvaFr>${escapeXml(declarant)}</num_tvaFr>`);
+    parts.push(`<mois_des>${String(options.month).padStart(2, '0')}</mois_des>`);
+    parts.push(`<an_des>${options.year}</an_des>`);
+    for (const [index, line] of lines.entries()) {
+        parts.push('<ligne_des>');
+        parts.push(`<numlin_des>${String(index + 1).padStart(6, '0')}</numlin_des>`);
+        parts.push(`<valeur>${line.value}</valeur>`);
+        parts.push(`<partner_des>${escapeXml(line.partner)}</partner_des>`);
+        parts.push('</ligne_des>');
+    }
+    parts.push('</declaration_des>');
+    parts.push('</fichier_des>');
+    return {
+        file: `${parts.join('\n')}\n`,
+        filename: desFileName(declarant, options.year, options.month),
+        violations,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@ekwo-ai/des",
+  "version": "0.4.0",
+  "description": "The French DES — declaration europeenne de services — in TypeScript: the XML the DGDDI accepts, from plain statement rows. Zero dependencies.",
+  "keywords": [
+    "des",
+    "declaration-europeenne-de-services",
+    "ec-sales-list",
+    "intra-community",
+    "vat",
+    "france",
+    "douane",
+    "dgddi",
+    "xml"
+  ],
+  "license": "MIT",
+  "author": "Ekwo AI",
+  "homepage": "https://github.com/Ekwo-ai/ekwo-os/tree/main/packages/formats/des#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ekwo-ai/ekwo-os.git",
+    "directory": "packages/formats/des"
+  },
+  "bugs": {
+    "url": "https://github.com/Ekwo-ai/ekwo-os/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.9.0",
+    "vitest": "^3.2.0"
+  }
+}