@seedcord/plugins 0.1.0

package/LICENSE

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1.  Definitions.
+
+    "License" shall mean the terms and conditions for use, reproduction,
+    and distribution as defined by Sections 1 through 9 of this document.
+
+    "Licensor" shall mean the copyright owner or entity authorized by
+    the copyright owner that is granting the License.
+
+    "Legal Entity" shall mean the union of the acting entity and all
+    other entities that control, are controlled by, or are under common
+    control with that entity. For the purposes of this definition,
+    "control" means (i) the power, direct or indirect, to cause the
+    direction or management of such entity, whether by contract or
+    otherwise, or (ii) ownership of fifty percent (50%) or more of the
+    outstanding shares, or (iii) beneficial ownership of such entity.
+
+    "You" (or "Your") shall mean an individual or Legal Entity
+    exercising permissions granted by this License.
+
+    "Source" form shall mean the preferred form for making modifications,
+    including but not limited to software source code, documentation
+    source, and configuration files.
+
+    "Object" form shall mean any form resulting from mechanical
+    transformation or translation of a Source form, including but
+    not limited to compiled object code, generated documentation,
+    and conversions to other media types.
+
+    "Work" shall mean the work of authorship, whether in Source or
+    Object form, made available under the License, as indicated by a
+    copyright notice that is included in or attached to the work
+    (an example is provided in the Appendix below).
+
+    "Derivative Works" shall mean any work, whether in Source or Object
+    form, that is based on (or derived from) the Work and for which the
+    editorial revisions, annotations, elaborations, or other modifications
+    represent, as a whole, an original work of authorship. For the purposes
+    of this License, Derivative Works shall not include works that remain
+    separable from, or merely link (or bind by name) to the interfaces of,
+    the Work and Derivative Works thereof.
+
+    "Contribution" shall mean any work of authorship, including
+    the original version of the Work and any modifications or additions
+    to that Work or Derivative Works thereof, that is intentionally
+    submitted to Licensor for inclusion in the Work by the copyright owner
+    or by an individual or Legal Entity authorized to submit on behalf of
+    the copyright owner. For the purposes of this definition, "submitted"
+    means any form of electronic, verbal, or written communication sent
+    to the Licensor or its representatives, including but not limited to
+    communication on electronic mailing lists, source code control systems,
+    and issue tracking systems that are managed by, or on behalf of, the
+    Licensor for the purpose of discussing and improving the Work, but
+    excluding communication that is conspicuously marked or otherwise
+    designated in writing by the copyright owner as "Not a Contribution."
+
+    "Contributor" shall mean Licensor and any individual or Legal Entity
+    on behalf of whom a Contribution has been received by Licensor and
+    subsequently incorporated within the Work.
+
+2.  Grant of Copyright License. Subject to the terms and conditions of
+    this License, each Contributor hereby grants to You a perpetual,
+    worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+    copyright license to reproduce, prepare Derivative Works of,
+    publicly display, publicly perform, sublicense, and distribute the
+    Work and such Derivative Works in Source or Object form.
+
+3.  Grant of Patent License. Subject to the terms and conditions of
+    this License, each Contributor hereby grants to You a perpetual,
+    worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+    (except as stated in this section) patent license to make, have made,
+    use, offer to sell, sell, import, and otherwise transfer the Work,
+    where such license applies only to those patent claims licensable
+    by such Contributor that are necessarily infringed by their
+    Contribution(s) alone or by combination of their Contribution(s)
+    with the Work to which such Contribution(s) was submitted. If You
+    institute patent litigation against any entity (including a
+    cross-claim or counterclaim in a lawsuit) alleging that the Work
+    or a Contribution incorporated within the Work constitutes direct
+    or contributory patent infringement, then any patent licenses
+    granted to You under this License for that Work shall terminate
+    as of the date such litigation is filed.
+
+4.  Redistribution. You may reproduce and distribute copies of the
+    Work or Derivative Works thereof in any medium, with or without
+    modifications, and in Source or Object form, provided that You
+    meet the following conditions:
+
+    (a) You must give any other recipients of the Work or
+    Derivative Works a copy of this License; and
+
+    (b) You must cause any modified files to carry prominent notices
+    stating that You changed the files; and
+
+    (c) You must retain, in the Source form of any Derivative Works
+    that You distribute, all copyright, patent, trademark, and
+    attribution notices from the Source form of the Work,
+    excluding those notices that do not pertain to any part of
+    the Derivative Works; and
+
+    (d) If the Work includes a "NOTICE" text file as part of its
+    distribution, then any Derivative Works that You distribute must
+    include a readable copy of the attribution notices contained
+    within such NOTICE file, excluding those notices that do not
+    pertain to any part of the Derivative Works, in at least one
+    of the following places: within a NOTICE text file distributed
+    as part of the Derivative Works; within the Source form or
+    documentation, if provided along with the Derivative Works; or,
+    within a display generated by the Derivative Works, if and
+    wherever such third-party notices normally appear. The contents
+    of the NOTICE file are for informational purposes only and
+    do not modify the License. You may add Your own attribution
+    notices within Derivative Works that You distribute, alongside
+    or as an addendum to the NOTICE text from the Work, provided
+    that such additional attribution notices cannot be construed
+    as modifying the License.
+
+    You may add Your own copyright statement to Your modifications and
+    may provide additional or different license terms and conditions
+    for use, reproduction, or distribution of Your modifications, or
+    for any such Derivative Works as a whole, provided Your use,
+    reproduction, and distribution of the Work otherwise complies with
+    the conditions stated in this License.
+
+5.  Submission of Contributions. Unless You explicitly state otherwise,
+    any Contribution intentionally submitted for inclusion in the Work
+    by You to the Licensor shall be under the terms and conditions of
+    this License, without any additional terms or conditions.
+    Notwithstanding the above, nothing herein shall supersede or modify
+    the terms of any separate license agreement you may have executed
+    with Licensor regarding such Contributions.
+
+6.  Trademarks. This License does not grant permission to use the trade
+    names, trademarks, service marks, or product names of the Licensor,
+    except as required for reasonable and customary use in describing the
+    origin of the Work and reproducing the content of the NOTICE file.
+
+7.  Disclaimer of Warranty. Unless required by applicable law or
+    agreed to in writing, Licensor provides the Work (and each
+    Contributor provides its Contributions) on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+    implied, including, without limitation, any warranties or conditions
+    of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+    PARTICULAR PURPOSE. You are solely responsible for determining the
+    appropriateness of using or redistributing the Work and assume any
+    risks associated with Your exercise of permissions under this License.
+
+8.  Limitation of Liability. In no event and under no legal theory,
+    whether in tort (including negligence), contract, or otherwise,
+    unless required by applicable law (such as deliberate and grossly
+    negligent acts) or agreed to in writing, shall any Contributor be
+    liable to You for damages, including any direct, indirect, special,
+    incidental, or consequential damages of any character arising as a
+    result of this License or out of the use or inability to use the
+    Work (including but not limited to damages for loss of goodwill,
+    work stoppage, computer failure or malfunction, or any and all
+    other commercial damages or losses), even if such Contributor
+    has been advised of the possibility of such damages.
+
+9.  Accepting Warranty or Additional Liability. While redistributing
+    the Work or Derivative Works thereof, You may choose to offer,
+    and charge a fee for, acceptance of support, warranty, indemnity,
+    or other liability obligations and/or rights consistent with this
+    License. However, in accepting such obligations, You may act only
+    on Your own behalf and on Your sole responsibility, not on behalf
+    of any other Contributor, and only if You agree to indemnify,
+    defend, and hold each Contributor harmless for any liability
+    incurred by, or claims asserted against, such Contributor by reason
+    of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+Copyright 2025 Dhruv Jain (materwelonDhruv)
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/dist/index.cjs

