@seedcord/core 0.4.0 → 0.5.0

package/dist/{cursor-GBUYz3jk.mjs → cursor-BkI9lxy2.mjs}

@@ -1,11 +1,12 @@
-import { C as InteractionMetadataKey, T as InteractionRoutes, g as BuilderComponent, w as InteractionRouteKeys } from "./Bus-BVwmKc-A.mjs";
-import { n as asError, t as PublishDefault } from "./publishDefault-D826XXDQ.mjs";
+import { b as InteractionMetadataKey, k as BuilderComponent, x as InteractionRouteKeys, y as InteractionKind } from "./Bus-dGy6xq3F.mjs";
+import { n as asError, t as PublishDefault } from "./publishDefault-BuSZPbjT.mjs";
 import "reflect-metadata";
+import { CustomId, decodeFor } from "@seedcord/custom-id";
 import { TextDisplayBuilder } from "@discordjs/builders";
+import { ApplicationCommandType, PermissionFlagsBits } from "discord-api-types/v10";
 import { SeedcordErrorCode, paint } from "@seedcord/errors";
+import { SeedcordError } from "@seedcord/errors/internal";
 import { Logger } from "@seedcord/logger";
-import { ApplicationCommandType, PermissionFlagsBits } from "discord-api-types/v10";
-import { SeedcordError, SeedcordRangeError, SeedcordTypeError } from "@seedcord/errors/internal";
 import { prettify, toEpochSeconds } from "@seedcord/utils";
 
 //#region src/stops/Notice.ts
@@ -83,473 +84,6 @@ var NoticeCard = class extends BuilderComponent {
 	}
 };
 
