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

package/dist/server/src/__tests__/environment-otel.test.js

@@ -0,0 +1,172 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+// Prevent dotenv from loading a real .env file and overriding our manual env manipulation
+vi.mock('dotenv', () => ({
+    config: vi.fn(),
+}));
+describe('OTEL Environment Configuration', () => {
+    const originalEnv = { ...process.env };
+    beforeEach(() => {
+        vi.resetModules();
+        process.env = { ...originalEnv };
+        // Required by other models in environment.ts
+        process.env.POSTGRES_HOST = 'localhost';
+        process.env.POSTGRES_PORT = '5432';
+        process.env.POSTGRES_DB = 'test_db';
+        process.env.POSTGRES_USER = 'test_user';
+        process.env.POSTGRES_PASSWORD = 'test_password';
+        // Clear all OTEL vars for a clean slate
+        delete process.env.OTEL_ENABLED;
+        delete process.env.OTEL_SERVICE_NAME;
+        delete process.env.OTEL_SERVICE_NAMESPACE;
+        delete process.env.OTEL_DEPLOYMENT_ENV;
+        delete process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
+        delete process.env.OTEL_EXPORTER_OTLP_HEADERS;
+        delete process.env.OTEL_TRACES_SAMPLER;
+        delete process.env.OTEL_TRACES_SAMPLER_ARG;
+        delete process.env.OTEL_STARTUP_STRICT;
+    });
+    afterEach(() => {
+        process.env = originalEnv;
+    });
+    it('should use default values when no OTEL env vars are set', async () => {
+        const { env } = await import('../environment.js');
+        expect(env.otel.enabled).toBe(false);
+        expect(env.otel.serviceName).toBe('accounter-server');
+        expect(env.otel.serviceNamespace).toBe('accounter');
+        expect(env.otel.tracesSampler).toBe('always_on');
+        expect(env.otel.startupStrict).toBe(false);
+        expect(env.otel.exporterEndpoint).toBeUndefined();
+        expect(env.otel.exporterHeaders).toBeUndefined();
+        expect(env.otel.tracesSamplerArg).toBeUndefined();
+    });
+    it('should treat empty string OTEL_ENABLED as disabled', async () => {
+        process.env.OTEL_ENABLED = '';
+        const { env } = await import('../environment.js');
+        expect(env.otel.enabled).toBe(false);
+    });
+    it('should fail validation when OTEL is enabled but endpoint is missing', async () => {
+        process.env.OTEL_ENABLED = '1';
+        delete process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
+        const exitSpy = vi.spyOn(process, 'exit').mockImplementation((() => { }));
+        const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        try {
+            await import('../environment.js');
+        }
+        catch {
+            // ignored — extractConfig throws after mocked process.exit
+        }
+        expect(exitSpy).toHaveBeenCalledWith(1);
+        exitSpy.mockRestore();
+        errorSpy.mockRestore();
+    });
+    it('should parse a valid enabled OTEL configuration', async () => {
+        process.env.OTEL_ENABLED = '1';
+        process.env.OTEL_EXPORTER_OTLP_ENDPOINT = 'http://localhost:4318';
+        process.env.OTEL_SERVICE_NAME = 'my-service';
+        process.env.OTEL_SERVICE_NAMESPACE = 'my-ns';
+        process.env.OTEL_DEPLOYMENT_ENV = 'staging';
+        process.env.OTEL_TRACES_SAMPLER = 'parentbased_traceidratio';
+        process.env.OTEL_TRACES_SAMPLER_ARG = '0.5';
+        process.env.OTEL_EXPORTER_OTLP_HEADERS = 'Authorization=Bearer token';
+        process.env.OTEL_STARTUP_STRICT = 'true';
+        const { env } = await import('../environment.js');
+        expect(env.otel.enabled).toBe(true);
+        expect(env.otel.exporterEndpoint).toBe('http://localhost:4318');
+        expect(env.otel.serviceName).toBe('my-service');
+        expect(env.otel.serviceNamespace).toBe('my-ns');
+        expect(env.otel.deploymentEnv).toBe('staging');
+        expect(env.otel.tracesSampler).toBe('parentbased_traceidratio');
+        expect(env.otel.tracesSamplerArg).toBe(0.5);
+        expect(env.otel.exporterHeaders).toBe('Authorization=Bearer token');
+        expect(env.otel.startupStrict).toBe(true);
+    });
+    it('should parse OTEL_TRACES_SAMPLER_ARG for traceidratio sampler', async () => {
+        process.env.OTEL_ENABLED = '1';
+        process.env.OTEL_EXPORTER_OTLP_ENDPOINT = 'http://localhost:4318';
+        process.env.OTEL_TRACES_SAMPLER = 'traceidratio';
+        process.env.OTEL_TRACES_SAMPLER_ARG = '0.25';
+        const { env } = await import('../environment.js');
+        expect(env.otel.tracesSampler).toBe('traceidratio');
+        expect(env.otel.tracesSamplerArg).toBe(0.25);
+    });
+    it('should fail validation when OTEL_TRACES_SAMPLER_ARG is out of range', async () => {
+        process.env.OTEL_ENABLED = '1';
+        process.env.OTEL_EXPORTER_OTLP_ENDPOINT = 'http://localhost:4318';
+        process.env.OTEL_TRACES_SAMPLER = 'parentbased_traceidratio';
+        process.env.OTEL_TRACES_SAMPLER_ARG = '1.5';
+        const exitSpy = vi.spyOn(process, 'exit').mockImplementation((() => { }));
+        const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        try {
+            await import('../environment.js');
+        }
+        catch {
+            // ignored
+        }
+        expect(exitSpy).toHaveBeenCalledWith(1);
+        exitSpy.mockRestore();
+        errorSpy.mockRestore();
+    });
+    it('should fail validation when OTEL_TRACES_SAMPLER_ARG is not numeric', async () => {
+        process.env.OTEL_ENABLED = '1';
+        process.env.OTEL_EXPORTER_OTLP_ENDPOINT = 'http://localhost:4318';
+        process.env.OTEL_TRACES_SAMPLER = 'parentbased_traceidratio';
+        process.env.OTEL_TRACES_SAMPLER_ARG = 'not-a-number';
+        const exitSpy = vi.spyOn(process, 'exit').mockImplementation((() => { }));
+        const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        try {
+            await import('../environment.js');
+        }
+        catch {
+            // ignored
+        }
+        expect(exitSpy).toHaveBeenCalledWith(1);
+        exitSpy.mockRestore();
+        errorSpy.mockRestore();
+    });
+    it('should accept OTEL_TRACES_SAMPLER_ARG of 0 and 1 (boundaries)', async () => {
+        process.env.OTEL_ENABLED = '1';
+        process.env.OTEL_EXPORTER_OTLP_ENDPOINT = 'http://localhost:4318';
+        process.env.OTEL_TRACES_SAMPLER = 'parentbased_traceidratio';
+        process.env.OTEL_TRACES_SAMPLER_ARG = '0';
+        const { env: env0 } = await import('../environment.js');
+        expect(env0.otel.tracesSamplerArg).toBe(0);
+        vi.resetModules();
+        process.env.OTEL_TRACES_SAMPLER_ARG = '1';
+        const { env: env1 } = await import('../environment.js');
+        expect(env1.otel.tracesSamplerArg).toBe(1);
+    });
+    it('should fail validation when ratio sampler is selected without OTEL_TRACES_SAMPLER_ARG', async () => {
+        process.env.OTEL_ENABLED = '1';
+        process.env.OTEL_EXPORTER_OTLP_ENDPOINT = 'http://localhost:4318';
+        process.env.OTEL_TRACES_SAMPLER = 'parentbased_traceidratio';
+        delete process.env.OTEL_TRACES_SAMPLER_ARG;
+        const exitSpy = vi.spyOn(process, 'exit').mockImplementation((() => { }));
+        const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        try {
+            await import('../environment.js');
+        }
+        catch {
+            // ignored
+        }
+        expect(exitSpy).toHaveBeenCalledWith(1);
+        exitSpy.mockRestore();
+        errorSpy.mockRestore();
+    });
+    it('should ignore OTEL_TRACES_SAMPLER_ARG when sampler is not ratio-based', async () => {
+        process.env.OTEL_ENABLED = '1';
+        process.env.OTEL_EXPORTER_OTLP_ENDPOINT = 'http://localhost:4318';
+        process.env.OTEL_TRACES_SAMPLER = 'always_off';
+        process.env.OTEL_TRACES_SAMPLER_ARG = 'not-a-number';
+        const { env } = await import('../environment.js');
+        expect(env.otel.tracesSampler).toBe('always_off');
+        expect(env.otel.tracesSamplerArg).toBeUndefined();
+    });
+    it('should not require startup strict and default it to false', async () => {
+        process.env.OTEL_ENABLED = '1';
+        process.env.OTEL_EXPORTER_OTLP_ENDPOINT = 'http://localhost:4318';
+        delete process.env.OTEL_STARTUP_STRICT;
+        const { env } = await import('../environment.js');
+        expect(env.otel.startupStrict).toBe(false);
+    });
+});
+//# sourceMappingURL=environment-otel.test.js.map

