@taxdao/fintax-mcp 0.2.0

package/dist/capabilities/definitions/extended-operations.js

@@ -0,0 +1,699 @@
+import { defineSuiteReadCapability, defineSuiteWriteCapability, } from '../define-capability.js';
+import { getExtendedOperationContract } from './extended-operation-contracts.js';
+function read(spec) {
+    const contract = getExtendedOperationContract(spec.id);
+    return defineSuiteReadCapability({
+        capabilityId: spec.id,
+        module: spec.module,
+        object: spec.object,
+        operation: spec.operation,
+        path: spec.path,
+        permissionAny: spec.permissions,
+        exposurePack: spec.pack,
+        requestSchema: contract.request,
+        responseSchema: contract.response,
+        requestAdapter: (input) => spec.adapt(input),
+    });
+}
+function write(spec) {
+    const contract = getExtendedOperationContract(spec.id);
+    return defineSuiteWriteCapability({
+        capabilityId: spec.id,
+        module: spec.module,
+        object: spec.object,
+        operation: spec.operation,
+        method: spec.method ?? 'POST',
+        path: spec.path,
+        permissionAny: spec.permissions,
+        exposurePack: spec.pack,
+        risk: spec.risk ?? 'R2',
+        sideEffect: spec.sideEffect ?? 'state_change',
+        idempotency: spec.idempotency ?? 'upstream-state',
+        requestSchema: contract.request,
+        responseSchema: contract.response,
+        requestAdapter: (input) => spec.adapt(input),
+    });
+}
+function path(key, parameter) {
+    return (input) => ({
+        pathParams: { [parameter]: String(input[key]) },
+    });
+}
+function bodyPath(key, parameter, body = (input) => input.body) {
+    return (input) => ({
+        pathParams: { [parameter]: String(input[key]) },
+        body: body(input),
+    });
+}
+const workflowCapabilities = [
+    write({
+        id: 'suite.acct.journal.verify_submit',
+        module: 'ACCT',
+        object: 'journal',
+        operation: 'verifyAndSubmit',
+        path: '/api/v1/accounting/journals/{id}/verify-and-submit',
+        permissions: ['accounting:journal:submit-approval'],
+        pack: 'workflow',
+        adapt: bodyPath('journal_id', 'id', (input) => ({
+            version: input.version,
+        })),
+    }),
+    write({
+        id: 'suite.acct.journal.batch_submit',
+        module: 'ACCT',
+        object: 'journal',
+        operation: 'submitApprovalBatch',
+        path: '/api/v1/accounting/journals/submit-approval:batch',
+        permissions: ['accounting:journal:submit-approval'],
+        pack: 'workflow',
+        adapt: (input) => ({ body: { journal_ids: input.journal_ids } }),
+    }),
+    ...['ap', 'ar'].flatMap((documentType) => {
+        const payable = documentType === 'ap';
+        const root = payable ? '/api/v1/ap/payable' : '/api/v1/ar/receivable';
+        const object = payable ? 'payable' : 'receivable';
+        const permission = payable ? 'ap:payable' : 'ar:receivable';
+        const idParameter = payable ? 'apHId' : 'arHId';
+        const idBodyKey = payable ? 'ap_h_ids' : 'ar_h_ids';
+        return [
+            write({
+                id: `suite.${documentType}.${object}.verify_submit`,
+                module: documentType.toUpperCase(),
+                object,
+                operation: 'verifyAndSubmit',
+                path: `${root}/{id}/verify-and-submit`,
+                permissions: [`${permission}:submit-approval`],
+                pack: 'workflow',
+                adapt: bodyPath('document_id', 'id', (input) => ({
+                    version: input.version,
+                })),
+            }),
+            write({
+                id: `suite.${documentType}.${object}.post`,
+                module: documentType.toUpperCase(),
+                object,
+                operation: 'post',
+                path: `${root}/post`,
+                permissions: [`${permission}:post`],
+                pack: 'workflow',
+                risk: 'R3',
+                adapt: (input) => ({ body: { [idBodyKey]: [input.document_id] } }),
+            }),
+            read({
+                id: `suite.${documentType}.${object}.offset_candidates`,
+                module: documentType.toUpperCase(),
+                object: `${object}_offset`,
+                operation: 'candidates',
+                path: `${root}/{${idParameter}}/offset-transactions/candidates`,
+                permissions: [`${permission}:offset:list`],
+                pack: 'workflow',
+                adapt: path('document_id', idParameter),
+            }),
+            read({
+                id: `suite.${documentType}.${object}.internal_offset_candidates`,
+                module: documentType.toUpperCase(),
+                object: `${object}_offset`,
+                operation: 'internalCandidates',
+                path: `${root}/{${idParameter}}/offset-transactions/internal-candidates`,
+                permissions: [`${permission}:offset:list`],
+                pack: 'workflow',
+                adapt: path('document_id', idParameter),
+            }),
+            write({
+                id: `suite.${documentType}.${object}.offset_apply`,
+                module: documentType.toUpperCase(),
+                object: `${object}_offset`,
+                operation: 'apply',
+                path: `${root}/{${idParameter}}/offset-transactions`,
+                permissions: [`${permission}:offset:apply`],
+                pack: 'workflow',
+                adapt: bodyPath('document_id', idParameter),
+            }),
+        ];
+    }),
+];
+const periodCapabilities = [
+    read({
+        id: 'suite.acct.closing.list',
+        module: 'ACCT',
+        object: 'closing',
+        operation: 'list',
+        path: '/api/v1/accounting/closing',
+        permissions: ['accounting:closing:list'],
+        pack: 'period-end',
+        adapt: (input) => ({
+            query: input.query,
+        }),
+    }),
+    read({
+        id: 'suite.acct.closing.detail',
+        module: 'ACCT',
+        object: 'closing',
+        operation: 'detail',
+        path: '/api/v1/accounting/closing/{id}',
+        permissions: ['accounting:closing:list'],
+        pack: 'period-end',
+        adapt: path('closing_id', 'id'),
+    }),
+    write({
+        id: 'suite.acct.closing.revaluation_preview',
+        module: 'ACCT',
+        object: 'closing',
+        operation: 'previewRevaluation',
+        path: '/api/v1/accounting/closing/{id}/revaluation/preview',
+        permissions: ['accounting:closing:revaluation'],
+        pack: 'period-end',
+        risk: 'R0',
+        sideEffect: 'none',
+        idempotency: 'http',
+        adapt: bodyPath('closing_id', 'id', (input) => ({
+            version: input.version,
+        })),
+    }),
+    write({
+        id: 'suite.acct.closing.revaluation_confirm',
+        module: 'ACCT',
+        object: 'closing',
+        operation: 'confirmRevaluation',
+        path: '/api/v1/accounting/closing/{id}/revaluation/confirm',
+        permissions: ['accounting:closing:revaluation'],
+        pack: 'period-end',
+        risk: 'R3',
+        adapt: bodyPath('closing_id', 'id', (input) => ({
+            version: input.version,
+        })),
+    }),
+    write({
+        id: 'suite.acct.closing.close_check',
+        module: 'ACCT',
+        object: 'closing',
+        operation: 'closeCheck',
+        path: '/api/v1/accounting/closing/{id}/close-check',
+        permissions: ['accounting:closing:close'],
+        pack: 'period-end',
+        risk: 'R0',
+        sideEffect: 'none',
+        idempotency: 'http',
+        adapt: bodyPath('closing_id', 'id', (input) => ({
+            version: input.version,
+        })),
+    }),
+    write({
+        id: 'suite.acct.closing.close_book',
+        module: 'ACCT',
+        object: 'closing',
+        operation: 'closeBook',
+        path: '/api/v1/accounting/closing/{id}/close-book',
+        permissions: ['accounting:closing:close'],
+        pack: 'period-end',
+        risk: 'R3',
+        adapt: bodyPath('closing_id', 'id', (input) => ({
+            version: input.version,
+            check_token: input.check_token,
+            close_reason: input.close_reason,
+        })),
+    }),
+    write({
+        id: 'suite.acct.closing.reconcile',
+        module: 'ACCT',
+        object: 'closing',
+        operation: 'reconcile',
+        path: '/api/v1/accounting/closing/{id}/reconcile',
+        permissions: ['accounting:closing:reconcile'],
+        pack: 'period-end',
+        adapt: bodyPath('closing_id', 'id', (input) => ({
+            version: input.version,
+            note: input.note,
+        })),
+    }),
+    write({
+        id: 'suite.acct.closing.reverse',
+        module: 'ACCT',
+        object: 'closing',
+        operation: 'reverseClose',
+        path: '/api/v1/accounting/closing/{id}/reverse-close',
+        permissions: ['accounting:closing:reverse'],
+        pack: 'period-end',
+        risk: 'R3',
+        adapt: bodyPath('closing_id', 'id', (input) => ({
+            version: input.version,
+            reason: input.reason,
+        })),
+    }),
+];
+const assetOperationCapabilities = [
+    write({
+        id: 'suite.fa.depreciation.preview',
+        module: 'FA',
+        object: 'depreciation',
+        operation: 'preview',
+        path: '/api/v1/fa/depr-run/preview',
+        permissions: ['fa:depr-run:preview'],
+        pack: 'asset-ops',
+        risk: 'R0',
+        sideEffect: 'none',
+        idempotency: 'http',
+        adapt: (input) => ({ body: input.body }),
+    }),
+    write({
+        id: 'suite.fa.depreciation.run',
+        module: 'FA',
+        object: 'depreciation',
+        operation: 'run',
+        path: '/api/v1/fa/depr-run/run',
+        permissions: ['fa:depr-run:run'],
+        pack: 'asset-ops',
+        risk: 'R3',
+        adapt: (input) => ({ body: input.body }),
+    }),
+    read({
+        id: 'suite.fa.cost_adjust.context',
+        module: 'FA',
+        object: 'cost_adjustment',
+        operation: 'context',
+        path: '/api/v1/fa/workbench/finances/{financeId}/cost-adjust/context',
+        permissions: ['fa:workbench:list'],
+        pack: 'asset-ops',
+        adapt: path('finance_id', 'financeId'),
+    }),
+    write({
+        id: 'suite.fa.cost_adjust.submit',
+        module: 'FA',
+        object: 'cost_adjustment',
+        operation: 'submit',
+        path: '/api/v1/fa/workbench/finances/{financeId}/cost-adjust',
+        permissions: ['fa:cost-adjust:create'],
+        pack: 'asset-ops',
+        adapt: bodyPath('finance_id', 'financeId'),
+    }),
+    read({
+        id: 'suite.fa.impair_retire.context',
+        module: 'FA',
+        object: 'impair_retire',
+        operation: 'context',
+        path: '/api/v1/fa/workbench/finances/{financeId}/context',
+        permissions: ['fa:impair-retire:list'],
+        pack: 'asset-ops',
+        adapt: path('finance_id', 'financeId'),
+    }),
+    write({
+        id: 'suite.fa.impair.submit',
+        module: 'FA',
+        object: 'impairment',
+        operation: 'impair',
+        path: '/api/v1/fa/workbench/finances/{financeId}/impair',
+        permissions: ['fa:impair-retire:impair'],
+        pack: 'asset-ops',
+        risk: 'R3',
+        adapt: bodyPath('finance_id', 'financeId'),
+    }),
+    write({
+        id: 'suite.fa.retire.submit',
+        module: 'FA',
+        object: 'retirement',
+        operation: 'retire',
+        path: '/api/v1/fa/workbench/finances/{financeId}/retire',
+        permissions: ['fa:impair-retire:retire'],
+        pack: 'asset-ops',
+        risk: 'R3',
+        adapt: bodyPath('finance_id', 'financeId'),
+    }),
+];
+const automationCapabilities = [
+    read({
+        id: 'suite.rul.events.list',
+        module: 'RUL',
+        object: 'event',
+        operation: 'list',
+        path: '/api/v1/rule/event-review',
+        permissions: ['rule:event-review:list'],
+        pack: 'automation',
+        adapt: (input) => ({
+            query: input.query,
+        }),
+    }),
+    read({
+        id: 'suite.rul.events.lines',
+        module: 'RUL',
+        object: 'event',
+        operation: 'lines',
+        path: '/api/v1/rule/event-review/{event_id}/lines',
+        permissions: ['rule:event-review:list'],
+        pack: 'automation',
+        adapt: path('event_id', 'event_id'),
+    }),
+    read({
+        id: 'suite.rul.events.check',
+        module: 'RUL',
+        object: 'event',
+        operation: 'eventCheck',
+        path: '/api/v1/rule/event-review/event-check',
+        permissions: ['rule:event-review:check'],
+        pack: 'automation',
+        adapt: (input) => ({
+            query: input.query,
+        }),
+    }),
+    read({
+        id: 'suite.rul.events.source_types',
+        module: 'RUL',
+        object: 'event',
+        operation: 'sourceTypes',
+        path: '/api/v1/rule/event-collect/source-types',
+        permissions: ['rule:event-collect:by-ids'],
+        pack: 'automation',
+        adapt: () => ({}),
+    }),
+    write({
+        id: 'suite.rul.events.collect_by_ids',
+        module: 'RUL',
+        object: 'event',
+        operation: 'collectByIds',
+        path: '/api/v1/rule/event-collect:by-ids',
+        permissions: ['rule:event-collect:by-ids'],
+        pack: 'automation',
+        adapt: (input) => ({ body: input.body }),
+    }),
+    read({
+        id: 'suite.rul.auto_flow.detail',
+        module: 'RUL',
+        object: 'auto_flow',
+        operation: 'detail',
+        path: '/api/v1/rule/auto-flow/{id}',
+        permissions: ['rule:auto-flow:list'],
+        pack: 'automation',
+        adapt: (input) => ({
+            pathParams: { id: String(input.flow_id) },
+            query: input.loop_seq === undefined
+                ? {}
+                : { loop_seq: Number(input.loop_seq) },
+        }),
+    }),
+    write({
+        id: 'suite.rul.auto_flow.run',
+        module: 'RUL',
+        object: 'auto_flow',
+        operation: 'runLoop',
+        path: '/api/v1/rule/auto-flow/{id}/runLoop',
+        permissions: ['rule:auto-flow:run'],
+        pack: 'automation',
+        risk: 'R3',
+        adapt: bodyPath('flow_id', 'id', () => undefined),
+    }),
+];
+const configurationCapabilities = [];
+const crudSpecs = [
+    {
+        key: 'map_attr_definition',
+        module: 'MAP',
+        object: 'attribute_definition',
+        root: '/api/v1/mapping/ext-attr-defs',
+        listPermission: 'mapping:attr-def:list',
+        createPermission: 'mapping:attr-def:create',
+        updatePermission: 'mapping:attr-def:update',
+    },
+    {
+        key: 'map_attribute_fill',
+        module: 'MAP',
+        object: 'attribute_fill',
+        root: '/api/v1/mapping/attr-fills',
+        listPermission: 'mapping:attr-fill:list',
+        createPermission: 'mapping:attr-fill:manage',
+        updatePermission: 'mapping:attr-fill:manage',
+    },
+    {
+        key: 'map_source_handler',
+        module: 'MAP',
+        object: 'source_handler',
+        root: '/api/v1/mapping/src-handlers',
+        listPermission: 'mapping:src-handler:list',
+        createPermission: 'mapping:src-handler:manage',
+        updatePermission: 'mapping:src-handler:manage',
+    },
+    {
+        key: 'accounting_rule',
+        module: 'RUL',
+        object: 'accounting_rule',
+        root: '/api/v1/rule/rules',
+        listPermission: 'rule:rules:list',
+        createPermission: 'rule:rules:create',
+        updatePermission: 'rule:rules:update',
+    },
+    {
+        key: 'allocation_config',
+        module: 'ALOC',
+        object: 'allocation_config',
+        root: '/api/v1/aloc/config',
+        listPermission: 'aloc:config:list',
+        createPermission: 'aloc:config:create',
+        updatePermission: 'aloc:config:update',
+    },
+    {
+        key: 'pnl_bucket',
+        module: 'PNL',
+        object: 'pnl_bucket',
+        root: '/api/v1/pnl/buckets',
+        listPermission: 'pnl:bucket:list',
+        createPermission: 'pnl:bucket:create',
+        updatePermission: 'pnl:bucket:update',
+    },
+    {
+        key: 'generator_parameter',
+        module: 'PGEN',
+        object: 'parameter',
+        root: '/api/v1/pgen/params',
+        listPermission: 'pgen:param:list',
+        createPermission: 'pgen:param:create',
+        updatePermission: 'pgen:param:update',
+    },
+    {
+        key: 'generator_rule',
+        module: 'PGEN',
+        object: 'generator_rule',
+        root: '/api/v1/pgen/rules',
+        listPermission: 'pgen:rule:list',
+        createPermission: 'pgen:rule:create',
+        updatePermission: 'pgen:rule:update',
+    },
+];
+for (const spec of crudSpecs) {
+    configurationCapabilities.push(read({
+        id: `suite.config.${spec.key}.list`,
+        module: spec.module,
+        object: spec.object,
+        operation: 'list',
+        path: spec.root,
+        permissions: [spec.listPermission],
+        pack: 'configuration',
+        adapt: (input) => ({
+            query: input.query,
+        }),
+    }), read({
+        id: `suite.config.${spec.key}.detail`,
+        module: spec.module,
+        object: spec.object,
+        operation: 'detail',
+        path: `${spec.root}/{id}`,
+        permissions: [spec.listPermission],
+        pack: 'configuration',
+        adapt: path('object_id', 'id'),
+    }), write({
+        id: `suite.config.${spec.key}.create`,
+        module: spec.module,
+        object: spec.object,
+        operation: 'create',
+        path: spec.root,
+        permissions: [spec.createPermission],
+        pack: 'configuration',
+        risk: [
+            'accounting_rule',
+            'generator_parameter',
+            'generator_rule',
+        ].includes(spec.key)
+            ? 'R2'
+            : 'R1',
+        adapt: (input) => ({ body: input.values }),
+    }), write({
+        id: `suite.config.${spec.key}.update`,
+        module: spec.module,
+        object: spec.object,
+        operation: 'update',
+        method: 'PUT',
+        path: `${spec.root}/{id}`,
+        permissions: [spec.updatePermission],
+        pack: 'configuration',
+        risk: [
+            'accounting_rule',
+            'generator_parameter',
+            'generator_rule',
+        ].includes(spec.key)
+            ? 'R2'
+            : 'R1',
+        adapt: bodyPath('object_id', 'id', (input) => ({
+            ...input.values,
+            version: input.version,
+        })),
+    }));
+}
+configurationCapabilities.push(read({
+    id: 'suite.config.precheck_rule.tree',
+    module: 'RUL',
+    object: 'precheck_rule',
+    operation: 'tree',
+    path: '/api/v1/rule/pre-check/tree',
+    permissions: ['rule:precheck:list'],
+    pack: 'configuration',
+    adapt: (input) => ({
+        query: input.query,
+    }),
+}), read({
+    id: 'suite.config.precheck_rule.detail',
+    module: 'RUL',
+    object: 'precheck_rule',
+    operation: 'detail',
+    path: '/api/v1/rule/pre-check/{id}',
+    permissions: ['rule:precheck:list'],
+    pack: 'configuration',
+    adapt: path('object_id', 'id'),
+}), write({
+    id: 'suite.config.precheck_rule.create',
+    module: 'RUL',
+    object: 'precheck_rule',
+    operation: 'create',
+    path: '/api/v1/rule/pre-check',
+    permissions: ['rule:precheck:create'],
+    pack: 'configuration',
+    risk: 'R2',
+    adapt: (input) => ({ body: input.values }),
+}), write({
+    id: 'suite.config.precheck_rule.update',
+    module: 'RUL',
+    object: 'precheck_rule',
+    operation: 'update',
+    method: 'PUT',
+    path: '/api/v1/rule/pre-check/{id}',
+    permissions: ['rule:precheck:update'],
+    pack: 'configuration',
+    risk: 'R2',
+    adapt: bodyPath('object_id', 'id', (input) => ({
+        ...input.values,
+        version: input.version,
+    })),
+}), read({
+    id: 'suite.aloc.detail.list',
+    module: 'ALOC',
+    object: 'allocation_detail',
+    operation: 'list',
+    path: '/api/v1/aloc/detail',
+    permissions: ['aloc:detail:list'],
+    pack: 'configuration',
+    adapt: (input) => ({
+        query: input.query,
+    }),
+}), read({
+    id: 'suite.aloc.detail.detail',
+    module: 'ALOC',
+    object: 'allocation_detail',
+    operation: 'detail',
+    path: '/api/v1/aloc/detail/{id}',
+    permissions: ['aloc:detail:list'],
+    pack: 'configuration',
+    adapt: path('object_id', 'id'),
+}), read({
+    id: 'suite.aloc.detail.summary',
+    module: 'ALOC',
+    object: 'allocation_detail',
+    operation: 'summary',
+    path: '/api/v1/aloc/detail/summary',
+    permissions: ['aloc:detail:list'],
+    pack: 'configuration',
+    adapt: (input) => ({
+        query: input.query,
+    }),
+}), write({
+    id: 'suite.config.allocation_config.lines',
+    module: 'ALOC',
+    object: 'allocation_config',
+    operation: 'replaceLines',
+    method: 'PUT',
+    path: '/api/v1/aloc/config/{id}/lines',
+    permissions: ['aloc:config:update'],
+    pack: 'configuration',
+    risk: 'R1',
+    adapt: bodyPath('object_id', 'id', (input) => ({
+        version: input.version,
+        lines: input.lines,
+    })),
+}), read({
+    id: 'suite.aloc.generate.preview',
+    module: 'ALOC',
+    object: 'allocation',
+    operation: 'preview',
+    path: '/api/v1/aloc/generate/preview/{journalId}',
+    permissions: ['aloc:generate:manual'],
+    pack: 'configuration',
+    adapt: path('journal_id', 'journalId'),
+}), write({
+    id: 'suite.aloc.generate.execute',
+    module: 'ALOC',
+    object: 'allocation',
+    operation: 'generate',
+    path: '/api/v1/aloc/generate/journal/{journalId}',
+    permissions: ['aloc:generate:manual'],
+    pack: 'configuration',
+    risk: 'R3',
+    adapt: bodyPath('journal_id', 'journalId', () => undefined),
+}), write({
+    id: 'suite.pnl.calculation.run',
+    module: 'PNL',
+    object: 'calculation',
+    operation: 'submitRun',
+    path: '/api/v1/pnl/calculations',
+    permissions: ['pnl:calculation:create'],
+    pack: 'configuration',
+    adapt: (input) => ({ body: input.body }),
+}), read({
+    id: 'suite.pnl.calculation.status',
+    module: 'PNL',
+    object: 'calculation',
+    operation: 'getRun',
+    path: '/api/v1/pnl/calculations/{runId}',
+    permissions: ['pnl:calculation:list', 'pnl:calculation:create'],
+    pack: 'configuration',
+    adapt: path('run_id', 'runId'),
+}), write({
+    id: 'suite.config.pnl_bucket.member_add',
+    module: 'PNL',
+    object: 'pnl_bucket_member',
+    operation: 'add',
+    path: '/api/v1/pnl/buckets/{bucketId}/members',
+    permissions: ['pnl:bucket:update'],
+    pack: 'configuration',
+    risk: 'R1',
+    adapt: bodyPath('bucket_id', 'bucketId', (input) => input.values),
+}), write({
+    id: 'suite.pgen.rule.run',
+    module: 'PGEN',
+    object: 'generator_rule',
+    operation: 'run',
+    path: '/api/v1/pgen/rules/{id}/run',
+    permissions: ['pgen:rule:run'],
+    pack: 'configuration',
+    adapt: (input) => {
+        const businessDate = input.business_date;
+        return {
+            pathParams: { id: String(input.rule_id) },
+            query: typeof businessDate === 'string'
+                ? { business_date: businessDate }
+                : {},
+        };
+    },
+}));
+export const extendedOperationCapabilities = [
+    ...workflowCapabilities,
+    ...periodCapabilities,
+    ...assetOperationCapabilities,
+    ...automationCapabilities,
+    ...configurationCapabilities,
+];
+//# sourceMappingURL=extended-operations.js.map