@proveanything/smartlinks 1.3.29 → 1.3.30

package/dist/api/appConfiguration.d.ts

@@ -1,4 +1,4 @@
-import { AppManifest } from "../types/appManifest";
+import { AppManifest, CollectionWidgetsResponse, GetCollectionWidgetsOptions } from "../types/appManifest";
 export type AppConfigOptions = {
     appId: string;
     collectionId?: string;
@@ -46,4 +46,46 @@ export declare namespace appConfiguration {
      * ```
      */
     function getManifest(manifestUrl: string, force?: boolean): Promise<AppManifest>;
+    /**
+     * Fetches ALL widget data (manifests + bundle files) for a collection in one call.
+     * Returns everything needed to render widgets with zero additional requests.
+     *
+     * This is the recommended approach as it solves N+1 query problems and fetches
+     * 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.getCollectionWidgets(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);
+     *   }
+     *
+     *   // Now use widgetModule components
+     * }
+     *
+     * // Force refresh all widgets
+     * const { apps: freshApps } = await Api.AppConfiguration.getCollectionWidgets(
+     *   collectionId,
+     *   { force: true }
+     * );
+     * ```
+     */
+    function getCollectionWidgets(collectionId: string, options?: GetCollectionWidgetsOptions): Promise<CollectionWidgetsResponse>;
 }

package/dist/api/appConfiguration.js

@@ -121,4 +121,53 @@ export var appConfiguration;
         return request(path);
     }
     appConfiguration.getManifest = getManifest;
+    /**
+     * Fetches ALL widget data (manifests + bundle files) for a collection in one call.
+     * Returns everything needed to render widgets with zero additional requests.
+     *
+     * This is the recommended approach as it solves N+1 query problems and fetches
+     * 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.getCollectionWidgets(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);
+     *   }
+     *
+     *   // Now use widgetModule components
+     * }
+     *
+     * // Force refresh all widgets
+     * const { apps: freshApps } = await Api.AppConfiguration.getCollectionWidgets(
+     *   collectionId,
+     *   { force: true }
+     * );
+     * ```
+     */
+    async function getCollectionWidgets(collectionId, options) {
+        let path = `/v1/public/collection/${encodeURIComponent(collectionId)}/widgets`;
+        if (options === null || options === void 0 ? void 0 : options.force) {
+            path += '?force=true';
+        }
+        return request(path);
+    }
+    appConfiguration.getCollectionWidgets = getCollectionWidgets;
 })(appConfiguration || (appConfiguration = {}));

package/dist/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.3.29  |  Generated: 2026-02-14T14:15:49.096Z
+Version: 1.3.30  |  Generated: 2026-02-14T14:44:14.267Z
 
 This is a concise summary of all available API functions and types.
 
@@ -873,6 +873,31 @@ interface AppManifest {
 }
 ```
 
+**CollectionWidget** (interface)
+```typescript
+interface CollectionWidget {
+  appId: string;
+  manifestUrl: string;
+  manifest: AppManifest;
+  bundleSource: string;
+  bundleCss?: string; // Optional CSS file
+}
+```
+
+**CollectionWidgetsResponse** (interface)
+```typescript
+interface CollectionWidgetsResponse {
+  apps: CollectionWidget[];
+}
+```
+
+**GetCollectionWidgetsOptions** (interface)
+```typescript
+interface GetCollectionWidgetsOptions {
+  force?: boolean; // Bypass cache and fetch fresh data
+}
+```
+
 ### asset
 
 **Asset** (interface)
@@ -3910,6 +3935,10 @@ Post a chat message to the AI (admin or public)
 **getManifest**(manifestUrl: string, force?: boolean) → `Promise<AppManifest>`
 Fetches an app's manifest file through the proxy API. The manifest is cached on the server for 5 minutes. ```typescript // Use with appsConfig const appsConfig = await Api.Collection.Public.getAppsConfig(collectionId); const app = appsConfig.apps[0]; if (app.manifestUrl) { const manifest = await Api.AppConfiguration.getManifest(app.manifestUrl); if (manifest.widgets) { console.log('Available widgets:', manifest.widgets); } } // Force refresh const freshManifest = await Api.AppConfiguration.getManifest(app.manifestUrl, true); ```
 
