@happyvertical/smrt-images 0.40.65 → 0.40.67

package/dist/smrt-knowledge.json

@@ -1,13 +1,14 @@
 {
   "schemaVersion": 1,
+  "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-images",
-  "packageVersion": "0.40.65",
+  "packageVersion": "0.40.67",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "fc02e979a0c0840689dd2f127934389f77582be2993ad0f50aa2dfd4354d84ac",
-    "packageJson": "00b953304665e7011341b9d2ea01bd28e44d3070839c72e76bf982c66982816f",
+    "manifest": "e363eecc4e6f5cf39077ddd0c658cfbe552a23d475e9b4f52b34d9ced6969c26",
+    "packageJson": "f4a13739e2b61dda40c513a4df39f7a59ed1a9e952c6058b4b7dccf29d8f9f5f",
     "agents": "b0cf63bd78f00cc1729ea7f1425291f8e23ab5591161cbbf0d08f4b16ace07fd"
   },
   "exports": [
@@ -16,7 +17,8 @@
     "./manifest.json",
     "./playground",
     "./svelte",
-    "./ui"
+    "./ui",
+    "./workbench"
   ],
   "dependencies": {
     "@happyvertical/ai": "catalog:",
@@ -122,7 +124,8 @@
           "name": "version",
           "type": "integer",
           "required": true,
-          "columnType": "INTEGER"
+          "columnType": "INTEGER",
+          "default": 1
         },
         {
           "name": "primaryVersionId",
@@ -198,19 +201,22 @@
           "name": "width",
           "type": "integer",
           "required": false,
-          "columnType": "INTEGER"
+          "columnType": "INTEGER",
+          "default": 0
         },
         {
           "name": "height",
           "type": "integer",
           "required": false,
-          "columnType": "INTEGER"
+          "columnType": "INTEGER",
+          "default": 0
         },
         {
           "name": "alt",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "default": ""
         }
       ],
       "relationships": [
@@ -304,6 +310,385 @@
         "toPlainObject",
         "toPublicJSON"
       ],
