@spfn/core 0.2.0-beta.2 → 0.2.0-beta.20

package/dist/config/index.d.ts

@@ -20,9 +20,9 @@ import { parsePostgresUrl, parseRedisUrl } from '@spfn/core/env';
  * ```
  */
 declare const coreEnvSchema: {
-    NODE_ENV: Omit<_spfn_core_env.EnvVarSchema<"production" | "local" | "development" | "test">, "key" | "type" | "validator"> & {
+    NODE_ENV: Omit<_spfn_core_env.EnvVarSchema<"production" | "local" | "development" | "staging" | "test">, "key" | "type" | "validator"> & {
         type: "enum";
-        validator: (val: string) => "production" | "local" | "development" | "test";
+        validator: (val: string) => "production" | "local" | "development" | "staging" | "test";
     } & {
         key: "NODE_ENV";
     };
@@ -34,6 +34,7 @@ declare const coreEnvSchema: {
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "DATABASE_URL";
     };
@@ -45,6 +46,7 @@ declare const coreEnvSchema: {
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "DATABASE_WRITE_URL";
     };
@@ -56,6 +58,7 @@ declare const coreEnvSchema: {
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "DATABASE_READ_URL";
     };
@@ -226,6 +229,7 @@ declare const coreEnvSchema: {
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "DRIZZLE_SCHEMA_PATH";
     };
@@ -236,6 +240,7 @@ declare const coreEnvSchema: {
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "DRIZZLE_OUT_DIR";
     };
@@ -253,6 +258,7 @@ declare const coreEnvSchema: {
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "CACHE_URL";
     };
@@ -264,6 +270,7 @@ declare const coreEnvSchema: {
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "CACHE_WRITE_URL";
     };
@@ -275,6 +282,7 @@ declare const coreEnvSchema: {
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "CACHE_READ_URL";
     };
@@ -284,6 +292,7 @@ declare const coreEnvSchema: {
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "CACHE_SENTINEL_HOSTS";
     };
@@ -293,6 +302,7 @@ declare const coreEnvSchema: {
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "CACHE_CLUSTER_NODES";
     };
@@ -302,6 +312,7 @@ declare const coreEnvSchema: {
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "CACHE_MASTER_NAME";
     };
@@ -312,6 +323,7 @@ declare const coreEnvSchema: {
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "CACHE_PASSWORD";
     };
@@ -342,6 +354,7 @@ declare const coreEnvSchema: {
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "HOST";
     };
@@ -385,24 +398,77 @@ declare const coreEnvSchema: {
     } & {
         key: "SHUTDOWN_TIMEOUT";
     };
+    FETCH_CONNECT_TIMEOUT: {
+        description: string;
+        default: number;
+        examples: number[];
+    } & {
+        type: "number";
+        validator: (value: string) => number;
+    } & {
+        key: "FETCH_CONNECT_TIMEOUT";
+    };
+    FETCH_HEADERS_TIMEOUT: {
+        description: string;
+        default: number;
+        examples: number[];
+    } & {
+        type: "number";
+        validator: (value: string) => number;
+    } & {
+        key: "FETCH_HEADERS_TIMEOUT";
+    };
+    FETCH_BODY_TIMEOUT: {
+        description: string;
+        default: number;
+        examples: number[];
+    } & {
+        type: "number";
+        validator: (value: string) => number;
+    } & {
+        key: "FETCH_BODY_TIMEOUT";
+    };
     SPFN_API_URL: {
         description: string;
         required: boolean;
+        nextjs: boolean;
         examples: string[];
     } & {
         type: "url";
     } & {
         key: "SPFN_API_URL";
     };
+    NEXT_PUBLIC_SPFN_API_URL: {
+        description: string;
+        required: boolean;
+        nextjs: boolean;
+        examples: string[];
+    } & {
+        type: "url";
+    } & {
+        key: "NEXT_PUBLIC_SPFN_API_URL";
+    };
     SPFN_APP_URL: {
         description: string;
         required: boolean;
+        nextjs: boolean;
         examples: string[];
     } & {
         type: "url";
     } & {
         key: "SPFN_APP_URL";
     };
+    RPC_PROXY_TIMEOUT: {
+        description: string;
+        default: number;
+        nextjs: boolean;
+        examples: number[];
+    } & {
+        type: "number";
+        validator: (value: string) => number;
+    } & {
+        key: "RPC_PROXY_TIMEOUT";
+    };
 };
 
 /**
@@ -415,9 +481,9 @@ declare const coreEnvSchema: {
  * ```
  */
 declare const registry: _spfn_core_env.EnvRegistry<{
-    NODE_ENV: Omit<_spfn_core_env.EnvVarSchema<"production" | "local" | "development" | "test">, "key" | "type" | "validator"> & {
+    NODE_ENV: Omit<_spfn_core_env.EnvVarSchema<"production" | "local" | "development" | "staging" | "test">, "key" | "type" | "validator"> & {
         type: "enum";
-        validator: (val: string) => "production" | "local" | "development" | "test";
+        validator: (val: string) => "production" | "local" | "development" | "staging" | "test";
     } & {
         key: "NODE_ENV";
     };
@@ -429,6 +495,7 @@ declare const registry: _spfn_core_env.EnvRegistry<{
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "DATABASE_URL";
     };
@@ -440,6 +507,7 @@ declare const registry: _spfn_core_env.EnvRegistry<{
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "DATABASE_WRITE_URL";
     };
@@ -451,6 +519,7 @@ declare const registry: _spfn_core_env.EnvRegistry<{
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "DATABASE_READ_URL";
     };
@@ -621,6 +690,7 @@ declare const registry: _spfn_core_env.EnvRegistry<{
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "DRIZZLE_SCHEMA_PATH";
     };
@@ -631,6 +701,7 @@ declare const registry: _spfn_core_env.EnvRegistry<{
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "DRIZZLE_OUT_DIR";
     };
@@ -648,6 +719,7 @@ declare const registry: _spfn_core_env.EnvRegistry<{
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "CACHE_URL";
     };
@@ -659,6 +731,7 @@ declare const registry: _spfn_core_env.EnvRegistry<{
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "CACHE_WRITE_URL";
     };
@@ -670,6 +743,7 @@ declare const registry: _spfn_core_env.EnvRegistry<{
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "CACHE_READ_URL";
     };
@@ -679,6 +753,7 @@ declare const registry: _spfn_core_env.EnvRegistry<{
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "CACHE_SENTINEL_HOSTS";
     };
@@ -688,6 +763,7 @@ declare const registry: _spfn_core_env.EnvRegistry<{
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "CACHE_CLUSTER_NODES";
     };
@@ -697,6 +773,7 @@ declare const registry: _spfn_core_env.EnvRegistry<{
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "CACHE_MASTER_NAME";
     };
@@ -707,6 +784,7 @@ declare const registry: _spfn_core_env.EnvRegistry<{
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "CACHE_PASSWORD";
     };
@@ -737,6 +815,7 @@ declare const registry: _spfn_core_env.EnvRegistry<{
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "HOST";
     };
@@ -780,32 +859,85 @@ declare const registry: _spfn_core_env.EnvRegistry<{
     } & {
         key: "SHUTDOWN_TIMEOUT";
     };
+    FETCH_CONNECT_TIMEOUT: {
+        description: string;
+        default: number;
+        examples: number[];
+    } & {
+        type: "number";
+        validator: (value: string) => number;
+    } & {
+        key: "FETCH_CONNECT_TIMEOUT";
+    };
+    FETCH_HEADERS_TIMEOUT: {
+        description: string;
+        default: number;
+        examples: number[];
+    } & {
+        type: "number";
+        validator: (value: string) => number;
+    } & {
+        key: "FETCH_HEADERS_TIMEOUT";
+    };
+    FETCH_BODY_TIMEOUT: {
+        description: string;
+        default: number;
+        examples: number[];
+    } & {
+        type: "number";
+        validator: (value: string) => number;
+    } & {
+        key: "FETCH_BODY_TIMEOUT";
+    };
     SPFN_API_URL: {
         description: string;
         required: boolean;
+        nextjs: boolean;
         examples: string[];
     } & {
         type: "url";
     } & {
         key: "SPFN_API_URL";
     };
+    NEXT_PUBLIC_SPFN_API_URL: {
+        description: string;
+        required: boolean;
+        nextjs: boolean;
+        examples: string[];
+    } & {
+        type: "url";
+    } & {
+        key: "NEXT_PUBLIC_SPFN_API_URL";
+    };
     SPFN_APP_URL: {
         description: string;
         required: boolean;
+        nextjs: boolean;
         examples: string[];
     } & {
         type: "url";
     } & {
         key: "SPFN_APP_URL";
     };
+    RPC_PROXY_TIMEOUT: {
+        description: string;
+        default: number;
+        nextjs: boolean;
+        examples: number[];
+    } & {
+        type: "number";
+        validator: (value: string) => number;
+    } & {
+        key: "RPC_PROXY_TIMEOUT";
+    };
 }>;
 /**
  * Validated environment configuration
  */
 declare const env: _spfn_core_env.InferEnvType<{
-    NODE_ENV: Omit<_spfn_core_env.EnvVarSchema<"production" | "local" | "development" | "test">, "key" | "type" | "validator"> & {
+    NODE_ENV: Omit<_spfn_core_env.EnvVarSchema<"production" | "local" | "development" | "staging" | "test">, "key" | "type" | "validator"> & {
         type: "enum";
-        validator: (val: string) => "production" | "local" | "development" | "test";
+        validator: (val: string) => "production" | "local" | "development" | "staging" | "test";
     } & {
         key: "NODE_ENV";
     };
@@ -817,6 +949,7 @@ declare const env: _spfn_core_env.InferEnvType<{
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "DATABASE_URL";
     };
@@ -828,6 +961,7 @@ declare const env: _spfn_core_env.InferEnvType<{
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "DATABASE_WRITE_URL";
     };
@@ -839,6 +973,7 @@ declare const env: _spfn_core_env.InferEnvType<{
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "DATABASE_READ_URL";
     };
@@ -1009,6 +1144,7 @@ declare const env: _spfn_core_env.InferEnvType<{
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "DRIZZLE_SCHEMA_PATH";
     };
@@ -1019,6 +1155,7 @@ declare const env: _spfn_core_env.InferEnvType<{
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "DRIZZLE_OUT_DIR";
     };
@@ -1036,6 +1173,7 @@ declare const env: _spfn_core_env.InferEnvType<{
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "CACHE_URL";
     };
@@ -1047,6 +1185,7 @@ declare const env: _spfn_core_env.InferEnvType<{
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "CACHE_WRITE_URL";
     };
@@ -1058,6 +1197,7 @@ declare const env: _spfn_core_env.InferEnvType<{
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "CACHE_READ_URL";
     };
@@ -1067,6 +1207,7 @@ declare const env: _spfn_core_env.InferEnvType<{
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "CACHE_SENTINEL_HOSTS";
     };
@@ -1076,6 +1217,7 @@ declare const env: _spfn_core_env.InferEnvType<{
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "CACHE_CLUSTER_NODES";
     };
@@ -1085,6 +1227,7 @@ declare const env: _spfn_core_env.InferEnvType<{
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "CACHE_MASTER_NAME";
     };
@@ -1095,6 +1238,7 @@ declare const env: _spfn_core_env.InferEnvType<{
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "CACHE_PASSWORD";
     };
@@ -1125,6 +1269,7 @@ declare const env: _spfn_core_env.InferEnvType<{
         examples: string[];
     } & {
         type: "string";
+        validator: (value: string) => string;
     } & {
         key: "HOST";
     };
@@ -1168,24 +1313,77 @@ declare const env: _spfn_core_env.InferEnvType<{
     } & {
         key: "SHUTDOWN_TIMEOUT";
     };
+    FETCH_CONNECT_TIMEOUT: {
+        description: string;
+        default: number;
+        examples: number[];
+    } & {
+        type: "number";
+        validator: (value: string) => number;
+    } & {
+        key: "FETCH_CONNECT_TIMEOUT";
+    };
+    FETCH_HEADERS_TIMEOUT: {
+        description: string;
+        default: number;
+        examples: number[];
+    } & {
+        type: "number";
+        validator: (value: string) => number;
+    } & {
+        key: "FETCH_HEADERS_TIMEOUT";
+    };
+    FETCH_BODY_TIMEOUT: {
+        description: string;
+        default: number;
+        examples: number[];
+    } & {
+        type: "number";
+        validator: (value: string) => number;
+    } & {
+        key: "FETCH_BODY_TIMEOUT";
+    };
     SPFN_API_URL: {
         description: string;
         required: boolean;
+        nextjs: boolean;
         examples: string[];
     } & {
         type: "url";
     } & {
         key: "SPFN_API_URL";
     };
+    NEXT_PUBLIC_SPFN_API_URL: {
+        description: string;
+        required: boolean;
+        nextjs: boolean;
+        examples: string[];
+    } & {
+        type: "url";
+    } & {
+        key: "NEXT_PUBLIC_SPFN_API_URL";
+    };
     SPFN_APP_URL: {
         description: string;
         required: boolean;
+        nextjs: boolean;
         examples: string[];
     } & {
         type: "url";
     } & {
         key: "SPFN_APP_URL";
     };
+    RPC_PROXY_TIMEOUT: {
+        description: string;
+        default: number;
+        nextjs: boolean;
+        examples: number[];
+    } & {
+        type: "number";
+        validator: (value: string) => number;
+    } & {
+        key: "RPC_PROXY_TIMEOUT";
+    };
 }>;
 
 export { env, coreEnvSchema as envSchema, registry };

package/dist/config/index.js

@@ -1,13 +1,14 @@
-import { defineEnvSchema, envUrl, envNumber, envString, envBoolean, envEnum, parseRedisUrl, parsePostgresUrl, createEnvRegistry } from '@spfn/core/env';
+import { defineEnvSchema, envNumber, envUrl, envString, envBoolean, envEnum, parseRedisUrl, parsePostgresUrl, createEnvRegistry } from '@spfn/core/env';
 
 // src/config/index.ts
 var coreEnvSchema = defineEnvSchema({
   // ========================================================================
   // Core Environment
   // ========================================================================
-  NODE_ENV: envEnum(["local", "development", "production", "test"], {
+  NODE_ENV: envEnum(["local", "development", "staging", "production", "test"], {
     description: "Node.js runtime environment",
-    default: "local"
+    default: "local",
+    nextjs: true
   }),
   // ========================================================================
   // Database - Connection
@@ -236,22 +237,54 @@ var coreEnvSchema = defineEnvSchema({
     examples: [3e4, 6e4, 12e4]
   }),
   SHUTDOWN_TIMEOUT: envNumber({
-    description: "Graceful shutdown timeout in milliseconds",
-    default: 3e4,
-    examples: [1e4, 3e4, 6e4]
+    description: "Graceful shutdown timeout in milliseconds (must be less than k8s terminationGracePeriodSeconds minus preStop sleep, with safety margin)",
+    default: 28e4,
+    examples: [3e4, 12e4, 28e4]
   }),
   // ========================================================================
-  // Next.js Client
+  // Fetch (Node.js undici) - outbound HTTP request timeout
+  // ========================================================================
+  FETCH_CONNECT_TIMEOUT: envNumber({
+    description: "Fetch TCP connection timeout in milliseconds (time to establish socket connection to upstream server)",
+    default: 1e4,
+    examples: [5e3, 1e4, 3e4]
+  }),
+  FETCH_HEADERS_TIMEOUT: envNumber({
+    description: "Fetch headers timeout in milliseconds (time to receive response headers after request sent)",
+    default: 3e5,
+    examples: [12e4, 3e5, 6e5]
+  }),
+  FETCH_BODY_TIMEOUT: envNumber({
+    description: "Fetch body timeout in milliseconds (time between body data chunks from upstream server)",
+    default: 3e5,
+    examples: [12e4, 3e5, 6e5]
+  }),
+  // ========================================================================
+  // Next.js Integration
   // ========================================================================
   SPFN_API_URL: envUrl({
-    description: "Next.js API URL (required for client-side API calls)",
+    description: "SPFN API URL (used by Next.js to call backend)",
+    required: true,
+    nextjs: true,
+    examples: ["http://localhost:8790", "https://api.your-app.com"]
+  }),
+  NEXT_PUBLIC_SPFN_API_URL: envUrl({
+    description: "SPFN API URL (used by Next.js to call backend)",
     required: true,
-    examples: ["http://localhost:3000", "https://your-app.com"]
+    nextjs: true,
+    examples: ["http://localhost:8790", "https://api.your-app.com"]
   }),
   SPFN_APP_URL: envUrl({
-    description: "Next.js application URL (required for server-side API calls)",
+    description: "Next.js application URL (used by SPFN server)",
     required: false,
-    examples: ["http://localhost:3000", "https://your-app.com"]
+    nextjs: true,
+    examples: ["http://localhost:3790", "https://your-app.com"]
+  }),
+  RPC_PROXY_TIMEOUT: envNumber({
+    description: "RPC proxy request timeout in milliseconds (AbortController timeout for proxied requests to backend, should be shorter than FETCH_HEADERS_TIMEOUT)",
+    default: 12e4,
+    nextjs: true,
+    examples: [6e4, 12e4, 28e4]
   })
 });