perspectapi-ts-sdk 6.5.6 → 6.5.7

package/dist/index.d.mts

@@ -1126,6 +1126,11 @@ declare class HttpClient {
      * Update API key
      */
     setApiKey(apiKey: string): void;
+    /**
+     * Whether this client currently has a site-user/admin bearer token attached.
+     * Bearer-scoped GETs must not share cache entries across callers.
+     */
+    hasBearerAuth(): boolean;
     /**
      * Remove authentication
      */
@@ -1969,13 +1974,14 @@ declare class SiteUsersV2Client extends BaseV2Client {
     list(siteName: string, params?: V2SiteUserListParams): Promise<V2List<V2SiteUser>>;
     listAutoPaginated(siteName: string, params?: Omit<V2SiteUserListParams, 'starting_after' | 'ending_before'>): AsyncGenerator<V2SiteUser, void, unknown>;
     get(siteName: string, id: string): Promise<V2SiteUser>;
+    getProfileForUser(siteName: string, id: string, cachePolicy?: CachePolicy): Promise<V2SiteUserProfile>;
     update(siteName: string, id: string, data: V2SiteUserUpdateParams): Promise<V2SiteUser>;
     /**
      * Load the currently-authenticated site user's canonical record plus their
      * profile KV map. Requires `client.setAuth(jwt)` to have been called with
      * the token returned from `verifyOtp`.
      */
-    getMe(siteName: string): Promise<V2SiteUserWithProfile>;
+    getMe(siteName: string, cachePolicy?: CachePolicy): Promise<V2SiteUserWithProfile>;
     /** Update the authenticated user's own fields. */
     updateMe(siteName: string, data: V2SiteUserMeUpdateParams): Promise<V2SiteUser>;
     /** Fetch the profile KV map as a dedicated `site_user_profile` envelope. */
@@ -2145,9 +2151,9 @@ declare class SubscriptionsV2Client extends BaseV2Client {
 
 declare class CreditsV2Client extends BaseV2Client {
     /** Get the current credit balance for the authenticated user. */
-    getMyBalance(siteName: string): Promise<V2CreditBalance>;
+    getMyBalance(siteName: string, cachePolicy?: CachePolicy): Promise<V2CreditBalance>;
     /** Get credit balance and transaction history for the authenticated user. */
-    getMyCredits(siteName: string): Promise<V2CreditBalance>;
+    getMyCredits(siteName: string, cachePolicy?: CachePolicy): Promise<V2CreditBalance>;
     /** Get the credit balance for a specific user (admin). */
     getUserBalance(siteName: string, userId: string): Promise<V2CreditBalance>;
     /** Grant credit to a specific user (admin). */

package/dist/index.d.ts

@@ -1126,6 +1126,11 @@ declare class HttpClient {
      * Update API key
      */
     setApiKey(apiKey: string): void;
+    /**
+     * Whether this client currently has a site-user/admin bearer token attached.
+     * Bearer-scoped GETs must not share cache entries across callers.
+     */
+    hasBearerAuth(): boolean;
     /**
      * Remove authentication
      */
@@ -1969,13 +1974,14 @@ declare class SiteUsersV2Client extends BaseV2Client {
     list(siteName: string, params?: V2SiteUserListParams): Promise<V2List<V2SiteUser>>;
     listAutoPaginated(siteName: string, params?: Omit<V2SiteUserListParams, 'starting_after' | 'ending_before'>): AsyncGenerator<V2SiteUser, void, unknown>;
     get(siteName: string, id: string): Promise<V2SiteUser>;
+    getProfileForUser(siteName: string, id: string, cachePolicy?: CachePolicy): Promise<V2SiteUserProfile>;
     update(siteName: string, id: string, data: V2SiteUserUpdateParams): Promise<V2SiteUser>;
     /**
      * Load the currently-authenticated site user's canonical record plus their
      * profile KV map. Requires `client.setAuth(jwt)` to have been called with
      * the token returned from `verifyOtp`.
      */
-    getMe(siteName: string): Promise<V2SiteUserWithProfile>;
+    getMe(siteName: string, cachePolicy?: CachePolicy): Promise<V2SiteUserWithProfile>;
     /** Update the authenticated user's own fields. */
     updateMe(siteName: string, data: V2SiteUserMeUpdateParams): Promise<V2SiteUser>;
     /** Fetch the profile KV map as a dedicated `site_user_profile` envelope. */
@@ -2145,9 +2151,9 @@ declare class SubscriptionsV2Client extends BaseV2Client {
 
 declare class CreditsV2Client extends BaseV2Client {
     /** Get the current credit balance for the authenticated user. */
-    getMyBalance(siteName: string): Promise<V2CreditBalance>;
+    getMyBalance(siteName: string, cachePolicy?: CachePolicy): Promise<V2CreditBalance>;
     /** Get credit balance and transaction history for the authenticated user. */
-    getMyCredits(siteName: string): Promise<V2CreditBalance>;
+    getMyCredits(siteName: string, cachePolicy?: CachePolicy): Promise<V2CreditBalance>;
     /** Get the credit balance for a specific user (admin). */
     getUserBalance(siteName: string, userId: string): Promise<V2CreditBalance>;
     /** Grant credit to a specific user (admin). */

package/dist/index.js

@@ -132,6 +132,13 @@ var HttpClient = class {
   setApiKey(apiKey) {
     this.defaultHeaders["X-API-Key"] = apiKey;
   }
+  /**
+   * Whether this client currently has a site-user/admin bearer token attached.
+   * Bearer-scoped GETs must not share cache entries across callers.
+   */
+  hasBearerAuth() {
+    return Boolean(this.defaultHeaders["Authorization"]);
+  }
   /**
    * Remove authentication
    */
@@ -684,7 +691,8 @@ var BaseV2Client = class {
   }
   /** Fetch with optional cache. Bypasses cache for writes or when no cache is configured. */
   async fetchWithCache(path, params, policy, fetcher) {
-    if (!this.cache || policy?.skipCache) {
+    const hasBearerAuth = typeof this.http.hasBearerAuth === "function" && this.http.hasBearerAuth();
+    if (!this.cache || policy?.skipCache || hasBearerAuth) {
       return fetcher();
     }
     const key = this.buildCacheKey(path, params);
@@ -1001,6 +1009,9 @@ var OrdersV2Client = class extends BaseV2Client {
 };
 
 // src/v2/client/site-users-client.ts
+function bypassAuthenticatedCache(policy) {
+  return { ...policy, skipCache: true };
+}
 var SiteUsersV2Client = class extends BaseV2Client {
   // --- OTP Auth (public, API-key-scoped) ---
   async requestOtp(siteName, data) {
@@ -1019,6 +1030,13 @@ var SiteUsersV2Client = class extends BaseV2Client {
   async get(siteName, id) {
     return this.getOne(this.sitePath(siteName, "users", id));
   }
+  async getProfileForUser(siteName, id, cachePolicy) {
+    return this.getOne(
+      this.sitePath(siteName, "users", `${id}/profile`),
+      void 0,
+      cachePolicy
+    );
+  }
   async update(siteName, id, data) {
     return this.patchOne(this.sitePath(siteName, "users", id), data);
   }
@@ -1028,9 +1046,11 @@ var SiteUsersV2Client = class extends BaseV2Client {
    * profile KV map. Requires `client.setAuth(jwt)` to have been called with
    * the token returned from `verifyOtp`.
    */
-  async getMe(siteName) {
+  async getMe(siteName, cachePolicy) {
     return this.getOne(
-      this.sitePath(siteName, "users", "me")
+      this.sitePath(siteName, "users", "me"),
+      void 0,
+      bypassAuthenticatedCache(cachePolicy)
     );
   }
   /** Update the authenticated user's own fields. */
@@ -1045,7 +1065,7 @@ var SiteUsersV2Client = class extends BaseV2Client {
     return this.getOne(
       this.sitePath(siteName, "users", "me/profile"),
       void 0,
-      cachePolicy
+      bypassAuthenticatedCache(cachePolicy)
     );
   }
   /**
@@ -1267,7 +1287,7 @@ var SubscriptionsV2Client = class extends BaseV2Client {
     return this.getList(
       this.sitePath(siteName, "users", "me/subscriptions"),
       void 0,
-      cachePolicy
+      { ...cachePolicy, skipCache: true }
     );
   }
   /** Pause a subscription. */
@@ -1332,15 +1352,19 @@ var SubscriptionsV2Client = class extends BaseV2Client {
 var CreditsV2Client = class extends BaseV2Client {
   // --- Authenticated "me" endpoints (site-user JWT) ---
   /** Get the current credit balance for the authenticated user. */
-  async getMyBalance(siteName) {
+  async getMyBalance(siteName, cachePolicy) {
     return this.getOne(
-      this.sitePath(siteName, "users", "me/credits/balance")
+      this.sitePath(siteName, "users", "me/credits/balance"),
+      void 0,
+      { ...cachePolicy, skipCache: true }
     );
   }
   /** Get credit balance and transaction history for the authenticated user. */
-  async getMyCredits(siteName) {
+  async getMyCredits(siteName, cachePolicy) {
     return this.getOne(
-      this.sitePath(siteName, "users", "me/credits")
+      this.sitePath(siteName, "users", "me/credits"),
+      void 0,
+      { ...cachePolicy, skipCache: true }
     );
   }
   // --- Admin endpoints (API key) ---
@@ -1488,7 +1512,8 @@ var BaseClient = class {
    * Fetch a GET endpoint with optional caching support.
    */
   async fetchWithCache(endpoint, params, tags, policy, fetcher) {
-    if (!this.cache) {
+    const hasBearerAuth = typeof this.http.hasBearerAuth === "function" && this.http.hasBearerAuth();
+    if (!this.cache || hasBearerAuth) {
       return fetcher();
     }
     const cacheKey = this.buildCacheKey(endpoint, params);

package/dist/index.mjs

@@ -56,6 +56,13 @@ var HttpClient = class {
   setApiKey(apiKey) {
     this.defaultHeaders["X-API-Key"] = apiKey;
   }
+  /**
+   * Whether this client currently has a site-user/admin bearer token attached.
+   * Bearer-scoped GETs must not share cache entries across callers.
+   */
+  hasBearerAuth() {
+    return Boolean(this.defaultHeaders["Authorization"]);
+  }
   /**
    * Remove authentication
    */
@@ -608,7 +615,8 @@ var BaseV2Client = class {
   }
   /** Fetch with optional cache. Bypasses cache for writes or when no cache is configured. */
   async fetchWithCache(path, params, policy, fetcher) {
-    if (!this.cache || policy?.skipCache) {
+    const hasBearerAuth = typeof this.http.hasBearerAuth === "function" && this.http.hasBearerAuth();
+    if (!this.cache || policy?.skipCache || hasBearerAuth) {
       return fetcher();
     }
     const key = this.buildCacheKey(path, params);
@@ -925,6 +933,9 @@ var OrdersV2Client = class extends BaseV2Client {
 };
 
 // src/v2/client/site-users-client.ts
+function bypassAuthenticatedCache(policy) {
+  return { ...policy, skipCache: true };
+}
 var SiteUsersV2Client = class extends BaseV2Client {
   // --- OTP Auth (public, API-key-scoped) ---
   async requestOtp(siteName, data) {
@@ -943,6 +954,13 @@ var SiteUsersV2Client = class extends BaseV2Client {
   async get(siteName, id) {
     return this.getOne(this.sitePath(siteName, "users", id));
   }
+  async getProfileForUser(siteName, id, cachePolicy) {
+    return this.getOne(
+      this.sitePath(siteName, "users", `${id}/profile`),
+      void 0,
+      cachePolicy
+    );
+  }
   async update(siteName, id, data) {
     return this.patchOne(this.sitePath(siteName, "users", id), data);
   }
@@ -952,9 +970,11 @@ var SiteUsersV2Client = class extends BaseV2Client {
    * profile KV map. Requires `client.setAuth(jwt)` to have been called with
    * the token returned from `verifyOtp`.
    */
-  async getMe(siteName) {
+  async getMe(siteName, cachePolicy) {
     return this.getOne(
-      this.sitePath(siteName, "users", "me")
+      this.sitePath(siteName, "users", "me"),
+      void 0,
+      bypassAuthenticatedCache(cachePolicy)
     );
   }
   /** Update the authenticated user's own fields. */
@@ -969,7 +989,7 @@ var SiteUsersV2Client = class extends BaseV2Client {
     return this.getOne(
       this.sitePath(siteName, "users", "me/profile"),
       void 0,
-      cachePolicy
+      bypassAuthenticatedCache(cachePolicy)
     );
   }
   /**
@@ -1191,7 +1211,7 @@ var SubscriptionsV2Client = class extends BaseV2Client {
     return this.getList(
       this.sitePath(siteName, "users", "me/subscriptions"),
       void 0,
-      cachePolicy
+      { ...cachePolicy, skipCache: true }
     );
   }
   /** Pause a subscription. */
@@ -1256,15 +1276,19 @@ var SubscriptionsV2Client = class extends BaseV2Client {
 var CreditsV2Client = class extends BaseV2Client {
   // --- Authenticated "me" endpoints (site-user JWT) ---
   /** Get the current credit balance for the authenticated user. */
-  async getMyBalance(siteName) {
+  async getMyBalance(siteName, cachePolicy) {
     return this.getOne(
-      this.sitePath(siteName, "users", "me/credits/balance")
+      this.sitePath(siteName, "users", "me/credits/balance"),
+      void 0,
+      { ...cachePolicy, skipCache: true }
     );
   }
   /** Get credit balance and transaction history for the authenticated user. */
-  async getMyCredits(siteName) {
+  async getMyCredits(siteName, cachePolicy) {
     return this.getOne(
-      this.sitePath(siteName, "users", "me/credits")
+      this.sitePath(siteName, "users", "me/credits"),
+      void 0,
+      { ...cachePolicy, skipCache: true }
     );
   }
   // --- Admin endpoints (API key) ---
@@ -1412,7 +1436,8 @@ var BaseClient = class {
    * Fetch a GET endpoint with optional caching support.
    */
   async fetchWithCache(endpoint, params, tags, policy, fetcher) {
-    if (!this.cache) {
+    const hasBearerAuth = typeof this.http.hasBearerAuth === "function" && this.http.hasBearerAuth();
+    if (!this.cache || hasBearerAuth) {
       return fetcher();
     }
     const cacheKey = this.buildCacheKey(endpoint, params);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "perspectapi-ts-sdk",
-  "version": "6.5.6",
+  "version": "6.5.7",
   "description": "TypeScript SDK for PerspectAPI - Cloudflare Workers compatible",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/client/base-client.ts

@@ -115,7 +115,8 @@ export abstract class BaseClient {
     policy: CachePolicy | undefined,
     fetcher: () => Promise<T>
   ): Promise<T> {
-    if (!this.cache) {
+    const hasBearerAuth = typeof this.http.hasBearerAuth === 'function' && this.http.hasBearerAuth();
+    if (!this.cache || hasBearerAuth) {
       return fetcher();
     }
 

package/src/utils/http-client.ts

@@ -51,6 +51,14 @@ export class HttpClient {
     this.defaultHeaders['X-API-Key'] = apiKey;
   }
 
+  /**
+   * Whether this client currently has a site-user/admin bearer token attached.
+   * Bearer-scoped GETs must not share cache entries across callers.
+   */
+  hasBearerAuth(): boolean {
+    return Boolean(this.defaultHeaders['Authorization']);
+  }
+
   /**
    * Remove authentication
    */

package/src/v2/client/base-v2-client.ts

@@ -148,7 +148,8 @@ export abstract class BaseV2Client {
     policy: CachePolicy | undefined,
     fetcher: () => Promise<T>,
   ): Promise<T> {
-    if (!this.cache || policy?.skipCache) {
+    const hasBearerAuth = typeof this.http.hasBearerAuth === 'function' && this.http.hasBearerAuth();
+    if (!this.cache || policy?.skipCache || hasBearerAuth) {
       return fetcher();
     }
     const key = this.buildCacheKey(path, params);

package/src/v2/client/credits-client.ts

@@ -7,6 +7,7 @@
  */
 
 import { BaseV2Client } from './base-v2-client';
+import type { CachePolicy } from '../../cache/types';
 import type {
   V2CreditBalance,
   V2GrantCreditParams,
@@ -18,16 +19,20 @@ export class CreditsV2Client extends BaseV2Client {
   // --- Authenticated "me" endpoints (site-user JWT) ---
 
   /** Get the current credit balance for the authenticated user. */
-  async getMyBalance(siteName: string): Promise<V2CreditBalance> {
+  async getMyBalance(siteName: string, cachePolicy?: CachePolicy): Promise<V2CreditBalance> {
     return this.getOne<V2CreditBalance>(
       this.sitePath(siteName, 'users', 'me/credits/balance'),
+      undefined,
+      { ...cachePolicy, skipCache: true },
     );
   }
 
   /** Get credit balance and transaction history for the authenticated user. */
-  async getMyCredits(siteName: string): Promise<V2CreditBalance> {
+  async getMyCredits(siteName: string, cachePolicy?: CachePolicy): Promise<V2CreditBalance> {
     return this.getOne<V2CreditBalance>(
       this.sitePath(siteName, 'users', 'me/credits'),
+      undefined,
+      { ...cachePolicy, skipCache: true },
     );
   }
 

package/src/v2/client/site-users-client.ts

@@ -31,6 +31,10 @@ export interface V2OtpVerifyResponse extends V2SiteUser {
   token: string;
 }
 
+function bypassAuthenticatedCache(policy?: CachePolicy): CachePolicy {
+  return { ...policy, skipCache: true };
+}
+
 export class SiteUsersV2Client extends BaseV2Client {
 
   // --- OTP Auth (public, API-key-scoped) ---
@@ -63,6 +67,18 @@ export class SiteUsersV2Client extends BaseV2Client {
     return this.getOne<V2SiteUser>(this.sitePath(siteName, 'users', id));
   }
 
+  async getProfileForUser(
+    siteName: string,
+    id: string,
+    cachePolicy?: CachePolicy,
+  ): Promise<V2SiteUserProfile> {
+    return this.getOne<V2SiteUserProfile>(
+      this.sitePath(siteName, 'users', `${id}/profile`),
+      undefined,
+      cachePolicy,
+    );
+  }
+
   async update(siteName: string, id: string, data: V2SiteUserUpdateParams): Promise<V2SiteUser> {
     return this.patchOne<V2SiteUser>(this.sitePath(siteName, 'users', id), data);
   }
@@ -74,9 +90,11 @@ export class SiteUsersV2Client extends BaseV2Client {
    * profile KV map. Requires `client.setAuth(jwt)` to have been called with
    * the token returned from `verifyOtp`.
    */
-  async getMe(siteName: string): Promise<V2SiteUserWithProfile> {
+  async getMe(siteName: string, cachePolicy?: CachePolicy): Promise<V2SiteUserWithProfile> {
     return this.getOne<V2SiteUserWithProfile>(
       this.sitePath(siteName, 'users', 'me'),
+      undefined,
+      bypassAuthenticatedCache(cachePolicy),
     );
   }
 
@@ -96,7 +114,7 @@ export class SiteUsersV2Client extends BaseV2Client {
     return this.getOne<V2SiteUserProfile>(
       this.sitePath(siteName, 'users', 'me/profile'),
       undefined,
-      cachePolicy,
+      bypassAuthenticatedCache(cachePolicy),
     );
   }
 

package/src/v2/client/subscriptions-client.ts

@@ -29,7 +29,7 @@ export class SubscriptionsV2Client extends BaseV2Client {
     return this.getList<V2SiteUserSubscription>(
       this.sitePath(siteName, 'users', 'me/subscriptions'),
       undefined,
-      cachePolicy,
+      { ...cachePolicy, skipCache: true },
     );
   }