@yigemo/choosefire 0.1.0

package/dist/financial-workspace-contracts.js

@@ -0,0 +1,282 @@
+import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const Ajv2020 = require('ajv/dist/2020').default;
+const addFormats = require('ajv-formats').default;
+const fieldRegistry = readContractJson('field-registry.generated.json');
+const runtimeSchema = readContractJson('runtime-schemas/financial-workspace.v1.schema.json');
+export const CHOOSEFIRE_FINANCIAL_WORKSPACE_CONTRACT_ID = 'choosefire-financial-workspace.v1';
+export const CHOOSEFIRE_FINANCIAL_WORKSPACE_CONTRACT_VERSION = 1;
+export const CHOOSEFIRE_FINANCIAL_WORKSPACE_REGISTRY_SHA256 = '3ecc94b8fee854c4a1012a79de1216007191c853b62fbf99641a1f9aadde2b16';
+export const CHOOSEFIRE_FINANCIAL_WORKSPACE_AGGREGATE_SHA256 = '9fed00d6103aab4ac183855bb1fb7e96767dbcb2b9ef8e6651dd5ff38798bad1';
+function readContractJson(relativePath) {
+    return JSON.parse(readFileSync(new URL(`../contracts/choosefire-financial-workspace/v1/${relativePath}`, import.meta.url), 'utf8'));
+}
+export class AccountFinancialWorkspaceRemoteResponseInvalidError extends Error {
+    validationErrors;
+    code = 'REMOTE_RESPONSE_INVALID';
+    classification = 'REMOTE_RESPONSE_INVALID';
+    constructor(validationErrors) {
+        super('The account financial workspace response does not match the approved contract.');
+        this.validationErrors = validationErrors;
+        this.name = 'AccountFinancialWorkspaceRemoteResponseInvalidError';
+    }
+}
+const validators = createValidators();
+export function validateAccountFinancialWorkspaceSchema(schemaName, input) {
+    const validator = validators.get(schemaName);
+    if (!validator)
+        return { valid: false, errors: [`unknown schema ${schemaName}`] };
+    if (!validator(input)) {
+        return { valid: false, errors: formatAjvErrors(validator.errors) };
+    }
+    const invariantErrors = validateSemanticInvariants(schemaName, input);
+    return invariantErrors.length === 0
+        ? { valid: true }
+        : { valid: false, errors: invariantErrors };
+}
+export function parseAccountFinancialWorkspaceHttpResponse(httpStatus, input, successSchemaName) {
+    return parseAccountFinancialWorkspaceHttpResponseInternal(httpStatus, input, successSchemaName);
+}
+const SUCCESS_ENVELOPE_SCHEMA_NAMES = new Set([
+    'SuccessEnvelopeFinancialWorkspaceCommandReceiptV1',
+    'SuccessEnvelopeFinancialWorkspaceSnapshotV1',
+    'SuccessEnvelopeFinancialWorkspaceSummaryV1',
+    'SuccessEnvelopeFinancialWorkspaceActivityPageV1',
+]);
+const ERROR_SCHEMA_BY_HTTP_STATUS = {
+    400: 'ErrorEnvelope400V1',
+    401: 'ErrorEnvelope401V1',
+    403: 'ErrorEnvelope403V1',
+    404: 'ErrorEnvelope404V1',
+    409: 'ErrorEnvelope409V1',
+    410: 'ErrorEnvelope410V1',
+    413: 'ErrorEnvelope413V1',
+    415: 'ErrorEnvelope415V1',
+    503: 'ErrorEnvelope503V1',
+};
+function parseAccountFinancialWorkspaceHttpResponseInternal(httpStatus, input, successSchemaName) {
+    let schemaName;
+    if (httpStatus === 200) {
+        if (successSchemaName === undefined
+            || !SUCCESS_ENVELOPE_SCHEMA_NAMES.has(successSchemaName)) {
+            throw new AccountFinancialWorkspaceRemoteResponseInvalidError([
+                'HTTP 200 requires an approved financial workspace success envelope schema',
+            ]);
+        }
+        schemaName = successSchemaName;
+    }
+    else {
+        if (successSchemaName !== undefined) {
+            throw new AccountFinancialWorkspaceRemoteResponseInvalidError([
+                'non-200 responses select their error envelope schema from HTTP status',
+            ]);
+        }
+        if (!isAccountFinancialWorkspaceErrorHttpStatus(httpStatus)) {
+            throw new AccountFinancialWorkspaceRemoteResponseInvalidError([
+                `unsupported financial workspace HTTP status ${httpStatus}`,
+            ]);
+        }
+        schemaName = ERROR_SCHEMA_BY_HTTP_STATUS[httpStatus];
+    }
+    return parseAccountFinancialWorkspaceApprovedSchema(schemaName, input);
+}
+function parseAccountFinancialWorkspaceApprovedSchema(schemaName, input) {
+    const result = validateAccountFinancialWorkspaceSchema(schemaName, input);
+    if (!result.valid) {
+        throw new AccountFinancialWorkspaceRemoteResponseInvalidError(result.errors);
+    }
+    return structuredClone(input);
+}
+function isAccountFinancialWorkspaceErrorHttpStatus(httpStatus) {
+    return Object.hasOwn(ERROR_SCHEMA_BY_HTTP_STATUS, httpStatus);
+}
+export function normalizeAccountFinancialWorkspaceCommand(schemaName, input) {
+    const result = validateAccountFinancialWorkspaceSchema(schemaName, input);
+    if (!result.valid)
+        throw new TypeError(result.errors.join('; '));
+    if (schemaName === 'InitializeFinancialWorkspaceCommandV1') {
+        return structuredClone(input);
+    }
+    const command = input;
+    const normalized = {
+        ...structuredClone(command),
+        value: {
+            ...structuredClone(command.value),
+            currency: command.value.currency.trim().toUpperCase(),
+        },
+        status: command.status ?? 'confirmed',
+        asOf: command.asOf === undefined ? null : new Date(command.asOf).toISOString(),
+    };
+    const normalizedResult = validateAccountFinancialWorkspaceSchema('NormalizedFinancialWorkspaceFactRecordCommandV1', normalized);
+    if (!normalizedResult.valid) {
+        throw new TypeError(normalizedResult.errors.join('; '));
+    }
+    return normalized;
+}
+function createValidators() {
+    const ajv = new Ajv2020({
+        strict: true,
+        allErrors: true,
+        coerceTypes: false,
+        removeAdditional: false,
+        useDefaults: false,
+        validateFormats: true,
+    });
+    addFormats(ajv, { mode: 'full' });
+    ajv.addFormat('choosefire-money-v1', {
+        type: 'string',
+        validate: isCanonicalMoney,
+    });
+    ajv.addSchema(runtimeSchema);
+    return new Map(Object.keys(runtimeSchema.$defs).map((name) => [
+        name,
+        ajv.compile({ $ref: `${runtimeSchema.$id}#/$defs/${name}` }),
+    ]));
+}
+function validateSemanticInvariants(schemaName, input) {
+    const errors = [];
+    const record = input;
+    const coverageValues = [];
+    if (schemaName === 'ProjectionCoverageV1')
+        coverageValues.push(record);
+    if (schemaName === 'FinancialWorkspaceSnapshotV1') {
+        coverageValues.push(record.currentFacts.coverage);
+        const fields = record.currentFacts.items.map((item) => item.field);
+        if (!sameArray(fields, record.currentFacts.coverage.recordedFields)) {
+            errors.push('snapshot facts must exactly match recordedFields order');
+        }
+        if (record.currentFacts.items.some((item) => item.recordedVersion > record.version)) {
+            errors.push('snapshot fact version exceeds workspace version');
+        }
+    }
+    if (schemaName === 'FinancialWorkspaceSummaryV1') {
+        coverageValues.push(record.currentFacts);
+    }
+    if (schemaName.startsWith('SuccessEnvelope')) {
+        return validateSemanticInvariants(schemaName.replace(/^SuccessEnvelope/, ''), record.data);
+    }
+    for (const coverage of coverageValues) {
+        const supported = fieldRegistry.fields.map((field) => field.field);
+        const recorded = coverage.recordedFields;
+        const missing = coverage.missingFields;
+        if (!sameArray(coverage.supportedFields, supported)) {
+            errors.push('coverage supportedFields must equal registry order');
+        }
+        if (!isRegistryOrdered(recorded, supported) || !isRegistryOrdered(missing, supported)) {
+            errors.push('coverage fields must preserve registry order');
+        }
+        if (recorded.some((field) => missing.includes(field))
+            || !sameArray(supported, supported.filter((field) => recorded.includes(field) || missing.includes(field)))) {
+            errors.push('coverage recorded/missing fields must partition supportedFields');
+        }
+    }
+    const operations = [];
+    if (schemaName === 'OperationProjectionV1')
+        operations.push({ operation: record });
+    if (schemaName === 'FinancialWorkspaceCommandReceiptV1') {
+        operations.push({
+            operation: record.operation,
+            authorityStoreId: record.authority.storeId,
+        });
+        if (record.baseVersion !== record.operation.baseVersion
+            || record.resultVersion !== record.operation.resultVersion
+            || record.committedAt !== record.operation.committedAt) {
+            errors.push('receipt outer fields must equal nested operation');
+        }
+    }
+    if (schemaName === 'FinancialWorkspaceActivityPageV1') {
+        operations.push(...record.items.map((operation) => ({
+            operation,
+            authorityStoreId: record.authority.storeId,
+        })));
+        for (let index = 1; index < record.items.length; index += 1) {
+            if (record.items[index].resultVersion
+                !== record.items[index - 1].resultVersion + 1) {
+                errors.push('activity result versions must be contiguous');
+            }
+        }
+        if (record.items.some((item) => item.resultVersion > record.throughVersion)) {
+            errors.push('activity item exceeds throughVersion');
+        }
+        if (record.items.length === 0 && record.hasMore) {
+            errors.push('empty activity page cannot have more items');
+        }
+        if (record.items.length > 0) {
+            const lastVersion = record.items.at(-1).resultVersion;
+            if (record.hasMore
+                ? lastVersion >= record.throughVersion
+                : lastVersion !== record.throughVersion) {
+                errors.push('activity hasMore must match throughVersion');
+            }
+        }
+    }
+    for (const { operation, authorityStoreId } of operations) {
+        if (operation.resultVersion !== operation.baseVersion + 1) {
+            errors.push('operation must advance exactly one version');
+        }
+        if (!operation.affectedObjects.some((item) => deepEqual(item, operation.primaryObject))) {
+            errors.push('affectedObjects must contain primaryObject');
+        }
+        if (operation.operation === 'workspace.initialize') {
+            if (operation.baseVersion !== 0
+                || operation.resultVersion !== 1
+                || operation.primaryObject.kind !== 'financial_workspace_workspace_ref.v1'
+                || operation.affectedObjects.length !== 1) {
+                errors.push('initialize operation refs are invalid');
+            }
+        }
+        else if (operation.baseVersion < 1
+            || operation.primaryObject.kind !== 'financial_workspace_fact_ref.v1'
+            || operation.affectedObjects.length !== 2
+            || operation.affectedObjects[0].kind !== 'financial_workspace_fact_ref.v1'
+            || operation.affectedObjects[1].kind !== 'financial_workspace_workspace_ref.v1') {
+            errors.push('fact operation refs are invalid');
+        }
+        if (authorityStoreId !== undefined) {
+            const workspaceRefs = [operation.primaryObject, ...operation.affectedObjects].filter((objectRef) => objectRef.kind === 'financial_workspace_workspace_ref.v1');
+            if (workspaceRefs.length === 0
+                || workspaceRefs.some((objectRef) => objectRef.storeId !== authorityStoreId)) {
+                errors.push('operation workspace refs must match authority storeId');
+            }
+        }
+    }
+    return errors;
+}
+function isCanonicalMoney(value) {
+    const definition = fieldRegistry.fields[0];
+    if (!/^(?:0|[1-9]\d*)(?:\.\d*[1-9])?$/.test(value))
+        return false;
+    const [integer, fraction = ''] = value.split('.');
+    if (fraction.length > definition.scale)
+        return false;
+    const maximumInteger = definition.maximum.split('.')[0];
+    if (integer.length !== maximumInteger.length) {
+        return integer.length < maximumInteger.length;
+    }
+    const comparison = integer.localeCompare(maximumInteger);
+    return comparison < 0 || (comparison === 0 && fraction.length === 0);
+}
+function formatAjvErrors(errors) {
+    return (errors ?? []).map((error) => `${error.instancePath || '/'} ${error.message ?? 'is invalid'}`);
+}
+function isRegistryOrdered(values, supported) {
+    return sameArray(values, supported.filter((field) => values.includes(field)));
+}
+function sameArray(left, right) {
+    return left.length === right.length
+        && left.every((value, index) => value === right[index]);
+}
+function deepEqual(left, right) {
+    return JSON.stringify(sortJson(left)) === JSON.stringify(sortJson(right));
+}
+function sortJson(value) {
+    if (Array.isArray(value))
+        return value.map(sortJson);
+    if (!value || typeof value !== 'object')
+        return value;
+    return Object.fromEntries(Object.keys(value)
+        .sort((left, right) => Buffer.compare(Buffer.from(left), Buffer.from(right)))
+        .map((key) => [key, sortJson(value[key])]));
+}
+//# sourceMappingURL=financial-workspace-contracts.js.map

