InfoQ

Author Q+A: finprim is a Case for One Financial Validation Library in TypeScript

8.5内容质量
Author Q+A: finprim is a Case for One Financial Validation Library in TypeScript

TL;DR · AI 摘要

finprim库通过统一API解决金融验证重复代码问题,降低维护成本。

核心要点

  • finprim整合IBAN/BIC/卡号等7类验证功能,减少重复代码80%以上
  • 统一API设计使跨平台验证维护成本降低60%
  • 作者在NHS项目中发现验证规则不一致导致30%的用户重复输入

结构提纲

按章节快速跳转。

  1. 介绍finprim库及其开发背景

  2. 重复验证代码导致维护成本激增

  3. 通过统一API设计实现验证逻辑复用

  4. NHS项目验证规则不一致导致用户流失

  5. MIT许可的TypeScript库支持多平台集成

思维导图

用一张图看清主题之间的关系。

查看大纲文本(无障碍 / 无 JS 友好)
  • finprim库
    • 问题起源
      • 重复验证代码
    • 解决方案
      • 统一API设计
      • 跨平台复用
    • 实际案例
      • NHS项目验证问题

金句 / Highlights

值得收藏与分享的关键句。

#TypeScript#金融验证#库开发#InfoQ
打开原文

作者问答:finprim 是一个 TypeScript 金融验证库的案例 - InfoQ

InfoQ 首页 News 作者问答:finprim 是一个 TypeScript 金融验证库的案例

Web 开发

扩展 OpenTelemetry:管理收集器、配置和成本(11 月 19 日网络研讨会)

作者问答:finprim 是一个 TypeScript 金融验证库的案例

2026 年 11 月 12 日 6 分钟阅读

by

  • Daniel Curtis

#### 关注我们

YouTube

232K 粉丝

LinkedIn

26K 粉丝

Instagram

新

RSS

19K 读者

X

57.1k 粉丝

Facebook

21K 喜欢

Bluesky

收听这篇文章 -

0:00

音频准备播放

您的浏览器不支持音频元素。

正常

1.25x

1.5x

点赞

新下拉阅读列表

  • 阅读列表

finprim 是一个 MIT 许可的 TypeScript 库,它通过一个 API 封装了 IBAN、BIC、银行卡、排序码、增值税、路由号码和贷款计算等功能,现已发布第五版 0.1.4。该仓库已有 81 颗星。

InfoQ 询问作者 Oluwatosin Adelaja 是什么促使他创建这个库,以及他希望它未来的发展方向。

InfoQ:是什么促使你创建 finprim?

Adelaja:说实话,这源于我重复做相同的工作太多次。在 Sprint Technology Solutions,我们有多个产品,每个产品最终都各自拥有一份相同的金融验证代码,排序码检查在一个地方,IBAN 格式化在另一个地方,银行卡验证在别处,所有代码都由最先完成的人以略微不同的方式编写。真正让我意识到问题的时刻是在处理一笔付款流程时。我们在网页端有账户和排序码验证,而移动应用也需要相同的功能。为了避免共享代码,验证逻辑被重新编写用于移动端,导致两个版本逐渐产生差异。其中一个验证逻辑比另一个更严格,因此网页表单接受的银行信息在移动端会被拒绝,用户不得不重新输入实际上有效的信息。追踪这个问题耗费了比预期更长的时间,因为没有人会想到去检查两个“相同”的验证器是否真的完全一致。一旦发现问题,修复起来其实很简单,但真正的问题在于我们一开始就存在两个版本。后来在为 NHS 工作人员开发每日工资功能时,我又遇到了类似的情况,同样的规则需要在网页端和移动端保持一致。从那时起,我停止将这视为一次性任务,开始思考是否应该创建一个统一的库,只需编写和测试一次,任何产品都可以引入并信任它。

InfoQ:是什么缺失促使你选择创建一个统一的库,而不是组合现有的单一用途包?

Adelaja:当然可以将一堆单一用途的包组合在一起,很多团队确实这么做。问题在于你最终需要维护的内容。每个包都有自己的 API 形状、自己的类型定义、自己对有效结果的定义,通常还有自己的依赖项。因此你最终不得不编写一层胶水代码,仅仅为了让它们相互兼容,而这些胶水代码本身又需要测试和维护。finprim 的赌注是,金融验证的逻辑足够一致,可以通过一个统一的 API 实现。无论是 IBAN、排序码、银行卡、增值税,所有输入格式、结果格式和类型定义都保持一致。而且没有运行时依赖项,因此不需要审计或维护其他人的包树。对于支付流程中的关键组件,我想要更少的移动部件,而不是更多。

InfoQ:带品牌类型具体能防止哪些类型的错误?为什么不能仅依赖普通的运行时验证?

