money-lover-app-client 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Nexo-Technology
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,2 @@
+# money-lover-client
+An unofficial, community-maintained connector for the Money Lover app that enables programmatic access to user financial data for analytics, automation, and integrations. Provides tools to import and normalise accounts and transactions. Not affiliated with or endorsed by Money Lover App.

package/dist/bundle.js

@@ -0,0 +1,3 @@
+'use strict';
+
+//# sourceMappingURL=bundle.js.map

package/dist/bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/client.d.ts

@@ -0,0 +1,16 @@
+import { MoneyLoverCategory } from "./interfaces/category";
+import { MoneyLoverTransaction } from "./interfaces/transaction";
+import { MoneyLoverWallet } from "./interfaces/wallet";
+declare class MoneyLoverClient {
+    private _jwtToken;
+    constructor(jwtToken?: string | null);
+    private _postRequest;
+    static getToken(email: string, password: string): Promise<any>;
+    isTokenValid(): boolean;
+    getUserInfo(): Promise<any>;
+    getWallets(): Promise<MoneyLoverWallet[]>;
+    getCategories(walletId: string): Promise<MoneyLoverCategory[]>;
+    getTransactions(walletId: string, startDate: Date, endDate: Date): Promise<any>;
+    addTransaction(transaction: MoneyLoverTransaction): Promise<any>;
+}
+export default MoneyLoverClient;

package/dist/client.js

