@gigadrive/network-config 4.3.7 → 4.5.0

package/dist/index.d.ts

@@ -1,8 +1,40 @@
+import { Schema, Effect, Layer } from 'effect';
 import { FileSystem, Path } from '@effect/platform';
-import { Effect, Schema, Layer } from 'effect';
 import * as _effect_platform_Path from '@effect/platform/Path';
 import * as _effect_platform_FileSystem from '@effect/platform/FileSystem';
 
+declare const StaticAssetHeadersSchema: Schema.filter<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.Union<[Schema.filter<typeof Schema.String>, Schema.mutable<Schema.Array$<Schema.filter<typeof Schema.String>>>]>>>>;
+type StaticAssetHeaders = Schema.Schema.Type<typeof StaticAssetHeadersSchema>;
+/** One logical static asset whose source is relative to the project root. */
+declare const StaticAssetManifestEntrySchema: Schema.mutable<Schema.Struct<{
+    source: Schema.filter<typeof Schema.String>;
+    path: Schema.filter<typeof Schema.String>;
+    status: Schema.optional<Schema.filter<typeof Schema.Int>>;
+    headers: Schema.optional<Schema.filter<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.Union<[Schema.filter<typeof Schema.String>, Schema.mutable<Schema.Array$<Schema.filter<typeof Schema.String>>>]>>>>>;
+    immutable: Schema.optional<typeof Schema.Boolean>;
+}>>;
+type StaticAssetManifestEntry = Schema.Schema.Type<typeof StaticAssetManifestEntrySchema>;
+/** Portable manifest for declaring many logical assets without expanding deployment configuration. */
+declare const StaticAssetManifestV1Schema: Schema.filter<Schema.mutable<Schema.Struct<{
+    version: Schema.Literal<[1]>;
+    assets: Schema.mutable<Schema.Array$<Schema.mutable<Schema.Struct<{
+        source: Schema.filter<typeof Schema.String>;
+        path: Schema.filter<typeof Schema.String>;
+        status: Schema.optional<Schema.filter<typeof Schema.Int>>;
+        headers: Schema.optional<Schema.filter<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.Union<[Schema.filter<typeof Schema.String>, Schema.mutable<Schema.Array$<Schema.filter<typeof Schema.String>>>]>>>>>;
+        immutable: Schema.optional<typeof Schema.Boolean>;
+    }>>>>;
+}>>>;
+type StaticAssetManifestV1 = Schema.Schema.Type<typeof StaticAssetManifestV1Schema>;
+type StaticAssetManifest = StaticAssetManifestV1;
+/**
+ * Parses and validates a portable static asset manifest.
+ *
+ * @param content JSON manifest content.
+ * @returns The validated manifest, or `undefined` when malformed.
+ */
+declare const parseStaticAssetManifest: (content: string) => StaticAssetManifest | undefined;
+
 interface NormalizedImageLocalPattern {
     pathname?: string;
     search?: string;
@@ -41,112 +73,255 @@ interface NormalizedImagePolicy {
 type JsonValue = null | boolean | number | string | JsonValue[] | {
     [key: string]: JsonValue;
 };
-interface GigadriveNextPrerenderOutput {
-    id: string;
-    type: 'PRERENDER';
-    pathname: string;
-    parentOutputId: string;
-    groupId: number;
-    pprChain?: {
-        headers: Record<string, string>;
-    };
-    parentFallbackMode?: JsonValue;
-    fallback?: {
-        filePath?: string;
-        initialStatus?: number;
-        initialHeaders?: Record<string, string | string[]>;
-        initialExpiration?: number;
-        initialRevalidate?: number | false;
-        postponedState?: string;
-    };
-    config: {
-        allowQuery?: string[];
-        allowHeader?: string[];
-        bypassFor?: JsonValue[];
-        renderingMode?: string;
-        partialFallback?: boolean;
-        bypassToken?: string;
-    };
-}
-/**
- * A directory subtree published under a single URL prefix, registered as one
- * descriptor instead of enumerating every file. Used to collapse `.next/static`
- * (thousands of content-hashed chunks) into a single edge-served prefix.
- */
-interface GigadriveNextStaticAssetPrefix {
-    /** Project-relative source directory (e.g. `.next/static`). */
-    sourceDir: string;
-    /** Public URL prefix the subtree is served under (e.g. `_next/static`). */
-    urlPrefix: string;
-    /** Entries are content-hashed and safe to serve with immutable cache-control. */
-    immutable: boolean;
-}
-interface GigadriveNextBuildManifestV1 {
-    version: 1;
-    output: 'standalone' | 'export';
-    distDir: string;
-    repoRootToProject: string;
-    nextVersion: string;
-    buildId: string;
-}
-/** Aggregated runtime configuration collapsed onto the single standalone server. */
-interface GigadriveNextServerDescriptor {
-    maxDuration?: number;
-    preferredRegion?: string | string[];
-    env?: Record<string, string>;
-}
-/**
- * Portable runtime plan for the single standalone Next.js server (Next >= 16.2).
- *
- * The whole deployment runs as one `next start` standalone server, so the plan
- * carries only what the platform needs to route around it: prerender/ISR/PPR
- * seeds, the `.next/static` prefix, and the routing/image configuration. It
- * deliberately omits per-route outputs and entrypoints — the server owns
- * routing, middleware, edge routes, and PPR resume in-process.
- */
-interface GigadriveNextBuildManifestV2Standalone {
-    version: 2;
-    mode: 'standalone-v2';
-    distDir: string;
-    repoRootToProject: string;
-    nextVersion: string;
-    buildId: string;
-    server: GigadriveNextServerDescriptor;
-    config: {
-        basePath: string;
-        trailingSlash: boolean;
-        cacheComponents: boolean;
-        i18n?: JsonValue;
-        images?: NormalizedImagePolicy;
-    };
-    routing: {
-        beforeMiddleware: JsonValue[];
-        beforeFiles: JsonValue[];
-        afterFiles: JsonValue[];
-        dynamicRoutes: JsonValue[];
-        onMatch: JsonValue[];
-        fallback: JsonValue[];
-        shouldNormalizeNextData: boolean;
-        rsc: JsonValue;
-    };
-    outputs: {
-        prerenders: GigadriveNextPrerenderOutput[];
-        staticAssets: GigadriveNextStaticAssetPrefix[];
-    };
-}
-/** Minimal plan for static-export builds (Next >= 16.2). */
-interface GigadriveNextBuildManifestV2Export {
-    version: 2;
-    mode: 'export';
-    distDir: string;
-    repoRootToProject: string;
-    nextVersion: string;
-    buildId: string;
-}
+declare const GigadriveNextPrerenderOutputSchema: Schema.mutable<Schema.Struct<{
+    id: typeof Schema.String;
+    type: Schema.Literal<["PRERENDER"]>;
+    pathname: Schema.filter<typeof Schema.String>;
+    parentOutputId: typeof Schema.String;
+    groupId: typeof Schema.Number;
+    pprChain: Schema.optional<Schema.mutable<Schema.Struct<{
+        headers: Schema.filter<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.filter<typeof Schema.String>>>>;
+    }>>>;
+    parentFallbackMode: Schema.optional<Schema.Schema<JsonValue, JsonValue, never>>;
+    fallback: Schema.optional<Schema.mutable<Schema.Struct<{
+        filePath: Schema.optional<Schema.filter<typeof Schema.String>>;
+        initialStatus: Schema.optional<Schema.filter<typeof Schema.Int>>;
+        initialHeaders: Schema.optional<Schema.filter<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.Union<[Schema.filter<typeof Schema.String>, Schema.mutable<Schema.Array$<Schema.filter<typeof Schema.String>>>]>>>>>;
+        initialExpiration: Schema.optional<typeof Schema.Number>;
+        initialRevalidate: Schema.optional<Schema.Union<[typeof Schema.Number, Schema.Literal<[false]>]>>;
+        postponedState: Schema.optional<typeof Schema.String>;
+    }>>>;
+    config: Schema.mutable<Schema.Struct<{
+        allowQuery: Schema.optional<Schema.mutable<Schema.Array$<typeof Schema.String>>>;
+        allowHeader: Schema.optional<Schema.mutable<Schema.Array$<typeof Schema.String>>>;
+        bypassFor: Schema.optional<Schema.mutable<Schema.Array$<Schema.Schema<JsonValue, JsonValue, never>>>>;
+        renderingMode: Schema.optional<typeof Schema.String>;
+        partialFallback: Schema.optional<typeof Schema.Boolean>;
+        bypassToken: Schema.optional<typeof Schema.String>;
+    }>>;
+}>>;
+type GigadriveNextPrerenderOutput = Schema.Schema.Type<typeof GigadriveNextPrerenderOutputSchema>;
+/** A directory subtree published under one URL prefix. */
+declare const GigadriveNextStaticAssetPrefixSchema: Schema.mutable<Schema.Struct<{
+    sourceDir: Schema.filter<typeof Schema.String>;
+    urlPrefix: Schema.filter<typeof Schema.String>;
+    immutable: typeof Schema.Boolean;
+}>>;
+type GigadriveNextStaticAssetPrefix = Schema.Schema.Type<typeof GigadriveNextStaticAssetPrefixSchema>;
+/** Aggregated runtime configuration for the standalone server. */
+declare const GigadriveNextServerDescriptorSchema: Schema.mutable<Schema.Struct<{
+    maxDuration: Schema.optional<typeof Schema.Number>;
+    preferredRegion: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Array$<typeof Schema.String>>]>>;
+    env: Schema.optional<Schema.mutable<Schema.Record$<typeof Schema.String, typeof Schema.String>>>;
+}>>;
+type GigadriveNextServerDescriptor = Schema.Schema.Type<typeof GigadriveNextServerDescriptorSchema>;
+declare const GigadriveNextBuildManifestV1Schema: Schema.mutable<Schema.Struct<{
+    version: Schema.Literal<[1]>;
+    output: Schema.Literal<["standalone", "export"]>;
+    distDir: Schema.filter<typeof Schema.String>;
+    repoRootToProject: Schema.filter<typeof Schema.String>;
+    nextVersion: typeof Schema.String;
+    buildId: typeof Schema.String;
+}>>;
+type GigadriveNextBuildManifestV1 = Schema.Schema.Type<typeof GigadriveNextBuildManifestV1Schema>;
+/** Minimal plan for static-export builds. */
+declare const GigadriveNextBuildManifestV2ExportSchema: Schema.mutable<Schema.Struct<{
+    version: Schema.Literal<[2]>;
+    mode: Schema.Literal<["export"]>;
+    distDir: Schema.filter<typeof Schema.String>;
+    repoRootToProject: Schema.filter<typeof Schema.String>;
+    nextVersion: typeof Schema.String;
+    buildId: typeof Schema.String;
+}>>;
+type GigadriveNextBuildManifestV2Export = Schema.Schema.Type<typeof GigadriveNextBuildManifestV2ExportSchema>;
+/** Portable runtime plan for a standalone Next.js server. */
+declare const GigadriveNextBuildManifestV2StandaloneSchema: Schema.mutable<Schema.Struct<{
+    version: Schema.Literal<[2]>;
+    mode: Schema.Literal<["standalone-v2"]>;
+    distDir: Schema.filter<typeof Schema.String>;
+    repoRootToProject: Schema.filter<typeof Schema.String>;
+    nextVersion: typeof Schema.String;
+    buildId: typeof Schema.String;
+    server: Schema.mutable<Schema.Struct<{
+        maxDuration: Schema.optional<typeof Schema.Number>;
+        preferredRegion: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Array$<typeof Schema.String>>]>>;
+        env: Schema.optional<Schema.mutable<Schema.Record$<typeof Schema.String, typeof Schema.String>>>;
+    }>>;
+    config: Schema.mutable<Schema.Struct<{
+        basePath: typeof Schema.String;
+        trailingSlash: typeof Schema.Boolean;
+        cacheComponents: typeof Schema.Boolean;
+        i18n: Schema.optional<Schema.Schema<JsonValue, JsonValue, never>>;
+        images: Schema.optional<Schema.Schema<NormalizedImagePolicy, NormalizedImagePolicy, never>>;
+    }>>;
+    routing: Schema.mutable<Schema.Struct<{
+        beforeMiddleware: Schema.mutable<Schema.Array$<Schema.Schema<JsonValue, JsonValue, never>>>;
+        beforeFiles: Schema.mutable<Schema.Array$<Schema.Schema<JsonValue, JsonValue, never>>>;
+        afterFiles: Schema.mutable<Schema.Array$<Schema.Schema<JsonValue, JsonValue, never>>>;
+        dynamicRoutes: Schema.mutable<Schema.Array$<Schema.Schema<JsonValue, JsonValue, never>>>;
+        onMatch: Schema.mutable<Schema.Array$<Schema.Schema<JsonValue, JsonValue, never>>>;
+        fallback: Schema.mutable<Schema.Array$<Schema.Schema<JsonValue, JsonValue, never>>>;
+        shouldNormalizeNextData: typeof Schema.Boolean;
+        rsc: Schema.Schema<JsonValue, JsonValue, never>;
+    }>>;
+    outputs: Schema.mutable<Schema.Struct<{
+        prerenders: Schema.mutable<Schema.Array$<Schema.mutable<Schema.Struct<{
+            id: typeof Schema.String;
+            type: Schema.Literal<["PRERENDER"]>;
+            pathname: Schema.filter<typeof Schema.String>;
+            parentOutputId: typeof Schema.String;
+            groupId: typeof Schema.Number;
+            pprChain: Schema.optional<Schema.mutable<Schema.Struct<{
+                headers: Schema.filter<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.filter<typeof Schema.String>>>>;
+            }>>>;
+            parentFallbackMode: Schema.optional<Schema.Schema<JsonValue, JsonValue, never>>;
+            fallback: Schema.optional<Schema.mutable<Schema.Struct<{
+                filePath: Schema.optional<Schema.filter<typeof Schema.String>>;
+                initialStatus: Schema.optional<Schema.filter<typeof Schema.Int>>;
+                initialHeaders: Schema.optional<Schema.filter<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.Union<[Schema.filter<typeof Schema.String>, Schema.mutable<Schema.Array$<Schema.filter<typeof Schema.String>>>]>>>>>;
+                initialExpiration: Schema.optional<typeof Schema.Number>;
+                initialRevalidate: Schema.optional<Schema.Union<[typeof Schema.Number, Schema.Literal<[false]>]>>;
+                postponedState: Schema.optional<typeof Schema.String>;
+            }>>>;
+            config: Schema.mutable<Schema.Struct<{
+                allowQuery: Schema.optional<Schema.mutable<Schema.Array$<typeof Schema.String>>>;
+                allowHeader: Schema.optional<Schema.mutable<Schema.Array$<typeof Schema.String>>>;
+                bypassFor: Schema.optional<Schema.mutable<Schema.Array$<Schema.Schema<JsonValue, JsonValue, never>>>>;
+                renderingMode: Schema.optional<typeof Schema.String>;
+                partialFallback: Schema.optional<typeof Schema.Boolean>;
+                bypassToken: Schema.optional<typeof Schema.String>;
+            }>>;
+        }>>>>;
+        prerenderManifest: Schema.optional<Schema.filter<typeof Schema.String>>;
+        assetManifest: Schema.optional<Schema.filter<typeof Schema.String>>;
+        entryPagePaths: Schema.optional<Schema.mutable<Schema.Array$<Schema.filter<typeof Schema.String>>>>;
+        staticAssets: Schema.mutable<Schema.Array$<Schema.mutable<Schema.Struct<{
+            sourceDir: Schema.filter<typeof Schema.String>;
+            urlPrefix: Schema.filter<typeof Schema.String>;
+            immutable: typeof Schema.Boolean;
+        }>>>>;
+    }>>;
+}>>;
+type GigadriveNextBuildManifestV2Standalone = Schema.Schema.Type<typeof GigadriveNextBuildManifestV2StandaloneSchema>;
+declare const GigadriveNextBuildManifestSchema: Schema.Union<[Schema.mutable<Schema.Struct<{
+    version: Schema.Literal<[1]>;
+    output: Schema.Literal<["standalone", "export"]>;
+    distDir: Schema.filter<typeof Schema.String>;
+    repoRootToProject: Schema.filter<typeof Schema.String>;
+    nextVersion: typeof Schema.String;
+    buildId: typeof Schema.String;
+}>>, Schema.mutable<Schema.Struct<{
+    version: Schema.Literal<[2]>;
+    mode: Schema.Literal<["export"]>;
+    distDir: Schema.filter<typeof Schema.String>;
+    repoRootToProject: Schema.filter<typeof Schema.String>;
+    nextVersion: typeof Schema.String;
+    buildId: typeof Schema.String;
+}>>, Schema.mutable<Schema.Struct<{
+    version: Schema.Literal<[2]>;
+    mode: Schema.Literal<["standalone-v2"]>;
+    distDir: Schema.filter<typeof Schema.String>;
+    repoRootToProject: Schema.filter<typeof Schema.String>;
+    nextVersion: typeof Schema.String;
+    buildId: typeof Schema.String;
+    server: Schema.mutable<Schema.Struct<{
+        maxDuration: Schema.optional<typeof Schema.Number>;
+        preferredRegion: Schema.optional<Schema.Union<[typeof Schema.String, Schema.mutable<Schema.Array$<typeof Schema.String>>]>>;
+        env: Schema.optional<Schema.mutable<Schema.Record$<typeof Schema.String, typeof Schema.String>>>;
+    }>>;
+    config: Schema.mutable<Schema.Struct<{
+        basePath: typeof Schema.String;
+        trailingSlash: typeof Schema.Boolean;
+        cacheComponents: typeof Schema.Boolean;
+        i18n: Schema.optional<Schema.Schema<JsonValue, JsonValue, never>>;
+        images: Schema.optional<Schema.Schema<NormalizedImagePolicy, NormalizedImagePolicy, never>>;
+    }>>;
+    routing: Schema.mutable<Schema.Struct<{
+        beforeMiddleware: Schema.mutable<Schema.Array$<Schema.Schema<JsonValue, JsonValue, never>>>;
+        beforeFiles: Schema.mutable<Schema.Array$<Schema.Schema<JsonValue, JsonValue, never>>>;
+        afterFiles: Schema.mutable<Schema.Array$<Schema.Schema<JsonValue, JsonValue, never>>>;
+        dynamicRoutes: Schema.mutable<Schema.Array$<Schema.Schema<JsonValue, JsonValue, never>>>;
+        onMatch: Schema.mutable<Schema.Array$<Schema.Schema<JsonValue, JsonValue, never>>>;
+        fallback: Schema.mutable<Schema.Array$<Schema.Schema<JsonValue, JsonValue, never>>>;
+        shouldNormalizeNextData: typeof Schema.Boolean;
+        rsc: Schema.Schema<JsonValue, JsonValue, never>;
+    }>>;
+    outputs: Schema.mutable<Schema.Struct<{
+        prerenders: Schema.mutable<Schema.Array$<Schema.mutable<Schema.Struct<{
+            id: typeof Schema.String;
+            type: Schema.Literal<["PRERENDER"]>;
+            pathname: Schema.filter<typeof Schema.String>;
+            parentOutputId: typeof Schema.String;
+            groupId: typeof Schema.Number;
+            pprChain: Schema.optional<Schema.mutable<Schema.Struct<{
+                headers: Schema.filter<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.filter<typeof Schema.String>>>>;
+            }>>>;
+            parentFallbackMode: Schema.optional<Schema.Schema<JsonValue, JsonValue, never>>;
+            fallback: Schema.optional<Schema.mutable<Schema.Struct<{
+                filePath: Schema.optional<Schema.filter<typeof Schema.String>>;
+                initialStatus: Schema.optional<Schema.filter<typeof Schema.Int>>;
+                initialHeaders: Schema.optional<Schema.filter<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.Union<[Schema.filter<typeof Schema.String>, Schema.mutable<Schema.Array$<Schema.filter<typeof Schema.String>>>]>>>>>;
+                initialExpiration: Schema.optional<typeof Schema.Number>;
+                initialRevalidate: Schema.optional<Schema.Union<[typeof Schema.Number, Schema.Literal<[false]>]>>;
+                postponedState: Schema.optional<typeof Schema.String>;
+            }>>>;
+            config: Schema.mutable<Schema.Struct<{
+                allowQuery: Schema.optional<Schema.mutable<Schema.Array$<typeof Schema.String>>>;
+                allowHeader: Schema.optional<Schema.mutable<Schema.Array$<typeof Schema.String>>>;
+                bypassFor: Schema.optional<Schema.mutable<Schema.Array$<Schema.Schema<JsonValue, JsonValue, never>>>>;
+                renderingMode: Schema.optional<typeof Schema.String>;
+                partialFallback: Schema.optional<typeof Schema.Boolean>;
+                bypassToken: Schema.optional<typeof Schema.String>;
+            }>>;
+        }>>>>;
+        prerenderManifest: Schema.optional<Schema.filter<typeof Schema.String>>;
+        assetManifest: Schema.optional<Schema.filter<typeof Schema.String>>;
+        entryPagePaths: Schema.optional<Schema.mutable<Schema.Array$<Schema.filter<typeof Schema.String>>>>;
+        staticAssets: Schema.mutable<Schema.Array$<Schema.mutable<Schema.Struct<{
+            sourceDir: Schema.filter<typeof Schema.String>;
+            urlPrefix: Schema.filter<typeof Schema.String>;
+            immutable: typeof Schema.Boolean;
+        }>>>>;
+    }>>;
+}>>]>;
 type GigadriveNextBuildManifestV2 = GigadriveNextBuildManifestV2Standalone | GigadriveNextBuildManifestV2Export;
