@proveanything/smartlinks 1.3.3 → 1.3.4

package/dist/api/tags.d.ts

@@ -128,10 +128,11 @@ export declare namespace tags {
      */
     function list(collectionId: string, params?: ListTagsRequest): Promise<ListTagsResponse>;
     /**
-     * Public lookup of a single tag by tagId.
+     * Public lookup of a single tag by tagId within a specific collection.
      * Optionally embed related collection, product, or proof data.
      * No authentication required.
      *
+     * @param collectionId - Identifier of the collection to search within
      * @param tagId - Unique tag identifier
      * @param params - Optional parameters (embed)
      * @returns Promise resolving to a PublicGetTagResponse with optional embedded data
@@ -140,28 +141,30 @@ export declare namespace tags {
      * @example
      * ```typescript
      * // Simple lookup
-     * const result = await tags.publicGet('TAG001')
+     * const result = await tags.publicGet('coll_123', 'TAG001')
      *
      * // With embedded data
-     * const withData = await tags.publicGet('TAG001', {
+     * const withData = await tags.publicGet('coll_123', 'TAG001', {
      *   embed: 'collection,product,proof'
      * })
      * console.log(withData.tag, withData.collection, withData.product, withData.proof)
      * ```
      */
-    function publicGet(tagId: string, params?: PublicGetTagRequest): Promise<PublicGetTagResponse>;
+    function publicGet(collectionId: string, tagId: string, params?: PublicGetTagRequest): Promise<PublicGetTagResponse>;
     /**
      * Public batch lookup of multiple tags in a single request (POST).
+     * Only returns tags from the specified collection.
      * Optionally embed related data. Related data is deduplicated and batch-fetched.
      * No authentication required.
      *
+     * @param collectionId - Identifier of the collection to search within
      * @param data - Request containing array of tagIds and optional embed parameter
      * @returns Promise resolving to PublicBatchLookupResponse with deduplicated related data
      * @throws ErrorResponse if the request fails
      *
      * @example
      * ```typescript
-     * const result = await tags.publicBatchLookup({
+     * const result = await tags.publicBatchLookup('coll_123', {
      *   tagIds: ['TAG001', 'TAG002', 'TAG003'],
      *   embed: 'collection,product'
      * })
@@ -172,23 +175,25 @@ export declare namespace tags {
      * console.log(result.products)
      * ```
      */
-    function publicBatchLookup(data: PublicBatchLookupRequest): Promise<PublicBatchLookupResponse>;
+    function publicBatchLookup(collectionId: string, data: PublicBatchLookupRequest): Promise<PublicBatchLookupResponse>;
     /**
      * Public batch lookup of multiple tags using query parameters (GET).
+     * Only returns tags from the specified collection.
      * Alternative to publicBatchLookup for simple GET requests.
      * No authentication required.
      *
+     * @param collectionId - Identifier of the collection to search within
      * @param params - Query parameters with comma-separated tagIds and optional embed
      * @returns Promise resolving to PublicBatchLookupQueryResponse
      * @throws ErrorResponse if the request fails
      *
      * @example
      * ```typescript
-     * const result = await tags.publicBatchLookupQuery({
+     * const result = await tags.publicBatchLookupQuery('coll_123', {
      *   tagIds: 'TAG001,TAG002,TAG003',
      *   embed: 'collection'
      * })
      * ```
      */
-    function publicBatchLookupQuery(params: PublicBatchLookupQueryRequest): Promise<PublicBatchLookupQueryResponse>;
+    function publicBatchLookupQuery(collectionId: string, params: PublicBatchLookupQueryRequest): Promise<PublicBatchLookupQueryResponse>;
 }

package/dist/api/tags.js

@@ -172,10 +172,11 @@ export var tags;
     // Public Endpoints
     // ============================================================================
     /**
-     * Public lookup of a single tag by tagId.
+     * Public lookup of a single tag by tagId within a specific collection.
      * Optionally embed related collection, product, or proof data.
      * No authentication required.
      *
+     * @param collectionId - Identifier of the collection to search within
      * @param tagId - Unique tag identifier
      * @param params - Optional parameters (embed)
      * @returns Promise resolving to a PublicGetTagResponse with optional embedded data
@@ -184,36 +185,38 @@ export var tags;
      * @example
      * ```typescript
      * // Simple lookup
-     * const result = await tags.publicGet('TAG001')
+     * const result = await tags.publicGet('coll_123', 'TAG001')
      *
      * // With embedded data
-     * const withData = await tags.publicGet('TAG001', {
+     * const withData = await tags.publicGet('coll_123', 'TAG001', {
      *   embed: 'collection,product,proof'
      * })
      * console.log(withData.tag, withData.collection, withData.product, withData.proof)
      * ```
      */
