@buape/carbon 0.13.0 → 0.15.0

package/dist/src/internals/RequestBody.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestBody.js","sourceRoot":"","sources":["../../../src/internals/RequestBody.ts"],"names":[],"mappings":"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"}

package/dist/src/internals/RequestScheduler.d.ts

@@ -0,0 +1,131 @@
+import type { RuntimeProfile } from "../classes/RequestClient.js";
+export type RequestLane = "critical" | "standard" | "background";
+export type RequestSchedulerLaneOptions = {
+    weight?: number;
+    maxQueueSize?: number;
+    staleAfterMs?: number;
+};
+export type RequestSchedulerOptions = {
+    maxConcurrency?: number;
+    maxRateLimitRetries?: number;
+    lanes?: Partial<Record<RequestLane, RequestSchedulerLaneOptions>>;
+};
+export declare const requestSchedulerProfileDefaults: {
+    serverless: {
+        maxConcurrency: number;
+        maxRateLimitRetries: number;
+        lanes: {
+            critical: {
+                weight: number;
+                maxQueueSize: number;
+            };
+            standard: {
+                weight: number;
+                maxQueueSize: number;
+                staleAfterMs: number;
+            };
+            background: {
+                weight: number;
+                maxQueueSize: number;
+                staleAfterMs: number;
+            };
+        };
+    };
+    persistent: {
+        maxConcurrency: number;
+        maxRateLimitRetries: number;
+        lanes: {
+            critical: {
+                weight: number;
+                maxQueueSize: number;
+            };
+            standard: {
+                weight: number;
+                maxQueueSize: number;
+                staleAfterMs: number;
+            };
+            background: {
+                weight: number;
+                maxQueueSize: number;
+                staleAfterMs: number;
+            };
+        };
+    };
+};
+export declare function normalizeRequestSchedulerOptions({ runtimeProfile, maxQueueSize, scheduler }: {
+    runtimeProfile: RuntimeProfile;
+    maxQueueSize?: number;
+    scheduler?: RequestSchedulerOptions;
+}): {
+    maxConcurrency: number;
+    maxRateLimitRetries: number;
+    lanes: {
+        critical: {
+            weight: number;
+            maxQueueSize: number;
+            staleAfterMs: number | undefined;
+        };
+        standard: {
+            weight: number;
+            maxQueueSize: number;
+            staleAfterMs: number;
+        };
+        background: {
+            weight: number;
+            maxQueueSize: number;
+            staleAfterMs: number;
+        };
+    };
+};
+export declare class RequestScheduler<T extends {
+    routeKey: string;
+    priority: RequestLane;
+    enqueuedAt: number;
+    reject(reason?: unknown): void;
+}> {
+    private pendingByRoute;
+    private laneCounts;
+    private laneDropped;
+    private laneSchedule;
+    private laneCursor;
+    private routeCursorByLane;
+    private laneConfig;
+    constructor(config: {
+        lanes: Record<RequestLane, {
+            weight: number;
+            maxQueueSize: number;
+            staleAfterMs?: number;
+        }>;
+    });
+    enqueue(request: T): Error | null;
+    takeNext(options: {
+        isRouteReady(routeKey: string): number;
+        isBucketActive(routeKey: string): boolean;
+    }): {
+        request: T | null;
+        waitMs: number | null;
+    };
+    clear(reason?: Error): void;
+    get size(): number;
+    getMetrics(): {
+        laneCounts: {
+            critical: number;
+            standard: number;
+            background: number;
+        };
+        laneDropped: {
+            critical: number;
+            standard: number;
+            background: number;
+        };
+        oldestByLane: {
+            critical: number;
+            standard: number;
+            background: number;
+        };
+    };
+    private compactRoute;
+    private isStale;
+    private getOldestAgeForLane;
+}
+//# sourceMappingURL=RequestScheduler.d.ts.map

