@yigemo/choosefire 0.1.0

package/dist/family-wealth-v2-http.js

@@ -0,0 +1,340 @@
+import { FamilyWealthV2ResponseInvalidError, parseFamilyWealthV2Error, parseFamilyWealthV2Success, validateFamilyWealthV2, } from './family-wealth-v2-contracts.js';
+const ROOT = '/choosefire/v2/workspace';
+const MAX_RESPONSE_BYTES = 1024 * 1024;
+export class FamilyWealthV2DisabledError extends Error {
+    code = 'FAMILY_WEALTH_V2_DISABLED';
+    constructor() {
+        super('ChooseFIRE family wealth v2 is disabled.');
+        this.name = 'FamilyWealthV2DisabledError';
+    }
+}
+export class FamilyWealthV2AuthRequiredError extends Error {
+    code = 'AUTH_REQUIRED';
+    constructor() {
+        super('ChooseFIRE workspace authentication is required.');
+        this.name = 'FamilyWealthV2AuthRequiredError';
+    }
+}
+export class FamilyWealthV2ScopeRequiredError extends Error {
+    requiredScope;
+    code = 'ACCOUNT_SCOPE_REQUIRED';
+    constructor(requiredScope) {
+        super(`The workspace credential requires ${requiredScope}.`);
+        this.requiredScope = requiredScope;
+        this.name = 'FamilyWealthV2ScopeRequiredError';
+    }
+}
+export class FamilyWealthV2HttpError extends Error {
+    status;
+    code;
+    data;
+    requestId;
+    constructor(status, code, message, data, requestId) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.data = data;
+        this.requestId = requestId;
+        this.name = 'FamilyWealthV2HttpError';
+    }
+}
+export class FamilyWealthV2RemoteUnavailableError extends Error {
+    code = 'REMOTE_UNAVAILABLE';
+    constructor() {
+        super('ChooseFIRE family wealth v2 is unavailable.');
+        this.name = 'FamilyWealthV2RemoteUnavailableError';
+    }
+}
+export class FamilyWealthV2RemoteOutcomeUnknownError extends Error {
+    command;
+    code = 'REMOTE_OUTCOME_UNKNOWN';
+    recovery;
+    constructor(command) {
+        super('The initialization outcome is unknown; retry the exact command with the same keys.');
+        this.command = command;
+        this.name = 'FamilyWealthV2RemoteOutcomeUnknownError';
+        this.recovery = {
+            action: 'retry_exact_command',
+            command: structuredClone(command),
+        };
+    }
+}
+export async function initializeFamilyWealthV2(config, command, options = {}) {
+    const validation = validateFamilyWealthV2('WorkspaceInitializeCommandV2', command);
+    if (!validation.valid)
+        throw new TypeError(validation.errors.join('; '));
+    try {
+        return await requestFamilyWealthV2(config, {
+            method: 'POST',
+            path: ROOT,
+            scope: 'workspace:initialize',
+            successSchema: 'WorkspaceInitializeSuccessV2',
+            body: JSON.stringify(command),
+        }, options);
+    }
+    catch (error) {
+        if (error instanceof FamilyWealthV2RemoteUnavailableError ||
+            error instanceof FamilyWealthV2ResponseInvalidError) {
+            throw new FamilyWealthV2RemoteOutcomeUnknownError(structuredClone(command));
+        }
+        throw error;
+    }
+}
+export function getFamilyWealthV2Summary(config, options = {}) {
+    return requestFamilyWealthV2(config, {
+        method: 'GET',
+        path: `${ROOT}/summary`,
+        scope: 'workspace:read',
+        successSchema: 'WorkspaceSummarySuccessV2',
+    }, options);
+}
+export function getFamilyWealthV2Activity(config, query, options = {}) {
+    const validation = validateFamilyWealthV2('ActivityPageQueryV2', query);
+    if (!validation.valid)
+        throw new TypeError(validation.errors.join('; '));
+    const search = new URLSearchParams({ limit: String(query.limit) });
+    if (query.cursor !== undefined)
+        search.set('cursor', query.cursor);
+    return requestFamilyWealthV2(config, {
+        method: 'GET',
+        path: `${ROOT}/activity?${search}`,
+        scope: 'workspace:read',
+        successSchema: 'ActivityPageSuccessV2',
+    }, options);
+}
+export async function createFamilyWealthV2AssetAccount(config, command, options = {}) {
+    return requestMutation(config, command, {
+        method: 'POST',
+        path: `${ROOT}/asset-accounts`,
+        scope: 'workspace:write:fact',
+        successSchema: 'CommandSuccessV2',
+        body: JSON.stringify(command),
+    }, options);
+}
+export async function updateFamilyWealthV2AssetAccount(config, command, options = {}) {
+    return requestMutation(config, command, {
+        method: 'PUT',
+        path: `${ROOT}/asset-accounts`,
+        scope: 'workspace:write:fact',
+        successSchema: 'CommandSuccessV2',
+        body: JSON.stringify(command),
+    }, options);
+}
+export async function archiveFamilyWealthV2AssetAccount(config, command, options = {}) {
+    return requestMutation(config, command, {
+        method: 'POST',
+        path: `${ROOT}/asset-accounts/archive`,
+        scope: 'workspace:write:fact',
+        successSchema: 'CommandSuccessV2',
+        body: JSON.stringify(command),
+    }, options);
+}
+export async function appendFamilyWealthV2Valuation(config, command, options = {}) {
+    return requestMutation(config, command, {
+        method: 'POST',
+        path: `${ROOT}/valuations`,
+        scope: 'workspace:write:fact',
+        successSchema: 'CommandSuccessV2',
+        body: JSON.stringify(command),
+    }, options);
+}
+export async function replaceFamilyWealthV2Classification(config, command, options = {}) {
+    return requestMutation(config, command, {
+        method: 'PUT',
+        path: `${ROOT}/classifications`,
+        scope: 'workspace:write:fact',
+        successSchema: 'CommandSuccessV2',
+        body: JSON.stringify(command),
+    }, options);
+}
+export function getFamilyWealthV2Overview(config, options = {}) {
+    return requestFamilyWealthV2(config, {
+        method: 'GET',
+        path: `${ROOT}/overview`,
+        scope: 'workspace:read',
+        successSchema: 'WorkspaceOverviewSuccessV2',
+    }, options);
+}
+export async function issueFamilyWealthV2McpDelegation(config, input, options = {}) {
+    const validation = validateFamilyWealthV2('McpDelegationIssueRequestV2', input);
+    if (!validation.valid)
+        throw new TypeError(validation.errors.join('; '));
+    const payload = await requestMcpJson(config, {
+        method: 'POST',
+        path: `${ROOT}/mcp/delegation`,
+        body: JSON.stringify(input),
+    }, options);
+    const result = validateFamilyWealthV2('McpDelegatedTokenCredentialV2', payload);
+    if (!result.valid)
+        throw new FamilyWealthV2ResponseInvalidError(result.errors);
+    return payload;
+}
+export async function revokeFamilyWealthV2McpDelegation(config, accessToken, options = {}) {
+    const input = { accessToken };
+    const validation = validateFamilyWealthV2('McpDelegationRevokeRequestV2', input);
+    if (!validation.valid)
+        throw new TypeError(validation.errors.join('; '));
+    const payload = await requestMcpJson(config, {
+        method: 'POST',
+        path: `${ROOT}/mcp/delegation/revoke`,
+        body: JSON.stringify(input),
+    }, options);
+    const result = validateFamilyWealthV2('McpDelegationRevokeResponseV2', payload);
+    if (!result.valid)
+        throw new FamilyWealthV2ResponseInvalidError(result.errors);
+    return payload;
+}
+async function requestMutation(config, command, definition, options) {
+    const schemaName = command.kind === 'asset_account.create.v2'
+        ? 'AssetAccountCreateCommandV2'
+        : command.kind === 'asset_account.update.v2'
+            ? 'AssetAccountUpdateCommandV2'
+            : command.kind === 'asset_account.archive.v2'
+                ? 'AssetAccountArchiveCommandV2'
+                : command.kind === 'valuation_snapshot.append.v2'
+                    ? 'ValuationSnapshotAppendCommandV2'
+                    : 'ClassificationReplaceCommandV2';
+    const validation = validateFamilyWealthV2(schemaName, command);
+    if (!validation.valid)
+        throw new TypeError(validation.errors.join('; '));
+    try {
+        return await requestFamilyWealthV2(config, definition, options);
+    }
+    catch (error) {
+        if (error instanceof FamilyWealthV2RemoteUnavailableError || error instanceof FamilyWealthV2ResponseInvalidError) {
+            throw new FamilyWealthV2RemoteOutcomeUnknownError(structuredClone(command));
+        }
+        throw error;
+    }
+}
+async function requestFamilyWealthV2(config, definition, options) {
+    const credential = requireCredential(config, definition.scope, options.now ?? Date.now);
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), normalizeTimeout(options.timeoutMs));
+    let response;
+    try {
+        response = await (options.fetch ?? fetch)(`${config.apiBaseUrl}${definition.path}`, {
+            method: definition.method,
+            redirect: 'error',
+            signal: controller.signal,
+            headers: {
+                accept: 'application/json',
+                authorization: `Bearer ${credential.accessToken}`,
+                ...(definition.body === undefined
+                    ? {}
+                    : { 'content-type': 'application/json' }),
+            },
+            body: definition.body,
+        });
+    }
+    catch {
+        throw new FamilyWealthV2RemoteUnavailableError();
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+    if (mediaType(response.headers.get('content-type')) !== 'application/json') {
+        throw new FamilyWealthV2ResponseInvalidError([
+            'response media type must be application/json',
+        ]);
+    }
+    const text = await response.text();
+    if (Buffer.byteLength(text, 'utf8') > MAX_RESPONSE_BYTES) {
+        throw new FamilyWealthV2ResponseInvalidError(['response body is too large']);
+    }
+    let payload;
+    try {
+        payload = JSON.parse(text);
+    }
+    catch {
+        throw new FamilyWealthV2ResponseInvalidError([
+            'response body must be valid JSON',
+        ]);
+    }
+    if (response.status === 200) {
+        return parseFamilyWealthV2Success(payload, definition.successSchema);
+    }
+    if (![400, 401, 403, 404, 409, 410, 503].includes(response.status)) {
+        throw new FamilyWealthV2ResponseInvalidError([
+            `HTTP ${response.status} is not approved for family wealth v2`,
+        ]);
+    }
+    const error = parseFamilyWealthV2Error(payload);
+    throw new FamilyWealthV2HttpError(response.status, error.code, error.error.message, error.error.data, error.error.requestId);
+}
+async function requestMcpJson(config, definition, options) {
+    const credential = requireCredential(config, 'workspace:read', options.now ?? Date.now);
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), normalizeTimeout(options.timeoutMs));
+    let response;
+    try {
+        response = await (options.fetch ?? fetch)(`${config.apiBaseUrl}${definition.path}`, {
+            method: definition.method,
+            redirect: 'error',
+            signal: controller.signal,
+            headers: {
+                accept: 'application/json',
+                'content-type': 'application/json',
+                authorization: `Bearer ${credential.accessToken}`,
+            },
+            body: definition.body,
+        });
+    }
+    catch {
+        throw new FamilyWealthV2RemoteUnavailableError();
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+    if (mediaType(response.headers.get('content-type')) !== 'application/json') {
+        throw new FamilyWealthV2ResponseInvalidError(['response media type must be application/json']);
+    }
+    const text = await response.text();
+    if (Buffer.byteLength(text, 'utf8') > MAX_RESPONSE_BYTES) {
+        throw new FamilyWealthV2ResponseInvalidError(['response body is too large']);
+    }
+    let payload;
+    try {
+        payload = JSON.parse(text);
+    }
+    catch {
+        throw new FamilyWealthV2ResponseInvalidError(['response body must be valid JSON']);
+    }
+    if (response.status === 200)
+        return payload;
+    if (![400, 401, 403, 404, 409, 503].includes(response.status)) {
+        throw new FamilyWealthV2ResponseInvalidError([
+            `HTTP ${response.status} is not approved for family wealth v2`,
+        ]);
+    }
+    const error = parseFamilyWealthV2Error(payload);
+    throw new FamilyWealthV2HttpError(response.status, error.code, error.error.message, error.error.data, error.error.requestId);
+}
+function requireCredential(config, scope, now) {
+    if (config.familyWealthV2Enabled !== true) {
+        throw new FamilyWealthV2DisabledError();
+    }
+    const credential = config.workspaceCredential;
+    if (!config.workspaceEnabled ||
+        !credential ||
+        credential.apiOrigin !== config.apiBaseUrl ||
+        credential.issuer !== config.accountsIssuer ||
+        credential.registeredClientId !== 'choosefire-cli' ||
+        Date.parse(credential.accessExpiresAt) <= now() + 60_000) {
+        throw new FamilyWealthV2AuthRequiredError();
+    }
+    if (!credential.scopes.includes(scope)) {
+        throw new FamilyWealthV2ScopeRequiredError(scope);
+    }
+    return credential;
+}
+function normalizeTimeout(value = 10_000) {
+    if (!Number.isSafeInteger(value) || value < 100 || value > 30_000) {
+        throw new TypeError('family wealth timeout must be 100-30000ms');
+    }
+    return value;
+}
+function mediaType(value) {
+    return value?.split(';', 1)[0].trim().toLowerCase() ?? '';
+}
+//# sourceMappingURL=family-wealth-v2-http.js.map

