@koda-plus/medusa-plugin-subiekt-nexo 0.2.0 → 0.2.1

package/.medusa/server/src/admin/index.js

@@ -347,26 +347,13 @@ function resolveText(value, lang) {
   const pl2 = lang.toLowerCase().startsWith("pl");
   return (pl2 ? value.pl ?? value.en : value.en ?? value.pl) || void 0;
 }
-const PL_GENITIVE = ["stycznia", "lutego", "marca", "kwietnia", "maja", "czerwca", "lipca", "sierpnia", "września", "października", "listopada", "grudnia"];
-function monthYear(since, lang) {
-  const m = /^(\d{4})-(\d{2})$/.exec(since);
-  if (!m) return since;
-  const year = Number(m[1]);
-  const month = Number(m[2]);
-  if (lang.toLowerCase().startsWith("pl")) return `${PL_GENITIVE[month - 1] ?? m[2]} ${year}`;
-  try {
-    return new Intl.DateTimeFormat(lang, { month: "long", year: "numeric", timeZone: "UTC" }).format(new Date(Date.UTC(year, month - 1, 15)));
-  } catch {
-    return since;
-  }
-}
 function referencesFor(list, lang) {
   return (list ?? []).map((r) => ({
     name: r.name,
-    url: r.url,
+    url: r.url ?? void 0,
+    soon: r.soon,
     icon: r.icon,
     description: resolveText(r.description, lang),
-    since: r.since,
     metrics: r.metrics.map((m) => ({ label: resolveText(m.label, lang) ?? "", value: m.value })).filter((m) => m.label),
     links: r.links.map((l) => ({ label: resolveText(l.label, lang) ?? l.url, url: l.url })),
     review: r.review ? { ...r.review, quote: resolveText(r.review.quote ?? void 0, lang) } : null
@@ -545,6 +532,10 @@ const SubiektOrderWidget = ({ data }) => {
 adminSdk.defineWidgetConfig({
   zone: "order.details.side.after"
 });
+const KIT_META = {
+  pkg: "@koda-plus/medusa-plugin-subiekt-nexo",
+  version: "0.2.1"
+};
 const NBSP = " ";
 const NBHY = "‑";
 const SHORT = /(^|[\s("„])(oraz|albo|lub|ale|że|bo|czy|gdy|aby|by|więc|jak|na|do|za|ze|we|od|po|to|[aiouwze])[ \t]+/gi;
@@ -676,6 +667,12 @@ function ModeBadge({ color, label, title, children }) {
     ] })
   ] });
 }
+function splitReferences(items) {
+  return {
+    live: items.filter((r) => !r.soon && typeof r.url === "string" && r.url !== ""),
+    soon: items.filter((r) => r.soon === true)
+  };
+}
 const host = (url) => {
   try {
     return new URL(url).host.replace(/^www\./, "");
@@ -709,8 +706,9 @@ function meanRating(items) {
   return { value: Math.round(value * 10) / 10, first: reviews[0] };
 }
 function ReferencesBadge({ items, labels }) {
-  if (items.length === 0) return null;
-  const mean = meanRating(items);
+  const { live, soon } = splitReferences(items);
+  if (live.length + soon.length === 0) return null;
+  const mean = meanRating(live);
   return /* @__PURE__ */ jsxRuntime.jsxs(ui.Popover, { children: [
     /* @__PURE__ */ jsxRuntime.jsx(ui.Popover.Trigger, { asChild: true, children: /* @__PURE__ */ jsxRuntime.jsxs(
       "button",
@@ -718,8 +716,11 @@ function ReferencesBadge({ items, labels }) {
         type: "button",
         className: "inline-flex h-9 max-w-full items-center gap-x-3 rounded-full border border-ui-border-base bg-ui-bg-component py-1 pl-1.5 pr-3 outline-none transition-fg hover:bg-ui-bg-component-hover focus-visible:shadow-borders-focus",
         children: [
-          /* @__PURE__ */ jsxRuntime.jsx("span", { className: "flex shrink-0 items-center", children: items.slice(0, 3).map((r, i) => /* @__PURE__ */ jsxRuntime.jsx("span", { className: ui.clx("rounded-md", i > 0 && "-ml-2"), children: /* @__PURE__ */ jsxRuntime.jsx(StoreIcon, { reference: r, size: 24 }) }, r.url)) }),
-          /* @__PURE__ */ jsxRuntime.jsx("span", { className: "txt-compact-small-plus truncate text-ui-fg-base", children: labels.count }),
+          /* @__PURE__ */ jsxRuntime.jsx("span", { className: "flex shrink-0 items-center", children: [...live, ...soon].slice(0, 3).map((r, i) => /* @__PURE__ */ jsxRuntime.jsx("span", { className: ui.clx("rounded-md", i > 0 && "-ml-2", r.soon && "opacity-50"), children: /* @__PURE__ */ jsxRuntime.jsx(StoreIcon, { reference: r, size: 24 }) }, r.url ?? r.name)) }),
+          /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "flex min-w-0 items-center gap-x-1.5", children: [
+            /* @__PURE__ */ jsxRuntime.jsx("span", { className: "txt-compact-small-plus truncate text-ui-fg-base", children: labels.count(live.length, soon.length) }),
+            live.length > 0 && soon.length > 0 ? /* @__PURE__ */ jsxRuntime.jsx("span", { className: "txt-compact-small shrink-0 text-ui-fg-muted", children: labels.soonMore(soon.length) }) : null
+          ] }),
           mean ? /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "flex shrink-0 items-center gap-x-2 border-l border-ui-border-base pl-3", children: [
             /* @__PURE__ */ jsxRuntime.jsx(Stars, { rating: mean.value, size: 13 }),
             /* @__PURE__ */ jsxRuntime.jsx("span", { className: "txt-compact-small-plus tabular-nums text-ui-fg-base", children: labels.rating(mean.value) }),
@@ -734,52 +735,61 @@ function ReferencesBadge({ items, labels }) {
         /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: "small", weight: "plus", className: "text-ui-fg-base", children: labels.title }),
         /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: "xsmall", className: "text-ui-fg-subtle", children: labels.subtitle })
       ] }),
-      /* @__PURE__ */ jsxRuntime.jsx("ul", { className: "flex max-h-[60vh] flex-col divide-y divide-ui-border-base overflow-y-auto", children: items.map((r) => {
-        var _a, _b;
-        return /* @__PURE__ */ jsxRuntime.jsxs("li", { className: "flex flex-col gap-y-2 px-4 py-3", children: [
-          /* @__PURE__ */ jsxRuntime.jsxs("a", { href: r.url, target: "_blank", rel: "noreferrer", className: "group flex items-center gap-x-3", children: [
-            /* @__PURE__ */ jsxRuntime.jsx(StoreIcon, { reference: r, size: 32 }),
-            /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "flex min-w-0 flex-col", children: [
-              /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: "small", weight: "plus", className: "truncate text-ui-fg-base", children: r.name }),
-              /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: "xsmall", className: "truncate text-ui-fg-interactive group-hover:text-ui-fg-interactive-hover", children: host(r.url) })
+      /* @__PURE__ */ jsxRuntime.jsxs("ul", { className: "flex max-h-[60vh] flex-col divide-y divide-ui-border-base overflow-y-auto", children: [
+        live.map((r) => {
+          var _a, _b;
+          return /* @__PURE__ */ jsxRuntime.jsxs("li", { className: "flex flex-col gap-y-2 px-4 py-3", children: [
+            /* @__PURE__ */ jsxRuntime.jsxs("a", { href: r.url, target: "_blank", rel: "noreferrer", className: "group flex items-center gap-x-3", children: [
+              /* @__PURE__ */ jsxRuntime.jsx(StoreIcon, { reference: r, size: 32 }),
+              /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "flex min-w-0 flex-col", children: [
+                /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: "small", weight: "plus", className: "truncate text-ui-fg-base", children: r.name }),
+                /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: "xsmall", className: "truncate text-ui-fg-interactive group-hover:text-ui-fg-interactive-hover", children: host(r.url) })
+              ] }),
+              /* @__PURE__ */ jsxRuntime.jsx(icons.ArrowUpRightOnBox, { className: "ml-auto shrink-0 text-ui-fg-muted group-hover:text-ui-fg-interactive" })
             ] }),
-            /* @__PURE__ */ jsxRuntime.jsx(icons.ArrowUpRightOnBox, { className: "ml-auto shrink-0 text-ui-fg-muted group-hover:text-ui-fg-interactive" })
-          ] }),
-          r.review ? /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-wrap items-center gap-x-2 gap-y-1", children: [
-            /* @__PURE__ */ jsxRuntime.jsx(Stars, { rating: r.review.rating, scale: r.review.scale }),
-            /* @__PURE__ */ jsxRuntime.jsx("span", { className: "txt-compact-xsmall-plus tabular-nums text-ui-fg-base", children: labels.rating(r.review.rating / (r.review.scale || 5) * 5) }),
-            /* @__PURE__ */ jsxRuntime.jsx(SourceMark, { review: r.review }),
-            r.review.url ? /* @__PURE__ */ jsxRuntime.jsxs("a", { href: r.review.url, target: "_blank", rel: "noreferrer", className: "txt-compact-xsmall-plus inline-flex items-center gap-x-0.5 text-ui-fg-interactive hover:text-ui-fg-interactive-hover", children: [
-              labels.review,
-              /* @__PURE__ */ jsxRuntime.jsx(icons.ArrowUpRightOnBox, { className: "h-3.5 w-3.5" })
-            ] }) : null
-          ] }) : null,
-          ((_a = r.review) == null ? void 0 : _a.quote) ? /* @__PURE__ */ jsxRuntime.jsxs(ui.Text, { size: "xsmall", className: "border-l-2 border-ui-border-strong pl-2 italic text-ui-fg-subtle", children: [
-            nb(r.review.quote),
-            r.review.author ? /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "not-italic text-ui-fg-muted", children: [
-              " ",
-              r.review.author
-            ] }) : null
-          ] }) : null,
-          r.description ? /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: "xsmall", className: "text-ui-fg-subtle", children: nb(r.description) }) : null,
-          ((_b = r.metrics) == null ? void 0 : _b.length) || r.since ? /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-wrap items-center gap-1.5", children: [
-            (r.metrics ?? []).map((m) => /* @__PURE__ */ jsxRuntime.jsxs(ui.Badge, { size: "2xsmall", color: "green", children: [
+            r.review ? /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-wrap items-center gap-x-2 gap-y-1", children: [
+              /* @__PURE__ */ jsxRuntime.jsx(Stars, { rating: r.review.rating, scale: r.review.scale }),
+              /* @__PURE__ */ jsxRuntime.jsx("span", { className: "txt-compact-xsmall-plus tabular-nums text-ui-fg-base", children: labels.rating(r.review.rating / (r.review.scale || 5) * 5) }),
+              /* @__PURE__ */ jsxRuntime.jsx(SourceMark, { review: r.review }),
+              r.review.url ? /* @__PURE__ */ jsxRuntime.jsxs("a", { href: r.review.url, target: "_blank", rel: "noreferrer", className: "txt-compact-xsmall-plus inline-flex items-center gap-x-0.5 text-ui-fg-interactive hover:text-ui-fg-interactive-hover", children: [
+                labels.review,
+                /* @__PURE__ */ jsxRuntime.jsx(icons.ArrowUpRightOnBox, { className: "h-3.5 w-3.5" })
+              ] }) : null
+            ] }) : null,
+            ((_a = r.review) == null ? void 0 : _a.quote) ? /* @__PURE__ */ jsxRuntime.jsxs(ui.Text, { size: "xsmall", className: "border-l-2 border-ui-border-strong pl-2 italic text-ui-fg-subtle", children: [
+              nb(r.review.quote),
+              r.review.author ? /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "not-italic text-ui-fg-muted", children: [
+                " ",
+                r.review.author
+              ] }) : null
+            ] }) : null,
+            r.description ? /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: "xsmall", className: "text-ui-fg-subtle", children: nb(r.description) }) : null,
+            ((_b = r.metrics) == null ? void 0 : _b.length) ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex flex-wrap items-center gap-1.5", children: (r.metrics ?? []).map((m) => /* @__PURE__ */ jsxRuntime.jsxs(ui.Badge, { size: "2xsmall", color: "green", children: [
               /* @__PURE__ */ jsxRuntime.jsx("span", { className: "tabular-nums", children: m.value }),
               " ",
               m.label
-            ] }, m.label)),
-            r.since ? /* @__PURE__ */ jsxRuntime.jsx(ui.Badge, { size: "2xsmall", color: "grey", children: labels.since(r.since) }) : null
-          ] }) : null,
-          (r.links ?? []).length ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex flex-wrap gap-x-3 gap-y-1", children: (r.links ?? []).map((l) => /* @__PURE__ */ jsxRuntime.jsxs("a", { href: l.url, target: "_blank", rel: "noreferrer", className: "txt-compact-xsmall-plus inline-flex items-center gap-x-0.5 text-ui-fg-interactive hover:text-ui-fg-interactive-hover", children: [
-            l.label,
-            /* @__PURE__ */ jsxRuntime.jsx(icons.ArrowUpRightOnBox, { className: "h-3.5 w-3.5" })
-          ] }, l.url)) }) : null
-        ] }, r.url);
-      }) })
+            ] }, m.label)) }) : null,
+            (r.links ?? []).length ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex flex-wrap gap-x-3 gap-y-1", children: (r.links ?? []).map((l) => /* @__PURE__ */ jsxRuntime.jsxs("a", { href: l.url, target: "_blank", rel: "noreferrer", className: "txt-compact-xsmall-plus inline-flex items-center gap-x-0.5 text-ui-fg-interactive hover:text-ui-fg-interactive-hover", children: [
+              l.label,
+              /* @__PURE__ */ jsxRuntime.jsx(icons.ArrowUpRightOnBox, { className: "h-3.5 w-3.5" })
+            ] }, l.url)) }) : null
+          ] }, r.url ?? r.name);
+        }),
+        soon.map((r) => /* @__PURE__ */ jsxRuntime.jsxs("li", { className: "flex flex-col gap-y-2 px-4 py-3", children: [
+          /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-x-3", children: [
+            /* @__PURE__ */ jsxRuntime.jsx(StoreIcon, { reference: r, size: 32 }),
+            /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "flex min-w-0 items-center gap-x-2", children: [
+              /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: "small", weight: "plus", className: "truncate text-ui-fg-base", children: r.name }),
+              /* @__PURE__ */ jsxRuntime.jsx(ui.Badge, { size: "2xsmall", color: "blue", className: "shrink-0", children: labels.soon })
+            ] })
+          ] }),
+          r.description ? /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: "xsmall", className: "text-ui-fg-subtle", children: nb(r.description) }) : null
+        ] }, r.url ?? r.name))
+      ] })
     ] })
   ] });
 }
