@catladder/cli 0.0.0-next-cb2cfd57 → 0.0.0-next-c392e917

package/dist/bundles/catenv/index.js

@@ -9632,9 +9632,14 @@ exports.GCLOUD_RUN_DEPLOY_TYPE = {
         // generation time. For review envs the service name part still
         // contains a runtime expression (the review slug), so the host stays
         // a bash expression there; the suffix is always a literal.
+        //
+        // The service name has to come from getRawServiceNameForEnvContext,
+        // not from fullName: it is shortened when the label would otherwise
+        // exceed what cloud run serves deterministically, and the url must
+        // name the service that is actually deployed.
         const HOSTNAME_INTERNAL = deployConfigRaw && envType !== "local"
             ? (0, bash_1.joinBashExpressions)([
-                fullName,
+                (0, getServiceName_1.getRawServiceNameForEnvContext)(ctx),
                 `${(0, store_1.getGcloudProjectNumber)(fullConfig, deployConfigRaw.projectId)}.${deployConfigRaw.region}.run.app`,
             ], "-").toLowerCase()
             : undefined;
@@ -9896,16 +9901,197 @@ exports.getCloudRunServiceOrJobArgsArg = getCloudRunServiceOrJobArgsArg;
 /***/ }),
 
 /***/ 33102:
