@ohos-ports/accounter-server 0.1.0-beta.0

package/dist/server/src/__tests__/fixtures/expenses/expense-scenario-b.js

@@ -0,0 +1,175 @@
+/**
+ * Expense Scenario B: Foreign Currency (USD) Invoice Expense
+ *
+ * This scenario represents an expense paid in foreign currency (USD) with an invoice.
+ * It demonstrates foreign currency handling and exchange rate conversion in ledger generation.
+ *
+ * Flow:
+ * 1. Admin business purchases from US Vendor LLC
+ * 2. Transaction recorded: -200 USD (negative = expense/outflow)
+ * 3. Invoice document provided in USD
+ * 4. Expected ledger: debit expense category (in ILS), credit bank account (in ILS)
+ *    - Exchange rate: 3.5 ILS per USD (mocked/deterministic)
+ *    - 200 USD × 3.5 = 700 ILS total
+ *
+ * Prerequisites:
+ * - Admin business entity exists (from seed)
+ * - General expense tax category exists (from seed)
+ * - Exchange rate mocked: USD→ILS at 3.5
+ */
+import { createBusiness, createCharge, createDocument, createTransaction, createTaxCategory, createFinancialAccount, } from '../../factories';
+import { makeUUID } from '../../../demo-fixtures/helpers/deterministic-uuid.js';
+import { CountryCode, Currency } from '../../../shared/enums.js';
+const ADMIN_ID = makeUUID('business', 'admin-business-usd');
+/**
+ * Expense Scenario B: USD Invoice Expense
+ *
+ * @description
+ * A US supplier provides a service, admin pays 200 USD, receives an invoice.
+ * This tests foreign currency conversion with a deterministic exchange rate.
+ *
+ * @example
+ * ```typescript
+ * import { expenseScenarioB } from './fixtures/expenses/expense-scenario-b';
+ * import { insertFixture } from './helpers/fixture-loader';
+ * import { mockExchangeRate } from './helpers/exchange-mock';
+ * import { Currency } from '../../../shared/enums.js';
+ *
+ * await withTestTransaction(pool, async (client) => {
+ *   await seedAdminCore(client); // Ensure admin context exists
+ *   const idMap = await insertFixture(client, expenseScenarioB);
+ *
+ *   // Create context with mocked exchange rate
+ *   const context = createLedgerTestContext({
+ *     pool,
+ *     adminContext,
+ *     mockExchangeRates: mockExchangeRate(Currency.Usd, Currency.Ils, 3.5),
+ *   });
+ *
+ *   // Now test ledger generation with foreign currency
+ *   const chargeId = idMap.get('charge-consulting-services');
+ *   // ... trigger ledger generation and assert
+ * });
+ * ```
+ */
+export const expenseScenarioB = {
+    businesses: {
+        businesses: [
+            // Admin business (owner of the expense)
+            createBusiness({
+                id: ADMIN_ID,
+                name: 'Accounter Admin',
+                country: CountryCode.Israel,
+            }),
+            // US Supplier business
+            createBusiness({
+                id: makeUUID('business', 'supplier-us-vendor-llc'),
+                name: 'Supplier US Vendor LLC',
+                country: CountryCode['United States of America (the)'],
+                exemptDealer: false,
+                isReceiptEnough: false, // Requires invoice for foreign transactions
+            }),
+        ],
+    },
+    taxCategories: {
+        taxCategories: [
+            createTaxCategory({
+                id: makeUUID('tax-category', 'expense-consulting'),
+                name: 'Consulting Expenses',
+                ownerId: ADMIN_ID,
+            }),
+            createTaxCategory({
+                id: makeUUID('tax-category', 'usd-account-tax-category'),
+                name: 'Foreign Currency Account',
+                ownerId: ADMIN_ID,
+            }),
+        ],
+    },
+    accounts: {
+        accounts: [
+            createFinancialAccount({
+                accountNumber: 'USD-ACCOUNT-001',
+                type: 'BANK_ACCOUNT',
+                ownerId: ADMIN_ID,
+            }),
+        ],
+    },
+    accountTaxCategories: {
+        mappings: [
+            {
+                accountNumber: 'USD-ACCOUNT-001',
+                currency: Currency.Usd,
+                taxCategoryId: makeUUID('tax-category', 'usd-account-tax-category'),
+                ownerId: ADMIN_ID,
+            },
+        ],
+    },
+    charges: {
+        charges: [
+            createCharge({
+                owner_id: ADMIN_ID,
+                tax_category_id: makeUUID('tax-category', 'expense-consulting'),
+                user_description: 'Consulting services from US vendor',
+            }, {
+                id: makeUUID('charge', 'charge-consulting-services'),
+            }),
+        ],
+    },
+    transactions: {
+        transactions: [
+            createTransaction({
+                charge_id: makeUUID('charge', 'charge-consulting-services'),
+                business_id: makeUUID('business', 'supplier-us-vendor-llc'),
+                amount: '-200.00', // Negative = expense/outflow in USD
+                currency: Currency.Usd,
+                event_date: '2024-01-20',
+                is_fee: false,
+                owner_id: ADMIN_ID,
+            }, {
+                id: makeUUID('transaction', 'transaction-consulting-payment'),
+                account_id: 'USD-ACCOUNT-001', // Will be resolved to UUID by loader
+                source_description: 'Consulting services - US Vendor LLC',
+                debit_date: '2024-01-20',
+                current_balance: '0', // Placeholder
+            }),
+        ],
+    },
+    documents: {
+        documents: [
+            createDocument({
+                charge_id: makeUUID('charge', 'charge-consulting-services'),
+                creditor_id: makeUUID('business', 'supplier-us-vendor-llc'), // Supplier is creditor
+                debtor_id: ADMIN_ID, // Admin is debtor
+                type: 'INVOICE',
+                total_amount: 200.0, // Amount in USD
+                currency_code: Currency.Usd,
+                date: '2024-01-20', // Invoice date matches transaction
+                owner_id: ADMIN_ID,
+            }, {
+                id: makeUUID('document', 'document-consulting-invoice'),
+                serial_number: 'INV-US-2024-001',
+                vat_amount: null, // US invoice - no Israeli VAT
+            }),
+        ],
+    },
+    expectations: {
+        ledger: [
+            {
+                chargeId: makeUUID('charge', 'charge-consulting-services'),
+                recordCount: 2, // Document + transaction entries
+                debitEntities: [makeUUID('tax-category', 'expense-consulting'), makeUUID('tax-category', 'usd-account-tax-category')],
+                creditEntities: [makeUUID('tax-category', 'usd-account-tax-category'), makeUUID('business', 'supplier-us-vendor-llc')],
+                // Ledger processes document (700 ILS) + transaction (700 ILS) = 1400 ILS total
+                // With exchange rate of 3.5 ILS/USD: 200 USD × 3.5 = 700 ILS per entry
+                totalDebitLocal: 1400.0,
+                totalCreditLocal: 1400.0,
+                balanced: true,
+                foreignCurrency: Currency.Usd,
+                foreignAmount: 200.0,
+                exchangeRate: 3.5, // Mocked deterministic rate
+                ownerId: ADMIN_ID,
+            },
+        ],
+    },
+};
+//# sourceMappingURL=expense-scenario-b.js.map