+      "methodSignatures": [
+        {
+          "name": "_setLoadedRelationship",
+          "params": [
+            "fieldName: string",
+            "value: any"
+          ],
+          "returns": "void"
+        },
+        {
+          "name": "associateWith",
+          "async": true,
+          "params": [
+            "metaType: string",
+            "metaId: string",
+            "role?: any"
+          ],
+          "returns": "Promise<AssetAssociation>"
+        },
+        {
+          "name": "classifyConstraintError",
+          "static": true,
+          "params": [
+            "message: string"
+          ],
+          "returns": "'unique' | 'not_null' | null"
+        },
+        {
+          "name": "clearEmbeddings",
+          "async": true,
+          "returns": "Promise<void>"
+        },
+        {
+          "name": "delete",
+          "async": true,
+          "returns": "Promise<void>"
+        },
+        {
+          "name": "describe",
+          "async": true,
+          "params": [
+            "options?: AiOperationOptions"
+          ],
+          "returns": "any"
+        },
+        {
+          "name": "destroy",
+          "returns": "void"
+        },
+        {
+          "name": "do",
+          "async": true,
+          "params": [
+            "instructions: string",
+            "options?: AiOperationOptions"
+          ],
+          "returns": "any"
+        },
+        {
+          "name": "executeToolCall",
+          "async": true,
+          "params": [
+            "toolCall: ToolCall"
+          ],
+          "returns": "Promise<ToolCallResult>"
+        },
+        {
+          "name": "forget",
+          "async": true,
+          "params": [
+            "options: object"
+          ],
+          "returns": "Promise<void>"
+        },
+        {
+          "name": "forgetScope",
+          "async": true,
+          "params": [
+            "options: object"
+          ],
+          "returns": "Promise<number>"
+        },
+        {
+          "name": "generateAltText",
+          "async": true,
+          "returns": "Promise<string>"
+        },
+        {
+          "name": "generateEmbeddings",
+          "async": true,
+          "params": [
+            "options?: GenerateEmbeddingsOptions"
+          ],
+          "returns": "Promise<void>"
+        },
+        {
+          "name": "getAiUsageSnapshot",
+          "returns": "AiUsageSnapshot | undefined"
+        },
+        {
+          "name": "getAssociations",
+          "async": true,
+          "returns": "Promise<AssetAssociation[]>"
+        },
+        {
+          "name": "getAvailableTools",
+          "returns": "AITool[]"
+        },
+        {
+          "name": "getBySlug",
+          "async": true,
+          "static": true,
+          "params": [
+            "_slug: string"
+          ],
+          "returns": "Promise<Asset | null>"
+        },
+        {
+          "name": "getDerivatives",
+          "async": true,
+          "returns": "Promise<Asset[]>"
+        },
+        {
+          "name": "getEmbedding",
+          "async": true,
+          "params": [
+            "fieldName: string",
+            "model?: string"
+          ],
+          "returns": "Promise<number[] | null>"
+        },
+        {
+          "name": "getExternalRef",
+          "params": [
+            "provider: string"
+          ],
+          "returns": "AssetExternalReference | null"
+        },
+        {
+          "name": "getExternalRefs",
+          "returns": "Record<string, AssetExternalReference>"
+        },
+        {
+          "name": "getFields",
+          "async": true,
+          "returns": "Promise<any>"
+        },
+        {
+          "name": "getId",
+          "async": true,
+          "returns": "any"
+        },
+        {
+          "name": "getMetadata",
+          "returns": "Record<string>"
+        },
+        {
+          "name": "getRelated",
+          "async": true,
+          "params": [
+            "fieldName: string",
+            "opts?: LoadRelatedOptions"
+          ],
+          "returns": "Promise<any>"
+        },
+        {
+          "name": "getSavedId",
+          "async": true,
+          "returns": "any"
+        },
+        {
+          "name": "getSlug",
+          "async": true,
+          "returns": "any"
+        },
+        {
+          "name": "getSource",
+          "async": true,
+          "returns": "Promise<Asset | null>"
+        },
+        {
+          "name": "getStatus",
+          "async": true,
+          "returns": "Promise<AssetStatus | null>"
+        },
+        {
+          "name": "getTags",
+          "async": true,
+          "returns": "Promise<Tag[]>"
+        },
+        {
+          "name": "getType",
+          "async": true,
+          "returns": "Promise<AssetType | null>"
+        },
+        {
+          "name": "hasStaleEmbeddings",
+          "async": true,
+          "returns": "Promise<boolean>"
+        },
+        {
+          "name": "hasTag",
+          "async": true,
+          "params": [
+            "tagSlug: string"
+          ],
+          "returns": "Promise<boolean>"
+        },
+        {
+          "name": "initialize",
+          "async": true,
+          "returns": "Promise"
+        },
+        {
+          "name": "is",
+          "async": true,
+          "params": [
+            "criteria: string",
+            "options?: AiOperationOptions"
+          ],
+          "returns": "any"
+        },
+        {
+          "name": "isHighResolution",
+          "returns": "boolean"
+        },
+        {
+          "name": "isRelatedLoaded",
+          "params": [
+            "fieldName: string"
+          ],
+          "returns": "boolean"
+        },
+        {
+          "name": "isSaved",
+          "async": true,
+          "returns": "any"
+        },
+        {
+          "name": "isValidImageFormat",
+          "returns": "boolean"
+        },
+        {
+          "name": "listAiUsage",
+          "async": true,
+          "params": [
+            "options?: AiUsageListOptions"
+          ],
+          "returns": "Promise<SmrtAiUsageRecord[]>"
+        },
+        {
+          "name": "loadDataFromDb",
+          "async": true,
+          "params": [
+            "data: Record<string>"
+          ],
+          "returns": "any"
+        },
+        {
+          "name": "loadFromId",
+          "async": true,
+          "returns": "any"
+        },
+        {
+          "name": "loadFromSlug",
+          "async": true,
+          "returns": "any"
+        },
+        {
+          "name": "loadRelated",
+          "async": true,
+          "params": [
+            "fieldName: string",
+            "opts?: LoadRelatedOptions"
+          ],
+          "returns": "Promise<any>"
+        },
+        {
+          "name": "loadRelatedMany",
+          "async": true,
+          "params": [
+            "fieldName: string",
+            "opts?: LoadRelatedOptions"
+          ],
+          "returns": "Promise<any[]>"
+        },
+        {
+          "name": "markAsPersisted",
+          "returns": "void"
+        },
+        {
+          "name": "mergeMetadata",
+          "params": [
+            "metadata: Record<string>"
+          ],
+          "returns": "void"
+        },
+        {
+          "name": "recall",
+          "async": true,
+          "params": [
+            "options: object"
+          ],
+          "returns": "Promise"
+        },
+        {
+          "name": "recallAll",
+          "async": true,
+          "params": [
+            "options?: object"
+          ],
+          "returns": "Promise<Map<string>>"
+        },
+        {
+          "name": "remember",
+          "async": true,
+          "params": [
+            "options: object"
+          ],
+          "returns": "Promise<void>"
+        },
+        {
+          "name": "requireInsertOnSave",
+          "returns": "void"
+        },
+        {
+          "name": "resetAiUsage",
+          "returns": "void"
+        },
+        {
+          "name": "save",
+          "async": true,
+          "returns": "any"
+        },
+        {
+          "name": "setExternalRef",
+          "params": [
+            "provider: string",
+            "reference: any"
+          ],
+          "returns": "void"
+        },
+        {
+          "name": "setMetadata",
+          "params": [
+            "metadata: Record<string>"
+          ],
+          "returns": "void"
+        },
+        {
+          "name": "summarizeAiUsage",
+          "async": true,
+          "params": [
+            "options?: AiUsageSummaryOptions"
+          ],
+          "returns": "Promise<Record<string, AiUsageStats>>"
+        },
+        {
+          "name": "toJSON",
+          "returns": "any"
+        },
+        {
+          "name": "toPlainObject",
+          "returns": "Record<string>"
+        },
+        {
+          "name": "toPublicJSON",
+          "params": [
+            "options?: PublicJsonOptions"
+          ],
+          "returns": "Record<string>"
+        }
+      ],
+      "tenant": {
+        "scoped": true,
+        "mode": "optional",
+        "field": "tenantId"
+      },
+      "tableStrategy": "sti",
       "surfaces": [
         {
           "kind": "api",
@@ -436,6 +821,81 @@
         "getPortrait",
         "getSquare"
       ],
+      "methodSignatures": [
+        {
+          "name": "findByTenant",
+          "async": true,
+          "params": [
+            "tenantId: string"
+          ],
+          "returns": "Promise<Image[]>"
+        },
+        {
+          "name": "findGlobal",
+          "async": true,
+          "returns": "Promise<Image[]>"
+        },
+        {
+          "name": "findWithGlobals",
+          "async": true,
+          "params": [
+            "tenantId: string"
+          ],
+          "returns": "Promise<Image[]>"
+        },
+        {
+          "name": "getByAspectRatio",
+          "async": true,
+          "params": [
+            "minRatio: number",
+            "maxRatio: number"
+          ],
+          "returns": "Promise<Image[]>"
+        },
+        {
+          "name": "getByMaxDimensions",
+          "async": true,
+          "params": [
+            "maxWidth: number",
+            "maxHeight: number"
+          ],
+          "returns": "Promise<Image[]>"
+        },
+        {
+          "name": "getByMinDimensions",
+          "async": true,
+          "params": [
+            "minWidth: number",
+            "minHeight: number"
+          ],
+          "returns": "Promise<Image[]>"
+        },
+        {
+          "name": "getHighResolution",
+          "async": true,
+          "returns": "Promise<Image[]>"
+        },
+        {
+          "name": "getLandscape",
+          "async": true,
+          "returns": "Promise<Image[]>"
+        },
+        {
+          "name": "getMissingAltText",
+          "async": true,
+          "returns": "Promise<Image[]>"
+        },
+        {
+          "name": "getPortrait",
+          "async": true,
+          "returns": "Promise<Image[]>"
+        },
+        {
+          "name": "getSquare",
+          "async": true,
+          "returns": "Promise<Image[]>"
+        }
+      ],
       "surfaces": [],
       "relationshipFeatures": [
         "uuidColumns"

package/dist/svelte/playground.d.ts

@@ -19,7 +19,6 @@ declare const _default: {
             mock: {
                 label: string;
             };
-            live?: undefined;
         };
     } | {
         id: string;
@@ -48,26 +47,7 @@ declare const _default: {
             mock: {
                 label: string;
             };
-            live?: undefined;
         };
-    } | {
-        id: string;
-        title: string;
-        description: string;
-        loadComponent: () => Promise<typeof import("./routes/ImageStudioRoute.svelte")>;
-        order: number;
-        tags: string[];
-        modes: {
-            live: {
-                label: string;
-                description: string;
-                props: {
-                    apiBaseUrl: string;
-                };
-            };
-            mock?: undefined;
-        };
-        props?: undefined;
     })[];
 };
 export default _default;

