@vendure/cloud-config 0.4.0 → 0.5.0-dev.20261014172655.g652e750

package/README.md

@@ -163,6 +163,15 @@ Vendure Cloud: Extension acme.erp attempted outbound access to api.other-erp.exa
 Declared outbound hosts: erp.acme.com
 ```
 
+`defineVendureExtension` accepts only bare public hostnames and stores each in the form the check
+compares: lowercase, without a trailing dot, and in Punycode. It refuses a URL, port, path,
+credentials, IP address, wildcard or local-network name. The error, an `InvalidOutboundHostsError`
+(a subclass of `InvalidVendureExtensionError`), names each refused entry by its position and does
+not quote it. The managed build evaluates the configuration before it creates an image, so the
+refusal fails the build, and the build's failure summary says which declaration to fix. This is
+syntax only; a public name that resolves to a private address is not detected. A report about a host
+that cannot be declared says so instead of suggesting the declaration.
+
 The check runs inside the customer's own process rather than in the network path, and
 attribution is the reason. A firewall sees a source address and a TLS server name and cannot
 say which extension made the call, so it cannot produce that message. Reading the stack can.
@@ -193,10 +202,10 @@ further down the same stack, and the suite covers all three.
 
 ### What it costs, and where it is imprecise
 
-An allowed call costs one `Set` lookup. The host is compared against the union of every
-declared host first, and only a host that appears in none of them is attributed, because
-capturing a stack is the expensive part. The cost of that ordering is that an extension
-reaching a host *another* extension declared is not reported.
+An allowed call costs a host normalisation and one `Set` lookup. The host is compared against
+the union of every declared host first, and only a host that appears in none of them is
+attributed, because capturing a stack is the expensive part. The cost of that ordering is that an
+extension reaching a host *another* extension declared is not reported.
 
 Interception is `globalThis.fetch` plus `net.Socket.prototype.connect`. The socket is where
 `http.request`, `https.request`, `net.connect` and every client library end up, and — unlike

package/dist/cloud-asset-server-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloud-asset-server-plugin.d.ts","sourceRoot":"","sources":["../src/cloud-asset-server-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAG7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAcjE,eAAO,MAAM,8BAA8B,iBAAiB,CAAC;AAK7D,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAQ1C,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAMlD,eAAO,MAAM,sCAAsC;;;;;CASzC,CAAC;AAMX,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAC3C,kBAAkB,EAClB,MAAM,OAAO,sCAAsC,CACpD,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG,0BAA0B,GAAG;IACvE,sBAAsB,CAAC,EAAE,aAAa,CACpC,CAAC,OAAO,sCAAsC,CAAC,CAAC,wBAAwB,CAAC,CAC1E,CAAC;IACF,cAAc,CAAC,EAAE,aAAa,CAAC,CAAC,OAAO,sCAAsC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAClG,cAAc,CAAC,EAAE,aAAa,CAAC,CAAC,OAAO,sCAAsC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAClG,KAAK,CAAC,EAAE,aAAa,CAAC,CAAC,OAAO,sCAAsC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;CACjF,CAAC;AAMF,MAAM,MAAM,wBAAwB,GAAG,0BAA0B,CAAC;AAWlE,eAAO,MAAM,sBAAsB;;;mBAOjB,6BAA6B,GAAQ,kBAAkB;CAQxE,CAAC;AAuBF,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,oBAAoB,GAAG,wBAAwB,CAMjG"}
+{"version":3,"file":"cloud-asset-server-plugin.d.ts","sourceRoot":"","sources":["../src/cloud-asset-server-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAG7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAUjE,eAAO,MAAM,8BAA8B,iBAAiB,CAAC;AAK7D,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAK1C,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAKlD,eAAO,MAAM,sCAAsC;;;;;CASzC,CAAC;AAIX,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAC3C,kBAAkB,EAClB,MAAM,OAAO,sCAAsC,CACpD,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG,0BAA0B,GAAG;IACvE,sBAAsB,CAAC,EAAE,aAAa,CACpC,CAAC,OAAO,sCAAsC,CAAC,CAAC,wBAAwB,CAAC,CAC1E,CAAC;IACF,cAAc,CAAC,EAAE,aAAa,CAAC,CAAC,OAAO,sCAAsC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAClG,cAAc,CAAC,EAAE,aAAa,CAAC,CAAC,OAAO,sCAAsC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAClG,KAAK,CAAC,EAAE,aAAa,CAAC,CAAC,OAAO,sCAAsC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;CACjF,CAAC;AAIF,MAAM,MAAM,wBAAwB,GAAG,0BAA0B,CAAC;AASlE,eAAO,MAAM,sBAAsB;;;mBAOjB,6BAA6B,GAAQ,kBAAkB;CAQxE,CAAC;AAiBF,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,oBAAoB,GAAG,wBAAwB,CAMjG"}

package/dist/cloud-asset-server-plugin.js

@@ -1,30 +1,22 @@
 import { declareCloudPlugin, listCloudPluginDeclarations } from "./cloud-plugin-declaration.js";
-// ADR-0044 rules `AssetServerPlugin` platform-supplied and wrapped, and ADR-0051 decides which of
-// its options the platform takes. This is the wrapper's declaration side: what a customer writes in
-// their configuration file. The plugin that serves and stores assets is built by the platform
-// runtime, which is the only place that knows the bucket, the credential chain and the hostname.
+// ADR-0044 and ADR-0051 own what the platform supplies. This file is the declaration side; the
+// platform runtime builds the plugin that serves and stores assets.
 //
-// The option types are imported from `@vendure/asset-server-plugin`. It is a peer dependency of
-// this package and a direct dependency of the `@vendure/cloud` facade, so a customer gets it
-// without declaring it and the tree holds one copy. One copy is what
-// `AssetServer.sanitizeFilePath` needs: it branches on `instanceof S3AssetStorageStrategy`, and
-// against a second copy that check fails and every asset request takes the local-filesystem
-// branch.
+// `@vendure/asset-server-plugin` is a peer dependency here and a direct dependency of
+// `@vendure/cloud`, so the tree holds one copy. `AssetServer.sanitizeFilePath` branches on
+// `instanceof S3AssetStorageStrategy`; with a second copy that check fails and every asset request
+// takes the local-filesystem branch.
 export const CLOUD_ASSET_SERVER_PLUGIN_KIND = "asset-server";
-// Fixed platform-wide (ADR-0051). The ingress carries an `/assets/*` cache behaviour whose path
-// pattern the control plane applies without reading customer code, so a customer-settable route
-// would move the asset path out from under it and nothing would report the move.
+// Fixed platform-wide (ADR-0051). The control plane applies the `/assets/*` cache path pattern
+// without reading customer code, so a customer-set route would move assets out from under it
+// unreported.
 export const CLOUD_ASSET_ROUTE = "assets";
-// The widest transform the platform renders, in pixels, on either axis. The number is a bound on
-// an unauthenticated amplification vector rather than a size the platform prefers: without it,
-// `?w=1` through `?w=10000` is ten thousand `sharp` runs and ten thousand stored objects, asked
-// for by anyone. It is set well above what a storefront asks for so that nobody meets it by
-// accident, and it is documented because a store legitimately serving something wider discovers it
-// as a smaller image rather than as an error.
+// Upper bound, in pixels on either axis, on an unauthenticated amplification vector: without it,
+// `?w=1` through `?w=10000` is ten thousand `sharp` runs and stored objects. Set above storefront
+// needs; a wider request is served as a smaller image, not an error.
 export const MAX_IMAGE_TRANSFORM_DIMENSION = 6000;
-// The four options that leave the type, with the explanation each one's build-time error carries.
-// Written as literals rather than assembled, for the reason `platform-fields.ts` records: the
-// explanation is what TypeScript prints when the field is set, so it is the message and not a key
+// Options removed from the customer type, each with the explanation its build-time error prints.
+// Literals, for the reason given in `platform-fields.ts`.
 // into one.
 export const PLATFORM_SUPPLIED_ASSET_SERVER_OPTIONS = {
     storageStrategyFactory: "Assets are stored in a bucket Vendure Cloud creates for this environment and only this environment's task can read. Remove storageStrategyFactory. To move assets you already hold, copy them in rather than pointing the platform at your own bucket.",
@@ -33,19 +25,16 @@ export const PLATFORM_SUPPLIED_ASSET_SERVER_OPTIONS = {
     route: "Assets are served at /assets, and the platform's cache sits on that exact path. Moving the route would take the asset path out from under it. Remove route.",
 };
 const PLATFORM_SUPPLIED_OPTION_NAMES = Object.keys(PLATFORM_SUPPLIED_ASSET_SERVER_OPTIONS);
-// A class carrying the default declaration, with `init` on it. A customer who wants a preset or a
-// transform strategy of their own writes `CloudAssetServerPlugin.init({ ... })`; one who wants the
-// defaults but wants assets visible in their file can write a bare `CloudAssetServerPlugin`. The
-// second is redundant, because the platform injects the default declaration when the customer
-// writes neither, and it is supported so that writing it is not read as a plugin nobody recognises.
+// A bare `CloudAssetServerPlugin` is the default declaration and `.init({ ... })` carries customer
+// options. The platform injects the default when neither is written, so the bare form only makes
+// assets visible in the file.
 export const CloudAssetServerPlugin = Object.assign(declareCloudPlugin("CloudAssetServerPlugin", CLOUD_ASSET_SERVER_PLUGIN_KIND, {}), {
     init(options = {}) {
         return declareCloudPlugin("CloudAssetServerPlugin", CLOUD_ASSET_SERVER_PLUGIN_KIND, withoutPlatformSuppliedOptions(options));
     },
 });
-// The branded options cannot be set from TypeScript, and a configuration file compiled from
-// JavaScript is not type-checked at all. Dropping them here rather than trusting the type is what
-// makes the platform's values authoritative in both cases, and it costs one object copy at boot.
+// The type blocks branded options only in TypeScript; a configuration compiled from JavaScript is
+// not type-checked. Dropping them at runtime keeps the platform's values authoritative in both.
 function withoutPlatformSuppliedOptions(options) {
     const customer = { ...options };
     for (const name of PLATFORM_SUPPLIED_OPTION_NAMES) {
@@ -53,14 +42,9 @@ function withoutPlatformSuppliedOptions(options) {
     }
     return customer;
 }
-// ADR-0044's rule that a wrapped plugin the customer declared replaces the platform's injected
-// default rather than joining it: the customer's declaration when there is one, an empty one when
-// there is not, and never both.
-//
-// A configuration declaring it more than once takes the last, which is what the upstream plugin's
-// static options do and therefore what a customer who has met that plugin expects. ADR-0044 calls a
-// double declaration a documentation problem rather than something to defend against, so this
-// resolves it quietly rather than refusing the boot over it.
+// ADR-0044: a customer declaration replaces the platform's injected default. With several
+// declarations the last wins, as in the upstream plugin's static options; ADR-0044 treats a double
+// declaration as a documentation problem.
 export function resolveAssetServerSettings(config) {
     const declarations = listCloudPluginDeclarations(config.plugins, CLOUD_ASSET_SERVER_PLUGIN_KIND);
     return declarations[declarations.length - 1]?.options ?? {};

package/dist/cloud-asset-server-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"cloud-asset-server-plugin.js","sourceRoot":"","sources":["../src/cloud-asset-server-plugin.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAIhG,kGAAkG;AAClG,oGAAoG;AACpG,8FAA8F;AAC9F,iGAAiG;AACjG,EAAE;AACF,gGAAgG;AAChG,6FAA6F;AAC7F,qEAAqE;AACrE,gGAAgG;AAChG,4FAA4F;AAC5F,UAAU;AAEV,MAAM,CAAC,MAAM,8BAA8B,GAAG,cAAc,CAAC;AAE7D,gGAAgG;AAChG,gGAAgG;AAChG,iFAAiF;AACjF,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC;AAE1C,iGAAiG;AACjG,+FAA+F;AAC/F,gGAAgG;AAChG,4FAA4F;AAC5F,mGAAmG;AACnG,8CAA8C;AAC9C,MAAM,CAAC,MAAM,6BAA6B,GAAG,IAAI,CAAC;AAElD,kGAAkG;AAClG,8FAA8F;AAC9F,kGAAkG;AAClG,YAAY;AACZ,MAAM,CAAC,MAAM,sCAAsC,GAAG;IACpD,sBAAsB,EACpB,wPAAwP;IAC1P,cAAc,EACZ,yHAAyH;IAC3H,cAAc,EACZ,8OAA8O;IAChP,KAAK,EACH,6JAA6J;CACvJ,CAAC;AA0BX,MAAM,8BAA8B,GAAG,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAExF,CAAC;AAEF,kGAAkG;AAClG,mGAAmG;AACnG,iGAAiG;AACjG,8FAA8F;AAC9F,oGAAoG;AACpG,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,CACjD,kBAAkB,CAChB,wBAAwB,EACxB,8BAA8B,EAC9B,EAAE,CACH,EACD;IACE,IAAI,CAAC,UAAyC,EAAE;QAC9C,OAAO,kBAAkB,CACvB,wBAAwB,EACxB,8BAA8B,EAC9B,8BAA8B,CAAC,OAAO,CAAC,CACxC,CAAC;IACJ,CAAC;CACF,CACF,CAAC;AAEF,4FAA4F;AAC5F,kGAAkG;AAClG,iGAAiG;AACjG,SAAS,8BAA8B,CACrC,OAAsC;IAEtC,MAAM,QAAQ,GAAG,EAAE,GAAG,OAAO,EAA6B,CAAC;IAC3D,KAAK,MAAM,IAAI,IAAI,8BAA8B,EAAE,CAAC;QAClD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,QAAoC,CAAC;AAC9C,CAAC;AAED,+FAA+F;AAC/F,kGAAkG;AAClG,gCAAgC;AAChC,EAAE;AACF,kGAAkG;AAClG,oGAAoG;AACpG,8FAA8F;AAC9F,6DAA6D;AAC7D,MAAM,UAAU,0BAA0B,CAAC,MAA4B;IACrE,MAAM,YAAY,GAAG,2BAA2B,CAC9C,MAAM,CAAC,OAAgC,EACvC,8BAA8B,CAC/B,CAAC;IACF,OAAO,YAAY,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,OAAO,IAAI,EAAE,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"cloud-asset-server-plugin.js","sourceRoot":"","sources":["../src/cloud-asset-server-plugin.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAIhG,+FAA+F;AAC/F,oEAAoE;AACpE,EAAE;AACF,sFAAsF;AACtF,2FAA2F;AAC3F,mGAAmG;AACnG,qCAAqC;AAErC,MAAM,CAAC,MAAM,8BAA8B,GAAG,cAAc,CAAC;AAE7D,+FAA+F;AAC/F,6FAA6F;AAC7F,cAAc;AACd,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC;AAE1C,iGAAiG;AACjG,kGAAkG;AAClG,qEAAqE;AACrE,MAAM,CAAC,MAAM,6BAA6B,GAAG,IAAI,CAAC;AAElD,iGAAiG;AACjG,0DAA0D;AAC1D,YAAY;AACZ,MAAM,CAAC,MAAM,sCAAsC,GAAG;IACpD,sBAAsB,EACpB,wPAAwP;IAC1P,cAAc,EACZ,yHAAyH;IAC3H,cAAc,EACZ,8OAA8O;IAChP,KAAK,EACH,6JAA6J;CACvJ,CAAC;AAsBX,MAAM,8BAA8B,GAAG,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAExF,CAAC;AAEF,mGAAmG;AACnG,iGAAiG;AACjG,8BAA8B;AAC9B,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,CACjD,kBAAkB,CAChB,wBAAwB,EACxB,8BAA8B,EAC9B,EAAE,CACH,EACD;IACE,IAAI,CAAC,UAAyC,EAAE;QAC9C,OAAO,kBAAkB,CACvB,wBAAwB,EACxB,8BAA8B,EAC9B,8BAA8B,CAAC,OAAO,CAAC,CACxC,CAAC;IACJ,CAAC;CACF,CACF,CAAC;AAEF,kGAAkG;AAClG,gGAAgG;AAChG,SAAS,8BAA8B,CACrC,OAAsC;IAEtC,MAAM,QAAQ,GAAG,EAAE,GAAG,OAAO,EAA6B,CAAC;IAC3D,KAAK,MAAM,IAAI,IAAI,8BAA8B,EAAE,CAAC;QAClD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,QAAoC,CAAC;AAC9C,CAAC;AAED,0FAA0F;AAC1F,mGAAmG;AACnG,0CAA0C;AAC1C,MAAM,UAAU,0BAA0B,CAAC,MAA4B;IACrE,MAAM,YAAY,GAAG,2BAA2B,CAC9C,MAAM,CAAC,OAAgC,EACvC,8BAA8B,CAC/B,CAAC;IACF,OAAO,YAAY,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,OAAO,IAAI,EAAE,CAAC;AAC9D,CAAC"}

package/dist/cloud-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloud-config.d.ts","sourceRoot":"","sources":["../src/cloud-config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cloud-config.d.ts","sourceRoot":"","sources":["../src/cloud-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC3F,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEnF,OAAO,CAAC,MAAM,kBAAkB,EAAE,OAAO,MAAM,CAAC;AAKhD,MAAM,MAAM,aAAa,CAAC,WAAW,SAAS,MAAM,IAAI;IACtD,QAAQ,CAAC,CAAC,kBAAkB,CAAC,EAAE,WAAW,CAAC;CAC5C,CAAC;AAIF,KAAK,SAAS,CAAC,IAAI,SAAS,sBAAsB,IAAI,OAAO,CAC3D,sBAAsB,EACtB;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CACf,CAAC,QAAQ,CAAC,CAAC;AAQZ,KAAK,UAAU,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;AAC9C,KAAK,WAAW,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC;AAChD,KAAK,YAAY,GAAG,WAAW,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC;AAC/D,KAAK,aAAa,GAAG,WAAW,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC,CAAC;AACjE,KAAK,eAAe,GAAG,WAAW,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC,CAAC;AACrE,KAAK,gBAAgB,GAAG,WAAW,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC,CAAC;AAKvE,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAAC,GAAG;IACpE,IAAI,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC,CAAC;CAC5D,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,IAAI,CACjC,WAAW,EACX,uBAAuB,GAAG,sBAAsB,GAAG,iBAAiB,CACrE,GAAG;IACF,qBAAqB,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,mCAAmC,CAAC,CAAC,CAAC;IACtF,oBAAoB,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,kCAAkC,CAAC,CAAC,CAAC;IACpF,eAAe,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAC,CAAC;CAC3E,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,YAAY,EAAE,sBAAsB,CAAC,GAAG;IAC3E,oBAAoB,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,mCAAmC,CAAC,CAAC,CAAC;CACtF,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,aAAa,EAAE,eAAe,GAAG,cAAc,CAAC,GAAG;IACvF,aAAa,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAC,CAAC;IACxE,YAAY,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,4BAA4B,CAAC,CAAC,CAAC;CACvE,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG;IAC7E,gBAAgB,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,kCAAkC,CAAC,CAAC,CAAC;CACjF,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,IAAI,CACtC,gBAAgB,EAChB,mBAAmB,GAAG,sBAAsB,CAC7C,GAAG;IACF,iBAAiB,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,oCAAoC,CAAC,CAAC,CAAC;IACnF,oBAAoB,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,uCAAuC,CAAC,CAAC,CAAC;CAC1F,CAAC;AAMF,MAAM,MAAM,WAAW,GAAG,OAAO,CAC/B,IAAI,CACF,aAAa,EACX,SAAS,GACT,qBAAqB,GACrB,QAAQ,GACR,YAAY,GACZ,aAAa,GACb,cAAc,GACd,eAAe,GACf,iBAAiB,GACjB,kBAAkB,CACrB,CACF,GAAG;IACF,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,mBAAmB,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC,CAAC;IACtE,MAAM,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5C,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,eAAe,CAAC,EAAE,oBAAoB,CAAC;IACvC,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;CAC1C,CAAC;AAIF,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,GAAG;IAChE,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B,CAAC"}

package/dist/cloud-dashboard-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloud-dashboard-plugin.d.ts","sourceRoot":"","sources":["../src/cloud-dashboard-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAOjE,eAAO,MAAM,2BAA2B,cAAc,CAAC;AAIvD,eAAO,MAAM,uBAAuB,cAAc,CAAC;AAMnD,eAAO,MAAM,mCAAmC;;;CAKtC,CAAC;AAEX,MAAM,WAAW,2BAA2B;IAG1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,aAAa,CAAC,CAAC,OAAO,mCAAmC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/E,iBAAiB,CAAC,EAAE,aAAa,CAC/B,CAAC,OAAO,mCAAmC,CAAC,CAAC,mBAAmB,CAAC,CAClE,CAAC;CACH;AAID,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;CACf;AAeD,qBAAa,0BAA2B,SAAQ,gBAAgB;IAC9D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAM1C;AAsBD,eAAO,MAAM,oBAAoB;;;mBAOf,2BAA2B,GAAQ,kBAAkB;CAUtE,CAAC;AAaF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,oBAAoB,GAAG,sBAAsB,CAS7F"}
+{"version":3,"file":"cloud-dashboard-plugin.d.ts","sourceRoot":"","sources":["../src/cloud-dashboard-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAMjE,eAAO,MAAM,2BAA2B,cAAc,CAAC;AAGvD,eAAO,MAAM,uBAAuB,cAAc,CAAC;AAInD,eAAO,MAAM,mCAAmC;;;CAKtC,CAAC;AAEX,MAAM,WAAW,2BAA2B;IAE1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,aAAa,CAAC,CAAC,OAAO,mCAAmC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/E,iBAAiB,CAAC,EAAE,aAAa,CAC/B,CAAC,OAAO,mCAAmC,CAAC,CAAC,mBAAmB,CAAC,CAClE,CAAC;CACH;AAGD,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;CACf;AAaD,qBAAa,0BAA2B,SAAQ,gBAAgB;IAC9D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAM1C;AAmBD,eAAO,MAAM,oBAAoB;;;mBAOf,2BAA2B,GAAQ,kBAAkB;CAUtE,CAAC;AAOF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,oBAAoB,GAAG,sBAAsB,CAS7F"}

package/dist/cloud-dashboard-plugin.js

@@ -1,29 +1,23 @@
 import { declareCloudPlugin, listCloudPluginDeclarations } from "./cloud-plugin-declaration.js";
 import { CloudConfigError } from "./errors.js";
 // ADR-0044 rules `DashboardPlugin` platform-supplied and wrapped, with `route` the only option the
-// customer keeps. This is the wrapper's declaration side: what a customer writes in their
-// configuration file. The plugin that serves the Dashboard is built by the platform runtime, which
-// is the only place that knows where the managed build put the Dashboard's files.
+// customer keeps. This file is the declaration side; the platform runtime builds the plugin that
+// serves the Dashboard.
 export const CLOUD_DASHBOARD_PLUGIN_KIND = "dashboard";
-// The same default the upstream plugin documents, so a customer moving an existing store onto
-// Vendure Cloud finds the Dashboard where they left it.
+// The upstream plugin's documented default.
 export const DEFAULT_DASHBOARD_ROUTE = "dashboard";
-// The two options that leave the type, with the explanation each one's build-time error carries.
-// Written as literals rather than assembled, for the reason `platform-fields.ts` records: the
-// explanation is what TypeScript prints when the field is set, so it is the message and not a key
-// into one.
+// Options removed from the customer type, each with the explanation its build-time error prints.
+// Literals, for the reason given in `platform-fields.ts`.
 export const PLATFORM_SUPPLIED_DASHBOARD_OPTIONS = {
     appDir: "The Dashboard's files are produced by the managed build, and Vendure Cloud tells the plugin where they are. A path set here would not exist in the runtime image. Remove appDir.",
     viteDevServerPort: "The Vite dev server does not run in a Vendure Cloud process, so there is nothing to probe for and no request is proxied to it. Remove viteDevServerPort. It still applies when you run the same configuration locally.",
 };
 const DEFAULT_DASHBOARD_SETTINGS = { route: DEFAULT_DASHBOARD_ROUTE };
-// The route is one path segment. Nest mounts the Dashboard's middleware at it, and the Dashboard's
-// own `index.html` carries it as a `<base>` tag, so a value with a slash in it produces a mount
-// path and a base tag that disagree and a Dashboard that loads nothing. Starting at a letter or a
-// digit rules out `.` and `..`, which resolve to somewhere else again.
+// One path segment. Nest mounts the Dashboard's middleware at the route and `index.html` carries it
+// as a `<base>` tag; a slash makes the two disagree and the Dashboard loads nothing. Starting with
+// a letter or digit rules out `.` and `..`.
 const ROUTE_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._~-]*$/;
-// Vendure's own defaults for the two API paths, restated because a Cloud Config that sets neither
-// still serves them there and this check runs before core has filled them in.
+// Vendure's defaults for the two API paths; this check runs before core fills them in.
 const DEFAULT_ADMIN_API_PATH = "admin-api";
 const DEFAULT_SHOP_API_PATH = "shop-api";
 export class InvalidDashboardRouteError extends CloudConfigError {
@@ -33,9 +27,8 @@ export class InvalidDashboardRouteError extends CloudConfigError {
         this.route = route;
     }
 }
-// Runs where the customer wrote the route, so the message arrives before anything is deployed.
-// Nothing in the type system can reach this: `route` is an ordinary string and the values it
-// rejects are ordinary strings too.
+// Runs where the customer wrote the route, so the error arrives before anything is deployed. The
+// type system cannot reach it: both the route and the values it rejects are plain strings.
 function assertRouteShape(route) {
     if (route.length === 0) {
         throw new InvalidDashboardRouteError(route, "The route is empty.");
@@ -44,11 +37,9 @@ function assertRouteShape(route) {
         throw new InvalidDashboardRouteError(route, "A route is one path segment: letters, digits, and then any of . _ ~ - after the first character. Slashes, spaces and a leading dot are not part of one.");
     }
 }
-// A class carrying the default declaration, with `init` on it. A customer who moves the Dashboard
-// writes `CloudDashboardPlugin.init({ route })`; one who wants the default route but wants the
-// Dashboard visible in their file can write a bare `CloudDashboardPlugin`. The second is
-// redundant, because the platform injects the default declaration when the customer writes
-// neither, and it is supported so that writing it is not read as a plugin nobody recognises.
+// A bare `CloudDashboardPlugin` is the default declaration and `.init({ route })` moves the
+// Dashboard. The platform injects the default when neither is written, so the bare form only makes
+// the Dashboard visible in the file.
 export const CloudDashboardPlugin = Object.assign(declareCloudPlugin("CloudDashboardPlugin", CLOUD_DASHBOARD_PLUGIN_KIND, DEFAULT_DASHBOARD_SETTINGS), {
     init(options = {}) {
         const route = options.route ?? DEFAULT_DASHBOARD_ROUTE;
@@ -56,17 +47,11 @@ export const CloudDashboardPlugin = Object.assign(declareCloudPlugin("CloudDashb
         return declareCloudPlugin("CloudDashboardPlugin", CLOUD_DASHBOARD_PLUGIN_KIND, { route });
     },
 });
-// ADR-0044's rule that a wrapped plugin the customer declared replaces the platform's injected
-// default rather than joining it: the customer's declaration when there is one, the default when
-// there is not, and never both.
+// ADR-0044: a customer declaration replaces the platform's injected default. With several
+// declarations the last wins, as in the upstream plugin's static options; ADR-0044 treats a double
+// declaration as a documentation problem.
 //
-// A configuration declaring it more than once takes the last, which is what the upstream plugin's
-// static options do and therefore what a customer who has met that plugin expects. ADR-0044 calls a
-// double declaration a documentation problem rather than something to defend against, so this
-// resolves it quietly rather than refusing the boot over it.
-//
-// It takes the whole configuration rather than the plugins array, because the route has to be
-// checked against the paths the customer's own API options claim.
+// Takes the whole configuration because the route is checked against the customer's API paths.
 export function resolveDashboardSettings(config) {
     const declarations = listCloudPluginDeclarations(config.plugins, CLOUD_DASHBOARD_PLUGIN_KIND);
     const settings = declarations[declarations.length - 1] ?? { options: DEFAULT_DASHBOARD_SETTINGS };
@@ -74,9 +59,8 @@ export function resolveDashboardSettings(config) {
     assertRouteIsFree(settings.options.route, config);
     return settings.options;
 }
-// A route matching an API path is served by whichever of the two Nest matches first, so the
-// customer loses one of them with nothing said. Checked here rather than in `init`, because it is
-// the only point at which the route and the API paths are both known.
+// A route equal to an API path is served by whichever Nest matches first, so one of the two is
+// lost silently. Checked here because only here are the route and the API paths both known.
 function assertRouteIsFree(route, config) {
     const claimed = [
         ["the Admin API", config.apiOptions?.adminApiPath ?? DEFAULT_ADMIN_API_PATH],

package/dist/cloud-dashboard-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"cloud-dashboard-plugin.js","sourceRoot":"","sources":["../src/cloud-dashboard-plugin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cloud-dashboard-plugin.js","sourceRoot":"","sources":["../src/cloud-dashboard-plugin.ts"],"names":[],"mappings":"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"}

package/dist/cloud-plugin-declaration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloud-plugin-declaration.d.ts","sourceRoot":"","sources":["../src/cloud-plugin-declaration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAkB1D,MAAM,WAAW,sBAAsB,CAAC,OAAO,GAAG,OAAO;IAGvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAMD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;;EAWvF;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,GAAG,SAAS,CAK7F;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEhE;AAKD,wBAAgB,2BAA2B,CAAC,OAAO,EACjD,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,IAAI,EAAE,MAAM,GACX,sBAAsB,CAAC,OAAO,CAAC,EAAE,CASnC"}
+{"version":3,"file":"cloud-plugin-declaration.d.ts","sourceRoot":"","sources":["../src/cloud-plugin-declaration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAgB1D,MAAM,WAAW,sBAAsB,CAAC,OAAO,GAAG,OAAO;IAEvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAMD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;;EAUvF;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,GAAG,SAAS,CAK7F;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEhE;AAGD,wBAAgB,2BAA2B,CAAC,OAAO,EACjD,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,IAAI,EAAE,MAAM,GACX,sBAAsB,CAAC,OAAO,CAAC,EAAE,CASnC"}

package/dist/cloud-plugin-declaration.js

@@ -1,30 +1,27 @@
-// How a customer declares a wrapped platform plugin (ADR-0044, shape 2). What they write is not
-// the plugin that runs. The plugin that runs needs `@vendure/core` and the platform's own values,
-// and build tooling imports the configuration file where neither is available. So
-// `CloudDashboardPlugin.init({ route })` returns a marker carrying the options and nothing else,
-// and the platform runtime builds the plugin that implements it during composition.
+// How a customer declares a wrapped platform plugin (ADR-0044, shape 2). The plugin that runs needs
+// `@vendure/core` and the platform's values, and build tooling imports the configuration file where
+// neither exists. So `CloudDashboardPlugin.init({ route })` returns a marker carrying only the
+// options, and the platform runtime builds the real plugin during composition.
 //
-// The marker is a class rather than a plain object so that it is an ordinary member of the plugins
-// array. It satisfies `VendurePluginEntry`, it reads as a plugin in the file, and the extension
-// flattening and the attribution wrapping walk past it without a special case. Composition removes
-// it before core sees it.
+// The marker is a class so it is an ordinary member of the plugins array: it satisfies
+// `VendurePluginEntry` and extension flattening and attribution wrapping pass over it. Composition
+// removes it before core sees it.
 //
-// Registered rather than a module-local symbol, for the reason the config handle's symbol is
-// (ADR-0043): a second copy of this package in the tree would otherwise produce markers the
-// composing copy does not recognise, and the customer's declared route would be silently ignored.
+// The symbol is registered, as the config handle's is (ADR-0043). With a second copy of this
+// package in the tree, a module-local symbol would give markers the composing copy does not
+// recognise, and the customer's route would be ignored silently.
 const DECLARATION = Symbol.for("vendure-cloud.cloud-plugin-declaration");
-// The return type is inferred rather than written as `VendurePluginEntry`, so a caller can add a
-// static `init` to the result and still have an ordinary member of the plugins array.
+// The return type is inferred so a caller can add a static `init` and keep an ordinary plugins
+// array member.
 export function declareCloudPlugin(name, kind, options) {
-    // Named through a computed key because a class expression takes its name from the binding it is
-    // assigned to, and this one is returned rather than assigned. The name reaches boot messages and
-    // build logs, and `pluginName` reports a class without one as "an anonymous plugin".
+    // A class expression takes its name from its binding, and this one is returned, so the name is
+    // set through a computed key. It reaches boot messages and build logs; `pluginName` reports a
+    // class without one as "an anonymous plugin".
     const marker = { [name]: class {
         } }[name];
     const declaration = { kind, options };
-    // Non-enumerable, so the marker spreads and serialises as an ordinary empty class. A visible
-    // property would appear in anything that inspects the plugins array — a build log, a diagnostic
-    // dump — as configuration the customer did not write.
+    // Non-enumerable, so the marker spreads and serialises as an empty class and inspecting the
+    // plugins array shows no configuration the customer did not write.
     Object.defineProperty(marker, DECLARATION, { value: declaration });
     return marker;
 }
@@ -37,9 +34,7 @@ export function readCloudPluginDeclaration(entry) {
 export function isCloudPluginDeclaration(entry) {
     return readCloudPluginDeclaration(entry) !== undefined;
 }
-// The declarations of one kind, in the order the customer wrote them. The platform runtime reads
-// these to build the plugins that implement them, and composition drops the markers from the array
-// it hands core.
+// The declarations of one kind, in the order the customer wrote them.
 export function listCloudPluginDeclarations(plugins, kind) {
     const declarations = [];
     for (const plugin of plugins) {

package/dist/cloud-plugin-declaration.js.map

@@ -1 +1 @@
-{"version":3,"file":"cloud-plugin-declaration.js","sourceRoot":"","sources":["../src/cloud-plugin-declaration.ts"],"names":[],"mappings":"AAEA,gGAAgG;AAChG,kGAAkG;AAClG,kFAAkF;AAClF,iGAAiG;AACjG,oFAAoF;AACpF,EAAE;AACF,mGAAmG;AACnG,gGAAgG;AAChG,mGAAmG;AACnG,0BAA0B;AAC1B,EAAE;AACF,6FAA6F;AAC7F,4FAA4F;AAC5F,kGAAkG;AAClG,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;AAWzE,iGAAiG;AACjG,sFAAsF;AACtF,MAAM,UAAU,kBAAkB,CAAU,IAAY,EAAE,IAAY,EAAE,OAAgB;IACtF,gGAAgG;IAChG,iGAAiG;IACjG,qFAAqF;IACrF,MAAM,MAAM,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE;SAAQ,EAAE,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAoC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACvE,6FAA6F;IAC7F,gGAAgG;IAChG,sDAAsD;IACtD,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;IACnE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAAc;IACvD,IAAI,OAAO,KAAK,KAAK,UAAU,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,EAAE,CAAC;QACjF,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAQ,KAA2B,CAAC,WAAW,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,OAAO,0BAA0B,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC;AACzD,CAAC;AAED,iGAAiG;AACjG,mGAAmG;AACnG,iBAAiB;AACjB,MAAM,UAAU,2BAA2B,CACzC,OAA8B,EAC9B,IAAY;IAEZ,MAAM,YAAY,GAAsC,EAAE,CAAC;IAC3D,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,WAAW,GAAG,0BAA0B,CAAC,MAAM,CAAC,CAAC;QACvD,IAAI,WAAW,EAAE,IAAI,KAAK,IAAI,EAAE,CAAC;YAC/B,YAAY,CAAC,IAAI,CAAC,WAA8C,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC"}
+{"version":3,"file":"cloud-plugin-declaration.js","sourceRoot":"","sources":["../src/cloud-plugin-declaration.ts"],"names":[],"mappings":"AAEA,oGAAoG;AACpG,oGAAoG;AACpG,+FAA+F;AAC/F,+EAA+E;AAC/E,EAAE;AACF,uFAAuF;AACvF,mGAAmG;AACnG,kCAAkC;AAClC,EAAE;AACF,6FAA6F;AAC7F,4FAA4F;AAC5F,iEAAiE;AACjE,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;AAUzE,+FAA+F;AAC/F,gBAAgB;AAChB,MAAM,UAAU,kBAAkB,CAAU,IAAY,EAAE,IAAY,EAAE,OAAgB;IACtF,+FAA+F;IAC/F,8FAA8F;IAC9F,8CAA8C;IAC9C,MAAM,MAAM,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE;SAAQ,EAAE,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAoC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACvE,4FAA4F;IAC5F,mEAAmE;IACnE,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;IACnE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAAc;IACvD,IAAI,OAAO,KAAK,KAAK,UAAU,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,EAAE,CAAC;QACjF,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAQ,KAA2B,CAAC,WAAW,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,OAAO,0BAA0B,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC;AACzD,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,2BAA2B,CACzC,OAA8B,EAC9B,IAAY;IAEZ,MAAM,YAAY,GAAsC,EAAE,CAAC;IAC3D,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,WAAW,GAAG,0BAA0B,CAAC,MAAM,CAAC,CAAC;QACvD,IAAI,WAAW,EAAE,IAAI,KAAK,IAAI,EAAE,CAAC;YAC/B,YAAY,CAAC,IAAI,CAAC,WAA8C,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/composition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"composition.d.ts","sourceRoot":"","sources":["../src/composition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAChG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAAE,KAAK,iBAAiB,EAAmB,MAAM,0BAA0B,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAE5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,KAAK,UAAU,EAIhB,MAAM,yBAAyB,CAAC;AAMjC,eAAO,MAAM,0BAA0B,WAAW,CAAC;AAKnD,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC,CAAC;AAEnF,wBAAgB,0BAA0B,CAAC,oBAAoB,EAAE,OAAO,GAAG,mBAAmB,CAS7F;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,YAAY,EAAE,SAAS,UAAU,EAAE,CAAC;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,CAAC,QAAQ,EAAE,qBAAqB,KAAK,cAAc,CAAC;CACpE;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,aAAa,CAAC;IAC7B,WAAW,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,oBAAoB,KAAK,aAAa,CAAC;CACrF;AAQD,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,oBAAoB,GAAG,aAAa,EAC5C,OAAO,EAAE,uBAAuB,GAC/B,aAAa,CAEf;AAKD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,yBAAyB,GACjC,aAAa,CA8Cf;AAuBD,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,SAAS,UAAU,EAAE,EACtC,YAAY,EAAE,SAAS,UAAU,EAAE,GAClC,UAAU,EAAE,CAGd;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAMrF;AAQD,qBAAa,6BAA8B,SAAQ,gBAAgB;IACjE,QAAQ,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC;gBAEnC,MAAM,EAAE,SAAS,kBAAkB,EAAE;CASlD;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAU3F"}
+{"version":3,"file":"composition.d.ts","sourceRoot":"","sources":["../src/composition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAChG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAAE,KAAK,iBAAiB,EAAmB,MAAM,0BAA0B,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAE5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,KAAK,UAAU,EAIhB,MAAM,yBAAyB,CAAC;AAKjC,eAAO,MAAM,0BAA0B,WAAW,CAAC;AAInD,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC,CAAC;AAEnF,wBAAgB,0BAA0B,CAAC,oBAAoB,EAAE,OAAO,GAAG,mBAAmB,CAS7F;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,YAAY,EAAE,SAAS,UAAU,EAAE,CAAC;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,CAAC,QAAQ,EAAE,qBAAqB,KAAK,cAAc,CAAC;CACpE;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,aAAa,CAAC;IAC7B,WAAW,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,oBAAoB,KAAK,aAAa,CAAC;CACrF;AAOD,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,oBAAoB,GAAG,aAAa,EAC5C,OAAO,EAAE,uBAAuB,GAC/B,aAAa,CAEf;AAID,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,yBAAyB,GACjC,aAAa,CA4Cf;AAqBD,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,SAAS,UAAU,EAAE,EACtC,YAAY,EAAE,SAAS,UAAU,EAAE,GAClC,UAAU,EAAE,CAGd;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAMrF;AAKD,qBAAa,6BAA8B,SAAQ,gBAAgB;IACjE,QAAQ,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC;gBAEnC,MAAM,EAAE,SAAS,kBAAkB,EAAE;CASlD;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAU3F"}

package/dist/composition.js

@@ -5,41 +5,37 @@ import { readPath } from "./path.js";
 import { PLATFORM_OWNED_FIELDS, formatPlatformFieldDetail, } from "./platform-fields.js";
 import { assertNoCustomerPluginWroteAPlatformField, pluginName, recordPlatformFieldWrites, } from "./plugin-attribution.js";
 import { assertNoSupersededPluginDeclared } from "./superseded-plugins.js";
-// The Vendure versions a Cloud Plugin declares itself compatible with. One name because the
-// platform's plugins have to move together: a wrapper built for a version core no longer accepts
-// is refused at boot, and finding out one plugin at a time is the slow way to learn it.
+// The Vendure versions a Cloud Plugin declares itself compatible with. Shared so the platform's
+// plugins move together; core refuses at boot a plugin built for a version it does not accept.
 export const CLOUD_PLUGIN_COMPATIBILITY = "^3.7.0";
 export function platformDefaultFieldValues(sessionCacheStrategy) {
     return {
         "authOptions.sessionCacheStrategy": sessionCacheStrategy,
-        // Five minutes avoids a database read on every authenticated request without making a revoked
-        // session linger for an operationally surprising interval.
+        // Five minutes avoids a database read on every authenticated request; a revoked session lingers
+        // at most that long.
         "authOptions.sessionCacheTTL": 300,
         "systemOptions.healthChecks": [],
         "schedulerOptions.runTasksInWorkerOnly": false,
     };
 }
-// The Dashboard compiler reads API and authentication settings before Vendure boots, so it never
-// receives the defaults Vendure normally applies or changes made later by plugin configuration.
-// Some defaults are platform-owned runtime values, but they remain inert here because compiling a
-// Dashboard boots no services; managed composition has already replaced its database value.
-// FlattenedCloudConfig brands platform-owned fields and cannot be assigned to PartialVendureConfig,
-// even though defineCloudConfig has already refused those fields before producing the handle.
+// The Dashboard compiler reads API and authentication settings before Vendure boots, so it gets
+// neither Vendure's defaults nor later plugin changes. Platform-owned defaults are inert here:
+// compiling a Dashboard boots no services, and managed composition has replaced the database value.
+// The cast is needed because FlattenedCloudConfig brands platform-owned fields and is not
+// assignable to PartialVendureConfig; defineCloudConfig has already refused those fields.
 export function mergeDashboardConfigWithDefaults(config, options) {
     return options.mergeConfig(options.defaultConfig, config);
 }
-// The one composition boundary shared by the local and managed runtimes. The caller supplies the
-// decorator from its own copy of Vendure core; keeping that value out of this package's imports is
-// what prevents the Cloud Config interface from loading a second copy of core.
+// The composition boundary shared by the local and managed runtimes. The caller supplies the
+// decorator from its own copy of Vendure core so this package never loads a second copy.
 export function composeCloudConfig(handle, options) {
     const contents = readCloudConfig(handle);
     const declaredPlugins = [...contents.config.plugins];
-    // Before anything else composition does, because a customer who declared a plugin the platform
-    // supplies should read that message rather than one about a field their plugin went on to write.
+    // First, so a customer who declared a plugin the platform supplies reads that message and not one
+    // about a field their plugin wrote.
     assertNoSupersededPluginDeclared(declaredPlugins, contents.extensionOf);
-    // A Cloud Plugin declaration is a marker carrying the customer's options, not a plugin core can
-    // run. The caller has already read the options out of the array and built the plugins that
-    // implement them, so the markers are removed here.
+    // A Cloud Plugin declaration is a marker, not a plugin core can run. The caller has already built
+    // the plugins that implement them, so the markers are removed here.
     const customerPlugins = declaredPlugins.filter((plugin) => !isCloudPluginDeclaration(plugin));
     const pendingWrites = recordPlatformFieldWrites(customerPlugins, contents.extensionOf);
     const cloudPluginNames = options.cloudPlugins.map(pluginName);
@@ -52,8 +48,7 @@ export function composeCloudConfig(handle, options) {
         configuration: (runtimeConfig) => {
             assertNoCustomerPluginWroteAPlatformField(pendingWrites.writes, cloudPluginNames);
             // Vendure merges the caller's config over its defaults before plugin configuration runs. Keep
-            // the entity catalog and other defaults it added while making the platform connection values
-            // authoritative at the final boundary.
+            // the entity catalog and other defaults it added; the platform connection values win here.
             values.dbConnectionOptions = {
                 ...copyObject(runtimeConfig.dbConnectionOptions),
                 ...copyObject(values.dbConnectionOptions),
@@ -89,11 +84,9 @@ function writePath(target, path, value) {
     }
     current[leaf] = value;
 }
-// ADR-0017 requires Cloud Plugins to run last: core runs the configuration chain in array
-// order, so the last write wins for the fields Vendure Cloud owns. The hoist is
-// unconditional, so a Cloud Plugin the customer declared early still runs last. Its written
-// position therefore does not predict when it runs, which this comment records and no type
-// prevents.
+// ADR-0017: Cloud Plugins run last, so the last write wins for the fields Vendure Cloud owns (core
+// runs the configuration chain in array order). The hoist is unconditional: a Cloud Plugin declared
+// early still runs last.
 export function hoistCloudPluginsLast(customerPlugins, cloudPlugins) {
     const cloud = new Set(cloudPlugins);
     return [...customerPlugins.filter((plugin) => !cloud.has(plugin)), ...cloudPlugins];
@@ -106,12 +99,9 @@ export function applyPlatformFields(config, values) {
         writePath(target, path, value);
     }
 }
-// ADR-0017's forward assertion: after composition, the fields Vendure Cloud owns must still
-// hold the values it set. This catches a plugin that rewrote one of them after the Cloud
-// Plugin ran, which the ordering rule alone cannot prevent.
-//
-// Scoped to the specific paths rather than whole option objects, because a customer adding
-// TypeORM `extra` options or an entity subscriber alongside is legitimate.
+// ADR-0017's forward assertion: after composition, platform-owned fields must hold the values the
+// platform set. It catches a plugin that rewrote one after the Cloud Plugin ran. Scoped to specific
+// paths because a customer adding TypeORM `extra` options or an entity subscriber is legitimate.
 export class PlatformFieldOverwrittenError extends CloudConfigError {
     fields;
     constructor(fields) {

package/dist/composition.js.map

@@ -1 +1 @@
-{"version":3,"file":"composition.js","sourceRoot":"","sources":["../src/composition.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"composition.js","sourceRoot":"","sources":["../src/composition.ts"],"names":[],"mappings":"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"}

package/dist/define-cloud-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-cloud-config.d.ts","sourceRoot":"","sources":["../src/define-cloud-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,KAAK,eAAe,EAA2B,MAAM,iBAAiB,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,EAAE,KAAK,gBAAgB,EAA4B,MAAM,wBAAwB,CAAC;AAMzF,QAAA,MAAM,MAAM,eAA4C,CAAC;AAMzD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACjD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;IAMhE,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAAC;CACpE;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;CACxC,CAAC;AASF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,CAyBxE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAE9E;AAGD,wBAAgB,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,mBAAmB,CAE9E"}
+{"version":3,"file":"define-cloud-config.d.ts","sourceRoot":"","sources":["../src/define-cloud-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,KAAK,eAAe,EAA2B,MAAM,iBAAiB,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,EAAE,KAAK,gBAAgB,EAA4B,MAAM,wBAAwB,CAAC;AAKzF,QAAA,MAAM,MAAM,eAA4C,CAAC;AAKzD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACjD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;IAKhE,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAAC;CACpE;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;CACxC,CAAC;AAOF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,CAuBxE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAE9E;AAGD,wBAAgB,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,mBAAmB,CAE9E"}

package/dist/define-cloud-config.js

@@ -2,31 +2,26 @@ import { loadExtensionMigrations } from "./migrations.js";
 import { PlatformFieldSetByConfigError, listPlatformOwnedFieldsSetIn } from "./runtime-backstop.js";
 import { assertNoMissingSecrets } from "./secrets.js";
 import { flattenVendureExtensions } from "./vendure-extension.js";
-// Registered rather than a module-local symbol, so the platform loader can read a handle
-// produced by a different copy of this package. ADR-0043 guards against a second copy of
-// @vendure/core at boot; this makes a second copy of the interface package survivable
-// instead of producing a handle the loader silently fails to recognise.
+// Registered so the platform loader can read a handle produced by another copy of this package.
+// ADR-0043 guards against a second copy of @vendure/core at boot; this covers a second copy of the
+// interface package.
 const HANDLE = Symbol.for("vendure-cloud.config-handle");
-// Returns an opaque handle rather than a composed VendureConfig. Returning the composed
-// config would hand back every field the input type takes away (ADR-0043), and composing
-// eagerly would mean that merely importing the config file acquires live resources —
-// the database connection's token refresher is a timer.
+// Returns an opaque handle and not a composed VendureConfig. A composed config would hand back
+// every field the input type takes away (ADR-0043), and composing here would make importing the
+// config file acquire live resources: the database connection's token refresher is a timer.
 //
-// Flattening the extensions is not composition and happens here: it reads the array and
-// acquires nothing.
+// Flattening extensions reads the array and acquires nothing, so it happens here.
 export function defineCloudConfig(config) {
     const platformOwned = listPlatformOwnedFieldsSetIn(config);
     if (platformOwned.length > 0) {
         throw new PlatformFieldSetByConfigError(platformOwned);
     }
-    // Every `secret()` call in the argument above has already run by the time this does — the
-    // object is built before the call. So this is the first point at which the whole declared
-    // set is known, which is what lets the failure name every unset secret at once instead of
-    // the first one (CLO-411).
+    // The argument object is built before this call, so every `secret()` in it has run. This is the
+    // first point where the whole declared set is known, so the failure can name every unset secret
+    // at once (CLO-411).
     assertNoMissingSecrets();
     const { plugins, extensions, extensionOf } = flattenVendureExtensions(config.plugins ?? []);
-    // Composition mutates the configuration object it is given, so the customer's own object
-    // is copied rather than written into.
+    // Composition mutates the configuration object, so the customer's object is copied.
     const flattened = { ...config, plugins: [...plugins] };
     return {
         [HANDLE]: {
@@ -40,7 +35,7 @@ export function defineCloudConfig(config) {
 export function isCloudConfigHandle(value) {
     return typeof value === "object" && value !== null && HANDLE in value;
 }
-// The platform entrypoint's accessor. Not part of the surface a customer uses.
+// The platform entrypoint's accessor, outside the customer-facing surface.
 export function readCloudConfig(handle) {
     return handle[HANDLE];
 }