@contractspec/module.examples 1.44.1 → 1.45.1

package/dist/libs/contracts/dist/integrations/openbanking/contracts/accounts.js

@@ -0,0 +1,230 @@
+import { ScalarTypeEnum } from "../../../../../schema/dist/ScalarTypeEnum.js";
+import { SchemaModel } from "../../../../../schema/dist/SchemaModel.js";
+import "../../../../../schema/dist/index.js";
+import { defineCommand, defineQuery } from "../../../operations/operation.js";
+import "../../../operations/index.js";
+import { BankAccountRecord } from "../models.js";
+import { OPENBANKING_TELEMETRY_EVENTS } from "../telemetry.js";
+
+//#region ../../libs/contracts/dist/integrations/openbanking/contracts/accounts.js
+const OpenBankingListAccountsInput = new SchemaModel({
+	name: "OpenBankingListAccountsInput",
+	description: "Parameters for listing bank accounts through the open banking provider.",
+	fields: {
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		userId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		connectionId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: true
+		},
+		includeBalances: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: true
+		},
+		institutionId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		cursor: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		pageSize: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true
+		}
+	}
+});
+const OpenBankingListAccountsOutput = new SchemaModel({
+	name: "OpenBankingListAccountsOutput",
+	description: "Paginated list of bank accounts available to the tenant and user.",
+	fields: {
+		accounts: {
+			type: BankAccountRecord,
+			isOptional: false,
+			isArray: true
+		},
+		nextCursor: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		hasMore: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: true
+		}
+	}
+});
+const OpenBankingGetAccountInput = new SchemaModel({
+	name: "OpenBankingGetAccountInput",
+	description: "Parameters for retrieving a specific bank account.",
+	fields: {
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		accountId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		includeBalances: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: true
+		},
+		includeLatestTransactions: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: true
+		}
+	}
+});
+const OpenBankingSyncAccountsInput = new SchemaModel({
+	name: "OpenBankingSyncAccountsInput",
+	description: "Command payload to trigger an account synchronisation against the open banking provider.",
+	fields: {
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		userId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: true
+		},
+		connectionId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		accountIds: {
+			type: ScalarTypeEnum.ID(),
+			isArray: true,
+			isOptional: true
+		},
+		forceFullRefresh: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: true
+		},
+		triggerWorkflows: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: true
+		}
+	}
+});
+const OpenBankingSyncAccountsOutput = new SchemaModel({
+	name: "OpenBankingSyncAccountsOutput",
+	description: "Result of a bank account synchronisation run.",
+	fields: {
+		synced: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		failed: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		errors: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isArray: true,
+			isOptional: true
+		},
+		nextSyncSuggestedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		}
+	}
+});
+const OpenBankingListAccounts = defineQuery({
+	meta: {
+		key: "openbanking.accounts.list",
+		version: "1.0.0",
+		description: "List bank accounts available to a tenant/user via Powens Open Banking.",
+		goal: "Provide downstream workflows with the set of accounts accessible via the configured open banking connection.",
+		context: "Used by Pocket Family Office dashboards and sync workflows to enumerate bank accounts prior to syncing balances or transactions.",
+		owners: ["@platform.finance"],
+		tags: [
+			"open-banking",
+			"powens",
+			"accounts"
+		],
+		stability: "experimental"
+	},
+	io: {
+		input: OpenBankingListAccountsInput,
+		output: OpenBankingListAccountsOutput
+	},
+	policy: { auth: "user" }
+});
+const OpenBankingGetAccount = defineQuery({
+	meta: {
+		key: "openbanking.accounts.get",
+		version: "1.0.0",
+		description: "Retrieve the canonical bank account record for the given account identifier.",
+		goal: "Allow user-facing experiences and automations to display up-to-date account metadata.",
+		context: "Invoked by UI surfaces and workflow automation steps that require detailed metadata for a specific bank account.",
+		owners: ["@platform.finance"],
+		tags: [
+			"open-banking",
+			"powens",
+			"accounts"
+		],
+		stability: "experimental"
+	},
+	io: {
+		input: OpenBankingGetAccountInput,
+		output: BankAccountRecord
+	},
+	policy: { auth: "user" }
+});
+const OpenBankingSyncAccounts = defineCommand({
+	meta: {
+		key: "openbanking.accounts.sync",
+		version: "1.0.0",
+		description: "Initiate a synchronisation run to refresh bank account metadata from Powens.",
+		goal: "Keep canonical bank account records aligned with the external open banking provider.",
+		context: "Triggered by scheduled workflows or manual operator actions to reconcile account metadata prior to transaction/balance syncs.",
+		owners: ["@platform.finance"],
+		tags: [
+			"open-banking",
+			"powens",
+			"accounts"
+		],
+		stability: "experimental"
+	},
+	io: {
+		input: OpenBankingSyncAccountsInput,
+		output: OpenBankingSyncAccountsOutput
+	},
+	policy: { auth: "admin" },
+	telemetry: {
+		success: {
+			event: { key: OPENBANKING_TELEMETRY_EVENTS.accountsSynced },
+			properties: ({ input, output }) => {
+				const payload = input;
+				const result = output;
+				return {
+					tenantId: payload?.tenantId,
+					connectionId: payload?.connectionId,
+					synced: result?.synced,
+					failed: result?.failed
+				};
+			}
+		},
+		failure: {
+			event: { key: OPENBANKING_TELEMETRY_EVENTS.accountsSyncFailed },
+			properties: ({ input, error }) => {
+				const payload = input;
+				return {
+					tenantId: payload?.tenantId,
+					connectionId: payload?.connectionId,
+					error: error instanceof Error ? error.message : String(error ?? "unknown")
+				};
+			}
+		}
+	}
+});
+
+//#endregion
+//# sourceMappingURL=accounts.js.map

