@seedcord/core 0.11.0 → 0.12.0-next.0

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { $ as RegisterInteractionMiddleware, A as rollbackCommits, B as NotInGuild, D as pickNotice, E as presentNames, F as MissingPermissions, G as serializeReply, H as OnCooldown, Ht as Notice, J as publishResponse, K as translateSerializationError, L as NeedsAny, Lt as NoticeCard, P as HasDangerousPermissions, Q as sendTarget, R as NotAllowed, Rt as BuilderComponent, S as RequireRole, T as missingNames, U as defineEffectGate, V as NotOwner, W as defineGate, X as AckTrace, Z as checkAckLegality, _ as pageCursor, b as RequireBotPermissions, bt as Commands, ct as RegisterCommand, d as WebhookLog, f as Subscriber, g as PAGE_MAX, it as storeInteractionRoute, j as runCheck, k as markCommits, l as WebhookUrl, pt as InteractionKind, q as attemptWrite, rt as storeComponentRoute, t as Bus, tt as contextMenuRouteOf, u as Subscribe, v as ResolvedEmoji, w as hasAll, x as RequirePermissions, xt as ContextMenus, y as Silence, z as NotInDm, zt as RowComponent } from "./subscribers-Ce3SWy23.mjs";
-import { n as StartupPhase, t as ShutdownPhase } from "./phases-BauKJOTT.mjs";
+import { A as serializeReply, B as contextMenuRouteOf, C as NotAllowed, D as OnCooldown, E as NotOwner, F as AckTrace, H as storeComponentRoute, I as checkAckLegality, L as sendTarget, M as attemptWrite, N as publishResponse, O as defineEffectGate, R as RegisterInteractionMiddleware, S as NeedsAny, T as NotInGuild, U as storeInteractionRoute, X as ContextMenus, Y as Commands, a as RequireBotPermissions, b as MissingPermissions, d as presentNames, f as pickNotice, ft as NoticeCard, g as runCheck, h as rollbackCommits, i as Silence, j as translateSerializationError, k as defineGate, l as hasAll, m as markCommits, n as pageCursor, o as RequirePermissions, pt as Notice, q as RegisterCommand, r as ResolvedEmoji, s as RequireRole, t as PAGE_MAX, u as missingNames, w as NotInDm, y as HasDangerousPermissions } from "./subscribers-D4_HZcgw.mjs";
+import { M as RowComponent, T as InteractionKind, _ as MemoryDriver, d as WebhookLog, f as Subscriber, j as BuilderComponent, l as WebhookUrl, t as Bus, u as Subscribe, v as ShutdownPhase, y as StartupPhase } from "./Bus-W1K-uMeO.mjs";
 import "reflect-metadata";
 import { CustomId, decodeFor, prefixOf, setCustomIdErrors, setCustomIdErrors as setCustomIdErrors$1 } from "@seedcord/custom-id";
 import { ActionRowBuilder, ButtonBuilder, TextDisplayBuilder } from "@discordjs/builders";
