theauthapi 1.0.7 → 1.0.8

package/README.md

@@ -7,6 +7,7 @@
   - [Configuration](#configuration)
   - [Usage](#usage)
     - [Example: Validating an api-key](#example-validating-an-api-key)
+    - [Example: Listing API-keys](#example-listing-api-keys)
     - [Example: Listing the projects of an account](#example-listing-the-projects-of-an-account)
     - [Example: Listing projects and associated API Keys](#example-listing-projects-and-associated-api-keys)
     - [Example: Creating an API Key](#example-creating-an-api-key)
@@ -99,7 +100,7 @@ All methods return a promise containing the returned JSON as a javascript object
 | HTTP Method | method name | example                                                                   |
 | ----------- | ----------- | ------------------------------------------------------------------------- |
 | POST        | create\*    | `client.apiKeys.createKey({ name: "KEY_NAME", projectId: "PROJECT_ID" })` |
-| GET         | get\*       | `client.apiKeys.getKeys("PROJECT_ID")`                                    |
+| GET         | get\*       | `client.apiKeys.getKeys()`                                                |
 | DELETE      | delete\*    | `client.apiKeys.deleteKey("MY_KEY")`                                      |
 | PATCH       | update\*    | `client.apiKeys.updateKey("MY_KEY", { name: "UPDATED_KEY_NAME" })`        |
 
@@ -138,6 +139,49 @@ try {
 }
 ```
 
+#### Example: Listing API-keys
+
+```javascript
+theAuthAPI.apiKeys
+  .getKeys()
+  .then((keys) => console.log(keys))
+  .catch((error) => console.log(error));
+```
+
+**Using async/await**
+
+```javascript
+try {
+  const keys = await theAuthAPI.apiKeys.getKeys();
+} catch (error) {
+  console.log(error);
+}
+```
+
+**Filtering API Keys**: You can filter the listed API keys by passing an object of type filter as an argument to `getKeys` 
+
+```typescript
+type ApiKeyFilter = {
+  projectId?: string;
+  customAccountId?: string;
+  customUserId?: string;
+  isActive?: boolean;
+};
+```
+
+**Example**: filtering api-keys with a specific `projectId` where the keys are not active
+
+```javascript
+try {
+  const keys = await theAuthAPI.apiKeys.getKeys({
+    projectId: "PROJECT_ID",
+    isActive: false,
+  });
+} catch (error) {
+  console.log(error);
+}
+```
+
 #### Example: Listing the projects of an account
 
 ```javascript

package/dist/endpoints/ApiKeys/ApiKeys.d.ts

@@ -1,16 +1,19 @@
 import ApiRequest from "../../services/ApiRequest/ApiRequest";
-import { ApiKey, ApiKeyInput, UpdateApiKeyInput } from "../../types";
+import { ApiKey, ApiKeyFilter, ApiKeyInput, UpdateApiKeyInput } from "../../types";
 import { ApiKeysInterface } from "./ApiKeysInterface";
 declare class ApiKeys implements ApiKeysInterface {
     api: ApiRequest;
+    private readonly endpoint;
     constructor(apiService: ApiRequest);
     isValidKey(apikey: string): Promise<boolean>;
-    getKeys(projectId: string): Promise<ApiKey[]>;
+    getKeys(filter?: ApiKeyFilter): Promise<ApiKey[]>;
     getKey(apikey: string): Promise<ApiKey>;
     createKey(apiKey: ApiKeyInput): Promise<ApiKey>;
-    updateKey(apiKey: string, updateTo: UpdateApiKeyInput): Promise<ApiKey>;
+    updateKey(apiKey: string, updatedKey: UpdateApiKeyInput): Promise<ApiKey>;
     deleteKey(apiKey: string): Promise<boolean>;
     private validateCreateKeyInput;
     private validateUpdateKeyInput;
+    private validateFiltersInput;
+    private getKeysFilterEndpoint;
 }
 export default ApiKeys;

package/dist/endpoints/ApiKeys/ApiKeys.js

@@ -19,6 +19,7 @@ const ApiResponseError_1 = __importDefault(require("../../services/ApiRequest/Ap
 class ApiKeys {
     constructor(apiService) {
         this.api = apiService;
+        this.endpoint = "/api-keys/";
     }
     isValidKey(apikey) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -35,10 +36,10 @@ class ApiKeys {
             }
         });
     }
-    getKeys(projectId) {
+    getKeys(filter) {
         return __awaiter(this, void 0, void 0, function* () {
-            (0, util_1.validateString)("projectId", projectId);
-            return yield this.api.request(HttpMethod_1.HttpMethod.GET, `/api-keys/?projectId=${projectId}`);
+            const endpoint = this.getKeysFilterEndpoint(filter);
+            return yield this.api.request(HttpMethod_1.HttpMethod.GET, endpoint);
         });
     }
     getKey(apikey) {
@@ -53,10 +54,10 @@ class ApiKeys {
             return yield this.api.request(HttpMethod_1.HttpMethod.POST, "/api-keys", apiKey);
         });
     }
-    updateKey(apiKey, updateTo) {
+    updateKey(apiKey, updatedKey) {
         return __awaiter(this, void 0, void 0, function* () {
-            this.validateUpdateKeyInput(apiKey, updateTo);
-            return yield this.api.request(HttpMethod_1.HttpMethod.PATCH, `/api-keys/${apiKey}`, updateTo);
+            this.validateUpdateKeyInput(apiKey, updatedKey);
+            return yield this.api.request(HttpMethod_1.HttpMethod.PATCH, `/api-keys/${apiKey}`, updatedKey);
         });
     }
     deleteKey(apiKey) {
@@ -69,8 +70,8 @@ class ApiKeys {
         if (!apiKey) {
             throw new TypeError("apiKey must be an object");
         }
-        if (!apiKey.name || !apiKey.projectId) {
-            throw TypeError("apiKey object must contain the properties [name, projectId]");
+        if (!apiKey.name) {
+            throw TypeError("apiKey object must contain the property name");
         }
         // validate string properties only
         for (const [key, value] of Object.entries((0, lodash_omit_1.default)(apiKey, ["customMetaData", "rateLimitConfigs"]))) {
@@ -87,5 +88,23 @@ class ApiKeys {
         (0, util_1.validateString)("apiKey", apiKey);
         (0, util_1.validateString)("name", updatedKey.name);
     }
+    validateFiltersInput(filter) {
+        if (filter) {
+            if (filter.isActive && typeof filter.isActive !== "boolean") {
+                throw TypeError("isActive must be a boolean");
+            }
+            Object.entries((0, lodash_omit_1.default)(filter, "isActive")).forEach(([key, value]) => {
+                (0, util_1.validateString)(key, value);
+            });
+        }
+    }
+    getKeysFilterEndpoint(filter) {
+        this.validateFiltersInput(filter);
+        let filters = [];
+        if (filter) {
+            filters = Object.entries(filter).map(([key, value]) => `${key}=${value}`);
+        }
+        return `${this.endpoint}${filter ? "?" : ""}${filters.join("&")}`;
+    }
 }
 exports.default = ApiKeys;

package/dist/endpoints/ApiKeys/ApiKeysInterface.d.ts

@@ -1,8 +1,8 @@
-import { ApiKey, ApiKeyInput, UpdateApiKeyInput } from "../../types";
+import { ApiKey, ApiKeyFilter, ApiKeyInput, UpdateApiKeyInput } from "../../types";
 export interface ApiKeysInterface {
     isValidKey(apiKey: string): Promise<boolean>;
     getKey(apiKey: string): Promise<ApiKey>;
-    getKeys(projectId: string): Promise<ApiKey[]>;
+    getKeys(filter?: ApiKeyFilter): Promise<ApiKey[]>;
     createKey(apiKey: ApiKeyInput): Promise<ApiKey>;
     updateKey(apiKey: string, updateTo: UpdateApiKeyInput): Promise<ApiKey>;
     deleteKey(apiKey: string): Promise<boolean>;

package/dist/types/index.d.ts

@@ -3,9 +3,11 @@ export declare type ApiKey = {
     name: string;
     customMetaData: string;
     customAccountId: string;
+    customUserId: string;
     env: string;
     createdAt: Date;
     updatedAt: Date;
+    isActive: boolean;
 };
 export declare type RateLimitConfiguration = {
     rateLimitedEntity?: string;
@@ -15,13 +17,19 @@ export declare type RateLimitConfiguration = {
 };
 export declare type ApiKeyInput = {
     name: string;
-    projectId: string;
+    projectId?: string;
     key?: string;
     customMetaData?: object;
     customAccountId?: string;
     rateLimitConfigs?: RateLimitConfiguration;
     customUserId?: string;
 };
+export declare type ApiKeyFilter = {
+    projectId?: string;
+    customAccountId?: string;
+    customUserId?: string;
+    isActive?: boolean;
+};
 export declare type UpdateApiKeyInput = {
     name: string;
     customMetaData?: object;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "theauthapi",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Client library for TheAuthAPI.com",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",