@wix/agent-skills 1.26.0 → 1.27.0

package/skills/wix-headless-templates/shared/seed/site-context.mjs

@@ -0,0 +1,70 @@
+// Which site a seed or a reader targets — the templates' twin of install/context.mjs (the templates
+// ship without the skill's install/ folder in reach, so the reading is repeated here, in full).
+//
+// A project's `wix.config.json` names the DEPLOY site; `.env.local` (what `wix env pull` writes) names
+// the CONTENT site's app, and on a migration preview also the site being migrated (the parent). Seeds
+// and readers are admin calls about content, so they target the content site: the config's site
+// normally, the parent on a migration. `env pull` runs when `.env.local` is missing.
+import { runWix } from "./wix-cli.mjs";
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+
+// Spelled once in install/context.mjs; keep the two in step.
+export const ENV = { clientId: "WIX_CLIENT_ID", parentSiteId: "EDITOR_MIGRATION_PARENT_SITE_ID", status: "EDITOR_MIGRATION_STATUS" };
+
+function readEnvFile(file) {
+  if (!existsSync(file)) return null;
+  const out = {};
+  for (const raw of readFileSync(file, "utf8").split(/\r?\n/)) {
+    const line = raw.trim();
+    if (!line || line.startsWith("#")) continue;
+    const eq = line.indexOf("=");
+    if (eq === -1) continue;
+    let value = line.slice(eq + 1).trim();
+    if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) value = value.slice(1, -1).replace(/\\"/g, '"');
+    out[line.slice(0, eq).trim().replace(/^export\s+/, "")] = value;
+  }
+  return out;
+}
+
+
+const runPull = (dir) => runWix(["env", "pull"], { cwd: dir, env: { ...process.env, CI: "1" }, encoding: "utf8", timeout: 180_000 });
+
+// `wix env pull` into cwd/.env.local, in place (every project shape has the command since Wix CLI
+// 1.1.253; same as install/context.mjs).
+function pullEnv(cwd) {
+  const r = runPull(cwd);
+  return r.status === 0 && existsSync(join(cwd, ".env.local"));
+}
+
+/** `{ deploySiteId, contentSiteId, migration: { active, parentSiteId } }` for the folder. */
+export function siteContext({ cwd = process.cwd() } = {}) {
+  const configFile = join(cwd, "wix.config.json");
+  const config = existsSync(configFile) ? JSON.parse(readFileSync(configFile, "utf8")) : {};
+  const deploySiteId = config.siteId ?? config.projectId ?? null;
+  const envFile = join(cwd, ".env.local");
+  if (deploySiteId && !existsSync(envFile)) pullEnv(cwd);
+  const env = readEnvFile(envFile) ?? {};
+  const parentSiteId = env[ENV.parentSiteId] || null;
+  const status = env[ENV.status];
+  const active = !!parentSiteId && (status === undefined || status.trim().toUpperCase() === "ACTIVE");
+  return { deploySiteId, contentSiteId: active ? parentSiteId : deploySiteId, migration: { active, parentSiteId: active ? parentSiteId : null } };
+}
+
+/** The site a READ targets (a reader, a sizing): the content site. */
+export function contentSiteId({ cwd = process.cwd() } = {}) {
+  return siteContext({ cwd }).contentSiteId;
+}
+
+/**
+ * The site a SEED writes to. On a migration preview the content site is the live original, so the
+ * seed stops unless the caller passed `--allow-parent` after the user confirmed. Throws with the reason.
+ */
+export function seedSiteId({ cwd = process.cwd(), argv = process.argv } = {}) {
+  const ctx = siteContext({ cwd });
+  if (!ctx.deploySiteId) throw new Error("wix.config.json has no siteId — is this a Wix CLI project?");
+  if (ctx.migration.active && !argv.includes("--allow-parent")) {
+    throw new Error(`this project deploys a migration preview of site ${ctx.migration.parentSiteId}: seeding would write into the live original. The site owns its content — skip the seed; if the user asked for content to be created there, re-run with --allow-parent.`);
+  }
+  return ctx.contentSiteId;
+}

package/skills/wix-headless-templates/shared/seed/site.mjs

