@open-discord-bots/framework 0.3.2 → 0.3.4

package/dist/api/modules/responder.js

@@ -372,8 +372,8 @@ export class ODCommandResponderInstance extends ODBaseResponderInstance {
     cmd;
     /**The type/source of instance. (from text or slash command) */
     type;
-    /**Did a worker already reply to this instance/interaction? */
-    didReply = false;
+    /**Switches to `true` when a worker replies, edits or defers interaction. Will stop the timeout error from being shown. */
+    ignoreResponderTimeout = false;
     /**The manager for all options of this command. */
     options;
     /**The user who triggered this command. */
@@ -397,27 +397,27 @@ export class ODCommandResponderInstance extends ODBaseResponderInstance {
         this.guild = interaction.guild;
         this.channel = interaction.channel;
         setTimeout(async () => {
-            if (!this.didReply) {
-                try {
-                    if (!errorCallback) {
-                        this.reply({ id: new ODId("opendiscord:unknown-error"), ephemeral: true, message: {
-                                content: ":x: **Something went wrong while replying to this command!**"
-                            } });
-                    }
-                    else {
-                        const errorResponse = await errorCallback(this, (this.type == "interaction") ? "slash" : "text");
-                        //auto-delete timeout error message after 5sec when text-based
-                        if (errorResponse.success && this.type == "message")
-                            setTimeout(() => {
-                                if (errorResponse.message?.deletable)
-                                    errorResponse.message?.delete();
-                            }, 5000);
-                    }
+            if (this.ignoreResponderTimeout)
+                return;
+            try {
+                if (!errorCallback) {
+                    this.reply({ id: new ODId("opendiscord:unknown-error"), ephemeral: true, message: {
+                            content: ":x: **Something went wrong while replying to this command!**"
+                        } });
                 }
-                catch (err) {
-                    process.emit("uncaughtException", err);
+                else {
+                    const errorResponse = await errorCallback(this, (this.type == "interaction") ? "slash" : "text");
+                    //auto-delete timeout error message after 5sec when text-based
+                    if (errorResponse.success && this.type == "message")
+                        setTimeout(() => {
+                            if (errorResponse.message?.deletable)
+                                errorResponse.message?.delete();
+                        }, 5000);
                 }
             }
+            catch (err) {
+                process.emit("uncaughtException", err);
+            }
         }, timeoutMs ?? 2500);
     }
     /**Reply to this command. */
@@ -427,46 +427,46 @@ export class ODCommandResponderInstance extends ODBaseResponderInstance {
             if (this.type == "interaction" && this.interaction instanceof discord.ChatInputCommandInteraction) {
                 if (this.interaction.replied || this.interaction.deferred) {
                     const sent = await this.interaction.editReply(finalMessage);
-                    this.didReply = true;
+                    this.ignoreResponderTimeout = true;
                     return { success: true, message: sent };
                 }
                 else {
                     const sent = await this.interaction.reply(finalMessage);
-                    this.didReply = true;
+                    this.ignoreResponderTimeout = true;
                     return { success: true, message: await sent.fetch() };
                 }
             }
             else if (this.type == "message" && this.interaction instanceof discord.Message && this.interaction.channel.type != discord.ChannelType.GroupDM) {
                 const sent = await this.interaction.channel.send(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: sent };
             }
             else
-                return { success: false, message: null };
+                return { success: false };
         }
         catch {
-            return { success: false, message: null };
+            return { success: false };
         }
     }
     /**Defer this command. */
     async defer(ephemeral) {
+        this.ignoreResponderTimeout = true;
         if (this.type != "interaction" || !(this.interaction instanceof discord.ChatInputCommandInteraction))
             return false;
         if (this.interaction.deferred || this.interaction.replied)
             return false;
         const msgFlags = ephemeral ? [discord.MessageFlags.Ephemeral] : [];
         await this.interaction.deferReply({ flags: msgFlags });
-        this.didReply = true;
         return true;
     }
     /**Show a modal as reply to this command. */
     async modal(modal) {
+        this.ignoreResponderTimeout = true;
         if (this.type != "interaction" || !(this.interaction instanceof discord.ChatInputCommandInteraction))
             return false;
         if (this.interaction.deferred || this.interaction.replied)
             return false;
         await this.interaction.showModal(modal.modal);
-        this.didReply = true;
         return true;
     }
 }
@@ -553,8 +553,8 @@ export class ODButtonResponderManager extends ODManager {
 export class ODButtonResponderInstance extends ODBaseResponderInstance {
     /**The interaction which is the source of this instance. */
     interaction;
-    /**Did a worker already reply to this instance/interaction? */
-    didReply = false;
+    /**Switches to `true` when a worker replies, edits or defers interaction. Will stop the timeout error from being shown. */
+    ignoreResponderTimeout = false;
     /**The user who triggered this button. */
     user;
     /**The guild member who triggered this button. */
@@ -576,21 +576,21 @@ export class ODButtonResponderInstance extends ODBaseResponderInstance {
         this.channel = interaction.channel;
         this.message = interaction.message;
         setTimeout(async () => {
-            if (!this.didReply) {
-                try {
-                    if (!errorCallback) {
-                        this.reply({ id: new ODId("opendiscord:unknown-error"), ephemeral: true, message: {
-                                content: ":x: **Something went wrong while replying to this button!**"
-                            } });
-                    }
-                    else {
-                        await errorCallback(this, "button");
-                    }
+            if (this.ignoreResponderTimeout)
+                return;
+            try {
+                if (!errorCallback) {
+                    this.reply({ id: new ODId("opendiscord:unknown-error"), ephemeral: true, message: {
+                            content: ":x: **Something went wrong while replying to this button!**"
+                        } });
                 }
-                catch (err) {
-                    process.emit("uncaughtException", err);
+                else {
+                    await errorCallback(this, "button");
                 }
             }
+            catch (err) {
+                process.emit("uncaughtException", err);
+            }
         }, timeoutMs ?? 2500);
     }
     /**Reply to this button. */
@@ -599,17 +599,17 @@ export class ODButtonResponderInstance extends ODBaseResponderInstance {
             const finalMessage = this.getMessageFromBuildResult(build, "interaction");
             if (this.interaction.replied || this.interaction.deferred) {
                 const sent = await this.interaction.editReply(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: sent };
             }
             else {
                 const sent = await this.interaction.reply(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: await sent.fetch() };
             }
         }
         catch {
-            return { success: false, message: null };
+            return { success: false };
         }
     }
     /**Update the message of this button. */
@@ -618,21 +618,22 @@ export class ODButtonResponderInstance extends ODBaseResponderInstance {
             const finalMessage = this.getMessageFromBuildResult(build, "interaction");
             if (this.interaction.replied || this.interaction.deferred) {
                 const sent = await this.interaction.editReply(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: await sent.fetch() };
             }
             else {
                 const sent = await this.interaction.update(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: await sent.fetch() };
             }
         }
         catch {
-            return { success: false, message: null };
+            return { success: false };
         }
     }
     /**Defer this button. */
     async defer(type, ephemeral) {
+        this.ignoreResponderTimeout = true;
         if (this.interaction.deferred || this.interaction.replied)
             return false;
         if (type == "reply") {
@@ -642,15 +643,14 @@ export class ODButtonResponderInstance extends ODBaseResponderInstance {
         else {
             await this.interaction.deferUpdate();
         }
-        this.didReply = true;
         return true;
     }
     /**Show a modal as reply to this button. */
     async modal(modal) {
+        this.ignoreResponderTimeout = true;
         if (this.interaction.deferred || this.interaction.replied)
             return false;
         await this.interaction.showModal(modal.modal);
-        this.didReply = true;
         return true;
     }
     getMessageComponent(type, id) {
@@ -839,8 +839,8 @@ export class ODDropdownResponderInstanceValues {
 export class ODDropdownResponderInstance extends ODBaseResponderInstance {
     /**The interaction which is the source of this instance. */
     interaction;
-    /**Did a worker already reply to this instance/interaction? */
-    didReply = false;
+    /**Switches to `true` when a worker replies, edits or defers interaction. Will stop the timeout error from being shown. */
+    ignoreResponderTimeout = false;
     /**The dropdown type. */
     type;
     /**The manager for all values of this dropdown. */
@@ -884,21 +884,21 @@ export class ODDropdownResponderInstance extends ODBaseResponderInstance {
         this.channel = interaction.channel;
         this.message = interaction.message;
         setTimeout(async () => {
-            if (!this.didReply) {
-                try {
-                    if (!errorCallback) {
-                        this.reply({ id: new ODId("opendiscord:unknown-error"), ephemeral: true, message: {
-                                content: ":x: **Something went wrong while replying to this dropdown!**"
-                            } });
-                    }
-                    else {
-                        await errorCallback(this, "dropdown");
-                    }
+            if (this.ignoreResponderTimeout)
+                return;
+            try {
+                if (!errorCallback) {
+                    this.reply({ id: new ODId("opendiscord:unknown-error"), ephemeral: true, message: {
+                            content: ":x: **Something went wrong while replying to this dropdown!**"
+                        } });
                 }
-                catch (err) {
-                    process.emit("uncaughtException", err);
+                else {
+                    await errorCallback(this, "dropdown");
                 }
             }
+            catch (err) {
+                process.emit("uncaughtException", err);
+            }
         }, timeoutMs ?? 2500);
     }
     /**Reply to this dropdown. */
@@ -907,17 +907,17 @@ export class ODDropdownResponderInstance extends ODBaseResponderInstance {
             const finalMessage = this.getMessageFromBuildResult(build, "interaction");
             if (this.interaction.replied || this.interaction.deferred) {
                 const sent = await this.interaction.editReply(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: sent };
             }
             else {
                 const sent = await this.interaction.reply(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: await sent.fetch() };
             }
         }
         catch {
-            return { success: false, message: null };
+            return { success: false };
         }
     }
     /**Update the message of this dropdown. */
@@ -926,21 +926,22 @@ export class ODDropdownResponderInstance extends ODBaseResponderInstance {
             const finalMessage = this.getMessageFromBuildResult(build, "interaction");
             if (this.interaction.replied || this.interaction.deferred) {
                 const sent = await this.interaction.editReply(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: await sent.fetch() };
             }
             else {
                 const sent = await this.interaction.update(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: await sent.fetch() };
             }
         }
         catch {
-            return { success: false, message: null };
+            return { success: false };
         }
     }
     /**Defer this dropdown. */
     async defer(type, ephemeral) {
+        this.ignoreResponderTimeout = true;
         if (this.interaction.deferred || this.interaction.replied)
             return false;
         if (type == "reply") {
@@ -950,15 +951,14 @@ export class ODDropdownResponderInstance extends ODBaseResponderInstance {
         else {
             await this.interaction.deferUpdate();
         }
-        this.didReply = true;
         return true;
     }
     /**Show a modal as reply to this dropdown. */
     async modal(modal) {
+        this.ignoreResponderTimeout = true;
         if (this.interaction.deferred || this.interaction.replied)
             return false;
         await this.interaction.showModal(modal.modal);
-        this.didReply = true;
         return true;
     }
     getMessageComponent(type, id) {
@@ -1088,8 +1088,8 @@ export class ODModalResponderInstanceValues {
 export class ODModalResponderInstance extends ODBaseResponderInstance {
     /**The interaction which is the source of this instance. */
     interaction;
-    /**Did a worker already reply to this instance/interaction? */
-    didReply = false;
+    /**Switches to `true` when a worker replies, edits or defers interaction. Will stop the timeout error from being shown. */
+    ignoreResponderTimeout = false;
     /**The manager for all fields of this modal. */
     values;
     /**The user who triggered this modal. */
@@ -1109,21 +1109,21 @@ export class ODModalResponderInstance extends ODBaseResponderInstance {
         this.guild = interaction.guild;
         this.channel = interaction.channel;
         setTimeout(async () => {
-            if (!this.didReply) {
-                try {
-                    if (!errorCallback) {
-                        this.reply({ id: new ODId("opendiscord:unknown-error"), ephemeral: true, message: {
-                                content: ":x: **Something went wrong while replying to this modal!**"
-                            } });
-                    }
-                    else {
-                        await errorCallback(this, "modal");
-                    }
+            if (this.ignoreResponderTimeout)
+                return;
+            try {
+                if (!errorCallback) {
+                    this.reply({ id: new ODId("opendiscord:unknown-error"), ephemeral: true, message: {
+                            content: ":x: **Something went wrong while replying to this modal!**"
+                        } });
                 }
-                catch (err) {
-                    process.emit("uncaughtException", err);
+                else {
+                    await errorCallback(this, "modal");
                 }
             }
+            catch (err) {
+                process.emit("uncaughtException", err);
+            }
         }, timeoutMs ?? 2500);
     }
     /**Reply to this modal. */
@@ -1131,11 +1131,11 @@ export class ODModalResponderInstance extends ODBaseResponderInstance {
         try {
             const finalMessage = this.getMessageFromBuildResult(build, "interaction");
             const sent = await this.interaction.followUp(finalMessage);
-            this.didReply = true;
+            this.ignoreResponderTimeout = true;
             return { success: true, message: sent };
         }
         catch {
-            return { success: false, message: null };
+            return { success: false };
         }
     }
     /**Update the message of this modal. */
@@ -1144,21 +1144,22 @@ export class ODModalResponderInstance extends ODBaseResponderInstance {
             const finalMessage = this.getMessageFromBuildResult(build, "interaction");
             if (this.interaction.replied || this.interaction.deferred) {
                 const sent = await this.interaction.editReply(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: await sent.fetch() };
             }
             else {
                 const sent = await this.interaction.reply(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: await sent.fetch() };
             }
         }
         catch {
-            return { success: false, message: null };
+            return { success: false };
         }
     }
     /**Defer this modal. */
     async defer(type, ephemeral) {
+        this.ignoreResponderTimeout = true;
         if (this.interaction.deferred || this.interaction.replied)
             return false;
         if (type == "reply") {
@@ -1168,7 +1169,6 @@ export class ODModalResponderInstance extends ODBaseResponderInstance {
         else {
             await this.interaction.deferUpdate();
         }
-        this.didReply = true;
         return true;
     }
 }
@@ -1241,8 +1241,8 @@ export class ODContextMenuResponderManager extends ODManager {
 export class ODContextMenuResponderInstance extends ODBaseResponderInstance {
     /**The interaction which is the source of this instance. */
     interaction;
-    /**Did a worker already reply to this instance/interaction? */
-    didReply = false;
+    /**Switches to `true` when a worker replies, edits or defers interaction. Will stop the timeout error from being shown. */
+    ignoreResponderTimeout = false;
     /**The context menu wich is the source of this instance. */
     menu;
     /**The user who triggered this context menu. */
@@ -1272,21 +1272,21 @@ export class ODContextMenuResponderInstance extends ODBaseResponderInstance {
         else
             throw new ODSystemError("ODContextMenuResponderInstance: Invalid context menu type. Should be of the type User/Message!");
         setTimeout(async () => {
-            if (!this.didReply) {
-                try {
-                    if (!errorCallback) {
-                        this.reply({ id: new ODId("opendiscord:unknown-error"), ephemeral: true, message: {
-                                content: ":x: **Something went wrong while replying to this context menu!**"
-                            } });
-                    }
-                    else {
-                        await errorCallback(this, "context-menu");
-                    }
+            if (this.ignoreResponderTimeout)
+                return;
+            try {
+                if (!errorCallback) {
+                    this.reply({ id: new ODId("opendiscord:unknown-error"), ephemeral: true, message: {
+                            content: ":x: **Something went wrong while replying to this context menu!**"
+                        } });
                 }
-                catch (err) {
-                    process.emit("uncaughtException", err);
+                else {
+                    await errorCallback(this, "context-menu");
                 }
             }
+            catch (err) {
+                process.emit("uncaughtException", err);
+            }
         }, timeoutMs ?? 2500);
     }
     /**Reply to this context menu. */
@@ -1295,17 +1295,17 @@ export class ODContextMenuResponderInstance extends ODBaseResponderInstance {
             const finalMessage = this.getMessageFromBuildResult(build, "interaction");
             if (this.interaction.replied || this.interaction.deferred) {
                 const sent = await this.interaction.editReply(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: sent };
             }
             else {
                 const sent = await this.interaction.reply(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: await sent.fetch() };
             }
         }
         catch {
-            return { success: false, message: null };
+            return { success: false };
         }
     }
     /**Update the message of this context menu. */
@@ -1314,33 +1314,33 @@ export class ODContextMenuResponderInstance extends ODBaseResponderInstance {
             const finalMessage = this.getMessageFromBuildResult(build, "interaction");
             if (this.interaction.replied || this.interaction.deferred) {
                 const sent = await this.interaction.editReply(finalMessage);
-                this.didReply = true;
+                this.ignoreResponderTimeout = true;
                 return { success: true, message: await sent.fetch() };
             }
             else
                 throw new ODSystemError("Unable to update context menu interaction!");
         }
         catch {
-            return { success: false, message: null };
+            return { success: false };
         }
     }
     /**Defer this context menu. */
     async defer(type, ephemeral) {
+        this.ignoreResponderTimeout = true;
         if (this.interaction.deferred || this.interaction.replied)
             return false;
         if (type == "reply") {
             const msgFlags = ephemeral ? [discord.MessageFlags.Ephemeral] : [];
             await this.interaction.deferReply({ flags: msgFlags });
         }
-        this.didReply = true;
         return true;
     }
     /**Show a modal as reply to this context menu. */
     async modal(modal) {
+        this.ignoreResponderTimeout = true;
         if (this.interaction.deferred || this.interaction.replied)
             return false;
         await this.interaction.showModal(modal.modal);
-        this.didReply = true;
         return true;
     }
 }

package/dist/api/modules/state.d.ts

@@ -0,0 +1,126 @@
+import { ODManager, ODValidId, ODManagerData, ODNoGeneric } from "./base.js";
+import { ODClientManager } from "./client.js";
+import { ODDebugger } from "./console.js";
+import { ODDatabase, ODDatabaseIdConstraint } from "./database.js";
+import * as discord from "discord.js";
+/**## ODStateKey `type`
+ * The key template for message states.
+ */
+export interface ODStateKey {
+    /**A valid discord server/guild ID or instance. */
+    guild?: discord.Guild | string | null;
+    /**A valid discord channel ID or instance. */
+    channel: discord.Channel | string;
+    /**A valid discord message ID or instance. */
+    message: discord.Message | string;
+    /**A valid discord user ID or instance. */
+    user?: discord.User | discord.GuildMember | string | null;
+}
+/**## ODStateData `type`
+ * The raw data template for message states used for storing in the database.
+ */
+export interface ODStateData<StateData extends any> {
+    /**The linked Guild ID of this message state. */
+    guildId: string | null;
+    /**The linked Channel ID of this message state. */
+    channelId: string;
+    /**The linked Message ID of this message state. */
+    messageId: string;
+    /**The linked User ID of this message state. */
+    userId: string | null;
+    /**The creation date of this state (UNIX TIMESTAMP). */
+    createdDate: number;
+    /**The modified date of this state (UNIX TIMESTAMP). */
+    modifiedDate: number;
+    /**Optional date after which this state should be regarded as expired (UNIX TIMESTAMP). */
+    deleteAfterDate: number | null;
+    /**The state data. */
+    data: StateData;
+}
+/**## ODStateSettings `type`
+ * Configurable settings for an ODState.
+ */
+export interface ODStateSettings {
+    /**(Default: `false`) Completely disable autodelete of message states. (unless manually activated using other settings) */
+    disableAutodelete: boolean;
+    /**(Default: `true`) Delete state on channel deletion. */
+    autodeleteOnChannelDelete: boolean;
+    /**(Default: `true`) Delete state on message deletion. */
+    autodeleteOnMessageDelete: boolean;
+    /**(Default: `true`) Delete state when the user leaves the guild/server. */
+    autodeleteOnUserLeave: boolean;
+    /**(Default: `false`) Delete state on bot restart. */
+    autodeleteOnRestart: boolean;
+    /**(Default: `true`) Delete state after 1 hour of an ephemeral message being sent. */
+    autodeleteOnEphemeral: boolean;
+    /**(Default: `null`) Delete state when unmodified/inactive for more than.... */
+    autodeleteAfterTimeout: null | {
+        time: number;
+        unit: "seconds" | "minutes" | "hours" | "days";
+    };
+}
+/**## ODState `class`
+ * An Open Discord state is a system for storing additional chunks of metadata for Discord messages.
+ * A system for tracking messages or linking metadata, states or progress to Discord messages (ID-based).
+ *
+ * Features automatic garbage collection to clear expired states.
+ */
+export declare class ODState<StateData extends any> extends ODManagerData {
+    /**Alias to Open Discord message states database. */
+    protected database: ODDatabase<ODDatabaseIdConstraint>;
+    /**Alias to Open Discord client manager. */
+    protected client: ODClientManager;
+    /**Alias to Open Discord debugger. */
+    protected debug: ODDebugger | null;
+    /**The settings of this state. */
+    settings: ODStateSettings;
+    constructor(id: ODValidId, client: ODClientManager, database: ODDatabase<ODDatabaseIdConstraint>, settings: Partial<ODStateSettings>);
+    /**Use the Open Discord debugger in this manager for logs. */
+    useDebug(debug?: ODDebugger | null): void;
+    /**Init the state and start autodeleting. The client must already be logged-in for this to work. */
+    init(): Promise<void>;
+    /**Purge all expired message states that reached a timeout or ephemeral. */
+    protected purgeExpiredStates(): Promise<void>;
+    /**Transform the object-based message state key contents to a string. */
+    protected transformKey(key: ODStateKey): string;
+    /**Transform the message state data contents for storage in the database. */
+    protected transformData(key: ODStateKey, data: StateData, isEphemeral: boolean, keepCreatedDate?: number): ODStateData<StateData>;
+    /**Calculate milliseconds from a time + unit. */
+    protected timeoutToUnixTime(): number | null;
+    /**Set a message state using guild, channel & message id as key. Returns `true` when overwritten. */
+    setMsgState(key: ODStateKey, data: StateData, isEphemeral: boolean): Promise<boolean>;
+    /**Get a message state using guild, channel & message id as key. */
+    getMsgState(key: ODStateKey): Promise<ODStateData<StateData> | null>;
+    /**Delete a message state using guild, channel & message id as key. Returns `true` when deleted. */
+    deleteMsgState(key: ODStateKey): Promise<boolean>;
+    /**List all message states of this `ODState`. */
+    listMsgStates(): Promise<{
+        key: string;
+        value: ODStateData<StateData>;
+    }[]>;
+    /**Delete all message states from this ODState. */
+    clearAllMsgStates(): Promise<void>;
+    /**Delete a message state using the raw key. Returns `true` when deleted. */
+    protected deleteMsgStateWithRawKey(rawKey: string): Promise<boolean>;
+}
+/**## ODStateManagerIdConstraint `type`
+ * The constraint/layout for id mappings/interfaces of the `ODStateManager` class.
+ */
+export type ODStateManagerIdConstraint = Record<string, ODState<any>>;
+/**## ODStateManager `class`
+ * The Open Discord state manager is a system for tracking messages or linking metadata, states or progress to Discord messages (ID-based).
+ *
+ * Features automatic garbage collection to clear expired states.
+ */
+export declare class ODStateManager<IdList extends ODStateManagerIdConstraint = ODStateManagerIdConstraint> extends ODManager<ODState<any>> {
+    constructor(debug: ODDebugger);
+    /**Init all states. */
+    init(): Promise<void>;
+    add(data: ODState<any>, overwrite?: boolean): boolean;
+    get<StateId extends keyof ODNoGeneric<IdList>>(id: StateId): IdList[StateId];
+    get(id: ODValidId): ODState<any> | null;
+    remove<StateId extends keyof ODNoGeneric<IdList>>(id: StateId): IdList[StateId];
+    remove(id: ODValidId): ODState<any> | null;
+    exists(id: keyof ODNoGeneric<IdList>): boolean;
+    exists(id: ODValidId): boolean;
+}