@@ -0,0 +1,146 @@
+'use strict';
+
+var mongoose2 = require('mongoose');
+require('reflect-metadata');
+var chalk = require('chalk');
+var seedcord = require('seedcord');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var mongoose2__default = /*#__PURE__*/_interopDefault(mongoose2);
+var chalk__default = /*#__PURE__*/_interopDefault(chalk);
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var ModelMetadataKey = Symbol("db:model");
+function DatabaseModel(collection) {
+  return (target, propertyKey) => {
+    const schema = target[propertyKey];
+    const name = String(collection);
+    const model = mongoose2__default.default.model(name, schema);
+    Reflect.defineMetadata(ModelMetadataKey, model, target);
+  };
+}
+__name(DatabaseModel, "DatabaseModel");
+
+// src/mongo/decorators/DatabaseService.ts
+var ServiceMetadataKey = Symbol("db:serviceKey");
+function DatabaseService(key) {
+  return (ctor) => {
+    Reflect.defineMetadata(ServiceMetadataKey, key, ctor);
+  };
+}
+__name(DatabaseService, "DatabaseService");
+
+// src/mongo/BaseService.ts
+var BaseService = class {
+  static {
+    __name(this, "BaseService");
+  }
+  db;
+  core;
+  model;
+  constructor(db, core) {
+    this.db = db;
+    this.core = core;
+    const ctor = this.constructor;
+    const key = Reflect.getMetadata(ServiceMetadataKey, ctor);
+    if (!key) throw new Error(`Missing @DatabaseService on ${ctor.name}`);
+    const model = Reflect.getMetadata(ModelMetadataKey, ctor);
+    if (!model) throw new Error(`Missing @DatabaseModel on ${ctor.name}`);
+    this.model = model;
+    db._register(key, this);
+  }
+};
+var Mongo = class extends seedcord.Plugin {
+  static {
+    __name(this, "Mongo");
+  }
+  core;
+  options;
+  logger = new seedcord.Logger("MongoDB");
+  isInitialised = false;
+  uri;
+  /**
+  * Map of all loaded services.
+  * Keys come from `@DatabaseService('key')`
+  */
+  services = {};
+  constructor(core, options) {
+    super(core), this.core = core, this.options = options;
+    this.uri = options.uri;
+    this.core.shutdown.addTask(seedcord.ShutdownPhase.ExternalResources, "stop-database", async () => await this.stop());
+  }
+  async init() {
+    if (this.isInitialised) return;
+    this.isInitialised = true;
+    await this.connect();
+    await this.loadServices();
+  }
+  async stop() {
+    await this.disconnect();
+  }
+  async connect() {
+    await mongoose2__default.default.connect(this.uri, {
+      dbName: this.options.name,
+      ...seedcord.Globals.isProduction && {
+        tls: true,
+        ssl: true
+      }
+    }).then((i) => this.logger.info(`Connected to MongoDB: ${chalk__default.default.bold.magenta(i.connection.name)}`)).catch((err) => {
+      throw new Error(`Could not connect to MongoDB`, err);
+    });
+  }
+  async disconnect() {
+    await mongoose2__default.default.disconnect().then(() => this.logger.info(chalk__default.default.red.bold("Disconnected from MongoDB"))).catch((err) => this.logger.error(`Could not disconnect from MongoDB: ${err.message}`));
+  }
+  async loadServices() {
+    const servicesDir = this.options.dir;
+    this.logger.info(chalk__default.default.bold(servicesDir));
+    await seedcord.traverseDirectory(servicesDir, (_full, rel, mod) => {
+      for (const Service of Object.values(mod)) {
+        if (this.isServiceClass(Service)) {
+          const instance = new Service(this, this.core);
+          this.logger.info(`${chalk__default.default.italic("Registered")} ${chalk__default.default.bold.yellow(instance.constructor.name)} from ${chalk__default.default.gray(rel)}`);
+        }
+      }
+    });
+    this.logger.info(`${chalk__default.default.bold.green("Loaded")}: ${chalk__default.default.magenta(Object.keys(this.services).length)} services`);
+  }
+  isServiceClass(obj) {
+    return typeof obj === "function" && obj.prototype instanceof BaseService && Reflect.hasMetadata(ServiceMetadataKey, obj);
+  }
+  _register(key, instance) {
+    this.services[key] = instance;
+  }
+};
+function DBCatchable(errorMessage) {
+  return function(_target, _propertyKey, descriptor) {
+    const originalMethod = descriptor.value;
+    descriptor.value = async function(...args) {
+      if (!originalMethod) {
+        throw new Error("Method not found");
+      }
+      try {
+        return await originalMethod.apply(this, args);
+      } catch (error) {
+        if (!(error instanceof seedcord.CustomError)) {
+          seedcord.throwCustomError(error, errorMessage, seedcord.DatabaseError);
+        } else {
+          throw error;
+        }
+      }
+    };
+  };
+}
+__name(DBCatchable, "DBCatchable");
+
+exports.BaseService = BaseService;
+exports.DBCatchable = DBCatchable;
+exports.DatabaseModel = DatabaseModel;
+exports.DatabaseService = DatabaseService;
+exports.ModelMetadataKey = ModelMetadataKey;
+exports.Mongo = Mongo;
+exports.ServiceMetadataKey = ServiceMetadataKey;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mongo/decorators/DatabaseModel.ts","../src/mongo/decorators/DatabaseService.ts","../src/mongo/BaseService.ts","../src/mongo/Mongo.ts","../src/mongo/decorators/DBCatchable.ts"],"names":["ModelMetadataKey","Symbol","DatabaseModel","collection","target","propertyKey","schema","name","String","model","mongoose","Reflect","defineMetadata","ServiceMetadataKey","DatabaseService","key","ctor","BaseService","db","core","getMetadata","Error","_register","Mongo","Plugin","logger","Logger","isInitialised","uri","services","options","shutdown","addTask","ShutdownPhase","ExternalResources","stop","init","connect","loadServices","disconnect","dbName","Globals","isProduction","tls","ssl","then","i","info","chalk","bold","magenta","connection","catch","err","red","error","message","servicesDir","dir","traverseDirectory","_full","rel","mod","Service","Object","values","isServiceClass","instance","italic","yellow","gray","green","keys","length","obj","prototype","hasMetadata","DBCatchable","errorMessage","_target","_propertyKey","descriptor","originalMethod","value","args","apply","CustomError","throwCustomError","DatabaseError"],"mappings":"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","file":"index.cjs","sourcesContent":["import mongoose from 'mongoose';\n\nimport type { ServiceKeys } from '../types/Services';\n\nexport const ModelMetadataKey = Symbol('db:model');\n\n/**\n * Associates a Mongoose model with a database service\n *\n * Creates a Mongoose model from the decorated static schema property and stores it\n * for service registration. The model becomes available as `this.model` in the service.\n * Must be applied to a `public static schema` property in the service class.\n *\n * @param collection - Collection name for the Mongoose model\n * @decorator\n * @example\n * ```typescript\n * \\@DatabaseService('users')\n * export class Users extends BaseService<IUser> {\n *   \\@DatabaseModel('users')\n *   public static schema = new mongoose.Schema<IUser>({\n *     username: { type: String, required: true, unique: true }\n *   });\n * }\n * ```\n */\nexport function DatabaseModel<TService extends ServiceKeys>(collection: TService) {\n  return <\n    SchemaObj extends Record<KeyOfSchema, mongoose.Schema>,\n    KeyOfSchema extends keyof SchemaObj & (string | symbol)\n  >(\n    target: SchemaObj,\n    propertyKey: KeyOfSchema\n  ): void => {\n    const schema = target[propertyKey];\n    const name = String(collection);\n    const model = mongoose.model(name, schema);\n    Reflect.defineMetadata(ModelMetadataKey, model, target);\n  };\n}\n","import type { BaseService } from '../BaseService';\nimport type { ServiceKeys } from '../types/Services';\nimport type { ConstructorFunction } from '@seedcord/types';\n\nexport const ServiceMetadataKey = Symbol('db:serviceKey');\n\n/**\n * Registers a database service with a typed key\n *\n * Associates a service class with a key for dependency injection.\n * The service becomes available via `core.db.services[key]`.\n *\n * @param key - Service key for registration and type-safe access\n * @decorator\n * @example\n * ```typescript\n * \\@DatabaseService('users')\n * export class Users<Doc extends IUser = IUser> extends BaseService<Doc> {\n *   // Some code\n * }\n * ```\n */\nexport function DatabaseService<TService extends ServiceKeys>(key: TService) {\n  return <DatabaseCtor extends ConstructorFunction & { prototype: BaseService }>(ctor: DatabaseCtor): void => {\n    Reflect.defineMetadata(ServiceMetadataKey, key, ctor);\n  };\n}\n","import { ModelMetadataKey } from './decorators/DatabaseModel';\nimport { ServiceMetadataKey } from './decorators/DatabaseService';\n\nimport type { Mongo } from './Mongo';\nimport type { Services } from './types/Services';\nimport type { IDocument, TypedConstructor } from '@seedcord/types';\nimport type mongoose from 'mongoose';\nimport type { Core } from 'seedcord';\n\n/**\n * Base class for MongoDB service layers\n *\n * Provides typed access to MongoDB collections through Mongoose models.\n * Services are automatically registered with the Mongo plugin when instantiated.\n *\n * @typeParam Doc - The document type this service manages\n * @example\n * ```typescript\n * \\@DatabaseService('users')\n * export class Users extends BaseService<IUser> {\n *   \\@DatabaseModel('users')\n *   public static schema = new mongoose.Schema<IUser>({\n *     username: { type: String, required: true, unique: true }\n *   });\n *\n *   // Custom methods here\n *   public async findByUsername(username: string) {\n *     return this.model.findOne({ username });\n *   }\n * }\n * ```\n */\nexport abstract class BaseService<Doc extends IDocument = IDocument> {\n  public readonly model: mongoose.Model<Doc>;\n\n  public constructor(\n    protected readonly db: Mongo,\n    protected readonly core: Core\n  ) {\n    const ctor = this.constructor;\n\n    const key = Reflect.getMetadata(ServiceMetadataKey, ctor) as string | undefined;\n    if (!key) throw new Error(`Missing @DatabaseService on ${ctor.name}`);\n\n    const model = Reflect.getMetadata(ModelMetadataKey, ctor) as mongoose.Model<Doc> | undefined;\n    if (!model) throw new Error(`Missing @DatabaseModel on ${ctor.name}`);\n\n    this.model = model;\n\n    db._register(key as keyof Services, this as unknown as Services[keyof Services]);\n  }\n}\n\n/** Constructor type for BaseService classes */\nexport type BaseServiceConstructor = TypedConstructor<typeof BaseService>;\n","import 'reflect-metadata';\n\nimport chalk from 'chalk';\nimport mongoose from 'mongoose';\nimport { Globals, Logger, Plugin, ShutdownPhase, traverseDirectory } from 'seedcord';\n\nimport { BaseService } from './BaseService';\nimport { ServiceMetadataKey } from './decorators/DatabaseService';\n\nimport type { BaseServiceConstructor } from './BaseService';\nimport type { Services } from './types/Services';\nimport type { Core } from 'seedcord';\n\n/**\n * Configuration options for MongoDB connection and service loading.\n */\ninterface MongoOptions {\n  /** Directory path containing database service classes */\n  dir: string;\n  /** MongoDB connection URI */\n  uri: string;\n  /** Database name to use */\n  name: string;\n}\n\n/**\n * MongoDB integration plugin for Seedcord.\n *\n * Manages MongoDB connections, service loading, and provides type-safe\n * access to database services through service registration decorators.\n */\nexport class Mongo extends Plugin {\n  public readonly logger = new Logger('MongoDB');\n  private isInitialised = false;\n  private readonly uri: string;\n\n  /**\n   * Map of all loaded services.\n   * Keys come from `@DatabaseService('key')`\n   */\n  public readonly services: Services = {} as Services;\n\n  constructor(\n    public readonly core: Core,\n    private readonly options: MongoOptions\n  ) {\n    super(core);\n    this.uri = options.uri;\n\n    this.core.shutdown.addTask(ShutdownPhase.ExternalResources, 'stop-database', async () => await this.stop());\n  }\n\n  public async init(): Promise<void> {\n    if (this.isInitialised) return;\n    this.isInitialised = true;\n\n    await this.connect();\n    await this.loadServices();\n  }\n\n  public async stop(): Promise<void> {\n    await this.disconnect();\n  }\n\n  private async connect(): Promise<void> {\n    await mongoose\n      .connect(this.uri, {\n        dbName: this.options.name,\n        ...(Globals.isProduction && { tls: true, ssl: true })\n      })\n      .then((i) => this.logger.info(`Connected to MongoDB: ${chalk.bold.magenta(i.connection.name)}`))\n      .catch((err) => {\n        throw new Error(`Could not connect to MongoDB`, err);\n      });\n  }\n\n  private async disconnect(): Promise<void> {\n    await mongoose\n      .disconnect()\n      .then(() => this.logger.info(chalk.red.bold('Disconnected from MongoDB')))\n      .catch((err) => this.logger.error(`Could not disconnect from MongoDB: ${(err as Error).message}`));\n  }\n\n  private async loadServices(): Promise<void> {\n    const servicesDir = this.options.dir;\n    this.logger.info(chalk.bold(servicesDir));\n\n    await traverseDirectory(servicesDir, (_full, rel, mod) => {\n      for (const Service of Object.values(mod)) {\n        if (this.isServiceClass(Service)) {\n          const instance = new Service(this, this.core);\n          this.logger.info(\n            `${chalk.italic('Registered')} ${chalk.bold.yellow(instance.constructor.name)} from ${chalk.gray(rel)}`\n          );\n        }\n      }\n    });\n\n    this.logger.info(`${chalk.bold.green('Loaded')}: ${chalk.magenta(Object.keys(this.services).length)} services`);\n  }\n\n  private isServiceClass(obj: unknown): obj is BaseServiceConstructor {\n    return (\n      typeof obj === 'function' && obj.prototype instanceof BaseService && Reflect.hasMetadata(ServiceMetadataKey, obj)\n    );\n  }\n\n  _register<SKey extends keyof Services>(key: SKey, instance: Services[SKey]): void {\n    this.services[key] = instance;\n  }\n}\n","import { CustomError, throwCustomError, DatabaseError } from 'seedcord';\n\n/**\n * Catches and wraps database operation errors.\n *\n * Automatically wraps non-CustomError exceptions in DatabaseError instances\n * with UUID tracking. Should be applied to database service methods.\n *\n * @param errorMessage - Message to include when wrapping errors\n * @decorator\n * @example\n * ```typescript\n * class UserService extends BaseService {\n *   \\@DBCatchable('Failed to find user')\n *   async findById(id: string) {\n *     return this.model.findById(id);\n *   }\n * }\n * ```\n */\nexport function DBCatchable<TypeReturn>(errorMessage: string) {\n  return function (\n    _target: unknown,\n    _propertyKey: string,\n    descriptor: TypedPropertyDescriptor<(...args: any[]) => Promise<TypeReturn>>\n  ): void {\n    const originalMethod = descriptor.value;\n\n    descriptor.value = async function (...args: any[]): Promise<TypeReturn> {\n      if (!originalMethod) {\n        throw new Error('Method not found');\n      }\n\n      try {\n        return await originalMethod.apply(this, args);\n      } catch (error) {\n        if (!(error instanceof CustomError)) {\n          throwCustomError(error, errorMessage, DatabaseError);\n        } else {\n          throw error;\n        }\n      }\n    };\n  };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,162 @@
+import { Plugin, Core, Logger } from 'seedcord';
+import { IDocument, TypedConstructor, ConstructorFunction } from '@seedcord/types';
+import mongoose from 'mongoose';
+
+/**
+ * Registry of available database services.
+ *
+ * This interface can be augmented via declaration merging to add
+ * type-safe service definitions when using the \@DatabaseService and \@DatabaseModel decorator.
+ *
+ * @example
+ * ```typescript
+ * declare module 'seedcord' {
+ *   interface Services {
+ *     'user': UserService;
+ *     'guild': GuildService;
+ *   }
+ * }
+ * ```
+ */
+interface Services {
+}
+/**
+ * Helper type to extract service keys from the Services interface.
+ */
+type ServiceKeys = keyof Services;
+
+/**
+ * Configuration options for MongoDB connection and service loading.
+ */
+interface MongoOptions {
+    /** Directory path containing database service classes */
+    dir: string;
+    /** MongoDB connection URI */
+    uri: string;
+    /** Database name to use */
+    name: string;
+}
+/**
+ * MongoDB integration plugin for Seedcord.
+ *
+ * Manages MongoDB connections, service loading, and provides type-safe
+ * access to database services through service registration decorators.
+ */
+declare class Mongo extends Plugin {
+    readonly core: Core;
+    private readonly options;
+    readonly logger: Logger;
+    private isInitialised;
+    private readonly uri;
+    /**
+     * Map of all loaded services.
+     * Keys come from `@DatabaseService('key')`
+     */
+    readonly services: Services;
+    constructor(core: Core, options: MongoOptions);
+    init(): Promise<void>;
+    stop(): Promise<void>;
+    private connect;
+    private disconnect;
+    private loadServices;
+    private isServiceClass;
+    _register<SKey extends keyof Services>(key: SKey, instance: Services[SKey]): void;
+}
+
+/**
+ * Base class for MongoDB service layers
+ *
+ * Provides typed access to MongoDB collections through Mongoose models.
+ * Services are automatically registered with the Mongo plugin when instantiated.
+ *
+ * @typeParam Doc - The document type this service manages
+ * @example
+ * ```typescript
+ * \@DatabaseService('users')
+ * export class Users extends BaseService<IUser> {
+ *   \@DatabaseModel('users')
+ *   public static schema = new mongoose.Schema<IUser>({
+ *     username: { type: String, required: true, unique: true }
+ *   });
+ *
+ *   // Custom methods here
+ *   public async findByUsername(username: string) {
+ *     return this.model.findOne({ username });
+ *   }
+ * }
+ * ```
+ */
+declare abstract class BaseService<Doc extends IDocument = IDocument> {
+    protected readonly db: Mongo;
+    protected readonly core: Core;
+    readonly model: mongoose.Model<Doc>;
+    constructor(db: Mongo, core: Core);
+}
+/** Constructor type for BaseService classes */
+type BaseServiceConstructor = TypedConstructor<typeof BaseService>;
+
+/**
+ * Catches and wraps database operation errors.
+ *
+ * Automatically wraps non-CustomError exceptions in DatabaseError instances
+ * with UUID tracking. Should be applied to database service methods.
+ *
+ * @param errorMessage - Message to include when wrapping errors
+ * @decorator
+ * @example
+ * ```typescript
+ * class UserService extends BaseService {
+ *   \@DBCatchable('Failed to find user')
+ *   async findById(id: string) {
+ *     return this.model.findById(id);
+ *   }
+ * }
+ * ```
+ */
+declare function DBCatchable<TypeReturn>(errorMessage: string): (_target: unknown, _propertyKey: string, descriptor: TypedPropertyDescriptor<(...args: any[]) => Promise<TypeReturn>>) => void;
+
+declare const ModelMetadataKey: unique symbol;
+/**
+ * Associates a Mongoose model with a database service
+ *
+ * Creates a Mongoose model from the decorated static schema property and stores it
+ * for service registration. The model becomes available as `this.model` in the service.
+ * Must be applied to a `public static schema` property in the service class.
+ *
+ * @param collection - Collection name for the Mongoose model
+ * @decorator
+ * @example
+ * ```typescript
+ * \@DatabaseService('users')
+ * export class Users extends BaseService<IUser> {
+ *   \@DatabaseModel('users')
+ *   public static schema = new mongoose.Schema<IUser>({
+ *     username: { type: String, required: true, unique: true }
+ *   });
+ * }
+ * ```
+ */
+declare function DatabaseModel<TService extends ServiceKeys>(collection: TService): <SchemaObj extends Record<KeyOfSchema, mongoose.Schema>, KeyOfSchema extends keyof SchemaObj & (string | symbol)>(target: SchemaObj, propertyKey: KeyOfSchema) => void;
+
+declare const ServiceMetadataKey: unique symbol;
+/**
+ * Registers a database service with a typed key
+ *
+ * Associates a service class with a key for dependency injection.
+ * The service becomes available via `core.db.services[key]`.
+ *
+ * @param key - Service key for registration and type-safe access
+ * @decorator
+ * @example
+ * ```typescript
+ * \@DatabaseService('users')
+ * export class Users<Doc extends IUser = IUser> extends BaseService<Doc> {
+ *   // Some code
+ * }
+ * ```
+ */
+declare function DatabaseService<TService extends ServiceKeys>(key: TService): <DatabaseCtor extends ConstructorFunction & {
+    prototype: BaseService;
+}>(ctor: DatabaseCtor) => void;
+
+export { BaseService, type BaseServiceConstructor, DBCatchable, DatabaseModel, DatabaseService, ModelMetadataKey, Mongo, type ServiceKeys, ServiceMetadataKey, type Services };

package/dist/index.d.mts

@@ -0,0 +1,162 @@
+import { Plugin, Core, Logger } from 'seedcord';
+import { IDocument, TypedConstructor, ConstructorFunction } from '@seedcord/types';
+import mongoose from 'mongoose';
+
+/**
+ * Registry of available database services.
+ *
+ * This interface can be augmented via declaration merging to add
+ * type-safe service definitions when using the \@DatabaseService and \@DatabaseModel decorator.
+ *
+ * @example
+ * ```typescript
+ * declare module 'seedcord' {
+ *   interface Services {
+ *     'user': UserService;
+ *     'guild': GuildService;
+ *   }
+ * }
+ * ```
+ */
+interface Services {
+}
+/**
+ * Helper type to extract service keys from the Services interface.
+ */
+type ServiceKeys = keyof Services;
+
+/**
+ * Configuration options for MongoDB connection and service loading.
+ */
+interface MongoOptions {
+    /** Directory path containing database service classes */
+    dir: string;
+    /** MongoDB connection URI */
+    uri: string;
+    /** Database name to use */
+    name: string;
+}
+/**
+ * MongoDB integration plugin for Seedcord.
+ *
+ * Manages MongoDB connections, service loading, and provides type-safe
+ * access to database services through service registration decorators.
+ */
+declare class Mongo extends Plugin {
+    readonly core: Core;
+    private readonly options;
+    readonly logger: Logger;
+    private isInitialised;
+    private readonly uri;
+    /**
+     * Map of all loaded services.
+     * Keys come from `@DatabaseService('key')`
+     */
+    readonly services: Services;
+    constructor(core: Core, options: MongoOptions);
+    init(): Promise<void>;
+    stop(): Promise<void>;
+    private connect;
+    private disconnect;
+    private loadServices;
+    private isServiceClass;
+    _register<SKey extends keyof Services>(key: SKey, instance: Services[SKey]): void;
+}
+
+/**
+ * Base class for MongoDB service layers
+ *
+ * Provides typed access to MongoDB collections through Mongoose models.
+ * Services are automatically registered with the Mongo plugin when instantiated.
+ *
+ * @typeParam Doc - The document type this service manages
+ * @example
+ * ```typescript
+ * \@DatabaseService('users')
+ * export class Users extends BaseService<IUser> {
+ *   \@DatabaseModel('users')
+ *   public static schema = new mongoose.Schema<IUser>({
+ *     username: { type: String, required: true, unique: true }
+ *   });
+ *
+ *   // Custom methods here
+ *   public async findByUsername(username: string) {
+ *     return this.model.findOne({ username });
+ *   }
+ * }
+ * ```
+ */
+declare abstract class BaseService<Doc extends IDocument = IDocument> {
+    protected readonly db: Mongo;
+    protected readonly core: Core;
+    readonly model: mongoose.Model<Doc>;
+    constructor(db: Mongo, core: Core);
+}
+/** Constructor type for BaseService classes */
+type BaseServiceConstructor = TypedConstructor<typeof BaseService>;
+
+/**
+ * Catches and wraps database operation errors.
+ *
+ * Automatically wraps non-CustomError exceptions in DatabaseError instances
+ * with UUID tracking. Should be applied to database service methods.
+ *
+ * @param errorMessage - Message to include when wrapping errors
+ * @decorator
+ * @example
+ * ```typescript
+ * class UserService extends BaseService {
+ *   \@DBCatchable('Failed to find user')
+ *   async findById(id: string) {
+ *     return this.model.findById(id);
+ *   }
+ * }
+ * ```
+ */
+declare function DBCatchable<TypeReturn>(errorMessage: string): (_target: unknown, _propertyKey: string, descriptor: TypedPropertyDescriptor<(...args: any[]) => Promise<TypeReturn>>) => void;
+
+declare const ModelMetadataKey: unique symbol;
+/**
+ * Associates a Mongoose model with a database service
+ *
+ * Creates a Mongoose model from the decorated static schema property and stores it
+ * for service registration. The model becomes available as `this.model` in the service.
+ * Must be applied to a `public static schema` property in the service class.
+ *
+ * @param collection - Collection name for the Mongoose model
+ * @decorator
+ * @example
+ * ```typescript
+ * \@DatabaseService('users')
+ * export class Users extends BaseService<IUser> {
+ *   \@DatabaseModel('users')
+ *   public static schema = new mongoose.Schema<IUser>({
+ *     username: { type: String, required: true, unique: true }
+ *   });
+ * }
+ * ```
+ */
+declare function DatabaseModel<TService extends ServiceKeys>(collection: TService): <SchemaObj extends Record<KeyOfSchema, mongoose.Schema>, KeyOfSchema extends keyof SchemaObj & (string | symbol)>(target: SchemaObj, propertyKey: KeyOfSchema) => void;
+
+declare const ServiceMetadataKey: unique symbol;
+/**
+ * Registers a database service with a typed key
+ *
+ * Associates a service class with a key for dependency injection.
+ * The service becomes available via `core.db.services[key]`.
+ *
+ * @param key - Service key for registration and type-safe access
+ * @decorator
+ * @example
+ * ```typescript
+ * \@DatabaseService('users')
+ * export class Users<Doc extends IUser = IUser> extends BaseService<Doc> {
+ *   // Some code
+ * }
+ * ```
+ */
+declare function DatabaseService<TService extends ServiceKeys>(key: TService): <DatabaseCtor extends ConstructorFunction & {
+    prototype: BaseService;
+}>(ctor: DatabaseCtor) => void;
+
+export { BaseService, type BaseServiceConstructor, DBCatchable, DatabaseModel, DatabaseService, ModelMetadataKey, Mongo, type ServiceKeys, ServiceMetadataKey, type Services };

package/dist/index.d.ts

@@ -0,0 +1,162 @@
+import { Plugin, Core, Logger } from 'seedcord';
+import { IDocument, TypedConstructor, ConstructorFunction } from '@seedcord/types';
+import mongoose from 'mongoose';
+
+/**
+ * Registry of available database services.
+ *
+ * This interface can be augmented via declaration merging to add
+ * type-safe service definitions when using the \@DatabaseService and \@DatabaseModel decorator.
+ *
+ * @example
+ * ```typescript
+ * declare module 'seedcord' {
+ *   interface Services {
+ *     'user': UserService;
+ *     'guild': GuildService;
+ *   }
+ * }
+ * ```
+ */
+interface Services {
+}
+/**
+ * Helper type to extract service keys from the Services interface.
+ */
+type ServiceKeys = keyof Services;
+
+/**
+ * Configuration options for MongoDB connection and service loading.
+ */
+interface MongoOptions {
+    /** Directory path containing database service classes */
+    dir: string;
+    /** MongoDB connection URI */
+    uri: string;
+    /** Database name to use */
+    name: string;
+}
+/**
+ * MongoDB integration plugin for Seedcord.
+ *
+ * Manages MongoDB connections, service loading, and provides type-safe
+ * access to database services through service registration decorators.
+ */
+declare class Mongo extends Plugin {
+    readonly core: Core;
+    private readonly options;
+    readonly logger: Logger;
+    private isInitialised;
+    private readonly uri;
+    /**
+     * Map of all loaded services.
+     * Keys come from `@DatabaseService('key')`
+     */
+    readonly services: Services;
+    constructor(core: Core, options: MongoOptions);
+    init(): Promise<void>;
+    stop(): Promise<void>;
+    private connect;
+    private disconnect;
+    private loadServices;
+    private isServiceClass;
+    _register<SKey extends keyof Services>(key: SKey, instance: Services[SKey]): void;
+}
+
+/**
+ * Base class for MongoDB service layers
+ *
+ * Provides typed access to MongoDB collections through Mongoose models.
+ * Services are automatically registered with the Mongo plugin when instantiated.
+ *
+ * @typeParam Doc - The document type this service manages
+ * @example
+ * ```typescript
+ * \@DatabaseService('users')
+ * export class Users extends BaseService<IUser> {
+ *   \@DatabaseModel('users')
+ *   public static schema = new mongoose.Schema<IUser>({
+ *     username: { type: String, required: true, unique: true }
+ *   });
+ *
+ *   // Custom methods here
+ *   public async findByUsername(username: string) {
+ *     return this.model.findOne({ username });
+ *   }
+ * }
+ * ```
+ */
+declare abstract class BaseService<Doc extends IDocument = IDocument> {
+    protected readonly db: Mongo;
+    protected readonly core: Core;
+    readonly model: mongoose.Model<Doc>;
+    constructor(db: Mongo, core: Core);
+}
+/** Constructor type for BaseService classes */
+type BaseServiceConstructor = TypedConstructor<typeof BaseService>;
+
+/**
+ * Catches and wraps database operation errors.
+ *
+ * Automatically wraps non-CustomError exceptions in DatabaseError instances
+ * with UUID tracking. Should be applied to database service methods.
+ *
+ * @param errorMessage - Message to include when wrapping errors
+ * @decorator
+ * @example
+ * ```typescript
+ * class UserService extends BaseService {
+ *   \@DBCatchable('Failed to find user')
+ *   async findById(id: string) {
+ *     return this.model.findById(id);
+ *   }
+ * }
+ * ```
+ */
+declare function DBCatchable<TypeReturn>(errorMessage: string): (_target: unknown, _propertyKey: string, descriptor: TypedPropertyDescriptor<(...args: any[]) => Promise<TypeReturn>>) => void;
+
+declare const ModelMetadataKey: unique symbol;
+/**
+ * Associates a Mongoose model with a database service
+ *
+ * Creates a Mongoose model from the decorated static schema property and stores it
+ * for service registration. The model becomes available as `this.model` in the service.
+ * Must be applied to a `public static schema` property in the service class.
+ *
+ * @param collection - Collection name for the Mongoose model
+ * @decorator
+ * @example
+ * ```typescript
+ * \@DatabaseService('users')
+ * export class Users extends BaseService<IUser> {
+ *   \@DatabaseModel('users')
+ *   public static schema = new mongoose.Schema<IUser>({
+ *     username: { type: String, required: true, unique: true }
+ *   });
+ * }
+ * ```
+ */
+declare function DatabaseModel<TService extends ServiceKeys>(collection: TService): <SchemaObj extends Record<KeyOfSchema, mongoose.Schema>, KeyOfSchema extends keyof SchemaObj & (string | symbol)>(target: SchemaObj, propertyKey: KeyOfSchema) => void;
+
+declare const ServiceMetadataKey: unique symbol;
+/**
+ * Registers a database service with a typed key
+ *
+ * Associates a service class with a key for dependency injection.
+ * The service becomes available via `core.db.services[key]`.
+ *
+ * @param key - Service key for registration and type-safe access
+ * @decorator
+ * @example
+ * ```typescript
+ * \@DatabaseService('users')
+ * export class Users<Doc extends IUser = IUser> extends BaseService<Doc> {
+ *   // Some code
+ * }
+ * ```
+ */
+declare function DatabaseService<TService extends ServiceKeys>(key: TService): <DatabaseCtor extends ConstructorFunction & {
+    prototype: BaseService;
+}>(ctor: DatabaseCtor) => void;
+
+export { BaseService, type BaseServiceConstructor, DBCatchable, DatabaseModel, DatabaseService, ModelMetadataKey, Mongo, type ServiceKeys, ServiceMetadataKey, type Services };

package/dist/index.mjs

@@ -0,0 +1,133 @@
+import mongoose2 from 'mongoose';
+import 'reflect-metadata';
+import chalk from 'chalk';
+import { Plugin, Logger, ShutdownPhase, Globals, traverseDirectory, CustomError, throwCustomError, DatabaseError } from 'seedcord';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var ModelMetadataKey = Symbol("db:model");
+function DatabaseModel(collection) {
+  return (target, propertyKey) => {
+    const schema = target[propertyKey];
+    const name = String(collection);
+    const model = mongoose2.model(name, schema);
+    Reflect.defineMetadata(ModelMetadataKey, model, target);
+  };
+}
+__name(DatabaseModel, "DatabaseModel");
+
+// src/mongo/decorators/DatabaseService.ts
+var ServiceMetadataKey = Symbol("db:serviceKey");
+function DatabaseService(key) {
+  return (ctor) => {
+    Reflect.defineMetadata(ServiceMetadataKey, key, ctor);
+  };
+}
+__name(DatabaseService, "DatabaseService");
+
+// src/mongo/BaseService.ts
+var BaseService = class {
+  static {
+    __name(this, "BaseService");
+  }
+  db;
+  core;
+  model;
+  constructor(db, core) {
+    this.db = db;
+    this.core = core;
+    const ctor = this.constructor;
+    const key = Reflect.getMetadata(ServiceMetadataKey, ctor);
+    if (!key) throw new Error(`Missing @DatabaseService on ${ctor.name}`);
+    const model = Reflect.getMetadata(ModelMetadataKey, ctor);
+    if (!model) throw new Error(`Missing @DatabaseModel on ${ctor.name}`);
+    this.model = model;
+    db._register(key, this);
+  }
+};
+var Mongo = class extends Plugin {
+  static {
+    __name(this, "Mongo");
+  }
+  core;
+  options;
+  logger = new Logger("MongoDB");
+  isInitialised = false;
+  uri;
+  /**
+  * Map of all loaded services.
+  * Keys come from `@DatabaseService('key')`
+  */
+  services = {};
+  constructor(core, options) {
+    super(core), this.core = core, this.options = options;
+    this.uri = options.uri;
+    this.core.shutdown.addTask(ShutdownPhase.ExternalResources, "stop-database", async () => await this.stop());
+  }
+  async init() {
+    if (this.isInitialised) return;
+    this.isInitialised = true;
+    await this.connect();
+    await this.loadServices();
+  }
+  async stop() {
+    await this.disconnect();
+  }
+  async connect() {
+    await mongoose2.connect(this.uri, {
+      dbName: this.options.name,
+      ...Globals.isProduction && {
+        tls: true,
+        ssl: true
+      }
+    }).then((i) => this.logger.info(`Connected to MongoDB: ${chalk.bold.magenta(i.connection.name)}`)).catch((err) => {
+      throw new Error(`Could not connect to MongoDB`, err);
+    });
+  }
+  async disconnect() {
+    await mongoose2.disconnect().then(() => this.logger.info(chalk.red.bold("Disconnected from MongoDB"))).catch((err) => this.logger.error(`Could not disconnect from MongoDB: ${err.message}`));
+  }
+  async loadServices() {
+    const servicesDir = this.options.dir;
+    this.logger.info(chalk.bold(servicesDir));
+    await traverseDirectory(servicesDir, (_full, rel, mod) => {
+      for (const Service of Object.values(mod)) {
+        if (this.isServiceClass(Service)) {
+          const instance = new Service(this, this.core);
+          this.logger.info(`${chalk.italic("Registered")} ${chalk.bold.yellow(instance.constructor.name)} from ${chalk.gray(rel)}`);
+        }
+      }
+    });
+    this.logger.info(`${chalk.bold.green("Loaded")}: ${chalk.magenta(Object.keys(this.services).length)} services`);
+  }
+  isServiceClass(obj) {
+    return typeof obj === "function" && obj.prototype instanceof BaseService && Reflect.hasMetadata(ServiceMetadataKey, obj);
+  }
+  _register(key, instance) {
+    this.services[key] = instance;
+  }
+};
+function DBCatchable(errorMessage) {
+  return function(_target, _propertyKey, descriptor) {
+    const originalMethod = descriptor.value;
+    descriptor.value = async function(...args) {
+      if (!originalMethod) {
+        throw new Error("Method not found");
+      }
+      try {
+        return await originalMethod.apply(this, args);
+      } catch (error) {
+        if (!(error instanceof CustomError)) {
+          throwCustomError(error, errorMessage, DatabaseError);
+        } else {
+          throw error;
+        }
+      }
+    };
+  };
+}
+__name(DBCatchable, "DBCatchable");
+
+export { BaseService, DBCatchable, DatabaseModel, DatabaseService, ModelMetadataKey, Mongo, ServiceMetadataKey };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mongo/decorators/DatabaseModel.ts","../src/mongo/decorators/DatabaseService.ts","../src/mongo/BaseService.ts","../src/mongo/Mongo.ts","../src/mongo/decorators/DBCatchable.ts"],"names":["ModelMetadataKey","Symbol","DatabaseModel","collection","target","propertyKey","schema","name","String","model","mongoose","Reflect","defineMetadata","ServiceMetadataKey","DatabaseService","key","ctor","BaseService","db","core","getMetadata","Error","_register","Mongo","Plugin","logger","Logger","isInitialised","uri","services","options","shutdown","addTask","ShutdownPhase","ExternalResources","stop","init","connect","loadServices","disconnect","dbName","Globals","isProduction","tls","ssl","then","i","info","chalk","bold","magenta","connection","catch","err","red","error","message","servicesDir","dir","traverseDirectory","_full","rel","mod","Service","Object","values","isServiceClass","instance","italic","yellow","gray","green","keys","length","obj","prototype","hasMetadata","DBCatchable","errorMessage","_target","_propertyKey","descriptor","originalMethod","value","args","apply","CustomError","throwCustomError","DatabaseError"],"mappings":"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","file":"index.mjs","sourcesContent":["import mongoose from 'mongoose';\n\nimport type { ServiceKeys } from '../types/Services';\n\nexport const ModelMetadataKey = Symbol('db:model');\n\n/**\n * Associates a Mongoose model with a database service\n *\n * Creates a Mongoose model from the decorated static schema property and stores it\n * for service registration. The model becomes available as `this.model` in the service.\n * Must be applied to a `public static schema` property in the service class.\n *\n * @param collection - Collection name for the Mongoose model\n * @decorator\n * @example\n * ```typescript\n * \\@DatabaseService('users')\n * export class Users extends BaseService<IUser> {\n *   \\@DatabaseModel('users')\n *   public static schema = new mongoose.Schema<IUser>({\n *     username: { type: String, required: true, unique: true }\n *   });\n * }\n * ```\n */\nexport function DatabaseModel<TService extends ServiceKeys>(collection: TService) {\n  return <\n    SchemaObj extends Record<KeyOfSchema, mongoose.Schema>,\n    KeyOfSchema extends keyof SchemaObj & (string | symbol)\n  >(\n    target: SchemaObj,\n    propertyKey: KeyOfSchema\n  ): void => {\n    const schema = target[propertyKey];\n    const name = String(collection);\n    const model = mongoose.model(name, schema);\n    Reflect.defineMetadata(ModelMetadataKey, model, target);\n  };\n}\n","import type { BaseService } from '../BaseService';\nimport type { ServiceKeys } from '../types/Services';\nimport type { ConstructorFunction } from '@seedcord/types';\n\nexport const ServiceMetadataKey = Symbol('db:serviceKey');\n\n/**\n * Registers a database service with a typed key\n *\n * Associates a service class with a key for dependency injection.\n * The service becomes available via `core.db.services[key]`.\n *\n * @param key - Service key for registration and type-safe access\n * @decorator\n * @example\n * ```typescript\n * \\@DatabaseService('users')\n * export class Users<Doc extends IUser = IUser> extends BaseService<Doc> {\n *   // Some code\n * }\n * ```\n */\nexport function DatabaseService<TService extends ServiceKeys>(key: TService) {\n  return <DatabaseCtor extends ConstructorFunction & { prototype: BaseService }>(ctor: DatabaseCtor): void => {\n    Reflect.defineMetadata(ServiceMetadataKey, key, ctor);\n  };\n}\n","import { ModelMetadataKey } from './decorators/DatabaseModel';\nimport { ServiceMetadataKey } from './decorators/DatabaseService';\n\nimport type { Mongo } from './Mongo';\nimport type { Services } from './types/Services';\nimport type { IDocument, TypedConstructor } from '@seedcord/types';\nimport type mongoose from 'mongoose';\nimport type { Core } from 'seedcord';\n\n/**\n * Base class for MongoDB service layers\n *\n * Provides typed access to MongoDB collections through Mongoose models.\n * Services are automatically registered with the Mongo plugin when instantiated.\n *\n * @typeParam Doc - The document type this service manages\n * @example\n * ```typescript\n * \\@DatabaseService('users')\n * export class Users extends BaseService<IUser> {\n *   \\@DatabaseModel('users')\n *   public static schema = new mongoose.Schema<IUser>({\n *     username: { type: String, required: true, unique: true }\n *   });\n *\n *   // Custom methods here\n *   public async findByUsername(username: string) {\n *     return this.model.findOne({ username });\n *   }\n * }\n * ```\n */\nexport abstract class BaseService<Doc extends IDocument = IDocument> {\n  public readonly model: mongoose.Model<Doc>;\n\n  public constructor(\n    protected readonly db: Mongo,\n    protected readonly core: Core\n  ) {\n    const ctor = this.constructor;\n\n    const key = Reflect.getMetadata(ServiceMetadataKey, ctor) as string | undefined;\n    if (!key) throw new Error(`Missing @DatabaseService on ${ctor.name}`);\n\n    const model = Reflect.getMetadata(ModelMetadataKey, ctor) as mongoose.Model<Doc> | undefined;\n    if (!model) throw new Error(`Missing @DatabaseModel on ${ctor.name}`);\n\n    this.model = model;\n\n    db._register(key as keyof Services, this as unknown as Services[keyof Services]);\n  }\n}\n\n/** Constructor type for BaseService classes */\nexport type BaseServiceConstructor = TypedConstructor<typeof BaseService>;\n","import 'reflect-metadata';\n\nimport chalk from 'chalk';\nimport mongoose from 'mongoose';\nimport { Globals, Logger, Plugin, ShutdownPhase, traverseDirectory } from 'seedcord';\n\nimport { BaseService } from './BaseService';\nimport { ServiceMetadataKey } from './decorators/DatabaseService';\n\nimport type { BaseServiceConstructor } from './BaseService';\nimport type { Services } from './types/Services';\nimport type { Core } from 'seedcord';\n\n/**\n * Configuration options for MongoDB connection and service loading.\n */\ninterface MongoOptions {\n  /** Directory path containing database service classes */\n  dir: string;\n  /** MongoDB connection URI */\n  uri: string;\n  /** Database name to use */\n  name: string;\n}\n\n/**\n * MongoDB integration plugin for Seedcord.\n *\n * Manages MongoDB connections, service loading, and provides type-safe\n * access to database services through service registration decorators.\n */\nexport class Mongo extends Plugin {\n  public readonly logger = new Logger('MongoDB');\n  private isInitialised = false;\n  private readonly uri: string;\n\n  /**\n   * Map of all loaded services.\n   * Keys come from `@DatabaseService('key')`\n   */\n  public readonly services: Services = {} as Services;\n\n  constructor(\n    public readonly core: Core,\n    private readonly options: MongoOptions\n  ) {\n    super(core);\n    this.uri = options.uri;\n\n    this.core.shutdown.addTask(ShutdownPhase.ExternalResources, 'stop-database', async () => await this.stop());\n  }\n\n  public async init(): Promise<void> {\n    if (this.isInitialised) return;\n    this.isInitialised = true;\n\n    await this.connect();\n    await this.loadServices();\n  }\n\n  public async stop(): Promise<void> {\n    await this.disconnect();\n  }\n\n  private async connect(): Promise<void> {\n    await mongoose\n      .connect(this.uri, {\n        dbName: this.options.name,\n        ...(Globals.isProduction && { tls: true, ssl: true })\n      })\n      .then((i) => this.logger.info(`Connected to MongoDB: ${chalk.bold.magenta(i.connection.name)}`))\n      .catch((err) => {\n        throw new Error(`Could not connect to MongoDB`, err);\n      });\n  }\n\n  private async disconnect(): Promise<void> {\n    await mongoose\n      .disconnect()\n      .then(() => this.logger.info(chalk.red.bold('Disconnected from MongoDB')))\n      .catch((err) => this.logger.error(`Could not disconnect from MongoDB: ${(err as Error).message}`));\n  }\n\n  private async loadServices(): Promise<void> {\n    const servicesDir = this.options.dir;\n    this.logger.info(chalk.bold(servicesDir));\n\n    await traverseDirectory(servicesDir, (_full, rel, mod) => {\n      for (const Service of Object.values(mod)) {\n        if (this.isServiceClass(Service)) {\n          const instance = new Service(this, this.core);\n          this.logger.info(\n            `${chalk.italic('Registered')} ${chalk.bold.yellow(instance.constructor.name)} from ${chalk.gray(rel)}`\n          );\n        }\n      }\n    });\n\n    this.logger.info(`${chalk.bold.green('Loaded')}: ${chalk.magenta(Object.keys(this.services).length)} services`);\n  }\n\n  private isServiceClass(obj: unknown): obj is BaseServiceConstructor {\n    return (\n      typeof obj === 'function' && obj.prototype instanceof BaseService && Reflect.hasMetadata(ServiceMetadataKey, obj)\n    );\n  }\n\n  _register<SKey extends keyof Services>(key: SKey, instance: Services[SKey]): void {\n    this.services[key] = instance;\n  }\n}\n","import { CustomError, throwCustomError, DatabaseError } from 'seedcord';\n\n/**\n * Catches and wraps database operation errors.\n *\n * Automatically wraps non-CustomError exceptions in DatabaseError instances\n * with UUID tracking. Should be applied to database service methods.\n *\n * @param errorMessage - Message to include when wrapping errors\n * @decorator\n * @example\n * ```typescript\n * class UserService extends BaseService {\n *   \\@DBCatchable('Failed to find user')\n *   async findById(id: string) {\n *     return this.model.findById(id);\n *   }\n * }\n * ```\n */\nexport function DBCatchable<TypeReturn>(errorMessage: string) {\n  return function (\n    _target: unknown,\n    _propertyKey: string,\n    descriptor: TypedPropertyDescriptor<(...args: any[]) => Promise<TypeReturn>>\n  ): void {\n    const originalMethod = descriptor.value;\n\n    descriptor.value = async function (...args: any[]): Promise<TypeReturn> {\n      if (!originalMethod) {\n        throw new Error('Method not found');\n      }\n\n      try {\n        return await originalMethod.apply(this, args);\n      } catch (error) {\n        if (!(error instanceof CustomError)) {\n          throwCustomError(error, errorMessage, DatabaseError);\n        } else {\n          throw error;\n        }\n      }\n    };\n  };\n}\n"]}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@seedcord/plugins",
+  "type": "module",
+  "version": "0.1.0",
+  "description": "Official plugins for Seedcord Discord bot framework",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/materwelondhruv/seedcord.git",
+    "directory": "packages/plugins"
+  },
+  "exports": {
+    ".": {
+      "types": {
+        "development": "./src/index.ts",
+        "import": "./dist/index.d.mts",
+        "require": "./dist/index.d.cts",
+        "default": "./dist/index.d.ts"
+      },
+      "development": "./src/index.ts",
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      },
+      "default": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "package.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "peerDependencies": {
+    "typescript": "^5.9.2"
+  },
+  "dependencies": {
+    "chalk": "^5.5.0",
+    "mongoose": "^8.17.1",
+    "reflect-metadata": "^0.2.2",
+    "@seedcord/types": "^0.1.0",
+    "seedcord": "^0.1.0"
+  },
+  "devDependencies": {
+    "@seedcord/eslint-config": "^1.0.1",
+    "@seedcord/tsconfig": "^1.0.1",
+    "@seedcord/tsup-config": "^1.0.1"
+  },
+  "scripts": {
+    "build": "tsup && cp dist/index.d.cts dist/index.d.mts",
+    "clean": "rm -rf dist",
+    "lint": "eslint 'src/**/*.{ts,tsx}' --cache",
+    "lint:fix": "eslint 'src/**/*.{ts,tsx}' --fix --cache",
+    "fmt": "prettier --write 'src/**/*.{ts,tsx,json,md}' --cache",
+    "fmt:check": "prettier --check 'src/**/*.{ts,tsx,json,md}' --cache",
+    "tc": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest dev",
+    "coverage": "vitest run --coverage"
+  }
+}