perspectapi-ts-sdk 2.4.0 → 2.6.0

package/dist/index.d.mts

@@ -828,6 +828,11 @@ declare class ContentClient extends BaseClient {
      */
     duplicateContent(id: number): Promise<ApiResponse<Content>>;
     private buildContentTags;
+    /**
+     * Extract the prefix from a slug (first segment before '/')
+     * e.g., 'blog/my-post' -> 'blog', 'about' -> undefined
+     */
+    private extractSlugPrefix;
 }
 
 /**
@@ -1226,6 +1231,11 @@ declare class ProductsClient extends BaseClient {
         };
     }>>;
     private buildProductTags;
+    /**
+     * Extract the prefix from a slug (first segment before '/')
+     * e.g., 'shop/shoes/nike-air' -> 'shop', 'product-name' -> undefined
+     */
+    private extractSlugPrefix;
 }
 
 /**

package/dist/index.d.ts

@@ -828,6 +828,11 @@ declare class ContentClient extends BaseClient {
      */
     duplicateContent(id: number): Promise<ApiResponse<Content>>;
     private buildContentTags;
+    /**
+     * Extract the prefix from a slug (first segment before '/')
+     * e.g., 'blog/my-post' -> 'blog', 'about' -> undefined
+     */
+    private extractSlugPrefix;
 }
 
 /**
@@ -1226,6 +1231,11 @@ declare class ProductsClient extends BaseClient {
         };
     }>>;
     private buildProductTags;
+    /**
+     * Extract the prefix from a slug (first segment before '/')
+     * e.g., 'shop/shoes/nike-air' -> 'shop', 'product-name' -> undefined
+     */
+    private extractSlugPrefix;
 }
 
 /**

package/dist/index.js

@@ -850,12 +850,12 @@ var ContentClient = class extends BaseClient {
     console.log("[PerspectAPI Content] Cache details:", {
       cacheEnabled: !!this.cache,
       cachePolicy,
-      tags: this.buildContentTags(siteName)
+      tags: this.buildContentTags(siteName, void 0, void 0, normalizedParams?.slug_prefix)
     });
     const result = await this.fetchWithCache(
       endpoint,
       normalizedParams,
-      this.buildContentTags(siteName),
+      this.buildContentTags(siteName, void 0, void 0, normalizedParams?.slug_prefix),
       cachePolicy,
       async () => {
         console.log("[PerspectAPI Content] Making HTTP request:", {
@@ -908,10 +908,11 @@ var ContentClient = class extends BaseClient {
   async getContentBySlug(siteName, slug, cachePolicy) {
     const endpoint = this.siteScopedEndpoint(siteName, `/slug/${encodeURIComponent(slug)}`);
     const path = this.buildPath(endpoint);
+    const slugPrefix = this.extractSlugPrefix(slug);
     return this.fetchWithCache(
       endpoint,
       void 0,
-      this.buildContentTags(siteName, slug),
+      this.buildContentTags(siteName, slug, void 0, slugPrefix),
       cachePolicy,
       () => this.http.get(path)
     );
@@ -976,7 +977,7 @@ var ContentClient = class extends BaseClient {
   async duplicateContent(id) {
     return this.create(`/content/${id}/duplicate`, {});
   }
-  buildContentTags(siteName, slug, id) {
+  buildContentTags(siteName, slug, id, slugPrefix) {
     const tags = /* @__PURE__ */ new Set(["content"]);
     if (siteName) {
       tags.add(`content:site:${siteName}`);
@@ -987,8 +988,22 @@ var ContentClient = class extends BaseClient {
     if (typeof id === "number") {
       tags.add(`content:id:${id}`);
     }
+    if (slugPrefix) {
+      tags.add(`content:prefix:${slugPrefix}`);
+    }
     return Array.from(tags.values());
   }
+  /**
+   * Extract the prefix from a slug (first segment before '/')
+   * e.g., 'blog/my-post' -> 'blog', 'about' -> undefined
+   */
+  extractSlugPrefix(slug) {
+    const slashIndex = slug.indexOf("/");
+    if (slashIndex > 0) {
+      return slug.substring(0, slashIndex);
+    }
+    return void 0;
+  }
 };
 
 // src/client/api-keys-client.ts