package/dist/libs/contracts/dist/integrations/openbanking/contracts/accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.js","names":[],"sources":["../../../../../../../../../libs/contracts/dist/integrations/openbanking/contracts/accounts.js"],"sourcesContent":["import { defineCommand, defineQuery } from \"../../../operations/operation.js\";\nimport \"../../../operations/index.js\";\nimport { BankAccountRecord } from \"../models.js\";\nimport { OPENBANKING_TELEMETRY_EVENTS } from \"../telemetry.js\";\nimport { ScalarTypeEnum, SchemaModel } from \"@contractspec/lib.schema\";\n\n//#region src/integrations/openbanking/contracts/accounts.ts\nconst OpenBankingListAccountsInput = new SchemaModel({\n\tname: \"OpenBankingListAccountsInput\",\n\tdescription: \"Parameters for listing bank accounts through the open banking provider.\",\n\tfields: {\n\t\ttenantId: {\n\t\t\ttype: ScalarTypeEnum.ID(),\n\t\t\tisOptional: false\n\t\t},\n\t\tuserId: {\n\t\t\ttype: ScalarTypeEnum.ID(),\n\t\t\tisOptional: false\n\t\t},\n\t\tconnectionId: {\n\t\t\ttype: ScalarTypeEnum.ID(),\n\t\t\tisOptional: true\n\t\t},\n\t\tincludeBalances: {\n\t\t\ttype: ScalarTypeEnum.Boolean(),\n\t\t\tisOptional: true\n\t\t},\n\t\tinstitutionId: {\n\t\t\ttype: ScalarTypeEnum.String_unsecure(),\n\t\t\tisOptional: true\n\t\t},\n\t\tcursor: {\n\t\t\ttype: ScalarTypeEnum.String_unsecure(),\n\t\t\tisOptional: true\n\t\t},\n\t\tpageSize: {\n\t\t\ttype: ScalarTypeEnum.Int_unsecure(),\n\t\t\tisOptional: true\n\t\t}\n\t}\n});\nconst OpenBankingListAccountsOutput = new SchemaModel({\n\tname: \"OpenBankingListAccountsOutput\",\n\tdescription: \"Paginated list of bank accounts available to the tenant and user.\",\n\tfields: {\n\t\taccounts: {\n\t\t\ttype: BankAccountRecord,\n\t\t\tisOptional: false,\n\t\t\tisArray: true\n\t\t},\n\t\tnextCursor: {\n\t\t\ttype: ScalarTypeEnum.String_unsecure(),\n\t\t\tisOptional: true\n\t\t},\n\t\thasMore: {\n\t\t\ttype: ScalarTypeEnum.Boolean(),\n\t\t\tisOptional: true\n\t\t}\n\t}\n});\nconst OpenBankingGetAccountInput = new SchemaModel({\n\tname: \"OpenBankingGetAccountInput\",\n\tdescription: \"Parameters for retrieving a specific bank account.\",\n\tfields: {\n\t\ttenantId: {\n\t\t\ttype: ScalarTypeEnum.ID(),\n\t\t\tisOptional: false\n\t\t},\n\t\taccountId: {\n\t\t\ttype: ScalarTypeEnum.ID(),\n\t\t\tisOptional: false\n\t\t},\n\t\tincludeBalances: {\n\t\t\ttype: ScalarTypeEnum.Boolean(),\n\t\t\tisOptional: true\n\t\t},\n\t\tincludeLatestTransactions: {\n\t\t\ttype: ScalarTypeEnum.Boolean(),\n\t\t\tisOptional: true\n\t\t}\n\t}\n});\nconst OpenBankingSyncAccountsInput = new SchemaModel({\n\tname: \"OpenBankingSyncAccountsInput\",\n\tdescription: \"Command payload to trigger an account synchronisation against the open banking provider.\",\n\tfields: {\n\t\ttenantId: {\n\t\t\ttype: ScalarTypeEnum.ID(),\n\t\t\tisOptional: false\n\t\t},\n\t\tuserId: {\n\t\t\ttype: ScalarTypeEnum.ID(),\n\t\t\tisOptional: true\n\t\t},\n\t\tconnectionId: {\n\t\t\ttype: ScalarTypeEnum.ID(),\n\t\t\tisOptional: false\n\t\t},\n\t\taccountIds: {\n\t\t\ttype: ScalarTypeEnum.ID(),\n\t\t\tisArray: true,\n\t\t\tisOptional: true\n\t\t},\n\t\tforceFullRefresh: {\n\t\t\ttype: ScalarTypeEnum.Boolean(),\n\t\t\tisOptional: true\n\t\t},\n\t\ttriggerWorkflows: {\n\t\t\ttype: ScalarTypeEnum.Boolean(),\n\t\t\tisOptional: true\n\t\t}\n\t}\n});\nconst OpenBankingSyncAccountsOutput = new SchemaModel({\n\tname: \"OpenBankingSyncAccountsOutput\",\n\tdescription: \"Result of a bank account synchronisation run.\",\n\tfields: {\n\t\tsynced: {\n\t\t\ttype: ScalarTypeEnum.Int_unsecure(),\n\t\t\tisOptional: false\n\t\t},\n\t\tfailed: {\n\t\t\ttype: ScalarTypeEnum.Int_unsecure(),\n\t\t\tisOptional: false\n\t\t},\n\t\terrors: {\n\t\t\ttype: ScalarTypeEnum.String_unsecure(),\n\t\t\tisArray: true,\n\t\t\tisOptional: true\n\t\t},\n\t\tnextSyncSuggestedAt: {\n\t\t\ttype: ScalarTypeEnum.DateTime(),\n\t\t\tisOptional: true\n\t\t}\n\t}\n});\nconst OpenBankingListAccounts = defineQuery({\n\tmeta: {\n\t\tkey: \"openbanking.accounts.list\",\n\t\tversion: \"1.0.0\",\n\t\tdescription: \"List bank accounts available to a tenant/user via Powens Open Banking.\",\n\t\tgoal: \"Provide downstream workflows with the set of accounts accessible via the configured open banking connection.\",\n\t\tcontext: \"Used by Pocket Family Office dashboards and sync workflows to enumerate bank accounts prior to syncing balances or transactions.\",\n\t\towners: [\"@platform.finance\"],\n\t\ttags: [\n\t\t\t\"open-banking\",\n\t\t\t\"powens\",\n\t\t\t\"accounts\"\n\t\t],\n\t\tstability: \"experimental\"\n\t},\n\tio: {\n\t\tinput: OpenBankingListAccountsInput,\n\t\toutput: OpenBankingListAccountsOutput\n\t},\n\tpolicy: { auth: \"user\" }\n});\nconst OpenBankingGetAccount = defineQuery({\n\tmeta: {\n\t\tkey: \"openbanking.accounts.get\",\n\t\tversion: \"1.0.0\",\n\t\tdescription: \"Retrieve the canonical bank account record for the given account identifier.\",\n\t\tgoal: \"Allow user-facing experiences and automations to display up-to-date account metadata.\",\n\t\tcontext: \"Invoked by UI surfaces and workflow automation steps that require detailed metadata for a specific bank account.\",\n\t\towners: [\"@platform.finance\"],\n\t\ttags: [\n\t\t\t\"open-banking\",\n\t\t\t\"powens\",\n\t\t\t\"accounts\"\n\t\t],\n\t\tstability: \"experimental\"\n\t},\n\tio: {\n\t\tinput: OpenBankingGetAccountInput,\n\t\toutput: BankAccountRecord\n\t},\n\tpolicy: { auth: \"user\" }\n});\nconst OpenBankingSyncAccounts = defineCommand({\n\tmeta: {\n\t\tkey: \"openbanking.accounts.sync\",\n\t\tversion: \"1.0.0\",\n\t\tdescription: \"Initiate a synchronisation run to refresh bank account metadata from Powens.\",\n\t\tgoal: \"Keep canonical bank account records aligned with the external open banking provider.\",\n\t\tcontext: \"Triggered by scheduled workflows or manual operator actions to reconcile account metadata prior to transaction/balance syncs.\",\n\t\towners: [\"@platform.finance\"],\n\t\ttags: [\n\t\t\t\"open-banking\",\n\t\t\t\"powens\",\n\t\t\t\"accounts\"\n\t\t],\n\t\tstability: \"experimental\"\n\t},\n\tio: {\n\t\tinput: OpenBankingSyncAccountsInput,\n\t\toutput: OpenBankingSyncAccountsOutput\n\t},\n\tpolicy: { auth: \"admin\" },\n\ttelemetry: {\n\t\tsuccess: {\n\t\t\tevent: { key: OPENBANKING_TELEMETRY_EVENTS.accountsSynced },\n\t\t\tproperties: ({ input, output }) => {\n\t\t\t\tconst payload = input;\n\t\t\t\tconst result = output;\n\t\t\t\treturn {\n\t\t\t\t\ttenantId: payload?.tenantId,\n\t\t\t\t\tconnectionId: payload?.connectionId,\n\t\t\t\t\tsynced: result?.synced,\n\t\t\t\t\tfailed: result?.failed\n\t\t\t\t};\n\t\t\t}\n\t\t},\n\t\tfailure: {\n\t\t\tevent: { key: OPENBANKING_TELEMETRY_EVENTS.accountsSyncFailed },\n\t\t\tproperties: ({ input, error }) => {\n\t\t\t\tconst payload = input;\n\t\t\t\treturn {\n\t\t\t\t\ttenantId: payload?.tenantId,\n\t\t\t\t\tconnectionId: payload?.connectionId,\n\t\t\t\t\terror: error instanceof Error ? error.message : String(error ?? \"unknown\")\n\t\t\t\t};\n\t\t\t}\n\t\t}\n\t}\n});\nconst openBankingAccountContracts = {\n\tOpenBankingListAccounts,\n\tOpenBankingGetAccount,\n\tOpenBankingSyncAccounts\n};\nfunction registerOpenBankingAccountContracts(registry) {\n\treturn registry.register(OpenBankingListAccounts).register(OpenBankingGetAccount).register(OpenBankingSyncAccounts);\n}\n\n//#endregion\nexport { OpenBankingGetAccount, OpenBankingListAccounts, OpenBankingSyncAccounts, openBankingAccountContracts, registerOpenBankingAccountContracts };"],"mappings":"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"}

