@amboras-dev/money 0.2.0 → 0.3.0

package/dist/sql.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_money = require("./money-B3wH_Z4S.cjs");
-const require_rate = require("./rate-CVeMii4a.cjs");
-const require_retail = require("./retail-Cml8YSKg.cjs");
-//#region src/sql/guard.ts
+const require_money = require("./money-DWBjuuEK.cjs");
+const require_rate = require("./rate-CEjWTATc.cjs");
+const require_retail = require("./retail-CYGPU4ea.cjs");
+// src/sql/guard.ts
 const STATEMENT_BREAKERS = /;|--|\/\*|\*\/|\0/;
 const refuse = (name, value) => new require_money.MoneyError("parse", `${name} must be a SQL expression written in code, got ${require_money.describeValue(value)}`);
 /** Code-written text, or `parse` when it is blank, could break out of the expression or holds a `?` placeholder. */
@@ -57,8 +57,7 @@ function dialectOf(value) {
 	if (value !== "pg" && value !== "clickhouse") throw new require_money.MoneyError("parse", `Unknown SQL dialect: ${require_money.describeValue(value)}`);
 	return value;
 }
-//#endregion
-//#region src/sql/lists.ts
+// src/sql/lists.ts
 const quoted = (pick) => require_money.CURRENCIES.filter(pick).map((info) => `'${info.code}'`).join(",");
 /** Storage scale 1000: `'BHD','IQD','JOD','KWD','LYD','OMR','TND'`. */
 const SCALE_1000_CODES = quoted((info) => info.storageScale === 1e3);
@@ -70,8 +69,7 @@ const DISPLAY_3_CODES = quoted((info) => info.displayDigits === 3);
 const MEDUSA_0_CODES = quoted((info) => info.medusaDigits === 0);
 /** Medusa core `decimal_digits` 3 (payment-status epsilon 0.001). */
 const MEDUSA_3_CODES = quoted((info) => info.medusaDigits === 3);
-//#endregion
-//#region src/sql/amounts.ts
+// src/sql/amounts.ts
 const CH_STORED_SCALE = 3;
 const CH_ROUND_SCALE = 12;
 /** The storage divisor of the currency in `codeExpr`, keyed by code (never `currency.decimal_digits`). */
