@dimo-network/data-sdk 1.2.3 → 1.2.5

package/README.jp.md

@@ -0,0 +1,86 @@
+![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/dimo-network/data-sdk/npm-publish.yml?style=flat-square)
+![GitHub top language](https://img.shields.io/github/languages/top/dimo-network/data-sdk?style=flat-square)
+![GitHub License](https://img.shields.io/github/license/dimo-network/data-sdk?style=flat-square)
+[![Downloads](https://img.shields.io/npm/d18m/@dimo-network/data-sdk.svg?style=flat-square)](https://www.npmjs.com/package/@dimo-network/data-sdk)
+[![Discord](https://img.shields.io/discord/892438668453740634)](https://chat.dimo.zone/)
+![X (formerly Twitter) URL](https://img.shields.io/twitter/url?url=https%3A%2F%2Ftwitter.com%2FDIMO_Network&style=social)
+
+# DIMO（智猛）Data SDK
+## 概要
+DIMO Data SDK は、TypeScript で構築された公式ライブラリであり、DIMO API を簡単かつ効率的に利用できるように設計されています。この SDK は、開発者が DIMO プラットフォームと統合する際の複雑さを軽減し、迅速な開発を可能にします。API 呼び出しの抽象化、データ操作の簡素化、そして堅牢な型安全性を提供することで、開発者体験を向上させます。
+
+## インストール
+
+[npm](https://www.npmjs.com/package/@dimo-network/data-sdk) を使用する場合:
+```bash
+npm install @dimo-network/data-sdk
+```
+
+[yarn](https://classic.yarnpkg.com/en/package/@dimo-network/data-sdk) を使用する場合:
+
+```bash
+yarn add @dimo-network/data-sdk
+```
+
+## 単体テスト
+`npm test` または `npm run test` を実行して、Jest テストを実行します。
+
+## API ドキュメント
+DIMO での開発や API に関する詳細情報については、DIMO の [開発者向けドキュメント](https://docs.dimo.org/developer-platform) をご覧ください。
+
+## SDK の使用方法
+### SDK ライブラリ
+
+(TypeScript / ES Modules)
+```ts
+import { DIMO } from '@dimo-network/data-sdk';
+```
+
+(CommonJS)
+```js
+const { DIMO } = require('@dimo-network/data-sdk')
+```
+### SDK 初期化
+
+```ts
+const dimo = new DIMO('Production');
+```
+
+### 開発者登録
+認証プロセスの一環として、[DIMO 開発者コンソール](https://console.dimo.org/) を通じて開発者ライセンスを取得する必要があります。登録を開始するには、以下の手順に従ってください:
+1. [DIMO 開発者コンソール](https://console.dimo.org/) にサインアップします。
+2. 「ライセンスを作成」(Create a License) をクリックし、ライセンスに関する詳細を入力します。
+3. API キー（API Key）を生成し、希望するリダイレクト URI（RedirectURI）を追加します。
+
+### 開発者認証
+SDK は、[認証フロー](https://docs.dimo.org/developer-platform/getting-started/developer-guide/authentication) に必要なすべての手順を提供し、「開発者 JWT」（Developer JWT） を取得し、アプリと共有されている各車両の「車両 JWT」（Vehicle JWT） を取得することができます。
+
+#### 認証の前提条件
+1. 開発者ライセンス
+2. API キー、リダイレクト URI（RedirectURI）
+3. 適切な [TypeScript を使用したプロジェクトのセットアップ](https://nodejs.keicode.com/typescript/create-ts-project.php)。
+
+#### 開発者 JWT
+
+```ts
+const developerJwt = await dimo.auth.getDeveloperJwt({
+  client_id: '<client_id>',
+  domain: '<domain/redirect_uri>',
+  private_key: '<api_key>',
+});
+```
+
+#### 車両 JWT
+消費者から車両データを取得するには、アプリケーションが短期間有効な [車両 JWT](https://docs.dimo.org/developer-platform/getting-started/developer-guide/authentication#getting-a-jwt) を交換する必要があります。この 車両 JWT は、アプリに権限を付与した車両に対して取得されます。
+
+消費者は事前に車両の権限を共有する必要があります。そのためには、[Login with DIMO](https://docs.dimo.org/developer-platform/getting-started/developer-guide/login-with-dimo) や DIMO Mobile のような実装が必要です。この手順が完了すると、車両データを取得できるようになります。
+
+```ts
+const vehicleJwt = await dimo.tokenexchange.getVehicleJwt({
+  ...developerJwt,
+  tokenId: 117315
+});
+```
+
+## SDK への貢献方法
+SDK への貢献についての詳細は、[こちら](https://github.com/DIMO-Network/data-sdk/blob/master/CONTRIBUTING.md)をご覧ください。

package/README.md

@@ -37,7 +37,7 @@ import { DIMO } from '@dimo-network/data-sdk';
 
 (CommonJS)
 ```js
-const { DIMO } = require('@dimo-network/data-sdk/dist/index.cjs')
+const { DIMO } = require('@dimo-network/data-sdk')
 ```
 
 Initiate the SDK:
@@ -49,39 +49,36 @@ const dimo = new DIMO('Production');
 ### Developer Registration
 As part of the authentication process, you will need to obtain a Developer License via the [DIMO Developer Console](https://console.dimo.org/). To get started with registration, follow the steps below:
 1. Sign up on the [DIMO Developer Console](https://console.dimo.org/).
-2. Get DIMO Credits (DCX) either by paying in your local currency (via Stripe) or paying with a balance (if you have one).
-3. Click on `Create app` and fill out the details about your project namespace (external-facing, e.g. `Drive2Survive LLC.`) and your application name (internal, e.g. `app-prod`)
-4. Generate an API key and add in your preferred redirect URI.
+2. Click on `Create a license` and fill out the details about your license.
+3. Generate an API key and add in your preferred redirect URI.
 
 ### Authentication
 
-The SDK provides you with all the steps needed in the [Authentication Flow](https://docs.dimo.org/developer-platform/getting-started/developer-guide/authentication) to obtain a Developer JWT.
+The SDK provides you with all the steps needed in the [Authentication Flow](https://docs.dimo.org/developer-platform/getting-started/developer-guide/authentication) to obtain a Developer JWT & to get Vehicle JWT for each vehicle shared with your app.
 
 #### Prerequisites for Authentication
 1. A valid Developer License with a `client_id`
 2. A valid API key, generated via the Developer Console
 3. A proper [project set up with TypeScript](https://www.digitalocean.com/community/tutorials/setting-up-a-node-project-with-typescript).
 
-#### API Authentication
+#### Developer JWT
+To get a Developer JWT, you will need a valid Developer License with a `client_id`, a generated `api_key`, and a `domain`/`redirect_uri` you configured on the Developer Console.
 
-##### (Option 1 - PREFERRED) getToken Function
+##### (Option 1 - PREFERRED) getDeveloperJwt Function
 This is a utility function call to get a Developer JWT in one step:
 
 ```ts
-const developerJwt = await dimo.auth.getToken({
+const developerJwt = await dimo.auth.getDeveloperJwt({
   client_id: '<client_id>',
-  domain: '<domain>',
+  domain: '<domain/redirect_uri>',
   private_key: '<api_key>',
 });
 ```
 
-Once you have the `developerJwt`, you'll have access to the DIMO API endpoints. For endpoints that require the authorization headers, you can simply pass the results.
+Once you have the `developerJwt`, you'll have access to the DIMO API as a verified developer. For endpoints that require the authorization headers, you can simply pass the results.
 
 ```ts
 // Pass the developerJwt object to a protected endpoint
-await dimo.user.get(developerJwt);
-
-// Pass the developerJwt object to a protected endpoint with body parameters
 await dimo.tokenexchange.exchange({
   ...developerJwt,
   privileges: [4],
@@ -101,6 +98,54 @@ const developerJwt = await dimo.authenticate();
 // The rest would be the same as option 1
 ```
 
+#### Vehicle JWT
+
+To get vehicle data from an end user, your application will need to exchange for a short-lived [Vehicle JWT](https://docs.dimo.org/developer-platform/getting-started/developer-guide/authentication#getting-a-jwt) for vehicles that have granted permissions to your app. 
+
+For the end users of your application, they will need to have already shared their vehicle permissions via the DIMO Mobile App or via your implementation of [Login with DIMO](https://docs.dimo.org/developer-platform/getting-started/developer-guide/login-with-dimo) before you can fetch for their vehicle data.
+
+##### (Option 1 - PREFERRED) getVehicleJwt Function
+This is a utility function call to get a Vehicle JWT in one step by inputting your developer JWT obtained earlier with the vehicle's identifier (`tokenId`):
+
+```ts
+const vehicleJwt = await dimo.tokenexchange.getVehicleJwt({
+  ...developerJwt,
+  tokenId: 117315
+});
+```
+
+##### (Option 2) Manually exchanging for Vehicle JWT
+
+```ts
+const vehicle_jwt = await dimo.tokenexchange.exchange({
+  ...auth,
+  privileges: [1, 5],
+  tokenId: <vehicle_token_id>
+});
+```
+
+Once you have the `vehicleJwt`, you'll have access to the vehicle data for a specific vehicle. For endpoints that require the authorization headers, you can pass the results.
+
+```ts
+// Vehicle Status uses privId 1
+await dimo.devicedata.getVehicleStatus({
+  ...vehicle_jwt,
+  tokenId: <vehicle_token_id>
+});
+
+// Proof of Movement Verifiable Credentials uses privId 4
+await dimo.attestation.createPomVC({
+  ...vehicle_jwt,
+  tokenId: <vehicle_token_id>
+})
+
+// VIN Verifiable Credentials uses privId 5
+await dimo.attestation.createVinVC({
+  ...vehicle_jwt,
+  tokenId: <vehicle_token_id>
+});
+```
+
 ### Querying the DIMO REST API
 The SDK supports async await and your typical JS Promises. HTTP operations can be utilized in either ways:
 
@@ -146,48 +191,16 @@ dimo.attestation.createVinVC({
 })
 ```
 
-#### Vehicle JWT
-
-As the 2nd leg of the API authentication, applications may exchange for short-lived [Vehicle JWT](https://docs.dimo.org/developer-platform/getting-started/developer-guide/authentication#getting-a-jwt) for specific vehicles that granted permissions to the app. This uses the [DIMO Token Exchange API](https://docs.dimo.org/developer-platform/api-references/dimo-protocol/token-exchange-api/token-exchange-api-endpoints). 
-
-For the end users of your application, they will need to share their vehicle permissions via the DIMO Mobile App or via your implementation of [Login with DIMO](https://docs.dimo.org/developer-platform/getting-started/developer-guide/login-with-dimo) or even by sharing on the Vehicle NFT directly. Once vehicles are shared, you will be able to get a Vehicle JWT.
-
-```ts
-const vehicle_jwt = await dimo.tokenexchange.exchange({
-  ...auth,
-  privileges: [1, 5],
-  tokenId: <vehicle_token_id>
-});
-
-// Vehicle Status uses privId 1
-await dimo.devicedata.getVehicleStatus({
-  ...vehicle_jwt,
-  tokenId: <vehicle_token_id>
-});
-
-// Proof of Movement Verifiable Credentials uses privId 4
-await dimo.attestation.createPomVC({
-  ...vehicle_jwt,
-  tokenId: <vehicle_token_id>
-})
-
-// VIN Verifiable Credentials uses privId 5
-await dimo.attestation.createVinVC({
-  ...vehicle_jwt,
-  tokenId: <vehicle_token_id>
-});
-```
-
 ### Querying the DIMO GraphQL API
 
-The SDK accepts any type of valid custom GraphQL queries, but we've also included a few sample queries to help you understand the DIMO GraphQL APIs. 
+The SDK accepts any type of valid custom GraphQL queries, but we've also included a few sample queries to help you understand the DIMO GraphQL APIs. There's also a helper function called `paginate` that you can use to paginate through the GraphQL pages, see `getVehiclePrivileges.ts` on how it's being used.
 
 #### Authentication for GraphQL API
 The GraphQL entry points are designed almost identical to the REST API entry points. For any GraphQL API that requires auth headers (Telemetry API for example), you can use the same pattern as you would in the REST protected endpoints.
 
 ```ts
 const vehicleJwt = await dimo.tokenexchange.exchange({
-  ...vehicleJwt,
+  ...developerJwt,
   privileges: [1, 3, 4],
   tokenId: <vehicle_token_id>
 });

package/README.zh-tw.md

@@ -0,0 +1,86 @@
+![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/dimo-network/data-sdk/npm-publish.yml?style=flat-square)
+![GitHub top language](https://img.shields.io/github/languages/top/dimo-network/data-sdk?style=flat-square)
+![GitHub License](https://img.shields.io/github/license/dimo-network/data-sdk?style=flat-square)
+[![Downloads](https://img.shields.io/npm/d18m/@dimo-network/data-sdk.svg?style=flat-square)](https://www.npmjs.com/package/@dimo-network/data-sdk)
+[![Discord](https://img.shields.io/discord/892438668453740634)](https://chat.dimo.zone/)
+![X (formerly Twitter) URL](https://img.shields.io/twitter/url?url=https%3A%2F%2Ftwitter.com%2FDIMO_Network&style=social)
+
+# DIMO（智猛）Data SDK
+## 概述
+DIMO Data SDK 是一個以 TypeScript 構建的官方函式庫，旨在讓開發者能夠簡單且高效地使用 DIMO API。此 SDK 減少了開發者在整合 DIMO 平台時的複雜性，並加速開發過程。透過 API 調用的抽象化、簡化數據操作以及提供強大的型別安全性，提升了開發者的使用體驗。
+
+## 安裝
+
+使用 [npm](https://www.npmjs.com/package/@dimo-network/data-sdk):
+```bash
+npm install @dimo-network/data-sdk
+```
+
+使用 [yarn](https://classic.yarnpkg.com/en/package/@dimo-network/data-sdk):
+
+```bash
+yarn add @dimo-network/data-sdk
+```
+
+## 單元測試
+執行 `npm test` 或 `npm run test` 來運行 Jest 測試。
+
+## API 文件
+有關 DIMO 開發或 API 的詳細資訊，請參閱 DIMO 的 [開發者文件](https://docs.dimo.org/developer-platform)。
+
+## SDK 使用方法
+### 訪問函式庫
+
+(TypeScript / ES Modules)
+```ts
+import { DIMO } from '@dimo-network/data-sdk';
+```
+
+(CommonJS)
+```js
+const { DIMO } = require('@dimo-network/data-sdk')
+```
+### SDK 初始化
+
+```ts
+const dimo = new DIMO('Production');
+```
+
+### 開發者註冊
+作為認證流程的一部分，您需要先通過 [DIMO Developer Console](https://console.dimo.org/) 獲取開發者授權身份。請按照以下步驟開始註冊：
+1. 造訪 [DIMO 開發者主控台](https://console.dimo.org/) 並註冊帳號。
+2. 點擊「創建執照」（Create a License），並輸入您的相關執照詳細資訊。
+3. 生成 API 金鑰（API Key），並新增所需的統一資源識別碼（Redirect URI）。
+
+### 開發者認證
+SDK 提供了[認證流程](https://docs.dimo.org/developer-platform/getting-started/developer-guide/authentication) 所需的所有步驟，幫助您獲取「開發者 JWT」（Developer JWT）以及每輛與應用程式共享的車輛所使用的「車輛 JWT」（Vehicle JWT）。
+
+#### 認證的前置條件
+1. 開發者執照
+2. API 金鑰以及至少一組自訂的統一資源識別碼（Redirect URI）
+3. 適當的 [TypeScript 環境設置](https://learn.microsoft.com/zh-tw/visualstudio/javascript/compile-typescript-code-npm?view=vs-2022)。
+
+#### 開發者 JWT
+
+```ts
+const developerJwt = await dimo.auth.getDeveloperJwt({
+    client_id: '<client_id>',
+    domain: '<domain/redirect_uri>',
+    private_key: '<api_key>',
+});
+```
+
+#### 車輛 JWT
+若要從消費者處獲取車輛數據，應用程式需要交換短期有效的 [車輛 JWT](https://docs.dimo.org/developer-platform/getting-started/developer-guide/authentication#getting-a-jwt)。此車輛 JWT 是針對授權應用程式的車輛生成的。
+
+消費者需要事先與您的應用程式共享車輛授權。為此，您可以透過前端整合 [Login with DIMO](https://docs.dimo.org/developer-platform/getting-started/developer-guide/login-with-dimo) 或開發出類似 DIMO Mobile 全端的功能。完成「分享」此步驟後，您將能夠自由獲取車輛數據。
+
+```ts
+const vehicleJwt = await dimo.tokenexchange.getVehicleJwt({
+    ...developerJwt,
+    tokenId: 117315
+});
+```
+
+## SDK 貢獻
+有關如何貢獻於此 SDK 的詳細資訊，請參閱[此處](https://github.com/DIMO-Network/data-sdk/blob/master/CONTRIBUTING.md)。

package/dist/api/functions/{getToken.d.ts → getDeveloperJwt.d.ts}

@@ -1,5 +1,5 @@
 import { DimoEnvironment } from '../../environments';
-export declare const getToken: (input: {
+export declare const getDeveloperJwt: (input: {
     client_id: string;
     domain: string;
     private_key: string;

package/dist/api/functions/{getToken.js → getDeveloperJwt.js}

@@ -1,5 +1,5 @@
 import { DIMO } from '../../dimo';
-export const getToken = async (input, env) => {
+export const getDeveloperJwt = async (input, env) => {
     const sdk = new DIMO(env);
     const challenge = await sdk.auth.generateChallenge({
         client_id: input.client_id,

package/dist/api/functions/getVehicleJwt.d.ts

@@ -0,0 +1,7 @@
+import { DimoEnvironment } from '../../environments';
+export declare const getVehicleJwt: (input: {
+    headers: {
+        Authorization: string;
+    };
+    tokenId: number;
+}, env: keyof typeof DimoEnvironment) => Promise<any>;

package/dist/api/functions/getVehicleJwt.js

@@ -0,0 +1,23 @@
+import { DIMO } from '../../dimo';
+import { decodeJwt, decodePermissions } from '../../util';
+export const getVehicleJwt = async (input, env) => {
+    const sdk = new DIMO(env);
+    const developerJwt = input.headers.Authorization;
+    if (!developerJwt || !developerJwt.startsWith('Bearer ')) {
+        throw new Error('Invalid Authorization header format');
+    }
+    // Remove "Bearer " prefix
+    const decodedToken = decodeJwt(developerJwt.slice(7));
+    const clientId = decodedToken.ethereum_address;
+    const privileges = await sdk.identity.getVehiclePrivileges({
+        tokenId: input.tokenId,
+        clientId: clientId // We want to pass in the clientId
+    });
+    const decodedPrivileges = decodePermissions(privileges[0].permissions);
+    const vehicleJwt = await sdk.tokenexchange.exchange({
+        ...input,
+        privileges: decodedPrivileges,
+        tokenId: input.tokenId
+    });
+    return vehicleJwt;
+};

package/dist/api/functions/index.d.ts

@@ -1,3 +1,4 @@
-import { getToken } from "./getToken";
+import { getDeveloperJwt } from "./getDeveloperJwt";
+import { getVehicleJwt } from "./getVehicleJwt";
 import { signChallenge } from "./signChallenge";
-export { getToken, signChallenge };
+export { getDeveloperJwt, getVehicleJwt, signChallenge };

package/dist/api/functions/index.js

@@ -1,3 +1,4 @@
-import { getToken } from "./getToken";
+import { getDeveloperJwt } from "./getDeveloperJwt";
+import { getVehicleJwt } from "./getVehicleJwt";
 import { signChallenge } from "./signChallenge";
-export { getToken, signChallenge };
+export { getDeveloperJwt, getVehicleJwt, signChallenge };

package/dist/api/resources/Auth/index.js

@@ -33,9 +33,9 @@ export class Auth extends Resource {
                 },
                 return: 'developer_jwt'
             },
-            getToken: {
+            getDeveloperJwt: {
                 method: 'FUNCTION',
-                path: 'getToken'
+                path: 'getDeveloperJwt'
             }
         });
     }

package/dist/api/resources/TokenExchange/index.js

@@ -14,6 +14,10 @@ export class TokenExchange extends Resource {
                 },
                 auth: 'developer_jwt',
                 return: 'vehicle_jwt'
+            },
+            getVehicleJwt: {
+                method: 'FUNCTION',
+                path: 'getVehicleJwt'
             }
         });
     }

package/dist/constants.d.ts

@@ -7,5 +7,8 @@ export declare const DimoConstants: {
         readonly NFT_address: "0x45fbCD3ef7361d156e8b16F5538AE36DEdf61Da8";
         readonly RPC_provider: "https://eth.llamarpc.com";
     };
+    readonly Query: {
+        readonly PAGE_SIZE: 100;
+    };
 };
-export type DimoConstants = typeof DimoConstants.Production | typeof DimoConstants.Dev;
+export type DimoConstants = typeof DimoConstants.Production | typeof DimoConstants.Dev | typeof DimoConstants.Query;

package/dist/constants.js

@@ -6,5 +6,8 @@ export const DimoConstants = {
     Dev: {
         'NFT_address': '0x45fbCD3ef7361d156e8b16F5538AE36DEdf61Da8',
         'RPC_provider': 'https://eth.llamarpc.com',
+    },
+    Query: {
+        'PAGE_SIZE': 100
     }
 };

package/dist/dimo.js

@@ -47,7 +47,7 @@ export class DIMO {
             }
             const data = fs.readFileSync('.credentials.json', 'utf8');
             const credentials = JSON.parse(data);
-            const authHeader = await this.auth.getToken({
+            const authHeader = await this.auth.getDeveloperJwt({
                 client_id: credentials.client_id,
                 domain: credentials.redirect_uri,
                 private_key: credentials.private_key,

package/dist/environments/index.d.ts

@@ -4,13 +4,10 @@ export declare const DimoEnvironment: {
         readonly Auth: "https://auth.dimo.zone";
         readonly Identity: "https://identity-api.dimo.zone/query";
         readonly Devices: "https://devices-api.dimo.zone";
-        readonly DeviceData: "https://device-data-api.dimo.zone";
         readonly DeviceDefinitions: "https://device-definitions-api.dimo.zone";
-        readonly Events: "https://events-api.dimo.zone";
         readonly Telemetry: "https://telemetry-api.dimo.zone/query";
         readonly TokenExchange: "https://token-exchange-api.dimo.zone";
         readonly Trips: "https://trips-api.dimo.zone";
-        readonly User: "https://users-api.dimo.zone";
         readonly Valuations: "https://valuations-api.dimo.zone";
         readonly VehicleSignalDecoding: "https://vehicle-signal-decoding.dimo.zone";
     };
@@ -19,13 +16,10 @@ export declare const DimoEnvironment: {
         readonly Auth: "https://auth.dev.dimo.zone";
         readonly Identity: "https://identity-api.dev.dimo.zone/query";
         readonly Devices: "https://devices-api.dev.dimo.zone";
-        readonly DeviceData: "https://device-data-api.dev.dimo.zone";
         readonly DeviceDefinitions: "https://device-definitions-api.dev.dimo.zone";
-        readonly Events: "https://events-api.dev.dimo.zone";
         readonly Telemetry: "https://telemetry-api.dev.dimo.zone/query";
         readonly TokenExchange: "https://token-exchange-api.dev.dimo.zone";
         readonly Trips: "https://trips-api.dev.dimo.zone";
-        readonly User: "https://users-api.dev.dimo.zone";
         readonly Valuations: "https://valuations-api.dev.dimo.zone";
         readonly VehicleSignalDecoding: "https://vehicle-signal-decoding.dev.dimo.zone";
     };

package/dist/environments/index.js

@@ -4,13 +4,10 @@ export const DimoEnvironment = {
         'Auth': 'https://auth.dimo.zone',
         'Identity': 'https://identity-api.dimo.zone/query',
         'Devices': 'https://devices-api.dimo.zone',
-        'DeviceData': 'https://device-data-api.dimo.zone',
         'DeviceDefinitions': 'https://device-definitions-api.dimo.zone',
-        'Events': 'https://events-api.dimo.zone',
         'Telemetry': 'https://telemetry-api.dimo.zone/query',
         'TokenExchange': 'https://token-exchange-api.dimo.zone',
         'Trips': 'https://trips-api.dimo.zone',
-        'User': 'https://users-api.dimo.zone',
         'Valuations': 'https://valuations-api.dimo.zone',
         'VehicleSignalDecoding': 'https://vehicle-signal-decoding.dimo.zone'
     },
@@ -19,13 +16,10 @@ export const DimoEnvironment = {
         'Auth': 'https://auth.dev.dimo.zone',
         'Identity': 'https://identity-api.dev.dimo.zone/query',
         'Devices': 'https://devices-api.dev.dimo.zone',
-        'DeviceData': 'https://device-data-api.dev.dimo.zone',
         'DeviceDefinitions': 'https://device-definitions-api.dev.dimo.zone',
-        'Events': 'https://events-api.dev.dimo.zone',
         'Telemetry': 'https://telemetry-api.dev.dimo.zone/query',
         'TokenExchange': 'https://token-exchange-api.dev.dimo.zone',
         'Trips': 'https://trips-api.dev.dimo.zone',
-        'User': 'https://users-api.dev.dimo.zone',
         'Valuations': 'https://valuations-api.dev.dimo.zone',
         'VehicleSignalDecoding': 'https://vehicle-signal-decoding.dev.dimo.zone'
     }

package/dist/graphql/Query.js

@@ -45,15 +45,14 @@ export const Query = async (resource, baseUrl, params = {}, env) => {
     for (const key in variables) {
         const placeholder = new RegExp(`\\$${key}\\b`, 'g');
         if (variables[key] === true) {
-            if (!params[key]) {
-                console.error(`Missing required input: ${key}`);
-                throw new DimoError({
-                    message: `Missing required input: ${key}`,
-                    statusCode: 400
-                });
+            if (params[key] === undefined || params[key] === null) {
+                // ACC-303: Replace the placeholder with null string to handle pagination
+                query = query.replace(placeholder, "null");
+            }
+            else {
+                const value = typeof params[key] === 'string' ? `"${params[key]}"` : params[key];
+                query = query.replace(placeholder, value);
             }
-            const value = typeof params[key] === 'string' ? `"${params[key]}"` : params[key];
-            query = query.replace(placeholder, value);
         }
     }
     try {

package/dist/graphql/functions/getVehiclePrivileges.d.ts

@@ -0,0 +1,6 @@
+import { DimoEnvironment } from '../../environments';
+export declare const getVehiclePrivileges: (input: {
+    headers: any;
+    tokenId: string;
+    clientId?: string;
+}, env: keyof typeof DimoEnvironment) => Promise<any>;

package/dist/graphql/functions/getVehiclePrivileges.js

@@ -0,0 +1,46 @@
+import { DIMO } from '../../dimo';
+import { DimoError } from '../../errors';
+import { paginate } from '../util/paginate';
+export const getVehiclePrivileges = async (input, env) => {
+    const sdk = new DIMO(env);
+    try {
+        const getSacds = async (after) => {
+            const response = await sdk.identity.listSacdPerVehicleTokenId({
+                tokenId: input.tokenId,
+                after
+            });
+            const sacds = response.data?.vehicle?.sacds || [];
+            const pageInfo = response.data?.vehicle?.sacds.pageInfo || { endCursor: null };
+            const totalCount = response.data?.vehicle?.sacds?.totalCount || null;
+            if (input.clientId) {
+                const matchingSacd = sacds.nodes.find((sacd) => sacd.grantee === input.clientId);
+                if (matchingSacd) {
+                    return {
+                        nodes: [matchingSacd],
+                        pageInfo: { endCursor: null },
+                        totalCount: 1
+                    };
+                }
+            }
+            return {
+                nodes: sacds,
+                pageInfo,
+                totalCount
+            };
+        };
+        if (input.clientId) {
+            const { nodes } = await getSacds(undefined);
+            if (nodes.length > 0) {
+                return nodes;
+            }
+        }
+        return await paginate(getSacds);
+    }
+    catch (error) {
+        console.error(error);
+        throw new DimoError({
+            message: `Error getting vehicle privileges: ${error.message || error}`,
+            statusCode: 400
+        });
+    }
+};

package/dist/graphql/functions/index.d.ts

@@ -1,2 +1,3 @@
+import { getVehiclePrivileges } from "./getVehiclePrivileges";
 import { getVin } from "./getVin";
-export { getVin };
+export { getVehiclePrivileges, getVin };

package/dist/graphql/functions/index.js

@@ -1,2 +1,3 @@
+import { getVehiclePrivileges } from "./getVehiclePrivileges";
 import { getVin } from "./getVin";
-export { getVin };
+export { getVehiclePrivileges, getVin };

package/dist/graphql/resources/Identity/index.d.ts

@@ -3,4 +3,3 @@ import { DimoEnvironment } from '../../../environments';
 export declare class Identity extends Resource {
     constructor(api: any, env: keyof typeof DimoEnvironment);
 }
-export declare const listVehicleDefinitionsPerAddress: (address: string, limit: number) => string;