@space-df/sdk 0.0.1-dev.41 → 0.0.1-dev.42

package/api.doc.md

@@ -3121,6 +3121,67 @@ console.log(alerts.count);
 
 </details>
 
+<details>
+  <summary><strong>events.list</strong></summary>
+
+List telemetry events for a device with optional filtering and pagination.
+
+**Signature:**
+
+```typescript
+list(device_id: string, params: EventsListParams, options?: Core.RequestOptions): Core.APIPromise<ListResponse<TelemetryEvent>>
+```
+
+**Parameters:**
+
+-   `device_id` _(string)_: The unique identifier of the device to fetch events for.
+-   `params` _(EventsListParams)_: Query parameters for filtering and pagination:
+    -   `limit` _(integer, optional)_: Number of results to return per page.
+    -   `offset` _(integer, optional)_: The initial index from which to return the results.
+    -   `search` _(string, optional)_: A search term to filter results.
+-   `options` _(Core.RequestOptions)_: Additional request options.
+
+**Returns:** `Promise<ListResponse<TelemetryEvent>>`
+
+**Response shape:**
+
+-   `count` _(integer)_: Total number of events matching the query.
+-   `next` _(string | null)_: URL to the next page of results, or `null`.
+-   `previous` _(string | null)_: URL to the previous page of results, or `null`.
+-   `results` _(TelemetryEvent[])_: Array of telemetry event objects.
+
+**TelemetryEvent shape:**
+
+-   `id` _(integer)_: Event ID.
+-   `event_type` _(string)_: Event type (e.g., `"device_event"`).
+-   `event_level` _(string)_: Event level/category (e.g., `"automation"`).
+-   `title` _(string)_: Human-readable event title.
+-   `entity_id` _(string)_: Entity UUID associated with the event.
+-   `time_fired` _(string)_: ISO timestamp when the event fired.
+-   `geofence` _(object, optional)_: Geofence metadata, when applicable:
+    -   `id` _(string)_: Geofence UUID.
+    -   `name` _(string)_: Geofence name.
+    -   `type_zone` _(string)_: Zone type (e.g., `"danger"`).
+-   `automation` _(object, optional)_: Automation metadata, when applicable:
+    -   `id` _(string)_: Automation UUID.
+    -   `name` _(string)_: Automation name.
+-   `location` _(object, optional)_: Location, when applicable:
+    -   `latitude` _(number)_: Latitude.
+    -   `longitude` _(number)_: Longitude.
+
+**Example:**
+
+```typescript
+const events = await client.telemetry.events.list('device-uuid-123', {
+    search: 'Danger Zone',
+    limit: 10,
+    offset: 0,
+});
+console.log(events.results);
+```
+
+</details>
+
 <details>
   <summary><strong>geofences.list</strong></summary>
 

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@space-df/sdk",
-  "version": "0.0.1-dev.41",
+  "version": "0.0.1-dev.42",
   "description": "The official TypeScript library for the Spacedf SDK API",
   "author": "Spacedf SDK <support@digitalfortress.dev>",
   "types": "./index.d.ts",

package/dist/resources/telemetry/events.d.ts

@@ -0,0 +1,37 @@
+import { APIResource } from '@space-df/sdk/resource';
+import * as Core from "../../core.js";
+import { ListResponse } from '@space-df/sdk/types/api';
+interface TelemetryEventGeofence {
+    id: string;
+    name: string;
+    type_zone: string;
+}
+interface TelemetryAutomation {
+    id: string;
+    name: string;
+}
+interface TelemetryEventLocation {
+    latitude: number;
+    longitude: number;
+}
+interface TelemetryEvent {
+    id: number;
+    event_type: string;
+    event_level: string;
+    title: string;
+    entity_id: string;
+    time_fired: string;
+    geofence?: TelemetryEventGeofence;
+    automation?: TelemetryAutomation;
+    location?: TelemetryEventLocation;
+}
+interface EventsListParams {
+    limit?: number;
+    offset?: number;
+    search?: string;
+}
+export declare class Events extends APIResource {
+    list(device_id: string, params: EventsListParams, options?: Core.RequestOptions): Core.APIPromise<ListResponse<TelemetryEvent>>;
+}
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/resources/telemetry/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/resources/telemetry/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,IAAI,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,UAAU,sBAAsB;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,mBAAmB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,sBAAsB;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,cAAc;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;CACrC;AAED,UAAU,gBAAgB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,MAAO,SAAQ,WAAW;IACnC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;CAQlI"}

