@seedcord/plugins 0.2.1 → 0.3.0

package/package.json

@@ -1,23 +1,20 @@
 {
   "name": "@seedcord/plugins",
   "type": "module",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Official plugins for Seedcord Discord bot framework",
   "repository": {
     "type": "git",
     "url": "https://github.com/materwelondhruv/seedcord.git",
     "directory": "packages/plugins"
   },
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "import": {
-        "types": "./dist/index.d.mts",
-        "default": "./dist/index.mjs"
-      },
-      "require": {
-        "types": "./dist/index.d.cts",
-        "default": "./dist/index.cjs"
-      }
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.mjs"
     }
   },
   "files": [
@@ -30,20 +27,20 @@
     "typescript": "5.9.2"
   },
   "dependencies": {
-    "chalk": "5.6.0",
-    "mongoose": "8.18.0",
-    "envapt": "3.0.0",
+    "chalk": "5.6.2",
+    "mongoose": "8.18.3",
+    "envapt": "3.0.2",
     "reflect-metadata": "0.2.2",
-    "@seedcord/types": "^0.1.3",
-    "seedcord": "^0.2.1"
+    "@seedcord/types": "^0.2.0",
+    "seedcord": "^0.4.0"
   },
   "devDependencies": {
-    "@seedcord/tsconfig": "^1.0.2",
-    "@seedcord/eslint-config": "^1.1.1",
-    "@seedcord/tsup-config": "^1.0.2"
+    "@seedcord/tsconfig": "^1.0.3",
+    "@seedcord/tsup-config": "^1.0.3",
+    "@seedcord/eslint-config": "^1.2.0"
   },
   "scripts": {
-    "build": "tsup && cp dist/index.d.cts dist/index.d.mts",
+    "build": "tsup",
     "clean": "rm -rf dist",
     "lint": "eslint 'src/**/*.{ts,tsx}' --cache",
     "lint:fix": "eslint 'src/**/*.{ts,tsx}' --fix --cache",

package/dist/index.d.mts

@@ -1,179 +0,0 @@
-import { Plugin, Core, Logger } from 'seedcord';
-import { 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;
-
-/**
- * Basic document interface with MongoDB ObjectId field.
- *
- * Represents the minimal structure of a MongoDB document
- * with the required `_id` field.
- */
-interface IDocument {
-    /** MongoDB document identifier */
-    _id: string;
-}
-/**
- * Helper type to extract the type of a document that extends IDocument.
- *
- * @typeParam Doc - The document type extending IDocument
- */
-type TypeOfIDocument<Doc extends IDocument = IDocument> = Doc;
-
-/**
- * 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, type IDocument, ModelMetadataKey, Mongo, type ServiceKeys, ServiceMetadataKey, type Services, type TypeOfIDocument };