@wix/agent-skills 1.35.1 → 1.36.1

package/skills/wix-vibe-headless/references/portfolio/app/rest/wix-portfolio.js

@@ -1,223 +0,0 @@
-import { wixApiRequest } from "./wix-client.js";
-
-/**
- * Wix Portfolio — read-only showcase. 3-level tree:
- *   Collection → Project → Project Item (image or video)
- * Hidden entities (hidden: true) are editor-only — every helper here filters them out.
- *
- * Collection: { id, title, description, slug, hidden, sortOrder,
- *   coverImage.imageInfo: { id, url, height, width, altText },
- *   url: { relativePath, url } (only when includePageUrl=true) }
- * Full model: https://dev.wix.com/docs/api-reference/business-solutions/portfolio/collections/collection-object.md
- *
- * Project: { id, title, description, slug, hidden, collectionIds {string[]},
- *   details {array} — [{ label, text? OR link: { text, url, target } }],
- *   coverImage.imageInfo: { id, url, height, width, altText } (ONE-OF with coverVideo),
- *   coverVideo.videoInfo: { id, url, posters, resolutions },
- *   url: { relativePath, url } (only when includePageUrl=true) }
- * Full media gallery is in Project Items — fetch with listProjectItems(project.id).
- * Full model: https://dev.wix.com/docs/api-reference/business-solutions/portfolio/projects/project-object.md
- *
- * Project Item: { id, projectId, sortOrder, title, description,
- *   type "IMAGE"|"VIDEO"|"UNDEFINED",
- *   image.imageInfo: { id, url, height, width, altText } (when IMAGE),
- *   video.videoInfo: { id, url, posters, resolutions } (when VIDEO; render first resolution),
- *   link: { text, url, target } }
- * Full model: https://dev.wix.com/docs/api-reference/business-solutions/portfolio/project-items/project-item-object.md
- */
-
-const COLLECTIONS_QUERY_URL = "/portfolio/v1/collections/query";
-const PROJECTS_QUERY_URL = "/portfolio/v1/projects/query";
-
-/**
- * Query visible portfolio collections (one page), sorted by their dashboard order.
- * https://dev.wix.com/docs/api-reference/business-solutions/portfolio/collections/query-collections.md
- * @param {{ limit?: number, cursor?: string }} [options]
- * @returns {Promise<{ collections: object[], nextCursor: string|null }>}
- */
-export async function queryCollections({ limit = 100, cursor } = {}) {
-  try {
-    const res = await wixApiRequest(COLLECTIONS_QUERY_URL, {
-      method: "POST",
-      body: {
-        includePageUrl: true,
-        query: cursor
-          ? { cursorPaging: { limit, cursor } }
-          : {
-              filter: { hidden: false },
-              sort: [{ fieldName: "sortOrder", order: "ASC" }],
-              cursorPaging: { limit },
-            },
-      },
-    });
-    return {
-      collections: res?.collections ?? [],
-      nextCursor: res?.metadata?.cursors?.next ?? null,
-    };
-  } catch (err) {
-    // Degrade to an empty page instead of rethrowing: an uncaught read would leave a
-    // component's `loading` flag stuck true and hang the gallery on a spinner. Empty
-    // renders the same empty state as a genuinely empty backend.
-    console.error("queryCollections failed:", err);
-    return { collections: [], nextCursor: null };
-  }
-}
-
-/**
- * Get a single visible collection by its URL slug. Returns null if not found / hidden.
- * Portfolio has no get-by-slug endpoint, so this queries with a slug filter.
- * https://dev.wix.com/docs/api-reference/business-solutions/portfolio/collections/query-collections.md
- * @param {string} slug
- * @returns {Promise<object|null>}
- */
-export async function getCollectionBySlug(slug) {
-  const res = await wixApiRequest(COLLECTIONS_QUERY_URL, {
-    method: "POST",
-    body: {
-      includePageUrl: true,
-      query: { filter: { slug, hidden: false }, cursorPaging: { limit: 1 } },
-    },
-  });
-  return res?.collections?.[0] ?? null;
-}
-
-/**
- * Total number of visible collections. Used for empty-state logic
- * (0 → prompt the user to add collections in their Wix dashboard).
- * @returns {Promise<number>}
- */
-export async function countCollections() {
-  try {
-    const res = await wixApiRequest(COLLECTIONS_QUERY_URL, {
-      method: "POST",
-      body: { query: { filter: { hidden: false }, cursorPaging: { limit: 100 } } },
-    });
-    return res?.metadata?.total ?? (res?.collections?.length ?? 0);
-  } catch (err) {
-    // On failure treat as empty (0) rather than rethrowing — a thrown count would hang
-    // the empty-state check; 0 falls through to the "add collections" prompt.
-    console.error("countCollections failed:", err);
-    return 0;
-  }
-}
-
-/**
- * Query visible projects (one page), sorted newest-first. Use for an "all work" gallery.
- * https://dev.wix.com/docs/api-reference/business-solutions/portfolio/projects/query-projects.md
- * @param {{ limit?: number, cursor?: string }} [options]
- * @returns {Promise<{ projects: object[], nextCursor: string|null }>}
- */
-export async function queryProjects({ limit = 100, cursor } = {}) {
-  try {
-    const res = await wixApiRequest(PROJECTS_QUERY_URL, {
-      method: "POST",
-      body: {
-        includePageUrl: true,
-        query: cursor
-          ? { cursorPaging: { limit, cursor } }
-          : {
-              filter: { hidden: false },
-              sort: [{ fieldName: "createdDate", order: "DESC" }],
-              cursorPaging: { limit },
-            },
-      },
-    });
-    return {
-      projects: res?.projects ?? [],
-      nextCursor: res?.metadata?.cursors?.next ?? null,
-    };
-  } catch (err) {
-    // Degrade to an empty page instead of rethrowing (see queryCollections) — an uncaught
-    // read hangs the gallery on an infinite spinner; empty renders the empty state instead.
-    console.error("queryProjects failed:", err);
-    return { projects: [], nextCursor: null };
-  }
-}
-
-/**
- * Query the visible projects that belong to a collection (one page), in dashboard order.
- * Filters on `collectionIds` with `$hasSome`.
- * https://dev.wix.com/docs/api-reference/business-solutions/portfolio/projects/query-projects.md
- * @param {string} collectionId  `collection.id` from queryCollections / getCollectionBySlug.
- * @param {{ limit?: number, cursor?: string }} [options]
- * @returns {Promise<{ projects: object[], nextCursor: string|null }>}
- */
-export async function queryProjectsByCollection(collectionId, { limit = 100, cursor } = {}) {
-  try {
-    const res = await wixApiRequest(PROJECTS_QUERY_URL, {
-      method: "POST",
-      body: {
-        includePageUrl: true,
-        query: cursor
-          ? { cursorPaging: { limit, cursor } }
-          : {
-              filter: { hidden: false, collectionIds: { $hasSome: [collectionId] } },
-              cursorPaging: { limit },
-            },
-      },
-    });
-    return {
-      projects: res?.projects ?? [],
-      nextCursor: res?.metadata?.cursors?.next ?? null,
-    };
-  } catch (err) {
-    // Degrade to an empty page instead of rethrowing (see queryCollections) — an uncaught
-    // read hangs the collection page on an infinite spinner; empty renders the empty state.
-    console.error("queryProjectsByCollection failed:", err);
-    return { projects: [], nextCursor: null };
-  }
-}
-
-/**
- * Get a single visible project by its URL slug. Returns null if not found / hidden.
- * Portfolio has no get-by-slug endpoint, so this queries with a slug filter.
- * https://dev.wix.com/docs/api-reference/business-solutions/portfolio/projects/query-projects.md
- * @param {string} slug
- * @returns {Promise<object|null>}
- */
-export async function getProjectBySlug(slug) {
-  const res = await wixApiRequest(PROJECTS_QUERY_URL, {
-    method: "POST",
-    body: {
-      includePageUrl: true,
-      query: { filter: { slug, hidden: false }, cursorPaging: { limit: 1 } },
-    },
-  });
-  return res?.projects?.[0] ?? null;
-}
-
-/**
- * Get a single project by its GUID. Returns null if not found.
- * Use when you already hold a project id (e.g. from a list) rather than a slug.
- * https://dev.wix.com/docs/api-reference/business-solutions/portfolio/projects/get-project.md
- * @param {string} projectId
- * @returns {Promise<object|null>}
- */
-export async function getProject(projectId) {
-  try {
-    const res = await wixApiRequest(`/portfolio/v1/projects/${encodeURIComponent(projectId)}`, {
-      method: "GET",
-      query: { includePageUrl: "true" },
-    });
-    return res?.project ?? null;
-  } catch {
-    return null;
-  }
-}
-
-/**
- * List all media items (images/videos) of a project, in dashboard order.
- * This is the project's gallery — call it on the project detail screen.
- * https://dev.wix.com/docs/api-reference/business-solutions/portfolio/project-items/list-project-items.md
- * @param {string} projectId  `project.id`.
- * @param {{ limit?: number, offset?: number }} [options]  Project items use offset paging, not cursors.
- * @returns {Promise<{ items: object[], total: number }>}
- */
-export async function listProjectItems(projectId, { limit = 100, offset = 0 } = {}) {
-  const res = await wixApiRequest(`/portfolio/v1/projectItems/${encodeURIComponent(projectId)}/items`, {
-    method: "GET",
-    query: { "paging.limit": String(limit), "paging.offset": String(offset) },
-  });
-  const items = (res?.items ?? []).slice().sort((a, b) => (a.sortOrder ?? 0) - (b.sortOrder ?? 0));
-  return { items, total: res?.metadata?.total ?? items.length };
-}