package/dist/server/src/__tests__/fixtures/expenses/expense-scenario-b.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expense-scenario-b.js","sourceRoot":"","sources":["../../../../../../src/__tests__/fixtures/expenses/expense-scenario-b.ts"],"names":[],"mappings":"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"}

package/dist/server/src/__tests__/fixtures/expenses/expense-scenario-b.test.d.ts

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

package/dist/server/src/__tests__/fixtures/expenses/expense-scenario-b.test.js

@@ -0,0 +1,107 @@
+import { describe, it, expect } from 'vitest';
+import { expenseScenarioB } from './expense-scenario-b';
+import { validateFixture } from '../../helpers/fixture-validation';
+import { makeUUID } from '../../../demo-fixtures/helpers/deterministic-uuid.js';
+import { Currency, CountryCode } from '../../../shared/enums.js';
+describe('Expense Scenario B - USD Invoice', () => {
+    it('fixture should compile and be well-formed', () => {
+        expect(expenseScenarioB).toBeDefined();
+        expect(expenseScenarioB.businesses).toBeDefined();
+        expect(expenseScenarioB.taxCategories).toBeDefined();
+        expect(expenseScenarioB.accounts).toBeDefined();
+        expect(expenseScenarioB.accountTaxCategories).toBeDefined();
+        expect(expenseScenarioB.charges).toBeDefined();
+        expect(expenseScenarioB.transactions).toBeDefined();
+        expect(expenseScenarioB.documents).toBeDefined();
+        expect(expenseScenarioB.expectations).toBeDefined();
+    });
+    it('fixture should validate successfully', () => {
+        const result = validateFixture(expenseScenarioB);
+        if (!result.ok) {
+            console.error('Validation errors:', result.errors);
+        }
+        expect(result.ok).toBe(true);
+    });
+    it('should have correct structure counts', () => {
+        expect(expenseScenarioB.businesses?.businesses).toHaveLength(2); // Admin + US Vendor
+        expect(expenseScenarioB.taxCategories?.taxCategories).toHaveLength(2); // Consulting expense + USD account
+        expect(expenseScenarioB.accounts?.accounts).toHaveLength(1); // USD account
+        expect(expenseScenarioB.accountTaxCategories?.mappings).toHaveLength(1); // USD account → tax category
+        expect(expenseScenarioB.charges?.charges).toHaveLength(1); // Consulting charge
+        expect(expenseScenarioB.transactions?.transactions).toHaveLength(1); // Payment in USD
+        expect(expenseScenarioB.documents?.documents).toHaveLength(1); // Invoice in USD
+        expect(expenseScenarioB.expectations?.ledger).toHaveLength(1); // Ledger expectation
+    });
+    it('should have correct business entities', () => {
+        const businesses = expenseScenarioB.businesses.businesses;
+        const admin = businesses.find(b => b.id === makeUUID('business', 'admin-business-usd'));
+        const supplier = businesses.find(b => b.id === makeUUID('business', 'supplier-us-vendor-llc'));
+        expect(admin).toBeDefined();
+        expect(admin?.country).toBe(CountryCode.Israel);
+        expect(supplier).toBeDefined();
+        expect(supplier?.country).toBe(CountryCode['United States of America (the)']);
+        expect(supplier?.isReceiptEnough).toBe(false); // Requires invoice
+    });
+    it('should have referential integrity between charge, transaction, and document', () => {
+        const chargeId = makeUUID('charge', 'charge-consulting-services');
+        const charge = expenseScenarioB.charges.charges[0];
+        const transaction = expenseScenarioB.transactions.transactions[0];
+        const document = expenseScenarioB.documents.documents[0];
+        expect(charge.id).toBe(chargeId);
+        expect(transaction.charge_id).toBe(chargeId);
+        expect(document.charge_id).toBe(chargeId);
+    });
+    it('should use USD currency for transaction and document', () => {
+        const transaction = expenseScenarioB.transactions.transactions[0];
+        const document = expenseScenarioB.documents.documents[0];
+        expect(transaction.currency).toBe(Currency.Usd);
+        expect(document.currency_code).toBe(Currency.Usd);
+    });
+    it('should have matching USD amounts', () => {
+        const transaction = expenseScenarioB.transactions.transactions[0];
+        const document = expenseScenarioB.documents.documents[0];
+        // Transaction is negative (outflow), document is positive
+        expect(transaction.amount).toBe('-200.00');
+        expect(document.total_amount).toBe(200.0);
+    });
+    it('should have matching dates', () => {
+        const transaction = expenseScenarioB.transactions.transactions[0];
+        const document = expenseScenarioB.documents.documents[0];
+        expect(transaction.event_date).toBe('2024-01-20');
+        expect(document.date).toBe('2024-01-20');
+    });
+    it('should use INVOICE document type for foreign transaction', () => {
+        const document = expenseScenarioB.documents.documents[0];
+        expect(document.type).toBe('INVOICE');
+    });
+    it('should have ledger expectations with exchange rate', () => {
+        const ledgerExpectation = expenseScenarioB.expectations.ledger[0];
+        expect(ledgerExpectation.chargeId).toBe(makeUUID('charge', 'charge-consulting-services'));
+        expect(ledgerExpectation.recordCount).toBe(2);
+        expect(ledgerExpectation.balanced).toBe(true);
+        expect(ledgerExpectation.foreignCurrency).toBe('USD');
+        expect(ledgerExpectation.foreignAmount).toBe(200.0);
+        expect(ledgerExpectation.exchangeRate).toBe(3.5);
+    });
+    it('should have correct ILS conversion in expectations', () => {
+        const ledgerExpectation = expenseScenarioB.expectations.ledger[0];
+        // 200 USD × 3.5 ILS/USD = 700 ILS per entry × 2 entries = 1400 ILS total
+        // Ledger processes document and transaction separately
+        expect(ledgerExpectation.totalDebitLocal).toBe(1400.0);
+        expect(ledgerExpectation.totalCreditLocal).toBe(1400.0);
+    });
+    it('should have correct tax categories', () => {
+        const ledgerExpectation = expenseScenarioB.expectations.ledger[0];
+        const debitEntity = ledgerExpectation.debitEntities[0];
+        const creditEntity = ledgerExpectation.creditEntities[0];
+        expect(debitEntity).toBe(makeUUID('tax-category', 'expense-consulting'));
+        expect(creditEntity).toBe(makeUUID('tax-category', 'usd-account-tax-category'));
+    });
+    it('should have USD account mapped to tax category', () => {
+        const accountMapping = expenseScenarioB.accountTaxCategories?.mappings[0];
+        expect(accountMapping?.accountNumber).toBe('USD-ACCOUNT-001');
+        expect(accountMapping?.currency).toBe(Currency.Usd);
+        expect(accountMapping?.taxCategoryId).toBe(makeUUID('tax-category', 'usd-account-tax-category'));
+    });
+});
+//# sourceMappingURL=expense-scenario-b.test.js.map

