@proveanything/smartlinks 1.3.32 → 1.3.34

package/dist/api/appConfiguration.d.ts

@@ -1,3 +1,4 @@
+import { CollectionWidgetsResponse, GetCollectionWidgetsOptions } from "../types/appManifest";
 export type AppConfigOptions = {
     appId: string;
     collectionId?: string;
@@ -19,4 +20,41 @@ export declare namespace appConfiguration {
     function getDataItem(opts: AppConfigOptions): Promise<any>;
     function setDataItem(opts: AppConfigOptions): Promise<any>;
     function deleteDataItem(opts: AppConfigOptions): Promise<void>;
+    /**
+     * Fetches ALL widget data (manifests + bundle files) for a collection in one call.
+     * Returns everything needed to render widgets with zero additional requests.
+     *
+     * This solves N+1 query problems by fetching manifests, JavaScript bundles,
+     * and CSS files in parallel on the server.
+     *
+     * @param collectionId - The collection ID
+     * @param options - Optional settings (force: bypass cache)
+     * @returns Promise resolving to collection widgets with manifests and bundle files
+     * @throws ErrorResponse if the request fails
+     *
+     * @example
+     * ```typescript
+     * // Fetch all widget data for a collection
+     * const { apps } = await Api.AppConfiguration.getWidgets(collectionId);
+     * // Returns: [{ appId, manifestUrl, manifest, bundleSource, bundleCss }, ...]
+     *
+     * // Convert bundle source to dynamic imports
+     * for (const app of apps) {
+     *   const blob = new Blob([app.bundleSource], { type: 'application/javascript' });
+     *   const blobUrl = URL.createObjectURL(blob);
+     *   const widgetModule = await import(blobUrl);
+     *
+     *   // Inject CSS if present
+     *   if (app.bundleCss) {
+     *     const styleTag = document.createElement('style');
+     *     styleTag.textContent = app.bundleCss;
+     *     document.head.appendChild(styleTag);
+     *   }
+     * }
+     *
+     * // Force refresh all widgets
+     * const { apps } = await Api.AppConfiguration.getWidgets(collectionId, { force: true });
+     * ```
+     */
+    function getWidgets(collectionId: string, options?: GetCollectionWidgetsOptions): Promise<CollectionWidgetsResponse>;
 }

package/dist/api/appConfiguration.js

@@ -88,4 +88,48 @@ export var appConfiguration;
         return del(path);
     }
     appConfiguration.deleteDataItem = deleteDataItem;
+    /**
+     * Fetches ALL widget data (manifests + bundle files) for a collection in one call.
+     * Returns everything needed to render widgets with zero additional requests.
+     *
+     * This solves N+1 query problems by fetching manifests, JavaScript bundles,
+     * and CSS files in parallel on the server.
+     *
+     * @param collectionId - The collection ID
+     * @param options - Optional settings (force: bypass cache)
+     * @returns Promise resolving to collection widgets with manifests and bundle files
+     * @throws ErrorResponse if the request fails
+     *
+     * @example
+     * ```typescript
+     * // Fetch all widget data for a collection
+     * const { apps } = await Api.AppConfiguration.getWidgets(collectionId);
+     * // Returns: [{ appId, manifestUrl, manifest, bundleSource, bundleCss }, ...]
+     *
+     * // Convert bundle source to dynamic imports
+     * for (const app of apps) {
+     *   const blob = new Blob([app.bundleSource], { type: 'application/javascript' });
+     *   const blobUrl = URL.createObjectURL(blob);
+     *   const widgetModule = await import(blobUrl);
+     *
+     *   // Inject CSS if present
+     *   if (app.bundleCss) {
+     *     const styleTag = document.createElement('style');
+     *     styleTag.textContent = app.bundleCss;
+     *     document.head.appendChild(styleTag);
+     *   }
+     * }
+     *
+     * // Force refresh all widgets
+     * const { apps } = await Api.AppConfiguration.getWidgets(collectionId, { force: true });
+     * ```
+     */
+    async function getWidgets(collectionId, options) {
+        let path = `/public/collection/${encodeURIComponent(collectionId)}/app/widgets`;
+        if (options === null || options === void 0 ? void 0 : options.force) {
+            path += '?force=true';
+        }
+        return request(path);
+    }
+    appConfiguration.getWidgets = getWidgets;
 })(appConfiguration || (appConfiguration = {}));

package/dist/api/appRecord.js

