diff --git a/package-lock.json b/package-lock.json
index 9fec3b93..c28a8e1f 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -11119,6 +11119,10 @@
"resolved": "widgets/storefinder",
"link": true
},
+ "node_modules/widget-subscription": {
+ "resolved": "widgets/subscription",
+ "link": true
+ },
"node_modules/widget-usp": {
"resolved": "widgets/usp",
"link": true
@@ -12396,6 +12400,72 @@
"dev": true,
"license": "MIT"
},
+ "widgets/subscription": {
+ "name": "widget-subscription",
+ "version": "0.0.1",
+ "dependencies": {
+ "zod": "^4.4.3"
+ },
+ "devDependencies": {
+ "@eslint/js": "^9.39.1",
+ "@types/node": "^24.10.1",
+ "@types/react": "^19.2.5",
+ "@types/react-dom": "^19.2.3",
+ "@vitejs/plugin-react-swc": "^4.2.2",
+ "eslint": "^9.39.1",
+ "eslint-plugin-react-hooks": "^7.0.1",
+ "eslint-plugin-react-refresh": "^0.4.24",
+ "globals": "^16.5.0",
+ "postcss": "^8.5.6",
+ "postcss-prefix-selector": "^2.1.1",
+ "rollup-plugin-visualizer": "^7.0.1",
+ "tsx": "^4.21.0",
+ "typescript": "~5.9.3",
+ "typescript-eslint": "^8.46.4",
+ "vite": "^8.3.0"
+ },
+ "peerDependencies": {
+ "react": "^19.2.0",
+ "react-dom": "^19.2.0"
+ }
+ },
+ "widgets/subscription/node_modules/@types/node": {
+ "version": "24.19.2",
+ "resolved": "https://registry.npmjs.org/@types/node/-/node-24.19.2.tgz",
+ "integrity": "sha512-93d49wCWJkCyN87MxLpNN6KXPCwFw7bVUg79mGUV1OS40JGWwVCr8n61DXCSqz7CV6/VfPkb7xec7uP2M+QHWQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "undici-types": ">=7.24.0 <7.24.7"
+ }
+ },
+ "widgets/subscription/node_modules/globals": {
+ "version": "16.5.0",
+ "resolved": "https://registry.npmjs.org/globals/-/globals-16.5.0.tgz",
+ "integrity": "sha512-c/c15i26VrJ4IRt5Z89DnIzCGDn9EcebibhAOjw5ibqEHsE1wLUgkPn9RDmNcUKyU87GeaL633nyJ+pplFR2ZQ==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=18"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "widgets/subscription/node_modules/typescript": {
+ "version": "5.9.3",
+ "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
+ "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
+ "dev": true,
+ "license": "Apache-2.0",
+ "bin": {
+ "tsc": "bin/tsc",
+ "tsserver": "bin/tsserver"
+ },
+ "engines": {
+ "node": ">=14.17"
+ }
+ },
"widgets/test": {
"name": "widget-test",
"version": "0.0.1",
diff --git a/widgets/subscription/api/index.ts b/widgets/subscription/api/index.ts
new file mode 100644
index 00000000..76da1c21
--- /dev/null
+++ b/widgets/subscription/api/index.ts
@@ -0,0 +1 @@
+export { Widget } from "../src/Widget";
diff --git a/widgets/subscription/api/runtime-shadow-widget.tsx b/widgets/subscription/api/runtime-shadow-widget.tsx
new file mode 100644
index 00000000..e6c221fa
--- /dev/null
+++ b/widgets/subscription/api/runtime-shadow-widget.tsx
@@ -0,0 +1,37 @@
+import { WIDGET_ID } from "../src/Config.ts";
+
+import type { WidgetApi } from "@reactedge/public-api/widget";
+import type {ReactEdgeRuntimeConfig} from "@reactedge/public-api/runtime.ts";
+
+import {ShadowHostProvider} from "@reactedge/framework/host.ts";
+import {createRoot} from "react-dom/client";
+import {WidgetRoot} from "../src/bootstrap/widget-root.tsx"
+import {styles} from "../src/styles/entry.ts";
+
+const mount = (
+ el: HTMLElement,
+ contract: unknown,
+ bootstrap: unknown,
+ runtime: ReactEdgeRuntimeConfig
+) => {
+ const hostProvider = new ShadowHostProvider(styles)
+
+ createRoot(hostProvider.getMountedHost(el)).render(
+
+ )
+};
+
+const api: WidgetApi = {
+ mount,
+};
+
+if (typeof window !== "undefined") {
+ window[`ReactEdge_${WIDGET_ID}`] = api;
+}
+
+export { mount };
\ No newline at end of file
diff --git a/widgets/subscription/capability.json b/widgets/subscription/capability.json
new file mode 100644
index 00000000..bae002ca
--- /dev/null
+++ b/widgets/subscription/capability.json
@@ -0,0 +1,15 @@
+{
+ "id": "subscription",
+ "widget": "subscription",
+ "description": "",
+ "signals": {
+ "consumes": [],
+ "emits": []
+ },
+ "runtime": {
+ "rendering": [
+ "client",
+ "ssr"
+ ]
+ }
+}
\ No newline at end of file
diff --git a/widgets/subscription/index.html b/widgets/subscription/index.html
new file mode 100644
index 00000000..cd7f5527
--- /dev/null
+++ b/widgets/subscription/index.html
@@ -0,0 +1,31 @@
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/widgets/subscription/package.json b/widgets/subscription/package.json
new file mode 100644
index 00000000..e7bbfedc
--- /dev/null
+++ b/widgets/subscription/package.json
@@ -0,0 +1,39 @@
+{
+ "name": "widget-subscription",
+ "private": true,
+ "version": "0.0.1",
+ "type": "module",
+ "scripts": {
+ "dev": "vite",
+ "build": "tsc -b && vite build",
+ "build:ssr": "vite build -c vite.npm.config.ts",
+ "analyze": "ANALYZE=true vite build",
+ "lint": "eslint .",
+ "preview": "vite preview"
+ },
+ "dependencies": {
+ "zod": "^4.4.3"
+ },
+ "devDependencies": {
+ "@eslint/js": "^9.39.1",
+ "@types/node": "^24.10.1",
+ "@types/react": "^19.2.5",
+ "@types/react-dom": "^19.2.3",
+ "@vitejs/plugin-react-swc": "^4.2.2",
+ "eslint": "^9.39.1",
+ "eslint-plugin-react-hooks": "^7.0.1",
+ "eslint-plugin-react-refresh": "^0.4.24",
+ "globals": "^16.5.0",
+ "postcss": "^8.5.6",
+ "postcss-prefix-selector": "^2.1.1",
+ "rollup-plugin-visualizer": "^7.0.1",
+ "tsx": "^4.21.0",
+ "typescript": "~5.9.3",
+ "typescript-eslint": "^8.46.4",
+ "vite": "^8.3.0"
+ },
+ "peerDependencies": {
+ "react": "^19.2.0",
+ "react-dom": "^19.2.0"
+ }
+}
\ No newline at end of file
diff --git a/widgets/subscription/public/default.json b/widgets/subscription/public/default.json
new file mode 100644
index 00000000..c5351f51
--- /dev/null
+++ b/widgets/subscription/public/default.json
@@ -0,0 +1,27 @@
+{
+ "data": {
+ "title": "Subscribe & Save",
+ "isCustomerLoggedIn": true,
+ "plans": [
+ {
+ "id": "monthly",
+ "label": "Monthly delivery",
+ "frequency": "Every month",
+ "discount": "Save 10%",
+ "termsBlockId": "subscription-monthly-terms"
+ },
+ {
+ "id": "quarterly",
+ "label": "Quarterly delivery",
+ "frequency": "Every 3 months",
+ "discount": "Save 15%"
+ }
+ ]
+ },
+ "settings": {
+ "colour": "#222222"
+ },
+ "integration": {
+ "requires": ["magentoGraphql"]
+ }
+}
diff --git a/widgets/subscription/src/Config.ts b/widgets/subscription/src/Config.ts
new file mode 100644
index 00000000..3433e6d3
--- /dev/null
+++ b/widgets/subscription/src/Config.ts
@@ -0,0 +1,125 @@
+import {parseConfig, type SchemaWidgetConfig} from "./ConfigSchema.ts";
+import type {WidgetActivity} from "@reactedge/framework/activity";
+import {parseRuntimeConfig, type SchemaRuntimeConfig} from "./ConfigSchemaRuntime.ts";
+
+export interface WidgetConfig {
+ readonly data: {
+ title: string;
+ plans: SubscriptionPlan[];
+ isCustomerLoggedIn: boolean;
+ loginUrl?: string | undefined;
+ }
+
+ readonly settings: {
+ colour: string;
+ };
+
+ readonly runtime: RuntimeConfig
+ readonly integrations: ResolvedConfigIntegrations
+}
+
+export interface ProductData {
+ id: string;
+ sku: string
+ name: string
+}
+
+export interface SubscriptionPlan {
+ id: string;
+ label: string;
+ frequency: string;
+ discount?: string | undefined;
+ termsBlockId?: string | undefined;
+}
+
+export interface RuntimeConfig {
+ storeCode: string;
+ sku: string;
+ termsUrl: string;
+}
+
+export interface ReactEdgeRuntimeConfig {
+ readonly integrations: ReactEdgeRuntimeIntegrations;
+ readonly context: Omit & { termsUrl?: string }
+}
+
+export interface ReactEdgeRuntimeIntegrations {
+ readonly magentoGraphql: {
+ readonly api: string
+ };
+}
+
+export interface ResolvedConfigIntegrations {
+ readonly magentoGraphql: {
+ readonly api: string
+ };
+}
+
+export const WIDGET_ID = 'subscription';
+
+/**
+ * Validates and resolves the Contact Us widget configuration.
+ *
+ * Both the widget contract and the runtime configuration are treated
+ * as untrusted input. Once validated, the configuration is normalized,
+ * resolved and frozen before being exposed to the React application.
+ *
+ * This function represents the trust boundary between the ReactEdge
+ * runtime and the widget implementation.
+ *
+ * The resolved configuration includes the Cloudflare integration
+ * required to render the captcha.
+ *
+ * @param contract - Widget contract supplied by the host platform.
+ * @param runtime - Runtime services supplied by the orchestrator.
+ * @param activity - Activity logger for bootstrap events.
+ * @returns An immutable Contact Us configuration.
+ * @throws When either configuration is invalid.
+ */
+export function readWidgetConfig(
+ contract: unknown,
+ runtime: unknown,
+ activity?: WidgetActivity
+): WidgetConfig {
+ try {
+ const parsedContract = parseConfig(contract);
+ const parsedRuntime = parseRuntimeConfig(runtime)
+ const resolved = resolveConfig(parsedContract, parsedRuntime);
+
+ activity?.log(
+ 'bootstrap',
+ 'Config resolved',
+ resolved
+ );
+
+ return Object.freeze(resolved);
+
+ } catch (e) {
+ activity?.log(
+ 'bootstrap',
+ 'Invalid widget contract',
+ e instanceof Error? e.message: e,
+ 'error'
+ );
+
+ throw e;
+ }
+}
+
+export function resolveConfig(
+ widget: SchemaWidgetConfig,
+ runtime: SchemaRuntimeConfig
+): WidgetConfig {
+ return {
+ data: widget.data,
+ settings: widget.settings,
+ runtime: {
+ storeCode: runtime.context.storeCode,
+ sku: runtime.context.sku,
+ termsUrl: runtime.context.termsUrl ?? '/subscribe/plan/terms'
+ },
+ integrations: {
+ magentoGraphql: runtime.integrations?.magentoGraphql
+ }
+ };
+}
diff --git a/widgets/subscription/src/ConfigSchema.ts b/widgets/subscription/src/ConfigSchema.ts
new file mode 100644
index 00000000..0c77706e
--- /dev/null
+++ b/widgets/subscription/src/ConfigSchema.ts
@@ -0,0 +1,39 @@
+import { z } from 'zod';
+
+const IntegrationSchema = z.enum([
+ "magentoGraphql"
+]);
+
+const WidgetDataSchema = z.object({
+ title: z.string(),
+ plans: z.array(z.object({
+ id: z.string(),
+ label: z.string(),
+ frequency: z.string(),
+ discount: z.string().optional(),
+ termsBlockId: z.string().optional(),
+ })),
+ isCustomerLoggedIn: z.boolean(),
+ loginUrl: z.string().url().optional(),
+});
+
+const WidgetSettingsSchema = z.object({
+ colour: z.string(),
+});
+
+export const WidgetConfigSchema = z.object({
+ data: WidgetDataSchema,
+ settings: WidgetSettingsSchema,
+ integration: z.object({
+ requires: z.array(IntegrationSchema)
+ }).optional()
+}).strict();
+
+export type SchemaWidgetConfig =
+ z.infer;
+
+export function parseConfig(
+ input: unknown
+): SchemaWidgetConfig {
+ return WidgetConfigSchema.parse(input);
+}
diff --git a/widgets/subscription/src/ConfigSchemaRuntime.ts b/widgets/subscription/src/ConfigSchemaRuntime.ts
new file mode 100644
index 00000000..c0bb8a18
--- /dev/null
+++ b/widgets/subscription/src/ConfigSchemaRuntime.ts
@@ -0,0 +1,27 @@
+import { z } from 'zod';
+
+export const SchemaRuntimeConfig = z.object({
+ integrations: z.object({
+ magentoGraphql: z.object({
+ api: z.string().url(),
+ }),
+ googleMaps: z.object({
+ apiKey: z.string(),
+ placeId: z.string()
+ }).optional()
+ }),
+ context: z.object({
+ storeCode: z.string(),
+ sku: z.string(),
+ termsUrl: z.string().optional(),
+ })
+});
+
+export type SchemaRuntimeConfig =
+ z.infer;
+
+export function parseRuntimeConfig(
+ input: unknown
+): SchemaRuntimeConfig {
+ return SchemaRuntimeConfig.parse(input);
+}
diff --git a/widgets/subscription/src/Widget.tsx b/widgets/subscription/src/Widget.tsx
new file mode 100644
index 00000000..abd70ca0
--- /dev/null
+++ b/widgets/subscription/src/Widget.tsx
@@ -0,0 +1,21 @@
+import {WidgetRoot} from "./bootstrap/widget-root.tsx";
+import {createRoot} from "react-dom/client";
+import type {RuntimeWidgetOptions} from "@reactedge/public-api/WidgetOptions.ts";
+import {ShadowHostProvider} from "@reactedge/framework/host.ts";
+import { styles } from "./styles/entry.ts";
+
+export function Widget({
+ container,
+ contract,
+ runtime
+}: RuntimeWidgetOptions) {
+ const hostProvider = new ShadowHostProvider(styles);
+ const host = hostProvider.getMountedHost(container);
+
+ createRoot(host).render(
+
+ );
+}
\ No newline at end of file
diff --git a/widgets/subscription/src/WidgetView.tsx b/widgets/subscription/src/WidgetView.tsx
new file mode 100644
index 00000000..ca7c0dfc
--- /dev/null
+++ b/widgets/subscription/src/WidgetView.tsx
@@ -0,0 +1,20 @@
+import type {BootstrapData} from "./entrypoints/ssr.tsx";
+import {readWidgetConfig} from "./Config.ts";
+import {SystemStateProvider} from "./state/System/SystemStateProvider.tsx";
+import {WidgetSubscription} from "./components/WidgetSubscription.tsx";
+
+type Props = {
+ contract: unknown;
+ runtime: unknown;
+ bootstrapData: BootstrapData;
+};
+export const WidgetView = ({ contract, runtime, bootstrapData }: Props) => {
+
+ const config = readWidgetConfig(contract, runtime);
+
+ if (!config) return null;
+
+ return
+
+
+};
diff --git a/widgets/subscription/src/activity/Context/ActivityContext.tsx b/widgets/subscription/src/activity/Context/ActivityContext.tsx
new file mode 100644
index 00000000..81be6cc3
--- /dev/null
+++ b/widgets/subscription/src/activity/Context/ActivityContext.tsx
@@ -0,0 +1,4 @@
+import {createContext} from "react";
+import type {WidgetActivity} from "@reactedge/framework/activity";
+
+export const LocalInstanceStateContext = createContext(undefined);
\ No newline at end of file
diff --git a/widgets/subscription/src/activity/Context/ActivityContextProvider.tsx b/widgets/subscription/src/activity/Context/ActivityContextProvider.tsx
new file mode 100644
index 00000000..e1afaf74
--- /dev/null
+++ b/widgets/subscription/src/activity/Context/ActivityContextProvider.tsx
@@ -0,0 +1,31 @@
+import {type ReactNode} from "react";
+import {WIDGET_ID} from "../../Config.ts";
+import {LocalInstanceStateContext} from "./ActivityContext.tsx";
+import {WidgetActivity} from "@reactedge/framework/activity";
+
+interface InstanceStateProviderProps {
+ children: ReactNode;
+ hostElement?: HTMLElement;
+}
+
+const LocalStateProvider = LocalInstanceStateContext.Provider;
+
+export const ActivityContextProvider: React.FC = ({
+ children,
+ hostElement
+ }) => {
+
+ const host = hostElement ?? document.documentElement;
+
+ const activity = new WidgetActivity(WIDGET_ID, host.dataset.instance)
+
+ return (
+
+ {children}
+
+ );
+};
diff --git a/widgets/subscription/src/activity/Context/useActivityContext.ts b/widgets/subscription/src/activity/Context/useActivityContext.ts
new file mode 100644
index 00000000..7a61a77d
--- /dev/null
+++ b/widgets/subscription/src/activity/Context/useActivityContext.ts
@@ -0,0 +1,11 @@
+import {useContext} from "react";
+import {LocalInstanceStateContext} from "./ActivityContext.tsx";
+import type {WidgetActivity} from "@reactedge/framework/activity";
+
+export function useActivityContext(): WidgetActivity {
+ const context = useContext(LocalInstanceStateContext);
+ if (!context) {
+ throw new Error("useInstanceState must be used within InstanceStateProvider");
+ }
+ return context;
+}
\ No newline at end of file
diff --git a/widgets/subscription/src/bootstrap/WidgetWrapper.tsx b/widgets/subscription/src/bootstrap/WidgetWrapper.tsx
new file mode 100644
index 00000000..fabe519b
--- /dev/null
+++ b/widgets/subscription/src/bootstrap/WidgetWrapper.tsx
@@ -0,0 +1,35 @@
+import {useActivityContext} from "../activity/Context/useActivityContext.ts";
+import {readWidgetConfig} from "../Config.ts";
+import {useEffect, useState} from "react";
+import {SystemStateProvider} from "../state/System/SystemStateProvider.tsx";
+import {SpinnerOverlay} from "../components/global/SpinnerOverlay.tsx";
+import {WidgetSubscription} from "../components/WidgetSubscription.tsx";
+
+type Props = {
+ contract: unknown,
+ runtime: unknown;
+}
+
+export default function WidgetWrapper({contract, runtime}: Props) {
+ const activity = useActivityContext()
+ const [bootReady, setBootReady] = useState(false);
+ const config = readWidgetConfig(contract, runtime, activity);
+
+ useEffect(() => {
+ if (!config) return;
+
+ // delay first meaningful render
+ requestAnimationFrame(() => {
+ setBootReady(true);
+ });
+ }, [config]);
+
+ if (!config) return null;
+
+ return
+ {!bootReady
+ ?
+ :
+ }
+
+}
\ No newline at end of file
diff --git a/widgets/subscription/src/bootstrap/widget-root.tsx b/widgets/subscription/src/bootstrap/widget-root.tsx
new file mode 100644
index 00000000..4ba810f9
--- /dev/null
+++ b/widgets/subscription/src/bootstrap/widget-root.tsx
@@ -0,0 +1,26 @@
+import {WIDGET_ID} from "../Config.ts";
+import {ActivityContextProvider} from "../activity/Context/ActivityContextProvider.tsx";
+import WidgetWrapper from "./WidgetWrapper.tsx";
+
+interface WidgetRootProps {
+ contract: unknown;
+ runtime: unknown;
+ bootstrap?: unknown;
+ hostElement?: HTMLElement;
+}
+
+export function WidgetRoot({
+ contract,
+ runtime,
+ hostElement,
+}: WidgetRootProps) {
+ return (
+
+ );
+}
\ No newline at end of file
diff --git a/widgets/subscription/src/components/WidgetSubscription.tsx b/widgets/subscription/src/components/WidgetSubscription.tsx
new file mode 100644
index 00000000..303feb52
--- /dev/null
+++ b/widgets/subscription/src/components/WidgetSubscription.tsx
@@ -0,0 +1,142 @@
+import { useState } from "react";
+import type { WidgetConfig } from "../Config.ts";
+import { useProductData } from "../hooks/domain/useProductData.tsx";
+import type { BootstrapData } from "../entrypoints/ssr.tsx";
+import { useSubscriptionController } from "../controller/useSubscriptionController.ts";
+
+type Props = {
+ config: WidgetConfig;
+ bootstrap?: BootstrapData;
+};
+
+export const WidgetSubscription = ({ config, bootstrap }: Props) => {
+ const { productData, productError, productLoading } = useProductData(config.runtime.sku, bootstrap);
+ const [purchaseType, setPurchaseType] = useState<"one-time" | "subscription">("one-time");
+ const [selectedPlanId, setSelectedPlanId] = useState(config.data.plans[0]?.id ?? "");
+ const [termsPlanId, setTermsPlanId] = useState(null);
+ const { status, message, subscribe, termsStatus, termsHtml, loadTerms } = useSubscriptionController(config.runtime.termsUrl);
+
+ if (productLoading) return Loading product...
;
+ if (productError || !productData) return Unable to load product.
;
+
+ const showTerms = (blockId: string, planId: string) => {
+ setTermsPlanId(planId);
+ void loadTerms(blockId);
+ };
+
+ if (!config.data.isCustomerLoggedIn) {
+ return (
+
+ {config.data.title}
+ Please sign in to subscribe.
+
+ );
+ }
+
+ return (
+
+ {config.data.title}
+ {productData.name}
+
+ {productData.sku}
+ {productData.name}
+
+
+
+
+ {purchaseType === "subscription" && (
+
+
+
+ {message && (
+
+ {message}
+
+ )}
+
+ )}
+
+ {termsPlanId && (
+ setTermsPlanId(null)}>
+
event.stopPropagation()}
+ >
+
+ Subscription Terms & Conditions
+
+
+ {termsStatus === "loading" && Loading terms…
}
+ {termsStatus === "error" && Unable to load terms. Please try again.
}
+ {termsStatus === "success" && (
+
+ )}
+
+
+ )}
+
+ );
+};
diff --git a/widgets/subscription/src/components/global/Circle.tsx b/widgets/subscription/src/components/global/Circle.tsx
new file mode 100644
index 00000000..6f01f52f
--- /dev/null
+++ b/widgets/subscription/src/components/global/Circle.tsx
@@ -0,0 +1,37 @@
+
+
+type SpinnerProps = {
+ size?: number;
+};
+
+export function Circle({ size = 40 }: SpinnerProps) {
+
+ return (
+
+ );
+}
diff --git a/widgets/subscription/src/components/global/SpinnerOverlay.tsx b/widgets/subscription/src/components/global/SpinnerOverlay.tsx
new file mode 100644
index 00000000..51b2ee01
--- /dev/null
+++ b/widgets/subscription/src/components/global/SpinnerOverlay.tsx
@@ -0,0 +1,8 @@
+import {StandardSpinner} from "./StandardSpinner.tsx";
+
+export const SpinnerOverlay = () => {
+
+ return (
+
+ )
+}
\ No newline at end of file
diff --git a/widgets/subscription/src/components/global/StandardSpinner.tsx b/widgets/subscription/src/components/global/StandardSpinner.tsx
new file mode 100644
index 00000000..6c006762
--- /dev/null
+++ b/widgets/subscription/src/components/global/StandardSpinner.tsx
@@ -0,0 +1,14 @@
+import {Circle} from "./Circle.tsx";
+
+type SpinnerProps = {
+ size?: number;
+};
+
+export function StandardSpinner({ size = 40 }: SpinnerProps) {
+
+ return (
+
+
+
+ );
+}
diff --git a/widgets/subscription/src/controller/useSubscriptionController.ts b/widgets/subscription/src/controller/useSubscriptionController.ts
new file mode 100644
index 00000000..2665c728
--- /dev/null
+++ b/widgets/subscription/src/controller/useSubscriptionController.ts
@@ -0,0 +1,63 @@
+import { useState } from "react";
+import { useActivityContext } from "../activity/Context/useActivityContext.ts";
+import { submitSubscriptionSelection } from "../integration/subscriptionSubmit.ts";
+import type { SubscriptionPlan } from "../Config.ts";
+
+type ControllerStatus = "idle" | "error";
+type TermsStatus = ControllerStatus | "loading" | "success";
+
+export function useSubscriptionController(termsUrl: string) {
+ const activity = useActivityContext();
+ const [status, setStatus] = useState("idle");
+ const [message, setMessage] = useState("");
+ const [termsStatus, setTermsStatus] = useState("idle");
+ const [termsHtml, setTermsHtml] = useState("");
+
+ const subscribe = (sku: string, storeCode: string, plan: SubscriptionPlan) => {
+ setStatus("idle");
+ setMessage("");
+ activity.log("subscription-submit", "Dispatch subscription selection", {
+ sku,
+ storeCode,
+ subscriptionPlanId: plan.id,
+ });
+
+ const handled = submitSubscriptionSelection({
+ purchaseType: "subscription",
+ sku,
+ storeCode,
+ plan: {
+ id: plan.id,
+ frequency: plan.frequency,
+ ...(plan.discount ? { discount: plan.discount } : {}),
+ ...(plan.termsBlockId ? { termsBlockId: plan.termsBlockId } : {}),
+ },
+ });
+
+ if (!handled) {
+ setStatus("error");
+ setMessage("Subscription checkout is not connected on this page.");
+ }
+ };
+
+ const loadTerms = async (blockId: string) => {
+ setTermsStatus("loading");
+ setTermsHtml("");
+
+ try {
+ const url = new URL(termsUrl, window.location.origin);
+ url.searchParams.set("block_id", blockId);
+ const response = await fetch(url.toString(), {
+ headers: { Accept: "text/html" },
+ });
+ if (!response.ok) throw new Error("Unable to load terms.");
+ setTermsHtml(await response.text());
+ setTermsStatus("success");
+ } catch (error) {
+ activity.log("subscription-terms", "Load terms failed", error, "error");
+ setTermsStatus("error");
+ }
+ };
+
+ return { status, message, subscribe, termsStatus, termsHtml, loadTerms };
+}
diff --git a/widgets/subscription/src/entrypoints/npm.tsx b/widgets/subscription/src/entrypoints/npm.tsx
new file mode 100644
index 00000000..4be4eb57
--- /dev/null
+++ b/widgets/subscription/src/entrypoints/npm.tsx
@@ -0,0 +1,47 @@
+import {Widget} from "../Widget.tsx";
+import {ResourceLoader} from "@reactedge/framework/contract.ts";
+import {WidgetActivity} from "@reactedge/framework/activity";
+import {WIDGET_ID} from "../Config.ts";
+
+async function main() {
+ const loader = new ResourceLoader();
+ const activity = new WidgetActivity(WIDGET_ID)
+ const contract = await loader.loadContract("default.json");
+ const bootstrap = await loader.loadContract("data.json");
+ const runtime = await loader.loadRuntime();
+
+ const container = document.getElementById("root")!;
+
+ const mode = __REACTEDGE_MODE__;
+
+ if (mode === "hydrate") {
+ activity.debug("Hydrating existing HTML", {
+ contract,
+ bootstrap,
+ runtime,
+ html: container.innerHTML
+ });
+ } else {
+ activity.debug("Rendering from scratch");
+ }
+
+ if (mode === "hydrate") {
+ Widget({
+ container,
+ contract,
+ bootstrap,
+ runtime,
+ hydrate: true
+ });
+ } else {
+ Widget({
+ container,
+ contract,
+ bootstrap,
+ runtime,
+ hydrate: false
+ });
+ }
+}
+
+main();
\ No newline at end of file
diff --git a/widgets/subscription/src/entrypoints/ssr.tsx b/widgets/subscription/src/entrypoints/ssr.tsx
new file mode 100644
index 00000000..8022369b
--- /dev/null
+++ b/widgets/subscription/src/entrypoints/ssr.tsx
@@ -0,0 +1,20 @@
+import { renderToString } from 'react-dom/server';
+import {WIDGET_ID} from "../Config.ts";
+import type { ReactEdgeRuntimeConfig, ProductData } from "../Config.ts";
+import { WidgetView } from "../WidgetView.tsx";
+
+export interface BootstrapData {
+ productData: ProductData | undefined;
+}
+
+export const renderHtml = (config: unknown, runtime: ReactEdgeRuntimeConfig, bootstrap: BootstrapData): string => {
+ return renderToString(
+
+
+
+ );
+};
+
+export { buildBootstrap } from '../ssr/bootstrap';
+
+export { loadRuntime } from '../ssr/bootstrap';
\ No newline at end of file
diff --git a/widgets/subscription/src/hooks/domain/useProductData.tsx b/widgets/subscription/src/hooks/domain/useProductData.tsx
new file mode 100644
index 00000000..46b710d7
--- /dev/null
+++ b/widgets/subscription/src/hooks/domain/useProductData.tsx
@@ -0,0 +1,33 @@
+import { useMagentoProductData } from "../infra/useMagentoProductData.tsx";
+import type { BootstrapData } from "../../entrypoints/ssr.tsx";
+
+export function useProductData(
+ sku: string,
+ bootstrap?: BootstrapData
+) {
+ const initialData = bootstrap?.productData;
+
+ const shouldFetch = !initialData;
+
+ const {
+ magentoProductData,
+ loading: productLoading,
+ error: productError,
+ refetch,
+ } = useMagentoProductData(
+ shouldFetch,
+ sku
+ );
+
+ return {
+ productData: magentoProductData,
+
+ productLoading:
+ shouldFetch && productLoading,
+
+ productError:
+ shouldFetch ? productError : null,
+
+ refetch,
+ };
+}
\ No newline at end of file
diff --git a/widgets/subscription/src/hooks/infra/useMagentoProductData.tsx b/widgets/subscription/src/hooks/infra/useMagentoProductData.tsx
new file mode 100644
index 00000000..7e6bda00
--- /dev/null
+++ b/widgets/subscription/src/hooks/infra/useMagentoProductData.tsx
@@ -0,0 +1,41 @@
+import { useCallback, useEffect, useState } from "react";
+import { useSystemState } from "../../state/System/useSystemState.ts";
+import { getError } from "../../lib/error.ts";
+import type { ProductData } from "../../Config.ts"
+import { fetchMagentoProductData } from "../../services/magento/fetchMagentoProductData.tsx";
+export function useMagentoProductData(enabled: boolean, sku?: string) {
+ const [data, setData] = useState();
+ const [loading, setLoading] = useState(false);
+ const [error, setError] = useState(null);
+
+ const { graphqlClient } = useSystemState();
+
+ const load = useCallback(async () => {
+ if (!enabled || sku === undefined) {
+ return;
+ }
+
+ setLoading(true);
+ setError(null);
+
+ try {
+ const result = await fetchMagentoProductData(graphqlClient, sku);
+ setData(result);
+ } catch (err: unknown) {
+ setError(getError(err));
+ } finally {
+ setLoading(false);
+ }
+ }, [enabled, sku, graphqlClient]);
+
+ useEffect(() => {
+ void load();
+ }, [load]);
+
+ return {
+ magentoProductData: data,
+ loading,
+ error,
+ refetch: load
+ };
+}
\ No newline at end of file
diff --git a/widgets/subscription/src/integration/subscriptionSubmit.ts b/widgets/subscription/src/integration/subscriptionSubmit.ts
new file mode 100644
index 00000000..a55a4b4b
--- /dev/null
+++ b/widgets/subscription/src/integration/subscriptionSubmit.ts
@@ -0,0 +1,27 @@
+export interface SubscriptionSubmitDetail {
+ purchaseType: "subscription";
+ sku: string;
+ storeCode: string;
+ plan: {
+ id: string;
+ frequency: string;
+ discount?: string;
+ termsBlockId?: string;
+ };
+}
+
+/**
+ * Dispatches a storefront action for the selected subscription plan.
+ * The host acknowledges synchronously with preventDefault() and owns
+ * the asynchronous Magento operation.
+ */
+export function submitSubscriptionSelection(
+ detail: SubscriptionSubmitDetail
+): boolean {
+ const event = new CustomEvent(
+ "reactedge:subscription:submit",
+ { detail, cancelable: true }
+ );
+
+ return !window.dispatchEvent(event);
+}
diff --git a/widgets/subscription/src/lib/error.ts b/widgets/subscription/src/lib/error.ts
new file mode 100644
index 00000000..9c9954d2
--- /dev/null
+++ b/widgets/subscription/src/lib/error.ts
@@ -0,0 +1,10 @@
+export function getError(err: unknown): Error {
+ if (err instanceof Error) {
+ return err;
+ } else {
+ return {
+ name: "unknonw",
+ message: err as string
+ };
+ }
+}
\ No newline at end of file
diff --git a/widgets/subscription/src/lib/graphqlResponseNormalizer.ts b/widgets/subscription/src/lib/graphqlResponseNormalizer.ts
new file mode 100644
index 00000000..a3852896
--- /dev/null
+++ b/widgets/subscription/src/lib/graphqlResponseNormalizer.ts
@@ -0,0 +1,47 @@
+import type {WidgetActivity} from "@reactedge/framework/activity";
+
+const PATCH_ON_DEFAULT = true;
+
+export function normalizeGraphqlResponse(
+ rawText: string,
+ activity?: WidgetActivity
+) {
+ try {
+ return JSON.parse(rawText);
+ } catch (err) {
+ if (!PATCH_ON_DEFAULT) {
+ throw err;
+ }
+
+ // Demo-only fallback:
+ // Extract the last JSON object from concatenated payload
+ const idxData = rawText.indexOf('{"data"');
+ const idxErrors = rawText.indexOf('{"errors"');
+
+ const idx =
+ idxData !== -1 && idxErrors !== -1 ? Math.min(idxData, idxErrors) :
+ idxData !== -1 ? idxData :
+ idxErrors !== -1 ? idxErrors :
+ -1;
+
+ if (idx === -1) {
+ throw new Error("GraphQL fallback failed: cannot find JSON payload start.");
+ }
+
+ const candidate = rawText.slice(idx);
+
+ activity?.log('graphql-invalid-json', 'GraphQL normalised raw text', {
+ candidate: candidate
+ });
+
+ try {
+ const parsed = JSON.parse(candidate);
+
+ activity?.log('graphql-invalid-json',"⚠ DEMO PATCH ACTIVE: GraphQL response was polluted. Fallback parser used.", null, 'warn');
+
+ return parsed;
+ } catch {
+ throw new Error("GraphQL fallback parsing failed.");
+ }
+ }
+}
diff --git a/widgets/subscription/src/services/magento/fetchMagentoProductData.tsx b/widgets/subscription/src/services/magento/fetchMagentoProductData.tsx
new file mode 100644
index 00000000..22c603e8
--- /dev/null
+++ b/widgets/subscription/src/services/magento/fetchMagentoProductData.tsx
@@ -0,0 +1,52 @@
+import type {ProductData} from "../../Config.ts";
+import type {GraphqlClient} from "@reactedge/framework/graphql/graphqlClient.ts";
+
+export type GraphqlProduct = {
+ id?: string | number | null;
+ sku?: string | null;
+ name?: string | null;
+};
+
+export type ProductsResponse = {
+ products: {items: GraphqlProduct[]}
+}
+
+const QUERY = `
+ query GetProducts($filter: ProductAttributeFilterInput!) {
+ products(filter: $filter) {
+ items {
+ id
+ sku
+ name
+ }
+ }
+ }
+`;
+
+export async function fetchMagentoProductData(
+ graphqlClient: GraphqlClient,
+ sku: string
+): Promise {
+ const data = await graphqlClient(
+ QUERY,
+ {
+ filter: {
+ sku: {
+ eq: sku,
+ },
+ },
+ }
+ );
+
+ const product = data.products.items[0];
+
+ if (!product) {
+ return null;
+ }
+
+ return {
+ id: String(product.id ?? ''),
+ sku: product.sku ?? "",
+ name: product.name ?? "",
+ };
+}
diff --git a/widgets/subscription/src/ssr/bootstrap.ts b/widgets/subscription/src/ssr/bootstrap.ts
new file mode 100644
index 00000000..2e1c44c7
--- /dev/null
+++ b/widgets/subscription/src/ssr/bootstrap.ts
@@ -0,0 +1,48 @@
+import type { ReactEdgeRuntimeConfig } from "../Config.ts";
+import { WIDGET_ID } from "../Config.ts";
+import fs from 'node:fs/promises';
+import {createGraphqlService} from "@reactedge/framework/graphql/graphql.service.ts"
+import {fetchMagentoProductData} from "../services/magento/fetchMagentoProductData";
+
+export async function loadRuntime(): Promise {
+ const path =
+ `./widgets/${WIDGET_ID}/public/reactedge-runtime.json`;
+
+ return JSON.parse(
+ await fs.readFile(path, 'utf8')
+ );
+}
+
+export async function buildBootstrap(runtime: ReactEdgeRuntimeConfig) {
+ const graphqlApi = getGraphqQlAPI(runtime);
+
+ const graphqlClient = createGraphqlService(
+ graphqlApi as string,
+ runtime.context.storeCode
+ );
+
+ const productData =
+ await fetchMagentoProductData(
+ graphqlClient,
+ runtime.context.sku
+ );
+
+ return {
+ productData
+ };
+}
+
+function getGraphqQlAPI(runtime: ReactEdgeRuntimeConfig) {
+ const magentoGraphql =
+ runtime.integrations.magentoGraphql;
+
+ const graphqlApi = magentoGraphql.api
+
+ if (!graphqlApi) {
+ throw new Error(
+ 'No Magento GraphQL endpoint configured'
+ );
+ }
+
+ return graphqlApi
+}
\ No newline at end of file
diff --git a/widgets/subscription/src/state/System/SystemState.tsx b/widgets/subscription/src/state/System/SystemState.tsx
new file mode 100644
index 00000000..00462f2c
--- /dev/null
+++ b/widgets/subscription/src/state/System/SystemState.tsx
@@ -0,0 +1,4 @@
+import {createContext} from "react";
+import type {SystemState} from "./type.ts";
+
+export const LocalSystemStateContext = createContext(undefined);
\ No newline at end of file
diff --git a/widgets/subscription/src/state/System/SystemStateProvider.tsx b/widgets/subscription/src/state/System/SystemStateProvider.tsx
new file mode 100644
index 00000000..798e8a1f
--- /dev/null
+++ b/widgets/subscription/src/state/System/SystemStateProvider.tsx
@@ -0,0 +1,41 @@
+import React from "react";
+import {type ReactNode, useMemo} from "react";
+import {LocalSystemStateContext} from "./SystemState.tsx";
+import type {WidgetActivity} from "@reactedge/framework/activity";
+import type {ResolvedConfigIntegrations, RuntimeConfig} from "../../Config.ts";
+import {createGraphqlService} from "@reactedge/framework/graphql/graphql.service.ts";
+
+interface SystemStateProviderProps {
+ children: ReactNode;
+ config: ResolvedConfigIntegrations;
+ runtime: RuntimeConfig;
+ activity?: WidgetActivity
+}
+
+const LocalStateProvider = LocalSystemStateContext.Provider;
+
+export const SystemStateProvider: React.FC = ({
+ children,
+ config,
+ runtime,
+ activity
+}) => {
+ if (!config?.magentoGraphql?.api) {
+ throw new Error('GraphQL client cannot be created without API endpoint');
+ }
+
+ const graphqlClient = useMemo(
+ () => createGraphqlService(config.magentoGraphql.api, runtime.storeCode, activity),
+ [config.magentoGraphql?.api, runtime.storeCode, activity]
+ );
+
+ return (
+
+ {children}
+
+ );
+};
\ No newline at end of file
diff --git a/widgets/subscription/src/state/System/type.ts b/widgets/subscription/src/state/System/type.ts
new file mode 100644
index 00000000..9e6dc875
--- /dev/null
+++ b/widgets/subscription/src/state/System/type.ts
@@ -0,0 +1,5 @@
+import type {GraphqlClient} from "@reactedge/framework/graphql/graphqlClient.ts";
+
+export interface SystemState {
+ graphqlClient: GraphqlClient;
+}
\ No newline at end of file
diff --git a/widgets/subscription/src/state/System/useSystemState.ts b/widgets/subscription/src/state/System/useSystemState.ts
new file mode 100644
index 00000000..cb883c49
--- /dev/null
+++ b/widgets/subscription/src/state/System/useSystemState.ts
@@ -0,0 +1,11 @@
+import {useContext} from "react";
+import type {SystemState} from "./type.ts";
+import {LocalSystemStateContext} from "./SystemState.tsx";
+
+export function useSystemState(): SystemState {
+ const context = useContext(LocalSystemStateContext);
+ if (!context) {
+ throw new Error("useSystemState must be used within SystemStateProvider");
+ }
+ return context;
+}
\ No newline at end of file
diff --git a/widgets/subscription/src/styles/entry.ts b/widgets/subscription/src/styles/entry.ts
new file mode 100644
index 00000000..c960ab03
--- /dev/null
+++ b/widgets/subscription/src/styles/entry.ts
@@ -0,0 +1,5 @@
+import main from "./main.css?inline";
+
+export const styles = [
+ main,
+];
\ No newline at end of file
diff --git a/widgets/subscription/src/styles/main.css b/widgets/subscription/src/styles/main.css
new file mode 100644
index 00000000..0896e5be
--- /dev/null
+++ b/widgets/subscription/src/styles/main.css
@@ -0,0 +1,86 @@
+.subscription-widget {
+ max-width: 42rem;
+ color: #222;
+ font: inherit;
+}
+
+.subscription-purchase-type,
+.subscription-plans fieldset {
+ display: grid;
+ gap: 0.75rem;
+ margin: 1rem 0;
+ padding: 1rem;
+ border: 1px solid #d5d5d5;
+}
+
+.subscription-purchase-type label,
+.subscription-plan label {
+ display: flex;
+ align-items: center;
+ gap: 0.5rem;
+}
+
+.subscription-plan {
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ gap: 1rem;
+}
+
+.subscription-submit {
+ padding: 0.75rem 1.5rem;
+ border: 0;
+ background: #222;
+ color: #fff;
+ cursor: pointer;
+}
+
+.subscription-submit:disabled {
+ cursor: wait;
+ opacity: 0.6;
+}
+
+.subscription-terms-link {
+ border: 0;
+ background: transparent;
+ color: #1458a5;
+ cursor: pointer;
+ text-decoration: underline;
+}
+
+.subscription-modal-backdrop {
+ position: fixed;
+ z-index: 10000;
+ inset: 0;
+ display: grid;
+ place-items: center;
+ padding: 1rem;
+ background: rgb(0 0 0 / 55%);
+}
+
+.subscription-modal {
+ width: min(40rem, 100%);
+ max-height: 85vh;
+ overflow: auto;
+ padding: 1.25rem;
+ background: #fff;
+ color: #222;
+}
+
+.subscription-modal header {
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ gap: 1rem;
+}
+
+.subscription-modal header button {
+ border: 0;
+ background: transparent;
+ font-size: 1.5rem;
+ cursor: pointer;
+}
+
+.subscription-terms-content {
+ padding-top: 1rem;
+}
diff --git a/widgets/subscription/src/tests/subscription.spec.ts b/widgets/subscription/src/tests/subscription.spec.ts
new file mode 100644
index 00000000..baf02cf9
--- /dev/null
+++ b/widgets/subscription/src/tests/subscription.spec.ts
@@ -0,0 +1,33 @@
+import { expect, test } from "@playwright/test";
+import type { Locator } from "@playwright/test";
+
+test.describe('Subscription Widget', () => {
+ let subscription: Locator;
+
+ test.beforeEach(async ({ page }) => {
+ await page.goto('/?reactedge_debug=eager');
+ subscription = page.locator('subscription-widget');
+ await expect(subscription).toBeVisible();
+ });
+
+ test('Subscription widget renders its configured title', async () => {
+ const title = subscription.locator(
+ '[data-subscription-title]'
+ );
+
+ await expect(title).toBeVisible();
+ });
+
+ test('Subscription widget renders the title colour', async () => {
+ const title = subscription.locator(
+ '[data-subscription-title]'
+ );
+
+ const colour = await title.evaluate(
+ (element: HTMLElement) =>
+ getComputedStyle(element).color
+ );
+
+ expect(colour).not.toBe('rgb(0, 0, 0)');
+ });
+});
\ No newline at end of file
diff --git a/widgets/subscription/src/types/global.d.ts b/widgets/subscription/src/types/global.d.ts
new file mode 100644
index 00000000..99c9f6c7
--- /dev/null
+++ b/widgets/subscription/src/types/global.d.ts
@@ -0,0 +1,9 @@
+export {};
+
+declare global {
+ interface Window {
+ __REACTEDGE_DEBUG__?: boolean;
+ [key: `ReactEdge_${string}`]: WidgetApi;
+ }
+ const __REACTEDGE_MODE__: "render" | "hydrate";
+}
diff --git a/widgets/subscription/tests/subscription.spec.ts b/widgets/subscription/tests/subscription.spec.ts
new file mode 100644
index 00000000..154b5f0c
--- /dev/null
+++ b/widgets/subscription/tests/subscription.spec.ts
@@ -0,0 +1,111 @@
+import { expect, test } from "@playwright/test";
+import type { Locator } from "@playwright/test";
+
+test.describe('Subscription Widget', () => {
+ let subscription: Locator;
+
+ test.beforeEach(async ({ page }) => {
+ await page.route('https://magento.example/graphql', async (route) => {
+ const request = route.request().postDataJSON();
+ if (request.query.includes('AddSubscriptionToCart')) {
+ await route.fulfill({
+ json: { data: { addSubscriptionToCart: { success: true, message: 'Added' } } },
+ });
+ return;
+ }
+ await route.fulfill({
+ json: { data: { products: { items: [{ id: 42, sku: 'example-product', name: 'Example product' }] } } },
+ });
+ });
+ await page.route('**/subscribe/plan/terms*', (route) =>
+ route.fulfill({ body: 'Monthly subscription terms
', contentType: 'text/html' })
+ );
+ await page.goto('/?reactedge_debug=eager');
+ subscription = page.locator('subscription-widget');
+ await expect(subscription).toBeVisible();
+ });
+
+ test('Subscription widget renders its configured title', async () => {
+ const title = subscription.locator(
+ '[data-subscription-title]'
+ );
+
+ await expect(title).toBeVisible();
+ });
+
+ test('Subscription widget renders the title colour', async () => {
+ const title = subscription.locator(
+ '[data-subscription-title]'
+ );
+
+ const colour = await title.evaluate(
+ element => getComputedStyle(element).color
+ );
+
+ expect(colour).not.toBe('rgb(0, 0, 0)');
+ });
+
+ test('Subscription widget renders product data', async () => {
+ const product = subscription.locator(
+ '[data-subscription-product]'
+ );
+
+ await expect(product).toBeVisible();
+
+ await expect(
+ product.getByText('SKU', { exact: true })
+ ).toBeVisible();
+
+ await expect(
+ product.getByText('Name', { exact: true })
+ ).toBeVisible();
+ });
+
+ test('Subscription widget loads product data from GraphQL', async () => {
+ const product = subscription.locator(
+ '[data-subscription-product]'
+ );
+
+ await expect(product).toBeVisible();
+
+ const values = product.locator('dd');
+
+ await expect(values).toHaveCount(2);
+ await expect(values.nth(0)).toHaveText(/\S+/);
+ await expect(values.nth(1)).toHaveText(/\S+/);
+ });
+
+ test('Subscribe dispatches a storefront event with the selected plan', async ({ page }) => {
+ await page.evaluate(() => {
+ window.addEventListener('reactedge:subscription:submit', (event) => {
+ event.preventDefault();
+ document.body.dataset.subscriptionEvent = JSON.stringify(
+ (event as CustomEvent).detail
+ );
+ }, { once: true });
+ });
+ await subscription.getByLabel('Subscribe & Save').check();
+ await subscription.getByRole('button', { name: 'Subscribe' }).click();
+ await expect.poll(() => page.locator('body').getAttribute('data-subscription-event')).not.toBeNull();
+ expect(JSON.parse((await page.locator('body').getAttribute('data-subscription-event')) ?? 'null')).toEqual({
+ purchaseType: 'subscription',
+ sku: 'example-product',
+ storeCode: 'default',
+ plan: {
+ id: 'monthly',
+ frequency: 'Every month',
+ discount: 'Save 10%',
+ termsBlockId: 'subscription-monthly-terms',
+ },
+ });
+ await expect(subscription.getByRole('alert')).toHaveCount(0);
+ });
+
+ test('Terms link opens a modal with the fetched CMS content', async () => {
+ await subscription.getByLabel('Subscribe & Save').check();
+ await subscription.getByRole('button', { name: 'View terms' }).first().click();
+ const dialog = subscription.getByRole('dialog');
+ await expect(dialog).toBeVisible();
+ await expect(dialog.getByText('Monthly subscription terms')).toBeVisible();
+ });
+});
diff --git a/widgets/subscription/tsconfig.app.json b/widgets/subscription/tsconfig.app.json
new file mode 100644
index 00000000..705ab148
--- /dev/null
+++ b/widgets/subscription/tsconfig.app.json
@@ -0,0 +1,7 @@
+{
+ "extends": "../../packages/widget-build/shared-resources/tsconfig.app.widget.json",
+ "compilerOptions": {
+ "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo"
+ },
+ "include": ["src", "api"]
+}
\ No newline at end of file
diff --git a/widgets/subscription/tsconfig.json b/widgets/subscription/tsconfig.json
new file mode 100644
index 00000000..4ebbbc80
--- /dev/null
+++ b/widgets/subscription/tsconfig.json
@@ -0,0 +1,8 @@
+{
+ "files": [],
+ "references": [
+ { "path": "./tsconfig.app.json" },
+ { "path": "./tsconfig.node.json" }
+ ],
+ "extends": "../../tsconfig.json"
+}
diff --git a/widgets/subscription/tsconfig.node.json b/widgets/subscription/tsconfig.node.json
new file mode 100644
index 00000000..620f3ec4
--- /dev/null
+++ b/widgets/subscription/tsconfig.node.json
@@ -0,0 +1,10 @@
+{
+ "extends": "../../packages/widget-build/shared-resources/tsconfig.node.widget.json",
+ "compilerOptions": {
+ "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo"
+ },
+ "include": [
+ "vite.config.ts",
+ "vite.npm.config.ts"
+ ]
+}
diff --git a/widgets/subscription/vite.config.ts b/widgets/subscription/vite.config.ts
new file mode 100644
index 00000000..a24d7915
--- /dev/null
+++ b/widgets/subscription/vite.config.ts
@@ -0,0 +1,49 @@
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react-swc";
+import pkg from "./package.json" with { type: "json" };
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+
+import { manifestPlugin } from "../../packages/widget-build/shared-resources/widget-preset/manifestPlugin.ts";
+import { createWidgetBuildDefaults } from "../../packages/widget-build/shared-resources/widget-preset/createReactEdgeConfig.ts";
+import { reactEdgeVisualizer } from "../../packages/widget-build/shared-resources/widget-preset/reactEdgeVisualizer.ts";
+
+const isAnalyze = process.env.ANALYZE === "true";
+const widgetName = pkg.name.replace(/^widget-/, "");
+const widgetDir = dirname(fileURLToPath(import.meta.url));
+
+export default defineConfig({
+ resolve: {
+ alias: {
+ "@reactedge": resolve(
+ widgetDir,
+ "../../packages/widget-build/shared-resources"
+ ),
+ },
+ },
+
+ plugins: [
+ react(),
+ reactEdgeVisualizer(isAnalyze),
+ manifestPlugin({
+ widgetName,
+ version: pkg.version,
+ }),
+ ],
+
+ define: {
+ "process.env.NODE_ENV": JSON.stringify("production"),
+ },
+
+ build: createWidgetBuildDefaults({
+ widgetName,
+ version: pkg.version,
+ entry: resolve(widgetDir, "api/runtime-shadow-widget.tsx"),
+ outDir: resolve(
+ widgetDir,
+ `../../workspace/release/source/${widgetName}`
+ ),
+ emitCss: false,
+ sourcemap: false
+ }),
+});
\ No newline at end of file
diff --git a/widgets/subscription/vite.npm.config.ts b/widgets/subscription/vite.npm.config.ts
new file mode 100644
index 00000000..71f83cc3
--- /dev/null
+++ b/widgets/subscription/vite.npm.config.ts
@@ -0,0 +1,31 @@
+import { defineConfig} from "vite";
+import type { BuildOptions } from "vite"
+import react from "@vitejs/plugin-react-swc";
+import pkg from "./package.json" with { type: "json" };
+import {dirname, resolve} from "node:path";
+import {createNpmBuildDefaults} from "../../packages/widget-build/shared-resources/widget-preset/createReactEdgeConfig.ts";
+import {fileURLToPath} from "node:url";
+
+const widgetName = pkg.name.replace(/^widget-/, "");
+const widgetDir = dirname(fileURLToPath(import.meta.url));
+
+export default defineConfig({
+ resolve: {
+ alias: {
+ "@reactedge": resolve(
+ widgetDir,
+ "../../packages/widget-build/shared-resources"
+ ),
+ },
+ },
+ publicDir: resolve(import.meta.dirname, "public"),
+ plugins: [react(), ],
+ define: {
+ __REACTEDGE_MODE__: JSON.stringify(
+ process.env.REACTEDGE_MODE ?? "render"
+ ),
+ },
+ build: createNpmBuildDefaults({
+ widgetName
+ }),
+});
\ No newline at end of file