@zeniai/client-epic-state 5.1.43-betaRD1 → 5.1.43-betaRD3

package/lib/esm/__testHelpers__/apiFailure.json

@@ -0,0 +1,6 @@
+{
+    "status": {
+        "message": "Internal server error",
+        "code": 500
+    }
+}

package/lib/esm/common/aiCfo/aiCfoSuggestedQuestionsPageContext.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/commonPayloadTypes/agingReportPayloadTypes.js

@@ -0,0 +1,24 @@
+import { toTransactionType } from '../entity/transaction/stateTypes/transactionType';
+import { date } from '../zeniDayJS';
+export function toAgingReportInvoice(invoice, entityId, currency) {
+    const result = {
+        invoiceNumber: invoice.invoice_number,
+        date: date(invoice.tx_date),
+        dueDate: invoice.due_date != null ? date(invoice.due_date) : null,
+        daysPastDue: invoice.days_past_due,
+        amount: {
+            amount: invoice.amount,
+            currencyCode: currency.currencyCode,
+            currencySymbol: currency.currencySymbol,
+        },
+        balance: {
+            amount: invoice.balance_due,
+            currencyCode: currency.currencyCode,
+            currencySymbol: currency.currencySymbol,
+        },
+        transactionId: invoice.transaction_id,
+        transactionType: toTransactionType(invoice.transaction_type),
+        entityId,
+    };
+    return result;
+}

package/lib/esm/commonPayloadTypes/balanceChangePayload.js

@@ -0,0 +1,20 @@
+import { toAmount } from '../commonStateTypes/amount';
+import { date } from '../zeniDayJS';
+export const mapBalancePayloadToBalance = (payload) => ({
+    available: toAmount(payload.available ?? 0, payload.currency_code, payload.currency_symbol),
+    change: payload.change
+        ? mapBalanceChangePayloadToBalanceChange(payload.change)
+        : undefined,
+});
+const mapBalanceChangePayloadToBalanceChange = (payload) => ({
+    available: payload.available != null
+        ? toAmount(payload.available, payload.currency_code, payload.currency_symbol)
+        : undefined,
+    availablePercent: payload.available_percent,
+    since: date(payload.since),
+    percent: payload.percent,
+    current: payload.current == null
+        ? undefined
+        : toAmount(payload.current, payload.currency_code, payload.currency_symbol),
+    currentPercent: payload.current_percent,
+});

package/lib/esm/commonPayloadTypes/classesView/reportByClassPayloadV2.js

@@ -0,0 +1,9 @@
+export {};
+/*
+ToDo:: Define this type individually for each report if platform is not supporting this.
+interface PandLReportByClassPayload {
+  metadata: ReportByClassMetadataPayload;
+  sections: Record<string, SectionByClassCOABalanceGroupedPayload>; // Record<section_id, SectionCOABalanceGroupedPayload>
+  calculated_sections: Record<string, COABalanceGroupedByPeriodPayload>; // Record<calcualted_section_id, COABalanceGroupedByPeriodPayload>
+}
+*/

package/lib/esm/commonPayloadTypes/coaBalanceByAdditionalPeriodPayload.js

@@ -0,0 +1,10 @@
+import { mapCOABalanceGroupedPayloadToCOABalanceGrouped, mapCOABalancePayloadToCOABalance, } from './coaBalancePayload';
+export const toCOABalanceByAdditionalPeriodGrouped = (payload) => ({
+    ...mapCOABalanceGroupedPayloadToCOABalanceGrouped(payload),
+    last30DaysMonths: payload.last_30_days_months != null
+        ? payload.last_30_days_months.map((p) => mapCOABalancePayloadToCOABalance(p, 'month'))
+        : [],
+    last90DaysMonths: payload.last_90_days_months != null
+        ? payload.last_90_days_months.map((p) => mapCOABalancePayloadToCOABalance(p, 'month'))
+        : [],
+});

package/lib/esm/commonPayloadTypes/coaBalancePayload.js

