@gigadrive/network-config 3.1.1 → 3.2.0

package/dist/index.d.mts

@@ -110,11 +110,21 @@ interface NormalizedConfigServicePostgres extends NormalizedConfigService {
     postgresVersion?: '17' | '16' | '15' | '14';
     region?: NeonAWSRegion;
 }
+/** 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). */
+declare const MAX_FUNCTION_DURATION_SECONDS = 28800;
 interface NormalizedConfigEntrypoint {
     displayName?: string;
     path: string;
     runtime: Runtime;
     memory: number;
+    /**
+     * Maximum lifetime of one HTTP request, response stream, or WebSocket connection, in seconds.
+     *
+     * The limit applies to an invocation, not to the reusable compute environment that happens to
+     * serve it. The platform may suspend or reuse that environment after all invocations finish.
+     */
     maxDuration: number;
     schedule?: string;
     symlinks?: Record<string, string>;
@@ -262,7 +272,11 @@ interface DetectionResult {
  * @param projectFolder - Absolute path to the project root
  * @returns DetectionResult with framework, package manager, and generated config
  */
-declare const detectFramework: (projectFolder: string) => Effect.Effect<DetectionResult, ManifestReadError | ManifestParseError | FrameworkNotDetectedError, FileSystem.FileSystem | Path.Path>;
+declare const detectFramework: (projectFolder: string) => Effect.Effect<{
+    framework: FrameworkDefinition;
+    packageManager: PackageManager;
+    config: NormalizedConfig;
+}, ManifestReadError | ManifestParseError | FrameworkNotDetectedError, FileSystem.FileSystem | Path.Path>;
 
 /**
  * Detects the package manager by checking for lockfiles in the project folder.
@@ -500,7 +514,11 @@ interface ConfigV4FunctionSettings {
      */
     memory?: number;
     /**
-     * The maximum duration of the function in seconds. May not be higher than 15 minutes.
+     * Maximum lifetime of one HTTP request, response stream, or WebSocket connection, in seconds.
+     * Defaults to 30 seconds and may not be higher than eight hours (28,800 seconds).
+     *
+     * This is an invocation limit. It does not control how long the platform retains or reuses the
+     * underlying execution environment after the invocation finishes.
      */
     max_duration?: number;
     /**
@@ -550,7 +568,21 @@ declare const V4ConfigParser_base: Effect.Service.Class<V4ConfigParser, "V4Confi
          * @param config - The raw V4 config object
          * @param projectFolder - Absolute path to the project root
          */
-        parse: (config: ConfigV4, projectFolder: string) => Effect.Effect<NormalizedConfig, FunctionConfigError, FileSystem.FileSystem | Path.Path>;
+        parse: (config: ConfigV4, projectFolder: string) => Effect.Effect<{
+            regions: ("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")[];
+            assets: {
+                paths: string[];
+                prefixToStrip: string;
+                dynamicRoutes: boolean;
+                populateCache: boolean;
+            };
+            environmentVariables: Record<string, string>;
+            commands: string[];
+            entrypoints: NormalizedConfigEntrypoint[];
+            errors: never[];
+            warnings: never[];
+            routes: NormalizedConfigRoute[];
+        }, FunctionConfigError, FileSystem.FileSystem | Path.Path>;
     }, never, never>;
 }>;
 declare class V4ConfigParser extends V4ConfigParser_base {
@@ -578,7 +610,21 @@ interface Config {
  * @param filePath - Absolute path to the config file
  * @param projectFolder - Absolute path to the project root
  */
-declare const parseConfigRaw: (filePath: string, projectFolder: string) => Effect.Effect<NormalizedConfig, ConfigFileNotFoundError | ConfigFileEmptyError | ConfigFileParseError | ConfigVersionError | ConfigSchemaValidationError | FunctionConfigError, _effect_platform_FileSystem.FileSystem | _effect_platform_Path.Path | RawConfigReader | SchemaValidator | V4ConfigParser>;
+declare const parseConfigRaw: (filePath: string, projectFolder: string) => Effect.Effect<{
+    regions: ("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")[];
+    assets: {
+        paths: string[];
+        prefixToStrip: string;
+        dynamicRoutes: boolean;
+        populateCache: boolean;
+    };
+    environmentVariables: Record<string, string>;
+    commands: string[];
+    entrypoints: NormalizedConfigEntrypoint[];
+    errors: never[];
+    warnings: never[];
+    routes: NormalizedConfigRoute[];
+}, ConfigFileNotFoundError | ConfigFileEmptyError | ConfigFileParseError | ConfigVersionError | ConfigSchemaValidationError | FunctionConfigError, _effect_platform_FileSystem.FileSystem | _effect_platform_Path.Path | RawConfigReader | SchemaValidator | V4ConfigParser>;
 /**
  * Parses a config file at the given path, validates it against the appropriate
  * JSON Schema, converts it to a NormalizedConfig, and applies post-processing.
@@ -601,4 +647,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, type DetectionResult, FRAMEWORK_DEFINITIONS, type FilePathMap, type FrameworkDefaultConfig, type FrameworkDefinition, type FrameworkDetectionItem, type FrameworkLanguage, FrameworkNotDetectedError, FunctionConfigError, 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 PackageManager, RawConfigReader, type Region, type Runtime, SchemaValidator, type UpstashAWSRegion, V4ConfigParser, VercelBuildOutputParser, detectFramework, detectPackageManager, filterFunctionsFromAssets, generateConfig, getFunctionSettings, mergeWithFrameworkDefaults, parseConfig, parseConfigRaw, 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, 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 PackageManager, RawConfigReader, type Region, type Runtime, SchemaValidator, type UpstashAWSRegion, V4ConfigParser, VercelBuildOutputParser, detectFramework, detectPackageManager, filterFunctionsFromAssets, generateConfig, getFunctionSettings, mergeWithFrameworkDefaults, parseConfig, parseConfigRaw, postProcessConfig, readDependencies };

package/dist/index.d.ts

@@ -110,11 +110,21 @@ interface NormalizedConfigServicePostgres extends NormalizedConfigService {
     postgresVersion?: '17' | '16' | '15' | '14';
     region?: NeonAWSRegion;
 }
+/** 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). */
+declare const MAX_FUNCTION_DURATION_SECONDS = 28800;
 interface NormalizedConfigEntrypoint {
     displayName?: string;
     path: string;
     runtime: Runtime;
     memory: number;
+    /**
+     * Maximum lifetime of one HTTP request, response stream, or WebSocket connection, in seconds.
+     *
+     * The limit applies to an invocation, not to the reusable compute environment that happens to
+     * serve it. The platform may suspend or reuse that environment after all invocations finish.
+     */
     maxDuration: number;
     schedule?: string;
     symlinks?: Record<string, string>;
@@ -262,7 +272,11 @@ interface DetectionResult {
  * @param projectFolder - Absolute path to the project root
  * @returns DetectionResult with framework, package manager, and generated config
  */
-declare const detectFramework: (projectFolder: string) => Effect.Effect<DetectionResult, ManifestReadError | ManifestParseError | FrameworkNotDetectedError, FileSystem.FileSystem | Path.Path>;
+declare const detectFramework: (projectFolder: string) => Effect.Effect<{
+    framework: FrameworkDefinition;
+    packageManager: PackageManager;
+    config: NormalizedConfig;
+}, ManifestReadError | ManifestParseError | FrameworkNotDetectedError, FileSystem.FileSystem | Path.Path>;
 
 /**
  * Detects the package manager by checking for lockfiles in the project folder.
@@ -500,7 +514,11 @@ interface ConfigV4FunctionSettings {
      */
     memory?: number;
     /**
-     * The maximum duration of the function in seconds. May not be higher than 15 minutes.
+     * Maximum lifetime of one HTTP request, response stream, or WebSocket connection, in seconds.
+     * Defaults to 30 seconds and may not be higher than eight hours (28,800 seconds).
+     *
+     * This is an invocation limit. It does not control how long the platform retains or reuses the
+     * underlying execution environment after the invocation finishes.
      */
     max_duration?: number;
     /**
@@ -550,7 +568,21 @@ declare const V4ConfigParser_base: Effect.Service.Class<V4ConfigParser, "V4Confi
          * @param config - The raw V4 config object
          * @param projectFolder - Absolute path to the project root
          */
-        parse: (config: ConfigV4, projectFolder: string) => Effect.Effect<NormalizedConfig, FunctionConfigError, FileSystem.FileSystem | Path.Path>;
+        parse: (config: ConfigV4, projectFolder: string) => Effect.Effect<{
+            regions: ("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")[];
+            assets: {
+                paths: string[];
+                prefixToStrip: string;
+                dynamicRoutes: boolean;
+                populateCache: boolean;
+            };
+            environmentVariables: Record<string, string>;
+            commands: string[];
+            entrypoints: NormalizedConfigEntrypoint[];
+            errors: never[];
+            warnings: never[];
+            routes: NormalizedConfigRoute[];
+        }, FunctionConfigError, FileSystem.FileSystem | Path.Path>;
     }, never, never>;
 }>;
 declare class V4ConfigParser extends V4ConfigParser_base {
@@ -578,7 +610,21 @@ interface Config {
  * @param filePath - Absolute path to the config file
  * @param projectFolder - Absolute path to the project root
  */
-declare const parseConfigRaw: (filePath: string, projectFolder: string) => Effect.Effect<NormalizedConfig, ConfigFileNotFoundError | ConfigFileEmptyError | ConfigFileParseError | ConfigVersionError | ConfigSchemaValidationError | FunctionConfigError, _effect_platform_FileSystem.FileSystem | _effect_platform_Path.Path | RawConfigReader | SchemaValidator | V4ConfigParser>;
+declare const parseConfigRaw: (filePath: string, projectFolder: string) => Effect.Effect<{
+    regions: ("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")[];
+    assets: {
+        paths: string[];
+        prefixToStrip: string;
+        dynamicRoutes: boolean;
+        populateCache: boolean;
+    };
+    environmentVariables: Record<string, string>;
+    commands: string[];
+    entrypoints: NormalizedConfigEntrypoint[];
+    errors: never[];
+    warnings: never[];
+    routes: NormalizedConfigRoute[];
+}, ConfigFileNotFoundError | ConfigFileEmptyError | ConfigFileParseError | ConfigVersionError | ConfigSchemaValidationError | FunctionConfigError, _effect_platform_FileSystem.FileSystem | _effect_platform_Path.Path | RawConfigReader | SchemaValidator | V4ConfigParser>;
 /**
  * Parses a config file at the given path, validates it against the appropriate
  * JSON Schema, converts it to a NormalizedConfig, and applies post-processing.
@@ -601,4 +647,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, type DetectionResult, FRAMEWORK_DEFINITIONS, type FilePathMap, type FrameworkDefaultConfig, type FrameworkDefinition, type FrameworkDetectionItem, type FrameworkLanguage, FrameworkNotDetectedError, FunctionConfigError, 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 PackageManager, RawConfigReader, type Region, type Runtime, SchemaValidator, type UpstashAWSRegion, V4ConfigParser, VercelBuildOutputParser, detectFramework, detectPackageManager, filterFunctionsFromAssets, generateConfig, getFunctionSettings, mergeWithFrameworkDefaults, parseConfig, parseConfigRaw, 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, 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 PackageManager, RawConfigReader, type Region, type Runtime, SchemaValidator, type UpstashAWSRegion, V4ConfigParser, VercelBuildOutputParser, detectFramework, detectPackageManager, filterFunctionsFromAssets, generateConfig, getFunctionSettings, mergeWithFrameworkDefaults, parseConfig, parseConfigRaw, postProcessConfig, readDependencies };