-const KODA_DISCORD = "https://discord.gg/WzUUKYzu8";
+const KODA_DISCORD = "https://koda.plus/discord";
 const KODA_EMAIL = "hello@koda.plus";
 const KODA_DEMO = "https://medusa.koda.plus";
 const plain = (text) => text.split(NBSP).join(" ");
@@ -887,8 +897,13 @@ function envNames(code) {
   for (const m of code.matchAll(/^([A-Z][A-Z0-9_]*)=/gm)) names.add(m[1]);
   return [...names];
 }
+function pinnedPackage(spec) {
+  const version = spec.version ?? (spec.pkg === KIT_META.pkg ? KIT_META.version : null);
+  return version && /^\d+\.\d+\.\d+(-[0-9A-Za-z.-]+)?$/.test(version) ? `${spec.pkg}@${version}` : spec.pkg;
+}
 function buildSetupPrompt(spec, lang) {
   const code = (text) => "`" + text + "`";
+  const pinned = pinnedPackage(spec);
   const env = envNames(`${spec.config}
 ${spec.demo}`).map(code).join(", ");
   const needs = spec.needs.map((n) => `- ${plain(n)}`);
@@ -909,16 +924,16 @@ ${spec.demo}`).map(code).join(", ");
       "",
       "## Kroki",
       "1. Zanim cokolwiek zmienisz, sprawdź projekt: Medusa 2.12 albo nowsza (tego wymagają strony i tłumaczenia panelu we wtyczce), menedżer pakietów projektu i medusa-config.ts. Jeśli coś blokuje instalację, zatrzymaj się i napisz mi, co.",
-      `2. Zainstaluj wtyczkę menedżerem pakietów projektu, na przykład ${code(`npm install ${spec.pkg}`)}. Jeśli rejestr jej nie znajduje, zatrzymaj się i daj mi znać: dostęp daje Koda Plus (${KODA_EMAIL}, Discord ${KODA_DISCORD}).`,
+      `2. Zainstaluj wtyczkę w tej wersji menedżerem pakietów projektu, na przykład ${code(`npm install ${pinned}`)}. Potem sprawdź pochodzenie paczki: ${code(`npm view ${spec.pkg} dist-tags.latest`)} i ${code("npm audit signatures")}. Jeśli rejestr jej nie znajduje albo podpisy się nie zgadzają, zatrzymaj się i daj mi znać: pomaga Koda Plus (${KODA_EMAIL}, Discord ${KODA_DISCORD}).`,
       "3. Zarejestruj wtyczkę w medusa-config.ts, nie ruszając tego, co już tam jest. Użyj konfiguracji z Przewodnika wdrożenia:",
       "",
       ...config2,
       "",
-      `4. Dodaj do opcji przełącznik trybu demo, tak jak w sklepie demo: ${code(spec.demo)}. Dopóki kluczy nie ma w .env, moduł pracuje na przykładowych danych i nie łączy się z ${service}.`,
+      `4. Dodaj do opcji przełącznik trybu demo, tak jak w sklepie demo: ${code(spec.demo)}. Tryb demo działa tylko po jawnym włączeniu: wtedy moduł pracuje na przykładowych danych i nie łączy się z ${service}; bez niego i bez kluczy mówi „nieskonfigurowane” i nic nie robi.`,
       `5. Wpisz zmienne do .env i do środowiska hostingu, nigdy do kodu ani do gita: ${env}. Jeśli nie podałem Ci wartości, zostaw ją pustą i wypisz mi ją na końcu.`,
-      `6. Uruchom migracje bazy (${code("npx medusa db:migrate")}), potem sklep, i otwórz ${spec.route} w panelu admina. Sprawdź, czy Panel, Przewodnik wdrożenia i Ustawienia otwierają się bez błędów w konsoli przeglądarki i w logu serwera.`,
-      `7. Nie włączaj żadnego zapisu, czyli niczego, co zmienia dane w ${service} albo w sklepie. Każdy zapis uzbraja człowiek w Ustawieniach, po próbie na sucho; opcje tylko na to pozwalają.`,
-      `8. Dopisz sekcję o tej integracji do notatek projektu dla agentów AI (CLAUDE.md albo AGENTS.md, zależnie od tego, czego używa projekt; jeśli nie ma żadnego, załóż CLAUDE.md): pakiet i jego wersja, gdzie są jego opcje w medusa-config.ts, zmienne środowiskowe, przełącznik demo, to, że zapisy uzbraja człowiek w Ustawieniach, że wdrożenie krok po kroku jest w panelu w Przewodniku wdrożenia, że pomoc jest na Discordzie (${KODA_DISCORD}) i że wtyczka zmienia się aktualizacją pakietu, nigdy edycją node_modules.`,
+      spec.migrations === false ? `6. Uruchom sklep i otwórz ${spec.route} w panelu admina (ta wtyczka nie ma własnych tabel, migracje nie są potrzebne). Sprawdź, czy Panel, Przewodnik wdrożenia i Ustawienia otwierają się bez błędów w konsoli przeglądarki i w logu serwera.` : `6. Uruchom migracje bazy (${code("npx medusa db:migrate")}), potem sklep, i otwórz ${spec.route} w panelu admina. Sprawdź, czy Panel, Przewodnik wdrożenia i Ustawienia otwierają się bez błędów w konsoli przeglądarki i w logu serwera.`,
+      spec.readOnly ? `7. Ta integracja tylko czyta z ${service}: nie ma zapisów do uzbrajania. Użyj klucza tylko do odczytu, jeśli ${service} go oferuje.` : `7. Nie włączaj żadnego zapisu, czyli niczego, co zmienia dane w ${service} albo w sklepie. Każdy zapis uzbraja człowiek w Ustawieniach, po próbie na sucho; opcje tylko na to pozwalają.`,
+      `8. Zaproponuj sekcję o tej integracji do notatek projektu dla agentów AI (CLAUDE.md albo AGENTS.md, zależnie od tego, czego używa projekt; jeśli nie ma żadnego, zaproponuj CLAUDE.md) i pokaż mi jej treść, zanim ją zapiszesz: pakiet i jego wersja, gdzie są jego opcje w medusa-config.ts, zmienne środowiskowe, przełącznik demo, to, że zapisy uzbraja człowiek w Ustawieniach, że wdrożenie krok po kroku jest w panelu w Przewodniku wdrożenia, że pomoc jest na Discordzie (${KODA_DISCORD}) i że wtyczka zmienia się aktualizacją pakietu, nigdy edycją node_modules.`,
       "",
       "Na koniec napisz mi, co zmieniłeś i co zostało po mojej stronie: konta i klucze, pierwsze połączenie w Ustawieniach i uzbrojenie zapisów."
     ].join("\n");
@@ -936,16 +951,16 @@ ${spec.demo}`).map(code).join(", ");
     "",
     "## Steps",
     "1. Before you change anything, check the project: Medusa 2.12 or newer (the plugin's admin pages and translations need it), the project's package manager and medusa-config.ts. If something blocks the install, stop and tell me what.",
