@pax2pay/model-banking 0.1.465 → 0.1.466

package/dist/reports/visa/rows.js

@@ -0,0 +1,155 @@
+import { isly } from "isly";
+export var rows;
+(function (rows) {
+    rows.all = [
+        "On-Us Payments Count - Month x",
+        "On-Us Payments Volume - Month x",
+        "On-Us Account Funding Transaction Count - Month x",
+        "On-Us Account Funding Transaction Volume - Month x",
+        "On-Us Original Credits Count - Month x",
+        "On-Us Original Credits Volume - Month x",
+        "On-Us ATM Cash Advances Count - Month x",
+        "On-Us ATM Cash Advances Volume - Month x",
+        "On-Us Manual Cash Count - Month x",
+        "On-Us Manual Cash Volume - Month x",
+        "On-Us Cashback Count - Month x",
+        "On-Us Cashback Volume - Month x",
+        "National Payments Count - Month x",
+        "National Payments Volume - Month x",
+        "National Account Funding Transaction Count - Month x",
+        "National Account Funding Transaction Volume - Month x",
+        "National Original Credits Count - Month x",
+        "National Original Credits Volume - Month x",
+        "National ATM Cash Advances Count - Month x",
+        "National ATM Cash Advances Volume - Month x",
+        "National Manual Cash Count - Month x",
+        "National Manual Cash Volume - Month x",
+        "National Cashback Count - Month x",
+        "National Cashback Volume - Month x",
+        "International - Intra-Regional Payments Count - Month x",
+        "International - Intra-Regional Payments Volume - Month x",
+        "International - Intra-Regional Account Funding Transaction Count - Month x",
+        "International - Intra-Regional Account Funding Transaction Volume - Month x",
+        "International - Intra-Regional Original Credits Count - Month x",
+        "International - Intra-Regional Original Credits Volume - Month x",
+        "International - Intra-Regional ATM Cash Advances Count - Month x",
+        "International - Intra-Regional ATM Cash Advances Volume - Month x",
+        "International - Intra-Regional Manual Cash Count - Month x",
+        "International - Intra-Regional Manual Cash Volume - Month x",
+        "International - Intra-Regional Cashback Count - Month x",
+        "International - Intra-Regional Cashback Volume - Month x",
+        "International - Non-EEA Payments Count - Month x",
+        "International - Non-EEA Payments Volume - Month x",
+        "International - Non-EEA Account Funding Transaction Count - Month x",
+        "International - Non-EEA Account Funding Transaction Volume - Month x",
+        "International - Non-EEA Original Credits Count - Month x",
+        "International - Non-EEA Original Credits Volume - Month x",
+        "International - Non-EEA ATM Cash Advances Count - Month x",
+        "International - Non-EEA ATM Cash Advances Volume - Month x",
+        "International - Non-EEA Manual Cash Count - Month x",
+        "International - Non-EEA Manual Cash Volume - Month x",
+        "International - Non-EEA Cashback Count - Month x",
+        "International - Non-EEA Cashback Volume - Month x",
+        "International - Inter-Regional Payments Count - Month x",
+        "International - Inter-Regional Payments Volume - Month x",
+        "International - Inter-Regional Account Funding Transaction Count - Month x",
+        "International - Inter-Regional Account Funding Transaction Volume - Month x",
+        "International - Inter-Regional Original Credits Count - Month x",
+        "International - Inter-Regional Original Credits Volume - Month x",
+        "International - Inter-Regional ATM Cash Advances Count - Month x",
+        "International - Inter-Regional ATM Cash Advances Volume - Month x",
+        "International - Inter-Regional Manual Cash Count - Month x",
+        "International - Inter-Regional Manual Cash Volume - Month x",
+        "International - Inter-Regional Cashback Count - Month x",
+        "International - Inter-Regional Cashback Volume - Month x",
+        "Total Number of Cards",
+        "Number of Cards - Magnetic Stripe",
+        "Number of Cards - Magnetic Stripe, Chip",
+        "Number of Cards - Magnetic Stripe, Contactless",
+        "Number of Cards - Magnetic Stripe, Chip, Contactless",
+        "Total Number of Active Cards",
+        "Number of Active Cards - used at Contactless device",
+        "Number of Devices with Visa Contactless - Micro Tags",
+        "Number of Devices with Visa Contactless - Mobile Phones",
+        "Number of Devices with Visa Contactless - Other Devices",
+        "Total Number of Accounts",
+        "Number of Accounts - Domestic Use Only",
+        "Number of Accounts - International Enabled",
+        "Total Number of Active Accounts",
+        "Total Number of Personal Deposit Accounts",
+        "Number of Savings Accounts",
+        "Number of Regular Checking Accounts",
+        "Fraud Recoveries - Domestic - Cash Disbursements - Amount",
+        "Fraud Recoveries - Domestic - Payments - Amount",
+        "Fraud Recoveries - International - Cash Disbursements - Amount",
+        "Fraud Recoveries - International - Payments - Amount",
+        "Gross Fraud Losses - Number of Accounts",
+        "Gross Fraud Losses - Number of Recovered Accounts",
+        "Gross Fraud Losses - Domestic - Cash Disbursements - Count",
+        "Gross Fraud Losses - Domestic - Cash Disbursements - Volume",
+        "Gross Fraud Losses - Domestic - Payments - Count",
+        "Gross Fraud Losses - Domestic - Payments - Volume",
+        "Gross Fraud Losses - International - Cash Disbursements - Count",
+        "Gross Fraud Losses - International - Cash Disbursements - Volume",
+        "Gross Fraud Losses - International - Payments - Count",
+        "Gross Fraud Losses - International - Payments - Volume",
+        "Total Product Balance - Volume",
+        "Payments Transactions Declined for Insufficient Funds - Number",
+        "Cash Transactions Declined for Insufficient Funds - Number",
+    ];
+    let NonZero;
+    (function (NonZero) {
+        NonZero.values = [
+            "National Payments Count - Month x",
+            "National Payments Volume - Month x",
+            "International - Intra-Regional Payments Count - Month x",
+            "International - Intra-Regional Payments Volume - Month x",
+            "International - Non-EEA Payments Count - Month x",
+            "International - Non-EEA Payments Volume - Month x",
+            "International - Inter-Regional Payments Count - Month x",
+            "International - Inter-Regional Payments Volume - Month x",
+            "Total Number of Cards",
+            "Total Number of Active Cards",
+            "Total Number of Accounts",
+            "Number of Accounts - International Enabled",
+            "Payments Transactions Declined for Insufficient Funds - Number",
+        ];
+        NonZero.type = isly.string(NonZero.values);
+    })(NonZero = rows.NonZero || (rows.NonZero = {}));
+    let Blank;
+    (function (Blank) {
+        Blank.values = [
+            "Fraud Recoveries - Domestic - Cash Disbursements - Amount",
+            "Fraud Recoveries - Domestic - Payments - Amount",
+            "Fraud Recoveries - International - Cash Disbursements - Amount",
+            "Fraud Recoveries - International - Payments - Amount",
+            "Gross Fraud Losses - Number of Accounts",
+            "Gross Fraud Losses - Number of Recovered Accounts",
+            "Gross Fraud Losses - Domestic - Cash Disbursements - Count",
+            "Gross Fraud Losses - Domestic - Cash Disbursements - Volume",
+            "Gross Fraud Losses - Domestic - Payments - Count",
+            "Gross Fraud Losses - Domestic - Payments - Volume",
+            "Gross Fraud Losses - International - Cash Disbursements - Count",
+            "Gross Fraud Losses - International - Cash Disbursements - Volume",
+            "Gross Fraud Losses - International - Payments - Count",
+            "Gross Fraud Losses - International - Payments - Volume",
+        ];
+        Blank.type = isly.string(Blank.values);
+        function toCsvRow(row, count) {
+            return row + "|".repeat(count) + "\n";
+        }
+        Blank.toCsvRow = toCsvRow;
+    })(Blank = rows.Blank || (rows.Blank = {}));
+    function monthlyZeroRows(row, zeroes) {
+        let result = "";
+        for (let i = 1; 3 >= i; i++)
+            result += row.replace("Month x", `Month ${i}`) + "|0".repeat(zeroes) + "\n";
+        return result;
+    }
+    rows.monthlyZeroRows = monthlyZeroRows;
+    function zeros(row, zeroes) {
+        return row + "|0".repeat(zeroes) + "\n";
+    }
+    rows.zeros = zeros;
+})(rows || (rows = {}));
+//# sourceMappingURL=rows.js.map