@@ -0,0 +1,57 @@
+import { toAmount } from '../commonStateTypes/amount';
+import { date } from '../zeniDayJS';
+/**
+ * map COABalance Payload to COABalance
+ * @param payload COABalance payload JSON
+ * @param timeframe COABalance timeframe, default: 'free_range'
+ * @param type COABalance type, default: 'default'
+ * @returns COA Balance
+ */
+export const mapCOABalancePayloadToCOABalance = (payload, timeframe = 'free_range', type = 'default') => {
+    return {
+        balance: toAmount(payload.balance.available ?? 0, payload.balance.currency_code, payload.balance.currency_symbol),
+        forecast: 'forecast' in payload.balance
+            ? toAmount(payload.balance.forecast ?? 0, payload.balance.currency_code, payload.balance.currency_symbol)
+            : undefined,
+        balanceTimeFrame: timeframe,
+        type: type,
+        startDate: date(payload.start_date),
+        endDate: date(payload.end_date),
+        id: payload.id,
+        label: payload.label ?? '',
+        sourceAccountIDs: payload.account_ids,
+    };
+};
+export const mapCOABalanceGroupedPayloadToCOABalanceGrouped = (payload) => ({
+    weeks: payload.weeks?.map((p) => mapCOABalancePayloadToCOABalance(p, 'week')),
+    months: payload.months?.map((p) => mapCOABalancePayloadToCOABalance(p, 'month')),
+    quarters: payload.quarters?.map((p) => mapCOABalancePayloadToCOABalance(p, 'quarter')),
+    years: payload?.years?.map((p) => mapCOABalancePayloadToCOABalance(p, 'year')),
+    totals: {
+        weeks: payload.totals?.weeks == null ||
+            Object.keys(payload.totals?.weeks).length === 0
+            ? undefined
+            : mapCOABalancePayloadToCOABalance(payload.totals.weeks),
+        months: payload.totals?.months == null ||
+            Object.keys(payload.totals?.months).length === 0
+            ? undefined
+            : mapCOABalancePayloadToCOABalance(payload.totals.months),
+        quarters: payload.totals?.quarters == null ||
+            Object.keys(payload.totals?.quarters).length === 0
+            ? undefined
+            : mapCOABalancePayloadToCOABalance(payload.totals.quarters),
+        years: payload.totals?.years == null ||
+            Object.keys(payload.totals?.years).length === 0
+            ? undefined
+            : mapCOABalancePayloadToCOABalance(payload.totals.years),
+    },
+});
+export const mapCOABalanceGroupedWithIDsPayloadToCOABalanceGroupedWithIDs = (payload) => ({
+    accountGroupIDs: payload.account_group_ids ?? [],
+    accountIDs: payload.account_ids ?? [],
+    ...mapCOABalanceGroupedPayloadToCOABalanceGrouped(payload),
+});
+export const mapCOABalanceGroupedWithAccountIDsPayloadToCOABalanceGroupedWithAccountIDs = (payload) => ({
+    accountIDs: payload.account_ids,
+    ...mapCOABalanceGroupedPayloadToCOABalanceGrouped(payload),
+});

package/lib/esm/commonPayloadTypes/commonPayload.js

@@ -0,0 +1,17 @@
+export function isAllowedValueWithCodePayload(allowedValueWithCodePayload // eslint-disable-line @typescript-eslint/no-explicit-any
+) {
+    return (isAllowedValueWithCodeOptionalPayload(allowedValueWithCodePayload) &&
+        allowedValueWithCodePayload.code != null &&
+        allowedValueWithCodePayload.name != null);
+}
+export function isAllowedValueWithCodeOptionalPayload(allowedValueWithCodePayload // eslint-disable-line @typescript-eslint/no-explicit-any
+) {
+    return ((Object.keys(allowedValueWithCodePayload) ??
+        []).includes('code') &&
+        (Object.keys(allowedValueWithCodePayload) ??
+            []).includes('name'));
+}
+// This helper is useful if we have any difference in AllowedValueWithCode from AllowedValueWithCodePayload
+export function toAllowedValueWithCode(allowedValueWithCodePayload) {
+    return allowedValueWithCodePayload;
+}

package/lib/esm/commonPayloadTypes/recommendationPayload.js