package/dist/server/src/__tests__/environment-otel.test.js.map

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

package/dist/server/src/__tests__/environment.test.d.ts

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

package/dist/server/src/__tests__/environment.test.js

@@ -0,0 +1,72 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+// We must mock dotenv to prevent it from overwriting our manual process.env changes
+// or picking up a real .env file that might confuse things
+vi.mock('dotenv', () => ({
+    config: vi.fn(),
+}));
+describe('Environment Configuration', () => {
+    const originalEnv = { ...process.env };
+    beforeEach(() => {
+        vi.resetModules();
+        process.env = { ...originalEnv };
+        // Mock common required vars here
+        process.env.POSTGRES_HOST = 'localhost';
+        process.env.POSTGRES_PORT = '5432';
+        process.env.POSTGRES_DB = 'test_db';
+        process.env.POSTGRES_USER = 'test_user';
+        process.env.POSTGRES_PASSWORD = 'test_password';
+    });
+    afterEach(() => {
+        process.env = originalEnv;
+    });
+    it('should load Auth0 configuration when provided', async () => {
+        process.env.AUTH0_DOMAIN = 'test-domain';
+        process.env.AUTH0_AUDIENCE = 'test-audience';
+        process.env.AUTH0_CLIENT_ID = 'test-client-id';
+        process.env.AUTH0_CLIENT_SECRET = 'test-client-secret';
+        process.env.AUTH0_MANAGEMENT_AUDIENCE = 'test-management-audience';
+        const { env } = await import('../environment.js');
+        expect(env.auth0).toEqual({
+            domain: 'test-domain',
+            audience: 'test-audience',
+            clientId: 'test-client-id',
+            clientSecret: 'test-client-secret',
+            managementAudience: 'test-management-audience',
+        });
+    });
+    it('should not load Auth0 configuration when variables are missing', async () => {
+        delete process.env.AUTH0_DOMAIN;
+        delete process.env.AUTH0_AUDIENCE;
+        delete process.env.AUTH0_CLIENT_ID;
+        delete process.env.AUTH0_CLIENT_SECRET;
+        delete process.env.AUTH0_MANAGEMENT_AUDIENCE;
+        const { env } = await import('../environment.js');
+        expect(env.auth0).toBeUndefined();
+    });
+    it('should fail validation when partially configured', async () => {
+        // Reset modules to ensure environment.ts is re-executed
+        vi.resetModules();
+        // Ensure clean slate for this test
+        delete process.env.AUTH0_DOMAIN;
+        delete process.env.AUTH0_AUDIENCE;
+        delete process.env.AUTH0_CLIENT_ID;
+        delete process.env.AUTH0_CLIENT_SECRET;
+        delete process.env.AUTH0_MANAGEMENT_AUDIENCE;
+        process.env.AUTH0_DOMAIN = 'test-domain';
+        // Missing others
+        // Since environment.ts exits the process on failure, we need to spy on process.exit
+        // and console.error
+        const exitSpy = vi.spyOn(process, 'exit').mockImplementation((() => { }));
+        const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        try {
+            await import('../environment.js');
+        }
+        catch (e) {
+            // Expected error because we mocked process.exit to not actually exit, 
+            // so code continued and hit the extractConfig check
+        }
+        expect(exitSpy).toHaveBeenCalledWith(1);
+        expect(errorSpy).toHaveBeenCalledWith(expect.stringContaining('❌ Invalid environment variables:'), expect.stringContaining('AUTH0_AUDIENCE'));
+    });
+});
+//# sourceMappingURL=environment.test.js.map

