@autologix-engineering/shared 1.2.404 → 1.2.406

package/src/lib/utilities/src/amount.in.words.js.map

@@ -1 +1 @@
-{"version":3,"file":"amount.in.words.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/amount.in.words.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"amount.in.words.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/amount.in.words.ts"],"names":[],"mappings":"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"}

package/src/lib/utilities/src/get.shortened.link.d.ts

@@ -1 +1,12 @@
+/**
+ * Returns the shortener's response if it is a short link on t.autologix.io,
+ * otherwise ''. The shortener has answered 200 with its own PHP source when
+ * PHP stopped executing on that box, and that text went out verbatim in trip
+ * emails, SMS and WhatsApp -- anything that isn't a short link must not.
+ */
+export declare const toValidShortUrl: (data: unknown) => string;
+/**
+ * Short link for `url`, or '' if one can't be had for any reason.
+ * Needs SHORTENER_API_KEY (a Shlink API key) in the service's env.
+ */
 export declare const getShortUrl: (url: string) => Promise<string>;

package/src/lib/utilities/src/get.shortened.link.js

@@ -1,18 +1,45 @@
 import axios from 'axios';
-export const getShortUrl = (url) => {
-    // eslint-disable-next-line no-async-promise-executor
-    return new Promise(async (resolve, reject) => {
-        try {
-            const _shortUrl = await axios.post('https://t.autologix.io/api/v2/action/shorten', {
-                key: 'b243355c7b9e8d20dc888b8d6cdc03',
-                url: url,
-            });
-            resolve(_shortUrl?.data?.replace('t.autologix.io/', 't.autologix.io/AUTLGX/'));
-        }
-        catch (error) {
-            console.error(error);
-            reject(error);
-        }
-    });
+// A single short link on our host, e.g. https://t.autologix.io/a1B2c
+const SHORT_URL_PATTERN = /^https?:\/\/t\.autologix\.io\/[A-Za-z0-9_-]{1,64}$/;
+// t.autologix.io runs Shlink (Polr's /api/v2/action/shorten is gone).
+const SHLINK_SHORTEN_URL = 'https://t.autologix.io/rest/v3/short-urls';
+/**
+ * Returns the shortener's response if it is a short link on t.autologix.io,
+ * otherwise ''. The shortener has answered 200 with its own PHP source when
+ * PHP stopped executing on that box, and that text went out verbatim in trip
+ * emails, SMS and WhatsApp -- anything that isn't a short link must not.
+ */
+export const toValidShortUrl = (data) => {
+    const candidate = typeof data === 'string' ? data.trim() : '';
+    if (SHORT_URL_PATTERN.test(candidate)) {
+        return candidate;
+    }
+    console.error(`Shortener returned an invalid short url: ${JSON.stringify(data)?.slice(0, 80)}`);
+    return '';
+};
+/**
+ * Short link for `url`, or '' if one can't be had for any reason.
+ * Needs SHORTENER_API_KEY (a Shlink API key) in the service's env.
+ */
+export const getShortUrl = async (url) => {
+    const apiKey = typeof process !== 'undefined'
+        ? process.env?.['SHORTENER_API_KEY']
+        : undefined;
+    if (!apiKey) {
+        console.error('Short URL request skipped: SHORTENER_API_KEY is not set');
+        return '';
+    }
+    try {
+        const _shortUrl = await axios.post(SHLINK_SHORTEN_URL, { longUrl: url }, {
+            headers: { 'X-Api-Key': apiKey, Accept: 'application/json' },
+            timeout: 10000,
+        });
+        return toValidShortUrl(_shortUrl?.data?.shortUrl);
+    }
+    catch (error) {
+        // Message only: the axios error also carries the request headers (the API key).
+        console.error(`Short URL request failed: ${error instanceof Error ? error.message : String(error)}`);
+        return '';
+    }
 };
 //# sourceMappingURL=get.shortened.link.js.map

package/src/lib/utilities/src/get.shortened.link.js.map

@@ -1 +1 @@
-{"version":3,"file":"get.shortened.link.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/get.shortened.link.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAW,EAAmB,EAAE;IAC3D,qDAAqD;IACrD,OAAO,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;QAC5C,IAAI,CAAC;YACJ,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,IAAI,CACjC,8CAA8C,EAC9C;gBACC,GAAG,EAAE,gCAAgC;gBACrC,GAAG,EAAE,GAAG;aACR,CACD,CAAC;YACF,OAAO,CACN,SAAS,EAAE,IAAI,EAAE,OAAO,CACvB,iBAAiB,EACjB,wBAAwB,CACxB,CACD,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACrB,MAAM,CAAC,KAAK,CAAC,CAAC;QACf,CAAC;IACF,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"get.shortened.link.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/get.shortened.link.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,qEAAqE;AACrE,MAAM,iBAAiB,GAAG,oDAAoD,CAAC;AAC/E,sEAAsE;AACtE,MAAM,kBAAkB,GAAG,2CAA2C,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAa,EAAU,EAAE;IACxD,MAAM,SAAS,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,IAAI,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,KAAK,CACZ,4CAA4C,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,CACtE,CAAC,EACD,EAAE,CACF,EAAE,CACH,CAAC;IACF,OAAO,EAAE,CAAC;AACX,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,GAAW,EAAmB,EAAE;IACjE,MAAM,MAAM,GACX,OAAO,OAAO,KAAK,WAAW;QAC7B,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,mBAAmB,CAAC;QACpC,CAAC,CAAC,SAAS,CAAC;IACd,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CACZ,yDAAyD,CACzD,CAAC;QACF,OAAO,EAAE,CAAC;IACX,CAAC;IACD,IAAI,CAAC;QACJ,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,IAAI,CACjC,kBAAkB,EAClB,EAAE,OAAO,EAAE,GAAG,EAAE,EAChB;YACC,OAAO,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE;YAC5D,OAAO,EAAE,KAAK;SACd,CACD,CAAC;QACF,OAAO,eAAe,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,gFAAgF;QAChF,OAAO,CAAC,KAAK,CACZ,6BAA6B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACrF,CAAC;QACF,OAAO,EAAE,CAAC;IACX,CAAC;AACF,CAAC,CAAC"}

package/src/lib/utilities/src/index.d.ts

@@ -23,6 +23,7 @@ export * from './format.cleartax.b2c.error';
 export * from './build.cleartax.pay.dtls';
 export * from './resolve.cleartax.driver.sac.hsn';
 export * from './normalize.phone.number';
+export * from './singapore.phone.number';
 export * from './resolve.passenger.display.name';
 export * from './remove.null.filter';
 export * from './calculate.deducted.sharing.amount';
@@ -33,6 +34,7 @@ export * from './line.item.helpers';
 export * from './tax.invoice.helpers';
 export * from './build.include.revenue.client.id.set';
 export * from './amount.in.words';
+export * from './money';
 export * from './calculate.ba.payout.working.days';
 export * from './garage.start.from.pickup';
 export * from './parse.display.date';
@@ -58,3 +60,4 @@ export * from './ba.contract.rm.refund';
 export * from './trip.allocation';
 export * from './gps.odometer.km';
 export * from './ltr.invoice.in.force';
+export * from './show.cust.usage.dtls';

package/src/lib/utilities/src/index.js

@@ -23,6 +23,7 @@ export * from './format.cleartax.b2c.error';
 export * from './build.cleartax.pay.dtls';
 export * from './resolve.cleartax.driver.sac.hsn';
 export * from './normalize.phone.number';
+export * from './singapore.phone.number';
 export * from './resolve.passenger.display.name';
 export * from './remove.null.filter';
 export * from './calculate.deducted.sharing.amount';
@@ -33,6 +34,7 @@ export * from './line.item.helpers';
 export * from './tax.invoice.helpers';
 export * from './build.include.revenue.client.id.set';
 export * from './amount.in.words';
+export * from './money';
 export * from './calculate.ba.payout.working.days';
 export * from './garage.start.from.pickup';
 export * from './parse.display.date';
@@ -58,4 +60,5 @@ export * from './ba.contract.rm.refund';
 export * from './trip.allocation';
 export * from './gps.odometer.km';
 export * from './ltr.invoice.in.force';
+export * from './show.cust.usage.dtls';
 //# sourceMappingURL=index.js.map

package/src/lib/utilities/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,YAAY,CAAC;AAC3B,cAAc,oCAAoC,CAAC;AACnD,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,OAAO,CAAC;AACtB,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mCAAmC,CAAC;AAClD,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,sBAAsB,CAAC;AACrC,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qCAAqC,CAAC;AACpD,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uCAAuC,CAAC;AACtD,cAAc,mBAAmB,CAAC;AAClC,cAAc,oCAAoC,CAAC;AACnD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iCAAiC,CAAC;AAChD,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,iBAAiB,CAAC;AAChC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,YAAY,CAAC;AAC3B,cAAc,oCAAoC,CAAC;AACnD,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,OAAO,CAAC;AACtB,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mCAAmC,CAAC;AAClD,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,sBAAsB,CAAC;AACrC,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qCAAqC,CAAC;AACpD,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uCAAuC,CAAC;AACtD,cAAc,mBAAmB,CAAC;AAClC,cAAc,SAAS,CAAC;AACxB,cAAc,oCAAoC,CAAC;AACnD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iCAAiC,CAAC;AAChD,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,iBAAiB,CAAC;AAChC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC"}

package/src/lib/utilities/src/money.d.ts

@@ -0,0 +1,82 @@
+import { BusinessContextOwnerField, IBusinessContextOwner } from '@autologix/shared/models';
+/** How a currency is written on documents and screens. */
+export interface CurrencyMeta {
+    /** ISO 4217 code, e.g. 'INR'. */
+    code: string;
+    /** Symbol before an amount, e.g. '₹'. */
+    symbol: string;
+    /** Short text prefix used where the symbol is spelled out, e.g. 'Rs.'. */
+    abbrev: string;
+    /** Locale for digit grouping, e.g. 'en-IN' (lakh/crore). */
+    locale: string;
+    /** Major and minor unit names for amount in words. */
+    major: string;
+    minor: string;
+    /**
+     * How amount in words groups digits: 'indian' (lakh / crore, the existing
+     * convertToRupeesAndPaisa text) or 'international' (million / billion).
+     */
+    numbering: 'indian' | 'international';
+}
+/**
+ * The currencies companies can bill in. INR matches what India-only code
+ * printed before currencies existed, so Indian output is unchanged.
+ */
+export declare const CURRENCY_META: Record<string, CurrencyMeta>;
+/** True for a currency code this platform can bill in. */
+export declare const isSupportedCurrency: (code?: string | null) => boolean;
+/** `code`'s formatting rules; INR's for a missing or unsupported code. */
+export declare const currencyMeta: (code?: string | null) => CurrencyMeta;
+/**
+ * A company's currency from its row, INR when missing or unsupported (rows
+ * read before the column existed, or a partial select without it).
+ */
+export declare const companyCurrency: (company?: Pick<IBusinessContextOwner, BusinessContextOwnerField.Currency> | null) => string;
+/** The symbol written before amounts in `code`, e.g. '₹' or 'S$'. */
+export declare const currencySymbol: (code?: string | null) => string;
+/**
+ * `amount` with `code`'s digit grouping and a fixed number of decimals, no
+ * symbol: 123456.5 is '1,23,456.50' in INR and '123,456.50' in SGD.
+ */
+export declare const formatAmount: (amount: number, code?: string | null, decimals?: number) => string;
+/**
+ * `amount` with its symbol and `code`'s grouping, no space: 123456.5 is
+ * '₹1,23,456.50' in INR and 'S$123,456.50' in SGD (the alert emails' form).
+ */
+export declare const formatMoney: (amount: number, code?: string | null, decimals?: number) => string;
+/**
+ * `amount` in words for a document, upper case. INR is exactly
+ * convertToRupeesAndPaisa ('Rs. ONE HUNDRED RUPEES AND ZERO PAISE ONLY.');
+ * other currencies use international numbering
+ * ('S$ ONE HUNDRED SINGAPORE DOLLARS AND FIFTY CENTS ONLY.').
+ */
+export declare const amountInWords: (amount: number, code?: string | null) => string;
+/**
+ * The only currency the payment, e-invoicing and ERP integrations handle
+ * today: CCAvenue and Razorpay are called with INR, Cleartax files Indian GST
+ * e-invoices (IRN), QUp is told the fare is INR and the D365 imports carry
+ * CURRENCYCODE INR. A company billing in anything else must not reach them,
+ * or its amounts would be charged or booked as rupees.
+ */
+export declare const INR_ONLY_CURRENCY = "INR";
+/**
+ * True when a company bills in INR. A missing or unsupported code counts as
+ * INR, as companyCurrency() reads it, so every company from before currencies
+ * existed behaves exactly as it did.
+ */
+export declare const isInrCompany: (currency?: string | null) => boolean;
+/** Names of INR-only features, for inrOnlyMessage / assertInrCompany. */
+export declare const InrOnlyFeature: {
+    readonly OnlinePayments: "Online payments";
+    readonly StandingInstructions: "Standing instructions";
+    readonly GstEInvoices: "GST e-invoices (IRN)";
+    readonly QupFareUpdates: "QUp fare updates";
+    readonly ErpImports: "D365 import sheets";
+};
+/**
+ * Why `feature` is refused for a non-INR company, e.g. "Online payments are
+ * not available for SGD companies yet."
+ */
+export declare const inrOnlyMessage: (currency: string | null | undefined, feature: string) => string;
+/** Throws inrOnlyMessage(currency, feature) unless the company bills in INR. */
+export declare const assertInrCompany: (currency: string | null | undefined, feature: string) => void;

package/src/lib/utilities/src/money.js

@@ -0,0 +1,123 @@
+import { BusinessContextOwnerField, } from '@autologix/shared/models';
+import { DEFAULT_CURRENCY } from '@autologix/shared/enums';
+import { convertNumberToWordsInternational, convertToRupeesAndPaisa, } from './amount.in.words';
+/**
+ * The currencies companies can bill in. INR matches what India-only code
+ * printed before currencies existed, so Indian output is unchanged.
+ */
+export const CURRENCY_META = {
+    INR: {
+        code: 'INR',
+        symbol: '₹',
+        abbrev: 'Rs.',
+        locale: 'en-IN',
+        major: 'rupees',
+        minor: 'paise',
+        numbering: 'indian',
+    },
+    SGD: {
+        code: 'SGD',
+        symbol: 'S$',
+        abbrev: 'S$',
+        locale: 'en-SG',
+        major: 'Singapore dollars',
+        minor: 'cents',
+        numbering: 'international',
+    },
+};
+/** True for a currency code this platform can bill in. */
+export const isSupportedCurrency = (code) => !!code && Object.prototype.hasOwnProperty.call(CURRENCY_META, code);
+/** `code`'s formatting rules; INR's for a missing or unsupported code. */
+export const currencyMeta = (code) => CURRENCY_META[isSupportedCurrency(code) ? code : DEFAULT_CURRENCY];
+/**
+ * A company's currency from its row, INR when missing or unsupported (rows
+ * read before the column existed, or a partial select without it).
+ */
+export const companyCurrency = (company) => {
+    const code = company?.[BusinessContextOwnerField.Currency];
+    return isSupportedCurrency(code) ? code : DEFAULT_CURRENCY;
+};
+/** The symbol written before amounts in `code`, e.g. '₹' or 'S$'. */
+export const currencySymbol = (code) => currencyMeta(code).symbol;
+/**
+ * `amount` with `code`'s digit grouping and a fixed number of decimals, no
+ * symbol: 123456.5 is '1,23,456.50' in INR and '123,456.50' in SGD.
+ */
+export const formatAmount = (amount, code, decimals = 2) => new Intl.NumberFormat(currencyMeta(code).locale, {
+    minimumFractionDigits: decimals,
+    maximumFractionDigits: decimals,
+}).format(amount);
+/**
+ * `amount` with its symbol and `code`'s grouping, no space: 123456.5 is
+ * '₹1,23,456.50' in INR and 'S$123,456.50' in SGD (the alert emails' form).
+ */
+export const formatMoney = (amount, code, decimals = 2) => {
+    const meta = currencyMeta(code);
+    return `${meta.symbol}${amount.toLocaleString(meta.locale, {
+        minimumFractionDigits: decimals,
+        maximumFractionDigits: decimals,
+    })}`;
+};
+/**
+ * `amount` in words for a document, upper case. INR is exactly
+ * convertToRupeesAndPaisa ('Rs. ONE HUNDRED RUPEES AND ZERO PAISE ONLY.');
+ * other currencies use international numbering
+ * ('S$ ONE HUNDRED SINGAPORE DOLLARS AND FIFTY CENTS ONLY.').
+ */
+export const amountInWords = (amount, code) => {
+    const meta = currencyMeta(code);
+    if (meta.numbering === 'indian')
+        return convertToRupeesAndPaisa(amount);
+    if (amount === null || amount === undefined || !Number.isFinite(amount)) {
+        return `${meta.abbrev} ZERO ${meta.major} AND ZERO ${meta.minor} ONLY.`.toUpperCase();
+    }
+    const absolute = Math.abs(amount);
+    let major = Math.floor(absolute);
+    let minor = Math.round((absolute - major) * 100);
+    // 1.999 rounds to 100 cents: carry it rather than print "100 cents".
+    if (minor === 100) {
+        major += 1;
+        minor = 0;
+    }
+    // Signed after rounding: -0.001 is zero, not "(-) ZERO ... ZERO CENTS".
+    const prefix = amount < 0 && (major > 0 || minor > 0)
+        ? `(-)${meta.abbrev} `
+        : `${meta.abbrev} `;
+    const words = `${convertNumberToWordsInternational(major)} ${meta.major} and ${convertNumberToWordsInternational(minor)} ${meta.minor} only.`;
+    return `${prefix}${words.toUpperCase()}`;
+};
+/**
+ * The only currency the payment, e-invoicing and ERP integrations handle
+ * today: CCAvenue and Razorpay are called with INR, Cleartax files Indian GST
+ * e-invoices (IRN), QUp is told the fare is INR and the D365 imports carry
+ * CURRENCYCODE INR. A company billing in anything else must not reach them,
+ * or its amounts would be charged or booked as rupees.
+ */
+export const INR_ONLY_CURRENCY = 'INR';
+/**
+ * True when a company bills in INR. A missing or unsupported code counts as
+ * INR, as companyCurrency() reads it, so every company from before currencies
+ * existed behaves exactly as it did.
+ */
+export const isInrCompany = (currency) => (isSupportedCurrency(currency) ? currency : DEFAULT_CURRENCY) ===
+    INR_ONLY_CURRENCY;
+/** Names of INR-only features, for inrOnlyMessage / assertInrCompany. */
+export const InrOnlyFeature = {
+    OnlinePayments: 'Online payments',
+    StandingInstructions: 'Standing instructions',
+    GstEInvoices: 'GST e-invoices (IRN)',
+    QupFareUpdates: 'QUp fare updates',
+    ErpImports: 'D365 import sheets',
+};
+/**
+ * Why `feature` is refused for a non-INR company, e.g. "Online payments are
+ * not available for SGD companies yet."
+ */
+export const inrOnlyMessage = (currency, feature) => `${feature} are not available for ${currency} companies yet.`;
+/** Throws inrOnlyMessage(currency, feature) unless the company bills in INR. */
+export const assertInrCompany = (currency, feature) => {
+    if (!isInrCompany(currency)) {
+        throw new Error(inrOnlyMessage(currency, feature));
+    }
+};
+//# sourceMappingURL=money.js.map

package/src/lib/utilities/src/money.js.map

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

package/src/lib/utilities/src/show.cust.usage.dtls.d.ts

@@ -0,0 +1,15 @@
+import { IBillingMethods } from '@autologix/shared/models';
+/**
+ * ZD-72175: whether a client's duty slips show the customer usage details
+ * (pickup/drop-off KMs and times, G2P/P2D/D2G KMs).
+ *
+ * Stored as `ClientPersona.billMthd.showCustUsageDtls`. Avis turns it off for
+ * selected customers; every existing client never had the key, so a missing or
+ * null value means Yes. Only an explicit `false` hides the section.
+ */
+export declare const showsCustUsageDtls: (billMthd?: Partial<IBillingMethods> | null) => boolean;
+/**
+ * The value sent to MMI as `ShowCustUsageDtls` on the booking push and the
+ * agreement-detail pull. Same Y/N convention as `RouteDetlReq`.
+ */
+export declare const showCustUsageDtlsFlag: (billMthd?: Partial<IBillingMethods> | null) => "Y" | "N";

package/src/lib/utilities/src/show.cust.usage.dtls.js

@@ -0,0 +1,16 @@
+import { ClientPersonaField } from '@autologix/shared/models';
+/**
+ * ZD-72175: whether a client's duty slips show the customer usage details
+ * (pickup/drop-off KMs and times, G2P/P2D/D2G KMs).
+ *
+ * Stored as `ClientPersona.billMthd.showCustUsageDtls`. Avis turns it off for
+ * selected customers; every existing client never had the key, so a missing or
+ * null value means Yes. Only an explicit `false` hides the section.
+ */
+export const showsCustUsageDtls = (billMthd) => billMthd?.[ClientPersonaField.ShowCustUsageDtls] !== false;
+/**
+ * The value sent to MMI as `ShowCustUsageDtls` on the booking push and the
+ * agreement-detail pull. Same Y/N convention as `RouteDetlReq`.
+ */
+export const showCustUsageDtlsFlag = (billMthd) => (showsCustUsageDtls(billMthd) ? 'Y' : 'N');
+//# sourceMappingURL=show.cust.usage.dtls.js.map

package/src/lib/utilities/src/show.cust.usage.dtls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.cust.usage.dtls.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/show.cust.usage.dtls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAmB,MAAM,0BAA0B,CAAC;AAE/E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CACjC,QAA0C,EAChC,EAAE,CAAC,QAAQ,EAAE,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,KAAK,KAAK,CAAC;AAEzE;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACpC,QAA0C,EAC9B,EAAE,CAAC,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC"}

package/src/lib/utilities/src/singapore.phone.number.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Singapore (+65) phone numbers, accepted alongside the Indian (+91) ones the
+ * platform was built around.
+ *
+ * A Singapore number is `+65` and eight digits: mobiles start 8 or 9,
+ * landlines 6, VoIP 3. It is stored the same way an Indian one is, in E.164
+ * (`+6591234567`), so nothing that reads a stored number has to learn a new
+ * shape.
+ *
+ * Only a number that SAYS it is Singaporean is treated as one: a leading `+65`
+ * (or the `0065` international trunk spelling). A bare `6591234567` is ten
+ * digits and a perfectly valid Indian mobile, and a bare `91234567` is eight
+ * digits that every India-first rule in the codebase would mangle or reject —
+ * guessing either way would move a number to the wrong person. Callers that
+ * know the company is Singaporean compose the `+65` themselves.
+ *
+ * Every helper here returns null / false for anything that is not a Singapore
+ * number, so `toSingaporePhoneNumber(x) ?? <existing India rule>(x)` leaves the
+ * India behaviour exactly as it was.
+ */
+export declare const INDIA_DIAL_CODE = "+91";
+export declare const SINGAPORE_DIAL_CODE = "+65";
+/**
+ * True when `phone` is a Singapore number already in stored (E.164) form,
+ * e.g. `+6591234567`. Decorated spellings (`+65 9123 4567`) are not — use
+ * {@link toSingaporePhoneNumber} to normalise those first.
+ */
+export declare function isSingaporePhoneNumber(phone: unknown): boolean;
+/**
+ * The E.164 form of a value that explicitly carries the Singapore country code
+ * (`+65 9123 4567`, `+65-91234567`, `(+65) 9123-4567`, `0065 91234567`), or
+ * null for anything else — including bare digits, which are left to the
+ * existing India rules.
+ */
+export declare function toSingaporePhoneNumber(phone: string | number | null | undefined): string | null;
+/**
+ * Whether a phone may be used to sign in or reset a password. India's rule is
+ * unchanged — anything starting `+91` passes here, as it did — and a Singapore
+ * number in E.164 is accepted alongside it.
+ */
+export declare function isAcceptedLoginPhone(phone: string | null | undefined): boolean;
+/**
+ * A driver mobile as the driver create / modify / bulk paths store it: a
+ * Singapore number in E.164; otherwise their rule from before +65, unchanged —
+ * a 13-character value (`+91` and ten digits) as is, anything else with `+91`
+ * in front. (Without the Singapore check, `+6591234567` is 11 characters and
+ * became `+91+6591234567`.)
+ */
+export declare function toStoredDriverMobile(mobile: string): string;
+/**
+ * `+91` in front of a value the caller holds as a bare Indian number — unless
+ * the value is already a Singapore number, which is returned normalised
+ * instead of becoming `+91+6591234567` (which a WhatsApp send strips to the
+ * Indian `916591234567`: somebody else's phone).
+ */
+export declare function withIndianDialCode(phone: string): string;

package/src/lib/utilities/src/singapore.phone.number.js

@@ -0,0 +1,90 @@
+/**
+ * Singapore (+65) phone numbers, accepted alongside the Indian (+91) ones the
+ * platform was built around.
+ *
+ * A Singapore number is `+65` and eight digits: mobiles start 8 or 9,
+ * landlines 6, VoIP 3. It is stored the same way an Indian one is, in E.164
+ * (`+6591234567`), so nothing that reads a stored number has to learn a new
+ * shape.
+ *
+ * Only a number that SAYS it is Singaporean is treated as one: a leading `+65`
+ * (or the `0065` international trunk spelling). A bare `6591234567` is ten
+ * digits and a perfectly valid Indian mobile, and a bare `91234567` is eight
+ * digits that every India-first rule in the codebase would mangle or reject —
+ * guessing either way would move a number to the wrong person. Callers that
+ * know the company is Singaporean compose the `+65` themselves.
+ *
+ * Every helper here returns null / false for anything that is not a Singapore
+ * number, so `toSingaporePhoneNumber(x) ?? <existing India rule>(x)` leaves the
+ * India behaviour exactly as it was.
+ */
+export const INDIA_DIAL_CODE = '+91';
+export const SINGAPORE_DIAL_CODE = '+65';
+/** Eight digits, starting 3 (VoIP), 6 (landline), 8 or 9 (mobile). */
+const SINGAPORE_SUBSCRIBER = /^[3689]\d{7}$/;
+/** Already-normalised E.164 Singapore number. */
+const SINGAPORE_E164 = /^\+65[3689]\d{7}$/;
+/**
+ * True when `phone` is a Singapore number already in stored (E.164) form,
+ * e.g. `+6591234567`. Decorated spellings (`+65 9123 4567`) are not — use
+ * {@link toSingaporePhoneNumber} to normalise those first.
+ */
+export function isSingaporePhoneNumber(phone) {
+    return typeof phone === 'string' && SINGAPORE_E164.test(phone);
+}
+/**
+ * The E.164 form of a value that explicitly carries the Singapore country code
+ * (`+65 9123 4567`, `+65-91234567`, `(+65) 9123-4567`, `0065 91234567`), or
+ * null for anything else — including bare digits, which are left to the
+ * existing India rules.
+ */
+export function toSingaporePhoneNumber(phone) {
+    if (phone === null || phone === undefined)
+        return null;
+    // Brackets, spaces, dots and hyphens are decoration; the `+` is not.
+    const marker = String(phone)
+        .trim()
+        .replace(/[^\d+]/g, '');
+    let subscriber;
+    if (marker.startsWith('+65'))
+        subscriber = marker.slice(3);
+    else if (marker.startsWith('0065'))
+        subscriber = marker.slice(4);
+    else
+        return null;
+    return SINGAPORE_SUBSCRIBER.test(subscriber)
+        ? `${SINGAPORE_DIAL_CODE}${subscriber}`
+        : null;
+}
+/**
+ * Whether a phone may be used to sign in or reset a password. India's rule is
+ * unchanged — anything starting `+91` passes here, as it did — and a Singapore
+ * number in E.164 is accepted alongside it.
+ */
+export function isAcceptedLoginPhone(phone) {
+    if (typeof phone !== 'string')
+        return false;
+    return (phone.substring(0, 3) === INDIA_DIAL_CODE ||
+        isSingaporePhoneNumber(phone));
+}
+/**
+ * A driver mobile as the driver create / modify / bulk paths store it: a
+ * Singapore number in E.164; otherwise their rule from before +65, unchanged —
+ * a 13-character value (`+91` and ten digits) as is, anything else with `+91`
+ * in front. (Without the Singapore check, `+6591234567` is 11 characters and
+ * became `+91+6591234567`.)
+ */
+export function toStoredDriverMobile(mobile) {
+    return (toSingaporePhoneNumber(mobile) ??
+        (mobile.length === 13 ? mobile : INDIA_DIAL_CODE + mobile));
+}
+/**
+ * `+91` in front of a value the caller holds as a bare Indian number — unless
+ * the value is already a Singapore number, which is returned normalised
+ * instead of becoming `+91+6591234567` (which a WhatsApp send strips to the
+ * Indian `916591234567`: somebody else's phone).
+ */
+export function withIndianDialCode(phone) {
+    return toSingaporePhoneNumber(phone) ?? INDIA_DIAL_CODE + phone;
+}
+//# sourceMappingURL=singapore.phone.number.js.map

package/src/lib/utilities/src/singapore.phone.number.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"singapore.phone.number.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/singapore.phone.number.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AACrC,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAEzC,sEAAsE;AACtE,MAAM,oBAAoB,GAAG,eAAe,CAAC;AAE7C,iDAAiD;AACjD,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAE3C;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACpD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACrC,KAAyC;IAEzC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACvD,qEAAqE;IACrE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC;SAC1B,IAAI,EAAE;SACN,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACzB,IAAI,UAAkB,CAAC;IACvB,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SACtD,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;;QAC5D,OAAO,IAAI,CAAC;IACjB,OAAO,oBAAoB,CAAC,IAAI,CAAC,UAAU,CAAC;QAC3C,CAAC,CAAC,GAAG,mBAAmB,GAAG,UAAU,EAAE;QACvC,CAAC,CAAC,IAAI,CAAC;AACT,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CACnC,KAAgC;IAEhC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,CACN,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,eAAe;QACzC,sBAAsB,CAAC,KAAK,CAAC,CAC7B,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IAClD,OAAO,CACN,sBAAsB,CAAC,MAAM,CAAC;QAC9B,CAAC,MAAM,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,GAAG,MAAM,CAAC,CAC1D,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC/C,OAAO,sBAAsB,CAAC,KAAK,CAAC,IAAI,eAAe,GAAG,KAAK,CAAC;AACjE,CAAC"}

package/src/lib/view-models/src/view.models.d.ts

@@ -85,6 +85,8 @@ export interface ContextListItem {
     dbAuditLogsEnabled?: boolean;
     /** IANA timezone of the company (BusinessContextOwner.timezone), e.g. 'Asia/Singapore'. */
     timezone?: string;
+    /** ISO 4217 currency of the company (BusinessContextOwner.currency), e.g. 'SGD'. */
+    currency?: string;
 }
 export interface IDriverDashBoardData {
     distance: number;