@accounter/server 0.0.9-alpha-20251231083050-a0e737863ca2a9fa68506d15357e55d9287972cb → 0.0.9-alpha-20251231163357-33d4c33fec5e21dad2e04d1f293f6248d2550588

package/dist/server/src/demo-fixtures/helpers/admin-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-context.js","sourceRoot":"","sources":["../../../../../src/demo-fixtures/helpers/admin-context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,MAAc;IAC7D,MAAM,eAAe,GAAG,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;IAE/D,iEAAiE;IACjE,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,KAAK,CACnC;;;cAGU,EACV,CAAC,eAAe,CAAC,CAClB,CAAC;IAEF,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/B,CAAC;IAED,6GAA6G;IAC7G,0BAA0B;IAC1B,4FAA4F;IAC5F,uEAAuE;IACvE,2EAA2E;IAC3E,EAAE;IACF,oFAAoF;IACpF,uFAAuF;IACvF,MAAM,OAAO,GAAG,eAAe,CAAC;IAChC,MAAM,MAAM,CAAC,KAAK,CAChB;+DAC2D,EAC3D,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,uDAAuD;IACvD,MAAM,MAAM,CAAC,KAAK,CAChB;iBACa,EACb,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,8DAA8D;IAC9D,MAAM,MAAM,CAAC,KAAK,CAChB;;mBAEe,EACf,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,45 @@
+/**
+ * Placeholder strings used in demo fixtures for runtime replacement.
+ */
+export declare const PLACEHOLDERS: {
+    readonly ADMIN_BUSINESS_ID: "{{ADMIN_BUSINESS_ID}}";
+};
+/**
+ * Resolve admin business ID placeholders in fixture objects.
+ *
+ * This function performs a deep replacement of all `{{ADMIN_BUSINESS_ID}}` placeholder
+ * strings within a fixture object by serializing to JSON, replacing all occurrences,
+ * and deserializing back to the original type.
+ *
+ * @param fixture - Fixture object containing placeholders (any type)
+ * @param adminBusinessId - The actual admin business UUID to replace placeholders with
+ * @returns New fixture object with all placeholders replaced
+ *
+ * @example
+ * ```typescript
+ * const fixture = {
+ *   id: 'charge-123',
+ *   ownerId: '{{ADMIN_BUSINESS_ID}}',
+ *   nested: {
+ *     businessId: '{{ADMIN_BUSINESS_ID}}'
+ *   }
+ * };
+ *
+ * const resolved = resolveAdminPlaceholders(fixture, 'actual-uuid-123');
+ * // {
+ * //   id: 'charge-123',
+ * //   ownerId: 'actual-uuid-123',
+ * //   nested: { businessId: 'actual-uuid-123' }
+ * // }
+ * ```
+ *
+ * @remarks
+ * **Performance Note:**
+ * Uses JSON serialization for deep replacement. For very large fixture objects,
+ * consider a more optimized approach if performance becomes an issue.
+ *
+ * **Type Safety:**
+ * Returns the same type as input, but type information is lost during JSON
+ * serialization (e.g., Date objects become strings). Use with plain object fixtures.
+ */
+export declare function resolveAdminPlaceholders<T>(fixture: T, adminBusinessId: string): T;

package/dist/server/src/demo-fixtures/helpers/placeholder.js