-type GigadriveNextBuildManifest = GigadriveNextBuildManifestV1 | GigadriveNextBuildManifestV2;
+type GigadriveNextBuildManifest = Schema.Schema.Type<typeof GigadriveNextBuildManifestSchema>;
+/** Portable sidecar containing high-cardinality Next.js prerender metadata. */
+declare const GigadriveNextPrerenderManifestV1Schema: Schema.mutable<Schema.Struct<{
+    version: Schema.Literal<[1]>;
+    prerenders: Schema.mutable<Schema.Array$<Schema.mutable<Schema.Struct<{
+        id: typeof Schema.String;
+        type: Schema.Literal<["PRERENDER"]>;
+        pathname: Schema.filter<typeof Schema.String>;
+        parentOutputId: typeof Schema.String;
+        groupId: typeof Schema.Number;
+        pprChain: Schema.optional<Schema.mutable<Schema.Struct<{
+            headers: Schema.filter<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.filter<typeof Schema.String>>>>;
+        }>>>;
+        parentFallbackMode: Schema.optional<Schema.Schema<JsonValue, JsonValue, never>>;
+        fallback: Schema.optional<Schema.mutable<Schema.Struct<{
+            filePath: Schema.optional<Schema.filter<typeof Schema.String>>;
+            initialStatus: Schema.optional<Schema.filter<typeof Schema.Int>>;
+            initialHeaders: Schema.optional<Schema.filter<Schema.mutable<Schema.Record$<typeof Schema.String, Schema.Union<[Schema.filter<typeof Schema.String>, Schema.mutable<Schema.Array$<Schema.filter<typeof Schema.String>>>]>>>>>;
+            initialExpiration: Schema.optional<typeof Schema.Number>;
+            initialRevalidate: Schema.optional<Schema.Union<[typeof Schema.Number, Schema.Literal<[false]>]>>;
+            postponedState: Schema.optional<typeof Schema.String>;
+        }>>>;
+        config: Schema.mutable<Schema.Struct<{
+            allowQuery: Schema.optional<Schema.mutable<Schema.Array$<typeof Schema.String>>>;
+            allowHeader: Schema.optional<Schema.mutable<Schema.Array$<typeof Schema.String>>>;
+            bypassFor: Schema.optional<Schema.mutable<Schema.Array$<Schema.Schema<JsonValue, JsonValue, never>>>>;
+            renderingMode: Schema.optional<typeof Schema.String>;
+            partialFallback: Schema.optional<typeof Schema.Boolean>;
+            bypassToken: Schema.optional<typeof Schema.String>;
+        }>>;
+    }>>>>;
+}>>;
+type GigadriveNextPrerenderManifestV1 = Schema.Schema.Type<typeof GigadriveNextPrerenderManifestV1Schema>;
 /** Parses and structurally validates adapter metadata before deployment code consumes it. */
 declare const parseGigadriveNextBuildManifest: (content: string) => GigadriveNextBuildManifest | undefined;