package/dist/server/src/__tests__/environment.test.js.map

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

package/dist/server/src/__tests__/factories/business.d.ts

@@ -0,0 +1,32 @@
+import { FixtureBusinesses } from '../helpers/fixture-types.js';
+/**
+ * Business factory for test fixtures
+ *
+ * Creates a minimal business object ready for insertion via pgtyped.
+ *
+ * @param overrides - Optional overrides for any business field
+ * @returns Business object matching FixtureBusinesses['businesses'][0] shape
+ *
+ * @remarks
+ * - id defaults to deterministic UUID if not provided
+ * - name defaults to overrides.id ?? defaultId (intelligent fallback for display)
+ * - All other fields default to null/void (database will use defaults or accept nulls)
+ * - exemptDealer defaults to false for typical scenarios
+ * - isReceiptEnough defaults to false (invoices required by default)
+ * - isDocumentsOptional defaults to false (documents required by default)
+ *
+ * @example
+ * ```typescript
+ * // Minimal business (uses defaults)
+ * const business = createBusiness({ id: makeUUID('business', 'supplier-1') });
+ *
+ * // Business with custom fields
+ * const supplier = createBusiness({
+ *   id: makeUUID('business', 'supplier-usd'),
+ *   name: 'American Supplier',
+ *   country: 'USA',
+ *   isReceiptEnough: true,
+ * });
+ * ```
+ */
+export declare function createBusiness(overrides?: Partial<FixtureBusinesses['businesses'][number]>): FixtureBusinesses['businesses'][number];