@@ -0,0 +1,44 @@
+import { toRecommendedAccountBasePayload, } from '../entity/account/accountPayload';
+import { toRecommendedClassBasePayload, } from '../entity/class/classPayload';
+export const toRecommendationBase = (payload) => {
+    return {
+        max: payload.max,
+        min: payload.min,
+        reason: payload.reason ?? '',
+        type: payload.type,
+        recommendationHash: payload.recommendation_hash,
+    };
+};
+export const toRecommendationBasePayload = (base) => {
+    return {
+        max: base.max,
+        min: base.min ?? 0,
+        reason: base.reason ?? undefined,
+        type: base.type,
+    };
+};
+export const toRecommendationPayload = (recommendation) => {
+    return {
+        account: recommendation.account != null
+            ? toRecommendedAccountBasePayload(recommendation.account)
+            : undefined,
+        accounting_class: recommendation.class != null
+            ? toRecommendedClassBasePayload(recommendation.class)
+            : undefined,
+    };
+};
+export const toRecommendedVendorBasePayload = (vendorRecommendation) => {
+    return {
+        vendor_name: vendorRecommendation.name,
+        vendor_name_confidence: vendorRecommendation.vendorNameConfidence,
+        third_party_merchant_id: vendorRecommendation.thirdPartyMerchantId,
+        vendor_id: vendorRecommendation.id ?? null,
+        qbo_id: vendorRecommendation.qboId ?? null,
+        reason: vendorRecommendation.reason,
+        logo: {
+            url: vendorRecommendation.logo?.toString(),
+            base64: null,
+        },
+        website_url: vendorRecommendation.websiteUrl?.toString() ?? null,
+    };
+};

package/lib/esm/commonPayloadTypes/sortOrderPayload.js

@@ -0,0 +1,6 @@
+export const mapSortOrderPayloadToSortOrder = (sortOrderPayload) => {
+    return sortOrderPayload === 'asc' ? 'ascending' : 'descending';
+};
+export const getSortOrder = (sortOrder) => {
+    return sortOrder === 'ascending' ? 'asc' : 'desc';
+};

package/lib/esm/commonPayloadTypes/statusPayload.js

@@ -0,0 +1,13 @@
+import { date } from '../zeniDayJS';
+export const mapStatusPayloadToStatus = (payload) => ({
+    code: payload.code,
+    description: payload.description,
+    message: payload.message,
+    lastRefreshAttemptTime: payload.last_refresh_attempt_time != null
+        ? date(payload.last_refresh_attempt_time)
+        : undefined,
+    lastRefreshSuccessTime: payload.last_refresh_success_time != null
+        ? date(payload.last_refresh_success_time)
+        : undefined,
+    isFilteredReport: payload.is_filtered_report,
+});

package/lib/esm/commonPayloadTypes/subAccountView/reportBySubAccountPayload.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/commonPayloadTypes/subAccountView/subAccountPayloadHelper.js

@@ -0,0 +1,24 @@
+import { getParentAccountId } from '../../commonStateTypes/accountView/getNestedAccountIDHierarchyForReport';
+export const getSubAccountsMetadataForAccountList = (accountListWithBalances, accountMetadataRecordsByID, sectionId, classesViewParentID) => {
+    const accountMetadataWithBalances = [];
+    if (accountListWithBalances != null) {
+        Object.keys(accountListWithBalances).forEach((eachAccountId) => {
+            const accountId = accountMetadataRecordsByID[eachAccountId]?.nestedAccountId;
+            if (accountId != null) {
+                accountMetadataWithBalances.push({
+                    accountsViewParentID: {
+                        parentAccountId: getParentAccountId(accountId),
+                        sectionId,
+                    },
+                    accountMetadataPayload: accountMetadataRecordsByID[eachAccountId].accountMetadataPayload,
+                    accountBalancesPayload: accountListWithBalances[eachAccountId],
+                    classesViewParentID: classesViewParentID,
+                });
+            }
+            else {
+                console.warn(`Account ${eachAccountId} in Section ${sectionId} is missing metadata.`);
+            }
+        });
+    }
+    return accountMetadataWithBalances;
+};

package/lib/esm/commonPayloadTypes/urlPayload.js

@@ -0,0 +1,4 @@
+import { toZeniUrl } from '../zeniUrl';
+export const toURL = (urlPayload) => urlPayload?.url != null && urlPayload?.url.length !== 0
+    ? toZeniUrl(urlPayload.url)
+    : undefined;

package/lib/esm/commonPayloadTypes/v2/coaBalancePayload.js