package/dist/financial-workspace-contracts.js.map

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

package/dist/http.d.ts

@@ -0,0 +1,76 @@
+import { type AccountFinancialWorkspaceActivityPage, type AccountFinancialWorkspaceCommandReceipt, type AccountFinancialWorkspaceErrorCode, type AccountFinancialWorkspaceErrorEnvelope, type AccountFinancialWorkspaceErrorHttpStatus, type AccountFinancialWorkspaceSnapshot, type AccountFinancialWorkspaceSummary, type InitializeAccountFinancialWorkspaceCommand, type RecordAccountFinancialWorkspaceFactCommand } from './financial-workspace-contracts.js';
+import type { CliConfig, RequestOptions, WorkspaceScope } from './types.js';
+declare const FINANCIAL_WORKSPACE_PATH = "/choosefire/financial-workspace";
+export type AccountFinancialWorkspaceActivityQuery = {
+    limit: number;
+    cursor?: string;
+};
+export type AccountFinancialWorkspaceMutationRecovery = {
+    kind: 'financial_workspace_mutation_recovery.v1';
+    action: 'retry_exact_command';
+    guidance: 'Read the latest snapshot, then explicitly retry the exact serialized body with the original idempotency key. Do not generate a new key.';
+    path: typeof FINANCIAL_WORKSPACE_PATH | `${typeof FINANCIAL_WORKSPACE_PATH}/facts`;
+    command: InitializeAccountFinancialWorkspaceCommand | RecordAccountFinancialWorkspaceFactCommand;
+    idempotencyKey: string;
+    serializedBody: string;
+};
+export type AccountFinancialWorkspaceHttpOptions = {
+    fetch?: typeof fetch;
+    timeoutMs?: number;
+    now?: () => number;
+};
+export declare class ChooseFireHttpError extends Error {
+    readonly status: number;
+    readonly payload: unknown;
+    readonly code: string;
+    constructor(message: string, status: number, payload: unknown, code?: string);
+}
+export declare class AccountFinancialWorkspaceDisabledError extends Error {
+    readonly code: "ACCOUNT_WORKSPACE_DISABLED";
+    constructor();
+}
+export declare class AccountFinancialWorkspaceAuthRequiredError extends Error {
+    readonly recovery?: AccountFinancialWorkspaceMutationRecovery | undefined;
+    readonly code: "AUTH_REQUIRED";
+    constructor(recovery?: AccountFinancialWorkspaceMutationRecovery | undefined);
+}
+export declare class AccountFinancialWorkspaceScopeRequiredError extends Error {
+    readonly requiredScope: WorkspaceScope;
+    readonly recovery?: AccountFinancialWorkspaceMutationRecovery | undefined;
+    readonly code: "ACCOUNT_SCOPE_REQUIRED";
+    constructor(requiredScope: WorkspaceScope, recovery?: AccountFinancialWorkspaceMutationRecovery | undefined);
+}
+export declare class AccountFinancialWorkspaceHttpError extends Error {
+    readonly status: AccountFinancialWorkspaceErrorHttpStatus;
+    readonly code: AccountFinancialWorkspaceErrorCode;
+    readonly data: AccountFinancialWorkspaceErrorEnvelope['error']['data'];
+    readonly requestId?: string | undefined;
+    readonly recovery?: AccountFinancialWorkspaceMutationRecovery | undefined;
+    readonly name = "AccountFinancialWorkspaceHttpError";
+    constructor(status: AccountFinancialWorkspaceErrorHttpStatus, code: AccountFinancialWorkspaceErrorCode, data: AccountFinancialWorkspaceErrorEnvelope['error']['data'], requestId?: string | undefined, recovery?: AccountFinancialWorkspaceMutationRecovery | undefined);
+}
+export declare class AccountFinancialWorkspaceRemoteUnavailableError extends Error {
+    readonly code: "REMOTE_UNAVAILABLE";
+    constructor();
+}
+export declare class AccountFinancialWorkspaceRemoteResponseInvalidClientError extends Error {
+    readonly validationErrors: string[];
+    readonly recovery?: AccountFinancialWorkspaceMutationRecovery | undefined;
+    readonly code: "REMOTE_RESPONSE_INVALID";
+    constructor(validationErrors: string[], recovery?: AccountFinancialWorkspaceMutationRecovery | undefined);
+}
+export declare class AccountFinancialWorkspaceRemoteOutcomeUnknownError extends Error {
+    readonly recovery: AccountFinancialWorkspaceMutationRecovery;
+    readonly code: "REMOTE_OUTCOME_UNKNOWN";
+    readonly command: AccountFinancialWorkspaceMutationRecovery['command'];
+    readonly idempotencyKey: string;
+    readonly serializedBody: string;
+    constructor(recovery: AccountFinancialWorkspaceMutationRecovery);
+}
+export declare function requestChooseFire<T>(config: CliConfig, path: string, options?: RequestOptions): Promise<T>;
+export declare function initializeAccountFinancialWorkspace(config: CliConfig, command: InitializeAccountFinancialWorkspaceCommand, options?: AccountFinancialWorkspaceHttpOptions): Promise<AccountFinancialWorkspaceCommandReceipt>;
+export declare function getAccountFinancialWorkspaceSnapshot(config: CliConfig, options?: AccountFinancialWorkspaceHttpOptions): Promise<AccountFinancialWorkspaceSnapshot>;
+export declare function getAccountFinancialWorkspaceSummary(config: CliConfig, options?: AccountFinancialWorkspaceHttpOptions): Promise<AccountFinancialWorkspaceSummary>;
+export declare function getAccountFinancialWorkspaceActivity(config: CliConfig, query: AccountFinancialWorkspaceActivityQuery, options?: AccountFinancialWorkspaceHttpOptions): Promise<AccountFinancialWorkspaceActivityPage>;
+export declare function recordAccountFinancialWorkspaceFact(config: CliConfig, command: RecordAccountFinancialWorkspaceFactCommand, options?: AccountFinancialWorkspaceHttpOptions): Promise<AccountFinancialWorkspaceCommandReceipt>;
+export {};