bukku-client 0.1.0-test.0

package/dist/files/type.d.ts

@@ -0,0 +1,50 @@
+import { BukkuListPagination } from "../common/type";
+/**
+ * Represents the structure of the uploaded file details as returned by the API.
+ * Based on the 'file' object in the POST /files response sample.
+ */
+export interface BukkuUploadedFile {
+    id: number;
+    filename: string;
+    url: string;
+    mime_type: string;
+    size: number;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Represents the API response structure when a file is successfully uploaded.
+ */
+export interface BukkuFileResponse {
+    file: BukkuUploadedFile;
+}
+/**
+ * Enum for file types for filtering.
+ */
+export type BukkuFileTypeFilter = "IMAGE" | "VIDEO" | "EXCEL" | "PDF";
+/**
+ * Parameters for listing files.
+ * Based on GET /files query parameters.
+ */
+export interface BukkuFileListParams {
+    search?: string;
+    type?: BukkuFileTypeFilter;
+    is_used?: boolean;
+    page?: number;
+    page_size?: number;
+    [key: string]: any;
+}
+/**
+ * Represents a file item as it appears in a list.
+ * This might be identical to BukkuUploadedFile, but defined separately for clarity in list contexts.
+ */
+export interface BukkuFileListItem extends BukkuUploadedFile {
+}
+/**
+ * Represents the API response structure for listing files.
+ */
+export interface BukkuFileListApiResponse {
+    paging: BukkuListPagination;
+    files: BukkuFileListItem[];
+}
+//# sourceMappingURL=type.d.ts.map

package/dist/files/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../src/files/type.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAID;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;AAEtE;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;CAG3D;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B"}

package/dist/files/type.js

@@ -0,0 +1,4 @@
+"use strict";
+// bukku/src/files/type.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=type.js.map

package/dist/files/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../src/files/type.ts"],"names":[],"mappings":";AAAA,0BAA0B"}

package/dist/index.d.ts

@@ -0,0 +1,73 @@
+import { URL } from "url";
+import { SalesAPI } from "./sales";
+import { PurchasesAPI } from "./purchases";
+import { ContactsAPI } from "./contacts";
+import { ProductsAPI } from "./products";
+import { AccountingAPI } from "./accounting";
+import { ListsAPI } from "./lists";
+import type { ListType, GetListsRequestBody, GetListsResponse, CountryItem, TermItem, CurrencyItem, CurrenciesList, StandardListData } from "./lists/type";
+/**
+ * Configuration options for the BukkuClient.
+ */
+export interface BukkuClientOptions {
+    /**
+     * Your Bukku API Access Token.
+     * Can be retrieved from Control Panel -> Integrations in your Bukku web app.
+     */
+    accessToken: string;
+    /**
+     * The subdomain of the company account you are accessing (e.g., "example" if your Bukku URL is example.bukku.my).
+     */
+    companySubdomain: string;
+    /**
+     * The base URL for the Bukku API.
+     * For production server, use: https://api.bukku.my
+     * For staging server, use: https://api.bukku.fyi
+     */
+    apiBaseUrl: string;
+    /**
+     * Optional fetch implementation. If not provided, uses global fetch.
+     * This is useful for Node.js environments prior to v18 or for using custom fetch libraries.
+     */
+    fetch?: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+}
+/**
+ * BukkuAPIError class for handling API specific errors.
+ */
+export declare class BukkuAPIError extends Error {
+    status?: number | undefined;
+    responseData?: any | undefined;
+    constructor(message: string, status?: number | undefined, responseData?: any | undefined);
+}
+export type { ListType, GetListsRequestBody, GetListsResponse, CountryItem, TermItem, CurrencyItem, CurrenciesList, StandardListData, };
+/**
+ * A TypeScript client for interacting with the Bukku REST API.
+ */
+export declare class BukkuClient {
+    private readonly accessToken;
+    private readonly companySubdomain;
+    private readonly apiBaseUrl;
+    private readonly fetchImplementation;
+    readonly sales: SalesAPI;
+    readonly purchases: PurchasesAPI;
+    readonly contacts: ContactsAPI;
+    readonly products: ProductsAPI;
+    readonly accounting: AccountingAPI;
+    readonly lists: ListsAPI;
+    /**
+     * Creates an instance of the BukkuClient.
+     * @param options - Configuration options for the client.
+     */
+    constructor(options: BukkuClientOptions);
+    /**
+     * A private helper method to make authenticated requests to the Bukku API.
+     * @param endpoint - The API endpoint (e.g., '/v1/invoices').
+     * @param method - HTTP method (GET, POST, PUT, DELETE, etc.).
+     * @param body - Optional request body for POST/PUT requests.
+     * @param queryParams - Optional query parameters.
+     * @returns A Promise resolving to the JSON response from the API.
+     * @throws BukkuAPIError if the API returns an error.
+     */
+    private _request;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,KAAK,EACV,QAAQ,EACR,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,gBAAgB,EACjB,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC7E;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IAG7B,MAAM,CAAC,EAAE,MAAM;IACf,YAAY,CAAC,EAAE,GAAG;gBAFzB,OAAO,EAAE,MAAM,EACR,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,YAAY,CAAC,EAAE,GAAG,YAAA;CAO5B;AAGD,YAAY,EACV,QAAQ,EACR,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,gBAAgB,GACjB,CAAC;AAEF;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAGb;IAEvB,SAAgB,KAAK,EAAE,QAAQ,CAAC;IAChC,SAAgB,SAAS,EAAE,YAAY,CAAC;IACxC,SAAgB,QAAQ,EAAE,WAAW,CAAC;IACtC,SAAgB,QAAQ,EAAE,WAAW,CAAC;IACtC,SAAgB,UAAU,EAAE,aAAa,CAAC;IAC1C,SAAgB,KAAK,EAAE,QAAQ,CAAC;IAEhC;;;OAGG;gBACS,OAAO,EAAE,kBAAkB;IA4CvC;;;;;;;;OAQG;YACW,QAAQ;CAiEvB"}

package/dist/index.js

@@ -0,0 +1,130 @@
+"use strict";
+// src/index.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BukkuClient = exports.BukkuAPIError = void 0;
+const url_1 = require("url"); // Using 'url' module for robust URL handling
+const sales_1 = require("./sales");
+const purchases_1 = require("./purchases");
+const contacts_1 = require("./contacts");
+const products_1 = require("./products");
+const accounting_1 = require("./accounting");
+const lists_1 = require("./lists");
+/**
+ * BukkuAPIError class for handling API specific errors.
+ */
+class BukkuAPIError extends Error {
+    constructor(message, status, responseData) {
+        super(message);
+        this.status = status;
+        this.responseData = responseData;
+        this.name = "BukkuAPIError";
+        // Set the prototype explicitly.
+        Object.setPrototypeOf(this, BukkuAPIError.prototype);
+    }
+}
+exports.BukkuAPIError = BukkuAPIError;
+/**
+ * A TypeScript client for interacting with the Bukku REST API.
+ */
+class BukkuClient {
+    /**
+     * Creates an instance of the BukkuClient.
+     * @param options - Configuration options for the client.
+     */
+    constructor(options) {
+        if (!options.accessToken) {
+            throw new Error("Bukku API Access Token (accessToken) is required.");
+        }
+        if (!options.companySubdomain) {
+            throw new Error("Bukku Company Subdomain (companySubdomain) is required.");
+        }
+        this.accessToken = options.accessToken;
+        this.companySubdomain = options.companySubdomain;
+        this.apiBaseUrl = options.apiBaseUrl;
+        if (options.fetch) {
+            this.fetchImplementation = options.fetch;
+        }
+        else if (typeof fetch !== "undefined") {
+            this.fetchImplementation = fetch;
+        }
+        else {
+            // This error will be thrown if global fetch is not available and no polyfill is provided.
+            // For Node.js < 18, users will need to pass a fetch polyfill (e.g., node-fetch).
+            throw new Error("Global fetch is not available. Please provide a fetch implementation in BukkuClientOptions or use Node.js v18+.");
+        }
+        // Validate apiBaseUrl
+        try {
+            new url_1.URL(this.apiBaseUrl);
+        }
+        catch (error) {
+            throw new Error(`Invalid apiBaseUrl: ${this.apiBaseUrl}. It must be a valid URL.`);
+        }
+        // Initialize API modules
+        this.sales = new sales_1.SalesAPI(this._request.bind(this));
+        this.purchases = new purchases_1.PurchasesAPI(this._request.bind(this));
+        this.contacts = new contacts_1.ContactsAPI(this._request.bind(this));
+        this.products = new products_1.ProductsAPI(this._request.bind(this));
+        this.accounting = new accounting_1.AccountingAPI(this._request.bind(this));
+        this.lists = new lists_1.ListsAPI(this._request.bind(this));
+    }
+    /**
+     * A private helper method to make authenticated requests to the Bukku API.
+     * @param endpoint - The API endpoint (e.g., '/v1/invoices').
+     * @param method - HTTP method (GET, POST, PUT, DELETE, etc.).
+     * @param body - Optional request body for POST/PUT requests.
+     * @param queryParams - Optional query parameters.
+     * @returns A Promise resolving to the JSON response from the API.
+     * @throws BukkuAPIError if the API returns an error.
+     */
+    async _request(endpoint, method, // Add other methods as needed
+    body, queryParams) {
+        const url = new url_1.URL(endpoint, this.apiBaseUrl);
+        if (queryParams) {
+            Object.entries(queryParams).forEach(([key, value]) => {
+                url.searchParams.append(key, String(value));
+            });
+        }
+        const headers = {
+            Authorization: `Bearer ${this.accessToken}`,
+            "Company-Subdomain": this.companySubdomain,
+            Accept: "application/json",
+        };
+        if (body) {
+            headers["Content-Type"] = "application/json";
+        }
+        const config = {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        };
+        try {
+            const response = await this.fetchImplementation(url.toString(), config);
+            if (!response.ok) {
+                // Attempt to parse error response, but don't fail if it's not JSON
+                let errorData;
+                try {
+                    errorData = await response.json();
+                }
+                catch (e) {
+                    // If response is not JSON, use text
+                    errorData = await response.text();
+                }
+                throw new BukkuAPIError(`API request failed: ${response.status} ${response.statusText}`, response.status, errorData);
+            }
+            // Handle cases where response might be empty (e.g., 204 No Content)
+            if (response.status === 204) {
+                return {}; // Or handle as undefined based on preference
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            if (error instanceof BukkuAPIError) {
+                throw error;
+            }
+            // Catch network errors or other issues not originating from the API's HTTP response
+            throw new BukkuAPIError(error instanceof Error ? error.message : String(error));
+        }
+    }
+}
+exports.BukkuClient = BukkuClient;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lists/index.d.ts

@@ -0,0 +1,24 @@
+import type { BukkuAPIRequestFunction } from "../types";
+import type { GetListsRequestBody, GetListsResponse } from "./type";
+/**
+ * Provides access to the Lists API endpoints.
+ * Currently, this handles the generic POST /v2/lists endpoint.
+ */
+export declare class ListsAPI {
+    private request;
+    /**
+     * Initializes the ListsAPI with the BukkuAPIRequestFunction.
+     * @param request - The function to make authenticated API requests.
+     */
+    constructor(request: BukkuAPIRequestFunction);
+    /**
+     * Fetches multiple types of lists from the Bukku API.
+     * Corresponds to the POST /v2/lists endpoint.
+     *
+     * @param body - The request body specifying which lists to fetch and any associated parameters.
+     * @returns A Promise resolving to the API response containing the requested lists.
+     * @throws BukkuAPIError if the API returns an error.
+     */
+    get(body: GetListsRequestBody): Promise<GetListsResponse>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/lists/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lists/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAEpE;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,OAAO,CAA0B;IAEzC;;;OAGG;gBACS,OAAO,EAAE,uBAAuB;IAI5C;;;;;;;OAOG;IACG,GAAG,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAMhE"}

package/dist/lists/index.js

@@ -0,0 +1,33 @@
+"use strict";
+// bukku/src/lists/index.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListsAPI = void 0;
+/**
+ * Provides access to the Lists API endpoints.
+ * Currently, this handles the generic POST /v2/lists endpoint.
+ */
+class ListsAPI {
+    /**
+     * Initializes the ListsAPI with the BukkuAPIRequestFunction.
+     * @param request - The function to make authenticated API requests.
+     */
+    constructor(request) {
+        this.request = request;
+    }
+    /**
+     * Fetches multiple types of lists from the Bukku API.
+     * Corresponds to the POST /v2/lists endpoint.
+     *
+     * @param body - The request body specifying which lists to fetch and any associated parameters.
+     * @returns A Promise resolving to the API response containing the requested lists.
+     * @throws BukkuAPIError if the API returns an error.
+     */
+    async get(body) {
+        if (!body || !body.lists || body.lists.length === 0) {
+            throw new Error("The 'lists' array in the request body is required and cannot be empty.");
+        }
+        return this.request("/v2/lists", "POST", body);
+    }
+}
+exports.ListsAPI = ListsAPI;
+//# sourceMappingURL=index.js.map

package/dist/lists/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lists/index.ts"],"names":[],"mappings":";AAAA,2BAA2B;;;AAK3B;;;GAGG;AACH,MAAa,QAAQ;IAGnB;;;OAGG;IACH,YAAY,OAAgC;QAC1C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,GAAG,CAAC,IAAyB;QACjC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;QAC5F,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAmB,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACnE,CAAC;CACF;AAzBD,4BAyBC"}