@vendure/cloud 0.4.0 → 0.5.0-dev.20261016123507.ge07a06e

package/dist/index.js

@@ -1,10 +1,7 @@
-// The one package a Vendure Cloud application installs (ADR-0045). It is a facade: it holds
-// no behaviour of its own, and every name below is re-exported from a package it pins at an
-// exact version. What it re-exports and what is still to join it is in ./README.md.
+// The one package a Vendure Cloud application installs (ADR-0045). It is a facade that re-exports
+// packages pinned at exact versions; ./README.md lists them.
 //
-// `export *` rather than a written-out list, so a name added to the Cloud Config surface
-// reaches a customer without a second edit here that nothing would catch if it were
-// forgotten.
+// `export *` carries a name added to the Cloud Config surface to customers without a second edit.
 export * from "@vendure/cloud-config";
 export { readCloudConfigHandle } from "./cloud-config-module.js";
 export { bootstrapLocalServer, bootstrapLocalWorker, composeLocalConfig, LocalMigrationFailedError, NoDeclaredMigrationsError, runLocalMigrations, } from "./local-runtime.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,4FAA4F;AAC5F,oFAAoF;AACpF,EAAE;AACF,yFAAyF;AACzF,oFAAoF;AACpF,aAAa;AACb,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,yBAAyB,EACzB,yBAAyB,EACzB,kBAAkB,GAEnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,mBAAmB,EACnB,0BAA0B,GAE3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,sBAAsB,EACtB,6BAA6B,GAE9B,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,6DAA6D;AAC7D,EAAE;AACF,kGAAkG;AAClG,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,yBAAyB,EACzB,yBAAyB,EACzB,kBAAkB,GAEnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,mBAAmB,EACnB,0BAA0B,GAE3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,sBAAsB,EACtB,6BAA6B,GAE9B,MAAM,qBAAqB,CAAC"}

