perspectapi-ts-sdk 6.3.0 → 6.4.1

package/dist/index.d.mts

@@ -1967,7 +1967,7 @@ declare class SiteUsersV2Client extends BaseV2Client {
     /** 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. */
-    getProfile(siteName: string): Promise<V2SiteUserProfile>;
+    getProfile(siteName: string, cachePolicy?: CachePolicy): Promise<V2SiteUserProfile>;
     /**
      * Set a single profile key. The value is persisted verbatim — callers wanting
      * structured data should JSON-stringify their value first.
@@ -2104,7 +2104,7 @@ declare class WebhooksV2Client extends BaseV2Client {
 
 declare class SubscriptionsV2Client extends BaseV2Client {
     /** List all subscriptions for the authenticated user. */
-    listMySubscriptions(siteName: string): Promise<V2List<V2SiteUserSubscription>>;
+    listMySubscriptions(siteName: string, cachePolicy?: CachePolicy): Promise<V2List<V2SiteUserSubscription>>;
     /** Pause a subscription. */
     pauseSubscription(siteName: string, subId: string, params?: V2SubscriptionPauseParams): Promise<V2SiteUserSubscription>;
     /** Resume a paused subscription. */
@@ -2114,7 +2114,7 @@ declare class SubscriptionsV2Client extends BaseV2Client {
     /** Change the plan (price) of a subscription. */
     changeSubscriptionPlan(siteName: string, subId: string, params: V2SubscriptionChangePlanParams): Promise<V2SiteUserSubscription>;
     /** List subscriptions for a specific user (admin). */
-    listUserSubscriptions(siteName: string, userId: string): Promise<V2List<V2SiteUserSubscription>>;
+    listUserSubscriptions(siteName: string, userId: string, cachePolicy?: CachePolicy): Promise<V2List<V2SiteUserSubscription>>;
     /** Pause a user's subscription (admin). */
     pauseUserSubscription(siteName: string, userId: string, subId: string, params?: V2SubscriptionPauseParams): Promise<V2SiteUserSubscription>;
     /** Resume a user's paused subscription (admin). */

package/dist/index.d.ts

@@ -1967,7 +1967,7 @@ declare class SiteUsersV2Client extends BaseV2Client {
     /** 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. */
-    getProfile(siteName: string): Promise<V2SiteUserProfile>;
+    getProfile(siteName: string, cachePolicy?: CachePolicy): Promise<V2SiteUserProfile>;
     /**
      * Set a single profile key. The value is persisted verbatim — callers wanting
      * structured data should JSON-stringify their value first.
@@ -2104,7 +2104,7 @@ declare class WebhooksV2Client extends BaseV2Client {
 
 declare class SubscriptionsV2Client extends BaseV2Client {
     /** List all subscriptions for the authenticated user. */
-    listMySubscriptions(siteName: string): Promise<V2List<V2SiteUserSubscription>>;
+    listMySubscriptions(siteName: string, cachePolicy?: CachePolicy): Promise<V2List<V2SiteUserSubscription>>;
     /** Pause a subscription. */
     pauseSubscription(siteName: string, subId: string, params?: V2SubscriptionPauseParams): Promise<V2SiteUserSubscription>;
     /** Resume a paused subscription. */
@@ -2114,7 +2114,7 @@ declare class SubscriptionsV2Client extends BaseV2Client {
     /** Change the plan (price) of a subscription. */
     changeSubscriptionPlan(siteName: string, subId: string, params: V2SubscriptionChangePlanParams): Promise<V2SiteUserSubscription>;
     /** List subscriptions for a specific user (admin). */
-    listUserSubscriptions(siteName: string, userId: string): Promise<V2List<V2SiteUserSubscription>>;
+    listUserSubscriptions(siteName: string, userId: string, cachePolicy?: CachePolicy): Promise<V2List<V2SiteUserSubscription>>;
     /** Pause a user's subscription (admin). */
     pauseUserSubscription(siteName: string, userId: string, subId: string, params?: V2SubscriptionPauseParams): Promise<V2SiteUserSubscription>;
     /** Resume a user's paused subscription (admin). */

package/dist/index.js

@@ -903,7 +903,9 @@ var CategoriesV2Client = class extends BaseV2Client {
 // src/v2/client/collections-client.ts
 var CollectionsV2Client = class extends BaseV2Client {
   async list(siteName, params) {
-    return this.getList(this.sitePath(siteName, "collections"), params);
+    return this.getList(this.sitePath(siteName, "collections"), params, {
+      tags: [`collections:${siteName}`]
+    });
   }
   async getCurrent(siteName) {
     const result = await this.getOne(
@@ -916,26 +918,22 @@ var CollectionsV2Client = class extends BaseV2Client {
   }
   async create(siteName, data) {
     const result = await this.post(this.sitePath(siteName, "collections"), data);
-    await this.invalidateCache({ keys: [this.sitePath(siteName, "collections")] });
+    await this.invalidateCache({ tags: [`collections:${siteName}`] });
     return result;
   }
   async update(siteName, id, data) {
     const result = await this.patchOne(this.sitePath(siteName, "collections", id), data);
     await this.invalidateCache({
-      keys: [
-        this.sitePath(siteName, "collections"),
-        this.sitePath(siteName, "collections", id)
-      ]
+      tags: [`collections:${siteName}`],
+      keys: [this.sitePath(siteName, "collections", id)]
     });
     return result;
   }
   async del(siteName, id) {
     const result = await this.deleteOne(this.sitePath(siteName, "collections", id));
     await this.invalidateCache({
-      keys: [
-        this.sitePath(siteName, "collections"),
-        this.sitePath(siteName, "collections", id)
-      ]
+      tags: [`collections:${siteName}`],
+      keys: [this.sitePath(siteName, "collections", id)]
     });
     return result;
   }
@@ -1040,9 +1038,11 @@ var SiteUsersV2Client = class extends BaseV2Client {
     );
   }
   /** Fetch the profile KV map as a dedicated `site_user_profile` envelope. */
-  async getProfile(siteName) {
+  async getProfile(siteName, cachePolicy) {
     return this.getOne(
-      this.sitePath(siteName, "users", "me/profile")
+      this.sitePath(siteName, "users", "me/profile"),
+      void 0,
+      cachePolicy
     );
   }
   /**
@@ -1260,9 +1260,11 @@ var WebhooksV2Client = class extends BaseV2Client {
 var SubscriptionsV2Client = class extends BaseV2Client {
   // --- Authenticated "me" endpoints (site-user JWT) ---
   /** List all subscriptions for the authenticated user. */
-  async listMySubscriptions(siteName) {
+  async listMySubscriptions(siteName, cachePolicy) {
     return this.getList(
-      this.sitePath(siteName, "users", "me/subscriptions")
+      this.sitePath(siteName, "users", "me/subscriptions"),
+      void 0,
+      cachePolicy
     );
   }
   /** Pause a subscription. */
@@ -1294,9 +1296,11 @@ var SubscriptionsV2Client = class extends BaseV2Client {
   }
   // --- Admin endpoints (API key) ---
   /** List subscriptions for a specific user (admin). */
-  async listUserSubscriptions(siteName, userId) {
+  async listUserSubscriptions(siteName, userId, cachePolicy) {
     return this.getList(
-      this.sitePath(siteName, "users", `${userId}/subscriptions`)
+      this.sitePath(siteName, "users", `${userId}/subscriptions`),
+      void 0,
+      cachePolicy
     );
   }
   /** Pause a user's subscription (admin). */

package/dist/index.mjs

@@ -827,7 +827,9 @@ var CategoriesV2Client = class extends BaseV2Client {
 // src/v2/client/collections-client.ts
 var CollectionsV2Client = class extends BaseV2Client {
   async list(siteName, params) {
-    return this.getList(this.sitePath(siteName, "collections"), params);
+    return this.getList(this.sitePath(siteName, "collections"), params, {
+      tags: [`collections:${siteName}`]
+    });
   }
   async getCurrent(siteName) {
     const result = await this.getOne(
@@ -840,26 +842,22 @@ var CollectionsV2Client = class extends BaseV2Client {
   }
   async create(siteName, data) {
     const result = await this.post(this.sitePath(siteName, "collections"), data);
-    await this.invalidateCache({ keys: [this.sitePath(siteName, "collections")] });
+    await this.invalidateCache({ tags: [`collections:${siteName}`] });
     return result;
   }
   async update(siteName, id, data) {
     const result = await this.patchOne(this.sitePath(siteName, "collections", id), data);
     await this.invalidateCache({
-      keys: [
-        this.sitePath(siteName, "collections"),
-        this.sitePath(siteName, "collections", id)
-      ]
+      tags: [`collections:${siteName}`],
+      keys: [this.sitePath(siteName, "collections", id)]
     });
     return result;
   }
   async del(siteName, id) {
     const result = await this.deleteOne(this.sitePath(siteName, "collections", id));
     await this.invalidateCache({
-      keys: [
-        this.sitePath(siteName, "collections"),
-        this.sitePath(siteName, "collections", id)
-      ]
+      tags: [`collections:${siteName}`],
+      keys: [this.sitePath(siteName, "collections", id)]
     });
     return result;
   }
@@ -964,9 +962,11 @@ var SiteUsersV2Client = class extends BaseV2Client {
     );
   }
   /** Fetch the profile KV map as a dedicated `site_user_profile` envelope. */
-  async getProfile(siteName) {
+  async getProfile(siteName, cachePolicy) {
     return this.getOne(
-      this.sitePath(siteName, "users", "me/profile")
+      this.sitePath(siteName, "users", "me/profile"),
+      void 0,
+      cachePolicy
     );
   }
   /**
@@ -1184,9 +1184,11 @@ var WebhooksV2Client = class extends BaseV2Client {
 var SubscriptionsV2Client = class extends BaseV2Client {
   // --- Authenticated "me" endpoints (site-user JWT) ---
   /** List all subscriptions for the authenticated user. */
-  async listMySubscriptions(siteName) {
+  async listMySubscriptions(siteName, cachePolicy) {
     return this.getList(
-      this.sitePath(siteName, "users", "me/subscriptions")
+      this.sitePath(siteName, "users", "me/subscriptions"),
+      void 0,
+      cachePolicy
     );
   }
   /** Pause a subscription. */
@@ -1218,9 +1220,11 @@ var SubscriptionsV2Client = class extends BaseV2Client {
   }
   // --- Admin endpoints (API key) ---
   /** List subscriptions for a specific user (admin). */
-  async listUserSubscriptions(siteName, userId) {
+  async listUserSubscriptions(siteName, userId, cachePolicy) {
     return this.getList(
-      this.sitePath(siteName, "users", `${userId}/subscriptions`)
+      this.sitePath(siteName, "users", `${userId}/subscriptions`),
+      void 0,
+      cachePolicy
     );
   }
   /** Pause a user's subscription (admin). */

package/package.json

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

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

@@ -11,7 +11,9 @@ import type {
 export class CollectionsV2Client extends BaseV2Client {
 
   async list(siteName: string, params?: V2PaginationParams): Promise<V2List<V2Collection>> {
-    return this.getList<V2Collection>(this.sitePath(siteName, 'collections'), params);
+    return this.getList<V2Collection>(this.sitePath(siteName, 'collections'), params, {
+      tags: [`collections:${siteName}`],
+    });
   }
 
   async getCurrent(siteName: string): Promise<V2Collection | null> {
@@ -27,17 +29,15 @@ export class CollectionsV2Client extends BaseV2Client {
 
   async create(siteName: string, data: V2CollectionCreateParams): Promise<V2Collection> {
     const result = await this.post<V2Collection>(this.sitePath(siteName, 'collections'), data);
-    await this.invalidateCache({ keys: [this.sitePath(siteName, 'collections')] });
+    await this.invalidateCache({ tags: [`collections:${siteName}`] });
     return result;
   }
 
   async update(siteName: string, id: string, data: V2CollectionUpdateParams): Promise<V2Collection> {
     const result = await this.patchOne<V2Collection>(this.sitePath(siteName, 'collections', id), data);
     await this.invalidateCache({
-      keys: [
-        this.sitePath(siteName, 'collections'),
-        this.sitePath(siteName, 'collections', id),
-      ],
+      tags: [`collections:${siteName}`],
+      keys: [this.sitePath(siteName, 'collections', id)],
     });
     return result;
   }
@@ -45,10 +45,8 @@ export class CollectionsV2Client extends BaseV2Client {
   async del(siteName: string, id: string): Promise<V2Deleted> {
     const result = await this.deleteOne(this.sitePath(siteName, 'collections', id));
     await this.invalidateCache({
-      keys: [
-        this.sitePath(siteName, 'collections'),
-        this.sitePath(siteName, 'collections', id),
-      ],
+      tags: [`collections:${siteName}`],
+      keys: [this.sitePath(siteName, 'collections', id)],
     });
     return result;
   }

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

@@ -9,6 +9,7 @@
  */
 
 import { BaseV2Client } from './base-v2-client';
+import type { CachePolicy } from '../../cache/types';
 import type {
   V2SiteUser,
   V2SiteUserUpdateParams,
@@ -91,9 +92,11 @@ export class SiteUsersV2Client extends BaseV2Client {
   }
 
   /** Fetch the profile KV map as a dedicated `site_user_profile` envelope. */
-  async getProfile(siteName: string): Promise<V2SiteUserProfile> {
+  async getProfile(siteName: string, cachePolicy?: CachePolicy): Promise<V2SiteUserProfile> {
     return this.getOne<V2SiteUserProfile>(
       this.sitePath(siteName, 'users', 'me/profile'),
+      undefined,
+      cachePolicy,
     );
   }
 

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

@@ -7,6 +7,7 @@
  */
 
 import { BaseV2Client } from './base-v2-client';
+import type { CachePolicy } from '../../cache/types';
 import type {
   V2SiteUserSubscription,
   V2SubscriptionPauseParams,
@@ -23,9 +24,12 @@ export class SubscriptionsV2Client extends BaseV2Client {
   /** List all subscriptions for the authenticated user. */
   async listMySubscriptions(
     siteName: string,
+    cachePolicy?: CachePolicy,
   ): Promise<V2List<V2SiteUserSubscription>> {
     return this.getList<V2SiteUserSubscription>(
       this.sitePath(siteName, 'users', 'me/subscriptions'),
+      undefined,
+      cachePolicy,
     );
   }
 
@@ -81,9 +85,12 @@ export class SubscriptionsV2Client extends BaseV2Client {
   async listUserSubscriptions(
     siteName: string,
     userId: string,
+    cachePolicy?: CachePolicy,
   ): Promise<V2List<V2SiteUserSubscription>> {
     return this.getList<V2SiteUserSubscription>(
       this.sitePath(siteName, 'users', `${userId}/subscriptions`),
+      undefined,
+      cachePolicy,
     );
   }