@proveanything/smartlinks 1.3.2 → 1.3.4

package/dist/api/contact.d.ts

@@ -19,6 +19,18 @@ export declare namespace contact {
     function publicUpsert(collectionId: string, data: PublicContactUpsertRequest): Promise<PublicContactUpsertResponse>;
     function publicGetMine(collectionId: string): Promise<PublicGetMyContactResponse>;
     function publicUpdateMine(collectionId: string, data: ContactPatch): Promise<PublicUpdateMyContactResponse>;
+    /**
+     * Public: Get contact update schema for a collection
+     *
+     * Fetches the public contact schema including core fields, custom fields with
+     * conditional visibility rules, and visibility/editability settings.
+     *
+     * Custom fields may include a `condition` property that specifies when the field
+     * should be displayed. Apps rendering these forms should:
+     * 1. Evaluate each field's `condition` against current form values
+     * 2. Hide fields whose conditions are not met
+     * 3. Skip validation for hidden fields (they shouldn't be required when not visible)
+     */
     function publicGetSchema(collectionId: string): Promise<ContactSchema>;
     function erase(collectionId: string, contactId: string, body?: any): Promise<ContactResponse>;
     function getUser(collectionId: string, userId: string): Promise<UserSearchResponse>;

package/dist/api/contact.js

@@ -71,7 +71,18 @@ export var contact;
         return patch(path, data);
     }
     contact.publicUpdateMine = publicUpdateMine;
