@ducatjs/money 0.1.0 → 0.2.1

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"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"}

package/dist/testing/jest.d.ts

@@ -0,0 +1,2 @@
+export * from './index.js';
+//# sourceMappingURL=jest.d.ts.map

package/dist/testing/jest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jest.d.ts","sourceRoot":"","sources":["../../src/testing/jest.ts"],"names":[],"mappings":"AASA,cAAc,YAAY,CAAC"}

package/dist/testing/jest.js

@@ -0,0 +1,15 @@
+/**
+ * `@ducatjs/money/testing/jest`: one import in a Jest setup file (`setupFilesAfterEnv`) installs
+ * the money matchers, value equality and the snapshot serializer on Jest's global `expect`. It
+ * needs no Jest package of its own. For the types, add `MoneyMatchers` to Jest's `Matchers` in a
+ * declaration file (see the README): augmenting Jest's global namespace from here would clash
+ * with Vitest's types in projects that have both.
+ */
+import { installMoneyMatchers } from './index.js';
+export * from './index.js';
+const globalExpect = globalThis.expect;
+if (globalExpect === undefined) {
+    throw new Error('@ducatjs/money/testing/jest needs Jest’s global expect; import it from a setup file, or call installMoneyMatchers(expect)');
+}
+installMoneyMatchers(globalExpect);
+//# sourceMappingURL=jest.js.map

package/dist/testing/jest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jest.js","sourceRoot":"","sources":["../../src/testing/jest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,oBAAoB,EAA6B,MAAM,YAAY,CAAC;AAE7E,cAAc,YAAY,CAAC;AAE3B,MAAM,YAAY,GAAI,UAAgD,CAAC,MAAM,CAAC;AAC9E,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;IAC/B,MAAM,IAAI,KAAK,CACb,2HAA2H,CAC5H,CAAC;AACJ,CAAC;AACD,oBAAoB,CAAC,YAAY,CAAC,CAAC"}

package/dist/testing/vitest.d.ts

@@ -0,0 +1,7 @@
+import { type MoneyMatchers } from './index.js';
+export * from './index.js';
+declare module 'vitest' {
+    interface Matchers<T = any> extends MoneyMatchers<T> {
+    }
+}
+//# sourceMappingURL=vitest.d.ts.map

package/dist/testing/vitest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.d.ts","sourceRoot":"","sources":["../../src/testing/vitest.ts"],"names":[],"mappings":"AAQA,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAEtE,cAAc,YAAY,CAAC;AAE3B,OAAO,QAAQ,QAAQ,CAAC;IAEtB,UAAU,QAAQ,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;KAAG;CACxD"}

package/dist/testing/vitest.js

@@ -0,0 +1,12 @@
+/**
+ * `@ducatjs/money/testing/vitest`: one import in a Vitest setup file installs the money matchers,
+ * value equality and the snapshot serializer, and types the matchers on `expect`:
+ *
+ *     // vitest.config.ts: test: { setupFiles: ['./test/setup.ts'] }
+ *     import '@ducatjs/money/testing/vitest';
+ */
+import { expect } from 'vitest';
+import { installMoneyMatchers } from './index.js';
+export * from './index.js';
+installMoneyMatchers(expect);
+//# sourceMappingURL=vitest.js.map

package/dist/testing/vitest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.js","sourceRoot":"","sources":["../../src/testing/vitest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,oBAAoB,EAAsB,MAAM,YAAY,CAAC;AAEtE,cAAc,YAAY,CAAC;AAO3B,oBAAoB,CAAC,MAAM,CAAC,CAAC"}

