bkper-js 1.5.1 → 1.7.0

package/lib/index.d.ts

@@ -366,6 +366,10 @@ export declare class App {
      * Perform update App, applying pending changes.
      */
     update(): Promise<App>;
+    /**
+     * @returns The wrapped plain json object
+     */
+    json(): bkper.App;
 }
 
 /**
@@ -414,6 +418,18 @@ export declare class Bkper {
      * @returns The retrieved list of Books
      */
     static getBooks(): Promise<Book[]>;
+    /**
+     * Gets all [[Apps]] available for the user.
+     *
+     * @returns The retrieved list of Apps
+     */
+    static getApps(): Promise<App[]>;
+    /**
+     * Gets all [[Templates]] available for the user.
+     *
+     * @returns The retrieved list of Templates
+     */
+    static getTemplates(): Promise<Template[]>;
     /**
      * Gets the current logged [[User]].
      *
@@ -1357,7 +1373,7 @@ export declare class Integration {
  *
  * @public
  */
-declare enum Month {
+export declare enum Month {
     JANUARY = "JANUARY",
     FEBRUARY = "FEBRUARY",
     MARCH = "MARCH",
@@ -1377,7 +1393,7 @@ declare enum Month {
  *
  * @public
  */
-declare enum Period {
+export declare enum Period {
     /**
      *  Monthly period
      */
@@ -1446,6 +1462,72 @@ export declare enum Permission {
     OWNER = "OWNER"
 }
 
+/**
+ * This class defines a Template.
+ *
+ * A Template is a pre-configured setup for [[Books]] and associated Google Sheets that provides users with a starting point for specific accounting or financial management needs.
+ *
+ * @public
+ */
+export declare class Template {
+
+    constructor(json?: bkper.Template);
+    /**
+     * Gets the name of the Template.
+     *
+     * @returns The Template's name
+     */
+    getName(): string | undefined;
+    /**
+     * Gets the description of the Template.
+     *
+     * @returns The Template's description
+     */
+    getDescription(): string | undefined;
+    /**
+     * Gets the url of the image of the Template.
+     *
+     * @returns The url of the Template's image
+     */
+    getImageUrl(): string | undefined;
+    /**
+     * Gets the category of the Template.
+     *
+     * @returns The Template's category. Example: "PERSONAL", "BUSINESS", etc
+     */
+    getCategory(): string | undefined;
+    /**
+     * Gets the times the Template has been used.
+     *
+     * @returns The number of times the Template has been used
+     */
+    getTimesUsed(): number;
+    /**
+     * Gets the bookId of the [[Book]] associated with the Template.
+     *
+     * @returns The bookId of the Book associated with the Template
+     */
+    getBookId(): string | undefined;
+    /**
+     * Gets the link of the [[Book]] associated with the Template.
+     *
+     * @returns The link of the Book associated with the Template
+     */
+    getBookLink(): string | undefined;
+    /**
+     * Gets the link of the Google Sheets spreadsheet associated with the Template.
+     *
+     * @returns The link of the Google Sheets spreadsheet associated with the Template
+     */
+    getSheetsLink(): string | undefined;
+    /**
+     * Gets the wrapped plain json object of the Template.
+     *
+     * @returns The Template wrapped plain json object
+     */
+    json(): bkper.Template;
+}
+
 /**
  *
  * This class defines a Transaction between [credit and debit](http://en.wikipedia.org/wiki/Debits_and_credits) [[Accounts]].
@@ -1922,7 +2004,7 @@ export declare class User {
  *
  * @public
  */
-declare enum Visibility {
+export declare enum Visibility {
     /**
      * The book can be accessed by anyone with the link
      */

package/lib/index.js

@@ -5,18 +5,19 @@
  *
  * @packageDocumentation
  */
-export { App } from './model/App.js';
+export { Account } from './model/Account.js';
 export { Amount } from "./model/Amount.js";
+export { App } from './model/App.js';
 export { Bkper } from './model/Bkper.js';
-export { Account } from './model/Account.js';
 export { Book } from './model/Book.js';
 export { Collection } from './model/Collection.js';
+export { Connection } from './model/Connection.js';
 export { File } from './model/File.js';
 export { Group } from './model/Group.js';
+export { Integration } from './model/Integration.js';
+export { Template } from './model/Template.js';
 export { Transaction } from './model/Transaction.js';
 export { TransactionIterator } from './model/TransactionIterator.js';
 export { User } from './model/User.js';
-export { Integration } from './model/Integration.js';
-export { Connection } from './model/Connection.js';
-export { Periodicity, AccountType, DecimalSeparator, Permission } from './model/Enums.js';
+export { Periodicity, DecimalSeparator, Permission, Visibility, AccountType, Period, Month } from './model/Enums.js';
 //# sourceMappingURL=index.js.map

package/lib/model/App.js

@@ -106,5 +106,11 @@ export class App {
             return this;
         });
     }
+    /**
+     * @returns The wrapped plain json object
+     */
+    json() {
+        return this.wrapped;
+    }
 }
 //# sourceMappingURL=App.js.map

package/lib/model/Bkper.js

@@ -9,10 +9,13 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { Book } from "./Book.js";
 import { App } from "./App.js";
+import * as AppService from '../service/app-service.js';
 import * as BookService from '../service/book-service.js';
 import * as UserService from '../service/user-service.js';
+import * as TemplateService from '../service/template-service.js';
 import { HttpApiRequest } from '../service/http-api-request.js';
 import { User } from "./User.js";
+import { Template } from "./Template.js";
 /**
  * This is the main entry point of the [bkper-js](https://www.npmjs.com/package/bkper-js) library.
  *
@@ -71,6 +74,28 @@ export class Bkper {
             return books.map(book => new Book(book));
         });
     }
+    /**
+     * Gets all [[Apps]] available for the user.
+     *
+     * @returns The retrieved list of Apps
+     */
+    static getApps() {
+        return __awaiter(this, void 0, void 0, function* () {
+            let apps = yield AppService.getApps();
+            return apps.map(app => new App(app));
+        });
+    }
+    /**
+     * Gets all [[Templates]] available for the user.
+     *
+     * @returns The retrieved list of Templates
+     */
+    static getTemplates() {
+        return __awaiter(this, void 0, void 0, function* () {
+            let templates = yield TemplateService.getTemplates();
+            return templates.map(template => new Template(template));
+        });
+    }
     /**
      * Gets the current logged [[User]].
      *

package/lib/model/Template.js

@@ -0,0 +1,85 @@
+/**
+ * This class defines a Template.
+ *
+ * A Template is a pre-configured setup for [[Books]] and associated Google Sheets that provides users with a starting point for specific accounting or financial management needs.
+ *
+ * @public
+ */
+export class Template {
+    constructor(json) {
+        this.wrapped = json || {};
+    }
+    /**
+     * Gets the name of the Template.
+     *
+     * @returns The Template's name
+     */
+    getName() {
+        return this.wrapped.name;
+    }
+    /**
+     * Gets the description of the Template.
+     *
+     * @returns The Template's description
+     */
+    getDescription() {
+        return this.wrapped.description;
+    }
+    /**
+     * Gets the url of the image of the Template.
+     *
+     * @returns The url of the Template's image
+     */
+    getImageUrl() {
+        return this.wrapped.imageUrl;
+    }
+    /**
+     * Gets the category of the Template.
+     *
+     * @returns The Template's category. Example: "PERSONAL", "BUSINESS", etc
+     */
+    getCategory() {
+        return this.wrapped.category;
+    }
+    /**
+     * Gets the times the Template has been used.
+     *
+     * @returns The number of times the Template has been used
+     */
+    getTimesUsed() {
+        return this.wrapped.timesUsed || 0;
+    }
+    /**
+     * Gets the bookId of the [[Book]] associated with the Template.
+     *
+     * @returns The bookId of the Book associated with the Template
+     */
+    getBookId() {
+        return this.wrapped.bookId;
+    }
+    /**
+     * Gets the link of the [[Book]] associated with the Template.
+     *
+     * @returns The link of the Book associated with the Template
+     */
+    getBookLink() {
+        return this.wrapped.bookLink;
+    }
+    /**
+     * Gets the link of the Google Sheets spreadsheet associated with the Template.
+     *
+     * @returns The link of the Google Sheets spreadsheet associated with the Template
+     */
+    getSheetsLink() {
+        return this.wrapped.sheetsLink;
+    }
+    /**
+     * Gets the wrapped plain json object of the Template.
+     *
+     * @returns The Template wrapped plain json object
+     */
+    json() {
+        return this.wrapped;
+    }
+}
+//# sourceMappingURL=Template.js.map

package/lib/service/app-service.js

@@ -8,6 +8,20 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { HttpApiRequest } from "./http-api-request.js";
+export function getApps() {
+    return __awaiter(this, void 0, void 0, function* () {
+        let response = yield new HttpApiRequest(`v5/apps`).setMethod('GET').fetch();
+        if (response.data == null) {
+            return [];
+        }
+        let appListPlain = response.data;
+        let appsJson = appListPlain.items;
+        if (appsJson == null) {
+            return [];
+        }
+        return appsJson;
+    });
+}
 export function createApp(app) {
     return __awaiter(this, void 0, void 0, function* () {
         var response = yield new HttpApiRequest(`v5/apps`).setMethod('POST').setPayload(app).fetch();

package/lib/service/template-service.js

@@ -0,0 +1,25 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { HttpApiRequest } from "./http-api-request.js";
+export function getTemplates() {
+    return __awaiter(this, void 0, void 0, function* () {
+        let response = yield new HttpApiRequest(`v5/templates`).setMethod('GET').fetch();
+        if (response.data == null) {
+            return [];
+        }
+        let templateListPlain = response.data;
+        let templatesJson = templateListPlain.items;
+        if (templatesJson == null) {
+            return [];
+        }
+        return templatesJson;
+    });
+}
+//# sourceMappingURL=template-service.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bkper-js",
-  "version": "1.5.1",
+  "version": "1.7.0",
   "description": "Javascript client for Bkper REST API",
   "main": "./lib/index.js",
   "module": "./lib/index.js",