-    // Public: Get contact update schema for a collection
+    /**
+     * Public: Get contact update schema for a collection
+     *
+     * Fetches the public contact schema including core fields, custom fields with
+     * conditional visibility rules, and visibility/editability settings.
+     *
+     * Custom fields may include a `condition` property that specifies when the field
+     * should be displayed. Apps rendering these forms should:
+     * 1. Evaluate each field's `condition` against current form values
+     * 2. Hide fields whose conditions are not met
+     * 3. Skip validation for hidden fields (they shouldn't be required when not visible)
+     */
     async function publicGetSchema(collectionId) {
         const path = `/public/collection/${encodeURIComponent(collectionId)}/contact/schema`;
         return request(path);

package/dist/api/index.d.ts

@@ -27,4 +27,6 @@ export { template } from "./template";
 export { interactions } from "./interactions";
 export { location } from "./location";
 export * as realtime from "./realtime";
+export { tags } from "./tags";
+export { order } from "./order";
 export type { AIGenerateContentRequest, AIGenerateImageRequest, AISearchPhotosRequest, AISearchPhotosPhoto } from "./ai";

package/dist/api/index.js

@@ -30,3 +30,5 @@ export { interactions } from "./interactions";
 export { location } from "./location";
 import * as realtime_1 from "./realtime";
 export { realtime_1 as realtime };
+export { tags } from "./tags";
+export { order } from "./order";

package/dist/api/order.d.ts

@@ -0,0 +1,189 @@
+import { CreateOrderRequest, CreateOrderResponse, GetOrderResponse, UpdateOrderRequest, UpdateOrderResponse, DeleteOrderResponse, ListOrdersRequest, ListOrdersResponse, AddItemsRequest, AddItemsResponse, RemoveItemsRequest, RemoveItemsResponse, LookupOrdersRequest, LookupOrdersResponse } from "../types/order";
+/**
+ * Order Management API
+ *
+ * Group scanned tags, proofs, or serial numbers into orders with flexible metadata.
+ * Designed for fulfillment, shipping, batch processing, and audit trails.
+ */
+export declare namespace order {
+    /**
+     * Create a new order with items.
+     *
+     * @param collectionId - Identifier of the parent collection
+     * @param data - Order creation data including items
+     * @returns Promise resolving to a CreateOrderResponse object
+     * @throws ErrorResponse if the request fails
+     *
+     * @example
+     * ```typescript
+     * const order = await order.create('coll_123', {
+     *   orderRef: 'ORD-12345',
+     *   customerId: 'CUST-789',
+     *   items: [
+     *     { itemType: 'tag', itemId: 'TAG001' },
+     *     { itemType: 'tag', itemId: 'TAG002' },
+     *     { itemType: 'serial', itemId: 'SN12345' }
+     *   ],
+     *   status: 'pending',
+     *   metadata: {
+     *     shipmentId: 'SHIP-789',
+     *     destination: 'Warehouse B'
+     *   }
+     * })
+     * ```
+     */
+    function create(collectionId: string, data: CreateOrderRequest): Promise<CreateOrderResponse>;
+    /**
+     * Get a single order by ID with all its items.
+     *
+     * @param collectionId - Identifier of the parent collection
+     * @param orderId - Order ID
+     * @returns Promise resolving to a GetOrderResponse object
+     * @throws ErrorResponse if the request fails
+     *
+     * @example
+     * ```typescript
+     * const order = await order.get('coll_123', 'order_abc123')
+     * console.log(`Order has ${order.itemCount} items`)
+     * ```
+     */
+    function get(collectionId: string, orderId: string): Promise<GetOrderResponse>;
+    /**
+     * Update order status or metadata.
+     * Items are managed separately via addItems/removeItems.
+     *
+     * @param collectionId - Identifier of the parent collection
+     * @param orderId - Order ID
+     * @param data - Update data (only include fields to update)
+     * @returns Promise resolving to an UpdateOrderResponse object
+     * @throws ErrorResponse if the request fails
+     *
+     * @example
+     * ```typescript
+     * const updated = await order.update('coll_123', 'order_abc123', {
+     *   status: 'shipped',
+     *   metadata: {
+     *     trackingNumber: '1Z999AA10123456784',
+     *     shippedAt: '2026-02-02T14:30:00Z'
+     *   }
+     * })
+     * ```
+     */
+    function update(collectionId: string, orderId: string, data: UpdateOrderRequest): Promise<UpdateOrderResponse>;
+    /**
+     * Delete an order and all its items (cascade delete).
+     *
+     * @param collectionId - Identifier of the parent collection
+     * @param orderId - Order ID
+     * @returns Promise resolving to a DeleteOrderResponse object
+     * @throws ErrorResponse if the request fails
+     *
+     * @example
+     * ```typescript
+     * await order.remove('coll_123', 'order_abc123')
+     * ```
+     */
+    function remove(collectionId: string, orderId: string): Promise<DeleteOrderResponse>;
+    /**
+     * List orders for a collection with optional filters and pagination.
+     * Orders are returned in descending order by createdAt (newest first).
+     *
+     * @param collectionId - Identifier of the parent collection
+     * @param params - Optional query parameters for filtering and pagination
+     * @returns Promise resolving to a ListOrdersResponse object
+     * @throws ErrorResponse if the request fails
+     *
+     * @example
+     * ```typescript
+     * // List all orders
+     * const all = await order.list('coll_123')
+     *
+     * // List with filters
+     * const pending = await order.list('coll_123', {
+     *   status: 'pending',
+     *   limit: 50,
+     *   offset: 0
+     * })
+     *
+     * // Filter by customer
+     * const customerOrders = await order.list('coll_123', {
+     *   customerId: 'CUST-789'
+     * })
+     * ```
+     */
+    function list(collectionId: string, params?: ListOrdersRequest): Promise<ListOrdersResponse>;
+    /**
+     * Add additional items to an existing order.
+     *
+     * @param collectionId - Identifier of the parent collection
+     * @param orderId - Order ID
+     * @param data - Items to add
+     * @returns Promise resolving to an AddItemsResponse object (updated order)
+     * @throws ErrorResponse if the request fails
+     *
+     * @example
+     * ```typescript
+     * const updated = await order.addItems('coll_123', 'order_abc123', {
+     *   items: [
+     *     { itemType: 'tag', itemId: 'TAG003' },
+     *     { itemType: 'proof', itemId: 'proof_xyz' }
+     *   ]
+     * })
+     * console.log(`Order now has ${updated.itemCount} items`)
+     * ```
+     */
+    function addItems(collectionId: string, orderId: string, data: AddItemsRequest): Promise<AddItemsResponse>;
+    /**
+     * Remove specific items from an order.
+     *
+     * @param collectionId - Identifier of the parent collection
+     * @param orderId - Order ID
+     * @param data - Item IDs to remove
+     * @returns Promise resolving to a RemoveItemsResponse object (updated order)
+     * @throws ErrorResponse if the request fails
+     *
+     * @example
+     * ```typescript
+     * const updated = await order.removeItems('coll_123', 'order_abc123', {
+     *   itemIds: ['item_001', 'item_002']
+     * })
+     * ```
+     */
+    function removeItems(collectionId: string, orderId: string, data: RemoveItemsRequest): Promise<RemoveItemsResponse>;
+    /**
+     * Find all orders containing specific items (tags, proofs, or serial numbers).
+     * Use case: Scan a tag and immediately see if it's part of any order.
+     *
+     * @param collectionId - Identifier of the parent collection
+     * @param data - Items to look up
+     * @returns Promise resolving to a LookupOrdersResponse with matching orders
+     * @throws ErrorResponse if the request fails
+     *
+     * @example
+     * ```typescript
+     * // Scan a tag and find associated orders
+     * const result = await order.lookup('coll_123', {
+     *   items: [
+     *     { itemType: 'tag', itemId: 'TAG001' }
+     *   ]
+     * })
+     *
+     * if (result.orders.length > 0) {
+     *   console.log(`Tag is part of ${result.orders.length} order(s)`)
+     *   result.orders.forEach(ord => {
+     *     console.log(`Order ${ord.orderRef}: ${ord.status}`)
+     *   })
+     * }
+     *
+     * // Batch lookup multiple items
+     * const batchResult = await order.lookup('coll_123', {
+     *   items: [
+     *     { itemType: 'tag', itemId: 'TAG001' },
+     *     { itemType: 'serial', itemId: 'SN12345' },
+     *     { itemType: 'proof', itemId: 'proof_xyz' }
+     *   ]
+     * })
+     * ```
+     */
+    function lookup(collectionId: string, data: LookupOrdersRequest): Promise<LookupOrdersResponse>;
+}

package/dist/api/order.js

@@ -0,0 +1,240 @@
+// src/api/order.ts
+import { request, post, put, del, requestWithOptions } from "../http";
+/**
+ * Order Management API
+ *
+ * Group scanned tags, proofs, or serial numbers into orders with flexible metadata.
+ * Designed for fulfillment, shipping, batch processing, and audit trails.
+ */
+export var order;
+(function (order) {
+    /**
+     * Create a new order with items.
+     *
+     * @param collectionId - Identifier of the parent collection
+     * @param data - Order creation data including items
+     * @returns Promise resolving to a CreateOrderResponse object
+     * @throws ErrorResponse if the request fails
+     *
+     * @example
+     * ```typescript
+     * const order = await order.create('coll_123', {
+     *   orderRef: 'ORD-12345',
+     *   customerId: 'CUST-789',
+     *   items: [
+     *     { itemType: 'tag', itemId: 'TAG001' },
+     *     { itemType: 'tag', itemId: 'TAG002' },
+     *     { itemType: 'serial', itemId: 'SN12345' }
+     *   ],
+     *   status: 'pending',
+     *   metadata: {
+     *     shipmentId: 'SHIP-789',
+     *     destination: 'Warehouse B'
+     *   }
+     * })
+     * ```
+     */
+    async function create(collectionId, data) {
+        const path = `/admin/collection/${encodeURIComponent(collectionId)}/orders`;
+        return post(path, data);
+    }
+    order.create = create;
+    /**
+     * Get a single order by ID with all its items.
+     *
+     * @param collectionId - Identifier of the parent collection
+     * @param orderId - Order ID
+     * @returns Promise resolving to a GetOrderResponse object
+     * @throws ErrorResponse if the request fails
+     *
+     * @example
+     * ```typescript
+     * const order = await order.get('coll_123', 'order_abc123')
+     * console.log(`Order has ${order.itemCount} items`)
+     * ```
+     */
+    async function get(collectionId, orderId) {
+        const path = `/admin/collection/${encodeURIComponent(collectionId)}/orders/${encodeURIComponent(orderId)}`;
+        return request(path);
+    }
+    order.get = get;
+    /**
+     * Update order status or metadata.
+     * Items are managed separately via addItems/removeItems.
+     *
+     * @param collectionId - Identifier of the parent collection
+     * @param orderId - Order ID
+     * @param data - Update data (only include fields to update)
+     * @returns Promise resolving to an UpdateOrderResponse object
+     * @throws ErrorResponse if the request fails
+     *
+     * @example
+     * ```typescript
+     * const updated = await order.update('coll_123', 'order_abc123', {
+     *   status: 'shipped',
+     *   metadata: {
+     *     trackingNumber: '1Z999AA10123456784',
+     *     shippedAt: '2026-02-02T14:30:00Z'
+     *   }
+     * })
+     * ```
+     */
+    async function update(collectionId, orderId, data) {
+        const path = `/admin/collection/${encodeURIComponent(collectionId)}/orders/${encodeURIComponent(orderId)}`;
+        return put(path, data);
+    }
+    order.update = update;
+    /**
+     * Delete an order and all its items (cascade delete).
+     *
+     * @param collectionId - Identifier of the parent collection
+     * @param orderId - Order ID
+     * @returns Promise resolving to a DeleteOrderResponse object
+     * @throws ErrorResponse if the request fails
+     *
+     * @example
+     * ```typescript
+     * await order.remove('coll_123', 'order_abc123')
+     * ```
+     */
+    async function remove(collectionId, orderId) {
+        const path = `/admin/collection/${encodeURIComponent(collectionId)}/orders/${encodeURIComponent(orderId)}`;
+        return del(path);
+    }
+    order.remove = remove;
+    /**
+     * List orders for a collection with optional filters and pagination.
+     * Orders are returned in descending order by createdAt (newest first).
+     *
+     * @param collectionId - Identifier of the parent collection
+     * @param params - Optional query parameters for filtering and pagination
+     * @returns Promise resolving to a ListOrdersResponse object
+     * @throws ErrorResponse if the request fails
+     *
+     * @example
+     * ```typescript
+     * // List all orders
+     * const all = await order.list('coll_123')
+     *
+     * // List with filters
+     * const pending = await order.list('coll_123', {
+     *   status: 'pending',
+     *   limit: 50,
+     *   offset: 0
+     * })
+     *
+     * // Filter by customer
+     * const customerOrders = await order.list('coll_123', {
+     *   customerId: 'CUST-789'
+     * })
+     * ```
+     */
+    async function list(collectionId, params) {
+        const queryParams = new URLSearchParams();
+        if (params === null || params === void 0 ? void 0 : params.limit)
+            queryParams.append('limit', params.limit.toString());
+        if (params === null || params === void 0 ? void 0 : params.offset)
+            queryParams.append('offset', params.offset.toString());
+        if (params === null || params === void 0 ? void 0 : params.status)
+            queryParams.append('status', params.status);
+        if (params === null || params === void 0 ? void 0 : params.orderRef)
+            queryParams.append('orderRef', params.orderRef);
+        if (params === null || params === void 0 ? void 0 : params.customerId)
+            queryParams.append('customerId', params.customerId);
+        const query = queryParams.toString();
+        const path = `/admin/collection/${encodeURIComponent(collectionId)}/orders${query ? `?${query}` : ''}`;
+        return request(path);
+    }
+    order.list = list;
+    /**
+     * Add additional items to an existing order.
+     *
+     * @param collectionId - Identifier of the parent collection
+     * @param orderId - Order ID
+     * @param data - Items to add
+     * @returns Promise resolving to an AddItemsResponse object (updated order)
+     * @throws ErrorResponse if the request fails
+     *
+     * @example
+     * ```typescript
+     * const updated = await order.addItems('coll_123', 'order_abc123', {
+     *   items: [
+     *     { itemType: 'tag', itemId: 'TAG003' },
+     *     { itemType: 'proof', itemId: 'proof_xyz' }
+     *   ]
+     * })
+     * console.log(`Order now has ${updated.itemCount} items`)
+     * ```
+     */
+    async function addItems(collectionId, orderId, data) {
+        const path = `/admin/collection/${encodeURIComponent(collectionId)}/orders/${encodeURIComponent(orderId)}/items`;
+        return post(path, data);
+    }
+    order.addItems = addItems;
+    /**
+     * Remove specific items from an order.
+     *
+     * @param collectionId - Identifier of the parent collection
+     * @param orderId - Order ID
+     * @param data - Item IDs to remove
+     * @returns Promise resolving to a RemoveItemsResponse object (updated order)
+     * @throws ErrorResponse if the request fails
+     *
+     * @example
+     * ```typescript
+     * const updated = await order.removeItems('coll_123', 'order_abc123', {
+     *   itemIds: ['item_001', 'item_002']
+     * })
+     * ```
+     */
+    async function removeItems(collectionId, orderId, data) {
+        const path = `/admin/collection/${encodeURIComponent(collectionId)}/orders/${encodeURIComponent(orderId)}/items`;
+        // DELETE with body requires requestWithOptions since del() doesn't send body
+        return requestWithOptions(path, {
+            method: 'DELETE',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(data)
+        });
+    }
+    order.removeItems = removeItems;
+    /**
+     * Find all orders containing specific items (tags, proofs, or serial numbers).
+     * Use case: Scan a tag and immediately see if it's part of any order.
+     *
+     * @param collectionId - Identifier of the parent collection
+     * @param data - Items to look up
+     * @returns Promise resolving to a LookupOrdersResponse with matching orders
+     * @throws ErrorResponse if the request fails
+     *
+     * @example
+     * ```typescript
+     * // Scan a tag and find associated orders
+     * const result = await order.lookup('coll_123', {
+     *   items: [
+     *     { itemType: 'tag', itemId: 'TAG001' }
+     *   ]
+     * })
+     *
+     * if (result.orders.length > 0) {
+     *   console.log(`Tag is part of ${result.orders.length} order(s)`)
+     *   result.orders.forEach(ord => {
+     *     console.log(`Order ${ord.orderRef}: ${ord.status}`)
+     *   })
+     * }
+     *
+     * // Batch lookup multiple items
+     * const batchResult = await order.lookup('coll_123', {
+     *   items: [
+     *     { itemType: 'tag', itemId: 'TAG001' },
+     *     { itemType: 'serial', itemId: 'SN12345' },
+     *     { itemType: 'proof', itemId: 'proof_xyz' }
+     *   ]
+     * })
+     * ```
+     */
+    async function lookup(collectionId, data) {
+        const path = `/admin/collection/${encodeURIComponent(collectionId)}/orders/lookup`;
+        return post(path, data);
+    }
+    order.lookup = lookup;
+})(order || (order = {}));

package/dist/api/tags.d.ts

@@ -0,0 +1,199 @@
+import { CreateTagRequest, CreateTagResponse, CreateTagsBatchRequest, CreateTagsBatchResponse, UpdateTagRequest, UpdateTagResponse, DeleteTagResponse, GetTagResponse, ListTagsRequest, ListTagsResponse, PublicGetTagRequest, PublicGetTagResponse, PublicBatchLookupRequest, PublicBatchLookupResponse, PublicBatchLookupQueryRequest, PublicBatchLookupQueryResponse } from "../types/tags";
+/**
+ * Tag Management API
+ *
+ * Create mappings between physical tags (NFC tags, QR codes, etc.) and digital proofs.
+ * Supports automatic serial number generation, batch operations, and public lookups.
+ */
+export declare namespace tags {
+    /**
+     * Create a single tag mapping.
+     * If proofId is not provided, automatically generates a serial number.
+     *
+     * @param collectionId - Identifier of the parent collection
+     * @param data - Tag creation data
+     * @returns Promise resolving to a CreateTagResponse object
+     * @throws ErrorResponse if the request fails
+     *
+     * @example
+     * ```typescript
+     * // Auto-generate serial number
+     * const tag = await tags.create('coll_123', {
+     *   tagId: 'TAG001',
+     *   productId: 'prod_456',
+     *   variantId: 'var_789'
+     * })
+     *
+     * // Use explicit proof ID
+     * const tag2 = await tags.create('coll_123', {
+     *   tagId: 'TAG002',
+     *   productId: 'prod_456',
+     *   proofId: 'proof_explicit_123'
+     * })
+     * ```
+     */
+    function create(collectionId: string, data: CreateTagRequest): Promise<CreateTagResponse>;
+    /**
+     * Create multiple tag mappings efficiently in a batch operation.
+     * By default, auto-generates serial numbers for all tags without explicit proofId.
+     * Tags are grouped by product/variant/batch and serial numbers are generated in
+     * a single transaction per group for optimal performance.
+     *
+     * @param collectionId - Identifier of the parent collection
+     * @param data - Batch creation data
+     * @returns Promise resolving to a CreateTagsBatchResponse with summary and results
+     * @throws ErrorResponse if the request fails
+     *
+     * @example
+     * ```typescript
+     * const result = await tags.createBatch('coll_123', {
+     *   tags: [
+     *     { tagId: 'TAG001', productId: 'prod_456', variantId: 'var_789' },
+     *     { tagId: 'TAG002', productId: 'prod_456', variantId: 'var_789' },
+     *     { tagId: 'TAG003', productId: 'prod_456', batchId: 'batch_100' }
+     *   ]
+     * })
+     *
+     * console.log(`Created: ${result.summary.created}, Failed: ${result.summary.failed}`)
+     * ```
+     */
+    function createBatch(collectionId: string, data: CreateTagsBatchRequest): Promise<CreateTagsBatchResponse>;
+    /**
+     * Update an existing tag mapping.
+     *
+     * @param collectionId - Identifier of the parent collection
+     * @param tagId - Unique tag identifier
+     * @param data - Update data (only include fields to update)
+     * @returns Promise resolving to an UpdateTagResponse object
+     * @throws ErrorResponse if the request fails
+     *
+     * @example
+     * ```typescript
+     * const updated = await tags.update('coll_123', 'TAG001', {
+     *   variantId: 'var_999',
+     *   metadata: { notes: 'Updated variant' }
+     * })
+     * ```
+     */
+    function update(collectionId: string, tagId: string, data: UpdateTagRequest): Promise<UpdateTagResponse>;
+    /**
+     * Delete a tag mapping.
+     *
+     * @param collectionId - Identifier of the parent collection
+     * @param tagId - Unique tag identifier
+     * @returns Promise resolving to a DeleteTagResponse object
+     * @throws ErrorResponse if the request fails
+     *
+     * @example
+     * ```typescript
+     * await tags.remove('coll_123', 'TAG001')
+     * ```
+     */
+    function remove(collectionId: string, tagId: string): Promise<DeleteTagResponse>;
+    /**
+     * Get a single tag mapping by tagId.
+     *
+     * @param collectionId - Identifier of the parent collection
+     * @param tagId - Unique tag identifier
+     * @returns Promise resolving to a GetTagResponse object
+     * @throws ErrorResponse if the request fails
+     *
+     * @example
+     * ```typescript
+     * const tag = await tags.get('coll_123', 'TAG001')
+     * ```
+     */
+    function get(collectionId: string, tagId: string): Promise<GetTagResponse>;
+    /**
+     * List all tags for a collection with optional filters and pagination.
+     *
+     * @param collectionId - Identifier of the parent collection
+     * @param params - Optional query parameters for filtering and pagination
+     * @returns Promise resolving to a ListTagsResponse object
+     * @throws ErrorResponse if the request fails
+     *
+     * @example
+     * ```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
+     * })
+     * ```
+     */
+    function list(collectionId: string, params?: ListTagsRequest): Promise<ListTagsResponse>;
+    /**
+     * 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
+     * @throws ErrorResponse if the request fails
+     *
+     * @example
+     * ```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)
+     * ```
+     */
+    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('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)
+     * ```
+     */
+    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('coll_123', {
+     *   tagIds: 'TAG001,TAG002,TAG003',
+     *   embed: 'collection'
+     * })
+     * ```
+     */
+    function publicBatchLookupQuery(collectionId: string, params: PublicBatchLookupQueryRequest): Promise<PublicBatchLookupQueryResponse>;
+}