package/dist/server/src/__tests__/fixtures/expenses/expense-scenario-b.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expense-scenario-b.test.js","sourceRoot":"","sources":["../../../../../../src/__tests__/fixtures/expenses/expense-scenario-b.test.ts"],"names":[],"mappings":"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"}

package/dist/server/src/__tests__/helpers/admin-context-builder.d.ts

@@ -0,0 +1,24 @@
+import type { PoolClient } from 'pg';
+import type { AdminContext } from '../../modules/admin-context/types.js';
+/**
+ * Builds AdminContext from database user_context table.
+ *
+ * This helper eliminates ~100 lines of duplication across integration tests
+ * by querying the database for the full admin context configuration.
+ *
+ * @param client - Database client connection
+ * @param businessName - Name of the admin business entity (default: 'Admin Business')
+ * @returns Complete AdminContext object with all required fields populated from DB
+ *
+ * @example
+ * ```typescript
+ * const client = await pool.connect();
+ * try {
+ *   const adminContext = await buildAdminContextFromDb(client);
+ *   // Use adminContext in test...
+ * } finally {
+ *   client.release();
+ * }
+ * ```
+ */
+export declare function buildAdminContextFromDb(client: PoolClient, businessName?: string): Promise<AdminContext>;

package/dist/server/src/__tests__/helpers/admin-context-builder.js