@@ -1274,7 +1289,7 @@ var ProductsClient = class extends BaseClient {
     return this.fetchWithCache(
       endpoint,
       normalizedParams,
-      this.buildProductTags(siteName, ["products:list"]),
+      this.buildProductTags(siteName, ["products:list"], normalizedParams?.slug_prefix),
       cachePolicy,
       () => this.http.get(path, normalizedParams)
     );
@@ -1317,10 +1332,11 @@ var ProductsClient = class extends BaseClient {
       { includeSitesSegment: false }
     );
     const path = this.buildPath(endpoint);
+    const slugPrefix = this.extractSlugPrefix(slug);
     return this.fetchWithCache(
       endpoint,
       void 0,
-      this.buildProductTags(siteName, [`products:slug:${siteName}:${slug}`]),
+      this.buildProductTags(siteName, [`products:slug:${siteName}:${slug}`], slugPrefix),
       cachePolicy,
       () => this.http.get(path)
     );
@@ -1436,14 +1452,28 @@ var ProductsClient = class extends BaseClient {
       () => this.http.get(path, queryParams)
     );
   }
-  buildProductTags(siteName, extraTags = []) {
+  buildProductTags(siteName, extraTags = [], slugPrefix) {
     const tags = /* @__PURE__ */ new Set(["products"]);
     if (siteName) {
       tags.add(`products:site:${siteName}`);
     }
+    if (slugPrefix) {
+      tags.add(`products:prefix:${slugPrefix}`);
+    }
     extraTags.filter(Boolean).forEach((tag) => tags.add(tag));
     return Array.from(tags.values());
   }
+  /**
+   * Extract the prefix from a slug (first segment before '/')
+   * e.g., 'shop/shoes/nike-air' -> 'shop', 'product-name' -> undefined
+   */
+  extractSlugPrefix(slug) {
+    const slashIndex = slug.indexOf("/");
+    if (slashIndex > 0) {
+      return slug.substring(0, slashIndex);
+    }
+    return void 0;
+  }
 };
 
 // src/client/categories-client.ts

package/dist/index.mjs

