@lssm/lib.contracts-integrations 9.0.1

package/dist/integrations/openbanking/contracts/transactions.d.ts

@@ -0,0 +1,206 @@
+import { type AnyOperationSpec } from '@lssm/lib.contracts-spec/operations';
+import type { OperationSpecRegistry } from '@lssm/lib.contracts-spec/operations/registry';
+import { SchemaModel } from '@lssm/lib.schema';
+export declare const OpenBankingListTransactions: import("@lssm/lib.contracts-spec").OperationSpec<SchemaModel<{
+    tenantId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    accountId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    from: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: true;
+    };
+    to: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: true;
+    };
+    cursor: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    pageSize: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: true;
+    };
+    direction: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    minimumAmount: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: true;
+    };
+    maximumAmount: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: true;
+    };
+    category: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+}>, SchemaModel<{
+    transactions: {
+        type: SchemaModel<{
+            id: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: false;
+            };
+            accountId: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: false;
+            };
+            tenantId: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: false;
+            };
+            connectionId: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: false;
+            };
+            externalId: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: false;
+            };
+            amount: {
+                type: import("@lssm/lib.schema").FieldType<number, number>;
+                isOptional: false;
+            };
+            currency: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: false;
+            };
+            date: {
+                type: import("@lssm/lib.schema").FieldType<Date, string>;
+                isOptional: false;
+            };
+            bookingDate: {
+                type: import("@lssm/lib.schema").FieldType<Date, string>;
+                isOptional: true;
+            };
+            valueDate: {
+                type: import("@lssm/lib.schema").FieldType<Date, string>;
+                isOptional: true;
+            };
+            description: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: true;
+            };
+            counterpartyName: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: true;
+            };
+            counterpartyAccount: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: true;
+            };
+            merchantCategoryCode: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: true;
+            };
+            rawCategory: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: true;
+            };
+            standardizedCategory: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: true;
+            };
+            transactionType: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: false;
+            };
+            status: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: false;
+            };
+            runningBalance: {
+                type: import("@lssm/lib.schema").FieldType<number, number>;
+                isOptional: true;
+            };
+            metadata: {
+                type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+                isOptional: true;
+            };
+            createdAt: {
+                type: import("@lssm/lib.schema").FieldType<Date, string>;
+                isOptional: false;
+            };
+            updatedAt: {
+                type: import("@lssm/lib.schema").FieldType<Date, string>;
+                isOptional: false;
+            };
+        }>;
+        isOptional: false;
+        isArray: true;
+    };
+    nextCursor: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    hasMore: {
+        type: import("@lssm/lib.schema").FieldType<boolean, boolean>;
+        isOptional: true;
+    };
+}>, undefined>;
+export declare const OpenBankingSyncTransactions: import("@lssm/lib.contracts-spec").OperationSpec<SchemaModel<{
+    tenantId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    accountId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    from: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: true;
+    };
+    to: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: true;
+    };
+    connectionId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    includePending: {
+        type: import("@lssm/lib.schema").FieldType<boolean, boolean>;
+        isOptional: true;
+    };
+    backfillDays: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: true;
+    };
+}>, SchemaModel<{
+    synced: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: false;
+    };
+    failed: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: false;
+    };
+    earliestSyncedAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: true;
+    };
+    latestSyncedAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: true;
+    };
+    nextSinceToken: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    errors: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isArray: true;
+        isOptional: true;
+    };
+}>, undefined>;
+export declare const openBankingTransactionContracts: Record<string, AnyOperationSpec>;
+export declare function registerOpenBankingTransactionContracts(registry: OperationSpecRegistry): OperationSpecRegistry;

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