@@ -0,0 +1,96 @@
+import { toAmount } from '../../commonStateTypes/amount';
+import { date } from '../../zeniDayJS';
+/**
+ * map COABalanceV2 Payload to COABalance
+ * @param payload COABalance payload JSON
+ * @param timeframe COABalance timeframe, default: 'free_range'
+ * @param type COABalance type, default: 'default'
+ * @returns COA Balance
+ */
+export const mapCOABalancePayloadV2ToCOABalance = (payload, currencyPayload, timeframe = 'free_range', type = 'default') => {
+    return {
+        balance: toAmount(payload.amount.value ?? 0, currencyPayload.currency_code, currencyPayload.currency_symbol),
+        totalBalance: toAmount(payload.amount.total_value ?? 0, currencyPayload.currency_code, currencyPayload.currency_symbol),
+        forecast: payload.amount.forecast_value != null
+            ? toAmount(payload.amount.forecast_value ?? 0, currencyPayload.currency_code, currencyPayload.currency_symbol)
+            : undefined,
+        // If forecast amount isnt present, we dont need the total forecast
+        totalForecast: payload.amount.total_forecast_value != null
+            ? toAmount(payload.amount.total_forecast_value ?? 0, currencyPayload.currency_code, currencyPayload.currency_symbol)
+            : undefined,
+        balanceTimeFrame: timeframe,
+        type: type === 'default' && payload.amount.value == null
+            ? 'default_with_null_balance'
+            : type,
+        startDate: date(payload.start_date),
+        endDate: date(payload.end_date),
+        id: payload.id,
+        label: payload.label ?? '',
+        sourceAccountIDs: payload.account_ids,
+    };
+};
+export const mapCOABalanceGroupedPayloadV2ToCOABalanceGrouped = (payload, currencyPayload, timeframe) => {
+    switch (timeframe) {
+        case 'month':
+            return {
+                months: payload.months?.map((p) => mapCOABalancePayloadV2ToCOABalance(p, currencyPayload, 'month')),
+                totals: {
+                    months: payload.totals?.months == null ||
+                        Object.keys(payload.totals?.months).length === 0
+                        ? undefined
+                        : mapCOABalancePayloadV2ToCOABalance(payload.totals.months, currencyPayload, timeframe, 'period_total'),
+                },
+            };
+        case 'quarter':
+            return {
+                quarters: payload.quarters?.map((p) => mapCOABalancePayloadV2ToCOABalance(p, currencyPayload, 'quarter')),
+                totals: {
+                    quarters: payload.totals?.quarters == null ||
+                        Object.keys(payload.totals?.quarters).length === 0
+                        ? undefined
+                        : mapCOABalancePayloadV2ToCOABalance(payload.totals.quarters, currencyPayload, timeframe, 'period_total'),
+                },
+            };
+        case 'year':
+            return {
+                years: payload.years?.map((p) => mapCOABalancePayloadV2ToCOABalance(p, currencyPayload, 'year')),
+                totals: {
+                    years: payload.totals?.years == null ||
+                        Object.keys(payload.totals?.years).length === 0
+                        ? undefined
+                        : mapCOABalancePayloadV2ToCOABalance(payload.totals.years, currencyPayload, timeframe, 'period_total'),
+                },
+            };
+    }
+};
+export const mapCOABalanceGroupedByPeriodPayloadV2ToCOABalanceGroupedByPeriod = (payload, currencyPayload, timeframe) => {
+    switch (timeframe) {
+        case 'month':
+            return {
+                months: payload.months?.map((p) => mapCOABalancePayloadV2ToCOABalance(p, currencyPayload, 'month')),
+            };
+        case 'quarter':
+            return {
+                quarters: payload.quarters?.map((p) => mapCOABalancePayloadV2ToCOABalance(p, currencyPayload, 'quarter')),
+            };
+        case 'year':
+            return {
+                years: payload.years?.map((p) => mapCOABalancePayloadV2ToCOABalance(p, currencyPayload, 'year')),
+            };
+    }
+};
+/**
+ * Use this function to combine months/quarters/years coa payloads which
+ * also have totals in them
+ * @param payloadA
+ * @param payloadB
+ * @returns
+ */
+export const combineCOABalanceGrouped = (payloadA, payloadB) => {
+    const combinedTotals = Object.assign({}, payloadA.totals, payloadB.totals);
+    const combinedTimeframes = Object.assign({}, payloadA, payloadB);
+    const finalBalances = Object.assign({}, combinedTimeframes, {
+        totals: combinedTotals,
+    });
+    return finalBalances;
+};

