@butinapp/sdk 0.1.1 → 0.1.2

package/dist/util/date.d.ts

@@ -9,6 +9,7 @@ export declare const dayOf: (value?: string | null) => string | undefined;
 export declare const monthKey: (year: number, month: number) => string;
 export declare const currentMonthKey: (now?: Date) => string;
 export declare const dayMinus: (day: string, days: number) => string;
+export declare const monthMinus: (day: string, months: number) => string;
 export declare const utcDaysAgo: (days: number) => string;
 export declare const isoDaysAgo: (days: number, now?: Date) => string;
 export declare const monthStart: (now?: Date) => string;

package/dist/util/date.js

@@ -41,6 +41,11 @@ export const currentMonthKey = (now = new Date()) => DateTime.fromJSDate(now, {
 // 'YYYY-MM-DD' for `days` before `day` (a UTC 'YYYY-MM-DD'). Day-string arithmetic goes through luxon, so callers
 // never re-roll millisecond math; invalid input returns `day` unchanged.
 export const dayMinus = (day, days) => DateTime.fromISO(day, { zone: 'utc' }).minus({ days }).toISODate() ?? day;
+// 'YYYY-MM-DD' for `months` calendar months before `day`. Luxon handles month-length edges (Mar 31 − 1 → Feb 28).
+// Bucketing arithmetic on a day string, so the reporting zone doesn't apply; invalid input returns `day` unchanged.
+// The go-to for arrears billing: an invoice issued in month M covers M − 1, so `monthMinus(issueDay, 1)` books it
+// into the month it actually covers regardless of which day of M it was issued.
+export const monthMinus = (day, months) => DateTime.fromISO(day, { zone: 'utc' }).minus({ months }).toISODate() ?? day;
 // UTC 'YYYY-MM-DD' for N days before now.
 export const utcDaysAgo = (days) => new Date(Date.now() - days * MS_PER_DAY).toISOString().slice(0, 10);
 // Full UTC ISO datetime N days before `now` — the start of a since-window passed to usage/event APIs.

package/dist/util/index.d.ts

@@ -1,5 +1,5 @@
 export { centsToMajor, centsStringToMajor, millicentsToMajor, parseDecimalAmount, round2, parseFrAmount } from './money.js';
-export { isoDay, dayOf, epochMsDay, epochSecDay, monthKey, currentMonthKey, dayMinus, utcDaysAgo, isoDaysAgo, monthStart, getReportingZone, setReportingZone, MS_PER_DAY, MONTH_ABBR } from './date.js';
+export { isoDay, dayOf, epochMsDay, epochSecDay, monthKey, currentMonthKey, dayMinus, monthMinus, utcDaysAgo, isoDaysAgo, monthStart, getReportingZone, setReportingZone, MS_PER_DAY, MONTH_ABBR } from './date.js';
 export { startCase, parseDollarAmount } from './text.js';
 export { convert } from './fx.js';
 export type { FxRates } from './fx.js';

package/dist/util/index.js

@@ -3,7 +3,7 @@
 // their leaf names already read clearly, and a namespace prefix would shadow common locals (`date`, `fx`).
 // (Generic third-party utilities — lodash + luxon — live on @butinapp/sdk/libs.)
 export { centsToMajor, centsStringToMajor, millicentsToMajor, parseDecimalAmount, round2, parseFrAmount } from './money.js';
-export { isoDay, dayOf, epochMsDay, epochSecDay, monthKey, currentMonthKey, dayMinus, utcDaysAgo, isoDaysAgo, monthStart, getReportingZone, setReportingZone, MS_PER_DAY, MONTH_ABBR } from './date.js';
+export { isoDay, dayOf, epochMsDay, epochSecDay, monthKey, currentMonthKey, dayMinus, monthMinus, utcDaysAgo, isoDaysAgo, monthStart, getReportingZone, setReportingZone, MS_PER_DAY, MONTH_ABBR } from './date.js';
 export { startCase, parseDollarAmount } from './text.js';
 export { convert } from './fx.js';
 export { omitUndef, asArray } from './object.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@butinapp/sdk",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "The Butin plugin-authoring contract: descriptor types, the data-view result contract, presets, and edge utilities.",
   "homepage": "https://butin.app",
   "bugs": "https://github.com/butinapp/butin/issues",