-//#endregion
-//#region src/customId/Errors.ts
-/**
-* Thrown when a customId was minted by an older version of its shape.
-*
-* This is normal after the shape changes.
-*/
-var StaleCustomId = class extends Notice {
-	constructor(prefix) {
-		super(`Stale customId for "${prefix}".`);
-	}
-	render() {
-		return { components: [new NoticeCard("This button or menu is from an older version. Please run the command again.", "Outdated").component] };
-	}
-};
-/**
-* Thrown when a customId wire is corrupt or tampered with and cannot be trusted.
-*
-* It reports because this is an odd case that should not happen.
-*/
-var InvalidCustomId = class extends Notice {
-	constructor(detail) {
-		super(`Invalid customId. ${detail}`);
-		this.report = true;
-	}
-	render() {
-		return { components: [new NoticeCard("Something went wrong. Please try again.").component] };
-	}
-};
-
-//#endregion
-//#region src/customId/codec.ts
-const ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
-const BASE = 64n;
-const CHAR_TO_VALUE = new Map([...ALPHABET].map((char, index) => [char, index]));
-const DELIMITER = "";
-const ESCAPE = "\x1B";
-/** @internal */
-const HASH_LENGTH = 3;
-const SAFE_MAX = BigInt(Number.MAX_SAFE_INTEGER);
-const SAFE_MIN = BigInt(Number.MIN_SAFE_INTEGER);
-function bigintToBase64(value) {
-	if (value === 0n) return ALPHABET.charAt(0);
-	let text = "";
-	for (let remaining = value; remaining > 0n; remaining /= BASE) text = ALPHABET.charAt(Number(remaining % BASE)) + text;
-	return text;
-}
-function base64ToBigint(text) {
-	let value = 0n;
-	for (const char of text) {
-		const digit = CHAR_TO_VALUE.get(char);
-		if (digit === void 0) throw new InvalidCustomId(`bad character ${JSON.stringify(char)}`);
-		value = value * BASE + BigInt(digit);
-	}
-	return value;
-}
-function zigzagEncode(value) {
-	const big = BigInt(value);
-	return big >= 0n ? big << 1n : (-big << 1n) - 1n;
-}
-function zigzagDecode(encoded) {
-	return (encoded & 1n) === 1n ? -(encoded + 1n >> 1n) : encoded >> 1n;
-}
-function escapeToken(text) {
-	return text.replaceAll(/[\x1B\x1F]/g, (char) => ESCAPE + char);
-}
-function unescapeToken(text) {
-	let out = "";
-	for (let i = 0; i < text.length; i++) {
-		if (text.charAt(i) !== ESCAPE) {
-			out += text.charAt(i);
-			continue;
-		}
-		const next = text.charAt(i + 1);
-		if (next === "") throw new InvalidCustomId("dangling escape at end of token");
-		out += next;
-		i++;
-	}
-	return out;
-}
-function splitTokens(body) {
-	const pieces = [];
-	let current = "";
-	for (let i = 0; i < body.length; i++) {
-		const char = body.charAt(i);
-		if (char === ESCAPE) {
-			current += char + body.charAt(i + 1);
-			i++;
-		} else if (char === DELIMITER) {
-			pieces.push(current);
-			current = "";
-		} else current += char;
-	}
-	pieces.push(current);
-	return pieces;
-}
-function isBounded(field) {
-	if (field.kind === "int") return field.min !== void 0 && field.max !== void 0;
-	return field.kind === "snowflake" || field.kind === "uuid" || field.kind === "bool" || field.kind === "oneOf";
-}
-function radixOf(field) {
-	return kindRadix(field) + (field.nullable === true ? 1n : 0n);
-}
-function kindRadix(field) {
-	switch (field.kind) {
-		case "snowflake": return 1n << 64n;
-		case "uuid": return 1n << 128n;
-		case "bool": return 2n;
-		case "oneOf":
-			if (!field.choices?.length) throw new InvalidCustomId("oneOf field has no choices");
-			return BigInt(field.choices.length);
-		case "int":
-			if (field.min === void 0 || field.max === void 0) throw new InvalidCustomId("bounded int field is missing a bound");
-			return BigInt(field.max) - BigInt(field.min) + 1n;
-		default: throw new InvalidCustomId(`field kind ${field.kind} has no radix`);
-	}
-}
-function boundedToBigint(field, name, value) {
-	if (field.nullable === true) {
-		if (value === null) return 0n;
-		return boundedToBigint({
-			...field,
-			nullable: false
-		}, name, value) + 1n;
-	}
-	const slot = boundedSlot(field, name, value);
-	if (slot < 0n || slot >= radixOf(field)) outOfRange(name, value);
-	return slot;
-}
-function boundedSlot(field, name, value) {
-	switch (field.kind) {
-		case "snowflake":
-			if (typeof value !== "string" || !/^\d+$/.test(value)) return outOfRange(name, value);
-			return BigInt(value);
-		case "uuid": {
-			if (typeof value !== "string") return outOfRange(name, value);
-			const hex = value.replaceAll("-", "");
-			if (!/^[0-9a-fA-F]{32}$/.test(hex)) return outOfRange(name, value);
-			return BigInt(`0x${hex}`);
-		}
-		case "bool": return value ? 1n : 0n;
-		case "oneOf": {
-			const index = (field.choices ?? []).indexOf(value);
-			return index === -1 ? outOfRange(name, value) : BigInt(index);
-		}
-		case "int":
-			if (!Number.isInteger(value)) return outOfRange(name, value);
-			return BigInt(value - (field.min ?? 0));
-		default: return outOfRange(name, value);
-	}
-}
-function outOfRange(name, value) {
-	throw new SeedcordRangeError(SeedcordErrorCode.CustomIdValueOutOfRange, [name, String(value)]);
-}
-function bigintToBoundedValue(field, slot) {
-	if (field.nullable === true) return slot === 0n ? null : bigintToBoundedValue({
-		...field,
-		nullable: false
-	}, slot - 1n);
-	return kindValue(field, slot);
-}
-function kindValue(field, slot) {
-	switch (field.kind) {
-		case "snowflake": return slot.toString();
-		case "uuid": return bigintToUuid(slot);
-		case "bool": return slot === 1n;
-		case "oneOf": return (field.choices ?? [])[Number(slot)];
-		case "int": return Number(slot) + (field.min ?? 0);
-		default: throw new InvalidCustomId(`field kind ${field.kind} is not bounded`);
-	}
-}
-function bigintToUuid(value) {
-	const hex = value.toString(16).padStart(32, "0");
-	return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
-}
-const ABSENT = "0";
-const PRESENT = "1";
-function encodeUnboundedToken(field, name, value) {
-	if (field.nullable === true) {
-		if (value === null) return ABSENT;
-		return PRESENT + encodeUnboundedToken({
-			...field,
-			nullable: false
-		}, name, value);
-	}
-	if (field.kind === "int") {
-		if (!Number.isSafeInteger(value)) outOfRange(name, value);
-		return bigintToBase64(zigzagEncode(value));
-	}
-	return escapeToken(value);
-}
-function decodeUnboundedToken(field, piece) {
-	if (field.nullable === true) {
-		const marker = piece.charAt(0);
-		if (marker === ABSENT && piece.length === 1) return null;
-		if (marker !== PRESENT) throw new InvalidCustomId(`bad presence marker ${JSON.stringify(marker)}`);
-		return decodeUnboundedToken({
-			...field,
-			nullable: false
-		}, piece.slice(1));
-	}
-	if (field.kind !== "int") return unescapeToken(piece);
-	if (piece === "") throw new InvalidCustomId("empty integer token");
-	const decoded = zigzagDecode(base64ToBigint(piece));
-	if (decoded > SAFE_MAX || decoded < SAFE_MIN) throw new InvalidCustomId("integer out of safe range");
-	return Number(decoded);
-}
-/** @internal */
-function computeLayoutHash(shape) {
-	const signature = JSON.stringify(Object.entries(shape).map(([name, field]) => [
-		name,
-		field.kind,
-		isBounded(field),
-		field.nullable === true,
-		field.kind === "oneOf" ? field.choices ?? [] : null,
-		field.kind === "int" ? [field.min ?? null, field.max ?? null] : null
-	]));
-	const modulus = BASE ** BigInt(3);
-	let hash = 0n;
-	for (const char of signature) hash = (hash * 131n + BigInt(char.charCodeAt(0))) % modulus;
-	let text = "";
-	for (let i = 0; i < 3; i++) {
-		text = ALPHABET.charAt(Number(hash % BASE)) + text;
-		hash /= BASE;
-	}
-	return text;
-}
-/** @internal */
-function encodeBody(shape, values) {
-	const fields = Object.entries(shape);
-	const pieces = [];
-	const bounded = fields.filter(([, field]) => isBounded(field));
-	if (bounded.length > 0) {
-		let packed = 0n;
-		for (const [name, field] of bounded) packed = packed * radixOf(field) + boundedToBigint(field, name, values[name]);
-		pieces.push(bigintToBase64(packed));
-	}
-	for (const [name, field] of fields) if (!isBounded(field)) pieces.push(encodeUnboundedToken(field, name, values[name]));
-	return pieces.join(DELIMITER);
-}
-function unpackBounded(bounded, blob, result) {
-	if (blob === void 0 || blob === "") throw new InvalidCustomId("empty packed block");
-	let packed = base64ToBigint(blob);
-	for (const [name, field] of [...bounded].reverse()) {
-		const radix = radixOf(field);
-		result[name] = bigintToBoundedValue(field, packed % radix);
-		packed /= radix;
-	}
-	if (packed !== 0n) throw new InvalidCustomId("leftover bits after unpacking");
-}
-/** @internal */
-function decodeBody(shape, body) {
-	const fields = Object.entries(shape);
-	const bounded = fields.filter(([, field]) => isBounded(field));
-	const unbounded = fields.filter(([, field]) => !isBounded(field));
-	const expected = (bounded.length > 0 ? 1 : 0) + unbounded.length;
-	if (expected === 0) {
-		if (body !== "") throw new InvalidCustomId(`expected an empty body, got ${JSON.stringify(body)}`);
-		return {};
-	}
-	const pieces = splitTokens(body);
-	if (pieces.length !== expected) throw new InvalidCustomId(`expected ${expected} piece(s), got ${pieces.length}`);
-	const result = {};
-	let cursor = 0;
-	if (bounded.length > 0) {
-		unpackBounded(bounded, pieces[cursor], result);
-		cursor++;
-	}
-	for (const [name, field] of unbounded) {
-		const piece = pieces[cursor];
-		cursor++;
-		if (piece === void 0) throw new InvalidCustomId("missing trailing piece");
-		result[name] = decodeUnboundedToken(field, piece);
-	}
-	return result;
-}
-
-//#endregion
-//#region src/customId/CustomId.ts
-const MAX_WIRE_LENGTH = 100;
-function routeKeyOf(wire) {
-	const colon = wire.indexOf(":");
-	return colon === -1 ? "" : wire.slice(0, colon);
-}
-/** Strip the layout hash off the routeKey to recover the stable prefix the controller routes by. @internal */
-function prefixOf(wire) {
-	const key = routeKeyOf(wire);
-	return key.length <= 3 ? "" : key.slice(0, key.length - 3);
-}
-/**
-* A typed customId. The single source of truth shared by the component that mints it and the handler
-* that reads it. This gives you typed reads on the `.customId` field in components. Values are packed
-* into a compact wire string, which fits more of them inside Discord's 100-char limit.
-*
-* @typeParam Prefix - The stable route prefix, e.g. 'approve'.
-* @typeParam Shape - The accumulated fields, filled in by the chain.
-*
-* @example
-* ```ts
-* const ApproveId = new CustomId('approve')
-*     .snowflake('userId')
-*     .oneOf('action', ['approve', 'deny']);
-*
-* // Set the custom id on a button when creating it.
-* new ButtonBuilder().setCustomId(ApproveId.encode({ userId: '123', action: 'approve' }));
-*
-* // in the handler, userId comes back a string
-* const { userId, action } = this.params; // userId: string, action: 'approve' | 'deny'
-* await this.event.guild?.members.fetch(userId);
-* ```
-*/
-var CustomId = class CustomId {
-	/** The stable route prefix, e.g. 'approve'. */
-	prefix;
-	/** The field definitions accumulated by the chain, keyed by name. */
-	shape;
-	/** The prefix plus a short hash of the shape, the part of the wire before the colon. */
-	routeKey;
-	constructor(prefix, shape = {}) {
-		if (!prefix || /[:\x1B\x1F]/.test(prefix)) throw new SeedcordTypeError(SeedcordErrorCode.CustomIdInvalidPrefix, [prefix]);
-		this.prefix = prefix;
-		this.shape = shape;
-		this.routeKey = prefix + computeLayoutHash(shape);
-	}
-	add(name, field) {
-		if (/^(?:0|[1-9]\d*)$/.test(name)) throw new SeedcordTypeError(SeedcordErrorCode.CustomIdReservedFieldName, [name]);
-		if (name in this.shape) throw new SeedcordTypeError(SeedcordErrorCode.CustomIdDuplicateFieldName, [name]);
-		const shape = {
-			...this.shape,
-			[name]: field
-		};
-		return new CustomId(this.prefix, shape);
-	}
-	/**
-	* Add a Discord ID field, decoded as a string (the `Snowflake` type from discord-api-types).
-	*
-	* @example
-	* ```ts
-	* new CustomId('ban').snowflake('userId');
-	* ```
-	*/
-	snowflake(name, opts) {
-		return this.add(name, {
-			...opts,
-			kind: "snowflake"
-		});
-	}
-	/**
-	* Add a UUID field, decoded as a lowercase uuid string.
-	*
-	* @example
-	* ```ts
-	* new CustomId('ticket').uuid('ticketId');
-	* ```
-	*/
-	uuid(name, opts) {
-		return this.add(name, {
-			...opts,
-			kind: "uuid"
-		});
-	}
-	int(name, minOrOpts, max, opts) {
-		const min = typeof minOrOpts === "number" ? minOrOpts : void 0;
-		if (min !== void 0 && max !== void 0 && min > max) throw new SeedcordRangeError(SeedcordErrorCode.CustomIdInvalidBounds, [
-			name,
-			min,
-			max
-		]);
-		const options = typeof minOrOpts === "number" ? opts : minOrOpts;
-		const bounds = min === void 0 || max === void 0 ? {} : {
-			min,
-			max
-		};
-		return this.add(name, {
-			...options,
-			kind: "int",
-			...bounds
-		});
-	}
-	/**
-	* Add a boolean flag.
-	*
-	* @example
-	* ```ts
-	* new CustomId('settings').bool('silent');
-	* ```
-	*/
-	bool(name, opts) {
-		return this.add(name, {
-			...opts,
-			kind: "bool"
-		});
-	}
-	/**
-	* Add a field that is one value from a fixed list, decoded as the literal union. No `as const` needed.
-	*
-	* @example
-	* ```ts
-	* new CustomId('poll').oneOf('choice', ['yes', 'no', 'abstain']);
-	* ```
-	*/
-	oneOf(name, choices, opts) {
-		if (choices.length === 0) throw new SeedcordRangeError(SeedcordErrorCode.CustomIdEmptyChoices, [name]);
-		return this.add(name, {
-			...opts,
-			kind: "oneOf",
-			choices
-		});
-	}
-	/**
-	* Add a free short text field. Avoid it where possible. It cannot be packed, which makes it the most
-	* expensive field on the wire.
-	*
-	* @example
-	* ```ts
-	* new CustomId('note').str('message');
-	* ```
-	*/
-	str(name, opts) {
-		return this.add(name, {
-			...opts,
-			kind: "string"
-		});
-	}
-	/**
-	* Mint a wire string from values. Throws if a value is out of its field's range or the wire is over 100 chars.
-	*
-	* @param values - One value per field, typed by the chain.
-	* @returns The wire string to put on the component's customId.
-	*/
-	encode(values) {
-		const wire = `${this.routeKey}:${encodeBody(this.shape, values)}`;
-		if (wire.length > MAX_WIRE_LENGTH) throw new SeedcordRangeError(SeedcordErrorCode.CustomIdWireTooLong, [wire.length]);
-		return wire;
-	}
-	/**
-	* Read a wire string back into values.
-	*
-	* - This will refuse with a default Notice when the shape changed since the wire was minted.
-	* - Or refuse with a different default Notice on a corrupt or foreign wire.
-	*
-	* @param wire - The customId string from the interaction.
-	* @returns The decoded values, typed by the chain.
-	*/
-	decode(wire) {
-		const key = routeKeyOf(wire);
-		if (key !== this.routeKey) {
-			if (prefixOf(wire) === this.prefix) throw new StaleCustomId(this.prefix);
-			throw new InvalidCustomId(`routeKey ${JSON.stringify(key)} is not ${JSON.stringify(this.routeKey)}`);
-		}
-		return decodeBody(this.shape, wire.slice(key.length + 1));
-	}
-	/** True if this wire was minted from this customId's prefix, ignoring the shape hash. */
-	owns(wire) {
-		return prefixOf(wire) === this.prefix;
-	}
-};
-/** @internal */
-function decodeFor(defs, wire) {
-	const match = defs.find((def) => def.owns(wire));
-	if (!match) throw new InvalidCustomId(`no customId owns ${JSON.stringify(routeKeyOf(wire))}`);
-	return {
-		prefix: match.prefix,
-		params: match.decode(wire)
-	};
-}
-
 //#endregion
 //#region src/customId/routing.ts
 /**
@@ -558,7 +92,7 @@ function decodeFor(defs, wire) {
 *
 * @internal
 */