@@ -0,0 +1,50 @@
+/**
+ * Placeholder strings used in demo fixtures for runtime replacement.
+ */
+export const PLACEHOLDERS = {
+    ADMIN_BUSINESS_ID: '{{ADMIN_BUSINESS_ID}}',
+};
+/**
+ * Resolve admin business ID placeholders in fixture objects.
+ *
+ * This function performs a deep replacement of all `{{ADMIN_BUSINESS_ID}}` placeholder
+ * strings within a fixture object by serializing to JSON, replacing all occurrences,
+ * and deserializing back to the original type.
+ *
+ * @param fixture - Fixture object containing placeholders (any type)
+ * @param adminBusinessId - The actual admin business UUID to replace placeholders with
+ * @returns New fixture object with all placeholders replaced
+ *
+ * @example
+ * ```typescript
+ * const fixture = {
+ *   id: 'charge-123',
+ *   ownerId: '{{ADMIN_BUSINESS_ID}}',
+ *   nested: {
+ *     businessId: '{{ADMIN_BUSINESS_ID}}'
+ *   }
+ * };
+ *
+ * const resolved = resolveAdminPlaceholders(fixture, 'actual-uuid-123');
+ * // {
+ * //   id: 'charge-123',
+ * //   ownerId: 'actual-uuid-123',
+ * //   nested: { businessId: 'actual-uuid-123' }
+ * // }
+ * ```
+ *
+ * @remarks
+ * **Performance Note:**
+ * Uses JSON serialization for deep replacement. For very large fixture objects,
+ * consider a more optimized approach if performance becomes an issue.
+ *
+ * **Type Safety:**
+ * Returns the same type as input, but type information is lost during JSON
+ * serialization (e.g., Date objects become strings). Use with plain object fixtures.
+ */
+export function resolveAdminPlaceholders(fixture, adminBusinessId) {
+    const json = JSON.stringify(fixture);
+    const resolved = json.replace(/\{\{ADMIN_BUSINESS_ID\}\}/g, adminBusinessId);
+    return JSON.parse(resolved);
+}
+//# sourceMappingURL=placeholder.js.map

package/dist/server/src/demo-fixtures/helpers/placeholder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder.js","sourceRoot":"","sources":["../../../../../src/demo-fixtures/helpers/placeholder.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,iBAAiB,EAAE,uBAAuB;CAClC,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,UAAU,wBAAwB,CAAI,OAAU,EAAE,eAAuB;IAC7E,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,4BAA4B,EAAE,eAAe,CAAC,CAAC;IAC7E,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAM,CAAC;AACnC,CAAC"}

package/dist/server/src/demo-fixtures/helpers/seed-exchange-rates.d.ts

@@ -0,0 +1,21 @@
+import type { Client } from 'pg';
+/**
+ * Seed FIAT exchange rates for demo data.
+ *
+ * Inserts or updates exchange rates for common currencies to ILS.
+ * Uses ON CONFLICT to ensure idempotent seeding.
+ *
+ * **Schema Note**: The exchange_rates table stores rates as individual columns
+ * (usd, eur, gbp, etc.) for a given exchange_date, NOT as normalized rows.
+ * This denormalized structure optimizes read performance for multi-currency queries.
+ *
+ * Example row:
+ * | exchange_date | usd | eur | gbp |
+ * | 2024-11-26    | 3.5 | 4.0 | 4.5 |
+ *
+ * Rates seeded:
+ * - USD: 3.5 ILS
+ * - EUR: 4.0 ILS
+ * - GBP: 4.5 ILS
+ */
+export declare function seedExchangeRates(client: Client): Promise<void>;

package/dist/server/src/demo-fixtures/helpers/seed-exchange-rates.js

@@ -0,0 +1,26 @@
+/**
+ * Seed FIAT exchange rates for demo data.
+ *
+ * Inserts or updates exchange rates for common currencies to ILS.
+ * Uses ON CONFLICT to ensure idempotent seeding.
+ *
+ * **Schema Note**: The exchange_rates table stores rates as individual columns
+ * (usd, eur, gbp, etc.) for a given exchange_date, NOT as normalized rows.
+ * This denormalized structure optimizes read performance for multi-currency queries.
+ *
+ * Example row:
+ * | exchange_date | usd | eur | gbp |
+ * | 2024-11-26    | 3.5 | 4.0 | 4.5 |
+ *
+ * Rates seeded:
+ * - USD: 3.5 ILS
+ * - EUR: 4.0 ILS
+ * - GBP: 4.5 ILS
+ */
+export async function seedExchangeRates(client) {
+    await client.query(`INSERT INTO accounter_schema.exchange_rates (exchange_date, usd, eur, gbp)
+     VALUES (CURRENT_DATE, 3.5, 4.0, 4.5)
+     ON CONFLICT (exchange_date)
+     DO UPDATE SET usd = EXCLUDED.usd, eur = EXCLUDED.eur, gbp = EXCLUDED.gbp`);
+}
+//# sourceMappingURL=seed-exchange-rates.js.map