package/dist/reports/visa/rows.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pax2pay/model-banking",
-	"version": "0.1.465",
+	"version": "0.1.466",
 	"description": "Library containing data model types and functions for the Pax2Pay Banking API.",
 	"author": "Pax2Pay Ltd",
 	"license": "MIT",

package/pax2pay.ts

@@ -30,4 +30,5 @@ export { Supplier } from "./Supplier"
 export { Transaction } from "./Transaction"
 export { Treasury } from "./Treasury"
 export { Warning } from "./Warning"
+export { reports } from "./reports"
 export { Quarter } from "./Quarter"

package/reports/index.ts

@@ -0,0 +1,5 @@
+import { visa as reportsVisa } from "./visa"
+
+export namespace reports {
+	export import visa = reportsVisa
+}

package/reports/visa/Data/Country.ts

@@ -0,0 +1,59 @@
+import { isoly } from "isoly"
+import { Transaction } from "../../../Transaction"
+import { Iin } from "./Iin"
+import { Monthly } from "./Monthly"
+import { Region } from "./Region"
+
+// data for rows of format:
+// "Country X - Region X Payments Card Present Count - Month x",
+// "Country X - Region X Payments Card Present Volume - Month x",
+// "Country X - Region X Payments Card Not Present Count - Month x",
+// "Country X - Region X Payments Card Not Present Volume - Month x",
+type PerCountry = { present?: Monthly; notPresent?: Monthly }
+export type Country = Partial<Record<isoly.CountryCode.Alpha2, PerCountry>>
+export namespace Country {
+	export function toCsv(country: Country): string {
+		let result = ""
+		for (const [countryCode, perCountry] of Object.entries(country)) {
+			const region = Region.find(countryCode as isoly.CountryCode.Alpha2)
+			result += csvLine(countryCode, region, perCountry, "present", "count")
+			result += csvLine(countryCode, region, perCountry, "present", "volume")
+			result += csvLine(countryCode, region, perCountry, "notPresent", "count")
+			result += csvLine(countryCode, region, perCountry, "notPresent", "volume")
+		}
+		return result
+	}
+	export function csvLine(
+		country: string,
+		region: Region,
+		data: PerCountry,
+		presence: "present" | "notPresent",
+		type: "count" | "volume"
+	): string {
+		let result = ""
+		if (data[presence])
+			for (const month of Monthly.Month.values) {
+				result += `Country ${country} - ${region} Card ${presence == "present" ? "Present" : "Not Present"} ${
+					type == "count" ? "Count" : "Volume"
+				} - Month ${month}`
+				for (const iin of Iin.values)
+					result += `|${data[presence][month][type][iin] ?? 0}`
+				result += "\n"
+			}
+		return result
+	}
+	export function update(country: Country, transaction: Transaction.CardTransaction): Country {
+		const result: Country = country
+		result[transaction.counterpart.merchant.country] = updatePerCountry(
+			result[transaction.counterpart.merchant.country] ?? {},
+			transaction
+		)
+		return result
+	}
+	function updatePerCountry(input: PerCountry, transaction: Transaction.CardTransaction): PerCountry {
+		const result = input
+		const key = transaction.counterpart.present === true ? "present" : "notPresent"
+		result[key] = Monthly.update(result[key], transaction)
+		return result
+	}
+}