package/dist/libs/contracts/dist/integrations/openbanking/contracts/balances.js

@@ -0,0 +1,161 @@
+import { ScalarTypeEnum } from "../../../../../schema/dist/ScalarTypeEnum.js";
+import { SchemaModel } from "../../../../../schema/dist/SchemaModel.js";
+import "../../../../../schema/dist/index.js";
+import { defineCommand, defineQuery } from "../../../operations/operation.js";
+import "../../../operations/index.js";
+import { AccountBalanceRecord } from "../models.js";
+import { OPENBANKING_TELEMETRY_EVENTS } from "../telemetry.js";
+
+//#region ../../libs/contracts/dist/integrations/openbanking/contracts/balances.js
+const OpenBankingGetBalancesInput = new SchemaModel({
+	name: "OpenBankingGetBalancesInput",
+	description: "Parameters for retrieving bank account balances from the canonical ledger.",
+	fields: {
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		accountId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		balanceTypes: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isArray: true,
+			isOptional: true
+		}
+	}
+});
+const OpenBankingGetBalancesOutput = new SchemaModel({
+	name: "OpenBankingGetBalancesOutput",
+	description: "Canonical balances for a bank account.",
+	fields: {
+		balances: {
+			type: AccountBalanceRecord,
+			isOptional: false,
+			isArray: true
+		},
+		asOf: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		}
+	}
+});
+const OpenBankingRefreshBalancesInput = new SchemaModel({
+	name: "OpenBankingRefreshBalancesInput",
+	description: "Command payload to refresh balances for a bank account via the open banking provider.",
+	fields: {
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		accountId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		connectionId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: true
+		},
+		balanceTypes: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isArray: true,
+			isOptional: true
+		},
+		forceRefresh: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: true
+		}
+	}
+});
+const OpenBankingRefreshBalancesOutput = new SchemaModel({
+	name: "OpenBankingRefreshBalancesOutput",
+	description: "Result of a balance refresh against the open banking provider.",
+	fields: {
+		balances: {
+			type: AccountBalanceRecord,
+			isOptional: false,
+			isArray: true
+		},
+		refreshedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		errors: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isArray: true,
+			isOptional: true
+		}
+	}
+});
+const OpenBankingGetBalances = defineQuery({
+	meta: {
+		key: "openbanking.balances.get",
+		version: "1.0.0",
+		description: "Retrieve the latest cached balances for a bank account.",
+		goal: "Expose current and available balances required by dashboards and analytics.",
+		context: "Used by Pocket Family Office UI surfaces and automation steps that require balance totals prior to generating summaries.",
+		owners: ["@platform.finance"],
+		tags: [
+			"open-banking",
+			"powens",
+			"balances"
+		],
+		stability: "experimental"
+	},
+	io: {
+		input: OpenBankingGetBalancesInput,
+		output: OpenBankingGetBalancesOutput
+	},
+	policy: { auth: "user" }
+});
+const OpenBankingRefreshBalances = defineCommand({
+	meta: {
+		key: "openbanking.balances.refresh",
+		version: "1.0.0",
+		description: "Refresh balances for a bank account via the configured open banking provider.",
+		goal: "Ensure canonical balance records reflect the latest values from Powens.",
+		context: "Triggered by scheduled workflows before generating summaries or forecasting cashflow.",
+		owners: ["@platform.finance"],
+		tags: [
+			"open-banking",
+			"powens",
+			"balances"
+		],
+		stability: "experimental"
+	},
+	io: {
+		input: OpenBankingRefreshBalancesInput,
+		output: OpenBankingRefreshBalancesOutput
+	},
+	policy: { auth: "admin" },
+	telemetry: {
+		success: {
+			event: { key: OPENBANKING_TELEMETRY_EVENTS.balancesRefreshed },
+			properties: ({ input, output }) => {
+				const payload = input;
+				const result = output;
+				return {
+					tenantId: payload?.tenantId,
+					accountId: payload?.accountId,
+					refreshedAt: result?.refreshedAt,
+					balanceCount: Array.isArray(result?.balances) ? result?.balances.length : void 0
+				};
+			}
+		},
+		failure: {
+			event: { key: OPENBANKING_TELEMETRY_EVENTS.balancesRefreshFailed },
+			properties: ({ input, error }) => {
+				const payload = input;
+				return {
+					tenantId: payload?.tenantId,
+					accountId: payload?.accountId,
+					error: error instanceof Error ? error.message : String(error ?? "unknown")
+				};
+			}
+		}
+	}
+});
+
+//#endregion
+//# sourceMappingURL=balances.js.map

