Merge pull request 'feat/TInvoice' (#2 ) from feat/TInvoice into master

Reviewed-on: #2 Reviewed-by: Dominik Schwank <dominik@schwank.cc>
remove obsolete files
2025-03-24 07:55:21 +00:00 · 2025-03-22 23:42:45 +00:00 · 2025-03-22 23:42:22 +00:00 · 2025-03-22 23:34:45 +00:00 · 2025-03-22 21:38:50 +00:00 · 2025-03-22 21:27:20 +00:00
9 changed files with 524 additions and 235 deletions
--- a/package.json
+++ b/package.json
@ -40,11 +40,11 @@
    "type-fest": "^4.37.0"
  },
  "devDependencies": {
-    "@git.zone/tsbuild": "^2.2.6",
+    "@git.zone/tsbuild": "^2.3.2",
    "@git.zone/tsrun": "^1.3.3",
    "@git.zone/tstest": "^1.0.96",
-    "@push.rocks/tapbundle": "^5.5.6",
-    "@types/node": "^22.13.9"
+    "@push.rocks/tapbundle": "^5.6.0",
+    "@types/node": "^22.13.11"
  },
  "files": [
    "ts/**/*",
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@ -13,20 +13,20 @@ importers:
        version: 4.37.0
    devDependencies:
      '@git.zone/tsbuild':
-        specifier: ^2.2.6
-        version: 2.2.6
+        specifier: ^2.3.2
+        version: 2.3.2
      '@git.zone/tsrun':
        specifier: ^1.3.3
        version: 1.3.3
      '@git.zone/tstest':
        specifier: ^1.0.96
-        version: 1.0.96(@aws-sdk/credential-providers@3.758.0)(socks@2.8.4)(typescript@5.7.3)
+        version: 1.0.96(@aws-sdk/credential-providers@3.772.0)(socks@2.8.4)(typescript@5.7.3)
      '@push.rocks/tapbundle':
-        specifier: ^5.5.6
-        version: 5.5.6(@aws-sdk/credential-providers@3.758.0)(socks@2.8.4)
+        specifier: ^5.6.0
+        version: 5.6.0(@aws-sdk/credential-providers@3.772.0)(socks@2.8.4)
      '@types/node':
-        specifier: ^22.13.9
-        version: 22.13.9
+        specifier: ^22.13.11
+        version: 22.13.11

 packages:

@ -68,24 +68,24 @@ packages:
  '@aws-crypto/util@5.2.0':
    resolution: {integrity: sha512-4RkU9EsI6ZpBve5fseQlGNUWKMa1RLPQ1dnjnQoe07ldfIzcsGb5hC5W0Dm7u423KWzawlrpbjXBrXCEv9zazQ==}

-  '@aws-sdk/client-cognito-identity@3.758.0':
-    resolution: {integrity: sha512-8bOXVYtf/0OUN0jXTIHLv3V0TAS6kvvCRAy7nmiL/fDde0O+ChW1WZU7CVPAOtFEpFCdKskDcxFspM7m1k6qyg==}
+  '@aws-sdk/client-cognito-identity@3.772.0':
+    resolution: {integrity: sha512-R11dYd2NGAH9TDRUJHd3Ab3HZzSoyqwQu+ZR9MZdcA2l3k99mqsrvcLp60YBPGq1dOEQDB1A85xgrAwtWLj81Q==}
    engines: {node: '>=18.0.0'}

-  '@aws-sdk/client-s3@3.758.0':
-    resolution: {integrity: sha512-f8SlhU9/93OC/WEI6xVJf/x/GoQFj9a/xXK6QCtr5fvCjfSLgMVFmKTiIl/tgtDRzxUDc8YS6EGtbHjJ3Y/atg==}
+  '@aws-sdk/client-s3@3.772.0':
+    resolution: {integrity: sha512-HQXlQIyyLp47h1/Hdjr36yK8/gsAAFX2vRzgDJhSRaz0vWZlWX07AJdYfrxapLUXfVU6DbBu3rwi2UGqM7ixqQ==}
    engines: {node: '>=18.0.0'}

-  '@aws-sdk/client-sso@3.758.0':
-    resolution: {integrity: sha512-BoGO6IIWrLyLxQG6txJw6RT2urmbtlwfggapNCrNPyYjlXpzTSJhBYjndg7TpDATFd0SXL0zm8y/tXsUXNkdYQ==}
+  '@aws-sdk/client-sso@3.772.0':
+    resolution: {integrity: sha512-sDdxepi74+cL6gXJJ2yw3UNSI7GBvoGTwZqFyPoNAzcURvaYwo8dBr7G4jS9GDanjTlO3CGVAf2VMcpqEvmoEw==}
    engines: {node: '>=18.0.0'}

  '@aws-sdk/core@3.758.0':
    resolution: {integrity: sha512-0RswbdR9jt/XKemaLNuxi2gGr4xGlHyGxkTdhSQzCyUe9A9OPCoLl3rIESRguQEech+oJnbHk/wuiwHqTuP9sg==}
    engines: {node: '>=18.0.0'}

-  '@aws-sdk/credential-provider-cognito-identity@3.758.0':
-    resolution: {integrity: sha512-y/rHZqyChlEkNRr59gn4hv0gjhJwGmdCdW0JI1K9p3P9p7EurWGjr2M6+goTn3ilOlcAwrl5oFKR5jLt27TkOA==}
+  '@aws-sdk/credential-provider-cognito-identity@3.772.0':
+    resolution: {integrity: sha512-rgGCB7+ttlOvuFjz016WVF0m1zDQNakreXVGmlqxKUHTgAkbXulbzcCnZt44S7QGP6V1ElbRB4jI7piRFirdwg==}
    engines: {node: '>=18.0.0'}

  '@aws-sdk/credential-provider-env@3.758.0':
@ -96,28 +96,28 @@ packages:
    resolution: {integrity: sha512-Xt9/U8qUCiw1hihztWkNeIR+arg6P+yda10OuCHX6kFVx3auTlU7+hCqs3UxqniGU4dguHuftf3mRpi5/GJ33Q==}
    engines: {node: '>=18.0.0'}

-  '@aws-sdk/credential-provider-ini@3.758.0':
-    resolution: {integrity: sha512-cymSKMcP5d+OsgetoIZ5QCe1wnp2Q/tq+uIxVdh9MbfdBBEnl9Ecq6dH6VlYS89sp4QKuxHxkWXVnbXU3Q19Aw==}
+  '@aws-sdk/credential-provider-ini@3.772.0':
+    resolution: {integrity: sha512-T1Ec9Q25zl5c/eZUPHZsiq8vgBeWBjHM7WM5xtZszZRPqqhQGnmFlomz1r9rwhW8RFB5k8HRaD/SLKo6jtYl/A==}
    engines: {node: '>=18.0.0'}

-  '@aws-sdk/credential-provider-node@3.758.0':
-    resolution: {integrity: sha512-+DaMv63wiq7pJrhIQzZYMn4hSarKiizDoJRvyR7WGhnn0oQ/getX9Z0VNCV3i7lIFoLNTb7WMmQ9k7+z/uD5EQ==}
+  '@aws-sdk/credential-provider-node@3.772.0':
+    resolution: {integrity: sha512-0IdVfjBO88Mtekq/KaScYSIEPIeR+ABRvBOWyj/c/qQ2KJyI0GRlSAzpANfxDLHVPn3yEHuZd9nRL6sOmOMI0A==}
    engines: {node: '>=18.0.0'}

  '@aws-sdk/credential-provider-process@3.758.0':
    resolution: {integrity: sha512-AzcY74QTPqcbXWVgjpPZ3HOmxQZYPROIBz2YINF0OQk0MhezDWV/O7Xec+K1+MPGQO3qS6EDrUUlnPLjsqieHA==}
    engines: {node: '>=18.0.0'}

-  '@aws-sdk/credential-provider-sso@3.758.0':
-    resolution: {integrity: sha512-x0FYJqcOLUCv8GLLFDYMXRAQKGjoM+L0BG4BiHYZRDf24yQWFCAZsCQAYKo6XZYh2qznbsW6f//qpyJ5b0QVKQ==}
+  '@aws-sdk/credential-provider-sso@3.772.0':
+    resolution: {integrity: sha512-yR3Y5RAVPa4ogojcBOpZUx6XyRVAkynIJCjd0avdlxW1hhnzSr5/pzoiJ6u21UCbkxlJJTDZE3jfFe7tt+HA4w==}
    engines: {node: '>=18.0.0'}

-  '@aws-sdk/credential-provider-web-identity@3.758.0':
-    resolution: {integrity: sha512-XGguXhBqiCXMXRxcfCAVPlMbm3VyJTou79r/3mxWddHWF0XbhaQiBIbUz6vobVTD25YQRbWSmSch7VA8kI5Lrw==}
+  '@aws-sdk/credential-provider-web-identity@3.772.0':
+    resolution: {integrity: sha512-yHAT5Y2y0fnecSuWRUn8NMunKfDqFYhnOpGq8UyCEcwz9aXzibU0hqRIEm51qpR81hqo0GMFDH0EOmegZ/iW5w==}
    engines: {node: '>=18.0.0'}

-  '@aws-sdk/credential-providers@3.758.0':
-    resolution: {integrity: sha512-BaGVBdm9ynsErIc/mLuUwJ1OQcL/pkhCuAm24jpsif3evZ5wgyZnEAZB2yRin+mQnQaQT3L+KvTbdKGfjL8+fQ==}
+  '@aws-sdk/credential-providers@3.772.0':
+    resolution: {integrity: sha512-+gOrzw05jNVSHFBTZ+LOaGQZ0IXT95aQjNUeWqYXzdgjxKXptrhuMnFLwBBliLbHPp8ziauRnnwG8aK58LOUlg==}
    engines: {node: '>=18.0.0'}

  '@aws-sdk/middleware-bucket-endpoint@3.734.0':
@ -144,8 +144,8 @@ packages:
    resolution: {integrity: sha512-mUMFITpJUW3LcKvFok176eI5zXAUomVtahb9IQBwLzkqFYOrMJvWAvoV4yuxrJ8TlQBG8gyEnkb9SnhZvjg67w==}
    engines: {node: '>=18.0.0'}

-  '@aws-sdk/middleware-recursion-detection@3.734.0':
-    resolution: {integrity: sha512-CUat2d9ITsFc2XsmeiRQO96iWpxSKYFjxvj27Hc7vo87YUHRnfMfnc8jw1EpxEwMcvBD7LsRa6vDNky6AjcrFA==}
+  '@aws-sdk/middleware-recursion-detection@3.772.0':
+    resolution: {integrity: sha512-zg0LjJa4v7fcLzn5QzZvtVS+qyvmsnu7oQnb86l6ckduZpWDCDC9+A0ZzcXTrxblPCJd3JqkoG1+Gzi4S4Ny/Q==}
    engines: {node: '>=18.0.0'}

  '@aws-sdk/middleware-sdk-s3@3.758.0':
@ -160,8 +160,8 @@ packages:
    resolution: {integrity: sha512-iNyehQXtQlj69JCgfaOssgZD4HeYGOwxcaKeG6F+40cwBjTAi0+Ph1yfDwqk2qiBPIRWJ/9l2LodZbxiBqgrwg==}
    engines: {node: '>=18.0.0'}

-  '@aws-sdk/nested-clients@3.758.0':
-    resolution: {integrity: sha512-YZ5s7PSvyF3Mt2h1EQulCG93uybprNGbBkPmVuy/HMMfbFTt4iL3SbKjxqvOZelm86epFfj7pvK7FliI2WOEcg==}
+  '@aws-sdk/nested-clients@3.772.0':
+    resolution: {integrity: sha512-gNJbBxR5YlEumsCS9EWWEASXEnysL0aDnr9MNPX1ip/g1xOqRHmytgV/+t8RFZFTKg0OprbWTq5Ich3MqsEuCQ==}
    engines: {node: '>=18.0.0'}

  '@aws-sdk/region-config-resolver@3.734.0':
@ -172,8 +172,8 @@ packages:
    resolution: {integrity: sha512-0RPCo8fYJcrenJ6bRtiUbFOSgQ1CX/GpvwtLU2Fam1tS9h2klKK8d74caeV6A1mIUvBU7bhyQ0wMGlwMtn3EYw==}
    engines: {node: '>=18.0.0'}

-  '@aws-sdk/token-providers@3.758.0':
-    resolution: {integrity: sha512-ckptN1tNrIfQUaGWm/ayW1ddG+imbKN7HHhjFdS4VfItsP0QQOB0+Ov+tpgb4MoNR4JaUghMIVStjIeHN2ks1w==}
+  '@aws-sdk/token-providers@3.772.0':
+    resolution: {integrity: sha512-d1Waa1vyebuokcAWYlkZdtFlciIgob7B39vPRmtxMObbGumJKiOy/qCe2/FB/72h1Ej9Ih32lwvbxUjORQWN4g==}
    engines: {node: '>=18.0.0'}

  '@aws-sdk/types@3.734.0':
@ -539,8 +539,8 @@ packages:
  '@esm-bundle/chai@4.3.4-fix.0':
    resolution: {integrity: sha512-26SKdM4uvDWlY8/OOOxSB1AqQWeBosCX3wRYUZO7enTAj03CtVxIiCimYVG2WpULcyV51qapK4qTovwkUr5Mlw==}

-  '@git.zone/tsbuild@2.2.6':
-    resolution: {integrity: sha512-6CZ0wqtW/+WXzoHxzNPIKVzPjTColxVoY+TpzlIaz01WktiNr/oeJAfYXdQIVTVYpJs1n9tZ3fwKP6l3LAPAlQ==}
+  '@git.zone/tsbuild@2.3.2':
+    resolution: {integrity: sha512-PG7N39/MkpIKGgRvT2MC7eyLHMcoofaQJQgUlJzicp62Wfk2W9qbnI8Xexb52uy7zvmndao/G4xZ391exJAj+A==}
    hasBin: true

  '@git.zone/tsbundle@2.2.5':
@ -893,8 +893,8 @@ packages:
  '@push.rocks/smartyaml@2.0.5':
    resolution: {integrity: sha512-tBcf+HaOIfeEsTMwgUZDtZERCxXQyRsWO8Ar5DjBdiSRchbhVGZQEBzXswMS0W5ZoRenjgPK+4tPW3JQGRTfbg==}

-  '@push.rocks/tapbundle@5.5.6':
-    resolution: {integrity: sha512-V6u+nZwt4fNccxbm3ztZgHr/QAj/uKhaaOUFgtaae0jzYdds4jNEI+mXLpfXuNMgm7Nx93Lk5XUxWKTI8drjNw==}
+  '@push.rocks/tapbundle@5.6.0':
+    resolution: {integrity: sha512-rPckJ39WsSDwLzmlji8sLpbQyfDUWLWV5aQi0NOPg1Bocq8PhDRrwxML/7LYMb2mSbupFe2bRHDlcugm+iltgA==}

  '@push.rocks/taskbuffer@3.1.7':
    resolution: {integrity: sha512-QktGVJPucqQmW/QNGnscf4FAigT1H7JWKFGFdRuDEaOHKFh9qN+PXG3QY7DtZ4jfXdGLxPN4yAufDuPSAJYFnw==}
@ -1270,6 +1270,9 @@ packages:
  '@tsclass/tsclass@4.4.0':
    resolution: {integrity: sha512-/T3qmxj28yRMM+0x9UtyBmrsJ66flviQEDg3M4kwmWuZQgbrDACa6JXdA0ieqfmuPOXDJRRDKcyKaKvKi2EdwA==}

+  '@tsclass/tsclass@4.4.4':
+    resolution: {integrity: sha512-YZOAF+u+r4u5rCev2uUd1KBTBdfyFdtDmcv4wuN+864lMccbdfRICR3SlJwCfYS1lbeV3QNLYGD30wjRXgvCJA==}
+
  '@types/accepts@1.3.7':
    resolution: {integrity: sha512-Pay9fq2lM2wXPWbteBsRAGiWH2hig4ZE2asK+mm7kUzlxRTfL961rj89I6zV/E3PcIkDqyuBEcMxFT7rccugeQ==}

@ -1339,6 +1342,9 @@ packages:
  '@types/express@5.0.0':
    resolution: {integrity: sha512-DvZriSMehGHL1ZNLzi6MidnsDhUZM/x2pRdDIKdwbUNqqwHxMlRdkxtn6/EPKyqKpHqTl/4nRZsRNLpZxZRpPQ==}

+  '@types/express@5.0.1':
+    resolution: {integrity: sha512-UZUw8vjpWFXuDnjFTh7/5c2TWDlQqeXHi6hcN7F2XSVT5P+WmUnnbFS3KA6Jnc6IsEqI2qCVu2bK0R0J4A8ZQQ==}
+
  '@types/fast-json-stable-stringify@2.1.2':
    resolution: {integrity: sha512-vsxcbfLDdjytnCnHXtinE40Xl46Wr7l/VGRGt7ewJwCPMKEHOdEsTxXX8xwgoR7cbc+6dE8SB4jlMrOV2zAg7g==}
    deprecated: This is a stub types definition. fast-json-stable-stringify provides its own type definitions, so you do not need this installed.
@ -1424,8 +1430,8 @@ packages:
  '@types/node-forge@1.3.11':
    resolution: {integrity: sha512-FQx220y22OKNTqaByeBGqHWYz4cl94tpcxeFdvBo3wjG6XPBuZ0BNgNZRV5J5TFmmcsJ4IzsLkmGRiQbnYsBEQ==}

-  '@types/node@22.13.9':
-    resolution: {integrity: sha512-acBjXdRJ3A6Pb3tqnw9HZmyR3Fiol3aGxRCK1x3d+6CDAMjl7I649wpSd+yNURCjbOUGu9tqtLKnTGxmK6CyGw==}
+  '@types/node@22.13.11':
+    resolution: {integrity: sha512-iEUCUJoU0i3VnrCmgoWCXttklWcvoCIx4jzcP22fioIVSdTmjgoEvmAO/QPw6TcS9k5FrNgn4w7q5lGOd1CT5g==}

  '@types/parse5@6.0.3':
    resolution: {integrity: sha512-SuT16Q1K51EAVPz1K29DJ/sXjhSQ0zjvsypYJ6tlwVsRV9jwW5Adq2ch8Dq8kDBCkYnELS7N7VNCSB5nC56t/g==}
@ -3281,8 +3287,8 @@ packages:
    resolution: {integrity: sha512-mLV7SEiov2LHleRJPMPrK2PMyhXFZt2UQLC4VD4pnth3jMjYKHhtqfwwkkvS/NXuo/Fp3vbhaNcXrIDaLRb9Tg==}
    engines: {node: '>=12.9.0'}

-  mongodb@6.14.2:
-    resolution: {integrity: sha512-kMEHNo0F3P6QKDq17zcDuPeaywK/YaJVCEQRzPF3TOM/Bl9MFg64YE5Tu7ifj37qZJMhwU1tl2Ioivws5gRG5Q==}
+  mongodb@6.15.0:
+    resolution: {integrity: sha512-ifBhQ0rRzHDzqp9jAQP6OwHSH7dbYIQjD3SbJs9YYk9AikKEettW/9s/tbSFDTpXcRbF+u1aLrhHxDFaYtZpFQ==}
    engines: {node: '>=16.20.1'}
    peerDependencies:
      '@aws-sdk/credential-providers': ^3.188.0
@ -3317,8 +3323,8 @@ packages:
  nanocolors@0.2.13:
    resolution: {integrity: sha512-0n3mSAQLPpGLV9ORXT5+C/D4mwew7Ebws69Hx4E2sgz2ZA5+32Q80B9tL8PbL7XHnRDiAxH/pnrUJ9a4fkTNTA==}

-  nanoid@3.3.9:
-    resolution: {integrity: sha512-SppoicMGpZvbF1l3z4x7No3OlIjP7QJvC9XR7AhZr1kL133KHnKPztkKDc+Ir4aJ/1VhTySrtKhrsycmrMQfvg==}
+  nanoid@3.3.11:
+    resolution: {integrity: sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==}
    engines: {node: ^10 || ^12 || ^13.7 || ^14 || >=15.0.1}
    hasBin: true

@ -4063,8 +4069,8 @@ packages:
    resolution: {integrity: sha512-l7FvfAHlcmulp8kr+flpQZmVwtu7nfRV7NZujtN0OqES8EL4O4e0qqzL0DC5gAvx/ZC/9lk6rhcUwYvkBnBnYA==}
    engines: {node: '>=12'}

-  tr46@5.0.0:
-    resolution: {integrity: sha512-tk2G5R2KRwBd+ZN0zaEXpmzdKyOYksXwywulIX95MBODjSzMIuQnQ3m8JxgbhnL1LeVo7lqQKsYa1O3Htl7K5g==}
+  tr46@5.1.0:
+    resolution: {integrity: sha512-IUWnUK7ADYR5Sl1fZlO1INDUhVhatWl7BtJWsIhwJ0UAK7ilzzIa8uIqOO/aYVWHZPJkKbEL+362wrzoeRF7bw==}
    engines: {node: '>=18'}

  tree-kill@1.2.2:
@ -4217,8 +4223,8 @@ packages:
    resolution: {integrity: sha512-RKT8HExMpoYx4igMiVMY83lN6UeITKJlBQ+vR/8ZJ8OCdSiN3RwCq+9gH0+Xzj0+5IrM6i4j/6LuvzbZIQgEcQ==}
    engines: {node: '>=12'}

-  whatwg-url@14.1.1:
-    resolution: {integrity: sha512-mDGf9diDad/giZ/Sm9Xi2YcyzaFpbdLpJPr+E9fSkyQ7KpQD4SdFcugkRQYzhmfI4KeV4Qpnn2sKPdo+kmsgRQ==}
+  whatwg-url@14.2.0:
+    resolution: {integrity: sha512-De72GdQZzNTUBBChsXueQUnPKDkg/5A5zp7pFDuQAj5UFoENpiACU0wlCvzpAGnTkj++ihpKwKyYewn/XNUbKw==}
    engines: {node: '>=18'}

  which@2.0.2:
@ -4484,15 +4490,15 @@ snapshots:
      '@smithy/util-utf8': 2.3.0
      tslib: 2.8.1

-  '@aws-sdk/client-cognito-identity@3.758.0':
+  '@aws-sdk/client-cognito-identity@3.772.0':
    dependencies:
      '@aws-crypto/sha256-browser': 5.2.0
      '@aws-crypto/sha256-js': 5.2.0
      '@aws-sdk/core': 3.758.0
-      '@aws-sdk/credential-provider-node': 3.758.0
+      '@aws-sdk/credential-provider-node': 3.772.0
      '@aws-sdk/middleware-host-header': 3.734.0
      '@aws-sdk/middleware-logger': 3.734.0
-      '@aws-sdk/middleware-recursion-detection': 3.734.0
+      '@aws-sdk/middleware-recursion-detection': 3.772.0
      '@aws-sdk/middleware-user-agent': 3.758.0
      '@aws-sdk/region-config-resolver': 3.734.0
      '@aws-sdk/types': 3.734.0
@ -4529,20 +4535,20 @@ snapshots:
      - aws-crt
    optional: true

-  '@aws-sdk/client-s3@3.758.0':
+  '@aws-sdk/client-s3@3.772.0':
    dependencies:
      '@aws-crypto/sha1-browser': 5.2.0
      '@aws-crypto/sha256-browser': 5.2.0
      '@aws-crypto/sha256-js': 5.2.0
      '@aws-sdk/core': 3.758.0
-      '@aws-sdk/credential-provider-node': 3.758.0
+      '@aws-sdk/credential-provider-node': 3.772.0
      '@aws-sdk/middleware-bucket-endpoint': 3.734.0
      '@aws-sdk/middleware-expect-continue': 3.734.0
      '@aws-sdk/middleware-flexible-checksums': 3.758.0
      '@aws-sdk/middleware-host-header': 3.734.0
      '@aws-sdk/middleware-location-constraint': 3.734.0
      '@aws-sdk/middleware-logger': 3.734.0
-      '@aws-sdk/middleware-recursion-detection': 3.734.0
+      '@aws-sdk/middleware-recursion-detection': 3.772.0
      '@aws-sdk/middleware-sdk-s3': 3.758.0
      '@aws-sdk/middleware-ssec': 3.734.0
      '@aws-sdk/middleware-user-agent': 3.758.0
@ -4590,14 +4596,14 @@ snapshots:
    transitivePeerDependencies:
      - aws-crt

-  '@aws-sdk/client-sso@3.758.0':
+  '@aws-sdk/client-sso@3.772.0':
    dependencies:
      '@aws-crypto/sha256-browser': 5.2.0
      '@aws-crypto/sha256-js': 5.2.0
      '@aws-sdk/core': 3.758.0
      '@aws-sdk/middleware-host-header': 3.734.0
      '@aws-sdk/middleware-logger': 3.734.0
-      '@aws-sdk/middleware-recursion-detection': 3.734.0
+      '@aws-sdk/middleware-recursion-detection': 3.772.0
      '@aws-sdk/middleware-user-agent': 3.758.0
      '@aws-sdk/region-config-resolver': 3.734.0
      '@aws-sdk/types': 3.734.0
@ -4647,9 +4653,9 @@ snapshots:
      fast-xml-parser: 4.4.1
      tslib: 2.8.1

-  '@aws-sdk/credential-provider-cognito-identity@3.758.0':
+  '@aws-sdk/credential-provider-cognito-identity@3.772.0':
    dependencies:
-      '@aws-sdk/client-cognito-identity': 3.758.0
+      '@aws-sdk/client-cognito-identity': 3.772.0
      '@aws-sdk/types': 3.734.0
      '@smithy/property-provider': 4.0.1
      '@smithy/types': 4.1.0
@ -4679,15 +4685,15 @@ snapshots:
      '@smithy/util-stream': 4.1.2
      tslib: 2.8.1

-  '@aws-sdk/credential-provider-ini@3.758.0':
+  '@aws-sdk/credential-provider-ini@3.772.0':
    dependencies:
      '@aws-sdk/core': 3.758.0
      '@aws-sdk/credential-provider-env': 3.758.0
      '@aws-sdk/credential-provider-http': 3.758.0
      '@aws-sdk/credential-provider-process': 3.758.0
-      '@aws-sdk/credential-provider-sso': 3.758.0
-      '@aws-sdk/credential-provider-web-identity': 3.758.0
-      '@aws-sdk/nested-clients': 3.758.0
+      '@aws-sdk/credential-provider-sso': 3.772.0
+      '@aws-sdk/credential-provider-web-identity': 3.772.0
+      '@aws-sdk/nested-clients': 3.772.0
      '@aws-sdk/types': 3.734.0
      '@smithy/credential-provider-imds': 4.0.1
      '@smithy/property-provider': 4.0.1
@ -4697,14 +4703,14 @@ snapshots:
    transitivePeerDependencies:
      - aws-crt

-  '@aws-sdk/credential-provider-node@3.758.0':
+  '@aws-sdk/credential-provider-node@3.772.0':
    dependencies:
      '@aws-sdk/credential-provider-env': 3.758.0
      '@aws-sdk/credential-provider-http': 3.758.0
-      '@aws-sdk/credential-provider-ini': 3.758.0
+      '@aws-sdk/credential-provider-ini': 3.772.0
      '@aws-sdk/credential-provider-process': 3.758.0
-      '@aws-sdk/credential-provider-sso': 3.758.0
-      '@aws-sdk/credential-provider-web-identity': 3.758.0
+      '@aws-sdk/credential-provider-sso': 3.772.0
+      '@aws-sdk/credential-provider-web-identity': 3.772.0
      '@aws-sdk/types': 3.734.0
      '@smithy/credential-provider-imds': 4.0.1
      '@smithy/property-provider': 4.0.1
@ -4723,11 +4729,11 @@ snapshots:
      '@smithy/types': 4.1.0
      tslib: 2.8.1

-  '@aws-sdk/credential-provider-sso@3.758.0':
+  '@aws-sdk/credential-provider-sso@3.772.0':
    dependencies:
-      '@aws-sdk/client-sso': 3.758.0
+      '@aws-sdk/client-sso': 3.772.0
      '@aws-sdk/core': 3.758.0
-      '@aws-sdk/token-providers': 3.758.0
+      '@aws-sdk/token-providers': 3.772.0
      '@aws-sdk/types': 3.734.0
      '@smithy/property-provider': 4.0.1
      '@smithy/shared-ini-file-loader': 4.0.1
@ -4736,10 +4742,10 @@ snapshots:
    transitivePeerDependencies:
      - aws-crt

-  '@aws-sdk/credential-provider-web-identity@3.758.0':
+  '@aws-sdk/credential-provider-web-identity@3.772.0':
    dependencies:
      '@aws-sdk/core': 3.758.0
-      '@aws-sdk/nested-clients': 3.758.0
+      '@aws-sdk/nested-clients': 3.772.0
      '@aws-sdk/types': 3.734.0
      '@smithy/property-provider': 4.0.1
      '@smithy/types': 4.1.0
@ -4747,19 +4753,19 @@ snapshots:
    transitivePeerDependencies:
      - aws-crt

-  '@aws-sdk/credential-providers@3.758.0':
+  '@aws-sdk/credential-providers@3.772.0':
    dependencies:
-      '@aws-sdk/client-cognito-identity': 3.758.0
+      '@aws-sdk/client-cognito-identity': 3.772.0
      '@aws-sdk/core': 3.758.0
-      '@aws-sdk/credential-provider-cognito-identity': 3.758.0
+      '@aws-sdk/credential-provider-cognito-identity': 3.772.0
      '@aws-sdk/credential-provider-env': 3.758.0
      '@aws-sdk/credential-provider-http': 3.758.0
-      '@aws-sdk/credential-provider-ini': 3.758.0
-      '@aws-sdk/credential-provider-node': 3.758.0
+      '@aws-sdk/credential-provider-ini': 3.772.0
+      '@aws-sdk/credential-provider-node': 3.772.0
      '@aws-sdk/credential-provider-process': 3.758.0
-      '@aws-sdk/credential-provider-sso': 3.758.0
-      '@aws-sdk/credential-provider-web-identity': 3.758.0
-      '@aws-sdk/nested-clients': 3.758.0
+      '@aws-sdk/credential-provider-sso': 3.772.0
+      '@aws-sdk/credential-provider-web-identity': 3.772.0
+      '@aws-sdk/nested-clients': 3.772.0
      '@aws-sdk/types': 3.734.0
      '@smithy/core': 3.1.5
      '@smithy/credential-provider-imds': 4.0.1
@ -4822,7 +4828,7 @@ snapshots:
      '@smithy/types': 4.1.0
      tslib: 2.8.1

-  '@aws-sdk/middleware-recursion-detection@3.734.0':
+  '@aws-sdk/middleware-recursion-detection@3.772.0':
    dependencies:
      '@aws-sdk/types': 3.734.0
      '@smithy/protocol-http': 5.0.1
@ -4862,14 +4868,14 @@ snapshots:
      '@smithy/types': 4.1.0
      tslib: 2.8.1

-  '@aws-sdk/nested-clients@3.758.0':
+  '@aws-sdk/nested-clients@3.772.0':
    dependencies:
      '@aws-crypto/sha256-browser': 5.2.0
      '@aws-crypto/sha256-js': 5.2.0
      '@aws-sdk/core': 3.758.0
      '@aws-sdk/middleware-host-header': 3.734.0
      '@aws-sdk/middleware-logger': 3.734.0
-      '@aws-sdk/middleware-recursion-detection': 3.734.0
+      '@aws-sdk/middleware-recursion-detection': 3.772.0
      '@aws-sdk/middleware-user-agent': 3.758.0
      '@aws-sdk/region-config-resolver': 3.734.0
      '@aws-sdk/types': 3.734.0
@ -4923,9 +4929,9 @@ snapshots:
      '@smithy/types': 4.1.0
      tslib: 2.8.1

-  '@aws-sdk/token-providers@3.758.0':
+  '@aws-sdk/token-providers@3.772.0':
    dependencies:
-      '@aws-sdk/nested-clients': 3.758.0
+      '@aws-sdk/nested-clients': 3.772.0
      '@aws-sdk/types': 3.734.0
      '@smithy/property-provider': 4.0.1
      '@smithy/shared-ini-file-loader': 4.0.1
@ -5196,7 +5202,7 @@ snapshots:
    dependencies:
      '@types/chai': 4.3.20

-  '@git.zone/tsbuild@2.2.6':
+  '@git.zone/tsbuild@2.3.2':
    dependencies:
      '@git.zone/tspublish': 1.9.1
      '@push.rocks/early': 4.0.4
@ -5247,7 +5253,7 @@ snapshots:
      '@push.rocks/smartshell': 3.2.0
      tsx: 4.19.2

-  '@git.zone/tstest@1.0.96(@aws-sdk/credential-providers@3.758.0)(socks@2.8.4)(typescript@5.7.3)':
+  '@git.zone/tstest@1.0.96(@aws-sdk/credential-providers@3.772.0)(socks@2.8.4)(typescript@5.7.3)':
    dependencies:
      '@api.global/typedserver': 3.0.68
      '@git.zone/tsbundle': 2.2.5
@ -5259,7 +5265,7 @@ snapshots:
      '@push.rocks/smartlog': 3.0.7
      '@push.rocks/smartpromise': 4.2.3
      '@push.rocks/smartshell': 3.2.3
-      '@push.rocks/tapbundle': 5.5.6(@aws-sdk/credential-providers@3.758.0)(socks@2.8.4)
+      '@push.rocks/tapbundle': 5.6.0(@aws-sdk/credential-providers@3.772.0)(socks@2.8.4)
      '@types/ws': 8.18.0
      figures: 6.1.0
      ws: 8.18.1
@ -5309,7 +5315,7 @@ snapshots:
      '@jest/schemas': 29.6.3
      '@types/istanbul-lib-coverage': 2.0.6
      '@types/istanbul-reports': 3.0.4
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11
      '@types/yargs': 17.0.33
      chalk: 4.1.2

@ -5467,7 +5473,7 @@ snapshots:
      '@push.rocks/smartstring': 4.0.15
      '@push.rocks/smartunique': 3.0.9
      '@push.rocks/taskbuffer': 3.1.7
-      '@tsclass/tsclass': 4.4.0
+      '@tsclass/tsclass': 4.4.4
    transitivePeerDependencies:
      - aws-crt

@ -5500,7 +5506,7 @@ snapshots:
      '@pushrocks/smartjson': 4.0.6
      '@pushrocks/smartpath': 5.0.5
      '@pushrocks/smartpromise': 3.1.10
-      '@tsclass/tsclass': 4.4.0
+      '@tsclass/tsclass': 4.4.4
      mongodb: 4.17.2
    transitivePeerDependencies:
      - aws-crt
@ -5543,7 +5549,7 @@ snapshots:

  '@push.rocks/smartbucket@3.3.7':
    dependencies:
-      '@aws-sdk/client-s3': 3.758.0
+      '@aws-sdk/client-s3': 3.772.0
      '@push.rocks/smartmime': 2.0.4
      '@push.rocks/smartpath': 5.0.18
      '@push.rocks/smartpromise': 4.2.3
@ -5551,7 +5557,7 @@ snapshots:
      '@push.rocks/smartstream': 3.2.5
      '@push.rocks/smartstring': 4.0.15
      '@push.rocks/smartunique': 3.0.9
-      '@tsclass/tsclass': 4.4.0
+      '@tsclass/tsclass': 4.4.4
    transitivePeerDependencies:
      - aws-crt

@ -5589,20 +5595,20 @@ snapshots:
      '@types/node-forge': 1.3.11
      node-forge: 1.3.1

-  '@push.rocks/smartdata@5.2.12(@aws-sdk/credential-providers@3.758.0)(socks@2.8.4)':
+  '@push.rocks/smartdata@5.2.12(@aws-sdk/credential-providers@3.772.0)(socks@2.8.4)':
    dependencies:
      '@push.rocks/lik': 6.1.0
      '@push.rocks/smartdelay': 3.0.5
      '@push.rocks/smartlog': 3.0.7
-      '@push.rocks/smartmongo': 2.0.10(@aws-sdk/credential-providers@3.758.0)(socks@2.8.4)
+      '@push.rocks/smartmongo': 2.0.10(@aws-sdk/credential-providers@3.772.0)(socks@2.8.4)
      '@push.rocks/smartpromise': 4.2.3
      '@push.rocks/smartrx': 3.0.7
      '@push.rocks/smartstring': 4.0.15
      '@push.rocks/smarttime': 4.1.1
      '@push.rocks/smartunique': 3.0.9
      '@push.rocks/taskbuffer': 3.1.7
-      '@tsclass/tsclass': 4.4.0
-      mongodb: 6.14.2(@aws-sdk/credential-providers@3.758.0)(socks@2.8.4)
+      '@tsclass/tsclass': 4.4.4
+      mongodb: 6.15.0(@aws-sdk/credential-providers@3.772.0)(socks@2.8.4)
    transitivePeerDependencies:
      - '@aws-sdk/credential-providers'
      - '@mongodb-js/zstd'
@ -5777,10 +5783,10 @@ snapshots:
      file-type: 19.6.0
      mime: 4.0.6

-  '@push.rocks/smartmongo@2.0.10(@aws-sdk/credential-providers@3.758.0)(socks@2.8.4)':
+  '@push.rocks/smartmongo@2.0.10(@aws-sdk/credential-providers@3.772.0)(socks@2.8.4)':
    dependencies:
      '@push.rocks/mongodump': 1.0.8
-      '@push.rocks/smartdata': 5.2.12(@aws-sdk/credential-providers@3.758.0)(socks@2.8.4)
+      '@push.rocks/smartdata': 5.2.12(@aws-sdk/credential-providers@3.772.0)(socks@2.8.4)
      '@push.rocks/smartpath': 5.0.18
      '@push.rocks/smartpromise': 4.2.3
      mongodb-memory-server: 8.16.1
@ -5912,7 +5918,7 @@ snapshots:
      '@push.rocks/smartbucket': 3.3.7
      '@push.rocks/smartfile': 11.2.0
      '@push.rocks/smartpath': 5.0.18
-      '@tsclass/tsclass': 4.4.0
+      '@tsclass/tsclass': 4.4.4
      '@types/s3rver': 3.7.4
      s3rver: 3.7.1
    transitivePeerDependencies:
@ -6069,7 +6075,7 @@ snapshots:
      '@types/js-yaml': 3.12.10
      js-yaml: 3.14.1

-  '@push.rocks/tapbundle@5.5.6(@aws-sdk/credential-providers@3.758.0)(socks@2.8.4)':
+  '@push.rocks/tapbundle@5.6.0(@aws-sdk/credential-providers@3.772.0)(socks@2.8.4)':
    dependencies:
      '@open-wc/testing': 4.0.0
      '@push.rocks/consolecolor': 2.0.2
@ -6080,7 +6086,7 @@ snapshots:
      '@push.rocks/smartexpect': 1.6.1
      '@push.rocks/smartfile': 11.2.0
      '@push.rocks/smartjson': 5.0.20
-      '@push.rocks/smartmongo': 2.0.10(@aws-sdk/credential-providers@3.758.0)(socks@2.8.4)
+      '@push.rocks/smartmongo': 2.0.10(@aws-sdk/credential-providers@3.772.0)(socks@2.8.4)
      '@push.rocks/smartpath': 5.0.18
      '@push.rocks/smartpromise': 4.2.3
      '@push.rocks/smartrequest': 2.0.23
@ -6669,16 +6675,20 @@ snapshots:
    dependencies:
      type-fest: 4.37.0

+  '@tsclass/tsclass@4.4.4':
+    dependencies:
+      type-fest: 4.37.0
+
  '@types/accepts@1.3.7':
    dependencies:
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11

  '@types/babel__code-frame@7.0.6': {}

  '@types/body-parser@1.19.5':
    dependencies:
      '@types/connect': 3.4.38
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11

  '@types/buffer-json@2.0.3': {}

@ -6694,17 +6704,17 @@ snapshots:

  '@types/clean-css@4.2.11':
    dependencies:
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11
      source-map: 0.6.1

  '@types/co-body@6.1.3':
    dependencies:
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11
      '@types/qs': 6.9.18

  '@types/connect@3.4.38':
    dependencies:
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11

  '@types/content-disposition@0.5.8': {}

@ -6715,13 +6725,13 @@ snapshots:
  '@types/cookies@0.9.0':
    dependencies:
      '@types/connect': 3.4.38
-      '@types/express': 5.0.0
+      '@types/express': 5.0.1
      '@types/keygrip': 1.0.6
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11

  '@types/cors@2.8.17':
    dependencies:
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11

  '@types/debounce@1.2.4': {}

@ -6735,14 +6745,14 @@ snapshots:

  '@types/express-serve-static-core@4.19.6':
    dependencies:
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11
      '@types/qs': 6.9.18
      '@types/range-parser': 1.2.7
      '@types/send': 0.17.4

  '@types/express-serve-static-core@5.0.6':
    dependencies:
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11
      '@types/qs': 6.9.18
      '@types/range-parser': 1.2.7
      '@types/send': 0.17.4
@ -6761,36 +6771,42 @@ snapshots:
      '@types/qs': 6.9.18
      '@types/serve-static': 1.15.7

+  '@types/express@5.0.1':
+    dependencies:
+      '@types/body-parser': 1.19.5
+      '@types/express-serve-static-core': 5.0.6
+      '@types/serve-static': 1.15.7
+
  '@types/fast-json-stable-stringify@2.1.2':
    dependencies:
      fast-json-stable-stringify: 2.1.0

  '@types/from2@2.3.5':
    dependencies:
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11

  '@types/fs-extra@11.0.4':
    dependencies:
      '@types/jsonfile': 6.1.4
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11

  '@types/fs-extra@9.0.13':
    dependencies:
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11

  '@types/glob@7.2.0':
    dependencies:
      '@types/minimatch': 5.1.2
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11

  '@types/glob@8.1.0':
    dependencies:
      '@types/minimatch': 5.1.2
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11

  '@types/gunzip-maybe@1.4.2':
    dependencies:
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11

  '@types/hast@3.0.4':
    dependencies:
@ -6824,7 +6840,7 @@ snapshots:

  '@types/jsonfile@6.1.4':
    dependencies:
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11

  '@types/keygrip@1.0.6': {}

@ -6841,7 +6857,7 @@ snapshots:
      '@types/http-errors': 2.0.4
      '@types/keygrip': 1.0.6
      '@types/koa-compose': 3.2.8
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11

  '@types/mdast@4.0.4':
    dependencies:
@ -6859,9 +6875,9 @@ snapshots:

  '@types/node-forge@1.3.11':
    dependencies:
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11

-  '@types/node@22.13.9':
+  '@types/node@22.13.11':
    dependencies:
      undici-types: 6.20.0

@ -6879,19 +6895,19 @@ snapshots:

  '@types/s3rver@3.7.4':
    dependencies:
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11

  '@types/semver@7.5.8': {}

  '@types/send@0.17.4':
    dependencies:
      '@types/mime': 1.3.5
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11

  '@types/serve-static@1.15.7':
    dependencies:
      '@types/http-errors': 2.0.4
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11
      '@types/send': 0.17.4

  '@types/sinon-chai@3.2.12':
@ -6911,11 +6927,11 @@ snapshots:

  '@types/tar-stream@2.2.3':
    dependencies:
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11

  '@types/through2@2.0.41':
    dependencies:
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11

  '@types/triple-beam@1.3.5': {}

@ -6939,18 +6955,18 @@ snapshots:

  '@types/whatwg-url@8.2.2':
    dependencies:
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11
      '@types/webidl-conversions': 7.0.3

  '@types/which@3.0.4': {}

  '@types/ws@7.4.7':
    dependencies:
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11

  '@types/ws@8.18.0':
    dependencies:
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11

  '@types/yargs-parser@21.0.3': {}

@ -6960,7 +6976,7 @@ snapshots:

  '@types/yauzl@2.10.3':
    dependencies:
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11
    optional: true

  '@ungap/structured-clone@1.3.0': {}
@ -7032,7 +7048,7 @@ snapshots:
      istanbul-reports: 3.1.7
      log-update: 4.0.0
      nanocolors: 0.2.13
-      nanoid: 3.3.9
+      nanoid: 3.3.11
      open: 8.4.2
      picomatch: 2.3.1
      source-map: 0.7.4
@ -7600,7 +7616,7 @@ snapshots:
    dependencies:
      '@types/cookie': 0.4.1
      '@types/cors': 2.8.17
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11
      accepts: 1.3.8
      base64id: 2.0.0
      cookie: 0.4.2
@ -8429,7 +8445,7 @@ snapshots:
  jest-util@29.7.0:
    dependencies:
      '@jest/types': 29.6.3
-      '@types/node': 22.13.9
+      '@types/node': 22.13.11
      chalk: 4.1.2
      ci-info: 3.9.0
      graceful-fs: 4.2.11
@ -9065,7 +9081,7 @@ snapshots:
  mongodb-connection-string-url@3.0.2:
    dependencies:
      '@types/whatwg-url': 11.0.5
-      whatwg-url: 14.1.1
+      whatwg-url: 14.2.0

  mongodb-memory-server-core@8.16.1:
    dependencies:
@ -9102,18 +9118,18 @@ snapshots:
      mongodb-connection-string-url: 2.6.0
      socks: 2.8.4
    optionalDependencies:
-      '@aws-sdk/credential-providers': 3.758.0
+      '@aws-sdk/credential-providers': 3.772.0
      '@mongodb-js/saslprep': 1.2.0
    transitivePeerDependencies:
      - aws-crt

-  mongodb@6.14.2(@aws-sdk/credential-providers@3.758.0)(socks@2.8.4):
+  mongodb@6.15.0(@aws-sdk/credential-providers@3.772.0)(socks@2.8.4):
    dependencies:
      '@mongodb-js/saslprep': 1.2.0
      bson: 6.10.3
      mongodb-connection-string-url: 3.0.2
    optionalDependencies:
-      '@aws-sdk/credential-providers': 3.758.0
+      '@aws-sdk/credential-providers': 3.772.0
      socks: 2.8.4

  ms@2.0.0: {}
@ -9122,7 +9138,7 @@ snapshots:

  nanocolors@0.2.13: {}

-  nanoid@3.3.9: {}
+  nanoid@3.3.11: {}

  nanoid@4.0.2: {}

@ -9981,7 +9997,7 @@ snapshots:
    dependencies:
      punycode: 2.3.1

-  tr46@5.0.0:
+  tr46@5.1.0:
    dependencies:
      punycode: 2.3.1

@ -10115,9 +10131,9 @@ snapshots:
      tr46: 3.0.0
      webidl-conversions: 7.0.0

-  whatwg-url@14.1.1:
+  whatwg-url@14.2.0:
    dependencies:
-      tr46: 5.0.0
+      tr46: 5.1.0
      webidl-conversions: 7.0.0

  which@2.0.2:
--- a/ts/00helperfunctions.ts/finance.ts
+++ b/ts/00helperfunctions.ts/finance.ts
@ -1,5 +0,0 @@
-import { type IInvoice } from "../finance/invoice.js";
-
-export function createLetterFromInvoice(invoiceArg: IInvoice) {
-
-}
--- a/ts/00helperfunctions.ts/index.ts
+++ b/ts/00helperfunctions.ts/index.ts
@ -1 +0,0 @@
-export * from './finance.js';
--- a/ts/business/contract.ts
+++ b/ts/business/contract.ts
@ -1,20 +1,157 @@
 import * as database from "../database/index.js";
-import type { TPerson } from "./index.js";
+import { business } from "../index.js";

-export interface IContract {
-  parties: {
-    signingOrder: number;
-    referencedAs: string;
-    person: TPerson;
-    role: "signer" | "cc";
-    signature: {
-      given: boolean;
-      timestamp?: number;
+/**
+ * Represents a paragraph or section in a contract.
+ */
+export type TContractParagraph = {
+  id: string;
+  title?: string;
+  content: string;  // Markdown formatted text
+  order: number;
+  type: "heading" | "clause" | "subclause" | "definition" | "exhibit";
+  isRequired: boolean;
+  metadata?: {
+    applicableJurisdictions?: string[];
+    tags?: string[];
+    lastModified?: number;
+    versionId?: string;
+  };
+};
+
+/**
+ * Contract party with signature information.
+ */
+export type TContractParty = {
+  signingOrder: number;
+  referencedAs: string;
+  person: business.TPerson;
+  role: "signer" | "cc" | "witness";
+  signature: {
+    given: boolean;
+    timestamp?: number;
+    location?: string;
+    ip?: string;
+    verifications?: any[];
+  };
+};
+
+/**
+ * Contract attachment like exhibits, appendices.
+ */
+export type TContractAttachment = {
+  id: string;
+  title: string;
+  type: "exhibit" | "appendix" | "schedule";
+  fileReference?: string;
+  content?: string;  // Markdown or reference
+};
+
+/**
+ * Base envelope type for all contract types, extending the common document type.
+ */
+export type TContractEnvelope<TYPE extends string, FIELDS> = business.TDocumentEnvelope<
+  TYPE,
+  {
+    // Contract-specific dates
+    effectiveDate: number;
+    expirationDate?: number;
+    
+    // Contract-specific status
+    status: "draft" | "negotiation" | "active" | "expired" | "terminated" | "renewed";
+    
+    // Parties (multiple, without sender/recipient distinction)
+    parties: TContractParty[];
+    
+    // Structured content
+    paragraphs: TContractParagraph[];
+    
+    // Additional attachments
+    attachments?: TContractAttachment[];
+  } & FIELDS
+>;
+
+/**
+ * Employment contract specific type.
+ */
+export type TEmploymentContract = TContractEnvelope<
+  "employment", 
+  {
+    employmentTerms: {
+      startDate: number;
+      position: string;
+      compensationDetails: string;
+      workingHours?: string;
      location?: string;
-      ip?: string;
-      verifications?: [];
+      probationPeriod?: {
+        durationInMonths: number;
+        terms?: string;
+      };
    };
-  }[];
-  contractTextMarkdown: string;
-  actions: database.IObjectAction[];
-}
+  }
+>;
+
+/**
+ * Non-disclosure agreement specific type.
+ */
+export type TNDAContract = TContractEnvelope<
+  "nda", 
+  {
+    confidentialityTerms: {
+      duration: number;  // In months
+      scope: string;
+      exclusions?: string[];
+    };
+  }
+>;
+
+/**
+ * Service agreement specific type.
+ */
+export type TServiceContract = TContractEnvelope<
+  "service", 
+  {
+    serviceTerms: {
+      scope: string;
+      deliverables: string[];
+      timeline?: {
+        milestones: {
+          description: string;
+          dueDate: number;
+        }[];
+      };
+      paymentTerms: string;
+    };
+  }
+>;
+
+/**
+ * Real estate lease agreement specific type.
+ */
+export type TLeaseContract = TContractEnvelope<
+  "lease", 
+  {
+    propertyDetails: {
+      address: business.IAddress;
+      propertyType: string;
+      areaSize?: number;
+      areaSizeUnit?: string;
+    };
+    leaseTerms: {
+      rentAmount: number;
+      rentCurrency: string;
+      paymentFrequency: "monthly" | "quarterly" | "annually";
+      depositAmount?: number;
+      utilities?: string[];
+    };
+  }
+>;
+
+/**
+ * Union type for all contract types.
+ */
+export type TContract = 
+  | TEmploymentContract 
+  | TNDAContract 
+  | TServiceContract 
+  | TLeaseContract;
--- a/ts/business/document.ts
+++ b/ts/business/document.ts
@ -0,0 +1,107 @@
+import * as database from "../database/index.js";
+import * as business from "./index.js";
+
+/**
+ * Base type for common document properties across different document types.
+ */
+export type TDocumentEnvelope<TYPE extends string, FIELDS> = {
+  /**
+   * Document type identifier
+   */
+  type: TYPE;
+  
+  /**
+   * Unique identifier for the document
+   */
+  id: string;
+  
+  /**
+   * Document creation/issuance date as a Unix timestamp
+   */
+  date: number;
+  
+  /**
+   * Document status in its lifecycle
+   */
+  status: string;
+  
+  /**
+   * Version information for the document
+   */
+  versionInfo: {
+    /**
+     * Should follow semVer format
+     */
+    version: string;
+    
+    /**
+     * Type of version (draft vs final)
+     */
+    type: "draft" | "final";
+    
+    /**
+     * When this version was last modified
+     */
+    lastModified?: number;
+    
+    /**
+     * Version history for tracking changes
+     */
+    history?: {
+      version: string;
+      modifiedAt: number;
+      modifiedBy?: string;
+      changeDescription?: string;
+    }[];
+  };
+  
+  /**
+   * Primary language of the document
+   */
+  language: string;
+  
+  /**
+   * The text displayed at the top of the document, often a greeting or introduction
+   */
+  topText?: string;
+  
+  /**
+   * The text displayed at the bottom of the document, often a signature or conclusion
+   */
+  bottomText?: string;
+  
+  /**
+   * Formatting/branding information
+   */
+  appearance?: {
+    /**
+     * URL to the logo to be displayed on the document
+     */
+    logoUrl?: string;
+    
+    /**
+     * Primary color for document styling
+     */
+    accentColor?: string;
+    
+    /**
+     * Font family for the document
+     */
+    fontFamily?: string;
+  };
+  
+  /**
+   * References to PDF versions of the document
+   */
+  pdf?: business.IPdf;
+  
+  /**
+   * PDF attachments are additional PDFs attached to the document
+   */
+  pdfAttachments?: business.IPdf[];
+  
+  /**
+   * Track document lifecycle actions
+   */
+  objectActions?: database.IObjectAction[];
+} & FIELDS;
--- a/ts/business/index.ts
+++ b/ts/business/index.ts
@ -1,5 +1,6 @@
 export * from './address.js';
 export * from './contact.js';
+export * from './document.js';
 export * from './job.js';
 export * from './letter.js';
 export * from './pdf.js';
--- a/ts/business/letter.ts
+++ b/ts/business/letter.ts
@ -1,35 +1,65 @@
 import * as business from "./index.js";
 import * as finance from "../finance/index.js";
-import * as database from "../database/index.js";
-export interface ILetter {
-  versionInfo: {
-    type: "draft" | "final";
+
+/**
+ * Letter-specific envelope extending the base document type
+ */
+export type TLetterEnvelope<TYPE extends string, FIELDS> = business.TDocumentEnvelope<
+  TYPE,
+  {
    /**
-     * should follow semVer
+     * The incident or case ID this letter relates to
     */
-    version: string;
-  };
-  incidenceId: string;
-  type: "invoice" | "notice" | "warning" | "verification" | "contract";
-  date: number;
-  from: business.TContact;
-  to: business.TContact;
-  legalContact: business.TContact;
-  logoUrl: string;
-  subject: string;
-  accentColor?: string;
-  needsCoverSheet: boolean;
-  content: {
-    textData: string[];
-    invoiceData?: finance.IInvoice;
-    contractData?: {
-      id: string;
-      contractDate: number;
+    incidenceId: string;
+    
+    /**
+     * The sender of the letter
+     */
+    from: business.TContact;
+    
+    /**
+     * The recipient of the letter
+     */
+    to: business.TContact;
+    
+    /**
+     * The legal contact is the contact that is responsible for the letter
+     * this is often the same as the from contact, but not always
+     */
+    legalContact?: business.TContact;
+    
+    /**
+     * Subject line of the letter
+     */
+    subject: string;
+    
+    /**
+     * Cover sheet configuration for the letter
+     */
+    coverSheet?: {
+      enabled: boolean;
+      coverSheetText: string;
+      /**
+       * if true, the cover sheet will be marked as confidential
+       * hinting that only authorized persons should handle the letter
+       */
+      confidential: boolean;
    };
-    timesheetData: string;
+  } & FIELDS
+>;
+
+export type TLetterSimple = TLetterEnvelope<"simple", {}>;
+
+
+export type TLetter = TLetterSimple;
+
+// type: "invoice" | "notice" | "warning" | "verification" | "contract";
+/* content: {
+  textData: string[];
+  invoiceData?: finance.IInvoice;
+  contractData?: {
+    id: string;
+    contractDate: number;
  };
-  pdf?: business.IPdf;
-  pdfAttachments: business.IPdf[];
-  language: string;
-  objectActions: database.IObjectAction[];
-}
+  timesheetData: string;
+}; */
--- a/ts/finance/invoice.ts
+++ b/ts/finance/invoice.ts
@ -3,7 +3,7 @@ import type { TCurrency } from './currency.js';

 export type TInvoiceStatus = 'draft' | 'invoice' | 'paid' | 'refunded';

-export interface IInvoiceItem {
+export type TInvoiceItem = {
  position: number;
  name: string;
  articleNumber?: string;
@ -13,46 +13,50 @@ export interface IInvoiceItem {
  vatPercentage: number;
 }

-export interface IInvoice {
-  id: string;
-  /**
-   * am optional date
-   * if not set, the date is likely coming from the encompasing letter
-   */
-  date?: number;
-  billedBy: business.TContact;
-  billedTo: business.TContact;
-  /**
-   * buyer reference is an optional field, that helps the buyer to identify the invoice
-   */
-  buyerReference?: string;
-  /**
-   * also a kind of reference, esspecially needed for circular xinvoice support.
-   */
-  electronicAddress?: {
-    scheme: string;
-    value: string;
-  };
-  type: 'creditnote' | 'debitnote';
-  status: TInvoiceStatus;
-  items: IInvoiceItem[];
-  periodOfPerformance?: {
-    from: number;
-    to: number;
-  };
-  deliveryDate?: number;
-  dueInDays: number;
-  reverseCharge: boolean;
-  printResult?: {
-    pdfBufferString: string;
-    totalNet: number;
-    totalGross: number;
-    vatGroups: {
-      percentage: number;
-      items: IInvoiceItem[];
+export type TInvoiceEnvelope<TYPE extends 'creditnote' | 'debitnote', FIELDS> = business.TLetterEnvelope<
+  'invoice',
+  {
+    invoiceId: string;
+    status: TInvoiceStatus;
+    type: TYPE;
+    items: TInvoiceItem[];
+    periodOfPerformance?: {
+      from: number;
+      to: number;
    };
-  };
-  notes: string[];
-  paymentOptions?: finance.IPaymentOptionInfo;
-  currency: TCurrency;
-}
+    deliveryDate?: number;
+    dueInDays: number;
+    reverseCharge: boolean;
+    /**
+     * buyer reference is an optional field, that helps the buyer to identify the invoice
+     */
+    buyerReference?: string;
+    /**
+     * also a kind of reference, esspecially needed for circular xinvoice support.
+     */
+    electronicAddress?: {
+      scheme: string;
+      value: string;
+    };
+    printResult?: {
+      pdfBufferString: string;
+      totalNet: number;
+      totalGross: number;
+      vatGroups: {
+        percentage: number;
+        items: TInvoiceItem[];
+      };
+    };
+    notes: string[];
+    paymentOptions?: finance.IPaymentOptionInfo;
+    currency: TCurrency;
+  } & FIELDS
+>;
+
+export type TCreditNote = TInvoiceEnvelope<'creditnote', {}>;
+export type TDebitNote = TInvoiceEnvelope<'debitnote', {}>;
+
+export type TInvoice = TCreditNote | TDebitNote;
+
+// Legacy type for backward compatibility
+export interface IInvoiceItem extends TInvoiceItem {}
Author	SHA1	Message	Date
Philipp Kunz	065b5faba2	Merge pull request 'feat/TInvoice' (#2 ) from feat/TInvoice into master Reviewed-on: #2 Reviewed-by: Dominik Schwank <dominik@schwank.cc>	2025-03-24 07:55:21 +00:00
Philipp Kunz	7ddc98d9c8	remove obsolete files	2025-03-22 23:42:45 +00:00
Philipp Kunz	65503e554b	feat(business): Add TDocumentEnvelope as common base for letters and contracts - Created a new TDocumentEnvelope base type for shared document properties - Refactored TLetterEnvelope to extend from TDocumentEnvelope - Refactored TContractEnvelope to extend from TDocumentEnvelope - Centralized common fields like version tracking, date, and formatting	2025-03-22 23:42:22 +00:00
Philipp Kunz	9b66c438b4	feat(business): Refactor TContract to use structured paragraphs and envelope pattern - Replaced single markdown string with structured paragraphs - Implemented TContractEnvelope pattern for different contract types - Added specific contract types (employment, NDA, service, lease) - Added metadata for dates, status, versioning, and attachments - Removed legacy contract interface	2025-03-22 23:34:45 +00:00
Philipp Kunz	0c977bd869	feat(finance): Refactor TInvoice to use TLetterEnvelope pattern - Implemented envelope pattern for TInvoice using business.TLetterEnvelope - Separated TInvoice into TCreditNote and TDebitNote types - Fixed IInvoiceItem references to use TInvoiceItem - Added compatibility interface for IInvoiceItem	2025-03-22 21:38:50 +00:00
Philipp Kunz	6d3f097bb8	on the way to new letter / invoice relationship	2025-03-22 21:27:20 +00:00