@endora-commerce/mod-settings 0.100.0

package/dist/backend/routes.admin.js

@@ -0,0 +1,188 @@
+import { ERROR_CODES, GroupCreateRequestSchema, GroupUpdateRequestSchema, ResetValueQuerySchema, SetValueRequestSchema, SettingsListQuerySchema, } from '@endora-commerce/contracts';
+import { secretValueIsSet } from '@endora-commerce/platform/kernel';
+export async function registerSettingsAdminRoutes(app, deps) {
+    const { adminService, requireAdmin, resolveAdminAuditContext } = deps;
+    const auditContext = (request) => {
+        const ctx = resolveAdminAuditContext?.(request) ?? {
+            actorAdminUserId: null,
+        };
+        const rid = request.headers['x-request-id'];
+        return {
+            ...ctx,
+            requestId: typeof rid === 'string' ? rid : null,
+        };
+    };
+    function setEtag(reply, version) {
+        reply.header('etag', `"${version}"`);
+    }
+    function serializeSetting(setting, values, classification = { editable: true, activationControl: false }) {
+        // Secret settings are write-only (feature 043, FR-021): every read
+        // replaces stored values with null + isSet indicators. The plaintext (or
+        // its ciphertext envelope) never leaves the backend through this API.
+        const isSecret = setting.valueType === 'secret';
+        return {
+            id: setting.id,
+            code: setting.code,
+            name: setting.name,
+            description: setting.description ?? null,
+            valueType: setting.valueType,
+            ownerModule: setting.ownerModule,
+            salesChannelCodes: setting.salesChannels.getItems().map((c) => c.code),
+            enumOptions: setting.enumOptions ?? null,
+            configurationType: setting.configurationType ?? null,
+            defaultValue: isSecret ? null : setting.defaultValue,
+            globalValue: isSecret ? null : setting.globalValue ?? null,
+            ...(isSecret ? { globalValueIsSet: secretValueIsSet(setting.globalValue) } : {}),
+            valuesByChannel: values.map((v) => ({
+                salesChannelId: v.salesChannel.id,
+                salesChannelCode: v.salesChannel.code,
+                value: isSecret ? null : v.value,
+                ...(isSecret ? { isSet: secretValueIsSet(v.value) } : {}),
+                updatedAt: v.updatedAt.toISOString(),
+            })),
+            version: adminService.computeSettingVersion(setting, values),
+            editable: classification.editable,
+            activationControl: classification.activationControl,
+        };
+    }
+    function serializeGroup(group, settings) {
+        return {
+            id: group.id,
+            code: group.code,
+            name: group.name,
+            isSystemProtected: group.isSystemProtected,
+            ownerModule: group.ownerModule,
+            salesChannelCodes: group.salesChannels.getItems().map((c) => c.code),
+            settings: settings.map((s) => serializeSetting(s.setting, s.values, {
+                editable: s.editable,
+                activationControl: s.activationControl,
+            })),
+        };
+    }
+    // --------------------------------------------------------------------
+    // List + detail
+    // --------------------------------------------------------------------
+    app.get('/api/v1/admin/settings', { preHandler: requireAdmin('settings:read') }, async (request) => {
+        const q = SettingsListQuerySchema.parse(request.query ?? {});
+        const filter = q.groupCode ? { groupCode: q.groupCode } : undefined;
+        const result = await adminService.listGroups(filter);
+        return { groups: result.groups.map((g) => serializeGroup(g.group, g.settings)) };
+    });
+    app.get('/api/v1/admin/settings/:code', { preHandler: requireAdmin('settings:read') }, async (request, reply) => {
+        const { setting, values, version, editable, activationControl } = await adminService.getSettingByCode(request.params.code);
+        setEtag(reply, version);
+        return serializeSetting(setting, values, { editable, activationControl });
+    });
+    // --------------------------------------------------------------------
+    // Value writes
+    // --------------------------------------------------------------------
+    app.put('/api/v1/admin/settings/:code/value', { preHandler: requireAdmin('settings:write') }, async (request, reply) => {
+        const body = SetValueRequestSchema.parse(request.body);
+        const expectedVersion = (request.body ?? {}).expectedVersion ??
+            parseIfMatch(request);
+        const ctx = auditContext(request);
+        let result;
+        if (body.scope === 'all') {
+            result = await adminService.setValueForAllChannels(request.params.code, body.value, expectedVersion, ctx);
+        }
+        else {
+            result = await adminService.setValueForSubset(request.params.code, body.salesChannelCodes, body.value, expectedVersion, ctx);
+        }
+        setEtag(reply, result.newVersion);
+        // Refresh full detail for the response.
+        const detail = await adminService.getSettingByCode(request.params.code);
+        return serializeSetting(detail.setting, detail.values, {
+            editable: detail.editable,
+            activationControl: detail.activationControl,
+        });
+    });
+    app.delete('/api/v1/admin/settings/:code/values', { preHandler: requireAdmin('settings:write') }, async (request, reply) => {
+        const q = ResetValueQuerySchema.parse(request.query ?? {});
+        const channelCodes = q.salesChannelCodes
+            ? q.salesChannelCodes.split(',').map((c) => c.trim()).filter(Boolean)
+            : undefined;
+        const ctx = auditContext(request);
+        const result = await adminService.resetValues(request.params.code, channelCodes, ctx);
+        setEtag(reply, result.newVersion);
+        const detail = await adminService.getSettingByCode(request.params.code);
+        return serializeSetting(detail.setting, detail.values, {
+            editable: detail.editable,
+            activationControl: detail.activationControl,
+        });
+    });
+    // --------------------------------------------------------------------
+    // Group CRUD
+    // --------------------------------------------------------------------
+    app.get('/api/v1/admin/settings/groups', { preHandler: requireAdmin('settings:read') }, async () => {
+        const result = await adminService.listGroups();
+        return {
+            groups: result.groups.map((g) => ({
+                id: g.group.id,
+                code: g.group.code,
+                name: g.group.name,
+                isSystemProtected: g.group.isSystemProtected,
+                ownerModule: g.group.ownerModule,
+                salesChannelCodes: g.group.salesChannels.getItems().map((c) => c.code),
+                settingCount: g.settings.length,
+                updatedAt: g.group.updatedAt.toISOString(),
+            })),
+        };
+    });
+    app.post('/api/v1/admin/settings/groups', { preHandler: requireAdmin('settings:write') }, async (request, reply) => {
+        const body = GroupCreateRequestSchema.parse(request.body);
+        const ctx = auditContext(request);
+        const created = await adminService.createGroup({
+            code: body.code,
+            name: body.name,
+            ...(body.salesChannelCodes !== undefined
+                ? { salesChannelCodes: body.salesChannelCodes }
+                : {}),
+        }, ctx);
+        reply.code(201);
+        setEtag(reply, created.updatedAt.toISOString());
+        return {
+            id: created.id,
+            code: created.code,
+            name: created.name,
+            isSystemProtected: created.isSystemProtected,
+            ownerModule: created.ownerModule,
+            salesChannelCodes: created.salesChannels.getItems().map((c) => c.code),
+        };
+    });
+    app.patch('/api/v1/admin/settings/groups/:code', { preHandler: requireAdmin('settings:write') }, async (request, reply) => {
+        const body = GroupUpdateRequestSchema.parse(request.body);
+        const expectedVersion = (request.body ?? {}).expectedVersion ??
+            parseIfMatch(request);
+        const ctx = auditContext(request);
+        const patch = {};
+        if (body.name !== undefined)
+            patch.name = body.name;
+        if (body.salesChannelCodes !== undefined) {
+            patch.salesChannelCodes = body.salesChannelCodes;
+        }
+        const updated = await adminService.updateGroup(request.params.code, patch, expectedVersion, ctx);
+        setEtag(reply, updated.updatedAt.toISOString());
+        return {
+            id: updated.id,
+            code: updated.code,
+            name: updated.name,
+            isSystemProtected: updated.isSystemProtected,
+            ownerModule: updated.ownerModule,
+            salesChannelCodes: updated.salesChannels.getItems().map((c) => c.code),
+        };
+    });
+    app.delete('/api/v1/admin/settings/groups/:code', { preHandler: requireAdmin('settings:write') }, async (request, reply) => {
+        const ctx = auditContext(request);
+        await adminService.deleteGroup(request.params.code, ctx);
+        reply.code(204);
+    });
+}
+function parseIfMatch(request) {
+    const header = request.headers['if-match'];
+    if (!header || typeof header !== 'string')
+        return null;
+    return header.replace(/^"|"$/g, '');
+}
+// Export a typed error helper so other modules can import the shape if needed.
+export const _settingsRoutesErrors = ERROR_CODES;
+//# sourceMappingURL=routes.admin.js.map