+/** Parses and validates a portable Next.js prerender sidecar. */
+declare const parseGigadriveNextPrerenderManifest: (content: string) => GigadriveNextPrerenderManifestV1 | undefined;
 
 declare const REGION_DEFINITIONS: readonly ["us-east-1", "us-east-2", "us-west-1", "us-west-2", "ap-south-1", "ap-northeast-3", "ap-northeast-2", "ap-southeast-1", "ap-southeast-2", "ap-northeast-1", "ca-central-1", "eu-central-1", "eu-west-1", "eu-west-2", "eu-west-3", "eu-north-1", "sa-east-1"];
 type Region = (typeof REGION_DEFINITIONS)[number];
@@ -206,6 +381,14 @@ interface NormalizedConfig {
             /** Optional Content-Type override applied to the whole subtree. */
             contentType?: string;
         }>;
+        /**
+         * Project-relative manifests containing logical static asset entries. A
+         * manifest keeps high-cardinality path mappings out of this configuration.
+         */
+        manifests?: Array<{
+            /** Project-relative path to a {@link StaticAssetManifest}. */
+            source: string;
+        }>;
         /**
          * Whether routes for the assets should be generated during deployment.
          */
@@ -231,7 +414,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 +449,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 +463,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). */
@@ -321,7 +529,8 @@ type NormalizedFramework = NormalizedNextjsFramework;
  * discriminators. The whole deployment runs as one standalone server, so this
  * carries prerender/routing/image metadata but no per-route entrypoints.
  */
