joopjs 2.0.0

package/dist/statement-parser-BHQtXwCM.d.ts

@@ -0,0 +1,260 @@
+import { a as JoopBehaviorSubject, J as JoopObservable } from './index-Dz0gOur2.js';
+
+interface JoopReceiptLine {
+    label: string;
+    value: string;
+    bold?: boolean;
+}
+interface JoopReceiptData {
+    title: string;
+    referenceNumber: string;
+    timestamp: string;
+    lines: JoopReceiptLine[];
+    footer?: string;
+}
+declare class JoopReceiptService {
+    build(data: JoopReceiptData): JoopReceiptData;
+    toText(data: JoopReceiptData): string;
+    toJson(data: JoopReceiptData): string;
+    toHtml(data: JoopReceiptData): string;
+}
+
+interface JoopTransactionSignal {
+    transactionId: string;
+    amount: number;
+    currency: string;
+    timestamp: number;
+    deviceId?: string;
+    ipAddress?: string;
+    latitude?: number;
+    longitude?: number;
+    cardBin?: string;
+    merchantCategory?: string;
+    channel?: 'web' | 'mobile' | 'atm' | 'pos';
+    userId?: string;
+}
+interface JoopFraudSignalResult {
+    name: string;
+    score: number;
+    triggered: boolean;
+    detail?: string;
+}
+type JoopFraudLevel = 'low' | 'medium' | 'high' | 'critical';
+interface JoopFraudResult {
+    transactionId: string;
+    score: number;
+    level: JoopFraudLevel;
+    signals: JoopFraudSignalResult[];
+    recommendation: 'allow' | 'review' | 'challenge' | 'block';
+    timestamp: number;
+}
+interface JoopFraudConfig {
+    velocityWindowMs?: number;
+    velocityCountThreshold?: number;
+    velocityAmountThreshold?: number;
+    largeAmountThreshold?: number;
+    geoDistanceThresholdKm?: number;
+    alertThreshold?: number;
+    maxHistorySize?: number;
+}
+declare class JoopFraudDetection {
+    private readonly _cfg;
+    private _history;
+    private _alertHandlers;
+    readonly result$: JoopBehaviorSubject<JoopFraudResult | null>;
+    constructor(config?: JoopFraudConfig);
+    evaluate(signal: JoopTransactionSignal): JoopFraudResult;
+    addSignal(signal: JoopTransactionSignal): void;
+    clearHistory(userId?: string): void;
+    onAlert(handler: (result: JoopFraudResult) => void): () => void;
+    /** Velocity: count of transactions by same user/device in window — max 30 pts */
+    private _velocityCount;
+    /** Velocity: total amount by same user/device in window — max 25 pts */
+    private _velocityAmount;
+    /** Large single amount — max 20 pts */
+    private _largeAmount;
+    /** Geo distance from last transaction by same user — max 15 pts */
+    private _geoDistance;
+    /** Time anomaly: unusual hours 02:00–05:00 local time — max 10 pts */
+    private _timeAnomaly;
+}
+
+interface JoopOBCredentials {
+    clientId: string;
+    clientSecret: string;
+    baseUrl: string;
+    tokenUrl: string;
+}
+type JoopOBConsentStatus = 'AwaitingAuthorisation' | 'Authorised' | 'Rejected' | 'Consumed' | 'Expired';
+type JoopOBPaymentStatus = 'Pending' | 'AcceptedSettlementInProcess' | 'AcceptedSettlementCompleted' | 'Rejected' | 'Cancelled';
+type JoopOBAccountType = 'Personal' | 'Business';
+interface JoopOBAccount {
+    accountId: string;
+    iban?: string;
+    currency: string;
+    accountType: JoopOBAccountType;
+    nickname?: string;
+    balance?: {
+        amount: number;
+        currency: string;
+        creditDebitIndicator: 'Credit' | 'Debit';
+    };
+}
+interface JoopOBTransaction {
+    transactionId: string;
+    accountId: string;
+    amount: number;
+    currency: string;
+    creditDebitIndicator: 'Credit' | 'Debit';
+    status: 'Booked' | 'Pending';
+    bookingDateTime: string;
+    description?: string;
+    merchantName?: string;
+    reference?: string;
+}
+interface JoopOBPaymentRequest {
+    reference: string;
+    amount: number;
+    currency: string;
+    creditorName: string;
+    creditorIban: string;
+    debtorIban?: string;
+    remittanceInfo?: string;
+}
+interface JoopOBConsentRequest {
+    scopes: Array<'ReadAccountsBasic' | 'ReadAccountsDetail' | 'ReadBalances' | 'ReadTransactionsDetail' | 'ReadTransactionsCredits' | 'ReadTransactionsDebits'>;
+    expirationDateTime?: string;
+}
+declare class JoopOpenBankingClient {
+    private readonly _credentials;
+    private _token;
+    /** Reactive authentication state — true once a valid token is held */
+    readonly authenticated$: JoopBehaviorSubject<boolean>;
+    constructor(credentials: JoopOBCredentials);
+    authenticate(): Promise<void>;
+    getAccounts(consentId: string): Promise<JoopOBAccount[]>;
+    getTransactions(accountId: string, consentId: string, fromDate?: string, toDate?: string): Promise<JoopOBTransaction[]>;
+    createConsent(request: JoopOBConsentRequest): Promise<{
+        consentId: string;
+        authorisationUrl: string;
+        status: JoopOBConsentStatus;
+    }>;
+    getConsentStatus(consentId: string): Promise<JoopOBConsentStatus>;
+    revokeConsent(consentId: string): Promise<void>;
+    initiatePayment(request: JoopOBPaymentRequest): Promise<{
+        paymentId: string;
+        status: JoopOBPaymentStatus;
+        consentId: string;
+    }>;
+    getPaymentStatus(paymentId: string): Promise<JoopOBPaymentStatus>;
+    cancelPayment(paymentId: string): Promise<void>;
+    private _getToken;
+    private _fetchToken;
+    private _request;
+}
+
+type JoopPaymentStep = 'idle' | 'initiating' | 'awaiting_3ds' | 'processing_3ds' | 'authorised' | 'settled' | 'failed' | 'cancelled';
+interface JoopPaymentSession {
+    sessionId: string;
+    paymentId: string;
+    amount: number;
+    currency: string;
+    step: JoopPaymentStep;
+    threeDsUrl?: string;
+    threeDsData?: string;
+    errorCode?: string;
+    errorMessage?: string;
+    createdAt: number;
+    updatedAt: number;
+}
+interface JoopPaymentRequest {
+    amount: number;
+    currency: string;
+    cardNumber: string;
+    cardExpiry: string;
+    cvv: string;
+    merchantId: string;
+    reference: string;
+    returnUrl?: string;
+    notifyUrl?: string;
+    metadata?: Record<string, string>;
+}
+interface JoopThreeDsResult {
+    transactionId: string;
+    status: 'Y' | 'N' | 'U' | 'A';
+    eci: string;
+    cavv?: string;
+}
+interface JoopPaymentOrchestratorConfig {
+    gatewayUrl: string;
+    merchantId: string;
+    apiKey: string;
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+}
+declare class JoopPaymentOrchestrator {
+    private readonly _cfg;
+    private readonly _sessions;
+    constructor(config: JoopPaymentOrchestratorConfig);
+    initiate(request: JoopPaymentRequest): Promise<JoopPaymentSession>;
+    handle3ds(sessionId: string, result: JoopThreeDsResult): Promise<JoopPaymentSession>;
+    poll(sessionId: string): Promise<JoopPaymentSession>;
+    confirm(sessionId: string): Promise<JoopPaymentSession>;
+    cancel(sessionId: string): Promise<JoopPaymentSession>;
+    getSession(sessionId: string): JoopPaymentSession | null;
+    session$(sessionId: string): JoopObservable<JoopPaymentSession>;
+    destroy(): void;
+    private _requireSession;
+    private _updateSession;
+    private _generateSessionId;
+    private _fetch;
+}
+
+type JoopTxnType = 'credit' | 'debit' | 'fee' | 'interest' | 'transfer' | 'unknown';
+interface JoopTransaction {
+    id: string;
+    date: string;
+    valueDate?: string;
+    amount: number;
+    type: JoopTxnType;
+    currency: string;
+    description: string;
+    reference?: string;
+    balance?: number;
+    counterpartyName?: string;
+    counterpartyIban?: string;
+    category?: string;
+    raw?: string;
+}
+interface JoopStatementResult {
+    format: 'MT940' | 'OFX' | 'QIF' | 'CSV' | 'unknown';
+    accountId?: string;
+    currency?: string;
+    openingBalance?: number;
+    closingBalance?: number;
+    transactions: JoopTransaction[];
+    parseErrors: string[];
+}
+interface JoopCsvStatementConfig {
+    delimiter?: string;
+    dateColumn?: string | number;
+    amountColumn?: string | number;
+    creditColumn?: string | number;
+    debitColumn?: string | number;
+    descriptionColumn?: string | number;
+    referenceColumn?: string | number;
+    balanceColumn?: string | number;
+    dateFormat?: string;
+    hasHeader?: boolean;
+    skipRows?: number;
+}
+declare class JoopStatementParser {
+    parse(text: string, csvConfig?: JoopCsvStatementConfig): JoopStatementResult;
+    static detectFormat(text: string): 'MT940' | 'OFX' | 'QIF' | 'CSV' | 'unknown';
+    parseMT940(text: string): JoopStatementResult;
+    parseOFX(text: string): JoopStatementResult;
+    parseQIF(text: string): JoopStatementResult;
+    parseCsv(text: string, config?: JoopCsvStatementConfig): JoopStatementResult;
+}
+
+export { type JoopReceiptLine as A, type JoopTransaction as B, JoopReceiptService as J, JoopFraudDetection as a, JoopOpenBankingClient as b, JoopPaymentOrchestrator as c, JoopStatementParser as d, type JoopCsvStatementConfig as e, type JoopFraudConfig as f, type JoopFraudLevel as g, type JoopFraudResult as h, type JoopFraudSignalResult as i, type JoopOBAccount as j, type JoopOBAccountType as k, type JoopOBConsentRequest as l, type JoopOBConsentStatus as m, type JoopOBCredentials as n, type JoopOBPaymentRequest as o, type JoopOBPaymentStatus as p, type JoopOBTransaction as q, type JoopPaymentOrchestratorConfig as r, type JoopPaymentRequest as s, type JoopPaymentSession as t, type JoopPaymentStep as u, type JoopReceiptData as v, type JoopStatementResult as w, type JoopThreeDsResult as x, type JoopTransactionSignal as y, type JoopTxnType as z };