package/dist/server/src/demo-fixtures/helpers/seed-exchange-rates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-exchange-rates.js","sourceRoot":"","sources":["../../../../../src/demo-fixtures/helpers/seed-exchange-rates.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAc;IACpD,MAAM,MAAM,CAAC,KAAK,CAChB;;;8EAG0E,CAC3E,CAAC;AACJ,CAAC"}

package/dist/server/src/demo-fixtures/helpers/seed-vat.d.ts

@@ -0,0 +1,20 @@
+import type { Client } from 'pg';
+/**
+ * Seed VAT percentage history for demo data.
+ *
+ * Inserts historical VAT rates with effective dates. Israel's VAT has changed
+ * over time, so we maintain a history table to support accurate calculations
+ * for documents from different time periods.
+ *
+ * **Schema Note**: Percentage stored as decimal (0.17 = 17%), not integer.
+ * Column name is 'date', not 'effective_date' or 'effectiveDate'.
+ *
+ * Current rates:
+ * - 17% effective from 2015-01-01
+ * - 18% effective from 2025-01-01
+ *
+ * Uses ON CONFLICT to ensure idempotency across multiple seed runs.
+ *
+ * @param client - PostgreSQL client instance
+ */
+export declare function seedVATDefault(client: Client): Promise<void>;

package/dist/server/src/demo-fixtures/helpers/seed-vat.js

@@ -0,0 +1,30 @@
+/**
+ * Seed VAT percentage history for demo data.
+ *
+ * Inserts historical VAT rates with effective dates. Israel's VAT has changed
+ * over time, so we maintain a history table to support accurate calculations
+ * for documents from different time periods.
+ *
+ * **Schema Note**: Percentage stored as decimal (0.17 = 17%), not integer.
+ * Column name is 'date', not 'effective_date' or 'effectiveDate'.
+ *
+ * Current rates:
+ * - 17% effective from 2015-01-01
+ * - 18% effective from 2025-01-01
+ *
+ * Uses ON CONFLICT to ensure idempotency across multiple seed runs.
+ *
+ * @param client - PostgreSQL client instance
+ */
+export async function seedVATDefault(client) {
+    const vatRates = [
+        { percentage: 0.17, date: '2015-01-01' },
+        { percentage: 0.18, date: '2025-01-01' },
+    ];
+    for (const { percentage, date } of vatRates) {
+        await client.query(`INSERT INTO accounter_schema.vat_value (percentage, date)
+       VALUES ($1, $2)
+       ON CONFLICT (date) DO NOTHING`, [percentage, date]);
+    }
+}
+//# sourceMappingURL=seed-vat.js.map

package/dist/server/src/demo-fixtures/helpers/seed-vat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-vat.js","sourceRoot":"","sources":["../../../../../src/demo-fixtures/helpers/seed-vat.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAc;IACjD,MAAM,QAAQ,GAAG;QACf,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE;QACxC,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE;KACzC,CAAC;IAEF,KAAK,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC5C,MAAM,MAAM,CAAC,KAAK,CAChB;;qCAE+B,EAC/B,CAAC,UAAU,EAAE,IAAI,CAAC,CACnB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/server/src/demo-fixtures/use-cases/equity/shareholder-dividend.d.ts

