bkper-js 2.36.0 → 2.38.0

package/lib/index.d.ts

@@ -2328,6 +2328,12 @@ export declare class Collaborator extends Resource<bkper.Collaborator> {
      * @returns This Collaborator, for chaining
      */
     setPermission(permission: Permission): Collaborator;
+    /**
+     * Gets the public avatar url of the Collaborator.
+     *
+     * @returns The Collaborator's public avatar url
+     */
+    getAvatarUrl(): string | undefined;
     /**
      * Performs create new Collaborator.
      *
@@ -2574,7 +2580,7 @@ export declare class Connection extends ResourceProperty<bkper.Connection> {
      *
      * @returns The Connection type
      */
-    getType(): "APP" | "BANK" | undefined;
+    getType(): 'APP' | 'BANK' | undefined;
     /**
      * Sets the Connection type.
      *
@@ -2582,7 +2588,7 @@ export declare class Connection extends ResourceProperty<bkper.Connection> {
      *
      * @returns The Connection, for chaining
      */
-    setType(type: "APP" | "BANK"): Connection;
+    setType(type: 'APP' | 'BANK'): Connection;
     /**
      * Cleans any token property stored in the Connection.
      */
@@ -2599,6 +2605,12 @@ export declare class Connection extends ResourceProperty<bkper.Connection> {
      * @returns The created Connection, for chaining
      */
     create(): Promise<Connection>;
+    /**
+     * Performs update Connection.
+     *
+     * @returns The updated Connection object
+     */
+    update(): Promise<Connection>;
     /**
      * Performs remove Connection.
      *
@@ -3197,6 +3209,14 @@ export declare class Integration extends ResourceProperty<bkper.Integration> {
      * @returns The Integration's name
      */
     getName(): string | undefined;
+    /**
+     * Sets the name of the Integration.
+     *
+     * @param name - The name of the Integration
+     *
+     * @returns The Integration, for chaining
+     */
+    setName(name: string): Integration;
     /**
      * Gets the name of the user who added the Integration.
      *
@@ -3241,6 +3261,12 @@ export declare class Integration extends ResourceProperty<bkper.Integration> {
      * @returns The Integration last update date in milliseconds
      */
     getLastUpdateMs(): string | undefined;
+    /**
+     * Performs update Integration.
+     *
+     * @returns The updated Integration object
+     */
+    update(): Promise<Integration>;
     /**
      * Performs remove Integration.
      *
@@ -3457,6 +3483,16 @@ declare abstract class Resource<T = any> {
  * Extends Resource<T> and adds property management methods for entities
  * that have a properties field in their payload.
  *
+ * Custom property keys are normalized and validated by the Bkper API when
+ * resources are persisted:
+ *
+ * - Keys can have up to 30 characters after normalization.
+ * - Keys are normalized to lowercase, spaces become underscores, and unsupported
+ *   punctuation is removed.
+ * - Keys ending with an underscore (`_`) are treated as hidden/internal by SDK
+ *   visible-property helpers.
+ * - Empty, null, or undefined values clear the property when saved.
+ *
  * @public
  */
 declare abstract class ResourceProperty<T extends {
@@ -3494,6 +3530,10 @@ declare abstract class ResourceProperty<T extends {
     /**
      * Sets a custom property in this resource.
      *
+     * Property keys are normalized and validated by the API when saved. Keep keys
+     * to 30 characters or fewer after normalization. Use a trailing underscore
+     * (`_`) for hidden/internal properties.
+     *
      * @param key - The property key
      * @param value - The property value, or null/undefined to clean it
      *

package/lib/model/Collaborator.js

@@ -71,6 +71,14 @@ export class Collaborator extends Resource {
         this.payload.permission = permission;
         return this;
     }
+    /**
+     * Gets the public avatar url of the Collaborator.
+     *
+     * @returns The Collaborator's public avatar url
+     */
+    getAvatarUrl() {
+        return this.payload.avatarUrl;
+    }
     /**
      * Performs create new Collaborator.
      *

package/lib/model/Connection.js

@@ -7,10 +7,10 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import { ResourceProperty } from "./ResourceProperty.js";
-import { Bkper } from "./Bkper.js";
-import * as ConnectionService from "../service/connection-service.js";
-import { Integration } from "./Integration.js";
+import { ResourceProperty } from './ResourceProperty.js';
+import { Bkper } from './Bkper.js';
+import * as ConnectionService from '../service/connection-service.js';
+import { Integration } from './Integration.js';
 /**
  * This class defines a Connection from an [[User]] to an external service.
  *
@@ -138,8 +138,8 @@ export class Connection extends ResourceProperty {
      */
     clearTokenProperties() {
         this.getPropertyKeys()
-            .filter((key) => key.includes("token"))
-            .forEach((key) => this.deleteProperty(key));
+            .filter(key => key.includes('token'))
+            .forEach(key => this.deleteProperty(key));
     }
     /**
      * Gets the existing [[Integrations]] on the Connection.
@@ -153,7 +153,7 @@ export class Connection extends ResourceProperty {
                 return [];
             }
             const integrationsPlain = yield ConnectionService.listIntegrations(id, this.getConfig());
-            const integrations = integrationsPlain.map((i) => new Integration(i, this.config));
+            const integrations = integrationsPlain.map(i => new Integration(i, this.config));
             return integrations;
         });
     }
@@ -168,6 +168,17 @@ export class Connection extends ResourceProperty {
             return this;
         });
     }
+    /**
+     * Performs update Connection.
+     *
+     * @returns The updated Connection object
+     */
+    update() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.payload = yield ConnectionService.updateConnection(this.payload, this.getConfig());
+            return this;
+        });
+    }
     /**
      * Performs remove Connection.
      *

package/lib/model/Integration.js

@@ -7,9 +7,9 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import * as IntegrationService from "../service/integration-service.js";
-import { ResourceProperty } from "./ResourceProperty.js";
-import { Bkper } from "./Bkper.js";
+import * as IntegrationService from '../service/integration-service.js';
+import { ResourceProperty } from './ResourceProperty.js';
+import { Bkper } from './Bkper.js';
 /**
  * This class defines a Integration from an [[User]] to an external service.
  *
@@ -48,6 +48,17 @@ export class Integration extends ResourceProperty {
     getName() {
         return this.payload.name;
     }
+    /**
+     * Sets the name of the Integration.
+     *
+     * @param name - The name of the Integration
+     *
+     * @returns The Integration, for chaining
+     */
+    setName(name) {
+        this.payload.name = name;
+        return this;
+    }
     /**
      * Gets the name of the user who added the Integration.
      *
@@ -106,6 +117,20 @@ export class Integration extends ResourceProperty {
     getLastUpdateMs() {
         return this.payload.lastUpdateMs;
     }
+    /**
+     * Performs update Integration.
+     *
+     * @returns The updated Integration object
+     */
+    update() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const bookId = this.getBookId();
+            if (bookId) {
+                this.payload = yield IntegrationService.updateIntegration(bookId, this.payload, this.getConfig());
+            }
+            return this;
+        });
+    }
     /**
      * Performs remove Integration.
      *

package/lib/model/ResourceProperty.js

@@ -5,6 +5,16 @@ import { Resource } from "./Resource.js";
  * Extends Resource<T> and adds property management methods for entities
  * that have a properties field in their payload.
  *
+ * Custom property keys are normalized and validated by the Bkper API when
+ * resources are persisted:
+ *
+ * - Keys can have up to 30 characters after normalization.
+ * - Keys are normalized to lowercase, spaces become underscores, and unsupported
+ *   punctuation is removed.
+ * - Keys ending with an underscore (`_`) are treated as hidden/internal by SDK
+ *   visible-property helpers.
+ * - Empty, null, or undefined values clear the property when saved.
+ *
  * @public
  */
 export class ResourceProperty extends Resource {
@@ -62,6 +72,10 @@ export class ResourceProperty extends Resource {
     /**
      * Sets a custom property in this resource.
      *
+     * Property keys are normalized and validated by the API when saved. Keep keys
+     * to 30 characters or fewer after normalization. Use a trailing underscore
+     * (`_`) for hidden/internal properties.
+     *
      * @param key - The property key
      * @param value - The property value, or null/undefined to clean it
      *

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "bkper-js",
-    "version": "2.36.0",
+    "version": "2.38.0",
     "description": "Javascript client for Bkper REST API",
     "main": "./lib/index.js",
     "module": "./lib/index.js",
@@ -38,7 +38,7 @@
         "release:major": "npm version major -m \"chore(release): v%s\""
     },
     "dependencies": {
-        "@bkper/bkper-api-types": "^5.41.0",
+        "@bkper/bkper-api-types": "^5.42.0",
         "big.js": "^6.0.3",
         "dayjs": "^1.10.3",
         "luxon": "^1.25.0",