package/dist/src/internals/RequestScheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestScheduler.d.ts","sourceRoot":"","sources":["../../../src/internals/RequestScheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAEjE,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,CAAA;AAEhE,MAAM,MAAM,2BAA2B,GAAG;IACzC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACrC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,2BAA2B,CAAC,CAAC,CAAA;CACjE,CAAA;AAED,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiC3C,CAAA;AAgBD,wBAAgB,gCAAgC,CAAC,EAChD,cAAc,EACd,YAAY,EACZ,SAAS,EACT,EAAE;IACF,cAAc,EAAE,cAAc,CAAA;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,uBAAuB,CAAA;CACnC;;;;;;;;;;;;;;;;;;;;EAuEA;AAED,qBAAa,gBAAgB,CAC5B,CAAC,SAAS;IACT,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,WAAW,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;CAC9B;IAED,OAAO,CAAC,cAAc,CAOnB;IACH,OAAO,CAAC,UAAU,CAIjB;IACD,OAAO,CAAC,WAAW,CAIlB;IACD,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,UAAU,CAAI;IACtB,OAAO,CAAC,iBAAiB,CAIxB;IACD,OAAO,CAAC,UAAU,CAOjB;gBAEW,MAAM,EAAE;QACnB,KAAK,EAAE,MAAM,CACZ,WAAW,EACX;YACC,MAAM,EAAE,MAAM,CAAA;YACd,YAAY,EAAE,MAAM,CAAA;YACpB,YAAY,CAAC,EAAE,MAAM,CAAA;SACrB,CACD,CAAA;KACD;IAYD,OAAO,CAAC,OAAO,EAAE,CAAC;IA4BlB,QAAQ,CAAC,OAAO,EAAE;QACjB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;QACtC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;KACzC,GAAG;QAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;IAkFhD,KAAK,CAAC,MAAM,QAAqC;IAcjD,IAAI,IAAI,WAMP;IAED,UAAU;;;;;;;;;;;;;;;;;IAgBV,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,mBAAmB;CAU3B"}

package/dist/src/internals/RequestScheduler.js