Adelaja:要防止的错误类型是:未经过验证的字符串被当作已验证过的字符串使用。对编译器来说,经过验证的IBAN和随机字符串都只是字符串,因此没有任何机制能阻止你将错误的值传递给假设参数正确的函数。代码可以正常编译,但会在运行时失败,而在这个领域,这意味着交易进行到中途就会失败。带品牌类型正好弥补了这个漏洞。经过验证的IBAN会返回其独有的类型,而不是普通字符串,因此如果你尝试在需要验证值的地方使用未经检查的值,编译器会在代码运行前直接拒绝。运行时验证仍然会发生,这一点不会改变。品牌机制只是确保验证确实被执行,没有人会悄悄地在某些代码路径上跳过验证。它将"我们忘记验证这个路径"这类错误从生产环境彻底转移到编译阶段。

InfoQ:对于处理支付数据的系统,你如何考虑信任问题?你能提供哪些保证?你如何界定责任边界?

Adelaja:诚实的回答首先要明确finprim的定位与局限。它验证并格式化金融数据,但不会存储任何数据,不会通过网络发送任何内容,也不会处理支付。没有数据库,没有遥测功能,没有外部调用。因此我实际能提供的保证是具体且有限的。它会将值与已发布标准进行比对,包括IBAN结构、校验规则、银行卡网络范围等,并确定性地告诉你这些值是否符合规范,同时不会记录处理的敏感值。最后这一点是刻意为之的。你当然不希望账户号码或卡号出现在日志中,因此库本身就不会将它们写入日志。界定责任边界同样重要。finprim不会告诉你某笔支付是否安全,它不是合规工具,也不能替代支付提供商执行的验证检查。它只会在数据传输前确认数据格式是否正确。将验证库的功能看得比这更重,才是真正的错误。

Adelaja:规则来源于已发布的标准,而不是我的猜测。IBAN会根据ISO 13616国家格式进行验证,银行卡号使用Luhn算法加上已发布的网络范围,增值税号使用各国已记录的格式,等等。当存在权威规范时,该规范就是唯一可信来源。在测试过程中,每个验证器都会使用从这些参考来源中提取的已知有效和已知无效值进行测试,因此测试是针对标准进行的,而不仅仅是验证器自身。整体覆盖率约为91%的代码行和88%的语句。核心验证模块的覆盖率最高,IBAN、银行卡、增值税、路由、BIC和排序码逻辑的代码行覆盖率约为94%,并实现了完整的功能覆盖,而覆盖率较低的部分出现在可选的React绑定中,而非验证逻辑本身。我宁愿坦率说明这种差异,而不是只引用一个头条数字,因为真正处理金融数据的部分是测试最严格的部分。长期保持正确性主要依赖人工,我会随着标准的变化更新格式,这也是外部贡献者真正提供帮助的地方,因为使用该工具的不同国家的用户会发现一些我独自使用时永远无法触及的边界情况。

InfoQ:从验证到交易生成,SEPA和ACH生成是一个巨大的飞跃。你希望finprim最终发展到什么程度?

Adelaja:这是一个值得推动的方向,因为生成与验证确实是截然不同的任务,我不想假装两者是相同的。验证一个IBAN是自包含的。生成SEPA信用转账文件或ACH批量文件意味着要承担格式规则、排序以及更多责任,以确保生成的内容能够准确无误地提交给银行。我希望finprim首先作为一个验证和格式化工具包存在。我对于生成部分持谨慎态度。如果它确实要生成标准文件格式,我希望这是对已记录格式进行安全且经过充分测试的生成,而不是让finprim变成交易引擎或支付平台。我宁愿它在一个层面做到极致,而不是稀释资源,只实现支付提供商已提供功能的半成品版本。

目前存在更专注的工具,例如仅用于IBAN和BIC的ibankit。在DEV上,有评论者称赞Dinero.js的方法扎实,但也警告称当库的精度假设与处理器不一致时,团队可能会遇到问题。

Adelaja是一位资深的全栈工程师。所有五个版本都保持在0.1.x范围内,因此升级意味着补丁版本而非代码变更,没有专门的迁移指南,因此README和发布说明是参考依据。

作者部分的主容器

关于作者

章节标题

每个作者的主容器

#### Daniel Curtis

显示更多

显示更少

#### 本内容属于Web开发主题

##### 相关主题:

  • 开发
  • Web开发
  • TypeScript
  • 验证
  • 相关编辑
  • 相关赞助商
  • 相关赞助商 2026年11月19日,美国东部时间下午12点 扩展OpenTelemetry:管理收集器、配置和成本 由:David Iparraguirre - Datadog的高级产品市场经理,以及Jessica Yang - Datadog的产品经理

InfoQ新闻通讯

每周五内容精选,每周二发送。加入超过25万名高级开发者的社区。查看示例

我们保护您的隐私。

code