@@ -0,0 +1,2 @@
+// @bun
+import{defineCommand as g,defineQuery as m}from"@lssm/lib.contracts-spec/operations";import{ScalarTypeEnum as n,SchemaModel as r}from"@lssm/lib.schema";import{ScalarTypeEnum as e,SchemaModel as c}from"@lssm/lib.schema";var _=new c({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}}}),l=new c({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}}}),E=new c({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}}});var O=["iban","bic","accountNumberMasked","accountNumber","counterpartyName","counterpartyAccount","description","merchantName","merchantCategoryCode","reference"],p={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 u(s){let t={};for(let[i,a]of Object.entries(s))if(O.includes(i))t[i]=f(a);else if(Array.isArray(a))t[i]=a.map((o)=>typeof o==="object"&&o!==null?u(o):o);else if(typeof a==="object"&&a!==null)t[i]=u(a);else t[i]=a;return t}function f(s){if(s==null)return"";let t=String(s);if(t.length<=4)return"*".repeat(t.length);return`${"*".repeat(Math.max(t.length-4,0))}${t.slice(-4)}`}var S=new r({name:"OpenBankingListTransactionsInput",description:"Parameters for listing bank transactions from the canonical ledger.",fields:{tenantId:{type:n.ID(),isOptional:!1},accountId:{type:n.ID(),isOptional:!1},from:{type:n.DateTime(),isOptional:!0},to:{type:n.DateTime(),isOptional:!0},cursor:{type:n.String_unsecure(),isOptional:!0},pageSize:{type:n.Int_unsecure(),isOptional:!0},direction:{type:n.String_unsecure(),isOptional:!0},minimumAmount:{type:n.Float_unsecure(),isOptional:!0},maximumAmount:{type:n.Float_unsecure(),isOptional:!0},category:{type:n.String_unsecure(),isOptional:!0}}}),I=new r({name:"OpenBankingListTransactionsOutput",description:"Paginated list of transactions for a bank account.",fields:{transactions:{type:l,isOptional:!1,isArray:!0},nextCursor:{type:n.String_unsecure(),isOptional:!0},hasMore:{type:n.Boolean(),isOptional:!0}}}),k=new r({name:"OpenBankingSyncTransactionsInput",description:"Command payload to synchronise transactions from the open banking provider into the canonical ledger.",fields:{tenantId:{type:n.ID(),isOptional:!1},accountId:{type:n.ID(),isOptional:!1},from:{type:n.DateTime(),isOptional:!0},to:{type:n.DateTime(),isOptional:!0},connectionId:{type:n.ID(),isOptional:!0},includePending:{type:n.Boolean(),isOptional:!0},backfillDays:{type:n.Int_unsecure(),isOptional:!0}}}),b=new r({name:"OpenBankingSyncTransactionsOutput",description:"Result of a transaction synchronisation run.",fields:{synced:{type:n.Int_unsecure(),isOptional:!1},failed:{type:n.Int_unsecure(),isOptional:!1},earliestSyncedAt:{type:n.DateTime(),isOptional:!0},latestSyncedAt:{type:n.DateTime(),isOptional:!0},nextSinceToken:{type:n.String_unsecure(),isOptional:!0},errors:{type:n.String_unsecure(),isArray:!0,isOptional:!0}}}),y=m({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:S,output:I},policy:{auth:"user"}}),d=g({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:k,output:b},policy:{auth:"admin"},telemetry:{success:{event:{key:p.transactionsSynced},properties:({input:s,output:t})=>{let i=s,a=t;return{tenantId:i?.tenantId,accountId:i?.accountId,synced:a?.synced,failed:a?.failed,earliestSyncedAt:a?.earliestSyncedAt,latestSyncedAt:a?.latestSyncedAt}}},failure:{event:{key:p.transactionsSyncFailed},properties:({input:s,error:t})=>{let i=s;return{tenantId:i?.tenantId,accountId:i?.accountId,error:t instanceof Error?t.message:String(t??"unknown")}}}}}),x={OpenBankingListTransactions:y,OpenBankingSyncTransactions:d};function R(s){return s.register(y).register(d)}export{y as OpenBankingListTransactions,d as OpenBankingSyncTransactions,x as openBankingTransactionContracts,R as registerOpenBankingTransactionContracts};

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

@@ -0,0 +1,8 @@
+import type { ResolvedAppConfig, ResolvedIntegration } from '@lssm/lib.contracts-spec/app-config/runtime';
+export interface OpenBankingGuardResult {
+    ok: boolean;
+    integration?: ResolvedIntegration;
+    error?: string;
+}
+export declare function ensurePrimaryOpenBankingIntegration(config: ResolvedAppConfig): OpenBankingGuardResult;
+export declare function assertPrimaryOpenBankingReady(config: ResolvedAppConfig): ResolvedIntegration;

package/dist/integrations/openbanking/guards.js

@@ -0,0 +1,2 @@
+// @bun
+function t(r){let n=r.integrations.find((o)=>o.slot.slotId==="primaryOpenBanking");if(!n)return{ok:!1,error:"primaryOpenBanking slot is not bound in the resolved app config."};let e=n.connection.status;if(e==="error"||e==="disconnected")return{ok:!1,integration:n,error:`primaryOpenBanking connection is in status "${e}".`};if(e==="unknown")return{ok:!1,integration:n,error:"primaryOpenBanking connection health is unknown."};return{ok:!0,integration:n}}function i(r){let n=t(r);if(!n.ok)throw Error(n.error??"Open banking integration not available.");if(!n.integration)throw Error(n.error??"Open banking integration not available.");return n.integration}export{i as assertPrimaryOpenBankingReady,t as ensurePrimaryOpenBankingIntegration};

