@zero-server/sdk 0.9.1 → 0.9.2

package/types/cluster.d.ts

@@ -1,75 +1,75 @@
-/// <reference types="node" />
-
-import { Worker } from 'cluster';
-
-export interface ClusterOptions {
-    /** Number of worker processes (default: CPU count). */
-    workers?: number;
-    /** Automatically respawn crashed workers (default: true). */
-    respawn?: boolean;
-    /** Initial delay (ms) before respawning (default: 1000). */
-    respawnDelay?: number;
-    /** Maximum respawn delay after backoff (default: 30000). */
-    maxRespawnDelay?: number;
-    /** Multiplier for exponential backoff (default: 2). */
-    backoffFactor?: number;
-}
-
-export declare class ClusterManager {
-    constructor(opts?: ClusterOptions);
-
-    /** Whether this is the primary (master) process. */
-    readonly isPrimary: boolean;
-
-    /** Whether this is a worker process. */
-    readonly isWorker: boolean;
-
-    /** Configured number of workers. */
-    readonly workerCount: number;
-
-    /** IDs of currently active workers. */
-    readonly workerIds: number[];
-
-    /** Number of currently alive workers. */
-    readonly activeWorkers: number;
-
-    /** Fork all worker processes. */
-    fork(): ClusterManager;
-
-    /** Broadcast a typed message to all workers. */
-    broadcast(type: string, data: any): void;
-
-    /** Send a typed message to a specific worker. */
-    sendTo(workerId: number, type: string, data: any): void;
-
-    /** Send a typed message from a worker to the primary. */
-    sendToPrimary(type: string, data: any): void;
-
-    /** Register a handler for a typed IPC message. */
-    onMessage(type: string, fn: (data: any, worker?: Worker) => void): ClusterManager;
-
-    /** Perform a rolling restart of all workers. */
-    reload(): Promise<void>;
-
-    /** Shut down the entire cluster gracefully. */
-    shutdown(opts?: { timeout?: number }): Promise<void>;
-
-    /** Enable automatic per-worker metrics aggregation. */
-    enableMetrics(registry: import('./observe').MetricsRegistry, opts?: { interval?: number }): ClusterManager;
-
-    /** Stop the per-worker metrics reporting timer. */
-    disableMetrics(): void;
-
-    /** Enable sticky sessions by hashing client IPs to workers. */
-    enableSticky(server: import('http').Server | import('https').Server, opts?: {
-        hash?: (ip: string, workerCount: number) => number;
-    }): ClusterManager;
-}
-
-/**
- * High-level clustering helper.
- */
-export declare function cluster(
-    workerFn: (mgr: ClusterManager) => void,
-    opts?: ClusterOptions
-): ClusterManager;
+/// <reference types="node" />
+
+import { Worker } from 'cluster';
+
+export interface ClusterOptions {
+    /** Number of worker processes (default: CPU count). */
+    workers?: number;
+    /** Automatically respawn crashed workers (default: true). */
+    respawn?: boolean;
+    /** Initial delay (ms) before respawning (default: 1000). */
+    respawnDelay?: number;
+    /** Maximum respawn delay after backoff (default: 30000). */
+    maxRespawnDelay?: number;
+    /** Multiplier for exponential backoff (default: 2). */
+    backoffFactor?: number;
+}
+
+export declare class ClusterManager {
+    constructor(opts?: ClusterOptions);
+
+    /** Whether this is the primary (master) process. */
+    readonly isPrimary: boolean;
+
+    /** Whether this is a worker process. */
+    readonly isWorker: boolean;
+
+    /** Configured number of workers. */
+    readonly workerCount: number;
+
+    /** IDs of currently active workers. */
+    readonly workerIds: number[];
+
+    /** Number of currently alive workers. */
+    readonly activeWorkers: number;
+
+    /** Fork all worker processes. */
+    fork(): ClusterManager;
+
+    /** Broadcast a typed message to all workers. */
+    broadcast(type: string, data: any): void;
+
+    /** Send a typed message to a specific worker. */
+    sendTo(workerId: number, type: string, data: any): void;
+
+    /** Send a typed message from a worker to the primary. */
+    sendToPrimary(type: string, data: any): void;
+
+    /** Register a handler for a typed IPC message. */
+    onMessage(type: string, fn: (data: any, worker?: Worker) => void): ClusterManager;
+
+    /** Perform a rolling restart of all workers. */
+    reload(): Promise<void>;
+
+    /** Shut down the entire cluster gracefully. */
+    shutdown(opts?: { timeout?: number }): Promise<void>;
+
+    /** Enable automatic per-worker metrics aggregation. */
+    enableMetrics(registry: import('./observe').MetricsRegistry, opts?: { interval?: number }): ClusterManager;
+
+    /** Stop the per-worker metrics reporting timer. */
+    disableMetrics(): void;
+
+    /** Enable sticky sessions by hashing client IPs to workers. */
+    enableSticky(server: import('http').Server | import('https').Server, opts?: {
+        hash?: (ip: string, workerCount: number) => number;
+    }): ClusterManager;
+}
+
+/**
+ * High-level clustering helper.
+ */
+export declare function cluster(
+    workerFn: (mgr: ClusterManager) => void,
+    opts?: ClusterOptions
+): ClusterManager;