-type NormalizedNextjsFramework = Omit<GigadriveNextBuildManifestV2Standalone, 'version'> & {
+type NormalizedNextjsFramework = Omit<GigadriveNextBuildManifestV2Standalone, 'version' | 'outputs'> & {
+    outputs: Omit<GigadriveNextBuildManifestV2Standalone['outputs'], 'entryPagePaths'>;
     type: 'nextjs';
     schemaVersion: 2;
     /**
@@ -455,6 +664,10 @@ interface FrameworkDefaultConfig {
         populateCache?: boolean;
         contentType?: string;
     }>;
+    /** Project-relative manifests containing logical static asset entries. */
+    assetManifests?: Array<{
+        source: string;
+    }>;
     populateAssetCache?: boolean;
     routes: Array<{
         source: string;
@@ -529,7 +742,7 @@ declare const generateConfig: (framework: FrameworkDefinition, packageManager: P
  * - commands: use user's if non-empty, otherwise framework's
  * - entrypoints: use user's if non-empty, otherwise framework's
  * - routes: use user's if non-empty, otherwise framework's
- * - assets: use user's if defined with paths, otherwise framework's
+ * - assets: use user's if it declares any sources, otherwise framework's
  * - excludeFiles: use user's if non-empty, otherwise framework's
  * - regions: always use user's (always populated from parsing)
  * - environmentVariables: deep merge (framework base, user overrides)
@@ -720,14 +933,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 +1080,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 +1124,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 +1152,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, GigadriveNextBuildManifestSchema, type GigadriveNextBuildManifestV1, GigadriveNextBuildManifestV1Schema, type GigadriveNextBuildManifestV2, type GigadriveNextBuildManifestV2Export, GigadriveNextBuildManifestV2ExportSchema, type GigadriveNextBuildManifestV2Standalone, GigadriveNextBuildManifestV2StandaloneSchema, type GigadriveNextPrerenderManifestV1, GigadriveNextPrerenderManifestV1Schema, type GigadriveNextPrerenderOutput, GigadriveNextPrerenderOutputSchema, type GigadriveNextServerDescriptor, GigadriveNextServerDescriptorSchema, type GigadriveNextStaticAssetPrefix, GigadriveNextStaticAssetPrefixSchema, 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 StaticAssetHeaders, StaticAssetHeadersSchema, type StaticAssetManifest, type StaticAssetManifestEntry, StaticAssetManifestEntrySchema, type StaticAssetManifestV1, StaticAssetManifestV1Schema, type UpstashAWSRegion, V4ConfigParser, VercelBuildOutputParser, detectFramework, detectPackageManager, filterFunctionsFromAssets, generateConfig, getFunctionSettings, mergeWithFrameworkDefaults, parseConfig, parseConfigRaw, parseGigadriveNextBuildManifest, parseGigadriveNextPrerenderManifest, parseStaticAssetManifest, postProcessConfig, readDependencies };