@@ -0,0 +1,9 @@
+import type { UseCaseSpec } from '../../../fixtures/fixture-spec.js';
+/**
+ * Shareholder Dividend (Q4 2024)
+ *
+ * Models a dividend payout in ILS with a single transaction
+ * and optional statement document. Designed as a simple
+ * equity scenario with minimal entities.
+ */
+export declare const shareholderDividend: UseCaseSpec;

package/dist/server/src/demo-fixtures/use-cases/equity/shareholder-dividend.js

@@ -0,0 +1,86 @@
+import { CountryCode, Currency } from '../../../shared/enums.js';
+import { makeUUID } from '../../helpers/deterministic-uuid.js';
+/**
+ * Shareholder Dividend (Q4 2024)
+ *
+ * Models a dividend payout in ILS with a single transaction
+ * and optional statement document. Designed as a simple
+ * equity scenario with minimal entities.
+ */
+export const shareholderDividend = {
+    id: 'shareholder-dividend',
+    name: 'Shareholder Dividend (Q4 2024)',
+    description: 'Dividend payout from ILS bank account with withholding tax counterparty. Includes optional statement document.',
+    category: 'equity',
+    fixtures: {
+        businesses: [
+            {
+                id: makeUUID('business', 'dividends-withholding-tax'),
+                name: 'Dividends Withholding Tax',
+                country: CountryCode['Israel'],
+                canSettleWithReceipt: false,
+            },
+        ],
+        taxCategories: [
+            {
+                id: makeUUID('tax-category', 'dividend'),
+                name: 'Dividend',
+            },
+        ],
+        financialAccounts: [
+            {
+                id: makeUUID('financial-account', 'bank-ils-account'),
+                accountNumber: '11-222-3333',
+                type: 'BANK_ACCOUNT',
+                currency: Currency.Ils,
+                taxCategoryMappings: [
+                    {
+                        taxCategoryId: makeUUID('tax-category', 'dividend'),
+                        currency: Currency.Ils,
+                    },
+                ],
+            },
+        ],
+        charges: [
+            {
+                id: makeUUID('charge', 'dividend-distribution-2024-q4'),
+                ownerId: '{{ADMIN_BUSINESS_ID}}',
+                userDescription: 'Dividend distribution for Q4 2024',
+            },
+        ],
+        transactions: [
+            {
+                id: makeUUID('transaction', 'dividend-payout-2024-q4'),
+                chargeId: makeUUID('charge', 'dividend-distribution-2024-q4'),
+                businessId: makeUUID('business', 'dividends-withholding-tax'),
+                amount: '-10000.00',
+                currency: Currency.Ils,
+                eventDate: '2024-12-31',
+                debitDate: '2024-12-31',
+                accountNumber: '11-222-3333',
+            },
+        ],
+        documents: [
+            {
+                id: makeUUID('document', 'dividend-statement-2024-q4'),
+                chargeId: makeUUID('charge', 'dividend-distribution-2024-q4'),
+                creditorId: makeUUID('business', 'dividends-withholding-tax'),
+                debtorId: '{{ADMIN_BUSINESS_ID}}',
+                serialNumber: 'DIV-2024-Q4',
+                type: 'INVOICE',
+                date: '2024-12-31',
+                totalAmount: '10000.00',
+                currencyCode: Currency.Ils,
+            },
+        ],
+    },
+    metadata: {
+        author: 'demo-team',
+        createdAt: '2024-11-24',
+        updatedAt: '2024-11-24',
+    },
+    expectations: {
+        ledgerRecordCount: 2,
+    },
+};
+//# sourceMappingURL=shareholder-dividend.js.map

