@wix/agent-skills 1.31.0 → 1.31.2

package/skills/wix-headless-templates/blog/project/package.json

@@ -24,7 +24,7 @@
     "tailwindcss": "^4.1.7",
     "@tailwindcss/vite": "^4.1.7",
     "@wix/blog": "^1.0.645",
-    "@wix/ricos": "^11.12.0",
+    "@wix/ricos": "^11.17.0",
     "@wix/seo": "^1.0.79"
   },
   "devDependencies": {

package/skills/wix-headless-templates/blog/project/src/components/blog/RichContent.tsx

@@ -1,12 +1,13 @@
 // The post-body renderer — wire AS-IS (machinery, not a reference). A post body is a Ricos
 // document, not HTML and not text: never innerHTML it, never String() its nodes. This is the
-// documented render path (@wix/ricos viewer + quick-start plugins).
+// documented render path (@wix/ricos/viewer + quick-start plugins: the viewer-only entry, 11.17+,
+// without the editor, its dev tools and CodeMirror that the root import drags into every bundle).
 //
 // In Astro this component MUST be a `client:only="react"` island — the ricos viewer breaks
 // under SSR. Dark theme: the ricos CSS hardcodes near-black text; scope an override on
 // `.ricos-content` forcing the foreground token (in Astro use <style is:global> — React
 // islands don't inherit scoped Astro styles).
-import { quickStartViewerPlugins, RicosViewer } from "@wix/ricos";
+import { quickStartViewerPlugins, RicosViewer } from "@wix/ricos/viewer";
 import "@wix/ricos/css/all-plugins-viewer.css";
 
 // Module-level, once — never rebuild the plugin list per render.

package/skills/wix-headless-templates/blog/rest/authors.ts

@@ -4,11 +4,11 @@
 // the bodies, port the core once.
 // docs: https://dev.wix.com/docs/api-reference/crm/members-contacts/members/member-management/members/query-members.md
 // docs: https://dev.wix.com/docs/api-reference/crm/members-contacts/members/member-management/members/get-my-member.md
-import { wixRequest } from "./client.js";
-import { imgSrc } from "./media.js";
-import { authorsQuery, indexAuthors, toAuthor, uniqueIds } from "./authors-core.js";
-import type { Raw } from "./posts-core.js";
-import type { BlogAuthor } from "./types.js";
+import { wixRequest } from "../../shared/rest/client.js";
+import { imgSrc } from "../../shared/rest/media.js";
+import { authorsQuery, indexAuthors, toAuthor, uniqueIds } from "../app/wix/blog/authors-core.js";
+import type { Raw } from "../app/wix/blog/posts-core.js";
+import type { BlogAuthor } from "../app/wix/blog/types.js";
 
 /**
  * Every distinct author of one page in ONE request, keyed by member id. {} on failure.

package/skills/wix-headless-templates/blog/rest/comments.ts

@@ -5,7 +5,7 @@
 // docs: https://dev.wix.com/docs/api-reference/crm/community/comments/comments/list-comments-by-resource.md
 // docs: https://dev.wix.com/docs/api-reference/crm/community/comments/comments/create-comment.md
 // docs: https://dev.wix.com/docs/api-reference/crm/community/comments/comments/delete-comment.md
-import { wixRequest } from "./client.js";
+import { wixRequest } from "../../shared/rest/client.js";
 import { fetchAuthorsByIds } from "./authors.js";
 import {
   commentAuthorIds,
@@ -18,9 +18,9 @@ import {
   toCommentThread,
   type CreateCommentOptions,
   type ListCommentsOptions,
-} from "./comments-core.js";
-import type { Raw } from "./posts-core.js";
-import type { BlogComment, CommentPage, CommentThread } from "./types.js";
+} from "../app/wix/blog/comments-core.js";
+import type { Raw } from "../app/wix/blog/posts-core.js";
+import type { BlogComment, CommentPage, CommentThread } from "../app/wix/blog/types.js";
 
 export { type CreateCommentOptions, type ListCommentsOptions };
 

package/skills/wix-headless-templates/blog/rest/post-likes.ts

@@ -5,10 +5,10 @@
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/blog/likes/create-like.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/blog/likes/query-likes.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/blog/likes/delete-like-by-fqdn-and-entity-id.md
-import { wixRequest } from "./client.js";
+import { wixRequest } from "../../shared/rest/client.js";
 import { fetchPostMetrics } from "./posts.js";
-import { BLOG_POST_FQDN, likeBody, likeStateQuery, type Raw } from "./posts-core.js";
-import type { LikeState } from "./types.js";
+import { BLOG_POST_FQDN, likeBody, likeStateQuery, type Raw } from "../app/wix/blog/posts-core.js";
+import type { LikeState } from "../app/wix/blog/types.js";
 
 /** Like the post as the current viewer.  POST /blog/v1/likes  { like: { entityId, fqdn: "wix.blog.v3.post" } } */
 export async function likePost(postId: string): Promise<void> {

package/skills/wix-headless-templates/blog/rest/posts.ts

@@ -6,8 +6,8 @@
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/blog/posts-stats/query-posts.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/blog/posts-stats/get-post-by-slug.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/blog/posts-stats/get-post-metrics.md
-import { wixRequest } from "./client.js";
-import { imgSrc } from "./media.js";
+import { wixRequest } from "../../shared/rest/client.js";
+import { imgSrc } from "../../shared/rest/media.js";
 import { fetchAuthorsByIds } from "./authors.js";
 import {
   BLOG_APP_ID,
@@ -31,8 +31,8 @@ import {
   withAuthors,
   type FetchPostsOptions,
   type Raw,
-} from "./posts-core.js";
-import type { PostDetail, PostMetrics, PostPage, PostSummary } from "./types.js";
+} from "../app/wix/blog/posts-core.js";
+import type { PostDetail, PostMetrics, PostPage, PostSummary } from "../app/wix/blog/types.js";
 
 export { BLOG_APP_ID, categoryPath, formatCount, postMetaLine, postPath, relativeDateLabel, tagPath, type FetchPostsOptions };
 

package/skills/wix-headless-templates/blog/rest/taxonomy.ts

@@ -6,11 +6,11 @@
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/blog/category/get-category-by-slug.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/blog/tags/query-tags.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/blog/tags/get-tag-by-slug.md
-import { wixRequest } from "./client.js";
-import { imgSrc } from "./media.js";
-import { TAG_SORT, TAXONOMY_LIMIT, categoriesQuery, inIdOrder, tagsByIdsQuery, toCategory, toTag, type FetchCategoriesOptions } from "./taxonomy-core.js";
-import type { Raw } from "./posts-core.js";
-import type { BlogCategory, BlogTag } from "./types.js";
+import { wixRequest } from "../../shared/rest/client.js";
+import { imgSrc } from "../../shared/rest/media.js";
+import { TAG_SORT, TAXONOMY_LIMIT, categoriesQuery, inIdOrder, tagsByIdsQuery, toCategory, toTag, type FetchCategoriesOptions } from "../app/wix/blog/taxonomy-core.js";
+import type { Raw } from "../app/wix/blog/posts-core.js";
+import type { BlogCategory, BlogTag } from "../app/wix/blog/types.js";
 
 export { inIdOrder, type FetchCategoriesOptions };
 

package/skills/wix-headless-templates/blog/seed/SEED.md

@@ -52,7 +52,7 @@ feed without covers looks broken.
 - Cover — the default is a `coverImagePrompt` (AI-generated, ~1 Wix AI credit per image,
   account-billed): brand-contextual — subject, aesthetic/mood, palette, lighting — always
   ending "no text, no watermarks". At least one image in the set shows the real subject of the business — the actual product/space/service, not abstract decoration. For an asset the user actually supplied use
-  `coverImagePath` (a file on this machine — uploaded to Wix Media) or `coverImageUrl` (their
+  `coverImageMediaId` (a file already in the site's Media Manager, such as one the user uploaded there: used as it is, no copy; a `static.wixstatic.com/media/<file id>` URL of a site file counts as one), `coverImagePath` (a file on this machine — uploaded to Wix Media) or `coverImageUrl` (their
   own hosted URL; verify it with `curl -sI` → 200) — never a stock-photo or guessed URL. Covers resolve
   in parallel and never block the seed; a failed cover leaves that post text-only (the script
   re-publishes each post it covers).

package/skills/wix-headless-templates/blog/seed/seed-blog.mjs

@@ -12,7 +12,7 @@
 // Plan shape (see SEED.md):
 //   { "categories"?: [name], "tags"?: [name],
 //     "posts": [{ "title", "content": [blocks] | "richContent"?, "category"?|"categories"?,
-//                 "tags"?, "coverImageUrl"? | "coverImagePrompt"? }] }
+//                 "tags"?, "coverImageMediaId"? | "coverImageUrl"? | "coverImagePrompt"? }] }
 //   content blocks: { type:"heading", text, level? } | { type:"paragraph", text }
 //     | { type:"quote", text } | { type:"bulleted"|"ordered", items:[text,…] }
 //
@@ -23,6 +23,7 @@ import { readFileSync } from "node:fs";
 import { resolveItemImages } from "../../shared/seed/images.mjs";
 import { seedSiteId } from "../../shared/seed/site-context.mjs";
 import { wixToken } from "../../shared/seed/wix-cli.mjs";
+import { isMain } from "../../shared/seed/main.mjs";
 
 const API = "https://www.wixapis.com";
 const BLOG_APP_ID = "14bcded7-0066-7c35-14d7-466cb3f09103";
@@ -255,7 +256,7 @@ export async function setupBlog(ctx, { posts = [], categories = [], tags = [] }
   // never depends on images.
   const files = await resolveItemImages(ctx, created.map((c, i) => (
     c?.id && c?.success
-      ? { path: posts[i]?.coverImagePath, url: posts[i]?.coverImageUrl, prompt: posts[i]?.coverImagePrompt, displayName: `post-${i}.png` }
+      ? { mediaId: posts[i]?.coverImageMediaId, path: posts[i]?.coverImagePath, url: posts[i]?.coverImageUrl, prompt: posts[i]?.coverImagePrompt, displayName: `post-${i}.png` }
       : null
   )));
   const covers = created
@@ -319,7 +320,7 @@ async function ensureLabelsPersisted(ctx, { cats, tgs, created, posts, catId, ta
 
 // ---- CLI entry ----------------------------------------------------------------------------------
 
-const invokedDirectly = process.argv[1] && import.meta.url.endsWith(process.argv[1].split("/").pop());
+const invokedDirectly = isMain(import.meta.url);
 if (invokedDirectly) {
   const planPath = process.argv[2];
   if (!planPath) {

package/skills/wix-headless-templates/bookings/rest/booking.ts

@@ -14,8 +14,8 @@
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/cart-v2/create-cart.md
 // docs: https://dev.wix.com/docs/api-reference/business-management/headless/redirects/create-redirect-session.md
 // docs: https://dev.wix.com/docs/api-reference/crm/forms/form-schemas/get-form-summary.md
-import { wixRequest } from "./client.js";
-import { DEFAULT_BOOKINGS_SETTINGS, toBookingsSettings } from "./services-core.js";
+import { wixRequest } from "../../shared/rest/client.js";
+import { DEFAULT_BOOKINGS_SETTINGS, toBookingsSettings } from "../app/wix/bookings/services-core.js";
 import {
   FALLBACK_FIELDS,
   addOnGroupsRequest,
@@ -49,8 +49,8 @@ import {
   type NextAvailableOptions,
   type Raw,
   type SlotsWindow,
-} from "./booking-core.js";
-import type { AddOnGroup, BookingFormField, BookingResult, BookingsSettings, CourseAvailability, ServiceDetail, Session, Slot, SlotsPage, Weekday } from "./types.js";
+} from "../app/wix/bookings/booking-core.js";
+import type { AddOnGroup, BookingFormField, BookingResult, BookingsSettings, CourseAvailability, ServiceDetail, Session, Slot, SlotsPage, Weekday } from "../app/wix/bookings/types.js";
 
 export { resolveDisplayTimeZone, toLocalDateString };
 

package/skills/wix-headless-templates/bookings/rest/services.ts

@@ -6,8 +6,8 @@
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/query-services.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/query-categories.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/query-locations.md
-import { wixRequest } from "./client.js";
-import { imgSrc } from "./media.js";
+import { wixRequest } from "../../shared/rest/client.js";
+import { imgSrc } from "../../shared/rest/media.js";
 import {
   BOOKINGS_APP_ID,
   CATEGORIES_QUERY,
@@ -25,8 +25,8 @@ import {
   toSummary,
   type Raw,
   type ServicesFilterOptions,
-} from "./services-core.js";
-import type { BookingCategory, LocationOption, ServiceDetail, ServiceSummary } from "./types.js";
+} from "../app/wix/bookings/services-core.js";
+import type { BookingCategory, LocationOption, ServiceDetail, ServiceSummary } from "../app/wix/bookings/types.js";
 
 export { BOOKINGS_APP_ID, OTHER_LOCATIONS_ID, SERVICES_PAGE_SIZE, STAFF_RESOURCE_TYPE_ID };
 

package/skills/wix-headless-templates/bookings/seed/SEED.md

@@ -19,7 +19,7 @@ service an image — the default is an `imagePrompt` (AI-generated, ~1 Wix AI cr
 account-billed): brand-contextual — subject, aesthetic/mood, palette, lighting — always ending
 "no text, no watermarks". At least one image in the set shows the real subject of the business —
 the actual product/space/service, not abstract decoration. For an asset the user actually supplied
-use `imagePath` (a file on this machine — uploaded to Wix Media) or `imageUrl` (their own hosted
+use `imageMediaId` (a file already in the site's Media Manager, such as one the user uploaded there: used as it is, no copy; a `static.wixstatic.com/media/<file id>` URL of a site file counts as one), `imagePath` (a file on this machine — uploaded to Wix Media) or `imageUrl` (their own hosted
 URL; verify it with `curl -sI` → 200) — never a stock-photo or guessed URL. Images resolve in
 parallel and never block the seed; a failed image leaves that service text-only.
 

package/skills/wix-headless-templates/bookings/seed/seed-bookings.mjs

@@ -17,7 +17,7 @@
 //                    "price"? (number | { "from": number }), "priceText"?, "free"?, "deposit"?, "payInFull"?,
 //                    "duration"? (APPOINTMENT, minutes), "capacity"?, "waitlist"?, "maxParticipants"?,
 //                    "requireManualApproval"?, "conferencing"?, "staff"? (name | [names]), "location"? (name),
-//                    "category"? (name), "imageUrl"? | "imagePath"? | "imagePrompt"?,
+//                    "category"? (name), "imageMediaId"? | "imageUrl"? | "imagePath"? | "imagePrompt"?,
 //                    "sessions"?: [{ "start", "end", "capacity"? }],            // CLASS: one-off sessions, local "YYYY-MM-DDThh:mm:ss"
 //                    "weekly"?: { "days": ["MONDAY"], "time": "18:00", "duration": 60, "start", "end" } }] }  // CLASS or COURSE: recurring
 //
@@ -28,6 +28,7 @@ import { readFileSync } from "node:fs";
 import { resolveItemImages } from "../../shared/seed/images.mjs";
 import { seedSiteId } from "../../shared/seed/site-context.mjs";
 import { wixToken } from "../../shared/seed/wix-cli.mjs";
+import { isMain } from "../../shared/seed/main.mjs";
 
 const API = "https://www.wixapis.com";
 const BOOKINGS_APP_ID = "13d21c63-b5ec-5912-8397-c3a5ddb27a97";
@@ -355,6 +356,7 @@ export async function setupBookings(ctx, { services = [], staff = [], locations
   // Pass 2 — images: resolve (import by url / generate by prompt) in one parallel wave, then
   // attach. Failures leave the service text-only; the seed's exit never depends on images.
   const files = await resolveItemImages(ctx, created.map((c, i) => ({
+    mediaId: services[i]?.imageMediaId,
     url: services[i]?.imageUrl,
     path: services[i]?.imagePath,
     prompt: services[i]?.imagePrompt,
@@ -389,7 +391,7 @@ export async function setupBookings(ctx, { services = [], staff = [], locations
 
 // ---- CLI entry ----------------------------------------------------------------------------------
 
-const invokedDirectly = process.argv[1] && import.meta.url.endsWith(process.argv[1].split("/").pop());
+const invokedDirectly = isMain(import.meta.url);
 if (invokedDirectly) {
   const planPath = process.argv[2];
   if (!planPath) {

package/skills/wix-headless-templates/cms/rest/collections.ts

@@ -2,9 +2,9 @@
 // DTO; the mapper comes from collections-core (the SAME file the SDK transport uses, deployed flat
 // next to this one by deploy.mjs --stack static), so this file is only the transport.
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/cms/data-collections/create-data-collection.md (the Data Collections API; get is GET /wix-data/v2/collections/{id} per the SDK's route table)
-import { WixApiError, wixRequest } from "./client.js";
-import { toCollectionSchema, type RawCollection } from "./collections-core.js";
-import type { CmsCollectionSchema } from "./types.js";
+import { WixApiError, wixRequest } from "../../shared/rest/client.js";
+import { toCollectionSchema, type RawCollection } from "../app/wix/cms/collections-core.js";
+import type { CmsCollectionSchema } from "../app/wix/cms/types.js";
 
 const unreadable = (e: unknown): boolean => e instanceof WixApiError && (e.status === 404 || e.status === 403);
 

package/skills/wix-headless-templates/cms/rest/items.ts

@@ -9,8 +9,8 @@
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/cms/data-items/get-data-item.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/cms/data-items/patch-data-item.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/cms/data-items/bulk-insert-data-item-references.md
-import { WixApiError, wixRequest } from "./client.js";
-import { imgRatio, imgSrc } from "./media.js";
+import { WixApiError, wixRequest } from "../../shared/rest/client.js";
+import { imgRatio, imgSrc } from "../../shared/rest/media.js";
 import {
   DEFAULT_LIMIT,
   DISTINCT_LIMIT,
@@ -26,8 +26,8 @@ import {
   toValues,
   type Media,
   type Raw,
-} from "./items-core.js";
-import type { CmsFilter, CmsItem, CmsPage, CmsQuery } from "./types.js";
+} from "../app/wix/cms/items-core.js";
+import type { CmsFilter, CmsItem, CmsPage, CmsQuery } from "../app/wix/cms/types.js";
 
 const media: Media = { imgSrc, imgRatio };
 const notFound = (e: unknown): boolean => e instanceof WixApiError && e.status === 404;

package/skills/wix-headless-templates/cms/seed/seed-cms.mjs

@@ -25,6 +25,7 @@ import { readFileSync } from "node:fs";
 import { resolveItemImages } from "../../shared/seed/images.mjs";
 import { seedSiteId } from "../../shared/seed/site-context.mjs";
 import { wixToken } from "../../shared/seed/wix-cli.mjs";
+import { isMain } from "../../shared/seed/main.mjs";
 
 const API = "https://www.wixapis.com";
 const WIX_DATA_APP_ID = "e593b0bd-b783-45b8-97c2-873d42aacaf4";
@@ -303,7 +304,7 @@ export async function setupCms(ctx, { collections = [] } = {}) {
 
 // ---- CLI entry ----------------------------------------------------------------------------------
 
-const invokedDirectly = process.argv[1] && import.meta.url.endsWith(process.argv[1].split("/").pop());
+const invokedDirectly = isMain(import.meta.url);
 if (invokedDirectly) {
   const planPath = process.argv[2];
   if (!planPath) {

package/skills/wix-headless-templates/donations/rest/campaigns.ts

@@ -6,10 +6,10 @@
 // Porting: keep the path, keep the body, port the core once.
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/donations/donation-campaigns/query-donation-campaigns.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/donations/donation-campaigns/get-donation-campaign-metrics.md
-import { WixApiError, wixRequest } from "./client.js";
-import { imgSrc } from "./media.js";
-import { campaignsQuery, currencyOf, isArchived, rawId, toDetail, toSummary, type Raw } from "./donations-core.js";
-import type { CampaignDetail, CampaignSummary } from "./types.js";
+import { WixApiError, wixRequest } from "../../shared/rest/client.js";
+import { imgSrc } from "../../shared/rest/media.js";
+import { campaignsQuery, currencyOf, isArchived, rawId, toDetail, toSummary, type Raw } from "../app/wix/donations/donations-core.js";
+import type { CampaignDetail, CampaignSummary } from "../app/wix/donations/types.js";
 
 const BASE = "/donation-campaigns/v2/donation-campaigns";
 

package/skills/wix-headless-templates/donations/rest/donate.ts

@@ -7,7 +7,7 @@
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/cart-v2/create-cart.md
 // docs: https://dev.wix.com/docs/api-reference/business-management/headless/redirects/create-redirect-session.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/orders/get-order.md
-import { wixRequest } from "./client.js";
+import { wixRequest } from "../../shared/rest/client.js";
 import {
   cartBody,
   cartIdOf,
@@ -17,8 +17,8 @@ import {
   toReceipt,
   type DonatePaths,
   type Raw,
-} from "./donations-core.js";
-import type { DonationInput, DonationReceipt } from "./types.js";
+} from "../app/wix/donations/donations-core.js";
+import type { DonationInput, DonationReceipt } from "../app/wix/donations/types.js";
 
 export type { DonatePaths };
 

package/skills/wix-headless-templates/donations/seed/SEED.md

@@ -16,7 +16,7 @@ amount with a minimum, the note and the cover-fee prompt on. A second campaign (
 only when the brief lists several causes. Every campaign gets a cover image — the default is an
 `imagePrompt` (AI-generated, ~1 Wix AI credit per image, account-billed): brand-contextual — subject,
 mood, palette, lighting — always ending "no text, no watermarks"; a real subject of the cause, not
-abstract decoration. For an asset the user supplied use `imagePath` (a file on this machine) or
+abstract decoration. For an asset the user supplied use `imageMediaId` (a file already in the site's Media Manager, such as one the user uploaded there: used as it is, no copy; a `static.wixstatic.com/media/<file id>` URL of a site file counts as one), `imagePath` (a file on this machine) or
 `imageUrl` (their own hosted URL; verify with `curl -sI` → 200) — never a stock or guessed URL.
 Images resolve in parallel and never block the seed; a failed image leaves the campaign text-only.
 

package/skills/wix-headless-templates/donations/seed/seed-donations.mjs

@@ -16,7 +16,7 @@
 //                     "customAmount"?: { "enabled", "min"?, "max"? },
 //                     "goal"?: { "target", "endDate"?, "acceptAfterGoal"?, "acceptAfterEndDate"? },
 //                     "comments"?: false, "askCoverFee"?: false,
-//                     "imageUrl"? | "imagePath"? | "imagePrompt"? }] }
+//                     "imageMediaId"? | "imageUrl"? | "imagePath"? | "imagePrompt"? }] }
 //
 // Seeding is ADDITIVE and idempotent — a non-archived campaign with the same name is reused, never
 // duplicated; nothing is deleted or overwritten. Unexpected shapes → read the live API reference;
@@ -25,6 +25,7 @@ import { setSiteCurrency } from "../../shared/seed/site.mjs";
 import { resolveItemImages } from "../../shared/seed/images.mjs";
 import { seedSiteId } from "../../shared/seed/site-context.mjs";
 import { wixToken } from "../../shared/seed/wix-cli.mjs";
+import { isMain } from "../../shared/seed/main.mjs";
 import { readFileSync } from "node:fs";
 import { randomUUID } from "node:crypto";
 
@@ -196,8 +197,9 @@ export async function setupDonations(ctx, { campaigns = [], currency } = {}) {
 
   // Pass 2 — images: resolve (upload a local file / import by url / generate by prompt) in one
   // parallel wave, then attach. Failures leave the campaign text-only; the exit never depends on them.
-  const wanted = created.filter((c) => c.created && (c.plan.imageUrl || c.plan.imagePath || c.plan.imagePrompt));
+  const wanted = created.filter((c) => c.created && (c.plan.imageMediaId || c.plan.imageUrl || c.plan.imagePath || c.plan.imagePrompt));
   const files = await resolveItemImages(ctx, wanted.map((c) => ({
+    mediaId: c.plan.imageMediaId,
     url: c.plan.imageUrl,
     path: c.plan.imagePath,
     prompt: c.plan.imagePrompt,
@@ -232,7 +234,7 @@ export async function setupDonations(ctx, { campaigns = [], currency } = {}) {
 
 // ---- CLI entry ----------------------------------------------------------------------------------
 
-const invokedDirectly = process.argv[1] && import.meta.url.endsWith(process.argv[1].split("/").pop());
+const invokedDirectly = isMain(import.meta.url);
 if (invokedDirectly) {
   const planPath = process.argv[2];
   if (!planPath) {

package/skills/wix-headless-templates/events/rest/events.ts

@@ -7,8 +7,8 @@
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/events-v3/get-event-by-slug.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/events-v3/get-event.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/categories/query-categories.md
-import { WixApiError, wixRequest } from "./client.js";
-import { imgSrc } from "./media.js";
+import { WixApiError, wixRequest } from "../../shared/rest/client.js";
+import { imgSrc } from "../../shared/rest/media.js";
 import {
   DEFAULT_PAGE_SIZE,
   DETAIL_FIELDS,
@@ -23,8 +23,8 @@ import {
   toSummary,
   type ListOptions,
   type Raw,
-} from "./events-core.js";
-import type { EventCategory, EventDetail, EventSummary } from "./types.js";
+} from "../app/wix/events/events-core.js";
+import type { EventCategory, EventDetail, EventSummary } from "../app/wix/events/types.js";
 
 export { EVENTS_APP_ID, type ListOptions };
 

package/skills/wix-headless-templates/events/rest/orders.ts

@@ -4,10 +4,10 @@
 // order on this visitor's session. Not guaranteed for every site's visitor scope: a 403 throws
 // and the confirmation surface degrades to a confirmation without order details.
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/events/registration/ticketing/orders/get-order.md
-import { WixApiError, wixRequest } from "./client.js";
-import { ORDER_FIELDSETS, toOrder } from "./orders-core.js";
-import type { Raw } from "./events-core.js";
-import type { OrderSummary } from "./types.js";
+import { WixApiError, wixRequest } from "../../shared/rest/client.js";
+import { ORDER_FIELDSETS, toOrder } from "../app/wix/events/orders-core.js";
+import type { Raw } from "../app/wix/events/events-core.js";
+import type { OrderSummary } from "../app/wix/events/types.js";
 
 /**
  * One order by the pair the thank-you URL carries. Null on 404; throws on anything else.

package/skills/wix-headless-templates/events/rest/registration.ts

@@ -9,7 +9,7 @@
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/events/registration/ticketing/ticket-reservations/create-ticket-reservation.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/events/registration/rsvp-v2/create-rsvp.md
 // docs: https://dev.wix.com/docs/api-reference/business-management/headless/redirects/create-redirect-session.md
-import { wixRequest } from "./client.js";
+import { wixRequest } from "../../shared/rest/client.js";
 import {
   availableTiersQuery,
   checkoutCallbacks,
@@ -25,9 +25,9 @@ import {
   type CheckoutPaths,
   type RsvpValues,
   type TierEvent,
-} from "./registration-core.js";
-import type { Raw } from "./events-core.js";
-import type { EventDetail, RegistrationResult, TicketSelection, TicketTier } from "./types.js";
+} from "../app/wix/events/registration-core.js";
+import type { Raw } from "../app/wix/events/events-core.js";
+import type { EventDetail, RegistrationResult, TicketSelection, TicketTier } from "../app/wix/events/types.js";
 
 export { type CheckoutPaths, type RsvpValues, type TierEvent };
 

package/skills/wix-headless-templates/events/seed/SEED.md

@@ -17,7 +17,7 @@ the shape; the owner adds the rest in the dashboard) and make them exercise the
 image (an events page without images looks broken) — the default is an `imagePrompt`
 (AI-generated, ~1 Wix AI credit per image, account-billed): brand-contextual — subject,
 aesthetic/mood, palette, lighting — always ending "no text, no watermarks". At least one image in the set shows the real subject of the business — the actual product/space/service, not abstract decoration. For an asset the user actually
-supplied use `imagePath` (a file on this machine — uploaded to Wix Media) or `imageUrl`
+supplied use `imageMediaId` (a file already in the site's Media Manager, such as one the user uploaded there: used as it is, no copy; a `static.wixstatic.com/media/<file id>` URL of a site file counts as one), `imagePath` (a file on this machine — uploaded to Wix Media) or `imageUrl`
 (their own hosted URL; verify it with `curl -sI` → 200) — never a stock-photo or guessed URL. Images resolve in parallel and never block the
 seed; a failed image leaves that event text-only.
 

package/skills/wix-headless-templates/events/seed/seed-events.mjs

@@ -14,7 +14,7 @@
 //                  "startDate", "endDate" (future ISO-8601 UTC), "timeZoneId",
 //                  "location" ({name,type:"VENUE",address} | {name,type:"ONLINE"} | {locationTbd:true,name}),
 //                  "ticketTiers"?: [{ "name" (≤30 chars), "price" (decimal STRING), "description"?, "initialLimit"?, "feeType"? }],
-//                  "category"? (name), "imageUrl"? | "imagePrompt"?, "rsvpResponseType"? }] }
+//                  "category"? (name), "imageMediaId"? | "imageUrl"? | "imagePrompt"?, "rsvpResponseType"? }] }
 //
 // Seeding is ADDITIVE — never deletes or overwrites existing content. Unexpected shapes →
 // read the live API reference; every call below
@@ -24,6 +24,7 @@ import { readFileSync } from "node:fs";
 import { resolveItemImages } from "../../shared/seed/images.mjs";
 import { seedSiteId } from "../../shared/seed/site-context.mjs";
 import { wixToken } from "../../shared/seed/wix-cli.mjs";
+import { isMain } from "../../shared/seed/main.mjs";
 
 const API = "https://www.wixapis.com";
 const EVENTS_APP_ID = "140603ad-af8d-84a5-2c80-a0f60cb47351";
@@ -260,7 +261,7 @@ export async function setupEvents(ctx, { events = [], currency } = {}) {
       catch (err) { console.error(`guest control skipped for "${ev.title}": ${err.message}`); }
     }
     await publishEvent(ctx, e.id);
-    created.push({ ...e, category: ev.category, imageUrl: ev.imageUrl, imagePrompt: ev.imagePrompt, ticketCount: tiers.length, feeTypes: tiers.map((t) => t.feeType), ...(ev.guests ? { guestControl } : {}) });
+    created.push({ ...e, category: ev.category, imageMediaId: ev.imageMediaId, imageUrl: ev.imageUrl, imagePrompt: ev.imagePrompt, ticketCount: tiers.length, feeTypes: tiers.map((t) => t.feeType), ...(ev.guests ? { guestControl } : {}) });
   }
 
   const names = [...new Set(created.map((e) => e.category).filter(Boolean))];
@@ -273,6 +274,7 @@ export async function setupEvents(ctx, { events = [], currency } = {}) {
   // Pass 2 — images: resolve (import by url / generate by prompt) in one parallel wave, then
   // attach. Failures leave the event text-only; the seed's exit never depends on images.
   const files = await resolveItemImages(ctx, created.map((e) => ({
+    mediaId: e.imageMediaId,
     url: e.imageUrl,
     path: e.imagePath,
     prompt: e.imagePrompt,
@@ -304,7 +306,7 @@ export async function setupEvents(ctx, { events = [], currency } = {}) {
 
 // ---- CLI entry ----------------------------------------------------------------------------------
 
-const invokedDirectly = process.argv[1] && import.meta.url.endsWith(process.argv[1].split("/").pop());
+const invokedDirectly = isMain(import.meta.url);
 if (invokedDirectly) {
   const planPath = process.argv[2];
   if (!planPath) {

package/skills/wix-headless-templates/faq/rest/faq.ts

@@ -7,8 +7,8 @@
 // Porting: keep the paths, keep the bodies, port the core once.
 // docs: https://dev.wix.com/docs/rest/business-management/faq-app/faq/category-v2/query-categories.md
 // docs: https://dev.wix.com/docs/rest/business-management/faq-app/faq/question-entry-v2/query-question-entries.md
-import { wixRequest } from "./client.js";
-import { imgSrc } from "./media.js";
+import { wixRequest } from "../../shared/rest/client.js";
+import { imgSrc } from "../../shared/rest/media.js";
 import {
   FAQ_APP_ID,
   assembleFaq,
@@ -21,8 +21,8 @@ import {
   toCategory,
   toQuestion,
   type Raw,
-} from "./faq-core.js";
-import type { FaqCategory, FaqData, FaqQuestion, FaqQuestionPage, FetchQuestionsOptions } from "./types.js";
+} from "../app/wix/faq/faq-core.js";
+import type { FaqCategory, FaqData, FaqQuestion, FaqQuestionPage, FetchQuestionsOptions } from "../app/wix/faq/types.js";
 
 export { FAQ_APP_ID };
 

package/skills/wix-headless-templates/faq/seed/seed-faq.mjs

@@ -20,6 +20,7 @@
 // reference page.
 import { seedSiteId } from "../../shared/seed/site-context.mjs";
 import { wixToken } from "../../shared/seed/wix-cli.mjs";
+import { isMain } from "../../shared/seed/main.mjs";
 import { readFileSync } from "node:fs";
 
 const API = "https://www.wixapis.com";
@@ -281,7 +282,7 @@ export async function setupFaq(ctx, { categories = [] } = {}) {
 
 // ---- CLI entry ----------------------------------------------------------------------------------
 
-const invokedDirectly = process.argv[1] && import.meta.url.endsWith(process.argv[1].split("/").pop());
+const invokedDirectly = isMain(import.meta.url);
 if (invokedDirectly) {
   const planPath = process.argv[2];
   if (!planPath) {

package/skills/wix-headless-templates/forms/rest/forms.ts

@@ -6,10 +6,10 @@
 // Porting: keep the paths, keep the query, port the core once.
 // docs: https://dev.wix.com/docs/api-reference/crm/forms/form-schemas/get-form.md
 // docs: https://dev.wix.com/docs/api-reference/crm/forms/form-schemas/list-forms.md
-import { wixRequest } from "./client.js";
-import { imgSrc } from "./media.js";
-import { FORMS_NAMESPACE, applyRules, isClosed, otherText, otherValue, toForm, type Raw } from "./forms-core.js";
-import type { FormDto } from "./types.js";
+import { wixRequest } from "../../shared/rest/client.js";
+import { imgSrc } from "../../shared/rest/media.js";
+import { FORMS_NAMESPACE, applyRules, isClosed, otherText, otherValue, toForm, type Raw } from "../app/wix/forms/forms-core.js";
+import type { FormDto } from "../app/wix/forms/types.js";
 
 export { FORMS_NAMESPACE, applyRules, isClosed, otherText, otherValue };
 

package/skills/wix-headless-templates/forms/rest/submissions.ts

@@ -8,8 +8,8 @@
 // docs: https://dev.wix.com/docs/api-reference/crm/forms/form-submissions/create-submission.md
 // docs: https://dev.wix.com/docs/api-reference/crm/forms/form-submissions/get-media-upload-url.md
 // docs: https://dev.wix.com/docs/api-reference/business-management/headless/redirects/create-redirect-session.md
-import { wixRequest } from "./client.js";
-import type { Raw } from "./forms-core.js";
+import { wixRequest } from "../../shared/rest/client.js";
+import type { Raw } from "../app/wix/forms/forms-core.js";
 import {
   SUBMITTED_OK,
   formLevelError,
@@ -23,8 +23,8 @@ import {
   toSubmissionValues,
   uploadFilesWith,
   uploadMimeType,
-} from "./submissions-core.js";
-import type { FormFieldDto, FormValues, SubmissionDto, UploadedFile } from "./types.js";
+} from "../app/wix/forms/submissions-core.js";
+import type { FormFieldDto, FormValues, SubmissionDto, UploadedFile } from "../app/wix/forms/types.js";
 
 export { SUBMITTED_OK, formLevelError, normalizePhone, normalizeUrl, submissionErrors, toSubmissionValues };