@fin.cx/opendata 3.6.0 → 4.0.0

package/dist_ts/handelsregister/references.js

@@ -0,0 +1,76 @@
+import { registerTypes } from './constants.js';
+import { registerCourts } from './data.codelists.js';
+const collapse = (textArg) => textArg.replace(/\s+/g, ' ').trim();
+const courtKey = (textArg) => collapse(textArg)
+    .replace(/^(?:amtsgericht|registergericht|ag)\s+/i, '')
+    .toLocaleLowerCase('de-DE');
+/** the alternative name the portal puts in brackets: `Berlin (Charlottenburg)` → `charlottenburg` */
+const courtAliasKey = (nameArg) => {
+    const bracket = /\(([^()]+)\)\s*$/.exec(nameArg);
+    return bracket ? courtKey(bracket[1]) : undefined;
+};
+/**
+ * Finds a register court by its code or its name: `H1101`, `Bremen`, `Amtsgericht Bremen`,
+ * `Berlin (Charlottenburg)` or `Charlottenburg`. Returns undefined unless exactly one court fits.
+ */
+export const findRegisterCourt = (codeOrNameArg, courtsArg = registerCourts) => {
+    const text = collapse(codeOrNameArg);
+    if (!text) {
+        return undefined;
+    }
+    const byCode = courtsArg.find((courtArg) => courtArg.code.toUpperCase() === text.toUpperCase());
+    if (byCode) {
+        return byCode;
+    }
+    const key = courtKey(text);
+    const byName = courtsArg.filter((courtArg) => courtKey(courtArg.name) === key);
+    if (byName.length === 1) {
+        return byName[0];
+    }
+    if (byName.length > 1) {
+        return undefined;
+    }
+    const byAlias = courtsArg.filter((courtArg) => courtAliasKey(courtArg.name) === key);
+    return byAlias.length === 1 ? byAlias[0] : undefined;
+};
+/** returns the canonical register type for `hrb`, `HRB`, `gnr` …, or undefined */
+export const toRegisterType = (textArg) => registerTypes.find((typeArg) => typeArg.toLowerCase() === collapse(textArg).toLowerCase());
+/** splits `35230 HB`, `35230HB` or `35230` into digits and location suffix */
+export const parseRegisterNumber = (textArg) => {
+    const match = /^(\d{1,9})\s*([A-Za-zÄÖÜäöü]{1,5})?$/.exec(collapse(textArg));
+    if (!match) {
+        return undefined;
+    }
+    return match[2] ? { digits: match[1], suffix: match[2].toLocaleUpperCase('de-DE') } : { digits: match[1] };
+};
+export const formatRegisterNumber = (partsArg) => partsArg.suffix ? `${partsArg.digits} ${partsArg.suffix}` : partsArg.digits;
+/**
+ * Reads a register reference as businesses print it: `Amtsgericht Bremen HRB 35230 HB`,
+ * `AG Bremen, HRB 35230`, `HRB 35230 HB`. Returns undefined for text it cannot read. A court name
+ * that fits no register court leaves `court` absent and keeps the text in `courtText`.
+ */
+export const parseRegisterReferenceText = (textArg, courtsArg = registerCourts) => {
+    const text = collapse(textArg);
+    const match = /^(.*?)[\s,;:]*\b(HRA|HRB|GnR|PR|VR|GsR)\b\.?\s*(?:Nr\.?\s*)?(\d{1,9}(?:\s*[A-Za-zÄÖÜäöü]{1,5})?)(?=\s|$)(?:\s+früher\s+Amtsgericht\s+.+)?$/i.exec(text);
+    if (!match) {
+        return undefined;
+    }
+    const type = toRegisterType(match[2]);
+    const number = parseRegisterNumber(match[3]);
+    if (!type || !number) {
+        return undefined;
+    }
+    const courtText = collapse(match[1].replace(/[,;:]+$/, ''));
+    const result = { type, number: formatRegisterNumber(number) };
+    if (courtText) {
+        result.courtText = courtText;
+        const court = findRegisterCourt(courtText, courtsArg);
+        if (court) {
+            result.court = court;
+        }
+    }
+    return result;
+};
+/** `Amtsgericht Bremen HRB 35230 HB` */
+export const formatRegisterReference = (referenceArg) => `Amtsgericht ${referenceArg.court.name} ${referenceArg.type} ${referenceArg.number}`;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVmZXJlbmNlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2hhbmRlbHNyZWdpc3Rlci9yZWZlcmVuY2VzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUMvQyxPQUFPLEVBQUUsY0FBYyxFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFvQnJELE1BQU0sUUFBUSxHQUFHLENBQUMsT0FBZSxFQUFVLEVBQUUsQ0FBQyxPQUFPLENBQUMsT0FBTyxDQUFDLE1BQU0sRUFBRSxHQUFHLENBQUMsQ0FBQyxJQUFJLEVBQUUsQ0FBQztBQUVsRixNQUFNLFFBQVEsR0FBRyxDQUFDLE9BQWUsRUFBVSxFQUFFLENBQzNDLFFBQVEsQ0FBQyxPQUFPLENBQUM7S0FDZCxPQUFPLENBQUMseUNBQXlDLEVBQUUsRUFBRSxDQUFDO0tBQ3RELGlCQUFpQixDQUFDLE9BQU8sQ0FBQyxDQUFDO0FBRWhDLHFHQUFxRztBQUNyRyxNQUFNLGFBQWEsR0FBRyxDQUFDLE9BQWUsRUFBc0IsRUFBRTtJQUM1RCxNQUFNLE9BQU8sR0FBRyxrQkFBa0IsQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLENBQUM7SUFDakQsT0FBTyxPQUFPLENBQUMsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsU0FBUyxDQUFDO0FBQ3BELENBQUMsQ0FBQztBQUVGOzs7R0FHRztBQUNILE1BQU0sQ0FBQyxNQUFNLGlCQUFpQixHQUFHLENBQy9CLGFBQXFCLEVBQ3JCLFlBQXVDLGNBQWMsRUFDekIsRUFBRTtJQUM5QixNQUFNLElBQUksR0FBRyxRQUFRLENBQUMsYUFBYSxDQUFDLENBQUM7SUFDckMsSUFBSSxDQUFDLElBQUksRUFBRSxDQUFDO1FBQ1YsT0FBTyxTQUFTLENBQUM7SUFDbkIsQ0FBQztJQUNELE1BQU0sTUFBTSxHQUFHLFNBQVMsQ0FBQyxJ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