@@ -0,0 +1,245 @@
+export const requestSchedulerProfileDefaults = {
+    serverless: {
+        maxConcurrency: 3,
+        maxRateLimitRetries: 2,
+        lanes: {
+            critical: { weight: 7, maxQueueSize: 2000 },
+            standard: { weight: 2, maxQueueSize: 1500, staleAfterMs: 20_000 },
+            background: { weight: 1, maxQueueSize: 600, staleAfterMs: 7_500 }
+        }
+    },
+    persistent: {
+        maxConcurrency: 8,
+        maxRateLimitRetries: 3,
+        lanes: {
+            critical: { weight: 6, maxQueueSize: 6000 },
+            standard: { weight: 3, maxQueueSize: 10_000, staleAfterMs: 60_000 },
+            background: { weight: 1, maxQueueSize: 5_000, staleAfterMs: 20_000 }
+        }
+    }
+};
+function assertPositiveInteger(name, value) {
+    if (value === undefined)
+        return;
+    if (!Number.isInteger(value) || value < 1) {
+        throw new Error(`${name} must be an integer greater than or equal to 1`);
+    }
+}
+function assertNonNegativeInteger(name, value) {
+    if (value === undefined)
+        return;
+    if (!Number.isInteger(value) || value < 0) {
+        throw new Error(`${name} must be a non-negative integer`);
+    }
+}
+export function normalizeRequestSchedulerOptions({ runtimeProfile, maxQueueSize, scheduler }) {
+    assertPositiveInteger("scheduler.maxConcurrency", scheduler?.maxConcurrency);
+    assertNonNegativeInteger("scheduler.maxRateLimitRetries", scheduler?.maxRateLimitRetries);
+    const defaults = requestSchedulerProfileDefaults[runtimeProfile];
+    const fallbackQueueSize = Math.max(1, maxQueueSize ?? 1000);
+    const laneInput = scheduler?.lanes;
+    return {
+        maxConcurrency: scheduler?.maxConcurrency ?? defaults.maxConcurrency,
+        maxRateLimitRetries: scheduler?.maxRateLimitRetries ?? defaults.maxRateLimitRetries,
+        lanes: {
+            critical: {
+                weight: Math.max(1, laneInput?.critical?.weight ?? defaults.lanes.critical.weight),
+                maxQueueSize: Math.max(1, laneInput?.critical?.maxQueueSize ??
+                    maxQueueSize ??
+                    defaults.lanes.critical.maxQueueSize ??
+                    fallbackQueueSize),
+                staleAfterMs: laneInput?.critical?.staleAfterMs
+            },
+            standard: {
+                weight: Math.max(1, laneInput?.standard?.weight ?? defaults.lanes.standard.weight),
+                maxQueueSize: Math.max(1, laneInput?.standard?.maxQueueSize ??
+                    maxQueueSize ??
+                    defaults.lanes.standard.maxQueueSize ??
+                    fallbackQueueSize),
+                staleAfterMs: laneInput?.standard?.staleAfterMs ??
+                    defaults.lanes.standard.staleAfterMs
+            },
+            background: {
+                weight: Math.max(1, laneInput?.background?.weight ?? defaults.lanes.background.weight),
+                maxQueueSize: Math.max(1, laneInput?.background?.maxQueueSize ??
+                    maxQueueSize ??
+                    defaults.lanes.background.maxQueueSize ??
+                    fallbackQueueSize),
+                staleAfterMs: laneInput?.background?.staleAfterMs ??
+                    defaults.lanes.background.staleAfterMs
+            }
+        }
+    };
+}
+export class RequestScheduler {
+    pendingByRoute = new Map();
+    laneCounts = {
+        critical: 0,
+        standard: 0,
+        background: 0
+    };
+    laneDropped = {
+        critical: 0,
+        standard: 0,
+        background: 0
+    };
+    laneSchedule = [];
+    laneCursor = 0;
+    routeCursorByLane = {
+        critical: 0,
+        standard: 0,
+        background: 0
+    };
+    laneConfig;
+    constructor(config) {
+        this.laneConfig = config.lanes;
+        for (const lane of ["critical", "standard", "background"]) {
+            for (let i = 0; i < this.laneConfig[lane].weight; i += 1) {
+                this.laneSchedule.push(lane);
+            }
+        }
+        if (this.laneSchedule.length === 0) {
+            this.laneSchedule = ["critical", "standard", "background"];
+        }
+    }
+    enqueue(request) {
+        const lane = request.priority;
+        const laneConfig = this.laneConfig[lane];
+        if (this.laneCounts[lane] >= laneConfig.maxQueueSize) {
+            this.laneDropped[lane] += 1;
+            return new Error(`Request queue for ${lane} is full (${this.laneCounts[lane]} / ${laneConfig.maxQueueSize}).`);
+        }
+        const routeQueues = this.pendingByRoute.get(request.routeKey) ??
+            {
+                critical: [],
+                standard: [],
+                background: []
+            };
+        routeQueues[lane].push(request);
+        this.pendingByRoute.set(request.routeKey, routeQueues);
+        this.laneCounts[lane] += 1;
+        return null;
+    }
+    takeNext(options) {
+        const now = Date.now();
+        let earliestWaitMs = null;
+        for (let laneOffset = 0; laneOffset < this.laneSchedule.length; laneOffset += 1) {
+            const lane = this.laneSchedule[(this.laneCursor + laneOffset) % this.laneSchedule.length];
+            if (!lane || this.laneCounts[lane] <= 0)
+                continue;
+            const routeKeys = [];
+            for (const [routeKey, queues] of this.pendingByRoute.entries()) {
+                if (queues[lane].length > 0) {
+                    routeKeys.push(routeKey);
+                }
+            }
+            if (routeKeys.length === 0)
+                continue;
+            const startIndex = this.routeCursorByLane[lane] % routeKeys.length;
+            for (let routeOffset = 0; routeOffset < routeKeys.length; routeOffset += 1) {
+                const routeKey = routeKeys[(startIndex + routeOffset) % routeKeys.length];
+                if (!routeKey)
+                    continue;
+                const routeQueues = this.pendingByRoute.get(routeKey);
+                if (!routeQueues)
+                    continue;
+                const queue = routeQueues[lane];
+                while (queue.length > 0 && this.isStale(queue[0], now)) {
+                    const stale = queue.shift();
+                    if (!stale)
+                        break;
+                    this.laneCounts[lane] -= 1;
+                    this.laneDropped[lane] += 1;
+                    stale.reject(new Error(`Dropped stale ${lane} request after ${now - stale.enqueuedAt}ms`));
+                }
+                if (queue.length === 0) {
+                    this.compactRoute(routeKey, routeQueues);
+                    continue;
+                }
+                const waitMs = options.isRouteReady(routeKey);
+                if (waitMs > 0) {
+                    earliestWaitMs =
+                        earliestWaitMs === null ? waitMs : Math.min(earliestWaitMs, waitMs);
+                    continue;
+                }
+                if (options.isBucketActive(routeKey)) {
+                    earliestWaitMs =
+                        earliestWaitMs === null ? 5 : Math.min(earliestWaitMs, 5);
+                    continue;
+                }
+                const dequeued = queue.shift();
+                if (!dequeued)
+                    continue;
+                this.laneCounts[lane] -= 1;
+                this.routeCursorByLane[lane] =
+                    (startIndex + routeOffset + 1) % routeKeys.length;
+                this.laneCursor =
+                    (this.laneCursor + laneOffset + 1) % this.laneSchedule.length;
+                this.compactRoute(routeKey, routeQueues);
+                return { request: dequeued, waitMs: null };
+            }
+        }
+        return { request: null, waitMs: earliestWaitMs };
+    }
+    clear(reason = new Error("Request queue cleared")) {
+        for (const routeQueues of this.pendingByRoute.values()) {
+            for (const lane of ["critical", "standard", "background"]) {
+                for (const request of routeQueues[lane]) {
+                    request.reject(reason);
+                }
+            }
+        }
+        this.pendingByRoute.clear();
+        this.laneCounts.critical = 0;
+        this.laneCounts.standard = 0;
+        this.laneCounts.background = 0;
+    }
+    get size() {
+        return (this.laneCounts.critical +
+            this.laneCounts.standard +
+            this.laneCounts.background);
+    }
+    getMetrics() {
+        return {
+            laneCounts: {
+                ...this.laneCounts
+            },
+            laneDropped: {
+                ...this.laneDropped
+            },
+            oldestByLane: {
+                critical: this.getOldestAgeForLane("critical"),
+                standard: this.getOldestAgeForLane("standard"),
+                background: this.getOldestAgeForLane("background")
+            }
+        };
+    }
+    compactRoute(routeKey, routeQueues) {
+        if (routeQueues.critical.length +
+            routeQueues.standard.length +
+            routeQueues.background.length ===
+            0) {
+            this.pendingByRoute.delete(routeKey);
+        }
+    }
+    isStale(request, now = Date.now()) {
+        if (!request)
+            return false;
+        const staleAfterMs = this.laneConfig[request.priority].staleAfterMs;
+        if (!staleAfterMs || staleAfterMs <= 0)
+            return false;
+        return now - request.enqueuedAt > staleAfterMs;
+    }
+    getOldestAgeForLane(lane) {
+        const now = Date.now();
+        let oldest = 0;
+        for (const routeQueues of this.pendingByRoute.values()) {
+            const head = routeQueues[lane][0];
+            if (!head)
+                continue;
+            oldest = Math.max(oldest, now - head.enqueuedAt);
+        }
+        return oldest;
+    }
+}
+//# sourceMappingURL=RequestScheduler.js.map