package/dist/statement-parser-C2qNmb49.d.mts

@@ -0,0 +1,260 @@
+import { a as JoopBehaviorSubject, J as JoopObservable } from './index-Dz0gOur2.mjs';
+
+interface JoopReceiptLine {
+    label: string;
+    value: string;
+    bold?: boolean;
+}
+interface JoopReceiptData {
+    title: string;
+    referenceNumber: string;
+    timestamp: string;
+    lines: JoopReceiptLine[];
+    footer?: string;
+}
+declare class JoopReceiptService {
+    build(data: JoopReceiptData): JoopReceiptData;
+    toText(data: JoopReceiptData): string;
+    toJson(data: JoopReceiptData): string;
+    toHtml(data: JoopReceiptData): string;
+}
+
+interface JoopTransactionSignal {
+    transactionId: string;
+    amount: number;
+    currency: string;
+    timestamp: number;
+    deviceId?: string;
+    ipAddress?: string;
+    latitude?: number;
+    longitude?: number;
+    cardBin?: string;
+    merchantCategory?: string;
+    channel?: 'web' | 'mobile' | 'atm' | 'pos';
+    userId?: string;
+}
+interface JoopFraudSignalResult {
+    name: string;
+    score: number;
+    triggered: boolean;
+    detail?: string;
+}
+type JoopFraudLevel = 'low' | 'medium' | 'high' | 'critical';
+interface JoopFraudResult {
+    transactionId: string;
+    score: number;
+    level: JoopFraudLevel;
+    signals: JoopFraudSignalResult[];
+    recommendation: 'allow' | 'review' | 'challenge' | 'block';
+    timestamp: number;
+}
+interface JoopFraudConfig {
+    velocityWindowMs?: number;
+    velocityCountThreshold?: number;
+    velocityAmountThreshold?: number;
+    largeAmountThreshold?: number;
+    geoDistanceThresholdKm?: number;
+    alertThreshold?: number;
+    maxHistorySize?: number;
+}
+declare class JoopFraudDetection {
+    private readonly _cfg;
+    private _history;
+    private _alertHandlers;
+    readonly result$: JoopBehaviorSubject<JoopFraudResult | null>;
+    constructor(config?: JoopFraudConfig);
+    evaluate(signal: JoopTransactionSignal): JoopFraudResult;
+    addSignal(signal: JoopTransactionSignal): void;
+    clearHistory(userId?: string): void;
+    onAlert(handler: (result: JoopFraudResult) => void): () => void;
+    /** Velocity: count of transactions by same user/device in window — max 30 pts */
+    private _velocityCount;
+    /** Velocity: total amount by same user/device in window — max 25 pts */
+    private _velocityAmount;
+    /** Large single amount — max 20 pts */
+    private _largeAmount;
+    /** Geo distance from last transaction by same user — max 15 pts */
+    private _geoDistance;
+    /** Time anomaly: unusual hours 02:00–05:00 local time — max 10 pts */
+    private _timeAnomaly;
+}
+
+interface JoopOBCredentials {
+    clientId: string;
+    clientSecret: string;
+    baseUrl: string;
+    tokenUrl: string;
+}
+type JoopOBConsentStatus = 'AwaitingAuthorisation' | 'Authorised' | 'Rejected' | 'Consumed' | 'Expired';
+type JoopOBPaymentStatus = 'Pending' | 'AcceptedSettlementInProcess' | 'AcceptedSettlementCompleted' | 'Rejected' | 'Cancelled';
+type JoopOBAccountType = 'Personal' | 'Business';
+interface JoopOBAccount {
+    accountId: string;
+    iban?: string;
+    currency: string;
+    accountType: JoopOBAccountType;
+    nickname?: string;
+    balance?: {
+        amount: number;
+        currency: string;
+        creditDebitIndicator: 'Credit' | 'Debit';
+    };
+}
+interface JoopOBTransaction {
+    transactionId: string;
+    accountId: string;
+    amount: number;
+    currency: string;
+    creditDebitIndicator: 'Credit' | 'Debit';
+    status: 'Booked' | 'Pending';
+    bookingDateTime: string;
+    description?: string;
+    merchantName?: string;
+    reference?: string;
+}
+interface JoopOBPaymentRequest {
+    reference: string;
+    amount: number;
+    currency: string;
+    creditorName: string;
+    creditorIban: string;
+    debtorIban?: string;
+    remittanceInfo?: string;
+}
+interface JoopOBConsentRequest {
+    scopes: Array<'ReadAccountsBasic' | 'ReadAccountsDetail' | 'ReadBalances' | 'ReadTransactionsDetail' | 'ReadTransactionsCredits' | 'ReadTransactionsDebits'>;
+    expirationDateTime?: string;
+}
+declare class JoopOpenBankingClient {
+    private readonly _credentials;
+    private _token;
+    /** Reactive authentication state — true once a valid token is held */
+    readonly authenticated$: JoopBehaviorSubject<boolean>;
+    constructor(credentials: JoopOBCredentials);
+    authenticate(): Promise<void>;
+    getAccounts(consentId: string): Promise<JoopOBAccount[]>;
+    getTransactions(accountId: string, consentId: string, fromDate?: string, toDate?: string): Promise<JoopOBTransaction[]>;
+    createConsent(request: JoopOBConsentRequest): Promise<{
+        consentId: string;
+        authorisationUrl: string;
+        status: JoopOBConsentStatus;
+    }>;
+    getConsentStatus(consentId: string): Promise<JoopOBConsentStatus>;
+    revokeConsent(consentId: string): Promise<void>;
+    initiatePayment(request: JoopOBPaymentRequest): Promise<{
+        paymentId: string;
+        status: JoopOBPaymentStatus;
+        consentId: string;
+    }>;
+    getPaymentStatus(paymentId: string): Promise<JoopOBPaymentStatus>;
+    cancelPayment(paymentId: string): Promise<void>;
+    private _getToken;
+    private _fetchToken;
+    private _request;
+}
+
+type JoopPaymentStep = 'idle' | 'initiating' | 'awaiting_3ds' | 'processing_3ds' | 'authorised' | 'settled' | 'failed' | 'cancelled';
+interface JoopPaymentSession {
+    sessionId: string;
+    paymentId: string;
+    amount: number;
+    currency: string;
+    step: JoopPaymentStep;
+    threeDsUrl?: string;
+    threeDsData?: string;
+    errorCode?: string;
+    errorMessage?: string;
+    createdAt: number;
+    updatedAt: number;
+}
+interface JoopPaymentRequest {
+    amount: number;
+    currency: string;
+    cardNumber: string;
+    cardExpiry: string;
+    cvv: string;
+    merchantId: string;
+    reference: string;
+    returnUrl?: string;
+    notifyUrl?: string;
+    metadata?: Record<string, string>;
+}
+interface JoopThreeDsResult {
+    transactionId: string;
+    status: 'Y' | 'N' | 'U' | 'A';
+    eci: string;
+    cavv?: string;
+}
+interface JoopPaymentOrchestratorConfig {
+    gatewayUrl: string;
+    merchantId: string;
+    apiKey: string;
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+}
+declare class JoopPaymentOrchestrator {
+    private readonly _cfg;
+    private readonly _sessions;
+    constructor(config: JoopPaymentOrchestratorConfig);
+    initiate(request: JoopPaymentRequest): Promise<JoopPaymentSession>;
+    handle3ds(sessionId: string, result: JoopThreeDsResult): Promise<JoopPaymentSession>;
+    poll(sessionId: string): Promise<JoopPaymentSession>;
+    confirm(sessionId: string): Promise<JoopPaymentSession>;
+    cancel(sessionId: string): Promise<JoopPaymentSession>;
+    getSession(sessionId: string): JoopPaymentSession | null;
+    session$(sessionId: string): JoopObservable<JoopPaymentSession>;
+    destroy(): void;
+    private _requireSession;
+    private _updateSession;
+    private _generateSessionId;
+    private _fetch;
+}
+
+type JoopTxnType = 'credit' | 'debit' | 'fee' | 'interest' | 'transfer' | 'unknown';
+interface JoopTransaction {
+    id: string;
+    date: string;
+    valueDate?: string;
+    amount: number;
+    type: JoopTxnType;
+    currency: string;
+    description: string;
+    reference?: string;
+    balance?: number;
+    counterpartyName?: string;
+    counterpartyIban?: string;
+    category?: string;
+    raw?: string;
+}
+interface JoopStatementResult {
+    format: 'MT940' | 'OFX' | 'QIF' | 'CSV' | 'unknown';
+    accountId?: string;
+    currency?: string;
+    openingBalance?: number;
+    closingBalance?: number;
+    transactions: JoopTransaction[];
+    parseErrors: string[];
+}
+interface JoopCsvStatementConfig {
+    delimiter?: string;
+    dateColumn?: string | number;
+    amountColumn?: string | number;
+    creditColumn?: string | number;
+    debitColumn?: string | number;
+    descriptionColumn?: string | number;
+    referenceColumn?: string | number;
+    balanceColumn?: string | number;
+    dateFormat?: string;
+    hasHeader?: boolean;
+    skipRows?: number;
+}
+declare class JoopStatementParser {
+    parse(text: string, csvConfig?: JoopCsvStatementConfig): JoopStatementResult;
+    static detectFormat(text: string): 'MT940' | 'OFX' | 'QIF' | 'CSV' | 'unknown';
+    parseMT940(text: string): JoopStatementResult;
+    parseOFX(text: string): JoopStatementResult;
+    parseQIF(text: string): JoopStatementResult;
+    parseCsv(text: string, config?: JoopCsvStatementConfig): JoopStatementResult;
+}
+
+export { type JoopReceiptLine as A, type JoopTransaction as B, JoopReceiptService as J, JoopFraudDetection as a, JoopOpenBankingClient as b, JoopPaymentOrchestrator as c, JoopStatementParser as d, type JoopCsvStatementConfig as e, type JoopFraudConfig as f, type JoopFraudLevel as g, type JoopFraudResult as h, type JoopFraudSignalResult as i, type JoopOBAccount as j, type JoopOBAccountType as k, type JoopOBConsentRequest as l, type JoopOBConsentStatus as m, type JoopOBCredentials as n, type JoopOBPaymentRequest as o, type JoopOBPaymentStatus as p, type JoopOBTransaction as q, type JoopPaymentOrchestratorConfig as r, type JoopPaymentRequest as s, type JoopPaymentSession as t, type JoopPaymentStep as u, type JoopReceiptData as v, type JoopStatementResult as w, type JoopThreeDsResult as x, type JoopTransactionSignal as y, type JoopTxnType as z };

