@vendure-platform/create 0.5.1 → 1.0.0-major.202609160652.120.4

package/dist/assets/storefront/src/config/capabilities.ts

@@ -0,0 +1,49 @@
+/**
+ * Build-time capability set for the storefront.
+ *
+ * The server composes its GraphQL schema from the capability modules the
+ * deployment is entitled to, so a document that selects a field belonging to an
+ * absent module fails validation on every request. The storefront therefore has
+ * to know which capability-gated fields it may select before it builds its
+ * documents.
+ *
+ * `NEXT_PUBLIC_VENDURE_CAPABILITIES` is a comma-separated list of the capability
+ * keys the target deployment is granted, baked at build time like
+ * `NEXT_PUBLIC_SCENARIO`. It is a composition hint, not an authorization
+ * boundary: the server remains authoritative and rejects anything this list
+ * gets wrong.
+ *
+ * The variable is required. No default is safe: assuming every capability makes
+ * a Starter storefront select fields its server does not expose. An empty value
+ * is a deliberate choice and means the server grants none of the capabilities
+ * the storefront selects.
+ */
+const RAW_CAPABILITIES = process.env.NEXT_PUBLIC_VENDURE_CAPABILITIES;
+
+function parseCapabilities(raw: string | undefined): ReadonlySet<string> {
+    if (raw === undefined) {
+        throw new Error(
+            'NEXT_PUBLIC_VENDURE_CAPABILITIES is not set. Set it to the comma-separated capability keys ' +
+                'of the Vendure server this storefront connects to, which are the keys of that ' +
+                "server's capability profile, and build again. @vendure-platform/create writes them to " +
+                'the storefront .env.local. Set an empty value only when the server grants none of the ' +
+                'capabilities the storefront selects.',
+        );
+    }
+    return new Set(
+        raw
+            .split(',')
+            .map((key) => key.trim())
+            .filter((key) => key.length > 0),
+    );
+}
+
+const GRANTED = parseCapabilities(RAW_CAPABILITIES);
+
+/** True when the deployment is expected to expose `key`'s schema. */
+export function hasCapability(key: string): boolean {
+    return GRANTED.has(key);
+}
+
+/** Configurator forms, rules, saved configurations, and the configured order journey. */
+export const hasConfiguratorForms = hasCapability('configurator.forms');

package/dist/assets/storefront/src/config/scenario.ts

@@ -141,6 +141,16 @@ export interface CartSlotOverrides {
      */
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     CartItems?: ServerComponent<any>;
+
+    /**
+     * Banner slot rendered above the cart content. Receives the active order
+     * (or null when empty/awaiting approval). Use for scenario-specific
+     * call-outs.
+     *
+     * `app/[locale]/cart/cart.tsx` reads this slot unconditionally, so the
+     * declaration has to be here even though no customer scenario fills it.
+     */
+    Banner?: ServerComponent;
 }
 
 // =============================================================