package/dist/resources/telemetry/events.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Events = void 0;
+const resource_1 = require("@space-df/sdk/resource");
+class Events extends resource_1.APIResource {
+    list(device_id, params, options) {
+        const { ...query } = params;
+        return this._client.get(`/telemetry/v1/events/device/${device_id}`, {
+            query,
+            ...options,
+            headers: { ...options?.headers },
+        });
+    }
+}
+exports.Events = Events;
+//# sourceMappingURL=events.js.map

package/dist/resources/telemetry/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/resources/telemetry/events.ts"],"names":[],"mappings":";;;AAAA,qDAAqD;AAsCrD,MAAa,MAAO,SAAQ,sBAAW;IACnC,IAAI,CAAC,SAAiB,EAAE,MAAwB,EAAE,OAA6B;QAC3E,MAAM,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,+BAA+B,SAAS,EAAE,EAAE;YAChE,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE;SACnC,CAAC,CAAC;IACP,CAAC;CACJ;AATD,wBASC"}

package/dist/resources/telemetry/events.mjs

@@ -0,0 +1,12 @@
+import { APIResource } from '@space-df/sdk/resource';
+export class Events extends APIResource {
+    list(device_id, params, options) {
+        const { ...query } = params;
+        return this._client.get(`/telemetry/v1/events/device/${device_id}`, {
+            query,
+            ...options,
+            headers: { ...options?.headers },
+        });
+    }
+}
+//# sourceMappingURL=events.mjs.map

package/dist/resources/telemetry/events.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.mjs","sourceRoot":"","sources":["../../src/resources/telemetry/events.ts"],"names":[],"mappings":"OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB;AAsCpD,MAAM,OAAO,MAAO,SAAQ,WAAW;IACnC,IAAI,CAAC,SAAiB,EAAE,MAAwB,EAAE,OAA6B;QAC3E,MAAM,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,+BAA+B,SAAS,EAAE,EAAE;YAChE,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE;SACnC,CAAC,CAAC;IACP,CAAC;CACJ"}

package/dist/resources/telemetry/index.d.ts

@@ -2,10 +2,11 @@ import { APIResource } from '@space-df/sdk/resource';
 import { Entities } from "./entities.js";
 import { Alerts } from "./alerts.js";
 import { Geofences } from "./geofences.js";
+import { Events } from "./events.js";
 export declare class Telemetry extends APIResource {
     entities: Entities;
     alerts: Alerts;
     geofences: Geofences;
+    events: Events;
 }
-export * from "./entities.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/resources/telemetry/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/telemetry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,qBAAa,SAAU,SAAQ,WAAW;IACtC,QAAQ,EAAE,QAAQ,CAA8B;IAChD,MAAM,EAAE,MAAM,CAA4B;IAC1C,SAAS,EAAE,SAAS,CAA+B;CACtD;AAED,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/telemetry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,qBAAa,SAAU,SAAQ,WAAW;IACtC,QAAQ,EAAE,QAAQ,CAA8B;IAChD,MAAM,EAAE,MAAM,CAA4B;IAC1C,SAAS,EAAE,SAAS,CAA+B;IACnD,MAAM,EAAE,MAAM,CAA4B;CAC7C"}

package/dist/resources/telemetry/index.js

@@ -1,32 +1,19 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Telemetry = void 0;
 const resource_1 = require("@space-df/sdk/resource");
 const entities_1 = require("./entities.js");
 const alerts_1 = require("./alerts.js");
 const geofences_1 = require("./geofences.js");