package/dist/storage/index.d.mts

@@ -0,0 +1,40 @@
+export { J as JoopDataStorage, a as JoopScopeMapService } from '../data-storage.service-LvhGRCmw.mjs';
+import { J as JoopObservable } from '../index-Dz0gOur2.mjs';
+import '../index-CqDKWTUP.mjs';
+
+interface JoopIdbStoreSchema {
+    name: string;
+    keyPath?: string;
+    autoIncrement?: boolean;
+    indexes?: Array<{
+        name: string;
+        keyPath: string | string[];
+        unique?: boolean;
+    }>;
+}
+interface JoopIdbConfig {
+    name: string;
+    version: number;
+    stores: JoopIdbStoreSchema[];
+}
+declare class JoopIndexedDbService {
+    private _db;
+    private _ready$;
+    open(config: JoopIdbConfig): Promise<void>;
+    close(): void;
+    isOpen(): boolean;
+    ready$(): JoopObservable<boolean>;
+    private _store;
+    get<T>(store: string, key: IDBValidKey): Promise<T | null>;
+    set(store: string, value: unknown, key?: IDBValidKey): Promise<IDBValidKey>;
+    delete(store: string, key: IDBValidKey): Promise<void>;
+    getAll<T>(store: string): Promise<T[]>;
+    getAllKeys(store: string): Promise<IDBValidKey[]>;
+    query<T>(store: string, indexName: string, range: IDBKeyRange): Promise<T[]>;
+    count(store: string, range?: IDBKeyRange): Promise<number>;
+    clear(store: string): Promise<void>;
+    bulkSet(store: string, items: unknown[]): Promise<void>;
+    deleteDatabase(name: string): Promise<void>;
+}
+
+export { type JoopIdbConfig, type JoopIdbStoreSchema, JoopIndexedDbService };

