timber-node 0.0.1

package/dist/expense.d.ts

@@ -0,0 +1,116 @@
+import { AxiosInstance, AxiosResponse } from "axios";
+export interface CreateExpenseRequest {
+    type: string;
+    merchant: string;
+    category: string;
+    date: string;
+    payment_method: string;
+    amount: number;
+}
+export type UpdateExpenseRequest = Partial<CreateExpenseRequest>;
+export interface Expense {
+    _id: string;
+    user: string;
+    company: string;
+    merchant: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface ExpenseQueryParams {
+    page: number;
+    limit: number;
+    sort: string;
+    filters: string;
+}
+/**
+ * Service for managing Expenses.
+ *
+ * @example
+ * ```ts
+ * const { createClient } = require('timber-sdk-dev');
+ * const client = createClient('your-api-key');
+ * const expenses = await client.expense.list({ page: 1, limit: 10 });
+ * console.log(expenses.data);
+ * ```
+ */
+export declare class ExpenseService {
+    private http;
+    constructor(http: AxiosInstance);
+    /**
+     * Fetch a paginated list of expenses.
+     *
+     * @param params - Query options like page, limit, filters, sort.
+     * @returns List of expenses matching the query.
+     *
+     * @example
+     * ```ts
+     * const expenses = await client.expense.list({ page: 1, limit: 5 });
+     * console.log(expenses.data);
+     * ```
+     */
+    list(params: ExpenseQueryParams): Promise<AxiosResponse<Expense[]>>;
+    /**
+     * Fetch a single expense by ID.
+     *
+     * @param id - Expense ID
+     * @returns Expense object
+     *
+     * @example
+     * ```ts
+     * const expense = await client.expense.get('expense_id_here');
+     * console.log(expense.data);
+     * ```
+     */
+    get(id: string): Promise<AxiosResponse<Expense>>;
+    /**
+     * Create a new expense.
+     *
+     * @param data - Expense creation payload
+     * @returns The created expense
+     *
+     * @example
+     * ```ts
+     * const newExpense = {
+     *   type: "travel",
+     *   merchant: "Uber",
+     *   category: "Transportation",
+     *   date: "2025-06-23",
+     *   payment_method: "credit_card",
+     *   amount: 45.75,
+     * };
+     * const response = await client.expense.create(newExpense);
+     * console.log(response.data);
+     * ```
+     */
+    create(data: CreateExpenseRequest): Promise<AxiosResponse<Expense>>;
+    /**
+     * Update an existing expense.
+     *
+     * @param id - Expense ID
+     * @param data - Partial update data
+     * @returns Updated expense
+     *
+     * @example
+     * ```ts
+     * const updates = { amount: 50.0 };
+     * const updated = await client.expense.update('expense_id_here', updates);
+     * console.log(updated.data);
+     * ```
+     */
+    update(id: string, data: UpdateExpenseRequest): Promise<AxiosResponse<Expense>>;
+    /**
+     * Delete an expense by ID.
+     *
+     * @param id - Expense ID
+     * @returns Confirmation message
+     *
+     * @example
+     * ```ts
+     * const response = await client.expense.delete('expense_id_here');
+     * console.log(response.data.message);
+     * ```
+     */
+    delete(id: string): Promise<AxiosResponse<{
+        message: string;
+    }>>;
+}

package/dist/expense.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExpenseService = void 0;
+/**
+ * Service for managing Expenses.
+ *
+ * @example
+ * ```ts
+ * const { createClient } = require('timber-sdk-dev');
+ * const client = createClient('your-api-key');
+ * const expenses = await client.expense.list({ page: 1, limit: 10 });
+ * console.log(expenses.data);
+ * ```
+ */
+class ExpenseService {
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Fetch a paginated list of expenses.
+     *
+     * @param params - Query options like page, limit, filters, sort.
+     * @returns List of expenses matching the query.
+     *
+     * @example
+     * ```ts
+     * const expenses = await client.expense.list({ page: 1, limit: 5 });
+     * console.log(expenses.data);
+     * ```
+     */
+    async list(params) {
+        return await this.http.get("/customer/expense", { params });
+    }
+    /**
+     * Fetch a single expense by ID.
+     *
+     * @param id - Expense ID
+     * @returns Expense object
+     *
+     * @example
+     * ```ts
+     * const expense = await client.expense.get('expense_id_here');
+     * console.log(expense.data);
+     * ```
+     */
+    async get(id) {
+        return await this.http.get(`/customer/expense/${id}`);
+    }
+    /**
+     * Create a new expense.
+     *
+     * @param data - Expense creation payload
+     * @returns The created expense
+     *
+     * @example
+     * ```ts
+     * const newExpense = {
+     *   type: "travel",
+     *   merchant: "Uber",
+     *   category: "Transportation",
+     *   date: "2025-06-23",
+     *   payment_method: "credit_card",
+     *   amount: 45.75,
+     * };
+     * const response = await client.expense.create(newExpense);
+     * console.log(response.data);
+     * ```
+     */
+    async create(data) {
+        return await this.http.post("/customer/expense", data);
+    }
+    /**
+     * Update an existing expense.
+     *
+     * @param id - Expense ID
+     * @param data - Partial update data
+     * @returns Updated expense
+     *
+     * @example
+     * ```ts
+     * const updates = { amount: 50.0 };
+     * const updated = await client.expense.update('expense_id_here', updates);
+     * console.log(updated.data);
+     * ```
+     */
+    async update(id, data) {
+        return await this.http.put(`/customer/expense/${id}`, data);
+    }
+    /**
+     * Delete an expense by ID.
+     *
+     * @param id - Expense ID
+     * @returns Confirmation message
+     *
+     * @example
+     * ```ts
+     * const response = await client.expense.delete('expense_id_here');
+     * console.log(response.data.message);
+     * ```
+     */
+    async delete(id) {
+        return await this.http.patch(`/customer/expense/${id}`);
+    }
+}
+exports.ExpenseService = ExpenseService;

package/dist/expenseCategory.d.ts

@@ -0,0 +1,95 @@
+import { AxiosInstance, AxiosResponse } from "axios";
+export interface CreateExpenseCategoryRequest {
+    category: string;
+}
+export type UpdateExpenseCategoryRequest = Partial<CreateExpenseCategoryRequest>;
+export interface ExpenseCategory {
+    _id: string;
+    company: string;
+    category: {
+        label: string;
+        value: string;
+    };
+    created_at: string;
+    updated_at: string;
+}
+export interface ExpenseCategoryQueryParams {
+    page: number;
+    limit: number;
+    sort: string;
+    filters: string;
+}
+/**
+ * Service for Expense Category
+ *
+ * @example
+ * ```ts
+ * const { createClient } = require('timber-sdk-dev');
+ * const client = createClient('your-api-key');
+ * const expenseCategory = await client.expenseCategory.list({ page: 1, limit: 10 });
+ * console.log(expenseCategory.data);
+ * ```
+ */
+export declare class ExpenseCategoryService {
+    private http;
+    constructor(http: AxiosInstance);
+    /**
+     * Fetch a paginated list of expense categories.
+     *
+     * @param params
+     * @returns
+     *
+     * @example
+     * ```ts
+     * const expenseCategories = await client.expenseCategory.list({ page: 1, limit: 5 });
+     * console.log(expenseCategories.data);
+     * ```
+     */
+    list(params: ExpenseCategoryQueryParams): Promise<AxiosResponse<ExpenseCategory[]>>;
+    /**
+     * Create a new expense category.
+     *
+     * @param data
+     * @returns
+     *
+     * @example
+     * ```ts
+     * const newExpenseCategory = {
+     *   category: "Travel"
+     * };
+     * const response = await client.expenseCategory.create(newExpenseCategory);
+     * console.log(response.data);
+     * ```
+     */
+    create(data: CreateExpenseCategoryRequest): Promise<AxiosResponse<ExpenseCategory>>;
+    /**
+     * Update an existing expense category.
+     *
+     * @param id
+     * @param data
+     * @returns
+     *
+     * @example
+     * ```ts
+     * const updates = { category: "Food" };
+     * const updated = await client.expenseCategory.update('expense_category_id_here', updates);
+     * console.log(updated.data);
+     * ```
+     */
+    update(id: string, data: CreateExpenseCategoryRequest): Promise<AxiosResponse<ExpenseCategory>>;
+    /**
+     * Delete an expense category by ID.
+     *
+     * @param id
+     * @returns
+     *
+     * @example
+     * ```ts
+     * const response = await client.expenseCategory.delete('expense_category_id_here');
+     * console.log(response.data.message);
+     * ```
+     */
+    delete(id: string): Promise<AxiosResponse<{
+        message: string;
+    }>>;
+}

package/dist/expenseCategory.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExpenseCategoryService = void 0;
+/**
+ * Service for Expense Category
+ *
+ * @example
+ * ```ts
+ * const { createClient } = require('timber-sdk-dev');
+ * const client = createClient('your-api-key');
+ * const expenseCategory = await client.expenseCategory.list({ page: 1, limit: 10 });
+ * console.log(expenseCategory.data);
+ * ```
+ */
+class ExpenseCategoryService {
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Fetch a paginated list of expense categories.
+     *
+     * @param params
+     * @returns
+     *
+     * @example
+     * ```ts
+     * const expenseCategories = await client.expenseCategory.list({ page: 1, limit: 5 });
+     * console.log(expenseCategories.data);
+     * ```
+     */
+    async list(params) {
+        return await this.http.get("/customer/expense/category", {
+            params,
+        });
+    }
+    /**
+     * Create a new expense category.
+     *
+     * @param data
+     * @returns
+     *
+     * @example
+     * ```ts
+     * const newExpenseCategory = {
+     *   category: "Travel"
+     * };
+     * const response = await client.expenseCategory.create(newExpenseCategory);
+     * console.log(response.data);
+     * ```
+     */
+    async create(data) {
+        return await this.http.post("/customer/expense/category", data);
+    }
+    /**
+     * Update an existing expense category.
+     *
+     * @param id
+     * @param data
+     * @returns
+     *
+     * @example
+     * ```ts
+     * const updates = { category: "Food" };
+     * const updated = await client.expenseCategory.update('expense_category_id_here', updates);
+     * console.log(updated.data);
+     * ```
+     */
+    async update(id, data) {
+        return await this.http.put(`/customer/expense/category/${id}`, data);
+    }
+    /**
+     * Delete an expense category by ID.
+     *
+     * @param id
+     * @returns
+     *
+     * @example
+     * ```ts
+     * const response = await client.expenseCategory.delete('expense_category_id_here');
+     * console.log(response.data.message);
+     * ```
+     */
+    async delete(id) {
+        return await this.http.delete(`/customer/expense/category/${id}`);
+    }
+}
+exports.ExpenseCategoryService = ExpenseCategoryService;

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+import { ExpenseService } from "./expense";
+import { RawExpenseService } from "./rawExpense";
+import { VendorPaymentService } from "./vendorPayment";
+import { ExpenseCategoryService } from "./expenseCategory";
+import { BillPaymentService } from "./billPayment";
+import { InvoiceService } from "./invoice";
+import { InvoicePaymentService } from "./invoicePayment";
+import { CustomerService } from "./customer";
+import { TaxRateService } from "./taxRate";
+import { SalaryService } from "./salary";
+import { EmployeeService } from "./employee";
+declare class TimberClient {
+    expense: ExpenseService;
+    expenseCategory: ExpenseCategoryService;
+    rawExpense: RawExpenseService;
+    invoice: InvoiceService;
+    invoicePayment: InvoicePaymentService;
+    vendorPayment: VendorPaymentService;
+    billPayment: BillPaymentService;
+    customer: CustomerService;
+    taxRate: TaxRateService;
+    salary: SalaryService;
+    employee: EmployeeService;
+    constructor(apiKey: string, options?: {
+        baseURL?: string;
+    });
+}
+export declare const createClient: (apiKey: string, options?: {}) => TimberClient;
+export {};

package/dist/index.js

@@ -0,0 +1,50 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createClient = void 0;
+const dotenv_1 = __importDefault(require("dotenv"));
+dotenv_1.default.config();
+const axios_1 = __importDefault(require("axios"));
+const expense_1 = require("./expense");
+const rawExpense_1 = require("./rawExpense");
+const vendorPayment_1 = require("./vendorPayment");
+const expenseCategory_1 = require("./expenseCategory");
+const billPayment_1 = require("./billPayment");
+const invoice_1 = require("./invoice");
+const invoicePayment_1 = require("./invoicePayment");
+const customer_1 = require("./customer");
+const taxRate_1 = require("./taxRate");
+const salary_1 = require("./salary");
+const employee_1 = require("./employee");
+class TimberClient {
+    constructor(apiKey, options = {}) {
+        const baseURL = `${options.baseURL || "http://localhost:4010"}/api/v1/user/sdk`;
+        const http = axios_1.default.create({
+            baseURL: baseURL,
+            headers: {
+                Authorization: `ApiKey ${apiKey}`,
+                "Content-Type": "application/json",
+            },
+        });
+        this.expense = new expense_1.ExpenseService(http);
+        this.expenseCategory = new expenseCategory_1.ExpenseCategoryService(http);
+        this.rawExpense = new rawExpense_1.RawExpenseService(http);
+        this.vendorPayment = new vendorPayment_1.VendorPaymentService(http);
+        this.billPayment = new billPayment_1.BillPaymentService(http);
+        this.invoice = new invoice_1.InvoiceService(http);
+        this.invoicePayment = new invoicePayment_1.InvoicePaymentService(http);
+        this.customer = new customer_1.CustomerService(http);
+        this.taxRate = new taxRate_1.TaxRateService(http);
+        this.salary = new salary_1.SalaryService(http);
+        this.employee = new employee_1.EmployeeService(http);
+    }
+}
+const createClient = (apiKey, options = {}) => {
+    if (!apiKey) {
+        throw new Error("API key is required");
+    }
+    return new TimberClient(apiKey, options);
+};
+exports.createClient = createClient;

package/dist/invoice.d.ts

@@ -0,0 +1,109 @@
+import { AxiosInstance, AxiosResponse } from "axios";
+export type NewInvoiceItem = {
+    id: string;
+    title: string;
+    quantity: number;
+    rate: number;
+    vat: number;
+    discount: number;
+    total: number;
+};
+export interface InvoiceData {
+    mode: "create" | "edit";
+    payment_method: string;
+    title: string;
+    company: string;
+    isTitleChanged: boolean;
+    customer: {
+        customer_id?: string;
+        name: string;
+        email: string;
+        trn?: string;
+        country_code: string;
+        mobile: string;
+        address: string;
+    };
+    biller: {
+        biller_id?: string;
+        name: string;
+        email: string;
+        country_code: string;
+        mobile: string;
+        address: string;
+        trn?: string;
+    };
+    invoice_number: string;
+    invoice_date: any;
+    due_date: any | null;
+    currency: string;
+    items: NewInvoiceItem[];
+    terms: any;
+    notes: any;
+    sub_total: number;
+    vat_total: number;
+    discount_total: number;
+    shipping: number;
+    total: number;
+    amount_paid: number;
+    amount_due: number;
+    logo: any | null | File;
+    place_of_supply?: string;
+    wafeq: boolean;
+    zoho: boolean;
+}
+export interface Invoice extends InvoiceData {
+    _id: string;
+    created_at?: string;
+    updated_at?: string;
+}
+export interface InvoiceQueryParams {
+    page?: number;
+    limit?: number;
+}
+/**
+ * Service for Invoice
+ *
+ * @example
+ * ```ts
+ * const { createClient } = require('timber-sdk-dev');
+ * const client = createClient('your-api-key');
+ * const invoice = await client.invoice.list({ page: 1, limit: 10 });
+ * console.log(invoice.data);
+ * ```
+ */
+export declare class InvoiceService {
+    private http;
+    constructor(http: AxiosInstance);
+    /**
+     * Fetch a paginated list of invoices.
+     *
+     * @param params - Query options like page, limit, filters, sort.
+     * @returns List of invoices matching the query.
+     *
+     * @example
+     * ```ts
+     * const invoices = await client.invoice.list({ page: 1, limit: 5 });
+     * console.log(invoices.data);
+     * ```
+     */
+    list(params?: InvoiceQueryParams): Promise<AxiosResponse<Invoice[]>>;
+    create(data: InvoiceData): Promise<AxiosResponse<Invoice>>;
+    update(id: string, data: Partial<InvoiceData>): Promise<AxiosResponse<Invoice>>;
+    /**
+     * Delete an invoice by ID.
+     *
+     * @param id - Invoice ID
+     * @returns Confirmation message
+     *
+     * @example
+     * ```ts
+     * const response = await client.invoice.delete('invoice_id_here');
+     * console.log(response.data.message);
+     * ```
+     */
+    delete(id: string, data: {
+        remarks: string;
+    }): Promise<AxiosResponse<{
+        message: string;
+    }>>;
+}

package/dist/invoice.js

@@ -0,0 +1,100 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvoiceService = void 0;
+const form_data_1 = __importDefault(require("form-data"));
+/**
+ * Service for Invoice
+ *
+ * @example
+ * ```ts
+ * const { createClient } = require('timber-sdk-dev');
+ * const client = createClient('your-api-key');
+ * const invoice = await client.invoice.list({ page: 1, limit: 10 });
+ * console.log(invoice.data);
+ * ```
+ */
+class InvoiceService {
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Fetch a paginated list of invoices.
+     *
+     * @param params - Query options like page, limit, filters, sort.
+     * @returns List of invoices matching the query.
+     *
+     * @example
+     * ```ts
+     * const invoices = await client.invoice.list({ page: 1, limit: 5 });
+     * console.log(invoices.data);
+     * ```
+     */
+    async list(params = {}) {
+        return await this.http.get("/customer/invoice", { params });
+    }
+    async create(data) {
+        const formData = new form_data_1.default();
+        for (const key in data) {
+            const value = data[key];
+            if (key === "items" || key === "customer" || key === "biller") {
+                formData.append(key, JSON.stringify(value));
+            }
+            else if (key === "logo" && value && typeof value.pipe === "function") {
+                // This is a ReadStream
+                formData.append("logo", value);
+            }
+            else if (value instanceof Date) {
+                formData.append(key, value.toISOString());
+            }
+            else if (value !== undefined && value !== null) {
+                formData.append(key, value.toString());
+            }
+        }
+        return await this.http.post("/customer/invoice", formData, {
+            headers: formData.getHeaders(),
+        });
+    }
+    async update(id, data) {
+        const formData = new form_data_1.default();
+        for (const key in data) {
+            const value = data[key];
+            if (key === "items" || key === "customer" || key === "biller") {
+                formData.append(key, JSON.stringify(value));
+            }
+            else if (key === "logo" && value && typeof value.pipe === "function") {
+                // This is a ReadStream
+                formData.append("logo", value);
+            }
+            else if (value instanceof Date) {
+                formData.append(key, value.toISOString());
+            }
+            else if (value !== undefined && value !== null) {
+                formData.append(key, value.toString());
+            }
+        }
+        return await this.http.put(`/customer/invoice/${id}`, data, {
+            headers: formData.getHeaders(),
+        });
+    }
+    /**
+     * Delete an invoice by ID.
+     *
+     * @param id - Invoice ID
+     * @returns Confirmation message
+     *
+     * @example
+     * ```ts
+     * const response = await client.invoice.delete('invoice_id_here');
+     * console.log(response.data.message);
+     * ```
+     */
+    async delete(id, data) {
+        return await this.http.delete(`/customer/invoice/${id}`, {
+            data,
+        });
+    }
+}
+exports.InvoiceService = InvoiceService;