-const ComponentDefsKey = Symbol("seedcord:customId:componentDefs");
+const ComponentDefsKey = Symbol.for("seedcord:custom-id:component-defs");
 /**
 * throws `CustomIdHandlerRouteMissing` when the class has no stored defs. a drifted or corrupt wire
 * throws `StaleCustomId` or `InvalidCustomId`.
@@ -573,25 +107,12 @@ function decodeComponentRoute(handlerClass, wire) {
 
 //#endregion
 //#region src/decorators/interactionRoutes.ts
-/** The select menu kinds the select route decorators take. */
-let SelectMenuKind = /* @__PURE__ */ function(SelectMenuKind) {
-	SelectMenuKind["String"] = "string";
-	SelectMenuKind["User"] = "user";
-	SelectMenuKind["Role"] = "role";
-	SelectMenuKind["Channel"] = "channel";
-	SelectMenuKind["Mentionable"] = "mentionable";
-	return SelectMenuKind;
-}({});
 function areRoutes(routes) {
 	return Array.isArray(routes) && routes.every((route) => typeof route === "string");
 }
-/**
-* every stored route kind and its route strings on a decorated constructor. the build's manifest
-* emitter reads the same pairs.
-*/
 function interactionRoutesOf(constructor) {
 	const pairs = [];
-	for (const route of Object.values(InteractionRoutes)) {
+	for (const route of Object.values(InteractionKind)) {
 		const meta = Reflect.getMetadata(InteractionRouteKeys[route], constructor);
 		if (areRoutes(meta)) pairs.push([route, meta]);
 	}
@@ -609,16 +130,6 @@ function storeComponentRoute(route, defs, constructor) {
 	storeInteractionRoute(route, defs.map((def) => def.prefix), constructor);
 	Reflect.defineMetadata(ComponentDefsKey, defs, constructor);
 }
-const SELECT_ROUTES = {
-	["string"]: "stringMenu",
-	["user"]: "userMenu",
-	["role"]: "roleMenu",
-	["channel"]: "channelMenu",
-	["mentionable"]: "mentionableMenu"
-};
-function selectMenuRouteOf(kind) {
-	return SELECT_ROUTES[kind];
-}
 function contextMenuRouteOf(kind) {
 	return kind === ApplicationCommandType.User ? "userContextMenu" : "messageContextMenu";
 }
@@ -1249,5 +760,5 @@ function pageCursor(prefix) {
 }
 
 //#endregion
-export { translateSerializationError as A, interactionRoutesOf as B, NotInDm as C, defineEffectGate as D, OnCooldown as E, checkAckLegality as F, decodeComponentRoute as G, storeComponentRoute as H, sendTarget as I, prefixOf as J, CustomId as K, SelectMenuKind as L, publishResponse as M, reportedWrite as N, defineGate as O, AckTrace as P, areRoutes as R, NotAllowed as S, NotOwner as T, storeInteractionRoute as U, selectMenuRouteOf as V, ComponentDefsKey as W, Notice as X, NoticeCard as Y, GateNotice as _, RequirePermissions as a, MissingRole as b, hasAll as c, pickNotice as d, discardCommits as f, runCommits as g, runCheck as h, RequireBotPermissions as i, attemptWrite as j, serializeReply as k, missingNames as l, rollbackCommits as m, pageCursor as n, RequireRole as o, markCommits as p, decodeFor as q, Silence as r, PermissionNames as s, PAGE_MAX as t, presentNames as u, HasDangerousPermissions as v, NotInGuild as w, NeedsAny as x, MissingPermissions as y, contextMenuRouteOf as z };
-//# sourceMappingURL=cursor-GBUYz3jk.mjs.map
+export { translateSerializationError as A, storeComponentRoute as B, NotInDm as C, defineEffectGate as D, OnCooldown as E, checkAckLegality as F, Notice as G, ComponentDefsKey as H, sendTarget as I, areRoutes as L, publishResponse as M, reportedWrite as N, defineGate as O, AckTrace as P, contextMenuRouteOf as R, NotAllowed as S, NotOwner as T, decodeComponentRoute as U, storeInteractionRoute as V, NoticeCard as W, GateNotice as _, RequirePermissions as a, MissingRole as b, hasAll as c, pickNotice as d, discardCommits as f, runCommits as g, runCheck as h, RequireBotPermissions as i, attemptWrite as j, serializeReply as k, missingNames as l, rollbackCommits as m, pageCursor as n, RequireRole as o, markCommits as p, Silence as r, PermissionNames as s, PAGE_MAX as t, presentNames as u, HasDangerousPermissions as v, NotInGuild as w, NeedsAny as x, MissingPermissions as y, interactionRoutesOf as z };
+//# sourceMappingURL=cursor-BkI9lxy2.mjs.map