@sneat/extension-splitus-contract 0.2.1 → 0.2.3

package/README.md

@@ -2,6 +2,27 @@
 
 Splitus extension contract library.
 
+## Bill contract version 1
+
+`ICreateSplitusBillV1Request` carries exact major-unit decimal strings,
+client-stable bill identity, and separate paid/owed contact allocations. The
+host must call `assertCreateSplitusBillV1Recorder` with its trusted
+authenticated identity before accepting the recorder audit claim.
+
+Parse untrusted API responses with `parseCreateSplitusBillV1Response`,
+`parseGetSplitusBillV1Response`, or `parseListSplitusBillsV1Response`. This
+rejects numeric money JSON, invalid posting proof, unsafe identifiers, and
+unbounded list/detail arrays before a runtime renders them. Contact IDs are
+resolved through the host's real Contactus data; they are not display labels.
+
+The earlier split DTOs and `ISplitusService` remain exported as deprecated
+compatibility surfaces until every consumer has moved to
+`ISplitusBillServiceV1`.
+
+The matching storage-neutral Go host contract is module
+`github.com/sneat-co/sneat-ext-contracts/splitus`, package
+`contract4splitus`.
+
 ## Provenance
 
 Migrated from sneat-co/debtus (npm continuity from @sneat/extension-splitus-contract@0.2.0).

package/fesm2022/sneat-extension-splitus-contract.mjs

@@ -1,10 +1,752 @@
 import { InjectionToken } from '@angular/core';
 
