@helyx/module-reactionroles 1.0.1

package/dist/panel-service.d.ts

@@ -0,0 +1,86 @@
+import type { ManagedResourceContext, ManagedResourceDetail, ManagedResourcePage, ManagedResourceValue, MessageResponse, ServiceAccess } from "@helyx/sdk";
+import { type PanelDraft } from "./builder.js";
+import { ReactionRolePanelRepository, type StoredPanel } from "./records.js";
+export interface PanelMutationContext {
+    guildId: string;
+    actorUserId: string;
+    source: "dashboard" | "discord";
+    services: ServiceAccess;
+    correlationId?: string;
+    sendToChannel(channelId: string, response: MessageResponse): Promise<{
+        messageId: string;
+    }>;
+    deleteChannelMessage(channelId: string, messageId: string): Promise<void>;
+    editChannelMessage(channelId: string, messageId: string, response: MessageResponse): Promise<void>;
+    addChannelMessageReaction(channelId: string, messageId: string, emojiIdentifier: string): Promise<void>;
+}
+export declare class PanelSnapshotCache {
+    #private;
+    get(guildId: string, messageId: string): StoredPanel | null;
+    getFresh(guildId: string, messageId: string): StoredPanel | null;
+    negativeHit(guildId: string, messageId: string): boolean;
+    markMissing(guildId: string, messageId: string): void;
+    load(guildId: string, messageId: string, operation: () => Promise<StoredPanel | null>): Promise<StoredPanel | null>;
+    put(panel: StoredPanel): void;
+    remove(panel: Pick<StoredPanel, "guildId" | "messageId">): void;
+    suspend(panel: Pick<StoredPanel, "guildId" | "messageId">): (replacement?: StoredPanel | null) => void;
+    clear(): void;
+    size(): number;
+    saturated(): boolean;
+}
+export declare class ReactionRolePanelService {
+    private readonly cache;
+    constructor(cache: PanelSnapshotCache);
+    repository(services: ServiceAccess): ReactionRolePanelRepository;
+    warm(services: ServiceAccess): Promise<number>;
+    recoverMessageCleanup(services: ServiceAccess): Promise<{
+        completed: number;
+        failed: number;
+        abandoned: number;
+    }>;
+    getCached(guildId: string, messageId: string): StoredPanel | null;
+    resolveActive(guildId: string, messageId: string, services: ServiceAccess): Promise<StoredPanel | null>;
+    list(context: ManagedResourceContext, input: {
+        cursor?: string;
+        limit: number;
+    }): Promise<ManagedResourcePage>;
+    read(context: ManagedResourceContext, resourceId: string): Promise<ManagedResourceDetail | null>;
+    preview(context: ManagedResourceContext, value: Readonly<Record<string, ManagedResourceValue>>): Promise<MessageResponse>;
+    create(context: PanelMutationContext, draftInput: PanelDraft): Promise<StoredPanel>;
+    update(context: PanelMutationContext, input: {
+        resourceId: string;
+        expectedRevision: number;
+        draft: PanelDraft;
+        replacementAction?: "repair" | "repost";
+    }): Promise<StoredPanel>;
+    delete(context: PanelMutationContext, panelId: string, expectedRevision: number): Promise<boolean>;
+    repair(context: PanelMutationContext, panelId: string, expectedRevision: number, repost: boolean): Promise<StoredPanel>;
+    markMessageMissing(input: {
+        guildId: string;
+        messageId: string;
+        services: ServiceAccess;
+    }): Promise<void>;
+    markNeedsAttention(panel: StoredPanel, services: ServiceAccess): Promise<boolean>;
+    handleChannelLifecycle(input: {
+        guildId: string;
+        channelId: string;
+        deleted: boolean;
+        services: ServiceAccess;
+    }): Promise<number>;
+    handleRoleLifecycle(input: {
+        guildId: string;
+        roleId: string;
+        deleted: boolean;
+        services: ServiceAccess;
+    }): Promise<number>;
+    handleEmojiLifecycle(input: {
+        guildId: string;
+        emojiId: string;
+        deleted: boolean;
+        services: ServiceAccess;
+    }): Promise<number>;
+    audit(context: PanelMutationContext, action: string, panel: StoredPanel, result?: "success" | "cleanup_pending"): Promise<void>;
+}
+export declare function managedContext(context: ManagedResourceContext): PanelMutationContext;
+export declare function parseManagedDraft(value: Readonly<Record<string, ManagedResourceValue>>): PanelDraft;
+export declare function toDetail(panel: StoredPanel): ManagedResourceDetail;