package/dist/backend/routes.admin.js.map

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

package/dist/backend/routes.cache.d.ts

@@ -0,0 +1,20 @@
+import type { FastifyInstance } from 'fastify';
+import type { CacheAdminService } from './services/cache-admin.service.js';
+import type { RequireAdminFactory } from '@endora-commerce/platform/kernel';
+/**
+ * Admin cache-maintenance routes — lets an operator flush selected Redis cache
+ * namespaces from the Admin UI so content / settings changes appear without
+ * waiting for TTL expiry.
+ *
+ *   GET  /api/v1/admin/cache/namespaces  — list clearable namespaces
+ *   POST /api/v1/admin/cache/clear       — clear selected (or all) namespaces
+ *
+ * Gated by `settings:write` — clearing caches is a privileged maintenance
+ * action on par with editing platform settings.
+ */
+export interface SettingsCacheDeps {
+    cacheAdminService: CacheAdminService;
+    requireAdmin: RequireAdminFactory;
+}
+export declare function registerSettingsCacheRoutes(app: FastifyInstance, deps: SettingsCacheDeps): Promise<void>;
+//# sourceMappingURL=routes.cache.d.ts.map

package/dist/backend/routes.cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.cache.d.ts","sourceRoot":"","sources":["../../src/backend/routes.cache.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE5E;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,YAAY,EAAE,mBAAmB,CAAC;CACnC;AAED,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,IAAI,CAAC,CA8Bf"}

