@proveanything/smartlinks 1.3.29 → 1.3.31

package/dist/api/appConfiguration.d.ts

@@ -1,4 +1,3 @@
-import { AppManifest } from "../types/appManifest";
 export type AppConfigOptions = {
     appId: string;
     collectionId?: string;
@@ -20,30 +19,4 @@ export declare namespace appConfiguration {
     function getDataItem(opts: AppConfigOptions): Promise<any>;
     function setDataItem(opts: AppConfigOptions): Promise<any>;
     function deleteDataItem(opts: AppConfigOptions): Promise<void>;
-    /**
-     * Fetches an app's manifest file through the proxy API.
-     * The manifest is cached on the server for 5 minutes.
-     *
-     * @param manifestUrl - The full URL to the manifest file (e.g., 'https://smartlinks.app/apps/my-app/v1.0.0/app.manifest.json')
-     * @param force - If true, bypasses cache and fetches fresh manifest
-     * @returns Promise resolving to the manifest object, or empty object if not found
-     * @throws ErrorResponse if the request fails
-     *
-     * @example
-     * ```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);
-     * ```
-     */
-    function getManifest(manifestUrl: string, force?: boolean): Promise<AppManifest>;
 }

package/dist/api/appConfiguration.js

@@ -88,37 +88,4 @@ export var appConfiguration;
         return del(path);
     }
     appConfiguration.deleteDataItem = deleteDataItem;
-    /**
-     * Fetches an app's manifest file through the proxy API.
-     * The manifest is cached on the server for 5 minutes.
-     *
-     * @param manifestUrl - The full URL to the manifest file (e.g., 'https://smartlinks.app/apps/my-app/v1.0.0/app.manifest.json')
-     * @param force - If true, bypasses cache and fetches fresh manifest
-     * @returns Promise resolving to the manifest object, or empty object if not found
-     * @throws ErrorResponse if the request fails
-     *
-     * @example
-     * ```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);
-     * ```
-     */
-    async function getManifest(manifestUrl, force) {
-        let path = `/public/app/manifest?url=${encodeURIComponent(manifestUrl)}`;
-        if (force) {
-            path += '&force=true';
-        }
-        return request(path);
-    }
-    appConfiguration.getManifest = getManifest;
 })(appConfiguration || (appConfiguration = {}));

package/dist/api/collection.d.ts

@@ -1,4 +1,5 @@
 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.
@@ -35,6 +36,43 @@ 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

@@ -56,10 +56,54 @@ export var collection;
      * @throws ErrorResponse if the request fails
      */
     async function getAppsConfig(collectionId) {
-        const path = `/public/collection/${encodeURIComponent(collectionId)}/apps-config`;
+        const path = `/v1/public/collection/${encodeURIComponent(collectionId)}/app/config`;
         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 = `/v1/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.29  |  Generated: 2026-02-14T14:15:49.096Z
+Version: 1.3.31  |  Generated: 2026-02-15T09:18:19.351Z
 
 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)
@@ -3907,9 +3932,6 @@ Post a chat message to the AI (admin or public)
 
 **deleteDataItem**(opts: AppConfigOptions) → `Promise<void>`
 
-**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); ```
-
 ### appRecord
 
 **get**(collectionId: string, appId: string) → `Promise<any>`
@@ -4280,6 +4302,10 @@ 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/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.31  |  Generated: 2026-02-15T09:18:19.351Z
 
 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)
@@ -3907,9 +3932,6 @@ Post a chat message to the AI (admin or public)
 
 **deleteDataItem**(opts: AppConfigOptions) → `Promise<void>`
 
-**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); ```
-
 ### appRecord
 
 **get**(collectionId: string, appId: string) → `Promise<any>`
@@ -4280,6 +4302,10 @@ 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.29",
+  "version": "1.3.31",
   "description": "Official JavaScript/TypeScript SDK for the Smartlinks API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",