package/dist/family-wealth-v2-http.js.map

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

package/dist/financial-workspace-contracts.d.ts

@@ -0,0 +1,191 @@
+export declare const CHOOSEFIRE_FINANCIAL_WORKSPACE_CONTRACT_ID: "choosefire-financial-workspace.v1";
+export declare const CHOOSEFIRE_FINANCIAL_WORKSPACE_CONTRACT_VERSION: 1;
+export declare const CHOOSEFIRE_FINANCIAL_WORKSPACE_REGISTRY_SHA256: "3ecc94b8fee854c4a1012a79de1216007191c853b62fbf99641a1f9aadde2b16";
+export declare const CHOOSEFIRE_FINANCIAL_WORKSPACE_AGGREGATE_SHA256: "9fed00d6103aab4ac183855bb1fb7e96767dbcb2b9ef8e6651dd5ff38798bad1";
+export type AccountFinancialWorkspaceAuthority = {
+    mode: 'account';
+    storeId: string;
+    householdId: string;
+    status: 'authoritative';
+};
+export type AccountFinancialWorkspaceMoneyInput = {
+    kind: 'money.v1';
+    amount: string;
+    currency: string;
+};
+export type AccountFinancialWorkspaceMoney = {
+    kind: 'money.v1';
+    amount: string;
+    currency: string;
+};
+export type InitializeAccountFinancialWorkspaceCommand = {
+    kind: 'financial_workspace_initialize_command.v1';
+    idempotencyKey: string;
+};
+export type RecordAccountFinancialWorkspaceFactCommand = {
+    kind: 'financial_workspace_fact_record_command.v1';
+    expectedVersion: number;
+    idempotencyKey: string;
+    field: string;
+    value: AccountFinancialWorkspaceMoneyInput;
+    status?: 'confirmed' | 'estimated';
+    asOf?: string;
+};
+export type NormalizedRecordAccountFinancialWorkspaceFactCommand = Omit<RecordAccountFinancialWorkspaceFactCommand, 'value' | 'status' | 'asOf'> & {
+    value: AccountFinancialWorkspaceMoney;
+    status: 'confirmed' | 'estimated';
+    asOf: string | null;
+};
+export type AccountFinancialWorkspaceObjectRef = {
+    kind: 'financial_workspace_workspace_ref.v1';
+    storeId: string;
+} | {
+    kind: 'financial_workspace_fact_ref.v1';
+    factId: string;
+};
+export type AccountFinancialWorkspaceOperation = {
+    kind: 'financial_workspace_operation.v1';
+    operationId: string;
+    operation: 'workspace.initialize' | 'fact.record';
+    channel: 'web' | 'cli';
+    baseVersion: number;
+    resultVersion: number;
+    committedAt: string;
+    primaryObject: AccountFinancialWorkspaceObjectRef;
+    affectedObjects: AccountFinancialWorkspaceObjectRef[];
+};
+export type AccountFinancialWorkspaceCommandReceipt = {
+    kind: 'financial_workspace_command_receipt.v1';
+    authority: AccountFinancialWorkspaceAuthority;
+    operation: AccountFinancialWorkspaceOperation;
+    baseVersion: number;
+    resultVersion: number;
+    replayed: boolean;
+    cursor: string;
+    committedAt: string;
+};
+export type AccountFinancialWorkspaceCoverage = {
+    kind: 'financial_workspace_fact_coverage.v1';
+    supportedFields: string[];
+    recordedFields: string[];
+    missingFields: string[];
+};
+export type AccountFinancialWorkspaceFact = {
+    kind: 'financial_fact_projection.v1';
+    factId: string;
+    field: string;
+    value: AccountFinancialWorkspaceMoney;
+    status: 'confirmed' | 'estimated';
+    asOf: string;
+    recordedAt: string;
+    recordedVersion: number;
+};
+export type AccountFinancialWorkspaceCapabilities = {
+    kind: 'financial_workspace_capabilities.v1';
+    readable: ['snapshot', 'summary', 'activity'];
+    writable: ['fact.record'];
+    protectedChange: 'unavailable';
+};
+export type AccountFinancialWorkspaceSnapshot = {
+    kind: 'financial_workspace_snapshot.v1';
+    authority: AccountFinancialWorkspaceAuthority;
+    contractVersion: 1;
+    projectionVersion: 1;
+    version: number;
+    updatedAt: string;
+    cursor: string;
+    capabilities: AccountFinancialWorkspaceCapabilities;
+    currentFacts: {
+        items: AccountFinancialWorkspaceFact[];
+        coverage: AccountFinancialWorkspaceCoverage;
+    };
+};
+export type AccountFinancialWorkspaceSummary = {
+    kind: 'financial_workspace_summary.v1';
+    authority: AccountFinancialWorkspaceAuthority;
+    contractVersion: 1;
+    projectionVersion: 1;
+    version: number;
+    updatedAt: string;
+    cursor: string;
+    capabilities: AccountFinancialWorkspaceCapabilities;
+    currentFacts: AccountFinancialWorkspaceCoverage;
+};
+export type AccountFinancialWorkspaceActivityPage = {
+    kind: 'financial_workspace_activity_page.v1';
+    authority: AccountFinancialWorkspaceAuthority;
+    contractVersion: 1;
+    projectionVersion: 1;
+    throughVersion: number;
+    items: AccountFinancialWorkspaceOperation[];
+    nextCursor: string;
+    hasMore: boolean;
+};
+export type AccountFinancialWorkspaceSuccessEnvelope<T> = {
+    code: 0;
+    success: true;
+    status: 'success';
+    data: T;
+};
+export type AccountFinancialWorkspaceErrorCode = 'INVALID_HTTP_FRAMING' | 'INVALID_JSON' | 'VALIDATION_ERROR' | 'AUTH_REQUIRED' | 'ACCOUNT_SCOPE_REQUIRED' | 'CSRF_VALIDATION_FAILED' | 'WORKSPACE_NOT_INITIALIZED' | 'WORKSPACE_ALREADY_INITIALIZED' | 'WORKSPACE_AUTHORITY_MISMATCH' | 'VERSION_CONFLICT' | 'IDEMPOTENCY_CONFLICT' | 'PROTECTED_FACT_CHANGE_REQUIRES_PREVIEW' | 'CURSOR_EXPIRED' | 'PAYLOAD_TOO_LARGE' | 'UNSUPPORTED_MEDIA_TYPE' | 'TRANSACTION_RETRYABLE' | 'REMOTE_UNAVAILABLE';
+export type AccountFinancialWorkspaceErrorEnvelope = {
+    kind: 'financial_workspace_error.v1';
+    code: AccountFinancialWorkspaceErrorCode;
+    success: false;
+    status: 'error';
+    error: {
+        message: string;
+        requestId?: string;
+        data: Record<never, never> | {
+            currentVersion: number;
+            currentCursor: string;
+        } | {
+            recovery: 'read_snapshot';
+        } | {
+            retryAfterMs: number;
+        };
+    };
+};
+export type AccountFinancialWorkspaceSchemaMap = {
+    InitializeFinancialWorkspaceCommandV1: InitializeAccountFinancialWorkspaceCommand;
+    FinancialWorkspaceFactRecordCommandV1: RecordAccountFinancialWorkspaceFactCommand;
+    NormalizedFinancialWorkspaceFactRecordCommandV1: NormalizedRecordAccountFinancialWorkspaceFactCommand;
+    FinancialWorkspaceCommandReceiptV1: AccountFinancialWorkspaceCommandReceipt;
+    FinancialWorkspaceSnapshotV1: AccountFinancialWorkspaceSnapshot;
+    FinancialWorkspaceSummaryV1: AccountFinancialWorkspaceSummary;
+    FinancialWorkspaceActivityPageV1: AccountFinancialWorkspaceActivityPage;
+    SuccessEnvelopeFinancialWorkspaceCommandReceiptV1: AccountFinancialWorkspaceSuccessEnvelope<AccountFinancialWorkspaceCommandReceipt>;
+    SuccessEnvelopeFinancialWorkspaceSnapshotV1: AccountFinancialWorkspaceSuccessEnvelope<AccountFinancialWorkspaceSnapshot>;
+    SuccessEnvelopeFinancialWorkspaceSummaryV1: AccountFinancialWorkspaceSuccessEnvelope<AccountFinancialWorkspaceSummary>;
+    SuccessEnvelopeFinancialWorkspaceActivityPageV1: AccountFinancialWorkspaceSuccessEnvelope<AccountFinancialWorkspaceActivityPage>;
+    ErrorEnvelopeV1: AccountFinancialWorkspaceErrorEnvelope;
+    ErrorEnvelope400V1: AccountFinancialWorkspaceErrorEnvelope;
+    ErrorEnvelope401V1: AccountFinancialWorkspaceErrorEnvelope;
+    ErrorEnvelope403V1: AccountFinancialWorkspaceErrorEnvelope;
+    ErrorEnvelope404V1: AccountFinancialWorkspaceErrorEnvelope;
+    ErrorEnvelope409V1: AccountFinancialWorkspaceErrorEnvelope;
+    ErrorEnvelope410V1: AccountFinancialWorkspaceErrorEnvelope;
+    ErrorEnvelope413V1: AccountFinancialWorkspaceErrorEnvelope;
+    ErrorEnvelope415V1: AccountFinancialWorkspaceErrorEnvelope;
+    ErrorEnvelope503V1: AccountFinancialWorkspaceErrorEnvelope;
+};
+export type AccountFinancialWorkspaceSchemaName = keyof AccountFinancialWorkspaceSchemaMap;
+export type AccountFinancialWorkspaceSuccessEnvelopeSchemaName = 'SuccessEnvelopeFinancialWorkspaceCommandReceiptV1' | 'SuccessEnvelopeFinancialWorkspaceSnapshotV1' | 'SuccessEnvelopeFinancialWorkspaceSummaryV1' | 'SuccessEnvelopeFinancialWorkspaceActivityPageV1';
+export type AccountFinancialWorkspaceErrorHttpStatus = 400 | 401 | 403 | 404 | 409 | 410 | 413 | 415 | 503;
+export type AccountFinancialWorkspaceValidationResult = {
+    valid: true;
+} | {
+    valid: false;
+    errors: string[];
+};
+export declare class AccountFinancialWorkspaceRemoteResponseInvalidError extends Error {
+    readonly validationErrors: string[];
+    readonly code: "REMOTE_RESPONSE_INVALID";
+    readonly classification: "REMOTE_RESPONSE_INVALID";
+    constructor(validationErrors: string[]);
+}
+export declare function validateAccountFinancialWorkspaceSchema(schemaName: string, input: unknown): AccountFinancialWorkspaceValidationResult;
+export declare function parseAccountFinancialWorkspaceHttpResponse<SchemaName extends AccountFinancialWorkspaceSuccessEnvelopeSchemaName>(httpStatus: 200, input: unknown, successSchemaName: SchemaName): AccountFinancialWorkspaceSchemaMap[SchemaName];
+export declare function parseAccountFinancialWorkspaceHttpResponse(httpStatus: AccountFinancialWorkspaceErrorHttpStatus, input: unknown): AccountFinancialWorkspaceErrorEnvelope;
+export declare function normalizeAccountFinancialWorkspaceCommand(schemaName: 'InitializeFinancialWorkspaceCommandV1', input: unknown): InitializeAccountFinancialWorkspaceCommand;
+export declare function normalizeAccountFinancialWorkspaceCommand(schemaName: 'FinancialWorkspaceFactRecordCommandV1', input: unknown): NormalizedRecordAccountFinancialWorkspaceFactCommand;