@@ -145,8 +143,7 @@ function rawAmountJsonSql(expr) {
 function normalizeCurrencySql(expr) {
 	return sql`lower(btrim(${expression(expr, "expr")}))`;
 }
-//#endregion
-//#region src/sql/clickhouse.ts
+// src/sql/clickhouse.ts
 /**
 * The SELECT list and GROUP BY of per-currency purchase revenue in stored units. The event name
 * is a ClickHouse query parameter (`{revenue_event:String}`, pass `params` as `query_params`),
@@ -165,8 +162,7 @@ function chEventRevenueByCurrencySql(cols = {}) {
 		params: { revenue_event: event }
 	};
 }
-//#endregion
-//#region src/sql/ddl.ts
+// src/sql/ddl.ts
 /** The column type of a stored amount. */
 const STORAGE_AMOUNT_SQL_TYPE = "BIGINT";
 /** A column for DDL, which Postgres never parameterises: a fragment with bindings is `parse`. */
@@ -208,8 +204,7 @@ function usdToCreditsSql(expr) {
 function monthlyEquivalentSql(expr) {
 	return sql`ROUND((${expression(expr, "expr")})::numeric / 12)`;
 }
-//#endregion
-//#region src/sql/fx.ts
+// src/sql/fx.ts
 function factorsJson(table) {
 	require_money.resolveCurrency(table?.base, { allowHistoric: true });
 	return JSON.stringify(table.factors);
@@ -268,7 +263,6 @@ function convertStoredByColumnsSql(amountExpr, cols) {
 	const whole = sql`(FLOOR(${x} / ${major}) * ${major})`;
 	return sql`(CASE WHEN ${retail} = 'none' THEN ${x} WHEN ${x} <= 0 THEN ${x} WHEN ${charm} IS NULL THEN CEIL(${x} / (100 * ${major})) * (100 * ${major}) WHEN ${x} <= ${whole} + ${charm} THEN ${whole} + ${charm} ELSE ${whole} + ${major} + ${charm} END)`;
 }
-//#endregion
 exports.STORAGE_AMOUNT_SQL_TYPE = STORAGE_AMOUNT_SQL_TYPE;
 exports.chEventRevenueByCurrencySql = chEventRevenueByCurrencySql;
 exports.convertStoredByColumnsSql = convertStoredByColumnsSql;

package/dist/sql.d.cts

@@ -1,6 +1,5 @@
-import { r as Rate } from "./rate-tqK8ijG0.cjs";
-import { t as FactorTable } from "./reporting-CG-ai2sM.cjs";
-//#region src/sql/guard.d.ts
+import { r as Rate } from "./rate-CEakW3ia.cjs";
+import { t as FactorTable } from "./reporting-DFNyDBdi.cjs";
 type SqlBinding = string | number;
 /** Text with knex `?` placeholders and the values they bind, in order: `knex.raw(f.sql, f.bindings)`. */
 interface SqlFragment {
@@ -10,8 +9,6 @@ interface SqlFragment {
 /** An expression argument: SQL text written in code (a column reference), or a builder's SqlFragment. */
 type SqlExpression = string | SqlFragment;
 type SqlDialect = 'pg' | 'clickhouse';
-//#endregion
-//#region src/sql/amounts.d.ts
 /** The storage divisor of the currency in `codeExpr`, keyed by code (never `currency.decimal_digits`). */
 export declare function storageDivisorSql(codeExpr: SqlExpression, dialect?: SqlDialect): SqlFragment;
 /**
@@ -51,8 +48,6 @@ export declare function summaryAmountSql(totalsExpr: SqlExpression, key: string,
 export declare function rawAmountJsonSql(expr: SqlExpression): SqlFragment;
 /** A currency code column normalised the way Medusa stores it. */
 export declare function normalizeCurrencySql(expr: SqlExpression): SqlFragment;
-//#endregion
-//#region src/sql/clickhouse.d.ts
 interface EventRevenueColumns {
   /** Default `'value'` (stored units). */
   readonly value?: string;
@@ -79,8 +74,6 @@ interface EventRevenueSql {
  * (verified on 24.8).
  */
 export declare function chEventRevenueByCurrencySql(cols?: EventRevenueColumns): EventRevenueSql;
-//#endregion
-//#region src/sql/ddl.d.ts
 /** The column type of a stored amount. */
 export declare const STORAGE_AMOUNT_SQL_TYPE = "BIGINT";
 /** Lower-case three-letter currency codes only. */
@@ -108,8 +101,6 @@ export declare function storageAmountCheckSql(column: SqlExpression, options?: S
 export declare function usdToCreditsSql(expr: SqlExpression): SqlFragment;
 /** A yearly price as its monthly equivalent, half away from zero, the twin of `billing.monthlyEquivalent`. */
 export declare function monthlyEquivalentSql(expr: SqlExpression): SqlFragment;
-//#endregion
-//#region src/sql/fx.d.ts
 /**
  * A stored amount in the currency of `codeExpr` converted with the bound factor table
  * (`fx.storeFactors`): `output: 'stored'` rounds half away from zero to a storage unit of the
@@ -143,5 +134,4 @@ interface ConvertColumns {
 }
 /** `convertStoredSql` with the factor and rounding read from columns, so one statement converts many currencies. */
 export declare function convertStoredByColumnsSql(amountExpr: SqlExpression, cols: ConvertColumns): SqlFragment;
-//#endregion
 export type { ConvertColumns, EventRevenueColumns, EventRevenueSql, SqlBinding, SqlDialect, SqlExpression, SqlFragment, StorageAmountCheckOptions };

package/dist/sql.d.ts

@@ -1,6 +1,5 @@
-import { r as Rate } from "./rate-DBPiYgT1.js";
-import { t as FactorTable } from "./reporting-tpGJbqYp.js";
-//#region src/sql/guard.d.ts
+import { r as Rate } from "./rate-BvvZUdSu.js";
+import { t as FactorTable } from "./reporting-jIBILvnr.js";
 type SqlBinding = string | number;
 /** Text with knex `?` placeholders and the values they bind, in order: `knex.raw(f.sql, f.bindings)`. */
 interface SqlFragment {
@@ -10,8 +9,6 @@ interface SqlFragment {
 /** An expression argument: SQL text written in code (a column reference), or a builder's SqlFragment. */
 type SqlExpression = string | SqlFragment;
 type SqlDialect = 'pg' | 'clickhouse';
-//#endregion
-//#region src/sql/amounts.d.ts
 /** The storage divisor of the currency in `codeExpr`, keyed by code (never `currency.decimal_digits`). */
 export declare function storageDivisorSql(codeExpr: SqlExpression, dialect?: SqlDialect): SqlFragment;
 /**
@@ -51,8 +48,6 @@ export declare function summaryAmountSql(totalsExpr: SqlExpression, key: string,
 export declare function rawAmountJsonSql(expr: SqlExpression): SqlFragment;
 /** A currency code column normalised the way Medusa stores it. */
 export declare function normalizeCurrencySql(expr: SqlExpression): SqlFragment;
-//#endregion
-//#region src/sql/clickhouse.d.ts
 interface EventRevenueColumns {
   /** Default `'value'` (stored units). */
   readonly value?: string;
@@ -79,8 +74,6 @@ interface EventRevenueSql {
  * (verified on 24.8).
  */
 export declare function chEventRevenueByCurrencySql(cols?: EventRevenueColumns): EventRevenueSql;
-//#endregion
-//#region src/sql/ddl.d.ts
 /** The column type of a stored amount. */
 export declare const STORAGE_AMOUNT_SQL_TYPE = "BIGINT";
 /** Lower-case three-letter currency codes only. */
@@ -108,8 +101,6 @@ export declare function storageAmountCheckSql(column: SqlExpression, options?: S
 export declare function usdToCreditsSql(expr: SqlExpression): SqlFragment;
 /** A yearly price as its monthly equivalent, half away from zero, the twin of `billing.monthlyEquivalent`. */
 export declare function monthlyEquivalentSql(expr: SqlExpression): SqlFragment;
-//#endregion
-//#region src/sql/fx.d.ts
 /**
  * A stored amount in the currency of `codeExpr` converted with the bound factor table
  * (`fx.storeFactors`): `output: 'stored'` rounds half away from zero to a storage unit of the
@@ -143,5 +134,4 @@ interface ConvertColumns {
 }
 /** `convertStoredSql` with the factor and rounding read from columns, so one statement converts many currencies. */
 export declare function convertStoredByColumnsSql(amountExpr: SqlExpression, cols: ConvertColumns): SqlFragment;
-//#endregion
 export type { ConvertColumns, EventRevenueColumns, EventRevenueSql, SqlBinding, SqlDialect, SqlExpression, SqlFragment, StorageAmountCheckOptions };

package/dist/sql.js

@@ -1,7 +1,7 @@
-import { $ as describeValue, A as storageScale, E as resolveCurrency, Q as MoneyError, u as CURRENCIES } from "./money-WhnGiI00.js";
-import { r as checkRate } from "./rate-DicStBue.js";
-import { t as priceRoundingParams } from "./retail-1mu888J1.js";
-//#region src/sql/guard.ts
+import { $ as describeValue, A as storageScale, E as resolveCurrency, Q as MoneyError, u as CURRENCIES } from "./money-BxbAw7BP.js";
+import { r as checkRate } from "./rate-D6S2_wgZ.js";
+import { t as priceRoundingParams } from "./retail-DXgs11ov.js";
+// src/sql/guard.ts
 const STATEMENT_BREAKERS = /;|--|\/\*|\*\/|\0/;
 const refuse = (name, value) => new MoneyError("parse", `${name} must be a SQL expression written in code, got ${describeValue(value)}`);
 /** Code-written text, or `parse` when it is blank, could break out of the expression or holds a `?` placeholder. */
@@ -56,8 +56,7 @@ function dialectOf(value) {
 	if (value !== "pg" && value !== "clickhouse") throw new MoneyError("parse", `Unknown SQL dialect: ${describeValue(value)}`);
 	return value;
 }
-//#endregion
-//#region src/sql/lists.ts
+// src/sql/lists.ts
 const quoted = (pick) => CURRENCIES.filter(pick).map((info) => `'${info.code}'`).join(",");
 /** Storage scale 1000: `'BHD','IQD','JOD','KWD','LYD','OMR','TND'`. */
 const SCALE_1000_CODES = quoted((info) => info.storageScale === 1e3);
@@ -69,8 +68,7 @@ const DISPLAY_3_CODES = quoted((info) => info.displayDigits === 3);
 const MEDUSA_0_CODES = quoted((info) => info.medusaDigits === 0);
 /** Medusa core `decimal_digits` 3 (payment-status epsilon 0.001). */
 const MEDUSA_3_CODES = quoted((info) => info.medusaDigits === 3);
-//#endregion
-//#region src/sql/amounts.ts
+// src/sql/amounts.ts
 const CH_STORED_SCALE = 3;
 const CH_ROUND_SCALE = 12;
 /** The storage divisor of the currency in `codeExpr`, keyed by code (never `currency.decimal_digits`). */
@@ -144,8 +142,7 @@ function rawAmountJsonSql(expr) {
 function normalizeCurrencySql(expr) {
 	return sql`lower(btrim(${expression(expr, "expr")}))`;
 }
-//#endregion
-//#region src/sql/clickhouse.ts
+// src/sql/clickhouse.ts
 /**
 * The SELECT list and GROUP BY of per-currency purchase revenue in stored units. The event name
 * is a ClickHouse query parameter (`{revenue_event:String}`, pass `params` as `query_params`),
@@ -164,8 +161,7 @@ function chEventRevenueByCurrencySql(cols = {}) {
 		params: { revenue_event: event }
 	};
 }
-//#endregion
-//#region src/sql/ddl.ts
+// src/sql/ddl.ts
 /** The column type of a stored amount. */
 const STORAGE_AMOUNT_SQL_TYPE = "BIGINT";
 /** A column for DDL, which Postgres never parameterises: a fragment with bindings is `parse`. */
@@ -207,8 +203,7 @@ function usdToCreditsSql(expr) {
 function monthlyEquivalentSql(expr) {
 	return sql`ROUND((${expression(expr, "expr")})::numeric / 12)`;
 }
-//#endregion
-//#region src/sql/fx.ts
+// src/sql/fx.ts
 function factorsJson(table) {
 	resolveCurrency(table?.base, { allowHistoric: true });
 	return JSON.stringify(table.factors);
@@ -267,5 +262,4 @@ function convertStoredByColumnsSql(amountExpr, cols) {
 	const whole = sql`(FLOOR(${x} / ${major}) * ${major})`;
 	return sql`(CASE WHEN ${retail} = 'none' THEN ${x} WHEN ${x} <= 0 THEN ${x} WHEN ${charm} IS NULL THEN CEIL(${x} / (100 * ${major})) * (100 * ${major}) WHEN ${x} <= ${whole} + ${charm} THEN ${whole} + ${charm} ELSE ${whole} + ${major} + ${charm} END)`;
 }
-//#endregion
 export { STORAGE_AMOUNT_SQL_TYPE, chEventRevenueByCurrencySql, convertStoredByColumnsSql, convertStoredSql, currencyCodeCheckSql, medusaEpsilonSql, monthlyEquivalentSql, normalizeCurrencySql, parseDecimalSql, rawAmountJsonSql, reportingCompleteSql, roundMajorSql, storageAmountCheckSql, storageDivisorSql, storedToMajorSql, summaryAmountSql, toReportingSql, usdToCreditsSql, withinEpsilonSql };