@jay-framework/wix-media 0.21.0 → 0.22.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { JayHtmlValidatorFn } from '@jay-framework/compiler-shared';
-import { PluginSetupContext, PluginSetupResult, PluginReferencesContext, PluginReferencesResult } from '@jay-framework/stack-server-runtime';
+import { PluginSetupContext, PluginSetupResult, PluginAgentKitContext, PluginAgentKitResult } from '@jay-framework/stack-server-runtime';
 import * as _jay_framework_fullstack_component from '@jay-framework/fullstack-component';
 
 declare const validate: JayHtmlValidatorFn;
@@ -15,6 +15,7 @@ interface MediaFileInfo {
     labels: string[];
     folderId: string;
     folderName: string;
+    folderPath: string[];
 }
 interface UploadUrlResult {
     uploadUrl: string;
@@ -32,14 +33,13 @@ declare function generateMediaIndex(files: MediaFileInfo[]): string;
 
 interface MediaAddMenuInteraction {
     mode: 'stage-place' | 'reference';
-    persistOnPage?: boolean;
     stagePromptTemplate?: string;
 }
 interface MediaAddMenuItem {
     id: string;
     title: string;
     category: string;
-    subCategory: string;
+    folderPath?: string[];
     pluginName: string;
     packageName: string;
     thumbnail?: string;
@@ -59,7 +59,7 @@ declare function refreshMediaAddMenuCatalog(projectRoot: string, mediaService: W
 }>;
 
 declare function setupWixMedia(ctx: PluginSetupContext): Promise<PluginSetupResult>;
-declare function generateWixMediaReferences(ctx: PluginReferencesContext): Promise<PluginReferencesResult>;
+declare function generateWixMediaAgentKit(ctx: PluginAgentKitContext): Promise<PluginAgentKitResult>;
 
 declare const rebuildIndex: _jay_framework_fullstack_component.JayCliCommand<{}> & _jay_framework_fullstack_component.JayCliCommandDefinition<{}, [_jay_framework_fullstack_component.ConsoleContext]>;
 
@@ -71,4 +71,4 @@ declare const uploadPublic: _jay_framework_fullstack_component.JayCliCommand<{
     dryRun?: boolean;
 }, [_jay_framework_fullstack_component.ConsoleContext]>;
 
-export { ADD_MENU_GENERATED_REL, buildMediaAddMenuItems, generateMediaIndex, generateWixMediaReferences, rebuildIndex, refreshMediaAddMenuCatalog, setupWixMedia, thumbnailUrlForMedia, uploadPublic, validate, writeGeneratedAddMenuCatalog };
+export { ADD_MENU_GENERATED_REL, buildMediaAddMenuItems, generateMediaIndex, generateWixMediaAgentKit, rebuildIndex, refreshMediaAddMenuCatalog, setupWixMedia, thumbnailUrlForMedia, uploadPublic, validate, writeGeneratedAddMenuCatalog };

package/dist/index.js

@@ -148,20 +148,6 @@ function generateMediaIndex(files2) {
   return lines.join("\n");
 }
 const CATEGORY = "Media";
-function subCategoryForMediaType(mediaType) {
-  switch (mediaType.toLowerCase()) {
-    case "image":
-      return "Images";
-    case "video":
-      return "Videos";
-    case "audio":
-      return "Audio";
-    case "document":
-      return "Documents";
-    default:
-      return "Other";
-  }
-}
 function uniqueItemId(slug, mediaId, usedIds) {
   const base = slug.trim() || mediaId.slice(0, 8);
   let id = `wix-media:${base}`;
@@ -179,10 +165,6 @@ function formatDimensions(file) {
   return "-";
 }
 function formatTitle(file) {
-  const folder = file.folderName?.trim();
-  if (folder && folder !== "Media Root" && folder !== "Unknown") {
-    return `${folder} — ${file.displayName}`;
-  }
   return file.displayName;
 }
 const VISUAL_FILE_EXTENSION_RE = /\.(svg|png|jpe?g|gif|webp|bmp|ico)($|[?#])/i;
@@ -204,7 +186,6 @@ function stagePlaceInteractionForMedia(file) {
   if (mediaType === "image" || mediaType === "vector" || isPreviewableVisualMedia(file)) {
     return {
       mode: "stage-place",
-      persistOnPage: true,
       stagePromptTemplate: `Place this image at the marker location on the page.
 URL: ${file.url}`
     };
@@ -212,7 +193,6 @@ URL: ${file.url}`
   if (mediaType === "video") {
     return {
       mode: "stage-place",
-      persistOnPage: true,
       stagePromptTemplate: `Place this video at the marker location on the page.
 URL: ${file.url}`
     };
@@ -222,7 +202,8 @@ URL: ${file.url}`
 function buildMediaPrompt(file) {
   const labels = file.labels.length > 0 ? `Labels: ${file.labels.join(", ")}
 ` : "";
-  const folderLine = file.folderName && file.folderName !== "Unknown" ? `Folder: ${file.folderName}
+  const folderLine = file.folderPath.length > 0 ? `Folder: ${file.folderPath.join(" / ")}
+` : file.folderName && file.folderName !== "Unknown" ? `Folder: ${file.folderName}
 ` : "";
   return [
     "Use this Wix Media Manager asset in jay-html (do not copy to public/):",
@@ -245,7 +226,7 @@ function buildMediaAddMenuItems(files2) {
       id: uniqueItemId(file.slug, file.id, usedIds),
       title: formatTitle(file),
       category: CATEGORY,
-      subCategory: subCategoryForMediaType(file.mediaType),
+      ...file.folderPath.length > 0 ? { folderPath: [...file.folderPath] } : {},
       pluginName: "wix-media",
       packageName: "@jay-framework/wix-media",
       ...thumbnail ? { thumbnail } : {},
@@ -269,6 +250,32 @@ async function refreshMediaAddMenuCatalog(projectRoot, mediaService) {
   const outputRel = writeGeneratedAddMenuCatalog(projectRoot, items);
   return { itemCount: items.length, outputRel };
 }
+const WIX_MEDIA_SITE_FILES_LABEL = "Site Files";
+function stripSiteFilesContainer(segments) {
+  const path2 = [...segments];
+  while (path2[0] === WIX_MEDIA_SITE_FILES_LABEL) {
+    path2.shift();
+  }
+  return path2;
+}
+function buildMediaFolderPath(folderId, folderIndex) {
+  if (!folderId || folderId === "media-root") {
+    return [];
+  }
+  const segments = [];
+  let currentFolderId = folderId;
+  const visitedFolderIds = /* @__PURE__ */ new Set();
+  while (currentFolderId && currentFolderId !== "media-root" && !visitedFolderIds.has(currentFolderId)) {
+    visitedFolderIds.add(currentFolderId);
+    const folder = folderIndex.get(currentFolderId);
+    if (!folder) break;
+    segments.unshift(folder.name);
+    const parentFolderId = folder.parentFolderId ?? void 0;
+    if (!parentFolderId || parentFolderId === "media-root") break;
+    currentFolderId = parentFolderId;
+  }
+  return stripSiteFilesContainer(segments);
+}
 const WIX_MEDIA_SERVICE_MARKER = createJayService("Wix Media Service");
 let filesClientInstance;
 let foldersClientInstance;
@@ -308,7 +315,7 @@ function extractDimensions(file) {
 }
 async function fetchAllFolders(foldersClient) {
   const folderMap = /* @__PURE__ */ new Map();
-  folderMap.set("media-root", "Media Root");
+  folderMap.set("media-root", { name: "Media Root", parentFolderId: null });
   let cursor;
   do {
     const result = await foldersClient.searchFolders({
@@ -317,7 +324,10 @@ async function fetchAllFolders(foldersClient) {
     });
     for (const folder of result.folders ?? []) {
       if (folder._id && folder.displayName) {
-        folderMap.set(folder._id, folder.displayName);
+        folderMap.set(folder._id, {
+          name: folder.displayName,
+          parentFolderId: folder.parentFolderId ?? null
+        });
       }
     }
     cursor = result.nextCursor?.cursors?.next;
@@ -367,6 +377,9 @@ function provideWixMediaService(wixClient) {
       ]);
       const items = rawFiles.map((file) => {
         const dims = extractDimensions(file);
+        const folderRecord = folderMap.get(file.folderId);
+        const folderName = folderRecord?.name ?? "Unknown";
+        const folderPath = buildMediaFolderPath(file.folderId, folderMap);
         return {
           id: file.id,
           displayName: file.displayName,
@@ -377,7 +390,8 @@ function provideWixMediaService(wixClient) {
           height: dims.height,
           labels: file.labels,
           folderId: file.folderId,
-          folderName: folderMap.get(file.folderId) ?? "Unknown"
+          folderName,
+          folderPath
         };
       });
       deduplicateSlugs(items);
@@ -392,9 +406,15 @@ function provideWixMediaService(wixClient) {
   registerService(WIX_MEDIA_SERVICE_MARKER, service);
   return service;
 }
-function createMediaService() {
-  const wixClient = getService(WIX_CLIENT_SERVICE);
-  return provideWixMediaService(wixClient);
+function getWixClient(services) {
+  const fromContext = services.get(WIX_CLIENT_SERVICE);
+  if (fromContext !== void 0) {
+    return fromContext;
+  }
+  return getService(WIX_CLIENT_SERVICE);
+}
+function createMediaService(services) {
+  return provideWixMediaService(getWixClient(services));
 }
 async function setupWixMedia(ctx) {
   if (ctx.initError) {
@@ -404,7 +424,7 @@ async function setupWixMedia(ctx) {
     };
   }
   try {
-    createMediaService();
+    createMediaService(ctx.services);
   } catch {
     return {
       status: "needs-config",
@@ -416,13 +436,13 @@ async function setupWixMedia(ctx) {
     message: "Wix Media Manager access verified."
   };
 }
-async function generateWixMediaReferences(ctx) {
+async function generateWixMediaAgentKit(ctx) {
   if (ctx.initError) {
     throw new Error(`init failed: ${ctx.initError.message}`);
   }
   let mediaService;
   try {
-    mediaService = createMediaService();
+    mediaService = createMediaService(ctx.services);
   } catch {
     throw new Error("WixMediaService not available. Run jay-stack setup first.");
   }
@@ -434,7 +454,7 @@ async function generateWixMediaReferences(ctx) {
   const addMenuItems = buildMediaAddMenuItems(mediaFiles);
   const addMenuGenerated = writeGeneratedAddMenuCatalog(ctx.projectRoot, addMenuItems);
   return {
-    referencesCreated: [
+    agentKitCreated: [
       `agent-kit/references/${ctx.pluginName}/MEDIA-INDEX.md`,
       addMenuGenerated
     ],
@@ -606,7 +626,7 @@ export {
   ADD_MENU_GENERATED_REL,
   buildMediaAddMenuItems,
   generateMediaIndex,
-  generateWixMediaReferences,
+  generateWixMediaAgentKit,
   rebuildIndex,
   refreshMediaAddMenuCatalog,
   setupWixMedia,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/wix-media",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "type": "module",
   "description": "Wix Media Manager plugin for Jay Framework — media validation, index generation, and agent-kit references",
   "license": "Apache-2.0",
@@ -25,21 +25,21 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@jay-framework/compiler-jay-html": "^0.21.0",
-    "@jay-framework/compiler-shared": "^0.21.0",
-    "@jay-framework/component": "^0.21.0",
-    "@jay-framework/fullstack-component": "^0.21.0",
-    "@jay-framework/stack-server-runtime": "^0.21.0",
-    "@jay-framework/wix-server-client": "^0.21.0",
-    "@jay-framework/wix-utils": "^0.21.0",
+    "@jay-framework/compiler-jay-html": "^0.22.0",
+    "@jay-framework/compiler-shared": "^0.22.0",
+    "@jay-framework/component": "^0.22.0",
+    "@jay-framework/fullstack-component": "^0.22.0",
+    "@jay-framework/stack-server-runtime": "^0.22.0",
+    "@jay-framework/wix-server-client": "^0.22.0",
+    "@jay-framework/wix-utils": "^0.22.0",
     "@wix/media": "^1.0.247",
     "@wix/sdk": "^1.21.5",
     "js-yaml": "^4.1.0"
   },
   "devDependencies": {
-    "@jay-framework/compiler-jay-stack": "^0.21.0",
-    "@jay-framework/jay-stack-cli": "^0.21.0",
-    "@jay-framework/vite-plugin": "^0.21.0",
+    "@jay-framework/compiler-jay-stack": "^0.22.0",
+    "@jay-framework/jay-stack-cli": "^0.22.0",
+    "@jay-framework/vite-plugin": "^0.22.0",
     "@types/node": "^20.11.0",
     "node-html-parser": "^6.1.0",
     "rimraf": "^5.0.5",

package/plugin.yaml

@@ -11,7 +11,6 @@ commands:
   - name: rebuild-index
     command: rebuild-index.jay-command
 
-setup:
-  handler: setupWixMedia
-  references: generateWixMediaReferences
-  description: Validates Wix Media Manager access, generates agent-kit media index
+setup: setupWixMedia
+agentkit: generateWixMediaAgentKit
+description: Validates Wix Media Manager access, generates agent-kit media index