-    `2. Install the plugin with the project's package manager, for example ${code(`npm install ${spec.pkg}`)}. If the registry cannot find it, stop and tell me: Koda Plus gives access (${KODA_EMAIL}, Discord ${KODA_DISCORD}).`,
+    `2. Install this version of the plugin with the project's package manager, for example ${code(`npm install ${pinned}`)}. Then check where the package comes from: ${code(`npm view ${spec.pkg} dist-tags.latest`)} and ${code("npm audit signatures")}. If the registry cannot find it or the signatures do not verify, stop and tell me: Koda Plus helps (${KODA_EMAIL}, Discord ${KODA_DISCORD}).`,
     "3. Register the plugin in medusa-config.ts without touching what is already there. Use the setup from the Setup guide:",
     "",
     ...config2,
     "",
-    `4. Add the demo switch to the options, as the demo store has it: ${code(spec.demo)}. Until the keys are in .env, the module works on sample data and never calls ${service}.`,
+    `4. Add the demo switch to the options, as the demo store has it: ${code(spec.demo)}. Demo mode runs only when switched on: then the module works on sample data and never calls ${service}; without it and without keys it says "Not configured" and does nothing.`,
     `5. Put the variables in .env and in the hosting's environment, never in code or in git: ${env}. If I did not give you a value, leave it empty and list it for me at the end.`,