package/dist/src/internals/RequestScheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestScheduler.js","sourceRoot":"","sources":["../../../src/internals/RequestScheduler.ts"],"names":[],"mappings":"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"}

package/dist/src/internals/TemporaryListenerManager.d.ts

@@ -0,0 +1,20 @@
+import type { AnyListener } from "../abstracts/BaseListener.js";
+import type { Client } from "../classes/Client.js";
+export declare class TemporaryListenerManager {
+    private client;
+    private listeners;
+    private defaultTimeout;
+    constructor(client: Client, defaultTimeout?: number);
+    register(listener: AnyListener, timeoutMs?: number): () => void;
+    unregister(id: string | AnyListener): boolean;
+    private generateId;
+    getCount(): number;
+    cleanup(): void;
+    getMetrics(): {
+        count: number;
+        oldestAge: number;
+        newestAge: number;
+        averageAge: number;
+    };
+}
+//# sourceMappingURL=TemporaryListenerManager.d.ts.map

package/dist/src/internals/TemporaryListenerManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemporaryListenerManager.d.ts","sourceRoot":"","sources":["../../../src/internals/TemporaryListenerManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAQlD,qBAAa,wBAAwB;IACpC,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,SAAS,CAAiD;IAClE,OAAO,CAAC,cAAc,CAAQ;gBAElB,MAAM,EAAE,MAAM,EAAE,cAAc,SAAS;IAKnD,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI;IAwB/D,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO;IAkB7C,OAAO,CAAC,UAAU;IAIlB,QAAQ,IAAI,MAAM;IAIlB,OAAO,IAAI,IAAI;IAMf,UAAU;;;;;;CAaV"}