package/dist/integrations/openbanking/guards.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,223 @@
+import { SchemaModel } from '@lssm/lib.schema';
+export declare const BankAccountRecord: SchemaModel<{
+    id: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    tenantId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    userId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    connectionId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    externalId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    institutionId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    institutionName: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    institutionLogoUrl: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    iban: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    bic: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    accountType: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    currency: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    displayName: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    accountNumberMasked: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    productCode: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    balance: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: true;
+    };
+    availableBalance: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: true;
+    };
+    lastSyncedAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+    createdAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+    updatedAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+    metadata: {
+        type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: true;
+    };
+}>;
+export declare const BankTransactionRecord: SchemaModel<{
+    id: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    accountId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    tenantId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    connectionId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    externalId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    amount: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: false;
+    };
+    currency: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    date: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+    bookingDate: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: true;
+    };
+    valueDate: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: true;
+    };
+    description: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    counterpartyName: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    counterpartyAccount: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    merchantCategoryCode: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    rawCategory: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    standardizedCategory: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    transactionType: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    status: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    runningBalance: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: true;
+    };
+    metadata: {
+        type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: true;
+    };
+    createdAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+    updatedAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+}>;
+export declare const AccountBalanceRecord: SchemaModel<{
+    id: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    accountId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    tenantId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    connectionId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    balanceType: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    currentBalance: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: false;
+    };
+    availableBalance: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: true;
+    };
+    currency: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    lastUpdatedAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+    createdAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+    metadata: {
+        type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: true;
+    };
+}>;

package/dist/integrations/openbanking/models.js

@@ -0,0 +1,2 @@
+// @bun
+import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";var 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}}}),i=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}}}),p=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{p as AccountBalanceRecord,n as BankAccountRecord,i as BankTransactionRecord};

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

@@ -0,0 +1 @@
+export declare const OpenBankingCapability: import("@lssm/lib.contracts-spec").CapabilitySpec;

package/dist/integrations/openbanking/openbanking.capability.js

@@ -0,0 +1,2 @@
+// @bun
+import{defineCapability as i}from"@lssm/lib.contracts-spec/capabilities";import{StabilityEnum as n}from"@lssm/lib.contracts-spec/ownership";var e=i({meta:{key:"openbanking",version:"1.0.0",kind:"integration",stability:n.Experimental,description:"Open Banking integrations capability",owners:["@platform.finance"],tags:["openbanking","finance","integrations"]}});export{e as OpenBankingCapability};

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

@@ -0,0 +1,5 @@
+/**
+ * OpenBanking feature module that bundles account, balance,
+ * and transaction synchronization capabilities.
+ */
+export declare const OpenBankingFeature: import("@lssm/lib.contracts-spec").FeatureModuleSpec;

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

@@ -0,0 +1,2 @@
+// @bun
+import{defineFeature as n}from"@lssm/lib.contracts-spec/features";var i=n({meta:{key:"openbanking",version:"1.0.0",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.0.0"},{key:"openbanking.accounts.list",version:"1.0.0"},{key:"openbanking.accounts.get",version:"1.0.0"},{key:"openbanking.balances.refresh",version:"1.0.0"},{key:"openbanking.balances.get",version:"1.0.0"},{key:"openbanking.transactions.sync",version:"1.0.0"},{key:"openbanking.transactions.list",version:"1.0.0"}],events:[],presentations:[],opToPresentation:[],presentationsTargets:[],capabilities:{provides:[{key:"openbanking",version:"1.0.0"}],requires:[{key:"identity",version:"1.0.0"}]}});export{i as OpenBankingFeature};

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

@@ -0,0 +1,12 @@
+export declare const OPENBANKING_PII_FIELDS: readonly ['iban', 'bic', 'accountNumberMasked', 'accountNumber', 'counterpartyName', 'counterpartyAccount', 'description', 'merchantName', 'merchantCategoryCode', 'reference'];
+export 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';
+};
+export type OpenBankingTelemetryEvent = (typeof OPENBANKING_TELEMETRY_EVENTS)[keyof typeof OPENBANKING_TELEMETRY_EVENTS];
+export declare function redactOpenBankingTelemetryPayload<T extends Record<string, unknown>>(payload: T): T;

package/dist/integrations/openbanking/telemetry.js

@@ -0,0 +1,2 @@
+// @bun
+var c=["iban","bic","accountNumberMasked","accountNumber","counterpartyName","counterpartyAccount","description","merchantName","merchantCategoryCode","reference"],i={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 o(a){let e={};for(let[t,n]of Object.entries(a))if(c.includes(t))e[t]=s(n);else if(Array.isArray(n))e[t]=n.map((r)=>typeof r==="object"&&r!==null?o(r):r);else if(typeof n==="object"&&n!==null)e[t]=o(n);else e[t]=n;return e}function s(a){if(a==null)return"";let e=String(a);if(e.length<=4)return"*".repeat(e.length);return`${"*".repeat(Math.max(e.length-4,0))}${e.slice(-4)}`}export{c as OPENBANKING_PII_FIELDS,i as OPENBANKING_TELEMETRY_EVENTS,o as redactOpenBankingTelemetryPayload};