-    `6. Run the database migrations (${code("npx medusa db:migrate")}), then the store, and open ${spec.route} in the admin. Check that the Panel, the Setup guide and Settings open with no errors in the browser console or the server log.`,
-    `7. Do not turn on any writer, that is anything that changes data in ${service} or in the store. A person arms each writer in Settings, after a dry run; the options only allow it.`,
-    `8. Add a section about this integration to the project's notes for AI agents (CLAUDE.md or AGENTS.md, whichever the project uses; if neither exists, create CLAUDE.md): the package and its version, where its options sit in medusa-config.ts, the environment variables, the demo switch, that a person arms writers in Settings, that the step by step setup is in the admin under Setup guide, that help is on Discord (${KODA_DISCORD}), and that the plugin changes through package updates, never through edits in node_modules.`,
+    spec.migrations === false ? `6. Start the store and open ${spec.route} in the admin (this plugin has no tables of its own, no migrations needed). Check that the Panel, the Setup guide and Settings open with no errors in the browser console or the server log.` : `6. Run the database migrations (${code("npx medusa db:migrate")}), then the store, and open ${spec.route} in the admin. Check that the Panel, the Setup guide and Settings open with no errors in the browser console or the server log.`,
+    spec.readOnly ? `7. This integration only reads from ${service}: there are no writers to arm. Use a read-only key if ${service} offers one.` : `7. Do not turn on any writer, that is anything that changes data in ${service} or in the store. A person arms each writer in Settings, after a dry run; the options only allow it.`,
+    `8. Propose a section about this integration for the project's notes for AI agents (CLAUDE.md or AGENTS.md, whichever the project uses; if neither exists, propose CLAUDE.md) and show me its text before you save it: the package and its version, where its options sit in medusa-config.ts, the environment variables, the demo switch, that a person arms writers in Settings, that the step by step setup is in the admin under Setup guide, that help is on Discord (${KODA_DISCORD}), and that the plugin changes through package updates, never through edits in node_modules.`,
     "",
     "When you are done, tell me what you changed and what is left for me: accounts and keys, the first connection in Settings and arming the writers."
   ].join("\n");
