@gigadrive/network-config 3.4.16 → 4.0.0

package/dist/index.d.mts

@@ -41,48 +41,6 @@ interface NormalizedImagePolicy {
 type JsonValue = null | boolean | number | string | JsonValue[] | {
     [key: string]: JsonValue;
 };
-type GigadriveNextRuntime = 'nodejs' | 'edge';
-interface GigadriveNextEdgeRuntime {
-    modulePath: string;
-    entryKey: string;
-    handlerExport: string;
-}
-interface GigadriveNextEntrypoint {
-    id: string;
-    runtime: GigadriveNextRuntime;
-    filePath: string;
-    outputIds: string[];
-    assets: Record<string, string>;
-    wasmAssets?: Record<string, string>;
-    edgeRuntime?: GigadriveNextEdgeRuntime;
-    config: {
-        maxDuration?: number;
-        preferredRegion?: string | string[];
-        env?: Record<string, string>;
-    };
-}
-interface GigadriveNextRouteOutput {
-    id: string;
-    type: 'PAGES' | 'PAGES_API' | 'APP_PAGE' | 'APP_ROUTE' | 'MIDDLEWARE';
-    filePath: string;
-    pathname: string;
-    sourcePage: string;
-    runtime: GigadriveNextRuntime;
-    assets: Record<string, string>;
-    wasmAssets?: Record<string, string>;
-    edgeRuntime?: GigadriveNextEdgeRuntime;
-    config: {
-        maxDuration?: number;
-        preferredRegion?: string | string[];
-        env?: Record<string, string>;
-        matchers?: Array<{
-            source: string;
-            sourceRegex: string;
-            has?: JsonValue[];
-            missing?: JsonValue[];
-        }>;
-    };
-}
 interface GigadriveNextPrerenderOutput {
     id: string;
     type: 'PRERENDER';
@@ -110,12 +68,18 @@ interface GigadriveNextPrerenderOutput {
         bypassToken?: string;
     };
 }
-interface GigadriveNextStaticOutput {
-    id: string;
-    type: 'STATIC_FILE';
-    filePath: string;
-    pathname: string;
-    immutableHash?: 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;
@@ -125,14 +89,29 @@ interface GigadriveNextBuildManifestV1 {
     nextVersion: string;
     buildId: string;
 }
-/** Portable build/runtime plan emitted by the Next.js 16 deployment adapter. */
-interface GigadriveNextBuildManifestV2 {
+/** 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: 'adapter-v2' | 'export';
+    mode: 'standalone-v2';
     distDir: string;
     repoRootToProject: string;
     nextVersion: string;
     buildId: string;
+    server: GigadriveNextServerDescriptor;
     config: {
         basePath: string;
         trailingSlash: boolean;
@@ -151,17 +130,20 @@ interface GigadriveNextBuildManifestV2 {
         rsc: JsonValue;
     };
     outputs: {
-        pages: GigadriveNextRouteOutput[];
-        middleware?: GigadriveNextRouteOutput;
-        appPages: GigadriveNextRouteOutput[];
-        pagesApi: GigadriveNextRouteOutput[];
-        appRoutes: GigadriveNextRouteOutput[];
         prerenders: GigadriveNextPrerenderOutput[];
-        staticFiles: GigadriveNextStaticOutput[];
+        staticAssets: GigadriveNextStaticAssetPrefix[];
     };
-    entrypoints: GigadriveNextEntrypoint[];
-    outputEntrypoints: Record<string, string>;
 }
+/** Minimal plan for static-export builds (Next >= 16.2). */
+interface GigadriveNextBuildManifestV2Export {
+    version: 2;
+    mode: 'export';
+    distDir: string;
+    repoRootToProject: string;
+    nextVersion: string;
+    buildId: string;
+}
+type GigadriveNextBuildManifestV2 = GigadriveNextBuildManifestV2Standalone | GigadriveNextBuildManifestV2Export;
 type GigadriveNextBuildManifest = GigadriveNextBuildManifestV1 | GigadriveNextBuildManifestV2;
 /** Parses and structurally validates adapter metadata before deployment code consumes it. */
 declare const parseGigadriveNextBuildManifest: (content: string) => GigadriveNextBuildManifest | undefined;
@@ -206,6 +188,24 @@ interface NormalizedConfig {
             path?: string;
             contentType?: string;
         }>;
+        /**
+         * Directory subtrees published under a single URL prefix, registered as one
+         * descriptor each instead of enumerating every file. Used to collapse
+         * high-cardinality immutable trees such as `.next/static` into a single
+         * edge-served prefix (one object-storage sync + one route, not one per file).
+         */
+        prefixes?: Array<{
+            /** Project-relative source directory root (e.g. `.next/static`). */
+            source: string;
+            /** Public URL prefix to serve the subtree under (e.g. `_next/static`). */
+            destination: string;
+            /** Serve with immutable cache-control (content-hashed assets). */
+            immutable?: boolean;
+            /** Populate the edge cache for this subtree at deployment time. */
+            populateCache?: boolean;
+            /** Optional Content-Type override applied to the whole subtree. */
+            contentType?: string;
+        }>;
         /**
          * Whether routes for the assets should be generated during deployment.
          */
@@ -315,7 +315,13 @@ interface NormalizedConfigEntrypoint {
     };
 }
 type NormalizedFramework = NormalizedNextjsFramework;
-type NormalizedNextjsFramework = Omit<GigadriveNextBuildManifestV2, 'version'> & {
+/**
+ * Framework runtime metadata the Network gateway consumes. Mirrors the single
+ * standalone-server manifest (minus the wire `version`) plus the persisted
+ * 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: 'nextjs';
     schemaVersion: 2;
 };
@@ -435,6 +441,14 @@ interface FrameworkDefaultConfig {
         path?: string;
         contentType?: string;
     }>;
+    /** Directory subtrees to publish under a URL prefix without per-file enumeration. */
+    assetPrefixes?: Array<{
+        source: string;
+        destination: string;
+        immutable?: boolean;
+        populateCache?: boolean;
+        contentType?: string;
+    }>;
     populateAssetCache?: boolean;
     routes: Array<{
         source: string;
@@ -850,4 +864,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 GigadriveNextEdgeRuntime, type GigadriveNextEntrypoint, type GigadriveNextPrerenderOutput, type GigadriveNextRouteOutput, type GigadriveNextRuntime, type GigadriveNextStaticOutput, 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, 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 };

package/dist/index.d.ts

@@ -41,48 +41,6 @@ interface NormalizedImagePolicy {
 type JsonValue = null | boolean | number | string | JsonValue[] | {
     [key: string]: JsonValue;
 };
-type GigadriveNextRuntime = 'nodejs' | 'edge';
-interface GigadriveNextEdgeRuntime {
-    modulePath: string;
-    entryKey: string;
-    handlerExport: string;
-}
-interface GigadriveNextEntrypoint {
-    id: string;
-    runtime: GigadriveNextRuntime;
-    filePath: string;
-    outputIds: string[];
-    assets: Record<string, string>;
-    wasmAssets?: Record<string, string>;
-    edgeRuntime?: GigadriveNextEdgeRuntime;
-    config: {
-        maxDuration?: number;
-        preferredRegion?: string | string[];
-        env?: Record<string, string>;
-    };
-}
-interface GigadriveNextRouteOutput {
-    id: string;
-    type: 'PAGES' | 'PAGES_API' | 'APP_PAGE' | 'APP_ROUTE' | 'MIDDLEWARE';
-    filePath: string;
-    pathname: string;
-    sourcePage: string;
-    runtime: GigadriveNextRuntime;
-    assets: Record<string, string>;
-    wasmAssets?: Record<string, string>;
-    edgeRuntime?: GigadriveNextEdgeRuntime;
-    config: {
-        maxDuration?: number;
-        preferredRegion?: string | string[];
-        env?: Record<string, string>;
-        matchers?: Array<{
-            source: string;
-            sourceRegex: string;
-            has?: JsonValue[];
-            missing?: JsonValue[];
-        }>;
-    };
-}
 interface GigadriveNextPrerenderOutput {
     id: string;
     type: 'PRERENDER';
@@ -110,12 +68,18 @@ interface GigadriveNextPrerenderOutput {
         bypassToken?: string;
     };
 }
-interface GigadriveNextStaticOutput {
-    id: string;
-    type: 'STATIC_FILE';
-    filePath: string;
-    pathname: string;
-    immutableHash?: 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;
@@ -125,14 +89,29 @@ interface GigadriveNextBuildManifestV1 {
     nextVersion: string;
     buildId: string;
 }
-/** Portable build/runtime plan emitted by the Next.js 16 deployment adapter. */
-interface GigadriveNextBuildManifestV2 {
+/** 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: 'adapter-v2' | 'export';
+    mode: 'standalone-v2';
     distDir: string;
     repoRootToProject: string;
     nextVersion: string;
     buildId: string;
+    server: GigadriveNextServerDescriptor;
     config: {
         basePath: string;
         trailingSlash: boolean;
@@ -151,17 +130,20 @@ interface GigadriveNextBuildManifestV2 {
         rsc: JsonValue;
     };
     outputs: {
-        pages: GigadriveNextRouteOutput[];
-        middleware?: GigadriveNextRouteOutput;
-        appPages: GigadriveNextRouteOutput[];
-        pagesApi: GigadriveNextRouteOutput[];
-        appRoutes: GigadriveNextRouteOutput[];
         prerenders: GigadriveNextPrerenderOutput[];
-        staticFiles: GigadriveNextStaticOutput[];
+        staticAssets: GigadriveNextStaticAssetPrefix[];
     };
-    entrypoints: GigadriveNextEntrypoint[];
-    outputEntrypoints: Record<string, string>;
 }
+/** Minimal plan for static-export builds (Next >= 16.2). */
+interface GigadriveNextBuildManifestV2Export {
+    version: 2;
+    mode: 'export';
+    distDir: string;
+    repoRootToProject: string;
+    nextVersion: string;
+    buildId: string;
+}
+type GigadriveNextBuildManifestV2 = GigadriveNextBuildManifestV2Standalone | GigadriveNextBuildManifestV2Export;
 type GigadriveNextBuildManifest = GigadriveNextBuildManifestV1 | GigadriveNextBuildManifestV2;
 /** Parses and structurally validates adapter metadata before deployment code consumes it. */
 declare const parseGigadriveNextBuildManifest: (content: string) => GigadriveNextBuildManifest | undefined;
@@ -206,6 +188,24 @@ interface NormalizedConfig {
             path?: string;
             contentType?: string;
         }>;
+        /**
+         * Directory subtrees published under a single URL prefix, registered as one
+         * descriptor each instead of enumerating every file. Used to collapse
+         * high-cardinality immutable trees such as `.next/static` into a single
+         * edge-served prefix (one object-storage sync + one route, not one per file).
+         */
+        prefixes?: Array<{
+            /** Project-relative source directory root (e.g. `.next/static`). */
+            source: string;
+            /** Public URL prefix to serve the subtree under (e.g. `_next/static`). */
+            destination: string;
+            /** Serve with immutable cache-control (content-hashed assets). */
+            immutable?: boolean;
+            /** Populate the edge cache for this subtree at deployment time. */
+            populateCache?: boolean;
+            /** Optional Content-Type override applied to the whole subtree. */
+            contentType?: string;
+        }>;
         /**
          * Whether routes for the assets should be generated during deployment.
          */
@@ -315,7 +315,13 @@ interface NormalizedConfigEntrypoint {
     };
 }
 type NormalizedFramework = NormalizedNextjsFramework;
-type NormalizedNextjsFramework = Omit<GigadriveNextBuildManifestV2, 'version'> & {
+/**
+ * Framework runtime metadata the Network gateway consumes. Mirrors the single
+ * standalone-server manifest (minus the wire `version`) plus the persisted
+ * 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: 'nextjs';
     schemaVersion: 2;
 };
@@ -435,6 +441,14 @@ interface FrameworkDefaultConfig {
         path?: string;
         contentType?: string;
     }>;
+    /** Directory subtrees to publish under a URL prefix without per-file enumeration. */
+    assetPrefixes?: Array<{
+        source: string;
+        destination: string;
+        immutable?: boolean;
+        populateCache?: boolean;
+        contentType?: string;
+    }>;
     populateAssetCache?: boolean;
     routes: Array<{
         source: string;
@@ -850,4 +864,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 GigadriveNextEdgeRuntime, type GigadriveNextEntrypoint, type GigadriveNextPrerenderOutput, type GigadriveNextRouteOutput, type GigadriveNextRuntime, type GigadriveNextStaticOutput, 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, 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 };