@gigadrive/network-config 5.4.0 → 5.5.1

package/dist/define-config.d.mts

@@ -32,7 +32,7 @@ interface NormalizedImagePolicy {
     variants: Record<string, NormalizedImageVariant>;
 }
 
-declare const RUNTIME_DEFINITIONS: readonly ["php-84", "php-83", "php-81", "node-22", "node-20", "node-18", "node-16", "bun-1"];
+declare const RUNTIME_DEFINITIONS: readonly ["php-84", "php-83", "php-81", "ruby-40", "ruby-34", "ruby-33", "node-22", "node-20", "node-18", "node-16", "bun-1"];
 type Runtime = (typeof RUNTIME_DEFINITIONS)[number];
 
 type UpstashAWSRegion = 'us-east-1' | 'us-east-2' | 'us-west-1' | 'us-west-2' | 'eu-central-1' | 'eu-west-1' | 'eu-west-2' | 'sa-east-1' | 'ap-south-1' | 'ap-northeast-1' | 'ap-southeast-1' | 'ap-southeast-2';

package/dist/define-config.d.ts

@@ -32,7 +32,7 @@ interface NormalizedImagePolicy {
     variants: Record<string, NormalizedImageVariant>;
 }
 
-declare const RUNTIME_DEFINITIONS: readonly ["php-84", "php-83", "php-81", "node-22", "node-20", "node-18", "node-16", "bun-1"];
+declare const RUNTIME_DEFINITIONS: readonly ["php-84", "php-83", "php-81", "ruby-40", "ruby-34", "ruby-33", "node-22", "node-20", "node-18", "node-16", "bun-1"];
 type Runtime = (typeof RUNTIME_DEFINITIONS)[number];
 
 type UpstashAWSRegion = 'us-east-1' | 'us-east-2' | 'us-west-1' | 'us-west-2' | 'eu-central-1' | 'eu-west-1' | 'eu-west-2' | 'sa-east-1' | 'ap-south-1' | 'ap-northeast-1' | 'ap-southeast-1' | 'ap-southeast-2';

package/dist/index.d.mts