package/reports/visa/Data/Iin.ts

@@ -0,0 +1,11 @@
+import { isly } from "isly"
+
+export type Iin = typeof Iin.values[number]
+export namespace Iin {
+	export type Idx = typeof Idx.values[number]
+	export namespace Idx {
+		export const values = ["45672555", "4567255", "45672557"] as const
+		export const type = isly.string<Idx>(values)
+	}
+	export const values = [...Idx.values, "totalIdx", "44260108", "49359119", "45672554"] as const
+}

package/reports/visa/Data/Monthly.ts

@@ -0,0 +1,45 @@
+import { isoly } from "isoly"
+import { Transaction } from "../../../Transaction"
+import { Iin } from "./Iin"
+
+export type Monthly = Record<
+	Monthly.Month,
+	{ count: Partial<Record<Iin, number>>; volume: Partial<Record<Iin, number>> }
+>
+export namespace Monthly {
+	export type Month = typeof Month.values[number]
+	export namespace Month {
+		export const values = [1, 2, 3] as const
+	}
+	// returns which number of the month in the quarter the transaction is in
+	export function getMonth(transaction: Transaction.CardTransaction): Monthly.Month {
+		const month = isoly.DateTime.getMonth(transaction.transacted ?? transaction.posted)
+		return (((month - 1) % 3) + 1) as Monthly.Month
+	}
+	export function update(previous: Monthly | undefined, transaction: Transaction.CardTransaction): Monthly {
+		const result: Monthly = previous ?? {
+			"1": { count: {}, volume: {} },
+			"2": { count: {}, volume: {} },
+			"3": { count: {}, volume: {} },
+		}
+		if (transaction.direction == "outbound" && transaction.status == "finalized") {
+			const month = getMonth(transaction)
+			result[month].count[transaction.account.iin as Iin] =
+				(result[month].count[transaction.account.iin as Iin] ?? 0) + 1
+			result[month].volume[transaction.account.iin as Iin] = isoly.Currency.add(
+				"GBP",
+				result[month].volume[transaction.account.iin as Iin] ?? 0,
+				Math.abs(transaction.amount.original)
+			)
+			if (Iin.Idx.type.is(transaction.account.iin)) {
+				result[month].count["totalIdx"] = (result[month].count["totalIdx"] ?? 0) + 1
+				result[month].volume["totalIdx"] = isoly.Currency.add(
+					"GBP",
+					result[month].volume["totalIdx"] ?? 0,
+					Math.abs(transaction.amount.original)
+				)
+			}
+		}
+		return result
+	}
+}