@@ -4,25 +4,25 @@ export var appRecord;
 (function (appRecord) {
     // Get app record (admin only)
     async function get(collectionId, appId) {
-        const path = `/api/v1/admin/collection/${encodeURIComponent(collectionId)}/app/${encodeURIComponent(appId)}`;
+        const path = `/admin/collection/${encodeURIComponent(collectionId)}/app/${encodeURIComponent(appId)}`;
         return request(path);
     }
     appRecord.get = get;
     // Create app record (admin only)
     async function create(collectionId, appId, data) {
-        const path = `/api/v1/admin/collection/${encodeURIComponent(collectionId)}/app/${encodeURIComponent(appId)}`;
+        const path = `/admin/collection/${encodeURIComponent(collectionId)}/app/${encodeURIComponent(appId)}`;
         return post(path, data);
     }
     appRecord.create = create;
     // Update app record (admin only)
     async function update(collectionId, appId, data) {
-        const path = `/api/v1/admin/collection/${encodeURIComponent(collectionId)}/app/${encodeURIComponent(appId)}`;
+        const path = `/admin/collection/${encodeURIComponent(collectionId)}/app/${encodeURIComponent(appId)}`;
         return put(path, data);
     }
     appRecord.update = update;
     // Delete app record (admin only)
     async function remove(collectionId, appId) {
-        const path = `/api/v1/admin/collection/${encodeURIComponent(collectionId)}/app/${encodeURIComponent(appId)}`;
+        const path = `/admin/collection/${encodeURIComponent(collectionId)}/app/${encodeURIComponent(appId)}`;
         return del(path);
     }
     appRecord.remove = remove;

package/dist/api/asset.d.ts

@@ -1,4 +1,4 @@
-import { Asset, AssetResponse, UploadAssetOptions, ListAssetsOptions, GetAssetOptions, RemoveAssetOptions } from "../types/asset";
+import { Asset, AssetResponse, UploadAssetOptions, UploadFromUrlOptions, ListAssetsOptions, GetAssetOptions, RemoveAssetOptions } from "../types/asset";
 export declare namespace asset {
     /**
      * Error type for asset uploads
@@ -14,6 +14,34 @@ export declare namespace asset {
      * @throws AssetUploadError if upload fails
      */
     function upload(options: UploadAssetOptions): Promise<Asset>;
+    /**
+     * Upload an asset from a URL
+     * The server will fetch the file from the provided URL and store it permanently in your CDN.
+     * This solves CORS issues and ensures files are permanently stored.
+     *
+     * @param options - Upload options including URL and scope
+     * @returns The uploaded asset with its CDN URL
+     * @throws AssetUploadError if upload fails
+     *
+     * @example
+     * ```typescript
+     * // Upload AI-generated image
+     * const asset = await asset.uploadFromUrl({
+     *   url: 'https://oaidalleapiprodscus.blob.core.windows.net/...',
+     *   scope: { type: 'collection', collectionId: 'my-collection' },
+     *   metadata: { name: 'AI Generated Image', app: 'gallery' }
+     * });
+     *
+     * // Upload stock photo
+     * const asset = await asset.uploadFromUrl({
+     *   url: 'https://images.unsplash.com/photo-...',
+     *   scope: { type: 'product', collectionId: 'my-collection', productId: 'wine-bottle' },
+     *   folder: 'images',
+     *   metadata: { name: 'Product Photo' }
+     * });
+     * ```
+     */
+    function uploadFromUrl(options: UploadFromUrlOptions): 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>;

package/dist/api/asset.js

@@ -107,6 +107,58 @@ export var asset;
         }
     }
     asset.upload = upload;
+    /**
+     * Upload an asset from a URL
+     * The server will fetch the file from the provided URL and store it permanently in your CDN.
+     * This solves CORS issues and ensures files are permanently stored.
+     *
+     * @param options - Upload options including URL and scope
+     * @returns The uploaded asset with its CDN URL
+     * @throws AssetUploadError if upload fails
+     *
+     * @example
+     * ```typescript
+     * // Upload AI-generated image
+     * const asset = await asset.uploadFromUrl({
+     *   url: 'https://oaidalleapiprodscus.blob.core.windows.net/...',
+     *   scope: { type: 'collection', collectionId: 'my-collection' },
+     *   metadata: { name: 'AI Generated Image', app: 'gallery' }
+     * });
+     *
+     * // Upload stock photo
+     * const asset = await asset.uploadFromUrl({
+     *   url: 'https://images.unsplash.com/photo-...',
+     *   scope: { type: 'product', collectionId: 'my-collection', productId: 'wine-bottle' },
+     *   folder: 'images',
+     *   metadata: { name: 'Product Photo' }
+     * });
+     * ```
+     */
+    async function uploadFromUrl(options) {
+        const base = buildScopeBase(options.scope, !!options.admin);
+        let path = `${base}/asset`;
+        if (options.appId) {
+            const qp = new URLSearchParams({ appId: options.appId });
+            path += `?${qp.toString()}`;
+        }
+        const body = {
+            url: options.url
+        };
+        if (options.folder) {
+            body.folder = options.folder;
+        }
+        if (options.metadata) {
+            body.extraData = options.metadata;
+        }
+        try {
+            return await post(path, body);
+        }
+        catch (e) {
+            const msg = (e === null || e === void 0 ? void 0 : e.message) || 'URL upload failed';
+            throw new AssetUploadError(msg, 'UNKNOWN');
+        }
+    }
+    asset.uploadFromUrl = uploadFromUrl;
     function mapStatusToUploadErrorCode(status, serverCode) {
         if (status === 401 || status === 403)
             return 'UNAUTHORIZED';

package/dist/api/collection.d.ts

@@ -1,5 +1,4 @@
 import { CollectionResponse, CollectionCreateRequest, CollectionUpdateRequest, AppsConfigResponse } from "../types/collection";
-import { CollectionWidgetsResponse, GetCollectionWidgetsOptions } from "../types/appManifest";
 export declare namespace collection {
     /**
      * Retrieves a single Collection by its ID.
@@ -36,43 +35,6 @@ export declare namespace collection {
      * @throws ErrorResponse if the request fails
      */
     function getAppsConfig(collectionId: string): Promise<AppsConfigResponse>;
-    /**
-     * Fetches ALL widget data (manifests + bundle files) for a collection in one call.
-     * Returns everything needed to render widgets with zero additional requests.
-     *
-     * This solves N+1 query problems by fetching manifests, JavaScript bundles,
-     * and CSS files in parallel on the server.
-     *
-     * @param collectionId - The collection ID
-     * @param options - Optional settings (force: bypass cache)
-     * @returns Promise resolving to collection widgets with manifests and bundle files
-     * @throws ErrorResponse if the request fails
-     *
-     * @example
-     * ```typescript
-     * // Fetch all widget data for a collection
-     * const { apps } = await Api.Collection.getWidgets(collectionId);
-     * // Returns: [{ appId, manifestUrl, manifest, bundleSource, bundleCss }, ...]
-     *
-     * // Convert bundle source to dynamic imports
-     * for (const app of apps) {
-     *   const blob = new Blob([app.bundleSource], { type: 'application/javascript' });
-     *   const blobUrl = URL.createObjectURL(blob);
-     *   const widgetModule = await import(blobUrl);
-     *
-     *   // Inject CSS if present
-     *   if (app.bundleCss) {
-     *     const styleTag = document.createElement('style');
-     *     styleTag.textContent = app.bundleCss;
-     *     document.head.appendChild(styleTag);
-     *   }
-     * }
-     *
-     * // Force refresh all widgets
-     * const { apps } = await Api.Collection.getWidgets(collectionId, { force: true });
-     * ```
-     */
-    function getWidgets(collectionId: string, options?: GetCollectionWidgetsOptions): Promise<CollectionWidgetsResponse>;
     /**
      * Update a specific settings group for a collection (admin endpoint).
      * @param collectionId – Identifier of the collection

package/dist/api/collection.js

@@ -60,50 +60,6 @@ export var collection;
         return request(path);
     }
     collection.getAppsConfig = getAppsConfig;
-    /**
-     * Fetches ALL widget data (manifests + bundle files) for a collection in one call.
-     * Returns everything needed to render widgets with zero additional requests.
-     *
-     * This solves N+1 query problems by fetching manifests, JavaScript bundles,
-     * and CSS files in parallel on the server.
-     *
-     * @param collectionId - The collection ID
-     * @param options - Optional settings (force: bypass cache)
-     * @returns Promise resolving to collection widgets with manifests and bundle files
-     * @throws ErrorResponse if the request fails
-     *
-     * @example
-     * ```typescript
-     * // Fetch all widget data for a collection
-     * const { apps } = await Api.Collection.getWidgets(collectionId);
-     * // Returns: [{ appId, manifestUrl, manifest, bundleSource, bundleCss }, ...]
-     *
-     * // Convert bundle source to dynamic imports
-     * for (const app of apps) {
-     *   const blob = new Blob([app.bundleSource], { type: 'application/javascript' });
-     *   const blobUrl = URL.createObjectURL(blob);
-     *   const widgetModule = await import(blobUrl);
-     *
-     *   // Inject CSS if present
-     *   if (app.bundleCss) {
-     *     const styleTag = document.createElement('style');
-     *     styleTag.textContent = app.bundleCss;
-     *     document.head.appendChild(styleTag);
-     *   }
-     * }
-     *
-     * // Force refresh all widgets
-     * const { apps } = await Api.Collection.getWidgets(collectionId, { force: true });
-     * ```
-     */
-    async function getWidgets(collectionId, options) {
-        let path = `/public/collection/${encodeURIComponent(collectionId)}/app/widgets`;
-        if (options === null || options === void 0 ? void 0 : options.force) {
-            path += '?force=true';
-        }
-        return request(path);
-    }
-    collection.getWidgets = getWidgets;
     /**
      * Update a specific settings group for a collection (admin endpoint).
      * @param collectionId – Identifier of the collection

package/dist/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.3.32  |  Generated: 2026-02-15T09:31:59.881Z
+Version: 1.3.34  |  Generated: 2026-02-16T09:46:01.466Z
 
 This is a concise summary of all available API functions and types.
 
@@ -29,6 +29,7 @@ The Smartlinks SDK is organized into the following namespaces:
 - **batch** - Group products into batches; manage serial number ranges and lookups.
 - **crate** - Organize products in containers/crates for logistics and grouping.
 - **form** - Build and manage dynamic forms used by apps and workflows.
+- **appRecord** - Store and retrieve application-level records tied to a collection.
 - **appConfiguration** - Read/write app configuration and scoped data (collection/product/proof).
 
 — Identity & Access —
@@ -753,6 +754,9 @@ interface AIGenerateImageRequest {
   prompt: string
   provider?: string
   model?: string
+  * Requested image size.
+  * OpenAI supported values: '1024x1024', '1024x1792', '1792x1024'
+  * Other providers may support different sizes.
   size?: string
   [key: string]: any
 }
@@ -940,6 +944,21 @@ interface UploadAssetOptions {
 }
 ```
 
+**UploadFromUrlOptions** (interface)
+```typescript
+interface UploadFromUrlOptions {
+  url: string
+  scope:
+  | { type: 'collection'; collectionId: string }
+  | { type: 'product'; collectionId: string; productId: string }
+  | { type: 'proof'; collectionId: string; productId: string; proofId: string }
+  folder?: 'images' | 'videos' | 'documents'
+  metadata?: Record<string, any>
+  appId?: string
+  admin?: boolean
+}
+```
+
 **ListAssetsOptions** (interface)
 ```typescript
 interface ListAssetsOptions {
@@ -3931,38 +3950,55 @@ Post a chat message to the AI (admin or public)
 
 **deleteDataItem**(opts: AppConfigOptions) → `Promise<void>`
 
+**getWidgets**(collectionId: string,
+    options?: GetCollectionWidgetsOptions) → `Promise<CollectionWidgetsResponse>`
+Fetches ALL widget data (manifests + bundle files) for a collection in one call. Returns everything needed to render widgets with zero additional requests. This solves N+1 query problems by fetching manifests, JavaScript bundles, and CSS files in parallel on the server. ```typescript // Fetch all widget data for a collection const { apps } = await Api.AppConfiguration.getWidgets(collectionId); // Returns: [{ appId, manifestUrl, manifest, bundleSource, bundleCss }, ...] // Convert bundle source to dynamic imports for (const app of apps) { const blob = new Blob([app.bundleSource], { type: 'application/javascript' }); const blobUrl = URL.createObjectURL(blob); const widgetModule = await import(blobUrl); // Inject CSS if present if (app.bundleCss) { const styleTag = document.createElement('style'); styleTag.textContent = app.bundleCss; document.head.appendChild(styleTag); } } // Force refresh all widgets const { apps } = await Api.AppConfiguration.getWidgets(collectionId, { force: true }); ```
+
+### appRecord
+
+**get**(collectionId: string, appId: string) → `Promise<any>`
+
+**create**(collectionId: string, appId: string, data: any) → `Promise<any>`
+
+**update**(collectionId: string, appId: string, data: any) → `Promise<any>`
+
+**remove**(collectionId: string, appId: string) → `Promise<void>`
+
 ### asset
 
 **upload**(options: UploadAssetOptions) → `Promise<Asset>`
 Upload an asset file
 
+**uploadFromUrl**(options: UploadFromUrlOptions) → `Promise<Asset>`
+Upload an asset from a URL The server will fetch the file from the provided URL and store it permanently in your CDN. This solves CORS issues and ensures files are permanently stored. ```typescript // Upload AI-generated image const asset = await asset.uploadFromUrl({ url: 'https://oaidalleapiprodscus.blob.core.windows.net/...', scope: { type: 'collection', collectionId: 'my-collection' }, metadata: { name: 'AI Generated Image', app: 'gallery' } }); // Upload stock photo const asset = await asset.uploadFromUrl({ url: 'https://images.unsplash.com/photo-...', scope: { type: 'product', collectionId: 'my-collection', productId: 'wine-bottle' }, folder: 'images', metadata: { name: 'Product Photo' } }); ```
+
 **getForCollection**(collectionId: string,
     assetId: string) → `Promise<AssetResponse>`
-Upload an asset file
+Upload an asset from a URL The server will fetch the file from the provided URL and store it permanently in your CDN. This solves CORS issues and ensures files are permanently stored. ```typescript // Upload AI-generated image const asset = await asset.uploadFromUrl({ url: 'https://oaidalleapiprodscus.blob.core.windows.net/...', scope: { type: 'collection', collectionId: 'my-collection' }, metadata: { name: 'AI Generated Image', app: 'gallery' } }); // Upload stock photo const asset = await asset.uploadFromUrl({ url: 'https://images.unsplash.com/photo-...', scope: { type: 'product', collectionId: 'my-collection', productId: 'wine-bottle' }, folder: 'images', metadata: { name: 'Product Photo' } }); ```
 
 **listForCollection**(collectionId: string) → `Promise<AssetResponse[]>`
-Upload an asset file
+Upload an asset from a URL The server will fetch the file from the provided URL and store it permanently in your CDN. This solves CORS issues and ensures files are permanently stored. ```typescript // Upload AI-generated image const asset = await asset.uploadFromUrl({ url: 'https://oaidalleapiprodscus.blob.core.windows.net/...', scope: { type: 'collection', collectionId: 'my-collection' }, metadata: { name: 'AI Generated Image', app: 'gallery' } }); // Upload stock photo const asset = await asset.uploadFromUrl({ url: 'https://images.unsplash.com/photo-...', scope: { type: 'product', collectionId: 'my-collection', productId: 'wine-bottle' }, folder: 'images', metadata: { name: 'Product Photo' } }); ```
 
 **getForProduct**(collectionId: string,
     productId: string,
     assetId: string) → `Promise<AssetResponse>`
-Upload an asset file
+Upload an asset from a URL The server will fetch the file from the provided URL and store it permanently in your CDN. This solves CORS issues and ensures files are permanently stored. ```typescript // Upload AI-generated image const asset = await asset.uploadFromUrl({ url: 'https://oaidalleapiprodscus.blob.core.windows.net/...', scope: { type: 'collection', collectionId: 'my-collection' }, metadata: { name: 'AI Generated Image', app: 'gallery' } }); // Upload stock photo const asset = await asset.uploadFromUrl({ url: 'https://images.unsplash.com/photo-...', scope: { type: 'product', collectionId: 'my-collection', productId: 'wine-bottle' }, folder: 'images', metadata: { name: 'Product Photo' } }); ```
 
 **listForProduct**(collectionId: string,
     productId: string) → `Promise<AssetResponse[]>`
-Upload an asset file
+Upload an asset from a URL The server will fetch the file from the provided URL and store it permanently in your CDN. This solves CORS issues and ensures files are permanently stored. ```typescript // Upload AI-generated image const asset = await asset.uploadFromUrl({ url: 'https://oaidalleapiprodscus.blob.core.windows.net/...', scope: { type: 'collection', collectionId: 'my-collection' }, metadata: { name: 'AI Generated Image', app: 'gallery' } }); // Upload stock photo const asset = await asset.uploadFromUrl({ url: 'https://images.unsplash.com/photo-...', scope: { type: 'product', collectionId: 'my-collection', productId: 'wine-bottle' }, folder: 'images', metadata: { name: 'Product Photo' } }); ```
 
 **getForProof**(collectionId: string,
     productId: string,
     proofId: string,
     assetId: string) → `Promise<AssetResponse>`
-Upload an asset file
+Upload an asset from a URL The server will fetch the file from the provided URL and store it permanently in your CDN. This solves CORS issues and ensures files are permanently stored. ```typescript // Upload AI-generated image const asset = await asset.uploadFromUrl({ url: 'https://oaidalleapiprodscus.blob.core.windows.net/...', scope: { type: 'collection', collectionId: 'my-collection' }, metadata: { name: 'AI Generated Image', app: 'gallery' } }); // Upload stock photo const asset = await asset.uploadFromUrl({ url: 'https://images.unsplash.com/photo-...', scope: { type: 'product', collectionId: 'my-collection', productId: 'wine-bottle' }, folder: 'images', metadata: { name: 'Product Photo' } }); ```
 
 **listForProof**(collectionId: string,
     productId: string,
     proofId: string,
     appId?: string) → `Promise<AssetResponse[]>`
-Upload an asset file
+Upload an asset from a URL The server will fetch the file from the provided URL and store it permanently in your CDN. This solves CORS issues and ensures files are permanently stored. ```typescript // Upload AI-generated image const asset = await asset.uploadFromUrl({ url: 'https://oaidalleapiprodscus.blob.core.windows.net/...', scope: { type: 'collection', collectionId: 'my-collection' }, metadata: { name: 'AI Generated Image', app: 'gallery' } }); // Upload stock photo const asset = await asset.uploadFromUrl({ url: 'https://images.unsplash.com/photo-...', scope: { type: 'product', collectionId: 'my-collection', productId: 'wine-bottle' }, folder: 'images', metadata: { name: 'Product Photo' } }); ```
 
 **uploadAsset**(collectionId: string,
     productId: string,
@@ -4291,10 +4327,6 @@ Retrieve a specific settings group for a collection (public endpoint).
 **getAppsConfig**(collectionId: string) → `Promise<AppsConfigResponse>`
 Retrieve all configured app module definitions for a collection (public endpoint).
 
-**getWidgets**(collectionId: string,
-    options?: GetCollectionWidgetsOptions) → `Promise<CollectionWidgetsResponse>`
-Fetches ALL widget data (manifests + bundle files) for a collection in one call. Returns everything needed to render widgets with zero additional requests. This solves N+1 query problems by fetching manifests, JavaScript bundles, and CSS files in parallel on the server. ```typescript // Fetch all widget data for a collection const { apps } = await Api.Collection.getWidgets(collectionId); // Returns: [{ appId, manifestUrl, manifest, bundleSource, bundleCss }, ...] // Convert bundle source to dynamic imports for (const app of apps) { const blob = new Blob([app.bundleSource], { type: 'application/javascript' }); const blobUrl = URL.createObjectURL(blob); const widgetModule = await import(blobUrl); // Inject CSS if present if (app.bundleCss) { const styleTag = document.createElement('style'); styleTag.textContent = app.bundleCss; document.head.appendChild(styleTag); } } // Force refresh all widgets const { apps } = await Api.Collection.getWidgets(collectionId, { force: true }); ```
-
 **updateSettings**(collectionId: string, settingGroup: string, settings: any) → `Promise<any>`
 Update a specific settings group for a collection (admin endpoint).
 

package/dist/types/ai.d.ts

@@ -348,7 +348,11 @@ export interface AIGenerateImageRequest {
     provider?: string;
     /** Optional model name to use for image generation */
     model?: string;
-    /** Requested image size, e.g. '1024x1024' */
+    /**
+     * Requested image size.
+     * OpenAI supported values: '1024x1024', '1024x1792', '1792x1024'
+     * Other providers may support different sizes.
+     */
     size?: string;
     /** Additional provider/model-specific options */
     [key: string]: any;

package/dist/types/asset.d.ts

@@ -88,6 +88,36 @@ export interface UploadAssetOptions {
     /** Optional: Upload via admin route instead of public */
     admin?: boolean;
 }
+/**
+ * Options for uploading an asset from a URL
+ * The server will fetch the file from the URL and store it in your CDN
+ */
+export interface UploadFromUrlOptions {
+    /** The URL of the file to fetch and upload */
+    url: string;
+    /** 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: Storage folder ('images', 'videos', 'documents') */
+    folder?: 'images' | 'videos' | 'documents';
+    /** Optional: Custom metadata to store with the asset */
+    metadata?: Record<string, any>;
+    /** Optional: App ID for scoping to a specific microapp */
+    appId?: string;
+    /** Optional: Upload via admin route instead of public */
+    admin?: boolean;
+}
 export interface ListAssetsOptions {
     scope: {
         type: 'collection';

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.3.32  |  Generated: 2026-02-15T09:31:59.881Z
+Version: 1.3.34  |  Generated: 2026-02-16T09:46:01.466Z
 
 This is a concise summary of all available API functions and types.
 
@@ -29,6 +29,7 @@ The Smartlinks SDK is organized into the following namespaces:
 - **batch** - Group products into batches; manage serial number ranges and lookups.
 - **crate** - Organize products in containers/crates for logistics and grouping.
 - **form** - Build and manage dynamic forms used by apps and workflows.
+- **appRecord** - Store and retrieve application-level records tied to a collection.
 - **appConfiguration** - Read/write app configuration and scoped data (collection/product/proof).
 
 — Identity & Access —
@@ -753,6 +754,9 @@ interface AIGenerateImageRequest {
   prompt: string
   provider?: string
   model?: string
+  * Requested image size.
+  * OpenAI supported values: '1024x1024', '1024x1792', '1792x1024'
+  * Other providers may support different sizes.
   size?: string
   [key: string]: any
 }
@@ -940,6 +944,21 @@ interface UploadAssetOptions {
 }
 ```
 
+**UploadFromUrlOptions** (interface)
+```typescript
+interface UploadFromUrlOptions {
+  url: string
+  scope:
+  | { type: 'collection'; collectionId: string }
+  | { type: 'product'; collectionId: string; productId: string }
+  | { type: 'proof'; collectionId: string; productId: string; proofId: string }
+  folder?: 'images' | 'videos' | 'documents'
+  metadata?: Record<string, any>
+  appId?: string
+  admin?: boolean
+}
+```
+
 **ListAssetsOptions** (interface)
 ```typescript
 interface ListAssetsOptions {
@@ -3931,38 +3950,55 @@ Post a chat message to the AI (admin or public)
 
 **deleteDataItem**(opts: AppConfigOptions) → `Promise<void>`
 
+**getWidgets**(collectionId: string,
+    options?: GetCollectionWidgetsOptions) → `Promise<CollectionWidgetsResponse>`
+Fetches ALL widget data (manifests + bundle files) for a collection in one call. Returns everything needed to render widgets with zero additional requests. This solves N+1 query problems by fetching manifests, JavaScript bundles, and CSS files in parallel on the server. ```typescript // Fetch all widget data for a collection const { apps } = await Api.AppConfiguration.getWidgets(collectionId); // Returns: [{ appId, manifestUrl, manifest, bundleSource, bundleCss }, ...] // Convert bundle source to dynamic imports for (const app of apps) { const blob = new Blob([app.bundleSource], { type: 'application/javascript' }); const blobUrl = URL.createObjectURL(blob); const widgetModule = await import(blobUrl); // Inject CSS if present if (app.bundleCss) { const styleTag = document.createElement('style'); styleTag.textContent = app.bundleCss; document.head.appendChild(styleTag); } } // Force refresh all widgets const { apps } = await Api.AppConfiguration.getWidgets(collectionId, { force: true }); ```
+
+### appRecord
+
+**get**(collectionId: string, appId: string) → `Promise<any>`
+
+**create**(collectionId: string, appId: string, data: any) → `Promise<any>`
+
+**update**(collectionId: string, appId: string, data: any) → `Promise<any>`
+
+**remove**(collectionId: string, appId: string) → `Promise<void>`
+
 ### asset
 
 **upload**(options: UploadAssetOptions) → `Promise<Asset>`
 Upload an asset file
 
+**uploadFromUrl**(options: UploadFromUrlOptions) → `Promise<Asset>`
+Upload an asset from a URL The server will fetch the file from the provided URL and store it permanently in your CDN. This solves CORS issues and ensures files are permanently stored. ```typescript // Upload AI-generated image const asset = await asset.uploadFromUrl({ url: 'https://oaidalleapiprodscus.blob.core.windows.net/...', scope: { type: 'collection', collectionId: 'my-collection' }, metadata: { name: 'AI Generated Image', app: 'gallery' } }); // Upload stock photo const asset = await asset.uploadFromUrl({ url: 'https://images.unsplash.com/photo-...', scope: { type: 'product', collectionId: 'my-collection', productId: 'wine-bottle' }, folder: 'images', metadata: { name: 'Product Photo' } }); ```
+
 **getForCollection**(collectionId: string,
     assetId: string) → `Promise<AssetResponse>`
-Upload an asset file
+Upload an asset from a URL The server will fetch the file from the provided URL and store it permanently in your CDN. This solves CORS issues and ensures files are permanently stored. ```typescript // Upload AI-generated image const asset = await asset.uploadFromUrl({ url: 'https://oaidalleapiprodscus.blob.core.windows.net/...', scope: { type: 'collection', collectionId: 'my-collection' }, metadata: { name: 'AI Generated Image', app: 'gallery' } }); // Upload stock photo const asset = await asset.uploadFromUrl({ url: 'https://images.unsplash.com/photo-...', scope: { type: 'product', collectionId: 'my-collection', productId: 'wine-bottle' }, folder: 'images', metadata: { name: 'Product Photo' } }); ```
 
 **listForCollection**(collectionId: string) → `Promise<AssetResponse[]>`
-Upload an asset file
+Upload an asset from a URL The server will fetch the file from the provided URL and store it permanently in your CDN. This solves CORS issues and ensures files are permanently stored. ```typescript // Upload AI-generated image const asset = await asset.uploadFromUrl({ url: 'https://oaidalleapiprodscus.blob.core.windows.net/...', scope: { type: 'collection', collectionId: 'my-collection' }, metadata: { name: 'AI Generated Image', app: 'gallery' } }); // Upload stock photo const asset = await asset.uploadFromUrl({ url: 'https://images.unsplash.com/photo-...', scope: { type: 'product', collectionId: 'my-collection', productId: 'wine-bottle' }, folder: 'images', metadata: { name: 'Product Photo' } }); ```
 
 **getForProduct**(collectionId: string,
     productId: string,
     assetId: string) → `Promise<AssetResponse>`
-Upload an asset file
+Upload an asset from a URL The server will fetch the file from the provided URL and store it permanently in your CDN. This solves CORS issues and ensures files are permanently stored. ```typescript // Upload AI-generated image const asset = await asset.uploadFromUrl({ url: 'https://oaidalleapiprodscus.blob.core.windows.net/...', scope: { type: 'collection', collectionId: 'my-collection' }, metadata: { name: 'AI Generated Image', app: 'gallery' } }); // Upload stock photo const asset = await asset.uploadFromUrl({ url: 'https://images.unsplash.com/photo-...', scope: { type: 'product', collectionId: 'my-collection', productId: 'wine-bottle' }, folder: 'images', metadata: { name: 'Product Photo' } }); ```
 
 **listForProduct**(collectionId: string,
     productId: string) → `Promise<AssetResponse[]>`
-Upload an asset file
+Upload an asset from a URL The server will fetch the file from the provided URL and store it permanently in your CDN. This solves CORS issues and ensures files are permanently stored. ```typescript // Upload AI-generated image const asset = await asset.uploadFromUrl({ url: 'https://oaidalleapiprodscus.blob.core.windows.net/...', scope: { type: 'collection', collectionId: 'my-collection' }, metadata: { name: 'AI Generated Image', app: 'gallery' } }); // Upload stock photo const asset = await asset.uploadFromUrl({ url: 'https://images.unsplash.com/photo-...', scope: { type: 'product', collectionId: 'my-collection', productId: 'wine-bottle' }, folder: 'images', metadata: { name: 'Product Photo' } }); ```
 
 **getForProof**(collectionId: string,
     productId: string,
     proofId: string,
     assetId: string) → `Promise<AssetResponse>`
-Upload an asset file
+Upload an asset from a URL The server will fetch the file from the provided URL and store it permanently in your CDN. This solves CORS issues and ensures files are permanently stored. ```typescript // Upload AI-generated image const asset = await asset.uploadFromUrl({ url: 'https://oaidalleapiprodscus.blob.core.windows.net/...', scope: { type: 'collection', collectionId: 'my-collection' }, metadata: { name: 'AI Generated Image', app: 'gallery' } }); // Upload stock photo const asset = await asset.uploadFromUrl({ url: 'https://images.unsplash.com/photo-...', scope: { type: 'product', collectionId: 'my-collection', productId: 'wine-bottle' }, folder: 'images', metadata: { name: 'Product Photo' } }); ```
 
 **listForProof**(collectionId: string,
     productId: string,
     proofId: string,
     appId?: string) → `Promise<AssetResponse[]>`
-Upload an asset file
+Upload an asset from a URL The server will fetch the file from the provided URL and store it permanently in your CDN. This solves CORS issues and ensures files are permanently stored. ```typescript // Upload AI-generated image const asset = await asset.uploadFromUrl({ url: 'https://oaidalleapiprodscus.blob.core.windows.net/...', scope: { type: 'collection', collectionId: 'my-collection' }, metadata: { name: 'AI Generated Image', app: 'gallery' } }); // Upload stock photo const asset = await asset.uploadFromUrl({ url: 'https://images.unsplash.com/photo-...', scope: { type: 'product', collectionId: 'my-collection', productId: 'wine-bottle' }, folder: 'images', metadata: { name: 'Product Photo' } }); ```
 
 **uploadAsset**(collectionId: string,
     productId: string,
@@ -4291,10 +4327,6 @@ Retrieve a specific settings group for a collection (public endpoint).
 **getAppsConfig**(collectionId: string) → `Promise<AppsConfigResponse>`
 Retrieve all configured app module definitions for a collection (public endpoint).
 
-**getWidgets**(collectionId: string,
-    options?: GetCollectionWidgetsOptions) → `Promise<CollectionWidgetsResponse>`
-Fetches ALL widget data (manifests + bundle files) for a collection in one call. Returns everything needed to render widgets with zero additional requests. This solves N+1 query problems by fetching manifests, JavaScript bundles, and CSS files in parallel on the server. ```typescript // Fetch all widget data for a collection const { apps } = await Api.Collection.getWidgets(collectionId); // Returns: [{ appId, manifestUrl, manifest, bundleSource, bundleCss }, ...] // Convert bundle source to dynamic imports for (const app of apps) { const blob = new Blob([app.bundleSource], { type: 'application/javascript' }); const blobUrl = URL.createObjectURL(blob); const widgetModule = await import(blobUrl); // Inject CSS if present if (app.bundleCss) { const styleTag = document.createElement('style'); styleTag.textContent = app.bundleCss; document.head.appendChild(styleTag); } } // Force refresh all widgets const { apps } = await Api.Collection.getWidgets(collectionId, { force: true }); ```
-
 **updateSettings**(collectionId: string, settingGroup: string, settings: any) → `Promise<any>`
 Update a specific settings group for a collection (admin endpoint).
 

package/package.json

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