@@ -962,7 +977,7 @@ function PromptButton({ spec, lang, labels }) {
     }
   };
   return /* @__PURE__ */ jsxRuntime.jsxs(ui.Popover, { children: [
-    /* @__PURE__ */ jsxRuntime.jsx(ui.Popover.Trigger, { asChild: true, children: /* @__PURE__ */ jsxRuntime.jsxs(ui.Button, { size: "small", variant: "secondary", onClick: () => void copy(), children: [
+    /* @__PURE__ */ jsxRuntime.jsx(ui.Popover.Trigger, { asChild: true, children: /* @__PURE__ */ jsxRuntime.jsxs(ui.Button, { size: "small", variant: "secondary", onClick: () => setState("idle"), children: [
       /* @__PURE__ */ jsxRuntime.jsx(icons.Sparkles, {}),
       labels.button
     ] }) }),
@@ -1046,54 +1061,67 @@ function SettingsView({
     children
   ] });
 }
-function References({ items, title, subtitle, openLabel, sinceLabel, reviewLabel, ratingLabel }) {
-  if (items.length === 0) return null;
+function CardIcon({ reference }) {
+  return reference.icon ? /* @__PURE__ */ jsxRuntime.jsx("img", { src: reference.icon, alt: "", width: 36, height: 36, className: "h-9 w-9 shrink-0 rounded-md bg-white object-contain shadow-borders-base" }) : /* @__PURE__ */ jsxRuntime.jsx("span", { className: "txt-compact-medium-plus flex h-9 w-9 shrink-0 items-center justify-center rounded-md bg-ui-bg-base text-ui-fg-base shadow-borders-base", children: reference.name.slice(0, 1).toUpperCase() });
+}
+function References({ items, title, subtitle, openLabel, soonLabel, reviewLabel, ratingLabel }) {
+  const { live, soon } = splitReferences(items);
+  if (live.length + soon.length === 0) return null;
   return /* @__PURE__ */ jsxRuntime.jsxs(ui.Container, { className: "divide-y p-0", children: [
     /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-col gap-y-1 px-6 py-4", children: [
       /* @__PURE__ */ jsxRuntime.jsx(ui.Heading, { level: "h2", children: title }),
       /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: "small", className: "text-ui-fg-subtle", children: subtitle })
     ] }),
-    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "grid grid-cols-1 gap-3 px-6 py-4 md:grid-cols-2 xl:grid-cols-3", children: items.map((r) => {
-      var _a;
-      return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-col gap-y-3 rounded-lg border border-ui-border-base bg-ui-bg-component px-4 py-3", children: [
-        /* @__PURE__ */ jsxRuntime.jsxs("a", { href: r.url, target: "_blank", rel: "noreferrer", className: "group flex items-center gap-x-3", children: [
-          r.icon ? /* @__PURE__ */ jsxRuntime.jsx("img", { src: r.icon, alt: "", width: 36, height: 36, className: "h-9 w-9 shrink-0 rounded-md bg-white object-contain shadow-borders-base" }) : /* @__PURE__ */ jsxRuntime.jsx("span", { className: "txt-compact-medium-plus flex h-9 w-9 shrink-0 items-center justify-center rounded-md bg-ui-bg-base text-ui-fg-base shadow-borders-base", children: r.name.slice(0, 1).toUpperCase() }),
-          /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "flex min-w-0 flex-col", children: [
-            /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: "small", weight: "plus", className: "truncate text-ui-fg-base", children: r.name }),
-            /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: "xsmall", className: "truncate text-ui-fg-interactive group-hover:text-ui-fg-interactive-hover", children: host(r.url) })
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "grid grid-cols-1 gap-3 px-6 py-4 md:grid-cols-2 xl:grid-cols-3", children: [
+      live.map((r) => {
+        var _a;
+        return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-col gap-y-3 rounded-lg border border-ui-border-base bg-ui-bg-component px-4 py-3", children: [
+          /* @__PURE__ */ jsxRuntime.jsxs("a", { href: r.url, target: "_blank", rel: "noreferrer", className: "group flex items-center gap-x-3", children: [
+            /* @__PURE__ */ jsxRuntime.jsx(CardIcon, { reference: r }),
+            /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "flex min-w-0 flex-col", children: [
+              /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: "small", weight: "plus", className: "truncate text-ui-fg-base", children: r.name }),
+              /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: "xsmall", className: "truncate text-ui-fg-interactive group-hover:text-ui-fg-interactive-hover", children: host(r.url) })
+            ] }),
+            /* @__PURE__ */ jsxRuntime.jsx(icons.ArrowUpRightOnBox, { className: "ml-auto shrink-0 text-ui-fg-muted group-hover:text-ui-fg-interactive" })
           ] }),
-          /* @__PURE__ */ jsxRuntime.jsx(icons.ArrowUpRightOnBox, { className: "ml-auto shrink-0 text-ui-fg-muted group-hover:text-ui-fg-interactive" })
-        ] }),
-        r.review ? /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-wrap items-center gap-x-2 gap-y-1", children: [
-          /* @__PURE__ */ jsxRuntime.jsx(Stars, { rating: r.review.rating, scale: r.review.scale }),
-          /* @__PURE__ */ jsxRuntime.jsx("span", { className: "txt-compact-xsmall-plus tabular-nums text-ui-fg-base", children: (ratingLabel ?? ((v) => v.toFixed(1)))(r.review.rating / (r.review.scale || 5) * 5) }),
-          /* @__PURE__ */ jsxRuntime.jsx(SourceMark, { review: r.review }),
-          r.review.url && reviewLabel ? /* @__PURE__ */ jsxRuntime.jsxs("a", { href: r.review.url, target: "_blank", rel: "noreferrer", className: "txt-compact-xsmall-plus inline-flex items-center gap-x-0.5 text-ui-fg-interactive hover:text-ui-fg-interactive-hover", children: [
-            reviewLabel,
-            /* @__PURE__ */ jsxRuntime.jsx(icons.ArrowUpRightOnBox, { className: "h-3.5 w-3.5" })
-          ] }) : null
-        ] }) : null,
-        r.description ? /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: "small", className: "text-ui-fg-subtle", children: nb(r.description) }) : null,
-        ((_a = r.metrics) == null ? void 0 : _a.length) || r.since ? /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [
-          (r.metrics ?? []).map((m) => /* @__PURE__ */ jsxRuntime.jsxs(ui.Badge, { size: "2xsmall", color: "green", children: [
+          r.review ? /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-wrap items-center gap-x-2 gap-y-1", children: [
+            /* @__PURE__ */ jsxRuntime.jsx(Stars, { rating: r.review.rating, scale: r.review.scale }),
+            /* @__PURE__ */ jsxRuntime.jsx("span", { className: "txt-compact-xsmall-plus tabular-nums text-ui-fg-base", children: (ratingLabel ?? ((v) => v.toFixed(1)))(r.review.rating / (r.review.scale || 5) * 5) }),
+            /* @__PURE__ */ jsxRuntime.jsx(SourceMark, { review: r.review }),
+            r.review.url && reviewLabel ? /* @__PURE__ */ jsxRuntime.jsxs("a", { href: r.review.url, target: "_blank", rel: "noreferrer", className: "txt-compact-xsmall-plus inline-flex items-center gap-x-0.5 text-ui-fg-interactive hover:text-ui-fg-interactive-hover", children: [
+              reviewLabel,
+              /* @__PURE__ */ jsxRuntime.jsx(icons.ArrowUpRightOnBox, { className: "h-3.5 w-3.5" })
+            ] }) : null
+          ] }) : null,
+          r.description ? /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: "small", className: "text-ui-fg-subtle", children: nb(r.description) }) : null,
+          ((_a = r.metrics) == null ? void 0 : _a.length) ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex flex-wrap items-center gap-2", children: (r.metrics ?? []).map((m) => /* @__PURE__ */ jsxRuntime.jsxs(ui.Badge, { size: "2xsmall", color: "green", children: [
             /* @__PURE__ */ jsxRuntime.jsx("span", { className: "tabular-nums", children: m.value }),
             " ",
             m.label