-/***/ ((__unused_webpack_module, exports) => {
+/***/ ((__unused_webpack_module, exports, __nccwpck_require__) => {
 
 "use strict";
 
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.getServiceNameForEnvContext = exports.getServiceName = void 0;
-const getServiceName = (context) => context.environment.fullName.toLowerCase();
+exports.getRawServiceNameForEnvContext = exports.getServiceNameForEnvContext = exports.getServiceName = exports.resolveCloudRunComponentPart = exports.REVIEW_SLUG_LENGTH_BUDGET = exports.CLOUD_RUN_DNS_SEGMENT_LIMIT = void 0;
+const bash_1 = __nccwpck_require__(94143);
+const store_1 = __nccwpck_require__(2789);
+/**
+ * cloud run only serves its deterministic url
+ * `https://<service>-<projectNumber>.<region>.run.app` while that first dns
+ * label stays within the 63 characters a dns label allows — the label holds
+ * the service name, the project number and any traffic tag together.
+ *
+ * Beyond it cloud run silently switches to a legacy url built from a random
+ * identifier that nothing can recompute. The url catladder generates would
+ * then be a hostname that can never resolve, and everything consuming
+ * ROOT_URL/ROOT_URL_INTERNAL (cloud tasks targets, service-to-service
+ * calls) fails with a dns error instead of a helpful one — which is why the
+ * component part is shortened to stay under the limit rather than left to
+ * overflow.
+ *
+ * https://cloud.google.com/run/docs/triggering/https-request
+ */
+exports.CLOUD_RUN_DNS_SEGMENT_LIMIT = 63;
+/**
+ * review environments resolve their slug at runtime (`mr<iid>` on gitlab,
+ * `pr<number>` on github), so its exact length is unknown while generating.
+ * Budget for a six digit number so that service names — and with them the
+ * urls of already deployed services — do not start changing years later
+ * just because a project's merge request numbers grew a digit.
+ */
+exports.REVIEW_SLUG_LENGTH_BUDGET = "mr123456".length;
+/**
+ * a service name shortened past this point is no longer recognizable. When
+ * even this does not fit, the fixed parts (customer name, app name, env,
+ * project number) are what needs to shrink — only the user can do that.
+ */
+const MIN_COMPONENT_PART_LENGTH = 6;
+const quote = (name) => `"${name}"`;
+/**
+ * a trailing dash would end up in the hostname as `...-foo-.run.app`
+ */
+const shortenTo = (name, maxLength) => name.slice(0, maxLength).replace(/-+$/, "");
+/**
+ * the component-name part of a cloud run service name, shortened just
+ * enough to keep the deterministic url resolvable.
+ *
+ * Only the component part is shortened: the env and review slug parts have
+ * to stay intact (they are what makes the name unique per environment), the
+ * project number is fixed, and customerName/appName are shared by every
+ * service of the project.
+ */
+const resolveCloudRunComponentPart = ({ customerName, appName, env, isReviewEnv, componentName, projectNumber, otherComponentNames, }) => {
+    const fixedParts = [
+        customerName,
+        appName,
+        env,
+        ...(isReviewEnv ? ["_".repeat(exports.REVIEW_SLUG_LENGTH_BUDGET)] : []),
+        projectNumber,
+    ];
+    // + 1 for the dash that joins the component part to the rest
+    const fixedLength = fixedParts.join("-").length + 1;
+    const available = exports.CLOUD_RUN_DNS_SEGMENT_LIMIT - fixedLength;
+    if (componentName.length <= available) {
+        return {
+            value: componentName,
+            dropped: 0,
+            dnsSegmentLength: fixedLength + componentName.length,
+        };
+    }
+    if (available < MIN_COMPONENT_PART_LENGTH) {
+        throw new Error(`Cannot build a resolvable cloud run url for component ${quote(componentName)} in env ${quote(env)}.\n` +
+            `Everything but the component name already takes ${fixedLength} of the ${exports.CLOUD_RUN_DNS_SEGMENT_LIMIT} characters ` +
+            `a dns label allows (${fixedParts.join("-")}-<component>), leaving only ${available} for the component name.\n` +
+            `Shorten appName (${quote(appName)}) or customerName (${quote(customerName)}) by at least ` +
+            `${MIN_COMPONENT_PART_LENGTH - available} character(s).` +
+            (isReviewEnv
+                ? `\nReview environments also carry a runtime slug, for which ${exports.REVIEW_SLUG_LENGTH_BUDGET} characters are reserved.`
+                : ""));
+    }
+    const value = shortenTo(componentName, available);
+    const colliding = otherComponentNames.filter((other) => shortenTo(other, available) === value);
+    if (colliding.length > 0) {
+        throw new Error(`Cloud run service names collide in env ${quote(env)}: ${quote(componentName)} and ` +
+            `${colliding.map(quote).join(", ")} all shorten to ${quote(value)}, so they would deploy over each other.\n` +
+            `The deterministic cloud run url allows ${exports.CLOUD_RUN_DNS_SEGMENT_LIMIT} characters, which leaves ${available} ` +
+            `for the component name here — rename the components so their first ${available} characters differ.`);
+    }
+    return {
+        value,
+        dropped: componentName.length - value.length,
+        dnsSegmentLength: fixedLength + value.length,
+    };
+};
+exports.resolveCloudRunComponentPart = resolveCloudRunComponentPart;
+/**
+ * one note per shortened service name instead of one per generated job:
+ * service names are resolved again for every job that references them
+ */
+const reportedTruncations = new Set();
+const reportTruncation = (env, componentName, { value, dnsSegmentLength }) => {
+    const key = `${env}/${componentName}`;
+    if (reportedTruncations.has(key)) {
+        return;
+    }
+    reportedTruncations.add(key);
+    console.warn(`ℹ️ component "${componentName}" deploys to cloud run as "...-${value}" in env "${env}": ` +
+        `the full name would push the url past the ${exports.CLOUD_RUN_DNS_SEGMENT_LIMIT} characters cloud run ` +
+        `serves deterministically, so the component part is shortened ` +
+        `(${dnsSegmentLength} of ${exports.CLOUD_RUN_DNS_SEGMENT_LIMIT} characters used).`);
+};
+/**
+ * the cloud run service name before lowercasing, so that callers keep
+ * lowercasing the whole expression exactly like they did before.
+ *
+ * Returns `fullName` unchanged unless the component part had to be
+ * shortened — every project whose url already fits generates byte-identical
+ * output.
+ *
+ * Note that the composition below has to match the one `fullName` is built
+ * from in getEnvironmentContext; the tests pin that they agree.
+ */
+const getRawServiceName = ({ fullName, environmentSlugPrefix, componentName, env, isReviewEnv, deployConfig, config, }) => {
+    const projectNumber = deployConfig
+        ? (0, store_1.readGcloudProjectNumber)(config, deployConfig.projectId)
+        : null;
+    if (!projectNumber) {
+        // without the project number there is no deterministic url to keep
+        // resolvable — generating the url itself fails with a store error that
+        // says how to fix it, so don't second-guess the name here
+        return fullName;
+    }
+    const componentPart = (0, exports.resolveCloudRunComponentPart)({
+        customerName: config.customerName,
+        appName: config.appName,
+        env,
+        isReviewEnv,
+        componentName,
+        projectNumber,
+        otherComponentNames: Object.keys(config.components).filter((name) => name !== componentName),
+    });
+    if (componentPart.dropped === 0) {
+        return fullName;
+    }
+    reportTruncation(env, componentName, componentPart);
+    return (0, bash_1.joinBashExpressions)([
+        config.customerName,
+        config.appName,
+        environmentSlugPrefix,
+        componentPart.value,
+    ], "-");
+};
+const fromComponentContext = (context) => {
+    var _a;
+    const deployConfig = (_a = context.deploy) === null || _a === void 0 ? void 0 : _a.config;
+    return {
+        fullName: context.environment.fullName,
+        environmentSlugPrefix: context.environment.slugPrefix,
+        componentName: context.name,
+        env: context.env,
+        isReviewEnv: context.environment.envType === "review",
+        deployConfig: deployConfig && deployConfig.type === "google-cloudrun"
+            ? deployConfig
+            : null,
+        config: context.fullConfig,
+    };
+};
+const fromEnvironmentContext = (context) => ({
+    fullName: context.fullName,
+    environmentSlugPrefix: context.environmentSlugPrefix,
+    componentName: context.componentName,
+    env: context.env,
+    isReviewEnv: context.envType === "review",
+    deployConfig: context.deployConfigRaw || null,
+    config: context.fullConfig,
+});
+/**
+ * the cloud run service name as it is passed to `gcloud run` — lowercased,
+ * and shortened when the deterministic url would otherwise not fit.
+ */
+const getServiceName = (context) => getRawServiceName(fromComponentContext(context)).toLowerCase();
 exports.getServiceName = getServiceName;
-const getServiceNameForEnvContext = (context) => context.fullName.toLowerCase();
+const getServiceNameForEnvContext = (context) => getRawServiceName(fromEnvironmentContext(context)).toLowerCase();
 exports.getServiceNameForEnvContext = getServiceNameForEnvContext;
+/**
+ * the service name part of the deterministic url, still to be lowercased
+ * together with the rest of the hostname by the caller.
+ */
+const getRawServiceNameForEnvContext = (context) => getRawServiceName(fromEnvironmentContext(context));
+exports.getRawServiceNameForEnvContext = getRawServiceNameForEnvContext;
 //# sourceMappingURL=getServiceName.js.map
 
 /***/ }),
@@ -12322,7 +12508,7 @@ exports.getRunnerImage = getRunnerImage;
 "use strict";
 
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.getGcloudProjectNumber = exports.readCatladderStore = exports.getCatladderStorePath = exports.catladderStoreSchema = exports.CATLADDER_STORE_FILE = exports.CATLADDER_STORE_FILE_NAME = exports.CATLADDER_STORE_DIR = void 0;
+exports.getGcloudProjectNumber = exports.readGcloudProjectNumber = exports.readCatladderStore = exports.getCatladderStorePath = exports.catladderStoreSchema = exports.CATLADDER_STORE_FILE = exports.CATLADDER_STORE_FILE_NAME = exports.CATLADDER_STORE_DIR = void 0;
 const fs_1 = __nccwpck_require__(79896);
 const path_1 = __nccwpck_require__(16928);
 const yaml_1 = __nccwpck_require__(99292);
@@ -12374,6 +12560,13 @@ const readCatladderStore = (directory = process.cwd()) => {
     }
 };
 exports.readCatladderStore = readCatladderStore;
+/**
+ * gcloud project number from the store, or null when it has not been
+ * fetched yet. Use this where a missing number is not itself the problem —
+ * `getGcloudProjectNumber` is the one that reports it.
+ */
+const readGcloudProjectNumber = (config, projectId) => { var _a, _b, _c, _d; return (_d = (_c = (_b = (_a = config.store) === null || _a === void 0 ? void 0 : _a.gcloudProjects) === null || _b === void 0 ? void 0 : _b[projectId]) === null || _c === void 0 ? void 0 : _c.projectNumber) !== null && _d !== void 0 ? _d : null; };
+exports.readGcloudProjectNumber = readGcloudProjectNumber;
 /**
  * gcloud project number from the store — needed to compute deterministic
  * cloud run urls (`<service>-<projectNumber>.<region>.run.app`) at
@@ -12383,8 +12576,7 @@ exports.readCatladderStore = readCatladderStore;
  * catenv fail until `catladder project setup` has stored it.
  */
 const getGcloudProjectNumber = (config, projectId) => {
-    var _a, _b, _c;
-    const projectNumber = (_c = (_b = (_a = config.store) === null || _a === void 0 ? void 0 : _a.gcloudProjects) === null || _b === void 0 ? void 0 : _b[projectId]) === null || _c === void 0 ? void 0 : _c.projectNumber;
+    const projectNumber = (0, exports.readGcloudProjectNumber)(config, projectId);
     if (!projectNumber) {
         throw new Error(`Missing gcloud project number for project "${projectId}" in ${exports.CATLADDER_STORE_FILE}.\n` +
             `Run "catladder project setup" to fetch and store it.`);

package/dist/bundles/cli/index.js

@@ -15564,9 +15564,14 @@ exports.GCLOUD_RUN_DEPLOY_TYPE = {
         // generation time. For review envs the service name part still
         // contains a runtime expression (the review slug), so the host stays
         // a bash expression there; the suffix is always a literal.
+        //
+        // The service name has to come from getRawServiceNameForEnvContext,
+        // not from fullName: it is shortened when the label would otherwise
+        // exceed what cloud run serves deterministically, and the url must
+        // name the service that is actually deployed.
         const HOSTNAME_INTERNAL = deployConfigRaw && envType !== "local"
             ? (0, bash_1.joinBashExpressions)([
-                fullName,
+                (0, getServiceName_1.getRawServiceNameForEnvContext)(ctx),
                 `${(0, store_1.getGcloudProjectNumber)(fullConfig, deployConfigRaw.projectId)}.${deployConfigRaw.region}.run.app`,
             ], "-").toLowerCase()
             : undefined;
@@ -15828,16 +15833,197 @@ exports.getCloudRunServiceOrJobArgsArg = getCloudRunServiceOrJobArgsArg;
 /***/ }),
 
 /***/ 33102:
-/***/ ((__unused_webpack_module, exports) => {
+/***/ ((__unused_webpack_module, exports, __nccwpck_require__) => {
 
 "use strict";
 
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.getServiceNameForEnvContext = exports.getServiceName = void 0;
-const getServiceName = (context) => context.environment.fullName.toLowerCase();
+exports.getRawServiceNameForEnvContext = exports.getServiceNameForEnvContext = exports.getServiceName = exports.resolveCloudRunComponentPart = exports.REVIEW_SLUG_LENGTH_BUDGET = exports.CLOUD_RUN_DNS_SEGMENT_LIMIT = void 0;
+const bash_1 = __nccwpck_require__(94143);
+const store_1 = __nccwpck_require__(2789);
+/**
+ * cloud run only serves its deterministic url
+ * `https://<service>-<projectNumber>.<region>.run.app` while that first dns
+ * label stays within the 63 characters a dns label allows — the label holds
+ * the service name, the project number and any traffic tag together.
+ *
+ * Beyond it cloud run silently switches to a legacy url built from a random
+ * identifier that nothing can recompute. The url catladder generates would
+ * then be a hostname that can never resolve, and everything consuming
+ * ROOT_URL/ROOT_URL_INTERNAL (cloud tasks targets, service-to-service
+ * calls) fails with a dns error instead of a helpful one — which is why the
+ * component part is shortened to stay under the limit rather than left to
+ * overflow.
+ *
+ * https://cloud.google.com/run/docs/triggering/https-request
+ */
+exports.CLOUD_RUN_DNS_SEGMENT_LIMIT = 63;
+/**
+ * review environments resolve their slug at runtime (`mr<iid>` on gitlab,
+ * `pr<number>` on github), so its exact length is unknown while generating.
+ * Budget for a six digit number so that service names — and with them the
+ * urls of already deployed services — do not start changing years later
+ * just because a project's merge request numbers grew a digit.
+ */
+exports.REVIEW_SLUG_LENGTH_BUDGET = "mr123456".length;
+/**
+ * a service name shortened past this point is no longer recognizable. When
+ * even this does not fit, the fixed parts (customer name, app name, env,
+ * project number) are what needs to shrink — only the user can do that.
+ */
+const MIN_COMPONENT_PART_LENGTH = 6;
+const quote = (name) => `"${name}"`;
+/**
+ * a trailing dash would end up in the hostname as `...-foo-.run.app`
+ */
+const shortenTo = (name, maxLength) => name.slice(0, maxLength).replace(/-+$/, "");
+/**
+ * the component-name part of a cloud run service name, shortened just
+ * enough to keep the deterministic url resolvable.
+ *
+ * Only the component part is shortened: the env and review slug parts have
+ * to stay intact (they are what makes the name unique per environment), the
+ * project number is fixed, and customerName/appName are shared by every
+ * service of the project.
+ */
+const resolveCloudRunComponentPart = ({ customerName, appName, env, isReviewEnv, componentName, projectNumber, otherComponentNames, }) => {
+    const fixedParts = [
+        customerName,
+        appName,
+        env,
+        ...(isReviewEnv ? ["_".repeat(exports.REVIEW_SLUG_LENGTH_BUDGET)] : []),
+        projectNumber,
+    ];
+    // + 1 for the dash that joins the component part to the rest
+    const fixedLength = fixedParts.join("-").length + 1;
+    const available = exports.CLOUD_RUN_DNS_SEGMENT_LIMIT - fixedLength;
+    if (componentName.length <= available) {
+        return {
+            value: componentName,
+            dropped: 0,
+            dnsSegmentLength: fixedLength + componentName.length,
+        };
+    }
+    if (available < MIN_COMPONENT_PART_LENGTH) {
+        throw new Error(`Cannot build a resolvable cloud run url for component ${quote(componentName)} in env ${quote(env)}.\n` +
+            `Everything but the component name already takes ${fixedLength} of the ${exports.CLOUD_RUN_DNS_SEGMENT_LIMIT} characters ` +
+            `a dns label allows (${fixedParts.join("-")}-<component>), leaving only ${available} for the component name.\n` +
+            `Shorten appName (${quote(appName)}) or customerName (${quote(customerName)}) by at least ` +
+            `${MIN_COMPONENT_PART_LENGTH - available} character(s).` +
+            (isReviewEnv
+                ? `\nReview environments also carry a runtime slug, for which ${exports.REVIEW_SLUG_LENGTH_BUDGET} characters are reserved.`
+                : ""));
+    }
+    const value = shortenTo(componentName, available);
+    const colliding = otherComponentNames.filter((other) => shortenTo(other, available) === value);
+    if (colliding.length > 0) {
+        throw new Error(`Cloud run service names collide in env ${quote(env)}: ${quote(componentName)} and ` +
+            `${colliding.map(quote).join(", ")} all shorten to ${quote(value)}, so they would deploy over each other.\n` +
+            `The deterministic cloud run url allows ${exports.CLOUD_RUN_DNS_SEGMENT_LIMIT} characters, which leaves ${available} ` +
+            `for the component name here — rename the components so their first ${available} characters differ.`);
+    }
+    return {
+        value,
+        dropped: componentName.length - value.length,
+        dnsSegmentLength: fixedLength + value.length,
+    };
+};
+exports.resolveCloudRunComponentPart = resolveCloudRunComponentPart;
+/**
+ * one note per shortened service name instead of one per generated job:
+ * service names are resolved again for every job that references them
+ */
+const reportedTruncations = new Set();
+const reportTruncation = (env, componentName, { value, dnsSegmentLength }) => {
+    const key = `${env}/${componentName}`;
+    if (reportedTruncations.has(key)) {
+        return;
+    }
+    reportedTruncations.add(key);
+    console.warn(`ℹ️ component "${componentName}" deploys to cloud run as "...-${value}" in env "${env}": ` +
+        `the full name would push the url past the ${exports.CLOUD_RUN_DNS_SEGMENT_LIMIT} characters cloud run ` +
+        `serves deterministically, so the component part is shortened ` +
+        `(${dnsSegmentLength} of ${exports.CLOUD_RUN_DNS_SEGMENT_LIMIT} characters used).`);
+};
+/**
+ * the cloud run service name before lowercasing, so that callers keep
+ * lowercasing the whole expression exactly like they did before.
+ *
+ * Returns `fullName` unchanged unless the component part had to be
+ * shortened — every project whose url already fits generates byte-identical
+ * output.
+ *
+ * Note that the composition below has to match the one `fullName` is built
+ * from in getEnvironmentContext; the tests pin that they agree.
+ */
+const getRawServiceName = ({ fullName, environmentSlugPrefix, componentName, env, isReviewEnv, deployConfig, config, }) => {
+    const projectNumber = deployConfig
+        ? (0, store_1.readGcloudProjectNumber)(config, deployConfig.projectId)
+        : null;
+    if (!projectNumber) {
+        // without the project number there is no deterministic url to keep
+        // resolvable — generating the url itself fails with a store error that
+        // says how to fix it, so don't second-guess the name here
+        return fullName;
+    }
+    const componentPart = (0, exports.resolveCloudRunComponentPart)({
+        customerName: config.customerName,
+        appName: config.appName,
+        env,
+        isReviewEnv,
+        componentName,
+        projectNumber,
+        otherComponentNames: Object.keys(config.components).filter((name) => name !== componentName),
+    });
+    if (componentPart.dropped === 0) {
+        return fullName;
+    }
+    reportTruncation(env, componentName, componentPart);
+    return (0, bash_1.joinBashExpressions)([
+        config.customerName,
+        config.appName,
+        environmentSlugPrefix,
+        componentPart.value,
+    ], "-");
+};
+const fromComponentContext = (context) => {
+    var _a;
+    const deployConfig = (_a = context.deploy) === null || _a === void 0 ? void 0 : _a.config;
+    return {
+        fullName: context.environment.fullName,
+        environmentSlugPrefix: context.environment.slugPrefix,
+        componentName: context.name,
+        env: context.env,
+        isReviewEnv: context.environment.envType === "review",
+        deployConfig: deployConfig && deployConfig.type === "google-cloudrun"
+            ? deployConfig
+            : null,
+        config: context.fullConfig,
+    };
+};
+const fromEnvironmentContext = (context) => ({
+    fullName: context.fullName,
+    environmentSlugPrefix: context.environmentSlugPrefix,
+    componentName: context.componentName,
+    env: context.env,
+    isReviewEnv: context.envType === "review",
+    deployConfig: context.deployConfigRaw || null,
+    config: context.fullConfig,
+});
+/**
+ * the cloud run service name as it is passed to `gcloud run` — lowercased,
+ * and shortened when the deterministic url would otherwise not fit.
+ */
+const getServiceName = (context) => getRawServiceName(fromComponentContext(context)).toLowerCase();
 exports.getServiceName = getServiceName;
-const getServiceNameForEnvContext = (context) => context.fullName.toLowerCase();
+const getServiceNameForEnvContext = (context) => getRawServiceName(fromEnvironmentContext(context)).toLowerCase();
 exports.getServiceNameForEnvContext = getServiceNameForEnvContext;
+/**
+ * the service name part of the deterministic url, still to be lowercased
+ * together with the rest of the hostname by the caller.
+ */
+const getRawServiceNameForEnvContext = (context) => getRawServiceName(fromEnvironmentContext(context));
+exports.getRawServiceNameForEnvContext = getRawServiceNameForEnvContext;
 //# sourceMappingURL=getServiceName.js.map
 
 /***/ }),
@@ -18254,7 +18440,7 @@ exports.getRunnerImage = getRunnerImage;
 "use strict";
 
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.getGcloudProjectNumber = exports.readCatladderStore = exports.getCatladderStorePath = exports.catladderStoreSchema = exports.CATLADDER_STORE_FILE = exports.CATLADDER_STORE_FILE_NAME = exports.CATLADDER_STORE_DIR = void 0;
+exports.getGcloudProjectNumber = exports.readGcloudProjectNumber = exports.readCatladderStore = exports.getCatladderStorePath = exports.catladderStoreSchema = exports.CATLADDER_STORE_FILE = exports.CATLADDER_STORE_FILE_NAME = exports.CATLADDER_STORE_DIR = void 0;
 const fs_1 = __nccwpck_require__(79896);
 const path_1 = __nccwpck_require__(16928);
 const yaml_1 = __nccwpck_require__(99292);
@@ -18306,6 +18492,13 @@ const readCatladderStore = (directory = process.cwd()) => {
     }
 };
 exports.readCatladderStore = readCatladderStore;
+/**
+ * gcloud project number from the store, or null when it has not been
+ * fetched yet. Use this where a missing number is not itself the problem —
+ * `getGcloudProjectNumber` is the one that reports it.
+ */
+const readGcloudProjectNumber = (config, projectId) => { var _a, _b, _c, _d; return (_d = (_c = (_b = (_a = config.store) === null || _a === void 0 ? void 0 : _a.gcloudProjects) === null || _b === void 0 ? void 0 : _b[projectId]) === null || _c === void 0 ? void 0 : _c.projectNumber) !== null && _d !== void 0 ? _d : null; };
+exports.readGcloudProjectNumber = readGcloudProjectNumber;
 /**
  * gcloud project number from the store — needed to compute deterministic
  * cloud run urls (`<service>-<projectNumber>.<region>.run.app`) at
@@ -18315,8 +18508,7 @@ exports.readCatladderStore = readCatladderStore;
  * catenv fail until `catladder project setup` has stored it.
  */
 const getGcloudProjectNumber = (config, projectId) => {
-    var _a, _b, _c;
-    const projectNumber = (_c = (_b = (_a = config.store) === null || _a === void 0 ? void 0 : _a.gcloudProjects) === null || _b === void 0 ? void 0 : _b[projectId]) === null || _c === void 0 ? void 0 : _c.projectNumber;
+    const projectNumber = (0, exports.readGcloudProjectNumber)(config, projectId);
     if (!projectNumber) {
         throw new Error(`Missing gcloud project number for project "${projectId}" in ${exports.CATLADDER_STORE_FILE}.\n` +
             `Run "catladder project setup" to fetch and store it.`);

package/dist/bundles/skills/catladder-deploys/references/deploy-types.md

@@ -46,6 +46,7 @@ resources with `yarn catladder project setup`; detect drift with
 - `cloudSql?: DeployConfigCloudRunCloudSql | false` — `{ type: "unmanaged", instanceConnectionName, dbUser?, dbNamePrefix?, dbBaseName?, deleteDatabaseOnStop?, dbConnectionStringFormat? ("prisma" default | "rails" | "jdbc"), dbConnectionStringVariablesMode? ("embedded" default | "legacy"), dbAdditionalQueryParams? }`. Injects `DB_*` vars plus `DATABASE_URL`/`DATABASE_JDBC_URL`; in the default `"embedded"` mode the connection strings contain the component's final values (referenceable from other components, `vars.public` overrides of `DB_*` flow in). To share another component's database: `dbBaseName: "<owner>"` + `DB_PASSWORD: "${<owner>:DB_PASSWORD}"` in `vars.public`.
 - `execute?: Record<string, DeployConfigCloudRunExecute | null>` — run a script / job / HTTP call at a lifecycle point (`when`: `preDeploy` | `postDeploy` | `preStop` | `postStop`) or on a `schedule`.
 - `debug?: boolean`.
+- Service name and url: the service deploys as `<customerName>-<appName>-<env>[-<reviewSlug>]-<componentName>`, and `ROOT_URL`/`ROOT_URL_INTERNAL` are cloud run's deterministic url `https://<service>-<projectNumber>.<region>.run.app`. That url only exists while its first dns label stays within 63 characters, so catladder **shortens the component part** of the service name when it would not fit — otherwise cloud run would serve a legacy url with a random identifier and the generated hostname would never resolve. Review environments carry a runtime slug on top, for which 8 characters are reserved, so a name can fit `dev`/`prod` and still be shortened for `review`. Generation fails instead of shortening when two components would end up with the same name, or when customerName/appName/env/project number already leave no room.
 
 ## `npmPackage`
 

package/dist/packages/pipeline/src/deploy/cloudRun/index.js

@@ -65,9 +65,14 @@ exports.GCLOUD_RUN_DEPLOY_TYPE = {
         // generation time. For review envs the service name part still
         // contains a runtime expression (the review slug), so the host stays
         // a bash expression there; the suffix is always a literal.
+        //
+        // The service name has to come from getRawServiceNameForEnvContext,
+        // not from fullName: it is shortened when the label would otherwise
+        // exceed what cloud run serves deterministically, and the url must
+        // name the service that is actually deployed.
         const HOSTNAME_INTERNAL = deployConfigRaw && envType !== "local"
             ? (0, bash_1.joinBashExpressions)([
-                fullName,
+                (0, getServiceName_1.getRawServiceNameForEnvContext)(ctx),
                 `${(0, store_1.getGcloudProjectNumber)(fullConfig, deployConfigRaw.projectId)}.${deployConfigRaw.region}.run.app`,
             ], "-").toLowerCase()
             : undefined;

package/dist/packages/pipeline/src/deploy/cloudRun/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../packages/pipeline/src/deploy/cloudRun/index.ts"],"names":[],"mappings":";;;AACA,0CAAsD;AAEtD,2CAAiD;AACjD,uCAAqD;AAErD,+CAG4B;AAC5B,6CAAkD;AAClD,6CAA8D;AAC9D,uEAAwE;AACxE,+CAI0B;AAC1B,2DAAqE;AAExD,QAAA,6BAA6B,GAAG,8BAA8B,CAAC;AAE5E,MAAM,oBAAoB,GAAG,CAAC,EAC5B,eAAe,EACf,qBAAqB,EACrB,GAAG,EACH,aAAa,EACb,UAAU,GAC4C,EAAE,EAAE;;IAC1D,IAAI,eAAe,IAAI,eAAe,CAAC,QAAQ,EAAE,CAAC;QAChD,MAAM,OAAO,GAAG,IAAA,qBAAa,EAC3B,eAAe,CAAC,QAAQ,EACxB,UAAU,EACV,qBAAqB,EACrB,aAAa,CACd,CAAC;QAEF,MAAM,2BAA2B,GAAG,MAAM,CAAC,OAAO,CAChD,MAAA,eAAe,CAAC,QAAQ,CAAC,uBAAuB,mCAAI,EAAE,CACvD;aACE,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC;aACzC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEZ,MAAM,MAAM,GAAG;YACb,kCAAkC,EAChC,eAAe,CAAC,QAAQ,CAAC,sBAAsB;YACjD,OAAO,EAAE,OAAO;YAChB,OAAO,EAAE,MAAA,eAAe,CAAC,QAAQ,CAAC,MAAM,mCAAI,UAAU;YACtD,WAAW,EAAE,GAAG,GAAG,IAAA,0BAAgB,EAAC,GAAG,EAAE,aAAa,EAAE,aAAa,CAAC;SACvE,CAAC;QACF,OAAO;YACL,GAAG,MAAM;YACT,YAAY,EAAE,IAAA,sCAA2B,EACvC,eAAe,CAAC,QAAQ,EACxB,MAAM,EACN,aAAa,CACd,CAAC,MAAM,CAAC,2BAA2B,CAAC;YACrC,iBAAiB,EAAE,IAAA,6BAAkB,EACnC,MAAM,EACN,MAAA,eAAe,CAAC,QAAQ,CAAC,+BAA+B,mCACtD,oCAAyB,EAC3B,aAAa,CACd;SACF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC;AACW,QAAA,sBAAsB,GACjC;IACE,IAAI,EAAE,2CAA8B;IACpC,QAAQ,EAAE,CAAC,EAAE,eAAe,EAAE,OAAO,EAAE,EAAE,EAAE;QACzC,IAAI,eAAe,IAAI,eAAe,CAAC,QAAQ,EAAE,CAAC;YAChD,OAAO;gBACL,QAAQ,EAAE;oBACR,oBAAoB,EAAE,OAAO,KAAK,QAAQ;iBAC3C;aACF,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,oBAAoB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC;QAC7B,wDAAwD;QACxD,GAAG,CAAC,GAAG,CAAC,OAAO,KAAK,OAAO;YACzB,CAAC,CAAC;gBACE;oBACE,GAAG,EAAE,qCAA6B;oBAClC,MAAM,EAAE,IAAI;iBACb;aACF;YACH,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,GAAG,CAAC,eAAe,IAAI,GAAG,CAAC,eAAe,CAAC,QAAQ;YACrD,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC;YAC1B,CAAC,CAAC,EAAE,CAAC;KACR;IACD,oBAAoB,EAAE,CAAC,GAAG,EAAE,EAAE;QAC5B,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC;QAE/D,sCAAsC;QACtC,+DAA+D;QAC/D,+DAA+D;QAC/D,qEAAqE;QACrE,2DAA2D;QAC3D,MAAM,iBAAiB,GACrB,eAAe,IAAI,OAAO,KAAK,OAAO;YACpC,CAAC,CAAC,IAAA,0BAAmB,EACjB;gBACE,QAAQ;gBACR,GAAG,IAAA,8BAAsB,EACvB,UAAU,EACV,eAAe,CAAC,SAAS,CAC1B,IAAI,eAAe,CAAC,MAAM,UAAU;aACtC,EACD,GAAG,CACJ,CAAC,WAAW,EAAE;YACjB,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,WAAW,GACf,eAAe,IAAI,eAAe,CAAC,IAAI;YACrC,CAAC,CAAC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC;iBACjC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;iBACrC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;gBACpB,4BAA4B,GAAG,IAAA,gCAAuB,EAAC,IAAI,CAAC;gBAC5D,IAAA,+CAAwB,EAAC,IAAI,EAAE;oBAC7B,WAAW,EAAE,QAAQ;oBACrB,SAAS,EAAE,eAAe,CAAC,SAAS;oBACpC,MAAM,EAAE,eAAe,CAAC,MAAM;iBAC/B,CAAC;aACH,CAAC,CACL;YACH,CAAC,CAAC,EAAE,CAAC;QAET,OAAO;YACL,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,GAAG,oBAAoB,CAAC,GAAG,CAAC;YAC5B,GAAG,WAAW;YACd,6BAA6B,EAAE,IAAA,4CAA2B,EAAC,GAAG,CAAC;YAC/D,2BAA2B,EAAE,eAAe;gBAC1C,CAAC,CAAC,eAAe,CAAC,SAAS;gBAC3B,CAAC,CAAC,SAAS;YACb,uBAAuB,EAAE,eAAe;gBACtC,CAAC,CAAC,eAAe,CAAC,MAAM;gBACxB,CAAC,CAAC,SAAS;SACd,CAAC;IACJ,CAAC;IACD,oBAAoB,EAAE,CAAC,OAAO,EAAE,EAAE;;QAChC,MAAM,YAAY,GAAG,MAAA,OAAO,CAAC,MAAM,0CAAE,MAExB,CAAC;QACd,MAAM,OAAO,GAAG,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,OAAO,CAAC;QACtC,MAAM,aAAa,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QACxE,IAAI,CAAA,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAE,oBAAoB,MAAK,KAAK,EAAE,CAAC;YAClD,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,yEAAyE;QACzE,2EAA2E;QAC3E,OAAO,IAAA,4BAAmB,EACxB,kBAAkB,EAClB,sCAAsC,CACvC,CAAC;YACA,UAAU,qCAA6B,uCAAuC;YAC9E,yEAAyE;SAC1E,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../packages/pipeline/src/deploy/cloudRun/index.ts"],"names":[],"mappings":"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"}

package/dist/packages/pipeline/src/deploy/cloudRun/utils/getServiceName.d.ts

@@ -1,6 +1,74 @@
+import type { StringOrBashExpression } from "../../../../../bash/src/index.js";
 import type { DeployConfigCloudRun } from "../..";
 import type { BuildConfig } from "../../../build/types";
 import type { ComponentContext } from "../../../types/context";
 import type { EnvironmentContext } from "../../../types/environmentContext";
+/**
+ * cloud run only serves its deterministic url
+ * `https://<service>-<projectNumber>.<region>.run.app` while that first dns
+ * label stays within the 63 characters a dns label allows — the label holds
+ * the service name, the project number and any traffic tag together.
+ *
+ * Beyond it cloud run silently switches to a legacy url built from a random
+ * identifier that nothing can recompute. The url catladder generates would
+ * then be a hostname that can never resolve, and everything consuming
+ * ROOT_URL/ROOT_URL_INTERNAL (cloud tasks targets, service-to-service
+ * calls) fails with a dns error instead of a helpful one — which is why the
+ * component part is shortened to stay under the limit rather than left to
+ * overflow.
+ *
+ * https://cloud.google.com/run/docs/triggering/https-request
+ */
+export declare const CLOUD_RUN_DNS_SEGMENT_LIMIT = 63;
+/**
+ * review environments resolve their slug at runtime (`mr<iid>` on gitlab,
+ * `pr<number>` on github), so its exact length is unknown while generating.
+ * Budget for a six digit number so that service names — and with them the
+ * urls of already deployed services — do not start changing years later
+ * just because a project's merge request numbers grew a digit.
+ */
+export declare const REVIEW_SLUG_LENGTH_BUDGET: number;
+export type CloudRunComponentPartInput = {
+    customerName: string;
+    appName: string;
+    env: string;
+    /** whether the env resolves a review slug at runtime */
+    isReviewEnv: boolean;
+    componentName: string;
+    projectNumber: string;
+    /**
+     * the config's other component names, so that a shortened name colliding
+     * with a sibling's is caught while generating instead of at deploy time,
+     * where two components would fight over one cloud run service
+     */
+    otherComponentNames: string[];
+};
+export type CloudRunComponentPart = {
+    /** the component part of the service name, shortened if it had to be */
+    value: string;
+    /** characters dropped from the component name — 0 when it already fit */
+    dropped: number;
+    /** dns label length of the resulting url, review slug budget included */
+    dnsSegmentLength: number;
+};
+/**
+ * the component-name part of a cloud run service name, shortened just
+ * enough to keep the deterministic url resolvable.
+ *
+ * Only the component part is shortened: the env and review slug parts have
+ * to stay intact (they are what makes the name unique per environment), the
+ * project number is fixed, and customerName/appName are shared by every
+ * service of the project.
+ */
+export declare const resolveCloudRunComponentPart: ({ customerName, appName, env, isReviewEnv, componentName, projectNumber, otherComponentNames, }: CloudRunComponentPartInput) => CloudRunComponentPart;
+/**
+ * the cloud run service name as it is passed to `gcloud run` — lowercased,
+ * and shortened when the deterministic url would otherwise not fit.
+ */
 export declare const getServiceName: (context: ComponentContext) => string | import("../../../../../bash/src/index.js").BashExpression;
 export declare const getServiceNameForEnvContext: (context: EnvironmentContext<BuildConfig, DeployConfigCloudRun>) => string | import("../../../../../bash/src/index.js").BashExpression;
+/**
+ * the service name part of the deterministic url, still to be lowercased
+ * together with the rest of the hostname by the caller.
+ */
+export declare const getRawServiceNameForEnvContext: (context: EnvironmentContext<BuildConfig, DeployConfigCloudRun>) => StringOrBashExpression;