@peektravel/app-utilities 0.1.6 → 0.2.2

package/dist/index.d.cts

@@ -23,8 +23,8 @@ interface GraphQLClientOptions {
     baseUrl: string;
     /** Peek app ID, used in the endpoint path. */
     appId: string;
-    /** API gateway key sent as the `pk-api-key` header. */
-    gatewayKey: string;
+    /** API gateway key sent as the `pk-api-key` header. Omitted from headers when absent (v2 mode). */
+    gatewayKey?: string;
     /** Supplies a valid bearer token for each request. */
     getToken: () => string;
     /** Backoff delays (ms) applied on successive HTTP 429 responses. */
@@ -33,6 +33,11 @@ interface GraphQLClientOptions {
     logger: Logger;
     /** `fetch` implementation to use. */
     fetchFn: typeof fetch;
+    /**
+     * Optional fixed path segment inserted between `appId` and the endpoint name.
+     * Used in v2 mode: `baseUrl/appId/endpointPathPrefix/endpointName`.
+     */
+    endpointPathPrefix?: string;
 }
 declare class GraphQLClient {
     private readonly options;
@@ -1199,9 +1204,16 @@ interface PeekAccessServiceConfig {
     issuer: string;
     /** Peek app ID, used in the gateway endpoint path. */
     appId: string;
-    /** API gateway key, sent as the `pk-api-key` header. */
-    gatewayKey: string;
-    /** Override the gateway base URL. Default: Peek production gateway. */
+    /** API gateway key, sent as the `pk-api-key` header. Required in v1 mode; not used in v2. */
+    gatewayKey?: string;
+    /**
+     * Gateway mode. `"v2"` routes through the app-registry installations API
+     * (`baseUrl/appId/peek_backoffice_api-v1/endpointName`) and defaults to the
+     * app-registry sandbox base URL. `"v1"` (default) uses the standard backoffice
+     * GraphQL gateway.
+     */
+    mode?: "v2";
+    /** Override the gateway base URL. Default: Peek production gateway (v1) or app-registry sandbox (v2). */
     baseUrl?: string;
     /** JWT lifetime in seconds. Default: 3600. */
     tokenTtlSeconds?: number;

package/dist/index.d.ts

@@ -23,8 +23,8 @@ interface GraphQLClientOptions {
     baseUrl: string;
     /** Peek app ID, used in the endpoint path. */
     appId: string;
-    /** API gateway key sent as the `pk-api-key` header. */
-    gatewayKey: string;
+    /** API gateway key sent as the `pk-api-key` header. Omitted from headers when absent (v2 mode). */
+    gatewayKey?: string;
     /** Supplies a valid bearer token for each request. */
     getToken: () => string;
     /** Backoff delays (ms) applied on successive HTTP 429 responses. */
@@ -33,6 +33,11 @@ interface GraphQLClientOptions {
     logger: Logger;
     /** `fetch` implementation to use. */
     fetchFn: typeof fetch;
+    /**
+     * Optional fixed path segment inserted between `appId` and the endpoint name.
+     * Used in v2 mode: `baseUrl/appId/endpointPathPrefix/endpointName`.
+     */
+    endpointPathPrefix?: string;
 }
 declare class GraphQLClient {
     private readonly options;
@@ -1199,9 +1204,16 @@ interface PeekAccessServiceConfig {
     issuer: string;
     /** Peek app ID, used in the gateway endpoint path. */
     appId: string;
-    /** API gateway key, sent as the `pk-api-key` header. */
-    gatewayKey: string;
-    /** Override the gateway base URL. Default: Peek production gateway. */
+    /** API gateway key, sent as the `pk-api-key` header. Required in v1 mode; not used in v2. */
+    gatewayKey?: string;
+    /**
+     * Gateway mode. `"v2"` routes through the app-registry installations API
+     * (`baseUrl/appId/peek_backoffice_api-v1/endpointName`) and defaults to the
+     * app-registry sandbox base URL. `"v1"` (default) uses the standard backoffice
+     * GraphQL gateway.
+     */
+    mode?: "v2";
+    /** Override the gateway base URL. Default: Peek production gateway (v1) or app-registry sandbox (v2). */
     baseUrl?: string;
     /** JWT lifetime in seconds. Default: 3600. */
     tokenTtlSeconds?: number;

package/dist/index.js

@@ -3,6 +3,7 @@ import * as jwt from 'jsonwebtoken';
 
 // src/internal/gateway-endpoints.ts
 var SALES_ENDPOINT = "sales";
+var V2_EXTENDABLE_SLUG = "peek_backoffice_api-v1";
 
 // src/internal/account-users/account-user-converter.ts
 var ACTIVE_STATUS = "ACTIVE";
@@ -1819,14 +1820,19 @@ var GraphQLClient = class {
     throw new RateLimitError();
   }
   endpoint(endpointName) {
-    return `${this.options.baseUrl}/${this.options.appId}/${endpointName}`;
+    const { baseUrl, appId, endpointPathPrefix } = this.options;
+    const prefix = endpointPathPrefix ? `${endpointPathPrefix}/` : "";
+    return `${baseUrl}/${appId}/${prefix}${endpointName}`;
   }
   buildHeaders() {
-    return {
+    const headers = {
       "X-Peek-Auth": `Bearer ${this.options.getToken()}`,
-      "pk-api-key": this.options.gatewayKey,
       "Content-Type": "application/json"
     };
+    if (this.options.gatewayKey) {
+      headers["pk-api-key"] = this.options.gatewayKey;
+    }
+    return headers;
   }
 };
 
@@ -2886,6 +2892,7 @@ var noopLogger = {
 
 // src/peek-access-service.ts
 var DEFAULT_BASE_URL = "https://apps.peekapis.com/backoffice-gql";
+var DEFAULT_V2_BASE_URL = "https://app-registry.peeklabs.com/installations-api";
 var DEFAULT_TOKEN_TTL_SECONDS = 3600;
 var DEFAULT_TOKEN_REFRESH_LEEWAY_SECONDS = 60;
 var DEFAULT_RETRY_DELAYS_MS = [1e3, 2e3, 4e3];
@@ -2904,11 +2911,12 @@ var PeekAccessService = class {
   bookingService;
   reviewService;
   constructor(config) {
+    const isV2 = config.mode === "v2";
     requireNonEmpty(config.installId, "installId");
     requireNonEmpty(config.jwtSecret, "jwtSecret");
     requireNonEmpty(config.issuer, "issuer");
     requireNonEmpty(config.appId, "appId");
-    requireNonEmpty(config.gatewayKey, "gatewayKey");
+    if (!isV2) requireNonEmpty(config.gatewayKey ?? "", "gatewayKey");
     const logger = config.logger ?? noopLogger;
     const tokens = new TokenManager({
       secret: config.jwtSecret,
@@ -2917,14 +2925,16 @@ var PeekAccessService = class {
       ttlSeconds: config.tokenTtlSeconds ?? DEFAULT_TOKEN_TTL_SECONDS,
       leewaySeconds: config.tokenRefreshLeewaySeconds ?? DEFAULT_TOKEN_REFRESH_LEEWAY_SECONDS
     });
+    const defaultBaseUrl = isV2 ? DEFAULT_V2_BASE_URL : DEFAULT_BASE_URL;
     this.client = new GraphQLClient({
-      baseUrl: config.baseUrl ?? DEFAULT_BASE_URL,
+      baseUrl: config.baseUrl ?? defaultBaseUrl,
       appId: config.appId,
       gatewayKey: config.gatewayKey,
       getToken: () => tokens.getToken(),
       retryDelaysMs: config.retryDelaysMs ?? DEFAULT_RETRY_DELAYS_MS,
       logger,
-      fetchFn: config.fetch ?? globalThis.fetch
+      fetchFn: config.fetch ?? globalThis.fetch,
+      endpointPathPrefix: isV2 ? V2_EXTENDABLE_SLUG : void 0
     });
     this.productServiceOptions = {
       itemOptionsPageSize: config.itemOptionsPageSize