-          ] }, m.label)),
-          r.since ? /* @__PURE__ */ jsxRuntime.jsx(ui.Badge, { size: "2xsmall", color: "grey", children: sinceLabel(r.since) }) : null
-        ] }) : null,
-        /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "mt-auto flex flex-col gap-y-1 border-t border-ui-border-base pt-2", children: [
-          (r.links ?? []).map((l) => /* @__PURE__ */ jsxRuntime.jsxs("a", { href: l.url, target: "_blank", rel: "noreferrer", className: "txt-compact-small inline-flex w-fit items-center gap-x-1 text-ui-fg-interactive hover:text-ui-fg-interactive-hover", children: [
-            l.label,
-            /* @__PURE__ */ jsxRuntime.jsx(icons.ArrowUpRightOnBox, { className: "shrink-0" })
-          ] }, l.url)),
-          /* @__PURE__ */ jsxRuntime.jsxs("a", { href: r.url, target: "_blank", rel: "noreferrer", className: "txt-compact-small-plus inline-flex w-fit items-center gap-x-1 text-ui-fg-interactive hover:text-ui-fg-interactive-hover", children: [
-            openLabel,
-            /* @__PURE__ */ jsxRuntime.jsx(icons.ArrowUpRightOnBox, { className: "shrink-0" })
+          ] }, m.label)) }) : null,
+          /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "mt-auto flex flex-col gap-y-1 border-t border-ui-border-base pt-2", children: [
+            (r.links ?? []).map((l) => /* @__PURE__ */ jsxRuntime.jsxs("a", { href: l.url, target: "_blank", rel: "noreferrer", className: "txt-compact-small inline-flex w-fit items-center gap-x-1 text-ui-fg-interactive hover:text-ui-fg-interactive-hover", children: [
+              l.label,
+              /* @__PURE__ */ jsxRuntime.jsx(icons.ArrowUpRightOnBox, { className: "shrink-0" })
+            ] }, l.url)),
+            /* @__PURE__ */ jsxRuntime.jsxs("a", { href: r.url, target: "_blank", rel: "noreferrer", className: "txt-compact-small-plus inline-flex w-fit items-center gap-x-1 text-ui-fg-interactive hover:text-ui-fg-interactive-hover", children: [
+              openLabel,
+              /* @__PURE__ */ jsxRuntime.jsx(icons.ArrowUpRightOnBox, { className: "shrink-0" })
+            ] })
           ] })