@@ -179,6 +179,7 @@ declare const GigadriveNextPrerenderOutputSchema: Schema.Union<[Schema.mutable<S
     route: Schema.optional<Schema.filter<typeof Schema.String>>;
     parentOutputId: typeof Schema.String;
     groupId: typeof Schema.Number;
+    cacheKey: Schema.optional<typeof Schema.String>;
     pprChain: Schema.optional<Schema.mutable<Schema.Struct<{
         headers: Schema.filter<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.filter<typeof Schema.String>>>>;
     }>>>;
@@ -210,6 +211,7 @@ declare const GigadriveNextPrerenderOutputSchema: Schema.Union<[Schema.mutable<S
     route: Schema.optional<Schema.filter<typeof Schema.String>>;
     parentOutputId: typeof Schema.String;
     groupId: typeof Schema.Number;
+    cacheKey: Schema.optional<typeof Schema.String>;
     pprChain: Schema.optional<Schema.mutable<Schema.Struct<{
         headers: Schema.filter<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.filter<typeof Schema.String>>>>;
     }>>>;
@@ -376,6 +378,7 @@ declare const GigadriveNextBuildManifestV2StandaloneSchema: Schema.mutable<Schem
             route: Schema.optional<Schema.filter<typeof Schema.String>>;
             parentOutputId: typeof Schema.String;
             groupId: typeof Schema.Number;
+            cacheKey: Schema.optional<typeof Schema.String>;
             pprChain: Schema.optional<Schema.mutable<Schema.Struct<{
                 headers: Schema.filter<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.filter<typeof Schema.String>>>>;
             }>>>;
@@ -407,6 +410,7 @@ declare const GigadriveNextBuildManifestV2StandaloneSchema: Schema.mutable<Schem
             route: Schema.optional<Schema.filter<typeof Schema.String>>;
             parentOutputId: typeof Schema.String;
             groupId: typeof Schema.Number;
+            cacheKey: Schema.optional<typeof Schema.String>;
             pprChain: Schema.optional<Schema.mutable<Schema.Struct<{
                 headers: Schema.filter<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.filter<typeof Schema.String>>>>;
             }>>>;
@@ -520,6 +524,7 @@ declare const GigadriveNextBuildManifestSchema: Schema.Union<[Schema.mutable<Sch
             route: Schema.optional<Schema.filter<typeof Schema.String>>;
             parentOutputId: typeof Schema.String;
             groupId: typeof Schema.Number;
+            cacheKey: Schema.optional<typeof Schema.String>;
             pprChain: Schema.optional<Schema.mutable<Schema.Struct<{
                 headers: Schema.filter<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.filter<typeof Schema.String>>>>;
             }>>>;
@@ -551,6 +556,7 @@ declare const GigadriveNextBuildManifestSchema: Schema.Union<[Schema.mutable<Sch
             route: Schema.optional<Schema.filter<typeof Schema.String>>;
             parentOutputId: typeof Schema.String;
             groupId: typeof Schema.Number;
+            cacheKey: Schema.optional<typeof Schema.String>;
             pprChain: Schema.optional<Schema.mutable<Schema.Struct<{
                 headers: Schema.filter<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.filter<typeof Schema.String>>>>;
             }>>>;
@@ -630,6 +636,7 @@ declare const GigadriveNextPrerenderManifestV1Schema: Schema.mutable<Schema.Stru
         route: Schema.optional<Schema.filter<typeof Schema.String>>;
         parentOutputId: typeof Schema.String;
         groupId: typeof Schema.Number;
+        cacheKey: Schema.optional<typeof Schema.String>;
         pprChain: Schema.optional<Schema.mutable<Schema.Struct<{
             headers: Schema.filter<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.filter<typeof Schema.String>>>>;
         }>>>;
@@ -661,6 +668,7 @@ declare const GigadriveNextPrerenderManifestV1Schema: Schema.mutable<Schema.Stru
         route: Schema.optional<Schema.filter<typeof Schema.String>>;
         parentOutputId: typeof Schema.String;
         groupId: typeof Schema.Number;
+        cacheKey: Schema.optional<typeof Schema.String>;
         pprChain: Schema.optional<Schema.mutable<Schema.Struct<{
             headers: Schema.filter<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.filter<typeof Schema.String>>>>;
         }>>>;
@@ -693,7 +701,7 @@ declare const REGION_DEFINITIONS: readonly ["us-east-1", "us-east-2", "us-west-1
 type Region = (typeof REGION_DEFINITIONS)[number];
 declare const AVAILABLE_REGIONS: Region[];
 
-declare const RUNTIME_DEFINITIONS: readonly ["php-84", "php-83", "php-81", "node-22", "node-20", "node-18", "node-16", "bun-1"];
+declare const RUNTIME_DEFINITIONS: readonly ["php-84", "php-83", "php-81", "ruby-40", "ruby-34", "ruby-33", "node-22", "node-20", "node-18", "node-16", "bun-1"];
 type Runtime = (typeof RUNTIME_DEFINITIONS)[number];
 declare const AVAILABLE_RUNTIMES: Runtime[];
 
@@ -1735,15 +1743,19 @@ declare const FrameworkNotDetectedError_base: Schema.TaggedErrorClass<FrameworkN
 declare class FrameworkNotDetectedError extends FrameworkNotDetectedError_base {
 }
 interface FrameworkDetectionItem {
-    /** Check manifest dependencies for this package (routed by framework language) */
+    /**
+     * Check manifest dependencies for this package (routed by framework language):
+     * `package.json` for Node, `composer.json` for PHP, and `Gemfile.lock` (or
+     * `Gemfile` without a lockfile) for Ruby.
+     */
     matchPackage?: string;
     /** Check if this file exists (relative to project root) */
     path?: string;
     /** If path is set, also check file content matches this regex */
     matchContent?: string;
 }
-type FrameworkLanguage = 'node' | 'php';
-type PackageManager = 'npm' | 'yarn' | 'pnpm' | 'bun' | 'composer';
+type FrameworkLanguage = 'node' | 'php' | 'ruby';
+type PackageManager = 'npm' | 'yarn' | 'pnpm' | 'bun' | 'composer' | 'bundler';
 interface FrameworkDefinition {
     slug: string;
     name: string;
@@ -1841,11 +1853,93 @@ declare const detectFramework: (projectFolder: string) => Effect.Effect<{
  */
 declare const detectPackageManager: (projectFolder: string) => Effect.Effect<PackageManager, never, FileSystem.FileSystem | Path.Path>;
 
+/**
+ * The runtime every Ruby preset declares until the project names a Ruby
+ * version: Ruby 3.4, which more gems support today than Ruby 4.0.
+ */
+declare const DEFAULT_RUBY_RUNTIME: Runtime;
+/**
+ * Picks the Ruby runtime for a concrete version, such as the contents of
+ * `.ruby-version`: the runtime of the same minor series, otherwise the newest
+ * runtime older than the version. A version older than every runtime (`3.2.2`)
+ * gets the oldest one, `ruby-33`, and one newer than every runtime gets
+ * `ruby-40`.
+ *
+ * @param version - The version, e.g. `3.3.6`, `ruby-3.4.1` or `3.3.6p108`.
+ * @returns The runtime, or `undefined` when the version cannot be parsed.
+ *
+ * @example
+ * ```ts
+ * rubyRuntimeForVersion('3.3.6'); // 'ruby-33'
+ * rubyRuntimeForVersion('3.2.2'); // 'ruby-33'
+ * rubyRuntimeForVersion('4.1.0'); // 'ruby-40'
+ * ```
+ */
+declare const rubyRuntimeForVersion: (version: string) => Runtime | undefined;
+/**
+ * Picks the Ruby runtime for a RubyGems requirement, such as a Gemfile `ruby`
+ * directive. An exact version (`3.3.6` or `= 3.3.6`) is a concrete version
+ * ({@link rubyRuntimeForVersion}); any other requirement picks the newest
+ * runtime whose newest patch release it allows, so `~> 3.3` picks `ruby-34`
+ * and `>= 3.2` picks `ruby-40`.
+ *
+ * @param requirement - The requirement, e.g. `~> 3.3` or `>= 3.2, < 3.4`.
+ * @returns The runtime, or `undefined` when the requirement cannot be parsed
+ *   or allows no runtime.
+ */
+declare const rubyRuntimeForRequirement: (requirement: string) => Runtime | undefined;
+/**
+ * Picks the Ruby runtime a project asks for, from file contents the caller
+ * supplies. Pure and synchronous, so a build can choose its Ruby with exactly
+ * the rules the presets use; {@link detectRubyRuntime} is the same function
+ * over the Effect file system. The first of these that names a usable version
+ * wins:
+ *
+ * 1. `.ruby-version` (`3.3.6`, `ruby-3.3.6`, `3.3`; trailing whitespace and
+ *    anything after a space ignored)
+ * 2. `.tool-versions` (`ruby 3.3.6`)
+ * 3. the Gemfile `ruby` directive (`ruby "3.3.6"`, `ruby "~> 3.3"`,
+ *    `ruby ">= 3.2", "< 4.0"`, or `ruby file: ".ruby-version"`, whose file is
+ *    read through `readFile`)
+ * 4. the `RUBY VERSION` a `Gemfile.lock` records (`ruby 3.3.6p108`)
+ *
+ * Concrete versions map with {@link rubyRuntimeForVersion} and requirements
+ * with {@link rubyRuntimeForRequirement}. A source naming no usable version is
+ * skipped.
+ *
+ * @param readFile - Returns the content of a project-relative file, or
+ *   `undefined` when it is missing or unreadable.
+ * @returns The runtime, or `undefined` when the project names no usable
+ *   version, in which case callers use {@link DEFAULT_RUBY_RUNTIME}.
+ *
+ * @example
+ * ```ts
+ * const runtime =
+ *   rubyRuntimeFromProjectFiles((file) => files.get(file)) ?? DEFAULT_RUBY_RUNTIME;
+ * ```
+ */
+declare const rubyRuntimeFromProjectFiles: (readFile: (relativePath: string) => string | undefined) => Runtime | undefined;
+/**
+ * Picks the Ruby runtime a project asks for by reading its files with the
+ * Effect file system and handing them to {@link rubyRuntimeFromProjectFiles},
+ * so presets and builds share one implementation. Missing or unreadable files
+ * are skipped, never an error.
+ *
+ * The runtime of a static Ruby preset (Jekyll, Bridgetown) appears nowhere in
+ * the generated config, since it has no function, so a build that needs to
+ * choose its Ruby calls this (or {@link rubyRuntimeFromProjectFiles}) directly.
+ *
+ * @param projectFolder - Absolute path to the project root
+ * @returns The runtime, or `undefined` when the project names no usable version.
+ */
+declare const detectRubyRuntime: (projectFolder: string) => Effect.Effect<"php-84" | "php-83" | "php-81" | "ruby-40" | "ruby-34" | "ruby-33" | "node-22" | "node-20" | "node-18" | "node-16" | "bun-1" | undefined, never, FileSystem.FileSystem | Path.Path>;
+
 /**
  * All supported framework definitions, sorted by priority descending.
  * Higher priority frameworks are checked first during detection. Every PHP
  * preset picks its runtime from `composer.json` `require.php`
- * ({@link withComposerPhpRuntime}).
+ * ({@link withComposerPhpRuntime}), and every Ruby preset from the project's
+ * Ruby version ({@link withRubyRuntime}).
  */
 declare const FRAMEWORK_DEFINITIONS: FrameworkDefinition[];
 
@@ -1902,7 +1996,9 @@ declare const mergeWithFrameworkDefaults: (userConfig: NormalizedConfig, framewo
 
 /**
  * Reads dependency names from the appropriate manifest file for a language.
- * Returns a set of all dependency names (production + dev).
+ * Returns a set of all dependency names (production + dev). For Ruby these are
+ * the gems in `Gemfile.lock`, including transitive ones, or the gems the
+ * `Gemfile` declares when there is no lockfile.
  *
  * If the manifest file does not exist, returns an empty set (graceful).
  * If the file exists but cannot be read (`ManifestReadError`) or parsed
@@ -1925,4 +2021,4 @@ declare const filterFunctionsFromAssets: (config: NormalizedConfig) => Normalize
 
 declare const NetworkConfigLive: Layer.Layer<ConfigModuleLoader | RawConfigReader | SchemaValidator | V4ConfigParser | VercelBuildOutputParser, never, _effect_platform_FileSystem.FileSystem | _effect_platform_Path.Path>;
 
-export { ALLOWED_CONFIG_NAMES, AVAILABLE_REGIONS, AVAILABLE_RUNTIMES, COMPOSE_FILE_NAMES, CONTAINER_ENTRYPOINT_PREFIX, CONTAINER_RUNTIME, type Config, ConfigFileEmptyError, ConfigFileNotFoundError, ConfigFileParseError, ConfigModuleLoadError, ConfigModuleLoader, ConfigSchemaValidationError, type ConfigV4, type ConfigV4Container, type ConfigV4ContainerBuild, type ConfigV4FunctionSettings, type ConfigV4Queue, type ConfigV4QueueDuration, type ConfigV4QueueSchedule, type ConfigV4Service, type ConfigV4ServicePostgres, type ConfigV4ServiceRedis, type ConfigV4ServiceStorage, type ConfigV4Services, type ConfigV4StorageBucket, ConfigVersionError, ContainerConfigError, type ContainerProjectDetection, type ContainerRuntime, DEFAULT_CONTAINER_MEMORY_MB, DEFAULT_FUNCTION_DURATION_SECONDS, DEFAULT_SIDECAR_MEMORY_MB, type DetectionResult, FRAMEWORK_DEFINITIONS, type FilePathMap, type FrameworkDefaultConfig, type FrameworkDefinition, type FrameworkDetectionItem, type FrameworkLanguage, FrameworkNotDetectedError, FunctionConfigError, type GigadriveNextBuildManifest, GigadriveNextBuildManifestSchema, type GigadriveNextBuildManifestV1, GigadriveNextBuildManifestV1Schema, type GigadriveNextBuildManifestV2, type GigadriveNextBuildManifestV2Export, GigadriveNextBuildManifestV2ExportSchema, type GigadriveNextBuildManifestV2Standalone, GigadriveNextBuildManifestV2StandaloneSchema, type GigadriveNextMiddlewareDescriptor, GigadriveNextMiddlewareDescriptorSchema, type GigadriveNextMiddlewareMatcher, GigadriveNextMiddlewareMatcherSchema, type GigadriveNextPrerenderManifestV1, GigadriveNextPrerenderManifestV1Schema, type GigadriveNextPrerenderOutput, GigadriveNextPrerenderOutputSchema, type GigadriveNextPrerenderSeedMethods, GigadriveNextPrerenderSeedMethodsSchema, type GigadriveNextRouteCondition, GigadriveNextRouteConditionSchema, type GigadriveNextServerDescriptor, GigadriveNextServerDescriptorSchema, type GigadriveNextStaticAssetPrefix, GigadriveNextStaticAssetPrefixSchema, type JsonValue, MAX_FUNCTION_DURATION_SECONDS, MAX_SIDECARS, ManifestNotFoundError, ManifestParseError, ManifestReadError, type NeonAWSRegion, NetworkConfigLive, type NormalizedConfig, type NormalizedConfigEntrypoint, type NormalizedConfigQueue, type NormalizedConfigQueueSchedule, type NormalizedConfigRoute, type NormalizedConfigRouteHandler, type NormalizedConfigRouteMatchRequirements, type NormalizedConfigRouteMethod, type NormalizedConfigService, type NormalizedConfigServiceDefinition, type NormalizedConfigServicePostgres, type NormalizedConfigServiceQueues, type NormalizedConfigServiceRedis, type NormalizedConfigServiceStorage, type NormalizedConfigServiceType, type NormalizedConfigStorageBucket, type NormalizedContainerImageSource, type NormalizedContainerSpec, type NormalizedFramework, type NormalizedImageFit, type NormalizedImageFormat, type NormalizedImageLocalPattern, type NormalizedImagePolicy, type NormalizedImageRemotePattern, type NormalizedImageVariant, type NormalizedNextjsFramework, type NormalizedSharedArtifact, type NormalizedSidecar, type PackageManager, RawConfigReader, type Region, type Runtime, SchemaValidator, type StaticAssetHeaders, StaticAssetHeadersSchema, type StaticAssetManifest, type StaticAssetManifestEntry, StaticAssetManifestEntrySchema, type StaticAssetManifestV1, StaticAssetManifestV1Schema, type UpstashAWSRegion, V4ConfigParser, VercelBuildOutputParser, collectAssetFiles, composeDeclaresApp, containerEntrypointPath, defineConfig, detectContainerProject, detectFramework, detectPackageManager, dockerFunctionContainerName, filterFunctionsFromAssets, generateConfig, generatedSecret, getFunctionSettings, mergeWithFrameworkDefaults, normalizeContainers, parseConfig, parseConfigRaw, parseGigadriveNextBuildManifest, parseGigadriveNextPrerenderManifest, parseStaticAssetManifest, postProcessConfig, readComposeContainers, readDependencies, splitCommandWords };
+export { ALLOWED_CONFIG_NAMES, AVAILABLE_REGIONS, AVAILABLE_RUNTIMES, COMPOSE_FILE_NAMES, CONTAINER_ENTRYPOINT_PREFIX, CONTAINER_RUNTIME, type Config, ConfigFileEmptyError, ConfigFileNotFoundError, ConfigFileParseError, ConfigModuleLoadError, ConfigModuleLoader, ConfigSchemaValidationError, type ConfigV4, type ConfigV4Container, type ConfigV4ContainerBuild, type ConfigV4FunctionSettings, type ConfigV4Queue, type ConfigV4QueueDuration, type ConfigV4QueueSchedule, type ConfigV4Service, type ConfigV4ServicePostgres, type ConfigV4ServiceRedis, type ConfigV4ServiceStorage, type ConfigV4Services, type ConfigV4StorageBucket, ConfigVersionError, ContainerConfigError, type ContainerProjectDetection, type ContainerRuntime, DEFAULT_CONTAINER_MEMORY_MB, DEFAULT_FUNCTION_DURATION_SECONDS, DEFAULT_RUBY_RUNTIME, DEFAULT_SIDECAR_MEMORY_MB, type DetectionResult, FRAMEWORK_DEFINITIONS, type FilePathMap, type FrameworkDefaultConfig, type FrameworkDefinition, type FrameworkDetectionItem, type FrameworkLanguage, FrameworkNotDetectedError, FunctionConfigError, type GigadriveNextBuildManifest, GigadriveNextBuildManifestSchema, type GigadriveNextBuildManifestV1, GigadriveNextBuildManifestV1Schema, type GigadriveNextBuildManifestV2, type GigadriveNextBuildManifestV2Export, GigadriveNextBuildManifestV2ExportSchema, type GigadriveNextBuildManifestV2Standalone, GigadriveNextBuildManifestV2StandaloneSchema, type GigadriveNextMiddlewareDescriptor, GigadriveNextMiddlewareDescriptorSchema, type GigadriveNextMiddlewareMatcher, GigadriveNextMiddlewareMatcherSchema, type GigadriveNextPrerenderManifestV1, GigadriveNextPrerenderManifestV1Schema, type GigadriveNextPrerenderOutput, GigadriveNextPrerenderOutputSchema, type GigadriveNextPrerenderSeedMethods, GigadriveNextPrerenderSeedMethodsSchema, type GigadriveNextRouteCondition, GigadriveNextRouteConditionSchema, type GigadriveNextServerDescriptor, GigadriveNextServerDescriptorSchema, type GigadriveNextStaticAssetPrefix, GigadriveNextStaticAssetPrefixSchema, type JsonValue, MAX_FUNCTION_DURATION_SECONDS, MAX_SIDECARS, ManifestNotFoundError, ManifestParseError, ManifestReadError, type NeonAWSRegion, NetworkConfigLive, type NormalizedConfig, type NormalizedConfigEntrypoint, type NormalizedConfigQueue, type NormalizedConfigQueueSchedule, type NormalizedConfigRoute, type NormalizedConfigRouteHandler, type NormalizedConfigRouteMatchRequirements, type NormalizedConfigRouteMethod, type NormalizedConfigService, type NormalizedConfigServiceDefinition, type NormalizedConfigServicePostgres, type NormalizedConfigServiceQueues, type NormalizedConfigServiceRedis, type NormalizedConfigServiceStorage, type NormalizedConfigServiceType, type NormalizedConfigStorageBucket, type NormalizedContainerImageSource, type NormalizedContainerSpec, type NormalizedFramework, type NormalizedImageFit, type NormalizedImageFormat, type NormalizedImageLocalPattern, type NormalizedImagePolicy, type NormalizedImageRemotePattern, type NormalizedImageVariant, type NormalizedNextjsFramework, type NormalizedSharedArtifact, type NormalizedSidecar, type PackageManager, RawConfigReader, type Region, type Runtime, SchemaValidator, type StaticAssetHeaders, StaticAssetHeadersSchema, type StaticAssetManifest, type StaticAssetManifestEntry, StaticAssetManifestEntrySchema, type StaticAssetManifestV1, StaticAssetManifestV1Schema, type UpstashAWSRegion, V4ConfigParser, VercelBuildOutputParser, collectAssetFiles, composeDeclaresApp, containerEntrypointPath, defineConfig, detectContainerProject, detectFramework, detectPackageManager, detectRubyRuntime, dockerFunctionContainerName, filterFunctionsFromAssets, generateConfig, generatedSecret, getFunctionSettings, mergeWithFrameworkDefaults, normalizeContainers, parseConfig, parseConfigRaw, parseGigadriveNextBuildManifest, parseGigadriveNextPrerenderManifest, parseStaticAssetManifest, postProcessConfig, readComposeContainers, readDependencies, rubyRuntimeForRequirement, rubyRuntimeForVersion, rubyRuntimeFromProjectFiles, splitCommandWords };

package/dist/index.d.ts

@@ -179,6 +179,7 @@ declare const GigadriveNextPrerenderOutputSchema: Schema.Union<[Schema.mutable<S
     route: Schema.optional<Schema.filter<typeof Schema.String>>;
     parentOutputId: typeof Schema.String;
     groupId: typeof Schema.Number;
+    cacheKey: Schema.optional<typeof Schema.String>;
     pprChain: Schema.optional<Schema.mutable<Schema.Struct<{
         headers: Schema.filter<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.filter<typeof Schema.String>>>>;
     }>>>;
@@ -210,6 +211,7 @@ declare const GigadriveNextPrerenderOutputSchema: Schema.Union<[Schema.mutable<S
     route: Schema.optional<Schema.filter<typeof Schema.String>>;
     parentOutputId: typeof Schema.String;
     groupId: typeof Schema.Number;
+    cacheKey: Schema.optional<typeof Schema.String>;
     pprChain: Schema.optional<Schema.mutable<Schema.Struct<{
         headers: Schema.filter<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.filter<typeof Schema.String>>>>;
     }>>>;
@@ -376,6 +378,7 @@ declare const GigadriveNextBuildManifestV2StandaloneSchema: Schema.mutable<Schem
             route: Schema.optional<Schema.filter<typeof Schema.String>>;
             parentOutputId: typeof Schema.String;
             groupId: typeof Schema.Number;
+            cacheKey: Schema.optional<typeof Schema.String>;
             pprChain: Schema.optional<Schema.mutable<Schema.Struct<{
                 headers: Schema.filter<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.filter<typeof Schema.String>>>>;
             }>>>;
@@ -407,6 +410,7 @@ declare const GigadriveNextBuildManifestV2StandaloneSchema: Schema.mutable<Schem
             route: Schema.optional<Schema.filter<typeof Schema.String>>;
             parentOutputId: typeof Schema.String;
             groupId: typeof Schema.Number;
+            cacheKey: Schema.optional<typeof Schema.String>;
             pprChain: Schema.optional<Schema.mutable<Schema.Struct<{
                 headers: Schema.filter<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.filter<typeof Schema.String>>>>;
             }>>>;
@@ -520,6 +524,7 @@ declare const GigadriveNextBuildManifestSchema: Schema.Union<[Schema.mutable<Sch
             route: Schema.optional<Schema.filter<typeof Schema.String>>;
             parentOutputId: typeof Schema.String;
             groupId: typeof Schema.Number;
+            cacheKey: Schema.optional<typeof Schema.String>;
             pprChain: Schema.optional<Schema.mutable<Schema.Struct<{
                 headers: Schema.filter<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.filter<typeof Schema.String>>>>;
             }>>>;
@@ -551,6 +556,7 @@ declare const GigadriveNextBuildManifestSchema: Schema.Union<[Schema.mutable<Sch
             route: Schema.optional<Schema.filter<typeof Schema.String>>;
             parentOutputId: typeof Schema.String;
             groupId: typeof Schema.Number;
+            cacheKey: Schema.optional<typeof Schema.String>;
             pprChain: Schema.optional<Schema.mutable<Schema.Struct<{
                 headers: Schema.filter<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.filter<typeof Schema.String>>>>;
             }>>>;
@@ -630,6 +636,7 @@ declare const GigadriveNextPrerenderManifestV1Schema: Schema.mutable<Schema.Stru
         route: Schema.optional<Schema.filter<typeof Schema.String>>;
         parentOutputId: typeof Schema.String;
         groupId: typeof Schema.Number;
+        cacheKey: Schema.optional<typeof Schema.String>;
         pprChain: Schema.optional<Schema.mutable<Schema.Struct<{
             headers: Schema.filter<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.filter<typeof Schema.String>>>>;
         }>>>;
@@ -661,6 +668,7 @@ declare const GigadriveNextPrerenderManifestV1Schema: Schema.mutable<Schema.Stru
         route: Schema.optional<Schema.filter<typeof Schema.String>>;
         parentOutputId: typeof Schema.String;
         groupId: typeof Schema.Number;
+        cacheKey: Schema.optional<typeof Schema.String>;
         pprChain: Schema.optional<Schema.mutable<Schema.Struct<{
             headers: Schema.filter<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.filter<typeof Schema.String>>>>;
         }>>>;
@@ -693,7 +701,7 @@ declare const REGION_DEFINITIONS: readonly ["us-east-1", "us-east-2", "us-west-1
 type Region = (typeof REGION_DEFINITIONS)[number];
 declare const AVAILABLE_REGIONS: Region[];
 
-declare const RUNTIME_DEFINITIONS: readonly ["php-84", "php-83", "php-81", "node-22", "node-20", "node-18", "node-16", "bun-1"];
+declare const RUNTIME_DEFINITIONS: readonly ["php-84", "php-83", "php-81", "ruby-40", "ruby-34", "ruby-33", "node-22", "node-20", "node-18", "node-16", "bun-1"];
 type Runtime = (typeof RUNTIME_DEFINITIONS)[number];
 declare const AVAILABLE_RUNTIMES: Runtime[];
 
@@ -1735,15 +1743,19 @@ declare const FrameworkNotDetectedError_base: Schema.TaggedErrorClass<FrameworkN
 declare class FrameworkNotDetectedError extends FrameworkNotDetectedError_base {
 }
 interface FrameworkDetectionItem {
-    /** Check manifest dependencies for this package (routed by framework language) */
+    /**
+     * Check manifest dependencies for this package (routed by framework language):
+     * `package.json` for Node, `composer.json` for PHP, and `Gemfile.lock` (or
+     * `Gemfile` without a lockfile) for Ruby.
+     */
     matchPackage?: string;
     /** Check if this file exists (relative to project root) */
     path?: string;
     /** If path is set, also check file content matches this regex */
     matchContent?: string;
 }
-type FrameworkLanguage = 'node' | 'php';
-type PackageManager = 'npm' | 'yarn' | 'pnpm' | 'bun' | 'composer';
+type FrameworkLanguage = 'node' | 'php' | 'ruby';
+type PackageManager = 'npm' | 'yarn' | 'pnpm' | 'bun' | 'composer' | 'bundler';
 interface FrameworkDefinition {
     slug: string;
     name: string;
@@ -1841,11 +1853,93 @@ declare const detectFramework: (projectFolder: string) => Effect.Effect<{
  */
 declare const detectPackageManager: (projectFolder: string) => Effect.Effect<PackageManager, never, FileSystem.FileSystem | Path.Path>;
 
+/**
+ * The runtime every Ruby preset declares until the project names a Ruby
+ * version: Ruby 3.4, which more gems support today than Ruby 4.0.
+ */
+declare const DEFAULT_RUBY_RUNTIME: Runtime;
+/**
+ * Picks the Ruby runtime for a concrete version, such as the contents of
+ * `.ruby-version`: the runtime of the same minor series, otherwise the newest
+ * runtime older than the version. A version older than every runtime (`3.2.2`)
+ * gets the oldest one, `ruby-33`, and one newer than every runtime gets
+ * `ruby-40`.
+ *
+ * @param version - The version, e.g. `3.3.6`, `ruby-3.4.1` or `3.3.6p108`.
+ * @returns The runtime, or `undefined` when the version cannot be parsed.
+ *
+ * @example
+ * ```ts
+ * rubyRuntimeForVersion('3.3.6'); // 'ruby-33'
+ * rubyRuntimeForVersion('3.2.2'); // 'ruby-33'
+ * rubyRuntimeForVersion('4.1.0'); // 'ruby-40'
+ * ```
+ */
+declare const rubyRuntimeForVersion: (version: string) => Runtime | undefined;
+/**
+ * Picks the Ruby runtime for a RubyGems requirement, such as a Gemfile `ruby`
+ * directive. An exact version (`3.3.6` or `= 3.3.6`) is a concrete version
+ * ({@link rubyRuntimeForVersion}); any other requirement picks the newest
+ * runtime whose newest patch release it allows, so `~> 3.3` picks `ruby-34`
+ * and `>= 3.2` picks `ruby-40`.
+ *
+ * @param requirement - The requirement, e.g. `~> 3.3` or `>= 3.2, < 3.4`.
+ * @returns The runtime, or `undefined` when the requirement cannot be parsed
+ *   or allows no runtime.
+ */
+declare const rubyRuntimeForRequirement: (requirement: string) => Runtime | undefined;
+/**
+ * Picks the Ruby runtime a project asks for, from file contents the caller
+ * supplies. Pure and synchronous, so a build can choose its Ruby with exactly
+ * the rules the presets use; {@link detectRubyRuntime} is the same function
+ * over the Effect file system. The first of these that names a usable version
+ * wins:
+ *
+ * 1. `.ruby-version` (`3.3.6`, `ruby-3.3.6`, `3.3`; trailing whitespace and
+ *    anything after a space ignored)
+ * 2. `.tool-versions` (`ruby 3.3.6`)
+ * 3. the Gemfile `ruby` directive (`ruby "3.3.6"`, `ruby "~> 3.3"`,
+ *    `ruby ">= 3.2", "< 4.0"`, or `ruby file: ".ruby-version"`, whose file is
+ *    read through `readFile`)
+ * 4. the `RUBY VERSION` a `Gemfile.lock` records (`ruby 3.3.6p108`)
+ *
+ * Concrete versions map with {@link rubyRuntimeForVersion} and requirements
+ * with {@link rubyRuntimeForRequirement}. A source naming no usable version is
+ * skipped.
+ *
+ * @param readFile - Returns the content of a project-relative file, or
+ *   `undefined` when it is missing or unreadable.
+ * @returns The runtime, or `undefined` when the project names no usable
+ *   version, in which case callers use {@link DEFAULT_RUBY_RUNTIME}.
+ *
+ * @example
+ * ```ts
+ * const runtime =
+ *   rubyRuntimeFromProjectFiles((file) => files.get(file)) ?? DEFAULT_RUBY_RUNTIME;
+ * ```
+ */
+declare const rubyRuntimeFromProjectFiles: (readFile: (relativePath: string) => string | undefined) => Runtime | undefined;
+/**
+ * Picks the Ruby runtime a project asks for by reading its files with the
+ * Effect file system and handing them to {@link rubyRuntimeFromProjectFiles},
+ * so presets and builds share one implementation. Missing or unreadable files
+ * are skipped, never an error.
+ *
+ * The runtime of a static Ruby preset (Jekyll, Bridgetown) appears nowhere in
+ * the generated config, since it has no function, so a build that needs to
+ * choose its Ruby calls this (or {@link rubyRuntimeFromProjectFiles}) directly.
+ *
+ * @param projectFolder - Absolute path to the project root
+ * @returns The runtime, or `undefined` when the project names no usable version.
+ */
+declare const detectRubyRuntime: (projectFolder: string) => Effect.Effect<"php-84" | "php-83" | "php-81" | "ruby-40" | "ruby-34" | "ruby-33" | "node-22" | "node-20" | "node-18" | "node-16" | "bun-1" | undefined, never, FileSystem.FileSystem | Path.Path>;
+
 /**
  * All supported framework definitions, sorted by priority descending.
  * Higher priority frameworks are checked first during detection. Every PHP
  * preset picks its runtime from `composer.json` `require.php`
- * ({@link withComposerPhpRuntime}).
+ * ({@link withComposerPhpRuntime}), and every Ruby preset from the project's
+ * Ruby version ({@link withRubyRuntime}).
  */
 declare const FRAMEWORK_DEFINITIONS: FrameworkDefinition[];
 
@@ -1902,7 +1996,9 @@ declare const mergeWithFrameworkDefaults: (userConfig: NormalizedConfig, framewo
 
 /**
  * Reads dependency names from the appropriate manifest file for a language.
- * Returns a set of all dependency names (production + dev).
+ * Returns a set of all dependency names (production + dev). For Ruby these are
+ * the gems in `Gemfile.lock`, including transitive ones, or the gems the
+ * `Gemfile` declares when there is no lockfile.
  *
  * If the manifest file does not exist, returns an empty set (graceful).
  * If the file exists but cannot be read (`ManifestReadError`) or parsed
@@ -1925,4 +2021,4 @@ declare const filterFunctionsFromAssets: (config: NormalizedConfig) => Normalize
 
 declare const NetworkConfigLive: Layer.Layer<ConfigModuleLoader | RawConfigReader | SchemaValidator | V4ConfigParser | VercelBuildOutputParser, never, _effect_platform_FileSystem.FileSystem | _effect_platform_Path.Path>;
 
-export { ALLOWED_CONFIG_NAMES, AVAILABLE_REGIONS, AVAILABLE_RUNTIMES, COMPOSE_FILE_NAMES, CONTAINER_ENTRYPOINT_PREFIX, CONTAINER_RUNTIME, type Config, ConfigFileEmptyError, ConfigFileNotFoundError, ConfigFileParseError, ConfigModuleLoadError, ConfigModuleLoader, ConfigSchemaValidationError, type ConfigV4, type ConfigV4Container, type ConfigV4ContainerBuild, type ConfigV4FunctionSettings, type ConfigV4Queue, type ConfigV4QueueDuration, type ConfigV4QueueSchedule, type ConfigV4Service, type ConfigV4ServicePostgres, type ConfigV4ServiceRedis, type ConfigV4ServiceStorage, type ConfigV4Services, type ConfigV4StorageBucket, ConfigVersionError, ContainerConfigError, type ContainerProjectDetection, type ContainerRuntime, DEFAULT_CONTAINER_MEMORY_MB, DEFAULT_FUNCTION_DURATION_SECONDS, DEFAULT_SIDECAR_MEMORY_MB, type DetectionResult, FRAMEWORK_DEFINITIONS, type FilePathMap, type FrameworkDefaultConfig, type FrameworkDefinition, type FrameworkDetectionItem, type FrameworkLanguage, FrameworkNotDetectedError, FunctionConfigError, type GigadriveNextBuildManifest, GigadriveNextBuildManifestSchema, type GigadriveNextBuildManifestV1, GigadriveNextBuildManifestV1Schema, type GigadriveNextBuildManifestV2, type GigadriveNextBuildManifestV2Export, GigadriveNextBuildManifestV2ExportSchema, type GigadriveNextBuildManifestV2Standalone, GigadriveNextBuildManifestV2StandaloneSchema, type GigadriveNextMiddlewareDescriptor, GigadriveNextMiddlewareDescriptorSchema, type GigadriveNextMiddlewareMatcher, GigadriveNextMiddlewareMatcherSchema, type GigadriveNextPrerenderManifestV1, GigadriveNextPrerenderManifestV1Schema, type GigadriveNextPrerenderOutput, GigadriveNextPrerenderOutputSchema, type GigadriveNextPrerenderSeedMethods, GigadriveNextPrerenderSeedMethodsSchema, type GigadriveNextRouteCondition, GigadriveNextRouteConditionSchema, type GigadriveNextServerDescriptor, GigadriveNextServerDescriptorSchema, type GigadriveNextStaticAssetPrefix, GigadriveNextStaticAssetPrefixSchema, type JsonValue, MAX_FUNCTION_DURATION_SECONDS, MAX_SIDECARS, ManifestNotFoundError, ManifestParseError, ManifestReadError, type NeonAWSRegion, NetworkConfigLive, type NormalizedConfig, type NormalizedConfigEntrypoint, type NormalizedConfigQueue, type NormalizedConfigQueueSchedule, type NormalizedConfigRoute, type NormalizedConfigRouteHandler, type NormalizedConfigRouteMatchRequirements, type NormalizedConfigRouteMethod, type NormalizedConfigService, type NormalizedConfigServiceDefinition, type NormalizedConfigServicePostgres, type NormalizedConfigServiceQueues, type NormalizedConfigServiceRedis, type NormalizedConfigServiceStorage, type NormalizedConfigServiceType, type NormalizedConfigStorageBucket, type NormalizedContainerImageSource, type NormalizedContainerSpec, type NormalizedFramework, type NormalizedImageFit, type NormalizedImageFormat, type NormalizedImageLocalPattern, type NormalizedImagePolicy, type NormalizedImageRemotePattern, type NormalizedImageVariant, type NormalizedNextjsFramework, type NormalizedSharedArtifact, type NormalizedSidecar, type PackageManager, RawConfigReader, type Region, type Runtime, SchemaValidator, type StaticAssetHeaders, StaticAssetHeadersSchema, type StaticAssetManifest, type StaticAssetManifestEntry, StaticAssetManifestEntrySchema, type StaticAssetManifestV1, StaticAssetManifestV1Schema, type UpstashAWSRegion, V4ConfigParser, VercelBuildOutputParser, collectAssetFiles, composeDeclaresApp, containerEntrypointPath, defineConfig, detectContainerProject, detectFramework, detectPackageManager, dockerFunctionContainerName, filterFunctionsFromAssets, generateConfig, generatedSecret, getFunctionSettings, mergeWithFrameworkDefaults, normalizeContainers, parseConfig, parseConfigRaw, parseGigadriveNextBuildManifest, parseGigadriveNextPrerenderManifest, parseStaticAssetManifest, postProcessConfig, readComposeContainers, readDependencies, splitCommandWords };
+export { ALLOWED_CONFIG_NAMES, AVAILABLE_REGIONS, AVAILABLE_RUNTIMES, COMPOSE_FILE_NAMES, CONTAINER_ENTRYPOINT_PREFIX, CONTAINER_RUNTIME, type Config, ConfigFileEmptyError, ConfigFileNotFoundError, ConfigFileParseError, ConfigModuleLoadError, ConfigModuleLoader, ConfigSchemaValidationError, type ConfigV4, type ConfigV4Container, type ConfigV4ContainerBuild, type ConfigV4FunctionSettings, type ConfigV4Queue, type ConfigV4QueueDuration, type ConfigV4QueueSchedule, type ConfigV4Service, type ConfigV4ServicePostgres, type ConfigV4ServiceRedis, type ConfigV4ServiceStorage, type ConfigV4Services, type ConfigV4StorageBucket, ConfigVersionError, ContainerConfigError, type ContainerProjectDetection, type ContainerRuntime, DEFAULT_CONTAINER_MEMORY_MB, DEFAULT_FUNCTION_DURATION_SECONDS, DEFAULT_RUBY_RUNTIME, DEFAULT_SIDECAR_MEMORY_MB, type DetectionResult, FRAMEWORK_DEFINITIONS, type FilePathMap, type FrameworkDefaultConfig, type FrameworkDefinition, type FrameworkDetectionItem, type FrameworkLanguage, FrameworkNotDetectedError, FunctionConfigError, type GigadriveNextBuildManifest, GigadriveNextBuildManifestSchema, type GigadriveNextBuildManifestV1, GigadriveNextBuildManifestV1Schema, type GigadriveNextBuildManifestV2, type GigadriveNextBuildManifestV2Export, GigadriveNextBuildManifestV2ExportSchema, type GigadriveNextBuildManifestV2Standalone, GigadriveNextBuildManifestV2StandaloneSchema, type GigadriveNextMiddlewareDescriptor, GigadriveNextMiddlewareDescriptorSchema, type GigadriveNextMiddlewareMatcher, GigadriveNextMiddlewareMatcherSchema, type GigadriveNextPrerenderManifestV1, GigadriveNextPrerenderManifestV1Schema, type GigadriveNextPrerenderOutput, GigadriveNextPrerenderOutputSchema, type GigadriveNextPrerenderSeedMethods, GigadriveNextPrerenderSeedMethodsSchema, type GigadriveNextRouteCondition, GigadriveNextRouteConditionSchema, type GigadriveNextServerDescriptor, GigadriveNextServerDescriptorSchema, type GigadriveNextStaticAssetPrefix, GigadriveNextStaticAssetPrefixSchema, type JsonValue, MAX_FUNCTION_DURATION_SECONDS, MAX_SIDECARS, ManifestNotFoundError, ManifestParseError, ManifestReadError, type NeonAWSRegion, NetworkConfigLive, type NormalizedConfig, type NormalizedConfigEntrypoint, type NormalizedConfigQueue, type NormalizedConfigQueueSchedule, type NormalizedConfigRoute, type NormalizedConfigRouteHandler, type NormalizedConfigRouteMatchRequirements, type NormalizedConfigRouteMethod, type NormalizedConfigService, type NormalizedConfigServiceDefinition, type NormalizedConfigServicePostgres, type NormalizedConfigServiceQueues, type NormalizedConfigServiceRedis, type NormalizedConfigServiceStorage, type NormalizedConfigServiceType, type NormalizedConfigStorageBucket, type NormalizedContainerImageSource, type NormalizedContainerSpec, type NormalizedFramework, type NormalizedImageFit, type NormalizedImageFormat, type NormalizedImageLocalPattern, type NormalizedImagePolicy, type NormalizedImageRemotePattern, type NormalizedImageVariant, type NormalizedNextjsFramework, type NormalizedSharedArtifact, type NormalizedSidecar, type PackageManager, RawConfigReader, type Region, type Runtime, SchemaValidator, type StaticAssetHeaders, StaticAssetHeadersSchema, type StaticAssetManifest, type StaticAssetManifestEntry, StaticAssetManifestEntrySchema, type StaticAssetManifestV1, StaticAssetManifestV1Schema, type UpstashAWSRegion, V4ConfigParser, VercelBuildOutputParser, collectAssetFiles, composeDeclaresApp, containerEntrypointPath, defineConfig, detectContainerProject, detectFramework, detectPackageManager, detectRubyRuntime, dockerFunctionContainerName, filterFunctionsFromAssets, generateConfig, generatedSecret, getFunctionSettings, mergeWithFrameworkDefaults, normalizeContainers, parseConfig, parseConfigRaw, parseGigadriveNextBuildManifest, parseGigadriveNextPrerenderManifest, parseStaticAssetManifest, postProcessConfig, readComposeContainers, readDependencies, rubyRuntimeForRequirement, rubyRuntimeForVersion, rubyRuntimeFromProjectFiles, splitCommandWords };