@open-nav/mock-server 0.1.0

package/dist/server.js

@@ -0,0 +1,123 @@
+import { createServer } from 'node:http';
+import { encodeInvoiceData, parseDocument } from '@open-nav/core';
+import { HANDLERS, MockError, errorResponse, } from './handlers.js';
+import { createState } from './state.js';
+/**
+ * Start a local stand-in for the Online Számla invoice service.
+ *
+ * It speaks the real XML on the real paths, verifies the request signature
+ * the way NAV does, and decides an invoice's fate by running it through this
+ * project's validator. That last part is what makes it useful: a test that
+ * submits a broken invoice sees a realistic ABORTED result with the fault
+ * code NAV would have reported.
+ *
+ * ```ts
+ * const mock = await startMockServer({ credentials });
+ * const client = new NavClient({ credentials, software, baseUrl: mock.url });
+ * ```
+ */
+export async function startMockServer(options) {
+    const state = createState(options.taxpayers ?? []);
+    seedInbound(state, options.inboundInvoices ?? [], options.now ?? (() => new Date()));
+    const config = {
+        credentials: options.credentials,
+        pollsBeforeDone: options.pollsBeforeDone ?? 0,
+        validate: options.validate ?? true,
+        now: options.now ?? (() => new Date()),
+    };
+    const server = createServer((request, response) => {
+        const chunks = [];
+        request.on('data', (chunk) => chunks.push(chunk));
+        request.on('end', () => {
+            const body = Buffer.concat(chunks).toString('utf8');
+            const { status, body: responseBody } = dispatch(request.method ?? '', request.url ?? '', body, config, state);
+            response.writeHead(status, { 'content-type': 'application/xml; charset=utf-8' });
+            response.end(responseBody);
+        });
+    });
+    await new Promise((resolve) => {
+        server.listen(options.port ?? 0, options.host ?? '127.0.0.1', resolve);
+    });
+    const address = server.address();
+    const host = options.host ?? '127.0.0.1';
+    return {
+        url: `http://${host}:${address.port}/invoiceService/v1`,
+        port: address.port,
+        state,
+        server,
+        close: () => new Promise((resolve, reject) => {
+            server.close((error) => (error ? reject(error) : resolve()));
+        }),
+    };
+}
+/** Store seeded invoices as if they had been received. */
+function seedInbound(state, invoices, now) {
+    for (const [index, invoice] of invoices.entries()) {
+        const head = invoice.invoiceMain.invoice?.invoiceHead;
+        state.inbound.set(invoice.invoiceNumber, {
+            invoiceNumber: invoice.invoiceNumber,
+            operation: 'CREATE',
+            supplierTaxNumber: head?.supplierInfo.supplierTaxNumber.taxpayerId ?? '',
+            ...(head?.customerInfo?.customerVatData?.customerTaxNumber?.taxpayerId
+                ? { customerTaxNumber: head.customerInfo.customerVatData.customerTaxNumber.taxpayerId }
+                : {}),
+            issueDate: invoice.invoiceIssueDate,
+            base64: encodeInvoiceData(invoice),
+            compressed: false,
+            invoice,
+            transactionId: `MOCKIN${(index + 1).toString().padStart(6, '0')}`,
+            index: index + 1,
+            insDate: now().toISOString(),
+        });
+    }
+}
+function dispatch(method, url, body, config, state) {
+    if (method !== 'POST') {
+        return {
+            status: 405,
+            body: errorResponse(config, 'INVALID_REQUEST', 'only POST is supported'),
+        };
+    }
+    const operation = url.split('?')[0]?.split('/').filter(Boolean).pop() ?? '';
+    const handler = HANDLERS[operation];
+    if (!handler) {
+        return {
+            status: 404,
+            body: errorResponse(config, 'INVALID_REQUEST', `unknown operation ${operation}`),
+        };
+    }
+    let document;
+    try {
+        // Lenient, because a caller's extra element should surface as a specific
+        // complaint from a handler rather than as an opaque parse failure.
+        document = parseDocument(body, { unknownElements: 'ignore' });
+    }
+    catch (cause) {
+        return {
+            status: 400,
+            body: errorResponse(config, 'INVALID_REQUEST', `request XML could not be parsed: ${cause.message}`),
+        };
+    }
+    state.requests.push({
+        operation,
+        requestId: document.value.header?.requestId ?? '',
+        body,
+    });
+    try {
+        return handler({
+            operation,
+            body,
+            document: { root: document.root, value: document.value },
+        }, config, state);
+    }
+    catch (error) {
+        if (error instanceof MockError) {
+            return { status: error.status, body: errorResponse(config, error.errorCode, error.message) };
+        }
+        return {
+            status: 500,
+            body: errorResponse(config, 'OPERATION_FAILED', error.message),
+        };
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/state.d.ts

@@ -0,0 +1,73 @@
+import type { InvoiceData, InvoiceStatusType } from '@open-nav/core';
+/**
+ * Everything the mock service remembers.
+ *
+ * Held in memory and exposed on the server handle, so a test can assert on
+ * what was actually received rather than only on what came back.
+ */
+export interface MockState {
+    /** Invoices accepted, keyed by invoice number. */
+    invoices: Map<string, StoredInvoice>;
+    /** Invoices issued *to* this taxpayer, seeded by the test. */
+    inbound: Map<string, StoredInvoice>;
+    /** Transactions, keyed by transaction id. */
+    transactions: Map<string, StoredTransaction>;
+    /** Every `requestId` seen, since NAV rejects a replayed one. */
+    requestIds: Set<string>;
+    /** Exchange tokens issued and not yet spent. */
+    tokens: Map<string, {
+        issuedAt: number;
+        spent: boolean;
+    }>;
+    /** Taxpayers the mock knows about, keyed by 8 digit core tax number. */
+    taxpayers: Map<string, MockTaxpayer>;
+    /** Requests received, newest last, for assertions. */
+    requests: Array<{
+        operation: string;
+        requestId: string;
+        body: string;
+    }>;
+}
+export interface StoredInvoice {
+    invoiceNumber: string;
+    /** `CREATE`, `MODIFY` or `STORNO`. */
+    operation: string;
+    supplierTaxNumber: string;
+    customerTaxNumber?: string;
+    issueDate: string;
+    /** The payload exactly as submitted, still base64. */
+    base64: string;
+    compressed: boolean;
+    invoice: InvoiceData;
+    transactionId: string;
+    index: number;
+    insDate: string;
+}
+export interface StoredTransaction {
+    transactionId: string;
+    insDate: string;
+    /** Poll count, used to simulate asynchronous processing. */
+    polls: number;
+    results: Array<{
+        index: number;
+        invoiceStatus: InvoiceStatusType;
+        /** Findings, mirroring NAV's split between technical and business faults. */
+        businessValidationMessages: Array<{
+            validationResultCode: 'ERROR' | 'WARN' | 'INFO';
+            validationErrorCode?: string;
+            message?: string;
+        }>;
+    }>;
+    /** Status the results settle on once processing finishes. */
+    finalStatuses: InvoiceStatusType[];
+}
+export interface MockTaxpayer {
+    taxNumber: string;
+    name: string;
+    shortName?: string;
+    valid: boolean;
+    vatCode?: string;
+    countyCode?: string;
+}
+export declare function createState(taxpayers?: MockTaxpayer[]): MockState;
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAErE;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,kDAAkD;IAClD,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACrC,8DAA8D;IAC9D,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACpC,6CAA6C;IAC7C,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC7C,gEAAgE;IAChE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,gDAAgD;IAChD,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC1D,wEAAwE;IACxE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACrC,sDAAsD;IACtD,QAAQ,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzE;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,WAAW,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,KAAK,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,aAAa,EAAE,iBAAiB,CAAC;QACjC,6EAA6E;QAC7E,0BAA0B,EAAE,KAAK,CAAC;YAChC,oBAAoB,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;YAChD,mBAAmB,CAAC,EAAE,MAAM,CAAC;YAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC,CAAC;KACJ,CAAC,CAAC;IACH,6DAA6D;IAC7D,aAAa,EAAE,iBAAiB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,WAAW,CAAC,SAAS,GAAE,YAAY,EAAO,GAAG,SAAS,CAUrE"}

package/dist/state.js

@@ -0,0 +1,12 @@
+export function createState(taxpayers = []) {
+    return {
+        invoices: new Map(),
+        inbound: new Map(),
+        transactions: new Map(),
+        requestIds: new Set(),
+        tokens: new Map(),
+        taxpayers: new Map(taxpayers.map((taxpayer) => [taxpayer.taxNumber, taxpayer])),
+        requests: [],
+    };
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAqEA,MAAM,UAAU,WAAW,CAAC,YAA4B,EAAE;IACxD,OAAO;QACL,QAAQ,EAAE,IAAI,GAAG,EAAE;QACnB,OAAO,EAAE,IAAI,GAAG,EAAE;QAClB,YAAY,EAAE,IAAI,GAAG,EAAE;QACvB,UAAU,EAAE,IAAI,GAAG,EAAE;QACrB,MAAM,EAAE,IAAI,GAAG,EAAE;QACjB,SAAS,EAAE,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC/E,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@open-nav/mock-server",
+  "version": "0.1.0",
+  "description": "A local stand-in for the NAV Online Számla invoice service, for testing without credentials",
+  "keywords": [
+    "nav",
+    "onlineszamla",
+    "hungary",
+    "invoice",
+    "mock",
+    "testing"
+  ],
+  "license": "MIT",
+  "author": "open-nav contributors",
+  "homepage": "https://github.com/eshton/open-nav#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/eshton/open-nav.git",
+    "directory": "packages/mock-server"
+  },
+  "bugs": "https://github.com/eshton/open-nav/issues",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "open-nav-mock": "./dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20.10.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@open-nav/core": "^0.1.0"
+  },
+  "devDependencies": {
+    "@open-nav/client": "^0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -b"
+  }
+}

