@lssm/lib.contracts 1.41.0 → 1.42.1

package/dist/integrations/openbanking/models.js

@@ -1 +1,240 @@
-import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";const n=new t({name:`BankAccountRecord`,description:`Canonical representation of a bank account synced from an open banking provider.`,fields:{id:{type:e.ID(),isOptional:!1},tenantId:{type:e.ID(),isOptional:!1},userId:{type:e.ID(),isOptional:!1},connectionId:{type:e.ID(),isOptional:!1},externalId:{type:e.NonEmptyString(),isOptional:!1},institutionId:{type:e.NonEmptyString(),isOptional:!1},institutionName:{type:e.NonEmptyString(),isOptional:!1},institutionLogoUrl:{type:e.URL(),isOptional:!0},iban:{type:e.String_unsecure(),isOptional:!0},bic:{type:e.String_unsecure(),isOptional:!0},accountType:{type:e.NonEmptyString(),isOptional:!1},currency:{type:e.Currency(),isOptional:!1},displayName:{type:e.NonEmptyString(),isOptional:!1},accountNumberMasked:{type:e.String_unsecure(),isOptional:!0},productCode:{type:e.String_unsecure(),isOptional:!0},balance:{type:e.Float_unsecure(),isOptional:!0},availableBalance:{type:e.Float_unsecure(),isOptional:!0},lastSyncedAt:{type:e.DateTime(),isOptional:!1},createdAt:{type:e.DateTime(),isOptional:!1},updatedAt:{type:e.DateTime(),isOptional:!1},metadata:{type:e.JSONObject(),isOptional:!0}}}),r=new t({name:`BankTransactionRecord`,description:`Canonical transaction entry mapped from Powens into the open banking ledger.`,fields:{id:{type:e.ID(),isOptional:!1},accountId:{type:e.ID(),isOptional:!1},tenantId:{type:e.ID(),isOptional:!1},connectionId:{type:e.ID(),isOptional:!1},externalId:{type:e.NonEmptyString(),isOptional:!1},amount:{type:e.Float_unsecure(),isOptional:!1},currency:{type:e.Currency(),isOptional:!1},date:{type:e.DateTime(),isOptional:!1},bookingDate:{type:e.DateTime(),isOptional:!0},valueDate:{type:e.DateTime(),isOptional:!0},description:{type:e.String_unsecure(),isOptional:!0},counterpartyName:{type:e.String_unsecure(),isOptional:!0},counterpartyAccount:{type:e.String_unsecure(),isOptional:!0},merchantCategoryCode:{type:e.String_unsecure(),isOptional:!0},rawCategory:{type:e.String_unsecure(),isOptional:!0},standardizedCategory:{type:e.String_unsecure(),isOptional:!0},transactionType:{type:e.NonEmptyString(),isOptional:!1},status:{type:e.NonEmptyString(),isOptional:!1},runningBalance:{type:e.Float_unsecure(),isOptional:!0},metadata:{type:e.JSONObject(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1},updatedAt:{type:e.DateTime(),isOptional:!1}}}),i=new t({name:`AccountBalanceRecord`,description:`Canonical balance snapshot computed from Powens balance payloads.`,fields:{id:{type:e.ID(),isOptional:!1},accountId:{type:e.ID(),isOptional:!1},tenantId:{type:e.ID(),isOptional:!1},connectionId:{type:e.ID(),isOptional:!1},balanceType:{type:e.NonEmptyString(),isOptional:!1},currentBalance:{type:e.Float_unsecure(),isOptional:!1},availableBalance:{type:e.Float_unsecure(),isOptional:!0},currency:{type:e.Currency(),isOptional:!1},lastUpdatedAt:{type:e.DateTime(),isOptional:!1},createdAt:{type:e.DateTime(),isOptional:!1},metadata:{type:e.JSONObject(),isOptional:!0}}});export{i as AccountBalanceRecord,n as BankAccountRecord,r as BankTransactionRecord};
+import { ScalarTypeEnum, SchemaModel } from "@lssm/lib.schema";
+
+//#region src/integrations/openbanking/models.ts
+const BankAccountRecord = new SchemaModel({
+	name: "BankAccountRecord",
+	description: "Canonical representation of a bank account synced from an open banking provider.",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		userId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		connectionId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		externalId: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		institutionId: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		institutionName: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		institutionLogoUrl: {
+			type: ScalarTypeEnum.URL(),
+			isOptional: true
+		},
+		iban: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		bic: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		accountType: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		currency: {
+			type: ScalarTypeEnum.Currency(),
+			isOptional: false
+		},
+		displayName: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		accountNumberMasked: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		productCode: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		balance: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: true
+		},
+		availableBalance: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: true
+		},
+		lastSyncedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		updatedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		metadata: {
+			type: ScalarTypeEnum.JSONObject(),
+			isOptional: true
+		}
+	}
+});
+const BankTransactionRecord = new SchemaModel({
+	name: "BankTransactionRecord",
+	description: "Canonical transaction entry mapped from Powens into the open banking ledger.",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		accountId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		connectionId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		externalId: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		amount: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: false
+		},
+		currency: {
+			type: ScalarTypeEnum.Currency(),
+			isOptional: false
+		},
+		date: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		bookingDate: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		valueDate: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		description: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		counterpartyName: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		counterpartyAccount: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		merchantCategoryCode: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		rawCategory: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		standardizedCategory: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		transactionType: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		status: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		runningBalance: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: true
+		},
+		metadata: {
+			type: ScalarTypeEnum.JSONObject(),
+			isOptional: true
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		updatedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const AccountBalanceRecord = new SchemaModel({
+	name: "AccountBalanceRecord",
+	description: "Canonical balance snapshot computed from Powens balance payloads.",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		accountId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		connectionId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		balanceType: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		currentBalance: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: false
+		},
+		availableBalance: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: true
+		},
+		currency: {
+			type: ScalarTypeEnum.Currency(),
+			isOptional: false
+		},
+		lastUpdatedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		metadata: {
+			type: ScalarTypeEnum.JSONObject(),
+			isOptional: true
+		}
+	}
+});
+
+//#endregion
+export { AccountBalanceRecord, BankAccountRecord, BankTransactionRecord };

