@naturalcycles/backend-lib 9.78.0 → 9.80.0

package/src/server/compressionMiddleware.ts

@@ -31,6 +31,19 @@ export interface CompressionOptions {
    */
   threshold?: number | string
 
+  /**
+   * Bodies sent in one `res.end(chunk)` call (which is what `res.json` and `res.send` do) up to this
+   * size are compressed synchronously on the event loop, instead of through a zlib stream.
+   * For typical JSON responses the per-response stream setup and threadpool round-trip cost more
+   * than the compression itself, and the sync path also keeps an exact `Content-Length`
+   * (streamed responses are chunked).
+   * Bodies above this size, and bodies written in several `res.write` calls, are streamed.
+   * Set to `0` to always stream.
+   *
+   * @default 128kb
+   */
+  syncMaxBytes?: number | string
+
   /**
    * Encoding to use when Accept-Encoding header is not present.
    * @default 'identity'
@@ -71,7 +84,8 @@ const cacheControlNoTransformRegExp = /(?:^|,)\s*?no-transform\s*?(?:,|$)/i
 /**
  * Compression middleware with support for gzip, deflate, brotli, and zstd.
  *
- * This is a fork of the `compression` npm package with added zstd support.
+ * This is a fork of the `compression` npm package with added zstd support,
+ * and a synchronous fast path for single-chunk bodies (see `syncMaxBytes`).
  *
  * Encoding preference order: zstd > br > gzip > deflate
  */
@@ -88,10 +102,14 @@ export function compressionMiddleware(options?: CompressionOptions): BackendRequ
   }
 
   // Zstd options
+  // Level 1 instead of zstd's own default of 3: for typical JSON responses the CPU cost and
+  // compression ratio are the same (measured 2026-10 on 22 KB and 115 KB payloads), but a level 3
+  // stream holds ~850 KB of native memory per in-flight response vs ~150 KB at level 1.
+  // That per-response allocation churn is what MALLOC_ARENA_MAX=2 works around on Cloud Run.
   const optsZstd: zlib.ZstdOptions = {
     ...opts.zstd,
     params: {
-      [zlib.constants.ZSTD_c_compressionLevel]: 3,
+      [zlib.constants.ZSTD_c_compressionLevel]: 1,
       ...opts.zstd?.params,
     },
   }
@@ -104,12 +122,19 @@ export function compressionMiddleware(options?: CompressionOptions): BackendRequ
   if (opts.windowBits !== undefined) zlibOpts.windowBits = opts.windowBits
   if (opts.chunkSize !== undefined) zlibOpts.chunkSize = opts.chunkSize
 
+  const codecOpts: CodecOptions = { zstd: optsZstd, brotli: optsBrotli, zlib: zlibOpts }
+
   const filter = opts.filter || shouldCompress
   const threshold = parseBytes(opts.threshold) ?? 1024
+  const syncMaxBytes = parseBytes(opts.syncMaxBytes) ?? 128 * 1024
   const enforceEncoding = opts.enforceEncoding || 'identity'
 
   return function compression(req, res, next) {
     let ended = false
+    // Set by the first `res.write`: the body comes in several chunks, so only the stream path applies
+    let wrote = false
+    // Set once the compress-or-not decision has been made for this response (by either path)
+    let decided = false
     let length: number | undefined
     let listeners: [string, (...args: any[]) => void][] | null = []
     let stream: zlib.Gzip | zlib.Deflate | zlib.BrotliCompress | zlib.ZstdCompress | undefined
@@ -136,6 +161,8 @@ export function compressionMiddleware(options?: CompressionOptions): BackendRequ
         return false
       }
 
+      wrote = true
+
       if (!headersSent(res)) {
         res.writeHead(res.statusCode)
       }
@@ -161,6 +188,30 @@ export function compressionMiddleware(options?: CompressionOptions): BackendRequ
         if (!res.getHeader('Content-Length')) {
           length = chunkLength(chunk, encodingOrCallback as BufferEncoding)
         }