package/dist/server/src/demo-fixtures/use-cases/equity/shareholder-dividend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shareholder-dividend.js","sourceRoot":"","sources":["../../../../../../src/demo-fixtures/use-cases/equity/shareholder-dividend.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAE/D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAgB;IAC9C,EAAE,EAAE,sBAAsB;IAC1B,IAAI,EAAE,gCAAgC;IACtC,WAAW,EACT,gHAAgH;IAClH,QAAQ,EAAE,QAAQ;IAClB,QAAQ,EAAE;QACR,UAAU,EAAE;YACV;gBACE,EAAE,EAAE,QAAQ,CAAC,UAAU,EAAE,2BAA2B,CAAC;gBACrD,IAAI,EAAE,2BAA2B;gBACjC,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC;gBAC9B,oBAAoB,EAAE,KAAK;aAC5B;SACF;QACD,aAAa,EAAE;YACb;gBACE,EAAE,EAAE,QAAQ,CAAC,cAAc,EAAE,UAAU,CAAC;gBACxC,IAAI,EAAE,UAAU;aACjB;SACF;QACD,iBAAiB,EAAE;YACjB;gBACE,EAAE,EAAE,QAAQ,CAAC,mBAAmB,EAAE,kBAAkB,CAAC;gBACrD,aAAa,EAAE,aAAa;gBAC5B,IAAI,EAAE,cAAc;gBACpB,QAAQ,EAAE,QAAQ,CAAC,GAAG;gBACtB,mBAAmB,EAAE;oBACnB;wBACE,aAAa,EAAE,QAAQ,CAAC,cAAc,EAAE,UAAU,CAAC;wBACnD,QAAQ,EAAE,QAAQ,CAAC,GAAG;qBACvB;iBACF;aACF;SACF;QACD,OAAO,EAAE;YACP;gBACE,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,+BAA+B,CAAC;gBACvD,OAAO,EAAE,uBAAuB;gBAChC,eAAe,EAAE,mCAAmC;aACrD;SACF;QACD,YAAY,EAAE;YACZ;gBACE,EAAE,EAAE,QAAQ,CAAC,aAAa,EAAE,yBAAyB,CAAC;gBACtD,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,+BAA+B,CAAC;gBAC7D,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,2BAA2B,CAAC;gBAC7D,MAAM,EAAE,WAAW;gBACnB,QAAQ,EAAE,QAAQ,CAAC,GAAG;gBACtB,SAAS,EAAE,YAAY;gBACvB,SAAS,EAAE,YAAY;gBACvB,aAAa,EAAE,aAAa;aAC7B;SACF;QACD,SAAS,EAAE;YACT;gBACE,EAAE,EAAE,QAAQ,CAAC,UAAU,EAAE,4BAA4B,CAAC;gBACtD,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,+BAA+B,CAAC;gBAC7D,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,2BAA2B,CAAC;gBAC7D,QAAQ,EAAE,uBAAuB;gBACjC,YAAY,EAAE,aAAa;gBAC3B,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,YAAY;gBAClB,WAAW,EAAE,UAAU;gBACvB,YAAY,EAAE,QAAQ,CAAC,GAAG;aAC3B;SACF;KACF;IACD,QAAQ,EAAE;QACR,MAAM,EAAE,WAAW;QACnB,SAAS,EAAE,YAAY;QACvB,SAAS,EAAE,YAAY;KACxB;IACD,YAAY,EAAE;QACZ,iBAAiB,EAAE,CAAC;KACrB;CACF,CAAC"}

package/dist/server/src/demo-fixtures/use-cases/expenses/monthly-expense-foreign-currency.d.ts

@@ -0,0 +1,12 @@
+import type { UseCaseSpec } from '../../../fixtures/fixture-spec.js';
+/**
+ * Monthly Expense Use-Case: Foreign Currency Transaction
+ *
+ * Demonstrates a US-based supplier invoice paid via bank transfer with
+ * exchange rate conversion from USD to ILS. This use-case validates:
+ * - Foreign currency transaction handling
+ * - Exchange rate application
+ * - Cross-border payment processing
+ * - Ledger generation with currency conversion
+ */
+export declare const monthlyExpenseForeignCurrency: UseCaseSpec;