package/reports/visa/Data/NonMonthly.ts

@@ -0,0 +1,36 @@
+import { Transaction } from "../../../Transaction"
+import { rows } from "../rows"
+import { Iin } from "./Iin"
+
+export type NonMonthly = Record<
+	| "Total Number of Cards"
+	| "Total Number of Active Cards"
+	| "Total Number of Accounts"
+	| "Number of Accounts - International Enabled"
+	| "Payments Transactions Declined for Insufficient Funds - Number",
+	Partial<Record<Iin, number>>
+>
+export namespace NonMonthly {
+	export const empty: NonMonthly = {
+		"Number of Accounts - International Enabled": {},
+		"Payments Transactions Declined for Insufficient Funds - Number": {},
+		"Total Number of Accounts": {},
+		"Total Number of Active Cards": {},
+		"Total Number of Cards": {},
+	}
+	export function update(previous: NonMonthly, transaction: Transaction.CardTransaction): NonMonthly {
+		const result = previous
+		if (Array.isArray(transaction.status) && transaction.status[1] == "insufficient funds")
+			result["Payments Transactions Declined for Insufficient Funds - Number"][transaction.account.iin as Iin] =
+				(result["Payments Transactions Declined for Insufficient Funds - Number"]?.[transaction.account.iin as Iin] ??
+					0) + 1
+		return result
+	}
+	export function toCsvRow(data: NonMonthly, row: rows.NonZero): string {
+		let result = row
+		for (const iin of Iin.values)
+			result += `|${data[row as keyof NonMonthly][iin] ?? 0}`
+		result += "\n"
+		return result
+	}
+}

package/reports/visa/Data/Region.ts

@@ -0,0 +1,71 @@
+import { isoly } from "isoly"
+import { isly } from "isly"
+
+export type Region = typeof Region.values[number]
+export namespace Region {
+	export const values = [
+		"National Payments",
+		"International - Intra-Regional Payments",
+		"International - Non-EEA Payments",
+		"International - Inter-Regional Payments",
+	] as const
+	export const type = isly.string<Region>(values)
+	export const regions: Record<Region, isoly.CountryCode.Alpha2[]> = {
+		"National Payments": ["GB"],
+		"International - Intra-Regional Payments": [
+			"AT",
+			"BE",
+			"BG",
+			"HR",
+			"CY",
+			"CZ",
+			"DK",
+			"EE",
+			"FI",
+			"FR",
+			"DE",
+			"GR",
+			"HU",
+			"IE",
+			"IT",
+			"LV",
+			"LT",
+			"LU",
+			"MT",
+			"NL",
+			"PL",
+			"PT",
+			"RO",
+			"SK",
+			"SI",
+			"ES",
+			"SE",
+		],
+		"International - Non-EEA Payments": [],
+		"International - Inter-Regional Payments": ["IS", "NO", "LI"],
+	}
+	export function find(country: isoly.CountryCode.Alpha2): Region {
+		let result: Region
+		if (regions["National Payments"].includes(country))
+			result = "National Payments"
+		else if (regions["International - Intra-Regional Payments"].includes(country))
+			result = "International - Intra-Regional Payments"
+		else if (regions["International - Inter-Regional Payments"].includes(country))
+			result = "International - Inter-Regional Payments"
+		else
+			result = "International - Non-EEA Payments"
+		return result
+	}
+	export function fromRow(row: string): Region {
+		let result: Region
+		if (row.startsWith("National"))
+			result = "National Payments"
+		else if (row.startsWith("International - Inter-Regional"))
+			result = "International - Inter-Regional Payments"
+		else if (row.startsWith("International - Intra-Regional"))
+			result = "International - Intra-Regional Payments"
+		else
+			result = "International - Non-EEA Payments"
+		return result
+	}
+}