package/dist/server/src/__tests__/factories/business.js

@@ -0,0 +1,59 @@
+import { makeUUIDLegacy } from '../../demo-fixtures/helpers/deterministic-uuid.js';
+import { CountryCode } from '../../shared/enums.js';
+/**
+ * Business factory for test fixtures
+ *
+ * Creates a minimal business object ready for insertion via pgtyped.
+ *
+ * @param overrides - Optional overrides for any business field
+ * @returns Business object matching FixtureBusinesses['businesses'][0] shape
+ *
+ * @remarks
+ * - id defaults to deterministic UUID if not provided
+ * - name defaults to overrides.id ?? defaultId (intelligent fallback for display)
+ * - All other fields default to null/void (database will use defaults or accept nulls)
+ * - exemptDealer defaults to false for typical scenarios
+ * - isReceiptEnough defaults to false (invoices required by default)
+ * - isDocumentsOptional defaults to false (documents required by default)
+ *
+ * @example
+ * ```typescript
+ * // Minimal business (uses defaults)
+ * const business = createBusiness({ id: makeUUID('business', 'supplier-1') });
+ *
+ * // Business with custom fields
+ * const supplier = createBusiness({
+ *   id: makeUUID('business', 'supplier-usd'),
+ *   name: 'American Supplier',
+ *   country: 'USA',
+ *   isReceiptEnough: true,
+ * });
+ * ```
+ */
+export function createBusiness(overrides) {
+    const defaultId = makeUUIDLegacy();
+    return {
+        id: defaultId,
+        // Intelligent name defaulting: use provided id, or use generated UUID
+        // This ensures display name is always meaningful even when only id is specified
+        name: overrides?.id ?? defaultId,
+        hebrewName: null,
+        address: null,
+        city: null,
+        zipCode: null,
+        email: null,
+        website: null,
+        phoneNumber: null,
+        governmentId: null,
+        exemptDealer: false,
+        suggestions: null,
+        optionalVat: false, // Database requires NOT NULL
+        country: CountryCode.Israel, // Database requires NOT NULL, default to Israel
+        pcn874RecordTypeOverride: null,
+        isReceiptEnough: false,
+        isDocumentsOptional: false,
+        ownerId: defaultId,
+        ...overrides,
+    };
+}
+//# sourceMappingURL=business.js.map

package/dist/server/src/__tests__/factories/business.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"business.js","sourceRoot":"","sources":["../../../../../src/__tests__/factories/business.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mDAAmD,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,cAAc,CAC5B,SAA4D;IAE5D,MAAM,SAAS,GAAG,cAAc,EAAE,CAAC;IACnC,OAAO;QACL,EAAE,EAAE,SAAS;QACb,sEAAsE;QACtE,gFAAgF;QAChF,IAAI,EAAE,SAAS,EAAE,EAAE,IAAI,SAAS;QAChC,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,IAAI;QACjB,YAAY,EAAE,IAAI;QAClB,YAAY,EAAE,KAAK;QACnB,WAAW,EAAE,IAAI;QACjB,WAAW,EAAE,KAAK,EAAE,6BAA6B;QACjD,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,gDAAgD;QAC7E,wBAAwB,EAAE,IAAI;QAC9B,eAAe,EAAE,KAAK;QACtB,mBAAmB,EAAE,KAAK;QAC1B,OAAO,EAAE,SAAS;QAClB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC"}

