@dawntech/blip-tools 0.1.10 → 0.2.0

package/dist/helpers/encode-blip-params.js

@@ -1,12 +1,10 @@
-function normalizeValue(value) {
-    return String(value).replaceAll(' ', '%20');
-}
+import encodeString from './encode-strings.js';
 export default function encodeBlipParams(params) {
     //This function does not uses any of the standard methods of URI parsing because Blip does not follow any of them
     const parsedParams = [];
     for (const [key, value] of Object.entries(params)) {
         if (value && key) {
-            parsedParams.push(`${normalizeValue(key)}=${normalizeValue(value)}`);
+            parsedParams.push(`${encodeString(key)}=${encodeString(value)}`);
         }
     }
     return parsedParams.join('&');

package/dist/helpers/encode-strings.d.ts

@@ -0,0 +1 @@
+export default function encodeString(value: unknown): string;

package/dist/helpers/encode-strings.js

@@ -0,0 +1,3 @@
+export default function encodeString(value) {
+    return String(value).replaceAll(' ', '%20');
+}

package/dist/index.d.ts

@@ -1,4 +1,3 @@
-import { AxiosInstance } from 'axios';
 import { Template } from './types/template.js';
 import { Contact } from './types/contact.js';
 import { BlipConstructor } from './types/blip-constructor.js';
@@ -7,9 +6,11 @@ import { AttendanceHourContainer } from './types/attendance-hour-container.js';
 import { Ticket } from './types/ticket.js';
 import { CampaignNotification } from './types/campaign-notification.js';
 import { CampaignNotificationStatus } from './types/campaign-notification-status.js';
+import BlipBucket from './modules/blip-bucket.js';
 export { BlipError, type Ticket, type AttendanceHourContainer, type Contact, type Template };
 export default class Blip {
-    api: AxiosInstance;
+    private api;
+    bucket: BlipBucket;
     constructor(params: BlipConstructor);
     /**
      * Sends a template-based message to any user. For sending messages to clients who are active, use `sendTemplateMessage` instead.
@@ -48,6 +49,11 @@ export default class Blip {
         identity: string;
         content: string;
     }): Promise<void>;
+    sendMessageWithButtons({ identity, message, buttons, }: {
+        identity: string;
+        message: string;
+        buttons: string[];
+    }): Promise<void>;
     updateContact({ identity, contactData }: {
         identity: string;
         contactData: Record<string, unknown>;

package/dist/index.js

@@ -6,9 +6,11 @@ import formatTemplateParams from './helpers/format-template-params.js';
 import validateInstance from './helpers/validate-instance.js';
 import BlipError from './exceptions/blip-error.js';
 import encodeBlipParams from './helpers/encode-blip-params.js';
+import BlipBucket from './modules/blip-bucket.js';
 export { BlipError };
 export default class Blip {
     api;
+    bucket;
     constructor(params) {
         validateInstance(params);
         this.api = axios.create({
@@ -18,6 +20,7 @@ export default class Blip {
             },
             timeout: 30000,
         });
+        this.bucket = new BlipBucket(this.api);
     }
     /**
      * Sends a template-based message to any user. For sending messages to clients who are active, use `sendTemplateMessage` instead.
@@ -142,6 +145,24 @@ export default class Blip {
             handleError(error);
         }
     }
+    async sendMessageWithButtons({ identity, message, buttons, }) {
+        try {
+            const response = await this.api.post('/messages', {
+                id: randomUUID(),
+                to: identity,
+                type: 'application/vnd.lime.select+json',
+                content: {
+                    scope: buttons.length <= 3 ? 'immediate' : null,
+                    text: message,
+                    options: buttons.map((button, index) => ({ order: index + 1, text: button })),
+                },
+            });
+            validateResponse(response);
+        }
+        catch (error) {
+            handleError(error);
+        }
+    }
     async updateContact({ identity, contactData }) {
         try {
             const response = await this.api.post('/commands', {
@@ -233,11 +254,9 @@ export default class Blip {
                 resource: {
                     category,
                     action,
+                    contact: identity ? { identity } : undefined,
                 },
             };
-            if (identity && body.resource) {
-                body.resource.contact = { identity };
-            }
             const response = await this.api.post('/commands', body);
             validateResponse(response);
         }

package/dist/modules/blip-bucket.d.ts

@@ -0,0 +1,21 @@
+import { AxiosInstance } from 'axios';
+export default class BlipBucket {
+    private api;
+    constructor(api: AxiosInstance);
+    /**
+        Stores JSON content in a bucket provided by Blip. The content can be updaded or retrieved using the same id used in the update.
+        You can optionally provide a expiration time (in milliseconds) to delete the document after a certain amount of time.
+    */
+    storeContentInBucket(id: string, content: unknown, opts?: {
+        expiresInMs?: number;
+    }): Promise<void>;
+    /**
+        Retrieves a document from the Blip bucket.
+    */
+    getContentFromBucket<T>(id: string): Promise<T>;
+    getAllContentIdsFromBucket(): Promise<string[]>;
+    /**
+        Deletes a JSON document from the Blip bucket.
+    */
+    deleteContentFromBucket(id: string): Promise<void>;
+}

package/dist/modules/blip-bucket.js

@@ -0,0 +1,88 @@
+import encodeString from '../helpers/encode-strings.js';
+import { randomUUID } from 'crypto';
+import encodeBlipParams from '../helpers/encode-blip-params.js';
+import validateResponse from '../helpers/validate-response.js';
+import handleError from '../helpers/handle-error.js';
+export default class BlipBucket {
+    api;
+    constructor(api) {
+        this.api = api;
+    }
+    /**
+        Stores JSON content in a bucket provided by Blip. The content can be updaded or retrieved using the same id used in the update.
+        You can optionally provide a expiration time (in milliseconds) to delete the document after a certain amount of time.
+    */
+    async storeContentInBucket(id, content, opts) {
+        try {
+            let uri = `/buckets/${encodeString(id)}`;
+            const params = {};
+            if (opts?.expiresInMs) {
+                params.expiration = opts?.expiresInMs;
+                uri += `?${encodeBlipParams(params)}`;
+            }
+            const body = {
+                id: randomUUID(),
+                method: 'set',
+                type: 'application/json',
+                uri,
+                resource: content,
+            };
+            const response = await this.api.post('/commands', body);
+            validateResponse(response);
+        }
+        catch (error) {
+            throw handleError(error);
+        }
+    }
+    /**
+        Retrieves a document from the Blip bucket.
+    */
+    async getContentFromBucket(id) {
+        try {
+            const body = {
+                id: randomUUID(),
+                method: 'get',
+                uri: `/buckets/${encodeString(id)}`,
+            };
+            const response = await this.api.post('/commands', body);
+            validateResponse(response);
+            return response.data.resource;
+        }
+        catch (error) {
+            throw handleError(error);
+        }
+    }
+    async getAllContentIdsFromBucket() {
+        try {
+            const body = {
+                id: randomUUID(),
+                method: 'get',
+                uri: `/buckets`,
+            };
+            const response = await this.api.post('/commands', body);
+            validateResponse(response);
+            return response.data.resource.items;
+        }
+        catch (error) {
+            throw handleError(error);
+        }
+    }
+    /**
+        Deletes a JSON document from the Blip bucket.
+    */
+    async deleteContentFromBucket(id) {
+        try {
+            const body = {
+                id: randomUUID(),
+                method: 'delete',
+                uri: `/buckets/${encodeString(id)}`,
+                to: 'postmaster@msging.net',
+            };
+            const response = await this.api.post('/commands', body);
+            validateResponse(response);
+        }
+        catch (error) {
+            throw handleError(error);
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dawntech/blip-tools",
-  "version": "0.1.10",
+  "version": "0.2.0",
   "description": "Node package for Blip API",
   "main": "dist/index.js",
   "module": "dist/index.js",