# @accounter/shaam-uniform-format-generator

## 0.2.6

### Patch Changes

- [#3440](https://github.com/Urigo/accounter-fullstack/pull/3440)
  [`1ad8a10`](https://github.com/Urigo/accounter-fullstack/commit/1ad8a10f3dd92b38c04ccea15b90cc7f9dc43887)
  Thanks [@renovate](https://github.com/apps/renovate)! - dependencies updates:
  - Updated dependency [`zod@4.4.2` ↗︎](https://www.npmjs.com/package/zod/v/4.4.2) (from `4.3.6`, in
    `dependencies`)

- [#3454](https://github.com/Urigo/accounter-fullstack/pull/3454)
  [`0b654ef`](https://github.com/Urigo/accounter-fullstack/commit/0b654ef08495e1632ccc75942d6a1a3142924d9f)
  Thanks [@renovate](https://github.com/apps/renovate)! - dependencies updates:
  - Updated dependency [`zod@4.4.3` ↗︎](https://www.npmjs.com/package/zod/v/4.4.3) (from `4.4.2`, in
    `dependencies`)

- [#3599](https://github.com/Urigo/accounter-fullstack/pull/3599)
  [`4405b3a`](https://github.com/Urigo/accounter-fullstack/commit/4405b3abf883827c5580131abdeba32552d82196)
  Thanks [@gilgardosh](https://github.com/gilgardosh)! - - **Encoding Support**: Added `iconv-lite`
  to handle Windows-1255 encoding, ensuring correct processing of legacy SHAAM file formats.

- [#3673](https://github.com/Urigo/accounter-fullstack/pull/3673)
  [`a1b5a9a`](https://github.com/Urigo/accounter-fullstack/commit/a1b5a9ad9ddfab18cc747e1f6c25d8b599aaf56a)
  Thanks [@gilgardosh](https://github.com/gilgardosh)! - - **Data Parsing Refactoring**: Centralized
  the data file parsing logic into a dedicated `parseDataFile` utility, improving code modularity
  and maintainability.
  - **Type Safety Improvements**: Introduced `ParsedDataRecords` interface to standardize data
    record structures and removed redundant manual property mapping.
  - **Error Handling Enhancements**: Implemented robust error handling for date conversions and
    record parsing, including better reporting of line numbers and unknown record types.
  - **Validation Logic Updates**: Renamed validation functions to `performRecordsValidation` and
    `performCrossFileValidation` for better clarity and intent.

## 0.2.5

### Patch Changes

- [#2954](https://github.com/Urigo/accounter-fullstack/pull/2954)
  [`79fef66`](https://github.com/Urigo/accounter-fullstack/commit/79fef668ca7a7f2b2411ae5f5d4d0bdc5bb2fa2b)
  Thanks [@renovate](https://github.com/apps/renovate)! - dependencies updates:
  - Updated dependency [`zod@4.3.6` ↗︎](https://www.npmjs.com/package/zod/v/4.3.6) (from `4.3.5`, in
    `dependencies`)

- [#3038](https://github.com/Urigo/accounter-fullstack/pull/3038)
  [`4d4e60d`](https://github.com/Urigo/accounter-fullstack/commit/4d4e60dd85f6c7779c556b513e2de844615dd293)
  Thanks [@gilgardosh](https://github.com/gilgardosh)! - - **Configurable NPM Registry in CI**: The
  GitHub Actions setup now includes a `registryUrl` input, allowing for flexible specification of
  the NPM registry during package publishing.
  - **Deterministic Dependency Installation**: The `yarn install` command in the CI workflow was
    updated to use `--frozen-lockfile`, ensuring consistent and reproducible builds by preventing
    modifications to the `yarn.lock` file.
  - **Standardized Package Metadata**: `package.json` files across several packages were updated to
    include comprehensive and consistent metadata, such as `description`, `repository` details,
    `homepage`, `bugs` URL, and `author` information.
  - **Explicit NPM Registry Configuration**: The `publishConfig` in multiple `package.json` files
    was modified to explicitly set the `registry` to `https://registry.npmjs.org`, clarifying the
    target for package publication.

## 0.2.4

### Patch Changes

- [#2816](https://github.com/Urigo/accounter-fullstack/pull/2816)
  [`6a9926c`](https://github.com/Urigo/accounter-fullstack/commit/6a9926c3948fa736e2c52ce93207b4f35e28f931)
  Thanks [@renovate](https://github.com/apps/renovate)! - dependencies updates:
  - Updated dependency [`iconv-lite@0.7.1` ↗︎](https://www.npmjs.com/package/iconv-lite/v/0.7.1)
    (from `0.7.0`, in `dependencies`)

- [#2824](https://github.com/Urigo/accounter-fullstack/pull/2824)
  [`ca5e62b`](https://github.com/Urigo/accounter-fullstack/commit/ca5e62b91faaf33c99ac178575304797150efe1a)
  Thanks [@renovate](https://github.com/apps/renovate)! - dependencies updates:
  - Updated dependency [`zod@4.2.0` ↗︎](https://www.npmjs.com/package/zod/v/4.2.0) (from `4.1.13`, in
    `dependencies`)

- [#2829](https://github.com/Urigo/accounter-fullstack/pull/2829)
  [`73b11ba`](https://github.com/Urigo/accounter-fullstack/commit/73b11ba1fd676a21b4ba44fe99e2bfd181e513dc)
  Thanks [@renovate](https://github.com/apps/renovate)! - dependencies updates:
  - Updated dependency [`zod@4.2.1` ↗︎](https://www.npmjs.com/package/zod/v/4.2.1) (from `4.2.0`, in
    `dependencies`)

- [#2873](https://github.com/Urigo/accounter-fullstack/pull/2873)
  [`eea8a89`](https://github.com/Urigo/accounter-fullstack/commit/eea8a89638a3893814fd9a341e0080922fc703a1)
  Thanks [@renovate](https://github.com/apps/renovate)! - dependencies updates:
  - Updated dependency [`zod@4.3.2` ↗︎](https://www.npmjs.com/package/zod/v/4.3.2) (from `4.2.1`, in
    `dependencies`)

- [#2877](https://github.com/Urigo/accounter-fullstack/pull/2877)
  [`1c209c8`](https://github.com/Urigo/accounter-fullstack/commit/1c209c8a6045bef747039bbff3780812c6b8678f)
  Thanks [@renovate](https://github.com/apps/renovate)! - dependencies updates:
  - Updated dependency [`zod@4.3.4` ↗︎](https://www.npmjs.com/package/zod/v/4.3.4) (from `4.3.2`, in
    `dependencies`)

- [#2881](https://github.com/Urigo/accounter-fullstack/pull/2881)
  [`bc3ab26`](https://github.com/Urigo/accounter-fullstack/commit/bc3ab260704b677363561ef1c9403eac704a29aa)
  Thanks [@renovate](https://github.com/apps/renovate)! - dependencies updates:
  - Updated dependency [`zod@4.3.5` ↗︎](https://www.npmjs.com/package/zod/v/4.3.5) (from `4.3.4`, in
    `dependencies`)

- [#2904](https://github.com/Urigo/accounter-fullstack/pull/2904)
  [`17ae14f`](https://github.com/Urigo/accounter-fullstack/commit/17ae14f2482ad876e1adce23cdbc7cb173b88dfb)
  Thanks [@renovate](https://github.com/apps/renovate)! - dependencies updates:
  - Updated dependency [`iconv-lite@0.7.2` ↗︎](https://www.npmjs.com/package/iconv-lite/v/0.7.2)
    (from `0.7.1`, in `dependencies`)

## 0.2.3

### Patch Changes

- [#2744](https://github.com/Urigo/accounter-fullstack/pull/2744)
  [`ef68321`](https://github.com/Urigo/accounter-fullstack/commit/ef68321608d60a7208e82a2c413f27beb502e3cc)
  Thanks [@renovate](https://github.com/apps/renovate)! - dependencies updates:
  - Updated dependency [`zod@4.1.13` ↗︎](https://www.npmjs.com/package/zod/v/4.1.13) (from `4.1.12`,
    in `dependencies`)

## 0.2.2

### Patch Changes

- [#2543](https://github.com/Urigo/accounter-fullstack/pull/2543)
  [`65e3c7f`](https://github.com/Urigo/accounter-fullstack/commit/65e3c7f01993eb4f41244a40feefefa08b31a4e6)
  Thanks [@renovate](https://github.com/apps/renovate)! - dependencies updates:
  - Updated dependency [`zod@4.1.12` ↗︎](https://www.npmjs.com/package/zod/v/4.1.12) (from `4.1.11`,
    in `dependencies`)

## 0.2.1

### Patch Changes

- [#2291](https://github.com/Urigo/accounter-fullstack/pull/2291)
  [`633a688`](https://github.com/Urigo/accounter-fullstack/commit/633a68824433dcd4df7be7e9c118ddadbf9a2029)
  Thanks [@renovate](https://github.com/apps/renovate)! - dependencies updates:
  - Updated dependency [`zod@4.0.17` ↗︎](https://www.npmjs.com/package/zod/v/4.0.17) (from `3.25.76`,
    in `dependencies`)

- [#2446](https://github.com/Urigo/accounter-fullstack/pull/2446)
  [`c56e276`](https://github.com/Urigo/accounter-fullstack/commit/c56e276f6e2addab88cd9fcd11b68fbc15c6f41a)
  Thanks [@renovate](https://github.com/apps/renovate)! - dependencies updates:
  - Updated dependency [`iconv-lite@0.7.0` ↗︎](https://www.npmjs.com/package/iconv-lite/v/0.7.0)
    (from `0.6.3`, in `dependencies`)

- [#2456](https://github.com/Urigo/accounter-fullstack/pull/2456)
  [`3fe961a`](https://github.com/Urigo/accounter-fullstack/commit/3fe961a8338359ed544ce4de5730a1898fb1cc43)
  Thanks [@renovate](https://github.com/apps/renovate)! - dependencies updates:
  - Updated dependency [`zod@4.1.0` ↗︎](https://www.npmjs.com/package/zod/v/4.1.0) (from `4.0.17`, in
    `dependencies`)

- [#2457](https://github.com/Urigo/accounter-fullstack/pull/2457)
  [`16b0040`](https://github.com/Urigo/accounter-fullstack/commit/16b0040862d1bf9d65eb9829e8eb33117d60a1c2)
  Thanks [@renovate](https://github.com/apps/renovate)! - dependencies updates:
  - Updated dependency [`zod@4.1.1` ↗︎](https://www.npmjs.com/package/zod/v/4.1.1) (from `4.1.0`, in
    `dependencies`)

- [#2469](https://github.com/Urigo/accounter-fullstack/pull/2469)
  [`7176d0d`](https://github.com/Urigo/accounter-fullstack/commit/7176d0d3e1808cc1800e1cabe121b380f0480d63)
  Thanks [@renovate](https://github.com/apps/renovate)! - dependencies updates:
  - Updated dependency [`zod@4.1.3` ↗︎](https://www.npmjs.com/package/zod/v/4.1.3) (from `4.1.1`, in
    `dependencies`)

- [#2478](https://github.com/Urigo/accounter-fullstack/pull/2478)
  [`86e628e`](https://github.com/Urigo/accounter-fullstack/commit/86e628e40cc0d8fac239cfea2563326094013df4)
  Thanks [@renovate](https://github.com/apps/renovate)! - dependencies updates:
  - Updated dependency [`zod@4.1.5` ↗︎](https://www.npmjs.com/package/zod/v/4.1.5) (from `4.1.3`, in
    `dependencies`)

- [#2483](https://github.com/Urigo/accounter-fullstack/pull/2483)
  [`43760d7`](https://github.com/Urigo/accounter-fullstack/commit/43760d77cb29ea44257d37ca0bc7a97e17aa1c89)
  Thanks [@renovate](https://github.com/apps/renovate)! - dependencies updates:
  - Updated dependency [`zod@4.1.8` ↗︎](https://www.npmjs.com/package/zod/v/4.1.8) (from `4.1.5`, in
    `dependencies`)

- [#2512](https://github.com/Urigo/accounter-fullstack/pull/2512)
  [`590823c`](https://github.com/Urigo/accounter-fullstack/commit/590823cf7105b018a3127abc2343ac714f2845ac)
  Thanks [@renovate](https://github.com/apps/renovate)! - dependencies updates:
  - Updated dependency [`zod@4.1.9` ↗︎](https://www.npmjs.com/package/zod/v/4.1.9) (from `4.1.8`, in
    `dependencies`)

- [#2522](https://github.com/Urigo/accounter-fullstack/pull/2522)
  [`df6b635`](https://github.com/Urigo/accounter-fullstack/commit/df6b63558a951ae7a318515d1d8b86b1b49a74a0)
  Thanks [@renovate](https://github.com/apps/renovate)! - dependencies updates:
  - Updated dependency [`zod@4.1.11` ↗︎](https://www.npmjs.com/package/zod/v/4.1.11) (from `4.1.9`,
    in `dependencies`)

## 0.2.0

### Minor Changes

- [#2314](https://github.com/Urigo/accounter-fullstack/pull/2314)
  [`88207b1`](https://github.com/Urigo/accounter-fullstack/commit/88207b1f3fbafbd67b67fe8edca6a576d42e25bd)
  Thanks [@gilgardosh](https://github.com/gilgardosh)! - Initial package

### Patch Changes

- [#2321](https://github.com/Urigo/accounter-fullstack/pull/2321)
  [`9915dd2`](https://github.com/Urigo/accounter-fullstack/commit/9915dd2c0f7f78103320bc99dabd2de2384bbfbc)
  Thanks [@gilgardosh](https://github.com/gilgardosh)! - \* **New Integration Test Suite**: I've
  added a comprehensive integration test suite for validating the uniform format report generation
  process using real-world fixture files.
  - **Round-trip Validation**: I've implemented tests to perform a full round-trip: parsing existing
    `BKMVDATA.txt` and `ini.txt` fixtures, generating new reports from the parsed data, and then
    re-parsing the generated reports to ensure data integrity and consistency.
  - **Data Parsing and Generation Coverage**: The tests cover parsing and generation of various
    record types (A100, B100, B110, C100, D110, D120, M100, Z900 for `BKMVDATA.txt` and A000,
    A000Sum for `ini.txt`), ensuring broad coverage of the uniform format specification.
  - **Robustness Testing**: I've included tests for handling edge cases such as different line
    endings, whitespace, and gracefully skipping invalid or unknown record types during parsing,
    enhancing the robustness of the parsing logic.
  - **Monetary Precision Verification**: A test has been added to ensure that monetary values from
    B100 records are correctly parsed and can be part of the round-trip process, implying that
    precision is maintained throughout data transformation.

- [#2322](https://github.com/Urigo/accounter-fullstack/pull/2322)
  [`408b287`](https://github.com/Urigo/accounter-fullstack/commit/408b287588f1753776cd98755383fc269d7410fb)
  Thanks [@gilgardosh](https://github.com/gilgardosh)! - \* **New Client-Side Feature**: I've added
  a new modal component (`FileDownloadModal`) to the client application, allowing users to select a
  date range and trigger the generation and download of uniform format files (bkmvdata and ini)
  directly from the UI.
  - **Data Model Extension**: The `JournalEntry` and `BusinessMetadata` schemas have been extended
    to support additional optional fields, such as `batchNumber`, `transactionType`,
    `referenceDocument`, `currencyCode`, `foreignCurrencyAmount` for journal entries, and `address`
    details for business metadata. This enriches the data available for reporting.
  - **Uniform Format Generator Enhancement**: The `generateUniformFormatReport` function in the
    generator package has been updated to consume and incorporate these new extended fields from the
    `JournalEntry` and `BusinessMetadata` into the generated uniform format files, ensuring more
    comprehensive reports.
  - **Testing**: New unit tests have been added to verify that the uniform format generator
    correctly handles journal entries with the newly introduced extended fields, ensuring data
    integrity and proper report generation.