package/dist/svelte/playground.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playground.d.ts","sourceRoot":"","sources":["../../src/svelte/playground.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkEA,wBA6DE"}
+{"version":3,"file":"playground.d.ts","sourceRoot":"","sources":["../../src/svelte/playground.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,wBA2CE"}

package/dist/svelte/playground.js

@@ -1,20 +1,3 @@
-import { IMAGES_ROUTE_META } from './routes/shared.js';
-const DEFAULT_IMAGES_PLAYGROUND_API_BASE_URL = '/api/v1';
-function resolveImagesPlaygroundApiBaseUrl() {
-    const configuredViaGlobal = globalThis
-        .__SMRT_IMAGES_PLAYGROUND_API_BASE_URL__;
-    if (configuredViaGlobal) {
-        return configuredViaGlobal;
-    }
-    const browserLocation = globalThis.location;
-    if (browserLocation) {
-        const configuredViaQuery = new URLSearchParams(browserLocation.search).get('smrtImagesApiBaseUrl');
-        if (configuredViaQuery) {
-            return configuredViaQuery;
-        }
-    }
-    return DEFAULT_IMAGES_PLAYGROUND_API_BASE_URL;
-}
 function createPreviewImageUri(label, accent) {
     const svg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1280 720">
     <defs>
@@ -43,12 +26,11 @@ const sampleImage = {
     alt: 'Cargo cranes and harbor lights reflected at dusk.',
 };
 const loadImageEditor = () => import('./components/ImageEditor.svelte');
-const loadImageStudioRoute = () => import('./routes/ImageStudioRoute.svelte');
 const loadImageUploader = () => import('./components/ImageUploader.svelte');
 export default {
     packageName: '@happyvertical/smrt-images',
     displayName: 'Images',
-    description: IMAGES_ROUTE_META.studio.description,
+    description: 'Component previews for image acquisition, editing, and package UI states.',
     entries: [
         {
             id: 'image-uploader',
@@ -84,22 +66,5 @@ export default {
                 },
             },
         },
-        {
-            id: 'image-studio-route',
-            title: 'Image Studio Route',
-            description: 'Package-owned acquisition and editing flow backed by the generated images API.',
-            loadComponent: loadImageStudioRoute,
-            order: 3,
-            tags: ['route', 'images', 'admin'],
-            modes: {
-                live: {
-                    label: 'Live',
-                    description: 'Requires the images package dev server and generated routes. Override the base URL with ?smrtImagesApiBaseUrl=... or window.__SMRT_IMAGES_PLAYGROUND_API_BASE_URL__ when needed.',
-                    props: {
-                        apiBaseUrl: resolveImagesPlaygroundApiBaseUrl(),
-                    },
-                },
-            },
-        },
     ],
 };

package/dist/svelte/routes/ImageStudioRoute.svelte

@@ -1,18 +1,48 @@
 <script lang="ts">
 import { useI18n } from '@happyvertical/smrt-ui/i18n';
 import { M } from '../i18n.js';
-import type { ImageLike } from '../image-clients.js';
+import type {
+  ImageEditorClient,
+  ImageLike,
+  ImagesGalleryClient,
+} from '../image-clients.js';
 import { AssetsGallery, ImageEditor, ImageUploader } from '../index.js';
 
 const { t } = useI18n();
 
-let { apiBaseUrl = '/api/v1' }: { apiBaseUrl?: string } = $props();
+let {
+  apiBaseUrl = '/api/v1',
+  galleryClient = undefined,
+  editorClient = undefined,
+  initialImage = null,
+}: {
+  apiBaseUrl?: string;
+  galleryClient?: ImagesGalleryClient;
+  editorClient?: ImageEditorClient;
+  initialImage?: ImageLike | null;
+} = $props();
 
 type StudioImage = ImageLike;
 
 let selectedImage = $state<StudioImage | null>(null);
+let lastInitialImageId = $state<string | null>(null);
 let uploaderStatus = $state('No image selected from the uploader yet.');
 
+$effect(() => {
+  const nextInitialImageId = initialImage?.id || null;
+
+  if (nextInitialImageId === lastInitialImageId) {
+    return;
+  }
+
+  lastInitialImageId = nextInitialImageId;
+  selectedImage = initialImage;
+
+  if (initialImage) {
+    uploaderStatus = `Loaded “${initialImage.name}” from the workbench fixture.`;
+  }
+});
+
 function isPersistedImage(value: unknown): value is StudioImage {
   return (
     typeof value === 'object' &&
@@ -69,7 +99,12 @@ function handleEditorSave(image: StudioImage) {
     </div>
 
     <div class="images-route__card">
-      <ImageUploader {apiBaseUrl} onSelect={handleUploaderSelect} />
+      <ImageUploader
+        {apiBaseUrl}
+        {galleryClient}
+        {editorClient}
+        onSelect={handleUploaderSelect}
+      />
     </div>
   </section>
 
@@ -83,12 +118,17 @@ function handleEditorSave(image: StudioImage) {
 
     <div class="images-route__workspace-grid">
       <div class="images-route__card images-route__gallery">
-        <AssetsGallery {apiBaseUrl} onSelect={handleGallerySelect} />
+        <AssetsGallery
+          {apiBaseUrl}
+          client={galleryClient}
+          onSelect={handleGallerySelect}
+        />
       </div>
 
       <div class="images-route__card images-route__editor">
         <ImageEditor
           {apiBaseUrl}
+          client={editorClient}
           image={selectedImage}
           onSave={handleEditorSave}
         />