package/dist/libs/contracts/dist/integrations/openbanking/contracts/balances.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balances.js","names":[],"sources":["../../../../../../../../../libs/contracts/dist/integrations/openbanking/contracts/balances.js"],"sourcesContent":["import { defineCommand, defineQuery } from \"../../../operations/operation.js\";\nimport \"../../../operations/index.js\";\nimport { AccountBalanceRecord } from \"../models.js\";\nimport { OPENBANKING_TELEMETRY_EVENTS } from \"../telemetry.js\";\nimport { ScalarTypeEnum, SchemaModel } from \"@contractspec/lib.schema\";\n\n//#region src/integrations/openbanking/contracts/balances.ts\nconst OpenBankingGetBalancesInput = new SchemaModel({\n\tname: \"OpenBankingGetBalancesInput\",\n\tdescription: \"Parameters for retrieving bank account balances from the canonical ledger.\",\n\tfields: {\n\t\ttenantId: {\n\t\t\ttype: ScalarTypeEnum.ID(),\n\t\t\tisOptional: false\n\t\t},\n\t\taccountId: {\n\t\t\ttype: ScalarTypeEnum.ID(),\n\t\t\tisOptional: false\n\t\t},\n\t\tbalanceTypes: {\n\t\t\ttype: ScalarTypeEnum.String_unsecure(),\n\t\t\tisArray: true,\n\t\t\tisOptional: true\n\t\t}\n\t}\n});\nconst OpenBankingGetBalancesOutput = new SchemaModel({\n\tname: \"OpenBankingGetBalancesOutput\",\n\tdescription: \"Canonical balances for a bank account.\",\n\tfields: {\n\t\tbalances: {\n\t\t\ttype: AccountBalanceRecord,\n\t\t\tisOptional: false,\n\t\t\tisArray: true\n\t\t},\n\t\tasOf: {\n\t\t\ttype: ScalarTypeEnum.DateTime(),\n\t\t\tisOptional: true\n\t\t}\n\t}\n});\nconst OpenBankingRefreshBalancesInput = new SchemaModel({\n\tname: \"OpenBankingRefreshBalancesInput\",\n\tdescription: \"Command payload to refresh balances for a bank account via the open banking provider.\",\n\tfields: {\n\t\ttenantId: {\n\t\t\ttype: ScalarTypeEnum.ID(),\n\t\t\tisOptional: false\n\t\t},\n\t\taccountId: {\n\t\t\ttype: ScalarTypeEnum.ID(),\n\t\t\tisOptional: false\n\t\t},\n\t\tconnectionId: {\n\t\t\ttype: ScalarTypeEnum.ID(),\n\t\t\tisOptional: true\n\t\t},\n\t\tbalanceTypes: {\n\t\t\ttype: ScalarTypeEnum.String_unsecure(),\n\t\t\tisArray: true,\n\t\t\tisOptional: true\n\t\t},\n\t\tforceRefresh: {\n\t\t\ttype: ScalarTypeEnum.Boolean(),\n\t\t\tisOptional: true\n\t\t}\n\t}\n});\nconst OpenBankingRefreshBalancesOutput = new SchemaModel({\n\tname: \"OpenBankingRefreshBalancesOutput\",\n\tdescription: \"Result of a balance refresh against the open banking provider.\",\n\tfields: {\n\t\tbalances: {\n\t\t\ttype: AccountBalanceRecord,\n\t\t\tisOptional: false,\n\t\t\tisArray: true\n\t\t},\n\t\trefreshedAt: {\n\t\t\ttype: ScalarTypeEnum.DateTime(),\n\t\t\tisOptional: false\n\t\t},\n\t\terrors: {\n\t\t\ttype: ScalarTypeEnum.String_unsecure(),\n\t\t\tisArray: true,\n\t\t\tisOptional: true\n\t\t}\n\t}\n});\nconst OpenBankingGetBalances = defineQuery({\n\tmeta: {\n\t\tkey: \"openbanking.balances.get\",\n\t\tversion: \"1.0.0\",\n\t\tdescription: \"Retrieve the latest cached balances for a bank account.\",\n\t\tgoal: \"Expose current and available balances required by dashboards and analytics.\",\n\t\tcontext: \"Used by Pocket Family Office UI surfaces and automation steps that require balance totals prior to generating summaries.\",\n\t\towners: [\"@platform.finance\"],\n\t\ttags: [\n\t\t\t\"open-banking\",\n\t\t\t\"powens\",\n\t\t\t\"balances\"\n\t\t],\n\t\tstability: \"experimental\"\n\t},\n\tio: {\n\t\tinput: OpenBankingGetBalancesInput,\n\t\toutput: OpenBankingGetBalancesOutput\n\t},\n\tpolicy: { auth: \"user\" }\n});\nconst OpenBankingRefreshBalances = defineCommand({\n\tmeta: {\n\t\tkey: \"openbanking.balances.refresh\",\n\t\tversion: \"1.0.0\",\n\t\tdescription: \"Refresh balances for a bank account via the configured open banking provider.\",\n\t\tgoal: \"Ensure canonical balance records reflect the latest values from Powens.\",\n\t\tcontext: \"Triggered by scheduled workflows before generating summaries or forecasting cashflow.\",\n\t\towners: [\"@platform.finance\"],\n\t\ttags: [\n\t\t\t\"open-banking\",\n\t\t\t\"powens\",\n\t\t\t\"balances\"\n\t\t],\n\t\tstability: \"experimental\"\n\t},\n\tio: {\n\t\tinput: OpenBankingRefreshBalancesInput,\n\t\toutput: OpenBankingRefreshBalancesOutput\n\t},\n\tpolicy: { auth: \"admin\" },\n\ttelemetry: {\n\t\tsuccess: {\n\t\t\tevent: { key: OPENBANKING_TELEMETRY_EVENTS.balancesRefreshed },\n\t\t\tproperties: ({ input, output }) => {\n\t\t\t\tconst payload = input;\n\t\t\t\tconst result = output;\n\t\t\t\treturn {\n\t\t\t\t\ttenantId: payload?.tenantId,\n\t\t\t\t\taccountId: payload?.accountId,\n\t\t\t\t\trefreshedAt: result?.refreshedAt,\n\t\t\t\t\tbalanceCount: Array.isArray(result?.balances) ? result?.balances.length : void 0\n\t\t\t\t};\n\t\t\t}\n\t\t},\n\t\tfailure: {\n\t\t\tevent: { key: OPENBANKING_TELEMETRY_EVENTS.balancesRefreshFailed },\n\t\t\tproperties: ({ input, error }) => {\n\t\t\t\tconst payload = input;\n\t\t\t\treturn {\n\t\t\t\t\ttenantId: payload?.tenantId,\n\t\t\t\t\taccountId: payload?.accountId,\n\t\t\t\t\terror: error instanceof Error ? error.message : String(error ?? \"unknown\")\n\t\t\t\t};\n\t\t\t}\n\t\t}\n\t}\n});\nconst openBankingBalanceContracts = {\n\tOpenBankingGetBalances,\n\tOpenBankingRefreshBalances\n};\nfunction registerOpenBankingBalanceContracts(registry) {\n\treturn registry.register(OpenBankingGetBalances).register(OpenBankingRefreshBalances);\n}\n\n//#endregion\nexport { OpenBankingGetBalances, OpenBankingRefreshBalances, openBankingBalanceContracts, registerOpenBankingBalanceContracts };"],"mappings":";;;;;;;;;AAOA,MAAM,8BAA8B,IAAI,YAAY;CACnD,MAAM;CACN,aAAa;CACb,QAAQ;EACP,UAAU;GACT,MAAM,eAAe,IAAI;GACzB,YAAY;GACZ;EACD,WAAW;GACV,MAAM,eAAe,IAAI;GACzB,YAAY;GACZ;EACD,cAAc;GACb,MAAM,eAAe,iBAAiB;GACtC,SAAS;GACT,YAAY;GACZ;EACD;CACD,CAAC;AACF,MAAM,+BAA+B,IAAI,YAAY;CACpD,MAAM;CACN,aAAa;CACb,QAAQ;EACP,UAAU;GACT,MAAM;GACN,YAAY;GACZ,SAAS;GACT;EACD,MAAM;GACL,MAAM,eAAe,UAAU;GAC/B,YAAY;GACZ;EACD;CACD,CAAC;AACF,MAAM,kCAAkC,IAAI,YAAY;CACvD,MAAM;CACN,aAAa;CACb,QAAQ;EACP,UAAU;GACT,MAAM,eAAe,IAAI;GACzB,YAAY;GACZ;EACD,WAAW;GACV,MAAM,eAAe,IAAI;GACzB,YAAY;GACZ;EACD,cAAc;GACb,MAAM,eAAe,IAAI;GACzB,YAAY;GACZ;EACD,cAAc;GACb,MAAM,eAAe,iBAAiB;GACtC,SAAS;GACT,YAAY;GACZ;EACD,cAAc;GACb,MAAM,eAAe,SAAS;GAC9B,YAAY;GACZ;EACD;CACD,CAAC;AACF,MAAM,mCAAmC,IAAI,YAAY;CACxD,MAAM;CACN,aAAa;CACb,QAAQ;EACP,UAAU;GACT,MAAM;GACN,YAAY;GACZ,SAAS;GACT;EACD,aAAa;GACZ,MAAM,eAAe,UAAU;GAC/B,YAAY;GACZ;EACD,QAAQ;GACP,MAAM,eAAe,iBAAiB;GACtC,SAAS;GACT,YAAY;GACZ;EACD;CACD,CAAC;AACF,MAAM,yBAAyB,YAAY;CAC1C,MAAM;EACL,KAAK;EACL,SAAS;EACT,aAAa;EACb,MAAM;EACN,SAAS;EACT,QAAQ,CAAC,oBAAoB;EAC7B,MAAM;GACL;GACA;GACA;GACA;EACD,WAAW;EACX;CACD,IAAI;EACH,OAAO;EACP,QAAQ;EACR;CACD,QAAQ,EAAE,MAAM,QAAQ;CACxB,CAAC;AACF,MAAM,6BAA6B,cAAc;CAChD,MAAM;EACL,KAAK;EACL,SAAS;EACT,aAAa;EACb,MAAM;EACN,SAAS;EACT,QAAQ,CAAC,oBAAoB;EAC7B,MAAM;GACL;GACA;GACA;GACA;EACD,WAAW;EACX;CACD,IAAI;EACH,OAAO;EACP,QAAQ;EACR;CACD,QAAQ,EAAE,MAAM,SAAS;CACzB,WAAW;EACV,SAAS;GACR,OAAO,EAAE,KAAK,6BAA6B,mBAAmB;GAC9D,aAAa,EAAE,OAAO,aAAa;IAClC,MAAM,UAAU;IAChB,MAAM,SAAS;AACf,WAAO;KACN,UAAU,SAAS;KACnB,WAAW,SAAS;KACpB,aAAa,QAAQ;KACrB,cAAc,MAAM,QAAQ,QAAQ,SAAS,GAAG,QAAQ,SAAS,SAAS,KAAK;KAC/E;;GAEF;EACD,SAAS;GACR,OAAO,EAAE,KAAK,6BAA6B,uBAAuB;GAClE,aAAa,EAAE,OAAO,YAAY;IACjC,MAAM,UAAU;AAChB,WAAO;KACN,UAAU,SAAS;KACnB,WAAW,SAAS;KACpB,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,SAAS,UAAU;KAC1E;;GAEF;EACD;CACD,CAAC"}