package/types/env.d.ts

@@ -1,80 +1,80 @@
-// --- Env Field Definition ----------------------------------------
-
-export interface EnvFieldDef {
-    /** Value type for coercion. */
-    type?: 'string' | 'number' | 'integer' | 'boolean' | 'port' | 'array' | 'json' | 'url' | 'enum';
-    /** Field is required. */
-    required?: boolean;
-    /** Default value (or function returning a value). */
-    default?: any | (() => any);
-    /** Min value (number/integer) or min length (string). */
-    min?: number;
-    /** Max value (number/integer) or max length (string). */
-    max?: number;
-    /** Pattern match (string type). */
-    match?: RegExp;
-    /** Delimiter for array type. Default: ','. */
-    separator?: string;
-    /** Allowed values for enum type. */
-    values?: string[];
-}
-
-export type EnvSchema = Record<string, EnvFieldDef>;
-
-export interface EnvLoadOptions {
-    /** Directory to load .env files from. Default: `process.cwd()`. */
-    path?: string;
-    /** Write file values into `process.env`. Default: false. */
-    override?: boolean;
-}
-
-// --- Env Proxy ---------------------------------------------------
-
-export interface Env {
-    /**
-     * Get a variable by key.
-     */
-    (key: string): any;
-
-    /**
-     * Load environment variables, optionally with a typed schema.
-     */
-    load(schema?: EnvSchema, options?: EnvLoadOptions): Record<string, any>;
-
-    /**
-     * Get a variable by key.
-     */
-    get(key: string): any;
-
-    /**
-     * Get a variable by key, throwing if missing.
-     */
-    require(key: string): any;
-
-    /**
-     * Check if a variable exists (in store or `process.env`).
-     */
-    has(key: string): boolean;
-
-    /**
-     * Return all loaded variables.
-     */
-    all(): Record<string, any>;
-
-    /**
-     * Clear all loaded variables from the internal store.
-     */
-    reset(): void;
-
-    /**
-     * Parse a raw `.env` string into key-value pairs.
-     */
-    parse(src: string): Record<string, string>;
-
-    /**
-     * Property access for variables (e.g., `env.PORT`).
-     */
-    [key: string]: any;
-}
-
-export const env: Env;
+// --- Env Field Definition ----------------------------------------
+
+export interface EnvFieldDef {
+    /** Value type for coercion. */
+    type?: 'string' | 'number' | 'integer' | 'boolean' | 'port' | 'array' | 'json' | 'url' | 'enum';
+    /** Field is required. */
+    required?: boolean;
+    /** Default value (or function returning a value). */
+    default?: any | (() => any);
+    /** Min value (number/integer) or min length (string). */
+    min?: number;
+    /** Max value (number/integer) or max length (string). */
+    max?: number;
+    /** Pattern match (string type). */
+    match?: RegExp;
+    /** Delimiter for array type. Default: ','. */
+    separator?: string;
+    /** Allowed values for enum type. */
+    values?: string[];
+}
+
+export type EnvSchema = Record<string, EnvFieldDef>;
+
+export interface EnvLoadOptions {
+    /** Directory to load .env files from. Default: `process.cwd()`. */
+    path?: string;
+    /** Write file values into `process.env`. Default: false. */
+    override?: boolean;
+}
+
+// --- Env Proxy ---------------------------------------------------
+
+export interface Env {
+    /**
+     * Get a variable by key.
+     */
+    (key: string): any;
+
+    /**
+     * Load environment variables, optionally with a typed schema.
+     */
+    load(schema?: EnvSchema, options?: EnvLoadOptions): Record<string, any>;
+
+    /**
+     * Get a variable by key.
+     */
+    get(key: string): any;
+
+    /**
+     * Get a variable by key, throwing if missing.
+     */
+    require(key: string): any;
+
+    /**
+     * Check if a variable exists (in store or `process.env`).
+     */
+    has(key: string): boolean;
+
+    /**
+     * Return all loaded variables.
+     */
+    all(): Record<string, any>;
+
+    /**
+     * Clear all loaded variables from the internal store.
+     */
+    reset(): void;
+
+    /**
+     * Parse a raw `.env` string into key-value pairs.
+     */
+    parse(src: string): Record<string, string>;
+
+    /**
+     * Property access for variables (e.g., `env.PORT`).
+     */
+    [key: string]: any;
+}
+
+export const env: Env;