@@ -789,12 +789,12 @@ var ContentClient = class extends BaseClient {
     console.log("[PerspectAPI Content] Cache details:", {
       cacheEnabled: !!this.cache,
       cachePolicy,
-      tags: this.buildContentTags(siteName)
+      tags: this.buildContentTags(siteName, void 0, void 0, normalizedParams?.slug_prefix)
     });
     const result = await this.fetchWithCache(
       endpoint,
       normalizedParams,
-      this.buildContentTags(siteName),
+      this.buildContentTags(siteName, void 0, void 0, normalizedParams?.slug_prefix),
       cachePolicy,
       async () => {
         console.log("[PerspectAPI Content] Making HTTP request:", {
@@ -847,10 +847,11 @@ var ContentClient = class extends BaseClient {
   async getContentBySlug(siteName, slug, cachePolicy) {
     const endpoint = this.siteScopedEndpoint(siteName, `/slug/${encodeURIComponent(slug)}`);
     const path = this.buildPath(endpoint);
+    const slugPrefix = this.extractSlugPrefix(slug);
     return this.fetchWithCache(
       endpoint,
       void 0,
-      this.buildContentTags(siteName, slug),
+      this.buildContentTags(siteName, slug, void 0, slugPrefix),
       cachePolicy,
       () => this.http.get(path)
     );
@@ -915,7 +916,7 @@ var ContentClient = class extends BaseClient {
   async duplicateContent(id) {
     return this.create(`/content/${id}/duplicate`, {});
   }
-  buildContentTags(siteName, slug, id) {
+  buildContentTags(siteName, slug, id, slugPrefix) {
     const tags = /* @__PURE__ */ new Set(["content"]);
     if (siteName) {
       tags.add(`content:site:${siteName}`);
@@ -926,8 +927,22 @@ var ContentClient = class extends BaseClient {
     if (typeof id === "number") {
       tags.add(`content:id:${id}`);
     }
+    if (slugPrefix) {
+      tags.add(`content:prefix:${slugPrefix}`);
+    }
     return Array.from(tags.values());
   }
+  /**
+   * Extract the prefix from a slug (first segment before '/')
+   * e.g., 'blog/my-post' -> 'blog', 'about' -> undefined
+   */
+  extractSlugPrefix(slug) {
+    const slashIndex = slug.indexOf("/");
+    if (slashIndex > 0) {
+      return slug.substring(0, slashIndex);
+    }
+    return void 0;
+  }
 };
 
 // src/client/api-keys-client.ts
@@ -1213,7 +1228,7 @@ var ProductsClient = class extends BaseClient {
     return this.fetchWithCache(
       endpoint,
       normalizedParams,
-      this.buildProductTags(siteName, ["products:list"]),
+      this.buildProductTags(siteName, ["products:list"], normalizedParams?.slug_prefix),
       cachePolicy,
       () => this.http.get(path, normalizedParams)
     );
@@ -1256,10 +1271,11 @@ var ProductsClient = class extends BaseClient {
       { includeSitesSegment: false }
     );
     const path = this.buildPath(endpoint);
+    const slugPrefix = this.extractSlugPrefix(slug);
     return this.fetchWithCache(
       endpoint,
       void 0,
-      this.buildProductTags(siteName, [`products:slug:${siteName}:${slug}`]),
+      this.buildProductTags(siteName, [`products:slug:${siteName}:${slug}`], slugPrefix),
       cachePolicy,
       () => this.http.get(path)
     );
@@ -1375,14 +1391,28 @@ var ProductsClient = class extends BaseClient {
       () => this.http.get(path, queryParams)
     );
   }
-  buildProductTags(siteName, extraTags = []) {
+  buildProductTags(siteName, extraTags = [], slugPrefix) {
     const tags = /* @__PURE__ */ new Set(["products"]);
     if (siteName) {
       tags.add(`products:site:${siteName}`);
     }
+    if (slugPrefix) {
+      tags.add(`products:prefix:${slugPrefix}`);
+    }
     extraTags.filter(Boolean).forEach((tag) => tags.add(tag));
     return Array.from(tags.values());
   }
+  /**
+   * Extract the prefix from a slug (first segment before '/')
+   * e.g., 'shop/shoes/nike-air' -> 'shop', 'product-name' -> undefined
+   */
+  extractSlugPrefix(slug) {
+    const slashIndex = slug.indexOf("/");
+    if (slashIndex > 0) {
+      return slug.substring(0, slashIndex);
+    }
+    return void 0;
+  }
 };
 
 // src/client/categories-client.ts

package/package.json

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

package/src/client/content-client.ts

@@ -76,13 +76,13 @@ export class ContentClient extends BaseClient {
     console.log('[PerspectAPI Content] Cache details:', {
       cacheEnabled: !!this.cache,
       cachePolicy,
-      tags: this.buildContentTags(siteName)
+      tags: this.buildContentTags(siteName, undefined, undefined, normalizedParams?.slug_prefix)
     });
 
     const result = await this.fetchWithCache<PaginatedResponse<Content>>(
       endpoint,
       normalizedParams,
-      this.buildContentTags(siteName),
+      this.buildContentTags(siteName, undefined, undefined, normalizedParams?.slug_prefix),
       cachePolicy,
       async () => {
         console.log('[PerspectAPI Content] Making HTTP request:', {
@@ -149,11 +149,12 @@ export class ContentClient extends BaseClient {
   ): Promise<ApiResponse<Content>> {
     const endpoint = this.siteScopedEndpoint(siteName, `/slug/${encodeURIComponent(slug)}`);
     const path = this.buildPath(endpoint);
+    const slugPrefix = this.extractSlugPrefix(slug);
 
     return this.fetchWithCache<ApiResponse<Content>>(
       endpoint,
       undefined,
-      this.buildContentTags(siteName, slug),
+      this.buildContentTags(siteName, slug, undefined, slugPrefix),
       cachePolicy,
       () => this.http.get<Content>(path)
     );
@@ -229,7 +230,7 @@ export class ContentClient extends BaseClient {
     return this.create<Record<string, never>, Content>(`/content/${id}/duplicate`, {});
   }
 
-  private buildContentTags(siteName?: string, slug?: string, id?: number): string[] {
+  private buildContentTags(siteName?: string, slug?: string, id?: number, slugPrefix?: string): string[] {
     const tags = new Set<string>(['content']);
     if (siteName) {
       tags.add(`content:site:${siteName}`);
@@ -240,6 +241,21 @@ export class ContentClient extends BaseClient {
     if (typeof id === 'number') {
       tags.add(`content:id:${id}`);
     }
+    if (slugPrefix) {
+      tags.add(`content:prefix:${slugPrefix}`);
+    }
     return Array.from(tags.values());
   }
+
+  /**
+   * Extract the prefix from a slug (first segment before '/')
+   * e.g., 'blog/my-post' -> 'blog', 'about' -> undefined
+   */
+  private extractSlugPrefix(slug: string): string | undefined {
+    const slashIndex = slug.indexOf('/');
+    if (slashIndex > 0) {
+      return slug.substring(0, slashIndex);
+    }
+    return undefined;
+  }
 }

package/src/client/products-client.ts

@@ -73,7 +73,7 @@ export class ProductsClient extends BaseClient {
     return this.fetchWithCache<PaginatedResponse<Product>>(
       endpoint,
       normalizedParams,
-      this.buildProductTags(siteName, ['products:list']),
+      this.buildProductTags(siteName, ['products:list'], normalizedParams?.slug_prefix),
       cachePolicy,
       () => this.http.get(path, normalizedParams) as Promise<PaginatedResponse<Product>>
     );
@@ -125,11 +125,12 @@ export class ProductsClient extends BaseClient {
       { includeSitesSegment: false }
     );
     const path = this.buildPath(endpoint);
+    const slugPrefix = this.extractSlugPrefix(slug);
 
     return this.fetchWithCache<ApiResponse<Product & { variants?: any[] }>>(
       endpoint,
       undefined,
-      this.buildProductTags(siteName, [`products:slug:${siteName}:${slug}`]),
+      this.buildProductTags(siteName, [`products:slug:${siteName}:${slug}`], slugPrefix),
       cachePolicy,
       () => this.http.get<Product & { variants?: any[] }>(path)
     );
@@ -347,12 +348,27 @@ export class ProductsClient extends BaseClient {
     );
   }
 
-  private buildProductTags(siteName?: string, extraTags: string[] = []): string[] {
+  private buildProductTags(siteName?: string, extraTags: string[] = [], slugPrefix?: string): string[] {
     const tags = new Set<string>(['products']);
     if (siteName) {
       tags.add(`products:site:${siteName}`);
     }
+    if (slugPrefix) {
+      tags.add(`products:prefix:${slugPrefix}`);
+    }
     extraTags.filter(Boolean).forEach(tag => tags.add(tag));
     return Array.from(tags.values());
   }
+
+  /**
+   * Extract the prefix from a slug (first segment before '/')
+   * e.g., 'shop/shoes/nike-air' -> 'shop', 'product-name' -> undefined
+   */
+  private extractSlugPrefix(slug: string): string | undefined {
+    const slashIndex = slug.indexOf('/');
+    if (slashIndex > 0) {
+      return slug.substring(0, slashIndex);
+    }
+    return undefined;
+  }
 }