package/dist/libs/contracts/dist/integrations/openbanking/contracts/index.js

@@ -0,0 +1,3 @@
+import "./accounts.js";
+import "./transactions.js";
+import "./balances.js";

package/dist/libs/contracts/dist/integrations/openbanking/contracts/transactions.js

@@ -0,0 +1,212 @@
+import { ScalarTypeEnum } from "../../../../../schema/dist/ScalarTypeEnum.js";
+import { SchemaModel } from "../../../../../schema/dist/SchemaModel.js";
+import "../../../../../schema/dist/index.js";
+import { defineCommand, defineQuery } from "../../../operations/operation.js";
+import "../../../operations/index.js";
+import { BankTransactionRecord } from "../models.js";
+import { OPENBANKING_TELEMETRY_EVENTS } from "../telemetry.js";
+
+//#region ../../libs/contracts/dist/integrations/openbanking/contracts/transactions.js
+const OpenBankingListTransactionsInput = new SchemaModel({
+	name: "OpenBankingListTransactionsInput",
+	description: "Parameters for listing bank transactions from the canonical ledger.",
+	fields: {
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		accountId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		from: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		to: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		cursor: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		pageSize: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true
+		},
+		direction: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		minimumAmount: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: true
+		},
+		maximumAmount: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: true
+		},
+		category: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		}
+	}
+});
+const OpenBankingListTransactionsOutput = new SchemaModel({
+	name: "OpenBankingListTransactionsOutput",
+	description: "Paginated list of transactions for a bank account.",
+	fields: {
+		transactions: {
+			type: BankTransactionRecord,
+			isOptional: false,
+			isArray: true
+		},
+		nextCursor: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		hasMore: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: true
+		}
+	}
+});
+const OpenBankingSyncTransactionsInput = new SchemaModel({
+	name: "OpenBankingSyncTransactionsInput",
+	description: "Command payload to synchronise transactions from the open banking provider into the canonical ledger.",
+	fields: {
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		accountId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		from: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		to: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		connectionId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: true
+		},
+		includePending: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: true
+		},
+		backfillDays: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true
+		}
+	}
+});
+const OpenBankingSyncTransactionsOutput = new SchemaModel({
+	name: "OpenBankingSyncTransactionsOutput",
+	description: "Result of a transaction synchronisation run.",
+	fields: {
+		synced: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		failed: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		earliestSyncedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		latestSyncedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		nextSinceToken: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		errors: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isArray: true,
+			isOptional: true
+		}
+	}
+});
+const OpenBankingListTransactions = defineQuery({
+	meta: {
+		key: "openbanking.transactions.list",
+		version: "1.0.0",
+		description: "List bank transactions that have been normalised into the canonical ledger.",
+		goal: "Allow downstream analytics and UI surfaces to page through canonical bank transactions.",
+		context: "Used by Pocket Family Office dashboards, reconciliation workflows, and analytics data views.",
+		owners: ["@platform.finance"],
+		tags: [
+			"open-banking",
+			"powens",
+			"transactions"
+		],
+		stability: "experimental"
+	},
+	io: {
+		input: OpenBankingListTransactionsInput,
+		output: OpenBankingListTransactionsOutput
+	},
+	policy: { auth: "user" }
+});
+const OpenBankingSyncTransactions = defineCommand({
+	meta: {
+		key: "openbanking.transactions.sync",
+		version: "1.0.0",
+		description: "Synchronise transactions for a bank account by calling the configured open banking provider.",
+		goal: "Ensure the canonical transaction ledger stays aligned with the external provider.",
+		context: "Triggered by scheduled workflows or on-demand actions when activity is expected on an account.",
+		owners: ["@platform.finance"],
+		tags: [
+			"open-banking",
+			"powens",
+			"transactions"
+		],
+		stability: "experimental"
+	},
+	io: {
+		input: OpenBankingSyncTransactionsInput,
+		output: OpenBankingSyncTransactionsOutput
+	},
+	policy: { auth: "admin" },
+	telemetry: {
+		success: {
+			event: { key: OPENBANKING_TELEMETRY_EVENTS.transactionsSynced },
+			properties: ({ input, output }) => {
+				const payload = input;
+				const result = output;
+				return {
+					tenantId: payload?.tenantId,
+					accountId: payload?.accountId,
+					synced: result?.synced,
+					failed: result?.failed,
+					earliestSyncedAt: result?.earliestSyncedAt,
+					latestSyncedAt: result?.latestSyncedAt
+				};
+			}
+		},
+		failure: {
+			event: { key: OPENBANKING_TELEMETRY_EVENTS.transactionsSyncFailed },
+			properties: ({ input, error }) => {
+				const payload = input;
+				return {
+					tenantId: payload?.tenantId,
+					accountId: payload?.accountId,
+					error: error instanceof Error ? error.message : String(error ?? "unknown")
+				};
+			}
+		}
+	}
+});
+
+//#endregion
+//# sourceMappingURL=transactions.js.map

