@jeffusion/bungee-types 4.2.0 → 4.4.0

package/dist/index.d.ts

@@ -1 +1,4 @@
-export * from './types';
+export * from './types.js';
+export * from './config-v2.js';
+export * from './rate-limit.js';
+export * from './daemon-control.js';

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from './types.js';
+export * from './config-v2.js';
+export * from './rate-limit.js';
+export * from './daemon-control.js';

package/dist/rate-limit.d.ts

@@ -0,0 +1,3 @@
+/** Shared configuration bounds; runtime protocol enforces the same contract. */
+export declare const RATE_LIMIT_MAX_RPS = 1000000;
+export declare const RATE_LIMIT_MAX_BURST = 1000000;

package/dist/rate-limit.js

@@ -0,0 +1,3 @@
+/** Shared configuration bounds; runtime protocol enforces the same contract. */
+export const RATE_LIMIT_MAX_RPS = 1000000;
+export const RATE_LIMIT_MAX_BURST = 1000000;

package/dist/types.d.ts

@@ -81,22 +81,28 @@ export interface Endpoint extends ModificationRules {
     description?: string;
     condition?: string;
 }
-export interface StickySessionConfig {
-    enabled: boolean;
-    key_expression?: string;
-}
 export interface RouteTimeoutsConfig {
-    connect_ms?: number;
     request_ms?: number;
 }
+/**
+ * Service-level transport timeouts.
+ * Describes how to connect to and exchange data with this pool of upstreams.
+ * Route-level request deadline (RouteTimeoutsConfig.request_ms) is unaffected.
+ */
+export interface ServiceTimeoutsConfig {
+    connect_ms?: number;
+    send_ms?: number;
+    read_ms?: number;
+}
 export interface FailoverPassiveHealthConfig {
     consecutive_failures?: number;
     healthy_successes?: number;
     auto_disable_threshold?: number;
-    auto_enable_on_active_health_check?: boolean;
 }
 export interface FailoverRecoveryConfig {
-    probe_interval_ms?: number;
+    /** UNHEALTHY 重新允许尝试的退避基准间隔（实际退避 = base × 2^recovery_attempt_count + 20% jitter） */
+    backoff_base_ms?: number;
+    /** HALF_OPEN/UNHEALTHY 状态下请求的超时切片 */
     probe_timeout_ms?: number;
 }
 export interface FailoverSlowStartConfig {
@@ -104,7 +110,11 @@ export interface FailoverSlowStartConfig {
     duration_ms?: number;
     initial_weight_factor?: number;
 }
-export interface FailoverHealthCheckConfig {
+/**
+ * Service-level active health check configuration.
+ * Independent subsystem — no longer nested under FailoverConfig.
+ */
+export interface ServiceHealthCheckConfig {
     enabled: boolean;
     interval_ms?: number;
     timeout_ms?: number;
@@ -117,22 +127,43 @@ export interface FailoverHealthCheckConfig {
     content_type?: string;
     headers?: Record<string, string>;
     query?: Record<string, string>;
+    /** 主动健康检查恢复后自动 re-enable 被 auto_disable 的 upstream */
+    auto_enable_on_active_health_check?: boolean;
+}
+export interface HashPolicyConfig {
+    /** 直接读 header 名作为 hash 输入（简单场景） */
+    header?: string;
+    /** 表达式返回值作为 hash 输入（可 access headers/body/url/method/env 全 context） */
+    expression?: string;
+}
+export interface LoadBalancingConfig {
+    policy: 'weighted_random' | 'round_robin' | 'least_requests' | 'consistent_hash';
+    /** 仅 policy='consistent_hash' 时有意义 */
+    hash_policy?: HashPolicyConfig;
 }
 export interface Service {
     name: string;
     endpoints: Endpoint[];
     plugins?: Array<PluginConfig | string>;
-    health_check?: FailoverHealthCheckConfig;
+    health_check?: ServiceHealthCheckConfig;
     failover?: FailoverConfig;
-    sticky_session?: StickySessionConfig;
+    load_balancing?: LoadBalancingConfig;
+    timeouts?: ServiceTimeoutsConfig;
 }
 export interface FailoverConfig {
     enabled: boolean;
     retry_on?: number | string | (number | string)[];
+    /**
+     * 响应内容触发关键字列表（与 retry_on 为 OR 关系）。
+     * 任一关键字在响应体中出现即触发 failover（大小写敏感子串匹配）。
+     *
+     * 流式：first-peek 首 4KB / 首个 SSE event；非流式：完整 body（1MB 上限）。
+     * 中段（5KB 后）错误无配置层方案。
+     */
+    retry_on_response?: string[];
     passive_health?: FailoverPassiveHealthConfig;
     recovery?: FailoverRecoveryConfig;
     slow_start?: FailoverSlowStartConfig;
-    health_check?: FailoverHealthCheckConfig;
 }
 export interface RateLimitConfig {
     enabled: boolean;
@@ -181,6 +212,8 @@ export interface RetryConfig {
     per_retry_timeout_ms?: number;
 }
 export interface RouteConfig extends ModificationRules {
+    /** Stable logical route identity, present only in compiled runtime config. */
+    id?: string;
     path: string;
     service?: string;
     endpoints?: Endpoint[];
@@ -210,6 +243,8 @@ export interface LoggingConfig {
  * 2. 通过 path 引用（高级）：手动指定插件文件路径
  */
 export interface PluginConfig {
+    /** Persisted plugin binding identity, when materialized from V2 configuration. */
+    id?: string;
     /**
      * Plugin 名称（唯一标识符）
      * 这是插件的唯一标识，用于引用和管理插件
@@ -262,3 +297,4 @@ export interface AppConfig {
     services?: Service[];
     routes: RouteConfig[];
 }
+export { decodeDaemonMetadataV1, encodeDaemonMetadataV1, parseDaemonMetadataV1, validateDaemonMetadataV1, } from './daemon-control.js';

package/dist/types.js

@@ -0,0 +1,2 @@
+// --- Type Definitions ---
+export { decodeDaemonMetadataV1, encodeDaemonMetadataV1, parseDaemonMetadataV1, validateDaemonMetadataV1, } from './daemon-control.js';

package/package.json

@@ -1,20 +1,30 @@
 {
   "name": "@jeffusion/bungee-types",
-  "version": "4.2.0",
+  "version": "4.4.0",
   "description": "TypeScript type definitions for Bungee",
-  "main": "./dist/index.d.ts",
+  "type": "module",
+  "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "scripts": {
     "build": "tsc",
     "prepublishOnly": "bun run build",
-    "test": "echo 'No tests for types package yet'"
+    "test": "bun run build && bun test tests/published-runtime.test.ts"
   },
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
     },
     "./types": {
-      "types": "./dist/types.d.ts"
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js",
+      "default": "./dist/types.js"
+    },
+    "./daemon-file": {
+      "types": "./dist/daemon-file.d.ts",
+      "import": "./dist/daemon-file.js",
+      "default": "./dist/daemon-file.js"
     }
   },
   "keywords": [