@@ -0,0 +1,95 @@
+import jwt from "jsonwebtoken";
+import { formatDate } from "./utils";
+const moneyLoverUrl = "https://web.moneylover.me";
+const moneyLoverTokenUrl = "https://oauth.moneylover.me";
+class MoneyLoverClient {
+    constructor(jwtToken = null) {
+        this._jwtToken = null;
+        this._jwtToken = jwtToken;
+    }
+    async _postRequest(path, body = null, headers = {}) {
+        const res = await fetch(`${moneyLoverUrl}/api${path}`, {
+            method: "POST",
+            headers: {
+                authorization: `AuthJWT ${this._jwtToken}`,
+                "cache-Control": "no-cache, max-age=0, no-store, no-transform, must-revalidate",
+                "Content-Type": "application/json",
+                ...headers,
+            },
+            body: JSON.stringify(body),
+        });
+        const data = await res.json();
+        if (data.error != null && data.error !== 0) {
+            const error = new Error(`Error ${data.error}, ${data.msg}`);
+            error.name = "MoneyLoverError";
+            error.message = data.msg;
+            throw error;
+        }
+        else if (data.e != null) {
+            const error = new Error(`Error ${data.e}, ${data.message}`);
+            error.name = "MoneyLoverError";
+            error.message = data.message;
+            throw error;
+        }
+        else {
+            return data.data;
+        }
+    }
+    static async getToken(email, password) {
+        const loginUrlRes = await fetch(`${moneyLoverUrl}/api/user/login-url`, {
+            method: "POST",
+        });
+        const loginUrlData = await loginUrlRes.json();
+        const res = await fetch(`${moneyLoverTokenUrl}/token`, {
+            method: "POST",
+            headers: {
+                authorization: `Bearer ${loginUrlData.data.request_token}`,
+                client: loginUrlData.data.login_url.match("client=(.+?)&")[1],
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({ email, password }),
+        });
+        const tokenData = await res.json();
+        return tokenData.access_token;
+    }
+    isTokenValid() {
+        if (this._jwtToken != null) {
+            // Check if token is expired
+            const jwtToken = jwt.decode(this._jwtToken);
+            if (!jwtToken.exp) {
+                return false;
+            }
+            return jwtToken.exp * 1000 > Date.now();
+        }
+        return false;
+    }
+    getUserInfo() {
+        return this._postRequest("/user/info");
+    }
+    getWallets() {
+        return this._postRequest("/wallet/list");
+    }
+    getCategories(walletId) {
+        return this._postRequest("/category/list-all", { walletId: walletId });
+    }
+    getTransactions(walletId, startDate, endDate) {
+        return this._postRequest("/transaction/list", {
+            startDate: startDate.toISOString().substr(0, 10),
+            endDate: endDate.toISOString().substr(0, 10),
+            walletId, // "all" to get the transactions of all wallets
+        });
+    }
+    addTransaction(transaction) {
+        return this._postRequest("/transaction/add", JSON.stringify({
+            with: [],
+            account: transaction.account,
+            category: transaction.category,
+            amount: transaction.amount,
+            note: transaction.note,
+            displayDate: formatDate(transaction.date),
+        }), {
+            "Content-Type": "application/json",
+        });
+    }
+}
+export default MoneyLoverClient;

package/dist/commands/categories.d.ts

@@ -0,0 +1,4 @@
+import MoneyLoverClient from "../client";
+import { MoneyLoverCategory } from "../interfaces/category";
+declare const getCategories: (client: MoneyLoverClient, walletId: string) => Promise<MoneyLoverCategory[]>;
+export default getCategories;

package/dist/commands/categories.js

@@ -0,0 +1,13 @@
+const getCategories = async (client, walletId) => {
+    if (!client) {
+        throw new Error("Not logged in");
+    }
+    if (!client.isTokenValid()) {
+        throw new Error("Token has expired");
+    }
+    const allCategories = await client.getCategories(walletId);
+    //   Api may return all categories even when the walletId is specified,
+    //   so we filter them here to return only the categories that belong to the specified walletId.
+    return allCategories.filter((category) => category.walletId === walletId);
+};
+export default getCategories;

package/dist/commands/login.d.ts

@@ -0,0 +1,3 @@
+import { UserProfile } from "../interfaces/user-profile";
+declare const login: (username: string, password: string) => Promise<UserProfile | null>;
+export default login;

package/dist/commands/login.js

@@ -0,0 +1,24 @@
+import MoneyLoverClient from "../client";
+import jwt from "jsonwebtoken";
+const debug = process.env.DEBUG === "true";
+const login = async (username, password) => {
+    let token;
+    token = await MoneyLoverClient.getToken(username, password);
+    try {
+        const jwtToken = jwt.decode(token);
+        const ml = new MoneyLoverClient(token);
+        const userInfo = await ml.getUserInfo();
+        if (debug) {
+            if (!jwtToken.exp) {
+                throw new Error("Invalid JWT token: missing exp field");
+            }
+            console.log(`MoneyLoverClient: Logged in as ${userInfo.email} until ${new Date(jwtToken.exp * 1000)}`);
+        }
+        return userInfo;
+    }
+    catch (e) {
+        console.error("MoneyLoverClient: Login failed", e);
+        return null;
+    }
+};
+export default login;

package/dist/commands/logout.d.ts

@@ -0,0 +1,2 @@
+declare const logout: (deviceId?: string | null) => Promise<void>;
+export default logout;

package/dist/commands/logout.js

@@ -0,0 +1,6 @@
+const logout = async (deviceId = null) => {
+    if (deviceId != null) {
+        // Delete device from Money Lover servers
+    }
+};
+export default logout;

package/dist/commands/transactions.d.ts

@@ -0,0 +1,5 @@
+import MoneyLoverClient from "../client";
+import { MoneyLoverTransaction } from "../interfaces/transaction";
+declare const getTransactions: (client: MoneyLoverClient, walletId: string, startDate: Date, endDate: Date) => Promise<any>;
+declare const addTransaction: (client: MoneyLoverClient, transaction: MoneyLoverTransaction) => Promise<any>;
+export { getTransactions, addTransaction };

package/dist/commands/transactions.js

@@ -0,0 +1,26 @@
+const getTransactions = async (client, walletId, startDate, endDate) => {
+    if (!client) {
+        throw new Error("MoneyLoverClient: Not logged in");
+    }
+    if (!client.isTokenValid()) {
+        throw new Error("MoneyLoverClient: Token has expired");
+    }
+    if (!walletId) {
+        // Default to all
+        walletId = "all";
+    }
+    return await client.getTransactions(walletId, startDate, endDate);
+};
+const addTransaction = async (client, transaction) => {
+    if (!client) {
+        throw new Error("MoneyLoverClient: Not logged in");
+    }
+    if (!client.isTokenValid()) {
+        throw new Error("MoneyLoverClient: Token has expired");
+    }
+    if (!transaction.account || !transaction.category) {
+        throw new Error("MoneyLoverClient: Transaction must have account and category");
+    }
+    return await client.addTransaction(transaction);
+};
+export { getTransactions, addTransaction };

package/dist/commands/wallets.d.ts

@@ -0,0 +1,3 @@
+import MoneyLoverClient from "../client";
+declare const getWallets: (client: MoneyLoverClient) => Promise<import("../interfaces/wallet").MoneyLoverWallet[]>;
+export default getWallets;

package/dist/commands/wallets.js

@@ -0,0 +1,15 @@
+const debug = process.env.DEBUG === "true";
+const getWallets = async (client) => {
+    if (!client) {
+        throw new Error("MoneyLoverClient: Not logged in");
+    }
+    if (!client.isTokenValid()) {
+        throw new Error("MoneyLoverClient: Token has expired");
+    }
+    const wallets = await client.getWallets();
+    if (debug) {
+        console.log(`MoneyLoverClient: Retrieved ${wallets.length} wallets`);
+    }
+    return wallets;
+};
+export default getWallets;

package/dist/index.js

@@ -0,0 +1 @@
+"use strict";

package/dist/interfaces/category-type.d.ts

@@ -0,0 +1,4 @@
+declare enum CategoryType {
+    INCOME = 1,
+    EXPENSE = 2
+}

package/dist/interfaces/category-type.js

@@ -0,0 +1,6 @@
+"use strict";
+var CategoryType;
+(function (CategoryType) {
+    CategoryType[CategoryType["INCOME"] = 1] = "INCOME";
+    CategoryType[CategoryType["EXPENSE"] = 2] = "EXPENSE";
+})(CategoryType || (CategoryType = {}));

package/dist/interfaces/category.d.ts

@@ -0,0 +1,25 @@
+export interface MoneyLoverCategory {
+    /** Internal unique identifier for the specific item */
+    _id: string;
+    /** Display name (e.g., "Tejas") */
+    name: string;
+    /** Icon identifier used in the UI */
+    icon: string;
+    /** * Reference ID to the parent wallet/account.
+     * Matches the structure of your previously defined Wallet _id.
+     */
+    account: string;
+    /** * Numeric type identifier.
+     * Likely represents a specific category or sub-account type.
+     */
+    type: number;
+    /** Metadata for additional info (currently an empty string) */
+    metadata: string;
+    /** Grouping identifier for organizational purposes */
+    group: number;
+    /** Duplicate of _id, often used for legacy or specific API compatibility */
+    id: string;
+    /** Optional parent category ID for hierarchical categorization */
+    parent?: string;
+    exclude_accounts: string[];
+}

package/dist/interfaces/category.js

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

package/dist/interfaces/client-state.d.ts

@@ -0,0 +1,3 @@
+export interface ClientState {
+    jwtToken: string | null;
+}

package/dist/interfaces/client-state.js

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

package/dist/interfaces/transaction.d.ts

@@ -0,0 +1,7 @@
+export interface MoneyLoverTransaction {
+    account: string;
+    category: string;
+    amount: string;
+    note: string;
+    date: Date;
+}

package/dist/interfaces/transaction.js

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

package/dist/interfaces/user-profile.d.ts

@@ -0,0 +1,51 @@
+export interface ClientSettings {
+    is_done_intro_home: boolean;
+    segment_user_ui_type: number;
+    ob_step_add_budget: boolean;
+    ob_step_get_it: boolean;
+    ob_step_add_transaction: boolean;
+    ob_budget_suggest_show: boolean;
+    is_show_step_view_for_user: boolean;
+    ob_step_create_wallet: boolean;
+    ob_step_closed: boolean;
+    main_currency: string;
+    su: boolean;
+    nps__last_ask: number;
+    ls: number;
+    om: number;
+    sb: number;
+    er: boolean;
+    fmy: number;
+    fdw: number;
+    pl: number;
+    av: number;
+    dr: number;
+    fd: number;
+    df: number;
+    l: string;
+    ps: number;
+    ds: number;
+    sa: boolean;
+    sc: boolean;
+    sd: boolean;
+    show_advance_add_transaction: boolean;
+    future_period: number;
+    ol: boolean;
+    sl: boolean;
+    is_done_intro_money_insider_home: boolean;
+    is_done_intro_money_insider_detail: boolean;
+    update_password_fb: string;
+    is_done_tooltip_txn_ai_add_trans: boolean;
+    is_done_tooltip_txn_ai_home: boolean;
+}
+export interface UserProfile {
+    _id: string;
+    email: string;
+    icon_package: any[];
+    limitDevice: number;
+    tags: string[];
+    client_setting: ClientSettings;
+    purchased: boolean;
+    subscribeProduct: string;
+    deviceId: string;
+}

package/dist/interfaces/user-profile.js

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

package/dist/interfaces/wallet.d.ts

@@ -0,0 +1,29 @@
+export interface MoneyLoverWallet {
+    _id: string;
+    name: string;
+    currency_id: number;
+    owner: string;
+    sortIndex: number;
+    transaction_notification: boolean;
+    archived: boolean;
+    account_type: number;
+    exclude_total: boolean;
+    icon: string;
+    listUser: MoneyLoverObjectUser[];
+    createdAt: string;
+    updateAt: string;
+    isDelete: boolean;
+    balance: MoneyLoverBankTransaction[];
+}
+export interface MoneyLoverObjectUser {
+    _id: string;
+    email: string;
+}
+export interface MoneyLoverBankTransaction {
+    date: string;
+    valueDate: string;
+    transaction: string;
+    debit: string;
+    credit: string;
+    balance: string;
+}

package/dist/interfaces/wallet.js

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

package/dist/state.d.ts

@@ -0,0 +1,3 @@
+export declare function getState(key: string): any;
+export declare function setState(key: string, value: any): void;
+export declare function clearState(): void;

package/dist/state.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getState = getState;
+exports.setState = setState;
+exports.clearState = clearState;
+let state = {
+    jwtToken: null,
+};
+function getState(key) {
+    return state[key];
+}
+function setState(key, value) {
+    state[key] = value;
+}
+function clearState() {
+    state = {
+        jwtToken: null,
+    };
+}

package/dist/utils.d.ts

@@ -0,0 +1,2 @@
+declare function formatDate(date: string | Date): string;
+export { formatDate };

package/dist/utils.js

@@ -0,0 +1,12 @@
+function formatDate(date) {
+    const d = new Date(date);
+    let month = "" + (d.getMonth() + 1);
+    let day = "" + d.getDate();
+    const year = d.getFullYear();
+    if (month.length < 2)
+        month = "0" + month;
+    if (day.length < 2)
+        day = "0" + day;
+    return [year, month, day].join("-");
+}
+export { formatDate };

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "money-lover-app-client",  
+  "version": "1.0.0",
+  "main": "dist/bundle.js",      
+  "types": "dist/index.d.ts",    
+  "scripts": {
+    "build": "rollup -c",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Nexo-Technology/money-lover-client.git"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "commonjs",
+  "bugs": {
+    "url": "https://github.com/Nexo-Technology/money-lover-client/issues"
+  },
+  "homepage": "https://github.com/Nexo-Technology/money-lover-client#readme",
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^29.0.0",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "@types/jsonwebtoken": "^9.0.10",
+    "@types/node": "^25.0.3",
+    "rollup": "^4.54.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "jsonwebtoken": "^9.0.3",
+    "tslib": "^2.8.1"
+  }
+}

package/rollup.config.mjs

@@ -0,0 +1,13 @@
+import resolve from '@rollup/plugin-node-resolve';
+import commonjs from '@rollup/plugin-commonjs';
+import typescript from '@rollup/plugin-typescript';
+
+export default {
+  input: 'src/index.ts',
+  output: {
+    file: 'dist/bundle.js',
+    format: 'cjs',
+    sourcemap: true
+  },
+  plugins: [resolve(), commonjs(), typescript({ tsconfig: './tsconfig.json' })]
+};