package/dist/storage/index.d.ts

@@ -0,0 +1,40 @@
+export { J as JoopDataStorage, a as JoopScopeMapService } from '../data-storage.service-DT6xaTxE.js';
+import { J as JoopObservable } from '../index-Dz0gOur2.js';
+import '../index-CqDKWTUP.js';
+
+interface JoopIdbStoreSchema {
+    name: string;
+    keyPath?: string;
+    autoIncrement?: boolean;
+    indexes?: Array<{
+        name: string;
+        keyPath: string | string[];
+        unique?: boolean;
+    }>;
+}
+interface JoopIdbConfig {
+    name: string;
+    version: number;
+    stores: JoopIdbStoreSchema[];
+}
+declare class JoopIndexedDbService {
+    private _db;
+    private _ready$;
+    open(config: JoopIdbConfig): Promise<void>;
+    close(): void;
+    isOpen(): boolean;
+    ready$(): JoopObservable<boolean>;
+    private _store;
+    get<T>(store: string, key: IDBValidKey): Promise<T | null>;
+    set(store: string, value: unknown, key?: IDBValidKey): Promise<IDBValidKey>;
+    delete(store: string, key: IDBValidKey): Promise<void>;
+    getAll<T>(store: string): Promise<T[]>;
+    getAllKeys(store: string): Promise<IDBValidKey[]>;
+    query<T>(store: string, indexName: string, range: IDBKeyRange): Promise<T[]>;
+    count(store: string, range?: IDBKeyRange): Promise<number>;
+    clear(store: string): Promise<void>;
+    bulkSet(store: string, items: unknown[]): Promise<void>;
+    deleteDatabase(name: string): Promise<void>;
+}
+
+export { type JoopIdbConfig, type JoopIdbStoreSchema, JoopIndexedDbService };