package/dist_ts/index.d.ts

@@ -1,3 +1 @@
-export * from './classes.main.opendata.js';
-export * from './laws/index.js';
 export * from './stocks/index.js';

package/dist_ts/index.js

@@ -1,4 +1,2 @@
-export * from './classes.main.opendata.js';
-export * from './laws/index.js';
 export * from './stocks/index.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLDRCQUE0QixDQUFDO0FBQzNDLGNBQWMsaUJBQWlCLENBQUM7QUFDaEMsY0FBYyxtQkFBbUIsQ0FBQyJ9
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLG1CQUFtQixDQUFDIn0=

package/dist_ts/plugins.d.ts

@@ -1,26 +1,8 @@
-import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
-export { fs, path, };
-import * as lik from '@push.rocks/lik';
+export { path, };
 import * as qenv from '@push.rocks/qenv';
-import * as smartarchive from '@push.rocks/smartarchive';
-import * as smartarray from '@push.rocks/smartarray';
-import * as smartbrowser from '@push.rocks/smartbrowser';
-import * as smartdata from '@push.rocks/smartdata';
 import * as smartdelay from '@push.rocks/smartdelay';
-import * as smartfile from '@push.rocks/smartfile';
-import { SmartFs } from '@push.rocks/smartfs';
-import * as smartlog from '@push.rocks/smartlog';
 import * as smartpath from '@push.rocks/smartpath';
-import * as smartpromise from '@push.rocks/smartpromise';
 import * as smartrequest from '@push.rocks/smartrequest';
-import * as smartdb from '@push.rocks/smartdb';
-import * as smartstream from '@push.rocks/smartstream';
-import * as smartunique from '@push.rocks/smartunique';
-import * as smartxml from '@push.rocks/smartxml';
-declare const smartfs: SmartFs;
-declare const smartfileFactory: smartfile.SmartFileFactory;
 declare const getErrorMessage: (error: unknown) => string;
-export { getErrorMessage, lik, qenv, smartarchive, smartarray, smartbrowser, smartdb, smartdata, smartdelay, smartfile, smartfileFactory, smartfs, smartlog, smartpath, smartpromise, smartrequest, smartstream, smartunique, smartxml, };
-import * as tsclass from '@tsclass/tsclass';
-export { tsclass, };
+export { getErrorMessage, qenv, smartdelay, smartpath, smartrequest, };

package/dist_ts/plugins.js

@@ -1,35 +1,16 @@
 // node native scope
-import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
-export { fs, path, };
+export { path, };
 // @push.rocks scope
-import * as lik from '@push.rocks/lik';
 import * as qenv from '@push.rocks/qenv';
-import * as smartarchive from '@push.rocks/smartarchive';
-import * as smartarray from '@push.rocks/smartarray';
-import * as smartbrowser from '@push.rocks/smartbrowser';
-import * as smartdata from '@push.rocks/smartdata';
 import * as smartdelay from '@push.rocks/smartdelay';
-import * as smartfile from '@push.rocks/smartfile';
-import { SmartFs, SmartFsProviderNode } from '@push.rocks/smartfs';
-import * as smartlog from '@push.rocks/smartlog';
 import * as smartpath from '@push.rocks/smartpath';
-import * as smartpromise from '@push.rocks/smartpromise';
 import * as smartrequest from '@push.rocks/smartrequest';
-import * as smartdb from '@push.rocks/smartdb';
-import * as smartstream from '@push.rocks/smartstream';
-import * as smartunique from '@push.rocks/smartunique';
-import * as smartxml from '@push.rocks/smartxml';
-const smartfs = new SmartFs(new SmartFsProviderNode());
-const smartfileFactory = new smartfile.SmartFileFactory(smartfs);
 const getErrorMessage = (error) => {
     if (error instanceof Error) {
         return error.message;
     }
     return String(error);
 };