@@ -0,0 +1,137 @@
+import { qualifyTable } from './test-db-config.js';
+import { optionalDateToTimelessDateString } from '../../shared/helpers/index.js';
+/**
+ * Builds AdminContext from database user_context table.
+ *
+ * This helper eliminates ~100 lines of duplication across integration tests
+ * by querying the database for the full admin context configuration.
+ *
+ * @param client - Database client connection
+ * @param businessName - Name of the admin business entity (default: 'Admin Business')
+ * @returns Complete AdminContext object with all required fields populated from DB
+ *
+ * @example
+ * ```typescript
+ * const client = await pool.connect();
+ * try {
+ *   const adminContext = await buildAdminContextFromDb(client);
+ *   // Use adminContext in test...
+ * } finally {
+ *   client.release();
+ * }
+ * ```
+ */
+export async function buildAdminContextFromDb(client, businessName = 'Admin Business') {
+    const contextResult = await client.query(`SELECT uc.* FROM ${qualifyTable('user_context')} uc
+     JOIN ${qualifyTable('financial_entities')} fe ON fe.id = uc.owner_id
+     WHERE fe.name = $1 AND fe.type = $2
+     LIMIT 1`, [businessName, 'business']);
+    if (contextResult.rows.length === 0) {
+        throw new Error(`Admin context not found for business "${businessName}". ` +
+            `Ensure seedAdminCore() has been called before tests.`);
+    }
+    const dbContext = contextResult.rows[0];
+    const adminBusinessId = dbContext.owner_id;
+    return {
+        defaultLocalCurrency: dbContext.default_local_currency,
+        defaultCryptoConversionFiatCurrency: dbContext.default_fiat_currency_for_crypto_conversions,
+        ownerId: adminBusinessId,
+        defaultTaxCategoryId: dbContext.default_tax_category_id,
+        locality: dbContext.locality || 'Israel',
+        ledgerLock: dbContext.ledger_lock
+            ? dbContext.ledger_lock.toISOString().split('T')[0]
+            : undefined,
+        dateEstablished: optionalDateToTimelessDateString(dbContext.date_established) ?? undefined,
+        initialAccounterYear: dbContext.initial_accounter_year ?? undefined,
+        authorities: {
+            vatBusinessId: dbContext.vat_business_id,
+            inputVatTaxCategoryId: dbContext.input_vat_tax_category_id,
+            outputVatTaxCategoryId: dbContext.output_vat_tax_category_id,
+            propertyOutputVatTaxCategoryId: dbContext.property_output_vat_tax_category_id,
+            taxBusinessId: dbContext.tax_business_id,
+            taxExpensesTaxCategoryId: dbContext.tax_expenses_tax_category_id,
+            socialSecurityBusinessId: dbContext.social_security_business_id,
+            vatReportExcludedBusinessNames: [],
+        },
+        general: {
+            taxCategories: {
+                exchangeRateTaxCategoryId: dbContext.exchange_rate_tax_category_id,
+                incomeExchangeRateTaxCategoryId: dbContext.income_exchange_rate_tax_category_id,
+                exchangeRevaluationTaxCategoryId: dbContext.exchange_rate_revaluation_tax_category_id,
+                feeTaxCategoryId: dbContext.fee_tax_category_id,
+                generalFeeTaxCategoryId: dbContext.general_fee_tax_category_id,
+                fineTaxCategoryId: dbContext.fine_tax_category_id,
+                untaxableGiftsTaxCategoryId: dbContext.untaxable_gifts_tax_category_id,
+                balanceCancellationTaxCategoryId: dbContext.balance_cancellation_tax_category_id,
+                developmentForeignTaxCategoryId: dbContext.development_foreign_tax_category_id,
+                developmentLocalTaxCategoryId: dbContext.development_local_tax_category_id,
+                salaryExcessExpensesTaxCategoryId: dbContext.salary_excess_expenses_tax_category_id,
+            },
+        },
+        crossYear: {
+            expensesToPayTaxCategoryId: dbContext.expenses_to_pay_tax_category_id,
+            expensesInAdvanceTaxCategoryId: dbContext.expenses_in_advance_tax_category_id,
+            incomeToCollectTaxCategoryId: dbContext.income_to_collect_tax_category_id,
+            incomeInAdvanceTaxCategoryId: dbContext.income_in_advance_tax_category_id,
+        },
+        financialAccounts: {
+            poalimBusinessId: null,
+            discountBusinessId: null,
+            otsarHahayalBusinessId: null,
+            swiftBusinessId: null,
+            isracardBusinessId: null,
+            amexBusinessId: null,
+            calBusinessId: null,
+            otsarHahayalCreditCardBusinessId: null,
+            etanaBusinessId: null,
+            krakenBusinessId: null,
+            etherScanBusinessId: null,
+            foreignSecuritiesBusinessId: null,
+            bankAccountIds: [],
+            creditCardIds: [],
+            internalWalletsIds: [],
+        },
+        bankDeposits: {
+            bankDepositBusinessId: null,
+            bankDepositInterestIncomeTaxCategoryId: null
+        },
+        foreignSecurities: {
+            foreignSecuritiesBusinessId: null,
+            foreignSecuritiesFeesCategoryId: null
+        },
+        salaries: {
+            zkufotExpensesTaxCategoryId: null,
+            zkufotIncomeTaxCategoryId: null,
+            socialSecurityExpensesTaxCategoryId: null,
+            salaryExpensesTaxCategoryId: null,
+            trainingFundExpensesTaxCategoryId: null,
+            compensationFundExpensesTaxCategoryId: null,
+            pensionExpensesTaxCategoryId: null,
+            batchedEmployeesBusinessId: null,
+            batchedFundsBusinessId: null,
+            salaryBatchedBusinessIds: [],
+            taxDeductionsBusinessId: null,
+            recoveryReserveExpensesTaxCategoryId: null,
+            recoveryReserveTaxCategoryId: null,
+            vacationReserveExpensesTaxCategoryId: null,
+            vacationReserveTaxCategoryId: null,
+        },
+        businessTrips: {
+            businessTripTaxCategoryId: null,
+            businessTripTagId: null
+        },
+        dividends: {
+            dividendWithholdingTaxBusinessId: null,
+            dividendTaxCategoryId: null,
+            dividendPaymentBusinessIds: [],
+            dividendBusinessIds: [],
+        },
+        depreciation: {
+            accumulatedDepreciationTaxCategoryId: null,
+            rndDepreciationExpensesTaxCategoryId: null,
+            gnmDepreciationExpensesTaxCategoryId: null,
+            marketingDepreciationExpensesTaxCategoryId: null,
+        },
+    };
+}
+//# sourceMappingURL=admin-context-builder.js.map

package/dist/server/src/__tests__/helpers/admin-context-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-context-builder.js","sourceRoot":"","sources":["../../../../../src/__tests__/helpers/admin-context-builder.ts"],"names":[],"mappings":"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"}

package/dist/server/src/__tests__/helpers/db-connection.d.ts

@@ -0,0 +1,4 @@
+import { Pool } from 'pg';
+export declare function getSharedPool(): Pool | null;
+export declare function connectTestDb(): Promise<Pool>;
+export declare function closeTestDb(): Promise<void>;

package/dist/server/src/__tests__/helpers/db-connection.js

@@ -0,0 +1,57 @@
+import { Pool } from 'pg';
+import { testDbConfig } from './test-db-config.js';
+import { debugLog, emitMetrics } from './diagnostics.js';
+import { TestDbConnectionError } from './errors.js';
+let sharedPool = null;
+export function getSharedPool() {
+    return sharedPool;
+}
+export async function connectTestDb() {
+    if (sharedPool)
+        return sharedPool;
+    const createPool = () => new Pool({
+        ...testDbConfig,
+        max: 10,
+        idleTimeoutMillis: 30000,
+        connectionTimeoutMillis: 5000,
+    });
+    const attempts = 3;
+    let lastError;
+    for (let attempt = 1; attempt <= attempts; attempt++) {
+        try {
+            sharedPool = createPool();
+            const client = await sharedPool.connect();
+            try {
+                await client.query('SELECT 1');
+            }
+            finally {
+                client.release();
+            }
+            debugLog('Connected to test DB on attempt', attempt);
+            emitMetrics('connected', sharedPool);
+            return sharedPool;
+        }
+        catch (error) {
+            lastError = error;
+            debugLog('DB connect attempt failed', attempt, error);
+            if (sharedPool) {
+                try {
+                    await sharedPool.end();
+                }
+                catch { }
+                sharedPool = null;
+            }
+            if (attempt < attempts)
+                await new Promise(r => setTimeout(r, 500 * attempt));
+        }
+    }
+    throw new TestDbConnectionError('Failed to connect to test database after retries', lastError);
+}
+export async function closeTestDb() {
+    if (sharedPool) {
+        emitMetrics('closing', sharedPool);
+        await sharedPool.end();
+        sharedPool = null;
+    }
+}
+//# sourceMappingURL=db-connection.js.map

package/dist/server/src/__tests__/helpers/db-connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-connection.js","sourceRoot":"","sources":["../../../../../src/__tests__/helpers/db-connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,IAAI,UAAU,GAAgB,IAAI,CAAC;AAEnC,MAAM,UAAU,aAAa;IAC3B,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAElC,MAAM,UAAU,GAAG,GAAG,EAAE,CACtB,IAAI,IAAI,CAAC;QACP,GAAG,YAAY;QACf,GAAG,EAAE,EAAE;QACP,iBAAiB,EAAE,KAAK;QACxB,uBAAuB,EAAE,IAAI;KAC9B,CAAC,CAAC;IAEL,MAAM,QAAQ,GAAG,CAAC,CAAC;IACnB,IAAI,SAAkB,CAAC;IACvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC;QACrD,IAAI,CAAC;YACH,UAAU,GAAG,UAAU,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC;YAC1C,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACjC,CAAC;oBAAS,CAAC;gBACT,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,CAAC;YACD,QAAQ,CAAC,iCAAiC,EAAE,OAAO,CAAC,CAAC;YACrD,WAAW,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;YACrC,OAAO,UAAU,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;YAClB,QAAQ,CAAC,2BAA2B,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;YACtD,IAAI,UAAU,EAAE,CAAC;gBACf,IAAI,CAAC;oBACH,MAAM,UAAU,CAAC,GAAG,EAAE,CAAC;gBACzB,CAAC;gBAAC,MAAM,CAAC,CAAA,CAAC;gBACV,UAAU,GAAG,IAAI,CAAC;YACpB,CAAC;YACD,IAAI,OAAO,GAAG,QAAQ;gBAAE,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IAED,MAAM,IAAI,qBAAqB,CAAC,kDAAkD,EAAE,SAAS,CAAC,CAAC;AACjG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,IAAI,UAAU,EAAE,CAAC;QACf,WAAW,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACnC,MAAM,UAAU,CAAC,GAAG,EAAE,CAAC;QACvB,UAAU,GAAG,IAAI,CAAC;IACpB,CAAC;AACH,CAAC"}

package/dist/server/src/__tests__/helpers/db-fixtures.d.ts

@@ -0,0 +1,3 @@
+import type { Pool } from 'pg';
+export declare function seedAdminOnce(pgPool: Pool): Promise<void>;
+export declare function resetSeedFlag(): void;

package/dist/server/src/__tests__/helpers/db-fixtures.js

@@ -0,0 +1,34 @@
+import { seedAdminCore } from '../../../scripts/seed-admin-context.js';
+import { emitMetrics } from './diagnostics.js';
+import { TestDbSeedError } from './errors.js';
+let adminSeeded = false;
+let seedInFlight = null;
+export async function seedAdminOnce(pgPool) {
+    if (adminSeeded)
+        return;
+    if (seedInFlight)
+        return seedInFlight;
+    const doSeed = async () => {
+        const client = await pgPool.connect();
+        try {
+            emitMetrics('seeding-start', pgPool);
+            await seedAdminCore(client);
+            emitMetrics('seeding-complete', pgPool);
+            adminSeeded = true;
+        }
+        catch (err) {
+            throw new TestDbSeedError('Failed to seed admin context', err);
+        }
+        finally {
+            client.release();
+            seedInFlight = null;
+        }
+    };
+    seedInFlight = doSeed();
+    return seedInFlight;
+}
+export function resetSeedFlag() {
+    adminSeeded = false;
+    seedInFlight = null;
+}
+//# sourceMappingURL=db-fixtures.js.map

package/dist/server/src/__tests__/helpers/db-fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-fixtures.js","sourceRoot":"","sources":["../../../../../src/__tests__/helpers/db-fixtures.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,IAAI,WAAW,GAAG,KAAK,CAAC;AACxB,IAAI,YAAY,GAAyB,IAAI,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAY;IAC9C,IAAI,WAAW;QAAE,OAAO;IACxB,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC;IAEtC,MAAM,MAAM,GAAG,KAAK,IAAI,EAAE;QACxB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACtC,IAAI,CAAC;YACH,WAAW,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;YACrC,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;YAC5B,WAAW,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;YACxC,WAAW,GAAG,IAAI,CAAC;QACrB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,eAAe,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAC;QACjE,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,YAAY,GAAG,IAAI,CAAC;QACtB,CAAC;IACH,CAAC,CAAC;IAEF,YAAY,GAAG,MAAM,EAAE,CAAC;IACxB,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,WAAW,GAAG,KAAK,CAAC;IACpB,YAAY,GAAG,IAAI,CAAC;AACtB,CAAC"}

package/dist/server/src/__tests__/helpers/db-migrations.d.ts

@@ -0,0 +1,2 @@
+import type { Pool } from 'pg';
+export declare function runMigrationsIfNeeded(pgPool: Pool): Promise<void>;

package/dist/server/src/__tests__/helpers/db-migrations.js

@@ -0,0 +1,43 @@
+import { createPool as createSlonikPool } from '@ohos-ports/slonik';
+import { testDbConfig, testDbSchema } from './test-db-config.js';
+import { runPGMigrations, LATEST_MIGRATION_NAME } from '../../../../migrations/src/run-pg-migrations.js';
+import { debugLog, emitMetrics } from './diagnostics.js';
+import { TestDbMigrationError } from './errors.js';
+export async function runMigrationsIfNeeded(pgPool) {
+    let needToRun = false;
+    const client = await pgPool.connect();
+    try {
+        const existsRes = await client.query('SELECT to_regclass($1) as reg', [`${testDbSchema}.migration`]);
+        const tableExists = Boolean(existsRes.rows?.[0]?.reg);
+        if (!tableExists) {
+            needToRun = true;
+        }
+        else if (LATEST_MIGRATION_NAME) {
+            const latestExists = await client.query(`SELECT 1 FROM ${testDbSchema}.migration WHERE name = $1 LIMIT 1`, [LATEST_MIGRATION_NAME]);
+            needToRun = latestExists.rowCount === 0;
+        }
+    }
+    catch (err) {
+        needToRun = true;
+        debugLog('Migration state check failed, will attempt to run migrations');
+    }
+    finally {
+        client.release();
+    }
+    if (!needToRun) {
+        debugLog('Migrations appear up-to-date; skipping run');
+        return;
+    }
+    const slonikPool = await createSlonikPool(`postgres://${testDbConfig.user}:${testDbConfig.password}@${testDbConfig.host}:${testDbConfig.port}/${testDbConfig.database}`, { statementTimeout: 10 * 60 * 1000 });
+    try {
+        await runPGMigrations({ slonik: slonikPool });
+        emitMetrics('migrations-ran', pgPool);
+    }
+    catch (err) {
+        throw new TestDbMigrationError('Failed to run migrations', err);
+    }
+    finally {
+        await slonikPool.end();
+    }
+}
+//# sourceMappingURL=db-migrations.js.map

package/dist/server/src/__tests__/helpers/db-migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-migrations.js","sourceRoot":"","sources":["../../../../../src/__tests__/helpers/db-migrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,gBAAgB,EAAqB,MAAM,QAAQ,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,iDAAiD,CAAC;AACzG,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGnD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAAY;IACtD,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,KAAK,CAClC,+BAA+B,EAC/B,CAAC,GAAG,YAAY,YAAY,CAAC,CAC9B,CAAC;QACF,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACtD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;aAAM,IAAI,qBAAqB,EAAE,CAAC;YACjC,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,KAAK,CACrC,iBAAiB,YAAY,oCAAoC,EACjE,CAAC,qBAAqB,CAAC,CACxB,CAAC;YACF,SAAS,GAAG,YAAY,CAAC,QAAQ,KAAK,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,SAAS,GAAG,IAAI,CAAC;QACjB,QAAQ,CAAC,8DAA8D,CAAC,CAAC;IAC3E,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,OAAO,EAAE,CAAC;IACnB,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,QAAQ,CAAC,4CAA4C,CAAC,CAAC;QACvD,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAiB,MAAM,gBAAgB,CACrD,cAAc,YAAY,CAAC,IAAI,IAAI,YAAY,CAAC,QAAQ,IAAI,YAAY,CAAC,IAAI,IAAI,YAAY,CAAC,IAAI,IAAI,YAAY,CAAC,QAAQ,EAAE,EAC7H,EAAE,gBAAgB,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,CACrC,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,eAAe,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAC9C,WAAW,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,oBAAoB,CAAC,0BAA0B,EAAE,GAAG,CAAC,CAAC;IAClE,CAAC;YAAS,CAAC;QACT,MAAM,UAAU,CAAC,GAAG,EAAE,CAAC;IACzB,CAAC;AACH,CAAC"}