package/dist/src/internals/TemporaryListenerManager.js

@@ -0,0 +1,59 @@
+export class TemporaryListenerManager {
+    client;
+    listeners = new Map();
+    defaultTimeout;
+    constructor(client, defaultTimeout = 300000) {
+        this.client = client;
+        this.defaultTimeout = defaultTimeout;
+    }
+    register(listener, timeoutMs) {
+        const id = this.generateId(listener);
+        const timeout = timeoutMs ?? this.defaultTimeout;
+        this.unregister(id);
+        const timeoutHandle = setTimeout(() => {
+            this.unregister(id);
+            console.warn(`[TemporaryListenerManager] Listener ${listener.constructor.name} (${id}) timed out after ${timeout}ms and was automatically removed`);
+        }, timeout);
+        this.listeners.set(id, {
+            listener,
+            timeout: timeoutHandle,
+            timestamp: Date.now()
+        });
+        this.client.registerListener(listener);
+        return () => this.unregister(id);
+    }
+    unregister(id) {
+        const listenerId = typeof id === "string" ? id : this.generateId(id);
+        const entry = this.listeners.get(listenerId);
+        if (!entry)
+            return false;
+        clearTimeout(entry.timeout);
+        const idx = this.client.listeners.indexOf(entry.listener);
+        if (idx > -1) {
+            this.client.listeners.splice(idx, 1);
+        }
+        this.listeners.delete(listenerId);
+        return true;
+    }
+    generateId(listener) {
+        return `${listener.type}_${listener.constructor.name}_${Date.now()}_${Math.random().toString(36).substring(7)}`;
+    }
+    getCount() {
+        return this.listeners.size;
+    }
+    cleanup() {
+        for (const id of this.listeners.keys()) {
+            this.unregister(id);
+        }
+    }
+    getMetrics() {
+        const ages = Array.from(this.listeners.values()).map((entry) => Date.now() - entry.timestamp);
+        return {
+            count: this.listeners.size,
+            oldestAge: ages.length > 0 ? Math.max(...ages) : 0,
+            newestAge: ages.length > 0 ? Math.min(...ages) : 0,
+            averageAge: ages.length > 0 ? ages.reduce((a, b) => a + b, 0) / ages.length : 0
+        };
+    }
+}
+//# sourceMappingURL=TemporaryListenerManager.js.map