package/lib/esm/commonPayloadTypes/v2/viewAndReportPayloadv2.js

@@ -0,0 +1,25 @@
+import { getMonthFromMonthName } from '../../commonStateTypes/timePeriod';
+import { toReportID } from '../../commonStateTypes/viewAndReport/viewAndReport';
+import { date } from '../../zeniDayJS';
+import { mapViewPayloadToView } from '../viewAndReportPayload';
+export const mapCurrencyPayloadToCurrency = (payload) => {
+    return {
+        currencyCode: payload.currency_code,
+        currencySymbol: payload.currency_symbol,
+    };
+};
+export const mapReportPayloadV2ToReportV2 = (payload) => ({
+    ...mapViewPayloadToView(payload),
+    currency: mapCurrencyPayloadToCurrency(payload.currency),
+    reportId: toReportID(payload.report_id),
+    reportTitle: payload.report_title,
+    dataAvailable: payload.data_available_start_date != null &&
+        payload.data_available_end_date != null
+        ? {
+            startDate: date(payload.data_available_start_date),
+            endDate: date(payload.data_available_end_date),
+        }
+        : undefined,
+    firstMonthOfFY: getMonthFromMonthName(payload.first_month_of_fiscal_year) ?? 1,
+    bookCloseDate: payload.book_close_date != null ? date(payload.book_close_date) : undefined,
+});

package/lib/esm/commonPayloadTypes/vendorRecommendationPayload.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/commonPayloadTypes/viewAndReportPayload.js

@@ -0,0 +1,22 @@
+import { getMonthFromMonthName } from '../commonStateTypes/timePeriod';
+import { toReportID, } from '../commonStateTypes/viewAndReport/viewAndReport';
+import { date } from '../zeniDayJS';
+import { mapStatusPayloadToStatus } from './statusPayload';
+export const mapViewPayloadToView = (payload) => ({
+    status: mapStatusPayloadToStatus(payload.status),
+    version: payload.version,
+});
+export const mapReportPayloadToReport = (payload) => ({
+    ...mapViewPayloadToView(payload),
+    reportId: toReportID(payload.report_id),
+    reportTitle: payload.report_title,
+    dataAvailable: payload.data_available_start_date != null &&
+        payload.data_available_end_date != null
+        ? {
+            startDate: date(payload.data_available_start_date),
+            endDate: date(payload.data_available_end_date),
+        }
+        : undefined,
+    firstMonthOfFY: getMonthFromMonthName(payload.first_month_of_fiscal_year) ?? 1,
+    bookCloseDate: payload.book_close_date != null ? date(payload.book_close_date) : undefined,
+});

package/lib/esm/commonStateTypes/accountView/getNestedAccountIDHierarchyForReport.js