package/dist/valibot.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `@ducatjs/money/valibot`: Valibot schemas for the JSON form of Money, `{ "amount": "12.34",
+ * "currency": "EUR" }`, for API boundaries. Valibot is an optional peer dependency: only this entry
+ * imports it.
+ */
+import * as valibot from 'valibot';
+import { type MoneyJSON } from './money.js';
+import { type MoneyFor, type MoneySchemaOptions } from './schema.js';
+export type { MoneyFor, MoneySchemaOptions } from './schema.js';
+declare const jsonShape: valibot.ObjectSchema<{
+    readonly amount: valibot.StringSchema<undefined>;
+    readonly currency: valibot.StringSchema<undefined>;
+}, undefined>;
+/** The schema type both functions return: the JSON shape, then a transformation. */
+export type MoneySchema<TOutput> = valibot.SchemaWithPipe<readonly [typeof jsonShape, valibot.RawTransformAction<MoneyJSON, TOutput>]>;
+/**
+ * Parses `{ amount, currency }` into Money, accepting exactly what the Zod entry accepts (see its
+ * `moneySchema`): an exact decimal string with no more decimals than the scale and at most
+ * `maxDigits` digits, padded to the scale, and a listed or known currency. Problems are Valibot
+ * issues on `amount` or `currency`; other keys are dropped. Bad options throw when the schema is
+ * built. Valibot has no codecs, so encode with `money.toJSON()` (or `JSON.stringify`), which this
+ * schema reads back.
+ *
+ *     const Order = valibot.object({ total: moneySchema({ currency: 'EUR' }) })
+ *     v.parse(Order, { total: { amount: '12.34', currency: 'EUR' } }).total   // Money<'EUR'>
+ */
+export declare function moneySchema<C extends string = string>(options?: MoneySchemaOptions<C>): MoneySchema<MoneyFor<C>>;
+/**
+ * Like `moneySchema`, but the output stays the JSON object: it checks that the input would parse,
+ * for code that passes the JSON on rather than computing with it.
+ */
+export declare function moneyJSONSchema<C extends string = string>(options?: MoneySchemaOptions<C>): MoneySchema<MoneyJSON<C>>;
+//# sourceMappingURL=valibot.d.ts.map

package/dist/valibot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"valibot.d.ts","sourceRoot":"","sources":["../src/valibot.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAGL,KAAK,QAAQ,EAEb,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEhE,QAAA,MAAM,SAAS;;;aAA2E,CAAC;AAE3F,oFAAoF;AACpF,MAAM,MAAM,WAAW,CAAC,OAAO,IAAI,OAAO,CAAC,cAAc,CACvD,SAAS,CAAC,OAAO,SAAS,EAAE,OAAO,CAAC,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAC5E,CAAC;AAeF;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EACnD,OAAO,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC9B,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAc1B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EACvD,OAAO,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC9B,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAc3B"}

package/dist/valibot.js

@@ -0,0 +1,61 @@
+/**
+ * `@ducatjs/money/valibot`: Valibot schemas for the JSON form of Money, `{ "amount": "12.34",
+ * "currency": "EUR" }`, for API boundaries. Valibot is an optional peer dependency: only this entry
+ * imports it.
+ */
+import * as valibot from 'valibot';
+import { isMoney } from './money.js';
+import { checkSchemaOptions, readMoneyJSON, } from './schema.js';
+const jsonShape = valibot.object({ amount: valibot.string(), currency: valibot.string() });
+/** A Valibot issue path pointing at the field that is wrong. */
+function pathTo(json, issue) {
+    return [
+        {
+            type: 'object',
+            origin: 'value',
+            input: json,
+            key: issue.field,
+            value: json[issue.field],
+        },
+    ];
+}
+/**
+ * Parses `{ amount, currency }` into Money, accepting exactly what the Zod entry accepts (see its
+ * `moneySchema`): an exact decimal string with no more decimals than the scale and at most
+ * `maxDigits` digits, padded to the scale, and a listed or known currency. Problems are Valibot
+ * issues on `amount` or `currency`; other keys are dropped. Bad options throw when the schema is
+ * built. Valibot has no codecs, so encode with `money.toJSON()` (or `JSON.stringify`), which this
+ * schema reads back.
+ *
+ *     const Order = valibot.object({ total: moneySchema({ currency: 'EUR' }) })
+ *     v.parse(Order, { total: { amount: '12.34', currency: 'EUR' } }).total   // Money<'EUR'>
+ */
+export function moneySchema(options) {
+    checkSchemaOptions(options);
+    return valibot.pipe(jsonShape, valibot.rawTransform(({ dataset, addIssue, NEVER }) => {
+        const json = dataset.value;
+        const result = readMoneyJSON(json, options);
+        if (isMoney(result)) {
+            return result;
+        }
+        addIssue({ message: result.message, path: pathTo(json, result) });
+        return NEVER;
+    }));
+}
+/**
+ * Like `moneySchema`, but the output stays the JSON object: it checks that the input would parse,
+ * for code that passes the JSON on rather than computing with it.
+ */
+export function moneyJSONSchema(options) {
+    checkSchemaOptions(options);
+    return valibot.pipe(jsonShape, valibot.rawTransform(({ dataset, addIssue, NEVER }) => {
+        const json = dataset.value;
+        const result = readMoneyJSON(json, options);
+        if (isMoney(result)) {
+            return json;
+        }
+        addIssue({ message: result.message, path: pathTo(json, result) });
+        return NEVER;
+    }));
+}
+//# sourceMappingURL=valibot.js.map