package/dist/src/internals/TemporaryListenerManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemporaryListenerManager.js","sourceRoot":"","sources":["../../../src/internals/TemporaryListenerManager.ts"],"names":[],"mappings":"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"}

package/dist/src/permissions.d.ts

@@ -50,6 +50,7 @@ export declare const Permission: {
     readonly SendPolls: bigint;
     readonly UseExternalApps: bigint;
     readonly PinMessages: bigint;
+    readonly BypassSlowmode: bigint;
 };
 export declare const maxPermissions: bigint[];
 //# sourceMappingURL=permissions.d.ts.map

package/dist/src/permissions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../src/permissions.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAsB,CAAA;AAE7C,eAAO,MAAM,cAAc,UAA4B,CAAA"}
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../src/permissions.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAsB,CAAA;AAE7C,eAAO,MAAM,cAAc,UAA4B,CAAA"}

package/dist/src/plugins/client-manager/ClientManager.d.ts

@@ -32,6 +32,27 @@ export interface ClientSetupOptions {
      */
     setEventsUrlOnDevPortal?: boolean;
 }
+export interface ClientManagerStartupOptions {
+    /**
+     * Maximum number of clients initialized in parallel during startup.
+     */
+    concurrency?: number;
+    /**
+     * If true, startup stops scheduling new clients after first failure.
+     */
+    failFast?: boolean;
+}
+export interface ClientManagerStartupResult {
+    total: number;
+    successes: number;
+    failures: number;
+    completedAt: number;
+    results: Array<{
+        clientId: string;
+        status: "success" | "error";
+        error?: string;
+    }>;
+}
 /**
  * Options for the ClientManager
  */
@@ -51,13 +72,17 @@ export interface ClientManagerOptions {
     /**
      * Array of application credentials.
      * If you need dynamic application loading (e.g., from a database),
-     * extend ClientManager and override getClient/getAllClients/getClientIds instead.
+     * extend ClientManager and override getClient/getClients/getClientIds instead.
      */
     applications?: ApplicationCredentials[];
     /**
      * The initial setup options for the clients, this will be passed to clientManager#setupClient
      */
     initialSetupOptions?: ClientSetupOptions;
+    /**
+     * Startup orchestration controls.
+     */
+    startup?: ClientManagerStartupOptions;
 }
 /**
  * Manages multiple Discord applications, routing requests to the appropriate client
@@ -65,7 +90,7 @@ export interface ClientManagerOptions {
  *
  * To use with a database, extend this class and override:
  * - getClient(clientId) - Return the client for a specific ID (or create it)
- * - getAllClients() - Return all available clients
+ * - getClients() - Return all available clients
  * - getClientIds() - Return all available client IDs
  *
  * Then call setupClient(credentials) to create clients on-demand.
@@ -92,11 +117,14 @@ export declare class ClientManager {
     protected staticApplications: ApplicationCredentials[];
     protected initialHandlers: ConstructorParameters<typeof Client>[1];
     protected initialPlugins: ConstructorParameters<typeof Client>[2];
+    private startupPromise;
     /**
      * Creates a new ClientManager
      * @param options Configuration options including shared settings and per-app credentials
      */
     constructor(options: ClientManagerOptions, handlers: ConstructorParameters<typeof Client>[1], plugins: ConstructorParameters<typeof Client>[2]);
+    whenReady(): Promise<ClientManagerStartupResult>;
+    private initializeClients;
     /**
      * Setup a client from credentials.
      *

package/dist/src/plugins/client-manager/ClientManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClientManager.d.ts","sourceRoot":"","sources":["../../../../src/plugins/client-manager/ClientManager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ClientManager.d.ts","sourceRoot":"","sources":["../../../../src/plugins/client-manager/ClientManager.ts"],"names":[],"mappings":"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"}