package/src/bin.ts

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+import { parseArgs } from 'node:util';
+import { startMockServer } from './server.js';
+
+/**
+ * Run the mock service standalone, so the CLI and any other integration can
+ * be pointed at it without credentials.
+ */
+const { values } = parseArgs({
+  args: process.argv.slice(2),
+  options: {
+    port: { type: 'string' },
+    host: { type: 'string' },
+    polls: { type: 'string' },
+    'no-validate': { type: 'boolean' },
+    help: { type: 'boolean', short: 'h' },
+  },
+  strict: true,
+});
+
+if (values.help === true) {
+  console.log(`open-nav-mock — a local stand-in for the NAV Online Számla invoice service
+
+  --port <n>       Port to listen on (default 8080; 0 picks a free one)
+  --host <host>    Interface to bind (default 127.0.0.1)
+  --polls <n>      Polls before a transaction settles (default 0, immediate)
+  --no-validate    Accept every invoice instead of validating it
+`);
+  process.exit(0);
+}
+
+// Obviously fake credentials, printed on startup so they can be copied.
+const credentials = {
+  login: 'mocklogin123',
+  password: 'mock-password',
+  signKey: 'mock-sign-key-0123456789',
+  exchangeKey: '0123456789abcdef',
+  taxNumber: '99999999',
+};
+
+const mock = await startMockServer({
+  credentials,
+  port: values.port === undefined ? 8080 : Number(values.port),
+  ...(values.host ? { host: values.host } : {}),
+  pollsBeforeDone: values.polls === undefined ? 0 : Number(values.polls),
+  validate: values['no-validate'] !== true,
+  taxpayers: [
+    {
+      taxNumber: '99999999',
+      name: 'Értékesítő Kft',
+      shortName: 'Értékesítő',
+      valid: true,
+      vatCode: '2',
+      countyCode: '41',
+    },
+    {
+      taxNumber: '99887764',
+      name: 'Beszerző Kft',
+      shortName: 'Beszerző',
+      valid: true,
+      vatCode: '2',
+      countyCode: '02',
+    },
+  ],
+});
+
+console.log(`Mock NAV invoice service listening on ${mock.url}`);
+console.log('');
+console.log('Point the CLI at it with these (fake) credentials:');
+console.log('');
+console.log(`  export NAV_BASE_URL=${mock.url}`);
+console.log(`  export NAV_LOGIN=${credentials.login}`);
+console.log(`  export NAV_PASSWORD=${credentials.password}`);
+console.log(`  export NAV_SIGN_KEY=${credentials.signKey}`);
+console.log(`  export NAV_EXCHANGE_KEY=${credentials.exchangeKey}`);
+console.log(`  export NAV_TAX_NUMBER=${credentials.taxNumber}`);
+console.log('  export NAV_SOFTWARE_ID=OPENNAVMOCK000001');
+console.log('');
+console.log('Then, for example:  open-nav token');
+console.log('Press Ctrl+C to stop.');
+
+const shutdown = (): void => {
+  void mock.close().then(() => process.exit(0));
+};
+process.on('SIGINT', shutdown);
+process.on('SIGTERM', shutdown);