+const events_1 = require("./events.js");
 class Telemetry extends resource_1.APIResource {
     constructor() {
         super(...arguments);
         this.entities = new entities_1.Entities(this._client);
         this.alerts = new alerts_1.Alerts(this._client);
         this.geofences = new geofences_1.Geofences(this._client);
+        this.events = new events_1.Events(this._client);
     }
 }
 exports.Telemetry = Telemetry;
-__exportStar(require("./entities.js"), exports);
 //# sourceMappingURL=index.js.map

package/dist/resources/telemetry/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/telemetry/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,qDAAqD;AACrD,4CAAsC;AACtC,wCAAkC;AAClC,8CAAwC;AAExC,MAAa,SAAU,SAAQ,sBAAW;IAA1C;;QACI,aAAQ,GAAa,IAAI,mBAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChD,WAAM,GAAW,IAAI,eAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,cAAS,GAAc,IAAI,qBAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvD,CAAC;CAAA;AAJD,8BAIC;AAED,gDAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/telemetry/index.ts"],"names":[],"mappings":";;;AAAA,qDAAqD;AACrD,4CAAsC;AACtC,wCAAkC;AAClC,8CAAwC;AACxC,wCAAkC;AAElC,MAAa,SAAU,SAAQ,sBAAW;IAA1C;;QACI,aAAQ,GAAa,IAAI,mBAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChD,WAAM,GAAW,IAAI,eAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,cAAS,GAAc,IAAI,qBAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnD,WAAM,GAAW,IAAI,eAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;CAAA;AALD,8BAKC"}

package/dist/resources/telemetry/index.mjs

@@ -2,13 +2,14 @@ import { APIResource } from '@space-df/sdk/resource';
 import { Entities } from "./entities.mjs";
 import { Alerts } from "./alerts.mjs";
 import { Geofences } from "./geofences.mjs";
+import { Events } from "./events.mjs";
 export class Telemetry extends APIResource {
     constructor() {
         super(...arguments);
         this.entities = new Entities(this._client);
         this.alerts = new Alerts(this._client);
         this.geofences = new Geofences(this._client);
+        this.events = new Events(this._client);
     }
 }
-export * from "./entities.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/resources/telemetry/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/resources/telemetry/index.ts"],"names":[],"mappings":"OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB;OAC7C,EAAE,QAAQ,EAAE;OACZ,EAAE,MAAM,EAAE;OACV,EAAE,SAAS,EAAE;AAEpB,MAAM,OAAO,SAAU,SAAQ,WAAW;IAA1C;;QACI,aAAQ,GAAa,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChD,WAAM,GAAW,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,cAAS,GAAc,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvD,CAAC;CAAA"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/resources/telemetry/index.ts"],"names":[],"mappings":"OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB;OAC7C,EAAE,QAAQ,EAAE;OACZ,EAAE,MAAM,EAAE;OACV,EAAE,SAAS,EAAE;OACb,EAAE,MAAM,EAAE;AAEjB,MAAM,OAAO,SAAU,SAAQ,WAAW;IAA1C;;QACI,aAAQ,GAAa,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChD,WAAM,GAAW,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,cAAS,GAAc,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnD,WAAM,GAAW,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;CAAA"}

package/dist/src/resources/telemetry/events.ts

