bkper-js 1.20.0 → 1.22.0

package/lib/index.d.ts

@@ -220,6 +220,37 @@ export declare enum AccountType {
     OUTGOING = "OUTGOING"
 }
 
+/**
+ * Defines an Agent on Bkper.
+ *
+ * An Agent represents an entity (such as an App or Bot) that interacts with Bkper, executing actions on behalf of users.
+ *
+ * @public
+ */
+export declare class Agent {
+    payload: bkper.Agent;
+    constructor(payload?: bkper.Agent);
+    /**
+     * @returns The wrapped plain json object
+     */
+    json(): bkper.Agent;
+    /**
+     *
+     * @returns The Agent universal identifier
+     */
+    getId(): string | undefined;
+    /**
+     *
+     * @returns The Agent name
+     */
+    getName(): string | undefined;
+    /**
+     *
+     * @returns The Agent logo url
+     */
+    getLogoUrl(): string | undefined;
+}
+
 /**
  * This class defines an Amount for arbitrary-precision decimal arithmetic.
  *
@@ -545,19 +576,6 @@ export declare class BalancesReport {
  * @public
  */
 export declare class Bkper {
-    /**
-     * Instantiate a new [[Book]]
-     *
-     * Example:
-     * ```js
-     * var book = Bkper.newBook()
-     *  .setName('My New Book')
-     *  .setFractionDigits(2)
-     *  .setDecimalSeparator('DOT')
-     *  .create();
-     * ```
-     */
-    static newBook(): Book;
     /**
      * Gets the [[Book]] with the specified bookId from url param.
      *
@@ -778,6 +796,17 @@ export declare class Book {
      * @returns The time zone offset of the book, in minutes
      */
     getTimeZoneOffset(): number | undefined;
+    /**
+     * @returns The auto post status of the Book
+     */
+    getAutoPost(): boolean | undefined;
+    /**
+     *
+     * Sets the auto post status of the Book
+     *
+     * @returns This Book, for chainning.
+     */
+    setAutoPost(autoPost: boolean): Book;
     /**
      * @returns The last update date of the book, in in milliseconds
      */
@@ -1306,7 +1335,10 @@ export declare enum DecimalSeparator {
 }
 
 /**
- * Represents an Event in the system.
+ *
+ * This class defines an Event from a [[Book]].
+ *
+ * An event is an object that represents an action (such as posting or deleting a [[Transaction]]) made by an actor (such as a user or a [Bot](https://bkper.com/apps) acting on behalf of a user).
  *
  * @public
  */
@@ -1317,6 +1349,22 @@ export declare class Event {
      * @returns The wrapped plain json object
      */
     json(): bkper.Event;
+    /**
+     * @returns The user who performed the event
+     */
+    getUser(): User | undefined;
+    /**
+     * @returns The user who performed the event
+     */
+    getAgent(): Agent | undefined;
+    /**
+     * @returns The date the event was created
+     */
+    getCreatedAt(): Date | undefined;
+    /**
+     * @returns The type of the event
+     */
+    getType(): EventType | undefined;
 }
 
 /**
@@ -1349,6 +1397,41 @@ export declare class EventList {
     getItems(): Event[];
 }
 
+/**
+ * Enum that represents event types.
+ *
+ * @public
+ */
+export declare enum EventType {
+    FILE_CREATED = "FILE_CREATED",
+    TRANSACTION_CREATED = "TRANSACTION_CREATED",
+    TRANSACTION_UPDATED = "TRANSACTION_UPDATED",
+    TRANSACTION_DELETED = "TRANSACTION_DELETED",
+    TRANSACTION_POSTED = "TRANSACTION_POSTED",
+    TRANSACTION_CHECKED = "TRANSACTION_CHECKED",
+    TRANSACTION_UNCHECKED = "TRANSACTION_UNCHECKED",
+    TRANSACTION_RESTORED = "TRANSACTION_RESTORED",
+    ACCOUNT_CREATED = "ACCOUNT_CREATED",
+    ACCOUNT_UPDATED = "ACCOUNT_UPDATED",
+    ACCOUNT_DELETED = "ACCOUNT_DELETED",
+    QUERY_CREATED = "QUERY_CREATED",
+    QUERY_UPDATED = "QUERY_UPDATED",
+    QUERY_DELETED = "QUERY_DELETED",
+    GROUP_CREATED = "GROUP_CREATED",
+    GROUP_UPDATED = "GROUP_UPDATED",
+    GROUP_DELETED = "GROUP_DELETED",
+    COMMENT_CREATED = "COMMENT_CREATED",
+    COMMENT_DELETED = "COMMENT_DELETED",
+    COLLABORATOR_ADDED = "COLLABORATOR_ADDED",
+    COLLABORATOR_UPDATED = "COLLABORATOR_UPDATED",
+    COLLABORATOR_REMOVED = "COLLABORATOR_REMOVED",
+    INTEGRATION_CREATED = "INTEGRATION_CREATED",
+    INTEGRATION_UPDATED = "INTEGRATION_UPDATED",
+    INTEGRATION_DELETED = "INTEGRATION_DELETED",
+    BOOK_UPDATED = "BOOK_UPDATED",
+    BOOK_DELETED = "BOOK_DELETED"
+}
+
 /**
  *
  * This class defines a File uploaded to a [[Book]].
@@ -2287,6 +2370,12 @@ export declare class User {
      * @returns The User's name
      */
     getName(): string | undefined;
+    /**
+     * Gets the avatar url of the User.
+     *
+     * @returns The User's avatar url
+     */
+    getAvatarUrl(): string | undefined;
     /**
      * Gets the full name of the User.
      *
@@ -2311,6 +2400,12 @@ export declare class User {
      * @returns True if the User is in the free plan
      */
     isFree(): boolean | undefined;
+    /**
+     * Gets the plan of the User.
+     *
+     * @returns The User's plan
+     */
+    getPlan(): string | undefined;
     /**
      * Tells if billing is enabled for the User.
      *

package/lib/index.js

@@ -6,6 +6,7 @@
  * @packageDocumentation
  */
 export { Account } from './model/Account.js';
+export { Agent } from './model/Agent.js';
 export { Amount } from "./model/Amount.js";
 export { App } from './model/App.js';
 export { BalancesReport } from './model/BalancesReport.js';
@@ -22,5 +23,5 @@ export { TransactionList } from './model/TransactionList.js';
 export { Event } from './model/Event.js';
 export { EventList } from './model/EventList.js';
 export { User } from './model/User.js';
-export { Periodicity, DecimalSeparator, Permission, Visibility, AccountType, Period, Month } from './model/Enums.js';
+export { Periodicity, DecimalSeparator, Permission, Visibility, AccountType, Period, Month, EventType } from './model/Enums.js';
 //# sourceMappingURL=index.js.map

package/lib/model/Agent.js

@@ -0,0 +1,40 @@
+/**
+ * Defines an Agent on Bkper.
+ *
+ * An Agent represents an entity (such as an App or Bot) that interacts with Bkper, executing actions on behalf of users.
+ *
+ * @public
+ */
+export class Agent {
+    constructor(payload) {
+        this.payload = payload || {};
+    }
+    /**
+     * @returns The wrapped plain json object
+     */
+    json() {
+        return Object.assign({}, this.payload);
+    }
+    /**
+     *
+     * @returns The Agent universal identifier
+     */
+    getId() {
+        return this.payload.id;
+    }
+    /**
+     *
+     * @returns The Agent name
+     */
+    getName() {
+        return this.payload.name;
+    }
+    /**
+     *
+     * @returns The Agent logo url
+     */
+    getLogoUrl() {
+        return this.payload.logo;
+    }
+}
+//# sourceMappingURL=Agent.js.map

package/lib/model/Bkper.js

@@ -37,21 +37,6 @@ import { Collection } from "./Collection.js";
  * @public
  */
 export class Bkper {
-    /**
-     * Instantiate a new [[Book]]
-     *
-     * Example:
-     * ```js
-     * var book = Bkper.newBook()
-     *  .setName('My New Book')
-     *  .setFractionDigits(2)
-     *  .setDecimalSeparator('DOT')
-     *  .create();
-     * ```
-     */
-    static newBook() {
-        return new Book();
-    }
     /**
      * Gets the [[Book]] with the specified bookId from url param.
      *

package/lib/model/Book.js

@@ -252,6 +252,22 @@ export class Book {
     getTimeZoneOffset() {
         return this.payload.timeZoneOffset;
     }
+    /**
+     * @returns The auto post status of the Book
+     */
+    getAutoPost() {
+        return this.payload.autoPost;
+    }
+    /**
+     *
+     * Sets the auto post status of the Book
+     *
+     * @returns This Book, for chainning.
+     */
+    setAutoPost(autoPost) {
+        this.payload.autoPost = autoPost;
+        return this;
+    }
     /**
      * @returns The last update date of the book, in in milliseconds
      */

package/lib/model/Enums.js

@@ -148,4 +148,39 @@ export var Month;
     Month["NOVEMBER"] = "NOVEMBER";
     Month["DECEMBER"] = "DECEMBER";
 })(Month || (Month = {}));
