@seedcord/core 0.11.0 → 0.12.0-next.0

package/dist/PluginHost-CYe-UVpp.mjs

@@ -0,0 +1,552 @@
+import { _ as MemoryDriver, t as Bus, v as ShutdownPhase, y as StartupPhase } from "./Bus-W1K-uMeO.mjs";
+import { SeedcordErrorCode, isSeedcordError } from "@seedcord/errors";
+import { SeedcordError, SeedcordRangeError, SeedcordTypeError } from "@seedcord/errors/internal";
+import { FRAMEWORK_CHANNELS, Logger } from "@seedcord/logger";
+import { HostPluginKeys } from "@seedcord/types/internal";
+
+//#region src/hmr/devChannel.ts
+let channel;
+/** @internal */
+function setDevChannel(next) {
+	channel = next;
+}
+/** @internal */
+function getDevChannel() {
+	return channel;
+}
+
+//#endregion
+//#region src/plugin/lifecycle.ts
+const DEFAULT_INIT_TIMEOUT_MS = 15e3;
+const DEFAULT_READY_TIMEOUT_MS = 15e3;
+const DEFAULT_DISPOSE_TIMEOUT_MS = 1e4;
+function timeoutOf(field, declared, fallback, pluginName) {
+	if (declared === void 0) return fallback;
+	if (!Number.isFinite(declared) || declared <= 0) throw new SeedcordRangeError(SeedcordErrorCode.LifecycleInvalidTimeout, [`${pluginName}'s lifecycle ${field}.timeout`, declared]);
+	return declared;
+}
+/** @internal */
+function resolveLifecycleSpec(spec, pluginName) {
+	return {
+		init: {
+			phase: spec?.init?.phase ?? 1,
+			timeout: timeoutOf("init", spec?.init?.timeout, DEFAULT_INIT_TIMEOUT_MS, pluginName)
+		},
+		ready: { timeout: timeoutOf("ready", spec?.ready?.timeout, DEFAULT_READY_TIMEOUT_MS, pluginName) },
+		dispose: {
+			phase: spec?.dispose?.phase ?? 3,
+			timeout: timeoutOf("dispose", spec?.dispose?.timeout, DEFAULT_DISPOSE_TIMEOUT_MS, pluginName)
+		}
+	};
+}
+
+//#endregion
+//#region src/plugin/Plugin.ts
+let attaching;
+/** @internal */
+const resolvedSpecSlot = Symbol("seedcord:plugin:spec");
+/** @internal */
+const loggerSlot = Symbol("seedcord:plugin:logger");
+/** @internal */
+const scopeSlot = Symbol("seedcord:plugin:scope");
+/** @internal */
+const FixedScope = Symbol("seedcord:plugin:fixed-scope");
+/**
+* Base class for a seedcord plugin. Extend it and implement `init()`. `this.core` is the running
+* bot.
+*
+* Your constructor takes the host first and passes it to `super()`. Add your own parameters after
+* it. `attach()` types them at the call site.
+*
+* A plugin that narrows `transport` or `runtime` in `Opts` passes the same values to `super()`.
+* `attach()` throws when either one differs from the bot's.
+*
+* @typeParam Opts - Where this plugin may attach.
+* @typeParam TCore - The `Core` each transport binds `this.core` to.
+* @typeParam Fixed - The `transport` and `runtime` values a transport's own `Plugin` base sets. Leave it out.
+*
+* @example
+* ```ts
+* class Analytics extends Plugin<{ transport: 'gateway' }> {
+*     constructor(
+*         host: CoreBase,
+*         private readonly apiKey: string
+*     ) {
+*         super(host, { transport: 'gateway', init: { phase: StartupPhase.Login } });
+*     }
+*
+*     public async init(): Promise<void> {
+*         await this.connect(this.apiKey);
+*     }
+* }
+*
+* seedcord.attach('analytics', Analytics, apiKey);
+* ```
+*/
+var Plugin = class {
+	host;
+	/** @internal */
+	static [FixedScope] = {};
+	/** @internal */
+	[resolvedSpecSlot];
+	/** @internal */
+	[loggerSlot];
+	/** @internal */
+	[scopeSlot];
+	/** Logs under the plugin's class name, on the channel its attach key sets. */
+	logger;
+	#kv;
+	constructor(host, ...[spec]) {
+		this.host = host;
+		const attachment = attaching;
+		attaching = void 0;
+		this.#kv = attachment?.kv;
+		this.logger = new Logger(this.constructor.name, attachment && { channel: attachment.key });
+		this[loggerSlot] = this.logger;
+		this[resolvedSpecSlot] = resolveLifecycleSpec(spec, this.constructor.name);
+		const passed = spec;
+		const fixed = new.target[FixedScope];
+		this[scopeSlot] = {
+			transport: fixed.transport ?? passed?.transport ?? "any",
+			runtime: fixed.runtime ?? passed?.runtime ?? "any"
+		};
+	}
+	/** The host, typed to the transport whose `Plugin` base this class extends. */
+	get core() {
+		return this.host;
+	}
+	/**
+	* This plugin's records in the bot's `config.kv`, stored under its attach key. Two attachments of
+	* one plugin class each get their own records. Renaming the attach key leaves the records under
+	* the old key behind.
+	*
+	* @throws A **SeedcordTypeError** when something built the plugin with `new` outside `attach()`.
+	* @example
+	* ```ts
+	* // works in a field initializer, the constructor, and every method
+	* private readonly jobs = this.kv.collection<Job>('job');
+	* ```
+	*/
+	get kv() {
+		if (!this.#kv) throw new SeedcordTypeError(SeedcordErrorCode.CorePluginKvOutsideAttach, [this.constructor.name]);
+		return this.#kv;
+	}
+	/**
+	* Rejects the options this plugin got.
+	*
+	* @param reason - Why the options are invalid.
+	* @throws A **SeedcordTypeError** every time, with the plugin class name and `reason` in its message.
+	*/
+	rejectOptions(reason) {
+		throw new SeedcordTypeError(SeedcordErrorCode.PluginOptionsRejected, [this.constructor.name, reason]);
+	}
+	/** Override to reload plugin state on an HMR update. */
+	onHmr(_event) {
+		return Promise.resolve();
+	}
+	/**
+	* Registers critical file patterns that should trigger a full restart when changed in Dev HMR.
+	* @param patterns - Glob patterns. A relative one resolves against `root` from `seedcord.config.ts`.
+	*/
+	registerCriticalFiles(patterns) {
+		getDevChannel()?.send("seedcord:register-critical-files", { patterns });
+	}
+};
+/** @internal */
+function resolvedLifecycleSpecOf(plugin) {
+	return plugin[resolvedSpecSlot];
+}
+/** @internal */
+function extendsThisCorePlugin(ctor) {
+	return ctor.prototype instanceof Plugin;
+}
+/** @internal */
+function pluginLoggerOf(plugin) {
+	return plugin[loggerSlot];
+}
+/** @internal */
+function declaredScopeOf(plugin) {
+	return plugin[scopeSlot];
+}
+/** @internal */
+function constructAttached(key, kv, construct) {
+	attaching = {
+		key,
+		kv
+	};
+	try {
+		return construct();
+	} finally {
+		attaching = void 0;
+	}
+}
+
+//#endregion
+//#region src/kv/GuardedDriver.ts
+function translated(operation, key, error) {
+	if (isSeedcordError(error)) return error;
+	return new SeedcordError(SeedcordErrorCode.CoreKvDriverFailed, [operation, key], { cause: error });
+}
+async function guard(operation, key, run) {
+	try {
+		return await run();
+	} catch (error) {
+		throw translated(operation, key, error);
+	}
+}
+var GuardedDriver = class {
+	driver;
+	constructor(driver) {
+		this.driver = driver;
+	}
+	async get(key) {
+		return guard("read", key, () => this.driver.get(key));
+	}
+	async set(key, value, ttlMs) {
+		await guard("write", key, () => this.driver.set(key, value, ttlMs));
+	}
+	async delete(key) {
+		await guard("delete", key, () => this.driver.delete(key));
+	}
+	async *entries(prefix) {
+		try {
+			for await (const entry of this.driver.entries(prefix)) yield entry;
+		} catch (error) {
+			throw translated("list", prefix, error);
+		}
+	}
+};
+
+//#endregion
+//#region src/kv/KeyedQueue.ts
+var KeyedQueue = class {
+	tails = /* @__PURE__ */ new Map();
+	run(key, task) {
+		const run = (this.tails.get(key) ?? Promise.resolve()).then(task);
+		const tail = run.then(() => void 0, () => void 0);
+		this.tails.set(key, tail);
+		tail.then(() => {
+			if (this.tails.get(key) === tail) this.tails.delete(key);
+		});
+		return run;
+	}
+};
+
+//#endregion
+//#region src/kv/KvCollection.ts
+/**
+* The records of one type, stored under one name in `config.kv`. Get one from
+* `kv.collection<T>('name')`.
+*
+* Every record goes through JSON on its way in and out. A `Date` you store reads back from `get()`
+* as an ISO string.
+*
+* @example
+* ```ts
+* interface Profile { bio: string; joinedAt: Date }
+* const profiles = this.core.kv.collection<Profile>('profile');
+*
+* await profiles.set(user.id, { bio: 'hi', joinedAt: new Date() });
+* const profile = await profiles.get(user.id); // { bio: string; joinedAt: string } | undefined
+* await profiles.delete(user.id);
+* ```
+*/
+var KvCollection = class {
+	#driver;
+	#prefix;
+	#updates;
+	constructor(driver, prefix, updates) {
+		this.#driver = driver;
+		this.#prefix = prefix;
+		this.#updates = updates;
+	}
+	/** Reads the record stored under `id`. Resolves to `undefined` when nothing is there or the record expired. */
+	async get(id) {
+		const key = this.#prefix + id;
+		const raw = await this.#driver.get(key);
+		const value = this.#liveValue(raw);
+		if (raw !== void 0 && value === void 0) await this.#deleteExpired(key);
+		return value;
+	}
+	/**
+	* Stores `value` under `id` and replaces whatever was there.
+	*
+	* @param ttlMs - How long the record lasts, in milliseconds. Leave it out to keep the record until you delete it.
+	*/
+	async set(id, value, ttlMs) {
+		const key = this.#prefix + id;
+		await this.#updates.run(key, async () => this.#write(key, value, ttlMs));
+	}
+	/** Removes the record under `id`. */
+	async delete(id) {
+		const key = this.#prefix + id;
+		await this.#updates.run(key, async () => this.#driver.delete(key));
+	}
+	/**
+	* Stores what `next` returns for the record under `id`, then resolves to that value. `next` gets
+	* the current record, or `undefined` when there is none.
+	*
+	* Use it over a `get()` then a `set()` when two calls can change one record at the same time.
+	* `set()`, `delete()`, and `update()` calls on one id run one after the other in this process.
+	* None of them loses another's change. Two processes sharing one backend can still both read
+	* before either writes.
+	*
+	* @param ttlMs - How many milliseconds the stored record lasts. Pass a function to work it out from the record. Leave it out to keep the record until you delete it.
+	* @example
+	* ```ts
+	* // counts a run of the command and resolves to the new count
+	* const runs = await counts.update(user.id, (count) => (count ?? 0) + 1);
+	* ```
+	*/
+	async update(id, next, ttlMs) {
+		const key = this.#prefix + id;
+		return this.#updates.run(key, async () => {
+			const value = next(this.#liveValue(await this.#driver.get(key)));
+			await this.#write(key, value, typeof ttlMs === "function" ? ttlMs(value) : ttlMs);
+			return value;
+		});
+	}
+	/**
+	* Yields `[id, record]` for every record in this collection that hasn't expired. Use it to read
+	* back what the bot saved before a restart.
+	*
+	* @throws A **SeedcordError** when the backend can't list its keys, like `@keyv/memcache`.
+	* @example
+	* ```ts
+	* // schedules every saved reminder again after a restart
+	* for await (const [id, reminder] of reminders.entries()) schedule(id, reminder);
+	* ```
+	*/
+	async *entries() {
+		const expired = [];
+		try {
+			for await (const [key, raw] of this.#driver.entries(this.#prefix)) {
+				const value = this.#liveValue(raw);
+				if (value === void 0) expired.push(key);
+				else yield [key.slice(this.#prefix.length), value];
+			}
+		} finally {
+			await Promise.all(expired.map(async (key) => this.#deleteExpired(key)));
+		}
+	}
+	async #write(key, value, ttlMs) {
+		const envelope = ttlMs === void 0 ? { value } : {
+			value,
+			expiresAt: Date.now() + ttlMs
+		};
+		await this.#driver.set(key, JSON.stringify(envelope), ttlMs);
+	}
+	async #deleteExpired(key) {
+		await this.#updates.run(key, async () => {
+			const raw = await this.#driver.get(key);
+			if (raw !== void 0 && this.#liveValue(raw) === void 0) await this.#driver.delete(key);
+		});
+	}
+	#liveValue(raw) {
+		if (raw === void 0) return void 0;
+		const envelope = JSON.parse(raw);
+		if (envelope.expiresAt !== void 0 && envelope.expiresAt <= Date.now()) return void 0;
+		return envelope.value;
+	}
+};
+
+//#endregion
+//#region src/kv/Kv.ts
+function keyPrefix(path) {
+	return path.map((segment) => `${encodeURIComponent(segment)}:`).join("");
+}
+/**
+* The bot's key-value store, or one prefixed slice of it. `core.kv` holds your handlers' records. A
+* plugin's `this.kv` holds the plugin's.
+*/
+var Kv = class {
+	/** What you passed as `config.kv`. Register its type in `KvTypes` to call the library's own methods on it. */
+	driver;
+	#guarded;
+	#path;
+	#updates = new KeyedQueue();
+	constructor(driver, ...path) {
+		this.driver = driver;
+		this.#guarded = new GuardedDriver(driver);
+		this.#path = path;
+	}
+	/**
+	* Records of one type under `name`. Pass the type argument. A record type holding a function,
+	* `Map`, `Set`, or `bigint` fails to compile here.
+	*/
+	collection(name) {
+		return new KvCollection(this.#guarded, keyPrefix([...this.#path, name]), this.#updates);
+	}
+};
+
+//#endregion
+//#region src/rateLimiter/KvRateLimiter.ts
+function limitedResult(live, now) {
+	const resetAt = live.reduce((earliest, exp) => Math.min(earliest, exp), Number.POSITIVE_INFINITY);
+	return {
+		limited: true,
+		resetAt,
+		remaining: 0,
+		retryAfterMs: resetAt - now
+	};
+}
+function openResult(remaining) {
+	return {
+		limited: false,
+		resetAt: 0,
+		remaining,
+		retryAfterMs: 0
+	};
+}
+function limitOf(window) {
+	return Math.max(1, window.limit ?? 1);
+}
+function liveUses(stored, now) {
+	return (stored ?? []).filter((exp) => exp > now);
+}
+var KvRateLimiter = class {
+	uses;
+	constructor(kv) {
+		this.uses = kv.collection("rate-limit");
+	}
+	async charge(key, window) {
+		const limit = limitOf(window);
+		let result;
+		await this.uses.update(key, (stored) => {
+			const now = Date.now();
+			const live = liveUses(stored, now);
+			const limited = live.length >= limit;
+			if (!limited) live.push(now + window.windowMs);
+			result = limited ? limitedResult(live, now) : openResult(limit - live.length);
+			return live;
+		}, (live) => live.reduce((latest, exp) => Math.max(latest, exp), 0) - Date.now());
+		return result;
+	}
+	async peek(key, window) {
+		const stored = await this.uses.get(key);
+		const now = Date.now();
+		const limit = limitOf(window);
+		const live = liveUses(stored, now);
+		return live.length >= limit ? limitedResult(live, now) : openResult(limit - live.length);
+	}
+	async reset(key) {
+		await this.uses.delete(key);
+	}
+};
+
+//#endregion
+//#region src/plugin/splitPluginKey.ts
+function splitPluginKey(key) {
+	const dot = key.indexOf(".");
+	return dot === -1 ? {
+		head: key,
+		leaf: void 0
+	} : {
+		head: key.slice(0, dot),
+		leaf: key.slice(dot + 1)
+	};
+}
+
+//#endregion
+//#region src/plugin/PluginHost.ts
+const RESERVED_KEYS = new Set(FRAMEWORK_CHANNELS);
+const attachmentsSlot = Symbol("seedcord:host:attachments");
+const sealSlot = Symbol("seedcord:host:seal");
+/** Base class for a plugin host. */
+var PluginHost = class {
+	/** @see {@link Bus} */
+	bus;
+	/** @see {@link Kv} */
+	kv;
+	/** @see {@link IRateLimiter} */
+	rateLimiter;
+	#sealed = false;
+	#attachments = [];
+	#groups = /* @__PURE__ */ new Map();
+	#scope;
+	constructor(transport, runtime, driver) {
+		this.#scope = {
+			transport,
+			runtime
+		};
+		this.bus = new Bus(this);
+		const kvDriver = driver ?? new MemoryDriver();
+		this.kv = new Kv(kvDriver, "app");
+		this.rateLimiter = new KvRateLimiter(new Kv(kvDriver, "seedcord"));
+	}
+	/** @internal */
+	get [attachmentsSlot]() {
+		return this.#attachments;
+	}
+	/** @internal */
+	[sealSlot]() {
+		this.#sealed = true;
+	}
+	/** @internal codegen reads this to emit the `Core` augmentation */
+	get [HostPluginKeys]() {
+		return this.#attachments.map((attachment) => attachment.key);
+	}
+	attach(key, Plugin, ...args) {
+		if (this.#sealed) throw new SeedcordError(SeedcordErrorCode.CorePluginAfterInit);
+		const { head, leaf } = splitPluginKey(key);
+		if (RESERVED_KEYS.has(head)) throw new SeedcordTypeError(SeedcordErrorCode.CorePluginReservedChannel, [head]);
+		if (head === "" || leaf === "") throw new SeedcordTypeError(SeedcordErrorCode.CorePluginKeyMalformed, [key, "has an empty part."]);
+		if (leaf?.includes(".")) throw new SeedcordTypeError(SeedcordErrorCode.CorePluginKeyMalformed, [key, "has more than one dot."]);
+		this.#assertFree(head, leaf, key);
+		if (!extendsThisCorePlugin(Plugin)) throw new SeedcordTypeError(SeedcordErrorCode.CorePluginFromOtherCore, [Plugin.name]);
+		const kv = new Kv(this.kv.driver, "plugins", key);
+		const instance = constructAttached(key, kv, () => new Plugin(this, ...args));
+		this.#assertScope(Plugin.name, declaredScopeOf(instance));
+		this.#attachments.push({
+			key,
+			instance,
+			spec: resolvedLifecycleSpecOf(instance)
+		});
+		if (leaf === void 0) return Object.assign(this, { [key]: instance });
+		this.#groupFor(head)[leaf] = instance;
+		return this;
+	}
+	#assertFree(head, leaf, key) {
+		if (leaf === void 0) {
+			if (this.#groups.has(key)) throw new SeedcordTypeError(SeedcordErrorCode.CorePluginKeyHoldsGroup, [key]);
+			if (key in this) throw new SeedcordTypeError(SeedcordErrorCode.CorePluginKeyExists, [key]);
+			return;
+		}
+		const group = this.#groups.get(head);
+		if (!group) {
+			if (head in this) throw new SeedcordTypeError(SeedcordErrorCode.CorePluginGroupTaken, [head, key]);
+			return;
+		}
+		if (Object.hasOwn(group, leaf)) throw new SeedcordTypeError(SeedcordErrorCode.CorePluginKeyExists, [key]);
+	}
+	#assertScope(pluginName, declared) {
+		for (const axis of ["transport", "runtime"]) {
+			const host = this.#scope[axis];
+			if (declared[axis] === "any" || declared[axis] === host) continue;
+			throw new SeedcordTypeError(SeedcordErrorCode.CorePluginScopeMismatch, [
+				pluginName,
+				axis,
+				declared[axis],
+				host
+			]);
+		}
+	}
+	#groupFor(head) {
+		const existing = this.#groups.get(head);
+		if (existing) return existing;
+		const group = Object.create(null);
+		this.#groups.set(head, group);
+		Object.assign(this, { [head]: group });
+		return group;
+	}
+};
+function attachmentsOf(host) {
+	return host[attachmentsSlot];
+}
+function sealAttachments(host) {
+	host[sealSlot]();
+}
+
+//#endregion
+export { FixedScope as a, getDevChannel as c, splitPluginKey as i, setDevChannel as l, attachmentsOf as n, Plugin as o, sealAttachments as r, pluginLoggerOf as s, PluginHost as t };
+//# sourceMappingURL=PluginHost-CYe-UVpp.mjs.map