package/reports/visa/Data/Regional.ts

@@ -0,0 +1,26 @@
+import { Transaction } from "../../../Transaction"
+import { Iin } from "./Iin"
+import { Monthly } from "./Monthly"
+import { Region } from "./Region"
+
+export type Regional = Partial<Record<Region, Monthly>>
+export namespace Regional {
+	export function update(previous: Regional, transaction: Transaction.CardTransaction): Regional {
+		const region = Region.find(transaction.counterpart.merchant.country)
+		const result: Regional = previous
+		result[region] = Monthly.update(result[region], transaction)
+		return result
+	}
+	export function toCsvRow(regional: Regional, row: string): string {
+		let result = ""
+		const region = Region.fromRow(row)
+		const key: "count" | "volume" = row.includes("Count") ? "count" : "volume"
+		for (const month of Monthly.Month.values) {
+			result += row.replace("Month x", `Month ${month}`)
+			for (const iin of Iin.values)
+				result += `|${regional[region]?.[month][key][iin] ?? 0}`
+			result += "\n"
+		}
+		return result
+	}
+}

package/reports/visa/Data/index.ts

@@ -0,0 +1,33 @@
+import { Transaction } from "../../../Transaction"
+import { rows } from "../rows"
+import { Country as DataCountry } from "./Country"
+import { Iin as DataIin } from "./Iin"
+import { NonMonthly } from "./NonMonthly"
+import { Regional } from "./Regional"
+
+export type Data = {
+	regional: Regional
+	nonMonthly: NonMonthly
+	country: Data.Country
+}
+export namespace Data {
+	export import Iin = DataIin
+	export import Country = DataCountry
+	export function create(transactions: Transaction.CardTransaction[]): Data {
+		const result: Data = { regional: {}, nonMonthly: NonMonthly.empty, country: {} }
+		for (const transaction of transactions) {
+			result.nonMonthly = NonMonthly.update(result.nonMonthly, transaction)
+			result.regional = Regional.update(result.regional, transaction)
+			result.country = Country.update(result.country, transaction)
+		}
+		return result
+	}
+	export function toCsv(data: Data, row: rows.NonZero): string {
+		let result: string
+		if (row.endsWith("Month x"))
+			result = Regional.toCsvRow(data.regional, row)
+		else
+			result = NonMonthly.toCsvRow(data.nonMonthly, row)
+		return result
+	}
+}

package/reports/visa/index.ts

@@ -0,0 +1,37 @@
+import { Data as visaData } from "./Data"
+import { rows as visaRows } from "./rows"
+
+export namespace visa {
+	export import Data = visaData
+	export import rows = visaRows
+	const headers = [
+		"Product Local Name",
+		"Visa IDX - 45672555",
+		"Visa IDX  - 4567255",
+		"Visa IDX 1.4% - 45672557",
+		"Total Visa IDX products",
+		"Visa Business Prepaid - 44260108",
+		"Visa Corporate Deferred Debit  - 49359119",
+		"Visa Business Immediate Debit - BIN: 45672554",
+	] as const
+	export function toCsv(data: Data): string {
+		// report 1
+		let csv = headers.join("|") + "\n"
+		for (const row of rows.all)
+			if (rows.Blank.type.is(row))
+				// Leave empty for operations team to fill
+				csv += rows.Blank.toCsvRow(row, headers.length - 1)
+			else if (rows.NonZero.type.is(row))
+				// "report 1" data
+				csv += Data.toCsv(data, row)
+			else if (row.endsWith("Month x"))
+				// rows with zeroes for each month
+				csv += rows.monthlyZeroRows(row, headers.length - 1)
+			// rows with zeroes
+			else
+				csv += rows.zeros(row, headers.length - 1)
+		// append "report 2" to the end
+		csv += Data.Country.toCsv(data.country)
+		return csv
+	}
+}