package/dist/backend/routes.cache.js

@@ -0,0 +1,22 @@
+import { ClearCacheRequestSchema } from '@endora-commerce/contracts';
+export async function registerSettingsCacheRoutes(app, deps) {
+    const { cacheAdminService, requireAdmin } = deps;
+    app.get('/api/v1/admin/cache/namespaces', { preHandler: requireAdmin('settings:write') }, async () => ({
+        data: cacheAdminService.listNamespaces(),
+        cacheEnabled: cacheAdminService.enabled,
+    }));
+    // Per-route ceiling on top of the global one in `http/server.ts`. Clearing
+    // leaves both cache layers cold platform-wide, so every subsequent setting
+    // read goes to PostgreSQL until they refill — cheap queries, but the
+    // connection pool is the scarce resource, and it is what a repeated clear
+    // exhausts. A human pressing the button a few times while diagnosing stays
+    // well inside this; a script in a loop does not, which is the case worth
+    // stopping.
+    const rateLimit = { max: 6, timeWindow: '1 minute' };
+    app.post('/api/v1/admin/cache/clear', { preHandler: requireAdmin('settings:write'), config: { rateLimit } }, async (request) => {
+        const body = ClearCacheRequestSchema.parse(request.body ?? {});
+        const result = await cacheAdminService.clear(body.namespaces);
+        return { data: result };
+    });
+}
+//# sourceMappingURL=routes.cache.js.map

package/dist/backend/routes.cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.cache.js","sourceRoot":"","sources":["../../src/backend/routes.cache.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAoBrE,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,GAAoB,EACpB,IAAuB;IAEvB,MAAM,EAAE,iBAAiB,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAEjD,GAAG,CAAC,GAAG,CACL,gCAAgC,EAChC,EAAE,UAAU,EAAE,YAAY,CAAC,gBAAgB,CAAC,EAAE,EAC9C,KAAK,IAAI,EAAE,CAAC,CAAC;QACX,IAAI,EAAE,iBAAiB,CAAC,cAAc,EAAE;QACxC,YAAY,EAAE,iBAAiB,CAAC,OAAO;KACxC,CAAC,CACH,CAAC;IAEF,2EAA2E;IAC3E,2EAA2E;IAC3E,qEAAqE;IACrE,0EAA0E;IAC1E,2EAA2E;IAC3E,yEAAyE;IACzE,YAAY;IACZ,MAAM,SAAS,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;IAErD,GAAG,CAAC,IAAI,CACN,2BAA2B,EAC3B,EAAE,UAAU,EAAE,YAAY,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,EAAE,EACrE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChB,MAAM,IAAI,GAAG,uBAAuB,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAC/D,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/backend/routes.homepage.d.ts