-        ] })
-      ] }, r.url);
-    }) })
+        ] }, r.url ?? r.name);
+      }),
+      soon.map((r) => /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-col gap-y-3 rounded-lg border border-ui-border-base bg-ui-bg-component px-4 py-3", children: [
+        /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-x-3", children: [
+          /* @__PURE__ */ jsxRuntime.jsx(CardIcon, { reference: r }),
+          /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "flex min-w-0 items-center gap-x-2", children: [
+            /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: "small", weight: "plus", className: "truncate text-ui-fg-base", children: r.name }),
+            /* @__PURE__ */ jsxRuntime.jsx(ui.Badge, { size: "2xsmall", color: "blue", className: "shrink-0", children: soonLabel })
+          ] })
+        ] }),
+        r.description ? /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: "small", className: "text-ui-fg-subtle", children: nb(r.description) }) : null
+      ] }, r.url ?? r.name))
+    ] })
   ] });
 }
 function GuideIntro({ title, text, time, needs, needsLabel, timeLabel }) {
@@ -1376,7 +1404,7 @@ function usePromptSpec() {
       needs: Array.isArray(needs) ? needs : [],
       config: `// medusa-config.ts, in plugins: [ ... ]
 ${MEDUSA_CODE}`,
-      demo: 'demo: process.env.SUBIEKT_DEMO === "true" || !process.env.SUBIEKT_BRIDGE_URL,'
+      demo: 'demo: process.env.SUBIEKT_DEMO === "true",'
     };
   }, [t]);
 }
@@ -1473,7 +1501,7 @@ function GuideView({ status, lang }) {
         title: t("references.title"),
         subtitle: t("references.subtitle"),
         openLabel: t("references.open"),
-        sinceLabel: (since) => t("references.since", { date: monthYear(since, lang) }),
+        soonLabel: t("references.soon"),
         reviewLabel: t("references.review"),
         ratingLabel: (value) => fmtRating(value, lang)
       }