+/**
+ * Enum that represents event types.
+ *
+ * @public
+ */
+export var EventType;
+(function (EventType) {
+    EventType["FILE_CREATED"] = "FILE_CREATED";
+    EventType["TRANSACTION_CREATED"] = "TRANSACTION_CREATED";
+    EventType["TRANSACTION_UPDATED"] = "TRANSACTION_UPDATED";
+    EventType["TRANSACTION_DELETED"] = "TRANSACTION_DELETED";
+    EventType["TRANSACTION_POSTED"] = "TRANSACTION_POSTED";
+    EventType["TRANSACTION_CHECKED"] = "TRANSACTION_CHECKED";
+    EventType["TRANSACTION_UNCHECKED"] = "TRANSACTION_UNCHECKED";
+    EventType["TRANSACTION_RESTORED"] = "TRANSACTION_RESTORED";
+    EventType["ACCOUNT_CREATED"] = "ACCOUNT_CREATED";
+    EventType["ACCOUNT_UPDATED"] = "ACCOUNT_UPDATED";
+    EventType["ACCOUNT_DELETED"] = "ACCOUNT_DELETED";
+    EventType["QUERY_CREATED"] = "QUERY_CREATED";
+    EventType["QUERY_UPDATED"] = "QUERY_UPDATED";
+    EventType["QUERY_DELETED"] = "QUERY_DELETED";
+    EventType["GROUP_CREATED"] = "GROUP_CREATED";
+    EventType["GROUP_UPDATED"] = "GROUP_UPDATED";
+    EventType["GROUP_DELETED"] = "GROUP_DELETED";
+    EventType["COMMENT_CREATED"] = "COMMENT_CREATED";
+    EventType["COMMENT_DELETED"] = "COMMENT_DELETED";
+    EventType["COLLABORATOR_ADDED"] = "COLLABORATOR_ADDED";
+    EventType["COLLABORATOR_UPDATED"] = "COLLABORATOR_UPDATED";
+    EventType["COLLABORATOR_REMOVED"] = "COLLABORATOR_REMOVED";
+    EventType["INTEGRATION_CREATED"] = "INTEGRATION_CREATED";
+    EventType["INTEGRATION_UPDATED"] = "INTEGRATION_UPDATED";
+    EventType["INTEGRATION_DELETED"] = "INTEGRATION_DELETED";
+    EventType["BOOK_UPDATED"] = "BOOK_UPDATED";
+    EventType["BOOK_DELETED"] = "BOOK_DELETED";
+})(EventType || (EventType = {}));
 //# sourceMappingURL=Enums.js.map