package/dist/valibot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"valibot.js","sourceRoot":"","sources":["../src/valibot.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,OAAO,EAA8B,MAAM,YAAY,CAAC;AACjE,OAAO,EACL,kBAAkB,EAClB,aAAa,GAId,MAAM,aAAa,CAAC;AAIrB,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAO3F,gEAAgE;AAChE,SAAS,MAAM,CAAC,IAAe,EAAE,KAAiB;IAChD,OAAO;QACL;YACE,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,OAAO;YACf,KAAK,EAAE,IAA0C;YACjD,GAAG,EAAE,KAAK,CAAC,KAAK;YAChB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;SACzB;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CACzB,OAA+B;IAE/B,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,OAAO,CAAC,IAAI,CACjB,SAAS,EACT,OAAO,CAAC,YAAY,CAAyB,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;QAC5E,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5C,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACpB,OAAO,MAA8B,CAAC;QACxC,CAAC;QACD,QAAQ,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAClE,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CACH,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,OAA+B;IAE/B,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,OAAO,CAAC,IAAI,CACjB,SAAS,EACT,OAAO,CAAC,YAAY,CAA0B,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;QAC7E,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5C,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACpB,OAAO,IAAoB,CAAC;QAC9B,CAAC;QACD,QAAQ,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAClE,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/zod.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `@ducatjs/money/zod`: Zod schemas for the JSON form of Money, `{ "amount": "12.34", "currency":
+ * "EUR" }`, for API boundaries. Zod is an optional peer dependency: only this entry imports it.
+ */
+import { z } from 'zod';
+import { type MoneyJSON } from './money.js';
+import { type MoneyFor, type MoneySchemaOptions } from './schema.js';
+export type { MoneyFor, MoneySchemaOptions } from './schema.js';
+declare const jsonShape: z.ZodObject<{
+    amount: z.ZodString;
+    currency: z.ZodString;
+}, z.core.$strip>;
+/** The schema `moneySchema` returns: a Zod codec between the JSON form and Money. */
+export type MoneyCodec<C extends string> = z.ZodCodec<typeof jsonShape, z.ZodCustom<MoneyFor<C>>>;
+/**
+ * Parses `{ amount, currency }` into Money, and encodes Money back to that JSON form. It is a Zod
+ * codec, so `schema.parse(json)` (or `z.decode`) gives Money and `z.encode(schema, money)` gives
+ * `{ amount, currency }`, written at the amount's own scale.
+ *
+ * The amount must be an exact decimal string with no more decimals than the scale (the
+ * currency's exponent unless `scale` is given; `rounding` allows more), and at most `maxDigits`
+ * digits. The currency must be one of `currency`, or any known code. Shorter amounts are padded to
+ * the scale ("1.5" EUR gives 1.50 EUR). Problems are Zod issues on `amount` or `currency`; keys
+ * other than those two are dropped. Bad options throw when the schema is built.
+ *
+ *     const Order = z.object({ total: moneySchema({ currency: 'EUR' }) })
+ *     Order.parse({ total: { amount: '12.34', currency: 'EUR' } }).total   // Money<'EUR'>
+ */
+export declare function moneySchema<C extends string = string>(options?: MoneySchemaOptions<C>): MoneyCodec<C>;
+/**
+ * Like `moneySchema`, but the output stays the JSON object (with only `amount` and `currency`): it
+ * checks that the input would parse, for code that passes the JSON on rather than computing with
+ * it.
+ */
+export declare function moneyJSONSchema<C extends string = string>(options?: MoneySchemaOptions<C>): z.ZodType<MoneyJSON<C>, MoneyJSON>;
+//# sourceMappingURL=zod.d.ts.map

package/dist/zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../src/zod.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEhE,QAAA,MAAM,SAAS;;;iBAAyD,CAAC;AAEzE,qFAAqF;AACrF,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAElG;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EACnD,OAAO,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC9B,UAAU,CAAC,CAAC,CAAC,CAsBf;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EACvD,OAAO,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC9B,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAUpC"}

package/dist/zod.js

@@ -0,0 +1,58 @@
+/**
+ * `@ducatjs/money/zod`: Zod schemas for the JSON form of Money, `{ "amount": "12.34", "currency":
+ * "EUR" }`, for API boundaries. Zod is an optional peer dependency: only this entry imports it.
+ */
+import { z } from 'zod';
+import { isMoney } from './money.js';
+import { checkSchemaOptions, readMoneyJSON, } from './schema.js';
+const jsonShape = z.object({ amount: z.string(), currency: z.string() });
+/**
+ * Parses `{ amount, currency }` into Money, and encodes Money back to that JSON form. It is a Zod
+ * codec, so `schema.parse(json)` (or `z.decode`) gives Money and `z.encode(schema, money)` gives
+ * `{ amount, currency }`, written at the amount's own scale.
+ *
+ * The amount must be an exact decimal string with no more decimals than the scale (the
+ * currency's exponent unless `scale` is given; `rounding` allows more), and at most `maxDigits`
+ * digits. The currency must be one of `currency`, or any known code. Shorter amounts are padded to
+ * the scale ("1.5" EUR gives 1.50 EUR). Problems are Zod issues on `amount` or `currency`; keys
+ * other than those two are dropped. Bad options throw when the schema is built.
+ *
+ *     const Order = z.object({ total: moneySchema({ currency: 'EUR' }) })
+ *     Order.parse({ total: { amount: '12.34', currency: 'EUR' } }).total   // Money<'EUR'>
+ */
+export function moneySchema(options) {
+    checkSchemaOptions(options);
+    return z.codec(jsonShape, z.custom((value) => isMoney(value)), {
+        decode: (json, payload) => {
+            const result = readMoneyJSON(json, options);
+            if (isMoney(result)) {
+                return result;
+            }
+            payload.issues.push({
+                code: 'custom',
+                message: result.message,
+                input: json,
+                path: [result.field],
+            });
+            return z.NEVER;
+        },
+        encode: (value) => value.toJSON(),
+    });
+}
+/**
+ * Like `moneySchema`, but the output stays the JSON object (with only `amount` and `currency`): it
+ * checks that the input would parse, for code that passes the JSON on rather than computing with
+ * it.
+ */
+export function moneyJSONSchema(options) {
+    checkSchemaOptions(options);
+    return jsonShape.transform((json, context) => {
+        const result = readMoneyJSON(json, options);
+        if (isMoney(result)) {
+            return json;
+        }
+        context.addIssue({ code: 'custom', message: result.message, path: [result.field] });
+        return z.NEVER;
+    });
+}
+//# sourceMappingURL=zod.js.map

package/dist/zod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.js","sourceRoot":"","sources":["../src/zod.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAA8B,MAAM,YAAY,CAAC;AACjE,OAAO,EACL,kBAAkB,EAClB,aAAa,GAGd,MAAM,aAAa,CAAC;AAIrB,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAKzE;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,WAAW,CACzB,OAA+B;IAE/B,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,CAAC,CAAC,KAAK,CACZ,SAAS,EACT,CAAC,CAAC,MAAM,CAAc,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAChD;QACE,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;YACxB,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC5C,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpB,OAAO,MAA8B,CAAC;YACxC,CAAC;YACD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;gBAClB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,KAAK,EAAE,IAAI;gBACX,IAAI,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;aACrB,CAAC,CAAC;YACH,OAAO,CAAC,CAAC,KAAK,CAAC;QACjB,CAAC;QACD,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAE,KAAe,CAAC,MAAM,EAAE;KAC7C,CACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,OAA+B;IAE/B,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,SAAS,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;QAC3C,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5C,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACpB,OAAO,IAAoB,CAAC;QAC9B,CAAC;QACD,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACpF,OAAO,CAAC,CAAC,KAAK,CAAC;IACjB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ducatjs/money",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Exact, fast, typed Money for TypeScript: integer minor units, bigint fallback, Stripe/Adyen views, allocation, cash rounding, Prisma helpers.",
   "homepage": "https://github.com/public/ducat#readme",
   "bugs": {
@@ -23,7 +23,11 @@
   "type": "module",
   "sideEffects": [
     "./dist/plugins/*.js",
-    "./src/plugins/*.ts"
+    "./src/plugins/*.ts",
+    "./dist/testing/vitest.js",
+    "./dist/testing/jest.js",
+    "./src/testing/vitest.ts",
+    "./src/testing/jest.ts"
   ],
   "exports": {
     ".": {
@@ -50,6 +54,30 @@
       "types": "./dist/ecb.d.ts",
       "default": "./dist/ecb.js"
     },
+    "./convert/history": {
+      "types": "./dist/history.d.ts",
+      "default": "./dist/history.js"
+    },
+    "./convert/boc": {
+      "types": "./dist/boc.d.ts",
+      "default": "./dist/boc.js"
+    },
+    "./convert/fed": {
+      "types": "./dist/fed.d.ts",
+      "default": "./dist/fed.js"
+    },
+    "./historic": {
+      "types": "./dist/historic.d.ts",
+      "default": "./dist/historic.js"
+    },
+    "./convert/boe": {
+      "types": "./dist/boe.d.ts",
+      "default": "./dist/boe.js"
+    },
+    "./convert/hmrc": {
+      "types": "./dist/hmrc.d.ts",
+      "default": "./dist/hmrc.js"
+    },
     "./convert/fetch": {
       "types": "./dist/fetch.d.ts",
       "default": "./dist/fetch.js"
@@ -58,6 +86,10 @@
       "types": "./dist/plugins/exact.d.ts",
       "default": "./dist/plugins/exact.js"
     },
+    "./policy": {
+      "types": "./dist/policy.d.ts",
+      "default": "./dist/policy.js"
+    },
     "./cash": {
       "types": "./dist/plugins/cash.d.ts",
       "default": "./dist/plugins/cash.js"
@@ -110,6 +142,50 @@
       "types": "./dist/plugins/prisma.d.ts",
       "default": "./dist/plugins/prisma.js"
     },
+    "./drizzle/pg": {
+      "types": "./dist/drizzle/pg.d.ts",
+      "default": "./dist/drizzle/pg.js"
+    },
+    "./drizzle/mysql": {
+      "types": "./dist/drizzle/mysql.d.ts",
+      "default": "./dist/drizzle/mysql.js"
+    },
+    "./drizzle/sqlite": {
+      "types": "./dist/drizzle/sqlite.d.ts",
+      "default": "./dist/drizzle/sqlite.js"
+    },
+    "./zod": {
+      "types": "./dist/zod.d.ts",
+      "default": "./dist/zod.js"
+    },
+    "./valibot": {
+      "types": "./dist/valibot.d.ts",
+      "default": "./dist/valibot.js"
+    },
+    "./pg": {
+      "types": "./dist/pg.d.ts",
+      "default": "./dist/pg.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "default": "./dist/testing/index.js"
+    },
+    "./testing/vitest": {
+      "types": "./dist/testing/vitest.d.ts",
+      "default": "./dist/testing/vitest.js"
+    },
+    "./testing/jest": {
+      "types": "./dist/testing/jest.d.ts",
+      "default": "./dist/testing/jest.js"
+    },
+    "./testing/arbitraries": {
+      "types": "./dist/testing/arbitraries.d.ts",
+      "default": "./dist/testing/arbitraries.js"
+    },
+    "./kysely": {
+      "types": "./dist/kysely.d.ts",
+      "default": "./dist/kysely.js"
+    },
     "./all": {
       "types": "./dist/plugins/all.d.ts",
       "default": "./dist/plugins/all.js"
@@ -117,8 +193,8 @@
     "./package.json": "./package.json"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.test.json && tsc -p test/core-only/tsconfig.json && tsc -p test/browser/tsconfig.json",
+    "build": "tsc -p tsconfig.json && tsc -p tsconfig.drizzle.json && tsc -p tsconfig.kysely.json && tsc -p tsconfig.peers.json",
+    "typecheck": "tsc -p tsconfig.test.json && tsc -p tsconfig.test-drizzle.json && tsc -p test/core-only/tsconfig.json && tsc -p test/browser/tsconfig.json && tsc -p test/jest-types/tsconfig.json",
     "test": "vitest run",
     "test:deep": "DUCAT_DEEP=1 vitest run",
     "compare": "pnpm --dir compare battery && pnpm --dir compare tables",
@@ -149,22 +225,57 @@
     "@prisma/client": "^6.19.3",
     "@stryker-mutator/core": "10.1.1",
     "@stryker-mutator/vitest-runner": "10.1.1",
+    "@types/better-sqlite3": "9.6.0",
     "@types/big.js": "^7.0.0",
     "@types/node": "^26.6.6",
     "@types/pg": "8.23.1",
+    "better-sqlite3": "13.0.3",
     "big.js": "^7.0.1",
     "currency.js": "^2.0.4",
     "decimal.js": "^10.6.0",
     "dinero.js": "^2.0.2",
+    "drizzle-orm": "0.45.4",
     "esbuild": "^0.28.2",
     "fast-check": "^4.10.2",
+    "kysely": "0.29.8",
     "mysql2": "3.24.6",
     "oxfmt": "0.77.0",
     "oxlint": "1.92.0",
     "pg": "8.23.1",
+    "pg-cursor": "2.22.1",
     "ts-money": "^0.4.8",
     "typescript": "^5.9.3",
-    "vitest": "^4.1.12"
+    "valibot": "1.5.0",
+    "vitest": "^4.1.12",
+    "zod": "4.6.7"
+  },
+  "peerDependencies": {
+    "drizzle-orm": ">=0.45.0 <1",
+    "fast-check": "^4.0.0",
+    "kysely": ">=0.28.0 <1",
+    "valibot": "^1.0.0",
+    "vitest": ">=3.2.0 <5",
+    "zod": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "drizzle-orm": {
+      "optional": true
+    },
+    "fast-check": {
+      "optional": true
+    },
+    "kysely": {
+      "optional": true
+    },
+    "valibot": {
+      "optional": true
+    },
+    "vitest": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
   },
   "engines": {
     "node": ">=24"

package/src/adyen-fx.ts

@@ -55,9 +55,20 @@ function offsetMinutes(zone: string): number | undefined {
   return numeric[1] === '-' ? -total : total;
 }
 
-/** The offset of an IANA time zone at a UTC instant, in minutes. */
-function ianaOffsetMinutes(timeZone: string, utcMs: number): number {
-  const parts = new Intl.DateTimeFormat('en-US', {
+// Building an Intl.DateTimeFormat is far slower than using one, and a report has thousands of rows
+// in one zone, so keep one formatter per zone. The bound stops a stream of distinct zone names
+// (case variants are accepted by Intl) from growing the cache without limit.
+const MAX_CACHED_FORMATTERS = 32;
+const formatters = new Map<string, Intl.DateTimeFormat>();
+
+/** The cached wall-clock formatter for an IANA time zone. */
+function wallClockFormatter(timeZone: string): Intl.DateTimeFormat {
+  let formatter = formatters.get(timeZone);
+  if (formatter !== undefined) {
+    return formatter;
+  }
+
+  formatter = new Intl.DateTimeFormat('en-US', {
     timeZone,
     hourCycle: 'h23',
     year: 'numeric',
@@ -66,7 +77,17 @@ function ianaOffsetMinutes(timeZone: string, utcMs: number): number {
     hour: 'numeric',
     minute: 'numeric',
     second: 'numeric',
-  }).formatToParts(new Date(utcMs));
+  });
+  if (formatters.size >= MAX_CACHED_FORMATTERS) {
+    formatters.clear();
+  }
+  formatters.set(timeZone, formatter);
+  return formatter;
+}
+
+/** The offset of an IANA time zone at a UTC instant, in minutes. */
+function ianaOffsetMinutes(timeZone: string, utcMs: number): number {
+  const parts = wallClockFormatter(timeZone).formatToParts(new Date(utcMs));
   const field = (type: string): number => Number(parts.find((part) => part.type === type)!.value);
   const wallClockAsUtc = Date.UTC(
     field('year'),

package/src/boc.ts

@@ -0,0 +1,136 @@
+// `@ducatjs/money/convert/boc`: an offline parser for the Bank of Canada's daily exchange rates
+// (the Valet API). No I/O: fetch the JSON yourself, or use fetchBankOfCanada from
+// @ducatjs/money/convert/fetch. Rates are kept exactly as published.
+import { quotedTable } from './history.js';
+import type { RateTable } from './provider.js';
+import { addDayRate, isCalendarDay, newestFirst, readRateCell } from './rate-text.js';
+
+const SERIES = /^FX([A-Z]{3})CAD$/;
+const ZERO = /^0+(?:\.0+)?$/;
+
+// The Bank publishes "once each business day by 16:30 (ET)". One formatter for the zone, built on
+// first use, gives the Toronto offset on any day, summer time included.
+let torontoFormatter: Intl.DateTimeFormat | undefined;
+
+/** 16:30 in Toronto on `day`, as a UTC instant. */
+function publishedBy(day: string): string {
+  torontoFormatter ??= new Intl.DateTimeFormat('en-US', {
+    timeZone: 'America/Toronto',
+    timeZoneName: 'shortOffset',
+  });
+  // Noon UTC is 07:00 or 08:00 in Toronto, after any clock change that day (they happen at 02:00).
+  const noon = new Date(`${day}T12:00:00Z`);
+  const zone = torontoFormatter.formatToParts(noon).find((part) => part.type === 'timeZoneName');
+  const offset = /^GMT([+-]\d+)$/.exec(zone?.value ?? '');
+  if (offset === null) {
+    throw new RangeError(`Can't tell Toronto's UTC offset on ${day} (${zone?.value})`);
+  }
+  const utcMs = Date.parse(`${day}T16:30:00Z`) - Number(offset[1]) * 3_600_000;
+  return new Date(utcMs).toISOString();
+}
+
+function notValet(why: string): never {
+  throw new SyntaxError(`Not a Bank of Canada Valet daily FX file: ${why}`);
+}
+
+/** Options for parseBankOfCanadaJson. */
+export interface BankOfCanadaOptions {
+  /**
+   * When each day's rates were published, or false for none. Default: 16:30 Toronto time that day,
+   * when the Bank says it publishes them.
+   */
+  readonly availableAt?: false | ((day: string) => string | Date);
+}
+
+/**
+ * Parses the Bank of Canada's daily exchange rates from the Valet API's JSON (the
+ * `FX_RATES_DAILY` group, or single `FX…CAD` series) into one CAD-based table per business day,
+ * newest first. The Bank quotes CAD per unit of each currency (FXUSDCAD 1.3748), so each table
+ * holds the exact inverse, CAD → currency, and keeps the published quote: `rate.inverse()` prints
+ * '1.3748' again. Rates have `source: 'BoC'`, `type: 'average'` (an average of a day's quotes, not
+ * a market rate) and `availableAt` 16:30 Toronto time, when the Bank says it publishes them (a late
+ * rate can come later; pass `availableAt` to change it). Valet leaves a series out of a day
+ * without a value, so a series listed in `seriesDetail` but absent on a day, an empty value or a
+ * null one, is in that day's `missing`. Anything but daily `FX…CAD` series (monthly or annual
+ * groups, other data) throws SyntaxError, as do two different values for one series on one day.
+ *
+ * Precision: the Bank quotes four decimals, up to six for small rates, so a small rate has only
+ * about four significant digits (JPY 0.008760, KRW 0.000929, and IDR 0.000082 with two). Its
+ * inverse is exact, but only as precise as that. For such currencies, prefer a source that quotes
+ * them the other way round.
+ *
+ *     const tables = parseBankOfCanadaJson(await (await fetch(url)).text());
+ *     tables[0].rate('CAD', 'USD')?.inverse().toString(); // '1.3748'
+ */
+export function parseBankOfCanadaJson(json: string, options?: BankOfCanadaOptions): RateTable[] {
+  const parsed = JSON.parse(json) as {
+    observations?: unknown;
+    seriesDetail?: Record<string, unknown>;
+  } | null;
+  const observations = parsed?.observations;
+  if (!Array.isArray(observations)) {
+    notValet('no observations');
+  }
+
+  // The series the file says it has; each must be a daily FX…CAD series.
+  const expected = new Set<string>();
+  for (const series of Object.keys(parsed?.seriesDetail ?? {})) {
+    if (!SERIES.test(series)) {
+      notValet(`series ${series} isn't a daily FX…CAD rate`);
+    }
+    expected.add(series);
+  }
+
+  const days = new Map<string, Record<string, string | null>>();
+  for (const observation of observations as readonly Record<string, unknown>[]) {
+    const day = observation?.['d'];
+    if (typeof day !== 'string' || !isCalendarDay(day)) {
+      notValet(`bad date ${JSON.stringify(day)}`);
+    }
+
+    for (const [series, cell] of Object.entries(observation)) {
+      if (series === 'd') {
+        continue;
+      }
+      const currency = SERIES.exec(series)?.[1];
+      if (currency === undefined) {
+        notValet(`series ${series} isn't a daily FX…CAD rate`);
+      }
+      const where = `${series} on ${day}`;
+      const value = (cell as { v?: unknown } | null)?.v;
+      if (value !== null && typeof value !== 'string') {
+        throw new SyntaxError(`Malformed Valet value for ${where}`);
+      }
+      const rate = value === null ? null : readRateCell(value, where);
+      if (rate !== null && ZERO.test(rate)) {
+        throw new SyntaxError(`A zero rate for ${where}`);
+      }
+      addDayRate(days, day, currency, rate);
+    }
+    // Valet leaves out a series without a value that day.
+    for (const series of expected) {
+      const currency = SERIES.exec(series)![1]!;
+      if (days.get(day)?.[currency] === undefined) {
+        addDayRate(days, day, currency, null);
+      }
+    }
+  }
+
+  const tables: RateTable[] = [];
+  for (const [day, rates] of days) {
+    if (!Object.values(rates).some((rate) => rate !== null)) {
+      continue;
+    }
+    let availableAt: string | Date | undefined;
+    if (options?.availableAt === undefined) {
+      availableAt = publishedBy(day);
+    } else if (options.availableAt !== false) {
+      availableAt = options.availableAt(day);
+    }
+    const info = { base: 'CAD', inverted: true, source: 'BoC', type: 'average', asOf: day };
+    tables.push(
+      quotedTable({ ...info, ...(availableAt === undefined ? {} : { availableAt }), rates }),
+    );
+  }
+  return newestFirst(tables);
+}