@@ -1930,12 +1958,13 @@ function Header({
           {
             items: references,
             labels: {
-              count: references.length === 1 ? t("references.badgeOne") : t("references.badgeMany", { count: references.length }),
+              count: (live, soon) => live > 0 ? live === 1 ? t("references.badgeOne") : t("references.badgeMany", { count: live }) : soon === 1 ? t("references.badgeSoonOne") : t("references.badgeSoonMany", { count: soon }),
+              soonMore: (soon) => t("references.soonMore", { count: soon }),
+              soon: t("references.soon"),
               title: t("references.title"),
               subtitle: t("references.subtitle"),
               open: t("references.open"),
               review: t("references.review"),
-              since: (since) => t("references.since", { date: monthYear(since, lang) }),
               rating: (value) => fmtRating(value, lang)
             }
           }
@@ -2229,6 +2258,62 @@ const config = adminSdk.defineRouteConfig({
   label: "Subiekt nexo",
   icon: SubiektIcon
 });
+const communityEn = {
+  addStore: {
+    button: "Add your store",
+    title: "Does your store run on this integration?",
+    text: "Tell us about it. Once we check it, the store joins this list with a link and its rating.",
+    name: "Store name",
+    url: "Store address",
+    note: "A few words about the setup (optional)",
+    send: "Send the request",
+    copy: "Copy the text",
+    copied: "Request copied, paste it into a mail to hello@koda.plus",
+    hint: "Your mail app opens with the message to {{email}} ready to send.",
+    subject: "A store for {{integration}}",
+    greeting: "Hello, my store runs on {{integration}}. Please add it to the list of stores."
+  },
+  prompt: {
+    button: "Copy prompt",
+    title: "Add this integration to your store",
+    text: "Paste it into Claude Code, Cursor or another AI agent opened in your Medusa project. The agent installs this version of the plugin, sets it up like here and shows you its notes before it saves them.",
+    copy: "Copy",
+    copied: "Prompt copied",
+    failed: "Could not copy. Select the text and copy it by hand."
+  },
+  discord: {
+    button: "Help on Discord",
+    title: "Join the Koda Plus server on Discord"
+  }
+};
+const communityPl = {
+  addStore: {
+    button: "Dodaj swój sklep",
+    title: "Twój sklep działa na tej integracji?",
+    text: "Daj nam znać. Po sprawdzeniu dodamy go do tej listy z linkiem i oceną.",
+    name: "Nazwa sklepu",
+    url: "Adres sklepu",
+    note: "Kilka słów o wdrożeniu (opcjonalnie)",
+    send: "Wyślij zgłoszenie",
+    copy: "Kopiuj treść",
+    copied: "Treść skopiowana, wklej ją w mail do hello@koda.plus",
+    hint: "Otworzy się Twoja poczta z gotową wiadomością do {{email}}.",
+    subject: "Zgłoszenie sklepu: {{integration}}",
+    greeting: "Dzień dobry, mój sklep działa na integracji {{integration}}. Proszę o dodanie go do listy sklepów."
+  },
+  prompt: {
+    button: "Kopiuj prompt",
+    title: "Dodaj tę integrację do swojego sklepu",
+    text: "Wklej go w Claude Code, Cursorze albo innym agencie AI otwartym w projekcie Twojej Medusy. Agent zainstaluje tę wersję wtyczki, ustawi ją tak jak tutaj i pokaże Ci notatki, zanim je zapisze.",
+    copy: "Kopiuj",
+    copied: "Prompt skopiowany",
+    failed: "Nie udało się skopiować. Zaznacz tekst i skopiuj go ręcznie."
+  },
+  discord: {
+    button: "Pomoc na Discordzie",
+    title: "Dołącz do serwera Koda Plus na Discordzie"
+  }
+};
 const en = {
   title: "Subiekt nexo",
   by: "by Koda Plus",
@@ -2595,39 +2680,15 @@ const en = {
     title: "Running in stores built by Koda Plus",
     subtitle: "Live stores implemented by Koda Plus that run on this integration every day.",
     open: "Open the store",
-    since: "Since {{date}}",
     badgeOne: "Running in 1 store",
     badgeMany: "Running in {{count}} stores",
+    badgeSoonOne: "Coming to 1 store",
+    badgeSoonMany: "Coming to {{count}} stores",
+    soon: "Soon",
+    soonMore: "+{{count}} soon",
     review: "Read the review"
   },
-  community: {
-    addStore: {
-      button: "Add your store",
-      title: "Does your store run on this integration?",
-      text: "Tell us about it. Once we check it, the store joins this list with a link and its rating.",
-      name: "Store name",
-      url: "Store address",
-      note: "A few words about the setup (optional)",
-      send: "Send the request",
-      copy: "Copy the text",
-      copied: "Request copied, paste it into a mail to hello@koda.plus",
-      hint: "Your mail app opens with the message to {{email}} ready to send.",
-      subject: "A store for {{integration}}",
-      greeting: "Hello, my store runs on {{integration}}. Please add it to the list of stores."
-    },
-    prompt: {
-      button: "Copy prompt",
-      title: "Add this integration to your store",
-      text: "Paste it into Claude Code, Cursor or another AI agent opened in your Medusa project. The agent installs the plugin, sets it up like here and leaves notes for further work.",
-      copy: "Copy again",
-      copied: "Prompt copied",
-      failed: "Could not copy. Select the text and copy it by hand."
-    },
-    discord: {
-      button: "Help on Discord",
-      title: "Join the Koda Plus server on Discord"
-    }
-  },
+  community: communityEn,
   guide: {
     intro: {
       title: "Connect Medusa to Subiekt nexo PRO",
@@ -3251,39 +3312,15 @@ const pl$1 = {
     title: "Działa w sklepach wdrożonych przez Koda Plus",
     subtitle: "Prawdziwe sklepy z wdrożeniem Koda Plus, które pracują na tej integracji na co dzień.",
     open: "Otwórz sklep",
-    since: "Od {{date}}",
     badgeOne: "Działa w 1 sklepie",
     badgeMany: "Działa w {{count}} sklepach",
+    badgeSoonOne: "Wkrótce w 1 sklepie",
+    badgeSoonMany: "Wkrótce w {{count}} sklepach",
+    soon: "Wkrótce",
+    soonMore: "+{{count}} wkrótce",
     review: "Zobacz opinię"
   },
-  community: {
-    addStore: {
-      button: "Dodaj swój sklep",
-      title: "Twój sklep działa na tej integracji?",
-      text: "Daj nam znać. Po sprawdzeniu dodamy go do tej listy z linkiem i oceną.",
-      name: "Nazwa sklepu",
-      url: "Adres sklepu",
-      note: "Kilka słów o wdrożeniu (opcjonalnie)",
-      send: "Wyślij zgłoszenie",
-      copy: "Kopiuj treść",
-      copied: "Treść skopiowana, wklej ją w mail do hello@koda.plus",
-      hint: "Otworzy się Twoja poczta z gotową wiadomością do {{email}}.",
-      subject: "Zgłoszenie sklepu: {{integration}}",
-      greeting: "Dzień dobry, mój sklep działa na integracji {{integration}}. Proszę o dodanie go do listy sklepów."
-    },
-    prompt: {
-      button: "Kopiuj prompt",
-      title: "Dodaj tę integrację do swojego sklepu",
-      text: "Wklej go w Claude Code, Cursorze albo innym agencie AI otwartym w projekcie Twojej Medusy. Agent zainstaluje wtyczkę, ustawi ją tak jak tutaj i zostawi notatki do dalszej pracy.",
-      copy: "Kopiuj jeszcze raz",
-      copied: "Prompt skopiowany",
-      failed: "Nie udało się skopiować. Zaznacz tekst i skopiuj go ręcznie."
-    },
-    discord: {
-      button: "Pomoc na Discordzie",
-      title: "Dołącz do serwera Koda Plus na Discordzie"
-    }
-  },
+  community: communityPl,
   guide: {
     intro: {
       title: "Połącz Medusę z Subiektem nexo PRO",