@@ -0,0 +1,108 @@
+import { mapAccountMetadataPayloadToAccountMetadata, } from '../../entity/account/accountPayload';
+/**
+ * This function builds the hierarchy which is used to display all accounts
+ * in the selection view
+ * @param accountsMetadata
+ * @returns
+ */
+export function geNestedAccountIDHierarchyForReport(accountsMetadata) {
+    const parentAccounts = [];
+    accountsMetadata.forEach((accountMeta) => {
+        if (accountMeta.isSubAccount === false ||
+            // look for its parent in the entire metadata. If not found, then push this also as a rootNode
+            accountsMetadata.find((eachAccount) => eachAccount.accountId === accountMeta.parentAccountId) == null) {
+            parentAccounts.push(accountMeta);
+        }
+    });
+    const nestedParents = parentAccounts.map((parentAccount) => {
+        const accountId = parentAccount.accountId;
+        return {
+            accountId: [accountId],
+            accountName: parentAccount.accountName,
+            qboId: parentAccount.qboId,
+            children: getNestedChildren([accountId], accountsMetadata),
+            hasSiblings: parentAccounts.length > 1,
+            coaId: parentAccount.coaId,
+            isBillEditableCoaAccountType: parentAccount.isBillEditableCoaAccountType,
+            isDeleted: parentAccount.isDeleted,
+        };
+    });
+    return nestedParents;
+}
+const getNestedChildren = (parentAccount, allAccounts) => {
+    const parentId = parentAccount[0];
+    const children = allAccounts.filter((eachAccount) => eachAccount.parentAccountId === parentId);
+    const nestedChildren = children.map((child) => {
+        const childId = [child.accountId, ...parentAccount];
+        return {
+            accountId: childId,
+            accountName: child.accountName,
+            qboId: child.qboId,
+            children: getNestedChildren(childId, allAccounts),
+            hasSiblings: children.length > 1,
+            coaId: child.coaId,
+            isBillEditableCoaAccountType: child.isBillEditableCoaAccountType,
+            isDeleted: child.isDeleted,
+        };
+    });
+    return nestedChildren;
+};
+/**
+ * Modified this function to remove recursion. The accounts metadata will ALWAYS be sorted such that all
+ * parent accounts of any will appear before any child account.
+ * @param accountId
+ * @param accountsMetadata
+ * @returns
+ */
+export function getNestedAccountIDForAccount(accountId, accountsMetadata) {
+    let nestedAccountId = undefined;
+    let toFindAccountId = accountId;
+    let toFindParentAccountId = undefined;
+    for (let index = accountsMetadata.length - 1; index >= 0; index--) {
+        if (accountsMetadata[index].accountId === toFindAccountId) {
+            nestedAccountId =
+                nestedAccountId == null
+                    ? [toFindAccountId]
+                    : [...nestedAccountId, toFindAccountId];
+            toFindParentAccountId = accountsMetadata[index].parentAccountId;
+            if (toFindParentAccountId == null) {
+                break;
+            }
+            else {
+                toFindAccountId = toFindParentAccountId;
+                toFindParentAccountId = undefined;
+            }
+        }
+    }
+    if (nestedAccountId == null) {
+        throw Error(`Cannot find accountId ${accountId} in account metadata`);
+    }
+    return nestedAccountId;
+}
+export const getParentAccountId = (accountId) => {
+    return accountId.length > 1
+        ? accountId.slice(1)
+        : undefined;
+};
+export const getAllAccountMetadataRecordsByID = (accountsMetadataPayload) => {
+    const accountMetadataRecords = {};
+    const accountMetadataRecordsPartial = {};
+    const accountsMetadata = accountsMetadataPayload != null
+        ? accountsMetadataPayload.map((accountPayload) => {
+            const accountMeta = mapAccountMetadataPayloadToAccountMetadata(accountPayload);
+            accountMetadataRecordsPartial[accountMeta.accountId] = Object.assign({}, {
+                payload: accountPayload,
+                meta: accountMeta,
+            });
+            return accountMeta;
+        })
+        : [];
+    accountsMetadata.forEach((accountMeta) => {
+        accountMetadataRecords[accountMeta.accountId] = Object.assign({}, {
+            nestedAccountId: getNestedAccountIDForAccount(accountMeta.accountId, accountsMetadata),
+            accountMetadata: accountMetadataRecordsPartial[accountMeta.accountId].meta,
+            accountMetadataPayload: accountMetadataRecordsPartial[accountMeta.accountId].payload,
+        });
+    });
+    return accountMetadataRecords;
+};

package/lib/esm/commonStateTypes/accountView/nestedAccountID.js

@@ -0,0 +1,12 @@
+export const MAX_SUB_ACCOUNTS_SUPPORTED = 4;
+export const MAX_SUB_CLASSES_SUPPORTED = 4;
+export const MAX_SUB_CUSTOMERS_SUPPORTED = 4;
+export function getNestedAccountIDStr(nestedAccountId) {
+    const [accountId, parentAccountId, greatParentAccountId, greatGreatParentAccountId, greatGreatGreatParentAccountId,] = nestedAccountId;
+    return `${accountId}-${parentAccountId ?? ''}-${greatParentAccountId ?? ''}-${greatGreatParentAccountId ?? ''}-${greatGreatGreatParentAccountId ?? ''}`;
+}
+export const isEqualNestedAccountId = (nestedAccountIdA, nestedAccountIdB) => {
+    const nestedStringA = getNestedAccountIDStr(nestedAccountIdA);
+    const nestedStringB = getNestedAccountIDStr(nestedAccountIdB);
+    return nestedStringA === nestedStringB;
+};

