refactor: share allowlist match metadata

Co-authored-by: thewilloftheshadow <thewilloftheshadow@users.noreply.github.com>

src/channels/allowlist-match.ts

@@ -0,0 +1,21 @@
+export type AllowlistMatchSource =
+  | "wildcard"
+  | "id"
+  | "name"
+  | "tag"
+  | "username"
+  | "prefixed-id"
+  | "prefixed-user"
+  | "prefixed-name"
+  | "slug"
+  | "localpart";
+
+export type AllowlistMatch<TSource extends string = AllowlistMatchSource> = {
+  allowed: boolean;
+  matchKey?: string;
+  matchSource?: TSource;
+};
+
+export function formatAllowlistMatchMeta(match?: AllowlistMatch | null): string {
+  return `matchKey=${match?.matchKey ?? "none"} matchSource=${match?.matchSource ?? "none"}`;
+}

src/channels/plugins/allowlist-match.ts

@@ -0,0 +1,2 @@
+export type { AllowlistMatch, AllowlistMatchSource } from "../allowlist-match.js";
+export { formatAllowlistMatchMeta } from "../allowlist-match.js";

src/channels/plugins/index.ts

@@ -93,4 +93,9 @@ export {
   type ChannelEntryMatch,
   type ChannelMatchSource,
 } from "./channel-config.js";
+export {
+  formatAllowlistMatchMeta,
+  type AllowlistMatch,
+  type AllowlistMatchSource,
+} from "./allowlist-match.js";
 export type { ChannelId, ChannelPlugin } from "./types.js";