+/** The first stable Splitus bill browser/host wire contract. */
+const SPLITUS_BILL_CONTRACT_VERSION = 1;
+const MAX_SPLITUS_BILL_PARTICIPANTS = 256;
+const MAX_SPLITUS_BILL_LIST_PAGE_SIZE = 100;
+const MAX_SPLITUS_BILL_OBLIGATIONS = 256;
+const MAX_SPLITUS_OBLIGATION_IDS_PER_LINE = 256;
+const MAX_EXACT_MINOR_UNITS = 9223372036854775807n;
+const exactDecimalPattern = /^(?:0|[1-9][0-9]*)\.[0-9]{2}$/;
+const datePattern = /^([0-9]{4})-([0-9]{2})-([0-9]{2})$/;
+function parseExactDecimalString(value) {
+    if (typeof value !== 'string' || !exactDecimalPattern.test(value)) {
+        throw new TypeError('amount must be a canonical decimal string with exactly two fraction digits');
+    }
+    const minorUnits = BigInt(value.replace('.', ''));
+    if (minorUnits > MAX_EXACT_MINOR_UNITS) {
+        throw new RangeError('amount exceeds the Splitus contract limit');
+    }
+    return value;
+}
+function parseCreateSplitusBillV1Request(value) {
+    const input = record(value, 'create bill request');
+    if (input['contractVersion'] !== SPLITUS_BILL_CONTRACT_VERSION) {
+        throw new TypeError('unsupported Splitus bill contract version');
+    }
+    const billKind = enumValue(input['billKind'], ['general', 'utility'], 'billKind');
+    const actualAmount = positiveAmount(input['actualAmount'], 'actualAmount');
+    const spaceID = storageID(input['spaceID'], 'spaceID');
+    const billID = storageID(input['billID'], 'billID');
+    const recorderUserID = storageID(input['recorderUserID'], 'recorderUserID');
+    const request = {
+        contractVersion: SPLITUS_BILL_CONTRACT_VERSION,
+        spaceID,
+        billID,
+        recorderUserID,
+        title: optionalText(input['title'], 'title', 256),
+        billKind,
+        currency: currency(input['currency']),
+        actualAmount,
+        paidAllocations: allocations(input['paidAllocations'], 'paidAllocations'),
+        owedAllocations: allocations(input['owedAllocations'], 'owedAllocations'),
+        utility: input['utility'] === undefined ? undefined : utility(input['utility']),
+        recurringOccurrence: input['recurringOccurrence'] === undefined
+            ? undefined
+            : recurring(input['recurringOccurrence'], actualAmount, billID),
+    };
+    if ((billKind === 'utility') !== (request.utility !== undefined)) {
+        throw new TypeError('utility details are required only for utility bills');
+    }
+    validateAllocationTotals(request);
+    return request;
+}
+/**
+ * Executable host-boundary check for the request's audit claim. The trusted
+ * authenticated identity is supplied by the host, never derived from the
+ * request itself.
+ */
+function assertCreateSplitusBillV1Recorder(request, authenticatedUserID) {
+    const trustedUserID = storageID(authenticatedUserID, 'authenticatedUserID');
+    if (request.recorderUserID !== trustedUserID) {
+        throw new TypeError('recorderUserID must match the trusted authenticated identity');
+    }
+}
+function parseListSplitusBillsV1Request(value) {
+    const input = record(value, 'list bills request');
+    if (input['contractVersion'] !== SPLITUS_BILL_CONTRACT_VERSION) {
+        throw new TypeError('unsupported Splitus bill contract version');
+    }
+    const pageSize = input['pageSize'];
+    if (typeof pageSize !== 'number' ||
+        !Number.isSafeInteger(pageSize) ||
+        pageSize < 1 ||
+        pageSize > MAX_SPLITUS_BILL_LIST_PAGE_SIZE) {
+        throw new RangeError(`pageSize must be an integer from 1 to ${MAX_SPLITUS_BILL_LIST_PAGE_SIZE}`);
+    }
+    return {
+        contractVersion: SPLITUS_BILL_CONTRACT_VERSION,
+        spaceID: storageID(input['spaceID'], 'spaceID'),
+        pageSize,
+        cursor: optionalText(input['cursor'], 'cursor', 2048),
+        utilityKind: input['utilityKind'] === undefined
+            ? undefined
+            : enumValue(input['utilityKind'], ['electricity', 'gas', 'water', 'internet', 'other'], 'utilityKind'),
+        period: input['period'] === undefined ? undefined : period(input['period']),
+    };
+}
+function parseGetSplitusBillV1Request(value) {
+    const input = versionedRecord(value, 'get bill request');
+    return {
+        contractVersion: SPLITUS_BILL_CONTRACT_VERSION,
+        spaceID: storageID(input['spaceID'], 'spaceID'),
+        billID: storageID(input['billID'], 'billID'),
+    };
+}
+function parseCreateSplitusBillV1Response(value) {
+    const input = versionedRecord(value, 'create bill response');
+    return {
+        contractVersion: SPLITUS_BILL_CONTRACT_VERSION,
+        bill: parseSplitusBillV1(input['bill']),
+    };
+}
+function parseGetSplitusBillV1Response(value) {
+    const input = versionedRecord(value, 'get bill response');
+    return {
+        contractVersion: SPLITUS_BILL_CONTRACT_VERSION,
+        bill: parseSplitusBillV1(input['bill']),
+    };
+}
+function parseListSplitusBillsV1Response(value, requestedPageSize) {
+    const input = versionedRecord(value, 'list bills response');
+    const pageSize = boundedPageSize(input['pageSize']);
+    if (requestedPageSize !== undefined && pageSize !== requestedPageSize) {
+        throw new RangeError('response pageSize does not match the accepted request');
+    }
+    if (!Array.isArray(input['items']) || input['items'].length > pageSize) {
+        throw new RangeError('response items exceed the bounded pageSize');
+    }
+    return {
+        contractVersion: SPLITUS_BILL_CONTRACT_VERSION,
+        pageSize,
+        items: input['items'].map((item) => splitusBillListItem(item)),
+        nextCursor: optionalText(input['nextCursor'], 'nextCursor', 2048),
+    };
+}
+function parseSplitusBillV1(value) {
+    const input = record(value, 'bill');
+    const request = parseCreateSplitusBillV1Request(input);
+    const resolvedSourceEffects = sourceEffects(input['resolvedSourceEffects']);
+    const revisionValue = positiveIntegerString(input['revision'], 'revision');
+    const createdAt = timestamp(input['createdAt'], 'createdAt');
+    const updatedAt = timestamp(input['updatedAt'], 'updatedAt');
+    if (Date.parse(updatedAt) < Date.parse(createdAt)) {
+        throw new RangeError('updatedAt must not precede createdAt');
+    }
+    const postingValue = posting(input['posting'], revisionValue);
+    const debtusValue = input['debtus'] === undefined
+        ? undefined
+        : debtusStatus(input['debtus'], request.spaceID, request.billID, request.currency);
+    if (debtusValue !== undefined && postingValue.status !== 'applied') {
+        throw new TypeError('Debtus status requires applied posting');
+    }
+    if (debtusValue !== undefined) {
+        const receipt = postingValue.receipt;
+        if (receipt === undefined) {
+            throw new TypeError('Debtus status requires an applied posting receipt');
+        }
+        validateDebtusMatchesReceipt(receipt, debtusValue);
+    }
+    return {
+        ...request,
+        resolvedSourceEffects,
+        revision: revisionValue,
+        posting: postingValue,
+        debtus: debtusValue,
+        createdAt,
+        updatedAt,
+    };
+}
+function sourceEffects(value) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value) || value.length > 100) {
+        throw new RangeError('resolvedSourceEffects exceeds maximum item count 100');
+    }
+    const effects = value.map((item, index) => sourceEffect(item, index));
+    return effects;
+}
+function sourceEffect(value, index) {
+    const input = record(value, `resolvedSourceEffects[${index}]`);
+    const agreementID = optionalStorageID(input['agreementID'], 'agreementID');
+    const priceRevision = input['priceRevision'];
+    if (typeof priceRevision !== 'number' ||
+        !Number.isSafeInteger(priceRevision) ||
+        priceRevision < 0) {
+        throw new RangeError('priceRevision must be a non-negative safe integer');
+    }
+    const expectedAmount = parseExactDecimalString(input['expectedAmount']);
+    if (typeof input['sourceAttributionCaptured'] !== 'boolean') {
+        throw new TypeError('sourceAttributionCaptured must be boolean');
+    }
+    const assetIDs = input['assetIDs'] === undefined
+        ? []
+        : identifierArray(input['assetIDs'], 'assetIDs', 100);
+    const contactLinks = sourceContactLinks(input['contactLinks']);
+    const ownerSpaceID = optionalStorageID(input['ownerSpaceID'], 'ownerSpaceID');
+    const enrollmentID = optionalStorageID(input['enrollmentID'], 'enrollmentID');
+    const chargeID = optionalStorageID(input['chargeID'], 'chargeID');
+    const occurrenceID = optionalStorageID(input['occurrenceID'], 'occurrenceID');
+    const direction = optionalEnum(input['direction'], ['expense', 'income', 'transfer'], 'direction');
+    const temporalBasis = optionalEnum(input['temporalBasis'], [
+        'occurrence_service_cost',
+        'contract_period_cost',
+        'normalized_service_cost',
+    ], 'temporalBasis');
+    const economicPeriod = input['economicPeriod'] === undefined
+        ? undefined
+        : period(input['economicPeriod']);
+    const eligible = optionalBoolean(input['invoiceReconciliationEligible'], 'invoiceReconciliationEligible');
+    const contactAttributions = sourceAttributions(input['contactAttributions'], 'contactAttributions');
+    const assetAttributions = sourceAttributions(input['assetAttributions'], 'assetAttributions');
+    return {
+        priceID: storageID(input['priceID'], 'priceID'),
+        priceRevision,
+        expectedAmount,
+        sourceAttributionCaptured: input['sourceAttributionCaptured'],
+        assetIDs,
+        contactLinks,
+        ownerSpaceID,
+        agreementID,
+        enrollmentID,
+        chargeID,
+        occurrenceID,
+        direction,
+        temporalBasis,
+        economicPeriod,
+        invoiceReconciliationEligible: eligible,
+        contactAttributions,
+        assetAttributions,
+    };
+}
+function sourceContactLinks(value) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value) || value.length > 100) {
+        throw new RangeError('contactLinks exceeds maximum item count 100');
+    }
+    const links = value.map((item, index) => {
+        const input = record(item, `contactLinks[${index}]`);
+        const roles = textArray(input['roles'], `contactLinks[${index}].roles`, 32);
+        return {
+            contactID: storageID(input['contactID'], `contactLinks[${index}].contactID`),
+            roles,
+        };
+    });
+    return links;
+}
+function sourceAttributions(value, name) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value) || value.length > 100) {
+        throw new RangeError(`${name} exceeds maximum item count 100`);
+    }
+    const values = value.map((item, index) => {
+        const input = record(item, `${name}[${index}]`);
+        return {
+            id: storageID(input['id'], `${name}[${index}].id`),
+            amount: parseExactDecimalString(input['amount']),
+        };
+    });
+    return values;
+}
+function splitusBillListItem(value) {
+    const input = versionedRecord(value, 'bill list item');
+    const billKind = enumValue(input['billKind'], ['general', 'utility'], 'billKind');
+    const utilityKind = input['utilityKind'] === undefined
+        ? undefined
+        : enumValue(input['utilityKind'], ['electricity', 'gas', 'water', 'internet', 'other'], 'utilityKind');
+    const periodValue = input['period'] === undefined ? undefined : period(input['period']);
+    if ((billKind === 'utility') !==
+        (utilityKind !== undefined && periodValue !== undefined)) {
+        throw new TypeError('utility list items require utilityKind and period');
+    }
+    const postingStatus = enumValue(input['postingStatus'], ['pending', 'posting', 'applied', 'attention'], 'postingStatus');
+    const debtusSettlementStatus = input['debtusSettlementStatus'] === undefined
+        ? undefined
+        : settlementStatus(input['debtusSettlementStatus'], 'debtusSettlementStatus');
+    if (debtusSettlementStatus !== undefined &&
+        postingStatus !== 'applied') {
+        throw new TypeError('Debtus settlement status requires applied posting');
+    }
+    return {
+        contractVersion: SPLITUS_BILL_CONTRACT_VERSION,
+        spaceID: storageID(input['spaceID'], 'spaceID'),
+        billID: storageID(input['billID'], 'billID'),
+        title: optionalText(input['title'], 'title', 256),
+        billKind,
+        utilityKind,
+        period: periodValue,
+        currency: currency(input['currency']),
+        actualAmount: positiveAmount(input['actualAmount'], 'actualAmount'),
+        ownPaidAmount: nonNegativeAmount(input['ownPaidAmount'], 'ownPaidAmount'),
+        ownOwedAmount: nonNegativeAmount(input['ownOwedAmount'], 'ownOwedAmount'),
+        postingStatus,
+        debtusSettlementStatus,
+        createdAt: timestamp(input['createdAt'], 'createdAt'),
+    };
+}
+function posting(value, billRevision) {
+    const input = record(value, 'posting');
+    const status = enumValue(input['status'], ['pending', 'posting', 'applied', 'attention'], 'posting.status');
+    const operationKey = storageID(input['operationKey'], 'posting.operationKey');
+    const inputDigest = digest(input['inputDigest'], 'posting.inputDigest');
+    const receiptValue = input['receipt'] === undefined
+        ? undefined
+        : postingReceipt(input['receipt'], billRevision, operationKey, inputDigest);
+    const attentionCode = input['attentionCode'] === undefined
+        ? undefined
+        : enumValue(input['attentionCode'], [
+            'authorization_changed',
+            'source_conflict',
+            'provider_rejected',
+            'invalid_provider_receipt',
+            'operator_action_required',
+        ], 'posting.attentionCode');
+    if ((status === 'applied') !== (receiptValue !== undefined)) {
+        throw new TypeError('applied posting status requires exactly one receipt');
+    }
+    if ((status === 'attention') !== (attentionCode !== undefined)) {
+        throw new TypeError('attention posting status requires exactly one code');
+    }
+    return {
+        status,
+        operationKey,
+        inputDigest,
+        receipt: receiptValue,
+        attentionCode,
+    };
+}
+function postingReceipt(value, billRevision, operationKey, inputDigest) {
+    const input = record(value, 'posting.receipt');
+    const revisionValue = positiveIntegerString(input['revision'], 'posting.receipt.revision');
+    const receiptOperationKey = storageID(input['operationKey'], 'posting.receipt.operationKey');
+    const receiptInputDigest = digest(input['inputDigest'], 'posting.receipt.inputDigest');
+    if (revisionValue !== billRevision ||
+        receiptOperationKey !== operationKey ||
+        receiptInputDigest !== inputDigest) {
+        throw new TypeError('posting receipt does not match the accepted bill revision');
+    }
+    if (!Array.isArray(input['obligationLines']) ||
+        input['obligationLines'].length > MAX_SPLITUS_BILL_OBLIGATIONS) {
+        throw new RangeError('posting receipt obligationLines are unbounded');
+    }
+    const lineIDs = new Set();
+    const obligationIDs = new Set();
+    const obligationLines = input['obligationLines'].map((value, index) => {
+        const line = record(value, `posting.receipt.obligationLines[${index}]`);
+        const lineID = storageID(line['lineID'], `posting.receipt.obligationLines[${index}].lineID`);
+        if (lineIDs.has(lineID)) {
+            throw new TypeError('posting receipt repeats an obligation line');
+        }
+        lineIDs.add(lineID);
+        const ids = identifierArray(line['obligationIDs'], `posting.receipt.obligationLines[${index}].obligationIDs`, MAX_SPLITUS_OBLIGATION_IDS_PER_LINE);
+        for (const id of ids) {
+            if (obligationIDs.has(id)) {
+                throw new TypeError('posting receipt repeats an obligation ID');
+            }
+            obligationIDs.add(id);
+        }
+        return { lineID, obligationIDs: ids };
+    });
+    return {
+        receiptID: storageID(input['receiptID'], 'posting.receipt.receiptID'),
+        operationKey: receiptOperationKey,
+        inputDigest: receiptInputDigest,
+        revision: revisionValue,
+        obligationLines,
+    };
+}
+function debtusStatus(value, spaceID, billID, billCurrency) {
+    const input = record(value, 'debtus');
+    if (!Array.isArray(input['obligations']) ||
+        input['obligations'].length > MAX_SPLITUS_BILL_OBLIGATIONS) {
+        throw new RangeError('Debtus obligations are unbounded');
+    }
+    const lineIDs = new Set();
+    const obligations = input['obligations'].map((item, index) => {
+        const obligation = record(item, `debtus.obligations[${index}]`);
+        const lineID = storageID(obligation['lineID'], `debtus.obligations[${index}].lineID`);
+        if (lineIDs.has(lineID)) {
+            throw new TypeError('Debtus status repeats an obligation line');
+        }
+        lineIDs.add(lineID);
+        const obligationCurrency = currency(obligation['currency']);
+        if (obligationCurrency !== billCurrency) {
+            throw new TypeError('Debtus obligation currency differs from the bill');
+        }
+        return {
+            lineID,
+            obligationIDs: identifierArray(obligation['obligationIDs'], `debtus.obligations[${index}].obligationIDs`, MAX_SPLITUS_OBLIGATION_IDS_PER_LINE),
+            debtorContactID: storageID(obligation['debtorContactID'], `debtus.obligations[${index}].debtorContactID`),
+            creditorContactID: storageID(obligation['creditorContactID'], `debtus.obligations[${index}].creditorContactID`),
+            currency: obligationCurrency,
+            principalAmount: positiveAmount(obligation['principalAmount'], `debtus.obligations[${index}].principalAmount`),
+            outstandingAmount: nonNegativeAmount(obligation['outstandingAmount'], `debtus.obligations[${index}].outstandingAmount`),
+            repaidAmount: nonNegativeAmount(obligation['repaidAmount'], `debtus.obligations[${index}].repaidAmount`),
+            creditAmount: nonNegativeAmount(obligation['creditAmount'], `debtus.obligations[${index}].creditAmount`),
+            status: settlementStatus(obligation['status'], `debtus.obligations[${index}].status`),
+            settlementTarget: settlementTarget(obligation['settlementTarget'], spaceID, billID, lineID),
+        };
+    });
+    return {
+        status: settlementStatus(input['status'], 'debtus.status'),
+        obligations,
+        settlementTarget: settlementTarget(input['settlementTarget'], spaceID, billID),
+    };
+}
+function validateDebtusMatchesReceipt(receipt, debtus) {
+    if (receipt.obligationLines.length !== debtus.obligations.length) {
+        throw new TypeError('Debtus obligations do not exactly match the applied posting receipt');
+    }
+    const receiptLines = new Map(receipt.obligationLines.map((line) => [
+        line.lineID,
+        new Set(line.obligationIDs),
+    ]));
+    for (const obligation of debtus.obligations) {
+        const receiptIDs = receiptLines.get(obligation.lineID);
+        if (receiptIDs === undefined ||
+            receiptIDs.size !== obligation.obligationIDs.length ||
+            obligation.obligationIDs.some((id) => !receiptIDs.has(id))) {
+            throw new TypeError('Debtus obligations do not exactly match the applied posting receipt');
+        }
+    }
+}
+function settlementTarget(value, spaceID, billID, expectedLineID) {
+    const input = record(value, 'settlementTarget');
+    const lineID = input['lineID'] === undefined
+        ? undefined
+        : storageID(input['lineID'], 'settlementTarget.lineID');
+    if (input['route'] !== 'debtus.source-obligations' ||
+        input['sourceNamespace'] !== 'splitus' ||
+        input['spaceID'] !== spaceID ||
+        input['sourceRecordID'] !== billID ||
+        lineID !== expectedLineID) {
+        throw new TypeError('settlement target does not match the Splitus bill source');
+    }
+    return {
+        route: 'debtus.source-obligations',
+        spaceID,
+        sourceNamespace: 'splitus',
+        sourceRecordID: billID,
+        lineID,
+    };
+}
+function versionedRecord(value, name) {
+    const input = record(value, name);
+    if (input['contractVersion'] !== SPLITUS_BILL_CONTRACT_VERSION) {
+        throw new TypeError('unsupported Splitus bill contract version');
+    }
+    return input;
+}
+function boundedPageSize(value) {
+    if (typeof value !== 'number' ||
+        !Number.isSafeInteger(value) ||
+        value < 1 ||
+        value > MAX_SPLITUS_BILL_LIST_PAGE_SIZE) {
+        throw new RangeError(`pageSize must be an integer from 1 to ${MAX_SPLITUS_BILL_LIST_PAGE_SIZE}`);
+    }
+    return value;
+}
+function settlementStatus(value, name) {
+    return enumValue(value, ['unsettled', 'part_settled', 'settled'], name);
+}
+function identifierArray(value, name, maximum) {
+    if (!Array.isArray(value) || value.length < 1 || value.length > maximum) {
+        throw new RangeError(`${name} must contain 1 to ${maximum} identifiers`);
+    }
+    const seen = new Set();
+    return value.map((item, index) => {
+        const id = storageID(item, `${name}[${index}]`);
+        if (seen.has(id)) {
+            throw new TypeError(`${name} contains a duplicate identifier`);
+        }
+        seen.add(id);
+        return id;
+    });
+}
+function digest(value, name) {
+    if (typeof value !== 'string' || !/^[0-9a-f]{64}$/.test(value)) {
+        throw new TypeError(`${name} must be a lowercase SHA-256 digest`);
+    }
+    return value;
+}
+function positiveIntegerString(value, name) {
+    if (typeof value !== 'string' || !/^[1-9][0-9]*$/.test(value)) {
+        throw new TypeError(`${name} must be a canonical positive integer string`);
+    }
+    if (BigInt(value) > 18446744073709551615n) {
+        throw new RangeError(`${name} exceeds unsigned 64-bit range`);
+    }
+    return value;
+}
+function timestamp(value, name) {
+    if (typeof value !== 'string' ||
+        !/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/.test(value) ||
+        Number.isNaN(Date.parse(value))) {
+        throw new TypeError(`${name} must be an RFC 3339 timestamp`);
+    }
+    date(value.slice(0, 10), name);
+    return value;
+}
+function nonNegativeAmount(value, name) {
+    try {
+        return parseExactDecimalString(value);
+    }
+    catch (error) {
+        if (error instanceof RangeError) {
+            throw new RangeError(`${name}: ${error.message}`);
+        }
+        if (error instanceof Error) {
+            throw new TypeError(`${name}: ${error.message}`);
+        }
+        throw error;
+    }
+}
+function validateAllocationTotals(request) {
+    const contacts = new Set();
+    for (const allocation of [
+        ...request.paidAllocations,
+        ...request.owedAllocations,
+    ]) {
+        contacts.add(allocation.contactID);
+    }
+    if (contacts.size < 2 || contacts.size > MAX_SPLITUS_BILL_PARTICIPANTS) {
+        throw new RangeError(`bill must have 2 to ${MAX_SPLITUS_BILL_PARTICIPANTS} participants`);
+    }
+    const actual = amountToMinorUnits(request.actualAmount);
+    if (sumAllocations(request.paidAllocations) !== actual) {
+        throw new RangeError('paid allocations must reconcile to actualAmount');
+    }
+    if (sumAllocations(request.owedAllocations) !== actual) {
+        throw new RangeError('owed allocations must reconcile to actualAmount');
+    }
+}
+function allocations(value, name) {
+    if (!Array.isArray(value) || value.length < 1 || value.length > MAX_SPLITUS_BILL_PARTICIPANTS) {
+        throw new RangeError(`${name} must contain 1 to ${MAX_SPLITUS_BILL_PARTICIPANTS} allocations`);
+    }
+    const allocationIDs = new Set();
+    const contactIDs = new Set();
+    return value.map((item, index) => {
+        const input = record(item, `${name}[${index}]`);
+        const allocationID = storageID(input['allocationID'], `${name}[${index}].allocationID`);
+        const contactID = storageID(input['contactID'], `${name}[${index}].contactID`);
+        if (allocationIDs.has(allocationID) || contactIDs.has(contactID)) {
+            throw new TypeError(`${name} contains a duplicate allocation or contact`);
+        }
+        allocationIDs.add(allocationID);
+        contactIDs.add(contactID);
+        return {
+            allocationID,
+            contactID,
+            amount: positiveAmount(input['amount'], `${name}[${index}].amount`),
+        };
+    });
+}
+function sumAllocations(allocationsToSum) {
+    let total = 0n;
+    for (const allocation of allocationsToSum) {
+        total += amountToMinorUnits(allocation.amount);
+        if (total > MAX_EXACT_MINOR_UNITS) {
+            throw new RangeError('allocation total exceeds the Splitus contract limit');
+        }
+    }
+    return total;
+}
+function amountToMinorUnits(value) {
+    return BigInt(value.replace('.', ''));
+}
+function positiveAmount(value, name) {
+    const amount = parseExactDecimalString(value);
+    if (amountToMinorUnits(amount) === 0n) {
+        throw new RangeError(`${name} must be positive`);
+    }
+    return amount;
+}
+function utility(value) {
+    const input = record(value, 'utility');
+    return {
+        utilityKind: enumValue(input['utilityKind'], ['electricity', 'gas', 'water', 'internet', 'other'], 'utility.utilityKind'),
+        providerName: optionalText(input['providerName'], 'utility.providerName', 256),
+        period: period(input['period']),
+    };
+}
+function recurring(value, actualAmount, billID) {
+    const input = record(value, 'recurringOccurrence');
+    const expectedAmount = input['expectedAmount'] === undefined
+        ? undefined
+        : positiveAmount(input['expectedAmount'], 'recurringOccurrence.expectedAmount');
+    const standingChargeAmount = input['standingChargeAmount'] === undefined
+        ? undefined
+        : positiveAmount(input['standingChargeAmount'], 'recurringOccurrence.standingChargeAmount');
+    const expectedComparison = input['expectedComparison'] === undefined
+        ? undefined
+        : enumValue(input['expectedComparison'], ['not_available', 'matches', 'increased', 'decreased'], 'recurringOccurrence.expectedComparison');
+    if (expectedAmount === undefined &&
+        expectedComparison !== undefined &&
+        expectedComparison !== 'not_available') {
+        throw new TypeError('comparison must be not_available exactly when expectedAmount is absent');
+    }
+    if (expectedAmount !== undefined) {
+        const expectedComparisonForAmounts = compareAmounts(actualAmount, expectedAmount);
+        if (expectedComparison !== undefined && expectedComparison !== expectedComparisonForAmounts) {
+            throw new TypeError('comparison does not match expected and actual amounts');
+        }
+    }
+    if (standingChargeAmount !== undefined &&
+        amountToMinorUnits(standingChargeAmount) > amountToMinorUnits(actualAmount)) {
+        throw new RangeError('standing charge cannot exceed actualAmount');
+    }
+    return {
+        happeningID: storageID(input['happeningID'], 'recurringOccurrence.happeningID'),
+        occurrenceID: storageID(input['occurrenceID'], 'recurringOccurrence.occurrenceID'),
+        chargeID: input['chargeID'] === undefined
+            ? undefined
+            : storageID(input['chargeID'], 'recurringOccurrence.chargeID'),
+        expectedAmount,
+        standingChargeAmount,
+        expectedComparison,
+        previousComparable: input['previousComparable'] === undefined
+            ? undefined
+            : previousComparable(input['previousComparable'], actualAmount, billID),
+    };
+}
+function previousComparable(value, actualAmount, billID) {
+    const input = record(value, 'recurringOccurrence.previousComparable');
+    const previousBillID = storageID(input['billID'], 'recurringOccurrence.previousComparable.billID');
+    if (previousBillID === billID) {
+        throw new TypeError('previous comparable bill must have a different billID');
+    }
+    const previousActualAmount = positiveAmount(input['actualAmount'], 'recurringOccurrence.previousComparable.actualAmount');
+    const comparison = enumValue(input['comparison'], ['matches', 'increased', 'decreased'], 'recurringOccurrence.previousComparable.comparison');
+    const expectedComparison = compareAmounts(actualAmount, previousActualAmount);
+    if (comparison !== expectedComparison) {
+        throw new TypeError('previous comparison does not match current and prior actual amounts');
+    }
+    return {
+        billID: previousBillID,
+        actualAmount: previousActualAmount,
+        comparison,
+    };
+}
+function compareAmounts(current, baseline) {
+    const currentMinor = amountToMinorUnits(current);
+    const baselineMinor = amountToMinorUnits(baseline);
+    return currentMinor === baselineMinor
+        ? 'matches'
+        : currentMinor > baselineMinor
+            ? 'increased'
+            : 'decreased';
+}
+function period(value) {
+    const input = record(value, 'period');
+    const startDate = date(input['startDate'], 'period.startDate');
+    const endDate = date(input['endDate'], 'period.endDate');
+    if (endDate < startDate) {
+        throw new RangeError('period.endDate must not precede period.startDate');
+    }
+    return { startDate, endDate };
+}
+function date(value, name) {
+    if (typeof value !== 'string') {
+        throw new TypeError(`${name} must be an ISO calendar date`);
+    }
+    const match = datePattern.exec(value);
+    if (match === null) {
+        throw new TypeError(`${name} must be an ISO calendar date`);
+    }
+    const parsed = new Date(`${value}T00:00:00.000Z`);
+    if (Number.isNaN(parsed.valueOf()) || parsed.toISOString().slice(0, 10) !== value) {
+        throw new TypeError(`${name} must be a real ISO calendar date`);
+    }
+    return value;
+}
+function currency(value) {
+    return enumValue(value, ['EUR', 'GBP', 'USD'], 'currency');
+}
+function storageID(value, name) {
+    if (typeof value !== 'string' ||
+        value.length === 0 ||
+        value.trim() !== value ||
+        new TextEncoder().encode(value).length > 512 ||
+        value.includes('/') ||
+        hasControlCharacters(value) ||
+        value === '.' ||
+        value === '..' ||
+        (/^__/.test(value) && /__$/.test(value))) {
+        throw new TypeError(`${name} is not a safe identifier`);
+    }
+    return value;
+}
+function optionalText(value, name, maxBytes) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value !== 'string' ||
+        value.length === 0 ||
+        value.trim() !== value ||
+        new TextEncoder().encode(value).length > maxBytes ||
+        hasControlCharacters(value)) {
+        throw new TypeError(`${name} is empty, padded, too long, or contains controls`);
+    }
+    return value;
+}
+function hasControlCharacters(value) {
+    for (const character of value) {
+        const code = character.charCodeAt(0);
+        if (code < 0x20 || code === 0x7f) {
+            return true;
+        }
+    }
+    return false;
+}
+function record(value, name) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw new TypeError(`${name} must be an object`);
+    }
+    return value;
+}
+function enumValue(value, allowed, name) {
+    if (typeof value !== 'string' || !allowed.includes(value)) {
+        throw new TypeError(`${name} has an unsupported value`);
+    }
+    return value;
+}
+function optionalStorageID(value, name) {
+    return value === undefined ? undefined : storageID(value, name);
+}
+function optionalEnum(value, allowed, name) {
+    return value === undefined ? undefined : enumValue(value, allowed, name);
+}
+function optionalBoolean(value, name) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'boolean')
+        throw new TypeError(`${name} must be boolean`);
+    return value;
+}
+function textArray(value, name, maximum) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value) || value.length > maximum) {
+        throw new RangeError(`${name} exceeds maximum item count ${maximum}`);
+    }
+    const values = value.map((item, index) => optionalText(item, `${name}[${index}]`, 100));
+    if (values.some((item) => item === undefined)) {
+        throw new TypeError(`${name} contains an invalid value`);
+    }
+    const result = values;
+    return result;
+}
+
+/** @deprecated Use `SPLITUS_BILL_SERVICE_V1`. */
 const SPLITUS_SERVICE = new InjectionToken('SplitusService');
