@proveanything/smartlinks 1.3.4 → 1.3.6

package/dist/api/tags.d.ts

@@ -128,12 +128,11 @@ export declare namespace tags {
      */
     function list(collectionId: string, params?: ListTagsRequest): Promise<ListTagsResponse>;
     /**
-     * Public lookup of a single tag by tagId within a specific collection.
+     * Public lookup of a single tag by tagId (global).
      * 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 tagId - Unique tag identifier (globally unique)
      * @param params - Optional parameters (embed)
      * @returns Promise resolving to a PublicGetTagResponse with optional embedded data
      * @throws ErrorResponse if the request fails
@@ -141,16 +140,21 @@ export declare namespace tags {
      * @example
      * ```typescript
      * // Simple lookup
-     * const result = await tags.publicGet('coll_123', 'TAG001')
+     * const result = await tags.getTag('TAG001')
      *
      * // With embedded data
-     * const withData = await tags.publicGet('coll_123', 'TAG001', {
+     * const withData = await tags.getTag('TAG001', {
      *   embed: 'collection,product,proof'
      * })
      * console.log(withData.tag, withData.collection, withData.product, withData.proof)
      * ```
      */
-    function publicGet(collectionId: string, tagId: string, params?: PublicGetTagRequest): Promise<PublicGetTagResponse>;
+    function getTag(tagId: string, params?: PublicGetTagRequest): Promise<PublicGetTagResponse>;
+    /**
+     * Backward-compat: Public lookup with collectionId parameter (ignored).
+     * Calls global route under /public/tags/:tagId.
+     */
+    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.
@@ -175,7 +179,12 @@ export declare namespace tags {
      * console.log(result.products)
      * ```
      */
-    function publicBatchLookup(collectionId: string, data: PublicBatchLookupRequest): Promise<PublicBatchLookupResponse>;
+    function lookupTags(data: PublicBatchLookupRequest): Promise<PublicBatchLookupResponse>;
+    /**
+     * Backward-compat: Public batch lookup with collectionId parameter (ignored).
+     * Calls global route under /public/tags/lookup.
+     */
+    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.
@@ -195,5 +204,10 @@ export declare namespace tags {
      * })
      * ```
      */
-    function publicBatchLookupQuery(collectionId: string, params: PublicBatchLookupQueryRequest): Promise<PublicBatchLookupQueryResponse>;
+    function lookupTagsQuery(params: PublicBatchLookupQueryRequest): Promise<PublicBatchLookupQueryResponse>;
+    /**
+     * Backward-compat: Public batch lookup (GET) with collectionId parameter (ignored).
+     * Calls global route under /public/tags/lookup.
+     */
+    function publicBatchLookupQuery(_collectionId: string, params: PublicBatchLookupQueryRequest): Promise<PublicBatchLookupQueryResponse>;
 }

package/dist/api/tags.js

@@ -172,12 +172,11 @@ export var tags;
     // Public Endpoints
     // ============================================================================
     /**
-     * Public lookup of a single tag by tagId within a specific collection.
+     * Public lookup of a single tag by tagId (global).
      * 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 tagId - Unique tag identifier (globally unique)
      * @param params - Optional parameters (embed)
      * @returns Promise resolving to a PublicGetTagResponse with optional embedded data
      * @throws ErrorResponse if the request fails
@@ -185,23 +184,31 @@ export var tags;
      * @example
      * ```typescript
      * // Simple lookup
-     * const result = await tags.publicGet('coll_123', 'TAG001')
+     * const result = await tags.getTag('TAG001')
      *
      * // With embedded data
-     * const withData = await tags.publicGet('coll_123', 'TAG001', {
+     * const withData = await tags.getTag('TAG001', {
      *   embed: 'collection,product,proof'
      * })
      * console.log(withData.tag, withData.collection, withData.product, withData.proof)
      * ```
      */
-    async function publicGet(collectionId, tagId, params) {
+    async function getTag(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/collection/${encodeURIComponent(collectionId)}/tags/${encodeURIComponent(tagId)}${query ? `?${query}` : ''}`;
+        const path = `/public/tags/${encodeURIComponent(tagId)}${query ? `?${query}` : ''}`;
         return request(path);
     }
+    tags.getTag = getTag;
+    /**
+     * Backward-compat: Public lookup with collectionId parameter (ignored).
+     * Calls global route under /public/tags/:tagId.
+     */
+    async function publicGet(_collectionId, tagId, params) {
+        return getTag(tagId, params);
+    }
     tags.publicGet = publicGet;
     /**
      * Public batch lookup of multiple tags in a single request (POST).
@@ -227,10 +234,18 @@ export var tags;
      * console.log(result.products)
      * ```
      */
-    async function publicBatchLookup(collectionId, data) {
-        const path = `/public/collection/${encodeURIComponent(collectionId)}/tags/lookup`;
+    async function lookupTags(data) {
+        const path = `/public/tags/lookup`;
         return post(path, data);
     }
+    tags.lookupTags = lookupTags;
+    /**
+     * Backward-compat: Public batch lookup with collectionId parameter (ignored).
+     * Calls global route under /public/tags/lookup.
+     */
+    async function publicBatchLookup(_collectionId, data) {
+        return lookupTags(data);
+    }
     tags.publicBatchLookup = publicBatchLookup;
     /**
      * Public batch lookup of multiple tags using query parameters (GET).
@@ -251,13 +266,21 @@ export var tags;
      * })
      * ```
      */
-    async function publicBatchLookupQuery(collectionId, params) {
+    async function lookupTagsQuery(params) {
         const queryParams = new URLSearchParams();
         queryParams.append('tagIds', params.tagIds);
         if (params.embed)
             queryParams.append('embed', params.embed);
-        const path = `/public/collection/${encodeURIComponent(collectionId)}/tags/lookup?${queryParams.toString()}`;
+        const path = `/public/tags/lookup?${queryParams.toString()}`;
         return request(path);
     }
+    tags.lookupTagsQuery = lookupTagsQuery;
+    /**
+     * Backward-compat: Public batch lookup (GET) with collectionId parameter (ignored).
+     * Calls global route under /public/tags/lookup.
+     */
+    async function publicBatchLookupQuery(_collectionId, params) {
+        return lookupTagsQuery(params);
+    }
     tags.publicBatchLookupQuery = publicBatchLookupQuery;
 })(tags || (tags = {}));

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.3.4  |  Generated: 2026-02-02T14:37:47.335Z
+Version: 1.3.6  |  Generated: 2026-02-04T13:17:46.204Z
 
 This is a concise summary of all available API functions and types.
 
@@ -3506,19 +3506,29 @@ 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**(collectionId: string,
+**getTag**(tagId: string,
+    params?: PublicGetTagRequest) → `Promise<PublicGetTagResponse>`
+Public lookup of a single tag by tagId (global). Optionally embed related collection, product, or proof data. No authentication required. ```typescript // Simple lookup const result = await tags.getTag('TAG001') // With embedded data const withData = await tags.getTag('TAG001', { embed: 'collection,product,proof' }) console.log(withData.tag, withData.collection, withData.product, withData.proof) ```
+
+**publicGet**(_collectionId: string,
     tagId: string,
     params?: PublicGetTagRequest) → `Promise<PublicGetTagResponse>`
-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) ```
+Backward-compat: Public lookup with collectionId parameter (ignored). Calls global route under /public/tags/:tagId.
 
-**publicBatchLookup**(collectionId: string,
-    data: PublicBatchLookupRequest) → `Promise<PublicBatchLookupResponse>`
+**lookupTags**(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**(collectionId: string,
-    params: PublicBatchLookupQueryRequest) → `Promise<PublicBatchLookupQueryResponse>`
+**publicBatchLookup**(_collectionId: string,
+    data: PublicBatchLookupRequest) → `Promise<PublicBatchLookupResponse>`
+Backward-compat: Public batch lookup with collectionId parameter (ignored). Calls global route under /public/tags/lookup.
+
+**lookupTagsQuery**(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' }) ```
 
+**publicBatchLookupQuery**(_collectionId: string,
+    params: PublicBatchLookupQueryRequest) → `Promise<PublicBatchLookupQueryResponse>`
+Backward-compat: Public batch lookup (GET) with collectionId parameter (ignored). Calls global route under /public/tags/lookup.
+
 ### template
 
 **getAll**(collectionId: string) → `Promise<Template[]>`

package/package.json

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