@@ -0,0 +1,15 @@
+import type { FastifyInstance } from 'fastify';
+import type { HomepageResolver } from './services/homepage-resolver.js';
+/**
+ * Public storefront read for the home-page configuration.
+ *
+ *   GET /api/v1/storefront/homepage
+ *
+ * Returns the CMS page slug an operator selected as the home page for the
+ * request's sales channel (from `x-sales-channel`, falling back to the
+ * system-default channel), or null when none is configured.
+ */
+export declare function registerSettingsHomepageRoutes(app: FastifyInstance, deps: {
+    homepageResolver: HomepageResolver;
+}): Promise<void>;
+//# sourceMappingURL=routes.homepage.d.ts.map

package/dist/backend/routes.homepage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.homepage.d.ts","sourceRoot":"","sources":["../../src/backend/routes.homepage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAExE;;;;;;;;GAQG;AACH,wBAAsB,8BAA8B,CAClD,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE;IAAE,gBAAgB,EAAE,gBAAgB,CAAA;CAAE,GAC3C,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/backend/routes.homepage.js

@@ -0,0 +1,20 @@
+import { getResolvedChannel } from '@endora-commerce/platform/kernel';
+/**
+ * Public storefront read for the home-page configuration.
+ *
+ *   GET /api/v1/storefront/homepage
+ *
+ * Returns the CMS page slug an operator selected as the home page for the
+ * request's sales channel (from `x-sales-channel`, falling back to the
+ * system-default channel), or null when none is configured.
+ */
+export async function registerSettingsHomepageRoutes(app, deps) {
+    app.get('/api/v1/storefront/homepage', async (request) => {
+        // The id, not the code: the channel is already resolved, and handing the
+        // resolver a code made it re-resolve one (feature 075 / D-87).
+        const salesChannelId = getResolvedChannel(request).id;
+        const data = await deps.homepageResolver.resolve(salesChannelId);
+        return { data };
+    });
+}
+//# sourceMappingURL=routes.homepage.js.map

package/dist/backend/routes.homepage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.homepage.js","sourceRoot":"","sources":["../../src/backend/routes.homepage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAGtE;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,GAAoB,EACpB,IAA4C;IAE5C,GAAG,CAAC,GAAG,CAAC,6BAA6B,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACvD,yEAAyE;QACzE,+DAA+D;QAC/D,MAAM,cAAc,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACjE,OAAO,EAAE,IAAI,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/backend/routes.product-card-buttons.d.ts

@@ -0,0 +1,15 @@
+import type { FastifyInstance } from 'fastify';
+import type { ProductCardButtonsResolver } from './services/product-card-buttons-resolver.js';
+/**
+ * Public storefront read for the product-card button visibility toggles.
+ *
+ *   GET /api/v1/storefront/settings/product-card-buttons
+ *
+ * Returns `{ showAddToCart, showAddToShoppingList, showAddToQuote }` for the
+ * request's sales channel (from `x-sales-channel`, falling back to the
+ * system-default channel). Each flag defaults to true on any read error.
+ */
+export declare function registerSettingsProductCardButtonsRoutes(app: FastifyInstance, deps: {
+    productCardButtonsResolver: ProductCardButtonsResolver;
+}): Promise<void>;
+//# sourceMappingURL=routes.product-card-buttons.d.ts.map