package/skills/wix-vibe-headless/references/portfolio/seed/SEED.md

@@ -1,90 +0,0 @@
-# Portfolio — seeding
-
-Seed a Wix Portfolio by **calling `seed-portfolio.cjs`** — don't hand-write the REST calls. It's
-a build-time module (run via `exec_tool`, not shipped in the app) that abstracts every Wix
-Portfolio seed operation. `require` it and call the functions with plain data.
-
-**Collections before projects.** A project is assigned to collections by a `collectionIds` array
-that Wix does **not** validate — a wrong id silently orphans the project. Create the collections
-first, then thread their real ids into each project.
-
-**Seeding is additive — never delete or overwrite existing content.** Don't clean up, don't remove
-"sample" data, don't reset. Just add.
-
-**DEFAULT — one call.** `setupPortfolio(ctx, plan)` runs the whole flow in the right order
-(collections → projects → items → covers), threading ids in memory. Pass covers/items only when you have them. Drop to the individual functions below only for step-by-step control.
-
-```js
-// build-time exec_tool
-const { accessToken } = await base44.asServiceRole.connectors.getConnection("wix");
-const seed = require(require("path").resolve(".agents/skills/wix-vibe-headless/references/portfolio/seed/seed-portfolio.cjs"));
-const ctx = { token: accessToken, siteId: WIX_METASITE_ID };
-
-const summary = await seed.setupPortfolio(ctx, {
-  collections: [
-    { title: "Brand Identity", description: "Logo systems and visual identities." },
-  ],
-  projects: [
-    { title: "Northwind Rebrand", description: "Full identity refresh for a logistics firm.",
-      collection: "Brand Identity",                    // resolved to that collection's id
-      details: [{ label: "Year", text: "2025" }],
-      // cover/items are optional and attached IN this one call. Pass plain urls — the module imports
-      // them to Wix Media for you (portfolio binds by file id). Use the FINAL https://media.base44.com/...
-      // url from the COMPLETED generate_image (it runs in the background while you build — wait for it),
-      // never a still-generating /__generating__/<id>.png placeholder.
-      coverImageUrl: "https://media.base44.com/…",
-      items: [{ sortOrder: 1, title: "Hero", imageUrl: "https://media.base44.com/…" }] },
-  ],
-});
-// summary => { collections:[{id,slug,revision}], projects:[{id,slug,revision}], itemsCreated, coversAttached }
-```
-
-## Escape hatch — individual functions
-Reach for the functions below only when the one-call `setupPortfolio` doesn't fit (step-by-step
-control, partial re-seed). `setupPortfolio` is built from them, in this order:
-
-```js
-const collections = await seed.createCollections(ctx, [                                 // STEP 1
-  { title: "Brand Identity", description: "Logo systems and visual identities." },
-]);
-const projects = await seed.createProjects(ctx, [                                       // STEP 2
-  { title: "Northwind Rebrand", description: "Full identity refresh for a logistics firm.",
-    collectionIds: [collections[0].id], details: [{ label: "Year", text: "2025" }] },
-]);
-
-// optional — import each url to Wix Media first (portfolio binds by file id), then attach
-const files = await Promise.all(imageUrls.map((u) => seed.importImage(ctx, u)));   // → [{ id, url }]
-await seed.attachProjectCovers(ctx, projects.map((p, i) => ({ id: p.id, revision: p.revision, imageId: files[i].id, height: 1024, width: 1024 })));
-await seed.attachCollectionCovers(ctx, collections.map((c, i) => ({ id: c.id, revision: c.revision, imageId: files[i].id, height: 1024, width: 1024 })));
-await seed.createProjectItems(ctx, [{ projectId: projects[0].id, sortOrder: 1, title: "Hero", imageId: files[0].id, height: 1024, width: 1024 }]);
-```
-
-## Functions
-| fn | does |
-|---|---|
-| `setupPortfolio(ctx, plan)` | **DEFAULT** — one call: collections → projects → items → covers; returns `{collections,projects,itemsCreated,coversAttached}` |
-| `createCollections(ctx, collections)` | STEP 1 — `[{title,description?,hidden?}]` → `[{id,slug,revision}]` |
-| `createProjects(ctx, projects)` | STEP 2 — `[{title,description?,collectionIds,details?,hidden?}]` → `[{id,slug,revision}]` |
-| `importImage(ctx, url)` | import an external url into Wix Media → `{id,url}` (file id + wixstatic url); covers + items bind by this file id |
-| `attachProjectCovers(ctx, [{id,revision,imageId,height,width}])` | PATCH each project's cover (optional); `imageId` = a Wix Media file id from `importImage` |
-| `attachCollectionCovers(ctx, [{id,revision,imageId,height,width}])` | PATCH each collection's cover (optional) |
-| `createProjectItems(ctx, [{projectId,sortOrder,title,imageId,height,width}])` | one POST per gallery image (optional) |
-
-`hidden` defaults to `false` (shown) — omit it for visible entities; send `hidden: true` only to
-hide. `setupPortfolio` **installs the Wix Portfolio app first** (`installPortfolioApp`, idempotent), so seeding works even if the site doesn't have it yet.
-
-## Reference
-If a call returns a shape you didn't expect, or you need an operation this module doesn't cover,
-use the documentation skill available in your environment to search + read the live Wix API reference — never guess. The
-authoritative source recipe is `wix-headless/references/inline-recipes/setup-portfolio.md`.
-
-**Transcribed from the recipe — NOT yet live-verified.** The endpoints/fields mirror
-`setup-portfolio.md`; confirm against a real run or the Wix docs before trusting edge shapes.
-
-Read a method's page before writing its call: it carries the exact body shape, the required
-permission scope, and the response envelope.
-- Install a Wix app onto the site: https://dev.wix.com/docs/api-reference/business-management/app-installation/app-installation/install-app.md
-- Import an image into Wix Media: https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/import-file.md
-- Create Collection: https://dev.wix.com/docs/api-reference/business-solutions/portfolio/collections/create-collection.md
-- Create Project: https://dev.wix.com/docs/api-reference/business-solutions/portfolio/projects/create-project.md
-- Create Project Item: https://dev.wix.com/docs/api-reference/business-solutions/portfolio/project-items/create-project-item.md

