@proveanything/smartlinks 1.1.22 → 1.1.24

package/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.1.22  |  Generated: 2026-01-07T12:13:29.397Z
+Version: 1.1.24  |  Generated: 2026-01-11T11:29:10.460Z
 
 This is a concise summary of all available API functions and types.
 
@@ -125,15 +125,84 @@ interface AppConfigurationResponse {
 
 ### asset
 
-**AssetResponse** (interface)
+**Asset** (interface)
 ```typescript
-interface AssetResponse {
+interface Asset {
   id: string
-  name: string
   url: string
+  name: string
+  mimeType?: string
+  size?: number
+  createdAt?: string
+  metadata?: Record<string, any>
+  assetType?: string
+  type?: string
+  collectionId?: string
+  hash?: string
+  thumbnails?: {
+  x100?: string
+  x200?: string
+  x512?: string
+  [key: string]: string | undefined
+  }
+  site?: string
+  cleanName?: string
+}
+```
+
+**UploadAssetOptions** (interface)
+```typescript
+interface UploadAssetOptions {
+  file: File
+  scope:
+  | { type: 'collection'; collectionId: string }
+  | { type: 'product'; collectionId: string; productId: string }
+  | { type: 'proof'; collectionId: string; productId: string; proofId: string }
+  name?: string
+  metadata?: Record<string, any>
+  onProgress?: (percent: number) => void
+  appId?: string
+}
+```
+
+**ListAssetsOptions** (interface)
+```typescript
+interface ListAssetsOptions {
+  scope:
+  | { type: 'collection'; collectionId: string }
+  | { type: 'product'; collectionId: string; productId: string }
+  | { type: 'proof'; collectionId: string; productId: string; proofId: string }
+  appId?: string
+  mimeTypePrefix?: string
+  limit?: number
+  offset?: number
+}
+```
+
+**GetAssetOptions** (interface)
+```typescript
+interface GetAssetOptions {
+  assetId: string
+  scope:
+  | { type: 'collection'; collectionId: string }
+  | { type: 'product'; collectionId: string; productId: string }
+  | { type: 'proof'; collectionId: string; productId: string; proofId: string }
+}
+```
+
+**RemoveAssetOptions** (interface)
+```typescript
+interface RemoveAssetOptions {
+  assetId: string
+  scope:
+  | { type: 'collection'; collectionId: string }
+  | { type: 'product'; collectionId: string; productId: string }
+  | { type: 'proof'; collectionId: string; productId: string; proofId: string }
 }
 ```
 
+**AssetResponse** = `Asset`
+
 ### attestation
 
 **AttestationResponse** (interface)
@@ -851,6 +920,38 @@ interface UserSearchResponse {
 }
 ```
 
+**ContactPublic** (interface)
+```typescript
+interface ContactPublic {
+  contactId: string
+  firstName?: string | null
+  lastName?: string | null
+  displayName?: string | null
+  company?: string | null
+  avatarUrl?: string | null
+  locale?: string | null
+  timezone?: string | null
+  email?: string | null
+  phone?: string | null
+  externalIds?: Record<string, any>
+  customFields?: ContactCustomFields
+}
+```
+
+**PublicGetMyContactResponse** (interface)
+```typescript
+interface PublicGetMyContactResponse {
+  ok: boolean; contact: ContactPublic | null
+}
+```
+
+**PublicUpdateMyContactResponse** (interface)
+```typescript
+interface PublicUpdateMyContactResponse {
+  ok: boolean; contact: ContactPublic
+}
+```
+
 **ContactCustomFields** = `Record<string, any>`
 
 **ContactResponse** = `Contact`
@@ -861,6 +962,8 @@ interface UserSearchResponse {
 
 **PublicContactUpsertRequest** = `Partial<`
 
+**ContactPatch** = `Partial<`
+
 ### error
 
 **ErrorResponse** (interface)
@@ -1518,12 +1621,18 @@ interface TemplateBase {
   collectionId: string
   name: string
   description?: string
-  type: string
+  type: 'pdf' | 'email' | 'multichannel' | 'label'
   resizeMode?: string
   pdf?: {
   base: { url: string }
   orientation: 'portrait' | 'landscape'
   }
+  channels?: {
+  email?: {subject: string; body: string},
+  sms?: { body: string },
+  push: { title: string; body: string, url?: string, iconUrl?: string },
+  wallet?: { header: string; body: string; imageUri?: string }
+  }
   subject?: string
   body?: string
   css?: string
@@ -1760,27 +1869,36 @@ Post a chat message to the AI (admin or public)
 
 ### asset
 
+**upload**(options: UploadAssetOptions) → `Promise<Asset>`
+Upload an asset file
+
 **getForCollection**(collectionId: string,
     assetId: string) → `Promise<AssetResponse>`
+Upload an asset file
 
 **listForCollection**(collectionId: string) → `Promise<AssetResponse[]>`
+Upload an asset file
 
 **getForProduct**(collectionId: string,
     productId: string,
     assetId: string) → `Promise<AssetResponse>`
+Upload an asset file
 
 **listForProduct**(collectionId: string,
     productId: string) → `Promise<AssetResponse[]>`
+Upload an asset file
 
 **getForProof**(collectionId: string,
     productId: string,
     proofId: string,
     assetId: string) → `Promise<AssetResponse>`
+Upload an asset file
 
 **listForProof**(collectionId: string,
     productId: string,
     proofId: string,
     appId?: string) → `Promise<AssetResponse[]>`
+Upload an asset file
 
 **uploadAsset**(collectionId: string,
     productId: string,
@@ -1790,6 +1908,15 @@ Post a chat message to the AI (admin or public)
     onProgress?: (percent: number) → `void`
 Uploads an asset file to a proof, with optional extraData as JSON. Supports progress reporting via onProgress callback (browser only).
 
+**list**(options: ListAssetsOptions) → `Promise<Asset[]>`
+List assets for a given scope
+
+**get**(options: GetAssetOptions) → `Promise<Asset>`
+Get an asset by id within a scope (public)
+
+**remove**(options: RemoveAssetOptions) → `Promise<void>`
+Remove an asset by id within a scope (admin)
+
 ### async
 
 **enqueueAsyncJob**(collectionId: string,
@@ -2166,6 +2293,11 @@ Logging: Append many communication events for a list of IDs. POST /admin/collect
 **publicUpsert**(collectionId: string,
     data: PublicContactUpsertRequest) → `Promise<PublicContactUpsertResponse>`
 
+**publicGetMine**(collectionId: string) → `Promise<PublicGetMyContactResponse>`
+
+**publicUpdateMine**(collectionId: string,
+    data: ContactPatch) → `Promise<PublicUpdateMyContactResponse>`
+
 **erase**(collectionId: string, contactId: string, body?: any) → `Promise<ContactResponse>`
 
 **getUser**(collectionId: string,

package/README.md

@@ -96,22 +96,88 @@ await product.update('collectionId', 'productId', { description: 'Updated' })
 await product.remove('collectionId', 'productId')
 ```
 
-### Assets (upload)
+### Assets
 
-Browser-side upload to a proof with progress callback:
+Upload, list, get, and remove assets within a scope (collection/product/proof).
+
+#### Upload (new)
 
 ```ts
 import { asset } from '@proveanything/smartlinks'
 
-const result = await asset.uploadAsset(
-  'collectionId',
-  'productId',
-  'proofId',
+const uploaded = await asset.upload({
   file, // File from an <input type="file">
-  { description: 'Uploaded via SDK' },
-  (progress) => console.log(`Upload: ${progress}%`)
-)
-console.log('Uploaded asset:', result)
+  scope: { type: 'proof', collectionId, productId, proofId },
+  name: 'hero.png',
+  metadata: { description: 'Uploaded via SDK' },
+  onProgress: (p) => console.log(`Upload: ${p}%`),
+  // appId: 'microapp-123' // optional
+})
+console.log('Uploaded asset:', uploaded)
+```
+
+Deprecated upload helper (wraps to the new `upload` internally):
+
+```ts
+// @deprecated Use asset.upload(options)
+const legacy = await asset.uploadAsset(collectionId, productId, proofId, file)
+```
+
+#### List
+
+```ts
+// Collection assets, first 20 images
+const list1 = await asset.list({
+  scope: { type: 'collection', collectionId },
+  mimeTypePrefix: 'image/',
+  limit: 20,
+})
+
+// Product assets, filter by appId
+const list2 = await asset.list({
+  scope: { type: 'product', collectionId, productId },
+  appId: 'microapp-123',
+})
+```
+
+#### Get (scoped)
+
+```ts
+const a = await asset.get({
+  assetId,
+  scope: { type: 'proof', collectionId, productId, proofId },
+})
+```
+
+#### Remove (scoped, admin)
+
+```ts
+await asset.remove({
+  assetId,
+  scope: { type: 'product', collectionId, productId },
+})
+```
+
+#### Asset response example
+
+```json
+{
+  "name": "Screenshot 2025-09-15 at 15.21.14",
+  "assetType": "Image",
+  "type": "png",
+  "collectionId": "ChaseAtlantic",
+  "url": "https://cdn.smartlinks.app/sites%2FChaseAtlantic%2Fimages%2F2025%2F9%2FScreenshot%202025-09-15%20at%2015%2C21%2C14-1757946214537.png",
+  "createdAt": "2005-10-10T23:15:03",
+  "hash": "fb98140a6b41ee69b824f29cc8b6795444246f871e4ab2379528b34a4d16284e",
+  "thumbnails": {
+    "x100": "https://cdn.smartlinks.app/..._100x100.png",
+    "x200": "https://cdn.smartlinks.app/..._200x200.png",
+    "x512": "https://cdn.smartlinks.app/..._512x512.png"
+  },
+  "id": "7k1cGErrlmQ94J8yDlVj",
+  "site": "ChaseAtlantic",
+  "cleanName": "Screenshot 2025-09-15 at 15.21"
+}
 ```
 
 ### AI helpers

package/dist/api/asset.d.ts

@@ -1,5 +1,19 @@
-import { AssetResponse } from "../types/asset";
+import { Asset, AssetResponse, UploadAssetOptions, ListAssetsOptions, GetAssetOptions, RemoveAssetOptions } from "../types/asset";
 export declare namespace asset {
+    /**
+     * Error type for asset uploads
+     */
+    class AssetUploadError extends Error {
+        readonly code: 'FILE_TOO_LARGE' | 'INVALID_TYPE' | 'NETWORK_ERROR' | 'UNAUTHORIZED' | 'QUOTA_EXCEEDED' | 'UNKNOWN';
+        readonly details?: Record<string, any> | undefined;
+        constructor(message: string, code: 'FILE_TOO_LARGE' | 'INVALID_TYPE' | 'NETWORK_ERROR' | 'UNAUTHORIZED' | 'QUOTA_EXCEEDED' | 'UNKNOWN', details?: Record<string, any> | undefined);
+    }
+    /**
+     * Upload an asset file
+     * @returns The uploaded asset with its public URL
+     * @throws AssetUploadError if upload fails
+     */
+    function upload(options: UploadAssetOptions): Promise<Asset>;
     function getForCollection(collectionId: string, assetId: string): Promise<AssetResponse>;
     function listForCollection(collectionId: string): Promise<AssetResponse[]>;
     function getForProduct(collectionId: string, productId: string, assetId: string): Promise<AssetResponse>;
@@ -8,6 +22,7 @@ export declare namespace asset {
     function listForProof(collectionId: string, productId: string, proofId: string, appId?: string): Promise<AssetResponse[]>;
     /**
      * Uploads an asset file to a proof, with optional extraData as JSON.
+     * @deprecated Use `asset.upload(options)` instead.
      * Supports progress reporting via onProgress callback (browser only).
      * @param collectionId - The collection ID
      * @param productId - The product ID
@@ -18,4 +33,16 @@ export declare namespace asset {
      * @returns Promise resolving to an AssetResponse object
      */
     function uploadAsset(collectionId: string, productId: string, proofId: string, file: File, extraData?: Record<string, any>, onProgress?: (percent: number) => void): Promise<AssetResponse>;
+    /**
+     * List assets for a given scope
+     */
+    function list(options: ListAssetsOptions): Promise<Asset[]>;
+    /**
+     * Get an asset by id within a scope (public)
+     */
+    function get(options: GetAssetOptions): Promise<Asset>;
+    /**
+     * Remove an asset by id within a scope (admin)
+     */
+    function remove(options: RemoveAssetOptions): Promise<void>;
 }

package/dist/api/asset.js

@@ -1,6 +1,114 @@
-import { request, getApiHeaders } from "../http";
+import { request, post, del, getApiHeaders } from "../http";
 export var asset;
 (function (asset) {
+    /**
+     * Error type for asset uploads
+     */
+    class AssetUploadError extends Error {
+        constructor(message, code, details) {
+            super(message);
+            this.code = code;
+            this.details = details;
+            this.name = 'AssetUploadError';
+        }
+    }
+    asset.AssetUploadError = AssetUploadError;
+    function buildScopeBase(scope) {
+        if (scope.type === 'collection') {
+            return `/public/collection/${encodeURIComponent(scope.collectionId)}`;
+        }
+        if (scope.type === 'product') {
+            return `/public/collection/${encodeURIComponent(scope.collectionId)}/product/${encodeURIComponent(scope.productId)}`;
+        }
+        // proof
+        return `/public/collection/${encodeURIComponent(scope.collectionId)}/product/${encodeURIComponent(scope.productId)}/proof/${encodeURIComponent(scope.proofId)}`;
+    }
+    /**
+     * Upload an asset file
+     * @returns The uploaded asset with its public URL
+     * @throws AssetUploadError if upload fails
+     */
+    async function upload(options) {
+        const base = buildScopeBase(options.scope);
+        let path = `${base}/asset`;
+        if (options.appId) {
+            const qp = new URLSearchParams({ appId: options.appId });
+            path += `?${qp.toString()}`;
+        }
+        const formData = new FormData();
+        formData.append("file", options.file);
+        if (options.name)
+            formData.append("name", options.name);
+        if (options.metadata)
+            formData.append("metadata", JSON.stringify(options.metadata));
+        // If progress callback provided, use XHR for progress events (browser-only)
+        if (options.onProgress && typeof window !== "undefined") {
+            const url = (typeof window !== "undefined" && window.SMARTLINKS_API_BASEURL)
+                ? window.SMARTLINKS_API_BASEURL + path
+                : path;
+            const headers = getApiHeaders ? getApiHeaders() : {};
+            return new Promise((resolve, reject) => {
+                const xhr = new XMLHttpRequest();
+                xhr.open("POST", url);
+                for (const [key, value] of Object.entries(headers))
+                    xhr.setRequestHeader(key, value);
+                xhr.upload.onprogress = (event) => {
+                    if (options.onProgress && event.lengthComputable) {
+                        const percent = Math.round((event.loaded / event.total) * 100);
+                        options.onProgress(percent);
+                    }
+                };
+                xhr.onload = () => {
+                    const status = xhr.status;
+                    const text = xhr.responseText;
+                    if (status >= 200 && status < 300) {
+                        try {
+                            resolve(JSON.parse(text));
+                        }
+                        catch (e) {
+                            reject(new AssetUploadError("Failed to parse server response", 'UNKNOWN'));
+                        }
+                    }
+                    else {
+                        try {
+                            const errBody = JSON.parse(text);
+                            const code = mapStatusToUploadErrorCode(status, errBody === null || errBody === void 0 ? void 0 : errBody.code);
+                            reject(new AssetUploadError((errBody === null || errBody === void 0 ? void 0 : errBody.message) || `Upload failed (${status})`, code, errBody));
+                        }
+                        catch (_a) {
+                            const code = mapStatusToUploadErrorCode(status);
+                            reject(new AssetUploadError(`Asset upload failed with status ${status}`, code));
+                        }
+                    }
+                };
+                xhr.onerror = () => reject(new AssetUploadError("Network error during asset upload", 'NETWORK_ERROR'));
+                xhr.send(formData);
+            });
+        }
+        // Otherwise use fetch helper
+        try {
+            return await post(path, formData);
+        }
+        catch (e) {
+            // Map generic Error to AssetUploadError
+            const msg = (e === null || e === void 0 ? void 0 : e.message) || 'Upload failed';
+            throw new AssetUploadError(msg, 'UNKNOWN');
+        }
+    }
+    asset.upload = upload;
+    function mapStatusToUploadErrorCode(status, serverCode) {
+        if (status === 401 || status === 403)
+            return 'UNAUTHORIZED';
+        if (status === 413)
+            return 'FILE_TOO_LARGE';
+        if (status === 415)
+            return 'INVALID_TYPE';
+        if (status === 429)
+            return 'QUOTA_EXCEEDED';
+        if (status === 0)
+            return 'NETWORK_ERROR';
+        return 'UNKNOWN';
+    }
     // Collection-level
     async function getForCollection(collectionId, assetId) {
         const path = `/public/collection/${encodeURIComponent(collectionId)}/asset/${encodeURIComponent(assetId)}`;
@@ -39,6 +147,7 @@ export var asset;
     asset.listForProof = listForProof;
     /**
      * Uploads an asset file to a proof, with optional extraData as JSON.
+     * @deprecated Use `asset.upload(options)` instead.
      * Supports progress reporting via onProgress callback (browser only).
      * @param collectionId - The collection ID
      * @param productId - The product ID
@@ -49,52 +158,60 @@ export var asset;
      * @returns Promise resolving to an AssetResponse object
      */
     async function uploadAsset(collectionId, productId, proofId, file, extraData, onProgress) {
-        const path = `/public/collection/${encodeURIComponent(collectionId)}/product/${encodeURIComponent(productId)}/proof/${encodeURIComponent(proofId)}/asset`;
-        const url = (typeof window !== "undefined" && window.SMARTLINKS_API_BASEURL)
-            ? window.SMARTLINKS_API_BASEURL + path
-            : path; // fallback for SSR or Node
-        const formData = new FormData();
-        formData.append("file", file);
-        if (extraData) {
-            formData.append("extraData", JSON.stringify(extraData));
-        }
-        // Use getApiHeaders from http module
-        const headers = getApiHeaders ? getApiHeaders() : {};
-        return new Promise((resolve, reject) => {
-            const xhr = new XMLHttpRequest();
-            xhr.open("POST", url);
-            // Set headers for API key and bearer token if available
-            for (const [key, value] of Object.entries(headers)) {
-                xhr.setRequestHeader(key, value);
-            }
-            xhr.upload.onprogress = (event) => {
-                if (onProgress && event.lengthComputable) {
-                    const percent = Math.round((event.loaded / event.total) * 100);
-                    onProgress(percent);
-                }
-            };
-            xhr.onload = () => {
-                if (xhr.status >= 200 && xhr.status < 300) {
-                    try {
-                        resolve(JSON.parse(xhr.responseText));
-                    }
-                    catch (e) {
-                        reject(new Error("Failed to parse server response"));
-                    }
-                }
-                else {
-                    try {
-                        const errBody = JSON.parse(xhr.responseText);
-                        reject(new Error(`Error ${errBody.code}: ${errBody.message}`));
-                    }
-                    catch (_a) {
-                        reject(new Error(`Asset upload failed with status ${xhr.status}`));
-                    }
-                }
-            };
-            xhr.onerror = () => reject(new Error("Network error during asset upload"));
-            xhr.send(formData);
+        // Route through new upload API for backward compatibility
+        const res = await upload({
+            file,
+            name: file === null || file === void 0 ? void 0 : file.name,
+            metadata: extraData,
+            onProgress,
+            scope: { type: 'proof', collectionId, productId, proofId },
         });
+        return res;
     }
     asset.uploadAsset = uploadAsset;
+    /**
+     * List assets for a given scope
+     */
+    async function list(options) {
+        const base = buildScopeBase(options.scope);
+        const params = new URLSearchParams();
+        if (options.appId)
+            params.set('appId', options.appId);
+        if (options.mimeTypePrefix)
+            params.set('mimeTypePrefix', options.mimeTypePrefix);
+        if (typeof options.limit === 'number')
+            params.set('limit', String(options.limit));
+        if (typeof options.offset === 'number')
+            params.set('offset', String(options.offset));
+        const path = `${base}/asset${params.toString() ? `?${params}` : ''}`;
+        return request(path);
+    }
+    asset.list = list;
+    /**
+     * Get an asset by id within a scope (public)
+     */
+    async function get(options) {
+        const base = buildScopeBase(options.scope);
+        const path = `${base}/asset/${encodeURIComponent(options.assetId)}`;
+        return request(path);
+    }
+    asset.get = get;
+    /**
+     * Remove an asset by id within a scope (admin)
+     */
+    async function remove(options) {
+        const scope = options.scope;
+        let path;
+        if (scope.type === 'collection') {
+            path = `/admin/collection/${encodeURIComponent(scope.collectionId)}/asset/${encodeURIComponent(options.assetId)}`;
+        }
+        else if (scope.type === 'product') {
+            path = `/admin/collection/${encodeURIComponent(scope.collectionId)}/product/${encodeURIComponent(scope.productId)}/asset/${encodeURIComponent(options.assetId)}`;
+        }
+        else {
+            path = `/admin/collection/${encodeURIComponent(scope.collectionId)}/product/${encodeURIComponent(scope.productId)}/proof/${encodeURIComponent(scope.proofId)}/asset/${encodeURIComponent(options.assetId)}`;
+        }
+        return del(path);
+    }
+    asset.remove = remove;
 })(asset || (asset = {}));

package/dist/api/contact.d.ts

@@ -1,4 +1,4 @@
-import { ContactResponse, ContactCreateRequest, ContactUpdateRequest, ContactListResponse, PublicContactUpsertRequest, PublicContactUpsertResponse, UserSearchResponse } from "../types";
+import { ContactResponse, ContactCreateRequest, ContactUpdateRequest, ContactListResponse, PublicContactUpsertRequest, PublicContactUpsertResponse, UserSearchResponse, ContactPatch, PublicGetMyContactResponse, PublicUpdateMyContactResponse } from "../types";
 export declare namespace contact {
     function create(collectionId: string, data: ContactCreateRequest): Promise<ContactResponse>;
     function list(collectionId: string, params?: {
@@ -17,6 +17,8 @@ export declare namespace contact {
     }): Promise<ContactResponse>;
     function upsert(collectionId: string, data: ContactCreateRequest): Promise<ContactResponse>;
     function publicUpsert(collectionId: string, data: PublicContactUpsertRequest): Promise<PublicContactUpsertResponse>;
+    function publicGetMine(collectionId: string): Promise<PublicGetMyContactResponse>;
+    function publicUpdateMine(collectionId: string, data: ContactPatch): Promise<PublicUpdateMyContactResponse>;
     function erase(collectionId: string, contactId: string, body?: any): Promise<ContactResponse>;
     function getUser(collectionId: string, userId: string): Promise<UserSearchResponse>;
 }

package/dist/api/contact.js

@@ -59,6 +59,18 @@ export var contact;
         return post(path, data);
     }
     contact.publicUpsert = publicUpsert;
+    // Public: Get "my" contact (requires auth bearer token)
+    async function publicGetMine(collectionId) {
+        const path = `/public/collection/${encodeURIComponent(collectionId)}/contact/me`;
+        return request(path);
+    }
+    contact.publicGetMine = publicGetMine;
+    // Public: Update "my" contact (requires auth bearer token)
+    async function publicUpdateMine(collectionId, data) {
+        const path = `/public/collection/${encodeURIComponent(collectionId)}/contact/me`;
+        return patch(path, data);
+    }
+    contact.publicUpdateMine = publicUpdateMine;
     async function erase(collectionId, contactId, body) {
         const path = `/admin/collection/${encodeURIComponent(collectionId)}/contacts/${encodeURIComponent(contactId)}/erase`;
         return post(path, body || {});

package/dist/types/asset.d.ts

@@ -1,8 +1,142 @@
+/**
+ * Response from any asset upload or retrieval operation
+ */
 /**
  * Represents an Asset object.
+ *
+ * Example server response shape:
+ * @example
+ * {
+ *   "name": "Screenshot 2025-09-15 at 15.21.14",
+ *   "assetType": "Image",
+ *   "type": "png",
+ *   "collectionId": "myCollection",
+ *   "url": "https://cdn.smartlinks.app/s25-09-15%20at14537.png",
+ *   "createdAt": "2005-10-10T23:15:03",
+ *   "hash": "fb98140a6b41ee69b824f29cc8b6795444246f871e4ab2379528b34a4d16284e",
+ *   "thumbnails": {
+ *     "x100": "https://cdn.smartlinks.app/sit2F..._100x100.png",
+ *     "x200": "https://cdn.smartlinks.app/sit2F..._200x200.png",
+ *     "x512": "https://cdn.smartlinks.app/sit2F..._512x512.png"
+ *   },
+ *   "id": "7k1cGErrlmQ94J8yDlVj",
+ *   "site": "ChaseAtlantic",
+ *   "cleanName": "Screenshot 2025-09-15 at 15.21"
+ * }
  */
-export interface AssetResponse {
+export interface Asset {
+    /** Unique identifier for the asset */
     id: string;
-    name: string;
+    /** The public URL to access the asset */
     url: string;
+    /** Original filename */
+    name: string;
+    /** MIME type (e.g., 'image/jpeg', 'video/mp4') */
+    mimeType?: string;
+    /** File size in bytes */
+    size?: number;
+    /** When the asset was uploaded */
+    createdAt?: string;
+    /** Any custom metadata attached during upload */
+    metadata?: Record<string, any>;
+    /** Optional: broader classification like 'Image' or 'Video' */
+    assetType?: string;
+    /** Optional: file extension/type shorthand (e.g., 'png') */
+    type?: string;
+    /** Optional: owning collection identifier */
+    collectionId?: string;
+    /** Optional: content hash */
+    hash?: string;
+    /** Optional: CDN thumbnail URLs */
+    thumbnails?: {
+        x100?: string;
+        x200?: string;
+        x512?: string;
+        [key: string]: string | undefined;
+    };
+    /** Optional: site identifier alias */
+    site?: string;
+    /** Optional: prettified name */
+    cleanName?: string;
+}
+export type AssetResponse = Asset;
+export interface UploadAssetOptions {
+    /** The file to upload (from input[type="file"] or drag-drop) */
+    file: File;
+    /** Where to attach the asset */
+    scope: {
+        type: 'collection';
+        collectionId: string;
+    } | {
+        type: 'product';
+        collectionId: string;
+        productId: string;
+    } | {
+        type: 'proof';
+        collectionId: string;
+        productId: string;
+        proofId: string;
+    };
+    /** Optional: Custom filename (defaults to file.name) */
+    name?: string;
+    /** Optional: Custom metadata to store with the asset */
+    metadata?: Record<string, any>;
+    /** Optional: Progress callback (0-100) */
+    onProgress?: (percent: number) => void;
+    /** Optional: App ID for scoping to a specific microapp */
+    appId?: string;
+}
+export interface ListAssetsOptions {
+    scope: {
+        type: 'collection';
+        collectionId: string;
+    } | {
+        type: 'product';
+        collectionId: string;
+        productId: string;
+    } | {
+        type: 'proof';
+        collectionId: string;
+        productId: string;
+        proofId: string;
+    };
+    /** Filter by app ID */
+    appId?: string;
+    /** Filter by MIME type prefix (e.g., 'image/', 'video/') */
+    mimeTypePrefix?: string;
+    /** Pagination */
+    limit?: number;
+    offset?: number;
+}
+export interface GetAssetOptions {
+    assetId: string;
+    scope: {
+        type: 'collection';
+        collectionId: string;
+    } | {
+        type: 'product';
+        collectionId: string;
+        productId: string;
+    } | {
+        type: 'proof';
+        collectionId: string;
+        productId: string;
+        proofId: string;
+    };
+}
+export interface RemoveAssetOptions {
+    assetId: string;
+    scope: {
+        type: 'collection';
+        collectionId: string;
+    } | {
+        type: 'product';
+        collectionId: string;
+        productId: string;
+    } | {
+        type: 'proof';
+        collectionId: string;
+        productId: string;
+        proofId: string;
+    };
 }

package/dist/types/contact.d.ts

@@ -50,3 +50,28 @@ export interface UserSearchResponse {
     contact: ContactResponse | null;
     existsAsContact: boolean;
 }
+export interface ContactPublic {
+    contactId: string;
+    firstName?: string | null;
+    lastName?: string | null;
+    displayName?: string | null;
+    company?: string | null;
+    avatarUrl?: string | null;
+    locale?: string | null;
+    timezone?: string | null;
+    email?: string | null;
+    phone?: string | null;
+    externalIds?: Record<string, any>;
+    customFields?: ContactCustomFields;
+}
+export type ContactPatch = Partial<Pick<Contact, "firstName" | "lastName" | "displayName" | "company" | "avatarUrl" | "locale" | "timezone" | "email" | "phone" | "externalIds">> & {
+    customFields?: ContactCustomFields;
+};
+export interface PublicGetMyContactResponse {
+    ok: boolean;
+    contact: ContactPublic | null;
+}
+export interface PublicUpdateMyContactResponse {
+    ok: boolean;
+    contact: ContactPublic;
+}

package/dist/types/template.d.ts

@@ -3,7 +3,7 @@ export interface TemplateBase {
     collectionId: string;
     name: string;
     description?: string;
-    type: string;
+    type: 'pdf' | 'email' | 'multichannel' | 'label';
     resizeMode?: string;
     pdf?: {
         base: {
@@ -11,6 +11,26 @@ export interface TemplateBase {
         };
         orientation: 'portrait' | 'landscape';
     };
+    channels?: {
+        email?: {
+            subject: string;
+            body: string;
+        };
+        sms?: {
+            body: string;
+        };
+        push: {
+            title: string;
+            body: string;
+            url?: string;
+            iconUrl?: string;
+        };
+        wallet?: {
+            header: string;
+            body: string;
+            imageUri?: string;
+        };
+    };
     subject?: string;
     body?: string;
     css?: string;

package/package.json

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