@saasicat/nest 0.18.1 → 0.21.0

package/dist/_entries.cjs

@@ -87,6 +87,7 @@ var RLS_BYPASS_PORT_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform/RlsBypassP
 
 // src/admin/super-admin.guard.ts
 var import_common = require("@nestjs/common");
+var import_types = require("@saasicat/types");
 function _ts_decorate(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -100,10 +101,18 @@ var SuperAdminGuard = class {
   }
   canActivate(context) {
     const request = context.switchToHttp().getRequest();
-    if (!request.user) throw new import_common.ForbiddenException("Nicht authentifiziert");
+    if (!request.user) {
+      throw new import_common.ForbiddenException({
+        code: import_types.AUTH_ERROR_CODES.NOT_AUTHENTICATED,
+        message: "Not authenticated"
+      });
+    }
     const role = request.user.platformRole ?? request.user.role;
     if (role !== "SUPER_ADMIN") {
-      throw new import_common.ForbiddenException("Nur SUPER_ADMIN-Rolle erlaubt");
+      throw new import_common.ForbiddenException({
+        code: import_types.AUTH_ERROR_CODES.SUPER_ADMIN_REQUIRED,
+        message: "Only the SUPER_ADMIN role is allowed"
+      });
     }
     return true;
   }
@@ -115,6 +124,22 @@ SuperAdminGuard = _ts_decorate([
 // src/admin/mfa.guard.ts
 var import_common3 = require("@nestjs/common");
 var import_core = require("@nestjs/core");
+var import_types3 = require("@saasicat/types");
+
+// src/errors/coded-error.ts
+var import_types2 = require("@saasicat/types");
+function codedError(code, params) {
+  const message = (0, import_types2.formatErrorMessage)(import_types2.ERROR_MESSAGES_EN[code], params ?? {});
+  return params ? {
+    code,
+    message,
+    params
+  } : {
+    code,
+    message
+  };
+}
+__name(codedError, "codedError");
 
 // src/admin/mfa.ts
 var import_common2 = require("@nestjs/common");
@@ -194,7 +219,7 @@ var MfaService = class _MfaService {
         return false;
       }
       const message = error instanceof Error ? error.message : String(error);
-      this.logger.warn(`TOTP-Verify f\xFCr User ${input.userId} unerwartet fehlgeschlagen: ${message}`);
+      this.logger.warn(`TOTP verification for user ${input.userId} failed unexpectedly: ${message}`);
       return false;
     }
   }
@@ -260,22 +285,30 @@ var MfaGuard = class _MfaGuard {
     }
     const request = context.switchToHttp().getRequest();
     const user = request.user;
-    if (!user) throw new import_common3.UnauthorizedException({
-      reason: "NOT_AUTHENTICATED"
-    });
+    if (!user) {
+      throw new import_common3.UnauthorizedException({
+        ...codedError(import_types3.AUTH_ERROR_CODES.NOT_AUTHENTICATED),
+        // `reason` is superseded by `code` and will be removed.
+        reason: "NOT_AUTHENTICATED"
+      });
+    }
     const enabled = await this.mfaService.isEnabled(user.id);
     if (!enabled) {
       throw new import_common3.UnauthorizedException({
+        code: import_types3.AUTH_ERROR_CODES.MFA_NOT_SET_UP,
+        // `reason` is superseded by `code` and will be removed.
         reason: "MFA_NOT_SET_UP",
-        message: "Bitte zuerst MFA-Setup \xFCber das CLI ausf\xFChren."
+        message: "Run the MFA setup via the CLI first."
       });
     }
     const headerVal = request.headers?.["x-mfa-code"];
     const code = Array.isArray(headerVal) ? headerVal[0] : headerVal;
     if (!code) {
       throw new import_common3.UnauthorizedException({
+        code: import_types3.AUTH_ERROR_CODES.MFA_REQUIRED,
+        // `reason` is superseded by `code` and will be removed.
         reason: "MFA_REQUIRED",
-        message: "TOTP-Code im Header X-Mfa-Code erforderlich."
+        message: "TOTP code required in the X-Mfa-Code header."
       });
     }
     const valid = await this.mfaService.verify({
@@ -284,8 +317,10 @@ var MfaGuard = class _MfaGuard {
     });
     if (!valid) {
       throw new import_common3.UnauthorizedException({
+        code: import_types3.AUTH_ERROR_CODES.MFA_FAILED,
+        // `reason` is superseded by `code` and will be removed.
         reason: "MFA_FAILED",
-        message: "TOTP-Code ung\xFCltig."
+        message: "Invalid TOTP code."
       });
     }
     return true;
@@ -799,7 +834,7 @@ var PLATFORM_CORE_MANIFEST_CONTRIBUTION = {
     actions: [
       {
         id: "platform.tenants.suspend",
-        label: "Mandant suspendieren",
+        label: "Suspend tenant",
         actionKey: "tenants.suspend",
         requiredCapability: "tenants.suspend",
         requiresMfa: true,
@@ -807,7 +842,7 @@ var PLATFORM_CORE_MANIFEST_CONTRIBUTION = {
       },
       {
         id: "platform.tenants.reactivate",
-        label: "Mandant reaktivieren",
+        label: "Reactivate tenant",
         actionKey: "tenants.reactivate",
         requiredCapability: "tenants.reactivate",
         requiresMfa: true,
@@ -823,7 +858,7 @@ var PLATFORM_CORE_MANIFEST_CONTRIBUTION = {
       },
       {
         id: "platform.tenants.export",
-        label: "DSGVO-Export",
+        label: "GDPR export",
         actionKey: "tenants.export",
         requiredCapability: "tenants.export",
         requiresMfa: true,
@@ -831,7 +866,7 @@ var PLATFORM_CORE_MANIFEST_CONTRIBUTION = {
       },
       {
         id: "platform.subscriptions.cancel",
-        label: "Subscription k\xFCndigen",
+        label: "Cancel subscription",
         actionKey: "subscriptions.cancel",
         requiredCapability: "subscriptions.cancel",
         requiresMfa: true,
@@ -839,7 +874,7 @@ var PLATFORM_CORE_MANIFEST_CONTRIBUTION = {
       },
       {
         id: "platform.pilots.grant",
-        label: "Pilot-Status setzen",
+        label: "Set pilot status",
         actionKey: "pilots.grant",
         requiredCapability: "pilots.grant",
         requiresMfa: true,
@@ -847,7 +882,7 @@ var PLATFORM_CORE_MANIFEST_CONTRIBUTION = {
       },
       {
         id: "platform.pilots.revoke",
-        label: "Pilot-Status entziehen",
+        label: "Revoke pilot status",
         actionKey: "pilots.revoke",
         requiredCapability: "pilots.revoke",
         requiresMfa: true,
@@ -855,7 +890,7 @@ var PLATFORM_CORE_MANIFEST_CONTRIBUTION = {
       },
       {
         id: "platform.pilots.extend",
-        label: "Pilot verl\xE4ngern",
+        label: "Extend pilot",
         actionKey: "pilots.extend",
         requiredCapability: "pilots.extend",
         requiresMfa: true,
@@ -867,102 +902,102 @@ var PLATFORM_CORE_MANIFEST_CONTRIBUTION = {
     actions: [
       {
         key: "TENANT_SUSPEND",
-        label: "Mandant suspendiert",
+        label: "Tenant suspended",
         severity: "high"
       },
       {
         key: "TENANT_REACTIVATE",
-        label: "Mandant reaktiviert",
+        label: "Tenant reactivated",
         severity: "medium"
       },
       {
         key: "TENANT_IMPERSONATE",
-        label: "Impersonation gestartet",
+        label: "Impersonation started",
         severity: "high"
       },
       {
         key: "TENANT_EXPORT",
-        label: "DSGVO-Export ausgel\xF6st",
+        label: "GDPR export triggered",
         severity: "medium"
       },
       {
         key: "PILOT_CREATE",
-        label: "Pilot-Tenant angelegt",
+        label: "Pilot tenant created",
         severity: "medium"
       },
       {
         key: "PILOT_GRANT",
-        label: "Pilot-Status gesetzt",
+        label: "Pilot status set",
         severity: "medium"
       },
       {
         key: "PILOT_REVOKE",
-        label: "Pilot-Status entzogen",
+        label: "Pilot status revoked",
         severity: "medium"
       },
       {
         key: "PILOT_EXTEND",
-        label: "Pilot verl\xE4ngert",
+        label: "Pilot extended",
         severity: "low"
       },
       {
         key: "PLAN_VERSION_PUBLISH",
-        label: "Plan-Version freigegeben",
+        label: "Plan version approved",
         severity: "high"
       },
       {
         key: "PLAN_VERSION_TERMINATE",
-        label: "Plan-Version terminiert",
+        label: "Plan version terminated",
         severity: "high"
       },
       {
         key: "SUBSCRIPTION_CANCEL",
-        label: "Subscription gek\xFCndigt",
+        label: "Subscription cancelled",
         severity: "high"
       },
       {
         key: "USER_RESET_PASSWORD",
-        label: "Passwort-Reset ausgel\xF6st",
+        label: "Password reset triggered",
         severity: "medium"
       },
       {
         key: "USER_DEACTIVATE",
-        label: "User deaktiviert",
+        label: "User deactivated",
         severity: "high"
       },
       {
         key: "USER_REASSIGN_ADMIN",
-        label: "Admin-Rolle \xFCbertragen",
+        label: "Admin role transferred",
         severity: "high"
       },
       {
         key: "PLATFORM_EMAIL_PROVIDER_CREATE",
-        label: "Plattform-Absender angelegt",
+        label: "Platform sender created",
         severity: "medium"
       },
       {
         key: "PLATFORM_EMAIL_PROVIDER_UPDATE",
-        label: "Plattform-Absender ge\xE4ndert",
+        label: "Platform sender changed",
         severity: "medium"
       },
       {
         key: "PLATFORM_EMAIL_PROVIDER_DELETE",
-        label: "Plattform-Absender gel\xF6scht",
+        label: "Platform sender deleted",
         severity: "medium"
       },
       {
         key: "PLATFORM_EMAIL_PROVIDER_TEST",
-        label: "Plattform-Absender Test-Versand",
+        label: "Platform sender test send",
         severity: "low"
       },
       {
         key: "EMAIL_HISTORY_DELETE",
-        label: "Plattform-E-Mail aus Verlauf entfernt",
+        label: "Platform email removed from history",
         severity: "medium"
       },
       {
         key: "EMAIL_HISTORY_RESEND",
-        label: "Plattform-E-Mail erneut versendet",
+        label: "Platform email resent",
         severity: "low"
       }
     ]
@@ -1081,7 +1116,7 @@ var AdminManifestModule = class _AdminManifestModule {
     ];
     if (includeManifestController) {
       if (options.guards === void 0) {
-        throw new Error("AdminManifestModule.forRoot: `guards` ist Pflicht, wenn `includeManifestController` aktiv ist (Default `true`). Setze `guards: [JwtAuthGuard, SuperAdminGuard]` (oder analog) \u2014 oder `guards: []`, um den Endpoint absichtlich auth-frei zu betreiben. Alternative: `includeManifestController: false` und einen eigenen Wrapping-Controller registrieren.");
+        throw new Error("AdminManifestModule.forRoot: `guards` is required when `includeManifestController` is enabled (default `true`). Set `guards: [JwtAuthGuard, SuperAdminGuard]` (or equivalent) \u2014 or `guards: []` to deliberately leave the endpoint unauthenticated. Alternative: `includeManifestController: false` plus registering your own wrapping controller.");
       }
       controllers.push(buildManifestController(options.guards, options.reloadGuards ?? []));
     }
@@ -1318,6 +1353,7 @@ AdminStatsModule = _ts_decorate12([
 // src/admin/admin-resources.module.ts
 var import_common14 = require("@nestjs/common");
 var import_class_validator = require("class-validator");
+var import_types4 = require("@saasicat/types");
 function _ts_decorate13(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -1363,7 +1399,15 @@ var AdminResourcesService = class {
   }
   async getTenantDetail(slug) {
     const tenant = await this.resources.getTenantDetail(slug);
-    if (!tenant) throw new import_common14.NotFoundException(`Tenant ${slug} not found`);
+    if (!tenant) {
+      throw new import_common14.NotFoundException({
+        code: import_types4.BILLING_ERROR_CODES.TENANT_NOT_FOUND,
+        message: `Tenant ${slug} not found`,
+        params: {
+          slug
+        }
+      });
+    }
     return tenant;
   }
   listUsers(filter) {
@@ -1389,7 +1433,15 @@ var AdminResourcesService = class {
   }
   async setTenantActive(slug, active, subscriptionStatus, actor, audit) {
     const result = await this.resources.setTenantActive(slug, active, subscriptionStatus);
-    if (!result) throw new import_common14.NotFoundException(`Tenant ${slug} not found`);
+    if (!result) {
+      throw new import_common14.NotFoundException({
+        code: import_types4.BILLING_ERROR_CODES.TENANT_NOT_FOUND,
+        message: `Tenant ${slug} not found`,
+        params: {
+          slug
+        }
+      });
+    }
     await this.audit.log({
       actor,
       entity: "Tenant",
@@ -1631,8 +1683,8 @@ __export(billing_exports, {
   buildPlanCatalogFromSnapshot: () => buildPlanCatalogFromSnapshot,
   buildPlanCatalogImporterController: () => buildPlanCatalogImporterController,
   buildTenantSubscriptionBundlesController: () => buildTenantSubscriptionBundlesController,
-  classifyBundleVersionDiff: () => import_types.classifyBundleVersionDiff,
-  classifyPlanDiff: () => import_types.classifyPlanDiff,
+  classifyBundleVersionDiff: () => import_types5.classifyBundleVersionDiff,
+  classifyPlanDiff: () => import_types5.classifyPlanDiff,
   clearPendingPlanVersionFields: () => clearPendingPlanVersionFields,
   computeCarriedTrialEndsAt: () => computeCarriedTrialEndsAt,
   computeNextPeriod: () => computeNextPeriod,
@@ -1693,7 +1745,7 @@ function periodEndWithMinLead(startedAt, cycle, now, minLeadDays = 42) {
 __name(periodEndWithMinLead, "periodEndWithMinLead");
 
 // src/billing/version-diff.ts
-var import_types = require("@saasicat/types");
+var import_types5 = require("@saasicat/types");
 
 // src/billing/version-publish.ts
 var PublishValidationError = class extends Error {
@@ -1709,35 +1761,35 @@ var PublishValidationError = class extends Error {
 function assertChangeNote(changeNote) {
   const trimmed = (changeNote ?? "").trim();
   if (trimmed.length === 0) {
-    throw new PublishValidationError("CHANGE_NOTE_REQUIRED", "changeNote ist Pflicht beim Ver\xF6ffentlichen einer Version.");
+    throw new PublishValidationError("CHANGE_NOTE_REQUIRED", "changeNote is required when publishing a version.");
   }
   return trimmed;
 }
 __name(assertChangeNote, "assertChangeNote");
 function assertDraftPublishable(draft, draftId) {
   if (!draft) {
-    throw new PublishValidationError("NOT_FOUND", `PlanVersion ${draftId} nicht gefunden`);
+    throw new PublishValidationError("NOT_FOUND", `PlanVersion ${draftId} not found`);
   }
   if (draft.publishedAt !== null) {
-    throw new PublishValidationError("ALREADY_PUBLISHED", `PlanVersion ${draftId} ist bereits ver\xF6ffentlicht.`);
+    throw new PublishValidationError("ALREADY_PUBLISHED", `PlanVersion ${draftId} has already been published.`);
   }
   if (!draft.baseVersionId) {
-    throw new PublishValidationError("NO_BASE_VERSION", `Draft ${draftId} hat keine baseVersion \u2014 wahrscheinlich manuell angelegtes v1, das nur per Migration ver\xF6ffentlicht werden darf.`);
+    throw new PublishValidationError("NO_BASE_VERSION", `Draft ${draftId} has no baseVersion \u2014 probably a manually created v1 that may only be published via a migration.`);
   }
 }
 __name(assertDraftPublishable, "assertDraftPublishable");
 function assertBaseVersionFresh(base, baseId, planContext) {
   if (!base) {
-    throw new PublishValidationError("BASE_NOT_FOUND", `baseVersion ${baseId} nicht mehr vorhanden.`);
+    throw new PublishValidationError("BASE_NOT_FOUND", `baseVersion ${baseId} no longer exists.`);
   }
   if (base.supersededAt !== null) {
-    throw new PublishValidationError("BASE_SUPERSEDED", `Draft basiert auf einer abgel\xF6sten Version (${planContext}). Bitte den Draft gegen die aktuelle Live-Version rebasen oder neu anlegen.`);
+    throw new PublishValidationError("BASE_SUPERSEDED", `The draft is based on a superseded version (${planContext}). Rebase the draft onto the current live version, or create a new one.`);
   }
 }
 __name(assertBaseVersionFresh, "assertBaseVersionFresh");
 function assertOptimisticLockHeld(updateCount, draftId) {
   if (updateCount !== 1) {
-    throw new PublishValidationError("OPTIMISTIC_LOCK_CONFLICT", `Draft ${draftId} wurde zwischenzeitlich von einem anderen Admin ver\xF6ffentlicht.`);
+    throw new PublishValidationError("OPTIMISTIC_LOCK_CONFLICT", `Draft ${draftId} has meanwhile been published by another admin.`);
   }
 }
 __name(assertOptimisticLockHeld, "assertOptimisticLockHeld");
@@ -1788,10 +1840,11 @@ var FEATURE_GUARD_CONFIG_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform/Featu
 // src/billing/feature.guard.ts
 var import_common18 = require("@nestjs/common");
 var import_core2 = require("@nestjs/core");
-var import_types2 = require("@saasicat/types");
+var import_types7 = require("@saasicat/types");
 
 // src/entitlement/service.ts
 var import_common17 = require("@nestjs/common");
+var import_types6 = require("@saasicat/types");
 
 // src/catalog/tokens.ts
 var PLAN_REPOSITORY_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform/PlanRepository");
@@ -1966,7 +2019,7 @@ __name(findPlan, "findPlan");
 function getPlanOrThrow(catalog, planId) {
   const plan = findPlan(catalog, planId);
   if (!plan) {
-    throw new Error(`Plan "${planId}" nicht im Catalog (${catalog.projectKey}) gefunden`);
+    throw new Error(`Plan "${planId}" not found in the catalog (${catalog.projectKey})`);
   }
   return plan;
 }
@@ -2236,7 +2289,7 @@ function assertNoReplacesCycle(index) {
         ...path.slice(cycleStart),
         key
       ].join(" \u2192 ");
-      throw new Error(`replaces-Zyklus in den Discovery-Metadaten: ${cycle}. Feature-Ersetzungen m\xFCssen azyklisch sein \u2014 replaces-Deklarationen im Code korrigieren (#39).`);
+      throw new Error(`replaces cycle in the discovery metadata: ${cycle}. Feature replacements must be acyclic \u2014 fix the replaces declarations in code (#39).`);
     }
     state.set(key, IN_PROGRESS);
     for (const successor of index.get(key) ?? []) {
@@ -2262,7 +2315,7 @@ var LimitExceededError = class extends Error {
   used;
   code = LIMIT_EXCEEDED;
   constructor(dimension, max, used) {
-    super(`Limit f\xFCr ${dimension} erreicht: ${used}/${max}.`), this.dimension = dimension, this.max = max, this.used = used;
+    super(`Limit for ${dimension} reached: ${used}/${max}.`), this.dimension = dimension, this.max = max, this.used = used;
     this.name = "LimitExceededError";
   }
 };
@@ -2357,7 +2410,13 @@ var EntitlementService = class {
     if (cached) return cached;
     const sub = await this.subscriptions.findByTenantId(tenantId);
     if (!sub) {
-      throw new import_common17.NotFoundException(`Keine Subscription f\xFCr Tenant ${tenantId}`);
+      throw new import_common17.NotFoundException({
+        code: import_types6.BILLING_ERROR_CODES.SUBSCRIPTION_NOT_FOUND,
+        message: `No subscription for tenant ${tenantId}`,
+        params: {
+          tenantId
+        }
+      });
     }
     const limits = await this.deriveLimits(sub, now);
     this.writeCache(tenantId, limits, now.getTime());
@@ -2430,7 +2489,7 @@ var EntitlementService = class {
     return Promise.all(active.map(async (booking) => {
       const bv = await this.bundles.findVersionById(booking.bundleVersionId, tx);
       if (!bv) {
-        throw new Error(`BundleVersion '${booking.bundleVersionId}' aus aktiver SubscriptionBundle nicht gefunden`);
+        throw new Error(`BundleVersion '${booking.bundleVersionId}' from an active subscription bundle not found`);
       }
       return {
         bundleKey: bv.bundleKey,
@@ -2452,12 +2511,21 @@ var EntitlementService = class {
     return this.tx.run(async (tx) => {
       const sub = await this.subscriptions.findByTenantIdLocked(input.tenantId, tx);
       if (!sub) {
-        throw new import_common17.NotFoundException(`Keine Subscription f\xFCr Tenant ${input.tenantId}`);
+        throw new import_common17.NotFoundException({
+          code: import_types6.BILLING_ERROR_CODES.SUBSCRIPTION_NOT_FOUND,
+          message: `No subscription for tenant ${input.tenantId}`,
+          params: {
+            tenantId: input.tenantId
+          }
+        });
       }
       const limits = await this.deriveLimits(sub, now, tx);
       const max = limits.quotas[input.dimension];
       if (max === void 0) {
-        throw new Error(`Quota-Dimension "${input.dimension}" nicht im PlanCatalog (${this.catalog.projectKey}).`);
+        throw new import_common17.InternalServerErrorException(codedError(import_types6.BILLING_ERROR_CODES.QUOTA_DIMENSION_UNKNOWN, {
+          dimension: input.dimension,
+          projectKey: this.catalog.projectKey
+        }));
       }
       const used = await input.currentUsage(tx, input.tenantId);
       if (max !== -1 && used + delta > max) {
@@ -2478,7 +2546,15 @@ var EntitlementService = class {
   async findActivePlanVersionOrFallback(planId, asOf, tx) {
     const v = this.planVersions.findActive ? await this.planVersions.findActive(planId, asOf, tx) : await this.planVersions.findLatestLive(planId, tx);
     if (!v) {
-      throw new import_common17.NotFoundException(`Keine zu ${asOf.toISOString().slice(0, 10)} aktive PlanVersion f\xFCr ${planId} \u2014 weder validFrom-window erf\xFCllt noch latest-live verf\xFCgbar.`);
+      const asOfDate = asOf.toISOString().slice(0, 10);
+      throw new import_common17.NotFoundException({
+        code: import_types6.BILLING_ERROR_CODES.NO_ACTIVE_PLAN_VERSION,
+        message: `No plan version for ${planId} active as of ${asOfDate} \u2014 neither the validFrom window is satisfied nor is a latest-live version available.`,
+        params: {
+          planId,
+          asOf: asOfDate
+        }
+      });
     }
     return v;
   }
@@ -2581,11 +2657,21 @@ var FeatureGuard = class _FeatureGuard {
     if (!required || required.length === 0) return true;
     const request = context.switchToHttp().getRequest();
     const user = request.user;
-    if (!user) throw new import_common18.ForbiddenException("Nicht authentifiziert");
+    if (!user) {
+      throw new import_common18.ForbiddenException({
+        code: import_types7.AUTH_ERROR_CODES.NOT_AUTHENTICATED,
+        message: "Not authenticated"
+      });
+    }
     const role = this.config?.userRoleResolver ? this.config.userRoleResolver(user) : user.role ?? user.platformRole;
     if (role === "SUPER_ADMIN") return true;
     const tenantId = this.config?.tenantIdResolver ? this.config.tenantIdResolver(request) : request.tenantId ?? user.tenantId;
-    if (!tenantId) throw new import_common18.ForbiddenException("Kein Mandant zugeordnet");
+    if (!tenantId) {
+      throw new import_common18.ForbiddenException({
+        code: import_types7.AUTH_ERROR_CODES.NO_TENANT_ASSIGNED,
+        message: "No tenant assigned"
+      });
+    }
     const compute = /* @__PURE__ */ __name(() => this.entitlements.computeLimits(tenantId), "compute");
     const limits = this.config?.tenantContextRunner ? await this.config.tenantContextRunner(tenantId, compute) : await compute();
     const allowed = required.some((f) => limits.features.has(f));
@@ -2595,25 +2681,27 @@ var FeatureGuard = class _FeatureGuard {
     return true;
   }
   /**
-   * Upsell response (#36): with a registered `UpsellOfferResolver` the 403
-   * becomes machine-readable (`FeatureNotLicensedBody`), so consumer UIs can
-   * render a purchase offer. Without a resolver the previous plain 403
-   * remains — no breaking change.
+   * Upsell response (#36): the 403 body is always the full
+   * `FeatureNotLicensedBody`, so a consumer that matches on `code` can read
+   * `featureKey`/`offers` unconditionally. Without a registered
+   * `UpsellOfferResolver` there is simply nothing to offer — `offers` is
+   * empty, the same degradation a failing resolver produces.
    *
    * Deliberately 403 + `code` field instead of 402 — rationale in
    * `@saasicat/types` upsell.types.ts (402 is reserved / inconsistently
    * supported; SPA interceptors must not treat the 403 as an auth error, the
    * distinction runs through `code`).
+   *
+   * The message must keep starting with the word `Feature` — consumers
+   * classify the response by that prefix.
    */
   async buildNotLicensedException(required, tenantId) {
-    const message = `Feature ${required.join(" / ")} nicht im aktuellen Paket enthalten.`;
-    if (!this.upsellResolver) return new import_common18.ForbiddenException(message);
     const body = {
-      code: import_types2.FEATURE_NOT_LICENSED,
+      code: import_types7.FEATURE_NOT_LICENSED,
       featureKey: required[0],
       featureKeys: required,
-      offers: await this.resolveOffersSafe(required, tenantId),
-      message
+      offers: this.upsellResolver ? await this.resolveOffersSafe(required, tenantId) : [],
+      message: `Feature ${required.join(" / ")} is not included in the current plan.`
     };
     return new import_common18.ForbiddenException(body);
   }
@@ -2625,7 +2713,7 @@ var FeatureGuard = class _FeatureGuard {
     try {
       return await this.upsellResolver.resolveOffers(required, tenantId);
     } catch (error) {
-      this.logger.warn(`UpsellOfferResolver fehlgeschlagen f\xFCr [${required.join(", ")}]: ${String(error)}`);
+      this.logger.warn(`UpsellOfferResolver failed for [${required.join(", ")}]: ${String(error)}`);
       return [];
     }
   }
@@ -2649,7 +2737,7 @@ FeatureGuard = _ts_decorate16([
 
 // src/billing/catalog-bundle-upsell-resolver.ts
 var import_common19 = require("@nestjs/common");
-var import_types3 = require("@saasicat/types");
+var import_types8 = require("@saasicat/types");
 
 // src/billing/public-catalog.tokens.ts
 var PUBLIC_CATALOG_PROJECT_KEY_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform/PublicCatalogProjectKey");
@@ -2719,7 +2807,7 @@ var CatalogBundleUpsellResolver = class {
     const rows = await this.catalogEntryRepo.listFeatures({
       projectKey: this.projectKey
     });
-    return (0, import_types3.collectUnsatisfiedRequires)(featureKeys, (0, import_types3.buildFeatureRequiresIndex)(rows));
+    return (0, import_types8.collectUnsatisfiedRequires)(featureKeys, (0, import_types8.buildFeatureRequiresIndex)(rows));
   }
   /** Only published-and-live AND marketed — non-marketed bundles are not an offer. */
   async listLiveMarketedBundles() {
@@ -2778,6 +2866,7 @@ __name(compareRankedOffers, "compareRankedOffers");
 // src/billing/limit-exceeded.filter.ts
 var import_common20 = require("@nestjs/common");
 var import_core3 = require("@nestjs/core");
+var import_types9 = require("@saasicat/types");
 function _ts_decorate18(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -2798,11 +2887,14 @@ var LimitExceededFilter = class _LimitExceededFilter extends import_core3.BaseEx
     const ctx = host.switchToHttp();
     const response = ctx.getResponse();
     const request = ctx.getRequest();
-    this.logger.warn(`Limit ${exception.dimension} \xFCberschritten: ${exception.used}/${exception.max} bei ${request.method ?? "?"} ${request.url ?? ""}`);
+    this.logger.warn(`Limit ${exception.dimension} exceeded: ${exception.used}/${exception.max} on ${request.method ?? "?"} ${request.url ?? ""}`);
     response.status(import_common20.HttpStatus.PAYMENT_REQUIRED).send({
       statusCode: import_common20.HttpStatus.PAYMENT_REQUIRED,
       error: "PaymentRequired",
-      reason: "LIMIT_EXCEEDED",
+      code: import_types9.BILLING_ERROR_CODES.LIMIT_EXCEEDED,
+      // Deprecated: superseded by `code`, kept until consumers have
+      // migrated. Same value, only under the older field name.
+      reason: import_types9.BILLING_ERROR_CODES.LIMIT_EXCEEDED,
       dimension: exception.dimension,
       used: exception.used,
       max: exception.max,
@@ -2828,8 +2920,8 @@ var PlanCatalogValidationError = class extends Error {
   source;
   errors;
   constructor(source, errors) {
-    const messages = errors.map((e) => `${e.instancePath || "/"}: ${e.message ?? "unbekannt"}`).join("\n  ");
-    super(`Plan-Catalog-Validierung fehlgeschlagen f\xFCr ${source}:
+    const messages = errors.map((e) => `${e.instancePath || "/"}: ${e.message ?? "unknown"}`).join("\n  ");
+    super(`Plan catalog validation failed for ${source}:
   ${messages}`), this.source = source, this.errors = errors;
     this.name = "PlanCatalogValidationError";
   }
@@ -2846,7 +2938,7 @@ __name(loadPlanCatalogFromFile, "loadPlanCatalogFromFile");
 function loadPlanCatalogFromString(yamlContent, opts) {
   const parsed = import_js_yaml.default.load(yamlContent);
   if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-    throw new Error(`YAML-Inhalt von ${opts.source} ist kein Objekt`);
+    throw new Error(`The YAML content of ${opts.source} is not an object`);
   }
   const ajv = new import__.default({
     strict: false,
@@ -2870,19 +2962,19 @@ function validateConsistency(catalog, source) {
   const planIds = /* @__PURE__ */ new Set();
   for (const plan of catalog.plans ?? []) {
     if (planIds.has(plan.id)) {
-      errors.push(`plans[].id: Doppelte Plan-ID "${plan.id}"`);
+      errors.push(`plans[].id: duplicate plan id "${plan.id}"`);
     }
     planIds.add(plan.id);
     if (catalog.features) {
       for (const fk of plan.features) {
         if (!declaredFeatureKeys.has(fk)) {
-          errors.push(`plans[id=${plan.id}].features: Unbekannter featureKey "${fk}" \u2014 nicht in catalog.features deklariert`);
+          errors.push(`plans[id=${plan.id}].features: Unknown featureKey "${fk}" \u2014 not declared in catalog.features`);
         }
       }
     }
   }
   if (errors.length > 0) {
-    const err = new Error(`Plan-Catalog-Konsistenz-Fehler in ${source}:
+    const err = new Error(`Plan catalog consistency error in ${source}:
   ${errors.join("\n  ")}`);
     err.name = "PlanCatalogConsistencyError";
     throw err;
@@ -2965,7 +3057,7 @@ var PlanCatalogImporterService = class {
       if (planResult.created) report.plansCreated++;
       else report.plansSkipped++;
       if (plan.monthlyNet === null || plan.monthlyNet === void 0) {
-        report.warnings.push(`Plan '${plan.id}' hat keinen monthlyNet \u2014 \xFCbersprungen (auf-Anfrage-Plans brauchen manuelle PlanVersion).`);
+        report.warnings.push(`Plan '${plan.id}' has no monthlyNet \u2014 skipped (on-request plans need a manual plan version).`);
         continue;
       }
       const versionResult = await this.sink.upsertPlanVersion({
@@ -3114,7 +3206,7 @@ var FEATURE_UI_REGISTRY_TOKEN2 = /* @__PURE__ */ Symbol.for("saas-platform/Featu
 
 // src/billing/public-catalog.controller.ts
 var import_common24 = require("@nestjs/common");
-var import_types4 = require("@saasicat/types");
+var import_types10 = require("@saasicat/types");
 function _ts_decorate22(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -3234,7 +3326,7 @@ var PublicCatalogController = class {
       const rows = await this.catalogEntryRepo.listFeatures({
         projectKey: this.projectKey
       });
-      return (0, import_types4.buildFeatureRequiresIndex)(rows);
+      return (0, import_types10.buildFeatureRequiresIndex)(rows);
     } catch {
       return /* @__PURE__ */ new Map();
     }
@@ -3274,7 +3366,7 @@ var PublicCatalogController = class {
       quotas: live.quotas,
       monthlyNet: live.monthlyNet,
       yearlyNet: live.yearlyNet,
-      requiresFeatures: (0, import_types4.collectUnsatisfiedRequires)(features, requiresIndex),
+      requiresFeatures: (0, import_types10.collectUnsatisfiedRequires)(features, requiresIndex),
       marketing
     };
   }
@@ -3398,6 +3490,7 @@ var PENDING_PLAN_QUERY_PORT_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform/Pe
 
 // src/billing/composed-tenant-auth.guard.ts
 var import_common26 = require("@nestjs/common");
+var import_types11 = require("@saasicat/types");
 function _ts_decorate24(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -3425,7 +3518,10 @@ var ComposedTenantAuthGuard = class {
   }
   async canActivate(context) {
     if (!this.guards || this.guards.length === 0) {
-      throw new import_common26.ForbiddenException("TenantBillingModule.forRoot.authGuards ist nicht konfiguriert.");
+      throw new import_common26.ForbiddenException({
+        code: import_types11.AUTH_ERROR_CODES.AUTH_GUARDS_NOT_CONFIGURED,
+        message: "TenantBillingModule.forRoot.authGuards is not configured."
+      });
     }
     for (const guard of this.guards) {
       const result = await Promise.resolve(guard.canActivate(context));
@@ -3446,6 +3542,7 @@ ComposedTenantAuthGuard = _ts_decorate24([
 
 // src/billing/tenant-admin.guard.ts
 var import_common27 = require("@nestjs/common");
+var import_types12 = require("@saasicat/types");
 function _ts_decorate25(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -3464,11 +3561,17 @@ var TenantAdminGuard = class {
   canActivate(context) {
     const request = context.switchToHttp().getRequest();
     if (!request.user) {
-      throw new import_common27.ForbiddenException("Nicht authentifiziert");
+      throw new import_common27.ForbiddenException({
+        code: import_types12.AUTH_ERROR_CODES.NOT_AUTHENTICATED,
+        message: "Not authenticated"
+      });
     }
     const role = request.user.platformRole ?? request.user.role;
     if (!role || !ADMIN_ROLES.has(role)) {
-      throw new import_common27.ForbiddenException("Diese Aktion erfordert die TENANT_ADMIN-Rolle.");
+      throw new import_common27.ForbiddenException({
+        code: import_types12.AUTH_ERROR_CODES.TENANT_ADMIN_REQUIRED,
+        message: "This action requires the TENANT_ADMIN role."
+      });
     }
     return true;
   }
@@ -3506,6 +3609,7 @@ __name(round22, "round2");
 
 // src/billing/plan-change-preview.service.ts
 var import_common29 = require("@nestjs/common");
+var import_types13 = require("@saasicat/types");
 
 // src/entitlement/index.ts
 var entitlement_exports = {};
@@ -3634,11 +3738,24 @@ var PlanChangePreviewService = class {
   async preview(tenantId, targetPlan, targetCycle, now = /* @__PURE__ */ new Date()) {
     const sub = await this.subscriptions.findForTenant(tenantId);
     if (!sub) {
-      throw new import_common29.NotFoundException(`Keine Subscription f\xFCr Tenant ${tenantId}`);
+      throw new import_common29.NotFoundException({
+        code: import_types13.BILLING_ERROR_CODES.SUBSCRIPTION_NOT_FOUND,
+        message: `No subscription for tenant ${tenantId}`,
+        params: {
+          tenantId
+        }
+      });
     }
     const targetPlanDef = findPlan(this.catalog, targetPlan);
     if (!targetPlanDef) {
-      throw new import_common29.NotFoundException(`Plan "${targetPlan}" nicht im Catalog (${this.catalog.projectKey})`);
+      throw new import_common29.NotFoundException({
+        code: import_types13.BILLING_ERROR_CODES.PLAN_NOT_IN_CATALOG,
+        message: `Plan "${targetPlan}" is not in the catalog (${this.catalog.projectKey})`,
+        params: {
+          planKey: targetPlan,
+          projectKey: this.catalog.projectKey
+        }
+      });
     }
     const ctx = {
       currentPeriodStart: sub.currentPeriodStart,
@@ -3703,13 +3820,13 @@ var PlanChangePreviewService = class {
     if (blockedTargets.includes(targetPlan)) {
       blockers.push({
         code: `${targetPlan}_NOT_SELF_SERVICE`,
-        message: `${targetSnap.name} wird nur per Sondervertrag aktiviert. Bitte den Vertragsbetreuer kontaktieren.`
+        message: `${targetSnap.name} is only activated via a special contract. Please contact the contract manager.`
       });
     }
     if (blockedSources.includes(sub.plan)) {
       blockers.push({
         code: `${sub.plan}_LOCKED`,
-        message: `Aktiver ${currentSnap.name}-Sondervertrag \u2014 bitte den Vertragsbetreuer f\xFCr Plan-Wechsel kontaktieren.`
+        message: `Active ${currentSnap.name} special contract \u2014 please contact the contract manager to change plans.`
       });
     }
     for (const [key, row] of Object.entries(limitsCheck)) {
@@ -3717,19 +3834,19 @@ var PlanChangePreviewService = class {
       const usedDisplay = isFloatQuota(key) ? row.used.toFixed(1) : row.used.toString();
       blockers.push({
         code: `${key.toUpperCase()}_OVER_TARGET`,
-        message: `Aktueller Verbrauch ${usedDisplay} \xFCberschreitet das Ziel-Limit ${row.targetMax} (${key}) im ${targetSnap.name}-Paket. Bitte Verbrauch reduzieren.`
+        message: `Current usage ${usedDisplay} exceeds the target limit ${row.targetMax} (${key}) in the ${targetSnap.name} plan. Please reduce usage first.`
       });
     }
     if (featuresLost.length > 0) {
       warnings.push({
         code: "FEATURES_LOST",
-        message: `Mit dem Wechsel verlierst du Zugriff auf ${featuresLost.length} Feature${featuresLost.length === 1 ? "" : "s"}. Bestehende Daten bleiben erhalten und werden nicht gel\xF6scht \u2014 du kannst sie wieder freischalten, wenn du erneut upgradest.`
+        message: `Switching means losing access to ${featuresLost.length} feature${featuresLost.length === 1 ? "" : "s"}. Existing data is retained and never deleted \u2014 upgrading again unlocks it.`
       });
     }
     if (changeType === "NOOP") {
       warnings.push({
         code: "NO_CHANGE",
-        message: "Ziel-Paket und Abrechnungszyklus stimmen mit dem aktuellen Stand \xFCberein."
+        message: "Target plan and billing cycle already match the current state."
       });
     }
     const projectedTrialEndsAt = this.trialProjection && sub.status === "TRIAL" ? await this.trialProjection.projectTrialEndsAt({
@@ -3887,13 +4004,13 @@ var PendingPlanMaterializationService = class _PendingPlanMaterializationService
         this.entitlements.invalidateTenant(change.tenantId);
         applied += 1;
       } catch (err) {
-        this.logger.error(`Pending-Plan-Materialisierung fehlgeschlagen (tenant ${change.tenantId}): ${String(err)}`);
+        this.logger.error(`Pending plan materialisation failed (tenant ${change.tenantId}): ${String(err)}`);
         continue;
       }
       await this.tryFreeze(change.tenantId, change.pendingPlan, cycle, now);
     }
     if (applied > 0) {
-      this.logger.log(`Pending-Plan-Materialisierung: ${applied} geplante(r) Plan-Wechsel angewandt.`);
+      this.logger.log(`Pending plan materialisation: applied ${applied} scheduled plan change(s).`);
     }
     return {
       applied
@@ -3904,7 +4021,7 @@ var PendingPlanMaterializationService = class _PendingPlanMaterializationService
     try {
       await this.contractFreeze.freezeOnPlanChange(tenantId, plan, cycle, now);
     } catch (err) {
-      this.logger.error(`Contract-Freeze nach Materialisierung fehlgeschlagen (tenant ${tenantId}): ${String(err)}`);
+      this.logger.error(`Contract freeze after materialisation failed (tenant ${tenantId}): ${String(err)}`);
     }
   }
 };
@@ -3978,7 +4095,7 @@ function createDiscountLineItem(input, discountNet) {
     kind: "discount",
     sourceKey: promoCode?.code ?? firstPromotion?.id ?? "price-discount",
     sourceVersionId: null,
-    titleSnapshot: promoCode?.label ?? firstPromotion?.label ?? "Rabatt",
+    titleSnapshot: promoCode?.label ?? firstPromotion?.label ?? "Discount",
     descriptionSnapshot: promoCode ? `Promo-Code ${promoCode.code}` : null,
     quantity: 1,
     unit: null,
@@ -4021,6 +4138,7 @@ function cloneJsonValue(value) {
 __name(cloneJsonValue, "cloneJsonValue");
 
 // src/subscription-contract/subscription-contract.service.ts
+var import_types14 = require("@saasicat/types");
 function _ts_decorate29(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -4052,7 +4170,13 @@ var SubscriptionContractService = class {
   async getById(contractId) {
     const row = await this.repo.findById(contractId);
     if (!row) {
-      throw new import_common31.NotFoundException(`SubscriptionContract '${contractId}' nicht gefunden`);
+      throw new import_common31.NotFoundException({
+        code: import_types14.CONTRACT_ERROR_CODES.SUBSCRIPTION_CONTRACT_NOT_FOUND,
+        message: `SubscriptionContract '${contractId}' not found`,
+        params: {
+          contractId
+        }
+      });
     }
     return row;
   }
@@ -4062,7 +4186,14 @@ var SubscriptionContractService = class {
   async getActiveInvoiceSnapshotForTenant(tenantId, asOf = /* @__PURE__ */ new Date()) {
     const contract = await this.repo.findActiveByTenantId(tenantId, asOf);
     if (!contract) {
-      throw new import_common31.NotFoundException(`Kein aktiver SubscriptionContract f\xFCr Tenant ${tenantId}`);
+      throw new import_common31.NotFoundException({
+        code: import_types14.CONTRACT_ERROR_CODES.NO_ACTIVE_SUBSCRIPTION_CONTRACT,
+        message: `No active subscription contract for tenant ${tenantId}`,
+        params: {
+          tenantId,
+          asOf: asOf.toISOString()
+        }
+      });
     }
     return subscriptionContractToInvoiceSnapshot(contract);
   }
@@ -4095,7 +4226,14 @@ var SubscriptionContractService = class {
   }
   createDataFromOffer(offer, options) {
     if (offer.status !== "consumed") {
-      throw new import_common31.ConflictException(`CheckoutOffer '${offer.id}' muss vor Contract-Erstellung consumed sein`);
+      throw new import_common31.ConflictException({
+        code: import_types14.CONTRACT_ERROR_CODES.CHECKOUT_OFFER_NOT_CONSUMED,
+        message: `CheckoutOffer '${offer.id}' must be consumed before the contract is created`,
+        params: {
+          offerId: offer.id,
+          status: offer.status
+        }
+      });
     }
     const lineItems = this.lineItemsFromOffer(offer);
     return {
@@ -4128,8 +4266,8 @@ var SubscriptionContractService = class {
     const source = offer.lineItems ?? [];
     if (source.length === 0) {
       throw new import_common31.UnprocessableEntityException({
-        code: "CHECKOUT_OFFER_LINE_ITEMS_REQUIRED",
-        message: "Aus einem CheckoutOffer kann nur ein Contract entstehen, wenn LineItems eingefroren sind."
+        code: import_types14.CONTRACT_ERROR_CODES.CHECKOUT_OFFER_LINE_ITEMS_REQUIRED,
+        message: "A checkout offer can yield only one contract, and only once its line items are frozen."
       });
     }
     return appendImplicitDiscountLineItem({
@@ -4167,8 +4305,11 @@ var SubscriptionContractService = class {
     const date = value instanceof Date ? new Date(value) : new Date(value);
     if (Number.isNaN(date.getTime())) {
       throw new import_common31.UnprocessableEntityException({
-        code: "SUBSCRIPTION_CONTRACT_INVALID_DATE",
-        message: `${field} muss ein g\xFCltiges Datum sein.`
+        code: import_types14.CONTRACT_ERROR_CODES.SUBSCRIPTION_CONTRACT_INVALID_DATE,
+        message: `${field} must be a valid date.`,
+        params: {
+          field
+        }
       });
     }
     return date;
@@ -4188,32 +4329,39 @@ var SubscriptionContractService = class {
   assertCreateData(data) {
     if (data.lineItems.length === 0) {
       throw new import_common31.UnprocessableEntityException({
-        code: "SUBSCRIPTION_CONTRACT_LINE_ITEMS_REQUIRED",
-        message: "SubscriptionContract ben\xF6tigt mindestens eine LineItem."
+        code: import_types14.CONTRACT_ERROR_CODES.SUBSCRIPTION_CONTRACT_LINE_ITEMS_REQUIRED,
+        message: "A subscription contract requires at least one line item."
       });
     }
     if (data.effectiveUntil && data.effectiveUntil <= data.effectiveFrom) {
       throw new import_common31.UnprocessableEntityException({
-        code: "SUBSCRIPTION_CONTRACT_INVALID_WINDOW",
-        message: "effectiveUntil muss nach effectiveFrom liegen."
+        code: import_types14.CONTRACT_ERROR_CODES.SUBSCRIPTION_CONTRACT_INVALID_WINDOW,
+        message: "effectiveUntil must be after effectiveFrom."
       });
     }
     const planLineItems = data.lineItems.filter((item) => item.kind === "plan");
     if (planLineItems.length !== 1) {
       throw new import_common31.UnprocessableEntityException({
-        code: "SUBSCRIPTION_CONTRACT_PLAN_LINE_ITEM_REQUIRED",
-        message: "SubscriptionContract ben\xF6tigt genau eine Plan-Grundposition."
+        code: import_types14.CONTRACT_ERROR_CODES.SUBSCRIPTION_CONTRACT_PLAN_LINE_ITEM_REQUIRED,
+        message: "A subscription contract requires exactly one plan base item."
       });
     }
   }
   assertTerminable(existing, data) {
     if (existing.status === "terminated" || existing.status === "superseded") {
-      throw new import_common31.ConflictException(`SubscriptionContract '${existing.id}' ist bereits geschlossen`);
+      throw new import_common31.ConflictException({
+        code: import_types14.CONTRACT_ERROR_CODES.SUBSCRIPTION_CONTRACT_ALREADY_CLOSED,
+        message: `SubscriptionContract '${existing.id}' is already closed`,
+        params: {
+          contractId: existing.id,
+          status: existing.status
+        }
+      });
     }
     if (data.effectiveUntil <= existing.effectiveFrom) {
       throw new import_common31.UnprocessableEntityException({
-        code: "SUBSCRIPTION_CONTRACT_TERMINATION_BEFORE_START",
-        message: "effectiveUntil muss nach effectiveFrom des Contracts liegen."
+        code: import_types14.CONTRACT_ERROR_CODES.SUBSCRIPTION_CONTRACT_TERMINATION_BEFORE_START,
+        message: "effectiveUntil must be after the effectiveFrom of the contract."
       });
     }
   }
@@ -4505,14 +4653,14 @@ var PreviewPlanChangeDto = class {
 _ts_decorate32([
   (0, import_class_validator3.IsString)(),
   (0, import_class_validator3.Matches)(PLAN_OR_CYCLE_PATTERN, {
-    message: "plan muss SCREAMING_SNAKE_CASE sein"
+    message: "plan must be SCREAMING_SNAKE_CASE"
   }),
   _ts_metadata22("design:type", String)
 ], PreviewPlanChangeDto.prototype, "plan", void 0);
 _ts_decorate32([
   (0, import_class_validator3.IsString)(),
   (0, import_class_validator3.Matches)(PLAN_OR_CYCLE_PATTERN, {
-    message: "billingCycle muss SCREAMING_SNAKE_CASE sein (z. B. MONTHLY, YEARLY)"
+    message: "billingCycle must be SCREAMING_SNAKE_CASE (e.g. MONTHLY, YEARLY)"
   }),
   _ts_metadata22("design:type", String)
 ], PreviewPlanChangeDto.prototype, "billingCycle", void 0);
@@ -4576,14 +4724,14 @@ var CompleteOnboardingSubscriptionDto = class {
 _ts_decorate33([
   (0, import_class_validator4.IsString)(),
   (0, import_class_validator4.Matches)(PLAN_OR_CYCLE_PATTERN2, {
-    message: "plan muss SCREAMING_SNAKE_CASE sein"
+    message: "plan must be SCREAMING_SNAKE_CASE"
   }),
   _ts_metadata23("design:type", String)
 ], CompleteOnboardingSubscriptionDto.prototype, "plan", void 0);
 _ts_decorate33([
   (0, import_class_validator4.IsString)(),
   (0, import_class_validator4.Matches)(PLAN_OR_CYCLE_PATTERN2, {
-    message: "billingCycle muss SCREAMING_SNAKE_CASE sein (z. B. MONTHLY, YEARLY)"
+    message: "billingCycle must be SCREAMING_SNAKE_CASE (e.g. MONTHLY, YEARLY)"
   }),
   _ts_metadata23("design:type", String)
 ], CompleteOnboardingSubscriptionDto.prototype, "billingCycle", void 0);
@@ -4591,7 +4739,7 @@ _ts_decorate33([
   (0, import_class_validator4.IsOptional)(),
   (0, import_class_validator4.IsString)(),
   (0, import_class_validator4.Matches)(PROMO_CODE_PATTERN, {
-    message: 'promoCode muss aus A\u2013Z, 0\u20139, "-", "_" bestehen (4\u201332 Zeichen)'
+    message: 'promoCode must consist of A\u2013Z, 0\u20139, "-", "_" (4\u201332 characters)'
   }),
   _ts_metadata23("design:type", String)
 ], CompleteOnboardingSubscriptionDto.prototype, "promoCode", void 0);
@@ -4607,9 +4755,11 @@ _ts_decorate33([
 
 // src/billing/tenant-billing.controller.ts
 var import_common36 = require("@nestjs/common");
+var import_types17 = require("@saasicat/types");
 
 // src/promo/service.ts
 var import_common34 = require("@nestjs/common");
+var import_types15 = require("@saasicat/types");
 
 // src/promo/tokens.ts
 var PROMO_CODE_REPOSITORY_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform/PromoCodeRepository");
@@ -4663,15 +4813,15 @@ function buildLabel(code, cycle) {
     maximumFractionDigits: 2
   })} \u20AC`;
   if (code.durationType === "ONCE") {
-    return `${valueStr} einmalig`;
+    return `${valueStr} once`;
   }
   if (code.durationType === "MONTHS") {
     const m = code.durationValue ?? 0;
-    return m === 1 ? `${valueStr} im ersten Monat` : `${valueStr} f\xFCr ${m} Monate`;
+    return m === 1 ? `${valueStr} for the first month` : `${valueStr} for ${m} months`;
   }
   const n = code.durationValue ?? 0;
-  if (n === 1) return cycle === "YEARLY" ? `${valueStr} im ersten Jahr` : `${valueStr} im ersten Monat`;
-  return cycle === "YEARLY" ? `${valueStr} in den ersten ${n} Jahren` : `${valueStr} in den ersten ${n} Monaten`;
+  if (n === 1) return cycle === "YEARLY" ? `${valueStr} for the first year` : `${valueStr} for the first month`;
+  return cycle === "YEARLY" ? `${valueStr} for the first ${n} years` : `${valueStr} for the first ${n} months`;
 }
 __name(buildLabel, "buildLabel");
 
@@ -4693,7 +4843,23 @@ function _ts_param22(paramIndex, decorator) {
   };
 }
 __name(_ts_param22, "_ts_param");
-var CODE_PATTERN = /^[A-Z0-9_-]{4,32}$/;
+var CODE_MIN_LENGTH = 4;
+var CODE_MAX_LENGTH = 32;
+var CODE_PATTERN = new RegExp(`^[A-Z0-9_-]{${CODE_MIN_LENGTH},${CODE_MAX_LENGTH}}$`);
+var PERCENT_MIN_EXCLUSIVE = 0;
+var PERCENT_MAX = 100;
+var DURATION_MIN = 1;
+var DURATION_MAX = 24;
+function notRedeemable(reason) {
+  return new import_common34.BadRequestException({
+    code: import_types15.PROMO_ERROR_CODES.PROMO_CODE_NOT_REDEEMABLE,
+    message: `Code cannot be redeemed: ${reason}`,
+    params: {
+      reason
+    }
+  });
+}
+__name(notRedeemable, "notRedeemable");
 var PromoCodesService = class {
   static {
     __name(this, "PromoCodesService");
@@ -4722,46 +4888,118 @@ var PromoCodesService = class {
   async create(input) {
     const code = input.code.trim().toUpperCase();
     if (!CODE_PATTERN.test(code)) {
-      throw new import_common34.BadRequestException('Code darf nur Gro\xDFbuchstaben, Ziffern, \u201E-" und \u201E_" enthalten (4\u201332 Zeichen).');
+      throw new import_common34.BadRequestException({
+        code: import_types15.PROMO_ERROR_CODES.PROMO_CODE_FORMAT_INVALID,
+        message: 'The code may only contain upper-case letters, digits, "-" and "_" (4\u201332 characters).',
+        params: {
+          promoCode: code,
+          minLength: CODE_MIN_LENGTH,
+          maxLength: CODE_MAX_LENGTH
+        }
+      });
     }
     if (input.valueType === "PERCENT") {
-      if (!(input.value > 0 && input.value <= 100)) {
-        throw new import_common34.BadRequestException("Prozentsatz muss zwischen 0 und 100 liegen.");
+      if (!(input.value > PERCENT_MIN_EXCLUSIVE && input.value <= PERCENT_MAX)) {
+        throw new import_common34.BadRequestException({
+          code: import_types15.PROMO_ERROR_CODES.PROMO_PERCENT_OUT_OF_RANGE,
+          message: "The percentage must be between 0 and 100.",
+          params: {
+            value: input.value,
+            min: PERCENT_MIN_EXCLUSIVE,
+            max: PERCENT_MAX
+          }
+        });
       }
     } else if (!(input.value > 0)) {
-      throw new import_common34.BadRequestException("Betrag muss positiv sein.");
+      throw new import_common34.BadRequestException({
+        code: import_types15.PROMO_ERROR_CODES.PROMO_AMOUNT_NOT_POSITIVE,
+        message: "The amount must be positive.",
+        params: {
+          value: input.value,
+          min: 0
+        }
+      });
     }
     if (input.durationType === "ONCE") {
       if (input.durationValue != null) {
-        throw new import_common34.BadRequestException("Bei einmaligem Rabatt darf keine Laufzeit gesetzt sein.");
+        throw new import_common34.BadRequestException({
+          code: import_types15.PROMO_ERROR_CODES.PROMO_ONE_OFF_WITH_DURATION,
+          message: "A one-off discount must not set a duration.",
+          params: {
+            durationValue: input.durationValue
+          }
+        });
       }
     } else {
       const v = input.durationValue;
-      if (v == null || v < 1 || v > 24) {
-        throw new import_common34.BadRequestException("Laufzeit ung\xFCltig (max. 24 Monate bzw. Abrechnungsperioden).");
+      if (v == null || v < DURATION_MIN || v > DURATION_MAX) {
+        throw new import_common34.BadRequestException({
+          code: import_types15.PROMO_ERROR_CODES.PROMO_DURATION_INVALID,
+          message: "Invalid duration (at most 24 months or billing periods).",
+          params: {
+            durationValue: v ?? null,
+            min: DURATION_MIN,
+            max: DURATION_MAX
+          }
+        });
       }
     }
     if (input.validFrom && input.validUntil && input.validFrom >= input.validUntil) {
-      throw new import_common34.BadRequestException("G\xFCltigkeits-Fenster ung\xFCltig.");
+      throw new import_common34.BadRequestException({
+        code: import_types15.PROMO_ERROR_CODES.PROMO_VALIDITY_WINDOW_INVALID,
+        message: "Invalid validity window.",
+        params: {
+          validFrom: input.validFrom.toISOString(),
+          validUntil: input.validUntil.toISOString()
+        }
+      });
     }
     const plans = input.appliesToPlans ?? [];
     const blocked = this.config.nonRedeemablePlans ?? [];
     for (const p of plans) {
       if (blocked.includes(p)) {
-        throw new import_common34.BadRequestException(`${p}-Plan kann nicht rabattiert werden.`);
+        throw new import_common34.BadRequestException({
+          code: import_types15.PROMO_ERROR_CODES.PROMO_PLAN_NOT_DISCOUNTABLE,
+          message: `${p}-Plan cannot be discounted.`,
+          params: {
+            plan: p
+          }
+        });
       }
     }
     if (input.minimumPlanAmountGross != null && input.minimumPlanAmountGross <= 0) {
-      throw new import_common34.BadRequestException("Mindest-Plan-Brutto muss positiv sein.");
+      throw new import_common34.BadRequestException({
+        code: import_types15.PROMO_ERROR_CODES.PROMO_MIN_AMOUNT_NOT_POSITIVE,
+        message: "The minimum plan gross amount must be positive.",
+        params: {
+          value: input.minimumPlanAmountGross,
+          min: 0
+        }
+      });
     }
     if (input.valueType === "ABSOLUTE" && !input.allowZeroInvoice) {
       const lowestApplicableGross = this.lowestApplicablePlanGross(plans);
       if (lowestApplicableGross != null && input.value >= lowestApplicableGross) {
-        throw new import_common34.BadRequestException("Bei Absolutbetr\xE4gen muss der Rabatt unter dem niedrigsten anwendbaren Plan-Preis liegen oder allowZeroInvoice aktiviert sein.");
+        throw new import_common34.BadRequestException({
+          code: import_types15.PROMO_ERROR_CODES.PROMO_WOULD_PRODUCE_ZERO_INVOICE,
+          message: "For absolute amounts the discount must stay below the lowest applicable plan price, or allowZeroInvoice must be enabled.",
+          params: {
+            value: input.value,
+            lowestApplicablePlanGross: lowestApplicableGross
+          }
+        });
       }
     }
     const exists = await this.promoRepo.findByCode(code);
-    if (exists) throw new import_common34.BadRequestException("Code existiert bereits.");
+    if (exists) {
+      throw new import_common34.BadRequestException({
+        code: import_types15.PROMO_ERROR_CODES.PROMO_CODE_ALREADY_EXISTS,
+        message: "The code already exists.",
+        params: {
+          promoCode: code
+        }
+      });
+    }
     return this.promoRepo.create({
       ...input,
       code
@@ -4769,10 +5007,26 @@ var PromoCodesService = class {
   }
   async update(id, input) {
     const existing = await this.promoRepo.findById(id);
-    if (!existing) throw new import_common34.NotFoundException("Code nicht gefunden");
+    if (!existing) {
+      throw new import_common34.NotFoundException({
+        code: import_types15.PROMO_ERROR_CODES.PROMO_CODE_NOT_FOUND,
+        message: "Code not found",
+        params: {
+          promoCodeId: id,
+          promoCode: null
+        }
+      });
+    }
     if (input.maxRedemptions != null && existing.maxRedemptions != null) {
       if (input.maxRedemptions < existing.maxRedemptions) {
-        throw new import_common34.BadRequestException("maxRedemptions kann nicht gesenkt werden.");
+        throw new import_common34.BadRequestException({
+          code: import_types15.PROMO_ERROR_CODES.PROMO_MAX_REDEMPTIONS_LOWERED,
+          message: "maxRedemptions cannot be lowered.",
+          params: {
+            current: existing.maxRedemptions,
+            requested: input.maxRedemptions
+          }
+        });
       }
     }
     return this.promoRepo.update(id, input);
@@ -4780,7 +5034,14 @@ var PromoCodesService = class {
   async softDelete(id) {
     const redemptions = await this.redemptionRepo.countByPromoCode(id);
     if (redemptions > 0) {
-      throw new import_common34.BadRequestException("Code hat bereits Einl\xF6sungen \u2014 Soft-Delete nicht m\xF6glich. Stattdessen pausieren.");
+      throw new import_common34.BadRequestException({
+        code: import_types15.PROMO_ERROR_CODES.PROMO_CODE_HAS_REDEMPTIONS,
+        message: "The code already has redemptions \u2014 it cannot be soft-deleted. Pause it instead.",
+        params: {
+          promoCodeId: id,
+          redemptions
+        }
+      });
     }
     await this.promoRepo.softDelete(id);
   }
@@ -4791,7 +5052,16 @@ var PromoCodesService = class {
   async findOne(id) {
     await this.lazyExpire();
     const code = await this.promoRepo.findById(id);
-    if (!code || code.deletedAt) throw new import_common34.NotFoundException("Code nicht gefunden");
+    if (!code || code.deletedAt) {
+      throw new import_common34.NotFoundException({
+        code: import_types15.PROMO_ERROR_CODES.PROMO_CODE_NOT_FOUND,
+        message: "Code not found",
+        params: {
+          promoCodeId: id,
+          promoCode: null
+        }
+      });
+    }
     return code;
   }
   async stats(id) {
@@ -4919,28 +5189,51 @@ var PromoCodesService = class {
     const code = input.code.trim().toUpperCase();
     const promo = await this.promoRepo.findByCode(code, tx);
     if (!promo || promo.deletedAt) {
-      throw new import_common34.BadRequestException("Code nicht gefunden");
+      throw new import_common34.BadRequestException({
+        code: import_types15.PROMO_ERROR_CODES.PROMO_CODE_NOT_FOUND,
+        // The lookup runs on the code string, so there is no id to report.
+        message: "Code not found",
+        params: {
+          promoCodeId: null,
+          promoCode: code
+        }
+      });
     }
     const sub = await this.subscriptionLookup.findById(input.subscriptionId, tx);
-    if (!sub) throw new import_common34.NotFoundException("Subscription nicht gefunden");
+    if (!sub) {
+      throw new import_common34.NotFoundException({
+        code: import_types15.BILLING_ERROR_CODES.SUBSCRIPTION_NOT_FOUND,
+        message: "Subscription not found",
+        params: {
+          tenantId: input.tenantId
+        }
+      });
+    }
     if (sub.tenantId !== input.tenantId) {
-      throw new import_common34.BadRequestException("Subscription geh\xF6rt nicht zum Tenant");
+      throw new import_common34.BadRequestException({
+        code: import_types15.BILLING_ERROR_CODES.SUBSCRIPTION_TENANT_MISMATCH,
+        message: "Subscription does not belong to the tenant",
+        params: {
+          subscriptionId: sub.id,
+          tenantId: input.tenantId
+        }
+      });
     }
     const reason = this.checkEligibility(promo, {
       code,
       planId: sub.plan,
       billingCycle: sub.billingCycle
     });
-    if (reason) throw new import_common34.BadRequestException(`Code nicht einl\xF6sbar: ${reason}`);
+    if (reason) throw notRedeemable(reason);
     const firstTimeReason = await this.checkFirstTimeCustomer(promo, input.email, {
       requireEmail: true
     });
     if (firstTimeReason) {
-      throw new import_common34.BadRequestException(`Code nicht einl\xF6sbar: ${firstTimeReason}`);
+      throw notRedeemable(firstTimeReason);
     }
     const claimed = await this.promoRepo.claimSlot(promo.id, tx);
     if (!claimed) {
-      throw new import_common34.BadRequestException("Code nicht einl\xF6sbar: EXHAUSTED");
+      throw notRedeemable("EXHAUSTED");
     }
     await this.promoRepo.markExhaustedIfFull(promo.id, tx);
     const startsAt = sub.startedAt ?? /* @__PURE__ */ new Date();
@@ -5051,6 +5344,7 @@ PromoCodesService = _ts_decorate34([
 
 // src/billing/subscription-bundles.service.ts
 var import_common35 = require("@nestjs/common");
+var import_types16 = require("@saasicat/types");
 function _ts_decorate35(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -5098,38 +5392,61 @@ var SubscriptionBundlesService = class {
   async addBundleToSubscription(input) {
     const bundleVersion = await this.bundles.findVersionById(input.bundleVersionId);
     if (!bundleVersion) {
-      throw new import_common35.NotFoundException(`BundleVersion '${input.bundleVersionId}' nicht gefunden`);
+      throw new import_common35.NotFoundException({
+        code: import_types16.CATALOG_ERROR_CODES.BUNDLE_VERSION_NOT_FOUND,
+        message: `BundleVersion '${input.bundleVersionId}' not found`,
+        params: {
+          bundleVersionId: input.bundleVersionId
+        }
+      });
     }
     if (bundleVersion.publishedAt === null) {
       throw new import_common35.UnprocessableEntityException({
-        code: "BUNDLE_VERSION_NOT_PUBLISHED",
-        message: `BundleVersion '${input.bundleVersionId}' ist nicht published und kann nicht gebucht werden.`
+        code: import_types16.CATALOG_ERROR_CODES.BUNDLE_VERSION_NOT_PUBLISHED,
+        message: `BundleVersion '${input.bundleVersionId}' is not published and cannot be booked.`,
+        params: {
+          bundleVersionId: input.bundleVersionId
+        }
       });
     }
     if (bundleVersion.supersededAt !== null) {
       throw new import_common35.UnprocessableEntityException({
-        code: "BUNDLE_VERSION_SUPERSEDED",
-        message: `BundleVersion '${input.bundleVersionId}' wurde durch eine Nachfolge-Version abgel\xF6st.`
+        code: import_types16.CATALOG_ERROR_CODES.BUNDLE_VERSION_SUPERSEDED,
+        message: `BundleVersion '${input.bundleVersionId}' has been superseded by a newer version.`,
+        params: {
+          bundleVersionId: input.bundleVersionId
+        }
       });
     }
     if (this.blockedBundles?.bundleKeys?.includes(bundleVersion.bundleKey)) {
       throw new import_common35.UnprocessableEntityException({
-        code: "BUNDLE_NOT_SELF_SERVICE",
-        message: `Bundle '${bundleVersion.bundleKey}' wird nur per Sondervertrag aktiviert. Bitte den Vertragsbetreuer kontaktieren.`
+        code: import_types16.BILLING_ERROR_CODES.BUNDLE_NOT_SELF_SERVICE,
+        message: `Bundle '${bundleVersion.bundleKey}' is only activated via a special contract. Please contact the contract manager.`,
+        params: {
+          bundleKey: bundleVersion.bundleKey
+        }
       });
     }
     const planIds = bundleVersion.compatibility?.planIds ?? [];
     if (planIds.length > 0 && !planIds.includes(input.currentPlanKey)) {
       throw new import_common35.UnprocessableEntityException({
-        code: "BUNDLE_INCOMPATIBLE_WITH_PLAN",
-        message: `BundleVersion '${input.bundleVersionId}' ist nicht mit Plan '${input.currentPlanKey}' kompatibel. Erlaubt: [${planIds.join(", ")}].`
+        code: import_types16.BILLING_ERROR_CODES.BUNDLE_INCOMPATIBLE_WITH_PLAN,
+        message: `BundleVersion '${input.bundleVersionId}' is not compatible with plan '${input.currentPlanKey}'. Allowed: [${planIds.join(", ")}].`,
+        params: {
+          bundleVersionId: input.bundleVersionId,
+          planKey: input.currentPlanKey,
+          allowedPlanKeys: planIds
+        }
       });
     }
     const active = await this.repo.listActiveBySubscription(input.subscriptionId);
     if (active.some((b) => b.bundleVersionId === input.bundleVersionId)) {
       throw new import_common35.UnprocessableEntityException({
-        code: "BUNDLE_ALREADY_SUBSCRIBED",
-        message: `Subscription '${input.subscriptionId}' hat dieses Bundle bereits aktiv gebucht.`
+        code: import_types16.BILLING_ERROR_CODES.BUNDLE_ALREADY_SUBSCRIBED,
+        message: `Subscription '${input.subscriptionId}' has already actively booked this bundle.`,
+        params: {
+          subscriptionId: input.subscriptionId
+        }
       });
     }
     const startedAt = input.startedAt ?? /* @__PURE__ */ new Date();
@@ -5145,12 +5462,21 @@ var SubscriptionBundlesService = class {
   async cancelBundleFromSubscription(input) {
     const existing = await this.repo.findById(input.subscriptionBundleId);
     if (!existing) {
-      throw new import_common35.NotFoundException(`SubscriptionBundle '${input.subscriptionBundleId}' nicht gefunden`);
+      throw new import_common35.NotFoundException({
+        code: import_types16.BILLING_ERROR_CODES.SUBSCRIPTION_BUNDLE_NOT_FOUND,
+        message: `SubscriptionBundle '${input.subscriptionBundleId}' not found`,
+        params: {
+          subscriptionBundleId: input.subscriptionBundleId
+        }
+      });
     }
     if (existing.canceledAt !== null) {
       throw new import_common35.UnprocessableEntityException({
-        code: "SUBSCRIPTION_BUNDLE_ALREADY_CANCELED",
-        message: `SubscriptionBundle '${input.subscriptionBundleId}' ist bereits gek\xFCndigt.`
+        code: import_types16.BILLING_ERROR_CODES.SUBSCRIPTION_BUNDLE_ALREADY_CANCELLED,
+        message: `SubscriptionBundle '${input.subscriptionBundleId}' is already cancelled.`,
+        params: {
+          subscriptionBundleId: input.subscriptionBundleId
+        }
       });
     }
     const canceledAt = input.canceledAt ?? /* @__PURE__ */ new Date();
@@ -5171,18 +5497,27 @@ var SubscriptionBundlesService = class {
   async reactivateBundle(subscriptionBundleId) {
     const existing = await this.repo.findById(subscriptionBundleId);
     if (!existing) {
-      throw new import_common35.NotFoundException(`SubscriptionBundle '${subscriptionBundleId}' nicht gefunden`);
+      throw new import_common35.NotFoundException({
+        code: import_types16.BILLING_ERROR_CODES.SUBSCRIPTION_BUNDLE_NOT_FOUND,
+        message: `SubscriptionBundle '${subscriptionBundleId}' not found`,
+        params: {
+          subscriptionBundleId
+        }
+      });
     }
     if (existing.canceledAt === null) {
       throw new import_common35.UnprocessableEntityException({
-        code: "SUBSCRIPTION_BUNDLE_NOT_CANCELED",
-        message: `SubscriptionBundle '${subscriptionBundleId}' ist nicht gek\xFCndigt.`
+        code: import_types16.BILLING_ERROR_CODES.SUBSCRIPTION_BUNDLE_NOT_CANCELLED,
+        message: `SubscriptionBundle '${subscriptionBundleId}' is not cancelled.`,
+        params: {
+          subscriptionBundleId
+        }
       });
     }
     if (existing.canceledEffectiveAt !== null && existing.canceledEffectiveAt <= /* @__PURE__ */ new Date()) {
       throw new import_common35.UnprocessableEntityException({
-        code: "SUBSCRIPTION_BUNDLE_CANCELLATION_EFFECTIVE",
-        message: "K\xFCndigung bereits wirksam \u2014 bitte das Bundle neu buchen."
+        code: import_types16.BILLING_ERROR_CODES.SUBSCRIPTION_BUNDLE_CANCELLATION_EFFECTIVE,
+        message: "Cancellation already in effect \u2014 book the bundle again."
       });
     }
     return this.repo.reactivate(subscriptionBundleId);
@@ -5288,7 +5623,13 @@ var TenantBillingController = class _TenantBillingController {
       this.usageSnapshot.snapshot(tenantId)
     ]);
     if (!sub) {
-      throw new import_common36.NotFoundException(`Keine Subscription f\xFCr Tenant ${tenantId}`);
+      throw new import_common36.NotFoundException({
+        code: import_types17.BILLING_ERROR_CODES.SUBSCRIPTION_NOT_FOUND,
+        message: `No subscription for tenant ${tenantId}`,
+        params: {
+          tenantId
+        }
+      });
     }
     const usage = {};
     for (const key of /* @__PURE__ */ new Set([
@@ -5337,14 +5678,29 @@ var TenantBillingController = class _TenantBillingController {
     const userId = this.requireUserId(req);
     const blockedTargets = this.blockedPlans?.asTarget ?? [];
     if (blockedTargets.includes(dto.plan)) {
-      throw new import_common36.ForbiddenException(`${dto.plan} wird nicht per Self-Service aktiviert.`);
+      throw new import_common36.ForbiddenException({
+        code: import_types17.BILLING_ERROR_CODES.PLAN_NOT_SELF_SERVICE,
+        message: `${dto.plan} is not activated via self-service.`,
+        params: {
+          planKey: dto.plan
+        }
+      });
     }
     const sub = await this.subscriptionUsage.findForTenant(tenantId);
-    if (!sub) throw new import_common36.NotFoundException(`Keine Subscription f\xFCr Tenant ${tenantId}`);
+    if (!sub) {
+      throw new import_common36.NotFoundException({
+        code: import_types17.BILLING_ERROR_CODES.SUBSCRIPTION_NOT_FOUND,
+        message: `No subscription for tenant ${tenantId}`,
+        params: {
+          tenantId
+        }
+      });
+    }
     const blockers = await this.planPreview.assertChangeAllowed(tenantId, dto.plan, dto.billingCycle);
     if (blockers.length > 0) {
       throw new import_common36.BadRequestException({
-        message: "Plan-Wechsel blockiert.",
+        code: import_types17.BILLING_ERROR_CODES.PLAN_CHANGE_BLOCKED,
+        message: "Plan change is blocked.",
         blockers
       });
     }
@@ -5414,14 +5770,29 @@ var TenantBillingController = class _TenantBillingController {
     const warnings = [];
     const blockedTargets = this.blockedPlans?.asTarget ?? [];
     if (blockedTargets.includes(dto.plan)) {
-      throw new import_common36.ForbiddenException(`${dto.plan} wird nicht per Self-Service aktiviert.`);
+      throw new import_common36.ForbiddenException({
+        code: import_types17.BILLING_ERROR_CODES.PLAN_NOT_SELF_SERVICE,
+        message: `${dto.plan} is not activated via self-service.`,
+        params: {
+          planKey: dto.plan
+        }
+      });
     }
     const sub = await this.subscriptionUsage.findForTenant(tenantId);
-    if (!sub) throw new import_common36.NotFoundException(`Keine Subscription f\xFCr Tenant ${tenantId}`);
+    if (!sub) {
+      throw new import_common36.NotFoundException({
+        code: import_types17.BILLING_ERROR_CODES.SUBSCRIPTION_NOT_FOUND,
+        message: `No subscription for tenant ${tenantId}`,
+        params: {
+          tenantId
+        }
+      });
+    }
     const blockers = await this.planPreview.assertChangeAllowed(tenantId, dto.plan, dto.billingCycle);
     if (blockers.length > 0) {
       throw new import_common36.BadRequestException({
-        message: "Plan-Wechsel im Onboarding blockiert.",
+        code: import_types17.BILLING_ERROR_CODES.PLAN_CHANGE_BLOCKED,
+        message: "Plan change during onboarding is blocked.",
         blockers
       });
     }
@@ -5455,8 +5826,13 @@ var TenantBillingController = class _TenantBillingController {
           warnings.push(...this.collectPromoSkipReasons(dto.promoCode, sub));
         }
       } catch (err) {
+        const reason = err instanceof Error ? err.message : null;
         throw new import_common36.BadRequestException({
-          message: err instanceof Error ? `Onboarding-Anlage fehlgeschlagen: ${err.message}` : "Onboarding-Anlage fehlgeschlagen"
+          code: import_types17.BILLING_ERROR_CODES.ONBOARDING_CREATE_FAILED,
+          message: reason ? `Onboarding creation failed: ${reason}` : "Onboarding creation failed",
+          params: {
+            reason
+          }
         });
       }
     } else {
@@ -5469,9 +5845,9 @@ var TenantBillingController = class _TenantBillingController {
       });
       if (dto.promoCode) {
         if (!this.promoCodes) {
-          warnings.push("Promo-Code wurde gesendet, aber PromoCodesModule ist nicht geladen \u2014 der Code wurde NICHT eingel\xF6st.");
+          warnings.push("A promo code was sent, but PromoCodesModule is not loaded \u2014 the code was NOT redeemed.");
         } else if (!sub.id) {
-          warnings.push("Promo-Code wurde gesendet, aber der Adapter liefert keine SubscriptionUsageRecord.id \u2014 der Code wurde NICHT eingel\xF6st.");
+          warnings.push("A promo code was sent, but the adapter returns no SubscriptionUsageRecord.id \u2014 the code was NOT redeemed.");
         } else {
           try {
             const redemption = await this.promoCodes.redeem({
@@ -5482,8 +5858,8 @@ var TenantBillingController = class _TenantBillingController {
             });
             promoRedemption = this.toResponseRedemption(redemption, dto.promoCode);
           } catch (err) {
-            const message = err instanceof Error ? err.message : "Unbekannter Fehler";
-            warnings.push(`Promo-Code konnte nicht eingel\xF6st werden: ${message}`);
+            const message = err instanceof Error ? err.message : "Unknown error";
+            warnings.push(`The promo code could not be redeemed: ${message}`);
           }
         }
       }
@@ -5509,11 +5885,11 @@ var TenantBillingController = class _TenantBillingController {
           });
           bundlesAdded += 1;
         } catch (err) {
-          warnings.push(`Bundle '${bundleVersionId}' konnte nicht gebucht werden: ` + (err instanceof Error ? err.message : String(err)));
+          warnings.push(`Bundle '${bundleVersionId}' could not be booked: ` + (err instanceof Error ? err.message : String(err)));
         }
       }
     } else if (bundleVersionIds.length > 0 && !this.subscriptionBundles) {
-      warnings.push("Bundle-Buchungen im Onboarding angefordert, aber SubscriptionBundleModule ist nicht im Konsumenten registriert. Bundles wurden nicht angelegt.");
+      warnings.push("Bundle bookings were requested during onboarding, but SubscriptionBundleModule is not registered in the consumer. No bundles were created.");
     }
     return {
       plan: planResult.plan,
@@ -5533,9 +5909,20 @@ var TenantBillingController = class _TenantBillingController {
     const tenantId = this.requireTenantId(req);
     const userId = this.requireUserId(req);
     const sub = await this.subscriptionUsage.findForTenant(tenantId);
-    if (!sub) throw new import_common36.NotFoundException(`Keine Subscription f\xFCr Tenant ${tenantId}`);
+    if (!sub) {
+      throw new import_common36.NotFoundException({
+        code: import_types17.BILLING_ERROR_CODES.SUBSCRIPTION_NOT_FOUND,
+        message: `No subscription for tenant ${tenantId}`,
+        params: {
+          tenantId
+        }
+      });
+    }
     if (!sub.pendingPlanVersion) {
-      throw new import_common36.BadRequestException("Es liegt aktuell keine Pending-Plan-Version zur Best\xE4tigung vor.");
+      throw new import_common36.BadRequestException({
+        code: import_types17.BILLING_ERROR_CODES.NO_PENDING_PLAN_VERSION,
+        message: "There is no pending plan version awaiting confirmation."
+      });
     }
     const result = await this.subscriptionWrite.acceptPendingPlanVersion(tenantId, userId, /* @__PURE__ */ new Date());
     if (!result.alreadyAccepted) {
@@ -5580,7 +5967,10 @@ var TenantBillingController = class _TenantBillingController {
     const resolver = this.tenantIdResolver ?? ((r) => r.user?.tenantId ?? null);
     const tenantId = resolver(req);
     if (!tenantId) {
-      throw new import_common36.NotFoundException("Tenant-ID nicht im Request gefunden");
+      throw new import_common36.NotFoundException({
+        code: import_types17.AUTH_ERROR_CODES.TENANT_CONTEXT_MISSING,
+        message: "No tenant ID found on the request"
+      });
     }
     return tenantId;
   }
@@ -5588,7 +5978,10 @@ var TenantBillingController = class _TenantBillingController {
     const resolver = this.userIdResolver ?? ((r) => r.user?.sub ?? r.user?.id ?? null);
     const userId = resolver(req);
     if (!userId) {
-      throw new import_common36.NotFoundException("User-ID nicht im Request gefunden");
+      throw new import_common36.NotFoundException({
+        code: import_types17.AUTH_ERROR_CODES.TENANT_CONTEXT_MISSING,
+        message: "No user ID found on the request"
+      });
     }
     return userId;
   }
@@ -5628,10 +6021,10 @@ var TenantBillingController = class _TenantBillingController {
   collectPromoSkipReasons(promoCode, sub) {
     const reasons = [];
     if (!this.promoCodes) {
-      reasons.push(`Promo-Code "${promoCode}" wurde gesendet, aber PromoCodesModule ist nicht geladen \u2014 der Code wurde NICHT eingel\xF6st.`);
+      reasons.push(`Promo-Code "${promoCode}" was sent, but PromoCodesModule is not loaded \u2014 the code was NOT redeemed.`);
     }
     if (!sub.id) {
-      reasons.push(`Promo-Code "${promoCode}" wurde gesendet, aber der Adapter liefert keine SubscriptionUsageRecord.id \u2014 der Code wurde NICHT eingel\xF6st.`);
+      reasons.push(`Promo-Code "${promoCode}" was sent, but the adapter returns no SubscriptionUsageRecord.id \u2014 the code was NOT redeemed.`);
     }
     return reasons;
   }
@@ -5646,7 +6039,7 @@ var TenantBillingController = class _TenantBillingController {
     try {
       await this.contractFreeze.freezeOnPlanChange(tenantId, plan, cycle, /* @__PURE__ */ new Date());
     } catch (err) {
-      this.logger.error(`Contract-Freeze nach Plan-Wechsel fehlgeschlagen (tenant ${tenantId}): ${String(err)}`);
+      this.logger.error(`Contract freeze after plan change failed (tenant ${tenantId}): ${String(err)}`);
     }
   }
   /**
@@ -5957,7 +6350,7 @@ __name(normalizeQuotas, "normalizeQuotas");
 
 // src/billing/subscription-bundle-preview.service.ts
 var import_common39 = require("@nestjs/common");
-var import_types5 = require("@saasicat/types");
+var import_types18 = require("@saasicat/types");
 function _ts_decorate39(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -5996,7 +6389,13 @@ var SubscriptionBundlePreviewService = class {
   async previewAdd(ctx, input, now = /* @__PURE__ */ new Date()) {
     const bundleVersion = await this.bundles.findVersionById(input.bundleVersionId);
     if (!bundleVersion) {
-      throw new import_common39.NotFoundException(`BundleVersion '${input.bundleVersionId}' nicht gefunden`);
+      throw new import_common39.NotFoundException({
+        code: import_types18.CATALOG_ERROR_CODES.BUNDLE_VERSION_NOT_FOUND,
+        message: `BundleVersion '${input.bundleVersionId}' not found`,
+        params: {
+          bundleVersionId: input.bundleVersionId
+        }
+      });
     }
     const blockers = [];
     const warnings = [];
@@ -6005,7 +6404,7 @@ var SubscriptionBundlePreviewService = class {
     if (activeBundleVersions.some((bv) => bv.id === bundleVersion.id)) {
       blockers.push({
         code: "BUNDLE_ALREADY_SUBSCRIBED",
-        message: "Dieses Bundle ist bereits aktiv gebucht."
+        message: "This bundle is already actively booked."
       });
     }
     const planFeatures = new Set(await this.resolvePlanFeatures(ctx.currentPlanKey, now));
@@ -6013,14 +6412,14 @@ var SubscriptionBundlePreviewService = class {
     if (redundantFeatures.length > 0) {
       warnings.push({
         code: "REDUNDANT_FEATURES",
-        message: `${redundantFeatures.length} Feature${redundantFeatures.length === 1 ? " ist" : "s sind"} bereits im Plan oder einem anderen gebuchten Bundle enthalten \u2014 das Bundle w\xFCrde daf\xFCr doppelt bezahlt.`
+        message: `${redundantFeatures.length} feature${redundantFeatures.length === 1 ? " is" : "s are"} already included in the plan or another booked bundle \u2014 the bundle would be paid for twice.`
       });
     }
     const missingRequires = await this.collectMissingRequires(bundleVersion, planFeatures, activeBundleVersions);
     if (missingRequires.length > 0) {
       blockers.push({
         code: "BUNDLE_FEATURE_DEPENDENCY_UNSATISFIED",
-        message: `Das Bundle ben\xF6tigt [${missingRequires.join(", ")}] \u2014 weder im Plan noch in den aktiven Bundles enthalten.`
+        message: `The bundle requires [${missingRequires.join(", ")}] \u2014 present neither in the plan nor in the active bundles.`
       });
     }
     const priceNet = resolveBundlePriceNet(bundleVersion, ctx.currentPlanKey, ctx.billingCycle);
@@ -6049,18 +6448,30 @@ var SubscriptionBundlePreviewService = class {
   async previewCancel(ctx, input, now = /* @__PURE__ */ new Date()) {
     const existing = await this.subscriptionBundles.findById(input.subscriptionBundleId);
     if (!existing || existing.subscriptionId !== ctx.subscriptionId) {
-      throw new import_common39.NotFoundException(`SubscriptionBundle '${input.subscriptionBundleId}' nicht gefunden`);
+      throw new import_common39.NotFoundException({
+        code: import_types18.BILLING_ERROR_CODES.SUBSCRIPTION_BUNDLE_NOT_FOUND,
+        message: `SubscriptionBundle '${input.subscriptionBundleId}' not found`,
+        params: {
+          subscriptionBundleId: input.subscriptionBundleId
+        }
+      });
     }
     const bundleVersion = await this.bundles.findVersionById(existing.bundleVersionId);
     if (!bundleVersion) {
-      throw new import_common39.NotFoundException(`BundleVersion '${existing.bundleVersionId}' nicht gefunden`);
+      throw new import_common39.NotFoundException({
+        code: import_types18.CATALOG_ERROR_CODES.BUNDLE_VERSION_NOT_FOUND,
+        message: `BundleVersion '${existing.bundleVersionId}' not found`,
+        params: {
+          bundleVersionId: existing.bundleVersionId
+        }
+      });
     }
     const blockers = [];
     const warnings = [];
     if (existing.canceledAt !== null) {
       blockers.push({
-        code: "SUBSCRIPTION_BUNDLE_ALREADY_CANCELED",
-        message: "Diese Bundle-Buchung ist bereits gek\xFCndigt."
+        code: import_types18.BILLING_ERROR_CODES.SUBSCRIPTION_BUNDLE_ALREADY_CANCELLED,
+        message: "This bundle booking is already cancelled."
       });
     }
     const effectiveAt = resolveBundleCancelEffectiveAt({
@@ -6072,7 +6483,7 @@ var SubscriptionBundlePreviewService = class {
     if (existing.minimumTermEndsAt && existing.minimumTermEndsAt.getTime() > periodEnd.getTime()) {
       warnings.push({
         code: "MINIMUM_TERM_BINDS",
-        message: "Die Mindestlaufzeit bindet \xFCber das Periodenende hinaus \u2014 die K\xFCndigung wirkt erst zum Mindestlaufzeit-Ende."
+        message: "The minimum term extends beyond the end of the period \u2014 the cancellation only takes effect when the minimum term ends."
       });
     }
     return {
@@ -6091,26 +6502,26 @@ var SubscriptionBundlePreviewService = class {
     if (bundleVersion.publishedAt === null) {
       blockers.push({
         code: "BUNDLE_VERSION_NOT_PUBLISHED",
-        message: "Diese BundleVersion ist nicht ver\xF6ffentlicht und nicht buchbar."
+        message: "This bundle version is not published and cannot be booked."
       });
     }
     if (bundleVersion.supersededAt !== null) {
       blockers.push({
         code: "BUNDLE_VERSION_SUPERSEDED",
-        message: "Diese BundleVersion wurde durch eine Nachfolge-Version abgel\xF6st."
+        message: "This bundle version has been superseded by a newer one."
       });
     }
     const planIds = bundleVersion.compatibility?.planIds ?? [];
     if (planIds.length > 0 && !planIds.includes(currentPlanKey)) {
       blockers.push({
         code: "BUNDLE_INCOMPATIBLE_WITH_PLAN",
-        message: `Das Bundle ist nicht mit Plan '${currentPlanKey}' kompatibel. Erlaubt: [${planIds.join(", ")}].`
+        message: `The bundle is not compatible with plan '${currentPlanKey}'. Allowed: [${planIds.join(", ")}].`
       });
     }
     if (this.blockedBundles?.bundleKeys?.includes(bundleVersion.bundleKey)) {
       blockers.push({
         code: "BUNDLE_NOT_SELF_SERVICE",
-        message: `Bundle '${bundleVersion.bundleKey}' wird nur per Sondervertrag aktiviert. Bitte den Vertragsbetreuer kontaktieren.`
+        message: `Bundle '${bundleVersion.bundleKey}' is only activated via a special contract. Please contact the contract manager.`
       });
     }
   }
@@ -6159,12 +6570,12 @@ var SubscriptionBundlePreviewService = class {
     const entries = await this.catalogEntries.listFeatures({
       projectKey
     });
-    const requiresIndex = (0, import_types5.buildFeatureRequiresIndex)(entries);
+    const requiresIndex = (0, import_types18.buildFeatureRequiresIndex)(entries);
     const covered = /* @__PURE__ */ new Set([
       ...planFeatures,
       ...activeBundleVersions.flatMap((bv) => bv.features ?? [])
     ]);
-    return (0, import_types5.collectUnsatisfiedRequires)(bundleVersion.features ?? [], requiresIndex).filter((key) => !covered.has(key));
+    return (0, import_types18.collectUnsatisfiedRequires)(bundleVersion.features ?? [], requiresIndex).filter((key) => !covered.has(key));
   }
   /** `projectKey` lives on the bundle stem, not on the version. */
   async resolveProjectKey(bundleVersion) {
@@ -6223,6 +6634,7 @@ var import_common41 = require("@nestjs/common");
 
 // src/billing/tenant-subscription-bundles.controller.ts
 var import_common40 = require("@nestjs/common");
+var import_types19 = require("@saasicat/types");
 
 // src/billing/dto/subscription-bundles.dto.ts
 var import_class_validator5 = require("class-validator");
@@ -6303,7 +6715,7 @@ var CancelSubscriptionBundleDto = class {
 _ts_decorate40([
   (0, import_class_validator5.IsOptional)(),
   (0, import_class_validator5.Matches)(ISO_DATE_PATTERN, {
-    message: "canceledAt muss ISO-Datum sein (YYYY-MM-DD)"
+    message: "canceledAt must be an ISO date (YYYY-MM-DD)"
   }),
   _ts_metadata28("design:type", String)
 ], CancelSubscriptionBundleDto.prototype, "canceledAt", void 0);
@@ -6367,7 +6779,10 @@ function buildTenantSubscriptionBundlesController(extraGuards = []) {
       const hasAdd = Boolean(dto.bundleVersionId);
       const hasCancel = Boolean(dto.subscriptionBundleId);
       if (hasAdd === hasCancel) {
-        throw new import_common40.BadRequestException("Genau eines von bundleVersionId (Add-Preview) oder subscriptionBundleId (Cancel-Preview) angeben.");
+        throw new import_common40.BadRequestException({
+          code: import_types19.BILLING_ERROR_CODES.BUNDLE_PREVIEW_ARGUMENT_AMBIGUOUS,
+          message: "Exactly one of bundleVersionId (add preview) or subscriptionBundleId (cancel preview) must be given."
+        });
       }
       const sub = await this.requireSubscription(this.requireTenantId(req));
       const ctx = {
@@ -6407,21 +6822,30 @@ function buildTenantSubscriptionBundlesController(extraGuards = []) {
     }
     requireSubscriptionPk(sub) {
       if (!sub.id) {
-        throw new import_common40.NotFoundException("SubscriptionUsageRecord ohne `id` \u2014 Adapter muss die Subscription-PK durchreichen (siehe SubscriptionUsageRecord.id).");
+        throw new import_common40.NotFoundException(codedError(import_types19.BILLING_ERROR_CODES.SUBSCRIPTION_PK_MISSING));
       }
       return sub.id;
     }
     requireTenantId(req) {
       const tenantId = this.tenantIdResolver(req);
       if (!tenantId) {
-        throw new import_common40.NotFoundException("Tenant-ID nicht im Request gefunden");
+        throw new import_common40.NotFoundException({
+          code: import_types19.AUTH_ERROR_CODES.TENANT_CONTEXT_MISSING,
+          message: "No tenant ID found on the request"
+        });
       }
       return tenantId;
     }
     async requireSubscription(tenantId) {
       const sub = await this.subscriptionUsage.findForTenant(tenantId);
       if (!sub) {
-        throw new import_common40.NotFoundException(`Keine Subscription f\xFCr Tenant ${tenantId}`);
+        throw new import_common40.NotFoundException({
+          code: import_types19.BILLING_ERROR_CODES.SUBSCRIPTION_NOT_FOUND,
+          message: `No subscription for tenant ${tenantId}`,
+          params: {
+            tenantId
+          }
+        });
       }
       return sub;
     }
@@ -6440,7 +6864,7 @@ function buildTenantSubscriptionBundlesController(extraGuards = []) {
       try {
         await this.contractFreeze.freezeOnPlanChange(tenantId, sub.planVersion.planId, sub.billingCycle, /* @__PURE__ */ new Date());
       } catch (err) {
-        this.logger.error(`Contract-Freeze nach Bundle-Mutation fehlgeschlagen (tenant ${tenantId}): ${String(err)}`);
+        this.logger.error(`Contract freeze after bundle mutation failed (tenant ${tenantId}): ${String(err)}`);
       }
     }
   };
@@ -6659,7 +7083,7 @@ __export(catalog_exports, {
 
 // src/catalog/bundles.service.ts
 var import_common43 = require("@nestjs/common");
-var import_types6 = require("@saasicat/types");
+var import_types20 = require("@saasicat/types");
 
 // src/discovery/discovery.scanner.ts
 var import_node_crypto2 = require("crypto");
@@ -6728,7 +7152,7 @@ var DiscoveryScanner = class _DiscoveryScanner {
       (0, import_node_fs2.writeFileSync)(path, JSON.stringify(snapshot, null, 2) + "\n", "utf-8");
       this.logger.log(`Discovery snapshot persisted to ${path}`);
     } catch (err) {
-      this.logger.warn(`Discovery snapshot konnte nicht nach ${path} geschrieben werden: ${err.message}`);
+      this.logger.warn(`The discovery snapshot could not be written to ${path}: ${err.message}`);
     }
   }
   /**
@@ -6813,7 +7237,7 @@ var DiscoveryScanner = class _DiscoveryScanner {
   registerCapability(target, meta, declaredAt) {
     const existing = target.get(meta.capabilityKey);
     if (existing) {
-      this.logger.warn(`Capability '${meta.capabilityKey}' wird an mehreren Stellen deklariert (${existing.declaredAt} und ${declaredAt}); erste Deklaration gewinnt`);
+      this.logger.warn(`Capability '${meta.capabilityKey}' is declared in several places (${existing.declaredAt} and ${declaredAt}); the first declaration wins`);
       return;
     }
     target.set(meta.capabilityKey, {
@@ -6834,7 +7258,7 @@ var DiscoveryScanner = class _DiscoveryScanner {
   registerQuota(target, opts, declaredAt) {
     const existing = target.get(opts.key);
     if (existing) {
-      this.logger.warn(`Quota '${opts.key}' wird an mehreren Stellen definiert (${existing.declaredAt} und ${declaredAt}); erste Definition gewinnt`);
+      this.logger.warn(`Quota '${opts.key}' is defined in several places (${existing.declaredAt} and ${declaredAt}); the first definition wins`);
       return;
     }
     target.set(opts.key, {
@@ -7013,7 +7437,7 @@ function dependencyWarnings(features, snapshot, code) {
       if (selected.has(required)) continue;
       warnings.push({
         code,
-        message: `Feature '${feature}' setzt '${required}' voraus, das in dieser Auswahl fehlt. Beim Tenant muss die Abh\xE4ngigkeit anderweitig gedeckt sein (z. B. durch den Plan) \u2014 sonst funktioniert das Feature nicht.`,
+        message: `Feature '${feature}' requires '${required}', which is missing from this selection. The tenant must cover that dependency some other way (for example through the plan) \u2014 otherwise the feature will not work.`,
         field: `features[${index}]`,
         value: required
       });
@@ -7032,7 +7456,7 @@ function validateBundleDraft(draft, snapshot, knownPlanKeys = null, marketedOnly
       if (approved && !approved.features.has(feature)) {
         warnings.push({
           code: "BUNDLE_FEATURE_NOT_APPROVED",
-          message: `Feature '${feature}' ist nicht freigegeben (Status != approved). Nur freigegebene Features sind verkaufbar \u2014 im Discovery-Review freigeben (#20).`,
+          message: `Feature '${feature}' is not approved (status != approved). Only approved features are sellable \u2014 approve it in the discovery review (#20).`,
           field: `features[${index}]`,
           value: feature
         });
@@ -7041,7 +7465,7 @@ function validateBundleDraft(draft, snapshot, knownPlanKeys = null, marketedOnly
     }
     warnings.push({
       code: "BUNDLE_FEATURE_UNKNOWN",
-      message: `Feature '${feature}' wurde im Discovery-Snapshot nicht gefunden. Entweder fehlt im Code eine @ImplementsCapability(..., { feature: '${feature}' })-Annotation, oder das Feature ist veraltet.`,
+      message: `Feature '${feature}' was not found in the discovery snapshot. Either the code is missing an @ImplementsCapability(..., { feature: '${feature}' }) annotation, or the feature is obsolete.`,
       field: `features[${index}]`,
       value: feature
     });
@@ -7050,14 +7474,14 @@ function validateBundleDraft(draft, snapshot, knownPlanKeys = null, marketedOnly
     if (!knownQuotas.has(quotaKey)) {
       warnings.push({
         code: "QUOTA_MISSING",
-        message: `Quota '${quotaKey}' wurde im Discovery-Snapshot nicht gefunden. Im Code muss eine Klasse mit @DefinesQuota({ key: '${quotaKey}', ... }) annotiert sein.`,
+        message: `Quota '${quotaKey}' was not found in the discovery snapshot. In code, a class must be annotated with @DefinesQuota({ key: '${quotaKey}', ... }).`,
         field: `quotas.${quotaKey}`,
         value: quotaKey
       });
     } else if (approved && !approved.quotas.has(quotaKey)) {
       warnings.push({
         code: "QUOTA_NOT_APPROVED",
-        message: `Quota '${quotaKey}' ist nicht freigegeben (Status != approved). Nur freigegebene Quotas sind verkaufbar \u2014 im Discovery-Review freigeben (#20).`,
+        message: `Quota '${quotaKey}' is not approved (status != approved). Only approved quotas are sellable \u2014 approve it in the discovery review (#20).`,
         field: `quotas.${quotaKey}`,
         value: quotaKey
       });
@@ -7069,7 +7493,7 @@ function validateBundleDraft(draft, snapshot, knownPlanKeys = null, marketedOnly
       if (knownPlanKeys.has(planKey)) return;
       warnings.push({
         code: "BUNDLE_PLAN_KEY_UNKNOWN",
-        message: `Plan '${planKey}' aus compatibility.planIds existiert im Project nicht. Entweder den planKey korrigieren oder den Plan-Stamm zuerst anlegen.`,
+        message: `Plan '${planKey}' from compatibility.planIds does not exist in the project. Either fix the planKey, or create the plan record first.`,
         field: `compatibility.planIds[${index}]`,
         value: planKey
       });
@@ -7089,7 +7513,7 @@ function validatePlanDraft(draft, snapshot, marketedOnlyFeatures = /* @__PURE__
       if (approved && !approved.features.has(feature)) {
         warnings.push({
           code: "PLAN_FEATURE_NOT_APPROVED",
-          message: `Feature '${feature}' ist nicht freigegeben (Status != approved). Nur freigegebene Features sind verkaufbar \u2014 im Discovery-Review freigeben (#20).`,
+          message: `Feature '${feature}' is not approved (status != approved). Only approved features are sellable \u2014 approve it in the discovery review (#20).`,
           field: `features[${index}]`,
           value: feature
         });
@@ -7098,7 +7522,7 @@ function validatePlanDraft(draft, snapshot, marketedOnlyFeatures = /* @__PURE__
     }
     warnings.push({
       code: "PLAN_FEATURE_UNKNOWN",
-      message: `Feature '${feature}' wurde im Discovery-Snapshot nicht gefunden. Entweder fehlt im Code eine @ImplementsCapability(..., { feature: '${feature}' })-Annotation, oder das Feature ist veraltet.`,
+      message: `Feature '${feature}' was not found in the discovery snapshot. Either the code is missing an @ImplementsCapability(..., { feature: '${feature}' }) annotation, or the feature is obsolete.`,
       field: `features[${index}]`,
       value: feature
     });
@@ -7107,14 +7531,14 @@ function validatePlanDraft(draft, snapshot, marketedOnlyFeatures = /* @__PURE__
     if (!knownQuotas.has(quotaKey)) {
       warnings.push({
         code: "QUOTA_MISSING",
-        message: `Quota '${quotaKey}' wurde im Discovery-Snapshot nicht gefunden. Im Code muss eine Klasse mit @DefinesQuota({ key: '${quotaKey}', ... }) annotiert sein.`,
+        message: `Quota '${quotaKey}' was not found in the discovery snapshot. In code, a class must be annotated with @DefinesQuota({ key: '${quotaKey}', ... }).`,
         field: `quotas.${quotaKey}`,
         value: quotaKey
       });
     } else if (approved && !approved.quotas.has(quotaKey)) {
       warnings.push({
         code: "QUOTA_NOT_APPROVED",
-        message: `Quota '${quotaKey}' ist nicht freigegeben (Status != approved). Nur freigegebene Quotas sind verkaufbar \u2014 im Discovery-Review freigeben (#20).`,
+        message: `Quota '${quotaKey}' is not approved (status != approved). Only approved quotas are sellable \u2014 approve it in the discovery review (#20).`,
         field: `quotas.${quotaKey}`,
         value: quotaKey
       });
@@ -7166,7 +7590,7 @@ var BundlesService = class _BundlesService {
     this.mode = config.strictModeCheckMode ?? "blocking";
     this.marketedOnly = new Set(config.marketedOnlyFeatures ?? []);
     if (this.mode === "blocking" && !hasDiscoverySnapshotSource(this.snapshot, this.scanner)) {
-      this.logger.error("BundlesService: strictModeCheckMode=blocking ohne DiscoverySnapshot-Quelle \u2014 degradiere auf warn-only. DiscoveryModule wiren, damit die Erzwingung greift (#25).");
+      this.logger.error("BundlesService: strictModeCheckMode=blocking without a DiscoverySnapshot source \u2014 degrading to warn-only. Wire DiscoveryModule so that enforcement takes effect (#25).");
       this.mode = "warn-only";
     }
   }
@@ -7181,7 +7605,15 @@ var BundlesService = class _BundlesService {
   }
   async getBundle(bundleId) {
     const bundle = await this.repo.findById(bundleId);
-    if (!bundle) throw new import_common43.NotFoundException(`Bundle '${bundleId}' nicht gefunden`);
+    if (!bundle) {
+      throw new import_common43.NotFoundException({
+        code: import_types20.CATALOG_ERROR_CODES.BUNDLE_NOT_FOUND,
+        message: `Bundle '${bundleId}' not found`,
+        params: {
+          bundleId
+        }
+      });
+    }
     const versions = await this.annotateEditability(await this.repo.listVersions(bundleId));
     return {
       bundle,
@@ -7191,18 +7623,41 @@ var BundlesService = class _BundlesService {
   async createBundle(data) {
     const existing = await this.repo.findByKey(data.projectKey, data.bundleKey);
     if (existing) {
-      throw new import_common43.UnprocessableEntityException(`Bundle '${data.bundleKey}' existiert bereits in Projekt '${data.projectKey}'`);
+      throw new import_common43.UnprocessableEntityException({
+        code: import_types20.CATALOG_ERROR_CODES.BUNDLE_ALREADY_EXISTS,
+        message: `Bundle '${data.bundleKey}' already exists in project '${data.projectKey}'`,
+        params: {
+          bundleKey: data.bundleKey,
+          projectKey: data.projectKey
+        }
+      });
     }
     return this.repo.create(data);
   }
   async updateBundle(bundleId, data) {
     const existing = await this.repo.findById(bundleId);
-    if (!existing) throw new import_common43.NotFoundException(`Bundle '${bundleId}' nicht gefunden`);
+    if (!existing) {
+      throw new import_common43.NotFoundException({
+        code: import_types20.CATALOG_ERROR_CODES.BUNDLE_NOT_FOUND,
+        message: `Bundle '${bundleId}' not found`,
+        params: {
+          bundleId
+        }
+      });
+    }
     return this.repo.update(bundleId, data);
   }
   async softDeleteBundle(bundleId) {
     const existing = await this.repo.findById(bundleId);
-    if (!existing) throw new import_common43.NotFoundException(`Bundle '${bundleId}' nicht gefunden`);
+    if (!existing) {
+      throw new import_common43.NotFoundException({
+        code: import_types20.CATALOG_ERROR_CODES.BUNDLE_NOT_FOUND,
+        message: `Bundle '${bundleId}' not found`,
+        params: {
+          bundleId
+        }
+      });
+    }
     if (existing.deletedAt !== null) return;
     await this.repo.softDelete(bundleId);
   }
@@ -7214,18 +7669,27 @@ var BundlesService = class _BundlesService {
   async discardBundleDraft(versionId) {
     const existing = await this.repo.findVersionById(versionId);
     if (!existing) {
-      throw new import_common43.NotFoundException(`BundleVersion '${versionId}' nicht gefunden`);
+      throw new import_common43.NotFoundException({
+        code: import_types20.CATALOG_ERROR_CODES.BUNDLE_VERSION_NOT_FOUND,
+        message: `BundleVersion '${versionId}' not found`,
+        params: {
+          bundleVersionId: versionId
+        }
+      });
     }
     if (existing.publishedAt !== null) {
       throw new import_common43.UnprocessableEntityException({
-        code: "BUNDLE_VERSION_ALREADY_PUBLISHED",
-        message: `BundleVersion '${versionId}' ist bereits published und kann nicht verworfen werden.`
+        code: import_types20.CATALOG_ERROR_CODES.BUNDLE_VERSION_ALREADY_PUBLISHED,
+        message: `BundleVersion '${versionId}' is already published and cannot be discarded.`,
+        params: {
+          versionId
+        }
       });
     }
     if (typeof this.repo.deleteDraft !== "function") {
       throw new import_common43.UnprocessableEntityException({
-        code: "BUNDLE_VERSION_DISCARD_NOT_IMPLEMENTED",
-        message: "Discard ist im aktuellen Repository nicht implementiert. Implementiere BundleRepository.deleteDraft."
+        code: import_types20.CATALOG_ERROR_CODES.BUNDLE_VERSION_DISCARD_NOT_IMPLEMENTED,
+        message: "Discard is not implemented in the current repository. Implement BundleRepository.deleteDraft."
       });
     }
     await this.repo.deleteDraft(versionId);
@@ -7239,7 +7703,13 @@ var BundlesService = class _BundlesService {
   async getBundleVersion(versionId) {
     const version = await this.repo.findVersionById(versionId);
     if (!version) {
-      throw new import_common43.NotFoundException(`BundleVersion '${versionId}' nicht gefunden`);
+      throw new import_common43.NotFoundException({
+        code: import_types20.CATALOG_ERROR_CODES.BUNDLE_VERSION_NOT_FOUND,
+        message: `BundleVersion '${versionId}' not found`,
+        params: {
+          bundleVersionId: versionId
+        }
+      });
     }
     const [annotated] = await this.annotateEditability([
       version
@@ -7281,11 +7751,24 @@ var BundlesService = class _BundlesService {
   async createBundleDraft(data) {
     const bundle = await this.repo.findById(data.bundleId);
     if (!bundle) {
-      throw new import_common43.NotFoundException(`Bundle '${data.bundleId}' nicht gefunden`);
+      throw new import_common43.NotFoundException({
+        code: import_types20.CATALOG_ERROR_CODES.BUNDLE_NOT_FOUND,
+        message: `Bundle '${data.bundleId}' not found`,
+        params: {
+          bundleId: data.bundleId
+        }
+      });
     }
     const existingDraft = await this.repo.findCurrentDraft(data.bundleId);
     if (existingDraft) {
-      throw new import_common43.UnprocessableEntityException(`Bundle '${bundle.bundleKey}' hat bereits eine Draft-Version v${existingDraft.version}; bitte erst publishen oder verwerfen`);
+      throw new import_common43.UnprocessableEntityException({
+        code: import_types20.CATALOG_ERROR_CODES.BUNDLE_DRAFT_ALREADY_EXISTS,
+        message: `Bundle '${bundle.bundleKey}' already has a draft version v${existingDraft.version}; publish or discard it first`,
+        params: {
+          bundleKey: bundle.bundleKey,
+          draftVersion: existingDraft.version
+        }
+      });
     }
     if (data.baseVersionId === void 0) {
       const latestLive = await this.repo.findLatestLive(data.bundleId);
@@ -7317,16 +7800,25 @@ var BundlesService = class _BundlesService {
   async updateBundleDraft(versionId, data) {
     const existing = await this.repo.findVersionById(versionId);
     if (!existing) {
-      throw new import_common43.NotFoundException(`BundleVersion '${versionId}' nicht gefunden`);
+      throw new import_common43.NotFoundException({
+        code: import_types20.CATALOG_ERROR_CODES.BUNDLE_VERSION_NOT_FOUND,
+        message: `BundleVersion '${versionId}' not found`,
+        params: {
+          bundleVersionId: versionId
+        }
+      });
     }
     const [annotated] = await this.annotateEditability([
       existing
     ]);
-    const { editable } = (0, import_types6.isVersionEditable)(annotated);
+    const { editable } = (0, import_types20.isVersionEditable)(annotated);
     if (!editable) {
       throw new import_common43.UnprocessableEntityException({
-        code: "BUNDLE_VERSION_NOT_EDITABLE",
-        message: `BundleVersion '${versionId}' ist nicht editierbar. Editierbar sind nur Drafts und published Versionen, die latest-in-chain sind, noch keine Subscription binden und deren validFrom in der Zukunft liegt.`
+        code: import_types20.CATALOG_ERROR_CODES.BUNDLE_VERSION_NOT_EDITABLE,
+        message: `BundleVersion '${versionId}' is not editable. Only drafts and published versions are editable that are latest-in-chain, bind no subscription yet, and whose validFrom lies in the future.`,
+        params: {
+          versionId
+        }
       });
     }
     const merged = {
@@ -7357,10 +7849,22 @@ var BundlesService = class _BundlesService {
   async publishBundleVersion(versionId, publishMeta) {
     const draft = await this.repo.findVersionById(versionId);
     if (!draft) {
-      throw new import_common43.NotFoundException(`BundleVersion '${versionId}' nicht gefunden`);
+      throw new import_common43.NotFoundException({
+        code: import_types20.CATALOG_ERROR_CODES.BUNDLE_VERSION_NOT_FOUND,
+        message: `BundleVersion '${versionId}' not found`,
+        params: {
+          bundleVersionId: versionId
+        }
+      });
     }
     if (draft.publishedAt !== null) {
-      throw new import_common43.UnprocessableEntityException(`BundleVersion '${versionId}' ist bereits published`);
+      throw new import_common43.UnprocessableEntityException({
+        code: import_types20.CATALOG_ERROR_CODES.BUNDLE_VERSION_ALREADY_PUBLISHED,
+        message: `BundleVersion '${versionId}' is already published`,
+        params: {
+          versionId
+        }
+      });
     }
     const bundle = await this.repo.findById(draft.bundleId);
     const warnings = await this.runStrictCheck({
@@ -7373,8 +7877,8 @@ var BundlesService = class _BundlesService {
       const explicitZero = /* @__PURE__ */ __name((v) => v !== null && v !== void 0 && Number.parseFloat(String(v)) <= 0, "explicitZero");
       if (explicitZero(draft.monthlyNet) || explicitZero(draft.yearlyNet)) {
         throw new import_common43.UnprocessableEntityException({
-          code: "BUNDLE_VERSION_ZERO_PRICE",
-          message: "BundleVersion kann nicht mit explizitem Preis 0,00 published werden (Schutz gegen Seed-Platzhalter). Preisfreie Bundles: null lassen oder allowZeroPrice setzen.",
+          code: import_types20.CATALOG_ERROR_CODES.BUNDLE_VERSION_ZERO_PRICE,
+          message: "A bundle version cannot be published with an explicit price of 0.00 (guard against seed placeholders). For free bundles leave it null, or set allowZeroPrice.",
           monthlyNet: draft.monthlyNet,
           yearlyNet: draft.yearlyNet
         });
@@ -7384,23 +7888,30 @@ var BundlesService = class _BundlesService {
     const validFromInput = publishMeta.validFrom ?? draft.validFrom;
     if (!validFromInput) {
       throw new import_common43.UnprocessableEntityException({
-        code: "BUNDLE_VERSION_VALID_FROM_REQUIRED",
-        message: "Beim Publish muss validFrom gesetzt sein (auf Draft oder Publish-Aufruf). SPEC_V2 \xA74.2."
+        code: import_types20.CATALOG_ERROR_CODES.BUNDLE_VERSION_VALID_FROM_REQUIRED,
+        message: "validFrom must be set when publishing (on the draft or the publish call). SPEC_V2 \xA74.2."
       });
     }
     const validFrom = new Date(validFromInput);
     if (Number.isNaN(validFrom.getTime())) {
       throw new import_common43.UnprocessableEntityException({
-        code: "BUNDLE_VERSION_VALID_FROM_INVALID",
-        message: `validFrom '${validFromInput}' ist kein g\xFCltiges Datum`
+        code: import_types20.CATALOG_ERROR_CODES.BUNDLE_VERSION_VALID_FROM_INVALID,
+        message: `validFrom '${validFromInput}' is not a valid date`,
+        params: {
+          validFrom: validFromInput
+        }
       });
     }
     if (previous?.validFrom) {
       const prevFrom = new Date(previous.validFrom);
       if (validFrom <= prevFrom) {
         throw new import_common43.UnprocessableEntityException({
-          code: "BUNDLE_VERSION_VALID_FROM_NOT_AFTER_PREVIOUS",
-          message: `validFrom (${validFrom.toISOString()}) muss strikt nach validFrom der Vorg\xE4nger-Version (${previous.validFrom}) liegen.`
+          code: import_types20.CATALOG_ERROR_CODES.BUNDLE_VERSION_VALID_FROM_NOT_AFTER_PREVIOUS,
+          message: `validFrom (${validFrom.toISOString()}) must be strictly after the validFrom of the previous version (${previous.validFrom}).`,
+          params: {
+            validFrom: validFrom.toISOString(),
+            previousValidFrom: previous.validFrom
+          }
         });
       }
       if (previous.validUntil) {
@@ -7409,8 +7920,11 @@ var BundlesService = class _BundlesService {
         const requiredStart = new Date(prevUntil.getTime() + dayMs);
         if (validFrom.getTime() !== requiredStart.getTime()) {
           throw new import_common43.UnprocessableEntityException({
-            code: "BUNDLE_VERSION_VALID_FROM_NOT_GAPLESS",
-            message: `Vorg\xE4nger hat validUntil=${previous.validUntil.slice(0, 10)} \u2014 der Nachfolger muss nahtlos am Folgetag (${requiredStart.toISOString().slice(0, 10)}) starten. Geliefert: ${validFrom.toISOString().slice(0, 10)}.`,
+            code: import_types20.CATALOG_ERROR_CODES.BUNDLE_VERSION_VALID_FROM_NOT_GAPLESS,
+            message: `The predecessor has validUntil=${previous.validUntil.slice(0, 10)} \u2014 the successor must start seamlessly on the next day (${requiredStart.toISOString().slice(0, 10)}). Received: ${validFrom.toISOString().slice(0, 10)}.`,
+            params: {
+              received: validFrom.toISOString().slice(0, 10)
+            },
             requiredValidFrom: requiredStart.toISOString().slice(0, 10),
             previousValidUntil: previous.validUntil
           });
@@ -7421,17 +7935,24 @@ var BundlesService = class _BundlesService {
     const validUntil = validUntilInput ? new Date(validUntilInput) : null;
     if (validUntil && Number.isNaN(validUntil.getTime())) {
       throw new import_common43.UnprocessableEntityException({
-        code: "BUNDLE_VERSION_VALID_UNTIL_INVALID",
-        message: `validUntil '${validUntilInput}' ist kein g\xFCltiges Datum`
+        code: import_types20.CATALOG_ERROR_CODES.BUNDLE_VERSION_VALID_UNTIL_INVALID,
+        message: `validUntil '${validUntilInput}' is not a valid date`,
+        params: {
+          validUntil: validUntilInput
+        }
       });
     }
     if (validUntil && validUntil <= validFrom) {
       throw new import_common43.UnprocessableEntityException({
-        code: "BUNDLE_VERSION_VALID_UNTIL_BEFORE_FROM",
-        message: `validUntil (${validUntil.toISOString()}) muss strikt nach validFrom (${validFrom.toISOString()}) liegen.`
+        code: import_types20.CATALOG_ERROR_CODES.BUNDLE_VERSION_VALID_UNTIL_BEFORE_FROM,
+        message: `validUntil (${validUntil.toISOString()}) must be strictly after validFrom (${validFrom.toISOString()}).`,
+        params: {
+          validUntil: validUntil.toISOString(),
+          validFrom: validFrom.toISOString()
+        }
       });
     }
-    const diff = previous ? (0, import_types.classifyBundleVersionDiff)({
+    const diff = previous ? (0, import_types5.classifyBundleVersionDiff)({
       features: previous.features,
       quotas: previous.quotas,
       monthlyNet: previous.monthlyNet,
@@ -7447,8 +7968,8 @@ var BundlesService = class _BundlesService {
     };
     if (!diff.nonRegressive && !publishMeta.forceRegressive) {
       throw new import_common43.UnprocessableEntityException({
-        code: "BUNDLE_VERSION_REGRESSION",
-        message: "Diese BundleVersion ist regressiv (Feature entfernt / Quota gesenkt / Preis erh\xF6ht). Publishen erfordert explizites `forceRegressive: true` (UI-Best\xE4tigungsmodal mit MFA).",
+        code: import_types20.CATALOG_ERROR_CODES.BUNDLE_VERSION_REGRESSION,
+        message: "This bundle version is regressive (feature removed / quota lowered / price raised). Publishing requires an explicit `forceRegressive: true` (UI confirmation dialog with MFA).",
         changes: diff.changes
       });
     }
@@ -7487,8 +8008,8 @@ var BundlesService = class _BundlesService {
     const hasHardBlockingWarning = blocking.some((w) => w.code === "BUNDLE_PLAN_KEY_UNKNOWN");
     if (this.mode === "blocking" || hasHardBlockingWarning) {
       throw new import_common43.UnprocessableEntityException({
-        code: "STRICT_MODE_VIOLATIONS",
-        message: "Strict-Mode-Check hat Drift gegen den Discovery-Snapshot gefunden.",
+        code: import_types20.CATALOG_ERROR_CODES.STRICT_MODE_VIOLATIONS,
+        message: "The strict-mode check found drift against the discovery snapshot.",
         warnings
       });
     }
@@ -7501,8 +8022,8 @@ var BundlesService = class _BundlesService {
     if (!validFromInput) {
       if (existing.publishedAt !== null) {
         throw new import_common43.UnprocessableEntityException({
-          code: "BUNDLE_VERSION_VALID_FROM_REQUIRED",
-          message: "Published BundleVersionen m\xFCssen ein validFrom behalten. Setze ein neues zuk\xFCnftiges Datum oder bearbeite die Draft vor dem Publish."
+          code: import_types20.CATALOG_ERROR_CODES.BUNDLE_VERSION_VALID_FROM_REQUIRED,
+          message: "Published bundle versions must keep a validFrom. Set a new future date, or edit the draft before publishing."
         });
       }
       return;
@@ -7510,14 +8031,21 @@ var BundlesService = class _BundlesService {
     const validFrom = this.parseRequiredBundleDate(validFromInput, "validFrom", "BUNDLE_VERSION_VALID_FROM_INVALID");
     if (existing.publishedAt !== null && validFrom.getTime() <= Date.now()) {
       throw new import_common43.UnprocessableEntityException({
-        code: "BUNDLE_VERSION_VALID_FROM_NOT_FUTURE",
-        message: `validFrom (${validFrom.toISOString()}) muss f\xFCr eine published-but-future BundleVersion weiterhin in der Zukunft liegen.`
+        code: import_types20.CATALOG_ERROR_CODES.BUNDLE_VERSION_VALID_FROM_NOT_FUTURE,
+        message: `validFrom (${validFrom.toISOString()}) must, for a published-but-future bundle version, still lie in the future.`,
+        params: {
+          validFrom: validFrom.toISOString()
+        }
       });
     }
     if (validUntil && validUntil <= validFrom) {
       throw new import_common43.UnprocessableEntityException({
-        code: "BUNDLE_VERSION_VALID_UNTIL_BEFORE_FROM",
-        message: `validUntil (${validUntil.toISOString()}) muss strikt nach validFrom (${validFrom.toISOString()}) liegen.`
+        code: import_types20.CATALOG_ERROR_CODES.BUNDLE_VERSION_VALID_UNTIL_BEFORE_FROM,
+        message: `validUntil (${validUntil.toISOString()}) must be strictly after validFrom (${validFrom.toISOString()}).`,
+        params: {
+          validUntil: validUntil.toISOString(),
+          validFrom: validFrom.toISOString()
+        }
       });
     }
     const previous = await this.findPreviousBundleVersion(existing);
@@ -7526,8 +8054,12 @@ var BundlesService = class _BundlesService {
     if (Number.isNaN(previousValidFrom.getTime())) return;
     if (validFrom <= previousValidFrom) {
       throw new import_common43.UnprocessableEntityException({
-        code: "BUNDLE_VERSION_VALID_FROM_NOT_AFTER_PREVIOUS",
-        message: `validFrom (${validFrom.toISOString()}) muss strikt nach validFrom der Vorg\xE4nger-Version (${previous.validFrom}) liegen.`
+        code: import_types20.CATALOG_ERROR_CODES.BUNDLE_VERSION_VALID_FROM_NOT_AFTER_PREVIOUS,
+        message: `validFrom (${validFrom.toISOString()}) must be strictly after the validFrom of the previous version (${previous.validFrom}).`,
+        params: {
+          validFrom: validFrom.toISOString(),
+          previousValidFrom: previous.validFrom
+        }
       });
     }
     if (!previous.validUntil) return;
@@ -7537,8 +8069,11 @@ var BundlesService = class _BundlesService {
     const requiredStart = new Date(previousValidUntil.getTime() + dayMs);
     if (validFrom.getTime() !== requiredStart.getTime()) {
       throw new import_common43.UnprocessableEntityException({
-        code: "BUNDLE_VERSION_VALID_FROM_NOT_GAPLESS",
-        message: `Vorg\xE4nger hat validUntil=${previous.validUntil.slice(0, 10)} \u2014 der Nachfolger muss nahtlos am Folgetag (${requiredStart.toISOString().slice(0, 10)}) starten. Geliefert: ${validFrom.toISOString().slice(0, 10)}.`,
+        code: import_types20.CATALOG_ERROR_CODES.BUNDLE_VERSION_VALID_FROM_NOT_GAPLESS,
+        message: `The predecessor has validUntil=${previous.validUntil.slice(0, 10)} \u2014 the successor must start seamlessly on the next day (${requiredStart.toISOString().slice(0, 10)}). Received: ${validFrom.toISOString().slice(0, 10)}.`,
+        params: {
+          received: validFrom.toISOString().slice(0, 10)
+        },
         requiredValidFrom: requiredStart.toISOString().slice(0, 10),
         previousValidUntil: previous.validUntil
       });
@@ -7557,7 +8092,12 @@ var BundlesService = class _BundlesService {
     if (Number.isNaN(date.getTime())) {
       throw new import_common43.UnprocessableEntityException({
         code,
-        message: `${field} '${input}' ist kein g\xFCltiges Datum`
+        message: `${field} '${input}' is not a valid date`,
+        // Keyed by the field name so these params match the publish
+        // path, where the same codes carry `validFrom` / `validUntil`.
+        params: {
+          [field]: input
+        }
       });
     }
     return date;
@@ -7592,6 +8132,7 @@ BundlesService = _ts_decorate44([
 
 // src/catalog/marketing-projections.service.ts
 var import_common44 = require("@nestjs/common");
+var import_types21 = require("@saasicat/types");
 function _ts_decorate45(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -7623,7 +8164,13 @@ var MarketingProjectionsService = class {
   async getById(id) {
     const row = await this.repo.findById(id);
     if (!row) {
-      throw new import_common44.NotFoundException(`MarketingProjection '${id}' nicht gefunden`);
+      throw new import_common44.NotFoundException({
+        code: import_types21.CATALOG_ERROR_CODES.MARKETING_PROJECTION_NOT_FOUND,
+        message: `MarketingProjection '${id}' not found`,
+        params: {
+          projectionId: id
+        }
+      });
     }
     return row;
   }
@@ -7631,7 +8178,15 @@ var MarketingProjectionsService = class {
     const locale = data.locale ?? "de";
     const existing = await this.repo.findByTarget(data.targetType, data.targetVersionId, locale);
     if (existing) {
-      throw new import_common44.ConflictException(`MarketingProjection f\xFCr ${data.targetType}/${data.targetVersionId}/${locale} existiert bereits \u2014 nutze PATCH zum Editieren`);
+      throw new import_common44.ConflictException({
+        code: import_types21.CATALOG_ERROR_CODES.MARKETING_PROJECTION_ALREADY_EXISTS,
+        message: `Marketing projection for ${data.targetType}/${data.targetVersionId}/${locale} already exists \u2014 use PATCH to edit it`,
+        params: {
+          targetType: data.targetType,
+          targetVersionId: data.targetVersionId,
+          locale
+        }
+      });
     }
     return this.repo.create({
       ...data,
@@ -7641,14 +8196,26 @@ var MarketingProjectionsService = class {
   async update(id, data) {
     const existing = await this.repo.findById(id);
     if (!existing) {
-      throw new import_common44.NotFoundException(`MarketingProjection '${id}' nicht gefunden`);
+      throw new import_common44.NotFoundException({
+        code: import_types21.CATALOG_ERROR_CODES.MARKETING_PROJECTION_NOT_FOUND,
+        message: `MarketingProjection '${id}' not found`,
+        params: {
+          projectionId: id
+        }
+      });
     }
     return this.repo.update(id, data);
   }
   async delete(id) {
     const existing = await this.repo.findById(id);
     if (!existing) {
-      throw new import_common44.NotFoundException(`MarketingProjection '${id}' nicht gefunden`);
+      throw new import_common44.NotFoundException({
+        code: import_types21.CATALOG_ERROR_CODES.MARKETING_PROJECTION_NOT_FOUND,
+        message: `MarketingProjection '${id}' not found`,
+        params: {
+          projectionId: id
+        }
+      });
     }
     await this.repo.delete(id);
   }
@@ -7664,6 +8231,7 @@ MarketingProjectionsService = _ts_decorate45([
 
 // src/catalog/catalog-entries.service.ts
 var import_common45 = require("@nestjs/common");
+var import_types22 = require("@saasicat/types");
 
 // src/catalog/approval-signature.ts
 function featureApprovalSignature(featureKey, snapshot) {
@@ -7776,14 +8344,14 @@ var CatalogEntriesService = class _CatalogEntriesService {
     if (!this.autoSyncAtBoot) return;
     const snapshot = resolveDiscoverySnapshot(this.snapshot, this.scanner);
     if (!snapshot) {
-      this.logger.warn("Discovery-Auto-Sync \xFCbersprungen: kein Snapshot (weder Token noch DiscoveryScanner injiziert). DiscoveryModule wiren (#25).");
+      this.logger.warn("Discovery auto-sync skipped: no snapshot (neither token nor DiscoveryScanner injected). Wire up DiscoveryModule (#25).");
       return;
     }
     try {
       const result = await this.syncFromSnapshot(snapshot);
       this.logger.log(`Discovery-Auto-Sync (${snapshot.app.key}): Features ${result.features.discovered}\u2191/${result.features.retired}\u2193/${result.features.outdated}\u26A0, Quotas ${result.quotas.discovered}\u2191/${result.quotas.retired}\u2193/${result.quotas.outdated}\u26A0, Capabilities ${result.capabilities.discovered}\u2191/${result.capabilities.retired}\u2193`);
     } catch (err) {
-      this.logger.error(`Discovery-Auto-Sync beim Boot fehlgeschlagen (${snapshot.app.key}) \u2014 Katalog ggf. veraltet; manuell via POST /admin/catalog/discovery/sync nachziehen`, err instanceof Error ? err.stack : String(err));
+      this.logger.error(`Discovery auto-sync on boot failed (${snapshot.app.key}) \u2014 the catalog may be stale; re-sync manually via POST /admin/catalog/discovery/sync`, err instanceof Error ? err.stack : String(err));
     }
   }
   listCapabilities(projectKey, codeStatus) {
@@ -7813,7 +8381,14 @@ var CatalogEntriesService = class _CatalogEntriesService {
   async reviewFeature(projectKey, featureKey, data, reviewedBy) {
     const existing = await this.repo.findFeature(projectKey, featureKey);
     if (!existing) {
-      throw new import_common45.NotFoundException(`Feature '${featureKey}' in Projekt '${projectKey}' nicht gefunden`);
+      throw new import_common45.NotFoundException({
+        code: import_types22.CATALOG_ERROR_CODES.FEATURE_NOT_FOUND,
+        message: `Feature '${featureKey}' not found in project '${projectKey}'`,
+        params: {
+          featureKey,
+          projectKey
+        }
+      });
     }
     return this.repo.setFeatureReview(projectKey, featureKey, this.resolveReviewUpdate(existing, data.discoveryStatus, reviewedBy, (snapshot) => featureApprovalSignature(featureKey, snapshot)));
   }
@@ -7821,24 +8396,47 @@ var CatalogEntriesService = class _CatalogEntriesService {
   async reviewQuota(projectKey, quotaKey, data, reviewedBy) {
     const existing = await this.repo.findQuota(projectKey, quotaKey);
     if (!existing) {
-      throw new import_common45.NotFoundException(`Quota '${quotaKey}' in Projekt '${projectKey}' nicht gefunden`);
+      throw new import_common45.NotFoundException({
+        code: import_types22.CATALOG_ERROR_CODES.QUOTA_NOT_FOUND,
+        message: `Quota '${quotaKey}' not found in project '${projectKey}'`,
+        params: {
+          quotaKey,
+          projectKey
+        }
+      });
     }
     return this.repo.setQuotaReview(projectKey, quotaKey, this.resolveReviewUpdate(existing, data.discoveryStatus, reviewedBy, (snapshot) => {
       const discovered = snapshot.quotas.find((q) => q.quotaKey === quotaKey);
       if (!discovered) {
-        throw new import_common45.UnprocessableEntityException(`Quota '${quotaKey}' ist nicht im Discovery-Snapshot \u2014 eine nicht im Code deklarierte Quota kann nicht freigegeben werden`);
+        throw new import_common45.UnprocessableEntityException({
+          code: import_types22.CATALOG_ERROR_CODES.QUOTA_NOT_IN_DISCOVERY_SNAPSHOT,
+          message: `Quota '${quotaKey}' is not in the discovery snapshot \u2014 a quota that is not declared in code cannot be approved`,
+          params: {
+            quotaKey
+          }
+        });
       }
       return quotaApprovalSignature(discovered);
     }));
   }
   resolveReviewUpdate(existing, target, reviewedBy, signatureOf) {
     if (!REVIEW_TRANSITIONS[existing.discoveryStatus].includes(target)) {
-      throw new import_common45.UnprocessableEntityException(`\xDCbergang '${existing.discoveryStatus}' \u2192 '${target}' ist nicht erlaubt`);
+      throw new import_common45.UnprocessableEntityException({
+        code: import_types22.CATALOG_ERROR_CODES.DISCOVERY_STATUS_TRANSITION_INVALID,
+        message: `Transition '${existing.discoveryStatus}' \u2192 '${target}' is not allowed`,
+        params: {
+          from: existing.discoveryStatus,
+          to: target
+        }
+      });
     }
     if (target === "approved") {
       const snapshot = resolveDiscoverySnapshot(this.snapshot, this.scanner);
       if (!snapshot) {
-        throw new import_common45.UnprocessableEntityException("Freigabe braucht einen Discovery-Snapshot \u2014 Discovery ist nicht initialisiert (#25)");
+        throw new import_common45.UnprocessableEntityException({
+          code: import_types22.CATALOG_ERROR_CODES.DISCOVERY_NOT_INITIALIZED,
+          message: "Approval requires a discovery snapshot \u2014 discovery is not initialised (#25)"
+        });
       }
       return {
         discoveryStatus: "approved",
@@ -8031,7 +8629,7 @@ var CatalogEntriesService = class _CatalogEntriesService {
         const claimants = claimantsByOldKey.get(entry.key);
         if (claimants && claimants.length > 0) {
           if (claimants.length > 1) {
-            this.logger.warn(`${type} '${entry.key}' wird von mehreren replaces-Deklarationen beansprucht (${claimants.join(", ")}); '${claimants[0]}' gewinnt \u2014 replaces im Code bereinigen (#39)`);
+            this.logger.warn(`${type} '${entry.key}' is claimed by several replaces declarations (${claimants.join(", ")}); '${claimants[0]}' wins \u2014 clean up the replaces in the code (#39)`);
           }
           target = claimants[0];
         }
@@ -8044,7 +8642,7 @@ var CatalogEntriesService = class _CatalogEntriesService {
     if (changes.length === 0) return 0;
     const setSuccessor = type === "feature" ? this.repo.setFeatureSuccessor?.bind(this.repo) : this.repo.setQuotaSuccessor?.bind(this.repo);
     if (!setSuccessor) {
-      this.logger.warn(`CatalogEntryRepository implementiert set${type === "feature" ? "Feature" : "Quota"}Successor nicht \u2014 ${changes.length} Nachfolger-Pointer (#39) werden nicht persistiert`);
+      this.logger.warn(`CatalogEntryRepository does not implement set${type === "feature" ? "Feature" : "Quota"}Successor  \u2014 ${changes.length} successor pointers (#39) are not persisted`);
       return 0;
     }
     let replaced = 0;
@@ -8212,7 +8810,7 @@ var ListCatalogEntriesQueryDto = class {
 _ts_decorate48([
   (0, import_class_validator6.IsString)(),
   (0, import_class_validator6.Matches)(PROJECT_KEY_PATTERN, {
-    message: "projectKey muss kebab-case sein"
+    message: "projectKey must be kebab-case"
   }),
   _ts_metadata35("design:type", String)
 ], ListCatalogEntriesQueryDto.prototype, "projectKey", void 0);
@@ -8237,7 +8835,7 @@ var ReviewCatalogEntryDto = class {
 _ts_decorate48([
   (0, import_class_validator6.IsString)(),
   (0, import_class_validator6.IsIn)(REVIEW_STATUSES, {
-    message: "discoveryStatus muss pending|approved|outdated|obsolete sein"
+    message: "discoveryStatus must be pending|approved|outdated|obsolete"
   }),
   _ts_metadata35("design:type", typeof DiscoveryStatus === "undefined" ? Object : DiscoveryStatus)
 ], ReviewCatalogEntryDto.prototype, "discoveryStatus", void 0);
@@ -8538,6 +9136,7 @@ __name(buildCatalogEntriesController, "buildCatalogEntriesController");
 
 // src/catalog/promotions.service.ts
 var import_common48 = require("@nestjs/common");
+var import_types23 = require("@saasicat/types");
 function _ts_decorate50(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -8571,7 +9170,13 @@ var PromotionsService = class {
   async getById(id) {
     const row = await this.repo.findById(id);
     if (!row) {
-      throw new import_common48.NotFoundException(`Promotion '${id}' nicht gefunden`);
+      throw new import_common48.NotFoundException({
+        code: import_types23.CATALOG_ERROR_CODES.PROMOTION_NOT_FOUND,
+        message: `Promotion '${id}' not found`,
+        params: {
+          promotionId: id
+        }
+      });
     }
     return row;
   }
@@ -8581,14 +9186,26 @@ var PromotionsService = class {
   async update(id, data) {
     const existing = await this.repo.findById(id);
     if (!existing) {
-      throw new import_common48.NotFoundException(`Promotion '${id}' nicht gefunden`);
+      throw new import_common48.NotFoundException({
+        code: import_types23.CATALOG_ERROR_CODES.PROMOTION_NOT_FOUND,
+        message: `Promotion '${id}' not found`,
+        params: {
+          promotionId: id
+        }
+      });
     }
     return this.repo.update(id, data);
   }
   async delete(id) {
     const existing = await this.repo.findById(id);
     if (!existing) {
-      throw new import_common48.NotFoundException(`Promotion '${id}' nicht gefunden`);
+      throw new import_common48.NotFoundException({
+        code: import_types23.CATALOG_ERROR_CODES.PROMOTION_NOT_FOUND,
+        message: `Promotion '${id}' not found`,
+        params: {
+          promotionId: id
+        }
+      });
     }
     await this.repo.delete(id);
   }
@@ -8645,7 +9262,7 @@ var ListPromotionsQueryDto = class {
 _ts_decorate51([
   (0, import_class_validator7.IsString)(),
   (0, import_class_validator7.Matches)(PROJECT_KEY_PATTERN2, {
-    message: "projectKey muss kebab-case sein"
+    message: "projectKey must be kebab-case"
   }),
   _ts_metadata38("design:type", String)
 ], ListPromotionsQueryDto.prototype, "projectKey", void 0);
@@ -8713,14 +9330,14 @@ _ts_decorate51([
 _ts_decorate51([
   (0, import_class_validator7.IsString)(),
   (0, import_class_validator7.Matches)(ISO_DATE_PATTERN2, {
-    message: "validFrom muss ISO-Datum sein"
+    message: "validFrom must be an ISO date"
   }),
   _ts_metadata38("design:type", String)
 ], CreatePromotionDto.prototype, "validFrom", void 0);
 _ts_decorate51([
   (0, import_class_validator7.IsString)(),
   (0, import_class_validator7.Matches)(ISO_DATE_PATTERN2, {
-    message: "validTo muss ISO-Datum sein"
+    message: "validTo must be an ISO date"
   }),
   _ts_metadata38("design:type", String)
 ], CreatePromotionDto.prototype, "validTo", void 0);
@@ -9041,7 +9658,7 @@ var ListMarketingSettingsQueryDto = class {
 _ts_decorate54([
   (0, import_class_validator8.IsString)(),
   (0, import_class_validator8.Matches)(PROJECT_KEY_PATTERN3, {
-    message: "projectKey muss kebab-case sein"
+    message: "projectKey must be kebab-case"
   }),
   _ts_metadata41("design:type", String)
 ], ListMarketingSettingsQueryDto.prototype, "projectKey", void 0);
@@ -9055,7 +9672,7 @@ var UpdateMarketingSettingsDto = class {
 _ts_decorate54([
   (0, import_class_validator8.IsString)(),
   (0, import_class_validator8.Matches)(PROJECT_KEY_PATTERN3, {
-    message: "projectKey muss kebab-case sein"
+    message: "projectKey must be kebab-case"
   }),
   _ts_metadata41("design:type", String)
 ], UpdateMarketingSettingsDto.prototype, "projectKey", void 0);
@@ -9067,7 +9684,7 @@ _ts_decorate54([
   }),
   (0, import_class_validator8.Matches)(LOCALE_PATTERN, {
     each: true,
-    message: "Locale muss ISO-639-1 sein"
+    message: "Locale must be ISO-639-1"
   }),
   _ts_metadata41("design:type", Array)
 ], UpdateMarketingSettingsDto.prototype, "activeLocales", void 0);
@@ -9142,7 +9759,7 @@ __name(buildMarketingSettingsController, "buildMarketingSettingsController");
 
 // src/catalog/public-marketing-catalog.service.ts
 var import_common52 = require("@nestjs/common");
-var import_types7 = require("@saasicat/types");
+var import_types24 = require("@saasicat/types");
 function _ts_decorate56(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -9245,7 +9862,7 @@ var PublicMarketingCatalogService = class {
       });
     }
     out.sort((a, b) => b.priority - a.priority);
-    const requiresIndex = (0, import_types7.buildFeatureRequiresIndex)([
+    const requiresIndex = (0, import_types24.buildFeatureRequiresIndex)([
       ...labelMeta.features
     ].map(([featureKey, meta]) => ({
       featureKey,
@@ -9299,7 +9916,7 @@ var PublicMarketingCatalogService = class {
     const features = [
       ...bv.features ?? []
     ];
-    const requiresFeatures = (0, import_types7.collectUnsatisfiedRequires)(features, requiresIndex);
+    const requiresFeatures = (0, import_types24.collectUnsatisfiedRequires)(features, requiresIndex);
     return {
       bundleKey: bv.bundleKey,
       label: marketing?.displayLabel || bv.label,
@@ -9443,12 +10060,12 @@ var PublicMarketingCatalogService = class {
     };
   }
   resolvePromo(promotions, targetKey, targetType, locale, monthlyNet, yearlyNet, asOf) {
-    const monthlyPromo = (0, import_types7.pickActivePromo)(promotions, targetKey, locale, "monthly", asOf, targetType);
-    const yearlyPromo = (0, import_types7.pickActivePromo)(promotions, targetKey, locale, "yearly", asOf, targetType);
+    const monthlyPromo = (0, import_types24.pickActivePromo)(promotions, targetKey, locale, "monthly", asOf, targetType);
+    const yearlyPromo = (0, import_types24.pickActivePromo)(promotions, targetKey, locale, "yearly", asOf, targetType);
     const promo = monthlyPromo ?? yearlyPromo;
     if (!promo) return null;
-    const monthlyResult = (0, import_types7.applyPromo)(monthlyPromo, monthlyNet);
-    const yearlyResult = (0, import_types7.applyPromo)(yearlyPromo, yearlyNet);
+    const monthlyResult = (0, import_types24.applyPromo)(monthlyPromo, monthlyNet);
+    const yearlyResult = (0, import_types24.applyPromo)(yearlyPromo, yearlyNet);
     const i18n = promo.i18n?.[locale] ?? promo.i18n?.[DEFAULT_LOCALE] ?? {};
     return {
       type: promo.type,
@@ -9555,6 +10172,7 @@ __name(parseAsOf, "parseAsOf");
 
 // src/catalog/plans.service.ts
 var import_common54 = require("@nestjs/common");
+var import_types25 = require("@saasicat/types");
 function _ts_decorate58(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -9601,24 +10219,55 @@ var PlansService = class {
   }
   async getPlan(planId) {
     const plan = await this.repo.findById(planId);
-    if (!plan) throw new import_common54.NotFoundException(`Plan '${planId}' nicht gefunden`);
+    if (!plan) {
+      throw new import_common54.NotFoundException({
+        code: import_types25.CATALOG_ERROR_CODES.PLAN_NOT_FOUND,
+        message: `Plan '${planId}' not found`,
+        params: {
+          planId
+        }
+      });
+    }
     return plan;
   }
   async createPlan(data) {
     const existing = await this.repo.findByKey(data.projectKey, data.planKey);
     if (existing) {
-      throw new import_common54.UnprocessableEntityException(`Plan '${data.planKey}' existiert bereits in Projekt '${data.projectKey}'`);
+      throw new import_common54.UnprocessableEntityException({
+        code: import_types25.CATALOG_ERROR_CODES.PLAN_ALREADY_EXISTS,
+        message: `Plan '${data.planKey}' already exists in project '${data.projectKey}'`,
+        params: {
+          planKey: data.planKey,
+          projectKey: data.projectKey
+        }
+      });
     }
     return this.repo.create(data);
   }
   async updatePlan(planId, data) {
     const existing = await this.repo.findById(planId);
-    if (!existing) throw new import_common54.NotFoundException(`Plan '${planId}' nicht gefunden`);
+    if (!existing) {
+      throw new import_common54.NotFoundException({
+        code: import_types25.CATALOG_ERROR_CODES.PLAN_NOT_FOUND,
+        message: `Plan '${planId}' not found`,
+        params: {
+          planId
+        }
+      });
+    }
     return this.repo.update(planId, data);
   }
   async softDeletePlan(planId) {
     const existing = await this.repo.findById(planId);
-    if (!existing) throw new import_common54.NotFoundException(`Plan '${planId}' nicht gefunden`);
+    if (!existing) {
+      throw new import_common54.NotFoundException({
+        code: import_types25.CATALOG_ERROR_CODES.PLAN_NOT_FOUND,
+        message: `Plan '${planId}' not found`,
+        params: {
+          planId
+        }
+      });
+    }
     if (existing.deletedAt !== null) return;
     await this.assertNoPublishedVersions(existing.planKey, "soft-delete");
     await this.repo.softDelete(planId);
@@ -9635,13 +10284,21 @@ var PlansService = class {
    */
   async hardDeletePlan(planId) {
     const existing = await this.repo.findById(planId);
-    if (!existing) throw new import_common54.NotFoundException(`Plan '${planId}' nicht gefunden`);
+    if (!existing) {
+      throw new import_common54.NotFoundException({
+        code: import_types25.CATALOG_ERROR_CODES.PLAN_NOT_FOUND,
+        message: `Plan '${planId}' not found`,
+        params: {
+          planId
+        }
+      });
+    }
     await this.assertNoPublishedVersions(existing.planKey, "hard-delete");
     await this.assertNoDrafts(existing.planKey);
     if (typeof this.repo.hardDelete !== "function") {
       throw new import_common54.UnprocessableEntityException({
-        code: "PLAN_HARD_DELETE_NOT_IMPLEMENTED",
-        message: "Hartes L\xF6schen ist im aktuellen Repository nicht implementiert. Implementiere PlanRepository.hardDelete."
+        code: import_types25.CATALOG_ERROR_CODES.PLAN_HARD_DELETE_NOT_IMPLEMENTED,
+        message: "Hard delete is not implemented in the current repository. Implement PlanRepository.hardDelete."
       });
     }
     await this.repo.hardDelete(planId);
@@ -9661,8 +10318,12 @@ var PlansService = class {
     const live = published.filter((v) => v.supersededAt === null).length;
     const superseded = published.length - live;
     throw new import_common54.UnprocessableEntityException({
-      code: "PLAN_HAS_PUBLISHED_VERSIONS",
-      message: `Plan '${planKey}' kann nicht ${op === "hard-delete" ? "gel\xF6scht" : "archiviert"} werden \u2014 der Plan hat ${published.length} published Version(en) (${live} live, ${superseded} superseded). Bestand-Subscriptions referenzieren diese Versionen (Vertragsschutz P1), der Plan-Stamm muss erhalten bleiben.`,
+      code: import_types25.CATALOG_ERROR_CODES.PLAN_HAS_PUBLISHED_VERSIONS,
+      message: `Plan '${planKey}' cannot be ${op === "hard-delete" ? "deleted" : "archived"} \u2014 it has ${published.length} published version(s) (${live} live, ${superseded} superseded). Existing subscriptions reference those versions (contract protection P1), so the plan record must be preserved.`,
+      params: {
+        planKey,
+        operation: op
+      },
       publishedCount: published.length,
       liveCount: live,
       supersededCount: superseded
@@ -9674,8 +10335,11 @@ var PlansService = class {
     const drafts = versions.filter((v) => v.publishedAt === null);
     if (drafts.length === 0) return;
     throw new import_common54.UnprocessableEntityException({
-      code: "PLAN_HAS_DRAFTS",
-      message: `Plan '${planKey}' hat noch ${drafts.length} offene Draft-Version(en). Verwerfe sie zuerst (DELETE /admin/catalog/plan-versions/:id) oder publishe sie.`,
+      code: import_types25.CATALOG_ERROR_CODES.PLAN_HAS_DRAFTS,
+      message: `Plan '${planKey}' still has ${drafts.length} open draft version(s). Discard them first (DELETE /admin/catalog/plan-versions/:id) or publish them.`,
+      params: {
+        planKey
+      },
       draftCount: drafts.length
     });
   }
@@ -9694,7 +10358,7 @@ PlansService = _ts_decorate58([
 
 // src/catalog/plan-versions.service.ts
 var import_common55 = require("@nestjs/common");
-var import_types8 = require("@saasicat/types");
+var import_types26 = require("@saasicat/types");
 function _ts_decorate59(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -9733,7 +10397,7 @@ var PlanVersionsService = class _PlanVersionsService {
     this.mode = config.strictModeCheckMode ?? "blocking";
     this.marketedOnly = new Set(config.marketedOnlyFeatures ?? []);
     if (this.mode === "blocking" && !hasDiscoverySnapshotSource(this.snapshot, this.scanner)) {
-      this.logger.error("PlanVersionsService: strictModeCheckMode=blocking ohne DiscoverySnapshot-Quelle \u2014 degradiere auf warn-only. DiscoveryModule wiren (#25).");
+      this.logger.error("PlanVersionsService: strictModeCheckMode=blocking without a DiscoverySnapshot source \u2014 degrading to warn-only. Wire DiscoveryModule (#25).");
       this.mode = "warn-only";
     }
     const required = [
@@ -9747,7 +10411,7 @@ var PlanVersionsService = class _PlanVersionsService {
     ];
     for (const key of required) {
       if (typeof this.repo[key] !== "function") {
-        throw new Error(`PlanVersionsService: PlanRepository.${String(key)} fehlt \u2014 das Repository implementiert die Lifecycle-Methoden nicht.`);
+        throw new Error(`PlanVersionsService: PlanRepository.${String(key)} is missing \u2014 the repository does not implement the lifecycle methods.`);
       }
     }
   }
@@ -9763,18 +10427,27 @@ var PlanVersionsService = class _PlanVersionsService {
   async discardPlanDraft(versionId) {
     const existing = await this.repo.findVersionById(versionId);
     if (!existing) {
-      throw new import_common55.NotFoundException(`PlanVersion '${versionId}' nicht gefunden`);
+      throw new import_common55.NotFoundException({
+        code: import_types26.CATALOG_ERROR_CODES.PLAN_VERSION_NOT_FOUND,
+        message: `PlanVersion '${versionId}' not found`,
+        params: {
+          versionId
+        }
+      });
     }
     if (existing.publishedAt !== null) {
       throw new import_common55.UnprocessableEntityException({
-        code: "PLAN_VERSION_ALREADY_PUBLISHED",
-        message: `PlanVersion '${versionId}' ist bereits published und kann nicht verworfen werden.`
+        code: import_types26.CATALOG_ERROR_CODES.PLAN_VERSION_ALREADY_PUBLISHED,
+        message: `PlanVersion '${versionId}' is already published and cannot be discarded.`,
+        params: {
+          versionId
+        }
       });
     }
     if (typeof this.repo.deletePlanVersionDraft !== "function") {
       throw new import_common55.UnprocessableEntityException({
-        code: "PLAN_VERSION_DISCARD_NOT_IMPLEMENTED",
-        message: "Discard ist im aktuellen Repository nicht implementiert. Implementiere PlanRepository.deletePlanVersionDraft."
+        code: import_types26.CATALOG_ERROR_CODES.PLAN_VERSION_DISCARD_NOT_IMPLEMENTED,
+        message: "Discard is not implemented in the current repository. Implement PlanRepository.deletePlanVersionDraft."
       });
     }
     await this.repo.deletePlanVersionDraft(versionId);
@@ -9787,7 +10460,13 @@ var PlanVersionsService = class _PlanVersionsService {
   async listPlanVersions(planUuid) {
     const plan = await this.repo.findById(planUuid);
     if (!plan) {
-      throw new import_common55.NotFoundException(`Plan '${planUuid}' nicht gefunden`);
+      throw new import_common55.NotFoundException({
+        code: import_types26.CATALOG_ERROR_CODES.PLAN_NOT_FOUND,
+        message: `Plan '${planUuid}' not found`,
+        params: {
+          planId: planUuid
+        }
+      });
     }
     const versions = await this.repo.listVersions(plan.planKey);
     return this.annotateEditability(versions);
@@ -9795,7 +10474,13 @@ var PlanVersionsService = class _PlanVersionsService {
   async getPlanVersion(versionId) {
     const version = await this.repo.findVersionById(versionId);
     if (!version) {
-      throw new import_common55.NotFoundException(`PlanVersion '${versionId}' nicht gefunden`);
+      throw new import_common55.NotFoundException({
+        code: import_types26.CATALOG_ERROR_CODES.PLAN_VERSION_NOT_FOUND,
+        message: `PlanVersion '${versionId}' not found`,
+        params: {
+          versionId
+        }
+      });
     }
     const [annotated] = await this.annotateEditability([
       version
@@ -9833,12 +10518,25 @@ var PlanVersionsService = class _PlanVersionsService {
   async createPlanDraft(data) {
     const plan = await this.repo.findById(data.planId);
     if (!plan) {
-      throw new import_common55.NotFoundException(`Plan '${data.planId}' nicht gefunden`);
+      throw new import_common55.NotFoundException({
+        code: import_types26.CATALOG_ERROR_CODES.PLAN_NOT_FOUND,
+        message: `Plan '${data.planId}' not found`,
+        params: {
+          planId: data.planId
+        }
+      });
     }
     const planKey = plan.planKey;
     const existingDraft = await this.repo.findCurrentDraft(planKey);
     if (existingDraft) {
-      throw new import_common55.UnprocessableEntityException(`Plan '${planKey}' hat bereits eine Draft-Version v${existingDraft.version}; bitte erst publishen oder verwerfen`);
+      throw new import_common55.UnprocessableEntityException({
+        code: import_types26.CATALOG_ERROR_CODES.PLAN_DRAFT_ALREADY_EXISTS,
+        message: `Plan '${planKey}' already has a draft version v${existingDraft.version}; publish or discard it first`,
+        params: {
+          planKey,
+          draftVersion: existingDraft.version
+        }
+      });
     }
     let baseVersionId = data.baseVersionId;
     if (baseVersionId === void 0) {
@@ -9863,16 +10561,25 @@ var PlanVersionsService = class _PlanVersionsService {
   async updatePlanDraft(versionId, data) {
     const existing = await this.repo.findVersionById(versionId);
     if (!existing) {
-      throw new import_common55.NotFoundException(`PlanVersion '${versionId}' nicht gefunden`);
+      throw new import_common55.NotFoundException({
+        code: import_types26.CATALOG_ERROR_CODES.PLAN_VERSION_NOT_FOUND,
+        message: `PlanVersion '${versionId}' not found`,
+        params: {
+          versionId
+        }
+      });
     }
     const [annotated] = await this.annotateEditability([
       existing
     ]);
-    const { editable } = (0, import_types8.isVersionEditable)(annotated);
+    const { editable } = (0, import_types26.isVersionEditable)(annotated);
     if (!editable) {
       throw new import_common55.UnprocessableEntityException({
-        code: "PLAN_VERSION_NOT_EDITABLE",
-        message: `PlanVersion '${versionId}' ist nicht editierbar. Editierbar sind nur Drafts und published Versionen, die latest-in-chain sind, noch keine Subscription binden und deren validFrom in der Zukunft liegt.`
+        code: import_types26.CATALOG_ERROR_CODES.PLAN_VERSION_NOT_EDITABLE,
+        message: `PlanVersion '${versionId}' is not editable. Only drafts and published versions are editable that are latest-in-chain, bind no subscription yet, and whose validFrom lies in the future.`,
+        params: {
+          versionId
+        }
       });
     }
     const merged = {
@@ -9890,10 +10597,22 @@ var PlanVersionsService = class _PlanVersionsService {
   async publishPlanVersion(versionId, publishMeta) {
     const draft = await this.repo.findVersionById(versionId);
     if (!draft) {
-      throw new import_common55.NotFoundException(`PlanVersion '${versionId}' nicht gefunden`);
+      throw new import_common55.NotFoundException({
+        code: import_types26.CATALOG_ERROR_CODES.PLAN_VERSION_NOT_FOUND,
+        message: `PlanVersion '${versionId}' not found`,
+        params: {
+          versionId
+        }
+      });
     }
     if (draft.publishedAt !== null) {
-      throw new import_common55.UnprocessableEntityException(`PlanVersion '${versionId}' ist bereits published`);
+      throw new import_common55.UnprocessableEntityException({
+        code: import_types26.CATALOG_ERROR_CODES.PLAN_VERSION_ALREADY_PUBLISHED,
+        message: `PlanVersion '${versionId}' is already published`,
+        params: {
+          versionId
+        }
+      });
     }
     const warnings = await this.runStrictCheck({
       features: draft.features,
@@ -9905,8 +10624,8 @@ var PlanVersionsService = class _PlanVersionsService {
       const yearly = Number.parseFloat(String(draft.yearlyNet ?? "0"));
       if (monthly <= 0 || yearly <= 0) {
         throw new import_common55.UnprocessableEntityException({
-          code: "PLAN_VERSION_ZERO_PRICE",
-          message: "PlanVersion kann nicht mit Preis 0,00 published werden (Schutz gegen Seed-Platzhalter). F\xFCr bewusst kostenlose Sondervertr\xE4ge: allowZeroPrice setzen.",
+          code: import_types26.CATALOG_ERROR_CODES.PLAN_VERSION_ZERO_PRICE,
+          message: "A plan version cannot be published with a price of 0.00 (guard against seed placeholder). For deliberately free special contracts, set allowZeroPrice.",
           monthlyNet: String(draft.monthlyNet),
           yearlyNet: String(draft.yearlyNet)
         });
@@ -9916,23 +10635,30 @@ var PlanVersionsService = class _PlanVersionsService {
     const validFromInput = publishMeta.validFrom ?? draft.validFrom;
     if (!validFromInput) {
       throw new import_common55.UnprocessableEntityException({
-        code: "PLAN_VERSION_VALID_FROM_REQUIRED",
-        message: "Beim Publish muss validFrom gesetzt sein (auf Draft oder Publish-Aufruf). SPEC_V2 \xA74.2."
+        code: import_types26.CATALOG_ERROR_CODES.PLAN_VERSION_VALID_FROM_REQUIRED,
+        message: "validFrom must be set when publishing (on the draft or the publish call). SPEC_V2 \xA74.2."
       });
     }
     const validFrom = new Date(validFromInput);
     if (Number.isNaN(validFrom.getTime())) {
       throw new import_common55.UnprocessableEntityException({
-        code: "PLAN_VERSION_VALID_FROM_INVALID",
-        message: `validFrom '${validFromInput}' ist kein g\xFCltiges Datum`
+        code: import_types26.CATALOG_ERROR_CODES.PLAN_VERSION_VALID_FROM_INVALID,
+        message: `validFrom '${validFromInput}' is not a valid date`,
+        params: {
+          validFrom: validFromInput
+        }
       });
     }
     if (previous?.validFrom) {
       const prevFrom = new Date(previous.validFrom);
       if (validFrom <= prevFrom) {
         throw new import_common55.UnprocessableEntityException({
-          code: "PLAN_VERSION_VALID_FROM_NOT_AFTER_PREVIOUS",
-          message: `validFrom (${validFrom.toISOString()}) muss strikt nach validFrom der Vorg\xE4nger-Version (${previous.validFrom}) liegen.`
+          code: import_types26.CATALOG_ERROR_CODES.PLAN_VERSION_VALID_FROM_NOT_AFTER_PREVIOUS,
+          message: `validFrom (${validFrom.toISOString()}) must be strictly after the validFrom of the previous version (${previous.validFrom}).`,
+          params: {
+            validFrom: validFrom.toISOString(),
+            previousValidFrom: previous.validFrom
+          }
         });
       }
       if (previous.validUntil) {
@@ -9941,8 +10667,11 @@ var PlanVersionsService = class _PlanVersionsService {
         const requiredStart = new Date(prevUntil.getTime() + dayMs);
         if (validFrom.getTime() !== requiredStart.getTime()) {
           throw new import_common55.UnprocessableEntityException({
-            code: "PLAN_VERSION_VALID_FROM_NOT_GAPLESS",
-            message: `Vorg\xE4nger hat validUntil=${previous.validUntil.slice(0, 10)} \u2014 der Nachfolger muss nahtlos am Folgetag (${requiredStart.toISOString().slice(0, 10)}) starten. Geliefert: ${validFrom.toISOString().slice(0, 10)}.`,
+            code: import_types26.CATALOG_ERROR_CODES.PLAN_VERSION_VALID_FROM_NOT_GAPLESS,
+            message: `The predecessor has validUntil=${previous.validUntil.slice(0, 10)} \u2014 the successor must start seamlessly on the next day (${requiredStart.toISOString().slice(0, 10)}). Received: ${validFrom.toISOString().slice(0, 10)}.`,
+            params: {
+              received: validFrom.toISOString().slice(0, 10)
+            },
             requiredValidFrom: requiredStart.toISOString().slice(0, 10),
             previousValidUntil: previous.validUntil
           });
@@ -9953,14 +10682,21 @@ var PlanVersionsService = class _PlanVersionsService {
     const validUntil = validUntilInput ? new Date(validUntilInput) : null;
     if (validUntil && Number.isNaN(validUntil.getTime())) {
       throw new import_common55.UnprocessableEntityException({
-        code: "PLAN_VERSION_VALID_UNTIL_INVALID",
-        message: `validUntil '${validUntilInput}' ist kein g\xFCltiges Datum`
+        code: import_types26.CATALOG_ERROR_CODES.PLAN_VERSION_VALID_UNTIL_INVALID,
+        message: `validUntil '${validUntilInput}' is not a valid date`,
+        params: {
+          validUntil: validUntilInput
+        }
       });
     }
     if (validUntil && validUntil <= validFrom) {
       throw new import_common55.UnprocessableEntityException({
-        code: "PLAN_VERSION_VALID_UNTIL_BEFORE_FROM",
-        message: `validUntil (${validUntil.toISOString()}) muss strikt nach validFrom (${validFrom.toISOString()}) liegen.`
+        code: import_types26.CATALOG_ERROR_CODES.PLAN_VERSION_VALID_UNTIL_BEFORE_FROM,
+        message: `validUntil (${validUntil.toISOString()}) must be strictly after validFrom (${validFrom.toISOString()}).`,
+        params: {
+          validUntil: validUntil.toISOString(),
+          validFrom: validFrom.toISOString()
+        }
       });
     }
     const fieldsFor = /* @__PURE__ */ __name((v) => ({
@@ -9971,14 +10707,14 @@ var PlanVersionsService = class _PlanVersionsService {
       monthlyNet: v.monthlyNet,
       yearlyNet: v.yearlyNet
     }), "fieldsFor");
-    const diff = previous ? (0, import_types.classifyPlanDiff)(fieldsFor(previous), fieldsFor(draft)) : {
+    const diff = previous ? (0, import_types5.classifyPlanDiff)(fieldsFor(previous), fieldsFor(draft)) : {
       changes: [],
       nonRegressive: true
     };
     if (!diff.nonRegressive && !publishMeta.forceRegressive) {
       throw new import_common55.UnprocessableEntityException({
-        code: "PLAN_VERSION_REGRESSION",
-        message: "Diese PlanVersion ist regressiv (Feature entfernt / Quota gesenkt / Preis erh\xF6ht). Publishen erfordert explizites `forceRegressive: true` (UI-Best\xE4tigungsmodal mit MFA).",
+        code: import_types26.CATALOG_ERROR_CODES.PLAN_VERSION_REGRESSION,
+        message: "This plan version is regressive (feature removed / quota lowered / price raised). Publishing requires an explicit `forceRegressive: true` (UI confirmation dialog with MFA).",
         changes: diff.changes
       });
     }
@@ -10013,36 +10749,51 @@ var PlanVersionsService = class _PlanVersionsService {
   async terminatePlanVersion(versionId, endsAt) {
     const existing = await this.repo.findVersionById(versionId);
     if (!existing) {
-      throw new import_common55.NotFoundException(`PlanVersion '${versionId}' nicht gefunden`);
+      throw new import_common55.NotFoundException({
+        code: import_types26.CATALOG_ERROR_CODES.PLAN_VERSION_NOT_FOUND,
+        message: `PlanVersion '${versionId}' not found`,
+        params: {
+          versionId
+        }
+      });
     }
     if (existing.publishedAt === null) {
       throw new import_common55.UnprocessableEntityException({
-        code: "PLAN_VERSION_NOT_LIVE",
-        message: `PlanVersion '${versionId}' ist nicht published und kann nicht terminiert werden.`
+        code: import_types26.CATALOG_ERROR_CODES.PLAN_VERSION_NOT_PUBLISHED,
+        message: `PlanVersion '${versionId}' is not published and cannot be terminated.`,
+        params: {
+          versionId
+        }
       });
     }
     if (existing.supersededAt !== null) {
       throw new import_common55.UnprocessableEntityException({
-        code: "PLAN_VERSION_NOT_LIVE",
-        message: `PlanVersion '${versionId}' wurde bereits von einer Nachfolge-Version abgel\xF6st (supersededAt) und kann nicht terminiert werden.`
+        code: import_types26.CATALOG_ERROR_CODES.PLAN_VERSION_SUPERSEDED,
+        message: `PlanVersion '${versionId}' has already been superseded by a newer version (supersededAt) and cannot be terminated.`,
+        params: {
+          versionId
+        }
       });
     }
     if (Number.isNaN(endsAt.getTime())) {
       throw new import_common55.UnprocessableEntityException({
-        code: "PLAN_TERMINATE_INVALID_DATE",
-        message: "endsAt ist kein g\xFCltiges Datum."
+        code: import_types26.CATALOG_ERROR_CODES.PLAN_TERMINATE_INVALID_DATE,
+        message: "endsAt is not a valid date."
       });
     }
     if (endsAt.getTime() <= Date.now()) {
       throw new import_common55.UnprocessableEntityException({
-        code: "PLAN_TERMINATE_DATE_NOT_FUTURE",
-        message: `endsAt (${endsAt.toISOString()}) muss strikt in der Zukunft liegen.`
+        code: import_types26.CATALOG_ERROR_CODES.PLAN_TERMINATE_DATE_NOT_FUTURE,
+        message: `endsAt (${endsAt.toISOString()}) must lie strictly in the future.`,
+        params: {
+          endsAt: endsAt.toISOString()
+        }
       });
     }
     if (typeof this.repo.terminate !== "function") {
       throw new import_common55.UnprocessableEntityException({
-        code: "PLAN_TERMINATE_NOT_IMPLEMENTED",
-        message: "Terminate ist im aktuellen Repository nicht implementiert. Implementiere PlanRepository.terminate."
+        code: import_types26.CATALOG_ERROR_CODES.PLAN_TERMINATE_NOT_IMPLEMENTED,
+        message: "Terminate is not implemented in the current repository. Implement PlanRepository.terminate."
       });
     }
     return this.repo.terminate(versionId, endsAt);
@@ -10060,8 +10811,8 @@ var PlanVersionsService = class _PlanVersionsService {
     if (blockingStrictModeWarnings(warnings).length === 0) return;
     if (this.mode === "blocking") {
       throw new import_common55.UnprocessableEntityException({
-        code: "STRICT_MODE_VIOLATIONS",
-        message: "Strict-Mode-Check hat Drift gegen den Discovery-Snapshot gefunden.",
+        code: import_types26.CATALOG_ERROR_CODES.STRICT_MODE_VIOLATIONS,
+        message: "The strict-mode check found drift against the discovery snapshot.",
         warnings
       });
     }
@@ -10128,7 +10879,7 @@ var CreateBundleDto = class {
 _ts_decorate60([
   (0, import_class_validator9.IsString)(),
   (0, import_class_validator9.Matches)(PROJECT_KEY_PATTERN4, {
-    message: 'projectKey muss kebab-case sein (z. B. "my-app")'
+    message: 'projectKey must be kebab-case (e.g. "my-app")'
   }),
   (0, import_class_validator9.MaxLength)(64),
   _ts_metadata47("design:type", String)
@@ -10136,7 +10887,7 @@ _ts_decorate60([
 _ts_decorate60([
   (0, import_class_validator9.IsString)(),
   (0, import_class_validator9.Matches)(KEY_PATTERN, {
-    message: 'bundleKey muss SCREAMING_SNAKE_CASE sein (z. B. "BANKING")'
+    message: 'bundleKey must be SCREAMING_SNAKE_CASE (e.g. "BANKING")'
   }),
   (0, import_class_validator9.MaxLength)(64),
   _ts_metadata47("design:type", String)
@@ -10236,7 +10987,7 @@ _ts_decorate60([
   }),
   (0, import_class_validator9.Matches)(FEATURE_KEY_PATTERN, {
     each: true,
-    message: "features-Eintr\xE4ge m\xFCssen SCREAMING_SNAKE_CASE sein"
+    message: "features entries must be SCREAMING_SNAKE_CASE"
   }),
   _ts_metadata47("design:type", Array)
 ], CreateBundleVersionDraftDto.prototype, "features", void 0);
@@ -10262,7 +11013,7 @@ _ts_decorate60([
     no_symbols: false
   }),
   (0, import_class_validator9.Matches)(DECIMAL_PATTERN, {
-    message: 'monthlyNet muss Decimal mit max. 2 Nachkommastellen sein (z. B. "9.90")'
+    message: 'monthlyNet must be a decimal with at most 2 fraction digits (e.g. "9.90")'
   }),
   _ts_metadata47("design:type", Object)
 ], CreateBundleVersionDraftDto.prototype, "monthlyNet", void 0);
@@ -10273,7 +11024,7 @@ _ts_decorate60([
     no_symbols: false
   }),
   (0, import_class_validator9.Matches)(DECIMAL_PATTERN, {
-    message: "yearlyNet muss Decimal mit max. 2 Nachkommastellen sein"
+    message: "yearlyNet must be a decimal with at most 2 fraction digits"
   }),
   _ts_metadata47("design:type", Object)
 ], CreateBundleVersionDraftDto.prototype, "yearlyNet", void 0);
@@ -10297,7 +11048,7 @@ _ts_decorate60([
   (0, import_class_validator9.IsOptional)(),
   (0, import_class_validator9.ValidateIf)((_o, value) => value !== null),
   (0, import_class_validator9.Matches)(ISO_DATE_PATTERN3, {
-    message: "validFrom muss ISO-Datum sein (YYYY-MM-DD)"
+    message: "validFrom must be an ISO date (YYYY-MM-DD)"
   }),
   _ts_metadata47("design:type", Object)
 ], CreateBundleVersionDraftDto.prototype, "validFrom", void 0);
@@ -10305,7 +11056,7 @@ _ts_decorate60([
   (0, import_class_validator9.IsOptional)(),
   (0, import_class_validator9.ValidateIf)((_o, value) => value !== null),
   (0, import_class_validator9.Matches)(ISO_DATE_PATTERN3, {
-    message: "validUntil muss ISO-Datum sein (YYYY-MM-DD)"
+    message: "validUntil must be an ISO date (YYYY-MM-DD)"
   }),
   _ts_metadata47("design:type", Object)
 ], CreateBundleVersionDraftDto.prototype, "validUntil", void 0);
@@ -10377,7 +11128,7 @@ _ts_decorate60([
   (0, import_class_validator9.IsOptional)(),
   (0, import_class_validator9.ValidateIf)((_o, value) => value !== null),
   (0, import_class_validator9.Matches)(ISO_DATE_PATTERN3, {
-    message: "validFrom muss ISO-Datum sein (YYYY-MM-DD)"
+    message: "validFrom must be an ISO date (YYYY-MM-DD)"
   }),
   _ts_metadata47("design:type", Object)
 ], UpdateBundleVersionDraftDto.prototype, "validFrom", void 0);
@@ -10385,7 +11136,7 @@ _ts_decorate60([
   (0, import_class_validator9.IsOptional)(),
   (0, import_class_validator9.ValidateIf)((_o, value) => value !== null),
   (0, import_class_validator9.Matches)(ISO_DATE_PATTERN3, {
-    message: "validUntil muss ISO-Datum sein (YYYY-MM-DD)"
+    message: "validUntil must be an ISO date (YYYY-MM-DD)"
   }),
   _ts_metadata47("design:type", Object)
 ], UpdateBundleVersionDraftDto.prototype, "validUntil", void 0);
@@ -10422,7 +11173,7 @@ _ts_decorate60([
   (0, import_class_validator9.IsOptional)(),
   (0, import_class_validator9.ValidateIf)((_o, value) => value !== null),
   (0, import_class_validator9.Matches)(ISO_DATE_PATTERN3, {
-    message: "validFrom muss ISO-Datum sein (YYYY-MM-DD)"
+    message: "validFrom must be an ISO date (YYYY-MM-DD)"
   }),
   _ts_metadata47("design:type", Object)
 ], PublishBundleVersionDto.prototype, "validFrom", void 0);
@@ -10430,7 +11181,7 @@ _ts_decorate60([
   (0, import_class_validator9.IsOptional)(),
   (0, import_class_validator9.ValidateIf)((_o, value) => value !== null),
   (0, import_class_validator9.Matches)(ISO_DATE_PATTERN3, {
-    message: "validUntil muss ISO-Datum sein (YYYY-MM-DD)"
+    message: "validUntil must be an ISO date (YYYY-MM-DD)"
   }),
   _ts_metadata47("design:type", Object)
 ], PublishBundleVersionDto.prototype, "validUntil", void 0);
@@ -10734,7 +11485,7 @@ var CreateMarketingProjectionDto = class {
 _ts_decorate62([
   (0, import_class_validator10.IsString)(),
   (0, import_class_validator10.Matches)(PROJECT_KEY_PATTERN5, {
-    message: "projectKey muss kebab-case sein"
+    message: "projectKey must be kebab-case"
   }),
   (0, import_class_validator10.MaxLength)(64),
   _ts_metadata49("design:type", String)
@@ -10752,7 +11503,7 @@ _ts_decorate62([
   (0, import_class_validator10.IsOptional)(),
   (0, import_class_validator10.IsString)(),
   (0, import_class_validator10.Matches)(LOCALE_PATTERN2, {
-    message: 'locale muss ISO-639-1 sein (z. B. "de", "en", "de-AT")'
+    message: 'locale must be ISO-639-1 (e.g. "de", "en", "de-AT")'
   }),
   _ts_metadata49("design:type", String)
 ], CreateMarketingProjectionDto.prototype, "locale", void 0);
@@ -11083,7 +11834,7 @@ var CreatePlanDto = class {
 _ts_decorate64([
   (0, import_class_validator11.IsString)(),
   (0, import_class_validator11.Matches)(PROJECT_KEY_PATTERN6, {
-    message: 'projectKey muss kebab-case sein (z. B. "my-app")'
+    message: 'projectKey must be kebab-case (e.g. "my-app")'
   }),
   (0, import_class_validator11.MaxLength)(64),
   _ts_metadata51("design:type", String)
@@ -11091,7 +11842,7 @@ _ts_decorate64([
 _ts_decorate64([
   (0, import_class_validator11.IsString)(),
   (0, import_class_validator11.Matches)(KEY_PATTERN2, {
-    message: 'planKey muss SCREAMING_SNAKE_CASE sein (z. B. "STARTER")'
+    message: 'planKey must be SCREAMING_SNAKE_CASE (e.g. "STARTER")'
   }),
   (0, import_class_validator11.MaxLength)(64),
   _ts_metadata51("design:type", String)
@@ -11200,7 +11951,7 @@ _ts_decorate65([
   }),
   (0, import_class_validator12.Matches)(FEATURE_KEY_PATTERN2, {
     each: true,
-    message: "features-Eintr\xE4ge m\xFCssen SCREAMING_SNAKE_CASE sein"
+    message: "features entries must be SCREAMING_SNAKE_CASE"
   }),
   _ts_metadata52("design:type", Array)
 ], CreatePlanVersionDraftDto.prototype, "features", void 0);
@@ -11212,7 +11963,7 @@ _ts_decorate65([
   }),
   (0, import_class_validator12.Matches)(FEATURE_KEY_PATTERN2, {
     each: true,
-    message: "bundles-Eintr\xE4ge m\xFCssen SCREAMING_SNAKE_CASE sein"
+    message: "bundles entries must be SCREAMING_SNAKE_CASE"
   }),
   _ts_metadata52("design:type", Array)
 ], CreatePlanVersionDraftDto.prototype, "bundles", void 0);
@@ -11222,13 +11973,13 @@ _ts_decorate65([
 ], CreatePlanVersionDraftDto.prototype, "quotas", void 0);
 _ts_decorate65([
   (0, import_class_validator12.Matches)(DECIMAL_PATTERN2, {
-    message: 'monthlyNet muss Decimal mit max. 2 Nachkommastellen sein (z. B. "9.90")'
+    message: 'monthlyNet must be a decimal with at most 2 fraction digits (e.g. "9.90")'
   }),
   _ts_metadata52("design:type", String)
 ], CreatePlanVersionDraftDto.prototype, "monthlyNet", void 0);
 _ts_decorate65([
   (0, import_class_validator12.Matches)(DECIMAL_PATTERN2, {
-    message: "yearlyNet muss Decimal mit max. 2 Nachkommastellen sein"
+    message: "yearlyNet must be a decimal with at most 2 fraction digits"
   }),
   _ts_metadata52("design:type", String)
 ], CreatePlanVersionDraftDto.prototype, "yearlyNet", void 0);
@@ -11472,7 +12223,7 @@ function buildPlansController(guards) {
     }
     assertVersionsService() {
       if (!this.versionsService) {
-        throw new Error("PlanVersionsService nicht registriert \u2014 App hat den Plan-Lifecycle-Editor nicht aktiviert.");
+        throw new Error("PlanVersionsService is not registered \u2014 the app has not enabled the plan lifecycle editor.");
       }
     }
   };
@@ -11837,9 +12588,9 @@ function runPreflight(input) {
 __name(runPreflight, "runPreflight");
 function formatPreflightReport(report) {
   const lines = [];
-  lines.push(`Preflight (Status: ${report.overall.toUpperCase()})`, `  Plans: ${report.counts.planFindings} \xB7 Bundles: ${report.counts.bundleFindings} \xB7 Gesamt: ${report.counts.total}`, "");
+  lines.push(`Preflight (Status: ${report.overall.toUpperCase()})`, `  Plans: ${report.counts.planFindings} \xB7 Bundles: ${report.counts.bundleFindings} \xB7 Total: ${report.counts.total}`, "");
   if (report.findings.length === 0) {
-    lines.push("  \u2713 Keine Strict-Mode-Verst\xF6\xDFe gefunden.");
+    lines.push("  \u2713 No strict-mode violations found.");
     return lines.join("\n");
   }
   let lastEntity = "";
@@ -11909,9 +12660,9 @@ function validateSeedAgainstSnapshot(input) {
 __name(validateSeedAgainstSnapshot, "validateSeedAgainstSnapshot");
 function formatSeedGateReport(report) {
   const lines = [];
-  lines.push(`Seed-Gate (Status: ${report.overall.toUpperCase()})`, `  Plans: ${report.counts.planFindings} \xB7 Bundles: ${report.counts.bundleFindings} \xB7 Gesamt: ${report.counts.total}`, "");
+  lines.push(`Seed-Gate (Status: ${report.overall.toUpperCase()})`, `  Plans: ${report.counts.planFindings} \xB7 Bundles: ${report.counts.bundleFindings} \xB7 Total: ${report.counts.total}`, "");
   if (report.findings.length === 0) {
-    lines.push("  \u2713 Alle geseedeten Plan-/Bundle-Features sind discovered (und, sofern gepr\xFCft, approved).");
+    lines.push("  \u2713 Every seeded plan/bundle feature is discovered (and approved where checked).");
     return lines.join("\n");
   }
   let lastEntity = "";
@@ -11941,7 +12692,7 @@ var DiscoverySnapshotNotFoundError = class extends Error {
   }
   path;
   constructor(path) {
-    super(`Discovery-Snapshot-Datei nicht gefunden: ${path}. Booten Sie zuerst die App mit DISCOVERY_SNAPSHOT_PATH oder DiscoveryModule.forRoot({ snapshotPath: '\u2026' }), damit der Scanner die Datei beim OnApplicationBootstrap-Hook schreibt.`), this.path = path;
+    super(`Discovery snapshot file not found: ${path}. Boot the app first with DISCOVERY_SNAPSHOT_PATH or DiscoveryModule.forRoot({ snapshotPath: '\u2026' }) so that the scanner writes the file on the OnApplicationBootstrap hook.`), this.path = path;
     this.name = "DiscoverySnapshotNotFoundError";
   }
 };
@@ -11968,10 +12719,10 @@ function runSeedGateFromFile(options) {
   } catch (err) {
     if (err instanceof DiscoverySnapshotNotFoundError) {
       if (mode === "blocking") {
-        error(`[seed-gate] FEHLER: Kein Discovery-Snapshot unter ${options.snapshotPath} \u2014 im blocking-Modus Pflicht (Headless-Scan vor dem Seed ausf\xFChren, #23).`);
+        error(`[seed-gate] ERROR: no discovery snapshot at ${options.snapshotPath} \u2014 required in blocking mode (run the headless scan before seeding, #23).`);
         return exit(4);
       }
-      warn(`[seed-gate] Kein Discovery-Snapshot unter ${options.snapshotPath} \u2014 \xFCbersprungen (report-only).`);
+      warn(`[seed-gate] No discovery snapshot at ${options.snapshotPath} \u2014 skipped (report-only).`);
       return null;
     }
     throw err;
@@ -11985,10 +12736,10 @@ function runSeedGateFromFile(options) {
   log(formatSeedGateReport(report));
   if (report.overall === "error") {
     if (mode === "blocking") {
-      error("[seed-gate] blocking: Verst\xF6\xDFe gefunden \u2014 Seed wird abgebrochen (#23).");
+      error("[seed-gate] blocking: violations found \u2014 aborting the seed (#23).");
       return exit(seedGateExitCode(report));
     }
-    warn("[seed-gate] report-only: Verst\xF6\xDFe gefunden, Seed l\xE4uft trotzdem weiter.");
+    warn("[seed-gate] report-only: violations found, seeding continues anyway.");
   }
   return report;
 }
@@ -12007,7 +12758,7 @@ __export(checkout_offer_exports, {
 
 // src/checkout-offer/checkout-offer.service.ts
 var import_common60 = require("@nestjs/common");
-var import_types9 = require("@saasicat/types");
+var import_types27 = require("@saasicat/types");
 
 // src/checkout-offer/tokens.ts
 var CHECKOUT_OFFER_REPOSITORY_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform/CheckoutOfferRepository");
@@ -12050,7 +12801,13 @@ var CheckoutOfferService = class {
   async getById(id) {
     const row = await this.repo.findById(id);
     if (!row) {
-      throw new import_common60.NotFoundException(`CheckoutOffer '${id}' nicht gefunden`);
+      throw new import_common60.NotFoundException({
+        code: import_types27.CONTRACT_ERROR_CODES.CHECKOUT_OFFER_NOT_FOUND,
+        message: `CheckoutOffer '${id}' not found`,
+        params: {
+          offerId: id
+        }
+      });
     }
     return row;
   }
@@ -12068,7 +12825,7 @@ var CheckoutOfferService = class {
   /** Customization in onboarding — only while the offer is `open`. */
   async update(id, data) {
     const existing = await this.getById(id);
-    this.assertOpen(existing, "\xE4ndern");
+    this.assertOpen(existing, "changed");
     const next = this.normalizeUpdateData(existing, data);
     await this.assertFeatureRequiresSatisfied({
       projectKey: existing.projectKey,
@@ -12086,7 +12843,7 @@ var CheckoutOfferService = class {
    */
   async consume(id) {
     const existing = await this.getById(id);
-    this.assertOpen(existing, "verbrauchen");
+    this.assertOpen(existing, "consumed");
     await this.assertBundleVersionsStillBookable(existing);
     return this.repo.consume(id);
   }
@@ -12104,19 +12861,19 @@ var CheckoutOfferService = class {
     const entries = await this.catalogEntries.listFeatures({
       projectKey: input.projectKey
     });
-    const requiresIndex = (0, import_types9.buildFeatureRequiresIndex)(entries);
+    const requiresIndex = (0, import_types27.buildFeatureRequiresIndex)(entries);
     if (requiresIndex.size === 0) return;
     const selected = /* @__PURE__ */ new Set([
       ...await this.resolvePlanFeatures(input),
       ...await this.resolveBundleFeatures(input)
     ]);
-    const missingRequires = (0, import_types9.collectUnsatisfiedRequires)([
+    const missingRequires = (0, import_types27.collectUnsatisfiedRequires)([
       ...selected
     ], requiresIndex);
     if (missingRequires.length > 0) {
       throw new import_common60.UnprocessableEntityException({
-        code: "CHECKOUT_OFFER_FEATURE_DEPENDENCY_UNSATISFIED",
-        message: `Die Paket-Auswahl deckt nicht alle Feature-Abh\xE4ngigkeiten: [${missingRequires.join(", ")}] fehlen in Plan + gew\xE4hlten Bundles.`,
+        code: import_types27.CONTRACT_ERROR_CODES.CHECKOUT_OFFER_FEATURE_DEPENDENCY_UNSATISFIED,
+        message: `The selected plan does not cover all feature dependencies: [${missingRequires.join(", ")}] are missing from the plan + selected bundles.`,
         missingRequires
       });
     }
@@ -12196,8 +12953,8 @@ var CheckoutOfferService = class {
     }
     if (violations.length > 0) {
       throw new import_common60.UnprocessableEntityException({
-        code: "CHECKOUT_OFFER_BUNDLE_VERSION_NOT_BOOKABLE",
-        message: "Mindestens eine BundleVersion aus dem CheckoutOffer ist nicht mehr buchbar.",
+        code: import_types27.CONTRACT_ERROR_CODES.CHECKOUT_OFFER_BUNDLE_VERSION_NOT_BOOKABLE,
+        message: "At least one bundle version from the checkout offer is no longer bookable.",
         violations
       });
     }
@@ -12251,15 +13008,15 @@ var CheckoutOfferService = class {
     const hasPlan = lineItems.some((item) => item.kind === "plan");
     if (!hasPlan) {
       throw new import_common60.UnprocessableEntityException({
-        code: "CHECKOUT_OFFER_PLAN_LINE_ITEM_REQUIRED",
-        message: "CheckoutOffer ben\xF6tigt eine eingefrorene Plan-LineItem."
+        code: import_types27.CONTRACT_ERROR_CODES.CHECKOUT_OFFER_PLAN_LINE_ITEM_REQUIRED,
+        message: "A checkout offer requires a frozen plan line item."
       });
     }
     const missingBundleVersionIds = input.bundleVersionIds.filter((versionId) => !lineItems.some((item) => item.kind === "bundle" && item.sourceVersionId === versionId));
     if (missingBundleVersionIds.length > 0) {
       throw new import_common60.UnprocessableEntityException({
-        code: "CHECKOUT_OFFER_BUNDLE_LINE_ITEMS_REQUIRED",
-        message: "Jede ausgew\xE4hlte BundleVersion ben\xF6tigt eine eingefrorene Bundle-LineItem.",
+        code: import_types27.CONTRACT_ERROR_CODES.CHECKOUT_OFFER_BUNDLE_LINE_ITEMS_REQUIRED,
+        message: "Every selected bundle version requires a frozen bundle line item.",
         bundleVersionIds: missingBundleVersionIds
       });
     }
@@ -12291,13 +13048,36 @@ var CheckoutOfferService = class {
   }
   assertOpen(existing, action) {
     if (existing.status === "consumed") {
-      throw new import_common60.ConflictException(`CheckoutOffer '${existing.id}' ist bereits verbraucht und kann nicht ${action} werden`);
+      throw new import_common60.ConflictException({
+        code: import_types27.CONTRACT_ERROR_CODES.CHECKOUT_OFFER_ALREADY_CONSUMED,
+        message: `Checkout offer '${existing.id}' has already been consumed and cannot be ${action}`,
+        params: {
+          offerId: existing.id,
+          action
+        }
+      });
     }
     if (existing.status === "expired") {
-      throw new import_common60.ConflictException(`CheckoutOffer '${existing.id}' ist abgelaufen und kann nicht ${action} werden`);
+      throw new import_common60.ConflictException({
+        code: import_types27.CONTRACT_ERROR_CODES.CHECKOUT_OFFER_EXPIRED,
+        message: `Checkout offer '${existing.id}' has expired and cannot be ${action}`,
+        params: {
+          offerId: existing.id,
+          action,
+          validUntil: existing.validUntil ?? null
+        }
+      });
     }
     if (this.isExpired(existing)) {
-      throw new import_common60.ConflictException(`CheckoutOffer '${existing.id}' ist abgelaufen und kann nicht ${action} werden`);
+      throw new import_common60.ConflictException({
+        code: import_types27.CONTRACT_ERROR_CODES.CHECKOUT_OFFER_EXPIRED,
+        message: `CheckoutOffer '${existing.id}' has expired and cannot be ${action}`,
+        params: {
+          offerId: existing.id,
+          action,
+          validUntil: existing.validUntil ?? null
+        }
+      });
     }
   }
   isExpired(row) {
@@ -12315,7 +13095,7 @@ var CheckoutOfferService = class {
     if (!value) return false;
     const validUntil = new Date(value).getTime();
     if (Number.isNaN(validUntil)) return true;
-    return validUntil < (0, import_types9.startOfUtcDay)(new Date(nowMs)).getTime();
+    return validUntil < (0, import_types27.startOfUtcDay)(new Date(nowMs)).getTime();
   }
 };
 CheckoutOfferService = _ts_decorate68([
@@ -12379,7 +13159,7 @@ var CreateCheckoutOfferDto = class {
 _ts_decorate69([
   (0, import_class_validator13.IsString)(),
   (0, import_class_validator13.Matches)(PROJECT_KEY_PATTERN7, {
-    message: "projectKey muss kebab-case sein"
+    message: "projectKey must be kebab-case"
   }),
   (0, import_class_validator13.MaxLength)(64),
   _ts_metadata55("design:type", String)
@@ -12867,7 +13647,7 @@ async function runHeadlessDiscoveryScan(appModule, options = {}) {
       await app.close();
     }
   } catch (err) {
-    console.error("[discovery-scan] FEHLER:", err instanceof Error ? err.message : err);
+    console.error("[discovery-scan] ERROR:", err instanceof Error ? err.message : err);
     return exit(4);
   }
 }
@@ -12946,7 +13726,7 @@ __export(platform_exports, {
 // src/platform/saas-platform.module.ts
 var import_common79 = require("@nestjs/common");
 var import_core9 = require("@nestjs/core");
-var import_types11 = require("@saasicat/types");
+var import_types31 = require("@saasicat/types");
 
 // src/promo/module.ts
 var import_common70 = require("@nestjs/common");
@@ -12987,7 +13767,7 @@ var PromoCodeExpirer = class _PromoCodeExpirer {
     const codes = await this.promoRepo.expireDueCodes(now);
     const redemptions = await this.redemptionRepo.expireDueRedemptions(now);
     if (codes > 0 || redemptions > 0) {
-      this.logger.log(`PromoCodeExpirer: ${codes} Codes, ${redemptions} Redemptions abgelaufen.`);
+      this.logger.log(`PromoCodeExpirer: ${codes} Codes, ${redemptions} redemptions expired.`);
     }
   }
 };
@@ -13016,6 +13796,7 @@ var import_common68 = require("@nestjs/common");
 
 // src/promo/rate-limit.guard.ts
 var import_common67 = require("@nestjs/common");
+var import_types28 = require("@saasicat/types");
 function _ts_decorate75(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -13027,6 +13808,18 @@ var IP_WINDOW_MS = 6e4;
 var IP_LIMIT = 20;
 var SESSION_WINDOW_MS = 60 * 6e4;
 var SESSION_LIMIT = 50;
+function rateLimited(windowMs) {
+  return new import_common67.HttpException({
+    ...codedError(import_types28.REGISTRATION_ERROR_CODES.RATE_LIMITED, {
+      retryAfterSeconds: Math.ceil(windowMs / 1e3)
+    }),
+    retryAfterSeconds: Math.ceil(windowMs / 1e3),
+    valid: false,
+    // Superseded by `code` — kept until all consumers read `code`.
+    reason: "RATE_LIMITED"
+  }, import_common67.HttpStatus.TOO_MANY_REQUESTS);
+}
+__name(rateLimited, "rateLimited");
 var PromoCodeRateLimitGuard = class {
   static {
     __name(this, "PromoCodeRateLimitGuard");
@@ -13038,16 +13831,10 @@ var PromoCodeRateLimitGuard = class {
     const ipKey = ipFingerprint(req);
     const sessionKey = req.user?.id ?? null;
     if (this.exceeded(this.ipBuckets, ipKey, IP_WINDOW_MS, IP_LIMIT)) {
-      throw new import_common67.HttpException({
-        valid: false,
-        reason: "RATE_LIMITED"
-      }, import_common67.HttpStatus.TOO_MANY_REQUESTS);
+      throw rateLimited(IP_WINDOW_MS);
     }
     if (sessionKey && this.exceeded(this.sessionBuckets, sessionKey, SESSION_WINDOW_MS, SESSION_LIMIT)) {
-      throw new import_common67.HttpException({
-        valid: false,
-        reason: "RATE_LIMITED"
-      }, import_common67.HttpStatus.TOO_MANY_REQUESTS);
+      throw rateLimited(SESSION_WINDOW_MS);
     }
     return true;
   }
@@ -13111,21 +13898,21 @@ var PreviewPromoCodeDto = class {
 _ts_decorate76([
   (0, import_class_validator14.IsString)(),
   (0, import_class_validator14.Matches)(CODE_PATTERN2, {
-    message: 'code muss aus A\u2013Z, 0\u20139, "-" und "_" bestehen (4\u201332 Zeichen)'
+    message: 'code must consist of A\u2013Z, 0\u20139, "-" and "_" (4\u201332 characters)'
   }),
   _ts_metadata59("design:type", String)
 ], PreviewPromoCodeDto.prototype, "code", void 0);
 _ts_decorate76([
   (0, import_class_validator14.IsString)(),
   (0, import_class_validator14.Matches)(PLAN_OR_CYCLE_PATTERN3, {
-    message: "plan muss SCREAMING_SNAKE_CASE sein"
+    message: "plan must be SCREAMING_SNAKE_CASE"
   }),
   _ts_metadata59("design:type", String)
 ], PreviewPromoCodeDto.prototype, "plan", void 0);
 _ts_decorate76([
   (0, import_class_validator14.IsString)(),
   (0, import_class_validator14.Matches)(PLAN_OR_CYCLE_PATTERN3, {
-    message: "billingCycle muss SCREAMING_SNAKE_CASE sein (z. B. MONTHLY, YEARLY)"
+    message: "billingCycle must be SCREAMING_SNAKE_CASE (e.g. MONTHLY, YEARLY)"
   }),
   _ts_metadata59("design:type", String)
 ], PreviewPromoCodeDto.prototype, "billingCycle", void 0);
@@ -13686,7 +14473,7 @@ var import_class_validator16 = require("class-validator");
 
 // src/setup/setup.service.ts
 var import_common71 = require("@nestjs/common");
-var import_types10 = require("@saasicat/types");
+var import_types29 = require("@saasicat/types");
 var import_node_crypto3 = require("crypto");
 var import_qrcode = __toESM(require("qrcode"), 1);
 
@@ -13742,9 +14529,7 @@ var SetupService = class {
     await this.assertNoSuperAdmin();
     const email = req.email.trim().toLowerCase();
     if (!email.includes("@")) {
-      throw new import_common71.BadRequestException({
-        code: import_types10.SETUP_ERROR_CODES.INVALID_EMAIL
-      });
+      throw new import_common71.BadRequestException(codedError(import_types29.SETUP_ERROR_CODES.INVALID_EMAIL));
     }
     const generated = !req.password;
     const password = req.password ?? (0, import_node_crypto3.randomBytes)(GENERATED_PASSWORD_BYTES).toString("base64url");
@@ -13755,9 +14540,9 @@ var SetupService = class {
         password
       });
     } catch (err) {
-      if ((0, import_types10.isPlatformUserExistsError)(err)) {
+      if ((0, import_types29.isPlatformUserExistsError)(err)) {
         throw new import_common71.ConflictException({
-          code: import_types10.SETUP_ERROR_CODES.EMAIL_EXISTS,
+          code: import_types29.SETUP_ERROR_CODES.EMAIL_EXISTS,
           message: err.message
         });
       }
@@ -13793,21 +14578,20 @@ var SetupService = class {
     const expected = process.env[this.config.setupTokenEnvVar]?.trim();
     if (!expected) {
       throw new import_common71.ForbiddenException({
-        code: import_types10.SETUP_ERROR_CODES.SETUP_DISABLED,
-        message: `${this.config.setupTokenEnvVar} ist nicht gesetzt \u2014 Setup ist deaktiviert.`
+        code: import_types29.SETUP_ERROR_CODES.SETUP_DISABLED,
+        message: `${this.config.setupTokenEnvVar} is not set \u2014 setup is disabled.`,
+        params: {
+          envVar: this.config.setupTokenEnvVar
+        }
       });
     }
     if (!token || !timingSafeEqualStr(token, expected)) {
-      throw new import_common71.UnauthorizedException({
-        code: import_types10.SETUP_ERROR_CODES.INVALID_SETUP_TOKEN
-      });
+      throw new import_common71.UnauthorizedException(codedError(import_types29.SETUP_ERROR_CODES.INVALID_SETUP_TOKEN));
     }
   }
   async assertNoSuperAdmin() {
     if (await this.users.countSuperAdmins() > 0) {
-      throw new import_common71.ConflictException({
-        code: import_types10.SETUP_ERROR_CODES.SETUP_ALREADY_DONE
-      });
+      throw new import_common71.ConflictException(codedError(import_types29.SETUP_ERROR_CODES.SETUP_ALREADY_DONE));
     }
   }
 };
@@ -14082,6 +14866,7 @@ StaticEntitlementService = _ts_decorate84([
 // src/platform/static-feature.guard.ts
 var import_common75 = require("@nestjs/common");
 var import_core7 = require("@nestjs/core");
+var import_types30 = require("@saasicat/types");
 function _ts_decorate85(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -14120,15 +14905,32 @@ var StaticFeatureGuard = class {
     if (!required || required.length === 0) return true;
     const request = context.switchToHttp().getRequest();
     const user = request.user;
-    if (!user) throw new import_common75.ForbiddenException("Nicht authentifiziert");
+    if (!user) {
+      throw new import_common75.ForbiddenException({
+        code: import_types30.AUTH_ERROR_CODES.NOT_AUTHENTICATED,
+        message: "Not authenticated"
+      });
+    }
     const role = this.config?.userRoleResolver ? this.config.userRoleResolver(user) : user.role ?? user.platformRole;
     if (role === "SUPER_ADMIN") return true;
     const tenantId = this.config?.tenantIdResolver ? this.config.tenantIdResolver(request) : request.tenantId ?? user.tenantId;
-    if (!tenantId) throw new import_common75.ForbiddenException("Kein Mandant zugeordnet");
+    if (!tenantId) {
+      throw new import_common75.ForbiddenException({
+        code: import_types30.AUTH_ERROR_CODES.NO_TENANT_ASSIGNED,
+        message: "No tenant assigned"
+      });
+    }
     const snap = await this.entitlements.snapshot(tenantId);
     const allowed = required.some((f) => snap.features.includes(f));
     if (!allowed) {
-      throw new import_common75.ForbiddenException(`Feature ${required.join(" / ")} nicht im aktuellen Plan enthalten.`);
+      const body = {
+        code: import_types30.FEATURE_NOT_LICENSED,
+        featureKey: required[0],
+        featureKeys: required,
+        offers: [],
+        message: `Feature ${required.join(" / ")} is not included in the current plan.`
+      };
+      throw new import_common75.ForbiddenException(body);
     }
     return true;
   }
@@ -14371,7 +15173,7 @@ function buildTenantManifestController(options) {
     async get(req) {
       const tenantId = req.user?.tenantId ?? req.tenantId;
       if (!tenantId) {
-        throw new Error("Kein Mandant im Request \u2014 TenantManifest braucht user.tenantId.");
+        throw new Error("No tenant on the request \u2014 TenantManifest requires user.tenantId.");
       }
       return this.svc.getManifest(tenantId);
     }
@@ -14608,7 +15410,7 @@ var SaasPlatformModule = class _SaasPlatformModule {
         throw new Error(`SaasPlatformModule.forRoot: entitlement active or required by the standard stack, but adapters are missing: ${missing.join(", ")}`);
       }
       if (persistence) {
-        (0, import_types11.assertPersistenceCapabilities)(persistence.capabilities, {
+        (0, import_types31.assertPersistenceCapabilities)(persistence.capabilities, {
           transactions: true,
           pessimisticLocking: true
         }, "SaasPlatformModule entitlement (transactional enforceLimit)");
@@ -15064,8 +15866,8 @@ var REGISTRATION_CONFIG_TOKEN = /* @__PURE__ */ Symbol.for("saas-platform/Regist
 
 // src/registration/pending-registration.service.ts
 var import_common80 = require("@nestjs/common");
-var import_types12 = require("@saasicat/types");
-var import_types13 = require("@saasicat/types");
+var import_types32 = require("@saasicat/types");
+var import_types33 = require("@saasicat/types");
 
 // src/registration/pricing.ts
 function round24(value) {
@@ -15183,7 +15985,7 @@ var PendingRegistrationService = class _PendingRegistrationService {
       });
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
-      this.logger.warn(`Audit-Log fehlgeschlagen (${eventType}): ${message}`);
+      this.logger.warn(`Audit log write failed (${eventType}): ${message}`);
     }
   }
   /** Public signup plan list for step 3 (frontend `usePublicPlans()`). */
@@ -15193,28 +15995,20 @@ var PendingRegistrationService = class _PendingRegistrationService {
   async selectPlan(input, context) {
     const pending = await this.repo.findById(input.pendingRegistrationId);
     if (!pending) {
-      throw new import_common80.NotFoundException({
-        code: "PENDING_REGISTRATION_NOT_FOUND"
-      });
+      throw new import_common80.NotFoundException(codedError(import_types32.REGISTRATION_ERROR_CODES.PENDING_REGISTRATION_NOT_FOUND));
     }
     if (pending.expiresAt.getTime() < Date.now()) {
-      throw new import_common80.BadRequestException({
-        code: "PENDING_REGISTRATION_EXPIRED"
-      });
+      throw new import_common80.BadRequestException(codedError(import_types32.REGISTRATION_ERROR_CODES.PENDING_REGISTRATION_EXPIRED));
     }
     if (pending.status !== "EMAIL_VERIFIED" && pending.status !== "PLAN_SELECTED" && pending.status !== "CHECKOUT_STARTED") {
-      throw new import_common80.BadRequestException({
-        code: "INVALID_REGISTRATION_STATE"
-      });
+      throw new import_common80.BadRequestException(codedError(import_types32.REGISTRATION_ERROR_CODES.INVALID_REGISTRATION_STATE));
     }
     const plan = await this.planCatalog.findPublicSignupPlan(input.planId);
     if (!plan) {
-      throw new import_common80.BadRequestException({
-        code: "PLAN_NOT_AVAILABLE"
-      });
+      throw new import_common80.BadRequestException(codedError(import_types32.REGISTRATION_ERROR_CODES.PLAN_NOT_AVAILABLE));
     }
     const now = /* @__PURE__ */ new Date();
-    const expiresAt = new Date(now.getTime() + import_types13.PENDING_ONBOARDING_TTL_DAYS * 24 * 60 * 60 * 1e3);
+    const expiresAt = new Date(now.getTime() + import_types33.PENDING_ONBOARDING_TTL_DAYS * 24 * 60 * 60 * 1e3);
     const updated = await this.repo.update(pending.id, {
       status: "PLAN_SELECTED",
       currentStep: 4,
@@ -15227,37 +16021,27 @@ var PendingRegistrationService = class _PendingRegistrationService {
     return {
       pendingRegistrationId: updated.id,
       status: updated.status,
-      nextStep: import_types13.REGISTRATION_STEP_BY_STATUS[updated.status],
+      nextStep: import_types33.REGISTRATION_STEP_BY_STATUS[updated.status],
       selectedPlanId: updated.selectedPlanId ?? plan.id
     };
   }
   async startCheckout(input, context) {
     const pending = await this.repo.findById(input.pendingRegistrationId);
     if (!pending) {
-      throw new import_common80.NotFoundException({
-        code: "PENDING_REGISTRATION_NOT_FOUND"
-      });
+      throw new import_common80.NotFoundException(codedError(import_types32.REGISTRATION_ERROR_CODES.PENDING_REGISTRATION_NOT_FOUND));
     }
     if (pending.expiresAt.getTime() < Date.now()) {
-      throw new import_common80.BadRequestException({
-        code: "PENDING_REGISTRATION_EXPIRED"
-      });
+      throw new import_common80.BadRequestException(codedError(import_types32.REGISTRATION_ERROR_CODES.PENDING_REGISTRATION_EXPIRED));
     }
     if (pending.status !== "PLAN_SELECTED" && pending.status !== "CHECKOUT_STARTED") {
-      throw new import_common80.BadRequestException({
-        code: "PLAN_NOT_SELECTED"
-      });
+      throw new import_common80.BadRequestException(codedError(import_types32.REGISTRATION_ERROR_CODES.PLAN_NOT_SELECTED));
     }
     if (!pending.selectedPlanId) {
-      throw new import_common80.BadRequestException({
-        code: "PLAN_NOT_SELECTED"
-      });
+      throw new import_common80.BadRequestException(codedError(import_types32.REGISTRATION_ERROR_CODES.PLAN_NOT_SELECTED));
     }
     const plan = await this.planCatalog.findPublicSignupPlan(pending.selectedPlanId);
     if (!plan) {
-      throw new import_common80.BadRequestException({
-        code: "PLAN_NOT_AVAILABLE"
-      });
+      throw new import_common80.BadRequestException(codedError(import_types32.REGISTRATION_ERROR_CODES.PLAN_NOT_AVAILABLE));
     }
     const session = await this.paymentProvider.createCheckoutSession({
       pendingRegistrationId: pending.id,
@@ -15267,7 +16051,7 @@ var PendingRegistrationService = class _PendingRegistrationService {
       cancelUrl: input.cancelUrl
     });
     const now = /* @__PURE__ */ new Date();
-    const expiresAt = new Date(now.getTime() + import_types13.PENDING_CHECKOUT_TTL_DAYS * 24 * 60 * 60 * 1e3);
+    const expiresAt = new Date(now.getTime() + import_types33.PENDING_CHECKOUT_TTL_DAYS * 24 * 60 * 60 * 1e3);
     const updated = await this.repo.update(pending.id, {
       status: "CHECKOUT_STARTED",
       currentStep: 4,
@@ -15282,7 +16066,7 @@ var PendingRegistrationService = class _PendingRegistrationService {
     return {
       pendingRegistrationId: updated.id,
       status: updated.status,
-      nextStep: import_types13.REGISTRATION_STEP_BY_STATUS[updated.status],
+      nextStep: import_types33.REGISTRATION_STEP_BY_STATUS[updated.status],
       checkoutSessionId: session.sessionId,
       checkoutUrl: session.checkoutUrl
     };
@@ -15308,7 +16092,7 @@ var PendingRegistrationService = class _PendingRegistrationService {
       rawPayload: input.rawPayload
     });
     if (!claimed) {
-      this.logger.warn(`Idempotenz: PaymentEvent ${input.eventId} bereits verarbeitet \u2014 Duplikat verworfen.`);
+      this.logger.warn(`Idempotency: payment event ${input.eventId} already processed \u2014 duplicate discarded.`);
       await this.record("PAYMENT_DUPLICATE_IGNORED", null, context, {
         eventId: input.eventId,
         sessionId: input.sessionId
@@ -15358,7 +16142,7 @@ var PendingRegistrationService = class _PendingRegistrationService {
       tenantId: result.tenantId,
       subscriptionId: result.subscriptionId
     });
-    this.logger.log(`Aktivierung erfolgreich: pending=${pending.id} \u2192 user=${result.userId} tenant=${result.tenantId} subscription=${result.subscriptionId}`);
+    this.logger.log(`Activation succeeded: pending=${pending.id} \u2192 user=${result.userId} tenant=${result.tenantId} subscription=${result.subscriptionId}`);
     return {
       activated: true,
       result
@@ -15386,11 +16170,11 @@ var PendingRegistrationService = class _PendingRegistrationService {
         await this.repo.delete(pending.id);
       } catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        this.logger.warn(`Cleanup: PendingRegistration ${pending.id} konnte nicht geloescht werden (${message}).`);
+        this.logger.warn(`Cleanup: pending registration ${pending.id} could not be deleted (${message}).`);
       }
     }
     if (expired.length > 0) {
-      this.logger.log(`Cleanup: ${expired.length} abgelaufene PendingRegistrations geloescht.`);
+      this.logger.log(`Cleanup: ${expired.length} expired PendingRegistrations deleted.`);
     }
     return {
       deleted: expired.length,
@@ -15400,7 +16184,7 @@ var PendingRegistrationService = class _PendingRegistrationService {
   async start(input, context) {
     const email = normalizeEmail(input.email);
     if (await this.userLookup.hasActiveUser(email)) {
-      this.logger.log(`register/start fuer aktiven Account ignoriert (${email}).`);
+      this.logger.log(`register/start ignored for an active account (${email}).`);
       await this.record("REGISTRATION_NEUTRAL_ACTIVE_USER", null, context);
       return {
         neutral: true
@@ -15438,8 +16222,8 @@ var PendingRegistrationService = class _PendingRegistrationService {
     const code = generateOtpCode();
     const otpHash = hashOtpCode(code);
     const now = /* @__PURE__ */ new Date();
-    const otpExpiresAt = new Date(now.getTime() + import_types13.OTP_TTL_MINUTES * 60 * 1e3);
-    const expiresAt = new Date(now.getTime() + import_types13.PENDING_EMAIL_TTL_HOURS * 60 * 60 * 1e3);
+    const otpExpiresAt = new Date(now.getTime() + import_types33.OTP_TTL_MINUTES * 60 * 1e3);
+    const expiresAt = new Date(now.getTime() + import_types33.PENDING_EMAIL_TTL_HOURS * 60 * 60 * 1e3);
     const pending = await this.repo.create({
       tenantName: input.tenantName.trim(),
       tenantSlug: slug,
@@ -15466,14 +16250,12 @@ var PendingRegistrationService = class _PendingRegistrationService {
       await this.record("OTP_VERIFY_FAILED", null, context, {
         reason: "unknown_email"
       });
-      throw new import_common80.BadRequestException({
-        code: "OTP_INVALID"
-      });
+      throw new import_common80.BadRequestException(codedError(import_types32.REGISTRATION_ERROR_CODES.OTP_INVALID));
     }
     if (pending.status !== "PENDING_EMAIL_VERIFICATION") {
       return {
         status: pending.status,
-        nextStep: import_types13.REGISTRATION_STEP_BY_STATUS[pending.status],
+        nextStep: import_types33.REGISTRATION_STEP_BY_STATUS[pending.status],
         pendingRegistrationId: pending.id
       };
     }
@@ -15481,43 +16263,33 @@ var PendingRegistrationService = class _PendingRegistrationService {
       await this.record("OTP_VERIFY_FAILED", pending.id, context, {
         reason: "no_otp_set"
       });
-      throw new import_common80.BadRequestException({
-        code: "OTP_INVALID"
-      });
+      throw new import_common80.BadRequestException(codedError(import_types32.REGISTRATION_ERROR_CODES.OTP_INVALID));
     }
     if (pending.otpExpiresAt.getTime() < Date.now()) {
       await this.record("OTP_VERIFY_FAILED", pending.id, context, {
         reason: "expired"
       });
-      throw new import_common80.BadRequestException({
-        code: "OTP_EXPIRED"
-      });
+      throw new import_common80.BadRequestException(codedError(import_types32.REGISTRATION_ERROR_CODES.OTP_EXPIRED));
     }
     const maxAttempts = resolveOtpVerifyMaxAttempts();
     if (pending.otpAttemptCount >= maxAttempts) {
       await this.record("OTP_VERIFY_FAILED", pending.id, context, {
         reason: "locked"
       });
-      throw new import_common80.BadRequestException({
-        code: "OTP_LOCKED"
-      });
+      throw new import_common80.BadRequestException(codedError(import_types32.REGISTRATION_ERROR_CODES.OTP_LOCKED));
     }
     const attemptCount = await this.repo.incrementOtpAttemptCount(pending.id);
     if (attemptCount > maxAttempts) {
       await this.record("OTP_VERIFY_FAILED", pending.id, context, {
         reason: "locked"
       });
-      throw new import_common80.BadRequestException({
-        code: "OTP_LOCKED"
-      });
+      throw new import_common80.BadRequestException(codedError(import_types32.REGISTRATION_ERROR_CODES.OTP_LOCKED));
     }
     if (!verifyOtpCode(pending.otpHash, code)) {
       await this.record("OTP_VERIFY_FAILED", pending.id, context, {
         reason: "wrong_code"
       });
-      throw new import_common80.BadRequestException({
-        code: "OTP_INVALID"
-      });
+      throw new import_common80.BadRequestException(codedError(import_types32.REGISTRATION_ERROR_CODES.OTP_INVALID));
     }
     const now = /* @__PURE__ */ new Date();
     const updated = await this.repo.update(pending.id, {
@@ -15526,12 +16298,12 @@ var PendingRegistrationService = class _PendingRegistrationService {
       emailVerifiedAt: now,
       otpHash: null,
       otpExpiresAt: null,
-      expiresAt: new Date(now.getTime() + import_types13.PENDING_ONBOARDING_TTL_DAYS * 24 * 60 * 60 * 1e3)
+      expiresAt: new Date(now.getTime() + import_types33.PENDING_ONBOARDING_TTL_DAYS * 24 * 60 * 60 * 1e3)
     });
     await this.record("OTP_VERIFIED", updated.id, context);
     return {
       status: updated.status,
-      nextStep: import_types13.REGISTRATION_STEP_BY_STATUS[updated.status],
+      nextStep: import_types33.REGISTRATION_STEP_BY_STATUS[updated.status],
       pendingRegistrationId: updated.id
     };
   }
@@ -15556,15 +16328,15 @@ var PendingRegistrationService = class _PendingRegistrationService {
   }
   async regenerateOtp(pending) {
     const now = /* @__PURE__ */ new Date();
-    const windowMs = import_types13.OTP_RATE_LIMIT_WINDOW_MINUTES * 60 * 1e3;
+    const windowMs = import_types33.OTP_RATE_LIMIT_WINDOW_MINUTES * 60 * 1e3;
     const withinWindow = pending.lastOtpSentAt !== null && now.getTime() - pending.lastOtpSentAt.getTime() < windowMs;
-    if (withinWindow && pending.otpSendCount >= import_types13.OTP_RATE_LIMIT_MAX_SENDS) {
-      this.logger.warn(`OTP-Rate-Limit erreicht fuer ${pending.email} \u2014 Send wird still verworfen.`);
+    if (withinWindow && pending.otpSendCount >= import_types33.OTP_RATE_LIMIT_MAX_SENDS) {
+      this.logger.warn(`OTP rate limit reached for ${pending.email} \u2014 send is being skipped.`);
       return;
     }
     const code = generateOtpCode();
     const otpHash = hashOtpCode(code);
-    const otpExpiresAt = new Date(now.getTime() + import_types13.OTP_TTL_MINUTES * 60 * 1e3);
+    const otpExpiresAt = new Date(now.getTime() + import_types33.OTP_TTL_MINUTES * 60 * 1e3);
     const otpSendCount = withinWindow ? pending.otpSendCount + 1 : 1;
     await this.repo.update(pending.id, {
       otpHash,
@@ -15587,7 +16359,7 @@ var PendingRegistrationService = class _PendingRegistrationService {
       });
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
-      this.logger.error(`OTP-Mail an ${pending.email} fehlgeschlagen: ${message}`);
+      this.logger.error(`OTP email to ${pending.email} failed: ${message}`);
     }
   }
   /**
@@ -15601,7 +16373,7 @@ var PendingRegistrationService = class _PendingRegistrationService {
     }
     const token = await this.resumeTokenSigner.sign({
       pendingRegistrationId: pending.id,
-      ttlMinutes: import_types12.REGISTRATION_RESUME_TTL_MINUTES
+      ttlMinutes: import_types32.REGISTRATION_RESUME_TTL_MINUTES
     });
     const base = (this.resumeBaseUrl ?? "http://localhost").replace(/\/+$/, "");
     const url = `${base}/login?resume=${encodeURIComponent(token)}`;
@@ -15614,7 +16386,7 @@ var PendingRegistrationService = class _PendingRegistrationService {
       });
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
-      this.logger.error(`Resume-Mail an ${pending.email} fehlgeschlagen: ${message}`);
+      this.logger.error(`Resume email to ${pending.email} failed: ${message}`);
     }
   }
   /**
@@ -15628,28 +16400,20 @@ var PendingRegistrationService = class _PendingRegistrationService {
    */
   async resumeWithToken(input, context) {
     if (!this.resumeTokenSigner) {
-      throw new import_common80.BadRequestException({
-        code: "RESUME_NOT_CONFIGURED"
-      });
+      throw new import_common80.BadRequestException(codedError(import_types32.REGISTRATION_ERROR_CODES.RESUME_NOT_CONFIGURED));
     }
     let decoded;
     try {
       decoded = await this.resumeTokenSigner.verify(input.token);
     } catch {
-      throw new import_common80.BadRequestException({
-        code: "RESUME_TOKEN_INVALID"
-      });
+      throw new import_common80.BadRequestException(codedError(import_types32.REGISTRATION_ERROR_CODES.RESUME_TOKEN_INVALID));
     }
     const pending = await this.repo.findById(decoded.pendingRegistrationId);
     if (!pending) {
-      throw new import_common80.BadRequestException({
-        code: "RESUME_TOKEN_INVALID"
-      });
+      throw new import_common80.BadRequestException(codedError(import_types32.REGISTRATION_ERROR_CODES.RESUME_TOKEN_INVALID));
     }
     if (pending.expiresAt.getTime() < Date.now()) {
-      throw new import_common80.BadRequestException({
-        code: "PENDING_REGISTRATION_EXPIRED"
-      });
+      throw new import_common80.BadRequestException(codedError(import_types32.REGISTRATION_ERROR_CODES.PENDING_REGISTRATION_EXPIRED));
     }
     await this.record("REGISTRATION_NEUTRAL_REPLAY", pending.id, context, {
       via: "resume_token",
@@ -15658,7 +16422,7 @@ var PendingRegistrationService = class _PendingRegistrationService {
     return {
       pendingRegistrationId: pending.id,
       status: pending.status,
-      nextStep: import_types13.REGISTRATION_STEP_BY_STATUS[pending.status],
+      nextStep: import_types33.REGISTRATION_STEP_BY_STATUS[pending.status],
       snapshot: toSnapshot2(pending)
     };
   }
@@ -15677,9 +16441,7 @@ var PendingRegistrationService = class _PendingRegistrationService {
   /** Returns the (app-specific) configurator catalog. */
   async getConfiguratorCatalog() {
     if (!this.configuratorLookup) {
-      throw new import_common80.BadRequestException({
-        code: "CONFIGURATOR_NOT_CONFIGURED"
-      });
+      throw new import_common80.BadRequestException(codedError(import_types32.REGISTRATION_ERROR_CODES.CONFIGURATOR_NOT_CONFIGURED));
     }
     return this.configuratorLookup.getCatalog();
   }
@@ -15696,32 +16458,22 @@ var PendingRegistrationService = class _PendingRegistrationService {
    */
   async saveConfiguration(input, context) {
     if (!this.configuratorLookup) {
-      throw new import_common80.BadRequestException({
-        code: "CONFIGURATOR_NOT_CONFIGURED"
-      });
+      throw new import_common80.BadRequestException(codedError(import_types32.REGISTRATION_ERROR_CODES.CONFIGURATOR_NOT_CONFIGURED));
     }
     const pending = await this.repo.findById(input.pendingRegistrationId);
     if (!pending) {
-      throw new import_common80.NotFoundException({
-        code: "PENDING_REGISTRATION_NOT_FOUND"
-      });
+      throw new import_common80.NotFoundException(codedError(import_types32.REGISTRATION_ERROR_CODES.PENDING_REGISTRATION_NOT_FOUND));
     }
     if (pending.expiresAt.getTime() < Date.now()) {
-      throw new import_common80.BadRequestException({
-        code: "PENDING_REGISTRATION_EXPIRED"
-      });
+      throw new import_common80.BadRequestException(codedError(import_types32.REGISTRATION_ERROR_CODES.PENDING_REGISTRATION_EXPIRED));
     }
     if (pending.status !== "EMAIL_VERIFIED" && pending.status !== "PLAN_SELECTED" && pending.status !== "CHECKOUT_STARTED") {
-      throw new import_common80.BadRequestException({
-        code: "INVALID_REGISTRATION_STATE"
-      });
+      throw new import_common80.BadRequestException(codedError(import_types32.REGISTRATION_ERROR_CODES.INVALID_REGISTRATION_STATE));
     }
     const catalog = await this.configuratorLookup.getCatalog();
     const model = catalog.models.find((m) => m.id === input.selection.modelId);
     if (!model) {
-      throw new import_common80.BadRequestException({
-        code: "MODEL_NOT_AVAILABLE"
-      });
+      throw new import_common80.BadRequestException(codedError(import_types32.REGISTRATION_ERROR_CODES.MODEL_NOT_AVAILABLE));
     }
     let promoEval;
     if (input.selection.appliedPromoCode && this.promoPreview) {
@@ -15753,7 +16505,7 @@ var PendingRegistrationService = class _PendingRegistrationService {
       };
     }
     const now = /* @__PURE__ */ new Date();
-    const expiresAt = new Date(now.getTime() + import_types13.PENDING_ONBOARDING_TTL_DAYS * 24 * 60 * 60 * 1e3);
+    const expiresAt = new Date(now.getTime() + import_types33.PENDING_ONBOARDING_TTL_DAYS * 24 * 60 * 60 * 1e3);
     const updated = await this.repo.update(pending.id, {
       status: "PLAN_SELECTED",
       currentStep: 4,
@@ -15772,7 +16524,7 @@ var PendingRegistrationService = class _PendingRegistrationService {
     return {
       pendingRegistrationId: updated.id,
       status: updated.status,
-      nextStep: import_types13.REGISTRATION_STEP_BY_STATUS[updated.status],
+      nextStep: import_types33.REGISTRATION_STEP_BY_STATUS[updated.status],
       selection: input.selection,
       breakdown
     };
@@ -15785,28 +16537,20 @@ var PendingRegistrationService = class _PendingRegistrationService {
    */
   async previewConfigPromo(pendingRegistrationId, code) {
     if (!this.configuratorLookup) {
-      throw new import_common80.BadRequestException({
-        code: "CONFIGURATOR_NOT_CONFIGURED"
-      });
+      throw new import_common80.BadRequestException(codedError(import_types32.REGISTRATION_ERROR_CODES.CONFIGURATOR_NOT_CONFIGURED));
     }
     const pending = await this.repo.findById(pendingRegistrationId);
     if (!pending) {
-      throw new import_common80.NotFoundException({
-        code: "PENDING_REGISTRATION_NOT_FOUND"
-      });
+      throw new import_common80.NotFoundException(codedError(import_types32.REGISTRATION_ERROR_CODES.PENDING_REGISTRATION_NOT_FOUND));
     }
     const config = pending.configJson;
     if (!config) {
-      throw new import_common80.BadRequestException({
-        code: "CONFIG_NOT_SAVED"
-      });
+      throw new import_common80.BadRequestException(codedError(import_types32.REGISTRATION_ERROR_CODES.CONFIG_NOT_SAVED));
     }
     const catalog = await this.configuratorLookup.getCatalog();
     const model = catalog.models.find((m) => m.id === config.modelId);
     if (!model) {
-      throw new import_common80.BadRequestException({
-        code: "MODEL_NOT_AVAILABLE"
-      });
+      throw new import_common80.BadRequestException(codedError(import_types32.REGISTRATION_ERROR_CODES.MODEL_NOT_AVAILABLE));
     }
     let promoEval;
     if (code && this.promoPreview) {
@@ -15864,7 +16608,7 @@ var PendingRegistrationService = class _PendingRegistrationService {
         return candidate;
       }
     }
-    throw new Error(`Konnte keinen freien Slug fuer "${tenantName}" finden.`);
+    throw new Error(`Could not find a free slug for "${tenantName}".`);
   }
 };
 PendingRegistrationService = _ts_decorate90([
@@ -15914,9 +16658,9 @@ function normalizeEmail(value) {
 __name(normalizeEmail, "normalizeEmail");
 function resolveOtpVerifyMaxAttempts() {
   const raw = process.env.SAAS_PLATFORM_OTP_VERIFY_MAX_ATTEMPTS;
-  if (!raw) return import_types13.OTP_VERIFY_MAX_ATTEMPTS;
+  if (!raw) return import_types33.OTP_VERIFY_MAX_ATTEMPTS;
   const parsed = Number.parseInt(raw, 10);
-  return Number.isInteger(parsed) && parsed > 0 ? parsed : import_types13.OTP_VERIFY_MAX_ATTEMPTS;
+  return Number.isInteger(parsed) && parsed > 0 ? parsed : import_types33.OTP_VERIFY_MAX_ATTEMPTS;
 }
 __name(resolveOtpVerifyMaxAttempts, "resolveOtpVerifyMaxAttempts");
 function toSnapshot2(pending) {
@@ -15989,7 +16733,7 @@ var RegistrationCleanupCron = class _RegistrationCleanupCron {
       }
     }
     if (totalDeleted > 0) {
-      this.logger.log(`PendingRegistration-Cleanup abgeschlossen: ${totalDeleted} geloescht in ${iterations} Batches.`);
+      this.logger.log(`Pending registration cleanup finished: ${totalDeleted} deleted in ${iterations} batches.`);
     }
   }
 };
@@ -16011,6 +16755,7 @@ RegistrationCleanupCron = _ts_decorate91([
 
 // src/registration/ip-rate-limit.guard.ts
 var import_common82 = require("@nestjs/common");
+var import_types34 = require("@saasicat/types");
 function _ts_decorate92(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -16039,9 +16784,14 @@ var BaseIpRateLimitGuard = class {
     const key = ipFingerprint2(req);
     if (this.exceeded(key)) {
       throw new import_common82.HttpException({
-        code: "RATE_LIMITED",
-        reason: this.options.name,
-        retryAfterSeconds: Math.ceil(this.options.windowMs / 1e3)
+        ...codedError(import_types34.REGISTRATION_ERROR_CODES.RATE_LIMITED, {
+          retryAfterSeconds: Math.ceil(this.options.windowMs / 1e3)
+        }),
+        retryAfterSeconds: Math.ceil(this.options.windowMs / 1e3),
+        // Superseded by `code`. Note this carries the limiter name,
+        // not the code — the two emitters of RATE_LIMITED disagree
+        // on what `reason` means, which is why it is going away.
+        reason: this.options.name
       }, import_common82.HttpStatus.TOO_MANY_REQUESTS);
     }
     return true;
@@ -16183,7 +16933,7 @@ _ts_decorate94([
   (0, import_class_validator17.IsOptional)(),
   (0, import_class_validator17.IsString)(),
   (0, import_class_validator17.Matches)(/^[a-z0-9-]+$/, {
-    message: "tenantSlug darf nur Kleinbuchstaben, Ziffern und Bindestriche enthalten."
+    message: "tenantSlug may only contain lower-case letters, digits and hyphens."
   }),
   (0, import_class_validator17.MaxLength)(60),
   _ts_metadata73("design:type", String)
@@ -16219,7 +16969,7 @@ _ts_decorate94([
 ], RegisterStartDto.prototype, "password", void 0);
 _ts_decorate94([
   (0, import_class_validator17.Equals)(true, {
-    message: "AGB, Datenschutzerklaerung und Auftragsverarbeitung muessen zugestimmt werden."
+    message: "The terms of service, privacy policy and data processing agreement must be accepted."
   }),
   _ts_metadata73("design:type", Boolean)
 ], RegisterStartDto.prototype, "termsAccepted", void 0);
@@ -16259,7 +17009,7 @@ _ts_decorate95([
 _ts_decorate95([
   (0, import_class_validator18.IsString)(),
   (0, import_class_validator18.Matches)(/^\d{6}$/, {
-    message: "OTP muss 6 Ziffern sein."
+    message: "The OTP must be 6 digits."
   }),
   _ts_metadata74("design:type", String)
 ], VerifyRegistrationOtpDto.prototype, "otp", void 0);
@@ -16790,9 +17540,10 @@ __export(src_exports, {
   buildPublicMarketingCatalogController: () => buildPublicMarketingCatalogController,
   buildReplacedByIndex: () => buildReplacedByIndex,
   buildTenantSubscriptionBundlesController: () => buildTenantSubscriptionBundlesController,
-  classifyBundleVersionDiff: () => import_types.classifyBundleVersionDiff,
-  classifyPlanDiff: () => import_types.classifyPlanDiff,
+  classifyBundleVersionDiff: () => import_types5.classifyBundleVersionDiff,
+  classifyPlanDiff: () => import_types5.classifyPlanDiff,
   clearPendingPlanVersionFields: () => clearPendingPlanVersionFields,
+  codedError: () => codedError,
   collectSubscriptionBundleFeatures: () => collectSubscriptionBundleFeatures,
   computeBreakdown: () => computeBreakdown,
   computeCarriedTrialEndsAt: () => computeCarriedTrialEndsAt,
@@ -16884,7 +17635,7 @@ __export(testing_exports, {
 });
 
 // src/testing/fake-repositories.ts
-var import_types14 = require("@saasicat/types");
+var import_types35 = require("@saasicat/types");
 var FakeSubscriptionRepository = class {
   static {
     __name(this, "FakeSubscriptionRepository");
@@ -16975,10 +17726,10 @@ var FakeSubscriptionBundleRepository = class {
   async cancel(subscriptionBundleId, data) {
     const existing = this.byId.get(subscriptionBundleId);
     if (!existing) {
-      throw new Error(`SubscriptionBundle '${subscriptionBundleId}' nicht gefunden`);
+      throw new Error(`SubscriptionBundle '${subscriptionBundleId}' not found`);
     }
     if (existing.canceledAt !== null) {
-      throw new Error(`SubscriptionBundle '${subscriptionBundleId}' ist bereits gek\xFCndigt`);
+      throw new Error(`SubscriptionBundle '${subscriptionBundleId}' is already cancelled`);
     }
     const updated = {
       ...existing,
@@ -16992,7 +17743,7 @@ var FakeSubscriptionBundleRepository = class {
   async reactivate(subscriptionBundleId) {
     const existing = this.byId.get(subscriptionBundleId);
     if (!existing) {
-      throw new Error(`SubscriptionBundle '${subscriptionBundleId}' nicht gefunden`);
+      throw new Error(`SubscriptionBundle '${subscriptionBundleId}' not found`);
     }
     const updated = {
       ...existing,
@@ -17102,7 +17853,7 @@ var FakeSubscriptionContractRepository = class {
   }
   async terminate(contractId, data) {
     const existing = this.byId.get(contractId);
-    if (!existing) throw new Error(`SubscriptionContract '${contractId}' nicht gefunden`);
+    if (!existing) throw new Error(`SubscriptionContract '${contractId}' not found`);
     const updated = {
       ...existing,
       status: data.status,
@@ -17262,7 +18013,7 @@ var FakeBundleRepository = class {
   }
   async update(bundleId, data) {
     const existing = this.bundles.get(bundleId);
-    if (!existing) throw new Error(`Bundle '${bundleId}' nicht gefunden`);
+    if (!existing) throw new Error(`Bundle '${bundleId}' not found`);
     const updated = {
       ...existing,
       label: data.label ?? existing.label,
@@ -17277,7 +18028,7 @@ var FakeBundleRepository = class {
   }
   async softDelete(bundleId) {
     const existing = this.bundles.get(bundleId);
-    if (!existing) throw new Error(`Bundle '${bundleId}' nicht gefunden`);
+    if (!existing) throw new Error(`Bundle '${bundleId}' not found`);
     this.bundles.set(bundleId, {
       ...existing,
       deletedAt: this.nowIso()
@@ -17309,7 +18060,7 @@ var FakeBundleRepository = class {
   async createDraft(data) {
     const draft = await this.findCurrentDraft(data.bundleId);
     if (draft) {
-      throw new Error(`Bundle '${data.bundleId}' hat bereits eine Draft-Version v${draft.version}`);
+      throw new Error(`Bundle '${data.bundleId}' already has a draft version v${draft.version}`);
     }
     const all = await this.listVersions(data.bundleId);
     const nextVersion = all.length === 0 ? 1 : Math.max(...all.map((v) => v.version)) + 1;
@@ -17345,7 +18096,7 @@ var FakeBundleRepository = class {
   }
   async updateDraft(versionId, data) {
     const existing = this.versions.get(versionId);
-    if (!existing) throw new Error(`BundleVersion '${versionId}' nicht gefunden`);
+    if (!existing) throw new Error(`BundleVersion '${versionId}' not found`);
     const updated = {
       ...existing,
       features: data.features ?? existing.features,
@@ -17367,15 +18118,15 @@ var FakeBundleRepository = class {
     const existing = this.versions.get(versionId);
     if (!existing) return;
     if (existing.publishedAt !== null) {
-      throw new Error(`BundleVersion '${versionId}' ist bereits published`);
+      throw new Error(`BundleVersion '${versionId}' is already published`);
     }
     this.versions.delete(versionId);
   }
   async publishDraft(versionId, publishMeta) {
     const draft = this.versions.get(versionId);
-    if (!draft) throw new Error(`BundleVersion '${versionId}' nicht gefunden`);
+    if (!draft) throw new Error(`BundleVersion '${versionId}' not found`);
     if (draft.publishedAt !== null) {
-      throw new Error(`BundleVersion '${versionId}' ist bereits published`);
+      throw new Error(`BundleVersion '${versionId}' is already published`);
     }
     const now = this.nowIso();
     const validFromIso = publishMeta.validFrom.toISOString();
@@ -17451,7 +18202,7 @@ var FakeMarketingProjectionRepository = class {
     const locale = data.locale ?? "de";
     const existing = await this.findByTarget(data.targetType, data.targetVersionId, locale);
     if (existing) {
-      throw new Error(`MarketingProjection f\xFCr ${data.targetType}/${data.targetVersionId}/${locale} existiert bereits`);
+      throw new Error(`Marketing projection for ${data.targetType}/${data.targetVersionId}/${locale} already exists`);
     }
     const now = this.nowIso();
     const row = {
@@ -17479,7 +18230,7 @@ var FakeMarketingProjectionRepository = class {
   }
   async update(id, data) {
     const existing = this.rows.get(id);
-    if (!existing) throw new Error(`MarketingProjection '${id}' nicht gefunden`);
+    if (!existing) throw new Error(`MarketingProjection '${id}' not found`);
     const updated = {
       ...existing,
       displayLabel: data.displayLabel ?? existing.displayLabel,
@@ -17499,7 +18250,7 @@ var FakeMarketingProjectionRepository = class {
     return updated;
   }
   async delete(id) {
-    if (!this.rows.has(id)) throw new Error(`MarketingProjection '${id}' nicht gefunden`);
+    if (!this.rows.has(id)) throw new Error(`MarketingProjection '${id}' not found`);
     this.rows.delete(id);
   }
 };
@@ -17573,7 +18324,7 @@ var FakePlanRepository = class {
   }
   async update(planId, data) {
     const existing = this.plans.get(planId);
-    if (!existing) throw new Error(`Plan '${planId}' nicht gefunden`);
+    if (!existing) throw new Error(`Plan '${planId}' not found`);
     const updated = {
       ...existing,
       label: data.label ?? existing.label,
@@ -17587,7 +18338,7 @@ var FakePlanRepository = class {
   }
   async softDelete(planId) {
     const existing = this.plans.get(planId);
-    if (!existing) throw new Error(`Plan '${planId}' nicht gefunden`);
+    if (!existing) throw new Error(`Plan '${planId}' not found`);
     const updated = {
       ...existing,
       deletedAt: this.nowIso(),
@@ -17640,7 +18391,7 @@ var FakePlanRepository = class {
   }
   async findActivePlanVersion(planKey, asOf = /* @__PURE__ */ new Date()) {
     const t = asOf.getTime();
-    const dayStart = (0, import_types14.startOfUtcDay)(asOf).getTime();
+    const dayStart = (0, import_types35.startOfUtcDay)(asOf).getTime();
     const matches = [
       ...this.versions.values()
     ].filter((v) => {
@@ -17704,7 +18455,7 @@ var FakePlanRepository = class {
   }
   async updatePlanVersionDraft(versionId, data) {
     const existing = this.versions.get(versionId);
-    if (!existing) throw new Error(`PlanVersion '${versionId}' nicht gefunden`);
+    if (!existing) throw new Error(`PlanVersion '${versionId}' not found`);
     const updated = {
       ...existing,
       features: data.features ?? existing.features,
@@ -17721,7 +18472,7 @@ var FakePlanRepository = class {
   }
   async publishPlanVersionDraft(versionId, publishMeta) {
     const draft = this.versions.get(versionId);
-    if (!draft) throw new Error(`PlanVersion '${versionId}' nicht gefunden`);
+    if (!draft) throw new Error(`PlanVersion '${versionId}' not found`);
     const planKey = draft.planId;
     const now = this.nowIso();
     const dayMs = 24 * 60 * 60 * 1e3;
@@ -17753,14 +18504,14 @@ var FakePlanRepository = class {
     const existing = this.versions.get(versionId);
     if (!existing) return;
     if (existing.publishedAt !== null) {
-      throw new Error(`FakePlanRepository: PlanVersion '${versionId}' ist bereits published \u2014 Discard nicht erlaubt`);
+      throw new Error(`FakePlanRepository: plan version '${versionId}' is already published \u2014 discard is not allowed`);
     }
     this.versions.delete(versionId);
   }
   async terminate(versionId, endsAt) {
     const existing = this.versions.get(versionId);
     if (!existing) {
-      throw new Error(`FakePlanRepository: PlanVersion '${versionId}' nicht gefunden`);
+      throw new Error(`FakePlanRepository: PlanVersion '${versionId}' not found`);
     }
     const updated = {
       ...existing,