@vendure/cloud-config 0.0.0 → 0.2.0

package/README.md

@@ -253,8 +253,9 @@ how the build happens to be written. A bundler is the route back to a second cop
 `@vendure/core`, and a minifier rewrites the class names that `CloudConfigError` and
 `pluginName` read at runtime to build the messages ADR-0044 requires. `tsc` can do neither,
 and `packages/cloud/test/published-output.test.ts` builds every publishable package and
-asserts it: one emitted file per source file, every dependency still a bare import, and every
-exported class still carrying its own name.
+asserts it: one emitted file per source file, every dependency still a bare import, every
+exported class still carrying its own name, and the entry point's import loading no more of the
+module graph than a stated budget.
 
 Read ADR-0045's packaging decision only. Its delivery decision — that the customer pins these
 packages in their own lockfile and the platform reports a vulnerable version rather than

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

@@ -0,0 +1,27 @@
+import type { AssetServerOptions } from "@vendure/asset-server-plugin";
+import type { FlattenedCloudConfig, PlatformOwned } from "./cloud-config.js";
+import type { VendurePluginEntry } from "./vendure-extension.js";
+export declare const CLOUD_ASSET_SERVER_PLUGIN_KIND = "asset-server";
+export declare const CLOUD_ASSET_ROUTE = "assets";
+export declare const MAX_IMAGE_TRANSFORM_DIMENSION = 6000;
+export declare const PLATFORM_SUPPLIED_ASSET_SERVER_OPTIONS: {
+    readonly 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.";
+    readonly assetUploadDir: "The upload directory is inside the runtime image, which is the only place the process may write. Remove assetUploadDir.";
+    readonly assetUrlPrefix: "Asset URLs are built by Vendure Cloud from the host each request arrived on, so a store reached on its custom domain serves asset URLs on that domain. A fixed prefix here would pin every asset URL to one hostname. Remove assetUrlPrefix.";
+    readonly 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.";
+};
+export type CustomerAssetServerOptions = Omit<AssetServerOptions, keyof typeof PLATFORM_SUPPLIED_ASSET_SERVER_OPTIONS>;
+export type CloudAssetServerPluginOptions = CustomerAssetServerOptions & {
+    storageStrategyFactory?: PlatformOwned<(typeof PLATFORM_SUPPLIED_ASSET_SERVER_OPTIONS)["storageStrategyFactory"]>;
+    assetUploadDir?: PlatformOwned<(typeof PLATFORM_SUPPLIED_ASSET_SERVER_OPTIONS)["assetUploadDir"]>;
+    assetUrlPrefix?: PlatformOwned<(typeof PLATFORM_SUPPLIED_ASSET_SERVER_OPTIONS)["assetUrlPrefix"]>;
+    route?: PlatformOwned<(typeof PLATFORM_SUPPLIED_ASSET_SERVER_OPTIONS)["route"]>;
+};
+export type CloudAssetServerSettings = CustomerAssetServerOptions;
+export declare const CloudAssetServerPlugin: {
+    new (): {};
+} & {
+    init(options?: CloudAssetServerPluginOptions): VendurePluginEntry;
+};
+export declare function resolveAssetServerSettings(config: FlattenedCloudConfig): CloudAssetServerSettings;
+//# sourceMappingURL=cloud-asset-server-plugin.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,68 @@
+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.
+//
+// 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.
+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.
+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.
+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
+// 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.",
+    assetUploadDir: "The upload directory is inside the runtime image, which is the only place the process may write. Remove assetUploadDir.",
+    assetUrlPrefix: "Asset URLs are built by Vendure Cloud from the host each request arrived on, so a store reached on its custom domain serves asset URLs on that domain. A fixed prefix here would pin every asset URL to one hostname. Remove assetUrlPrefix.",
+    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.
+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.
+function withoutPlatformSuppliedOptions(options) {
+    const customer = { ...options };
+    for (const name of PLATFORM_SUPPLIED_OPTION_NAMES) {
+        delete customer[name];
+    }
+    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.
+export function resolveAssetServerSettings(config) {
+    const declarations = listCloudPluginDeclarations(config.plugins, CLOUD_ASSET_SERVER_PLUGIN_KIND);
+    return declarations[declarations.length - 1]?.options ?? {};
+}
+//# sourceMappingURL=cloud-asset-server-plugin.js.map

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

@@ -0,0 +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"}

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export { PLATFORM_OWNED_FIELDS, findPlatformOwnedField, type PlatformOwnedField,
 export { PlatformFieldSetByConfigError, listPlatformOwnedFieldsSetIn, } from "./runtime-backstop.js";
 export { PlatformFieldSetByPluginError, PLUGIN_CONFIGURATION_METADATA_KEY, assertNoCustomerPluginWroteAPlatformField, pluginName, recordPlatformFieldWrites, type ExtensionOfPlugin, type PendingPlatformFieldWrites, type PlatformFieldWrite, type PluginConstructor, type PluginLike, } from "./plugin-attribution.js";
 export { CLOUD_PLUGIN_COMPATIBILITY, composeCloudConfig, PlatformFieldOverwrittenError, applyPlatformFields, assertPlatformFieldsHold, hoistCloudPluginsLast, platformDefaultFieldValues, type ComposeCloudConfigOptions, type PlatformFieldValues, } from "./composition.js";
+export { CLOUD_ASSET_ROUTE, CLOUD_ASSET_SERVER_PLUGIN_KIND, CloudAssetServerPlugin, MAX_IMAGE_TRANSFORM_DIMENSION, PLATFORM_SUPPLIED_ASSET_SERVER_OPTIONS, resolveAssetServerSettings, type CloudAssetServerPluginOptions, type CloudAssetServerSettings, type CustomerAssetServerOptions, } from "./cloud-asset-server-plugin.js";
 export { CLOUD_DASHBOARD_PLUGIN_KIND, CloudDashboardPlugin, DEFAULT_DASHBOARD_ROUTE, InvalidDashboardRouteError, PLATFORM_SUPPLIED_DASHBOARD_OPTIONS, resolveDashboardSettings, type CloudDashboardPluginOptions, type CloudDashboardSettings, } from "./cloud-dashboard-plugin.js";
 export { declareCloudPlugin, isCloudPluginDeclaration, listCloudPluginDeclarations, readCloudPluginDeclaration, type CloudPluginDeclaration, } from "./cloud-plugin-declaration.js";
 export { SUPERSEDED_PLUGINS, SupersededPluginDeclaredError, assertNoSupersededPluginDeclared, findSupersededPlugin, type SupersededPlugin, type SupersededPluginDeclaration, } from "./superseded-plugins.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,gCAAgC,EAChC,4BAA4B,EAC5B,sBAAsB,EACtB,kBAAkB,EAClB,0BAA0B,EAC1B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,GACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,yBAAyB,EACzB,qCAAqC,EACrC,8BAA8B,EAC9B,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,GAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,6BAA6B,EAC7B,iCAAiC,EACjC,yCAAyC,EACzC,UAAU,EACV,yBAAyB,EACzB,KAAK,iBAAiB,EACtB,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,UAAU,GAChB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,6BAA6B,EAC7B,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,GACzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,EACpB,uBAAuB,EACvB,0BAA0B,EAC1B,mCAAmC,EACnC,wBAAwB,EACxB,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,GAC5B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,kBAAkB,EAClB,6BAA6B,EAC7B,gCAAgC,EAChC,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,2BAA2B,GACjC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,MAAM,GACP,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,wBAAwB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,gCAAgC,EAChC,4BAA4B,EAC5B,sBAAsB,EACtB,kBAAkB,EAClB,0BAA0B,EAC1B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,GACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,yBAAyB,EACzB,qCAAqC,EACrC,8BAA8B,EAC9B,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,GAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,6BAA6B,EAC7B,iCAAiC,EACjC,yCAAyC,EACzC,UAAU,EACV,yBAAyB,EACzB,KAAK,iBAAiB,EACtB,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,UAAU,GAChB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,6BAA6B,EAC7B,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,GACzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,iBAAiB,EACjB,8BAA8B,EAC9B,sBAAsB,EACtB,6BAA6B,EAC7B,sCAAsC,EACtC,0BAA0B,EAC1B,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,GAChC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,EACpB,uBAAuB,EACvB,0BAA0B,EAC1B,mCAAmC,EACnC,wBAAwB,EACxB,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,GAC5B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,kBAAkB,EAClB,6BAA6B,EAC7B,gCAAgC,EAChC,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,2BAA2B,GACjC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,MAAM,GACP,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,wBAAwB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -5,6 +5,7 @@ export { PLATFORM_OWNED_FIELDS, findPlatformOwnedField, } from "./platform-field
 export { PlatformFieldSetByConfigError, listPlatformOwnedFieldsSetIn, } from "./runtime-backstop.js";
 export { PlatformFieldSetByPluginError, PLUGIN_CONFIGURATION_METADATA_KEY, assertNoCustomerPluginWroteAPlatformField, pluginName, recordPlatformFieldWrites, } from "./plugin-attribution.js";
 export { CLOUD_PLUGIN_COMPATIBILITY, composeCloudConfig, PlatformFieldOverwrittenError, applyPlatformFields, assertPlatformFieldsHold, hoistCloudPluginsLast, platformDefaultFieldValues, } from "./composition.js";
+export { CLOUD_ASSET_ROUTE, CLOUD_ASSET_SERVER_PLUGIN_KIND, CloudAssetServerPlugin, MAX_IMAGE_TRANSFORM_DIMENSION, PLATFORM_SUPPLIED_ASSET_SERVER_OPTIONS, resolveAssetServerSettings, } from "./cloud-asset-server-plugin.js";
 export { CLOUD_DASHBOARD_PLUGIN_KIND, CloudDashboardPlugin, DEFAULT_DASHBOARD_ROUTE, InvalidDashboardRouteError, PLATFORM_SUPPLIED_DASHBOARD_OPTIONS, resolveDashboardSettings, } from "./cloud-dashboard-plugin.js";
 export { declareCloudPlugin, isCloudPluginDeclaration, listCloudPluginDeclarations, readCloudPluginDeclaration, } from "./cloud-plugin-declaration.js";
 export { SUPERSEDED_PLUGINS, SupersededPluginDeclaredError, assertNoSupersededPluginDeclared, findSupersededPlugin, } from "./superseded-plugins.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,GAGhB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,gCAAgC,EAChC,4BAA4B,EAC5B,sBAAsB,EACtB,kBAAkB,EAClB,0BAA0B,GAK3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,yBAAyB,EACzB,qCAAqC,EACrC,8BAA8B,GAI/B,MAAM,iBAAiB,CAAC;AAYzB,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GAGvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,6BAA6B,EAC7B,iCAAiC,EACjC,yCAAyC,EACzC,UAAU,EACV,yBAAyB,GAM1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,6BAA6B,EAC7B,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,GAG3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,EACpB,uBAAuB,EACvB,0BAA0B,EAC1B,mCAAmC,EACnC,wBAAwB,GAGzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,GAE3B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,kBAAkB,EAClB,6BAA6B,EAC7B,gCAAgC,EAChC,oBAAoB,GAGrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,MAAM,GACP,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,wBAAwB,GAIzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,GAGhB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,gCAAgC,EAChC,4BAA4B,EAC5B,sBAAsB,EACtB,kBAAkB,EAClB,0BAA0B,GAK3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,yBAAyB,EACzB,qCAAqC,EACrC,8BAA8B,GAI/B,MAAM,iBAAiB,CAAC;AAYzB,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GAGvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,6BAA6B,EAC7B,iCAAiC,EACjC,yCAAyC,EACzC,UAAU,EACV,yBAAyB,GAM1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,6BAA6B,EAC7B,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,GAG3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,iBAAiB,EACjB,8BAA8B,EAC9B,sBAAsB,EACtB,6BAA6B,EAC7B,sCAAsC,EACtC,0BAA0B,GAI3B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,EACpB,uBAAuB,EACvB,0BAA0B,EAC1B,mCAAmC,EACnC,wBAAwB,GAGzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,GAE3B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,kBAAkB,EAClB,6BAA6B,EAC7B,gCAAgC,EAChC,oBAAoB,GAGrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,MAAM,GACP,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,wBAAwB,GAIzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/superseded-plugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"superseded-plugins.d.ts","sourceRoot":"","sources":["../src/superseded-plugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,UAAU,EAAc,MAAM,yBAAyB,CAAC;AAkB9F,MAAM,WAAW,gBAAgB;IAI/B,MAAM,EAAE,MAAM,CAAC;IAGf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAWD,eAAO,MAAM,kBAAkB,EAAE,SAAS,gBAAgB,EAAqB,CAAC;AAEhF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE/E;AAED,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,gBAAgB,CAAC;IAI7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,6BAA8B,SAAQ,gBAAgB;IACjE,QAAQ,CAAC,YAAY,EAAE,SAAS,2BAA2B,EAAE,CAAC;gBAElD,YAAY,EAAE,SAAS,2BAA2B,EAAE;CAiBjE;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,WAAW,GAAE,iBAA6B,GACzC,IAAI,CAUN"}
+{"version":3,"file":"superseded-plugins.d.ts","sourceRoot":"","sources":["../src/superseded-plugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,UAAU,EAAc,MAAM,yBAAyB,CAAC;AAkB9F,MAAM,WAAW,gBAAgB;IAI/B,MAAM,EAAE,MAAM,CAAC;IAGf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAwBD,eAAO,MAAM,kBAAkB,EAAE,SAAS,gBAAgB,EAAqB,CAAC;AAEhF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE/E;AAED,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,gBAAgB,CAAC;IAI7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,6BAA8B,SAAQ,gBAAgB;IACjE,QAAQ,CAAC,YAAY,EAAE,SAAS,2BAA2B,EAAE,CAAC;gBAElD,YAAY,EAAE,SAAS,2BAA2B,EAAE;CAiBjE;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,WAAW,GAAE,iBAA6B,GACzC,IAAI,CAUN"}

package/dist/superseded-plugins.js

@@ -1,6 +1,18 @@
 import { CloudConfigError } from "./errors.js";
 import { pluginName } from "./plugin-attribution.js";
 const SUPERSEDED_SPECS = [
+    {
+        // The behavioural check cannot see this one. It attributes each write to the class name that
+        // made it, then ignores the names the platform's own plugins carry. The platform serves assets
+        // with the upstream `AssetServerPlugin` itself, configured by `CloudAssetServerPlugin`, so a
+        // customer declaring that plugin writes `assetOptions.assetStorageStrategy` under a name the
+        // check has been told to ignore, and the boot succeeds with their storage strategy discarded.
+        // `DashboardPlugin` is not exposed to this: the platform's plugin is
+        // `CloudDashboardServerPlugin`, which is a different name.
+        plugin: "AssetServerPlugin",
+        replacement: "CloudAssetServerPlugin",
+        reason: "Vendure Cloud stores assets in a bucket it creates for this environment and serves them at /assets. CloudAssetServerPlugin keeps your presets, transform strategies, naming, previews and cache header, and supplies the storage and the URLs.",
+    },
     {
         plugin: "DashboardPlugin",
         replacement: "CloudDashboardPlugin",

package/dist/superseded-plugins.js.map

@@ -1 +1 @@
-{"version":3,"file":"superseded-plugins.js","sourceRoot":"","sources":["../src/superseded-plugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAA2C,UAAU,EAAE,MAAM,yBAAyB,CAAC;AA6B9F,MAAM,gBAAgB,GAAG;IACvB;QACE,MAAM,EAAE,iBAAiB;QACzB,WAAW,EAAE,sBAAsB;QACnC,MAAM,EACJ,oKAAoK;KACvK;CAC6C,CAAC;AAEjD,MAAM,CAAC,MAAM,kBAAkB,GAAgC,gBAAgB,CAAC;AAEhF,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC;AAC7E,CAAC;AAUD,MAAM,OAAO,6BAA8B,SAAQ,gBAAgB;IACxD,YAAY,CAAyC;IAE9D,YAAY,YAAoD;QAC9D,MAAM,MAAM,GAAG,YAAY;aACxB,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE;YACjC,MAAM,KAAK,GACT,SAAS,KAAK,SAAS;gBACrB,CAAC,CAAC,UAAU,CAAC,MAAM;gBACnB,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,+BAA+B,SAAS,IAAI,CAAC;YACvE,OAAO,KAAK,KAAK,uCAAuC,UAAU,CAAC,MAAM,aAAa,UAAU,CAAC,WAAW,WAAW,CAAC;QAC1H,CAAC,CAAC;aACD,IAAI,CAAC,MAAM,CAAC,CAAC;QAChB,KAAK,CACH,8CAA8C,YAAY,CAAC,MAAM,UAC/D,YAAY,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GACnC,qDAAqD,MAAM,IAAI,CAChE,CAAC;QACF,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;CACF;AAED,MAAM,UAAU,gCAAgC,CAC9C,OAA8B,EAC9B,cAAiC,IAAI,GAAG,EAAE;IAE1C,MAAM,YAAY,GAAkC,EAAE,CAAC;IACvD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,oBAAoB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5D,IAAI,CAAC,UAAU;YAAE,SAAS;QAC1B,YAAY,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,6BAA6B,CAAC,YAAY,CAAC,CAAC;IACxD,CAAC;AACH,CAAC"}
+{"version":3,"file":"superseded-plugins.js","sourceRoot":"","sources":["../src/superseded-plugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAA2C,UAAU,EAAE,MAAM,yBAAyB,CAAC;AA6B9F,MAAM,gBAAgB,GAAG;IACvB;QACE,6FAA6F;QAC7F,+FAA+F;QAC/F,6FAA6F;QAC7F,6FAA6F;QAC7F,8FAA8F;QAC9F,qEAAqE;QACrE,2DAA2D;QAC3D,MAAM,EAAE,mBAAmB;QAC3B,WAAW,EAAE,wBAAwB;QACrC,MAAM,EACJ,gPAAgP;KACnP;IACD;QACE,MAAM,EAAE,iBAAiB;QACzB,WAAW,EAAE,sBAAsB;QACnC,MAAM,EACJ,oKAAoK;KACvK;CAC6C,CAAC;AAEjD,MAAM,CAAC,MAAM,kBAAkB,GAAgC,gBAAgB,CAAC;AAEhF,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC;AAC7E,CAAC;AAUD,MAAM,OAAO,6BAA8B,SAAQ,gBAAgB;IACxD,YAAY,CAAyC;IAE9D,YAAY,YAAoD;QAC9D,MAAM,MAAM,GAAG,YAAY;aACxB,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE;YACjC,MAAM,KAAK,GACT,SAAS,KAAK,SAAS;gBACrB,CAAC,CAAC,UAAU,CAAC,MAAM;gBACnB,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,+BAA+B,SAAS,IAAI,CAAC;YACvE,OAAO,KAAK,KAAK,uCAAuC,UAAU,CAAC,MAAM,aAAa,UAAU,CAAC,WAAW,WAAW,CAAC;QAC1H,CAAC,CAAC;aACD,IAAI,CAAC,MAAM,CAAC,CAAC;QAChB,KAAK,CACH,8CAA8C,YAAY,CAAC,MAAM,UAC/D,YAAY,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GACnC,qDAAqD,MAAM,IAAI,CAChE,CAAC;QACF,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;CACF;AAED,MAAM,UAAU,gCAAgC,CAC9C,OAA8B,EAC9B,cAAiC,IAAI,GAAG,EAAE;IAE1C,MAAM,YAAY,GAAkC,EAAE,CAAC;IACvD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,oBAAoB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5D,IAAI,CAAC,UAAU;YAAE,SAAS;QAC1B,YAAY,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,6BAA6B,CAAC,YAAY,CAAC,CAAC;IACxD,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vendure/cloud-config",
-  "version": "0.0.0",
+  "version": "0.2.0",
   "type": "module",
   "description": "The Cloud Config interface a Vendure Cloud application is written against.",
   "license": "MIT",
@@ -52,11 +52,13 @@
     "tinyglobby": "^0.2.15"
   },
   "peerDependencies": {
+    "@vendure/asset-server-plugin": "^3.7.0",
     "@vendure/core": "^3.7.0"
   },
   "devDependencies": {
     "@types/node": "^22.20.0",
     "@vendure-cloud/tsconfig": "workspace:*",
+    "@vendure/asset-server-plugin": "3.7.2",
     "@vendure/core": "3.7.2",
     "typescript": "catalog:",
     "vitest": "^3.2.6"