perspectapi-ts-sdk 2.5.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

@@ -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)
     );
@@ -992,6 +993,17 @@ var ContentClient = class extends BaseClient {
     }
     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
@@ -1277,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)
     );
@@ -1320,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)
     );
@@ -1439,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

@@ -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)
     );
@@ -931,6 +932,17 @@ var ContentClient = class extends BaseClient {
     }
     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
@@ -1216,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)
     );
@@ -1259,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)
     );
@@ -1378,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.5.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

@@ -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)
     );
@@ -245,4 +246,16 @@ export class ContentClient extends BaseClient {
     }
     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;
+  }
 }