-export { getErrorMessage, lik, qenv, smartarchive, smartarray, smartbrowser, smartdb, smartdata, smartdelay, smartfile, smartfileFactory, smartfs, smartlog, smartpath, smartpromise, smartrequest, smartstream, smartunique, smartxml, };
-// @tsclass scope
-import * as tsclass from '@tsclass/tsclass';
-export { tsclass, };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2lucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL3BsdWdpbnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsb0JBQW9CO0FBQ3BCLE9BQU8sS0FBSyxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFDdkMsT0FBTyxLQUFLLElBQUksTUFBTSxXQUFXLENBQUM7QUFFbEMsT0FBTyxFQUNMLEVBQUUsRUFDRixJQUFJLEdBQ0wsQ0FBQTtBQUVELG9CQUFvQjtBQUNwQixPQUFPLEtBQUssR0FBRyxNQUFNLGlCQUFpQixDQUFDO0FBQ3ZDLE9BQU8sS0FBSyxJQUFJLE1BQU0sa0JBQWtCLENBQUM7QUFDekMsT0FBTyxLQUFLLFlBQVksTUFBTSwwQkFBMEIsQ0FBQztBQUN6RCxPQUFPLEtBQUssVUFBVSxNQUFNLHdCQUF3QixDQUFDO0FBQ3JELE9BQU8sS0FBSyxZQUFZLE1BQU0sMEJBQTBCLENBQUM7QUFDekQsT0FBTyxLQUFLLFNBQVMsTUFBTSx1QkFBdUIsQ0FBQztBQUNuRCxPQUFPLEtBQUssVUFBVSxNQUFNLHdCQUF3QixDQUFDO0FBQ3JELE9BQU8sS0FBSyxTQUFTLE1BQU0sdUJBQXVCLENBQUM7QUFDbkQsT0FBTyxFQUFFLE9BQU8sRUFBRSxtQkFBbUIsRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBQ25FLE9BQU8sS0FBSyxRQUFRLE1BQU0sc0JBQXNCLENBQUM7QUFDakQsT0FBTyxLQUFLLFNBQVMsTUFBTSx1QkFBdUIsQ0FBQztBQUNuRCxPQUFPLEtBQUssWUFBWSxNQUFNLDBCQUEwQixDQUFDO0FBQ3pELE9BQU8sS0FBSyxZQUFZLE1BQU0sMEJBQTBCLENBQUM7QUFDekQsT0FBTyxLQUFLLE9BQU8sTUFBTSxxQkFBcUIsQ0FBQztBQUMvQyxPQUFPLEtBQUssV0FBVyxNQUFNLHlCQUF5QixDQUFDO0FBQ3ZELE9BQU8sS0FBSyxXQUFXLE1BQU0seUJBQXlCLENBQUM7QUFDdkQsT0FBTyxLQUFLLFFBQVEsTUFBTSxzQkFBc0IsQ0FBQztBQUVqRCxNQUFNLE9BQU8sR0FBRyxJQUFJLE9BQU8sQ0FBQyxJQUFJLG1CQUFtQixFQUFFLENBQUMsQ0FBQztBQUN2RCxNQUFNLGdCQUFnQixHQUFHLElBQUksU0FBUyxDQUFDLGdCQUFnQixDQUFDLE9BQU8sQ0FBQyxDQUFDO0FBRWpFLE1BQU0sZUFBZSxHQUFHLENBQUMsS0FBYyxFQUFFLEVBQUU7SUFDekMsSUFBSSxLQUFLLFlBQVksS0FBSyxFQUFFLENBQUM7UUFDM0IsT0FBTyxLQUFLLENBQUMsT0FBTyxDQUFDO0lBQ3ZCLENBQUM7SUFFRCxPQUFPLE1BQU0sQ0FBQyxLQUFLLENBQUMsQ0FBQztBQUN2QixDQUFDLENBQUM7QUFFRixPQUFPLEVBQ0wsZUFBZSxFQUNmLEdBQUcsRUFDSCxJQUFJLEVBQ0osWUFBWSxFQUNaLFVBQVUsRUFDVixZQUFZLEVBQ1osT0FBTyxFQUNQLFNBQVMsRUFDVCxVQUFVLEVBQ1YsU0FBUyxFQUNULGdCQUFnQixFQUNoQixPQUFPLEVBQ1AsUUFBUSxFQUNSLFNBQVMsRUFDVCxZQUFZLEVBQ1osWUFBWSxFQUNaLFdBQVcsRUFDWCxXQUFXLEVBQ1gsUUFBUSxHQUNULENBQUE7QUFFRCxpQkFBaUI7QUFDakIsT0FBTyxLQUFLLE9BQU8sTUFBTSxrQkFBa0IsQ0FBQztBQUU1QyxPQUFPLEVBQ0wsT0FBTyxHQUNSLENBQUEifQ==
+export { getErrorMessage, qenv, smartdelay, smartpath, smartrequest, };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2lucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL3BsdWdpbnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsb0JBQW9CO0FBQ3BCLE9BQU8sS0FBSyxJQUFJLE1BQU0sV0FBVyxDQUFDO0FBRWxDLE9BQU8sRUFDTCxJQUFJLEdBQ0wsQ0FBQTtBQUVELG9CQUFvQjtBQUNwQixPQUFPLEtBQUssSUFBSSxNQUFNLGtCQUFrQixDQUFDO0FBQ3pDLE9BQU8sS0FBSyxVQUFVLE1BQU0sd0JBQXdCLENBQUM7QUFDckQsT0FBTyxLQUFLLFNBQVMsTUFBTSx1QkFBdUIsQ0FBQztBQUNuRCxPQUFPLEtBQUssWUFBWSxNQUFNLDBCQUEwQixDQUFDO0FBRXpELE1BQU0sZUFBZSxHQUFHLENBQUMsS0FBYyxFQUFFLEVBQUU7SUFDekMsSUFBSSxLQUFLLFlBQVksS0FBSyxFQUFFLENBQUM7UUFDM0IsT0FBTyxLQUFLLENBQUMsT0FBTyxDQUFDO0lBQ3ZCLENBQUM7SUFFRCxPQUFPLE1BQU0sQ0FBQyxLQUFLLENBQUMsQ0FBQztBQUN2QixDQUFDLENBQUM7QUFFRixPQUFPLEVBQ0wsZUFBZSxFQUNmLElBQUksRUFDSixVQUFVLEVBQ1YsU0FBUyxFQUNULFlBQVksR0FDYixDQUFBIn0=

