@proveanything/smartlinks 1.4.4 → 1.4.5

package/dist/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.4.4  |  Generated: 2026-02-20T22:46:39.365Z
+Version: 1.4.5  |  Generated: 2026-02-21T09:35:56.076Z
 
 This is a concise summary of all available API functions and types.
 
@@ -832,9 +832,20 @@ interface AppBundle {
 }
 ```
 
-**AppWidgetDefinition** (interface)
+**AppManifestFiles** (interface)
 ```typescript
-interface AppWidgetDefinition {
+interface AppManifestFiles {
+  js: {
+  umd: string;
+  esm?: string;
+  };
+  css?: string;
+}
+```
+
+**AppWidgetComponent** (interface)
+```typescript
+interface AppWidgetComponent {
   name: string;
   description?: string;
   sizes?: Array<'compact' | 'standard' | 'large' | string>;
@@ -842,12 +853,13 @@ interface AppWidgetDefinition {
   required?: string[];
   optional?: string[];
   };
+  settings?: Record<string, any>;
 }
 ```
 
-**AppContainerDefinition** (interface)
+**AppContainerComponent** (interface)
 ```typescript
-interface AppContainerDefinition {
+interface AppContainerComponent {
   name: string;
   description?: string;
   props?: {
@@ -868,8 +880,17 @@ interface AppManifest {
   platformRevision?: string;
   appId: string;
   };
-  widgets?: AppWidgetDefinition[];
-  containers?: AppContainerDefinition[];
+  * Filename of the admin configuration JSON (e.g. "app.admin.json").
+  * Present when the app ships an admin UI config.
+  admin?: string;
+  widgets?: {
+  files: AppManifestFiles;
+  components: AppWidgetComponent[];
+  };
+  containers?: {
+  files: AppManifestFiles;
+  components: AppContainerComponent[];
+  };
   setup?: {
   description?: string;
   questions?: Array<{
@@ -934,6 +955,7 @@ interface CollectionAppWidget {
   manifest: AppManifest;
   widget: AppBundle;
   container: AppBundle | null;
+  admin: string | null;
 }
 ```
 

package/dist/types/appManifest.d.ts

@@ -6,15 +6,15 @@
  * for inline content first and fall back to loading the URL.
  *
  *   if (bundle.source) {
- *     // inline JS — create a Blob URL or inject directly
+ *     // inline JS � create a Blob URL or inject directly
  *   } else if (bundle.js) {
  *     // load from URL
  *   }
  */
 export interface AppBundle {
-    /** URL to the JavaScript file — load if `source` is absent */
+    /** URL to the JavaScript file � load if `source` is absent */
     js: string | null;
-    /** URL to the CSS file — load if `styles` is absent */
+    /** URL to the CSS file � load if `styles` is absent */
     css: string | null;
     /** Inlined JavaScript source (present when server bundles it inline) */
     source?: string;
@@ -22,10 +22,20 @@ export interface AppBundle {
     styles?: string;
 }
 /**
- * A single widget defined in the manifest.
- * Presence of the `widgets` array means a widget bundle exists for this app.
+ * The files section inside a widgets or containers block.
  */
-export interface AppWidgetDefinition {
+export interface AppManifestFiles {
+    js: {
+        /** UMD bundle � used for script-tag / dynamic loading */
+        umd: string;
+        /** ESM bundle � used for native ES module loading */
+        esm?: string;
+    };
+    /** CSS file � absent if the bundle ships no styles */
+    css?: string;
+}
+/** A single widget component defined in the manifest */
+export interface AppWidgetComponent {
     name: string;
     description?: string;
     sizes?: Array<'compact' | 'standard' | 'large' | string>;
@@ -33,13 +43,11 @@ export interface AppWidgetDefinition {
         required?: string[];
         optional?: string[];
     };
+    /** JSON-Schema-style settings the widget accepts */
+    settings?: Record<string, any>;
 }
-/**
- * A single container defined in the manifest.
- * Presence of the `containers` array means a container bundle exists for this app.
- * Containers are full-page / embedded components (larger than widgets, no iframe needed).
- */
-export interface AppContainerDefinition {
+/** A single container component defined in the manifest */
+export interface AppContainerComponent {
     name: string;
     description?: string;
     props?: {
@@ -48,7 +56,7 @@ export interface AppContainerDefinition {
     };
 }
 /**
- * SmartLinks App Manifest — the app.manifest.json structure.
+ * SmartLinks App Manifest � the app.manifest.json structure.
  */
 export interface AppManifest {
     $schema?: string;
@@ -59,10 +67,21 @@ export interface AppManifest {
         platformRevision?: string;
         appId: string;
     };
-    /** Presence means a widget bundle (widgets.umd.js / widgets.css) exists */
-    widgets?: AppWidgetDefinition[];
-    /** Presence means a container bundle (containers.umd.js / containers.css) exists */
-    containers?: AppContainerDefinition[];
+    /**
+     * Filename of the admin configuration JSON (e.g. "app.admin.json").
+     * Present when the app ships an admin UI config.
+     */
+    admin?: string;
+    /** Widget bundle definition. Presence means a widget bundle exists for this app. */
+    widgets?: {
+        files: AppManifestFiles;
+        components: AppWidgetComponent[];
+    };
+    /** Container bundle definition. Presence means a container bundle exists. */
+    containers?: {
+        files: AppManifestFiles;
+        components: AppContainerComponent[];
+    };
     setup?: {
         description?: string;
         questions?: Array<{
@@ -133,10 +152,12 @@ export interface AppManifest {
 export interface CollectionAppWidget {
     appId: string;
     manifest: AppManifest;
-    /** Widget bundle — always present (apps without widgets are excluded from the response) */
+    /** Widget bundle � always present (apps without widgets are excluded from the response) */
     widget: AppBundle;
-    /** Container bundle — null when the app has no containers */
+    /** Container bundle � null when the app has no containers */
     container: AppBundle | null;
+    /** URL to the admin configuration JSON � null when the app has no admin config */
+    admin: string | null;
 }
 /**
  * Response from GET /api/v1/public/collection/:collectionId/widgets

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.4.4  |  Generated: 2026-02-20T22:46:39.365Z
+Version: 1.4.5  |  Generated: 2026-02-21T09:35:56.076Z
 
 This is a concise summary of all available API functions and types.
 
@@ -832,9 +832,20 @@ interface AppBundle {
 }
 ```
 
-**AppWidgetDefinition** (interface)
+**AppManifestFiles** (interface)
 ```typescript
-interface AppWidgetDefinition {
+interface AppManifestFiles {
+  js: {
+  umd: string;
+  esm?: string;
+  };
+  css?: string;
+}
+```
+
+**AppWidgetComponent** (interface)
+```typescript
+interface AppWidgetComponent {
   name: string;
   description?: string;
   sizes?: Array<'compact' | 'standard' | 'large' | string>;
@@ -842,12 +853,13 @@ interface AppWidgetDefinition {
   required?: string[];
   optional?: string[];
   };
+  settings?: Record<string, any>;
 }
 ```
 
-**AppContainerDefinition** (interface)
+**AppContainerComponent** (interface)
 ```typescript
-interface AppContainerDefinition {
+interface AppContainerComponent {
   name: string;
   description?: string;
   props?: {
@@ -868,8 +880,17 @@ interface AppManifest {
   platformRevision?: string;
   appId: string;
   };
-  widgets?: AppWidgetDefinition[];
-  containers?: AppContainerDefinition[];
+  * Filename of the admin configuration JSON (e.g. "app.admin.json").
+  * Present when the app ships an admin UI config.
+  admin?: string;
+  widgets?: {
+  files: AppManifestFiles;
+  components: AppWidgetComponent[];
+  };
+  containers?: {
+  files: AppManifestFiles;
+  components: AppContainerComponent[];
+  };
   setup?: {
   description?: string;
   questions?: Array<{
@@ -934,6 +955,7 @@ interface CollectionAppWidget {
   manifest: AppManifest;
   widget: AppBundle;
   container: AppBundle | null;
+  admin: string | null;
 }
 ```
 

package/package.json

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