Merge pull request #115 from Space-DF/feat/implement-notification-sdk

feat: implement notification sdk

Author: huyphan02

api.doc.md

@@ -3652,7 +3652,7 @@ await client.trip.delete('trip-uuid-456');
 
 ## Overview
 
-The `Telemetry` class provides methods for retrieving telemetry entities, alerts, events, automations, actions, and geofences. This class allows you to search and filter telemetry entities by display type and search terms, retrieve alerts, query events by device, list telemetry actions, manage automations (list, create, retrieve, update, delete), and manage geofences (list, create, retrieve, update, delete, test).
+The `Telemetry` class provides methods for retrieving telemetry entities, alerts, events, automations, actions, notifications, and geofences. This class allows you to search and filter telemetry entities by display type and search terms, retrieve alerts, query events by device, list telemetry actions, manage notification subscriptions, manage automations (list, create, retrieve, update, delete), and manage geofences (list, create, retrieve, update, delete, test).
 
 ## Methods
 
@@ -4006,6 +4006,39 @@ console.log(actions.results);
 
 </details>
 
+<details>
+  <summary><strong>notifications.subscribe</strong></summary>
+
+Subscribe a push notification endpoint for telemetry notifications.
+
+**Signature:**
+
+```typescript
+subscribe(params: NotificationsSubscribeParams, options?: Core.RequestOptions): Core.APIPromise<unknown>
+```
+
+**Parameters:**
+
+-   `params` _(NotificationsSubscribeParams)_: Subscription payload:
+    -   `auth` _(string)_: Push subscription auth secret.
+    -   `endpoint` _(string)_: Push service endpoint URL.
+    -   `p256dh` _(string)_: Push subscription \(p256dh\) public key.
+-   `options` _(Core.RequestOptions)_: Additional request options.
+
+**Returns:** `Promise<unknown>`
+
+**Example:**
+
+```typescript
+await client.telemetry.notifications.subscribe({
+    auth: 'string1',
+    endpoint: 'string3',
+    p256dh: 'string5',
+});
+```
+
+</details>
+
 <details>
   <summary><strong>automations.summary</strong></summary>
 

src/resources/telemetry/index.ts

@@ -5,6 +5,7 @@ import { Geofences } from './geofences';
 import { Automations } from './automations';
 import { Events } from './events';
 import { Actions } from './actions';
+import { Notifications } from './notifications';
 
 export class Telemetry extends APIResource {
     entities: Entities = new Entities(this._client);
@@ -13,4 +14,5 @@ export class Telemetry extends APIResource {
     automations: Automations = new Automations(this._client);
     events: Events = new Events(this._client);
     actions: Actions = new Actions(this._client);
+    notifications: Notifications = new Notifications(this._client);
 }

src/resources/telemetry/notifications.ts

@@ -0,0 +1,20 @@
+import { APIResource } from '../../resource';
+import * as Core from '../../core';
+
+export interface NotificationsSubscribeParams {
+    auth: string;
+    endpoint: string;
+    p256dh: string;
+}
+
+export type NotificationsSubscribeResponse = unknown;
+
+export class Notifications extends APIResource {
+    subscribe(params: NotificationsSubscribeParams, options?: Core.RequestOptions): Core.APIPromise<NotificationsSubscribeResponse> {
+        const { ...body } = params;
+        return this._client.post(`/telemetry/v1/notifications/subscribe`, {
+            body,
+            ...options,
+        });
+    }
+}