package/dist/backend/routes.product-card-buttons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.product-card-buttons.d.ts","sourceRoot":"","sources":["../../src/backend/routes.product-card-buttons.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6CAA6C,CAAC;AAE9F;;;;;;;;GAQG;AACH,wBAAsB,wCAAwC,CAC5D,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE;IAAE,0BAA0B,EAAE,0BAA0B,CAAA;CAAE,GAC/D,OAAO,CAAC,IAAI,CAAC,CASf"}

package/dist/backend/routes.product-card-buttons.js

@@ -0,0 +1,21 @@
+import { getResolvedChannel } from '@endora-commerce/platform/kernel';
+/**
+ * Public storefront read for the product-card button visibility toggles.
+ *
+ *   GET /api/v1/storefront/settings/product-card-buttons
+ *
+ * Returns `{ showAddToCart, showAddToShoppingList, showAddToQuote }` for the
+ * request's sales channel (from `x-sales-channel`, falling back to the
+ * system-default channel). Each flag defaults to true on any read error.
+ */
+export async function registerSettingsProductCardButtonsRoutes(app, deps) {
+    app.get('/api/v1/storefront/settings/product-card-buttons', async (request, reply) => {
+        reply.header('cache-control', 'public, max-age=60');
+        // The id, not the code: the channel is already resolved, and handing the
+        // resolver a code made it re-resolve one (feature 075 / D-87).
+        const salesChannelId = getResolvedChannel(request).id;
+        const data = await deps.productCardButtonsResolver.resolve(salesChannelId);
+        return { data };
+    });
+}
+//# sourceMappingURL=routes.product-card-buttons.js.map

package/dist/backend/routes.product-card-buttons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.product-card-buttons.js","sourceRoot":"","sources":["../../src/backend/routes.product-card-buttons.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAGtE;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,wCAAwC,CAC5D,GAAoB,EACpB,IAAgE;IAEhE,GAAG,CAAC,GAAG,CAAC,kDAAkD,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACnF,KAAK,CAAC,MAAM,CAAC,eAAe,EAAE,oBAAoB,CAAC,CAAC;QACpD,yEAAyE;QACzE,+DAA+D;QAC/D,MAAM,cAAc,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAC3E,OAAO,EAAE,IAAI,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/backend/routes.speculation-rules.d.ts

@@ -0,0 +1,16 @@
+import type { FastifyInstance } from 'fastify';
+import type { SpeculationRulesResolver } from './services/speculation-rules-resolver.js';
+/**
+ * Public storefront read for the Speculation Rules configuration.
+ *
+ *   GET /api/v1/storefront/speculation-rules
+ *
+ * Resolves the `storefront.speculation_rules.*` settings for the request's
+ * sales channel (from `x-sales-channel`, falling back to the system-default
+ * channel). Returns `{ enabled, eagerness }`; a settings hiccup falls back to
+ * enabled + 'moderate' inside the resolver so a public page never 500s.
+ */
+export declare function registerSettingsSpeculationRulesRoutes(app: FastifyInstance, deps: {
+    speculationRulesResolver: SpeculationRulesResolver;
+}): Promise<void>;
+//# sourceMappingURL=routes.speculation-rules.d.ts.map

package/dist/backend/routes.speculation-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.speculation-rules.d.ts","sourceRoot":"","sources":["../../src/backend/routes.speculation-rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AAEzF;;;;;;;;;GASG;AACH,wBAAsB,sCAAsC,CAC1D,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE;IAAE,wBAAwB,EAAE,wBAAwB,CAAA;CAAE,GAC3D,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/backend/routes.speculation-rules.js

@@ -0,0 +1,21 @@
+import { getResolvedChannel } from '@endora-commerce/platform/kernel';
+/**
+ * Public storefront read for the Speculation Rules configuration.
+ *
+ *   GET /api/v1/storefront/speculation-rules
+ *
+ * Resolves the `storefront.speculation_rules.*` settings for the request's
+ * sales channel (from `x-sales-channel`, falling back to the system-default
+ * channel). Returns `{ enabled, eagerness }`; a settings hiccup falls back to
+ * enabled + 'moderate' inside the resolver so a public page never 500s.
+ */
+export async function registerSettingsSpeculationRulesRoutes(app, deps) {
+    app.get('/api/v1/storefront/speculation-rules', async (request) => {
+        // The id, not the code: the channel is already resolved, and handing the
+        // resolver a code made it re-resolve one (feature 075 / D-87).
+        const salesChannelId = getResolvedChannel(request).id;
+        const data = await deps.speculationRulesResolver.resolve(salesChannelId);
+        return { data };
+    });
+}
+//# sourceMappingURL=routes.speculation-rules.js.map