package/dist/local-asset-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-asset-server.d.ts","sourceRoot":"","sources":["../src/local-asset-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAqB,KAAK,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAkBzF,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,wBAAwB,EAClC,cAAc,EAAE,MAAM,GACrB,kBAAkB,CAMpB"}
+{"version":3,"file":"local-asset-server.d.ts","sourceRoot":"","sources":["../src/local-asset-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAqB,KAAK,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAYzF,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,wBAAwB,EAClC,cAAc,EAAE,MAAM,GACrB,kBAAkB,CAMpB"}

package/dist/local-asset-server.js

@@ -1,19 +1,13 @@
 import { CLOUD_ASSET_ROUTE } from "@vendure/cloud-config";
-// The local substitute for the asset capability (ADR-0017). The plugin is the upstream
-// `AssetServerPlugin`, the same one the managed runtime composes, so a preset or a transform
-// strategy a customer declared behaves the same in both places. What differs is where the bytes
-// live: a directory inside the project rather than the environment's own bucket.
-// The whole option set the local runtime hands `AssetServerPlugin.init`: the customer's own
-// options, with the two the platform takes written over the top. Written in this order
-// deliberately — a customer's declaration cannot reach those keys through the type, and this is
-// what makes that true of a configuration compiled from JavaScript as well.
+// The local substitute for the asset capability (ADR-0017). It is the upstream `AssetServerPlugin`
+// the managed runtime also composes, with bytes stored in a project directory.
+// The customer's options with `route` and `assetUploadDir` written over them. The spread comes
+// first so a configuration compiled from JavaScript cannot set those two keys either.
 //
-// `route` is the platform's fixed route rather than a local one, so an asset URL a developer sees
-// is the path a deployed store serves the same asset on.
+// `route` is the platform's fixed route, so a local asset URL matches a deployed store's.
 //
-// `storageStrategyFactory` and `assetUrlPrefix` are left unset, which is what selects the plugin's
-// own filesystem storage and its own request-derived URLs. The platform supplies both in a managed
-// process; off-platform there is no bucket to reach and no ingress in front to build a URL from.
+// `storageStrategyFactory` and `assetUrlPrefix` are unset, which selects the plugin's filesystem
+// storage and request-derived URLs. Off-platform there is no bucket or ingress to supply them.
 export function localAssetServerOptions(settings, assetUploadDir) {
     return {
         ...settings,

package/dist/local-asset-server.js.map

@@ -1 +1 @@
-{"version":3,"file":"local-asset-server.js","sourceRoot":"","sources":["../src/local-asset-server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAiC,MAAM,uBAAuB,CAAC;AAEzF,uFAAuF;AACvF,6FAA6F;AAC7F,gGAAgG;AAChG,iFAAiF;AAEjF,4FAA4F;AAC5F,uFAAuF;AACvF,gGAAgG;AAChG,4EAA4E;AAC5E,EAAE;AACF,kGAAkG;AAClG,yDAAyD;AACzD,EAAE;AACF,mGAAmG;AACnG,mGAAmG;AACnG,iGAAiG;AACjG,MAAM,UAAU,uBAAuB,CACrC,QAAkC,EAClC,cAAsB;IAEtB,OAAO;QACL,GAAG,QAAQ;QACX,KAAK,EAAE,iBAAiB;QACxB,cAAc;KACf,CAAC;AACJ,CAAC"}
+{"version":3,"file":"local-asset-server.js","sourceRoot":"","sources":["../src/local-asset-server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAiC,MAAM,uBAAuB,CAAC;AAEzF,mGAAmG;AACnG,+EAA+E;AAE/E,+FAA+F;AAC/F,sFAAsF;AACtF,EAAE;AACF,0FAA0F;AAC1F,EAAE;AACF,iGAAiG;AACjG,+FAA+F;AAC/F,MAAM,UAAU,uBAAuB,CACrC,QAAkC,EAClC,cAAsB;IAEtB,OAAO;QACL,GAAG,QAAQ;QACX,KAAK,EAAE,iBAAiB;QACxB,cAAc;KACf,CAAC;AACJ,CAAC"}

package/dist/local-cache-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-cache-plugin.d.ts","sourceRoot":"","sources":["../src/local-cache-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEpF,OAAO,EAAE,KAAK,oBAAoB,EAA6B,MAAM,kBAAkB,CAAC;AAWxF,eAAO,MAAM,qBAAqB,wBAAwB,CAAC;AA4C3D,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,oBAAoB,GAAG,UAAU,CAc7E"}
+{"version":3,"file":"local-cache-plugin.d.ts","sourceRoot":"","sources":["../src/local-cache-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEpF,OAAO,EAAE,KAAK,oBAAoB,EAA6B,MAAM,kBAAkB,CAAC;AAQxF,eAAO,MAAM,qBAAqB,wBAAwB,CAAC;AAuC3D,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,oBAAoB,GAAG,UAAU,CAc7E"}

package/dist/local-cache-plugin.js

@@ -1,27 +1,22 @@
 import { CLOUD_PLUGIN_COMPATIBILITY } from "@vendure/cloud-config";
 import { RedisCacheStrategy, VendurePlugin } from "@vendure/core";
 import { assertLocalCacheReachable } from "./local-cache.js";
-// The local substitute for the cache capability (ADR-0017). The protocol work is Vendure's own
-// `RedisCacheStrategy`, which stores a value and its tag memberships in one transaction and declares
-// no entity. `PlatformCacheStrategy` is not reused: it is in a private package that already depends
-// on this one, and everything it adds is production infrastructure — a SigV4 IAM token per
-// connection, mandatory TLS, and an RBAC-user key prefix.
-// One namespace, fixed rather than derived, because the separately supervised server and worker
-// each compose their own configuration and have to arrive at the same keyspace. Two projects
-// sharing one server are separated by the connection's database index instead.
+// The local substitute for the cache capability (ADR-0017), built on `RedisCacheStrategy`.
+// `PlatformCacheStrategy` is not reused: it lives in a private package that depends on this one and
+// adds production infrastructure (SigV4 IAM tokens, mandatory TLS, an RBAC-user key prefix).
+// Fixed, because the separately supervised server and worker each compose their own configuration
+// and must share one keyspace. Projects sharing a server are separated by database index.
 export const LOCAL_CACHE_NAMESPACE = "vendure-cloud-local";
-// Vendure's cache service calls this during bootstrap, which is where a cache that is not there has
-// to be reported. The upstream strategy constructs its client and never awaits a connection, so an
-// unreachable server would otherwise surface as a repeating client error and a store that quietly
-// caches nothing.
+// Vendure's cache service calls `init` during bootstrap. The upstream strategy never awaits a
+// connection, so an unreachable server would otherwise show as repeating client errors and a store
+// that caches nothing.
 class LocalCacheStrategy extends RedisCacheStrategy {
     connection;
     constructor(connection) {
         super({
             namespace: LOCAL_CACHE_NAMESPACE,
-            // No `maxItemSizeInBytes`, which is the strategy's own default when it is constructed
-            // directly. The managed cache strategy imposes no size limit either, and a limit that exists
-            // only locally would drop an entry the deployed store keeps.
+            // No `maxItemSizeInBytes`, matching the managed cache strategy. A local-only limit would drop
+            // entries the deployed store keeps.
             redisOptions: {
                 host: connection.host,
                 port: connection.port,
@@ -37,21 +32,18 @@ class LocalCacheStrategy extends RedisCacheStrategy {
         await super.init();
     }
 }
-// A plugin of the platform's own rather than upstream `RedisCachePlugin`.
+// A platform plugin, not upstream `RedisCachePlugin`.
 //
-// **Do not rename this to an upstream plugin's name.** `assertNoCustomerPluginWroteAPlatformField`
-// ignores writes made under the names the composed Cloud Plugins carry, so an upstream name here
-// would exempt a customer's own copy of that plugin: they would set
-// `systemOptions.cacheStrategy`, this composition would overwrite it, and the boot would succeed
-// with their strategy discarded. That is CLO-429's failure, and it is what the managed runtime's
-// `CloudCachePlugin` carries the same warning about. Under a name of its own, a customer declaring
-// `DefaultCachePlugin` or `RedisCachePlugin` is refused here for the same reason and with the same
-// message as in a deployed environment.
+// Do not rename this to an upstream plugin's name. `assertNoCustomerPluginWroteAPlatformField`
+// ignores writes made under the names the composed Cloud Plugins carry, so an upstream name would
+// exempt a customer's own copy: their `systemOptions.cacheStrategy` would be overwritten and the
+// boot would succeed with their strategy discarded. The managed runtime's `CloudCachePlugin`
+// carries the same warning. Under this name, a customer declaring `DefaultCachePlugin` or
+// `RedisCachePlugin` is refused as in a deployed environment.
 //
-// A class per call, holding its strategy in a closure rather than in a module-level variable. Two
-// compositions in one process are what `test/local-cache.integration.test.ts` uses to stand in for
-// the separately supervised server and worker, and a shared variable would give both of them one
-// strategy — so the suite would pass while proving nothing.
+// The strategy lives in a closure, not a module variable. `test/local-cache.integration.test.ts`
+// composes two plugins in one process to stand in for server and worker, and a shared variable
+// would give both one strategy.
 export function localCachePlugin(connection) {
     const strategy = new LocalCacheStrategy(connection);
     class LocalCachePlugin {

package/dist/local-cache-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"local-cache-plugin.js","sourceRoot":"","sources":["../src/local-cache-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAmB,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAA6B,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAExF,+FAA+F;AAC/F,qGAAqG;AACrG,oGAAoG;AACpG,2FAA2F;AAC3F,0DAA0D;AAE1D,gGAAgG;AAChG,6FAA6F;AAC7F,+EAA+E;AAC/E,MAAM,CAAC,MAAM,qBAAqB,GAAG,qBAAqB,CAAC;AAE3D,oGAAoG;AACpG,mGAAmG;AACnG,kGAAkG;AAClG,kBAAkB;AAClB,MAAM,kBAAmB,SAAQ,kBAAkB;IACpB;IAA7B,YAA6B,UAAgC;QAC3D,KAAK,CAAC;YACJ,SAAS,EAAE,qBAAqB;YAChC,sFAAsF;YACtF,6FAA6F;YAC7F,6DAA6D;YAC7D,YAAY,EAAE;gBACZ,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,QAAQ,EAAE,UAAU,CAAC,QAAQ;gBAC7B,QAAQ,EAAE,UAAU,CAAC,QAAQ;gBAC7B,EAAE,EAAE,UAAU,CAAC,EAAE;aAClB;SACF,CAAC,CAAC;QAbwB,eAAU,GAAV,UAAU,CAAsB;IAc7D,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,MAAM,yBAAyB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjD,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;CACF;AAED,0EAA0E;AAC1E,EAAE;AACF,mGAAmG;AACnG,iGAAiG;AACjG,oEAAoE;AACpE,iGAAiG;AACjG,iGAAiG;AACjG,mGAAmG;AACnG,mGAAmG;AACnG,wCAAwC;AACxC,EAAE;AACF,kGAAkG;AAClG,mGAAmG;AACnG,iGAAiG;AACjG,4DAA4D;AAC5D,MAAM,UAAU,gBAAgB,CAAC,UAAgC;IAC/D,MAAM,QAAQ,GAAG,IAAI,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAEpD,MAAM,gBAAgB;KAAG;IAEzB,aAAa,CAAC;QACZ,aAAa,EAAE,0BAA0B;QACzC,aAAa,EAAE,CAAC,MAAM,EAAE,EAAE;YACxB,MAAM,CAAC,aAAa,CAAC,aAAa,GAAG,QAAQ,CAAC;YAC9C,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAErB,OAAO,gBAAgB,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"local-cache-plugin.js","sourceRoot":"","sources":["../src/local-cache-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAmB,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAA6B,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAExF,2FAA2F;AAC3F,oGAAoG;AACpG,6FAA6F;AAE7F,kGAAkG;AAClG,0FAA0F;AAC1F,MAAM,CAAC,MAAM,qBAAqB,GAAG,qBAAqB,CAAC;AAE3D,8FAA8F;AAC9F,mGAAmG;AACnG,uBAAuB;AACvB,MAAM,kBAAmB,SAAQ,kBAAkB;IACpB;IAA7B,YAA6B,UAAgC;QAC3D,KAAK,CAAC;YACJ,SAAS,EAAE,qBAAqB;YAChC,8FAA8F;YAC9F,oCAAoC;YACpC,YAAY,EAAE;gBACZ,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,QAAQ,EAAE,UAAU,CAAC,QAAQ;gBAC7B,QAAQ,EAAE,UAAU,CAAC,QAAQ;gBAC7B,EAAE,EAAE,UAAU,CAAC,EAAE;aAClB;SACF,CAAC,CAAC;QAZwB,eAAU,GAAV,UAAU,CAAsB;IAa7D,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,MAAM,yBAAyB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjD,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;CACF;AAED,sDAAsD;AACtD,EAAE;AACF,+FAA+F;AAC/F,kGAAkG;AAClG,iGAAiG;AACjG,6FAA6F;AAC7F,0FAA0F;AAC1F,8DAA8D;AAC9D,EAAE;AACF,iGAAiG;AACjG,+FAA+F;AAC/F,gCAAgC;AAChC,MAAM,UAAU,gBAAgB,CAAC,UAAgC;IAC/D,MAAM,QAAQ,GAAG,IAAI,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAEpD,MAAM,gBAAgB;KAAG;IAEzB,aAAa,CAAC;QACZ,aAAa,EAAE,0BAA0B;QACzC,aAAa,EAAE,CAAC,MAAM,EAAE,EAAE;YACxB,MAAM,CAAC,aAAa,CAAC,aAAa,GAAG,QAAQ,CAAC;YAC9C,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAErB,OAAO,gBAAgB,CAAC;AAC1B,CAAC"}

package/dist/local-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-cache.d.ts","sourceRoot":"","sources":["../src/local-cache.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IAGb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAQD,eAAO,MAAM,mBAAmB,4BAA4B,CAAC;AAS7D,qBAAa,0BAA2B,SAAQ,KAAK;gBACvC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAOnD;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,oBAAoB,GAAG,SAAS,EAC1C,WAAW,EAAE,MAAM,CAAC,UAAU,GAC7B,oBAAoB,CAQtB;AAKD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAsBpE;AA8BD,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,oBAAoB,GAAG,MAAM,CAG3E;AAKD,wBAAgB,+BAA+B,IAAI,IAAI,CAStD;AASD,wBAAsB,yBAAyB,CAAC,UAAU,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4C/F"}
+{"version":3,"file":"local-cache.d.ts","sourceRoot":"","sources":["../src/local-cache.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IAGb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAID,eAAO,MAAM,mBAAmB,4BAA4B,CAAC;AAQ7D,qBAAa,0BAA2B,SAAQ,KAAK;gBACvC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAOnD;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,oBAAoB,GAAG,SAAS,EAC1C,WAAW,EAAE,MAAM,CAAC,UAAU,GAC7B,oBAAoB,CAetB;AAID,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAsBpE;AA0BD,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,oBAAoB,GAAG,MAAM,CAG3E;AAGD,wBAAgB,+BAA+B,IAAI,IAAI,CAStD;AAOD,wBAAsB,yBAAyB,CAAC,UAAU,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqC/F"}

package/dist/local-cache.js

@@ -1,34 +1,34 @@
 import { createRequire } from "node:module";
-// The variable `vendure dev` sets when it runs the server or the worker as a child process,
-// carrying the cache it provisioned. The in-process form is `LocalRuntimeOptions`'s `cache`, and
-// both resolve to the same shape.
-//
-// Deliberately not a `VC_*` name, for the reason `LOCAL_DATABASE_URL_VAR` is not one: ADR-0043
-// makes `VC_*` the signal that a process is a platform process and must refuse local substitutes.
+import { isLoopbackHost } from "./local-runtime-guard.js";
+// Set by `vendure dev` on the server and worker child processes, carrying the cache it provisioned.
+// `LocalRuntimeOptions`'s `cache` is the in-process form.
 export const LOCAL_CACHE_URL_VAR = "VENDURE_LOCAL_CACHE_URL";
-// Both spellings of the same wire protocol. Valkey is the engine, and `redis://` is the scheme
-// every client and every URL that predates the fork uses for it, so refusing one of them would
-// refuse a correct connection string over its spelling.
+// `redis://` is the scheme of every client and URL that predates the Valkey fork, so both are
+// accepted.
 const CACHE_URL_SCHEMES = ["valkey:", "redis:"];
 const DEFAULT_CACHE_PORT = 6379;
 export class LocalCacheUnavailableError extends Error {
     constructor(detail, options) {
-        super(`Vendure Cloud: the local runtime needs a Valkey cache, and ${detail}\n  \`vendure dev\` provisions one, keeps it between runs and passes its connection to this process. Start the application through it rather than running this process directly.\n`, options);
+        super(`Vendure Cloud: the local runtime needs a Valkey cache, and ${detail}\n  \`vendure dev\` provisions one for each run and passes its connection to this process. Use \`vendure dev\`, or supply a loopback connection through LocalRuntimeOptions.\n`, options);
         this.name = "LocalCacheUnavailableError";
     }
 }
 export function resolveLocalCache(supplied, environment) {
-    if (supplied)
-        return supplied;
-    const url = environment[LOCAL_CACHE_URL_VAR];
-    if (url === undefined || url === "") {
-        throw new LocalCacheUnavailableError("no connection was supplied to it.");
+    let connection = supplied;
+    if (!connection) {
+        const url = environment[LOCAL_CACHE_URL_VAR];
+        if (url === undefined || url === "") {
+            throw new LocalCacheUnavailableError("no connection was supplied to it.");
+        }
+        connection = parseLocalCacheUrl(url);
+    }
+    if (!isLoopbackHost(connection.host)) {
+        throw new LocalCacheUnavailableError(`the connection it was given names the host ${connection.host}, which is not this machine. LocalRuntimeOptions.cache and VENDURE_LOCAL_CACHE_URL require a loopback host. Expose your development Valkey cache on 127.0.0.1, localhost or ::1 in the application process's network namespace.`);
     }
-    return parseLocalCacheUrl(url);
+    return connection;
 }
-// Parsed here rather than handed to the client as a URL string, so that the announcement can name
-// the host without printing the password beside it, and so that a malformed value is our message
-// rather than a client's.
+// Parsed, not passed to the client as a string, so the announcement can name the host without the
+// password.
 export function parseLocalCacheUrl(url) {
     let parsed;
     try {
@@ -48,19 +48,16 @@ export function parseLocalCacheUrl(url) {
         db: parseDatabaseIndex(parsed.pathname),
     };
 }
-// Empty userinfo is absent rather than an empty credential. `new URL` reports both as "", and
-// presenting an empty username to a server that wants none is refused rather than ignored.
+// `new URL` reports empty and absent userinfo as "", and a server that wants no credentials refuses
+// an empty username.
 function optionalCredential(value) {
     return value === "" ? undefined : decodeURIComponent(value);
 }
-// The path of a cache URL is the logical database index, the way the path of a PostgreSQL URL is
-// the database name. Read rather than ignored: a caller that wrote one and had it dropped would
-// share a keyspace it believed it had left.
+// The path is the logical database index, as a PostgreSQL URL's path is the database name. A
+// dropped index would leave the caller in a keyspace it believed it had left.
 //
-// Matched against digits before it is converted, rather than converted and then checked. `Number`
-// reads `1e2` as 100 and `0x9` as 9, both of which are integers, so a check on the converted value
-// alone accepts spellings this message says are not allowed and silently picks a database the
-// caller did not name.
+// Matched against digits first: `Number` reads `1e2` as 100 and `0x9` as 9, so checking the
+// converted value would accept spellings the message rejects and select an unnamed database.
 function parseDatabaseIndex(pathname) {
     const path = pathname.replace(/^\//, "");
     if (path === "")
@@ -70,15 +67,12 @@ function parseDatabaseIndex(pathname) {
     }
     return Number(path);
 }
-// For the startup announcement, which goes to a terminal and into whatever collects that terminal's
-// output, so it names the server without the password used to reach it.
+// For the startup announcement, which names the server without the password.
 export function describeLocalCache(connection) {
     const database = connection.db === undefined ? "" : `, database ${connection.db}`;
     return `Valkey at ${connection.host}:${connection.port}${database}`;
 }
-// The client is an optional peer dependency, so it is absent from a tree that never runs locally.
-// Resolved rather than imported, because the cache strategy is what loads it and this only has to
-// decide whether the failure is ours to explain.
+// `ioredis` is an optional peer dependency, absent from a tree that never runs locally.
 export function assertLocalCacheDriverAvailable() {
     try {
         createRequire(import.meta.url).resolve("ioredis");
@@ -87,17 +81,14 @@ export function assertLocalCacheDriverAvailable() {
         throw new Error("Vendure Cloud: connecting to the local Valkey cache requires ioredis. Install it as a development dependency; deployed images carry their own copy.", { cause });
     }
 }
-// One connection, opened and closed, before anything that will keep one opens it. The probe is what
-// turns an absent cache into a single actionable message naming the server that did not answer,
-// rather than into a client retrying in the background for the life of the process.
+// Opens and closes one connection before anything keeps one, so an absent cache gives one message
+// naming the server instead of a client retrying in the background.
 //
-// A `vendure dev` run makes this check twice, deliberately: once in the command, which is what
-// stops a refused cache from reaching a process at all, and once in the cache strategy as it boots,
-// which is the check a process started any other way still gets.
+// A `vendure dev` run checks twice: in the command, so a refused cache reaches no process, and in
+// the cache strategy at boot, which covers processes started any other way.
 export async function assertLocalCacheReachable(connection) {
-    // Imported here rather than at module scope. `ioredis` is an optional peer dependency, so an
-    // application that never composes a local configuration must not load it, and `local-runtime.ts`
-    // has already reported its absence by the time this runs.
+    // `ioredis` is optional, so it is loaded only when a local configuration is composed, after
+    // `local-runtime.ts` has reported its absence.
     const { Redis } = await import("ioredis");
     const probe = new Redis({
         host: connection.host,
@@ -106,32 +97,26 @@ export async function assertLocalCacheReachable(connection) {
         password: connection.password,
         db: connection.db,
         lazyConnect: true,
-        // One attempt. The point of this connection is to answer whether the cache is there now, and a
-        // client that retries in the background answers it by hanging.
+        // One attempt: a client retrying in the background answers by hanging.
         retryStrategy: () => null,
         maxRetriesPerRequest: 1,
         enableOfflineQueue: false,
     });
-    // Without a listener, `ioredis` treats a connection error as an unhandled error event and takes
-    // the process down before the message below is ever built.
+    // Without a listener, `ioredis` treats a connection error as unhandled and exits the process.
     probe.on("error", () => undefined);
     try {
         await probe.connect();
         await probe.ping();
-        // `SELECT` again, explicitly, when an index was asked for. `ioredis` selects the database while
-        // it connects, but it reports a refusal as an `error` event rather than by failing the connect —
-        // so an index the server does not have leaves an open, working connection on database 0. Every
-        // key then lands in a keyspace the caller believed it had left, which is the whole failure the
-        // index exists to prevent. Issued as a command, its rejection is ours to catch.
+        // `ioredis` reports a refused database index as an `error` event, leaving a working connection
+        // on database 0 where every key lands in the wrong keyspace. Issuing `SELECT` as a command
+        // makes the rejection catchable.
         if (connection.db !== undefined) {
             await probe.select(connection.db);
         }
     }
     catch (cause) {
-        // The server's own reason, not just the fact that this did not complete. A cache that answered
-        // and refused the credentials, or refused the database index, is a different problem from one
-        // that is not running, and a message saying only that nothing answered sends the reader to the
-        // wrong place.
+        // Include the server's reason: a refused credential or index is a different problem from a
+        // cache that is not running.
         throw new LocalCacheUnavailableError(`${describeLocalCache(connection)} did not accept a connection: ${describe(cause)}`, { cause });
     }
     finally {

package/dist/local-cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"local-cache.js","sourceRoot":"","sources":["../src/local-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA+B5C,4FAA4F;AAC5F,iGAAiG;AACjG,kCAAkC;AAClC,EAAE;AACF,+FAA+F;AAC/F,kGAAkG;AAClG,MAAM,CAAC,MAAM,mBAAmB,GAAG,yBAAyB,CAAC;AAE7D,+FAA+F;AAC/F,+FAA+F;AAC/F,wDAAwD;AACxD,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAEhD,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEhC,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IACnD,YAAY,MAAc,EAAE,OAAsB;QAChD,KAAK,CACH,8DAA8D,MAAM,oLAAoL,EACxP,OAAO,CACR,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,UAAU,iBAAiB,CAC/B,QAA0C,EAC1C,WAA8B;IAE9B,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,MAAM,GAAG,GAAG,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAC7C,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,0BAA0B,CAAC,mCAAmC,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC;AACjC,CAAC;AAED,kGAAkG;AAClG,iGAAiG;AACjG,0BAA0B;AAC1B,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,0BAA0B,CAClC,GAAG,mBAAmB,0DAA0D,CACjF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,0BAA0B,CAClC,GAAG,mBAAmB,cAAc,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,gDAAgD,iBAAiB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,sDAAsD,CACxO,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC;QAChF,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QACnE,QAAQ,EAAE,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC7C,QAAQ,EAAE,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC7C,EAAE,EAAE,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC;KACxC,CAAC;AACJ,CAAC;AAED,8FAA8F;AAC9F,2FAA2F;AAC3F,SAAS,kBAAkB,CAAC,KAAa;IACvC,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED,iGAAiG;AACjG,gGAAgG;AAChG,4CAA4C;AAC5C,EAAE;AACF,kGAAkG;AAClG,mGAAmG;AACnG,8FAA8F;AAC9F,uBAAuB;AACvB,SAAS,kBAAkB,CAAC,QAAgB;IAC1C,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACzC,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAElC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,0BAA0B,CAClC,GAAG,mBAAmB,UAAU,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,sHAAsH,CAC3K,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAED,oGAAoG;AACpG,wEAAwE;AACxE,MAAM,UAAU,kBAAkB,CAAC,UAAgC;IACjE,MAAM,QAAQ,GAAG,UAAU,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,UAAU,CAAC,EAAE,EAAE,CAAC;IAClF,OAAO,aAAa,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC;AACtE,CAAC;AAED,kGAAkG;AAClG,kGAAkG;AAClG,iDAAiD;AACjD,MAAM,UAAU,+BAA+B;IAC7C,IAAI,CAAC;QACH,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,qJAAqJ,EACrJ,EAAE,KAAK,EAAE,CACV,CAAC;IACJ,CAAC;AACH,CAAC;AAED,oGAAoG;AACpG,gGAAgG;AAChG,oFAAoF;AACpF,EAAE;AACF,+FAA+F;AAC/F,oGAAoG;AACpG,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,UAAgC;IAC9E,6FAA6F;IAC7F,iGAAiG;IACjG,0DAA0D;IAC1D,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC;QACtB,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,EAAE,EAAE,UAAU,CAAC,EAAE;QACjB,WAAW,EAAE,IAAI;QACjB,+FAA+F;QAC/F,+DAA+D;QAC/D,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI;QACzB,oBAAoB,EAAE,CAAC;QACvB,kBAAkB,EAAE,KAAK;KAC1B,CAAC,CAAC;IACH,gGAAgG;IAChG,2DAA2D;IAC3D,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;QACtB,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,gGAAgG;QAChG,iGAAiG;QACjG,+FAA+F;QAC/F,+FAA+F;QAC/F,gFAAgF;QAChF,IAAI,UAAU,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,+FAA+F;QAC/F,8FAA8F;QAC9F,+FAA+F;QAC/F,eAAe;QACf,MAAM,IAAI,0BAA0B,CAClC,GAAG,kBAAkB,CAAC,UAAU,CAAC,iCAAiC,QAAQ,CAAC,KAAK,CAAC,EAAE,EACnF,EAAE,KAAK,EAAE,CACV,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,UAAU,EAAE,CAAC;IACrB,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}
+{"version":3,"file":"local-cache.js","sourceRoot":"","sources":["../src/local-cache.ts"],"names":[],"mappings":"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"}

package/dist/local-core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-core.d.ts","sourceRoot":"","sources":["../src/local-core.ts"],"names":[],"mappings":"AAOA,wBAAgB,wBAAwB,IAAI,IAAI,CAS/C"}
+{"version":3,"file":"local-core.d.ts","sourceRoot":"","sources":["../src/local-core.ts"],"names":[],"mappings":"AAKA,wBAAgB,wBAAwB,IAAI,IAAI,CAS/C"}

package/dist/local-core.js

@@ -1,9 +1,7 @@
 import { createRequire } from "node:module";
-// `@vendure/core` is what every function in `local-runtime.ts` composes and boots, and that file
-// imports it statically. Resolving it here, in a module with no import of its own, is what lets an
-// entry point check for it before importing `local-runtime.js` — importing that file directly when
-// `@vendure/core` is absent fails during module resolution, before any of its own code has a chance
-// to explain why.
+// `local-runtime.ts` imports `@vendure/core` statically, so importing it without `@vendure/core`
+// fails at module resolution with no explanation. This module has no such import, so an entry
+// point can call it first.
 export function assertLocalCoreAvailable() {
     try {
         createRequire(import.meta.url).resolve("@vendure/core");

package/dist/local-core.js.map

@@ -1 +1 @@
-{"version":3,"file":"local-core.js","sourceRoot":"","sources":["../src/local-core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,iGAAiG;AACjG,mGAAmG;AACnG,mGAAmG;AACnG,oGAAoG;AACpG,kBAAkB;AAClB,MAAM,UAAU,wBAAwB;IACtC,IAAI,CAAC;QACH,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAC1D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,kKAAkK,EAClK,EAAE,KAAK,EAAE,CACV,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"local-core.js","sourceRoot":"","sources":["../src/local-core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,iGAAiG;AACjG,8FAA8F;AAC9F,2BAA2B;AAC3B,MAAM,UAAU,wBAAwB;IACtC,IAAI,CAAC;QACH,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAC1D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,kKAAkK,EAClK,EAAE,KAAK,EAAE,CACV,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"local-dashboard-plugin.d.ts","sourceRoot":"","sources":["../src/local-dashboard-plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAQxD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAKD,eAAO,MAAM,4BAA4B,OAAO,CAAC;AASjD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,UAAU,CAE/E"}
+{"version":3,"file":"local-dashboard-plugin.d.ts","sourceRoot":"","sources":["../src/local-dashboard-plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAMxD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAGD,eAAO,MAAM,4BAA4B,OAAO,CAAC;AAQjD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,UAAU,CAE/E"}

package/dist/local-dashboard-plugin.js

@@ -1,20 +1,15 @@
 import { createRequire } from "node:module";
-// `vite`'s own default port, which is where a developer running the Dashboard's development server
-// lands unless they moved it. Passed to the plugin explicitly rather than left to its default, so
-// the startup announcement names the port that is actually being probed.
+// `vite`'s default port. Passed explicitly so the startup announcement names the port being probed.
 export const DEFAULT_VITE_DEV_SERVER_PORT = 5173;
 export function localDashboardPlugin(options) {
     return loadUpstreamDashboardPlugin().init(options);
 }
-// `@vendure/dashboard` is an optional peer dependency, loaded here when the Dashboard capability is
-// composed and never at import time. Two things follow. A customer's application does not carry it
-// into a managed build, where the build installs and prunes it itself. And an application that
-// never composes a local configuration does not pay for it: the plugin's entry point loads a few
-// hundred modules of its own, against the facade's budget in `published-output.test.ts`.
+// `@vendure/dashboard` is an optional peer dependency, loaded when the Dashboard capability is
+// composed. A managed build installs and prunes it itself, and its entry point loads a few hundred
+// modules against the facade's budget in `published-output.test.ts`.
 //
-// Resolved before it is required, so that a package that is not installed produces the message
-// below and a package that is installed but throws while loading produces its own error rather than
-// advice to install what is already there.
+// Resolved before required, so a missing package gives the message below and an installed package
+// that throws while loading gives its own error.
 function loadUpstreamDashboardPlugin() {
     const require = createRequire(import.meta.url);
     try {

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

@@ -1 +1 @@
-{"version":3,"file":"local-dashboard-plugin.js","sourceRoot":"","sources":["../src/local-dashboard-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAe5C,mGAAmG;AACnG,kGAAkG;AAClG,yEAAyE;AACzE,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC;AASjD,MAAM,UAAU,oBAAoB,CAAC,OAA8B;IACjE,OAAO,2BAA2B,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACrD,CAAC;AAED,oGAAoG;AACpG,mGAAmG;AACnG,+FAA+F;AAC/F,iGAAiG;AACjG,yFAAyF;AACzF,EAAE;AACF,+FAA+F;AAC/F,oGAAoG;AACpG,2CAA2C;AAC3C,SAAS,2BAA2B;IAClC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,IAAI,CAAC;QACH,OAAO,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,8KAA8K,EAC9K,EAAE,KAAK,EAAE,CACV,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAY,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAa,MAA+C,EAAE,eAAe,CAAC;IAC5F,IAAI,CAAC,yBAAyB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,uLAAuL,CACxL,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,yBAAyB,CAAC,KAAc;IAC/C,OAAO,CACL,OAAO,KAAK,KAAK,UAAU;QAC3B,OAAQ,KAA0C,CAAC,IAAI,KAAK,UAAU,CACvE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"local-dashboard-plugin.js","sourceRoot":"","sources":["../src/local-dashboard-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAa5C,oGAAoG;AACpG,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC;AAQjD,MAAM,UAAU,oBAAoB,CAAC,OAA8B;IACjE,OAAO,2BAA2B,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACrD,CAAC;AAED,+FAA+F;AAC/F,mGAAmG;AACnG,qEAAqE;AACrE,EAAE;AACF,kGAAkG;AAClG,iDAAiD;AACjD,SAAS,2BAA2B;IAClC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,IAAI,CAAC;QACH,OAAO,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,8KAA8K,EAC9K,EAAE,KAAK,EAAE,CACV,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAY,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAa,MAA+C,EAAE,eAAe,CAAC;IAC5F,IAAI,CAAC,yBAAyB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,uLAAuL,CACxL,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,yBAAyB,CAAC,KAAc;IAC/C,OAAO,CACL,OAAO,KAAK,KAAK,UAAU;QAC3B,OAAQ,KAA0C,CAAC,IAAI,KAAK,UAAU,CACvE,CAAC;AACJ,CAAC"}

package/dist/local-database.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-database.d.ts","sourceRoot":"","sources":["../src/local-database.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AASD,eAAO,MAAM,sBAAsB,+BAA+B,CAAC;AAEnE,qBAAa,6BAA8B,SAAQ,KAAK;gBAC1C,MAAM,EAAE,MAAM;CAM3B;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,uBAAuB,GAAG,SAAS,EAC7C,WAAW,EAAE,MAAM,CAAC,UAAU,GAC7B,uBAAuB,CAQzB;AAKD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,uBAAuB,CA+B1E;AAKD,wBAAgB,kCAAkC,IAAI,IAAI,CASzD"}
+{"version":3,"file":"local-database.d.ts","sourceRoot":"","sources":["../src/local-database.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,eAAO,MAAM,sBAAsB,+BAA+B,CAAC;AAEnE,qBAAa,6BAA8B,SAAQ,KAAK;gBAC1C,MAAM,EAAE,MAAM;CAM3B;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,uBAAuB,GAAG,SAAS,EAC7C,WAAW,EAAE,MAAM,CAAC,UAAU,GAC7B,uBAAuB,CAezB;AAID,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,uBAAuB,CA8B1E;AAGD,wBAAgB,kCAAkC,IAAI,IAAI,CASzD"}

package/dist/local-database.js

@@ -1,30 +1,30 @@
 import { createRequire } from "node:module";
-// The variable `vendure dev` sets when it runs the server, the worker or a migration as a child
-// process, carrying the connection it provisioned. The in-process form is `LocalRuntimeOptions`'s
-// `database`, and both resolve to the same shape.
-//
-// Deliberately not a `VC_*` name. ADR-0043 makes `VC_*` the signal that a process is a platform
-// process and must refuse local substitutes, so a local variable under that prefix would be a
-// name in the space of the thing it is the opposite of.
+import { isLoopbackHost } from "./local-runtime-guard.js";
+// Set by `vendure dev` on the server, worker and migration child processes, carrying the
+// connection it provisioned. `LocalRuntimeOptions`'s `database` is the in-process form.
 export const LOCAL_DATABASE_URL_VAR = "VENDURE_LOCAL_DATABASE_URL";
 export class LocalDatabaseUnavailableError extends Error {
     constructor(detail) {
-        super(`Vendure Cloud: the local runtime needs a PostgreSQL database, and ${detail}\n  \`vendure dev\` provisions one, keeps it between runs and passes its connection to this process. Start the application through it rather than running this process directly.\n`);
+        super(`Vendure Cloud: the local runtime needs a PostgreSQL database, and ${detail}\n  \`vendure dev\` provisions one, keeps it between runs and passes its connection to this process. Use \`vendure dev\`, or supply a loopback connection through LocalRuntimeOptions.\n`);
         this.name = "LocalDatabaseUnavailableError";
     }
 }
 export function resolveLocalDatabase(supplied, environment) {
-    if (supplied)
-        return supplied;
-    const url = environment[LOCAL_DATABASE_URL_VAR];
-    if (url === undefined || url === "") {
-        throw new LocalDatabaseUnavailableError("no connection was supplied to it.");
-    }
-    return parseLocalDatabaseUrl(url);
+    let connection = supplied;
+    if (!connection) {
+        const url = environment[LOCAL_DATABASE_URL_VAR];
+        if (url === undefined || url === "") {
+            throw new LocalDatabaseUnavailableError("no connection was supplied to it.");
+        }
+        connection = parseLocalDatabaseUrl(url);
+    }
+    if (!isLoopbackHost(connection.host)) {
+        throw new LocalDatabaseUnavailableError(`the connection it was given names the host ${connection.host}, which is not this machine. LocalRuntimeOptions.database and VENDURE_LOCAL_DATABASE_URL require a loopback host. Expose your development PostgreSQL database on 127.0.0.1, localhost or ::1 in the application process's network namespace.`);
+    }
+    return connection;
 }
-// Parsed here rather than handed to TypeORM as a `url`, so that the announcement can name the host
-// and the database without printing the password beside them, and so that a malformed value is our
-// message rather than a driver's.
+// Parsed, not passed to TypeORM as a `url`, so the announcement can name the host and database
+// without the password.
 export function parseLocalDatabaseUrl(url) {
     let parsed;
     try {
@@ -36,8 +36,7 @@ export function parseLocalDatabaseUrl(url) {
     if (parsed.protocol !== "postgres:" && parsed.protocol !== "postgresql:") {
         throw new LocalDatabaseUnavailableError(`${LOCAL_DATABASE_URL_VAR} names the ${parsed.protocol.replace(":", "")} scheme. A deployed VC Environment runs PostgreSQL, so the local runtime does too.`);
     }
-    // The path is `/database`, so one leading slash comes off and anything left is a name a
-    // PostgreSQL database cannot have.
+    // One leading slash is the separator; anything left is not a valid PostgreSQL database name.
     const database = decodeURIComponent(parsed.pathname.replace(/^\//, ""));
     if (database === "" || database.includes("/")) {
         throw new LocalDatabaseUnavailableError(`${LOCAL_DATABASE_URL_VAR} names no database. The path of the URL is the database name.`);
@@ -50,9 +49,7 @@ export function parseLocalDatabaseUrl(url) {
         password: decodeURIComponent(parsed.password),
     };
 }
-// The driver is an optional peer dependency, so it is absent from a tree that never runs locally.
-// Resolved rather than imported, because TypeORM is what loads it and this only has to decide
-// whether the failure is ours to explain.
+// The driver is an optional peer dependency, absent from a tree that never runs locally.
 export function assertLocalDatabaseDriverAvailable() {
     try {
         createRequire(import.meta.url).resolve("pg");

package/dist/local-database.js.map

@@ -1 +1 @@
-{"version":3,"file":"local-database.js","sourceRoot":"","sources":["../src/local-database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAuB5C,gGAAgG;AAChG,kGAAkG;AAClG,kDAAkD;AAClD,EAAE;AACF,gGAAgG;AAChG,8FAA8F;AAC9F,wDAAwD;AACxD,MAAM,CAAC,MAAM,sBAAsB,GAAG,4BAA4B,CAAC;AAEnE,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IACtD,YAAY,MAAc;QACxB,KAAK,CACH,qEAAqE,MAAM,oLAAoL,CAChQ,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC9C,CAAC;CACF;AAED,MAAM,UAAU,oBAAoB,CAClC,QAA6C,EAC7C,WAA8B;IAE9B,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,MAAM,GAAG,GAAG,WAAW,CAAC,sBAAsB,CAAC,CAAC;IAChD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,6BAA6B,CAAC,mCAAmC,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,qBAAqB,CAAC,GAAG,CAAC,CAAC;AACpC,CAAC;AAED,mGAAmG;AACnG,mGAAmG;AACnG,kCAAkC;AAClC,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,6BAA6B,CACrC,GAAG,sBAAsB,4DAA4D,CACtF,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,WAAW,IAAI,MAAM,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;QACzE,MAAM,IAAI,6BAA6B,CACrC,GAAG,sBAAsB,cAAc,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,oFAAoF,CAC5J,CAAC;IACJ,CAAC;IAED,wFAAwF;IACxF,mCAAmC;IACnC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;IACxE,IAAI,QAAQ,KAAK,EAAE,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,6BAA6B,CACrC,GAAG,sBAAsB,+DAA+D,CACzF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC;QAChF,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QACrD,QAAQ;QACR,QAAQ,EAAE,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC7C,QAAQ,EAAE,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED,kGAAkG;AAClG,8FAA8F;AAC9F,0CAA0C;AAC1C,MAAM,UAAU,kCAAkC;IAChD,IAAI,CAAC;QACH,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,qJAAqJ,EACrJ,EAAE,KAAK,EAAE,CACV,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"local-database.js","sourceRoot":"","sources":["../src/local-database.ts"],"names":[],"mappings":"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"}

package/dist/local-durable-execution-plugin.d.ts

@@ -1,3 +1,15 @@
+import type { LocalDatabaseConnection } from "./local-database.js";
+export declare const TERMINAL_WORKFLOW_STATUSES: readonly ["SUCCESS", "ERROR", "CANCELLED", "MAX_RECOVERY_ATTEMPTS_EXCEEDED"];
+export declare class LocalDurableWorkflowError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare function findDbosSdk(resolveHere: (specifier: string) => string, resolveFromProject: (specifier: string) => string): string | null;
+export declare function refuseOtherLocalDbosLaunchers(): void;
+export declare function localDurableWorkflowsAvailable(): boolean;
+export declare function explainMissingSchema(error: unknown): never;
+export declare function installLocalDurableWorkflows(database: LocalDatabaseConnection): void;
+export declare function launchLocalDurableExecution(): Promise<void>;
 export declare class LocalDurableExecutionPlugin {
+    onApplicationShutdown(): Promise<void>;
 }
 //# sourceMappingURL=local-durable-execution-plugin.d.ts.map

package/dist/local-durable-execution-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-durable-execution-plugin.d.ts","sourceRoot":"","sources":["../src/local-durable-execution-plugin.ts"],"names":[],"mappings":"AAwBA,qBAAa,2BAA2B;CAAG"}
+{"version":3,"file":"local-durable-execution-plugin.d.ts","sourceRoot":"","sources":["../src/local-durable-execution-plugin.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAcnE,eAAO,MAAM,0BAA0B,8EAK7B,CAAC;AAYX,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAOD,wBAAgB,WAAW,CACzB,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,EAC1C,kBAAkB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAChD,MAAM,GAAG,IAAI,CAef;AA6CD,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD;AAGD,wBAAgB,8BAA8B,IAAI,OAAO,CAExD;AAyLD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAQ1D;AAiCD,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI,CAOpF;AAOD,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAkBjE;AAED,qBAAa,2BAA2B;IAChC,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7C"}