package/skills/wix-vibe-headless/references/portfolio/seed/seed-portfolio.cjs

@@ -1,236 +0,0 @@
-// Portfolio seed helpers — run at BUILD TIME via exec_tool (NOT shipped in the app).
-// The agent requires this and calls the functions with plain data; all Wix Portfolio
-// request/response mechanics (the collection/project wrappers, title-not-name, the
-// hidden-defaults-to-false polarity, collections-before-projects, cover PATCH + gallery
-// items) live here, once.
-//
-// Usage (build-time exec_tool):
-//   const { accessToken } = await base44.asServiceRole.connectors.getConnection("wix");  // Base44
-//   const seed = require("/app/.agents/skills/wix-vibe-headless/references/portfolio/seed/seed-portfolio.cjs");
-//   const ctx = { token: accessToken, siteId: WIX_METASITE_ID };
-//
-//   const collections = await seed.createCollections(ctx, [{ title, description }]);        // STEP 1
-//   const projects = await seed.createProjects(ctx, [                                        // STEP 2
-//     { title, description, collectionIds: [collections[0].id], details: [{ label, text }] },
-//   ]);
-//   // optional — import each image url to Wix Media first (portfolio binds by file id), then attach.
-//   const files = await Promise.all(imageUrls.map((u) => seed.importImage(ctx, u)));   // → [{ id, url }]
-//   await seed.attachProjectCovers(ctx, projects.map((p,i) => ({ id:p.id, revision:p.revision, imageId:files[i].id, height:1024, width:1024 })));
-//   await seed.createProjectItems(ctx, [{ projectId: projects[0].id, sortOrder: 1, title, imageId: files[0].id, height:1024, width:1024 }]);
-//
-// **NOT yet live-verified — transcribed from setup-portfolio.md.** If any call fails with a
-// shape the caller didn't expect, fall back to the documentation skill available in your environment (search + read the live Wix
-// API reference) — never guess. Source recipe (authoritative):
-// wix-headless/references/inline-recipes/setup-portfolio.md.
-
-const API = "https://www.wixapis.com";
-const PORTFOLIO_APP_ID = "d90652a2-f5a1-4c7c-84c4-d4cdcc41f130"; // installPortfolioApp installs this before seeding
-
-async function req(ctx, path, { method = "POST", body } = {}) {
-  const res = await fetch(API + path, {
-    method,
-    headers: {
-      Authorization: `Bearer ${ctx.token}`,
-      "wix-site-id": ctx.siteId,
-      "Content-Type": "application/json",
-    },
-    body: body ? JSON.stringify(body) : undefined,
-  });
-  const json = await res.json().catch(() => ({}));
-  if (!res.ok) throw new Error(`${method} ${path} -> ${res.status}: ${JSON.stringify(json).slice(0, 400)}`);
-  return json;
-}
-
-// ---- exported operations ----
-
-// Read-only listing helpers.
-async function listProjects(ctx) {
-  const r = await req(ctx, "/portfolio/v1/projects", { method: "GET" });
-  return (r.projects ?? []).map((p) => ({ id: p.id, title: p.title }));
-}
-async function listCollections(ctx) {
-  const r = await req(ctx, "/portfolio/v1/collections", { method: "GET" });
-  return (r.collections ?? []).map((c) => ({ id: c.id, title: c.title }));
-}
-
-/**
- * STEP 1 — Create the collections. MUST run before createProjects: a project's collectionIds
- * are NOT validated, so projects need the real collection ids read back from here.
- * @param collections [{ title, description?, hidden? }]  (display name is `title`, not `name`;
- *   `slug` auto-generates from title when omitted; `hidden` defaults to false = shown, so omit
- *   it for a visible collection and send `hidden: true` only to hide.)
- *   No bulk-create — one call per collection; concurrent is safe (no 409 race) but sequential
- *   is just as correct and simplest.
- * @returns [{ id, slug, revision }]  (id feeds each project's collectionIds; revision feeds covers)
- */
-async function createCollections(ctx, collections) {
-  const out = [];
-  for (const c of collections) {
-    const body = { collection: { title: c.title, description: c.description } };
-    if (c.hidden) body.collection.hidden = true; // omit otherwise — defaults to shown
-    const r = await req(ctx, "/portfolio/v1/collections", { body });
-    out.push({ id: r.collection?.id, slug: r.collection?.slug, revision: r.collection?.revision });
-  }
-  return out;
-}
-
-/**
- * STEP 2 — Create the projects, each assigned to its collection(s) via collectionIds.
- * @param projects [{ title, description?, collectionIds: [id], details?, hidden? }]
- *   collectionIds MUST hold real ids from createCollections — they are NOT validated, so a
- *   wrong/missing id is accepted silently and orphans the project (reachable only from the
- *   all-projects list). `details` is an optional [{ label, text }] array (Role, Year, Client…).
- *   `hidden` defaults to false = shown. No bulk-create — one call per project; concurrent safe.
- * @returns [{ id, slug, revision }]  (revision feeds attachProjectCovers)
- */
-async function createProjects(ctx, projects) {
-  const out = [];
-  for (const p of projects) {
-    const project = {
-      title: p.title,
-      description: p.description,
-      collectionIds: p.collectionIds ?? [],
-    };
-    if (p.details) project.details = p.details;
-    if (p.hidden) project.hidden = true; // omit otherwise — defaults to shown
-    const r = await req(ctx, "/portfolio/v1/projects", { body: { project } });
-    out.push({ id: r.project?.id, slug: r.project?.slug, revision: r.project?.revision });
-  }
-  return out;
-}
-
-// Import an external image URL into Wix Media → { id, url }. Portfolio binds covers + gallery items
-// by the Wix Media file **id**, NOT a url — an external url (e.g. a base44 generate_image result)
-// MUST be imported first; the raw url renders nothing. id = wixstatic file id, url = wixstatic url.
-async function importImage(ctx, url, displayName = "image.png") {
-  const r = await req(ctx, "/site-media/v1/files/import", { body: { url, mimeType: "image/png", displayName } });
-  const f = r.file || r;
-  if (!f?.id) throw new Error(`import-file returned no file id: ${JSON.stringify(r).slice(0, 200)}`);
-  return { id: f.id, url: f.url };
-}
-
-// Optional — pass a cover/items to attach, omit to skip. Cover = the listing-card thumbnail. PATCH per entity,
-// echoing the current revision (a missing/stale revision fails). height + width are required
-// alongside the imported WixMedia image id (from importImage). items: [{ id, revision, imageId, height, width }].
-async function attachProjectCovers(ctx, items) {
-  for (const it of items) {
-    await req(ctx, `/portfolio/v1/projects/${it.id}`, {
-      method: "PATCH",
-      body: { project: { id: it.id, revision: it.revision, coverImage: { imageInfo: { id: it.imageId, height: it.height, width: it.width } } } },
-    });
-  }
-}
-async function attachCollectionCovers(ctx, items) {
-  for (const it of items) {
-    await req(ctx, `/portfolio/v1/collections/${it.id}`, {
-      method: "PATCH",
-      body: { collection: { id: it.id, revision: it.revision, coverImage: { imageInfo: { id: it.imageId, height: it.height, width: it.width } } } },
-    });
-  }
-}
-
-// Optional — the project's media gallery (detail-page images) is a SEPARATE `item` entity,
-// one POST per image. sortOrder (1,2,3…) sets render order. lowercase `items` — `/Items` 404s.
-// There is NO public list endpoint. items: [{ projectId, sortOrder, title, imageId, height, width }].
-async function createProjectItems(ctx, items) {
-  const out = [];
-  for (const it of items) {
-    const r = await req(ctx, "/portfolio/v1/items", {
-      body: { item: { projectId: it.projectId, sortOrder: it.sortOrder, title: it.title, image: { imageInfo: { id: it.imageId, height: it.height, width: it.width } } } },
-    });
-    out.push({ id: r.item?.id });
-  }
-  return out;
-}
-
-/**
- * DEFAULT one-call path — seed a whole portfolio from one plan; ids stay in memory so
- * collections→projects→items→covers are wired without hand-threading ids. Order matches SEED.md:
- * createCollections → createProjects (into collections) → createProjectItems → attach*Covers.
- * @param plan {
- *   collections: [{ title, description?, hidden?, coverImageUrl? }],
- *   projects:    [{ title, description?, details?, hidden?,
- *                   collection?: "<collection title>",   // resolved to that collection's id
- *                   items?: [{ sortOrder, title, imageUrl }],
- *                   coverImageUrl? }],
- * }
- *   coverImageUrl / items[].imageUrl are plain image urls — imported to Wix Media here. Covers/items
- *   are optional — a project/collection without one skips it.
- * @returns { collections:[{id,slug,revision}], projects:[{id,slug,revision}], itemsCreated, coversAttached }
- */
-// Install the Wix Portfolio app before seeding — base44 sites aren't guaranteed to have it (no
-// separate Setup step here, unlike the wix-headless recipe). Idempotent: re-installing returns 200.
-async function installPortfolioApp(ctx) {
-  return req(ctx, "/apps-installer-service/v1/app-instance/install", { body: {
-    tenant: { tenantType: "SITE", id: ctx.siteId },
-    appInstance: { appDefId: PORTFOLIO_APP_ID, enabled: true },
-  } });
-}
-
-async function setupPortfolio(ctx, { collections = [], projects = [] } = {}) {
-  await installPortfolioApp(ctx);
-  const cols = await createCollections(ctx, collections);               // STEP 1
-  const idByName = new Map(collections.map((c, i) => [c.title, cols[i].id]));
-
-  const projs = await createProjects(                                   // STEP 2
-    ctx,
-    projects.map((p) => ({
-      title: p.title, description: p.description, details: p.details, hidden: p.hidden,
-      collectionIds: p.collection ? [idByName.get(p.collection)].filter(Boolean) : [],
-    })),
-  );
-
-  // resolve a plain image url → { imageId, height, width } by importing to Wix Media (binds by file id)
-  const toImage = async (url, name) => {
-    const file = await importImage(ctx, url, name);
-    return { imageId: file.id, height: 1024, width: 1024 };
-  };
-
-  // STEP 3 — project media-gallery items (import each image; a failed import skips that item)
-  const itemsFlat = [];
-  for (let i = 0; i < projects.length; i++) {
-    for (const it of projects[i].items ?? []) {
-      if (!it.imageUrl) continue;
-      try {
-        const img = await toImage(it.imageUrl, `${it.title || "item"}.png`);
-        itemsFlat.push({ projectId: projs[i].id, sortOrder: it.sortOrder, title: it.title, ...img });
-      } catch { /* skip this item's image */ }
-    }
-  }
-  const items = itemsFlat.length ? await createProjectItems(ctx, itemsFlat) : [];
-
-  // STEP 4 — covers (import each; a failed import skips that cover)
-  const projCovers = [];
-  for (let i = 0; i < projects.length; i++) {
-    if (!projects[i].coverImageUrl) continue;
-    try {
-      const img = await toImage(projects[i].coverImageUrl, `${projects[i].title || "project"}-cover.png`);
-      projCovers.push({ id: projs[i].id, revision: projs[i].revision, ...img });
-    } catch { /* skip */ }
-  }
-  if (projCovers.length) await attachProjectCovers(ctx, projCovers);
-
-  const colCovers = [];
-  for (let i = 0; i < collections.length; i++) {
-    if (!collections[i].coverImageUrl) continue;
-    try {
-      const img = await toImage(collections[i].coverImageUrl, `${collections[i].title || "collection"}-cover.png`);
-      colCovers.push({ id: cols[i].id, revision: cols[i].revision, ...img });
-    } catch { /* skip */ }
-  }
-  if (colCovers.length) await attachCollectionCovers(ctx, colCovers);
-
-  return {
-    collections: cols,
-    projects: projs,
-    itemsCreated: items.length,
-    coversAttached: projCovers.length + colCovers.length,
-  };
-}
-
-module.exports = {
-  setupPortfolio, installPortfolioApp,
-  listProjects, listCollections,
-  createCollections, createProjects, importImage,
-  attachProjectCovers, attachCollectionCovers, createProjectItems,
-};