package/dist/backend/routes.speculation-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.speculation-rules.js","sourceRoot":"","sources":["../../src/backend/routes.speculation-rules.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAGtE;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,sCAAsC,CAC1D,GAAoB,EACpB,IAA4D;IAE5D,GAAG,CAAC,GAAG,CAAC,sCAAsC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,yEAAyE;QACzE,+DAA+D;QAC/D,MAAM,cAAc,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,wBAAwB,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACzE,OAAO,EAAE,IAAI,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/backend/routes.storefront.d.ts

@@ -0,0 +1,15 @@
+import type { FastifyInstance } from 'fastify';
+import type { ShopInfoResolver } from './services/shop-info-resolver.js';
+/**
+ * Public storefront read for the shop / company contact information.
+ *
+ *   GET /api/v1/storefront/shop-info
+ *
+ * Resolves the `shop.*` settings for the request's sales channel (from the
+ * `x-sales-channel` header, falling back to the system-default channel). Every
+ * field is always present as a string; unset values come back empty.
+ */
+export declare function registerSettingsStorefrontRoutes(app: FastifyInstance, deps: {
+    shopInfoResolver: ShopInfoResolver;
+}): Promise<void>;
+//# sourceMappingURL=routes.storefront.d.ts.map

package/dist/backend/routes.storefront.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.storefront.d.ts","sourceRoot":"","sources":["../../src/backend/routes.storefront.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE;;;;;;;;GAQG;AACH,wBAAsB,gCAAgC,CACpD,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE;IAAE,gBAAgB,EAAE,gBAAgB,CAAA;CAAE,GAC3C,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/backend/routes.storefront.js

@@ -0,0 +1,20 @@
+import { getResolvedChannel } from '@endora-commerce/platform/kernel';
+/**
+ * Public storefront read for the shop / company contact information.
+ *
+ *   GET /api/v1/storefront/shop-info
+ *
+ * Resolves the `shop.*` settings for the request's sales channel (from the
+ * `x-sales-channel` header, falling back to the system-default channel). Every
+ * field is always present as a string; unset values come back empty.
+ */
+export async function registerSettingsStorefrontRoutes(app, deps) {
+    app.get('/api/v1/storefront/shop-info', async (request) => {
+        // The id, not the code: the channel is already resolved, and handing the
+        // resolver a code made it re-resolve one (feature 075 / D-87).
+        const salesChannelId = getResolvedChannel(request).id;
+        const data = await deps.shopInfoResolver.resolve(salesChannelId);
+        return { data };
+    });
+}
+//# sourceMappingURL=routes.storefront.js.map

package/dist/backend/routes.storefront.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.storefront.js","sourceRoot":"","sources":["../../src/backend/routes.storefront.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAGtE;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gCAAgC,CACpD,GAAoB,EACpB,IAA4C;IAE5C,GAAG,CAAC,GAAG,CAAC,8BAA8B,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACxD,yEAAyE;QACzE,+DAA+D;QAC/D,MAAM,cAAc,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACjE,OAAO,EAAE,IAAI,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/backend/services/cache-admin.service.d.ts

