@juhuu/sdk-ts 1.2.144 → 1.2.146

package/dist/index.d.mts

@@ -12,6 +12,8 @@ type ExtractType<T> = T extends {
 } ? U : never;
 type UserGroup = "retailer" | "engineer" | "operator" | "user";
 type Frontend = "dashboard" | "app";
+type ApiKeyStatus = "enabled" | "disabled";
+type ApiKeyScope = "device:parameter:update";
 type Capability = {
     type: "predictiveMaintenance";
     stripePriceId: string | null;
@@ -537,6 +539,9 @@ declare class Service {
     readonly httpBaseUrl: string;
     readonly wssBaseUrl: string;
     readonly clientVersion: string;
+    readonly apiKey: string | null;
+    readonly defaultRequestOptions: JUHUU.RequestOptions;
+    readonly authenticationMode: "jwt" | "apiKey";
     onException: <T>(response: JUHUU.HttpResponse<T>) => Promise<"abort" | "retry">;
     getAccessToken: () => Promise<string | null> | null;
     setAccessToken: (accessToken: string) => Promise<void>;
@@ -846,6 +851,14 @@ declare class DeviceParameterHistoriesService extends Service {
     retrieve(DeviceParameterHistoryRetrieveParams: JUHUU.DeviceParameterHistory.Retrieve.Params, DeviceParameterHistoryRetrieveOptions?: JUHUU.DeviceParameterHistory.Retrieve.Options): Promise<JUHUU.HttpResponse<JUHUU.DeviceParameterHistory.Retrieve.Response>>;
 }
 
+declare class ApiKeysService extends Service {
+    constructor(config: JUHUU.SetupConfig);
+    create(ApiKeyCreateParams: JUHUU.ApiKey.Create.Params, ApiKeyCreateOptions?: JUHUU.ApiKey.Create.Options): Promise<JUHUU.HttpResponse<JUHUU.ApiKey.Create.Response>>;
+    list(ApiKeyListParams: JUHUU.ApiKey.List.Params, ApiKeyListOptions?: JUHUU.ApiKey.List.Options): Promise<JUHUU.HttpResponse<JUHUU.ApiKey.List.Response>>;
+    retrieve(ApiKeyRetrieveParams: JUHUU.ApiKey.Retrieve.Params, ApiKeyRetrieveOptions?: JUHUU.ApiKey.Retrieve.Options): Promise<JUHUU.HttpResponse<JUHUU.ApiKey.Retrieve.Response>>;
+    update(ApiKeyUpdateParams: JUHUU.ApiKey.Update.Params, ApiKeyUpdateOptions?: JUHUU.ApiKey.Update.Options): Promise<JUHUU.HttpResponse<JUHUU.ApiKey.Update.Response>>;
+}
+
 declare class Juhuu {
     constructor(config: JUHUU.SetupConfig);
     /**
@@ -879,16 +892,20 @@ declare class Juhuu {
     readonly tapkey: TapkeyService;
     readonly articleGroups: ArticleGroupGroupsService;
     readonly deviceParameterHistories: DeviceParameterHistoriesService;
+    readonly apiKeys: ApiKeysService;
 }
 declare namespace JUHUU {
     interface SetupConfig {
-        environment: Environment;
-        getAccessToken: () => Promise<string | null>;
-        onException: <T>(response: JUHUU.HttpResponse<T>) => Promise<"abort">;
-        setAccessToken: (accessToken: string) => Promise<void>;
-        getRefreshToken: () => Promise<string | null>;
-        setRefreshToken: (refreshToken: string) => Promise<void>;
+        environment?: Environment;
+        getAccessToken?: () => Promise<string | null>;
+        onException?: <T>(response: JUHUU.HttpResponse<T>) => Promise<"abort">;
+        setAccessToken?: (accessToken: string) => Promise<void>;
+        getRefreshToken?: () => Promise<string | null>;
+        setRefreshToken?: (refreshToken: string) => Promise<void>;
         clientVersion: string;
+        apiKey?: string;
+        defaultRequestOptions?: JUHUU.RequestOptions;
+        authenticationMode?: "jwt" | "apiKey";
     }
     interface HttpResponse<T> {
         ok: boolean;
@@ -914,6 +931,10 @@ declare namespace JUHUU {
          * If this is true, a new accessToken will be requested if the current one is expired.
          */
         refreshTokensIfNecessary?: boolean;
+        /**
+         * If this API key is provided, the request will be sent with this API key instead of the one passed to config.
+         */
+        apiKey?: string | null;
     };
     interface LocaleString {
         de?: string;
@@ -1462,6 +1483,67 @@ declare namespace JUHUU {
             type Response = JUHUU.AccountingArea.Object;
         }
     }
+    namespace ApiKey {
+        type Object = {
+            id: string;
+            readonly object: "apiKey";
+            name: string;
+            status: ApiKeyStatus;
+            scopeArray: ApiKeyScope[];
+            propertyId: string;
+            expiresAt: Date | null;
+            createdAt: Date;
+            hash: string;
+        };
+        namespace Create {
+            type Params = {
+                propertyId: string;
+                name?: string;
+            };
+            type Options = JUHUU.RequestOptions;
+            type Response = {
+                apiKey: JUHUU.ApiKey.Object;
+                clearText: string;
+            };
+        }
+        namespace Retrieve {
+            type Params = {
+                apiKeyId: string;
+            };
+            type Options = {
+                expand?: Array<"property">;
+            } & JUHUU.RequestOptions;
+            type Response = {
+                apiKey: JUHUU.ApiKey.Object;
+                property?: JUHUU.Property.Object;
+            };
+        }
+        namespace List {
+            type Params = {
+                propertyId?: string;
+                statusArray?: JUHUU.Article.Object["status"][];
+            };
+            type Options = {
+                limit?: number;
+                skip?: number;
+            } & JUHUU.RequestOptions;
+            type Response = {
+                apiKeyArray: JUHUU.ApiKey.Object[];
+                count: number;
+                hasMore: boolean;
+            };
+        }
+        namespace Update {
+            type Params = {
+                apiKeyId: string;
+                status?: ApiKeyStatus;
+            };
+            type Options = JUHUU.RequestOptions;
+            type Response = {
+                apiKey: JUHUU.ApiKey.Object;
+            };
+        }
+    }
     namespace ArticleEmbedding {
         type Object = {
             id: string;
@@ -3317,4 +3399,4 @@ declare namespace JUHUU {
     }
 }
 
-export { type AccessControlListElement, type Address, type AutoRenewMode, type BusinessType, type Capability, type Category, type Circumstance, type Color, type ColorScheme, type Command, type Condition, ConditionType, type CountryCode, CountryCodeArray, type CurrencyCode, CurrencyCodeArray, type CustomClaims, type DeepNullable, type DevicePermission, type DeviceStatus, type DeviceType, type Environment, type EnvironmentSettings, type ExtractType, type Frontend, type FuelType, type GeneralSettings, type GeoPoint, type GraphNode, JUHUU, Juhuu, type LanguageCode, LanguageCodeArray, Layout, type LayoutBlock, type LicenseTariffIdMap, type LinkType, type LocaleString, type MapFilter, type Modality, type Offer, type OfferTime, type Parameter, type Party, type PaymentMethod, type PaymentReason, type PaymentRefundReason, type PaymentRefundStatus, type PaymentServiceProvider, type PaymentStatus, type PayoutSettings, type PayoutStatus, type PermissionTypes, type Person, type Platform, type PlatformString, type PostingRow, type Purpose, type PushToken, ReadonlyCategoryArray, ReadonlyModalityArray, ReadonlySectorArray, type RefundStatus, type Sector, type SessionCannotTerminateReason, type SessionSettings, type SessionStatus, type SessionTerminatedByType, type SessionType, Settings, type SimStatus, type StarRating, type TarifType, type TimeZone, type Unit, type UserGroup, type UserType, type Utilization, type VeloBrushDeviceDocumentUserManualStep, type Viewport, type ViewportPolygon, type VisualPriority, type hexColor };
+export { type AccessControlListElement, type Address, type ApiKeyScope, type ApiKeyStatus, type AutoRenewMode, type BusinessType, type Capability, type Category, type Circumstance, type Color, type ColorScheme, type Command, type Condition, ConditionType, type CountryCode, CountryCodeArray, type CurrencyCode, CurrencyCodeArray, type CustomClaims, type DeepNullable, type DevicePermission, type DeviceStatus, type DeviceType, type Environment, type EnvironmentSettings, type ExtractType, type Frontend, type FuelType, type GeneralSettings, type GeoPoint, type GraphNode, JUHUU, Juhuu, type LanguageCode, LanguageCodeArray, Layout, type LayoutBlock, type LicenseTariffIdMap, type LinkType, type LocaleString, type MapFilter, type Modality, type Offer, type OfferTime, type Parameter, type Party, type PaymentMethod, type PaymentReason, type PaymentRefundReason, type PaymentRefundStatus, type PaymentServiceProvider, type PaymentStatus, type PayoutSettings, type PayoutStatus, type PermissionTypes, type Person, type Platform, type PlatformString, type PostingRow, type Purpose, type PushToken, ReadonlyCategoryArray, ReadonlyModalityArray, ReadonlySectorArray, type RefundStatus, type Sector, type SessionCannotTerminateReason, type SessionSettings, type SessionStatus, type SessionTerminatedByType, type SessionType, Settings, type SimStatus, type StarRating, type TarifType, type TimeZone, type Unit, type UserGroup, type UserType, type Utilization, type VeloBrushDeviceDocumentUserManualStep, type Viewport, type ViewportPolygon, type VisualPriority, type hexColor };

package/dist/index.d.ts

@@ -12,6 +12,8 @@ type ExtractType<T> = T extends {
 } ? U : never;
 type UserGroup = "retailer" | "engineer" | "operator" | "user";
 type Frontend = "dashboard" | "app";
+type ApiKeyStatus = "enabled" | "disabled";
+type ApiKeyScope = "device:parameter:update";
 type Capability = {
     type: "predictiveMaintenance";
     stripePriceId: string | null;
@@ -537,6 +539,9 @@ declare class Service {
     readonly httpBaseUrl: string;
     readonly wssBaseUrl: string;
     readonly clientVersion: string;
+    readonly apiKey: string | null;
+    readonly defaultRequestOptions: JUHUU.RequestOptions;
+    readonly authenticationMode: "jwt" | "apiKey";
     onException: <T>(response: JUHUU.HttpResponse<T>) => Promise<"abort" | "retry">;
     getAccessToken: () => Promise<string | null> | null;
     setAccessToken: (accessToken: string) => Promise<void>;
@@ -846,6 +851,14 @@ declare class DeviceParameterHistoriesService extends Service {
     retrieve(DeviceParameterHistoryRetrieveParams: JUHUU.DeviceParameterHistory.Retrieve.Params, DeviceParameterHistoryRetrieveOptions?: JUHUU.DeviceParameterHistory.Retrieve.Options): Promise<JUHUU.HttpResponse<JUHUU.DeviceParameterHistory.Retrieve.Response>>;
 }
 
+declare class ApiKeysService extends Service {
+    constructor(config: JUHUU.SetupConfig);
+    create(ApiKeyCreateParams: JUHUU.ApiKey.Create.Params, ApiKeyCreateOptions?: JUHUU.ApiKey.Create.Options): Promise<JUHUU.HttpResponse<JUHUU.ApiKey.Create.Response>>;
+    list(ApiKeyListParams: JUHUU.ApiKey.List.Params, ApiKeyListOptions?: JUHUU.ApiKey.List.Options): Promise<JUHUU.HttpResponse<JUHUU.ApiKey.List.Response>>;
+    retrieve(ApiKeyRetrieveParams: JUHUU.ApiKey.Retrieve.Params, ApiKeyRetrieveOptions?: JUHUU.ApiKey.Retrieve.Options): Promise<JUHUU.HttpResponse<JUHUU.ApiKey.Retrieve.Response>>;
+    update(ApiKeyUpdateParams: JUHUU.ApiKey.Update.Params, ApiKeyUpdateOptions?: JUHUU.ApiKey.Update.Options): Promise<JUHUU.HttpResponse<JUHUU.ApiKey.Update.Response>>;
+}
+
 declare class Juhuu {
     constructor(config: JUHUU.SetupConfig);
     /**
@@ -879,16 +892,20 @@ declare class Juhuu {
     readonly tapkey: TapkeyService;
     readonly articleGroups: ArticleGroupGroupsService;
     readonly deviceParameterHistories: DeviceParameterHistoriesService;
+    readonly apiKeys: ApiKeysService;
 }
 declare namespace JUHUU {
     interface SetupConfig {
-        environment: Environment;
-        getAccessToken: () => Promise<string | null>;
-        onException: <T>(response: JUHUU.HttpResponse<T>) => Promise<"abort">;
-        setAccessToken: (accessToken: string) => Promise<void>;
-        getRefreshToken: () => Promise<string | null>;
-        setRefreshToken: (refreshToken: string) => Promise<void>;
+        environment?: Environment;
+        getAccessToken?: () => Promise<string | null>;
+        onException?: <T>(response: JUHUU.HttpResponse<T>) => Promise<"abort">;
+        setAccessToken?: (accessToken: string) => Promise<void>;
+        getRefreshToken?: () => Promise<string | null>;
+        setRefreshToken?: (refreshToken: string) => Promise<void>;
         clientVersion: string;
+        apiKey?: string;
+        defaultRequestOptions?: JUHUU.RequestOptions;
+        authenticationMode?: "jwt" | "apiKey";
     }
     interface HttpResponse<T> {
         ok: boolean;
@@ -914,6 +931,10 @@ declare namespace JUHUU {
          * If this is true, a new accessToken will be requested if the current one is expired.
          */
         refreshTokensIfNecessary?: boolean;
+        /**
+         * If this API key is provided, the request will be sent with this API key instead of the one passed to config.
+         */
+        apiKey?: string | null;
     };
     interface LocaleString {
         de?: string;
@@ -1462,6 +1483,67 @@ declare namespace JUHUU {
             type Response = JUHUU.AccountingArea.Object;
         }
     }
+    namespace ApiKey {
+        type Object = {
+            id: string;
+            readonly object: "apiKey";
+            name: string;
+            status: ApiKeyStatus;
+            scopeArray: ApiKeyScope[];
+            propertyId: string;
+            expiresAt: Date | null;
+            createdAt: Date;
+            hash: string;
+        };
+        namespace Create {
+            type Params = {
+                propertyId: string;
+                name?: string;
+            };
+            type Options = JUHUU.RequestOptions;
+            type Response = {
+                apiKey: JUHUU.ApiKey.Object;
+                clearText: string;
+            };
+        }
+        namespace Retrieve {
+            type Params = {
+                apiKeyId: string;
+            };
+            type Options = {
+                expand?: Array<"property">;
+            } & JUHUU.RequestOptions;
+            type Response = {
+                apiKey: JUHUU.ApiKey.Object;
+                property?: JUHUU.Property.Object;
+            };
+        }
+        namespace List {
+            type Params = {
+                propertyId?: string;
+                statusArray?: JUHUU.Article.Object["status"][];
+            };
+            type Options = {
+                limit?: number;
+                skip?: number;
+            } & JUHUU.RequestOptions;
+            type Response = {
+                apiKeyArray: JUHUU.ApiKey.Object[];
+                count: number;
+                hasMore: boolean;
+            };
+        }
+        namespace Update {
+            type Params = {
+                apiKeyId: string;
+                status?: ApiKeyStatus;
+            };
+            type Options = JUHUU.RequestOptions;
+            type Response = {
+                apiKey: JUHUU.ApiKey.Object;
+            };
+        }
+    }
     namespace ArticleEmbedding {
         type Object = {
             id: string;
@@ -3317,4 +3399,4 @@ declare namespace JUHUU {
     }
 }
 
-export { type AccessControlListElement, type Address, type AutoRenewMode, type BusinessType, type Capability, type Category, type Circumstance, type Color, type ColorScheme, type Command, type Condition, ConditionType, type CountryCode, CountryCodeArray, type CurrencyCode, CurrencyCodeArray, type CustomClaims, type DeepNullable, type DevicePermission, type DeviceStatus, type DeviceType, type Environment, type EnvironmentSettings, type ExtractType, type Frontend, type FuelType, type GeneralSettings, type GeoPoint, type GraphNode, JUHUU, Juhuu, type LanguageCode, LanguageCodeArray, Layout, type LayoutBlock, type LicenseTariffIdMap, type LinkType, type LocaleString, type MapFilter, type Modality, type Offer, type OfferTime, type Parameter, type Party, type PaymentMethod, type PaymentReason, type PaymentRefundReason, type PaymentRefundStatus, type PaymentServiceProvider, type PaymentStatus, type PayoutSettings, type PayoutStatus, type PermissionTypes, type Person, type Platform, type PlatformString, type PostingRow, type Purpose, type PushToken, ReadonlyCategoryArray, ReadonlyModalityArray, ReadonlySectorArray, type RefundStatus, type Sector, type SessionCannotTerminateReason, type SessionSettings, type SessionStatus, type SessionTerminatedByType, type SessionType, Settings, type SimStatus, type StarRating, type TarifType, type TimeZone, type Unit, type UserGroup, type UserType, type Utilization, type VeloBrushDeviceDocumentUserManualStep, type Viewport, type ViewportPolygon, type VisualPriority, type hexColor };
+export { type AccessControlListElement, type Address, type ApiKeyScope, type ApiKeyStatus, type AutoRenewMode, type BusinessType, type Capability, type Category, type Circumstance, type Color, type ColorScheme, type Command, type Condition, ConditionType, type CountryCode, CountryCodeArray, type CurrencyCode, CurrencyCodeArray, type CustomClaims, type DeepNullable, type DevicePermission, type DeviceStatus, type DeviceType, type Environment, type EnvironmentSettings, type ExtractType, type Frontend, type FuelType, type GeneralSettings, type GeoPoint, type GraphNode, JUHUU, Juhuu, type LanguageCode, LanguageCodeArray, Layout, type LayoutBlock, type LicenseTariffIdMap, type LinkType, type LocaleString, type MapFilter, type Modality, type Offer, type OfferTime, type Parameter, type Party, type PaymentMethod, type PaymentReason, type PaymentRefundReason, type PaymentRefundStatus, type PaymentServiceProvider, type PaymentStatus, type PayoutSettings, type PayoutStatus, type PermissionTypes, type Person, type Platform, type PlatformString, type PostingRow, type Purpose, type PushToken, ReadonlyCategoryArray, ReadonlyModalityArray, ReadonlySectorArray, type RefundStatus, type Sector, type SessionCannotTerminateReason, type SessionSettings, type SessionStatus, type SessionTerminatedByType, type SessionType, Settings, type SimStatus, type StarRating, type TarifType, type TimeZone, type Unit, type UserGroup, type UserType, type Utilization, type VeloBrushDeviceDocumentUserManualStep, type Viewport, type ViewportPolygon, type VisualPriority, type hexColor };

package/dist/index.js

@@ -46,14 +46,17 @@ module.exports = __toCommonJS(src_exports);
 var import_socket = __toESM(require("socket.io-client"));
 var Service = class {
   constructor(config) {
-    this.environment = config.environment;
-    this.getAccessToken = config.getAccessToken;
-    this.onException = config.onException;
-    this.setAccessToken = config.setAccessToken;
-    this.getAccessToken = config.getAccessToken;
-    this.setRefreshToken = config.setRefreshToken;
-    this.getRefreshToken = config.getRefreshToken;
+    this.environment = config.environment ?? "production";
+    this.getAccessToken = config.getAccessToken ?? (() => null);
+    this.onException = config.onException ?? (() => Promise.resolve("abort"));
+    this.setAccessToken = config.setAccessToken ?? (() => Promise.resolve());
+    this.getAccessToken = config.getAccessToken ?? (() => null);
+    this.setRefreshToken = config.setRefreshToken ?? (() => Promise.resolve());
+    this.getRefreshToken = config.getRefreshToken ?? (() => Promise.resolve(null));
     this.clientVersion = config.clientVersion;
+    this.apiKey = config.apiKey ?? null;
+    this.defaultRequestOptions = config.defaultRequestOptions ?? {};
+    this.authenticationMode = config.authenticationMode ?? "jwt";
     switch (config.environment) {
       case "development":
         this.httpBaseUrl = "https://api.juhuu.dev/v1/";
@@ -69,6 +72,9 @@ var Service = class {
   httpBaseUrl;
   wssBaseUrl;
   clientVersion;
+  apiKey;
+  defaultRequestOptions;
+  authenticationMode;
   onException;
   getAccessToken;
   setAccessToken;
@@ -80,29 +86,76 @@ var Service = class {
     body = void 0,
     authenticationNotOptional
   }, options = {}) {
-    if (options.triggerOnException === void 0) {
-      options.triggerOnException = true;
+    const currentOptions = {
+      ...this.defaultRequestOptions,
+      ...options
+    };
+    if (currentOptions.triggerOnException === void 0) {
+      switch (this.authenticationMode) {
+        case "jwt": {
+          currentOptions.triggerOnException = true;
+          break;
+        }
+        case "apiKey": {
+          currentOptions.triggerOnException = false;
+          break;
+        }
+      }
     }
-    if (options.refreshTokensIfNecessary === void 0) {
-      options.refreshTokensIfNecessary = true;
+    if (currentOptions.refreshTokensIfNecessary === void 0) {
+      switch (this.authenticationMode) {
+        case "jwt": {
+          currentOptions.refreshTokensIfNecessary = true;
+          break;
+        }
+        case "apiKey": {
+          currentOptions.refreshTokensIfNecessary = false;
+          break;
+        }
+      }
     }
     let token = null;
-    if (options.accessToken === void 0 || options.accessToken === null) {
-      token = await this.getAccessToken();
-    } else {
-      token = options.accessToken;
-    }
-    console.log("accessToken:", token);
-    if ((token === null || token === void 0) && authenticationNotOptional === true) {
-      console.error(
-        "endpoint",
-        url,
-        "should use authentication but no token was found"
-      );
-      return {
-        ok: false,
-        data: {}
-      };
+    let apiKey = null;
+    switch (this.authenticationMode) {
+      case "jwt": {
+        if (currentOptions.accessToken === void 0 || currentOptions.accessToken === null) {
+          token = await this.getAccessToken();
+        } else {
+          token = currentOptions.accessToken;
+        }
+        console.log("accessToken:", token);
+        if ((token === null || token === void 0) && authenticationNotOptional === true) {
+          console.error(
+            "endpoint",
+            url,
+            "should use authentication but no token was found"
+          );
+          return {
+            ok: false,
+            data: {}
+          };
+        }
+        break;
+      }
+      case "apiKey": {
+        if (currentOptions.apiKey === void 0 || currentOptions.apiKey === null) {
+          apiKey = this.apiKey;
+        } else {
+          apiKey = currentOptions.apiKey;
+        }
+        if (apiKey === null) {
+          console.error(
+            "endpoint",
+            url,
+            "should use authentication but no apiKey was found"
+          );
+          return {
+            ok: false,
+            data: {}
+          };
+        }
+        break;
+      }
     }
     const uri = this.httpBaseUrl + url;
     let response = null;
@@ -110,19 +163,19 @@ var Service = class {
     try {
       switch (method) {
         case "GET": {
-          response = await this.sendGetRequest(token, uri);
+          response = await this.sendGetRequest({ token, uri, apiKey });
           break;
         }
         case "POST": {
-          response = await this.sendPostRequest(token, uri, body);
+          response = await this.sendPostRequest({ token, uri, body, apiKey });
           break;
         }
         case "PATCH": {
-          response = await this.sendPatchRequest(token, uri, body);
+          response = await this.sendPatchRequest({ token, uri, body, apiKey });
           break;
         }
         case "DELETE": {
-          response = await this.sendDeleteRequest(token, uri);
+          response = await this.sendDeleteRequest({ token, uri, apiKey });
           break;
         }
       }
@@ -210,7 +263,11 @@ var Service = class {
     }
     return responseObject;
   }
-  async sendGetRequest(token, uri) {
+  async sendGetRequest({
+    token,
+    apiKey,
+    uri
+  }) {
     const headers = {
       "Content-Type": "application/json",
       "Client-Version": this.clientVersion
@@ -218,12 +275,20 @@ var Service = class {
     if (token !== void 0 && token !== null) {
       headers.Authorization = `Bearer ${token}`;
     }
+    if (apiKey !== null) {
+      headers["X-API-KEY"] = apiKey;
+    }
     return await fetch(uri, {
       method: "GET",
       headers
     });
   }
-  async sendPostRequest(token, uri, body) {
+  async sendPostRequest({
+    token,
+    uri,
+    apiKey,
+    body
+  }) {
     const headers = {
       "Content-Type": "application/json",
       "Client-Version": this.clientVersion
@@ -231,13 +296,21 @@ var Service = class {
     if (token !== void 0 && token !== null) {
       headers.Authorization = `Bearer ${token}`;
     }
+    if (apiKey !== null) {
+      headers["X-API-KEY"] = apiKey;
+    }
     return await fetch(uri, {
       method: "POST",
       headers,
       body: JSON.stringify(body)
     });
   }
-  async sendPatchRequest(token, uri, body) {
+  async sendPatchRequest({
+    token,
+    uri,
+    apiKey,
+    body
+  }) {
     const headers = {
       "Content-Type": "application/json",
       "Client-Version": this.clientVersion
@@ -245,13 +318,20 @@ var Service = class {
     if (token !== void 0 && token !== null) {
       headers.Authorization = `Bearer ${token}`;
     }
+    if (apiKey !== null) {
+      headers["X-API-KEY"] = apiKey;
+    }
     return await fetch(uri, {
       method: "PATCH",
       headers,
       body: JSON.stringify(body)
     });
   }
-  async sendDeleteRequest(token, uri) {
+  async sendDeleteRequest({
+    token,
+    uri,
+    apiKey
+  }) {
     const headers = {
       "Content-Type": "application/json",
       "Client-Version": this.clientVersion
@@ -259,6 +339,9 @@ var Service = class {
     if (token !== void 0 && token !== null) {
       headers.Authorization = `Bearer ${token}`;
     }
+    if (apiKey !== null) {
+      headers["X-API-KEY"] = apiKey;
+    }
     return await fetch(uri, {
       method: "DELETE",
       headers
@@ -2749,6 +2832,78 @@ var DeviceParameterHistoriesService = class extends Service {
   }
 };
 
+// src/apiKeys/apiKeys.service.ts
+var ApiKeysService = class extends Service {
+  constructor(config) {
+    super(config);
+  }
+  async create(ApiKeyCreateParams, ApiKeyCreateOptions) {
+    return await super.sendRequest(
+      {
+        method: "POST",
+        url: "apiKeys",
+        body: {
+          propertyId: ApiKeyCreateParams.propertyId
+        },
+        authenticationNotOptional: true
+      },
+      ApiKeyCreateOptions
+    );
+  }
+  async list(ApiKeyListParams, ApiKeyListOptions) {
+    const queryArray = [];
+    if (ApiKeyListOptions?.limit !== void 0) {
+      queryArray.push("limit=" + ApiKeyListOptions.limit);
+    }
+    if (ApiKeyListParams?.propertyId !== void 0) {
+      queryArray.push("propertyId=" + ApiKeyListParams.propertyId);
+    }
+    if (ApiKeyListParams?.statusArray !== void 0) {
+      queryArray.push("statusArray=" + ApiKeyListParams.statusArray.join(","));
+    }
+    if (ApiKeyListOptions?.skip !== void 0) {
+      queryArray.push("skip=" + ApiKeyListOptions.skip);
+    }
+    return await super.sendRequest(
+      {
+        method: "GET",
+        url: "apiKeys?" + queryArray.join("&"),
+        body: void 0,
+        authenticationNotOptional: false
+      },
+      ApiKeyListOptions
+    );
+  }
+  async retrieve(ApiKeyRetrieveParams, ApiKeyRetrieveOptions) {
+    const queryArray = [];
+    if (ApiKeyRetrieveOptions?.expand !== void 0) {
+      queryArray.push("expand=" + ApiKeyRetrieveOptions.expand.join(","));
+    }
+    return await super.sendRequest(
+      {
+        method: "GET",
+        url: "apiKeys/" + ApiKeyRetrieveParams.apiKeyId + "?" + queryArray.join("&"),
+        body: void 0,
+        authenticationNotOptional: false
+      },
+      ApiKeyRetrieveOptions
+    );
+  }
+  async update(ApiKeyUpdateParams, ApiKeyUpdateOptions) {
+    return await super.sendRequest(
+      {
+        method: "PATCH",
+        url: "apiKeys/" + ApiKeyUpdateParams.apiKeyId,
+        body: {
+          status: ApiKeyUpdateParams.status
+        },
+        authenticationNotOptional: true
+      },
+      ApiKeyUpdateOptions
+    );
+  }
+};
+
 // src/types/types.ts
 var LanguageCodeArray = [
   "en",
@@ -2926,6 +3081,7 @@ var Juhuu = class {
     this.tapkey = new TapkeyService(config);
     this.articleGroups = new ArticleGroupGroupsService(config);
     this.deviceParameterHistories = new DeviceParameterHistoriesService(config);
+    this.apiKeys = new ApiKeysService(config);
   }
   /**
    * Top Level Resources
@@ -2958,6 +3114,7 @@ var Juhuu = class {
   tapkey;
   articleGroups;
   deviceParameterHistories;
+  apiKeys;
 };
 var JUHUU;
 ((JUHUU2) => {

package/dist/index.mjs

@@ -2,14 +2,17 @@
 import io from "socket.io-client";
 var Service = class {
   constructor(config) {
-    this.environment = config.environment;
-    this.getAccessToken = config.getAccessToken;
-    this.onException = config.onException;
-    this.setAccessToken = config.setAccessToken;
-    this.getAccessToken = config.getAccessToken;
-    this.setRefreshToken = config.setRefreshToken;
-    this.getRefreshToken = config.getRefreshToken;
+    this.environment = config.environment ?? "production";
+    this.getAccessToken = config.getAccessToken ?? (() => null);
+    this.onException = config.onException ?? (() => Promise.resolve("abort"));
+    this.setAccessToken = config.setAccessToken ?? (() => Promise.resolve());
+    this.getAccessToken = config.getAccessToken ?? (() => null);
+    this.setRefreshToken = config.setRefreshToken ?? (() => Promise.resolve());
+    this.getRefreshToken = config.getRefreshToken ?? (() => Promise.resolve(null));
     this.clientVersion = config.clientVersion;
+    this.apiKey = config.apiKey ?? null;
+    this.defaultRequestOptions = config.defaultRequestOptions ?? {};
+    this.authenticationMode = config.authenticationMode ?? "jwt";
     switch (config.environment) {
       case "development":
         this.httpBaseUrl = "https://api.juhuu.dev/v1/";
@@ -25,6 +28,9 @@ var Service = class {
   httpBaseUrl;
   wssBaseUrl;
   clientVersion;
+  apiKey;
+  defaultRequestOptions;
+  authenticationMode;
   onException;
   getAccessToken;
   setAccessToken;
@@ -36,29 +42,76 @@ var Service = class {
     body = void 0,
     authenticationNotOptional
   }, options = {}) {
-    if (options.triggerOnException === void 0) {
-      options.triggerOnException = true;
+    const currentOptions = {
+      ...this.defaultRequestOptions,
+      ...options
+    };
+    if (currentOptions.triggerOnException === void 0) {
+      switch (this.authenticationMode) {
+        case "jwt": {
+          currentOptions.triggerOnException = true;
+          break;
+        }
+        case "apiKey": {
+          currentOptions.triggerOnException = false;
+          break;
+        }
+      }
     }
-    if (options.refreshTokensIfNecessary === void 0) {
-      options.refreshTokensIfNecessary = true;
+    if (currentOptions.refreshTokensIfNecessary === void 0) {
+      switch (this.authenticationMode) {
+        case "jwt": {
+          currentOptions.refreshTokensIfNecessary = true;
+          break;
+        }
+        case "apiKey": {
+          currentOptions.refreshTokensIfNecessary = false;
+          break;
+        }
+      }
     }
     let token = null;
-    if (options.accessToken === void 0 || options.accessToken === null) {
-      token = await this.getAccessToken();
-    } else {
-      token = options.accessToken;
-    }
-    console.log("accessToken:", token);
-    if ((token === null || token === void 0) && authenticationNotOptional === true) {
-      console.error(
-        "endpoint",
-        url,
-        "should use authentication but no token was found"
-      );
-      return {
-        ok: false,
-        data: {}
-      };
+    let apiKey = null;
+    switch (this.authenticationMode) {
+      case "jwt": {
+        if (currentOptions.accessToken === void 0 || currentOptions.accessToken === null) {
+          token = await this.getAccessToken();
+        } else {
+          token = currentOptions.accessToken;
+        }
+        console.log("accessToken:", token);
+        if ((token === null || token === void 0) && authenticationNotOptional === true) {
+          console.error(
+            "endpoint",
+            url,
+            "should use authentication but no token was found"
+          );
+          return {
+            ok: false,
+            data: {}
+          };
+        }
+        break;
+      }
+      case "apiKey": {
+        if (currentOptions.apiKey === void 0 || currentOptions.apiKey === null) {
+          apiKey = this.apiKey;
+        } else {
+          apiKey = currentOptions.apiKey;
+        }
+        if (apiKey === null) {
+          console.error(
+            "endpoint",
+            url,
+            "should use authentication but no apiKey was found"
+          );
+          return {
+            ok: false,
+            data: {}
+          };
+        }
+        break;
+      }
     }
     const uri = this.httpBaseUrl + url;
     let response = null;
@@ -66,19 +119,19 @@ var Service = class {
     try {
       switch (method) {
         case "GET": {
-          response = await this.sendGetRequest(token, uri);
+          response = await this.sendGetRequest({ token, uri, apiKey });
           break;
         }
         case "POST": {
-          response = await this.sendPostRequest(token, uri, body);
+          response = await this.sendPostRequest({ token, uri, body, apiKey });
           break;
         }
         case "PATCH": {
-          response = await this.sendPatchRequest(token, uri, body);
+          response = await this.sendPatchRequest({ token, uri, body, apiKey });
           break;
         }
         case "DELETE": {
-          response = await this.sendDeleteRequest(token, uri);
+          response = await this.sendDeleteRequest({ token, uri, apiKey });
           break;
         }
       }
@@ -166,7 +219,11 @@ var Service = class {
     }
     return responseObject;
   }
-  async sendGetRequest(token, uri) {
+  async sendGetRequest({
+    token,
+    apiKey,
+    uri
+  }) {
     const headers = {
       "Content-Type": "application/json",
       "Client-Version": this.clientVersion
@@ -174,12 +231,20 @@ var Service = class {
     if (token !== void 0 && token !== null) {
       headers.Authorization = `Bearer ${token}`;
     }
+    if (apiKey !== null) {
+      headers["X-API-KEY"] = apiKey;
+    }
     return await fetch(uri, {
       method: "GET",
       headers
     });
   }
-  async sendPostRequest(token, uri, body) {
+  async sendPostRequest({
+    token,
+    uri,
+    apiKey,
+    body
+  }) {
     const headers = {
       "Content-Type": "application/json",
       "Client-Version": this.clientVersion
@@ -187,13 +252,21 @@ var Service = class {
     if (token !== void 0 && token !== null) {
       headers.Authorization = `Bearer ${token}`;
     }
+    if (apiKey !== null) {
+      headers["X-API-KEY"] = apiKey;
+    }
     return await fetch(uri, {
       method: "POST",
       headers,
       body: JSON.stringify(body)
     });
   }
-  async sendPatchRequest(token, uri, body) {
+  async sendPatchRequest({
+    token,
+    uri,
+    apiKey,
+    body
+  }) {
     const headers = {
       "Content-Type": "application/json",
       "Client-Version": this.clientVersion
@@ -201,13 +274,20 @@ var Service = class {
     if (token !== void 0 && token !== null) {
       headers.Authorization = `Bearer ${token}`;
     }
+    if (apiKey !== null) {
+      headers["X-API-KEY"] = apiKey;
+    }
     return await fetch(uri, {
       method: "PATCH",
       headers,
       body: JSON.stringify(body)
     });
   }
-  async sendDeleteRequest(token, uri) {
+  async sendDeleteRequest({
+    token,
+    uri,
+    apiKey
+  }) {
     const headers = {
       "Content-Type": "application/json",
       "Client-Version": this.clientVersion
@@ -215,6 +295,9 @@ var Service = class {
     if (token !== void 0 && token !== null) {
       headers.Authorization = `Bearer ${token}`;
     }
+    if (apiKey !== null) {
+      headers["X-API-KEY"] = apiKey;
+    }
     return await fetch(uri, {
       method: "DELETE",
       headers
@@ -2705,6 +2788,78 @@ var DeviceParameterHistoriesService = class extends Service {
   }
 };
 
+// src/apiKeys/apiKeys.service.ts
+var ApiKeysService = class extends Service {
+  constructor(config) {
+    super(config);
+  }
+  async create(ApiKeyCreateParams, ApiKeyCreateOptions) {
+    return await super.sendRequest(
+      {
+        method: "POST",
+        url: "apiKeys",
+        body: {
+          propertyId: ApiKeyCreateParams.propertyId
+        },
+        authenticationNotOptional: true
+      },
+      ApiKeyCreateOptions
+    );
+  }
+  async list(ApiKeyListParams, ApiKeyListOptions) {
+    const queryArray = [];
+    if (ApiKeyListOptions?.limit !== void 0) {
+      queryArray.push("limit=" + ApiKeyListOptions.limit);
+    }
+    if (ApiKeyListParams?.propertyId !== void 0) {
+      queryArray.push("propertyId=" + ApiKeyListParams.propertyId);
+    }
+    if (ApiKeyListParams?.statusArray !== void 0) {
+      queryArray.push("statusArray=" + ApiKeyListParams.statusArray.join(","));
+    }
+    if (ApiKeyListOptions?.skip !== void 0) {
+      queryArray.push("skip=" + ApiKeyListOptions.skip);
+    }
+    return await super.sendRequest(
+      {
+        method: "GET",
+        url: "apiKeys?" + queryArray.join("&"),
+        body: void 0,
+        authenticationNotOptional: false
+      },
+      ApiKeyListOptions
+    );
+  }
+  async retrieve(ApiKeyRetrieveParams, ApiKeyRetrieveOptions) {
+    const queryArray = [];
+    if (ApiKeyRetrieveOptions?.expand !== void 0) {
+      queryArray.push("expand=" + ApiKeyRetrieveOptions.expand.join(","));
+    }
+    return await super.sendRequest(
+      {
+        method: "GET",
+        url: "apiKeys/" + ApiKeyRetrieveParams.apiKeyId + "?" + queryArray.join("&"),
+        body: void 0,
+        authenticationNotOptional: false
+      },
+      ApiKeyRetrieveOptions
+    );
+  }
+  async update(ApiKeyUpdateParams, ApiKeyUpdateOptions) {
+    return await super.sendRequest(
+      {
+        method: "PATCH",
+        url: "apiKeys/" + ApiKeyUpdateParams.apiKeyId,
+        body: {
+          status: ApiKeyUpdateParams.status
+        },
+        authenticationNotOptional: true
+      },
+      ApiKeyUpdateOptions
+    );
+  }
+};
+
 // src/types/types.ts
 var LanguageCodeArray = [
   "en",
@@ -2882,6 +3037,7 @@ var Juhuu = class {
     this.tapkey = new TapkeyService(config);
     this.articleGroups = new ArticleGroupGroupsService(config);
     this.deviceParameterHistories = new DeviceParameterHistoriesService(config);
+    this.apiKeys = new ApiKeysService(config);
   }
   /**
    * Top Level Resources
@@ -2914,6 +3070,7 @@ var Juhuu = class {
   tapkey;
   articleGroups;
   deviceParameterHistories;
+  apiKeys;
 };
 var JUHUU;
 ((JUHUU2) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juhuu/sdk-ts",
-  "version": "1.2.144",
+  "version": "1.2.146",
   "description": "Typescript wrapper for JUHUU services",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",