Skip to content

fix(sv/nit): align check digit logic with Python reference implementa…#155

Open
menyinch wants to merge 3 commits into
koblas:mainfrom
menyinch:patch-1
Open

fix(sv/nit): align check digit logic with Python reference implementa…#155
menyinch wants to merge 3 commits into
koblas:mainfrom
menyinch:patch-1

Conversation

@menyinch
Copy link
Copy Markdown

@menyinch menyinch commented May 13, 2026

The TypeScript NIT validator diverged from the upstream python-stdnum implementation in two places, causing valid NITs to be rejected.

  1. Old-vs-new NIT branch selection

    The condition used strict equality against the sequential block:

    value.substr(10, 3) === '100'
    

    The Python reference uses a lexicographic comparison:

    number[10:13] <= '100'
    

    As a result, any "old" NIT whose sequential block was below '100' (i.e. '000'–'099') was being validated with the new-NIT formula and incorrectly flagged as InvalidChecksum. Changed to <= '100' to match.

  2. New-NIT check digit edge case

    The formula was:

    (11 - weightedSum(...)) % 10
    

    The Python equivalent is:

    (-total % 11) % 10
    

    which, expanded, is ((11 - total % 11) % 11) % 10. The outer % 11 matters: when the weighted sum is divisible by 11, Python returns 0 while the TS version returned 1, rejecting otherwise-valid numbers. Added the missing % 11 step.

No changes to weights, length/format/component checks, or the SV-prefix handling. Verified against the docstring fixture 0614-050707-104-8.

…tion

The TypeScript NIT validator diverged from the upstream python-stdnum
implementation in two places, causing valid NITs to be rejected.

1. Old-vs-new NIT branch selection

   The condition used strict equality against the sequential block:

       value.substr(10, 3) === '100'

   The Python reference uses a lexicographic comparison:

       number[10:13] <= '100'

   As a result, any "old" NIT whose sequential block was below '100'
   (i.e. '000'–'099') was being validated with the new-NIT formula and
   incorrectly flagged as InvalidChecksum. Changed to `<= '100'` to
   match.

2. New-NIT check digit edge case

   The formula was:

       (11 - weightedSum(...)) % 10

   The Python equivalent is:

       (-total % 11) % 10

   which, expanded, is `((11 - total % 11) % 11) % 10`. The outer `% 11`
   matters: when the weighted sum is divisible by 11, Python returns 0
   while the TS version returned 1, rejecting otherwise-valid numbers.
   Added the missing `% 11` step.

No changes to weights, length/format/component checks, or the SV-prefix
handling. Verified against the docstring fixture `0614-050707-104-8`.
@gemini-code-assist
Copy link
Copy Markdown

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request addresses discrepancies between the TypeScript NIT validator and the upstream python-stdnum reference implementation. By correcting the branch selection logic and the checksum calculation formula, the changes ensure that valid NITs are no longer incorrectly rejected.

Highlights

  • Branch selection logic: Updated the sequential block comparison from strict equality to lexicographical comparison (<= '100') to correctly handle older NIT formats.
  • Checksum calculation: Adjusted the new-NIT check digit formula to include an intermediate modulo 11 operation, ensuring parity with the Python reference implementation.
New Features

🧠 You can now enable Memory (public preview) to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize the Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counterproductive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the NIT validation logic in src/sv/nit.ts by expanding the condition for the first sum calculation and refining the check digit calculation with an additional modulo operation. Feedback suggests replacing the deprecated substr() method with slice() for better standards compliance and correcting minor spacing inconsistencies in the mathematical expressions.

Comment thread src/sv/nit.ts Outdated
Comment thread src/sv/nit.ts
menyinch and others added 2 commits May 13, 2026 14:53
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant