@accounter/server 0.0.9-alpha-20251210153039-1cfd8df346dd211c95a70c76c63465a29236849b → 0.0.9-alpha-20251210155614-e6e65aaecafef9e8fedd0b933f613ffcf478cecf

package/src/__tests__/helpers/fixture-validation.test.ts

@@ -5,18 +5,18 @@ import { createDocument } from '../factories/document.js';
 import { createFinancialAccount } from '../factories/financial-account.js';
 import { createTaxCategory } from '../factories/tax-category.js';
 import { createTransaction } from '../factories/transaction.js';
-import { makeUUID } from '../../demo-fixtures/helpers/deterministic-uuid.js';
+import { makeUUID } from '../factories/ids.js';
 import type { Fixture } from './fixture-types.js';
 import { assertValidFixture, validateFixture } from './fixture-validation.js';
 
 describe('Fixture Validation', () => {
   describe('validateFixture', () => {
     it('should validate a complete valid fixture', () => {
-      const adminId = makeUUID('business', 'admin');
-      const supplierId = makeUUID('business', 'supplier');
-      const taxCatId = makeUUID('tax-category', 'tax-cat');
-      const chargeId = makeUUID('charge', 'charge');
-      const accountId = makeUUID('account', 'account');
+      const adminId = makeUUID('admin');
+      const supplierId = makeUUID('supplier');
+      const taxCatId = makeUUID('tax-cat');
+      const chargeId = makeUUID('charge');
+      const accountId = makeUUID('account');
 
       const fixture: Fixture = {
         businesses: {
@@ -67,9 +67,9 @@ describe('Fixture Validation', () => {
     });
 
     it('should validate a minimal fixture with just charges', () => {
-      const adminId = makeUUID('business', 'admin');
-      const chargeId = makeUUID('charge', 'charge');
-      const taxCatId = makeUUID('tax-category', 'tax-cat');
+      const adminId = makeUUID('admin');
+      const chargeId = makeUUID('charge');
+      const taxCatId = makeUUID('tax-cat');
 
       const fixture: Fixture = {
         businesses: {
@@ -90,9 +90,9 @@ describe('Fixture Validation', () => {
     });
 
     it('should fail when transaction references non-existent charge', () => {
-      const adminId = makeUUID('business', 'admin');
-      const supplierId = makeUUID('business', 'supplier');
-      const nonExistentChargeId = makeUUID('charge', 'non-existent-charge');
+      const adminId = makeUUID('admin');
+      const supplierId = makeUUID('supplier');
+      const nonExistentChargeId = makeUUID('non-existent-charge');
 
       const fixture: Fixture = {
         businesses: {
@@ -121,9 +121,9 @@ describe('Fixture Validation', () => {
     });
 
     it('should fail when document references non-existent charge', () => {
-      const adminId = makeUUID('business', 'admin');
-      const supplierId = makeUUID('business', 'supplier');
-      const nonExistentChargeId = makeUUID('charge', 'non-existent-charge');
+      const adminId = makeUUID('admin');
+      const supplierId = makeUUID('supplier');
+      const nonExistentChargeId = makeUUID('non-existent-charge');
 
       const fixture: Fixture = {
         businesses: {
@@ -154,8 +154,8 @@ describe('Fixture Validation', () => {
     });
 
     it('should fail when charge references non-existent business', () => {
-      const nonExistentBusinessId = makeUUID('business', 'non-existent-business');
-      const chargeId = makeUUID('charge', 'charge');
+      const nonExistentBusinessId = makeUUID('non-existent-business');
+      const chargeId = makeUUID('charge');
 
       const fixture: Fixture = {
         charges: {
@@ -175,9 +175,9 @@ describe('Fixture Validation', () => {
     });
 
     it('should fail when charge references non-existent tax category', () => {
-      const adminId = makeUUID('business', 'admin');
-      const chargeId = makeUUID('charge', 'charge');
-      const nonExistentTaxCatId = makeUUID('tax-category', 'non-existent-tax-cat');
+      const adminId = makeUUID('admin');
+      const chargeId = makeUUID('charge');
+      const nonExistentTaxCatId = makeUUID('non-existent-tax-cat');
 
       const fixture: Fixture = {
         businesses: {
@@ -203,9 +203,9 @@ describe('Fixture Validation', () => {
     });
 
     it('should fail when transaction references non-existent business', () => {
-      const adminId = makeUUID('business', 'admin');
-      const chargeId = makeUUID('charge', 'charge');
-      const nonExistentBusinessId = makeUUID('business', 'non-existent-business');
+      const adminId = makeUUID('admin');
+      const chargeId = makeUUID('charge');
+      const nonExistentBusinessId = makeUUID('non-existent-business');
 
       const fixture: Fixture = {
         businesses: {
@@ -237,9 +237,9 @@ describe('Fixture Validation', () => {
     });
 
     it('should fail when document references non-existent creditor', () => {
-      const adminId = makeUUID('business', 'admin');
-      const chargeId = makeUUID('charge', 'charge');
-      const nonExistentCreditorId = makeUUID('business', 'non-existent-creditor');
+      const adminId = makeUUID('admin');
+      const chargeId = makeUUID('charge');
+      const nonExistentCreditorId = makeUUID('non-existent-creditor');
 
       const fixture: Fixture = {
         businesses: {
@@ -273,10 +273,10 @@ describe('Fixture Validation', () => {
     });
 
     it('should fail when document references non-existent debtor', () => {
-      const adminId = makeUUID('business', 'admin');
-      const supplierId = makeUUID('business', 'supplier');
-      const chargeId = makeUUID('charge', 'charge');
-      const nonExistentDebtorId = makeUUID('business', 'non-existent-debtor');
+      const adminId = makeUUID('admin');
+      const supplierId = makeUUID('supplier');
+      const chargeId = makeUUID('charge');
+      const nonExistentDebtorId = makeUUID('non-existent-debtor');
 
       const fixture: Fixture = {
         businesses: {
@@ -310,7 +310,7 @@ describe('Fixture Validation', () => {
     });
 
     it('should fail when charge is missing owner_id', () => {
-      const chargeId = makeUUID('charge', 'charge');
+      const chargeId = makeUUID('charge');
 
       const fixture: Fixture = {
         charges: {
@@ -337,8 +337,8 @@ describe('Fixture Validation', () => {
     });
 
     it('should fail when transaction is missing required fields', () => {
-      const adminId = makeUUID('business', 'admin');
-      const chargeId = makeUUID('charge', 'charge');
+      const adminId = makeUUID('admin');
+      const chargeId = makeUUID('charge');
 
       const fixture: Fixture = {
         businesses: {
@@ -350,10 +350,10 @@ describe('Fixture Validation', () => {
         transactions: {
           transactions: [
             {
-              id: makeUUID('transaction', 'tx'),
-              account_id: makeUUID('account', 'account'),
+              id: makeUUID('tx'),
+              account_id: makeUUID('account'),
               charge_id: '', // Missing
-              source_id: makeUUID('source', 'source'),
+              source_id: makeUUID('source'),
               currency: '', // Missing
               event_date: '', // Missing
               amount: '', // Will be caught as missing
@@ -379,8 +379,8 @@ describe('Fixture Validation', () => {
     });
 
     it('should fail when document is missing required fields', () => {
-      const adminId = makeUUID('business', 'admin');
-      const chargeId = makeUUID('charge', 'charge');
+      const adminId = makeUUID('admin');
+      const chargeId = makeUUID('charge');
 
       const fixture: Fixture = {
         businesses: {
@@ -392,7 +392,7 @@ describe('Fixture Validation', () => {
         documents: {
           documents: [
             {
-              id: makeUUID('document', 'doc'),
+              id: makeUUID('doc'),
               charge_id: '', // Missing
               creditor_id: '', // Missing
               debtor_id: '', // Missing
@@ -430,7 +430,7 @@ describe('Fixture Validation', () => {
     });
 
     it('should detect duplicate business IDs', () => {
-      const duplicateId = makeUUID('business', 'duplicate-business');
+      const duplicateId = makeUUID('duplicate-business');
 
       const fixture: Fixture = {
         businesses: {
@@ -449,8 +449,8 @@ describe('Fixture Validation', () => {
     });
 
     it('should detect duplicate charge IDs', () => {
-      const adminId = makeUUID('business', 'admin');
-      const duplicateChargeId = makeUUID('charge', 'duplicate-charge');
+      const adminId = makeUUID('admin');
+      const duplicateChargeId = makeUUID('duplicate-charge');
 
       const fixture: Fixture = {
         businesses: {
@@ -472,8 +472,8 @@ describe('Fixture Validation', () => {
     });
 
     it('should validate financial account owner reference', () => {
-      const nonExistentOwnerId = makeUUID('business', 'non-existent-owner');
-      const accountNumber = makeUUID('account', 'account');
+      const nonExistentOwnerId = makeUUID('non-existent-owner');
+      const accountNumber = makeUUID('account');
 
       const fixture: Fixture = {
         accounts: {
@@ -493,7 +493,7 @@ describe('Fixture Validation', () => {
     });
 
     it('should allow financial account without owner', () => {
-      const accountNumber = makeUUID('account', 'account');
+      const accountNumber = makeUUID('account');
 
       const fixture: Fixture = {
         accounts: {
@@ -508,9 +508,9 @@ describe('Fixture Validation', () => {
 
   describe('assertValidFixture', () => {
     it('should not throw for valid fixture', () => {
-      const adminId = makeUUID('business', 'admin');
-      const chargeId = makeUUID('charge', 'charge');
-      const taxCatId = makeUUID('tax-category', 'tax-cat');
+      const adminId = makeUUID('admin');
+      const chargeId = makeUUID('charge');
+      const taxCatId = makeUUID('tax-cat');
 
       const fixture: Fixture = {
         businesses: {
@@ -530,8 +530,8 @@ describe('Fixture Validation', () => {
     });
 
     it('should throw for invalid fixture with formatted error message', () => {
-      const nonExistentBusinessId = makeUUID('business', 'non-existent-business');
-      const chargeId = makeUUID('charge', 'charge');
+      const nonExistentBusinessId = makeUUID('non-existent-business');
+      const chargeId = makeUUID('charge');
 
       const fixture: Fixture = {
         charges: {

package/src/modules/ledger/__tests__/helpers/ledger-assertions.ts

@@ -1,4 +1,6 @@
 import { expect } from 'vitest';
+// Adjusted relative path: helper is one directory deeper than scenario tests
+import { makeUUID } from '../../../../__tests__/factories/ids.js';
 
 // Minimal ledger record type based on DB result interface
 export interface LedgerRecord {
@@ -241,6 +243,9 @@ export function assertExpenseScenarioLogic(records: LedgerRecord[], opts: {
   });
 }
 
+/** Helper to prepare deterministic UUID sets for known fixture aliases */
+export function fixtureUUID(alias: string): string { return makeUUID(alias); }
+
 /** Combined high-level assertion for typical simple local expense scenario */
 export function assertSimpleLocalExpenseScenario(records: LedgerRecord[], params: {
   chargeId: string;

package/src/modules/ledger/__tests__/ledger-scenario-a.integration.test.ts

@@ -2,7 +2,7 @@ import { describe, it, expect, beforeAll, afterAll, afterEach } from 'vitest';
 import { TestDatabase } from '../../../__tests__/helpers/db-setup.js';
 import { insertFixture } from '../../../__tests__/helpers/fixture-loader.js';
 import { expenseScenarioA } from '../../../__tests__/fixtures/expenses/expense-scenario-a.js';
-import { makeUUID } from '../../../demo-fixtures/helpers/deterministic-uuid.js';
+import { makeUUID } from '../../../__tests__/factories/ids.js';
 import { qualifyTable } from '../../../__tests__/helpers/test-db-config.js';
 import { buildAdminContextFromDb } from '../../../__tests__/helpers/admin-context-builder.js';
 import { env } from '../../../environment.js';
@@ -43,7 +43,7 @@ describe('Ledger Generation - Expense Scenario A', () => {
   afterEach(async () => {
     const client = await db.getPool().connect();
     try {
-      const chargeId = makeUUID('charge', 'charge-office-supplies');
+      const chargeId = makeUUID('charge-office-supplies');
       await client.query(
         `DELETE FROM ${qualifyTable('ledger_records')} WHERE charge_id = $1`,
         [chargeId],
@@ -65,7 +65,7 @@ describe('Ledger Generation - Expense Scenario A', () => {
       await client.query(
         `DELETE FROM ${qualifyTable('financial_accounts_tax_categories')} 
          WHERE tax_category_id IN ($1, $2)`,
-        [makeUUID('tax-category', 'expense-general'), makeUUID('tax-category', 'bank-account-tax-category')],
+        [makeUUID('expense-general'), makeUUID('bank-account-tax-category')],
       );
       await client.query(
         `DELETE FROM ${qualifyTable('financial_accounts')} WHERE account_number = $1`,
@@ -73,19 +73,19 @@ describe('Ledger Generation - Expense Scenario A', () => {
       );
       await client.query(
         `DELETE FROM ${qualifyTable('tax_categories')} WHERE id IN ($1, $2)`,
-        [makeUUID('tax-category', 'expense-general'), makeUUID('tax-category', 'bank-account-tax-category')],
+        [makeUUID('expense-general'), makeUUID('bank-account-tax-category')],
       );
       await client.query(
         `DELETE FROM ${qualifyTable('businesses')} WHERE id IN ($1, $2)`,
-        [makeUUID('business', 'admin-business-scenario-a'), makeUUID('business', 'supplier-local-ltd')],
+        [makeUUID('admin-business'), makeUUID('supplier-local-ltd')],
       );
       await client.query(
         `DELETE FROM ${qualifyTable('financial_entities')} WHERE id IN ($1, $2, $3, $4)`,
         [
-          makeUUID('business', 'admin-business-scenario-a'),
-          makeUUID('business', 'supplier-local-ltd'),
-          makeUUID('tax-category', 'expense-general'),
-          makeUUID('tax-category', 'bank-account-tax-category'),
+          makeUUID('admin-business'),
+          makeUUID('supplier-local-ltd'),
+          makeUUID('expense-general'),
+          makeUUID('bank-account-tax-category'),
         ],
       );
     } finally {
@@ -101,7 +101,7 @@ describe('Ledger Generation - Expense Scenario A', () => {
 
       await insertFixture(insertClient, expenseScenarioA);
 
-      const chargeId = makeUUID('charge', 'charge-office-supplies');
+      const chargeId = makeUUID('charge-office-supplies');
 
       // Verify inserts within the same transaction
       const chargeResult = await insertClient.query(
@@ -137,7 +137,7 @@ describe('Ledger Generation - Expense Scenario A', () => {
     // Re-open a new client (outside prior transaction) for verification & generation
     const client = await db.getPool().connect();
     try {
-      const chargeId = makeUUID('charge', 'charge-office-supplies');
+      const chargeId = makeUUID('charge-office-supplies');
       const chargeResult = await client.query(
         `SELECT * FROM ${qualifyTable('charges')} WHERE id = $1`,
         [chargeId],
@@ -192,8 +192,8 @@ describe('Ledger Generation - Expense Scenario A', () => {
       assertSimpleLocalExpenseScenario(ledgerResult.rows as any, {
         chargeId: charge.id,
         ownerId: charge.owner_id, // Use actual charge owner for ledger record owner assertions
-        expenseEntity: makeUUID('tax-category', 'expense-general'),
-        bankEntity: makeUUID('tax-category', 'bank-account-tax-category'),
+        expenseEntity: makeUUID('expense-general'),
+        bankEntity: makeUUID('bank-account-tax-category'),
         expectedCurrency: Currency.Ils,
         expectedTotal: ledgerExpectation?.totalDebitLocal || 500.0,
       });
@@ -212,7 +212,7 @@ describe('Ledger Generation - Expense Scenario A', () => {
   it('should be idempotent on repeated ledger generation (no duplicate records)', async () => {
     const client = await db.getPool().connect();
     try {
-      const chargeId = makeUUID('charge', 'charge-office-supplies');
+      const chargeId = makeUUID('charge-office-supplies');
       // Ensure fixture inserted (if previous test did cleanup, reinsert minimal fixture)
       const existingCharge = await client.query(
         `SELECT * FROM ${qualifyTable('charges')} WHERE id = $1`,
@@ -296,7 +296,7 @@ describe('Ledger Generation - Expense Scenario A', () => {
     expect(expenseScenarioA.expectations?.ledger).toHaveLength(1);
 
     const ledgerExpectation = expenseScenarioA.expectations?.ledger?.[0];
-    expect(ledgerExpectation?.chargeId).toBe(makeUUID('charge', 'charge-office-supplies'));
+    expect(ledgerExpectation?.chargeId).toBe(makeUUID('charge-office-supplies'));
     expect(ledgerExpectation?.recordCount).toBe(2);
     expect(ledgerExpectation?.balanced).toBe(true);
     expect(ledgerExpectation?.totalDebitLocal).toBe(500.0);
@@ -307,11 +307,11 @@ describe('Ledger Generation - Expense Scenario A', () => {
 
   it('should create deterministic UUIDs for reproducible tests', () => {
     // Verify all IDs are deterministic and match expected values
-    const adminBusinessId = makeUUID('business', 'admin-business-scenario-a');
-    const supplierId = makeUUID('business', 'supplier-local-ltd');
-    const chargeId = makeUUID('charge', 'charge-office-supplies');
-    const transactionId = makeUUID('transaction', 'transaction-supplies-payment');
-    const documentId = makeUUID('document', 'document-supplies-receipt');
+    const adminBusinessId = makeUUID('admin-business');
+    const supplierId = makeUUID('supplier-local-ltd');
+    const chargeId = makeUUID('charge-office-supplies');
+    const transactionId = makeUUID('transaction-supplies-payment');
+    const documentId = makeUUID('document-supplies-receipt');
 
     expect(adminBusinessId).toBe(expenseScenarioA.businesses?.businesses[0]?.id);
     expect(supplierId).toBe(expenseScenarioA.businesses?.businesses[1]?.id);

package/src/modules/ledger/__tests__/ledger-scenario-b.integration.test.ts

@@ -2,7 +2,7 @@ import { describe, it, expect, beforeAll, afterAll, afterEach } from 'vitest';
 import { TestDatabase } from '../../../__tests__/helpers/db-setup.js';
 import { insertFixture } from '../../../__tests__/helpers/fixture-loader.js';
 import { expenseScenarioB } from '../../../__tests__/fixtures/expenses/expense-scenario-b.js';
-import { makeUUID } from '../../../demo-fixtures/helpers/deterministic-uuid.js';
+import { makeUUID } from '../../../__tests__/factories/ids.js';
 import { qualifyTable } from '../../../__tests__/helpers/test-db-config.js';
 import { buildAdminContextFromDb } from '../../../__tests__/helpers/admin-context-builder.js';
 import { mockExchangeRate } from '../../../__tests__/helpers/exchange-mock.js';
@@ -48,7 +48,7 @@ describe('Ledger Generation - Expense Scenario B (Foreign Currency)', () => {
   afterEach(async () => {
     const client = await db.getPool().connect();
     try {
-      const chargeId = makeUUID('charge', 'charge-consulting-services');
+      const chargeId = makeUUID('charge-consulting-services');
       await client.query(
         `DELETE FROM ${qualifyTable('ledger_records')} WHERE charge_id = $1`,
         [chargeId],
@@ -70,7 +70,7 @@ describe('Ledger Generation - Expense Scenario B (Foreign Currency)', () => {
       await client.query(
         `DELETE FROM ${qualifyTable('financial_accounts_tax_categories')} 
          WHERE tax_category_id IN ($1, $2)`,
-        [makeUUID('tax-category', 'expense-consulting'), makeUUID('tax-category', 'usd-account-tax-category')],
+        [makeUUID('expense-consulting'), makeUUID('usd-account-tax-category')],
       );
       await client.query(
         `DELETE FROM ${qualifyTable('financial_accounts')} WHERE account_number = $1`,
@@ -78,19 +78,19 @@ describe('Ledger Generation - Expense Scenario B (Foreign Currency)', () => {
       );
       await client.query(
         `DELETE FROM ${qualifyTable('tax_categories')} WHERE id IN ($1, $2)`,
-        [makeUUID('tax-category', 'expense-consulting'), makeUUID('tax-category', 'usd-account-tax-category')],
+        [makeUUID('expense-consulting'), makeUUID('usd-account-tax-category')],
       );
       await client.query(
         `DELETE FROM ${qualifyTable('businesses')} WHERE id IN ($1, $2)`,
-        [makeUUID('business', 'admin-business-usd'), makeUUID('business', 'supplier-us-vendor-llc')],
+        [makeUUID('admin-business-usd'), makeUUID('supplier-us-vendor-llc')],
       );
       await client.query(
         `DELETE FROM ${qualifyTable('financial_entities')} WHERE id IN ($1, $2, $3, $4)`,
         [
-          makeUUID('business', 'admin-business-usd'),
-          makeUUID('business', 'supplier-us-vendor-llc'),
-          makeUUID('tax-category', 'expense-consulting'),
-          makeUUID('tax-category', 'usd-account-tax-category'),
+          makeUUID('admin-business-usd'),
+          makeUUID('supplier-us-vendor-llc'),
+          makeUUID('expense-consulting'),
+          makeUUID('usd-account-tax-category'),
         ],
       );
     } finally {
@@ -106,7 +106,7 @@ describe('Ledger Generation - Expense Scenario B (Foreign Currency)', () => {
 
       await insertFixture(insertClient, expenseScenarioB);
 
-      const chargeId = makeUUID('charge', 'charge-consulting-services');
+      const chargeId = makeUUID('charge-consulting-services');
 
       // Verify inserts within the same transaction
       const chargeResult = await insertClient.query(
@@ -143,7 +143,7 @@ describe('Ledger Generation - Expense Scenario B (Foreign Currency)', () => {
     // Re-open a new client (outside prior transaction) for verification & generation
     const client = await db.getPool().connect();
     try {
-      const chargeId = makeUUID('charge', 'charge-consulting-services');
+      const chargeId = makeUUID('charge-consulting-services');
       const chargeResult = await client.query(
         `SELECT * FROM ${qualifyTable('charges')} WHERE id = $1`,
         [chargeId],
@@ -200,8 +200,8 @@ describe('Ledger Generation - Expense Scenario B (Foreign Currency)', () => {
       assertForeignExpenseScenario(ledgerResult.rows as any, {
         chargeId: charge.id,
         ownerId: charge.owner_id, // Use actual charge owner id
-        expenseEntity: makeUUID('tax-category', 'expense-consulting'),
-        bankEntity: makeUUID('tax-category', 'usd-account-tax-category'),
+        expenseEntity: makeUUID('expense-consulting'),
+        bankEntity: makeUUID('usd-account-tax-category'),
         expectedCurrency: Currency.Usd,
         expectedForeignAmount: ledgerExpectation?.foreignAmount || 200.0,
         expectedRate: ledgerExpectation?.exchangeRate || 3.5,
@@ -222,7 +222,7 @@ describe('Ledger Generation - Expense Scenario B (Foreign Currency)', () => {
   it('should be idempotent on repeated foreign ledger generation (no duplicate records)', async () => {
     const client = await db.getPool().connect();
     try {
-      const chargeId = makeUUID('charge', 'charge-consulting-services');
+      const chargeId = makeUUID('charge-consulting-services');
       // Ensure fixture inserted if absent
       const existingCharge = await client.query(
         `SELECT * FROM ${qualifyTable('charges')} WHERE id = $1`,
@@ -310,14 +310,14 @@ describe('Ledger Generation - Expense Scenario B (Foreign Currency)', () => {
     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'));
+    expect(accountMapping?.taxCategoryId).toBe(makeUUID('usd-account-tax-category'));
 
     // Verify expectations are defined
     expect(expenseScenarioB.expectations).toBeDefined();
     expect(expenseScenarioB.expectations?.ledger).toHaveLength(1);
 
     const ledgerExpectation = expenseScenarioB.expectations?.ledger?.[0];
-    expect(ledgerExpectation?.chargeId).toBe(makeUUID('charge', 'charge-consulting-services'));
+    expect(ledgerExpectation?.chargeId).toBe(makeUUID('charge-consulting-services'));
     expect(ledgerExpectation?.recordCount).toBe(2);
     expect(ledgerExpectation?.balanced).toBe(true);
     expect(ledgerExpectation?.totalDebitLocal).toBe(1400.0);
@@ -331,11 +331,11 @@ describe('Ledger Generation - Expense Scenario B (Foreign Currency)', () => {
 
   it('should create deterministic UUIDs for reproducible tests', () => {
     // Verify all IDs are deterministic and match expected values
-    const adminBusinessId = makeUUID('business', 'admin-business-usd');
-    const supplierId = makeUUID('business', 'supplier-us-vendor-llc');
-    const chargeId = makeUUID('charge', 'charge-consulting-services');
-    const transactionId = makeUUID('transaction', 'transaction-consulting-payment');
-    const documentId = makeUUID('document', 'document-consulting-invoice');
+    const adminBusinessId = makeUUID('admin-business-usd');
+    const supplierId = makeUUID('supplier-us-vendor-llc');
+    const chargeId = makeUUID('charge-consulting-services');
+    const transactionId = makeUUID('transaction-consulting-payment');
+    const documentId = makeUUID('document-consulting-invoice');
 
     expect(adminBusinessId).toBe(expenseScenarioB.businesses?.businesses[0]?.id);
     expect(supplierId).toBe(expenseScenarioB.businesses?.businesses[1]?.id);

package/dist/server/src/demo-fixtures/__tests__/deterministic-uuid.test.js

@@ -1,58 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { makeUUID } from '../helpers/deterministic-uuid.js';
-describe('deterministic-uuid', () => {
-    describe('makeUUID', () => {
-        it('generates same UUID for same inputs', () => {
-            const uuid1 = makeUUID('business', 'acme-consulting-llc');
-            const uuid2 = makeUUID('business', 'acme-consulting-llc');
-            expect(uuid1).toBe(uuid2);
-            expect(uuid1).toMatch(/^[0-9a-f]{8}-[0-9a-f]{4}-5[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/);
-        });
-        it('generates different UUIDs for different names', () => {
-            const uuid1 = makeUUID('business', 'acme-llc');
-            const uuid2 = makeUUID('business', 'acme-corp');
-            expect(uuid1).not.toBe(uuid2);
-        });
-        it('generates different UUIDs for different namespaces', () => {
-            const businessUUID = makeUUID('business', 'acme');
-            const chargeUUID = makeUUID('charge', 'acme');
-            expect(businessUUID).not.toBe(chargeUUID);
-        });
-        it('includes namespace in composite key', () => {
-            // Same name, different namespace types
-            const bizUUID = makeUUID('business', 'test-entity');
-            const transactionUUID = makeUUID('transaction', 'test-entity');
-            const documentUUID = makeUUID('document', 'test-entity');
-            expect(bizUUID).not.toBe(transactionUUID);
-            expect(bizUUID).not.toBe(documentUUID);
-            expect(transactionUUID).not.toBe(documentUUID);
-        });
-        it('generates valid UUID v5 format', () => {
-            const uuid = makeUUID('charge', 'monthly-invoice-2024-11');
-            // UUID v5 format: xxxxxxxx-xxxx-5xxx-yxxx-xxxxxxxxxxxx
-            // where y is one of [8, 9, a, b]
-            expect(uuid).toMatch(/^[0-9a-f]{8}-[0-9a-f]{4}-5[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/);
-        });
-        it('handles kebab-case names correctly', () => {
-            const uuid1 = makeUUID('business', 'us-supplier-acme-llc');
-            const uuid2 = makeUUID('business', 'us-supplier-acme-llc');
-            expect(uuid1).toBe(uuid2);
-        });
-        it('handles numeric components in names', () => {
-            const uuid1 = makeUUID('charge', 'invoice-2024-11-15');
-            const uuid2 = makeUUID('charge', 'invoice-2024-11-15');
-            expect(uuid1).toBe(uuid2);
-        });
-        it('is case-sensitive for names', () => {
-            const uuid1 = makeUUID('business', 'acme-llc');
-            const uuid2 = makeUUID('business', 'ACME-LLC');
-            expect(uuid1).not.toBe(uuid2);
-        });
-        it('is case-sensitive for namespaces', () => {
-            const uuid1 = makeUUID('business', 'acme');
-            const uuid2 = makeUUID('Business', 'acme');
-            expect(uuid1).not.toBe(uuid2);
-        });
-    });
-});
-//# sourceMappingURL=deterministic-uuid.test.js.map

package/dist/server/src/demo-fixtures/__tests__/deterministic-uuid.test.js.map

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

package/dist/server/src/demo-fixtures/helpers/deterministic-uuid.d.ts

@@ -1,50 +0,0 @@
-/**
- * Generate deterministic UUID v5 from semantic name.
- *
- * This function creates stable, reproducible UUIDs for demo/staging data entities.
- * The same namespace + name combination will always produce the same UUID across
- * deployments, making it safe to reference these IDs in documentation, screenshots,
- * and external links.
- *
- * @param namespace - Entity type: 'business', 'charge', 'transaction', 'document', etc.
- * @param name - Semantic identifier (kebab-case recommended)
- * @returns UUID v5 string (e.g., '550e8400-e29b-41d4-a716-446655440000')
- *
- * @example
- * ```typescript
- * // Business entity
- * makeUUID('business', 'acme-consulting-llc')
- * // => Always produces same UUID
- *
- * // Charge entity
- * makeUUID('charge', 'consulting-invoice-2024-11')
- * // => Stable across deploys
- *
- * // Financial account
- * makeUUID('financial-account', 'bank-usd-account')
- * // => Different from makeUUID('business', 'bank-usd-account')
- * ```
- *
- * @remarks
- * **Naming Conventions:**
- * - Use kebab-case for all semantic names
- * - Combine entity type + descriptive name ensures no collisions
- * - Never change a semantic name once deployed (breaks external links)
- * - For updates to same entity, append version: `acme-consulting-llc-v2`
- *
- * **Stability Warning:**
- * Once a UUID is generated and used in staging/production, the semantic name
- * MUST NOT be changed. Doing so will generate a different UUID and break:
- * - External documentation with embedded links
- * - Screenshots with visible UUIDs
- * - Any hardcoded references in client applications
- *
- * If you need to modify an entity, create a new semantic name with a version suffix.
- */
-export declare function makeUUID(namespace: string, name: string): string;
-/**
- * Backward compatible adapter for legacy single-argument API.
- * - When seed is provided, returns deterministic UUID v5 scoped under 'legacy' namespace
- * - When seed omitted, returns a random UUID to preserve previous behavior
- */
-export declare function makeUUIDLegacy(seed?: string): string;