@gigadrive/network-config 4.3.7 → 4.4.0

package/dist/index.d.mts

@@ -231,7 +231,8 @@ interface NormalizedConfig {
     commands: string[];
     entrypoints: Array<NormalizedConfigEntrypoint>;
     routes: Array<NormalizedConfigRoute>;
-    services?: Array<NormalizedConfigService>;
+    /** Managed infrastructure declarations supplied through `gigadrive.yaml`. */
+    services?: NormalizedConfigService[];
     /**
      * Settings related to the archive the user uploads to the build workers.
      */
@@ -265,9 +266,13 @@ interface NormalizedConfig {
 interface NormalizedConfigService {
     type: NormalizedConfigServiceType;
 }
-type NormalizedConfigServiceType = 'redis' | 'postgres';
+/** Service kinds supported by the normalized deployment configuration. */
+type NormalizedConfigServiceType = 'redis' | 'postgres' | 'storage';
+/** Fully normalized managed-service declaration consumed by provisioning. */
+type NormalizedConfigServiceDefinition = NormalizedConfigServiceRedis | NormalizedConfigServicePostgres | NormalizedConfigServiceStorage;
 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';
 interface NormalizedConfigServiceRedis extends NormalizedConfigService {
+    type: 'redis';
     envBindings?: Record<'url' | 'host' | 'port' | 'password' | 'db' | 'ssl', string>;
     primaryRegion?: UpstashAWSRegion | 'us-central1';
     readRegions?: UpstashAWSRegion[];
@@ -275,10 +280,30 @@ interface NormalizedConfigServiceRedis extends NormalizedConfigService {
 }
 type NeonAWSRegion = 'us-east-1' | 'us-east-2' | 'us-west-2' | 'ap-southeast-1' | 'ap-southeast-2' | 'eu-central-1' | 'eu-west-2' | 'sa-east-1';
 interface NormalizedConfigServicePostgres extends NormalizedConfigService {
+    type: 'postgres';
     envBindings?: Record<'url' | 'host' | 'port' | 'user' | 'password' | 'database', string>;
     postgresVersion?: '17' | '16' | '15' | '14';
     region?: NeonAWSRegion;
 }
+/** Declarative File Storage service provisioned in the deployment environment. */
+interface NormalizedConfigServiceStorage extends NormalizedConfigService {
+    type: 'storage';
+    /**
+     * Buckets sorted by name for deterministic deployment plans.
+     *
+     * Names are preserved exactly after schema validation. The deployment
+     * environment is authoritative, and global CDN/S3 slugs are generated by
+     * the File Storage API rather than stored in configuration.
+     */
+    buckets: NormalizedConfigStorageBucket[];
+}
+/** Desired state for one environment-scoped File Storage bucket. */
+interface NormalizedConfigStorageBucket {
+    /** Immutable environment-scoped API and IaC identifier. */
+    name: string;
+    /** Access policy to apply when the bucket is first provisioned. */
+    visibility: 'public' | 'private';
+}
 /** Default maximum lifetime of one function invocation, in seconds. */
 declare const DEFAULT_FUNCTION_DURATION_SECONDS = 30;
 /** Maximum configurable lifetime of one function invocation, in seconds (eight hours). */
@@ -720,14 +745,81 @@ interface ConfigV4 extends Config {
      * Additional environment variables to set during runtime and build.
      */
     env?: Record<string, string>;
+    /** Declares managed services to provision for the deployment environment. */
+    services?: ConfigV4Services;
+}
+interface ConfigV4Service {
+}
+interface ConfigV4ServiceRedis extends ConfigV4Service {
     /**
-     * Optionally, specify additional services like databases to deploy.
+     * Optionally, specify what environment variables the credentials will be bound to.
+     * For example: `{ url: 'REDIS_URL' }` will bind the `url` environment variable to the Redis URL.
+     * If you don't specify any bindings, they will be bound to the REDIS_URL, REDIS_HOST, REDIS_PORT, REDIS_PASSWORD, REDIS_DB, and REDIS_SSL environment variables.
      */
-    services?: {
-        [type in NormalizedConfigServiceType]?: ConfigV4Service | null;
-    };
+    envBindings?: Record<'url' | 'host' | 'port' | 'password' | 'db' | 'ssl', string>;
+    /**
+     * The primary region to deploy the Redis instance to.
+     */
+    primaryRegion?: UpstashAWSRegion | 'us-central1';
+    /**
+     * Optionally, add additional regions to read from. More regions will incur higher costs.
+     */
+    readRegions?: UpstashAWSRegion[];
+    /**
+     * Optionally, enable Redis eviction. This will evict the least recently used keys in order to make space for new ones.
+     */
+    eviction?: boolean;
 }
-interface ConfigV4Service {
+interface ConfigV4ServicePostgres extends ConfigV4Service {
+    /**
+     * Optionally, specify what environment variables the credentials will be bound to.
+     * For example: `{ url: 'POSTGRES_URL' }` will bind the `url` environment variable to the Postgres URL.
+     * If you don't specify any bindings, they will be bound to the POSTGRES_URL, POSTGRES_HOST, POSTGRES_PORT, POSTGRES_USER, POSTGRES_PASSWORD, and POSTGRES_DATABASE environment variables.
+     */
+    envBindings?: Record<'url' | 'host' | 'port' | 'user' | 'password' | 'database', string>;
+    /**
+     * The version of Postgres to deploy.
+     */
+    postgresVersion?: '17' | '16' | '15' | '14';
+    /**
+     * The region to deploy the Postgres instance to.
+     */
+    region?: NeonAWSRegion;
+}
+/** Managed services accepted under the v4 `services` key. */
+interface ConfigV4Services {
+    /** Managed Redis configuration. `null` selects provider defaults. */
+    redis?: ConfigV4ServiceRedis | null;
+    /** Managed Postgres configuration. `null` selects provider defaults. */
+    postgres?: ConfigV4ServicePostgres | null;
+    /** Declarative File Storage buckets for the deployment environment. */
+    storage?: ConfigV4ServiceStorage;
+}
+/** Declarative File Storage configuration for one deployment environment. */
+interface ConfigV4ServiceStorage extends ConfigV4Service {
+    /**
+     * Buckets keyed by their immutable environment-scoped name.
+     *
+     * Use `null` or an empty object to accept the default private visibility.
+     * Names are validated exactly and are never normalized. The environment and
+     * global CDN/S3 slug are intentionally not configurable here.
+     *
+     * @example
+     * ```yaml
+     * services:
+     *   storage:
+     *     buckets:
+     *       assets:
+     *         visibility: public
+     *       uploads: null
+     * ```
+     */
+    buckets: Record<string, ConfigV4StorageBucket | null>;
+}
+/** Optional settings for a declaratively provisioned File Storage bucket. */
+interface ConfigV4StorageBucket {
+    /** Access policy applied when the bucket is first provisioned. Defaults to `private`. */
+    visibility?: 'public' | 'private';
 }
 interface ConfigV4FunctionSettings {
     /**
@@ -800,6 +892,7 @@ declare const V4ConfigParser_base: Effect.Service.Class<V4ConfigParser, "V4Confi
             environmentVariables: Record<string, string>;
             commands: string[];
             images: NormalizedImagePolicy | undefined;
+            services: NormalizedConfigServiceDefinition[] | undefined;
             entrypoints: NormalizedConfigEntrypoint[];
             errors: never[];
             warnings: never[];
@@ -843,6 +936,7 @@ declare const parseConfigRaw: (filePath: string, projectFolder: string) => Effec
     environmentVariables: Record<string, string>;
     commands: string[];
     images: NormalizedImagePolicy | undefined;
+    services: NormalizedConfigServiceDefinition[] | undefined;
     entrypoints: NormalizedConfigEntrypoint[];
     errors: never[];
     warnings: never[];
@@ -870,4 +964,4 @@ declare const postProcessConfig: (config: NormalizedConfig, projectFolder: strin
 
 declare const NetworkConfigLive: Layer.Layer<RawConfigReader | SchemaValidator | V4ConfigParser | VercelBuildOutputParser, never, _effect_platform_FileSystem.FileSystem | _effect_platform_Path.Path>;
 
-export { ALLOWED_CONFIG_NAMES, AVAILABLE_REGIONS, AVAILABLE_RUNTIMES, type Config, ConfigFileEmptyError, ConfigFileNotFoundError, ConfigFileParseError, ConfigSchemaValidationError, ConfigVersionError, DEFAULT_FUNCTION_DURATION_SECONDS, type DetectionResult, FRAMEWORK_DEFINITIONS, type FilePathMap, type FrameworkDefaultConfig, type FrameworkDefinition, type FrameworkDetectionItem, type FrameworkLanguage, FrameworkNotDetectedError, FunctionConfigError, type GigadriveNextBuildManifest, type GigadriveNextBuildManifestV1, type GigadriveNextBuildManifestV2, type GigadriveNextBuildManifestV2Export, type GigadriveNextBuildManifestV2Standalone, type GigadriveNextPrerenderOutput, type GigadriveNextServerDescriptor, type GigadriveNextStaticAssetPrefix, type JsonValue, MAX_FUNCTION_DURATION_SECONDS, ManifestNotFoundError, ManifestParseError, ManifestReadError, type NeonAWSRegion, NetworkConfigLive, type NormalizedConfig, type NormalizedConfigEntrypoint, type NormalizedConfigRoute, type NormalizedConfigRouteHandler, type NormalizedConfigRouteMatchRequirements, type NormalizedConfigRouteMethod, type NormalizedConfigService, type NormalizedConfigServicePostgres, type NormalizedConfigServiceRedis, type NormalizedConfigServiceType, type NormalizedFramework, type NormalizedImageFit, type NormalizedImageFormat, type NormalizedImageLocalPattern, type NormalizedImagePolicy, type NormalizedImageRemotePattern, type NormalizedImageVariant, type NormalizedNextjsFramework, type NormalizedSharedArtifact, type PackageManager, RawConfigReader, type Region, type Runtime, SchemaValidator, type UpstashAWSRegion, V4ConfigParser, VercelBuildOutputParser, detectFramework, detectPackageManager, filterFunctionsFromAssets, generateConfig, getFunctionSettings, mergeWithFrameworkDefaults, parseConfig, parseConfigRaw, parseGigadriveNextBuildManifest, postProcessConfig, readDependencies };
+export { ALLOWED_CONFIG_NAMES, AVAILABLE_REGIONS, AVAILABLE_RUNTIMES, type Config, ConfigFileEmptyError, ConfigFileNotFoundError, ConfigFileParseError, ConfigSchemaValidationError, type ConfigV4, type ConfigV4FunctionSettings, type ConfigV4Service, type ConfigV4ServicePostgres, type ConfigV4ServiceRedis, type ConfigV4ServiceStorage, type ConfigV4Services, type ConfigV4StorageBucket, ConfigVersionError, DEFAULT_FUNCTION_DURATION_SECONDS, type DetectionResult, FRAMEWORK_DEFINITIONS, type FilePathMap, type FrameworkDefaultConfig, type FrameworkDefinition, type FrameworkDetectionItem, type FrameworkLanguage, FrameworkNotDetectedError, FunctionConfigError, type GigadriveNextBuildManifest, type GigadriveNextBuildManifestV1, type GigadriveNextBuildManifestV2, type GigadriveNextBuildManifestV2Export, type GigadriveNextBuildManifestV2Standalone, type GigadriveNextPrerenderOutput, type GigadriveNextServerDescriptor, type GigadriveNextStaticAssetPrefix, type JsonValue, MAX_FUNCTION_DURATION_SECONDS, ManifestNotFoundError, ManifestParseError, ManifestReadError, type NeonAWSRegion, NetworkConfigLive, type NormalizedConfig, type NormalizedConfigEntrypoint, type NormalizedConfigRoute, type NormalizedConfigRouteHandler, type NormalizedConfigRouteMatchRequirements, type NormalizedConfigRouteMethod, type NormalizedConfigService, type NormalizedConfigServiceDefinition, type NormalizedConfigServicePostgres, type NormalizedConfigServiceRedis, type NormalizedConfigServiceStorage, type NormalizedConfigServiceType, type NormalizedConfigStorageBucket, type NormalizedFramework, type NormalizedImageFit, type NormalizedImageFormat, type NormalizedImageLocalPattern, type NormalizedImagePolicy, type NormalizedImageRemotePattern, type NormalizedImageVariant, type NormalizedNextjsFramework, type NormalizedSharedArtifact, type PackageManager, RawConfigReader, type Region, type Runtime, SchemaValidator, type UpstashAWSRegion, V4ConfigParser, VercelBuildOutputParser, detectFramework, detectPackageManager, filterFunctionsFromAssets, generateConfig, getFunctionSettings, mergeWithFrameworkDefaults, parseConfig, parseConfigRaw, parseGigadriveNextBuildManifest, postProcessConfig, readDependencies };

package/dist/index.d.ts

@@ -231,7 +231,8 @@ interface NormalizedConfig {
     commands: string[];
     entrypoints: Array<NormalizedConfigEntrypoint>;
     routes: Array<NormalizedConfigRoute>;
-    services?: Array<NormalizedConfigService>;
+    /** Managed infrastructure declarations supplied through `gigadrive.yaml`. */
+    services?: NormalizedConfigService[];
     /**
      * Settings related to the archive the user uploads to the build workers.
      */
@@ -265,9 +266,13 @@ interface NormalizedConfig {
 interface NormalizedConfigService {
     type: NormalizedConfigServiceType;
 }
-type NormalizedConfigServiceType = 'redis' | 'postgres';
+/** Service kinds supported by the normalized deployment configuration. */
+type NormalizedConfigServiceType = 'redis' | 'postgres' | 'storage';
+/** Fully normalized managed-service declaration consumed by provisioning. */
+type NormalizedConfigServiceDefinition = NormalizedConfigServiceRedis | NormalizedConfigServicePostgres | NormalizedConfigServiceStorage;
 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';
 interface NormalizedConfigServiceRedis extends NormalizedConfigService {
+    type: 'redis';
     envBindings?: Record<'url' | 'host' | 'port' | 'password' | 'db' | 'ssl', string>;
     primaryRegion?: UpstashAWSRegion | 'us-central1';
     readRegions?: UpstashAWSRegion[];
@@ -275,10 +280,30 @@ interface NormalizedConfigServiceRedis extends NormalizedConfigService {
 }
 type NeonAWSRegion = 'us-east-1' | 'us-east-2' | 'us-west-2' | 'ap-southeast-1' | 'ap-southeast-2' | 'eu-central-1' | 'eu-west-2' | 'sa-east-1';
 interface NormalizedConfigServicePostgres extends NormalizedConfigService {
+    type: 'postgres';
     envBindings?: Record<'url' | 'host' | 'port' | 'user' | 'password' | 'database', string>;
     postgresVersion?: '17' | '16' | '15' | '14';
     region?: NeonAWSRegion;
 }
+/** Declarative File Storage service provisioned in the deployment environment. */
+interface NormalizedConfigServiceStorage extends NormalizedConfigService {
+    type: 'storage';
+    /**
+     * Buckets sorted by name for deterministic deployment plans.
+     *
+     * Names are preserved exactly after schema validation. The deployment
+     * environment is authoritative, and global CDN/S3 slugs are generated by
+     * the File Storage API rather than stored in configuration.
+     */
+    buckets: NormalizedConfigStorageBucket[];
+}
+/** Desired state for one environment-scoped File Storage bucket. */
+interface NormalizedConfigStorageBucket {
+    /** Immutable environment-scoped API and IaC identifier. */
+    name: string;
+    /** Access policy to apply when the bucket is first provisioned. */
+    visibility: 'public' | 'private';
+}
 /** Default maximum lifetime of one function invocation, in seconds. */
 declare const DEFAULT_FUNCTION_DURATION_SECONDS = 30;
 /** Maximum configurable lifetime of one function invocation, in seconds (eight hours). */
@@ -720,14 +745,81 @@ interface ConfigV4 extends Config {
      * Additional environment variables to set during runtime and build.
      */
     env?: Record<string, string>;
+    /** Declares managed services to provision for the deployment environment. */
+    services?: ConfigV4Services;
+}
+interface ConfigV4Service {
+}
+interface ConfigV4ServiceRedis extends ConfigV4Service {
     /**
-     * Optionally, specify additional services like databases to deploy.
+     * Optionally, specify what environment variables the credentials will be bound to.
+     * For example: `{ url: 'REDIS_URL' }` will bind the `url` environment variable to the Redis URL.
+     * If you don't specify any bindings, they will be bound to the REDIS_URL, REDIS_HOST, REDIS_PORT, REDIS_PASSWORD, REDIS_DB, and REDIS_SSL environment variables.
      */
-    services?: {
-        [type in NormalizedConfigServiceType]?: ConfigV4Service | null;
-    };
+    envBindings?: Record<'url' | 'host' | 'port' | 'password' | 'db' | 'ssl', string>;
+    /**
+     * The primary region to deploy the Redis instance to.
+     */
+    primaryRegion?: UpstashAWSRegion | 'us-central1';
+    /**
+     * Optionally, add additional regions to read from. More regions will incur higher costs.
+     */
+    readRegions?: UpstashAWSRegion[];
+    /**
+     * Optionally, enable Redis eviction. This will evict the least recently used keys in order to make space for new ones.
+     */
+    eviction?: boolean;
 }
-interface ConfigV4Service {
+interface ConfigV4ServicePostgres extends ConfigV4Service {
+    /**
+     * Optionally, specify what environment variables the credentials will be bound to.
+     * For example: `{ url: 'POSTGRES_URL' }` will bind the `url` environment variable to the Postgres URL.
+     * If you don't specify any bindings, they will be bound to the POSTGRES_URL, POSTGRES_HOST, POSTGRES_PORT, POSTGRES_USER, POSTGRES_PASSWORD, and POSTGRES_DATABASE environment variables.
+     */
+    envBindings?: Record<'url' | 'host' | 'port' | 'user' | 'password' | 'database', string>;
+    /**
+     * The version of Postgres to deploy.
+     */
+    postgresVersion?: '17' | '16' | '15' | '14';
+    /**
+     * The region to deploy the Postgres instance to.
+     */
+    region?: NeonAWSRegion;
+}
+/** Managed services accepted under the v4 `services` key. */
+interface ConfigV4Services {
+    /** Managed Redis configuration. `null` selects provider defaults. */
+    redis?: ConfigV4ServiceRedis | null;
+    /** Managed Postgres configuration. `null` selects provider defaults. */
+    postgres?: ConfigV4ServicePostgres | null;
+    /** Declarative File Storage buckets for the deployment environment. */
+    storage?: ConfigV4ServiceStorage;
+}
+/** Declarative File Storage configuration for one deployment environment. */
+interface ConfigV4ServiceStorage extends ConfigV4Service {
+    /**
+     * Buckets keyed by their immutable environment-scoped name.
+     *
+     * Use `null` or an empty object to accept the default private visibility.
+     * Names are validated exactly and are never normalized. The environment and
+     * global CDN/S3 slug are intentionally not configurable here.
+     *
+     * @example
+     * ```yaml
+     * services:
+     *   storage:
+     *     buckets:
+     *       assets:
+     *         visibility: public
+     *       uploads: null
+     * ```
+     */
+    buckets: Record<string, ConfigV4StorageBucket | null>;
+}
+/** Optional settings for a declaratively provisioned File Storage bucket. */
+interface ConfigV4StorageBucket {
+    /** Access policy applied when the bucket is first provisioned. Defaults to `private`. */
+    visibility?: 'public' | 'private';
 }
 interface ConfigV4FunctionSettings {
     /**
@@ -800,6 +892,7 @@ declare const V4ConfigParser_base: Effect.Service.Class<V4ConfigParser, "V4Confi
             environmentVariables: Record<string, string>;
             commands: string[];
             images: NormalizedImagePolicy | undefined;
+            services: NormalizedConfigServiceDefinition[] | undefined;
             entrypoints: NormalizedConfigEntrypoint[];
             errors: never[];
             warnings: never[];
@@ -843,6 +936,7 @@ declare const parseConfigRaw: (filePath: string, projectFolder: string) => Effec
     environmentVariables: Record<string, string>;
     commands: string[];
     images: NormalizedImagePolicy | undefined;
+    services: NormalizedConfigServiceDefinition[] | undefined;
     entrypoints: NormalizedConfigEntrypoint[];
     errors: never[];
     warnings: never[];
@@ -870,4 +964,4 @@ declare const postProcessConfig: (config: NormalizedConfig, projectFolder: strin
 
 declare const NetworkConfigLive: Layer.Layer<RawConfigReader | SchemaValidator | V4ConfigParser | VercelBuildOutputParser, never, _effect_platform_FileSystem.FileSystem | _effect_platform_Path.Path>;
 
-export { ALLOWED_CONFIG_NAMES, AVAILABLE_REGIONS, AVAILABLE_RUNTIMES, type Config, ConfigFileEmptyError, ConfigFileNotFoundError, ConfigFileParseError, ConfigSchemaValidationError, ConfigVersionError, DEFAULT_FUNCTION_DURATION_SECONDS, type DetectionResult, FRAMEWORK_DEFINITIONS, type FilePathMap, type FrameworkDefaultConfig, type FrameworkDefinition, type FrameworkDetectionItem, type FrameworkLanguage, FrameworkNotDetectedError, FunctionConfigError, type GigadriveNextBuildManifest, type GigadriveNextBuildManifestV1, type GigadriveNextBuildManifestV2, type GigadriveNextBuildManifestV2Export, type GigadriveNextBuildManifestV2Standalone, type GigadriveNextPrerenderOutput, type GigadriveNextServerDescriptor, type GigadriveNextStaticAssetPrefix, type JsonValue, MAX_FUNCTION_DURATION_SECONDS, ManifestNotFoundError, ManifestParseError, ManifestReadError, type NeonAWSRegion, NetworkConfigLive, type NormalizedConfig, type NormalizedConfigEntrypoint, type NormalizedConfigRoute, type NormalizedConfigRouteHandler, type NormalizedConfigRouteMatchRequirements, type NormalizedConfigRouteMethod, type NormalizedConfigService, type NormalizedConfigServicePostgres, type NormalizedConfigServiceRedis, type NormalizedConfigServiceType, type NormalizedFramework, type NormalizedImageFit, type NormalizedImageFormat, type NormalizedImageLocalPattern, type NormalizedImagePolicy, type NormalizedImageRemotePattern, type NormalizedImageVariant, type NormalizedNextjsFramework, type NormalizedSharedArtifact, type PackageManager, RawConfigReader, type Region, type Runtime, SchemaValidator, type UpstashAWSRegion, V4ConfigParser, VercelBuildOutputParser, detectFramework, detectPackageManager, filterFunctionsFromAssets, generateConfig, getFunctionSettings, mergeWithFrameworkDefaults, parseConfig, parseConfigRaw, parseGigadriveNextBuildManifest, postProcessConfig, readDependencies };
+export { ALLOWED_CONFIG_NAMES, AVAILABLE_REGIONS, AVAILABLE_RUNTIMES, type Config, ConfigFileEmptyError, ConfigFileNotFoundError, ConfigFileParseError, ConfigSchemaValidationError, type ConfigV4, type ConfigV4FunctionSettings, type ConfigV4Service, type ConfigV4ServicePostgres, type ConfigV4ServiceRedis, type ConfigV4ServiceStorage, type ConfigV4Services, type ConfigV4StorageBucket, ConfigVersionError, DEFAULT_FUNCTION_DURATION_SECONDS, type DetectionResult, FRAMEWORK_DEFINITIONS, type FilePathMap, type FrameworkDefaultConfig, type FrameworkDefinition, type FrameworkDetectionItem, type FrameworkLanguage, FrameworkNotDetectedError, FunctionConfigError, type GigadriveNextBuildManifest, type GigadriveNextBuildManifestV1, type GigadriveNextBuildManifestV2, type GigadriveNextBuildManifestV2Export, type GigadriveNextBuildManifestV2Standalone, type GigadriveNextPrerenderOutput, type GigadriveNextServerDescriptor, type GigadriveNextStaticAssetPrefix, type JsonValue, MAX_FUNCTION_DURATION_SECONDS, ManifestNotFoundError, ManifestParseError, ManifestReadError, type NeonAWSRegion, NetworkConfigLive, type NormalizedConfig, type NormalizedConfigEntrypoint, type NormalizedConfigRoute, type NormalizedConfigRouteHandler, type NormalizedConfigRouteMatchRequirements, type NormalizedConfigRouteMethod, type NormalizedConfigService, type NormalizedConfigServiceDefinition, type NormalizedConfigServicePostgres, type NormalizedConfigServiceRedis, type NormalizedConfigServiceStorage, type NormalizedConfigServiceType, type NormalizedConfigStorageBucket, type NormalizedFramework, type NormalizedImageFit, type NormalizedImageFormat, type NormalizedImageLocalPattern, type NormalizedImagePolicy, type NormalizedImageRemotePattern, type NormalizedImageVariant, type NormalizedNextjsFramework, type NormalizedSharedArtifact, type PackageManager, RawConfigReader, type Region, type Runtime, SchemaValidator, type UpstashAWSRegion, V4ConfigParser, VercelBuildOutputParser, detectFramework, detectPackageManager, filterFunctionsFromAssets, generateConfig, getFunctionSettings, mergeWithFrameworkDefaults, parseConfig, parseConfigRaw, parseGigadriveNextBuildManifest, postProcessConfig, readDependencies };

package/dist/index.js

@@ -1266,6 +1266,23 @@ var normalizeImagePolicy = (images) => {
     variants: images.variants ?? {}
   };
 };
+var normalizeServices = (services) => {
+  if (services == null) return void 0;
+  const normalized = [];
+  if (services.redis !== void 0) {
+    normalized.push({ type: "redis", ...services.redis ?? {} });
+  }
+  if (services.postgres !== void 0) {
+    normalized.push({ type: "postgres", ...services.postgres ?? {} });
+  }
+  if (services.storage !== void 0) {
+    normalized.push({
+      type: "storage",
+      buckets: Object.entries(services.storage.buckets).map(([name, bucket]) => ({ name, visibility: bucket?.visibility ?? "private" })).sort((left, right) => left.name < right.name ? -1 : left.name > right.name ? 1 : 0)
+    });
+  }
+  return normalized.length > 0 ? normalized : void 0;
+};
 var normalizeRouteDestination = (destination) => {
   const [withoutHash] = destination.split("#", 1);
   const [withoutQuery] = withoutHash.split("?", 1);
@@ -1429,6 +1446,7 @@ var V4ConfigParser = class extends import_effect15.Effect.Service()("V4ConfigPar
         environmentVariables: config.env ?? {},
         commands: config.build_commands ?? [],
         images: normalizeImagePolicy(config.images),
+        services: normalizeServices(config.services),
         entrypoints,
         errors: [],
         warnings: [],
@@ -1946,7 +1964,8 @@ var schema_default = {
     },
     services: {
       type: "object",
-      description: "Optionally, specify additional services like databases to deploy.",
+      description: "Managed services to provision for the deployment environment.",
+      additionalProperties: false,
       properties: {
         redis: {
           oneOf: [
@@ -2060,6 +2079,39 @@ var schema_default = {
               }
             }
           ]
+        },
+        storage: {
+          type: "object",
+          required: ["buckets"],
+          additionalProperties: false,
+          description: "File Storage buckets to provision in the deployment environment. The environment and global delivery/S3 slug are assigned by the platform.",
+          properties: {
+            buckets: {
+              type: "object",
+              description: "Buckets keyed by immutable environment-scoped name. Use null or an empty object for the default private visibility.",
+              propertyNames: {
+                minLength: 3,
+                maxLength: 63,
+                pattern: "^(?![0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$"
+              },
+              additionalProperties: {
+                oneOf: [
+                  { type: "null" },
+                  {
+                    type: "object",
+                    additionalProperties: false,
+                    properties: {
+                      visibility: {
+                        type: "string",
+                        enum: ["public", "private"],
+                        description: "Bucket access policy. Defaults to private when omitted. Public buckets can serve objects through their CDN hostname."
+                      }
+                    }
+                  }
+                ]
+              }
+            }
+          }
         }
       }
     }