package/lib/model/Event.js

@@ -1,5 +1,10 @@
+import { Agent } from "./Agent";
+import { User } from "./User";
 /**
- * Represents an Event in the system.
+ *
+ * This class defines an Event from a [[Book]].
+ *
+ * An event is an object that represents an action (such as posting or deleting a [[Transaction]]) made by an actor (such as a user or a [Bot](https://bkper.com/apps) acting on behalf of a user).
  *
  * @public
  */
@@ -13,5 +18,29 @@ export class Event {
     json() {
         return Object.assign({}, this.payload);
     }
+    /**
+     * @returns The user who performed the event
+     */
+    getUser() {
+        return this.payload.user ? new User(this.payload.user) : undefined;
+    }
+    /**
+     * @returns The user who performed the event
+     */
+    getAgent() {
+        return this.payload.agent ? new Agent(this.payload.agent) : undefined;
+    }
+    /**
+     * @returns The date the event was created
+     */
+    getCreatedAt() {
+        return this.payload.createdAt ? new Date(new Number(this.payload.createdAt).valueOf()) : undefined;
+    }
+    /**
+     * @returns The type of the event
+     */
+    getType() {
+        return this.payload.type;
+    }
 }
 //# sourceMappingURL=Event.js.map

package/lib/model/User.js

@@ -41,6 +41,14 @@ export class User {
     getName() {
         return this.payload.name;
     }
+    /**
+     * Gets the avatar url of the User.
+     *
+     * @returns The User's avatar url
+     */
+    getAvatarUrl() {
+        return this.payload.avatarUrl;
+    }
     /**
      * Gets the full name of the User.
      *
@@ -73,6 +81,14 @@ export class User {
     isFree() {
         return this.payload.free;
     }
+    /**
+     * Gets the plan of the User.
+     *
+     * @returns The User's plan
+     */
+    getPlan() {
+        return this.payload.plan;
+    }
     /**
      * Tells if billing is enabled for the User.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bkper-js",
-  "version": "1.20.0",
+  "version": "1.22.0",
   "description": "Javascript client for Bkper REST API",
   "main": "./lib/index.js",
   "module": "./lib/index.js",
@@ -34,7 +34,7 @@
     "postversion": "git push --tags && yarn publish --new-version $npm_package_version && git push && echo \"Successfully released version $npm_package_version!\""
   },
   "peerDependencies": {
-    "@bkper/bkper-api-types": "^5.10.0"
+    "@bkper/bkper-api-types": "^5.12.0"
   },
   "dependencies": {
     "@google-cloud/local-auth": "^3.0.1",