@@ -0,0 +1,48 @@
+import { APIResource } from "../../resource";
+import * as Core from '../../core';
+import { ListResponse } from "../../types/api";
+
+interface TelemetryEventGeofence {
+    id: string;
+    name: string;
+    type_zone: string;
+}
+
+interface TelemetryAutomation {
+    id: string;
+    name: string;
+}
+
+interface TelemetryEventLocation {
+    latitude: number;
+    longitude: number;
+}
+
+interface TelemetryEvent {
+    id: number;
+    event_type: string;
+    event_level: string;
+    title: string;
+    entity_id: string;
+    time_fired: string;
+    geofence?: TelemetryEventGeofence;
+    automation?: TelemetryAutomation;
+    location?: TelemetryEventLocation;
+}
+
+interface EventsListParams {
+    limit?: number;
+    offset?: number;
+    search?: string;
+}
+
+export class Events extends APIResource {
+    list(device_id: string, params: EventsListParams, options?: Core.RequestOptions): Core.APIPromise<ListResponse<TelemetryEvent>> {
+        const { ...query } = params;
+        return this._client.get(`/telemetry/v1/events/device/${device_id}`, {
+            query,
+            ...options,
+            headers: { ...options?.headers },
+        });
+    }
+}

package/dist/src/resources/telemetry/index.ts

@@ -2,11 +2,11 @@ import { APIResource } from "../../resource";
 import { Entities } from './entities';
 import { Alerts } from './alerts';
 import { Geofences } from './geofences';
+import { Events } from './events';
 
 export class Telemetry extends APIResource {
     entities: Entities = new Entities(this._client);
     alerts: Alerts = new Alerts(this._client);
     geofences: Geofences = new Geofences(this._client);
+    events: Events = new Events(this._client);
 }
-
-export * from './entities';

package/dist/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.0.1-dev.41';
+export const VERSION = '0.0.1-dev.42';

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.0.1-dev.41";
+export declare const VERSION = "0.0.1-dev.42";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.0.1-dev.41';
+exports.VERSION = '0.0.1-dev.42';
 //# sourceMappingURL=version.js.map

package/dist/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.0.1-dev.41';
+export const VERSION = '0.0.1-dev.42';
 //# sourceMappingURL=version.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@space-df/sdk",
-  "version": "0.0.1-dev.41",
+  "version": "0.0.1-dev.42",
   "description": "The official TypeScript library for the Spacedf SDK API",
   "author": "Spacedf SDK <support@digitalfortress.dev>",
   "types": "dist/index.d.ts",

package/src/resources/telemetry/events.ts

@@ -0,0 +1,48 @@
+import { APIResource } from '@space-df/sdk/resource';
+import * as Core from '../../core';
+import { ListResponse } from '@space-df/sdk/types/api';
+
+interface TelemetryEventGeofence {
+    id: string;
+    name: string;
+    type_zone: string;
+}
+
+interface TelemetryAutomation {
+    id: string;
+    name: string;
+}
+
+interface TelemetryEventLocation {
+    latitude: number;
+    longitude: number;
+}
+
+interface TelemetryEvent {
+    id: number;
+    event_type: string;
+    event_level: string;
+    title: string;
+    entity_id: string;
+    time_fired: string;
+    geofence?: TelemetryEventGeofence;
+    automation?: TelemetryAutomation;
+    location?: TelemetryEventLocation;
+}
+
+interface EventsListParams {
+    limit?: number;
+    offset?: number;
+    search?: string;
+}
+
+export class Events extends APIResource {
+    list(device_id: string, params: EventsListParams, options?: Core.RequestOptions): Core.APIPromise<ListResponse<TelemetryEvent>> {
+        const { ...query } = params;
+        return this._client.get(`/telemetry/v1/events/device/${device_id}`, {
+            query,
+            ...options,
+            headers: { ...options?.headers },
+        });
+    }
+}

package/src/resources/telemetry/index.ts

@@ -2,11 +2,11 @@ import { APIResource } from '@space-df/sdk/resource';
 import { Entities } from './entities';
 import { Alerts } from './alerts';
 import { Geofences } from './geofences';
+import { Events } from './events';
 
 export class Telemetry extends APIResource {
     entities: Entities = new Entities(this._client);
     alerts: Alerts = new Alerts(this._client);
     geofences: Geofences = new Geofences(this._client);
+    events: Events = new Events(this._client);
 }
-
-export * from './entities';

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.0.1-dev.41';
+export const VERSION = '0.0.1-dev.42';