@@ -291,15 +291,15 @@ function MentionableMenuRoute(...defs) {
 
 //#endregion
 //#region src/dispatch/DispatchContext.ts
-/**
-* A typed bag allocated once per interaction dispatch and handed to the handler. The middleware and i18n
-* work reads and writes it through {@link DispatchState}. Today the bag is empty, so it only carries the
-* dispatched `routeId`.
-*/
+/** State shared by middleware and handlers during one dispatch. */
 var DispatchContext = class {
-	routeId;
 	state = Object.create(null);
 	id = crypto.randomUUID();
+	/**
+	* The dispatch identifier, such as `slash:search/docs`, `button:approve`, or `event:messageCreate`.
+	* Component identifiers contain the custom-ID prefix without encoded params.
+	*/
+	routeId;
 	constructor(routeId) {
 		this.routeId = routeId;
 	}
@@ -359,10 +359,8 @@ var BaseHandler = class {
 var RepliableHandler = class extends BaseHandler {
 	/** The reply surface for this interaction. Pass the handler to reply from outside its class. */
 	sender;
-	routeId;
 	constructor(event, core, dispatch, sender) {
 		super(event, core, dispatch, "interactions");
-		this.routeId = dispatch.routeId;
 		this.sender = sender ?? this.buildSender(event, core, dispatch);
 	}
 	/** Send the initial response, exactly once. */
@@ -1146,11 +1144,119 @@ var CursorSourceBase = class {
 	}
 };
 
+//#endregion
+//#region src/kv/KeyvDriver.ts
+/**
+* Wraps a Keyv instance for `config.kv`.
+*
+* @example
+* ```ts
+* new Seedcord({ ...config, kv: new KeyvDriver(new Keyv(new KeyvSqlite('sqlite://./kv.sqlite'))) });
+* ```
+*/
+var KeyvDriver = class {
+	keyv;
+	constructor(keyv) {
+		this.keyv = keyv;
+	}
+	async get(key) {
+		const value = await this.keyv.get(key);
+		return typeof value === "string" ? value : void 0;
+	}
+	async set(key, value, ttlMs) {
+		if (!await this.keyv.set(key, value, ttlMs)) throw new SeedcordError(SeedcordErrorCode.CoreKvDriverFailed, ["write", key]);
+	}
+	async delete(key) {
+		await this.keyv.delete(key);
+	}
+	/** @throws A **SeedcordError** when the Keyv store can't list its keys, like `@keyv/memcache`. */
+	async *entries(prefix) {
+		if (!this.#canListKeys()) throw new SeedcordError(SeedcordErrorCode.CoreKvKeysUnsupported);
+		for await (const [key, value] of this.keyv.iterator()) if (key.startsWith(prefix) && typeof value === "string") yield [key, value];
+	}
+	async [Symbol.asyncDispose]() {
+		await this.keyv.disconnect();
+	}
+	#canListKeys() {
+		const capabilities = this.keyv.store.capabilities;
+		return capabilities?.store === "mapLike" || capabilities?.methods.iterator.exists === true;
+	}
+};
+
+//#endregion
+//#region src/kv/UnstorageDriver.ts
+const MIN_TTL_SECONDS = 60;
+const MS_PER_SECOND = 1e3;
+function storageKey(key) {
+	return `_${encodeURIComponent(key).replaceAll(".", "%2E")}`;
+}
+function originalKey(stored) {
+	return decodeURIComponent(stored.slice(1));
+}
+function text(raw) {
+	if (raw === null) return void 0;
+	return typeof raw === "string" ? raw : new TextDecoder().decode(raw);
+}
+/**
+* Wraps an unstorage `Storage` for `config.kv`.
+*
+* @example
+* ```ts
+* new Seedcord({ ...config, kv: new UnstorageDriver(createStorage({ driver: fsDriver({ base: './.kv' }) })) });
+* ```
+*/
+var UnstorageDriver = class {
+	storage;
+	constructor(storage) {
+		this.storage = storage;
+	}
+	async get(key) {
+		return text(await this.storage.getItemRaw(storageKey(key)));
+	}
+	async set(key, value, ttlMs) {
+		const ttl = ttlMs === void 0 ? {} : { ttl: Math.max(MIN_TTL_SECONDS, Math.ceil(ttlMs / MS_PER_SECOND)) };
+		await this.storage.setItemRaw(storageKey(key), value, ttl);
+	}
+	async delete(key) {
+		await this.storage.removeItem(storageKey(key));
+	}
+	async *entries(prefix) {
+		const storedPrefix = storageKey(prefix);
+		for (const key of await this.storage.getKeys()) {
+			if (!key.startsWith(storedPrefix)) continue;
+			const value = text(await this.storage.getItemRaw(key));
+			if (value !== void 0) yield [originalKey(key), value];
+		}
+	}
+	async [Symbol.asyncDispose]() {
+		await this.storage.dispose();
+	}
+};
+
+//#endregion
+//#region src/rateLimiter/buildKey.ts
+/**
+* Builds a rate-limit key from a prefix and scope parts, joined with `:`. A null or undefined part
+* becomes `'global'`. A key built from a DM's guild id reads `<prefix>:global` for every DM caller.
+*
+* @param prefix - The bucket family, e.g. `'cooldown'`.
+* @param parts - Scope values, e.g. a user or guild id.
+*
+* @example
+* ```ts
+* buildKey('report', interaction.guildId); // 'report:1234...' or 'report:global' in a DM
+* ```
+*/
+function buildKey(prefix, ...parts) {
+	if (parts.length === 0) return prefix;
+	return [prefix, ...parts.map((part) => part ?? "global")].join(":");
+}
+
 //#endregion
 //#region src/index.ts
 /** Package version */
-const version = "0.11.0";
+const version = "0.12.0-next.0";
 
 //#endregion
-export { ArraySourceBase, AutocompleteRoute, BaseHandler, BaseReplySender, BuilderComponent, Bus, ButtonRoute, ChannelMenuRoute, Commands, ContextMenus, Cooldown, CursorSourceBase, CustomId, DispatchContext, DmOnly, Fault, GuildOnly, InteractionKind, MentionableMenuRoute, MessageContextMenuRoute, ModalRoute, Notice, OwnerOnly, PaginatorBase, RegisterCommand, RegisterInteractionMiddleware, RepliableHandler, RequireBotPermissions, RequirePermissions, RequireRole, ResolvedEmoji, RoleMenuRoute, RowComponent, ShutdownPhase, Silence, SlashRoute, StartupPhase, StringMenuRoute, Subscribe, Subscriber, UserContextMenuRoute, UserMenuRoute, WebhookLog, WebhookUrl, and, assertPermissions, decodeFor, defineEffectGate, defineGate, mergeRoles, or, paginate, prefixOf, setCustomIdErrors, version };
+export { ArraySourceBase, AutocompleteRoute, BaseHandler, BaseReplySender, BuilderComponent, Bus, ButtonRoute, ChannelMenuRoute, Commands, ContextMenus, Cooldown, CursorSourceBase, CustomId, DispatchContext, DmOnly, Fault, GuildOnly, InteractionKind, KeyvDriver, MemoryDriver, MentionableMenuRoute, MessageContextMenuRoute, ModalRoute, Notice, OwnerOnly, PaginatorBase, RegisterCommand, RegisterInteractionMiddleware, RepliableHandler, RequireBotPermissions, RequirePermissions, RequireRole, ResolvedEmoji, RoleMenuRoute, RowComponent, ShutdownPhase, Silence, SlashRoute, StartupPhase, StringMenuRoute, Subscribe, Subscriber, UnstorageDriver, UserContextMenuRoute, UserMenuRoute, WebhookLog, WebhookUrl, and, assertPermissions, buildKey, decodeFor, defineEffectGate, defineGate, mergeRoles, or, paginate, prefixOf, setCustomIdErrors, version };
 //# sourceMappingURL=index.mjs.map