+const SPLITUS_BILL_SERVICE_V1 = new InjectionToken('SplitusBillServiceV1');
 
 /**
  * Generated bundle index. Do not edit.
  */
 
-export { SPLITUS_SERVICE };
+export { MAX_SPLITUS_BILL_LIST_PAGE_SIZE, MAX_SPLITUS_BILL_OBLIGATIONS, MAX_SPLITUS_BILL_PARTICIPANTS, MAX_SPLITUS_OBLIGATION_IDS_PER_LINE, SPLITUS_BILL_CONTRACT_VERSION, SPLITUS_BILL_SERVICE_V1, SPLITUS_SERVICE, assertCreateSplitusBillV1Recorder, parseCreateSplitusBillV1Request, parseCreateSplitusBillV1Response, parseExactDecimalString, parseGetSplitusBillV1Request, parseGetSplitusBillV1Response, parseListSplitusBillsV1Request, parseListSplitusBillsV1Response, parseSplitusBillV1 };
 //# sourceMappingURL=sneat-extension-splitus-contract.mjs.map

package/fesm2022/sneat-extension-splitus-contract.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"sneat-extension-splitus-contract.mjs","sources":["../../../../libs/splitus/src/services.ts","../../../../libs/splitus/src/sneat-extension-splitus-contract.ts"],"sourcesContent":["import { InjectionToken } from '@angular/core';\nimport { Observable } from 'rxjs';\nimport { ICreateSplitRequest, ICreateSplitResponse, ISplit, ISplitListItem } from './dto';\n\nexport interface ISplitusService {\n  /** REAL: POST /api4splitus/create-split. Payer is the authenticated user. */\n  createSplit(request: ICreateSplitRequest): Observable<ICreateSplitResponse>;\n  /** REAL: GET /api4splitus/split?spaceID=&id= */\n  getSplit(spaceID: string, id: string): Observable<ISplit>;\n  /** REAL: GET /api4splitus/splits?spaceID= */\n  getSplits(spaceID: string): Observable<ISplitListItem[]>;\n}\n\nexport const SPLITUS_SERVICE = new InjectionToken<ISplitusService>('SplitusService');\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;MAaa,eAAe,GAAG,IAAI,cAAc,CAAkB,gBAAgB;;ACbnF;;AAEG;;"}
+{"version":3,"file":"sneat-extension-splitus-contract.mjs","sources":["../../../../libs/splitus/src/dto/bill-v1.ts","../../../../libs/splitus/src/services.ts","../../../../libs/splitus/src/sneat-extension-splitus-contract.ts"],"sourcesContent":["/** The first stable Splitus bill browser/host wire contract. */\nexport const SPLITUS_BILL_CONTRACT_VERSION = 1 as const;\n\nexport const MAX_SPLITUS_BILL_PARTICIPANTS = 256;\nexport const MAX_SPLITUS_BILL_LIST_PAGE_SIZE = 100;\nexport const MAX_SPLITUS_BILL_OBLIGATIONS = 256;\nexport const MAX_SPLITUS_OBLIGATION_IDS_PER_LINE = 256;\n\nexport type SplitusBillContractVersion =\n  typeof SPLITUS_BILL_CONTRACT_VERSION;\n\n/**\n * A canonical, non-negative major-unit amount with exactly two fraction\n * digits. Examples: `0.00`, `30.00`, `90.00`.\n *\n * The alias documents the wire type; use `parseExactDecimalString()` at an\n * untrusted boundary. JavaScript numbers and minor-unit numbers are not part\n * of this contract.\n */\nexport type ExactDecimalString = string;\n\n/** Currencies whose minor unit is exactly two decimal digits in this contract. */\nexport type SplitusCurrencyCode = 'EUR' | 'GBP' | 'USD';\n\nexport type SplitusBillKind = 'general' | 'utility';\nexport type SplitusUtilityKind =\n  | 'electricity'\n  | 'gas'\n  | 'water'\n  | 'internet'\n  | 'other';\n\nexport type SplitusBillPostingStatus =\n  | 'pending'\n  | 'posting'\n  | 'applied'\n  | 'attention';\n\nexport type SplitusDebtusSettlementStatus =\n  | 'unsettled'\n  | 'part_settled'\n  | 'settled';\n\nexport type SplitusExpectedActualComparison =\n  | 'not_available'\n  | 'matches'\n  | 'increased'\n  | 'decreased';\n\nexport type SplitusBillAttentionCode =\n  | 'authorization_changed'\n  | 'source_conflict'\n  | 'provider_rejected'\n  | 'invalid_provider_receipt'\n  | 'operator_action_required';\n\nexport interface ISplitusBillAllocationV1 {\n  /** Stable within the bill revision, independent of array ordering. */\n  readonly allocationID: string;\n  /**\n   * Contactus identity in this Space. Hosts resolve its real display data from\n   * Contactus; this opaque ID is never a user-facing label.\n   */\n  readonly contactID: string;\n  readonly amount: ExactDecimalString;\n}\n\nexport interface ISplitusBillingPeriodV1 {\n  /** Inclusive ISO calendar date. */\n  readonly startDate: string;\n  /** Inclusive ISO calendar date; must not precede `startDate`. */\n  readonly endDate: string;\n}\n\nexport interface ISplitusUtilityDetailsV1 {\n  readonly utilityKind: SplitusUtilityKind;\n  readonly providerName?: string;\n  readonly period: ISplitusBillingPeriodV1;\n}\n\n/**\n * A reference to the Calendarius occurrence represented by this actual bill.\n * `expectedAmount` and `standingChargeAmount` are context only; neither is a\n * paid expense. `actualAmount` on the enclosing bill remains mandatory.\n */\nexport interface ISplitusRecurringOccurrenceV1 {\n  readonly happeningID: string;\n  readonly occurrenceID: string;\n  readonly chargeID?: string;\n  readonly expectedAmount?: ExactDecimalString;\n  readonly standingChargeAmount?: ExactDecimalString;\n  readonly expectedComparison?: SplitusExpectedActualComparison;\n  readonly previousComparable?: ISplitusPreviousComparableBillV1;\n}\n\nexport interface ISplitusPreviousComparableBillV1 {\n  readonly billID: string;\n  readonly actualAmount: ExactDecimalString;\n  readonly comparison: Exclude<\n    SplitusExpectedActualComparison,\n    'not_available'\n  >;\n}\n\nexport type SplitusResolvedSourceDirection =\n  | 'expense'\n  | 'income'\n  | 'transfer';\n\nexport type SplitusResolvedSourceTemporalBasis =\n  | 'occurrence_service_cost'\n  | 'contract_period_cost'\n  | 'normalized_service_cost';\n\nexport interface ISplitusSourceContactLinkV1 {\n  readonly contactID: string;\n  readonly roles: readonly string[];\n}\n\nexport interface ISplitusSourceAttributionV1 {\n  readonly id: string;\n  readonly amount: ExactDecimalString;\n}\n\n/** Immutable source facts captured by Splitus when the actual bill is accepted. */\nexport interface ISplitusResolvedSourceEffectV1 {\n  readonly priceID: string;\n  readonly priceRevision: number;\n  readonly expectedAmount: ExactDecimalString;\n  readonly sourceAttributionCaptured: boolean;\n  readonly assetIDs: readonly string[];\n  readonly contactLinks: readonly ISplitusSourceContactLinkV1[];\n  /** Present as one complete group for agreement-backed reconciliation. */\n  readonly ownerSpaceID?: string;\n  readonly agreementID?: string;\n  readonly enrollmentID?: string;\n  readonly chargeID?: string;\n  readonly occurrenceID?: string;\n  readonly direction?: SplitusResolvedSourceDirection;\n  readonly temporalBasis?: SplitusResolvedSourceTemporalBasis;\n  readonly economicPeriod?: ISplitusBillingPeriodV1;\n  readonly invoiceReconciliationEligible?: boolean;\n  readonly contactAttributions: readonly ISplitusSourceAttributionV1[];\n  readonly assetAttributions: readonly ISplitusSourceAttributionV1[];\n}\n\nexport interface ICreateSplitusBillV1Request {\n  readonly contractVersion: SplitusBillContractVersion;\n  readonly spaceID: string;\n  /**\n   * Stable across duplicate submission and lost-response retries. Reusing the\n   * same ID with changed paid/owed allocations is a provider conflict.\n   */\n  readonly billID: string;\n  /**\n   * Audit identity of the authenticated actor. The server must bind this to\n   * its trusted authentication context. It never implies a paid or owed\n   * allocation.\n   */\n  readonly recorderUserID: string;\n  readonly title?: string;\n  readonly billKind: SplitusBillKind;\n  readonly currency: SplitusCurrencyCode;\n  /** Actual paid amount. An expectation is never accepted in its place. */\n  readonly actualAmount: ExactDecimalString;\n  /** Explicit sources of payment; one contact may also owe a share. */\n  readonly paidAllocations: readonly ISplitusBillAllocationV1[];\n  /** Explicit responsibility shares. */\n  readonly owedAllocations: readonly ISplitusBillAllocationV1[];\n  /** Required exactly when `billKind` is `utility`. */\n  readonly utility?: ISplitusUtilityDetailsV1;\n  readonly recurringOccurrence?: ISplitusRecurringOccurrenceV1;\n}\n\nexport interface ISplitusDebtusReceiptLineV1 {\n  readonly lineID: string;\n  readonly obligationIDs: readonly string[];\n}\n\nexport interface ISplitusBillPostingReceiptV1 {\n  readonly receiptID: string;\n  readonly operationKey: string;\n  readonly inputDigest: string;\n  readonly revision: string;\n  readonly obligationLines: readonly ISplitusDebtusReceiptLineV1[];\n}\n\nexport interface ISplitusBillPostingV1 {\n  readonly status: SplitusBillPostingStatus;\n  /** Durable identity of the retry-safe provider operation. */\n  readonly operationKey: string;\n  /** Digest of the exact accepted source revision and allocations. */\n  readonly inputDigest: string;\n  /** Present exactly when `status` is `applied`. */\n  readonly receipt?: ISplitusBillPostingReceiptV1;\n  /** Present exactly when `status` is `attention`. */\n  readonly attentionCode?: SplitusBillAttentionCode;\n}\n\n/**\n * An application-relative target. The host resolves it through its injected\n * Debtus navigation adapter; contracts never hard-code debtus.app or another\n * deployment origin.\n */\nexport interface ISplitusDebtusSettlementTargetV1 {\n  readonly route: 'debtus.source-obligations';\n  readonly spaceID: string;\n  readonly sourceNamespace: 'splitus';\n  readonly sourceRecordID: string;\n  readonly lineID?: string;\n}\n\nexport interface ISplitusDebtusObligationV1 {\n  readonly lineID: string;\n  readonly obligationIDs: readonly string[];\n  readonly debtorContactID: string;\n  readonly creditorContactID: string;\n  readonly currency: SplitusCurrencyCode;\n  readonly principalAmount: ExactDecimalString;\n  readonly outstandingAmount: ExactDecimalString;\n  readonly repaidAmount: ExactDecimalString;\n  readonly creditAmount: ExactDecimalString;\n  readonly status: SplitusDebtusSettlementStatus;\n  readonly settlementTarget: ISplitusDebtusSettlementTargetV1;\n}\n\nexport interface ISplitusDebtusStatusV1 {\n  /** Current state read from Debtus, never a Splitus-maintained balance. */\n  readonly status: SplitusDebtusSettlementStatus;\n  readonly obligations: readonly ISplitusDebtusObligationV1[];\n  readonly settlementTarget: ISplitusDebtusSettlementTargetV1;\n}\n\nexport interface ISplitusBillV1 extends ICreateSplitusBillV1Request {\n  readonly resolvedSourceEffects?: readonly ISplitusResolvedSourceEffectV1[];\n  /** Canonical positive decimal integer encoded as a string. */\n  readonly revision: string;\n  readonly posting: ISplitusBillPostingV1;\n  /** Absent until a Debtus financial projection is available. */\n  readonly debtus?: ISplitusDebtusStatusV1;\n  readonly createdAt: string;\n  readonly updatedAt: string;\n}\n\nexport interface ICreateSplitusBillV1Response {\n  readonly contractVersion: SplitusBillContractVersion;\n  readonly bill: ISplitusBillV1;\n}\n\nexport interface IGetSplitusBillV1Request {\n  readonly contractVersion: SplitusBillContractVersion;\n  readonly spaceID: string;\n  readonly billID: string;\n}\n\nexport interface IGetSplitusBillV1Response {\n  readonly contractVersion: SplitusBillContractVersion;\n  readonly bill: ISplitusBillV1;\n}\n\nexport interface ISplitusBillListItemV1 {\n  readonly contractVersion: SplitusBillContractVersion;\n  readonly spaceID: string;\n  readonly billID: string;\n  readonly title?: string;\n  readonly billKind: SplitusBillKind;\n  readonly utilityKind?: SplitusUtilityKind;\n  readonly period?: ISplitusBillingPeriodV1;\n  readonly currency: SplitusCurrencyCode;\n  readonly actualAmount: ExactDecimalString;\n  readonly ownPaidAmount: ExactDecimalString;\n  readonly ownOwedAmount: ExactDecimalString;\n  readonly postingStatus: SplitusBillPostingStatus;\n  /** Debtus-derived and absent before the bill has a financial projection. */\n  readonly debtusSettlementStatus?: SplitusDebtusSettlementStatus;\n  readonly createdAt: string;\n}\n\nexport interface IListSplitusBillsV1Request {\n  readonly contractVersion: SplitusBillContractVersion;\n  readonly spaceID: string;\n  readonly pageSize: number;\n  readonly cursor?: string;\n  readonly utilityKind?: SplitusUtilityKind;\n  readonly period?: ISplitusBillingPeriodV1;\n}\n\nexport interface IListSplitusBillsV1Response {\n  readonly contractVersion: SplitusBillContractVersion;\n  /** Echoes the accepted request bound so callers can verify the page. */\n  readonly pageSize: number;\n  /** Contains no more than `pageSize` items and never more than 100. */\n  readonly items: readonly ISplitusBillListItemV1[];\n  readonly nextCursor?: string;\n}\n\nconst MAX_EXACT_MINOR_UNITS = 9_223_372_036_854_775_807n;\nconst exactDecimalPattern = /^(?:0|[1-9][0-9]*)\\.[0-9]{2}$/;\nconst datePattern = /^([0-9]{4})-([0-9]{2})-([0-9]{2})$/;\n\nexport function parseExactDecimalString(value: unknown): ExactDecimalString {\n  if (typeof value !== 'string' || !exactDecimalPattern.test(value)) {\n    throw new TypeError(\n      'amount must be a canonical decimal string with exactly two fraction digits',\n    );\n  }\n  const minorUnits = BigInt(value.replace('.', ''));\n  if (minorUnits > MAX_EXACT_MINOR_UNITS) {\n    throw new RangeError('amount exceeds the Splitus contract limit');\n  }\n  return value;\n}\n\nexport function parseCreateSplitusBillV1Request(\n  value: unknown,\n): ICreateSplitusBillV1Request {\n  const input = record(value, 'create bill request');\n  if (input['contractVersion'] !== SPLITUS_BILL_CONTRACT_VERSION) {\n    throw new TypeError('unsupported Splitus bill contract version');\n  }\n  const billKind = enumValue(\n    input['billKind'],\n    ['general', 'utility'] as const,\n    'billKind',\n  );\n  const actualAmount = positiveAmount(input['actualAmount'], 'actualAmount');\n  const spaceID = storageID(input['spaceID'], 'spaceID');\n  const billID = storageID(input['billID'], 'billID');\n  const recorderUserID = storageID(\n    input['recorderUserID'],\n    'recorderUserID',\n  );\n  const request: ICreateSplitusBillV1Request = {\n    contractVersion: SPLITUS_BILL_CONTRACT_VERSION,\n    spaceID,\n    billID,\n    recorderUserID,\n    title: optionalText(input['title'], 'title', 256),\n    billKind,\n    currency: currency(input['currency']),\n    actualAmount,\n    paidAllocations: allocations(input['paidAllocations'], 'paidAllocations'),\n    owedAllocations: allocations(input['owedAllocations'], 'owedAllocations'),\n    utility:\n      input['utility'] === undefined ? undefined : utility(input['utility']),\n    recurringOccurrence:\n      input['recurringOccurrence'] === undefined\n        ? undefined\n        : recurring(input['recurringOccurrence'], actualAmount, billID),\n  };\n  if ((billKind === 'utility') !== (request.utility !== undefined)) {\n    throw new TypeError('utility details are required only for utility bills');\n  }\n  validateAllocationTotals(request);\n  return request;\n}\n\n/**\n * Executable host-boundary check for the request's audit claim. The trusted\n * authenticated identity is supplied by the host, never derived from the\n * request itself.\n */\nexport function assertCreateSplitusBillV1Recorder(\n  request: ICreateSplitusBillV1Request,\n  authenticatedUserID: string,\n): void {\n  const trustedUserID = storageID(\n    authenticatedUserID,\n    'authenticatedUserID',\n  );\n  if (request.recorderUserID !== trustedUserID) {\n    throw new TypeError(\n      'recorderUserID must match the trusted authenticated identity',\n    );\n  }\n}\n\nexport function parseListSplitusBillsV1Request(\n  value: unknown,\n): IListSplitusBillsV1Request {\n  const input = record(value, 'list bills request');\n  if (input['contractVersion'] !== SPLITUS_BILL_CONTRACT_VERSION) {\n    throw new TypeError('unsupported Splitus bill contract version');\n  }\n  const pageSize = input['pageSize'];\n  if (\n    typeof pageSize !== 'number' ||\n    !Number.isSafeInteger(pageSize) ||\n    pageSize < 1 ||\n    pageSize > MAX_SPLITUS_BILL_LIST_PAGE_SIZE\n  ) {\n    throw new RangeError(\n      `pageSize must be an integer from 1 to ${MAX_SPLITUS_BILL_LIST_PAGE_SIZE}`,\n    );\n  }\n  return {\n    contractVersion: SPLITUS_BILL_CONTRACT_VERSION,\n    spaceID: storageID(input['spaceID'], 'spaceID'),\n    pageSize,\n    cursor: optionalText(input['cursor'], 'cursor', 2048),\n    utilityKind:\n      input['utilityKind'] === undefined\n        ? undefined\n        : enumValue(\n            input['utilityKind'],\n            ['electricity', 'gas', 'water', 'internet', 'other'] as const,\n            'utilityKind',\n          ),\n    period:\n      input['period'] === undefined ? undefined : period(input['period']),\n  };\n}\n\nexport function parseGetSplitusBillV1Request(\n  value: unknown,\n): IGetSplitusBillV1Request {\n  const input = versionedRecord(value, 'get bill request');\n  return {\n    contractVersion: SPLITUS_BILL_CONTRACT_VERSION,\n    spaceID: storageID(input['spaceID'], 'spaceID'),\n    billID: storageID(input['billID'], 'billID'),\n  };\n}\n\nexport function parseCreateSplitusBillV1Response(\n  value: unknown,\n): ICreateSplitusBillV1Response {\n  const input = versionedRecord(value, 'create bill response');\n  return {\n    contractVersion: SPLITUS_BILL_CONTRACT_VERSION,\n    bill: parseSplitusBillV1(input['bill']),\n  };\n}\n\nexport function parseGetSplitusBillV1Response(\n  value: unknown,\n): IGetSplitusBillV1Response {\n  const input = versionedRecord(value, 'get bill response');\n  return {\n    contractVersion: SPLITUS_BILL_CONTRACT_VERSION,\n    bill: parseSplitusBillV1(input['bill']),\n  };\n}\n\nexport function parseListSplitusBillsV1Response(\n  value: unknown,\n  requestedPageSize?: number,\n): IListSplitusBillsV1Response {\n  const input = versionedRecord(value, 'list bills response');\n  const pageSize = boundedPageSize(input['pageSize']);\n  if (requestedPageSize !== undefined && pageSize !== requestedPageSize) {\n    throw new RangeError('response pageSize does not match the accepted request');\n  }\n  if (!Array.isArray(input['items']) || input['items'].length > pageSize) {\n    throw new RangeError('response items exceed the bounded pageSize');\n  }\n  return {\n    contractVersion: SPLITUS_BILL_CONTRACT_VERSION,\n    pageSize,\n    items: input['items'].map((item) => splitusBillListItem(item)),\n    nextCursor: optionalText(input['nextCursor'], 'nextCursor', 2048),\n  };\n}\n\nexport function parseSplitusBillV1(value: unknown): ISplitusBillV1 {\n  const input = record(value, 'bill');\n  const request = parseCreateSplitusBillV1Request(input);\n  const resolvedSourceEffects = sourceEffects(input['resolvedSourceEffects']);\n  const revisionValue = positiveIntegerString(input['revision'], 'revision');\n  const createdAt = timestamp(input['createdAt'], 'createdAt');\n  const updatedAt = timestamp(input['updatedAt'], 'updatedAt');\n  if (Date.parse(updatedAt) < Date.parse(createdAt)) {\n    throw new RangeError('updatedAt must not precede createdAt');\n  }\n  const postingValue = posting(input['posting'], revisionValue);\n  const debtusValue =\n    input['debtus'] === undefined\n      ? undefined\n      : debtusStatus(\n          input['debtus'],\n          request.spaceID,\n          request.billID,\n          request.currency,\n        );\n  if (debtusValue !== undefined && postingValue.status !== 'applied') {\n    throw new TypeError('Debtus status requires applied posting');\n  }\n  if (debtusValue !== undefined) {\n    const receipt = postingValue.receipt;\n    if (receipt === undefined) {\n      throw new TypeError('Debtus status requires an applied posting receipt');\n    }\n    validateDebtusMatchesReceipt(receipt, debtusValue);\n  }\n  return {\n    ...request,\n    resolvedSourceEffects,\n    revision: revisionValue,\n    posting: postingValue,\n    debtus: debtusValue,\n    createdAt,\n    updatedAt,\n  };\n}\n\nfunction sourceEffects(\n  value: unknown,\n): readonly ISplitusResolvedSourceEffectV1[] {\n  if (value === undefined) return [];\n  if (!Array.isArray(value) || value.length > 100) {\n    throw new RangeError('resolvedSourceEffects exceeds maximum item count 100');\n  }\n  const effects = value.map((item, index) => sourceEffect(item, index));\n  return effects;\n}\n\nfunction sourceEffect(\n  value: unknown,\n  index: number,\n): ISplitusResolvedSourceEffectV1 {\n  const input = record(value, `resolvedSourceEffects[${index}]`);\n  const agreementID = optionalStorageID(input['agreementID'], 'agreementID');\n  const priceRevision = input['priceRevision'];\n  if (\n    typeof priceRevision !== 'number' ||\n    !Number.isSafeInteger(priceRevision) ||\n    priceRevision < 0\n  ) {\n    throw new RangeError('priceRevision must be a non-negative safe integer');\n  }\n  const expectedAmount = parseExactDecimalString(\n    input['expectedAmount'],\n  );\n  if (typeof input['sourceAttributionCaptured'] !== 'boolean') {\n    throw new TypeError('sourceAttributionCaptured must be boolean');\n  }\n  const assetIDs =\n    input['assetIDs'] === undefined\n      ? []\n      : identifierArray(input['assetIDs'], 'assetIDs', 100);\n  const contactLinks = sourceContactLinks(input['contactLinks']);\n  const ownerSpaceID = optionalStorageID(input['ownerSpaceID'], 'ownerSpaceID');\n  const enrollmentID = optionalStorageID(input['enrollmentID'], 'enrollmentID');\n  const chargeID = optionalStorageID(input['chargeID'], 'chargeID');\n  const occurrenceID = optionalStorageID(input['occurrenceID'], 'occurrenceID');\n  const direction = optionalEnum(\n    input['direction'],\n    ['expense', 'income', 'transfer'] as const,\n    'direction',\n  );\n  const temporalBasis = optionalEnum(\n    input['temporalBasis'],\n    [\n      'occurrence_service_cost',\n      'contract_period_cost',\n      'normalized_service_cost',\n    ] as const,\n    'temporalBasis',\n  );\n  const economicPeriod =\n    input['economicPeriod'] === undefined\n      ? undefined\n      : period(input['economicPeriod']);\n  const eligible = optionalBoolean(\n    input['invoiceReconciliationEligible'],\n    'invoiceReconciliationEligible',\n  );\n  const contactAttributions = sourceAttributions(\n    input['contactAttributions'],\n    'contactAttributions',\n  );\n  const assetAttributions = sourceAttributions(\n    input['assetAttributions'],\n    'assetAttributions',\n  );\n  return {\n    priceID: storageID(input['priceID'], 'priceID'),\n    priceRevision,\n    expectedAmount,\n    sourceAttributionCaptured: input['sourceAttributionCaptured'],\n    assetIDs,\n    contactLinks,\n    ownerSpaceID,\n    agreementID,\n    enrollmentID,\n    chargeID,\n    occurrenceID,\n    direction,\n    temporalBasis,\n    economicPeriod,\n    invoiceReconciliationEligible: eligible,\n    contactAttributions,\n    assetAttributions,\n  };\n}\n\nfunction sourceContactLinks(value: unknown): readonly ISplitusSourceContactLinkV1[] {\n  if (value === undefined) return [];\n  if (!Array.isArray(value) || value.length > 100) {\n    throw new RangeError('contactLinks exceeds maximum item count 100');\n  }\n  const links = value.map((item, index) => {\n    const input = record(item, `contactLinks[${index}]`);\n    const roles = textArray(input['roles'], `contactLinks[${index}].roles`, 32);\n    return {\n      contactID: storageID(input['contactID'], `contactLinks[${index}].contactID`),\n      roles,\n    };\n  });\n  return links;\n}\n\nfunction sourceAttributions(\n  value: unknown,\n  name: string,\n): readonly ISplitusSourceAttributionV1[] {\n  if (value === undefined) return [];\n  if (!Array.isArray(value) || value.length > 100) {\n    throw new RangeError(`${name} exceeds maximum item count 100`);\n  }\n  const values = value.map((item, index) => {\n    const input = record(item, `${name}[${index}]`);\n    return {\n      id: storageID(input['id'], `${name}[${index}].id`),\n      amount: parseExactDecimalString(input['amount']),\n    };\n  });\n  return values;\n}\n\nfunction splitusBillListItem(value: unknown): ISplitusBillListItemV1 {\n  const input = versionedRecord(value, 'bill list item');\n  const billKind = enumValue(\n    input['billKind'],\n    ['general', 'utility'] as const,\n    'billKind',\n  );\n  const utilityKind =\n    input['utilityKind'] === undefined\n      ? undefined\n      : enumValue(\n          input['utilityKind'],\n          ['electricity', 'gas', 'water', 'internet', 'other'] as const,\n          'utilityKind',\n        );\n  const periodValue =\n    input['period'] === undefined ? undefined : period(input['period']);\n  if (\n    (billKind === 'utility') !==\n    (utilityKind !== undefined && periodValue !== undefined)\n  ) {\n    throw new TypeError('utility list items require utilityKind and period');\n  }\n  const postingStatus = enumValue(\n    input['postingStatus'],\n    ['pending', 'posting', 'applied', 'attention'] as const,\n    'postingStatus',\n  );\n  const debtusSettlementStatus =\n    input['debtusSettlementStatus'] === undefined\n      ? undefined\n      : settlementStatus(\n          input['debtusSettlementStatus'],\n          'debtusSettlementStatus',\n        );\n  if (\n    debtusSettlementStatus !== undefined &&\n    postingStatus !== 'applied'\n  ) {\n    throw new TypeError('Debtus settlement status requires applied posting');\n  }\n  return {\n    contractVersion: SPLITUS_BILL_CONTRACT_VERSION,\n    spaceID: storageID(input['spaceID'], 'spaceID'),\n    billID: storageID(input['billID'], 'billID'),\n    title: optionalText(input['title'], 'title', 256),\n    billKind,\n    utilityKind,\n    period: periodValue,\n    currency: currency(input['currency']),\n    actualAmount: positiveAmount(input['actualAmount'], 'actualAmount'),\n    ownPaidAmount: nonNegativeAmount(input['ownPaidAmount'], 'ownPaidAmount'),\n    ownOwedAmount: nonNegativeAmount(input['ownOwedAmount'], 'ownOwedAmount'),\n    postingStatus,\n    debtusSettlementStatus,\n    createdAt: timestamp(input['createdAt'], 'createdAt'),\n  };\n}\n\nfunction posting(value: unknown, billRevision: string): ISplitusBillPostingV1 {\n  const input = record(value, 'posting');\n  const status = enumValue(\n    input['status'],\n    ['pending', 'posting', 'applied', 'attention'] as const,\n    'posting.status',\n  );\n  const operationKey = storageID(input['operationKey'], 'posting.operationKey');\n  const inputDigest = digest(input['inputDigest'], 'posting.inputDigest');\n  const receiptValue =\n    input['receipt'] === undefined\n      ? undefined\n      : postingReceipt(\n          input['receipt'],\n          billRevision,\n          operationKey,\n          inputDigest,\n        );\n  const attentionCode =\n    input['attentionCode'] === undefined\n      ? undefined\n      : enumValue(\n          input['attentionCode'],\n          [\n            'authorization_changed',\n            'source_conflict',\n            'provider_rejected',\n            'invalid_provider_receipt',\n            'operator_action_required',\n          ] as const,\n          'posting.attentionCode',\n        );\n  if ((status === 'applied') !== (receiptValue !== undefined)) {\n    throw new TypeError('applied posting status requires exactly one receipt');\n  }\n  if ((status === 'attention') !== (attentionCode !== undefined)) {\n    throw new TypeError('attention posting status requires exactly one code');\n  }\n  return {\n    status,\n    operationKey,\n    inputDigest,\n    receipt: receiptValue,\n    attentionCode,\n  };\n}\n\nfunction postingReceipt(\n  value: unknown,\n  billRevision: string,\n  operationKey: string,\n  inputDigest: string,\n): ISplitusBillPostingReceiptV1 {\n  const input = record(value, 'posting.receipt');\n  const revisionValue = positiveIntegerString(\n    input['revision'],\n    'posting.receipt.revision',\n  );\n  const receiptOperationKey = storageID(\n    input['operationKey'],\n    'posting.receipt.operationKey',\n  );\n  const receiptInputDigest = digest(\n    input['inputDigest'],\n    'posting.receipt.inputDigest',\n  );\n  if (\n    revisionValue !== billRevision ||\n    receiptOperationKey !== operationKey ||\n    receiptInputDigest !== inputDigest\n  ) {\n    throw new TypeError('posting receipt does not match the accepted bill revision');\n  }\n  if (\n    !Array.isArray(input['obligationLines']) ||\n    input['obligationLines'].length > MAX_SPLITUS_BILL_OBLIGATIONS\n  ) {\n    throw new RangeError('posting receipt obligationLines are unbounded');\n  }\n  const lineIDs = new Set<string>();\n  const obligationIDs = new Set<string>();\n  const obligationLines = input['obligationLines'].map((value, index) => {\n    const line = record(value, `posting.receipt.obligationLines[${index}]`);\n    const lineID = storageID(\n      line['lineID'],\n      `posting.receipt.obligationLines[${index}].lineID`,\n    );\n    if (lineIDs.has(lineID)) {\n      throw new TypeError('posting receipt repeats an obligation line');\n    }\n    lineIDs.add(lineID);\n    const ids = identifierArray(\n      line['obligationIDs'],\n      `posting.receipt.obligationLines[${index}].obligationIDs`,\n      MAX_SPLITUS_OBLIGATION_IDS_PER_LINE,\n    );\n    for (const id of ids) {\n      if (obligationIDs.has(id)) {\n        throw new TypeError('posting receipt repeats an obligation ID');\n      }\n      obligationIDs.add(id);\n    }\n    return { lineID, obligationIDs: ids };\n  });\n  return {\n    receiptID: storageID(input['receiptID'], 'posting.receipt.receiptID'),\n    operationKey: receiptOperationKey,\n    inputDigest: receiptInputDigest,\n    revision: revisionValue,\n    obligationLines,\n  };\n}\n\nfunction debtusStatus(\n  value: unknown,\n  spaceID: string,\n  billID: string,\n  billCurrency: string,\n): ISplitusDebtusStatusV1 {\n  const input = record(value, 'debtus');\n  if (\n    !Array.isArray(input['obligations']) ||\n    input['obligations'].length > MAX_SPLITUS_BILL_OBLIGATIONS\n  ) {\n    throw new RangeError('Debtus obligations are unbounded');\n  }\n  const lineIDs = new Set<string>();\n  const obligations = input['obligations'].map((item, index) => {\n    const obligation = record(item, `debtus.obligations[${index}]`);\n    const lineID = storageID(\n      obligation['lineID'],\n      `debtus.obligations[${index}].lineID`,\n    );\n    if (lineIDs.has(lineID)) {\n      throw new TypeError('Debtus status repeats an obligation line');\n    }\n    lineIDs.add(lineID);\n    const obligationCurrency = currency(obligation['currency']);\n    if (obligationCurrency !== billCurrency) {\n      throw new TypeError('Debtus obligation currency differs from the bill');\n    }\n    return {\n      lineID,\n      obligationIDs: identifierArray(\n        obligation['obligationIDs'],\n        `debtus.obligations[${index}].obligationIDs`,\n        MAX_SPLITUS_OBLIGATION_IDS_PER_LINE,\n      ),\n      debtorContactID: storageID(\n        obligation['debtorContactID'],\n        `debtus.obligations[${index}].debtorContactID`,\n      ),\n      creditorContactID: storageID(\n        obligation['creditorContactID'],\n        `debtus.obligations[${index}].creditorContactID`,\n      ),\n      currency: obligationCurrency,\n      principalAmount: positiveAmount(\n        obligation['principalAmount'],\n        `debtus.obligations[${index}].principalAmount`,\n      ),\n      outstandingAmount: nonNegativeAmount(\n        obligation['outstandingAmount'],\n        `debtus.obligations[${index}].outstandingAmount`,\n      ),\n      repaidAmount: nonNegativeAmount(\n        obligation['repaidAmount'],\n        `debtus.obligations[${index}].repaidAmount`,\n      ),\n      creditAmount: nonNegativeAmount(\n        obligation['creditAmount'],\n        `debtus.obligations[${index}].creditAmount`,\n      ),\n      status: settlementStatus(\n        obligation['status'],\n        `debtus.obligations[${index}].status`,\n      ),\n      settlementTarget: settlementTarget(\n        obligation['settlementTarget'],\n        spaceID,\n        billID,\n        lineID,\n      ),\n    };\n  });\n  return {\n    status: settlementStatus(input['status'], 'debtus.status'),\n    obligations,\n    settlementTarget: settlementTarget(\n      input['settlementTarget'],\n      spaceID,\n      billID,\n    ),\n  };\n}\n\nfunction validateDebtusMatchesReceipt(\n  receipt: ISplitusBillPostingReceiptV1,\n  debtus: ISplitusDebtusStatusV1,\n): void {\n  if (receipt.obligationLines.length !== debtus.obligations.length) {\n    throw new TypeError(\n      'Debtus obligations do not exactly match the applied posting receipt',\n    );\n  }\n  const receiptLines = new Map(\n    receipt.obligationLines.map((line) => [\n      line.lineID,\n      new Set(line.obligationIDs),\n    ]),\n  );\n  for (const obligation of debtus.obligations) {\n    const receiptIDs = receiptLines.get(obligation.lineID);\n    if (\n      receiptIDs === undefined ||\n      receiptIDs.size !== obligation.obligationIDs.length ||\n      obligation.obligationIDs.some((id) => !receiptIDs.has(id))\n    ) {\n      throw new TypeError(\n        'Debtus obligations do not exactly match the applied posting receipt',\n      );\n    }\n  }\n}\n\nfunction settlementTarget(\n  value: unknown,\n  spaceID: string,\n  billID: string,\n  expectedLineID?: string,\n): ISplitusDebtusSettlementTargetV1 {\n  const input = record(value, 'settlementTarget');\n  const lineID =\n    input['lineID'] === undefined\n      ? undefined\n      : storageID(input['lineID'], 'settlementTarget.lineID');\n  if (\n    input['route'] !== 'debtus.source-obligations' ||\n    input['sourceNamespace'] !== 'splitus' ||\n    input['spaceID'] !== spaceID ||\n    input['sourceRecordID'] !== billID ||\n    lineID !== expectedLineID\n  ) {\n    throw new TypeError('settlement target does not match the Splitus bill source');\n  }\n  return {\n    route: 'debtus.source-obligations',\n    spaceID,\n    sourceNamespace: 'splitus',\n    sourceRecordID: billID,\n    lineID,\n  };\n}\n\nfunction versionedRecord(value: unknown, name: string): Record<string, unknown> {\n  const input = record(value, name);\n  if (input['contractVersion'] !== SPLITUS_BILL_CONTRACT_VERSION) {\n    throw new TypeError('unsupported Splitus bill contract version');\n  }\n  return input;\n}\n\nfunction boundedPageSize(value: unknown): number {\n  if (\n    typeof value !== 'number' ||\n    !Number.isSafeInteger(value) ||\n    value < 1 ||\n    value > MAX_SPLITUS_BILL_LIST_PAGE_SIZE\n  ) {\n    throw new RangeError(\n      `pageSize must be an integer from 1 to ${MAX_SPLITUS_BILL_LIST_PAGE_SIZE}`,\n    );\n  }\n  return value;\n}\n\nfunction settlementStatus(\n  value: unknown,\n  name: string,\n): SplitusDebtusSettlementStatus {\n  return enumValue(\n    value,\n    ['unsettled', 'part_settled', 'settled'] as const,\n    name,\n  );\n}\n\nfunction identifierArray(value: unknown, name: string, maximum: number): string[] {\n  if (!Array.isArray(value) || value.length < 1 || value.length > maximum) {\n    throw new RangeError(`${name} must contain 1 to ${maximum} identifiers`);\n  }\n  const seen = new Set<string>();\n  return value.map((item, index) => {\n    const id = storageID(item, `${name}[${index}]`);\n    if (seen.has(id)) {\n      throw new TypeError(`${name} contains a duplicate identifier`);\n    }\n    seen.add(id);\n    return id;\n  });\n}\n\nfunction digest(value: unknown, name: string): string {\n  if (typeof value !== 'string' || !/^[0-9a-f]{64}$/.test(value)) {\n    throw new TypeError(`${name} must be a lowercase SHA-256 digest`);\n  }\n  return value;\n}\n\nfunction positiveIntegerString(value: unknown, name: string): string {\n  if (typeof value !== 'string' || !/^[1-9][0-9]*$/.test(value)) {\n    throw new TypeError(`${name} must be a canonical positive integer string`);\n  }\n  if (BigInt(value) > 18_446_744_073_709_551_615n) {\n    throw new RangeError(`${name} exceeds unsigned 64-bit range`);\n  }\n  return value;\n}\n\nfunction timestamp(value: unknown, name: string): string {\n  if (\n    typeof value !== 'string' ||\n    !/^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})$/.test(\n      value,\n    ) ||\n    Number.isNaN(Date.parse(value))\n  ) {\n    throw new TypeError(`${name} must be an RFC 3339 timestamp`);\n  }\n  date(value.slice(0, 10), name);\n  return value;\n}\n\nfunction nonNegativeAmount(\n  value: unknown,\n  name: string,\n): ExactDecimalString {\n  try {\n    return parseExactDecimalString(value);\n  } catch (error) {\n    if (error instanceof RangeError) {\n      throw new RangeError(`${name}: ${error.message}`);\n    }\n    if (error instanceof Error) {\n      throw new TypeError(`${name}: ${error.message}`);\n    }\n    throw error;\n  }\n}\n\nfunction validateAllocationTotals(request: ICreateSplitusBillV1Request): void {\n  const contacts = new Set<string>();\n  for (const allocation of [\n    ...request.paidAllocations,\n    ...request.owedAllocations,\n  ]) {\n    contacts.add(allocation.contactID);\n  }\n  if (contacts.size < 2 || contacts.size > MAX_SPLITUS_BILL_PARTICIPANTS) {\n    throw new RangeError(\n      `bill must have 2 to ${MAX_SPLITUS_BILL_PARTICIPANTS} participants`,\n    );\n  }\n  const actual = amountToMinorUnits(request.actualAmount);\n  if (sumAllocations(request.paidAllocations) !== actual) {\n    throw new RangeError('paid allocations must reconcile to actualAmount');\n  }\n  if (sumAllocations(request.owedAllocations) !== actual) {\n    throw new RangeError('owed allocations must reconcile to actualAmount');\n  }\n}\n\nfunction allocations(value: unknown, name: string): ISplitusBillAllocationV1[] {\n  if (!Array.isArray(value) || value.length < 1 || value.length > MAX_SPLITUS_BILL_PARTICIPANTS) {\n    throw new RangeError(\n      `${name} must contain 1 to ${MAX_SPLITUS_BILL_PARTICIPANTS} allocations`,\n    );\n  }\n  const allocationIDs = new Set<string>();\n  const contactIDs = new Set<string>();\n  return value.map((item, index) => {\n    const input = record(item, `${name}[${index}]`);\n    const allocationID = storageID(\n      input['allocationID'],\n      `${name}[${index}].allocationID`,\n    );\n    const contactID = storageID(\n      input['contactID'],\n      `${name}[${index}].contactID`,\n    );\n    if (allocationIDs.has(allocationID) || contactIDs.has(contactID)) {\n      throw new TypeError(`${name} contains a duplicate allocation or contact`);\n    }\n    allocationIDs.add(allocationID);\n    contactIDs.add(contactID);\n    return {\n      allocationID,\n      contactID,\n      amount: positiveAmount(input['amount'], `${name}[${index}].amount`),\n    };\n  });\n}\n\nfunction sumAllocations(allocationsToSum: readonly ISplitusBillAllocationV1[]): bigint {\n  let total = 0n;\n  for (const allocation of allocationsToSum) {\n    total += amountToMinorUnits(allocation.amount);\n    if (total > MAX_EXACT_MINOR_UNITS) {\n      throw new RangeError('allocation total exceeds the Splitus contract limit');\n    }\n  }\n  return total;\n}\n\nfunction amountToMinorUnits(value: ExactDecimalString): bigint {\n  return BigInt(value.replace('.', ''));\n}\n\nfunction positiveAmount(value: unknown, name: string): ExactDecimalString {\n  const amount = parseExactDecimalString(value);\n  if (amountToMinorUnits(amount) === 0n) {\n    throw new RangeError(`${name} must be positive`);\n  }\n  return amount;\n}\n\nfunction utility(value: unknown): ISplitusUtilityDetailsV1 {\n  const input = record(value, 'utility');\n  return {\n    utilityKind: enumValue(\n      input['utilityKind'],\n      ['electricity', 'gas', 'water', 'internet', 'other'] as const,\n      'utility.utilityKind',\n    ),\n    providerName: optionalText(\n      input['providerName'],\n      'utility.providerName',\n      256,\n    ),\n    period: period(input['period']),\n  };\n}\n\nfunction recurring(\n  value: unknown,\n  actualAmount: ExactDecimalString,\n  billID: string,\n): ISplitusRecurringOccurrenceV1 {\n  const input = record(value, 'recurringOccurrence');\n  const expectedAmount =\n    input['expectedAmount'] === undefined\n      ? undefined\n      : positiveAmount(\n          input['expectedAmount'],\n          'recurringOccurrence.expectedAmount',\n        );\n  const standingChargeAmount =\n    input['standingChargeAmount'] === undefined\n      ? undefined\n      : positiveAmount(\n          input['standingChargeAmount'],\n          'recurringOccurrence.standingChargeAmount',\n        );\n  const expectedComparison = input['expectedComparison'] === undefined\n    ? undefined\n    : enumValue(\n        input['expectedComparison'],\n        ['not_available', 'matches', 'increased', 'decreased'] as const,\n        'recurringOccurrence.expectedComparison',\n      );\n  if (\n    expectedAmount === undefined &&\n    expectedComparison !== undefined &&\n    expectedComparison !== 'not_available'\n  ) {\n    throw new TypeError(\n      'comparison must be not_available exactly when expectedAmount is absent',\n    );\n  }\n  if (expectedAmount !== undefined) {\n    const expectedComparisonForAmounts = compareAmounts(\n      actualAmount,\n      expectedAmount,\n    );\n    if (expectedComparison !== undefined && expectedComparison !== expectedComparisonForAmounts) {\n      throw new TypeError('comparison does not match expected and actual amounts');\n    }\n  }\n  if (\n    standingChargeAmount !== undefined &&\n    amountToMinorUnits(standingChargeAmount) > amountToMinorUnits(actualAmount)\n  ) {\n    throw new RangeError('standing charge cannot exceed actualAmount');\n  }\n  return {\n    happeningID: storageID(\n      input['happeningID'],\n      'recurringOccurrence.happeningID',\n    ),\n    occurrenceID: storageID(\n      input['occurrenceID'],\n      'recurringOccurrence.occurrenceID',\n    ),\n    chargeID:\n      input['chargeID'] === undefined\n        ? undefined\n        : storageID(input['chargeID'], 'recurringOccurrence.chargeID'),\n    expectedAmount,\n    standingChargeAmount,\n    expectedComparison,\n    previousComparable:\n      input['previousComparable'] === undefined\n        ? undefined\n        : previousComparable(\n            input['previousComparable'],\n            actualAmount,\n            billID,\n          ),\n  };\n}\n\nfunction previousComparable(\n  value: unknown,\n  actualAmount: ExactDecimalString,\n  billID: string,\n): ISplitusPreviousComparableBillV1 {\n  const input = record(value, 'recurringOccurrence.previousComparable');\n  const previousBillID = storageID(\n    input['billID'],\n    'recurringOccurrence.previousComparable.billID',\n  );\n  if (previousBillID === billID) {\n    throw new TypeError('previous comparable bill must have a different billID');\n  }\n  const previousActualAmount = positiveAmount(\n    input['actualAmount'],\n    'recurringOccurrence.previousComparable.actualAmount',\n  );\n  const comparison = enumValue(\n    input['comparison'],\n    ['matches', 'increased', 'decreased'] as const,\n    'recurringOccurrence.previousComparable.comparison',\n  );\n  const expectedComparison = compareAmounts(\n    actualAmount,\n    previousActualAmount,\n  );\n  if (comparison !== expectedComparison) {\n    throw new TypeError(\n      'previous comparison does not match current and prior actual amounts',\n    );\n  }\n  return {\n    billID: previousBillID,\n    actualAmount: previousActualAmount,\n    comparison,\n  };\n}\n\nfunction compareAmounts(\n  current: ExactDecimalString,\n  baseline: ExactDecimalString,\n): Exclude<SplitusExpectedActualComparison, 'not_available'> {\n  const currentMinor = amountToMinorUnits(current);\n  const baselineMinor = amountToMinorUnits(baseline);\n  return currentMinor === baselineMinor\n    ? 'matches'\n    : currentMinor > baselineMinor\n      ? 'increased'\n      : 'decreased';\n}\n\nfunction period(value: unknown): ISplitusBillingPeriodV1 {\n  const input = record(value, 'period');\n  const startDate = date(input['startDate'], 'period.startDate');\n  const endDate = date(input['endDate'], 'period.endDate');\n  if (endDate < startDate) {\n    throw new RangeError('period.endDate must not precede period.startDate');\n  }\n  return { startDate, endDate };\n}\n\nfunction date(value: unknown, name: string): string {\n  if (typeof value !== 'string') {\n    throw new TypeError(`${name} must be an ISO calendar date`);\n  }\n  const match = datePattern.exec(value);\n  if (match === null) {\n    throw new TypeError(`${name} must be an ISO calendar date`);\n  }\n  const parsed = new Date(`${value}T00:00:00.000Z`);\n  if (Number.isNaN(parsed.valueOf()) || parsed.toISOString().slice(0, 10) !== value) {\n    throw new TypeError(`${name} must be a real ISO calendar date`);\n  }\n  return value;\n}\n\nfunction currency(value: unknown): SplitusCurrencyCode {\n  return enumValue(value, ['EUR', 'GBP', 'USD'] as const, 'currency');\n}\n\nfunction storageID(value: unknown, name: string): string {\n  if (\n    typeof value !== 'string' ||\n    value.length === 0 ||\n    value.trim() !== value ||\n    new TextEncoder().encode(value).length > 512 ||\n    value.includes('/') ||\n    hasControlCharacters(value) ||\n    value === '.' ||\n    value === '..' ||\n    (/^__/.test(value) && /__$/.test(value))\n  ) {\n    throw new TypeError(`${name} is not a safe identifier`);\n  }\n  return value;\n}\n\nfunction optionalText(\n  value: unknown,\n  name: string,\n  maxBytes: number,\n): string | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n  if (\n    typeof value !== 'string' ||\n    value.length === 0 ||\n    value.trim() !== value ||\n    new TextEncoder().encode(value).length > maxBytes ||\n    hasControlCharacters(value)\n  ) {\n    throw new TypeError(`${name} is empty, padded, too long, or contains controls`);\n  }\n  return value;\n}\n\nfunction hasControlCharacters(value: string): boolean {\n  for (const character of value) {\n    const code = character.charCodeAt(0);\n    if (code < 0x20 || code === 0x7f) {\n      return true;\n    }\n  }\n  return false;\n}\n\nfunction record(value: unknown, name: string): Record<string, unknown> {\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n    throw new TypeError(`${name} must be an object`);\n  }\n  return value as Record<string, unknown>;\n}\n\nfunction enumValue<const T extends readonly string[]>(\n  value: unknown,\n  allowed: T,\n  name: string,\n): T[number] {\n  if (typeof value !== 'string' || !allowed.includes(value)) {\n    throw new TypeError(`${name} has an unsupported value`);\n  }\n  return value as T[number];\n}\n\nfunction optionalStorageID(value: unknown, name: string): string | undefined {\n  return value === undefined ? undefined : storageID(value, name);\n}\n\nfunction optionalEnum<const T extends readonly string[]>(\n  value: unknown,\n  allowed: T,\n  name: string,\n): T[number] | undefined {\n  return value === undefined ? undefined : enumValue(value, allowed, name);\n}\n\nfunction optionalBoolean(value: unknown, name: string): boolean | undefined {\n  if (value === undefined) return undefined;\n  if (typeof value !== 'boolean') throw new TypeError(`${name} must be boolean`);\n  return value;\n}\n\nfunction textArray(value: unknown, name: string, maximum: number): string[] {\n  if (value === undefined) return [];\n  if (!Array.isArray(value) || value.length > maximum) {\n    throw new RangeError(`${name} exceeds maximum item count ${maximum}`);\n  }\n  const values = value.map((item, index) =>\n    optionalText(item, `${name}[${index}]`, 100),\n  );\n  if (values.some((item) => item === undefined)) {\n    throw new TypeError(`${name} contains an invalid value`);\n  }\n  const result = values as string[];\n  return result;\n}\n","import { InjectionToken } from '@angular/core';\nimport { Observable } from 'rxjs';\nimport {\n  ICreateSplitRequest,\n  ICreateSplitResponse,\n  ICreateSplitusBillV1Request,\n  ICreateSplitusBillV1Response,\n  IGetSplitusBillV1Request,\n  IGetSplitusBillV1Response,\n  IListSplitusBillsV1Request,\n  IListSplitusBillsV1Response,\n  ISplit,\n  ISplitListItem,\n} from './dto';\n\n/** @deprecated Use `ISplitusBillServiceV1`. */\nexport interface ISplitusService {\n  /** REAL: POST /api4splitus/create-split. Payer is the authenticated user. */\n  createSplit(request: ICreateSplitRequest): Observable<ICreateSplitResponse>;\n  /** REAL: GET /api4splitus/split?spaceID=&id= */\n  getSplit(spaceID: string, id: string): Observable<ISplit>;\n  /** REAL: GET /api4splitus/splits?spaceID= */\n  getSplits(spaceID: string): Observable<ISplitListItem[]>;\n}\n\n/** @deprecated Use `SPLITUS_BILL_SERVICE_V1`. */\nexport const SPLITUS_SERVICE = new InjectionToken<ISplitusService>('SplitusService');\n\nexport interface ISplitusBillServiceV1 {\n  createBill(\n    request: ICreateSplitusBillV1Request,\n  ): Observable<ICreateSplitusBillV1Response>;\n  getBill(\n    request: IGetSplitusBillV1Request,\n  ): Observable<IGetSplitusBillV1Response>;\n  listBills(\n    request: IListSplitusBillsV1Request,\n  ): Observable<IListSplitusBillsV1Response>;\n}\n\nexport const SPLITUS_BILL_SERVICE_V1 =\n  new InjectionToken<ISplitusBillServiceV1>('SplitusBillServiceV1');\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sneat/extension-splitus-contract",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "publishConfig": {
     "access": "public"
   },

package/types/sneat-extension-splitus-contract.d.ts

@@ -1,14 +1,262 @@
 import { InjectionToken } from '@angular/core';
 import { Observable } from 'rxjs';
 
-/** Mirrors models4splitus.SplitMode (backend/splitus/models4splitus). */
+/** The first stable Splitus bill browser/host wire contract. */
+declare const SPLITUS_BILL_CONTRACT_VERSION: 1;
+declare const MAX_SPLITUS_BILL_PARTICIPANTS = 256;
+declare const MAX_SPLITUS_BILL_LIST_PAGE_SIZE = 100;
+declare const MAX_SPLITUS_BILL_OBLIGATIONS = 256;
+declare const MAX_SPLITUS_OBLIGATION_IDS_PER_LINE = 256;
+type SplitusBillContractVersion = typeof SPLITUS_BILL_CONTRACT_VERSION;
+/**
+ * A canonical, non-negative major-unit amount with exactly two fraction
+ * digits. Examples: `0.00`, `30.00`, `90.00`.
+ *
+ * The alias documents the wire type; use `parseExactDecimalString()` at an
+ * untrusted boundary. JavaScript numbers and minor-unit numbers are not part
+ * of this contract.
+ */
+type ExactDecimalString = string;
+/** Currencies whose minor unit is exactly two decimal digits in this contract. */
+type SplitusCurrencyCode = 'EUR' | 'GBP' | 'USD';
+type SplitusBillKind = 'general' | 'utility';
+type SplitusUtilityKind = 'electricity' | 'gas' | 'water' | 'internet' | 'other';
+type SplitusBillPostingStatus = 'pending' | 'posting' | 'applied' | 'attention';
+type SplitusDebtusSettlementStatus = 'unsettled' | 'part_settled' | 'settled';
+type SplitusExpectedActualComparison = 'not_available' | 'matches' | 'increased' | 'decreased';
+type SplitusBillAttentionCode = 'authorization_changed' | 'source_conflict' | 'provider_rejected' | 'invalid_provider_receipt' | 'operator_action_required';
+interface ISplitusBillAllocationV1 {
+    /** Stable within the bill revision, independent of array ordering. */
+    readonly allocationID: string;
+    /**
+     * Contactus identity in this Space. Hosts resolve its real display data from
+     * Contactus; this opaque ID is never a user-facing label.
+     */
+    readonly contactID: string;
+    readonly amount: ExactDecimalString;
+}
+interface ISplitusBillingPeriodV1 {
+    /** Inclusive ISO calendar date. */
+    readonly startDate: string;
+    /** Inclusive ISO calendar date; must not precede `startDate`. */
+    readonly endDate: string;
+}
+interface ISplitusUtilityDetailsV1 {
+    readonly utilityKind: SplitusUtilityKind;
+    readonly providerName?: string;
+    readonly period: ISplitusBillingPeriodV1;
+}
+/**
+ * A reference to the Calendarius occurrence represented by this actual bill.
+ * `expectedAmount` and `standingChargeAmount` are context only; neither is a
+ * paid expense. `actualAmount` on the enclosing bill remains mandatory.
+ */
+interface ISplitusRecurringOccurrenceV1 {
+    readonly happeningID: string;
+    readonly occurrenceID: string;
+    readonly chargeID?: string;
+    readonly expectedAmount?: ExactDecimalString;
+    readonly standingChargeAmount?: ExactDecimalString;
+    readonly expectedComparison?: SplitusExpectedActualComparison;
+    readonly previousComparable?: ISplitusPreviousComparableBillV1;
+}
+interface ISplitusPreviousComparableBillV1 {
+    readonly billID: string;
+    readonly actualAmount: ExactDecimalString;
+    readonly comparison: Exclude<SplitusExpectedActualComparison, 'not_available'>;
+}
+type SplitusResolvedSourceDirection = 'expense' | 'income' | 'transfer';
+type SplitusResolvedSourceTemporalBasis = 'occurrence_service_cost' | 'contract_period_cost' | 'normalized_service_cost';
+interface ISplitusSourceContactLinkV1 {
+    readonly contactID: string;
+    readonly roles: readonly string[];
+}
+interface ISplitusSourceAttributionV1 {
+    readonly id: string;
+    readonly amount: ExactDecimalString;
+}
+/** Immutable source facts captured by Splitus when the actual bill is accepted. */
+interface ISplitusResolvedSourceEffectV1 {
+    readonly priceID: string;
+    readonly priceRevision: number;
+    readonly expectedAmount: ExactDecimalString;
+    readonly sourceAttributionCaptured: boolean;
+    readonly assetIDs: readonly string[];
+    readonly contactLinks: readonly ISplitusSourceContactLinkV1[];
+    /** Present as one complete group for agreement-backed reconciliation. */
+    readonly ownerSpaceID?: string;
+    readonly agreementID?: string;
+    readonly enrollmentID?: string;
+    readonly chargeID?: string;
+    readonly occurrenceID?: string;
+    readonly direction?: SplitusResolvedSourceDirection;
+    readonly temporalBasis?: SplitusResolvedSourceTemporalBasis;
+    readonly economicPeriod?: ISplitusBillingPeriodV1;
+    readonly invoiceReconciliationEligible?: boolean;
+    readonly contactAttributions: readonly ISplitusSourceAttributionV1[];
+    readonly assetAttributions: readonly ISplitusSourceAttributionV1[];
+}
+interface ICreateSplitusBillV1Request {
+    readonly contractVersion: SplitusBillContractVersion;
+    readonly spaceID: string;
+    /**
+     * Stable across duplicate submission and lost-response retries. Reusing the
+     * same ID with changed paid/owed allocations is a provider conflict.
+     */
+    readonly billID: string;
+    /**
+     * Audit identity of the authenticated actor. The server must bind this to
+     * its trusted authentication context. It never implies a paid or owed
+     * allocation.
+     */
+    readonly recorderUserID: string;
+    readonly title?: string;
+    readonly billKind: SplitusBillKind;
+    readonly currency: SplitusCurrencyCode;
+    /** Actual paid amount. An expectation is never accepted in its place. */
+    readonly actualAmount: ExactDecimalString;
+    /** Explicit sources of payment; one contact may also owe a share. */
+    readonly paidAllocations: readonly ISplitusBillAllocationV1[];
+    /** Explicit responsibility shares. */
+    readonly owedAllocations: readonly ISplitusBillAllocationV1[];
+    /** Required exactly when `billKind` is `utility`. */
+    readonly utility?: ISplitusUtilityDetailsV1;
+    readonly recurringOccurrence?: ISplitusRecurringOccurrenceV1;
+}
+interface ISplitusDebtusReceiptLineV1 {
+    readonly lineID: string;
+    readonly obligationIDs: readonly string[];
+}
+interface ISplitusBillPostingReceiptV1 {
+    readonly receiptID: string;
+    readonly operationKey: string;
+    readonly inputDigest: string;
+    readonly revision: string;
+    readonly obligationLines: readonly ISplitusDebtusReceiptLineV1[];
+}
+interface ISplitusBillPostingV1 {
+    readonly status: SplitusBillPostingStatus;
+    /** Durable identity of the retry-safe provider operation. */
+    readonly operationKey: string;
+    /** Digest of the exact accepted source revision and allocations. */
+    readonly inputDigest: string;
+    /** Present exactly when `status` is `applied`. */
+    readonly receipt?: ISplitusBillPostingReceiptV1;
+    /** Present exactly when `status` is `attention`. */
+    readonly attentionCode?: SplitusBillAttentionCode;
+}
+/**
+ * An application-relative target. The host resolves it through its injected
+ * Debtus navigation adapter; contracts never hard-code debtus.app or another
+ * deployment origin.
+ */
+interface ISplitusDebtusSettlementTargetV1 {
+    readonly route: 'debtus.source-obligations';
+    readonly spaceID: string;
+    readonly sourceNamespace: 'splitus';
+    readonly sourceRecordID: string;
+    readonly lineID?: string;
+}
+interface ISplitusDebtusObligationV1 {
+    readonly lineID: string;
+    readonly obligationIDs: readonly string[];
+    readonly debtorContactID: string;
+    readonly creditorContactID: string;
+    readonly currency: SplitusCurrencyCode;
+    readonly principalAmount: ExactDecimalString;
+    readonly outstandingAmount: ExactDecimalString;
+    readonly repaidAmount: ExactDecimalString;
+    readonly creditAmount: ExactDecimalString;
+    readonly status: SplitusDebtusSettlementStatus;
+    readonly settlementTarget: ISplitusDebtusSettlementTargetV1;
+}
+interface ISplitusDebtusStatusV1 {
+    /** Current state read from Debtus, never a Splitus-maintained balance. */
+    readonly status: SplitusDebtusSettlementStatus;
+    readonly obligations: readonly ISplitusDebtusObligationV1[];
+    readonly settlementTarget: ISplitusDebtusSettlementTargetV1;
+}
+interface ISplitusBillV1 extends ICreateSplitusBillV1Request {
+    readonly resolvedSourceEffects?: readonly ISplitusResolvedSourceEffectV1[];
+    /** Canonical positive decimal integer encoded as a string. */
+    readonly revision: string;
+    readonly posting: ISplitusBillPostingV1;
+    /** Absent until a Debtus financial projection is available. */
+    readonly debtus?: ISplitusDebtusStatusV1;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+interface ICreateSplitusBillV1Response {
+    readonly contractVersion: SplitusBillContractVersion;
+    readonly bill: ISplitusBillV1;
+}
+interface IGetSplitusBillV1Request {
+    readonly contractVersion: SplitusBillContractVersion;
+    readonly spaceID: string;
+    readonly billID: string;
+}
+interface IGetSplitusBillV1Response {
+    readonly contractVersion: SplitusBillContractVersion;
+    readonly bill: ISplitusBillV1;
+}
+interface ISplitusBillListItemV1 {
+    readonly contractVersion: SplitusBillContractVersion;
+    readonly spaceID: string;
+    readonly billID: string;
+    readonly title?: string;
+    readonly billKind: SplitusBillKind;
+    readonly utilityKind?: SplitusUtilityKind;
+    readonly period?: ISplitusBillingPeriodV1;
+    readonly currency: SplitusCurrencyCode;
+    readonly actualAmount: ExactDecimalString;
+    readonly ownPaidAmount: ExactDecimalString;
+    readonly ownOwedAmount: ExactDecimalString;
+    readonly postingStatus: SplitusBillPostingStatus;
+    /** Debtus-derived and absent before the bill has a financial projection. */
+    readonly debtusSettlementStatus?: SplitusDebtusSettlementStatus;
+    readonly createdAt: string;
+}
+interface IListSplitusBillsV1Request {
+    readonly contractVersion: SplitusBillContractVersion;
+    readonly spaceID: string;
+    readonly pageSize: number;
+    readonly cursor?: string;
+    readonly utilityKind?: SplitusUtilityKind;
+    readonly period?: ISplitusBillingPeriodV1;
+}
+interface IListSplitusBillsV1Response {
+    readonly contractVersion: SplitusBillContractVersion;
+    /** Echoes the accepted request bound so callers can verify the page. */
+    readonly pageSize: number;
+    /** Contains no more than `pageSize` items and never more than 100. */
+    readonly items: readonly ISplitusBillListItemV1[];
+    readonly nextCursor?: string;
+}
+declare function parseExactDecimalString(value: unknown): ExactDecimalString;
+declare function parseCreateSplitusBillV1Request(value: unknown): ICreateSplitusBillV1Request;
+/**
+ * Executable host-boundary check for the request's audit claim. The trusted
+ * authenticated identity is supplied by the host, never derived from the
+ * request itself.
+ */
+declare function assertCreateSplitusBillV1Recorder(request: ICreateSplitusBillV1Request, authenticatedUserID: string): void;
+declare function parseListSplitusBillsV1Request(value: unknown): IListSplitusBillsV1Request;
+declare function parseGetSplitusBillV1Request(value: unknown): IGetSplitusBillV1Request;
+declare function parseCreateSplitusBillV1Response(value: unknown): ICreateSplitusBillV1Response;
+declare function parseGetSplitusBillV1Response(value: unknown): IGetSplitusBillV1Response;
+declare function parseListSplitusBillsV1Response(value: unknown, requestedPageSize?: number): IListSplitusBillsV1Response;
+declare function parseSplitusBillV1(value: unknown): ISplitusBillV1;
+
+/** @deprecated Use the Splitus bill contract types exported from `bill-v1`. */
 type SplitMode = 'equally' | 'exact-amount' | 'percentage';
+/** @deprecated Use `SplitusCurrencyCode` from the Splitus bill contract. */
 type CurrencyCode = 'EUR' | 'USD';
 /**
  * One participant's custom share for `exact-amount` / `percentage` split
  * modes. An omitted/empty `contactID` denotes the payer's own share. Ignored
  * (and may be omitted) for `equally`, which the backend computes itself.
  */
+/** @deprecated Use explicit paid and owed allocations in `ICreateSplitusBillV1Request`. */
 interface ISplitShare {
     readonly contactID?: string;
     /** Decimal string, e.g. "35.00" — required for `exact-amount`. */
@@ -16,6 +264,7 @@ interface ISplitShare {
     /** Decimal string, e.g. "33.34" — required for `percentage`. */
     readonly percent?: string;
 }
+/** @deprecated Use `ICreateSplitusBillV1Request`. */
 interface ICreateSplitRequest {
     readonly spaceID: string;
     readonly title?: string;
@@ -32,11 +281,13 @@ interface ICreateSplitRequest {
     /** Required for `exact-amount` / `percentage`; ignored for `equally`. */
     readonly shares?: ISplitShare[];
 }
+/** @deprecated Use `ISplitusDebtusObligationV1`. */
 interface ICreateSplitTransfer {
     readonly id: string;
     readonly contactID: string;
     readonly amount: number;
 }
+/** @deprecated Use `ICreateSplitusBillV1Response`. */
 interface ICreateSplitResponse {
     readonly id: string;
     /**
@@ -49,7 +300,9 @@ interface ICreateSplitResponse {
  * "settled" or "outstanding", derived server-side by reading the linked
  * Debtus transfers — never computed or cached on the client.
  */
+/** @deprecated Use `SplitusDebtusSettlementStatus`. */
 type SplitShareStatus = 'settled' | 'outstanding';
+/** @deprecated Use `ISplitusBillAllocationV1`. */
 interface ISplitParticipant {
     readonly contactID?: string;
     readonly userID?: string;
@@ -58,6 +311,7 @@ interface ISplitParticipant {
     readonly isPayer?: boolean;
     readonly status: SplitShareStatus;
 }
+/** @deprecated Use `ISplitusBillV1`. */
 interface ISplit {
     readonly id: string;
     readonly title?: string;
@@ -66,6 +320,7 @@ interface ISplit {
     readonly status: string;
     readonly participants: ISplitParticipant[];
 }
+/** @deprecated Use `ISplitusBillListItemV1`. */
 interface ISplitListItem {
     readonly id: string;
     readonly title?: string;
@@ -75,6 +330,7 @@ interface ISplitListItem {
     readonly membersCount: number;
 }
 
+/** @deprecated Use `ISplitusBillServiceV1`. */
 interface ISplitusService {
     /** REAL: POST /api4splitus/create-split. Payer is the authenticated user. */
     createSplit(request: ICreateSplitRequest): Observable<ICreateSplitResponse>;
@@ -83,7 +339,14 @@ interface ISplitusService {
     /** REAL: GET /api4splitus/splits?spaceID= */
     getSplits(spaceID: string): Observable<ISplitListItem[]>;
 }
+/** @deprecated Use `SPLITUS_BILL_SERVICE_V1`. */
 declare const SPLITUS_SERVICE: InjectionToken<ISplitusService>;
+interface ISplitusBillServiceV1 {
+    createBill(request: ICreateSplitusBillV1Request): Observable<ICreateSplitusBillV1Response>;
+    getBill(request: IGetSplitusBillV1Request): Observable<IGetSplitusBillV1Response>;
+    listBills(request: IListSplitusBillsV1Request): Observable<IListSplitusBillsV1Response>;
+}
+declare const SPLITUS_BILL_SERVICE_V1: InjectionToken<ISplitusBillServiceV1>;
 
-export { SPLITUS_SERVICE };
-export type { CurrencyCode, ICreateSplitRequest, ICreateSplitResponse, ICreateSplitTransfer, ISplit, ISplitListItem, ISplitParticipant, ISplitShare, ISplitusService, SplitMode, SplitShareStatus };
+export { MAX_SPLITUS_BILL_LIST_PAGE_SIZE, MAX_SPLITUS_BILL_OBLIGATIONS, MAX_SPLITUS_BILL_PARTICIPANTS, MAX_SPLITUS_OBLIGATION_IDS_PER_LINE, SPLITUS_BILL_CONTRACT_VERSION, SPLITUS_BILL_SERVICE_V1, SPLITUS_SERVICE, assertCreateSplitusBillV1Recorder, parseCreateSplitusBillV1Request, parseCreateSplitusBillV1Response, parseExactDecimalString, parseGetSplitusBillV1Request, parseGetSplitusBillV1Response, parseListSplitusBillsV1Request, parseListSplitusBillsV1Response, parseSplitusBillV1 };
+export type { CurrencyCode, ExactDecimalString, ICreateSplitRequest, ICreateSplitResponse, ICreateSplitTransfer, ICreateSplitusBillV1Request, ICreateSplitusBillV1Response, IGetSplitusBillV1Request, IGetSplitusBillV1Response, IListSplitusBillsV1Request, IListSplitusBillsV1Response, ISplit, ISplitListItem, ISplitParticipant, ISplitShare, ISplitusBillAllocationV1, ISplitusBillListItemV1, ISplitusBillPostingReceiptV1, ISplitusBillPostingV1, ISplitusBillServiceV1, ISplitusBillV1, ISplitusBillingPeriodV1, ISplitusDebtusObligationV1, ISplitusDebtusReceiptLineV1, ISplitusDebtusSettlementTargetV1, ISplitusDebtusStatusV1, ISplitusPreviousComparableBillV1, ISplitusRecurringOccurrenceV1, ISplitusResolvedSourceEffectV1, ISplitusService, ISplitusSourceAttributionV1, ISplitusSourceContactLinkV1, ISplitusUtilityDetailsV1, SplitMode, SplitShareStatus, SplitusBillAttentionCode, SplitusBillContractVersion, SplitusBillKind, SplitusBillPostingStatus, SplitusCurrencyCode, SplitusDebtusSettlementStatus, SplitusExpectedActualComparison, SplitusResolvedSourceDirection, SplitusResolvedSourceTemporalBasis, SplitusUtilityKind };