feat: v4 (#361)

* step 1

* Refactorings

* command modules do not depend on anything but itself

* tearing it up

* Remove module store, manager, and Intializable type

* consolidate interfaces in single file

* consolidate default services in single file

* TEAR IT UP

* fix text compile

* the end of sern init??

* Presence namespaced types removed

* internal namespace

* clean up dependencies

* fix test

* fix circular dependency

* still broken but progress

* remove barrel for core/structs

* reffactor

* refactor allat

* more refactoring

* prototyping linking static handler

* cleanup tests, codegen, and importing handler

* some refactor

* generify partition

* for now copy paste new ioc system

* removeiti

* fdsfD

* ensure container is init'd

* fix absPath gen

* working on bun compat

* refactor and clean up and reenter v3 module loading

* dsfsd

* refactor, add cron types, reinstante module loader

* ready handler revamped so much cleaner

* fdssdf

* refactor deps list

* add more tests, polish up ioc

* up to speed with event modules

* i think cron works

* cron works now, poc

* ksdjkldsfld

* updating ioc api, experimenting with cron

* save b4 thunder and lightning

* plugin data reduction & args changes

* freeze module after plugins, updateModule, and more

* simplify plugin args and prepare for reduction among plugins

* add deps to plugin calls and execute

* plugin system loking better, tbd type

* porg

* initplugins inject deps, inconspicuos

* fix faiklling test

* fix initPlugins not reassigning

* parsingParams kinda

* proper mapping

* dynamic customIds

* handling customId params working

* testing n shi

* inlineinignsd

* consolidate fmt

* once on eventModules

* refact,simplf

* readd vitest and Asset fn

* fix typings

* assets fn complete

* more intuitive context.options and Asset typings

* add init hooks not firing

* -file,-updateModule,publish?

* fix: ioc deps not created correctly

* documentation, add json for Asset

* remove asset

* ss

* finish ioc transition

* nvm, now i did

* s

* update locals api, docs, tests

* fix tests

* fix up tests and cleanup

* fix

* Update src/core/functions.ts

Co-authored-by: Evo <85353424+EvolutionX-10@users.noreply.github.com>

* better documentation

* temp fix

* namespace presence types again

* revising cron modules and better error messages

* scheduler ids

* more descriptive errors

* refactor to not type leak and job cancellation

* refactor n better signatures for task scheduler

* documentation

* fix swap not accepting functions

* change task signature

---------

Co-authored-by: Evo <85353424+EvolutionX-10@users.noreply.github.com>

src/core/structures/context.ts

@@ -11,7 +11,9 @@ import type {
 import { CoreContext } from '../structures/core-context';
 import { Result, Ok, Err } from 'ts-results-es';
 import * as assert from 'assert';
-import { ReplyOptions } from '../../types/utility';
+import type { ReplyOptions } from '../../types/utility';
+import { fmt } from '../functions'
+import { SernError } from './enums';
 
 
 /**
@@ -20,16 +22,24 @@ import { ReplyOptions } from '../../types/utility';
  * Message and ChatInputCommandInteraction
  */
 export class Context extends CoreContext<Message, ChatInputCommandInteraction> {
-    /*
-     * @Experimental
-     */
+    
     get options() {
-        return this.interaction.options;
+        if(this.isMessage()) {
+            const [, ...rest] = fmt(this.message.content, this.prefix);
+            return rest;
+        } else {
+            return this.interaction.options;
+        }
     }
-    protected constructor(protected ctx: Result<Message, ChatInputCommandInteraction>) {
+    
+
+    protected constructor(protected ctx: Result<Message, ChatInputCommandInteraction>,
+                          private __prefix?: string) {
         super(ctx);
     }
-
+    public get prefix() {
+        return this.__prefix;
+    }
     public get id(): Snowflake {
         return safeUnwrap(this.ctx
                             .map(m => m.id)
@@ -37,9 +47,7 @@ export class Context extends CoreContext<Message, ChatInputCommandInteraction> {
     }
 
     public get channel() {
-        return safeUnwrap(this.ctx
-                            .map(m => m.channel)
-                            .mapErr(i => i.channel));
+        return safeUnwrap(this.ctx.map(m => m.channel).mapErr(i => i.channel));
     }
 
     public get channelId(): Snowflake {
@@ -88,6 +96,15 @@ export class Context extends CoreContext<Message, ChatInputCommandInteraction> {
                             .mapErr(i => i.member));
     }
 
+    get message(): Message {
+        return this.ctx.expect(SernError.MismatchEvent);
+    }
+
+    get interaction(): ChatInputCommandInteraction {
+        return this.ctx.expectErr(SernError.MismatchEvent);
+    }
+
+
     public get client(): Client {
         return safeUnwrap(this.ctx
                             .map(m => m.client)
@@ -105,17 +122,16 @@ export class Context extends CoreContext<Message, ChatInputCommandInteraction> {
             this.ctx
                 .map(m => m.reply(content as MessageReplyOptions))
                 .mapErr(i =>
-                    i.reply(content as InteractionReplyOptions).then(() => i.fetchReply()),
-                ),
+                    i.reply(content as InteractionReplyOptions).then(() => i.fetchReply())),
         );
     }
 
-    static override wrap(wrappable: BaseInteraction | Message): Context {
+    static wrap(wrappable: BaseInteraction | Message, prefix?: string): Context {
         if ('interaction' in wrappable) {
-            return new Context(Ok(wrappable));
+            return new Context(Ok(wrappable), prefix);
         }
         assert.ok(wrappable.isChatInputCommand(), "Context created with bad interaction.");
-        return new Context(Err(wrappable));
+        return new Context(Err(wrappable), prefix);
     }
 }
 

src/core/structures/core-context.ts

@@ -1,5 +1,4 @@
 import { Result as Either } from 'ts-results-es';
-import { SernError } from '../_internal';
 import * as assert from 'node:assert';
 
 /**
@@ -9,13 +8,6 @@ export abstract class CoreContext<M, I> {
     protected constructor(protected ctx: Either<M, I>) {
         assert.ok(typeof ctx === 'object' && ctx != null, "Context was nonobject or null");
     }
-    get message(): M {
-        return this.ctx.expect(SernError.MismatchEvent);
-    }
-    get interaction(): I {
-        return this.ctx.expectErr(SernError.MismatchEvent);
-    }
-
     public isMessage(): this is CoreContext<M, never> {
         return this.ctx.isOk();
     }
@@ -23,10 +15,4 @@ export abstract class CoreContext<M, I> {
     public isSlash(): this is CoreContext<never, I> {
         return !this.isMessage();
     }
-    //todo: add agnostic options resolver for Context
-    abstract get options(): unknown;
-
-    static wrap(_: unknown): unknown {
-        throw Error('You need to override this method; cannot wrap an abstract class');
-    }
 }

src/core/structures/default-services.ts

@@ -0,0 +1,89 @@
+import { ScheduledTask } from '../../types/core-modules';
+import type { LogPayload, Logging, ErrorHandling, Disposable } from '../interfaces';
+import { CronJob } from 'cron';
+
+/**
+ * @internal
+ * @since 2.0.0
+ * Version 4.0.0 will internalize this api. Please refrain from using the defaults!
+ */
+export class DefaultErrorHandling implements ErrorHandling {
+    crash(err: Error): never {
+        throw err;
+    }
+    updateAlive(err: Error) {
+        throw err;
+    }
+}
+
+
+/**
+ * @internal
+ * @since 2.0.0
+ * Version 4.0.0 will internalize this api. Please refrain from using ModuleStore!
+ */
+export class DefaultLogging implements Logging {
+    private date() { return new Date() } 
+    debug(payload: LogPayload): void {
+        console.debug(`DEBUG: ${this.date().toISOString()} -> ${payload.message}`);
+    }
+
+    error(payload: LogPayload): void {
+        console.error(`ERROR: ${this.date().toISOString()} -> ${payload.message}`);
+    }
+
+    info(payload: LogPayload): void {
+        console.info(`INFO: ${this.date().toISOString()} -> ${payload.message}`);
+    }
+
+    warning(payload: LogPayload): void {
+        console.warn(`WARN: ${this.date().toISOString()} -> ${payload.message}`);
+    }
+}
+
+
+export class TaskScheduler implements Disposable {
+    private __tasks: Map<string, CronJob<any, any>> = new Map();
+
+    schedule(uuid: string, task: ScheduledTask, deps: Dependencies) {
+        if (this.__tasks.has(uuid)) {
+            throw Error("while scheduling a task \
+                         found another task of same name. Not scheduling " +
+                         uuid + "again."  );
+        }
+        try {
+            const onTick = async function(this: CronJob) {
+                task.execute({ id: uuid,
+                               lastTimeExecution: this.lastExecution,
+                               nextTimeExecution: this.nextDate().toJSDate() }, { deps })
+           }
+           const job = CronJob.from({ cronTime: task.trigger, onTick, timeZone: task.timezone });
+           job.start();
+           this.__tasks.set(uuid, job);
+        } catch (error) {
+           throw Error(`while scheduling a task ${uuid} ` +  error);
+        }
+    }
+  
+    kill(taskName: string): boolean {
+        const job = this.__tasks.get(taskName);
+        if (job) {
+            job.stop();
+            this.__tasks.delete(taskName);
+            return true;
+        }
+        return false;
+    }
+  
+    get tasks(): string[] {
+        return Array.from(this.__tasks.keys());
+    }
+
+    dispose() {
+        this.__tasks.forEach((_, id) => {
+            this.kill(id);
+            this.__tasks.delete(id);
+        })
+    }
+    
+}

src/core/structures/enums.ts

@@ -48,16 +48,16 @@ export enum EventType {
     /**
      * The EventType for handling discord events
      */
-    Discord = 1,
+    Discord,
     /**
      * The EventType for handling sern events
      */
-    Sern = 2,
+    Sern,
     /**
      * The EventType for handling external events.
      * Could be for example, `process` events, database events
      */
-    External = 3,
+    External,
 }
 
 /**
@@ -85,20 +85,12 @@ export enum PluginType {
     Control = 2,
 }
 /**
+ * @deprecated - Use strings 'success' | 'failure' | 'warning'
  * @enum { string }
  */
 export enum PayloadType {
-    /**
-     * The PayloadType for a SernEmitter success event
-     */
     Success = 'success',
-    /**
-     * The PayloadType for a SernEmitter failure event
-     */
     Failure = 'failure',
-    /**
-     * The PayloadType for a SernEmitter warning event
-     */
     Warning = 'warning',
 }
 

src/core/structures/index.ts

@@ -1,5 +0,0 @@
-export { CommandType, PluginType, PayloadType, EventType } from './enums';
-export * from './context';
-export * from './services';
-export * from './module-store';
-

src/core/structures/module-store.ts

@@ -1,11 +0,0 @@
-import { CommandMeta, Module } from '../../types/core-modules';
-
-/*
- * @deprecated
- * Version 4.0.0 will internalize this api. Please refrain from using ModuleStore!
- * For interacting with modules, use the ModuleManager instead.
- */
-export class ModuleStore {
-    metadata = new WeakMap<Module, CommandMeta>();
-    commands = new Map<string, Module>();
-}

src/core/structures/services/error-handling.ts

@@ -1,21 +0,0 @@
-import { ErrorHandling } from '../../contracts';
-
-/**
- * @internal
- * @since 2.0.0
- * Version 4.0.0 will internalize this api. Please refrain from using the defaults!
- */
-export class DefaultErrorHandling implements ErrorHandling {
-    crash(err: Error): never {
-        throw err;
-    }
-
-    #keepAlive = 1;
-
-    updateAlive(err: Error) {
-        this.#keepAlive--;
-        if (this.#keepAlive === 0) {
-            throw err;
-        }
-    }
-}

src/core/structures/services/index.ts

@@ -1,3 +0,0 @@
-export * from './error-handling';
-export * from './logger';
-export * from './module-manager';

src/core/structures/services/logger.ts

@@ -1,25 +0,0 @@
-import { LogPayload, Logging } from '../../contracts';
-
-/**
- * @internal
- * @since 2.0.0
- * Version 4.0.0 will internalize this api. Please refrain from using ModuleStore!
- */
-export class DefaultLogging implements Logging {
-    private date = () => new Date();
-    debug(payload: LogPayload): void {
-        console.debug(`DEBUG: ${this.date().toISOString()} -> ${payload.message}`);
-    }
-
-    error(payload: LogPayload): void {
-        console.error(`ERROR: ${this.date().toISOString()} -> ${payload.message}`);
-    }
-
-    info(payload: LogPayload): void {
-        console.info(`INFO: ${this.date().toISOString()} -> ${payload.message}`);
-    }
-
-    warning(payload: LogPayload): void {
-        console.warn(`WARN: ${this.date().toISOString()} -> ${payload.message}`);
-    }
-}

src/core/structures/services/module-manager.ts

@@ -1,51 +0,0 @@
-import * as Id from '../../../core/id';
-import { CoreModuleStore, ModuleManager } from '../../contracts';
-import { CommandMeta, CommandModule, CommandModuleDefs, Module } from '../../../types/core-modules';
-import { CommandType } from '../enums';
-/**
- * @internal
- * @since 2.0.0
- * Version 4.0.0 will internalize this api. Please refrain from using DefaultModuleManager!
- */
-export class DefaultModuleManager implements ModuleManager {
-    constructor(private moduleStore: CoreModuleStore) {}
-
-
-    getByNameCommandType<T extends CommandType>(name: string, commandType: T) {
-        const module = this.get(Id.create(name, commandType));
-        if (!module) {
-            return undefined;
-        }
-        return module as CommandModuleDefs[T];
-    }
-
-    setMetadata(m: Module, c: CommandMeta): void {
-        this.moduleStore.metadata.set(m, c);
-    }
-
-    getMetadata(m: Module): CommandMeta {
-        const maybeModule = this.moduleStore.metadata.get(m);
-        if (!maybeModule) {
-            throw Error('Could not find metadata in store for ' + m);
-        }
-        return maybeModule;
-    }
-
-    get(id: string) {
-        return this.moduleStore.commands.get(id);
-    }
-    set(id: string, path: CommandModule): void {
-        this.moduleStore.commands.set(id, path);
-    }
-    //not tested
-    getPublishableCommands(): CommandModule[] {
-        const entries = this.moduleStore.commands.entries();
-        const publishable = 0b000000110;
-        return Array.from(entries)
-                .filter(([id]) => {
-                    const last_entry = id.at(-1);
-                    return last_entry == 'B' ||  !(publishable & Number.parseInt(last_entry!));
-                })
-                .map(([, path]) => path as CommandModule);
-    }
-}