+
+        // Single-chunk body (no prior `res.write`): the whole body is right here, so compress it
+        // synchronously instead of setting up a zlib stream for one chunk.
+        if (chunk && !wrote && !decided) {
+          const encoding = typeof encodingOrCallback === 'function' ? undefined : encodingOrCallback
+          const body = toBuffer(chunk, encoding)
+
+          if (body.length <= syncMaxBytes) {
+            const method = decide(body.length)
+
+            if (method) {
+              const compressed = compressSync(method, body, codecOpts)
+              res.setHeader('Content-Encoding', method)
+              res.setHeader('Content-Length', compressed.length)
+              ended = true
+              const cb = typeof encodingOrCallback === 'function' ? encodingOrCallback : callback
+              // encoding is irrelevant for a Buffer chunk; it is passed to satisfy the `end` overload
+              return _end.call(res, compressed, 'utf8', cb)
+            }
+            // Not compressing: falls through to the plain `end`.
+            // The `onHeaders` listener below sees `decided` and does nothing.
+          }
+        }
+
         res.writeHead(res.statusCode)
       }
 
@@ -195,34 +246,27 @@ export function compressionMiddleware(options?: CompressionOptions): BackendRequ
       return res
     }
 
-    function nocompress(_msg: string): void {
+    function nocompress(_msg: string): undefined {
       addListeners(res, _on, listeners!)
       listeners = null
     }
 
-    // Release the compression stream when the response closes, freeing native
-    // zlib memory even if the client disconnected before the response finished.
-    // Registered before onHeaders so a close that happens before the stream
-    // exists is not missed (the `closed` flag below handles a stream created
-    // afterwards). Fixes CVE-2026-87776 / GHSA-vc2v-76pw-4v95.
-    // We use `stream.destroy()` (not the `destroy` npm package upstream added)
-    // because our Node target frees the zlib handle on destroy().
-    _on.call(res, 'close', function onResponseClose() {
-      closed = true
-      stream?.destroy()
-    })
+    /**
+     * The compress-or-not decision, shared by the sync path (`res.end` holding the whole body)
+     * and the stream path (`onHeaders`).
+     * Returns the encoding to use, or undefined when the response is to be sent as-is.
+     */
+    function decide(bodyLength: number | undefined): string | undefined {
+      decided = true
 
-    onHeaders(res, function onResponseHeaders() {
       // determine if request is filtered
       if (!filter(req, res)) {
-        nocompress('filtered')
-        return
+        return nocompress('filtered')
       }
 
       // determine if the entity should be transformed
       if (!shouldTransform(req, res)) {
-        nocompress('no transform')
-        return
+        return nocompress('no transform')
       }
 
       // vary
@@ -231,24 +275,21 @@ export function compressionMiddleware(options?: CompressionOptions): BackendRequ
       // content-length below threshold
       if (
         Number(res.getHeader('Content-Length')) < threshold ||
-        (length !== undefined && length < threshold)
+        (bodyLength !== undefined && bodyLength < threshold)
       ) {
-        nocompress('size below threshold')
-        return
+        return nocompress('size below threshold')
       }
 
       const encoding = (res.getHeader('Content-Encoding') as string) || 'identity'
 
       // already encoded
       if (encoding !== 'identity') {
-        nocompress('already encoded')
-        return
+        return nocompress('already encoded')
       }
 
       // head
       if (req.method === 'HEAD') {
-        nocompress('HEAD request')
-        return
+        return nocompress('HEAD request')
       }
 
       // compression method
@@ -266,10 +307,31 @@ export function compressionMiddleware(options?: CompressionOptions): BackendRequ
 
       // negotiation failed
       if (!method || method === 'identity') {
-        nocompress('not acceptable')
-        return
+        return nocompress('not acceptable')
       }
 
+      return method
+    }
+
+    // Release the compression stream when the response closes, freeing native
+    // zlib memory even if the client disconnected before the response finished.
+    // Registered before onHeaders so a close that happens before the stream
+    // exists is not missed (the `closed` flag below handles a stream created
+    // afterwards). Fixes CVE-2026-87776 / GHSA-vc2v-76pw-4v95.
+    // We use `stream.destroy()` (not the `destroy` npm package upstream added)
+    // because our Node target frees the zlib handle on destroy().
+    _on.call(res, 'close', function onResponseClose() {
+      closed = true
+      stream?.destroy()
+    })
+
+    onHeaders(res, function onResponseHeaders() {
+      // The sync path has already handled this response (compressed it, or declined to)
+      if (decided) return
+
+      const method = decide(length)
+      if (!method) return
+
       // compression stream
       if (method === 'zstd') {
         stream = zlib.createZstdCompress(optsZstd)
@@ -331,6 +393,23 @@ export function shouldCompress(_req: any, res: any): boolean {
   return true
 }
 
+interface CodecOptions {
+  zstd: zlib.ZstdOptions
+  brotli: zlib.BrotliOptions
+  zlib: zlib.ZlibOptions
+}
+
+/**
+ * Compresses a whole body in one call, on the event loop.
+ * Same codec options as the streams, so the output is identical to the streamed one.
+ */
+function compressSync(method: string, body: Buffer, opts: CodecOptions): Buffer {
+  if (method === 'zstd') return zlib.zstdCompressSync(body, opts.zstd)
+  if (method === 'br') return zlib.brotliCompressSync(body, opts.brotli)
+  if (method === 'gzip') return zlib.gzipSync(body, opts.zlib)
+  return zlib.deflateSync(body, opts.zlib)
+}
+
 function addListeners(
   stream: any,
   on: (type: string, listener: (...args: any[]) => void) => void,

package/src/server/serverStatusMiddleware.ts

@@ -2,15 +2,11 @@ import os from 'node:os'
 import { localTime } from '@naturalcycles/js-lib/datetime/localTime.js'
 import { _filterNullishValues } from '@naturalcycles/js-lib/object/object.util.js'
 import { memoryUsageFull, processSharedUtil } from '@naturalcycles/nodejs-lib'
-import { getDeployInfo } from '../deploy/deployInfo.util.js'
 import type { BackendRequestHandler } from './server.model.js'
 
 const { versions, arch, platform } = process
 const availableParallelismAtStart = os.availableParallelism()
 const {
-  GAE_APPLICATION,
-  GAE_SERVICE,
-  GAE_VERSION,
   GOOGLE_CLOUD_PROJECT,
   K_SERVICE,
   K_REVISION,
@@ -23,33 +19,21 @@ const {
   BUILD_VERSION,
 } = process.env
 
-export function serverStatusMiddleware(projectDir?: string, extra?: any): BackendRequestHandler {
+export function serverStatusMiddleware(extra?: any): BackendRequestHandler {
   return async (_req, res) => {
-    res.json(getServerStatusData(projectDir, extra))
+    res.json(getServerStatusData(extra))
   }
 }
 
-export function getServerStatusData(
-  projectDir: string = process.cwd(),
-  extra?: any,
-): Record<string, any> {
-  let deployBuildTime = DEPLOY_BUILD_TIME
-  if (!deployBuildTime) {
-    const { ts } = getDeployInfo(projectDir)
-    deployBuildTime = localTime(ts).toPretty()
-  }
-
+export function getServerStatusData(extra?: any): Record<string, any> {
   const availableParallelism = os.availableParallelism()
 
   return _filterNullishValues({
     nodeProcessStarted: getStartedStr(),
-    deployBuildTime,
+    DEPLOY_BUILD_TIME,
     BUILD_VERSION,
     APP_ENV,
     GOOGLE_CLOUD_PROJECT,
-    GAE_APPLICATION,
-    GAE_SERVICE,
-    GAE_VERSION,
     K_SERVICE,
     K_REVISION,
     processInfo: {

package/src/util.ts

@@ -1,8 +1,4 @@
-const { GAE_INSTANCE, K_SERVICE } = process.env
-
-export function isGAE(): boolean {
-  return !!GAE_INSTANCE
-}
+const { K_SERVICE } = process.env
 
 export function isCloudRun(): boolean {
   return !!K_SERVICE

package/bin/deploy-gae.js

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-import '../dist/bin/deploy-gae.js'

package/bin/deploy-prepare.js

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-import '../dist/bin/deploy-prepare.js'

package/bin/undeploy-gae.js

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-import '../dist/bin/undeploy-gae.js'

package/dist/bin/deploy-gae.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/bin/deploy-gae.js

@@ -1,12 +0,0 @@
-import { _parseArgs } from '@naturalcycles/nodejs-lib/args';
-import { runScript } from '@naturalcycles/nodejs-lib/runScript';
-import { deployGae } from '../deploy/deployGae.js';
-import { deployHealthCheckCliOptions } from '../deploy/deployHealthCheck.js';
-import { deployPrepareCliOptions } from '../deploy/deployPrepare.js';
-runScript(async () => {
-    const opt = _parseArgs({
-        ...deployPrepareCliOptions,
-        ...deployHealthCheckCliOptions,
-    });
-    await deployGae(opt);
-});

package/dist/bin/deploy-prepare.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/bin/deploy-prepare.js

@@ -1,19 +0,0 @@
-/*
-
-yarn deploy-prepare
-
- */
-import { _parseArgs } from '@naturalcycles/nodejs-lib/args';
-import { runScript } from '@naturalcycles/nodejs-lib/runScript';
-import { deployPrepare, deployPrepareCliOptions } from '../deploy/deployPrepare.js';
-runScript(async () => {
-    const opt = _parseArgs(deployPrepareCliOptions);
-    await deployPrepare(opt);
-});
-// deploy strategy
-// gae project: from config
-// gae service: from config -- branch name
-// gae version: automatic form date
-// yarn build-prod
-// yarn deploy-prepare && ./tmp/deploy/app.yaml && ./tmp/deploy/deployInfo.json && json2env
-//

package/dist/bin/undeploy-gae.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/bin/undeploy-gae.js

@@ -1,13 +0,0 @@
-import { _parseArgs } from '@naturalcycles/nodejs-lib/args';
-import { runScript } from '@naturalcycles/nodejs-lib/runScript';
-import { undeployGae } from '../deploy/deployGae.js';
-runScript(async () => {
-    const { branch } = _parseArgs({
-        branch: {
-            type: 'string',
-            demandOption: true,
-            desc: `Because Github Actions delete event happens after the branch is already deleted - you need to pass it manually`,
-        },
-    });
-    await undeployGae(branch);
-});

package/dist/deploy/backend.cfg.util.d.ts

@@ -1,30 +0,0 @@
-import type { StringMap } from '@naturalcycles/js-lib/types';
-export interface BackendCfg {
-    gaeProject: string;
-    gaeProjectByBranch?: StringMap;
-    /**
-     * @example default
-     */
-    gaeService: string;
-    gaeServiceByBranch?: StringMap;
-    /**
-     * List of file patterns to include in deployment.
-     */
-    files?: string[];
-    appEnvDefault: string;
-    appEnvByBranch?: StringMap;
-    /**
-     * List of branches to use timestamps in gae version names (to keep previous versions).
-     */
-    branchesWithTimestampVersions?: string[];
-    /**
-     * If true - branch names are not passed into deployed urls as is, but are hashed.
-     */
-    hashedBranches?: boolean;
-    /**
-     * Comma-separated list of env variables that will be passed to app.yaml from process.env
-     */
-    appYamlPassEnv?: string;
-}
-export declare const backendCfgSchema: any;
-export declare function getBackendCfg(projectDir?: string): BackendCfg;

package/dist/deploy/backend.cfg.util.js

@@ -1,23 +0,0 @@
-import { j } from '@naturalcycles/nodejs-lib/ajv';
-import { fs2 } from '@naturalcycles/nodejs-lib/fs2';
-import { yaml2 } from '@naturalcycles/nodejs-lib/yaml2';
-export const backendCfgSchema = j.object({
-    gaeProject: j.string(),
-    gaeProjectByBranch: j.object.stringMap(j.string()).optional(),
-    gaeService: j.string(),
-    gaeServiceByBranch: j.object.stringMap(j.string()).optional(),
-    files: j.array(j.string()).optional(),
-    appEnvDefault: j.string(),
-    appEnvByBranch: j.object.stringMap(j.string()).optional(),
-    branchesWithTimestampVersions: j.array(j.string()).optional(),
-    hashedBranches: j.boolean().optional(),
-    appYamlPassEnv: j.string().optional(),
-});
-export function getBackendCfg(projectDir = '.') {
-    const backendCfgYamlPath = `${projectDir}/backend.cfg.yaml`;
-    fs2.requireFileToExist(backendCfgYamlPath);
-    const backendCfg = {
-        ...yaml2.readYaml(backendCfgYamlPath),
-    };
-    return backendCfgSchema.validate(backendCfg);
-}

package/dist/deploy/deploy.model.d.ts

@@ -1,29 +0,0 @@
-import type { UnixTimestamp } from '@naturalcycles/js-lib/types';
-export interface DeployInfo {
-    gaeProject: string;
-    gaeService: string;
-    gaeVersion: string;
-    versionUrl: string;
-    serviceUrl: string;
-    gitRev: string;
-    gitBranch: string;
-    /**
-     * Unix timestamp of deployInfo.json being generated.
-     */
-    ts: UnixTimestamp;
-}
-export interface AppYaml extends Record<string, any> {
-    runtime: string;
-    service: string;
-    inbound_services?: string[];
-    instance_class?: string;
-    automatic_scaling?: {
-        min_instances?: number;
-        max_instances?: number;
-    };
-    env_variables: {
-        APP_ENV: string;
-        DEBUG: string;
-        [k: string]: string;
-    };
-}

package/dist/deploy/deploy.model.js

@@ -1 +0,0 @@
-export {};

package/dist/deploy/deploy.util.d.ts

@@ -1,7 +0,0 @@
-import type { BackendCfg } from './backend.cfg.util.js';
-import type { AppYaml, DeployInfo } from './deploy.model.js';
-export declare function createAndSaveDeployInfo(backendCfg: BackendCfg, targetDir: string): Promise<DeployInfo>;
-export declare function createDeployInfo(backendCfg: BackendCfg, overrideBranch?: string): Promise<DeployInfo>;
-export declare function createAndSaveAppYaml(backendCfg: BackendCfg, deployInfo: DeployInfo, projectDir: string, targetDir: string, appYamlPassEnv?: string): AppYaml;
-export declare function createAppYaml(backendCfg: BackendCfg, deployInfo: DeployInfo, projectDir: string, appYamlPassEnv?: string): AppYaml;
-export declare function validateGAEServiceName(serviceName: string): string;

package/dist/deploy/deploy.util.js

@@ -1,151 +0,0 @@
-import { localTime } from '@naturalcycles/js-lib/datetime/localTime.js';
-import { _assert } from '@naturalcycles/js-lib/error/assert.js';
-import { _mapValues, _merge } from '@naturalcycles/js-lib/object/object.util.js';
-import { _truncate } from '@naturalcycles/js-lib/string/string.util.js';
-import { sha256 } from '@naturalcycles/nodejs-lib';
-import { dimGrey, white } from '@naturalcycles/nodejs-lib/colors';
-import { fs2 } from '@naturalcycles/nodejs-lib/fs2';
-import { yaml2 } from '@naturalcycles/nodejs-lib/yaml2';
-const APP_YAML_DEFAULT = () => ({
-    runtime: 'nodejs22',
-    service: 'default',
-    inbound_services: ['warmup'],
-    instance_class: 'F1',
-    automatic_scaling: {
-        min_instances: 0,
-        max_instances: 1,
-    },
-    env_variables: {
-        APP_ENV: 'prod',
-        DEBUG: 'app*,nc:*',
-        DEBUG_HIDE_DATE: 'true',
-        // DEBUG_COLORS: 'true',
-        TZ: 'UTC',
-    },
-});
-export async function createAndSaveDeployInfo(backendCfg, targetDir) {
-    const deployInfo = await createDeployInfo(backendCfg);
-    const deployInfoPath = `${targetDir}/deployInfo.json`;
-    fs2.writeJson(deployInfoPath, deployInfo, { spaces: 2 });
-    console.log(`saved ${dimGrey(deployInfoPath)}`);
-    return deployInfo;
-}
-export async function createDeployInfo(backendCfg, overrideBranch) {
-    const { simpleGit } = await import('simple-git'); // lazy load
-    const git = simpleGit('.');
-    const now = localTime.now();
-    const gitBranch = overrideBranch || (await git.status()).current;
-    const gitRev = (await git.revparse(['HEAD'])).slice(0, 7);
-    let { gaeProject, gaeProjectByBranch = {}, gaeService, gaeServiceByBranch = {}, branchesWithTimestampVersions = [], } = backendCfg;
-    gaeProject = gaeProjectByBranch[gitBranch] || gaeProject;
-    if (gaeServiceByBranch[gitBranch]) {
-        gaeService = validateGAEServiceName(gaeServiceByBranch[gitBranch]);
-    }
-    else {
-        let branchName = gitBranch;
-        if (backendCfg.hashedBranches) {
-            // Obfuscates the branch name by hashing it.
-            // If there are Jira issue names in the branch name, the first one found will be used as a prefix.
-            const jiraIssue = gitBranch.match(/([Dd][Ee][Vv]-\d+)/)?.[0];
-            const branchHash = sha256(gitBranch).slice(0, 10);
-            branchName = [jiraIssue, branchHash].filter(Boolean).join('-');
-        }
-        gaeService = validateGAEServiceName([branchName, gaeService].join('--'));
-    }
-    let gaeVersion = '1';
-    if (branchesWithTimestampVersions.includes(gitBranch)) {
-        // May only contain lowercase letters, digits, and hyphens. Must begin and end with a letter or digit. Must not exceed 63 characters.
-        gaeVersion = [
-            // now.format('YYYYMMDD-HHmm'), // 20190521-1721
-            now.toStringCompact().replace('_', '-'),
-            gitRev,
-        ].join('-');
-    }
-    const versionUrl = `https://${[gaeVersion, gaeService, gaeProject].join('-dot-')}.appspot.com`;
-    // Check the 63-char limit
-    const versionUrlString = [gaeVersion, gaeService, gaeProject].join('-dot-');
-    _assert(versionUrlString.length <= 63, `versionUrl length should be <= 63 characters, but it's ${versionUrlString.length} instead: ${versionUrlString}`);
-    const serviceUrl = `https://${[gaeService, gaeProject].join('-dot-')}.appspot.com`;
-    const deployInfo = {
-        gaeProject,
-        gaeService,
-        gaeVersion,
-        versionUrl,
-        serviceUrl,
-        gitBranch,
-        gitRev,
-        ts: now.unix,
-    };
-    console.log({ deployInfo });
-    return deployInfo;
-}
-export function createAndSaveAppYaml(backendCfg, deployInfo, projectDir, targetDir, appYamlPassEnv = '') {
-    const appYaml = createAppYaml(backendCfg, deployInfo, projectDir, appYamlPassEnv);
-    const appYamlPath = `${targetDir}/app.yaml`;
-    yaml2.writeYaml(appYamlPath, appYaml);
-    console.log(`saved ${dimGrey(appYamlPath)}`);
-    return appYaml;
-}
-export function createAppYaml(backendCfg, deployInfo, projectDir, appYamlPassEnv = '') {
-    const { appEnvDefault, appEnvByBranch = {} } = backendCfg;
-    const { gaeService: service, gitBranch } = deployInfo;
-    const { APP_ENV: processAppEnv } = process.env;
-    const APP_ENV = processAppEnv || appEnvByBranch[gitBranch] || appEnvDefault;
-    if (processAppEnv) {
-        console.log(`using APP_ENV=${dimGrey(processAppEnv)} from process.env`);
-    }
-    const appYaml = APP_YAML_DEFAULT();
-    // Check existing app.yaml
-    const appYamlPath = `${projectDir}/app.yaml`;
-    if (fs2.pathExists(appYamlPath)) {
-        console.log(`merging-in ${dimGrey(appYamlPath)}`);
-        _merge(appYaml, yaml2.readYaml(appYamlPath));
-    }
-    const appEnvYamlPath = `${projectDir}/app.${APP_ENV}.yaml`;
-    if (fs2.pathExists(appEnvYamlPath)) {
-        console.log(`merging-in ${dimGrey(appEnvYamlPath)}`);
-        _merge(appYaml, yaml2.readYaml(appEnvYamlPath));
-    }
-    // appYamlPassEnv
-    const passEnv = appYamlPassEnv
-        .split(',')
-        .filter(Boolean)
-        // oxlint-disable-next-line unicorn/no-array-reduce
-        .reduce((map, key) => {
-        const v = process.env[key];
-        if (!v) {
-            throw new Error(`appYamlPassEnv.${key} is requested, but process.env.${key} is not defined!`);
-        }
-        map[key] = v;
-        return map;
-    }, {});
-    if (Object.keys(passEnv).length) {
-        console.log(`will merge ${white(String(Object.keys(passEnv).length))} process.env keys to app.yaml: ${dimGrey(Object.keys(passEnv).join(', '))}`);
-    }
-    _merge(appYaml, {
-        service,
-        env_variables: {
-            APP_ENV,
-            ...passEnv,
-        },
-    });
-    // Redacted appYaml to not show up secrets
-    console.log({
-        appYaml: redactedAppYaml(appYaml),
-    });
-    return appYaml;
-}
-function redactedAppYaml(appYaml) {
-    return {
-        ...appYaml,
-        env_variables: _mapValues(appYaml.env_variables || {}, (_k, v) => _truncate(v, 7)),
-    };
-}
-export function validateGAEServiceName(serviceName) {
-    // May only contain lowercase letters, digits, and hyphens. Must begin and end with a letter or digit. Must not exceed 63 characters.
-    return serviceName
-        .replaceAll('_', '-')
-        .toLowerCase()
-        .replaceAll(/[^0-9a-z-]/gi, '')
-        .slice(0, 40);
-}

package/dist/deploy/deployGae.d.ts

@@ -1,10 +0,0 @@
-import type { DeployHealthCheckOptions } from './deployHealthCheck.js';
-import type { DeployPrepareOptions } from './deployPrepare.js';
-export interface DeployGaeOptions extends DeployPrepareOptions, DeployHealthCheckOptions {
-}
-export declare function deployGae(opt?: DeployGaeOptions): Promise<void>;
-/**
- * Undeploys/removes the GAE service/version, using the same rules as deployGae.
- * Detects the service/version by the same criteria: branch name, backend.cfg.yaml, etc.
- */
-export declare function undeployGae(branch: string): Promise<void>;