package/package.json

@@ -1,44 +1,38 @@
 {
   "name": "@fin.cx/opendata",
-  "version": "3.6.0",
+  "version": "4.0.0",
   "private": false,
-  "description": "A comprehensive TypeScript library for accessing business data and real-time financial information. Features include German company data management with MongoDB integration, JSONL bulk processing, automated Handelsregister interactions, and real-time stock market data from multiple providers.",
+  "description": "Open business and financial data for TypeScript: register lookups on the German register portal (handelsregister.de) without storage, and stock and crypto prices and fundamentals from several providers.",
   "main": "dist_ts/index.js",
   "typings": "dist_ts/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist_ts/index.d.ts",
+      "import": "./dist_ts/index.js"
+    },
+    "./handelsregister": {
+      "types": "./dist_ts/handelsregister/index.d.ts",
+      "import": "./dist_ts/handelsregister/index.js"
+    },
+    "./package.json": "./package.json"
+  },
   "type": "module",
   "author": "Task Venture Capital GmbH",
   "license": "MIT",
-  "scripts": {
-    "test": "(tstest test/ --verbose)",
-    "build": "(tsbuild)",
-    "buildDocs": "(tsdoc)"
-  },
   "devDependencies": {
-    "@git.zone/tsbuild": "^4.4.0",
-    "@git.zone/tsbundle": "^2.10.0",
-    "@git.zone/tsrun": "^2.0.2",
-    "@git.zone/tstest": "^3.6.3",
-    "@types/node": "25.6.0"
+    "@git.zone/tsbuild": "^5.0.0",
+    "@git.zone/tsbundle": "^2.15.0",
+    "@git.zone/tsrun": "^3.0.0",
+    "@git.zone/tstest": "^6.2.0",
+    "@types/node": "^26.6.1"
   },
   "dependencies": {
-    "@push.rocks/lik": "^6.2.2",
     "@push.rocks/qenv": "^6.1.3",
-    "@push.rocks/smartarchive": "^5.2.1",
-    "@push.rocks/smartarray": "^1.1.0",
-    "@push.rocks/smartbrowser": "^2.0.8",
-    "@push.rocks/smartdata": "^7.1.7",
-    "@push.rocks/smartdb": "^2.7.0",
     "@push.rocks/smartdelay": "^3.0.5",
-    "@push.rocks/smartfile": "^13.1.2",
-    "@push.rocks/smartfs": "^1.5.0",
-    "@push.rocks/smartlog": "^3.1.10",
     "@push.rocks/smartpath": "^6.0.0",
-    "@push.rocks/smartpromise": "^4.2.3",
     "@push.rocks/smartrequest": "^5.0.1",
-    "@push.rocks/smartstream": "^3.4.0",
-    "@push.rocks/smartunique": "^3.0.9",
-    "@push.rocks/smartxml": "^2.0.0",
-    "@tsclass/tsclass": "^9.3.0"
+    "@push.rocks/smartxml": "^2.1.0",
+    "parse5": "^8.0.1"
   },
   "repository": {
     "type": "git",
@@ -68,17 +62,19 @@
     "open data",
     "German companies",
     "business data",
-    "MongoDB",
-    "JSONL",
-    "bulk processing",
-    "data management",
-    "automation",
-    "browser automation",
     "Handelsregister",
-    "web scraping",
-    "file processing",
+    "register portal",
+    "commercial register",
+    "XJustiz",
     "business registry",
-    "data retrieval"
+    "data retrieval",
+    "stock prices",
+    "cryptocurrency",
+    "fundamentals"
   ],