@@ -0,0 +1,48 @@
+// Site-level settings a seed applies before it creates content. Same ctx as every seed:
+// { token, siteId }, the site token minted by the seed itself.
+const API = "https://www.wixapis.com";
+
+// The site currency, set BEFORE any priced content exists. A product's, service's, ticket tier's
+// or plan's price is stored in the site currency at create time, and an event's ticket tiers
+// cannot be repriced afterwards. A new site starts in the currency of the account that created
+// it, not the business's. Reads can report the old currency for a few seconds after this returns;
+// that lag is expected and self-resolves.
+// docs: https://dev.wix.com/docs/rest/business-management/site-properties/properties/update-site-properties
+export async function setSiteCurrency(ctx, currency) {
+  if (!/^[A-Z]{3}$/.test(currency)) throw new Error(`currency must be a 3-letter ISO code, got "${currency}"`);
+  const res = await fetch(`${API}/site-properties/v4/properties`, {
+    method: "PATCH",
+    headers: { Authorization: `Bearer ${ctx.token}`, "wix-site-id": ctx.siteId, "Content-Type": "application/json" },
+    body: JSON.stringify({ properties: { paymentCurrency: currency }, fields: { paths: ["paymentCurrency"] } }),
+  });
+  const json = await res.json().catch(() => ({}));
+  if (!res.ok) throw new Error(`PATCH /site-properties/v4/properties -> ${res.status}: ${JSON.stringify(json).slice(0, 300)}`);
+  return currency;
+}
+
+// The Wix Site Search app. Installing it is what indexes a site's products, services, posts and
+// events for the site-search capability (templates/shared/capabilities/site-search); without it every
+// search answers 200 with zero documents, silently. The install back-fills existing content — results
+// appear about half a minute later (products in ~26 s, services in ~14 s, observed) — so run it AFTER
+// the content seed. Opt-in: nothing calls this unless plan.capabilities.siteSearch.install is true
+// (the capability's seed/install.mjs does). Idempotent: an installed app is reported, not re-installed.
+// docs: https://dev.wix.com/docs/api-reference/business-management/app-installation/app-installation/get-installed-apps
+// docs: https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/platform/about-apps-created-by-wix.md
+export const SITE_SEARCH_APP_ID = "1484cb44-49cd-5b39-9681-75188ab429de";
+
+export async function installSiteSearch(ctx) {
+  const headers = { Authorization: `Bearer ${ctx.token}`, "wix-site-id": ctx.siteId, "Content-Type": "application/json" };
+  const listed = await fetch(`${API}/apps-installer-service/v1/app-instances`, { headers });
+  const list = await listed.json().catch(() => ({}));
+  if (!listed.ok) throw new Error(`GET /apps-installer-service/v1/app-instances -> ${listed.status}: ${JSON.stringify(list).slice(0, 300)}`);
+  const already = (list.appInstances ?? []).some((a) => a.appDefId === SITE_SEARCH_APP_ID || a.appId === SITE_SEARCH_APP_ID);
+  if (already) return { appId: SITE_SEARCH_APP_ID, installed: "already" };
+  const res = await fetch(`${API}/apps-installer-service/v1/app-instance/install`, {
+    method: "POST",
+    headers,
+    body: JSON.stringify({ tenant: { tenantType: "SITE", id: ctx.siteId }, appInstance: { appDefId: SITE_SEARCH_APP_ID, enabled: true } }),
+  });
+  const json = await res.json().catch(() => ({}));
+  if (!res.ok) throw new Error(`POST /apps-installer-service/v1/app-instance/install -> ${res.status}: ${JSON.stringify(json).slice(0, 300)}`);
+  return { appId: SITE_SEARCH_APP_ID, installed: "now" };
+}

package/skills/wix-headless-templates/shared/seed/wix-cli.mjs

@@ -0,0 +1,44 @@
+// The Wix CLI the seeds call for a site token and for `wix env pull`.
+//
+// Order: the project's own copy (node_modules/.bin/wix, installed with the template's lock), then
+// a `wix` on PATH, then `npx -y @wix/cli@latest` — which installs the CLI before running it, 20 to
+// 60 s and a wall of npm output on a fresh machine. The first two take under two seconds.
+import { existsSync } from "node:fs";
+import { delimiter, join } from "node:path";
+import { execFileSync, spawnSync } from "node:child_process";
+
+export function resolveWixCli(cwd = process.cwd()) {
+  const bin = process.platform === "win32" ? "wix.cmd" : "wix";
+  const local = join(cwd, "node_modules", ".bin", bin);
+  // The project's copy counts only once its install has finished: the seed runs beside a detached
+  // npm install, and mid-install the .bin shim can exist before the package it points at does
+  // (seen live: "Cannot find module node_modules/.bin/wix"). npm writes node_modules/.package-lock.json
+  // last, the same marker the kit's install step syncs on.
+  const installed = existsSync(join(cwd, "node_modules", ".package-lock.json")) && existsSync(join(cwd, "node_modules", "@wix", "cli", "package.json"));
+  if (installed && existsSync(local)) return { file: local, prefix: [] };
+  for (const dir of (process.env.PATH ?? "").split(delimiter)) {
+    if (dir && existsSync(join(dir, bin))) return { file: join(dir, bin), prefix: [] };
+  }
+  return { file: "npx", prefix: ["-y", "@wix/cli@latest"] };
+}
+
+/**
+ * A site token for the API calls. Throws when the CLI is not logged in. The CLI may print a
+ * notice (an update box, a project warning) around the token, so the token is extracted from
+ * the output rather than taken whole.
+ */
+export function wixToken(siteId, cwd = process.cwd()) {
+  const cli = resolveWixCli(cwd);
+  const out = execFileSync(cli.file, [...cli.prefix, "token", "--site", siteId], { encoding: "utf8", cwd });
+  // An older CLI starts its "update available" box on the token's own line, so a line split is
+  // not enough: the token is the first long run of token characters.
+  const token = out.match(/[A-Za-z0-9._-]{40,}/)?.[0];
+  if (!token) throw new Error("The Wix CLI returned no token — run `wix login` (or `npx @wix/cli@latest login`) first.");
+  return token;
+}
+
+/** Runs a Wix CLI command synchronously; same return shape as spawnSync. */
+export function runWix(args, { cwd = process.cwd(), ...opts } = {}) {
+  const cli = resolveWixCli(cwd);
+  return spawnSync(cli.file, [...cli.prefix, ...args], { cwd, ...opts });
+}