@@ -0,0 +1,83 @@
+import type { Redis } from 'ioredis';
+import type { CacheNamespaceDto } from '@endora-commerce/contracts';
+import { type InProcessCacheRegistry } from '@endora-commerce/platform/kernel';
+/**
+ * Static registry of clearable cache namespaces. Each entry owns one or more
+ * key-glob patterns; clearing a namespace SCAN+DELs every matching key.
+ *
+ * Patterns mirror the prefixes each module's cache service writes with:
+ *   - settings:        `settings:v1:*`        (SettingsCache)
+ *   - sales_channels:  `sales-channels:v2:*`  (SalesChannelsCache)
+ *   - blog:            `blog:v1:*`            (BlogCacheService)
+ *   - cms:             `cms:v1:*`             (CmsCache)
+ *   - megamenu:        `megamenu:v1:*`        (MegamenuCache)
+ *   - dictionaries:    `dictionary:*`         (DictionaryCache)
+ *   - carts:           `b2b:cart:recompute:*` (CartRecomputeCache)
+ *
+ * The first two take their prefix from the cache itself rather than repeating
+ * the literal: `sales_channels` spent from feature 053 to now pointing at
+ * `sales-channels:v1:*` while the cache wrote `v2`, so the button cleared
+ * nothing at all for that namespace.
+ *
+ * Keep this list in sync when a new Redis-backed cache prefix is introduced.
+ */
+interface CacheNamespace {
+    key: string;
+    label: string;
+    description: string;
+    patterns: string[];
+}
+export declare const CACHE_NAMESPACES: readonly CacheNamespace[];
+export interface ClearedNamespace {
+    key: string;
+    deletedKeysCount: number;
+}
+/**
+ * Admin-facing cache maintenance. Lets an operator flush selected cache
+ * namespaces so freshly-published content / changed settings show up without
+ * waiting for TTL expiry.
+ *
+ * Six of the eight namespaces live only in Redis, so SCAN+DEL over their key
+ * patterns is a complete clear. Two — `settings` and `sales_channels` — keep a
+ * per-process layer in front of Redis, and for those the clear goes through
+ * the cache that owns both layers (see {@link InProcessCacheRegistry}), which
+ * is also the only way to get the ordering right: shared layer first, prefix
+ * marked for the whole operation.
+ *
+ * The cost of that ordering is worth naming. Immediately after a clear both
+ * layers are cold and the marked prefix sends reads through to PostgreSQL, so
+ * a platform-wide burst of setting reads lands on the database. The queries are
+ * trivial (small table, unique index on `code`), but the connection pool is
+ * not: it is the scarce resource. That is acceptable for a rare,
+ * operator-initiated action and unacceptable in a loop, which is why the route
+ * carries its own rate limit (`routes.cache.ts`).
+ */
+export declare class CacheAdminService {
+    private readonly redis?;
+    /** Injectable so a test does not clear this process's real caches. */
+    private readonly caches;
+    constructor(redis?: Redis | undefined, 
+    /** Injectable so a test does not clear this process's real caches. */
+    caches?: InProcessCacheRegistry);
+    get enabled(): boolean;
+    listNamespaces(): CacheNamespaceDto[];
+    /**
+     * Clear the given namespaces (or every namespace when passed `'all'`).
+     * Unknown keys are ignored. Returns the per-namespace deleted-key counts.
+     */
+    clear(namespaces: 'all' | string[]): Promise<{
+        cleared: ClearedNamespace[];
+        totalDeletedKeys: number;
+    }>;
+    /**
+     * Prefer the owning cache when this process has one: it drops the shared
+     * layer and its own in-memory layer as one marked operation. A process that
+     * registered none — the `cache:clear` CLI, a worker without the module —
+     * has no in-memory layer to be stale, so clearing the Redis keys is the
+     * whole job.
+     */
+    private clearNamespace;
+    private scanDelete;
+}
+export {};
+//# sourceMappingURL=cache-admin.service.d.ts.map

package/dist/backend/services/cache-admin.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-admin.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/cache-admin.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,kCAAkC,CAAC;AAU1C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,UAAU,cAAc;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,eAAO,MAAM,gBAAgB,EAAE,SAAS,cAAc,EAiD5C,CAAC;AAEX,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IACvB,sEAAsE;IACtE,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFN,KAAK,CAAC,EAAE,KAAK,YAAA;IAC9B,sEAAsE;IACrD,MAAM,GAAE,sBAAwC;IAGnE,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,cAAc,IAAI,iBAAiB,EAAE;IAQrC;;;OAGG;IACG,KAAK,CACT,UAAU,EAAE,KAAK,GAAG,MAAM,EAAE,GAC3B,OAAO,CAAC;QAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC;IAgBrE;;;;;;OAMG;YACW,cAAc;YAYd,UAAU;CAgBzB"}