package/lib/esm/commonStateTypes/agingBalance/agingBalance.js

@@ -0,0 +1,11 @@
+import { DEFAULT_DATE_FORMAT } from '../fiscalYearHelpers/formatZeniDateFY';
+import { stringToUnion } from '../stringToUnion';
+export const AGING_PERIODS = [
+    'current_due',
+    'due_1-30_days',
+    'due_31-60_days',
+    'due_61-90_days',
+    'due_over_90_days',
+];
+export const toAgingPeriod = (v) => stringToUnion(v, AGING_PERIODS);
+export const getAgingBalancesKey = (reportDate) => `${reportDate.format(DEFAULT_DATE_FORMAT)}`;

package/lib/esm/commonStateTypes/allowedValue.js

@@ -0,0 +1,6 @@
+export function isAllowedValueWithCode(allowedValue) {
+    return allowedValue.code !== undefined;
+}
+export function isAllowedValueWithID(allowedValue) {
+    return allowedValue.id !== undefined;
+}

package/lib/esm/commonStateTypes/amount.js

@@ -0,0 +1,14 @@
+export const toAmount = (amount, currency_code, currency_symbol) => ({
+    amount: amount,
+    currencyCode: currency_code,
+    currencySymbol: currency_symbol,
+});
+/* to amount with currency */
+export const toAmountWC = (amount, currency) => toAmount(amount, currency.currencyCode, currency.currencySymbol);
+// Cash-management surfaces (selectors + reducers under
+// `spendManagement/cashManagement/`) are USD-only for v1; this helper hard-codes
+// the seed currency so the `isZeroAmount` sentinel check in
+// `cashManagementOverviewSelector.ts` can rely on USD/$ as "no currency yet".
+// Drop the hard-coding when multi-currency lands and introduce a real sentinel
+// (e.g. `Amount | undefined`).
+export const zeroAmount = () => toAmount(0, 'USD', '$');

package/lib/esm/commonStateTypes/animations.js

@@ -0,0 +1,62 @@
+import { stringToUnion } from './stringToUnion';
+const ALL_ANIMATIONS_FILE_NAMES = [
+    'AiAgent',
+    'AiIconEntry',
+    'AiIconExit',
+    'AiIconLoop',
+    'AiStar',
+    'AiStarIcon',
+    'AiStarPlain',
+    'AIPoweredInvoiceDark',
+    'AIPoweredInvoiceLight',
+    'Angry',
+    'AutoTransfer',
+    'CloseCard',
+    'Confetti',
+    'ConfettiSuccess',
+    'DashboardChristmasSnow',
+    'DashboardNewYearShow',
+    'DashboardSidebarBottomChristmas',
+    'DashboardSidebarBottomHalloween',
+    'DashboardSidebarBottomNewYear',
+    'DashboardSidebarBottomThanksgiving',
+    'DashboardSidebarTopChristmas',
+    'DashboardSidebarTopHalloween',
+    'DashboardSidebarTopNewYear',
+    'DashboardSidebarTopThanksgiving',
+    'Distribution',
+    'DistributionDark',
+    'EarnYield',
+    'FastestWayDark',
+    'FastestWayLight',
+    'FinanceTeamDark',
+    'FinanceTeamLight',
+    'Happy',
+    'Liquidity',
+    'LockCard',
+    'MoneyTransferSuccess',
+    'MultiLevelApprovalDark',
+    'MultiLevelApprovalLight',
+    'NotHappy',
+    'Protection',
+    'ReceiptDark',
+    'ReceiptLight',
+    'Recurring',
+    'RecurringDark',
+    'ReimburseDark',
+    'ReimburseLight',
+    'RewardsDark',
+    'RewardsDarkHover',
+    'RewardsLight',
+    'RewardsLightHover',
+    'Ripple',
+    'Secure',
+    'Success',
+    'Target',
+    'TargetDark',
+    'UnlockCard',
+    'VeryHappy',
+    'Welcome',
+    'ZeniAssist',
+];
+export const toAnimationsFileName = (v) => stringToUnion(v, ALL_ANIMATIONS_FILE_NAMES);

package/lib/esm/commonStateTypes/balance.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/commonStateTypes/balanceTimeseries.js

@@ -0,0 +1 @@
+export {};