-  "packageManager": "pnpm@10.7.0+sha512.6b865ad4b62a1d9842b61d674a393903b871d9244954f652b8842c2b553c72176b278f64c463e52d40fff8aba385c235c8c9ecf5cc7de4fd78b8bb6d49633ab6"
-}
+  "scripts": {
+    "test": "(tstest test/ --verbose)",
+    "build": "(tsbuild)",
+    "buildDocs": "(tsdoc)"
+  }
+}

package/readme.md

@@ -1,13 +1,12 @@
 # @fin.cx/opendata
 
-`@fin.cx/opendata` is a TypeScript toolbox for serious data plumbing: market data, SEC fundamentals, German company registry workflows, and locally synced law corpora. It is built for programmers who want scriptable APIs, local persistence, and real workflows instead of a thin wrapper around one remote endpoint.
+`@fin.cx/opendata` is a TypeScript toolbox for open business and market data: stock and crypto prices, SEC fundamentals, and lookups in the German registers through the register portal of the federal states. It is built for programmers who want scriptable APIs and real workflows instead of a thin wrapper around one remote endpoint.
 
-It currently gives you four practical lanes in one package:
+It gives you three practical lanes in one package:
 
 - `StockPriceService` for stock and crypto prices with caching, retries, failover, historical ranges, and intraday support
 - `FundamentalsService` and `StockDataService` for SEC fundamentals and combined price + fundamentals payloads
-- `OpenData` for German company ingestion plus browser-driven Handelsregister lookup and document download
-- `LawService` for syncing and searching German, EU, and US law texts in a local embedded database
+- `HandelsregisterClient`, from `@fin.cx/opendata/handelsregister`, for single lookups in the commercial, cooperative, partnership, association and civil-law partnership registers over plain HTTP, without any storage
 
 ## Issue Reporting and Security
 
@@ -36,17 +35,18 @@ pnpm add @fin.cx/opendata
 - `SecEdgarProvider`
   Fundamentals provider backed by SEC EDGAR company facts.
 
-### German Company Data
+### German Registers
 
-- `OpenData`
-  Starts a local embedded database, imports the public German company JSONL dump, and exposes a `handelsregister` helper for company lookup and file download.
+Everything here comes from `@fin.cx/opendata/handelsregister`. That entry point imports nothing else of the package, needs no database, no browser and no download folder, and keeps nothing between calls.
 
-### Laws
-
-- `LawService`
-  Syncs laws into a local embedded database and lets you search them later.
-- `LawRecord`
-  The stored law document model returned by sync and search operations.
+- `HandelsregisterClient`
+  Searches the register portal (handelsregister.de) by name or register number and retrieves one register sheet with its structured register content (SI) parsed into a typed result.
+- `SlidingWindowGate`
+  Holds the portal's limit of 60 searches and retrievals per hour. The client asks it before every counted request.
+- `parseStructuredContent()` and `parseSearchResults()`
+  The parsers on their own, for an SI file or a result page someone saved from the portal. They make no request.
+- `registerCourts`, `findRegisterCourt()`, `parseRegisterReferenceText()`, `formatRegisterReference()`
+  The 150 register courts with their XJustiz codes, and helpers for register references as businesses print them (`Amtsgericht Bremen HRB 35230 HB`).
 
 ## Before You Start
 
@@ -54,10 +54,8 @@ pnpm add @fin.cx/opendata
 - `MarketstackProvider` requires an API key.
 - `SecEdgarProvider` requires a valid `User-Agent` string in the format `Company Name email@example.com`.
 - `CoinGeckoProvider` works without an API key, but a key gives you better rate limits.
-- `OpenData` requires `nogitDir`, `downloadDir`, and `germanBusinessDataDir`.
-- `OpenData.start()` is required before using `OpenData.handelsregister` or `buildInitialDb()`.
-- `LawService` stores data locally. It auto-starts on demand, but explicit `start()` and `stop()` keep lifecycle handling cleaner.
-- EU law syncing and Handelsregister access use a headless browser under the hood.
+- `HandelsregisterClient` needs a gate. The portal's terms allow at most 60 searches or retrievals of entities per hour from one installation, so share one `SlidingWindowGate` (or a gate of your own) among every client that reaches the portal from the same address.
+- The portal's terms allow single lookups for information purposes. Systematic retrieval to build or update a copy of the registers is not allowed, and neither is publishing the data under the name "Handelsregister" (§ 8 Abs. 2 HGB).
 - `StockDataService` defaults to a 24 hour price cache. If you want fresher quote caching, pass `cache.priceTTL` explicitly or use `StockPriceService` directly.
 
 ## Quick Start
@@ -194,118 +192,125 @@ console.log({
 });
 ```
 
-### German Company Data And Handelsregister Automation
+### Register Lookups (Handelsregister)
 
-`OpenData` is the local workflow layer for German company data. It creates its directories, boots an embedded SmartDB-backed database, and starts a browser automation session for Handelsregister access.
+`HandelsregisterClient` speaks to the register portal of the federal states over plain HTTP, the way a browser would: it opens the search form, sends the search, reads the result list and, for one entry, downloads the structured register content (SI, an XJustiz XML file) and parses it.
 
 ```ts