package/dist/server/src/__tests__/factories/business.test.d.ts

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

package/dist/server/src/__tests__/factories/business.test.js

@@ -0,0 +1,118 @@
+import { describe, expect, it } from 'vitest';
+import { UUID_REGEX } from '../../shared/constants.js';
+import { createBusiness } from './business.js';
+import { makeUUID } from '../../demo-fixtures/helpers/deterministic-uuid.js';
+import { CountryCode } from '../../shared/enums.js';
+describe('Factory: Business', () => {
+    describe('createBusiness', () => {
+        it('should create business with default values', () => {
+            const business = createBusiness();
+            // Required field with default
+            expect(business.id).toBeDefined();
+            expect(business.id).toMatch(UUID_REGEX);
+            // Boolean defaults
+            expect(business.exemptDealer).toBe(false);
+            expect(business.isReceiptEnough).toBe(false);
+            expect(business.isDocumentsOptional).toBe(false);
+            // Null/void defaults
+            expect(business.hebrewName).toBeNull();
+            expect(business.address).toBeNull();
+            expect(business.city).toBeNull();
+            expect(business.zipCode).toBeNull();
+            expect(business.email).toBeNull();
+            expect(business.website).toBeNull();
+            expect(business.phoneNumber).toBeNull();
+            expect(business.governmentId).toBeNull();
+            expect(business.suggestions).toBeNull();
+            expect(business.optionalVat).toBe(false); // NOT NULL constraint
+            expect(business.country).toBe('ISR'); // NOT NULL constraint, default to Israel
+            expect(business.pcn874RecordTypeOverride).toBeNull();
+        });
+        it('should generate unique IDs by default', () => {
+            const business1 = createBusiness();
+            const business2 = createBusiness();
+            expect(business1.id).not.toBe(business2.id);
+        });
+        it('should apply overrides correctly', () => {
+            const customId = makeUUID('business', 'custom-business');
+            const business = createBusiness({
+                id: customId,
+                name: 'עסק ישראלי',
+                country: CountryCode.Israel,
+                exemptDealer: true,
+                isReceiptEnough: true,
+                isDocumentsOptional: true,
+            });
+            expect(business.id).toBe(customId);
+            expect(business.name).toBe('עסק ישראלי');
+            expect(business.country).toBe(CountryCode.Israel);
+            expect(business.exemptDealer).toBe(true);
+            expect(business.isReceiptEnough).toBe(true);
+            expect(business.isDocumentsOptional).toBe(true);
+        });
+        it('should allow partial overrides', () => {
+            const business = createBusiness({
+                name: 'ספק מקומי',
+            });
+            expect(business.name).toBe('ספק מקומי');
+            expect(business.id).toBeDefined();
+            expect(business.exemptDealer).toBe(false);
+            expect(business.country).toBe(CountryCode.Israel); // Default value, not null
+        });
+        it('should preserve all required fields', () => {
+            const business = createBusiness();
+            // Verify structure matches expected pgtyped interface
+            expect(business).toHaveProperty('id');
+            expect(business).toHaveProperty('hebrewName');
+            expect(business).toHaveProperty('address');
+            expect(business).toHaveProperty('city');
+            expect(business).toHaveProperty('zipCode');
+            expect(business).toHaveProperty('email');
+            expect(business).toHaveProperty('website');
+            expect(business).toHaveProperty('phoneNumber');
+            expect(business).toHaveProperty('governmentId');
+            expect(business).toHaveProperty('exemptDealer');
+            expect(business).toHaveProperty('suggestions');
+            expect(business).toHaveProperty('optionalVat');
+            expect(business).toHaveProperty('country');
+            expect(business).toHaveProperty('pcn874RecordTypeOverride');
+            expect(business).toHaveProperty('isReceiptEnough');
+            expect(business).toHaveProperty('isDocumentsOptional');
+        });
+        it('should handle contact information overrides', () => {
+            const business = createBusiness({
+                email: 'supplier@example.com',
+                phoneNumber: '+972-50-1234567',
+                website: 'https://example.com',
+                address: '123 Main St',
+                city: 'Tel Aviv',
+                zipCode: '61000',
+            });
+            expect(business.email).toBe('supplier@example.com');
+            expect(business.phoneNumber).toBe('+972-50-1234567');
+            expect(business.website).toBe('https://example.com');
+            expect(business.address).toBe('123 Main St');
+            expect(business.city).toBe('Tel Aviv');
+            expect(business.zipCode).toBe('61000');
+        });
+        it('should handle government ID and exempt dealer scenario', () => {
+            const business = createBusiness({
+                governmentId: '123456789',
+                exemptDealer: true,
+                optionalVat: true,
+            });
+            expect(business.governmentId).toBe('123456789');
+            expect(business.exemptDealer).toBe(true);
+            expect(business.optionalVat).toBe(true);
+        });
+        it('should allow explicit null overrides', () => {
+            const business = createBusiness({
+                hebrewName: null,
+                country: null,
+            });
+            expect(business.hebrewName).toBeNull();
+            expect(business.country).toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=business.test.js.map

package/dist/server/src/__tests__/factories/business.test.js.map

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

package/dist/server/src/__tests__/factories/charge.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Charge factory for test fixtures
+ *
+ * Creates minimal charge objects ready for database insertion.
+ *
+ * Based on charges table schema from migrations and charges.provider.ts:
+ * - Required: owner_id
+ * - Optional: type, accountant_status, user_description, tax_category_id, optional_vat, documents_optional_flag, is_property
+ *
+ * @see packages/server/src/modules/charges/providers/charges.provider.ts (generateCharge query)
+ * @see packages/migrations/src/actions/*-charges-*.ts (migrations)
+ */
+/**
+ * Charge insert parameters shape
+ *
+ * Matches the fields from generateCharge SQL query in charges.provider.ts:
+ * INSERT INTO accounter_schema.charges (owner_id, type, accountant_status, user_description, tax_category_id, optional_vat, documents_optional_flag)
+ */
+export interface ChargeInsertParams {
+    id?: string;
+    owner_id: string;
+    is_property?: boolean | null;
+    type?: string | null;
+    accountant_status?: string | null;
+    user_description?: string | null;
+    tax_category_id?: string | null;
+    optional_vat?: boolean | null;
+    documents_optional_flag?: boolean | null;
+}
+/**
+ * Create a charge for test fixtures
+ *
+ * @param params - Required fields (owner_id, tax_category_id) and optional user_description
+ * @param overrides - Optional overrides for any charge field
+ * @returns Charge object ready for database insertion
+ *
+ * @remarks
+ * - owner_id is required (must be a valid business UUID)
+ * - tax_category_id defaults to deterministic UUID if not provided
+ * - user_description defaults to null (will be auto-generated by database if needed)
+ * - type defaults to null (database will determine based on related records)
+ * - accountant_status defaults to 'PENDING' (database requires NOT NULL)
+ * - optional_vat defaults to false (database requires NOT NULL)
+ * - documents_optional_flag defaults to false (database requires NOT NULL)
+ * - is_property defaults to null (property-related charges can override to true)
+ * - id defaults to deterministic UUID if not provided
+ *
+ * @example
+ * ```typescript
+ * // Minimal charge with required fields
+ * const charge = createCharge({
+ *   owner_id: makeUUID('business', 'test-owner'),
+ *   tax_category_id: makeUUID('tax-category', 'tax-cat-1'),
+ * });
+ *
+ * // Charge with user description
+ * const descCharge = createCharge(
+ *   {
+ *     owner_id: makeUUID('business', 'test-owner'),
+ *     tax_category_id: makeUUID('tax-category', 'tax-cat-1'),
+ *     user_description: 'Office supplies purchase',
+ *   }
+ * );
+ *
+ * // Charge with overrides
+ * const customCharge = createCharge(
+ *   {
+ *     owner_id: makeUUID('business', 'test-owner'),
+ *     tax_category_id: makeUUID('tax-category', 'tax-cat-1'),
+ *   },
+ *   {
+ *     type: 'PAYROLL',
+ *     accountant_status: 'REVIEWED',
+ *     optional_vat: true,
+ *   }
+ * );
+ * ```
+ */
+export declare function createCharge(params: {
+    owner_id: string;
+    tax_category_id?: string;
+    user_description?: string;
+}, overrides?: Partial<ChargeInsertParams>): ChargeInsertParams;