@jeffusion/bungee-types 5.4.4 → 5.4.6

package/dist/index.d.ts

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

package/dist/index.js

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

package/dist/publication-policy.d.ts

@@ -0,0 +1,13 @@
+export interface PublicationPolicy {
+    readonly drain_start_timeout_ms: number;
+    readonly drain_timeout_ms: number;
+    readonly worker_exit_timeout_ms: number;
+}
+export declare const DEFAULT_PUBLICATION_POLICY: Readonly<PublicationPolicy>;
+export declare const MAX_PUBLICATION_TIMEOUT_MS = 2147483000;
+export type PublicationPolicyValidationError = {
+    readonly field: keyof PublicationPolicy | 'publication';
+    readonly message: string;
+};
+export declare function validatePublicationPolicy(value: unknown): readonly PublicationPolicyValidationError[];
+export declare function resolvePublicationPolicy(value?: PublicationPolicy): Readonly<PublicationPolicy>;

package/dist/publication-policy.js

@@ -0,0 +1,51 @@
+export const DEFAULT_PUBLICATION_POLICY = Object.freeze({
+    drain_start_timeout_ms: 5000,
+    drain_timeout_ms: 300000,
+    worker_exit_timeout_ms: 10000,
+});
+export const MAX_PUBLICATION_TIMEOUT_MS = 2147483000;
+const PUBLICATION_FIELDS = [
+    'drain_start_timeout_ms',
+    'drain_timeout_ms',
+    'worker_exit_timeout_ms',
+];
+export function validatePublicationPolicy(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        return [{ field: 'publication', message: 'Expected an object' }];
+    }
+    const object = value;
+    const errors = [];
+    for (const key of Object.keys(object)) {
+        if (!PUBLICATION_FIELDS.includes(key)) {
+            errors.push({ field: 'publication', message: `Unknown field: ${key}` });
+        }
+    }
+    for (const field of PUBLICATION_FIELDS) {
+        if (!Object.prototype.hasOwnProperty.call(object, field)) {
+            errors.push({ field, message: 'Required field is missing' });
+            continue;
+        }
+        const timeout = object[field];
+        if (typeof timeout !== 'number' || !Number.isSafeInteger(timeout)) {
+            errors.push({ field, message: 'Expected a safe integer number of milliseconds' });
+        }
+        else if (timeout <= 0) {
+            errors.push({ field, message: 'Must be greater than zero' });
+        }
+        else if (timeout % 1000 !== 0) {
+            errors.push({ field, message: 'Must be a whole number of seconds' });
+        }
+        else if (timeout > MAX_PUBLICATION_TIMEOUT_MS) {
+            errors.push({ field, message: `Must not exceed ${MAX_PUBLICATION_TIMEOUT_MS} milliseconds` });
+        }
+    }
+    return errors;
+}
+export function resolvePublicationPolicy(value) {
+    if (value === undefined)
+        return DEFAULT_PUBLICATION_POLICY;
+    const errors = validatePublicationPolicy(value);
+    if (errors.length !== 0)
+        throw new TypeError(`Invalid publication policy: ${errors.map(({ field, message }) => `${field}: ${message}`).join('; ')}`);
+    return value;
+}

package/dist/types.d.ts

@@ -1,3 +1,4 @@
+import type { PublicationPolicy } from './publication-policy.js';
 /**
  * 插件配置值类型
  * 定义了插件配置中允许的值类型，比 `any` 更具体
@@ -283,6 +284,7 @@ export interface AppConfig {
     body_parser_limit?: string;
     auth?: AuthConfig;
     logging?: LoggingConfig;
+    publication?: PublicationPolicy;
     plugins?: Array<PluginConfig | string>;
     services?: Service[];
     routes: RouteConfig[];

package/dist/types.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jeffusion/bungee-types",
-  "version": "5.4.4",
+  "version": "5.4.6",
   "description": "TypeScript type definitions for Bungee",
   "type": "module",
   "main": "./dist/index.js",