-import { OpenData } from '@fin.cx/opendata';
-import * as path from 'node:path';
-
-const nogitDir = path.join(process.cwd(), '.nogit');
-
-const openData = new OpenData({
-  nogitDir,
-  downloadDir: path.join(nogitDir, 'downloads'),
-  germanBusinessDataDir: path.join(nogitDir, 'germanbusinessdata'),
-});
-
-await openData.start();
-
-const matches = await openData.handelsregister.searchCompany('Siemens AG', 20);
-
-const company = await openData.handelsregister.getSpecificCompany({
-  court: 'Munich',
-  type: 'HRB',
-  number: '6684',
-});
-
-console.log({
-  searchHits: matches.length,
-  downloadedFiles: company.files.map((file) => file.path),
+import {
+  HandelsregisterClient,
+  HandelsregisterError,
+  SlidingWindowGate,
+  findRegisterCourt,
+  formatRegisterReference,
+} from '@fin.cx/opendata/handelsregister';
+
+// one gate for the whole installation: 60 searches or retrievals per hour
+const gate = new SlidingWindowGate();
+
+const register = new HandelsregisterClient({
+  gate,
+  userAgent: 'Example Books (+https://example.com/contact)',
 });
 
-await openData.stop();
+// by name: every row the portal lists, in its order, never narrowed down to one
+const found = await register.search({ name: 'Task Venture Capital', seat: 'Bremen' });
+const choices = found.matches.map((match) => ({
+  reference: formatRegisterReference(match.reference), // 'Amtsgericht Bremen HRB 35230 HB'
+  name: match.name,
+  sheet: match.sheetStatus, // 'current' or 'closed'
+  formerNames: match.formerNames,
+}));
+if (found.truncated) {
+  // the portal stops at 100 hits: add the seat, the court or the register number
+}
+
+// one register sheet, with its structured content
+const court = findRegisterCourt('Amtsgericht Bremen');
+if (court) {
+  const entry = await register.getEntry({ courtCode: court.code, type: 'HRB', number: '35230 HB' });
+  const content = entry.structuredContent; // null when the portal offers none for this entry
+  if (content) {
+    const facts = {
+      name: content.name,
+      legalForm: content.legalForm?.short, // 'GmbH'
+      address: content.address,
+      status: content.status?.state, // 'active', 'deleted', 'in_liquidation', 'insolvent', 'merged'
+      representatives: content.representatives, // [{ name, function, functionCode, kind }]
+      retrievedAt: entry.retrievedAt,
+      notice: entry.notice.en, // the portal's note: the structured content is not binding
+    };
+  }
+}
+
+// every failure is typed
+try {
+  await register.getEntry({ courtCode: 'H1101', type: 'HRB', number: '35230' });
+} catch (error) {
+  if (error instanceof HandelsregisterError && error.code === 'rate_limited') {
+    const nextPossibleAt = new Date(error.retryAt ?? Date.now());
+  }
+}
 ```
 
-Useful `OpenData` workflows today:
+Searches take a name or a register number:
 
-- `await openData.start()`
-- `await openData.buildInitialDb()` to ingest the public German company JSONL dataset
-- `await openData.handelsregister.searchCompany(name, limit)`
-- `await openData.handelsregister.getSpecificCompany({ court, type, number })`
-- `await openData.handelsregister.getSpecificCompanyByName(name)`
+- `{ name, match?: 'all' | 'any' | 'exact', seat?, type?, courtCode?, includeClosed? }`
+- `{ type, number, courtCode?, includeClosed? }` where `type` is `HRA`, `HRB`, `GnR`, `PR`, `VR` or `GsR` and `number` may carry the location suffix (`999924 B`, `999928 NM`). The portal is searched by the digits, so rows with any suffix come back. Without `courtCode`, every court's entry with that number is returned.
 
-The download workflow currently fetches the Handelsregister files into a temporary folder and returns the files to you as `SmartFile` objects.
+`getEntry({ courtCode, type, number })` identifies one sheet. It includes closed sheets, compares the location suffix when you give one, and never picks one of several: it fails with `not_found` or `ambiguous` and lists the candidates.
 
-### Law Syncing And Search
+#### What counts against the 60 per hour
 
-`LawService` stores synced laws in a local embedded database and supports three jurisdictions:
+| Call | Counted requests | Also loaded |
+| --- | --- | --- |
+| `search()` | 1 search | the search form and the result list |
+| `getEntry()` | 1 search, plus 1 retrieval when the portal offers structured content | the search form and the result list |
 
-- Germany via `gesetze-im-internet`
-- EU via `EUR-Lex`
-- US via GovInfo and Cornell LII
+The client asks the gate before each counted request and before that step sends anything, so a refusal costs no traffic. A slot taken for a step that then fails before its request is sent stays taken; the count errs on the safe side. The client never repeats a request by itself, never caches, and never writes to the console. Every call opens its own visit to the portal and forgets it afterwards.
 
-```ts
-import { LawService } from '@fin.cx/opendata';
-
-const laws = new LawService({
-  dbFolderPath: '.nogit/law-smartdb',
-  dbName: 'laws',
-  govInfoApiKey: process.env.GOVINFO_API_KEY,
-});
+A refusal of `SlidingWindowGate` is a `HandelsregisterError` with the code `rate_limited` and `retryAt`, the moment the next request is possible. Like every error of the client it carries the refused `step` (`search` or `structured_content`) and the `countedRequests` made before it: a `getEntry()` refused at the retrieval has already counted its search. A gate of your own may refuse with any error; a `HandelsregisterError` gains the step and the count the same way, and any other error reaches the caller unchanged.
 
-await laws.start();
-
-const germanLaw = await laws.syncLaw({
-  jurisdiction: 'de',
-  identifier: 'aeg',
-});
-
-const euLaw = await laws.syncLaw({
-  jurisdiction: 'eu',
-  identifier: '32024R1689',
-  language: 'EN',
-});
+#### What a result holds
 
-const usCode = await laws.syncLaw({
-  jurisdiction: 'us',
-  identifier: '8 U.S.C. § 1226',
-});
+- `IRegisterMatch`, one row of the result list: `reference` (court with code and name, register type, number with suffix), `formerCourt`, `federalState`, `name`, `seat`, `sheetStatus` (`current`, `closed` or `other`, with the portal's word in `sheetStatusText`), `formerNames` and the `documents` the portal offers.
+- `IRegisterStructuredContent`, the parsed SI: `name`, `legalForm` (XUnternehmen code with short and long designation), `seat`, the business `address`, `register`, `status` (XJustiz status of the legal entity), `lastEntryOn`, `representatives` and `representationStated`, `producedAt`, `binding: false` and the portal's `notice`.
+- A closed sheet ("Geschlossenes Registerblatt") means the entry was deleted, or its sheet was closed when the entity moved to another court, changed its legal form or merged. The result list does not say which, and the portal offers no structured content for it.
+- The structured content states no date for the status itself; `lastEntryOn` is the date of the latest entry on the sheet.
+- Of people the parser reads the name and the function only. Birth dates, places of residence and private addresses never leave it.
+- Codes are decoded with tables taken from the code lists on XRepository on 2026-09-23. A code the tables do not know is kept as a code, without a designation.
 
-const results = await laws.searchLaws({
-  jurisdiction: 'eu',
-  query: 'Artificial Intelligence Act',
-  limit: 5,
-});
+#### What can happen
 
-console.log({
-  germany: germanLaw.title,
-  eu: euLaw.title,
-  us: usCode.title,
-  hits: results.length,
-});
+| Case | Result |
+| --- | --- |
+| No match | `search()` returns no matches; `getEntry()` fails with `not_found` |
+| Several matches in different courts | every row, in the portal's order |
+| More than 100 hits | the first 100 and `truncated: true` |
+| Renamed entity | the current name, earlier names in `formerNames` |
+| Deleted or moved entity | `sheetStatus: 'closed'`, no structured content |
+| Dissolved or insolvent entity | `status.state` `in_liquidation` or `insolvent`, and the liquidators among the representatives |
+| Branch of a company under foreign law | its foreign legal form and seat, and its permanent representatives |
+| Partnership, cooperative, association, civil-law partnership | register types `PR`, `GnR`, `VR`, `GsR` |
+| Number without suffix that fits several sheets | `ambiguous` with the candidates |
+| Suffix that fits no sheet | `not_found` with the sheets of the same number |
+| Structured content of another sheet | `unexpected_response` |
+| Portal answers with an HTTP error (blocked address, overload) | `refused` with `status` |
+| Portal shows its notice that it refuses retrievals from this address | `refused` with its words in `portalMessage` |
+| Portal too slow, unreachable, or call aborted | `timeout`, `unreachable`, `aborted` |
+| Portal changed its pages or answered in another language | `unexpected_response`, with the portal's own message in `portalMessage` when it showed one |
+| Structured content that cannot be read | `invalid_structured_content` |
 
-await laws.stop();
-```
+Errors of the client carry `countedRequests` and the `step` that failed, so you can say whether a request may have counted even when its answer did not arrive. Error messages contain no register data.
 
-`LawService` also supports bulk sync:
+#### Parsing without a request
 
 ```ts
-await laws.syncLaws({
-  jurisdiction: 'us',
-  usCollection: 'PLAW',
-  limit: 25,
-  since: new Date('2025-01-01'),
-});
-```
+import { parseStructuredContent } from '@fin.cx/opendata/handelsregister';
 
-Useful request patterns:
-
-- Germany: `identifier: 'aeg'`
-- EU: `identifier: '32024R1689'`, `language: 'EN'`
-- US public law package: `identifier: 'PLAW-119publ1'`, `usCollection: 'PLAW'`
-- US Code citation: `identifier: '8 U.S.C. § 1226'`
+// an SI file a person downloaded from the portal themselves
+const content = parseStructuredContent(xmlText);
+```
 
 ## API At A Glance
 
@@ -346,33 +351,61 @@ Useful request patterns:
 - `getProviderStats()`
 - `clearCache()`
 
-### `OpenData`
+### `HandelsregisterClient` (`@fin.cx/opendata/handelsregister`)
+
+- `new HandelsregisterClient({ gate, portalUrl?, userAgent?, requestTimeoutMs?, maxResponseBytes?, now? })`
+- `search(query, { signal? })`
+- `getEntry({ courtCode, type, number }, { signal? })`
+
+### `SlidingWindowGate`
+
+- `new SlidingWindowGate({ limit?, windowMs?, now? })`
+- `acquire({ kind })`
+- `remaining()`
+- `nextAllowedAt()`
+
+### Register helpers
+
+- `parseStructuredContent(xml)`
+- `parseSearchResults(html)`
+- `registerCourts`
+- `findRegisterCourt(codeOrName)`
+- `parseRegisterReferenceText(text)`
+- `parseRegisterNumber(text)`
+- `formatRegisterReference(reference)`
+- `structuredContentNotice`
+
+## Data Sources
+
+The package ships no market or register data. Prices and fundamentals come at run time from the providers you register (Marketstack, CoinGecko, SEC EDGAR), and register entries come at run time from the register portal of the federal states (handelsregister.de), one lookup at a time.
+
+The only data the package carries are the code tables that `@fin.cx/opendata/handelsregister` uses to decode the structured register content (`ts/handelsregister/data.codelists.ts`). They are official code lists, published on XRepository (https://www.xrepository.de), and were taken on 2026-09-23:
+
+| Table | Code list | Issued by |
+| --- | --- | --- |
+| `legalFormLabels` | `urn:xoev-de:xunternehmen:codeliste:rechtsformen_2.4` (Rechtsformen) | XUnternehmen |
+| `roleLabels` | `urn:xoev-de:xjustiz:codeliste:gds.rollenbezeichnung_3.6` (GDS.Rollenbezeichnung) | BLK-AG IT-Standards in der Justiz |
+| `entityStatusLabels` | `urn:xoev-de:xjustiz:codeliste:reg.status-rechtstraeger_2.0` (REG.Status_Rechtstraeger) | BLK-AG IT-Standards in der Justiz |
+| `stateKeyToIso` | `urn:xoev-de:bund:bfj:codeliste:bfj.staat_7.0` (BfJ Staat) | Bundesamt für Justiz, Bonn |
+| `registerCourts` | the register courts of the portal's search form, with their codes from `urn:xoev-de:xjustiz:codeliste:gds.gerichte` | BLK-AG IT-Standards in der Justiz |
 
-- `start()`
-- `stop()`
-- `buildInitialDb()`
-- `handelsregister.searchCompany(name, limit?)`
-- `handelsregister.getSpecificCompany({ court, type, number })`
-- `handelsregister.getSpecificCompanyByName(name)`
+Codes and designations are reproduced as published, without changes. The tables hold a selection of each list, never an edited entry:
 
-### `LawService`
+- `legalFormLabels`: the concrete legal forms that one of the justice registers can carry, with the short and the long designation;
+- `roleLabels`: the 71 roles that occur in register content;
+- `entityStatusLabels`: the whole list;
+- `stateKeyToIso`: the key and the ISO 3166-1 alpha-2 code of each state or territory that has one;
+- `registerCourts`: the 150 register courts as the portal's search form named them on the same day.
 
-- `start()`
-- `stop()`
-- `getLaw(request)`
-- `syncLaw(request)`
-- `syncLaws(request)`
-- `searchLaws({ query, jurisdiction?, limit? })`
+A later version of a code list may add codes. The parser keeps a code it does not know as a code, without a designation, and never guesses one.
 
 ## Behavior And Caveats
 
 - Historical market data is cached aggressively because it is treated as immutable.
 - Intraday data uses interval-aware caching and tries incremental refreshes for recent data.
 - `StockDataService` is convenience-first. `StockPriceService` is the better low-level choice if you care about request-shape-specific cache behavior.
-- `OpenData` is a real workflow layer, not just types. It writes local data, launches a browser, and manages downloads.
-- Handelsregister and EUR-Lex integrations depend on current site structure. They are practical automation workflows, not guaranteed stable official APIs.
-- The most useful public `OpenData` features today are startup, JSONL import, and Handelsregister operations. Some extra validation/search helper methods exist in source but are still stubs.
-- `LawService` persists synced laws locally, so repeated searches can stay offline once the data has been synced.
+- The register lookup reads the portal's German pages and asks for German explicitly. It depends on the portal's current page structure: when that changes, calls end in `unexpected_response` rather than in guessed data.
+- The structured register content is a non-binding service of the portal; the current printout is binding. Results carry `binding: false` and the portal's note.
 - There is no hosted backend in this package. Everything is meant to run from your own TypeScript/Node process.
 
 ## Testing
@@ -381,7 +414,7 @@ Useful request patterns:
 pnpm test
 ```
 
-Some tests hit live remote services, so they may depend on network access, optional API credentials, or browser automation support.
+Some market data tests hit live remote services, so they may depend on network access or optional API credentials. The register lookup is tested against minimal hand-written pages and structured content with synthetic values only; the tests never contact the register portal.
 
 ## License and Legal Information