package/dist/integrations/openbanking/openbanking.feature.d.ts

@@ -0,0 +1,11 @@
+import { FeatureModuleSpec } from "../../features.js";
+
+//#region src/integrations/openbanking/openbanking.feature.d.ts
+
+/**
+ * OpenBanking feature module that bundles account, balance,
+ * and transaction synchronization capabilities.
+ */
+declare const OpenBankingFeature: FeatureModuleSpec;
+//#endregion
+export { OpenBankingFeature };

package/dist/integrations/openbanking/openbanking.feature.js

@@ -1 +1,69 @@
-const e={meta:{key:`openbanking`,title:`Open Banking Integration`,description:`Open banking account sync, balance refresh, and transaction synchronization`,domain:`integrations`,owners:[`@platform.finance`],tags:[`open-banking`,`powens`,`finance`,`banking`],stability:`experimental`},operations:[{name:`openbanking.accounts.sync`,version:1},{name:`openbanking.accounts.list`,version:1},{name:`openbanking.accounts.get`,version:1},{name:`openbanking.balances.refresh`,version:1},{name:`openbanking.balances.get`,version:1},{name:`openbanking.transactions.sync`,version:1},{name:`openbanking.transactions.list`,version:1}],events:[],presentations:[],opToPresentation:[],presentationsTargets:[],capabilities:{provides:[{key:`openbanking`,version:1}],requires:[{key:`identity`,version:1}]}};export{e as OpenBankingFeature};
+//#region src/integrations/openbanking/openbanking.feature.ts
+/**
+* OpenBanking feature module that bundles account, balance,
+* and transaction synchronization capabilities.
+*/
+const OpenBankingFeature = {
+	meta: {
+		key: "openbanking",
+		version: 1,
+		title: "Open Banking Integration",
+		description: "Open banking account sync, balance refresh, and transaction synchronization",
+		domain: "integrations",
+		owners: ["@platform.finance"],
+		tags: [
+			"open-banking",
+			"powens",
+			"finance",
+			"banking"
+		],
+		stability: "experimental"
+	},
+	operations: [
+		{
+			key: "openbanking.accounts.sync",
+			version: 1
+		},
+		{
+			key: "openbanking.accounts.list",
+			version: 1
+		},
+		{
+			key: "openbanking.accounts.get",
+			version: 1
+		},
+		{
+			key: "openbanking.balances.refresh",
+			version: 1
+		},
+		{
+			key: "openbanking.balances.get",
+			version: 1
+		},
+		{
+			key: "openbanking.transactions.sync",
+			version: 1
+		},
+		{
+			key: "openbanking.transactions.list",
+			version: 1
+		}
+	],
+	events: [],
+	presentations: [],
+	opToPresentation: [],
+	presentationsTargets: [],
+	capabilities: {
+		provides: [{
+			key: "openbanking",
+			version: 1
+		}],
+		requires: [{
+			key: "identity",
+			version: 1
+		}]
+	}
+};
+
+//#endregion
+export { OpenBankingFeature };

package/dist/integrations/openbanking/telemetry.d.ts