-    async function publicGet(tagId, params) {
+    async function publicGet(collectionId, tagId, params) {
         const queryParams = new URLSearchParams();
         if (params === null || params === void 0 ? void 0 : params.embed)
             queryParams.append('embed', params.embed);
         const query = queryParams.toString();
-        const path = `/public/tags/${encodeURIComponent(tagId)}${query ? `?${query}` : ''}`;
+        const path = `/public/collection/${encodeURIComponent(collectionId)}/tags/${encodeURIComponent(tagId)}${query ? `?${query}` : ''}`;
         return request(path);
     }
     tags.publicGet = publicGet;
     /**
      * Public batch lookup of multiple tags in a single request (POST).
+     * Only returns tags from the specified collection.
      * Optionally embed related data. Related data is deduplicated and batch-fetched.
      * No authentication required.
      *
+     * @param collectionId - Identifier of the collection to search within
      * @param data - Request containing array of tagIds and optional embed parameter
      * @returns Promise resolving to PublicBatchLookupResponse with deduplicated related data
      * @throws ErrorResponse if the request fails
      *
      * @example
      * ```typescript
-     * const result = await tags.publicBatchLookup({
+     * const result = await tags.publicBatchLookup('coll_123', {
      *   tagIds: ['TAG001', 'TAG002', 'TAG003'],
      *   embed: 'collection,product'
      * })
@@ -224,34 +227,36 @@ export var tags;
      * console.log(result.products)
      * ```
      */
-    async function publicBatchLookup(data) {
-        const path = `/public/tags/lookup`;
+    async function publicBatchLookup(collectionId, data) {
+        const path = `/public/collection/${encodeURIComponent(collectionId)}/tags/lookup`;
         return post(path, data);
     }
     tags.publicBatchLookup = publicBatchLookup;
     /**
      * Public batch lookup of multiple tags using query parameters (GET).
+     * Only returns tags from the specified collection.
      * Alternative to publicBatchLookup for simple GET requests.
      * No authentication required.
      *
+     * @param collectionId - Identifier of the collection to search within
      * @param params - Query parameters with comma-separated tagIds and optional embed
      * @returns Promise resolving to PublicBatchLookupQueryResponse
      * @throws ErrorResponse if the request fails
      *
      * @example
      * ```typescript
-     * const result = await tags.publicBatchLookupQuery({
+     * const result = await tags.publicBatchLookupQuery('coll_123', {
      *   tagIds: 'TAG001,TAG002,TAG003',
      *   embed: 'collection'
      * })
      * ```
      */
-    async function publicBatchLookupQuery(params) {
+    async function publicBatchLookupQuery(collectionId, params) {
         const queryParams = new URLSearchParams();
         queryParams.append('tagIds', params.tagIds);
         if (params.embed)
             queryParams.append('embed', params.embed);
-        const path = `/public/tags/lookup?${queryParams.toString()}`;
+        const path = `/public/collection/${encodeURIComponent(collectionId)}/tags/lookup?${queryParams.toString()}`;
         return request(path);
     }
     tags.publicBatchLookupQuery = publicBatchLookupQuery;

package/dist/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.3.3  |  Generated: 2026-02-02T14:12:19.424Z
+Version: 1.3.4  |  Generated: 2026-02-02T14:36:48.206Z
 
 This is a concise summary of all available API functions and types.
 
@@ -3506,15 +3506,18 @@ Get a single tag mapping by tagId. ```typescript const tag = await tags.get('col
     params?: ListTagsRequest) → `Promise<ListTagsResponse>`
 List all tags for a collection with optional filters and pagination. ```typescript // List all tags const all = await tags.list('coll_123') // List with filters const filtered = await tags.list('coll_123', { productId: 'prod_456', variantId: 'var_789', limit: 50, offset: 0 }) ```
 
-**publicGet**(tagId: string,
+**publicGet**(collectionId: string,
+    tagId: string,
     params?: PublicGetTagRequest) → `Promise<PublicGetTagResponse>`
-Public lookup of a single tag by tagId. Optionally embed related collection, product, or proof data. No authentication required. ```typescript // Simple lookup const result = await tags.publicGet('TAG001') // With embedded data const withData = await tags.publicGet('TAG001', { embed: 'collection,product,proof' }) console.log(withData.tag, withData.collection, withData.product, withData.proof) ```
+Public lookup of a single tag by tagId within a specific collection. Optionally embed related collection, product, or proof data. No authentication required. ```typescript // Simple lookup const result = await tags.publicGet('coll_123', 'TAG001') // With embedded data const withData = await tags.publicGet('coll_123', 'TAG001', { embed: 'collection,product,proof' }) console.log(withData.tag, withData.collection, withData.product, withData.proof) ```
 
-**publicBatchLookup**(data: PublicBatchLookupRequest) → `Promise<PublicBatchLookupResponse>`
-Public batch lookup of multiple tags in a single request (POST). Optionally embed related data. Related data is deduplicated and batch-fetched. No authentication required. ```typescript const result = await tags.publicBatchLookup({ tagIds: ['TAG001', 'TAG002', 'TAG003'], embed: 'collection,product' }) // Access tags and deduplicated collections/products console.log(result.tags['TAG001']) console.log(result.collections) console.log(result.products) ```
+**publicBatchLookup**(collectionId: string,
+    data: PublicBatchLookupRequest) → `Promise<PublicBatchLookupResponse>`
+Public batch lookup of multiple tags in a single request (POST). Only returns tags from the specified collection. Optionally embed related data. Related data is deduplicated and batch-fetched. No authentication required. ```typescript const result = await tags.publicBatchLookup('coll_123', { tagIds: ['TAG001', 'TAG002', 'TAG003'], embed: 'collection,product' }) // Access tags and deduplicated collections/products console.log(result.tags['TAG001']) console.log(result.collections) console.log(result.products) ```
 
-**publicBatchLookupQuery**(params: PublicBatchLookupQueryRequest) → `Promise<PublicBatchLookupQueryResponse>`
-Public batch lookup of multiple tags using query parameters (GET). Alternative to publicBatchLookup for simple GET requests. No authentication required. ```typescript const result = await tags.publicBatchLookupQuery({ tagIds: 'TAG001,TAG002,TAG003', embed: 'collection' }) ```
+**publicBatchLookupQuery**(collectionId: string,
+    params: PublicBatchLookupQueryRequest) → `Promise<PublicBatchLookupQueryResponse>`
+Public batch lookup of multiple tags using query parameters (GET). Only returns tags from the specified collection. Alternative to publicBatchLookup for simple GET requests. No authentication required. ```typescript const result = await tags.publicBatchLookupQuery('coll_123', { tagIds: 'TAG001,TAG002,TAG003', embed: 'collection' }) ```
 
 ### template
 

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.3.3  |  Generated: 2026-02-02T14:13:32.582Z
+Version: 1.3.4  |  Generated: 2026-02-02T14:37:47.335Z
 
 This is a concise summary of all available API functions and types.
 
@@ -3506,15 +3506,18 @@ Get a single tag mapping by tagId. ```typescript const tag = await tags.get('col
     params?: ListTagsRequest) → `Promise<ListTagsResponse>`
 List all tags for a collection with optional filters and pagination. ```typescript // List all tags const all = await tags.list('coll_123') // List with filters const filtered = await tags.list('coll_123', { productId: 'prod_456', variantId: 'var_789', limit: 50, offset: 0 }) ```
 
-**publicGet**(tagId: string,
+**publicGet**(collectionId: string,
+    tagId: string,
     params?: PublicGetTagRequest) → `Promise<PublicGetTagResponse>`
-Public lookup of a single tag by tagId. Optionally embed related collection, product, or proof data. No authentication required. ```typescript // Simple lookup const result = await tags.publicGet('TAG001') // With embedded data const withData = await tags.publicGet('TAG001', { embed: 'collection,product,proof' }) console.log(withData.tag, withData.collection, withData.product, withData.proof) ```
+Public lookup of a single tag by tagId within a specific collection. Optionally embed related collection, product, or proof data. No authentication required. ```typescript // Simple lookup const result = await tags.publicGet('coll_123', 'TAG001') // With embedded data const withData = await tags.publicGet('coll_123', 'TAG001', { embed: 'collection,product,proof' }) console.log(withData.tag, withData.collection, withData.product, withData.proof) ```
 
-**publicBatchLookup**(data: PublicBatchLookupRequest) → `Promise<PublicBatchLookupResponse>`
-Public batch lookup of multiple tags in a single request (POST). Optionally embed related data. Related data is deduplicated and batch-fetched. No authentication required. ```typescript const result = await tags.publicBatchLookup({ tagIds: ['TAG001', 'TAG002', 'TAG003'], embed: 'collection,product' }) // Access tags and deduplicated collections/products console.log(result.tags['TAG001']) console.log(result.collections) console.log(result.products) ```
+**publicBatchLookup**(collectionId: string,
+    data: PublicBatchLookupRequest) → `Promise<PublicBatchLookupResponse>`
+Public batch lookup of multiple tags in a single request (POST). Only returns tags from the specified collection. Optionally embed related data. Related data is deduplicated and batch-fetched. No authentication required. ```typescript const result = await tags.publicBatchLookup('coll_123', { tagIds: ['TAG001', 'TAG002', 'TAG003'], embed: 'collection,product' }) // Access tags and deduplicated collections/products console.log(result.tags['TAG001']) console.log(result.collections) console.log(result.products) ```
 
-**publicBatchLookupQuery**(params: PublicBatchLookupQueryRequest) → `Promise<PublicBatchLookupQueryResponse>`
-Public batch lookup of multiple tags using query parameters (GET). Alternative to publicBatchLookup for simple GET requests. No authentication required. ```typescript const result = await tags.publicBatchLookupQuery({ tagIds: 'TAG001,TAG002,TAG003', embed: 'collection' }) ```
+**publicBatchLookupQuery**(collectionId: string,
+    params: PublicBatchLookupQueryRequest) → `Promise<PublicBatchLookupQueryResponse>`
+Public batch lookup of multiple tags using query parameters (GET). Only returns tags from the specified collection. Alternative to publicBatchLookup for simple GET requests. No authentication required. ```typescript const result = await tags.publicBatchLookupQuery('coll_123', { tagIds: 'TAG001,TAG002,TAG003', embed: 'collection' }) ```
 
 ### template
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proveanything/smartlinks",
-  "version": "1.3.3",
+  "version": "1.3.4",
   "description": "Official JavaScript/TypeScript SDK for the Smartlinks API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",