package/reports/visa/rows.ts

@@ -0,0 +1,151 @@
+import { isly } from "isly"
+
+export namespace rows {
+	export const all = [
+		"On-Us Payments Count - Month x",
+		"On-Us Payments Volume - Month x",
+		"On-Us Account Funding Transaction Count - Month x",
+		"On-Us Account Funding Transaction Volume - Month x",
+		"On-Us Original Credits Count - Month x",
+		"On-Us Original Credits Volume - Month x",
+		"On-Us ATM Cash Advances Count - Month x",
+		"On-Us ATM Cash Advances Volume - Month x",
+		"On-Us Manual Cash Count - Month x",
+		"On-Us Manual Cash Volume - Month x",
+		"On-Us Cashback Count - Month x",
+		"On-Us Cashback Volume - Month x",
+		"National Payments Count - Month x",
+		"National Payments Volume - Month x",
+		"National Account Funding Transaction Count - Month x",
+		"National Account Funding Transaction Volume - Month x",
+		"National Original Credits Count - Month x",
+		"National Original Credits Volume - Month x",
+		"National ATM Cash Advances Count - Month x",
+		"National ATM Cash Advances Volume - Month x",
+		"National Manual Cash Count - Month x",
+		"National Manual Cash Volume - Month x",
+		"National Cashback Count - Month x",
+		"National Cashback Volume - Month x",
+		"International - Intra-Regional Payments Count - Month x",
+		"International - Intra-Regional Payments Volume - Month x",
+		"International - Intra-Regional Account Funding Transaction Count - Month x",
+		"International - Intra-Regional Account Funding Transaction Volume - Month x",
+		"International - Intra-Regional Original Credits Count - Month x",
+		"International - Intra-Regional Original Credits Volume - Month x",
+		"International - Intra-Regional ATM Cash Advances Count - Month x",
+		"International - Intra-Regional ATM Cash Advances Volume - Month x",
+		"International - Intra-Regional Manual Cash Count - Month x",
+		"International - Intra-Regional Manual Cash Volume - Month x",
+		"International - Intra-Regional Cashback Count - Month x",
+		"International - Intra-Regional Cashback Volume - Month x",
+		"International - Non-EEA Payments Count - Month x",
+		"International - Non-EEA Payments Volume - Month x",
+		"International - Non-EEA Account Funding Transaction Count - Month x",
+		"International - Non-EEA Account Funding Transaction Volume - Month x",
+		"International - Non-EEA Original Credits Count - Month x",
+		"International - Non-EEA Original Credits Volume - Month x",
+		"International - Non-EEA ATM Cash Advances Count - Month x",
+		"International - Non-EEA ATM Cash Advances Volume - Month x",
+		"International - Non-EEA Manual Cash Count - Month x",
+		"International - Non-EEA Manual Cash Volume - Month x",
+		"International - Non-EEA Cashback Count - Month x",
+		"International - Non-EEA Cashback Volume - Month x",
+		"International - Inter-Regional Payments Count - Month x",
+		"International - Inter-Regional Payments Volume - Month x",
+		"International - Inter-Regional Account Funding Transaction Count - Month x",
+		"International - Inter-Regional Account Funding Transaction Volume - Month x",
+		"International - Inter-Regional Original Credits Count - Month x",
+		"International - Inter-Regional Original Credits Volume - Month x",
+		"International - Inter-Regional ATM Cash Advances Count - Month x",
+		"International - Inter-Regional ATM Cash Advances Volume - Month x",
+		"International - Inter-Regional Manual Cash Count - Month x",
+		"International - Inter-Regional Manual Cash Volume - Month x",
+		"International - Inter-Regional Cashback Count - Month x",
+		"International - Inter-Regional Cashback Volume - Month x",
+		"Total Number of Cards",
+		"Number of Cards - Magnetic Stripe",
+		"Number of Cards - Magnetic Stripe, Chip",
+		"Number of Cards - Magnetic Stripe, Contactless",
+		"Number of Cards - Magnetic Stripe, Chip, Contactless",
+		"Total Number of Active Cards",
+		"Number of Active Cards - used at Contactless device",
+		"Number of Devices with Visa Contactless - Micro Tags",
+		"Number of Devices with Visa Contactless - Mobile Phones",
+		"Number of Devices with Visa Contactless - Other Devices",
+		"Total Number of Accounts",
+		"Number of Accounts - Domestic Use Only",
+		"Number of Accounts - International Enabled",
+		"Total Number of Active Accounts",
+		"Total Number of Personal Deposit Accounts",
+		"Number of Savings Accounts",
+		"Number of Regular Checking Accounts",
+		"Fraud Recoveries - Domestic - Cash Disbursements - Amount",
+		"Fraud Recoveries - Domestic - Payments - Amount",
+		"Fraud Recoveries - International - Cash Disbursements - Amount",
+		"Fraud Recoveries - International - Payments - Amount",
+		"Gross Fraud Losses - Number of Accounts",
+		"Gross Fraud Losses - Number of Recovered Accounts",
+		"Gross Fraud Losses - Domestic - Cash Disbursements - Count",
+		"Gross Fraud Losses - Domestic - Cash Disbursements - Volume",
+		"Gross Fraud Losses - Domestic - Payments - Count",
+		"Gross Fraud Losses - Domestic - Payments - Volume",
+		"Gross Fraud Losses - International - Cash Disbursements - Count",
+		"Gross Fraud Losses - International - Cash Disbursements - Volume",
+		"Gross Fraud Losses - International - Payments - Count",
+		"Gross Fraud Losses - International - Payments - Volume",
+		"Total Product Balance - Volume",
+		"Payments Transactions Declined for Insufficient Funds - Number",
+		"Cash Transactions Declined for Insufficient Funds - Number",
+	] as const
+	export type NonZero = typeof NonZero.values[number]
+	export namespace NonZero {
+		export const values = [
+			"National Payments Count - Month x",
+			"National Payments Volume - Month x",
+			"International - Intra-Regional Payments Count - Month x",
+			"International - Intra-Regional Payments Volume - Month x",
+			"International - Non-EEA Payments Count - Month x",
+			"International - Non-EEA Payments Volume - Month x",
+			"International - Inter-Regional Payments Count - Month x",
+			"International - Inter-Regional Payments Volume - Month x",
+			"Total Number of Cards",
+			"Total Number of Active Cards",
+			"Total Number of Accounts",
+			"Number of Accounts - International Enabled",
+			"Payments Transactions Declined for Insufficient Funds - Number",
+		] as const
+		export const type = isly.string<NonZero>(values)
+	}
+	export type Blank = typeof Blank.values[number]
+	export namespace Blank {
+		export const values = [
+			"Fraud Recoveries - Domestic - Cash Disbursements - Amount",
+			"Fraud Recoveries - Domestic - Payments - Amount",
+			"Fraud Recoveries - International - Cash Disbursements - Amount",
+			"Fraud Recoveries - International - Payments - Amount",
+			"Gross Fraud Losses - Number of Accounts",
+			"Gross Fraud Losses - Number of Recovered Accounts",
+			"Gross Fraud Losses - Domestic - Cash Disbursements - Count",
+			"Gross Fraud Losses - Domestic - Cash Disbursements - Volume",
+			"Gross Fraud Losses - Domestic - Payments - Count",
+			"Gross Fraud Losses - Domestic - Payments - Volume",
+			"Gross Fraud Losses - International - Cash Disbursements - Count",
+			"Gross Fraud Losses - International - Cash Disbursements - Volume",
+			"Gross Fraud Losses - International - Payments - Count",
+			"Gross Fraud Losses - International - Payments - Volume",
+		] as const
+		export const type = isly.string<Blank>(values)
+		export function toCsvRow(row: Blank, count: number): string {
+			return row + "|".repeat(count) + "\n"
+		}
+	}
+	export function monthlyZeroRows(row: string, zeroes: number): string {
+		let result = ""
+		for (let i = 1; 3 >= i; i++)
+			result += row.replace("Month x", `Month ${i}`) + "|0".repeat(zeroes) + "\n"
+		return result
+	}
+	export function zeros(row: string, zeroes: number): string {
+		return row + "|0".repeat(zeroes) + "\n"
+	}
+}