+**getCollectionWidgets**(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 is the recommended approach as it solves N+1 query problems and fetches manifests, JavaScript bundles, and CSS files in parallel on the server. ```typescript // Fetch all widget data for a collection const { apps } = await Api.AppConfiguration.getCollectionWidgets(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); } // Now use widgetModule components } // Force refresh all widgets const { apps: freshApps } = await Api.AppConfiguration.getCollectionWidgets( collectionId, { force: true } ); ```
+
 ### appRecord
 
 **get**(collectionId: string, appId: string) → `Promise<any>`

package/dist/types/appManifest.d.ts

@@ -78,3 +78,25 @@ export interface AppManifest {
     };
     [key: string]: any;
 }
+/**
+ * Single app widget data with manifest and bundle files
+ */
+export interface CollectionWidget {
+    appId: string;
+    manifestUrl: string;
+    manifest: AppManifest;
+    bundleSource: string;
+    bundleCss?: string;
+}
+/**
+ * Response from collection widgets endpoint
+ */
+export interface CollectionWidgetsResponse {
+    apps: CollectionWidget[];
+}
+/**
+ * Options for fetching collection widgets
+ */
+export interface GetCollectionWidgetsOptions {
+    force?: boolean;
+}

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.3.29  |  Generated: 2026-02-14T14:15:49.096Z
+Version: 1.3.30  |  Generated: 2026-02-14T14:44:14.267Z
 
 This is a concise summary of all available API functions and types.
 
@@ -873,6 +873,31 @@ interface AppManifest {
 }
 ```
 
+**CollectionWidget** (interface)
+```typescript
+interface CollectionWidget {
+  appId: string;
+  manifestUrl: string;
+  manifest: AppManifest;
+  bundleSource: string;
+  bundleCss?: string; // Optional CSS file
+}
+```
+
+**CollectionWidgetsResponse** (interface)
+```typescript
+interface CollectionWidgetsResponse {
+  apps: CollectionWidget[];
+}
+```
+
+**GetCollectionWidgetsOptions** (interface)
+```typescript
+interface GetCollectionWidgetsOptions {
+  force?: boolean; // Bypass cache and fetch fresh data
+}
+```
+
 ### asset
 
 **Asset** (interface)
@@ -3910,6 +3935,10 @@ Post a chat message to the AI (admin or public)
 **getManifest**(manifestUrl: string, force?: boolean) → `Promise<AppManifest>`
 Fetches an app's manifest file through the proxy API. The manifest is cached on the server for 5 minutes. ```typescript // Use with appsConfig const appsConfig = await Api.Collection.Public.getAppsConfig(collectionId); const app = appsConfig.apps[0]; if (app.manifestUrl) { const manifest = await Api.AppConfiguration.getManifest(app.manifestUrl); if (manifest.widgets) { console.log('Available widgets:', manifest.widgets); } } // Force refresh const freshManifest = await Api.AppConfiguration.getManifest(app.manifestUrl, true); ```
 
+**getCollectionWidgets**(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 is the recommended approach as it solves N+1 query problems and fetches manifests, JavaScript bundles, and CSS files in parallel on the server. ```typescript // Fetch all widget data for a collection const { apps } = await Api.AppConfiguration.getCollectionWidgets(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); } // Now use widgetModule components } // Force refresh all widgets const { apps: freshApps } = await Api.AppConfiguration.getCollectionWidgets( collectionId, { force: true } ); ```
+
 ### appRecord
 
 **get**(collectionId: string, appId: string) → `Promise<any>`

package/package.json

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