@@ -0,0 +1,15 @@
+//#region src/integrations/openbanking/telemetry.d.ts
+declare const OPENBANKING_PII_FIELDS: readonly ["iban", "bic", "accountNumberMasked", "accountNumber", "counterpartyName", "counterpartyAccount", "description", "merchantName", "merchantCategoryCode", "reference"];
+declare const OPENBANKING_TELEMETRY_EVENTS: {
+  readonly accountsSynced: "openbanking.accounts.synced";
+  readonly accountsSyncFailed: "openbanking.accounts.sync_failed";
+  readonly transactionsSynced: "openbanking.transactions.synced";
+  readonly transactionsSyncFailed: "openbanking.transactions.sync_failed";
+  readonly balancesRefreshed: "openbanking.balances.refreshed";
+  readonly balancesRefreshFailed: "openbanking.balances.refresh_failed";
+  readonly overviewGenerated: "openbanking.overview.generated";
+};
+type OpenBankingTelemetryEvent = (typeof OPENBANKING_TELEMETRY_EVENTS)[keyof typeof OPENBANKING_TELEMETRY_EVENTS];
+declare function redactOpenBankingTelemetryPayload<T extends Record<string, unknown>>(payload: T): T;
+//#endregion
+export { OPENBANKING_PII_FIELDS, OPENBANKING_TELEMETRY_EVENTS, OpenBankingTelemetryEvent, redactOpenBankingTelemetryPayload };

package/dist/integrations/openbanking/telemetry.js

@@ -1 +1,39 @@
-const e=[`iban`,`bic`,`accountNumberMasked`,`accountNumber`,`counterpartyName`,`counterpartyAccount`,`description`,`merchantName`,`merchantCategoryCode`,`reference`],t={accountsSynced:`openbanking.accounts.synced`,accountsSyncFailed:`openbanking.accounts.sync_failed`,transactionsSynced:`openbanking.transactions.synced`,transactionsSyncFailed:`openbanking.transactions.sync_failed`,balancesRefreshed:`openbanking.balances.refreshed`,balancesRefreshFailed:`openbanking.balances.refresh_failed`,overviewGenerated:`openbanking.overview.generated`};function n(t){let i={};for(let[a,o]of Object.entries(t))e.includes(a)?i[a]=r(o):Array.isArray(o)?i[a]=o.map(e=>typeof e==`object`&&e?n(e):e):typeof o==`object`&&o?i[a]=n(o):i[a]=o;return i}function r(e){if(e==null)return``;let t=String(e);return t.length<=4?`*`.repeat(t.length):`${`*`.repeat(Math.max(t.length-4,0))}${t.slice(-4)}`}export{e as OPENBANKING_PII_FIELDS,t as OPENBANKING_TELEMETRY_EVENTS,n as redactOpenBankingTelemetryPayload};
+//#region src/integrations/openbanking/telemetry.ts
+const OPENBANKING_PII_FIELDS = [
+	"iban",
+	"bic",
+	"accountNumberMasked",
+	"accountNumber",
+	"counterpartyName",
+	"counterpartyAccount",
+	"description",
+	"merchantName",
+	"merchantCategoryCode",
+	"reference"
+];
+const OPENBANKING_TELEMETRY_EVENTS = {
+	accountsSynced: "openbanking.accounts.synced",
+	accountsSyncFailed: "openbanking.accounts.sync_failed",
+	transactionsSynced: "openbanking.transactions.synced",
+	transactionsSyncFailed: "openbanking.transactions.sync_failed",
+	balancesRefreshed: "openbanking.balances.refreshed",
+	balancesRefreshFailed: "openbanking.balances.refresh_failed",
+	overviewGenerated: "openbanking.overview.generated"
+};
+function redactOpenBankingTelemetryPayload(payload) {
+	const redacted = {};
+	for (const [key, value] of Object.entries(payload)) if (OPENBANKING_PII_FIELDS.includes(key)) redacted[key] = maskValue(value);
+	else if (Array.isArray(value)) redacted[key] = value.map((item) => typeof item === "object" && item !== null ? redactOpenBankingTelemetryPayload(item) : item);
+	else if (typeof value === "object" && value !== null) redacted[key] = redactOpenBankingTelemetryPayload(value);
+	else redacted[key] = value;
+	return redacted;
+}
+function maskValue(value) {
+	if (value == null) return "";
+	const str = String(value);
+	if (str.length <= 4) return "*".repeat(str.length);
+	return `${"*".repeat(Math.max(str.length - 4, 0))}${str.slice(-4)}`;
+}
+
+//#endregion
+export { OPENBANKING_PII_FIELDS, OPENBANKING_TELEMETRY_EVENTS, redactOpenBankingTelemetryPayload };