package/dist/PluginHost-CYe-UVpp.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginHost-CYe-UVpp.mjs","names":[],"sources":["../src/hmr/devChannel.ts","../src/plugin/lifecycle.ts","../src/plugin/Plugin.ts","../src/kv/GuardedDriver.ts","../src/kv/KeyedQueue.ts","../src/kv/KvCollection.ts","../src/kv/Kv.ts","../src/rateLimiter/KvRateLimiter.ts","../src/plugin/splitPluginKey.ts","../src/plugin/PluginHost.ts"],"sourcesContent":["import type { DevChannel, SeedcordCliEvents, SeedcordFrameworkEvents } from '@seedcord/types/internal';\n\nexport type CliChannel = DevChannel<SeedcordFrameworkEvents, SeedcordCliEvents>;\n\n// one module instance per process, the HmrManager write and every framework read share it\nlet channel: CliChannel | undefined;\n\n/** @internal */\nexport function setDevChannel(next: CliChannel | undefined): void {\n    channel = next;\n}\n\n/** @internal */\nexport function getDevChannel(): CliChannel | undefined {\n    return channel;\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordRangeError } from '@seedcord/errors/internal';\n\nimport { ShutdownPhase, StartupPhase } from '#src/lifecycle/phases';\n\nimport type { TaskShutdownPhase } from '#src/lifecycle/phases';\n\n/**\n * Sets when a plugin's lifecycle methods run. Pass it as the second argument to `super()`. Omit a\n * field to keep its default.\n *\n * @see {@link StartupPhase}\n * @see {@link ShutdownPhase}\n * @example\n * ```ts\n * super(host, { init: { phase: StartupPhase.Login }, dispose: { timeout: 30_000 } });\n * ```\n */\nexport interface PluginLifecycleSpec {\n    /**\n     * Defaults to `StartupPhase.Configuration` and 15000ms. Set the phase to `Ready` and `init()`\n     * runs ahead of every plugin's `ready()`.\n     */\n    init?: { phase?: StartupPhase; timeout?: number };\n    /** `ready()` always runs in `StartupPhase.Ready`. Defaults to a 15000ms timeout. */\n    ready?: { timeout?: number };\n    /** Defaults to `ShutdownPhase.Disconnect` and 10000ms. */\n    dispose?: { phase?: TaskShutdownPhase; timeout?: number };\n}\n\n/** @internal */\nexport interface ResolvedPluginLifecycleSpec {\n    readonly init: { readonly phase: StartupPhase; readonly timeout: number };\n    readonly ready: { readonly timeout: number };\n    readonly dispose: { readonly phase: TaskShutdownPhase; readonly timeout: number };\n}\n\nconst DEFAULT_INIT_TIMEOUT_MS = 15_000;\nconst DEFAULT_READY_TIMEOUT_MS = 15_000;\nconst DEFAULT_DISPOSE_TIMEOUT_MS = 10_000;\n\nfunction timeoutOf(\n    field: 'init' | 'ready' | 'dispose',\n    declared: number | undefined,\n    fallback: number,\n    pluginName: string\n): number {\n    if (declared === undefined) return fallback;\n    if (!Number.isFinite(declared) || declared <= 0) {\n        throw new SeedcordRangeError(SeedcordErrorCode.LifecycleInvalidTimeout, [\n            `${pluginName}'s lifecycle ${field}.timeout`,\n            declared\n        ]);\n    }\n    return declared;\n}\n\n/** @internal */\nexport function resolveLifecycleSpec(\n    spec: PluginLifecycleSpec | undefined,\n    pluginName: string\n): ResolvedPluginLifecycleSpec {\n    return {\n        init: {\n            phase: spec?.init?.phase ?? StartupPhase.Configuration,\n            timeout: timeoutOf('init', spec?.init?.timeout, DEFAULT_INIT_TIMEOUT_MS, pluginName)\n        },\n        ready: {\n            timeout: timeoutOf('ready', spec?.ready?.timeout, DEFAULT_READY_TIMEOUT_MS, pluginName)\n        },\n        dispose: {\n            phase: spec?.dispose?.phase ?? ShutdownPhase.Disconnect,\n            timeout: timeoutOf('dispose', spec?.dispose?.timeout, DEFAULT_DISPOSE_TIMEOUT_MS, pluginName)\n        }\n    };\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordTypeError } from '@seedcord/errors/internal';\nimport { Logger } from '@seedcord/logger';\n\nimport { getDevChannel } from '#hmr/devChannel';\n\nimport { RuntimeBrand, TransportBrand } from './brands';\nimport { resolveLifecycleSpec } from './lifecycle';\n\nimport type { CoreBase } from '#interfaces/CoreBase';\nimport type { Kv } from '#src/kv/Kv';\nimport type { ScopedSpec } from './brands';\nimport type { ResolvedPluginLifecycleSpec, PluginLifecycleSpec } from './lifecycle';\nimport type {\n    DeclaredScope,\n    TransportOf,\n    PluginOptions,\n    PluginSpecArgs,\n    RuntimeOf,\n    ScopeAxis,\n    Runtime,\n    RuntimeAssert,\n    Transport,\n    TransportAssert\n} from './options';\nimport type { Tail, FrameworkChannel, HmrAware, HmrUpdateEvent } from '@seedcord/types';\n\ninterface Attaching {\n    readonly key: string;\n    readonly kv: Kv;\n}\n\n// set only while attach() runs `new Plugin()`\nlet attaching: Attaching | undefined;\n\nexport interface Initializeable {\n    init(): Promise<void>;\n}\n\n/** @internal */\nconst resolvedSpecSlot = Symbol('seedcord:plugin:spec');\n/** @internal */\nconst loggerSlot = Symbol('seedcord:plugin:logger');\n/** @internal */\nconst scopeSlot = Symbol('seedcord:plugin:scope');\n/** @internal */\nexport const FixedScope = Symbol('seedcord:plugin:fixed-scope');\n\n/**\n * Base class for a seedcord plugin. Extend it and implement `init()`. `this.core` is the running\n * bot.\n *\n * Your constructor takes the host first and passes it to `super()`. Add your own parameters after\n * it. `attach()` types them at the call site.\n *\n * A plugin that narrows `transport` or `runtime` in `Opts` passes the same values to `super()`.\n * `attach()` throws when either one differs from the bot's.\n *\n * @typeParam Opts - Where this plugin may attach.\n * @typeParam TCore - The `Core` each transport binds `this.core` to.\n * @typeParam Fixed - The `transport` and `runtime` values a transport's own `Plugin` base sets. Leave it out.\n *\n * @example\n * ```ts\n * class Analytics extends Plugin<{ transport: 'gateway' }> {\n *     constructor(\n *         host: CoreBase,\n *         private readonly apiKey: string\n *     ) {\n *         super(host, { transport: 'gateway', init: { phase: StartupPhase.Login } });\n *     }\n *\n *     public async init(): Promise<void> {\n *         await this.connect(this.apiKey);\n *     }\n * }\n *\n * seedcord.attach('analytics', Analytics, apiKey);\n * ```\n */\nexport abstract class Plugin<\n    Opts extends PluginOptions = {},\n    TCore extends CoreBase = CoreBase,\n    Fixed extends ScopeAxis = never\n>\n    implements Initializeable, HmrAware\n{\n    /** @internal */\n    protected static readonly [FixedScope]: Partial<DeclaredScope> = {};\n\n    // phantom, never set at runtime.\n    /** @internal */\n    declare readonly [TransportBrand]?: TransportOf<Opts>;\n    /** @internal */\n    declare readonly [RuntimeBrand]?: RuntimeOf<Opts>;\n\n    /** @internal */\n    readonly [resolvedSpecSlot]: ResolvedPluginLifecycleSpec;\n    /** @internal */\n    readonly [loggerSlot]: Logger;\n    /** @internal */\n    readonly [scopeSlot]: DeclaredScope;\n\n    /** Logs under the plugin's class name, on the channel its attach key sets. */\n    protected readonly logger: Logger;\n\n    readonly #kv: Kv | undefined;\n\n    // CoreBase here keeps the augmented Core out of ConstructorParameters, which attach reads\n    constructor(\n        private readonly host: CoreBase,\n        ...[spec]: PluginSpecArgs<Opts, Fixed>\n    ) {\n        // cleared here. a plugin this constructor builds by hand doesn't get the outer key\n        const attachment = attaching;\n        attaching = undefined;\n        this.#kv = attachment?.kv;\n\n        this.logger = new Logger(this.constructor.name, attachment && { channel: attachment.key });\n        this[loggerSlot] = this.logger;\n        this[resolvedSpecSlot] = resolveLifecycleSpec(spec, this.constructor.name);\n\n        const passed: (PluginLifecycleSpec & Partial<DeclaredScope>) | undefined = spec;\n        const fixed = new.target[FixedScope];\n        this[scopeSlot] = {\n            transport: fixed.transport ?? passed?.transport ?? 'any',\n            runtime: fixed.runtime ?? passed?.runtime ?? 'any'\n        };\n    }\n\n    /** The host, typed to the transport whose `Plugin` base this class extends. */\n    protected get core(): TCore {\n        // justified: each transport binds TCore to the Core its own host satisfies\n        return this.host as TCore;\n    }\n\n    /**\n     * This plugin's records in the bot's `config.kv`, stored under its attach key. Two attachments of\n     * one plugin class each get their own records. Renaming the attach key leaves the records under\n     * the old key behind.\n     *\n     * @throws A **SeedcordTypeError** when something built the plugin with `new` outside `attach()`.\n     * @example\n     * ```ts\n     * // works in a field initializer, the constructor, and every method\n     * private readonly jobs = this.kv.collection<Job>('job');\n     * ```\n     */\n    protected get kv(): Kv {\n        if (!this.#kv)\n            throw new SeedcordTypeError(SeedcordErrorCode.CorePluginKvOutsideAttach, [this.constructor.name]);\n        return this.#kv;\n    }\n\n    /**\n     * Runs in `StartupPhase.Configuration` by default.\n     * Move it to a different phase with the {@link PluginLifecycleSpec}.\n     */\n    abstract init(): Promise<void>;\n\n    /**\n     * Runs in the Ready phase, after every attached plugin's `init()` has resolved. The other Ready\n     * tasks run alongside it, including the http server binding its port.\n     *\n     * Override it when your work needs a logged-in client or a resolved application id.\n     */\n    ready?(): Promise<void>;\n\n    /**\n     * Runs during teardown, in `ShutdownPhase.Disconnect` by default. seedcord skips it when `init()`\n     * has thrown.\n     *\n     * When `init()` outlasts its timeout, seedcord calls this once that `init()` resolves, outside any\n     * shutdown phase. The process must still be alive for that call to happen.\n     */\n    dispose?(): Promise<void>;\n\n    /**\n     * Returns data that `seedcord codegen` writes into the bot's `seedcord-gen.ts` as a type.\n     * Read it back with `Generated<typeof YourPlugin>`. Return plain data, or classes and objects\n     * that a project file or your plugin's package exports. The class needs a `static readonly id`.\n     *\n     * `seedcord codegen` calls this without running `init()`. Read only what the constructor stored\n     * and the bot's files.\n     */\n    codegen?(): Promise<unknown>;\n\n    /**\n     * Rejects the options this plugin got.\n     *\n     * @param reason - Why the options are invalid.\n     * @throws A **SeedcordTypeError** every time, with the plugin class name and `reason` in its message.\n     */\n    protected rejectOptions(reason: string): never {\n        throw new SeedcordTypeError(SeedcordErrorCode.PluginOptionsRejected, [this.constructor.name, reason]);\n    }\n\n    /** Override to reload plugin state on an HMR update. */\n    public onHmr(_event: HmrUpdateEvent): Promise<void> {\n        return Promise.resolve();\n    }\n\n    /**\n     * Registers critical file patterns that should trigger a full restart when changed in Dev HMR.\n     * @param patterns - Glob patterns. A relative one resolves against `root` from `seedcord.config.ts`.\n     */\n    protected registerCriticalFiles(patterns: string[]): void {\n        getDevChannel()?.send('seedcord:register-critical-files', { patterns });\n    }\n}\n\n/** @internal */\nexport function resolvedLifecycleSpecOf(plugin: PluginLike): ResolvedPluginLifecycleSpec {\n    return plugin[resolvedSpecSlot];\n}\n\n/** @internal */\nexport function extendsThisCorePlugin(ctor: PluginCtor): boolean {\n    return ctor.prototype instanceof Plugin;\n}\n\n/** @internal */\nexport function pluginLoggerOf(plugin: PluginLike): Logger {\n    return plugin[loggerSlot];\n}\n\n/** @internal */\nexport function declaredScopeOf(plugin: PluginLike): DeclaredScope {\n    return plugin[scopeSlot];\n}\n\n/** @internal */\nexport function constructAttached<TPlugin>(key: string, kv: Kv, construct: () => TPlugin): TPlugin {\n    attaching = { key, kv };\n    try {\n        return construct();\n    } finally {\n        attaching = undefined;\n    }\n}\n\nexport type { PluginLifecycleSpec } from './lifecycle';\nexport type { PluginOptions } from './options';\n\n// a bound of Plugin<{}> rejects every plugin that declares an option, since Plugin<A> and Plugin<B>\n// are mutually unassignable. every member here must stay Opts-independent.\n/** @internal */\nexport type PluginLike = Pick<\n    Plugin,\n    'init' | 'ready' | 'dispose' | 'onHmr' | typeof resolvedSpecSlot | typeof loggerSlot | typeof scopeSlot\n>;\n\n// a `CoreBase` first parameter rejects a narrowing ctor on its own, and it also collapses\n// `InstanceType<Ctor>` to `PluginLike` at every attach call. CoreParamAssert checks it instead.\n/** @internal */\nexport type PluginCtor<TPlugin extends PluginLike = PluginLike> = new (...args: any[]) => TPlugin;\n\n/** @internal */\nexport type PluginArgs<Ctor extends PluginCtor> =\n    InheritsScopedConstructor<Ctor> extends true ? [] : Tail<ConstructorParameters<Ctor>>;\n\n// a narrowed plugin with no constructor of its own inherits the base one, whose spec carries ScopedSpec\ntype InheritsScopedConstructor<Ctor extends PluginCtor> =\n    Tail<ConstructorParameters<Ctor>> extends [infer Spec, ...unknown[]]\n        ? typeof ScopedSpec extends keyof Spec\n            ? true\n            : false\n        : false;\n\n/** @internal */\nexport type Attached<Key extends string, Instance> = Key extends `${infer Group}.${infer Leaf}`\n    ? Record<Group, Record<Leaf, Instance>>\n    : Record<Key, Instance>;\n\n// attach writes the key onto the host, so a key like toString would shadow the one on Object.prototype\n// eslint-disable-next-line @typescript-eslint/no-wrapper-object-types -- lint:fix swaps this for `keyof object`, which is never\ntype HostMember<Host> = keyof Host | keyof Object;\n\n// a string argument against an object type renders only as `string is not assignable`\n/** @internal */\nexport type AttachKeyAssert<Key extends string, Host> = Key extends ''\n    ? 'A plugin key needs a name.'\n    : Key extends `${infer Group}.${infer Leaf}`\n      ? Leaf extends `${string}.${string}`\n          ? `'${Key}' has more than one dot. A plugin key takes one dot at most.`\n          : '' extends Group | Leaf\n            ? `'${Key}' has an empty part. Write a group and a plugin name around the dot, like 'services.users'.`\n            : Group extends FrameworkChannel\n              ? `'${Group}' is a channel the framework logs on. Pick another group name.`\n              : Group extends keyof Host\n                ? Host[Group] extends PluginLike\n                    ? `'${Group}' already holds a plugin, so '${Leaf}' cannot nest inside it.`\n                    : Host[Group] extends Record<string, PluginLike>\n                      ? Leaf extends keyof Host[Group]\n                          ? `'${Key}' is already attached.`\n                          : Key\n                      : `'${Group}' is already a member on the bot. Pick another group name.`\n                : Group extends HostMember<Host>\n                  ? `'${Group}' is already a member on the bot. Pick another group name.`\n                  : Key\n      : Key extends FrameworkChannel\n        ? `'${Key}' is a channel the framework logs on. Pick another plugin key.`\n        : Key extends keyof Host\n          ? Host[Key] extends PluginLike\n              ? `'${Key}' is already attached.`\n              : Host[Key] extends Record<string, PluginLike>\n                ? `'${Key}' already holds a group of plugins. Attach this one under a name of its own.`\n                : `'${Key}' is already a member on the bot. Pick another plugin key.`\n          : Key extends HostMember<Host>\n            ? `'${Key}' is already a member on the bot. Pick another plugin key.`\n            : Key;\n\ntype CoreParamTooNarrow = Record<\n    'this plugin constructor must take CoreBase as its first parameter and read the transport Core off this.core',\n    never\n>;\n\n// a narrowed first parameter fails `CoreBase extends Param`\ntype CoreParamAssert<Ctor extends PluginCtor> = CoreBase extends ConstructorParameters<Ctor>[0]\n    ? unknown\n    : CoreParamTooNarrow;\n\ntype ConstructorMissing = Record<\n    \"this plugin narrows its transport or runtime. Give it a constructor that passes them to super(), like super(host, { runtime: 'server' })\",\n    never\n>;\n\ntype OwnConstructorAssert<Ctor extends PluginCtor> =\n    InheritsScopedConstructor<Ctor> extends true ? ConstructorMissing : unknown;\n\ntype AttachAsserts<Ctor extends PluginCtor, BotT extends Transport, BotRt extends Runtime> = TransportAssert<\n    InstanceType<Ctor>,\n    BotT\n> &\n    RuntimeAssert<InstanceType<Ctor>, BotRt> &\n    CoreParamAssert<Ctor> &\n    OwnConstructorAssert<Ctor>;\n\n// typescript can't infer Ctor from a generic class through `Ctor & AttachAsserts`. every assert returns unknown to pass.\n/** @internal */\nexport type AttachableCtor<Ctor extends PluginCtor, BotT extends Transport, BotRt extends Runtime> =\n    unknown extends AttachAsserts<Ctor, BotT, BotRt> ? Ctor : AttachAsserts<Ctor, BotT, BotRt>;\n","import { SeedcordErrorCode, isSeedcordError } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\n\nimport type { SeedcordErrorArguments } from '@seedcord/errors/internal';\nimport type { KvDriver, KvEntry } from '@seedcord/types';\nimport type { Promisable } from 'type-fest';\n\ntype Operation = SeedcordErrorArguments<SeedcordErrorCode.CoreKvDriverFailed>[0];\n\nfunction translated(operation: Operation, key: string, error: unknown): unknown {\n    if (isSeedcordError(error)) return error;\n    return new SeedcordError(SeedcordErrorCode.CoreKvDriverFailed, [operation, key], { cause: error });\n}\n\nasync function guard<TResult>(operation: Operation, key: string, run: () => Promisable<TResult>): Promise<TResult> {\n    try {\n        return await run();\n    } catch (error) {\n        throw translated(operation, key, error);\n    }\n}\n\nexport class GuardedDriver implements KvDriver {\n    constructor(private readonly driver: KvDriver) {}\n\n    public async get(key: string): Promise<string | undefined> {\n        return guard('read', key, () => this.driver.get(key));\n    }\n\n    public async set(key: string, value: string, ttlMs?: number): Promise<void> {\n        await guard('write', key, () => this.driver.set(key, value, ttlMs));\n    }\n\n    public async delete(key: string): Promise<void> {\n        await guard('delete', key, () => this.driver.delete(key));\n    }\n\n    public async *entries(prefix: string): AsyncIterable<KvEntry> {\n        try {\n            for await (const entry of this.driver.entries(prefix)) yield entry;\n        } catch (error) {\n            throw translated('list', prefix, error);\n        }\n    }\n}\n","export class KeyedQueue {\n    private readonly tails = new Map<string, Promise<void>>();\n\n    public run<TResult>(key: string, task: () => Promise<TResult>): Promise<TResult> {\n        const run = (this.tails.get(key) ?? Promise.resolve()).then(task);\n        const tail = run.then(\n            () => undefined,\n            () => undefined\n        );\n        this.tails.set(key, tail);\n        void tail.then(() => {\n            if (this.tails.get(key) === tail) this.tails.delete(key);\n        });\n        return run;\n    }\n}\n","import type { KeyedQueue } from './KeyedQueue';\nimport type { KvDriver } from '@seedcord/types';\nimport type { Jsonify, Simplify } from 'type-fest';\n\n// a hover shows the record's fields in place of JsonifyObject<...>. SimplifyDeep hits TS2589 in get()\ntype Stored<TRecord> = Simplify<Jsonify<TRecord>>;\n\n// expiresAt covers backends that ignore a ttl, like unstorage's fs driver\ninterface Envelope<TValue> {\n    value: TValue;\n    expiresAt?: number;\n}\n\n/**\n * The records of one type, stored under one name in `config.kv`. Get one from\n * `kv.collection<T>('name')`.\n *\n * Every record goes through JSON on its way in and out. A `Date` you store reads back from `get()`\n * as an ISO string.\n *\n * @example\n * ```ts\n * interface Profile { bio: string; joinedAt: Date }\n * const profiles = this.core.kv.collection<Profile>('profile');\n *\n * await profiles.set(user.id, { bio: 'hi', joinedAt: new Date() });\n * const profile = await profiles.get(user.id); // { bio: string; joinedAt: string } | undefined\n * await profiles.delete(user.id);\n * ```\n */\nexport class KvCollection<TRecord> {\n    readonly #driver: KvDriver;\n    readonly #prefix: string;\n    readonly #updates: KeyedQueue;\n\n    constructor(driver: KvDriver, prefix: string, updates: KeyedQueue) {\n        this.#driver = driver;\n        this.#prefix = prefix;\n        this.#updates = updates;\n    }\n\n    /** Reads the record stored under `id`. Resolves to `undefined` when nothing is there or the record expired. */\n    public async get(id: string): Promise<Stored<TRecord> | undefined> {\n        const key = this.#prefix + id;\n        const raw = await this.#driver.get(key);\n        const value = this.#liveValue(raw);\n        if (raw !== undefined && value === undefined) await this.#deleteExpired(key);\n        return value;\n    }\n\n    /**\n     * Stores `value` under `id` and replaces whatever was there.\n     *\n     * @param ttlMs - How long the record lasts, in milliseconds. Leave it out to keep the record until you delete it.\n     */\n    public async set(id: string, value: TRecord, ttlMs?: number): Promise<void> {\n        const key = this.#prefix + id;\n        await this.#updates.run(key, async () => this.#write(key, value, ttlMs));\n    }\n\n    /** Removes the record under `id`. */\n    public async delete(id: string): Promise<void> {\n        const key = this.#prefix + id;\n        await this.#updates.run(key, async () => this.#driver.delete(key));\n    }\n\n    /**\n     * Stores what `next` returns for the record under `id`, then resolves to that value. `next` gets\n     * the current record, or `undefined` when there is none.\n     *\n     * Use it over a `get()` then a `set()` when two calls can change one record at the same time.\n     * `set()`, `delete()`, and `update()` calls on one id run one after the other in this process.\n     * None of them loses another's change. Two processes sharing one backend can still both read\n     * before either writes.\n     *\n     * @param ttlMs - How many milliseconds the stored record lasts. Pass a function to work it out from the record. Leave it out to keep the record until you delete it.\n     * @example\n     * ```ts\n     * // counts a run of the command and resolves to the new count\n     * const runs = await counts.update(user.id, (count) => (count ?? 0) + 1);\n     * ```\n     */\n    public async update(\n        id: string,\n        next: (current: Stored<TRecord> | undefined) => TRecord,\n        ttlMs?: number | ((value: TRecord) => number)\n    ): Promise<TRecord> {\n        const key = this.#prefix + id;\n        return this.#updates.run(key, async () => {\n            const value = next(this.#liveValue(await this.#driver.get(key)));\n            await this.#write(key, value, typeof ttlMs === 'function' ? ttlMs(value) : ttlMs);\n            return value;\n        });\n    }\n\n    /**\n     * Yields `[id, record]` for every record in this collection that hasn't expired. Use it to read\n     * back what the bot saved before a restart.\n     *\n     * @throws A **SeedcordError** when the backend can't list its keys, like `@keyv/memcache`.\n     * @example\n     * ```ts\n     * // schedules every saved reminder again after a restart\n     * for await (const [id, reminder] of reminders.entries()) schedule(id, reminder);\n     * ```\n     */\n    public async *entries(): AsyncIterable<[id: string, record: Stored<TRecord>]> {\n        const expired: string[] = [];\n        try {\n            for await (const [key, raw] of this.#driver.entries(this.#prefix)) {\n                const value = this.#liveValue(raw);\n                if (value === undefined) expired.push(key);\n                else yield [key.slice(this.#prefix.length), value];\n            }\n        } finally {\n            // deletes wait until the listing ends. a driver may be reading from an open cursor\n            await Promise.all(expired.map(async (key) => this.#deleteExpired(key)));\n        }\n    }\n\n    async #write(key: string, value: TRecord, ttlMs: number | undefined): Promise<void> {\n        const envelope: Envelope<TRecord> = ttlMs === undefined ? { value } : { value, expiresAt: Date.now() + ttlMs };\n        await this.#driver.set(key, JSON.stringify(envelope), ttlMs);\n    }\n\n    // reads again in the queue. a set queued after the first read may have stored a live record\n    async #deleteExpired(key: string): Promise<void> {\n        await this.#updates.run(key, async () => {\n            const raw = await this.#driver.get(key);\n            if (raw !== undefined && this.#liveValue(raw) === undefined) await this.#driver.delete(key);\n        });\n    }\n\n    #liveValue(raw: string | undefined): Stored<TRecord> | undefined {\n        if (raw === undefined) return undefined;\n        // justified: only this collection writes under its prefix\n        const envelope = JSON.parse(raw) as Envelope<Stored<TRecord>>;\n        if (envelope.expiresAt !== undefined && envelope.expiresAt <= Date.now()) return undefined;\n        return envelope.value;\n    }\n}\n","import { GuardedDriver } from './GuardedDriver';\nimport { KeyedQueue } from './KeyedQueue';\nimport { KvCollection } from './KvCollection';\n\nimport type { Config } from '@seedcord/types';\n\ntype ConfiguredDriver = NonNullable<Config['kv']>;\n\n// what JSON.stringify keeps as written. a Date passes through its toJSON\ntype JsonSafe<TValue> = TValue extends string | number | boolean | null | undefined\n    ? TValue\n    : TValue extends { toJSON(): unknown }\n      ? TValue\n      : TValue extends (...args: never[]) => unknown\n        ? never\n        : TValue extends ReadonlyMap<unknown, unknown> | ReadonlySet<unknown>\n          ? never\n          : TValue extends readonly (infer Item)[]\n            ? readonly JsonSafe<Item>[]\n            : TValue extends object\n              ? { [K in keyof TValue]: JsonSafe<TValue[K]> }\n              : never;\n\n// tsc prints a failed string argument against an object type as only `string is not assignable`\ntype CollectionName<TRecord> = unknown extends TRecord\n    ? 'Pass the record type, like kv.collection<Profile>(name).'\n    : [TRecord] extends [JsonSafe<TRecord>]\n      ? string\n      : 'This record type holds a value JSON cannot keep, like a function, Map, Set, or bigint.';\n\n// unescaped, every key under `user:settings:` would also start with `user:`\nfunction keyPrefix(path: readonly string[]): string {\n    return path.map((segment) => `${encodeURIComponent(segment)}:`).join('');\n}\n\n/**\n * The bot's key-value store, or one prefixed slice of it. `core.kv` holds your handlers' records. A\n * plugin's `this.kv` holds the plugin's.\n */\nexport class Kv {\n    /** What you passed as `config.kv`. Register its type in `KvTypes` to call the library's own methods on it. */\n    public readonly driver: ConfiguredDriver;\n    readonly #guarded: GuardedDriver;\n    readonly #path: readonly string[];\n    readonly #updates = new KeyedQueue();\n\n    constructor(driver: ConfiguredDriver, ...path: string[]) {\n        this.driver = driver;\n        this.#guarded = new GuardedDriver(driver);\n        this.#path = path;\n    }\n\n    /**\n     * Records of one type under `name`. Pass the type argument. A record type holding a function,\n     * `Map`, `Set`, or `bigint` fails to compile here.\n     */\n    public collection<TRecord>(name: CollectionName<TRecord>): KvCollection<TRecord> {\n        return new KvCollection<TRecord>(this.#guarded, keyPrefix([...this.#path, name]), this.#updates);\n    }\n}\n","import type { Kv } from '#src/kv/Kv';\nimport type { KvCollection } from '#src/kv/KvCollection';\nimport type { EpochMs, IRateLimiter, RateLimitResult, RateLimitWindow } from '@seedcord/types';\n\nfunction limitedResult(live: readonly number[], now: number): RateLimitResult {\n    // a reduce, because spreading into Math.min throws past the argument cap\n    const resetAt = live.reduce((earliest, exp) => Math.min(earliest, exp), Number.POSITIVE_INFINITY) as EpochMs;\n    return { limited: true, resetAt, remaining: 0, retryAfterMs: resetAt - now };\n}\n\nfunction openResult(remaining: number): RateLimitResult {\n    return { limited: false, resetAt: 0 as EpochMs, remaining, retryAfterMs: 0 };\n}\n\n// 0 or a negative limit never means \"block everything\"\nfunction limitOf(window: RateLimitWindow): number {\n    return Math.max(1, window.limit ?? 1);\n}\n\nfunction liveUses(stored: readonly number[] | undefined, now: number): number[] {\n    return (stored ?? []).filter((exp) => exp > now);\n}\n\nexport class KvRateLimiter implements IRateLimiter {\n    private readonly uses: KvCollection<number[]>;\n\n    constructor(kv: Kv) {\n        this.uses = kv.collection<number[]>('rate-limit');\n    }\n\n    public async charge(key: string, window: RateLimitWindow): Promise<RateLimitResult> {\n        const limit = limitOf(window);\n        // update() calls the callback before it resolves\n        let result!: RateLimitResult;\n        await this.uses.update(\n            key,\n            (stored) => {\n                // read here, since this callback can wait in the queue behind other charges\n                const now = Date.now();\n                const live = liveUses(stored, now);\n                const limited = live.length >= limit;\n                if (!limited) live.push(now + window.windowMs);\n                result = limited ? limitedResult(live, now) : openResult(limit - live.length);\n                return live;\n            },\n            (live) => live.reduce((latest, exp) => Math.max(latest, exp), 0) - Date.now()\n        );\n        return result;\n    }\n\n    public async peek(key: string, window: RateLimitWindow): Promise<RateLimitResult> {\n        const stored = await this.uses.get(key);\n        const now = Date.now();\n        const limit = limitOf(window);\n        const live = liveUses(stored, now);\n        return live.length >= limit ? limitedResult(live, now) : openResult(limit - live.length);\n    }\n\n    public async reset(key: string): Promise<void> {\n        await this.uses.delete(key);\n    }\n}\n","interface PluginKeyParts {\n    readonly head: string;\n    readonly leaf: string | undefined;\n}\n\n// 'services.users' attaches the plugin as users inside the group services\nexport function splitPluginKey(key: string): PluginKeyParts {\n    const dot = key.indexOf('.');\n    return dot === -1 ? { head: key, leaf: undefined } : { head: key.slice(0, dot), leaf: key.slice(dot + 1) };\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError, SeedcordTypeError } from '@seedcord/errors/internal';\nimport { FRAMEWORK_CHANNELS } from '@seedcord/logger';\nimport { HostPluginKeys } from '@seedcord/types/internal';\n\nimport { Kv } from '#src/kv/Kv';\nimport { MemoryDriver } from '#src/kv/MemoryDriver';\nimport { KvRateLimiter } from '#src/rateLimiter/KvRateLimiter';\nimport { Bus } from '#subscribers/Bus';\n\nimport { constructAttached, declaredScopeOf, extendsThisCorePlugin, resolvedLifecycleSpecOf } from './Plugin';\nimport { splitPluginKey } from './splitPluginKey';\n\nimport type { CoreBase } from '#interfaces/CoreBase';\nimport type { ResolvedPluginLifecycleSpec } from './lifecycle';\nimport type { DeclaredScope, Runtime, Transport } from './options';\nimport type { AttachableCtor, Attached, AttachKeyAssert, PluginArgs, PluginCtor, PluginLike } from './Plugin';\nimport type { REST } from '@discordjs/rest';\nimport type { Config, IRateLimiter } from '@seedcord/types';\n\nexport interface Attachment {\n    readonly key: string;\n    readonly instance: PluginLike;\n    readonly spec: ResolvedPluginLifecycleSpec;\n}\n\nconst RESERVED_KEYS: ReadonlySet<string> = new Set(FRAMEWORK_CHANNELS);\n\nconst attachmentsSlot = Symbol('seedcord:host:attachments');\nconst sealSlot = Symbol('seedcord:host:seal');\n\n/** Base class for a plugin host. */\nexport abstract class PluginHost<BotT extends Transport, BotRt extends Runtime> implements CoreBase {\n    public abstract readonly config: Config;\n    public abstract readonly rest: REST;\n    public abstract readonly applicationId: string;\n\n    /** @see {@link Bus} */\n    public readonly bus: Bus;\n    /** @see {@link Kv} */\n    public readonly kv: Kv;\n    /** @see {@link IRateLimiter} */\n    public readonly rateLimiter: IRateLimiter;\n\n    #sealed = false;\n    readonly #attachments: Attachment[] = [];\n    readonly #groups = new Map<string, Record<string, PluginLike>>();\n    readonly #scope: { readonly transport: BotT; readonly runtime: BotRt };\n\n    constructor(transport: BotT, runtime: BotRt, driver: Config['kv']) {\n        this.#scope = { transport, runtime };\n        this.bus = new Bus(this);\n        const kvDriver = driver ?? new MemoryDriver();\n        this.kv = new Kv(kvDriver, 'app');\n        this.rateLimiter = new KvRateLimiter(new Kv(kvDriver, 'seedcord'));\n    }\n\n    /** @internal */\n    public get [attachmentsSlot](): readonly Attachment[] {\n        return this.#attachments;\n    }\n\n    /** @internal */\n    public [sealSlot](): void {\n        this.#sealed = true;\n    }\n\n    /** @internal codegen reads this to emit the `Core` augmentation */\n    public get [HostPluginKeys](): readonly string[] {\n        return this.#attachments.map((attachment) => attachment.key);\n    }\n\n    /**\n     * Attaches a plugin under `key`. Read the instance back as `core[key]`. `seedcord codegen`\n     * writes the `Core` augmentation that types it there.\n     *\n     * Put one dot in the key to nest the plugin under a group. `'services.users'` reads back as\n     * `core.services.users`. Each name holds one plugin or one group.\n     *\n     * Startup runs each plugin's `init()` in attach order within its phase. A node bot starts in\n     * `start()`. An edge bot starts on its first request.\n     *\n     * Attaching a plugin whose `transport` or `runtime` differs from this host fails to compile.\n     * Your constructor takes `CoreBase` as its first parameter (you don't need to pass it though).\n     * A narrower one fails to compile here.\n     *\n     * @param key - Also the channel the plugin logs on, dots included.\n     * @param args - Whatever your constructor takes after the host.\n     * @throws A **SeedcordError** when you attach after the bot has started.\n     * @throws A **SeedcordTypeError** when `key` is taken, reserved, or malformed.\n     * @throws A **SeedcordTypeError** when the plugin extends `Plugin` from another copy of `@seedcord/core`.\n     * @throws A **SeedcordTypeError** when the plugin's `transport` or `runtime` differs from this host and the types were bypassed.\n     * @example\n     * ```ts\n     * seedcord.attach('db', Mongoose, { uri: 'mongodb://...', name: 'seedcord', dir: ... });\n     * ```\n     */\n    public attach<Key extends string, Ctor extends PluginCtor>(\n        this: this,\n        key: AttachKeyAssert<Key, this>,\n        Plugin: AttachableCtor<Ctor, BotT, BotRt>,\n        ...args: PluginArgs<Ctor>\n    ): this & Attached<Key, InstanceType<Ctor>>;\n    public attach<Key extends string, Ctor extends PluginCtor>(\n        this: this,\n        key: Key,\n        Plugin: Ctor,\n        ...args: PluginArgs<Ctor>\n    ): this & Attached<Key, InstanceType<Ctor>> {\n        if (this.#sealed) {\n            throw new SeedcordError(SeedcordErrorCode.CorePluginAfterInit);\n        }\n\n        const { head, leaf } = splitPluginKey(key);\n\n        // runs before assertFree because some reserved channels are also host members\n        if (RESERVED_KEYS.has(head)) {\n            throw new SeedcordTypeError(SeedcordErrorCode.CorePluginReservedChannel, [head]);\n        }\n\n        if (head === '' || leaf === '') {\n            throw new SeedcordTypeError(SeedcordErrorCode.CorePluginKeyMalformed, [key, 'has an empty part.']);\n        }\n        if (leaf?.includes('.')) {\n            throw new SeedcordTypeError(SeedcordErrorCode.CorePluginKeyMalformed, [key, 'has more than one dot.']);\n        }\n        this.#assertFree(head, leaf, key);\n\n        if (!extendsThisCorePlugin(Plugin)) {\n            throw new SeedcordTypeError(SeedcordErrorCode.CorePluginFromOtherCore, [Plugin.name]);\n        }\n\n        const kv = new Kv(this.kv.driver, 'plugins', key);\n        const instance = constructAttached(key, kv, () => new Plugin(this, ...args));\n        this.#assertScope(Plugin.name, declaredScopeOf(instance));\n        this.#attachments.push({ key, instance, spec: resolvedLifecycleSpecOf(instance) });\n\n        if (leaf === undefined) {\n            return Object.assign(this, { [key]: instance }) as this & Attached<Key, InstanceType<Ctor>>;\n        }\n\n        this.#groupFor(head)[leaf] = instance;\n        return this as this & Attached<Key, InstanceType<Ctor>>;\n    }\n\n    #assertFree(head: string, leaf: string | undefined, key: string): void {\n        if (leaf === undefined) {\n            if (this.#groups.has(key)) throw new SeedcordTypeError(SeedcordErrorCode.CorePluginKeyHoldsGroup, [key]);\n            if (key in this) throw new SeedcordTypeError(SeedcordErrorCode.CorePluginKeyExists, [key]);\n            return;\n        }\n\n        const group = this.#groups.get(head);\n        if (!group) {\n            if (head in this) throw new SeedcordTypeError(SeedcordErrorCode.CorePluginGroupTaken, [head, key]);\n            return;\n        }\n        if (Object.hasOwn(group, leaf)) throw new SeedcordTypeError(SeedcordErrorCode.CorePluginKeyExists, [key]);\n    }\n\n    // the types already reject a mismatch. plain JS and casts reach this.\n    #assertScope(pluginName: string, declared: DeclaredScope): void {\n        for (const axis of ['transport', 'runtime'] as const) {\n            const host = this.#scope[axis];\n            if (declared[axis] === 'any' || declared[axis] === host) continue;\n            throw new SeedcordTypeError(SeedcordErrorCode.CorePluginScopeMismatch, [\n                pluginName,\n                axis,\n                declared[axis],\n                host\n            ]);\n        }\n    }\n\n    #groupFor(head: string): Record<string, PluginLike> {\n        const existing = this.#groups.get(head);\n        if (existing) return existing;\n\n        // a null prototype makes a leaf called __proto__ or valueOf an ordinary key\n        const group = Object.create(null) as Record<string, PluginLike>;\n        this.#groups.set(head, group);\n        Object.assign(this, { [head]: group });\n        return group;\n    }\n}\n\nexport function attachmentsOf(\n    host: Pick<PluginHost<Transport, Runtime>, typeof attachmentsSlot>\n): readonly Attachment[] {\n    return host[attachmentsSlot];\n}\n\nexport function sealAttachments(host: Pick<PluginHost<Transport, Runtime>, typeof sealSlot>): void {\n    host[sealSlot]();\n}\n"],"mappings":"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"}