package/dist/libs/contracts/dist/integrations/openbanking/contracts/transactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.js","names":[],"sources":["../../../../../../../../../libs/contracts/dist/integrations/openbanking/contracts/transactions.js"],"sourcesContent":["import { defineCommand, defineQuery } from \"../../../operations/operation.js\";\nimport \"../../../operations/index.js\";\nimport { BankTransactionRecord } from \"../models.js\";\nimport { OPENBANKING_TELEMETRY_EVENTS } from \"../telemetry.js\";\nimport { ScalarTypeEnum, SchemaModel } from \"@contractspec/lib.schema\";\n\n//#region src/integrations/openbanking/contracts/transactions.ts\nconst OpenBankingListTransactionsInput = new SchemaModel({\n\tname: \"OpenBankingListTransactionsInput\",\n\tdescription: \"Parameters for listing bank transactions from the canonical ledger.\",\n\tfields: {\n\t\ttenantId: {\n\t\t\ttype: ScalarTypeEnum.ID(),\n\t\t\tisOptional: false\n\t\t},\n\t\taccountId: {\n\t\t\ttype: ScalarTypeEnum.ID(),\n\t\t\tisOptional: false\n\t\t},\n\t\tfrom: {\n\t\t\ttype: ScalarTypeEnum.DateTime(),\n\t\t\tisOptional: true\n\t\t},\n\t\tto: {\n\t\t\ttype: ScalarTypeEnum.DateTime(),\n\t\t\tisOptional: true\n\t\t},\n\t\tcursor: {\n\t\t\ttype: ScalarTypeEnum.String_unsecure(),\n\t\t\tisOptional: true\n\t\t},\n\t\tpageSize: {\n\t\t\ttype: ScalarTypeEnum.Int_unsecure(),\n\t\t\tisOptional: true\n\t\t},\n\t\tdirection: {\n\t\t\ttype: ScalarTypeEnum.String_unsecure(),\n\t\t\tisOptional: true\n\t\t},\n\t\tminimumAmount: {\n\t\t\ttype: ScalarTypeEnum.Float_unsecure(),\n\t\t\tisOptional: true\n\t\t},\n\t\tmaximumAmount: {\n\t\t\ttype: ScalarTypeEnum.Float_unsecure(),\n\t\t\tisOptional: true\n\t\t},\n\t\tcategory: {\n\t\t\ttype: ScalarTypeEnum.String_unsecure(),\n\t\t\tisOptional: true\n\t\t}\n\t}\n});\nconst OpenBankingListTransactionsOutput = new SchemaModel({\n\tname: \"OpenBankingListTransactionsOutput\",\n\tdescription: \"Paginated list of transactions for a bank account.\",\n\tfields: {\n\t\ttransactions: {\n\t\t\ttype: BankTransactionRecord,\n\t\t\tisOptional: false,\n\t\t\tisArray: true\n\t\t},\n\t\tnextCursor: {\n\t\t\ttype: ScalarTypeEnum.String_unsecure(),\n\t\t\tisOptional: true\n\t\t},\n\t\thasMore: {\n\t\t\ttype: ScalarTypeEnum.Boolean(),\n\t\t\tisOptional: true\n\t\t}\n\t}\n});\nconst OpenBankingSyncTransactionsInput = new SchemaModel({\n\tname: \"OpenBankingSyncTransactionsInput\",\n\tdescription: \"Command payload to synchronise transactions from the open banking provider into the canonical ledger.\",\n\tfields: {\n\t\ttenantId: {\n\t\t\ttype: ScalarTypeEnum.ID(),\n\t\t\tisOptional: false\n\t\t},\n\t\taccountId: {\n\t\t\ttype: ScalarTypeEnum.ID(),\n\t\t\tisOptional: false\n\t\t},\n\t\tfrom: {\n\t\t\ttype: ScalarTypeEnum.DateTime(),\n\t\t\tisOptional: true\n\t\t},\n\t\tto: {\n\t\t\ttype: ScalarTypeEnum.DateTime(),\n\t\t\tisOptional: true\n\t\t},\n\t\tconnectionId: {\n\t\t\ttype: ScalarTypeEnum.ID(),\n\t\t\tisOptional: true\n\t\t},\n\t\tincludePending: {\n\t\t\ttype: ScalarTypeEnum.Boolean(),\n\t\t\tisOptional: true\n\t\t},\n\t\tbackfillDays: {\n\t\t\ttype: ScalarTypeEnum.Int_unsecure(),\n\t\t\tisOptional: true\n\t\t}\n\t}\n});\nconst OpenBankingSyncTransactionsOutput = new SchemaModel({\n\tname: \"OpenBankingSyncTransactionsOutput\",\n\tdescription: \"Result of a transaction synchronisation run.\",\n\tfields: {\n\t\tsynced: {\n\t\t\ttype: ScalarTypeEnum.Int_unsecure(),\n\t\t\tisOptional: false\n\t\t},\n\t\tfailed: {\n\t\t\ttype: ScalarTypeEnum.Int_unsecure(),\n\t\t\tisOptional: false\n\t\t},\n\t\tearliestSyncedAt: {\n\t\t\ttype: ScalarTypeEnum.DateTime(),\n\t\t\tisOptional: true\n\t\t},\n\t\tlatestSyncedAt: {\n\t\t\ttype: ScalarTypeEnum.DateTime(),\n\t\t\tisOptional: true\n\t\t},\n\t\tnextSinceToken: {\n\t\t\ttype: ScalarTypeEnum.String_unsecure(),\n\t\t\tisOptional: true\n\t\t},\n\t\terrors: {\n\t\t\ttype: ScalarTypeEnum.String_unsecure(),\n\t\t\tisArray: true,\n\t\t\tisOptional: true\n\t\t}\n\t}\n});\nconst OpenBankingListTransactions = defineQuery({\n\tmeta: {\n\t\tkey: \"openbanking.transactions.list\",\n\t\tversion: \"1.0.0\",\n\t\tdescription: \"List bank transactions that have been normalised into the canonical ledger.\",\n\t\tgoal: \"Allow downstream analytics and UI surfaces to page through canonical bank transactions.\",\n\t\tcontext: \"Used by Pocket Family Office dashboards, reconciliation workflows, and analytics data views.\",\n\t\towners: [\"@platform.finance\"],\n\t\ttags: [\n\t\t\t\"open-banking\",\n\t\t\t\"powens\",\n\t\t\t\"transactions\"\n\t\t],\n\t\tstability: \"experimental\"\n\t},\n\tio: {\n\t\tinput: OpenBankingListTransactionsInput,\n\t\toutput: OpenBankingListTransactionsOutput\n\t},\n\tpolicy: { auth: \"user\" }\n});\nconst OpenBankingSyncTransactions = defineCommand({\n\tmeta: {\n\t\tkey: \"openbanking.transactions.sync\",\n\t\tversion: \"1.0.0\",\n\t\tdescription: \"Synchronise transactions for a bank account by calling the configured open banking provider.\",\n\t\tgoal: \"Ensure the canonical transaction ledger stays aligned with the external provider.\",\n\t\tcontext: \"Triggered by scheduled workflows or on-demand actions when activity is expected on an account.\",\n\t\towners: [\"@platform.finance\"],\n\t\ttags: [\n\t\t\t\"open-banking\",\n\t\t\t\"powens\",\n\t\t\t\"transactions\"\n\t\t],\n\t\tstability: \"experimental\"\n\t},\n\tio: {\n\t\tinput: OpenBankingSyncTransactionsInput,\n\t\toutput: OpenBankingSyncTransactionsOutput\n\t},\n\tpolicy: { auth: \"admin\" },\n\ttelemetry: {\n\t\tsuccess: {\n\t\t\tevent: { key: OPENBANKING_TELEMETRY_EVENTS.transactionsSynced },\n\t\t\tproperties: ({ input, output }) => {\n\t\t\t\tconst payload = input;\n\t\t\t\tconst result = output;\n\t\t\t\treturn {\n\t\t\t\t\ttenantId: payload?.tenantId,\n\t\t\t\t\taccountId: payload?.accountId,\n\t\t\t\t\tsynced: result?.synced,\n\t\t\t\t\tfailed: result?.failed,\n\t\t\t\t\tearliestSyncedAt: result?.earliestSyncedAt,\n\t\t\t\t\tlatestSyncedAt: result?.latestSyncedAt\n\t\t\t\t};\n\t\t\t}\n\t\t},\n\t\tfailure: {\n\t\t\tevent: { key: OPENBANKING_TELEMETRY_EVENTS.transactionsSyncFailed },\n\t\t\tproperties: ({ input, error }) => {\n\t\t\t\tconst payload = input;\n\t\t\t\treturn {\n\t\t\t\t\ttenantId: payload?.tenantId,\n\t\t\t\t\taccountId: payload?.accountId,\n\t\t\t\t\terror: error instanceof Error ? error.message : String(error ?? \"unknown\")\n\t\t\t\t};\n\t\t\t}\n\t\t}\n\t}\n});\nconst openBankingTransactionContracts = {\n\tOpenBankingListTransactions,\n\tOpenBankingSyncTransactions\n};\nfunction registerOpenBankingTransactionContracts(registry) {\n\treturn registry.register(OpenBankingListTransactions).register(OpenBankingSyncTransactions);\n}\n\n//#endregion\nexport { OpenBankingListTransactions, OpenBankingSyncTransactions, openBankingTransactionContracts, registerOpenBankingTransactionContracts };"],"mappings":"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"}