@seedcord/plugins 0.6.1 → 0.7.0-next.0

package/dist/index.d.mts

@@ -1,9 +1,12 @@
+import { Logger } from "@seedcord/services";
 import mongoose, { Mongoose } from "mongoose";
-import { Core, Logger, Plugin, TypedConstructor } from "seedcord";
+import { Core, Plugin } from "seedcord";
 import { Kysely, KyselyConfig } from "kysely";
 import { Pool, PoolConfig } from "pg";
 import { MigrationInfo, NoMigrations } from "kysely/migration";
 import { HmrUpdateEvent } from "@seedcord/types/internal";
+import { TypedConstructor } from "@seedcord/types";
+
 //#region src/mongo/types/MongoOptions.d.ts
 /**
  * Configuration options for MongoDB connection and service loading.
@@ -157,7 +160,7 @@ declare abstract class MongoService<Doc extends MongoDocument = MongoDocument> {
  */
 declare function RegisterMongoModel<TService extends MongoServiceKeys>(collection: TService): <SchemaObj extends Record<KeyOfSchema, mongoose.Schema>, KeyOfSchema extends keyof SchemaObj & (string | symbol)>(target: SchemaObj, propertyKey: KeyOfSchema) => void;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/primitive.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/primitive.d.ts
 /**
 Matches any [primitive value](https://developer.mozilla.org/en-US/docs/Glossary/Primitive).
 
@@ -165,7 +168,7 @@ Matches any [primitive value](https://developer.mozilla.org/en-US/docs/Glossary/
 */
 type Primitive = null | undefined | string | number | boolean | symbol | bigint;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/basic.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/basic.d.ts
 /**
 Matches a [`class` constructor](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes).
 
@@ -173,7 +176,7 @@ Matches a [`class` constructor](https://developer.mozilla.org/en-US/docs/Web/Jav
 */
 type Constructor<T, Arguments extends unknown[] = any[]> = new (...arguments_: Arguments) => T;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/is-any.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/is-any.d.ts
 /**
 Returns a boolean for whether the given type is `any`.
 
@@ -204,7 +207,7 @@ const anyA = get(anyObject, 'a');
 */
 type IsAny<T> = 0 extends 1 & NoInfer<T> ? true : false;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/is-optional-key-of.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/is-optional-key-of.d.ts
 /**
 Returns a boolean for whether the given key is an optional key of type.
 
@@ -247,7 +250,7 @@ type T5 = IsOptionalKeyOf<User | Admin, 'surname'>;
 */
 type IsOptionalKeyOf<Type extends object, Key extends keyof Type> = IsAny<Type | Key> extends true ? never : Key extends keyof Type ? Type extends Record<Key, Type[Key]> ? false : true : false;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/optional-keys-of.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/optional-keys-of.d.ts
 /**
 Extract all optional keys from the given type.
 
@@ -285,7 +288,7 @@ type OptionalKeysOf<Type extends object> = Type extends unknown // For distribut
 ? (keyof { [Key in keyof Type as IsOptionalKeyOf<Type, Key> extends false ? never : Key]: never }) & keyof Type // Intersect with `keyof Type` to ensure result of `OptionalKeysOf<Type>` is always assignable to `keyof Type`
 : never;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/required-keys-of.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/required-keys-of.d.ts
 /**
 Extract all required keys from the given type.
 
@@ -319,7 +322,7 @@ const validator3 = createValidation<User>('luckyNumber', value => value > 0);
 type RequiredKeysOf<Type extends object> = Type extends unknown // For distributing `Type`
 ? Exclude<keyof Type, OptionalKeysOf<Type>> : never;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/is-never.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/is-never.d.ts
 /**
 Returns a boolean for whether the given type is `never`.
 
@@ -375,7 +378,7 @@ type B = IsTrueFixed<never>;
 */
 type IsNever<T> = [T] extends [never] ? true : false;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/if.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/if.d.ts
 /**
 An if-else-like type that resolves depending on whether the given `boolean` type is `true` or `false`.
 
@@ -470,7 +473,7 @@ type Works = IncludesWithoutIf<HundredZeroes, '1'>;
 */
 type If<Type extends boolean, IfBranch, ElseBranch> = IsNever<Type> extends true ? ElseBranch : Type extends true ? IfBranch : ElseBranch;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/simplify.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/simplify.d.ts
 /**
 Useful to flatten the type output to improve type hints shown in editors. And also to transform an interface into a type to aide with assignability.
 
@@ -531,7 +534,7 @@ fn(someInterface as Simplify<SomeInterface>); // Good: transform an `interface`
 */
 type Simplify<T> = { [KeyType in keyof T]: T[KeyType] } & {};
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/is-equal.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/is-equal.d.ts
 /**
 Returns a boolean for whether the two given types are equal.
 
@@ -562,7 +565,7 @@ type IsEqual<A, B> = [A] extends [B] ? [B] extends [A] ? _IsEqual<A, B> : false
 // This version fails the `equalWrappedTupleIntersectionToBeNeverAndNeverExpanded` test in `test-d/is-equal.ts`.
 type _IsEqual<A, B> = (<G>() => G extends A & G | G ? 1 : 2) extends (<G>() => G extends B & G | G ? 1 : 2) ? true : false;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/omit-index-signature.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/omit-index-signature.d.ts
 /**
 Omit any index signatures from the given object type, leaving only explicitly defined properties.
 
@@ -656,7 +659,7 @@ type ExampleWithoutIndexSignatures = OmitIndexSignature<Example>;
 */
 type OmitIndexSignature<ObjectType> = { [KeyType in keyof ObjectType as {} extends Record<KeyType, unknown> ? never : KeyType]: ObjectType[KeyType] };
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/pick-index-signature.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/pick-index-signature.d.ts
 /**
 Pick only index signatures from the given object type, leaving out all explicitly defined properties.
 
@@ -704,7 +707,7 @@ type ExampleIndexSignature = PickIndexSignature<Example>;
 */
 type PickIndexSignature<ObjectType> = { [KeyType in keyof ObjectType as {} extends Record<KeyType, unknown> ? KeyType : never]: ObjectType[KeyType] };
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/merge.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/merge.d.ts
 // Merges two objects without worrying about index signatures.
 type SimpleMerge<Destination, Source> = Simplify<{ [Key in keyof Destination as Key extends keyof Source ? never : Key]: Destination[Key] } & Source>;
 /**
@@ -776,7 +779,7 @@ type Merge<Destination, Source> = Destination extends unknown // For distributin
 // Should never happen
 type _Merge<Destination, Source> = Simplify<SimpleMerge<PickIndexSignature<Destination>, PickIndexSignature<Source>> & SimpleMerge<OmitIndexSignature<Destination>, OmitIndexSignature<Source>>>;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/internal/object.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/internal/object.d.ts
 /**
 Merges user specified options with default options.
 
@@ -829,9 +832,38 @@ type Result = ApplyDefaultOptions<PathsOptions, DefaultPathsOptions, SpecifiedOp
 // Types of property 'leavesOnly' are incompatible. Type 'string' is not assignable to type 'boolean'.
 ```
 */
-type ApplyDefaultOptions<Options extends object, Defaults extends Simplify<Omit<Required<Options>, RequiredKeysOf<Options>> & Partial<Record<RequiredKeysOf<Options>, never>>>, SpecifiedOptions extends Options> = If<IsAny<SpecifiedOptions>, Defaults, If<IsNever<SpecifiedOptions>, Defaults, Simplify<Merge<Defaults, { [Key in keyof SpecifiedOptions as Key extends OptionalKeysOf<Options> ? undefined extends SpecifiedOptions[Key] ? never : Key : Key]: SpecifiedOptions[Key] }> & Required<Options>>>>;
+type ApplyDefaultOptions<Options extends object, Defaults extends Simplify<Omit<Required<Options>, RequiredKeysOf<Options>> & Partial<Record<RequiredKeysOf<Options>, never>>>, SpecifiedOptions extends Options> = _ApplyDefaultOptions<Options, Defaults, SpecifiedOptions> extends infer Result extends Required<Options> // `extends Required<Options>` ensures that `ApplyDefaultOptions<SomeOption, ...>` is always assignable to `Required<SomeOption>`
+? Result : never;
+type _ApplyDefaultOptions<Options, Defaults, SpecifiedOptions> = If<IsAny<SpecifiedOptions>, Defaults, If<IsNever<SpecifiedOptions>, Defaults, Merge<Defaults, { [Key in keyof SpecifiedOptions as undefined extends Required<Options>[Key & keyof Options] ? Key : undefined extends SpecifiedOptions[Key] ? never : Key]: SpecifiedOptions[Key] }>>>;
+/**
+Collapses literal types in a union into their corresponding primitive types, when possible. For example, `CollapseLiterals<'foo' | 'bar' | (string & {})>` returns `string`.
+
+Note: This doesn't collapse literals within tagged types. For example, `CollapseLiterals<Tagged<'foo' | (string & {}), 'Tag'>>` returns `("foo" & Tag<"Tag", never>) | (string & Tag<"Tag", never>)` and not `string & Tag<"Tag", never>`.
+
+Use-case: For collapsing unions created using {@link LiteralUnion}.
+
+@example
+```
+import type {LiteralUnion} from 'type-fest';
+
+type A = CollapseLiterals<'foo' | 'bar' | (string & {})>;
+//=> string
+
+type B = CollapseLiterals<LiteralUnion<1 | 2 | 3, number>>;
+//=> number
+
+type C = CollapseLiterals<LiteralUnion<'onClick' | 'onChange', `on${string}`>>;
+//=> `on${string}`
+
+type D = CollapseLiterals<'click' | 'change' | (`on${string}` & {})>;
+//=> 'click' | 'change' | `on${string}`
+
+type E = CollapseLiterals<LiteralUnion<'foo' | 'bar', string> | null | undefined>;
+//=> string | null | undefined
+```
+*/
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/except.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/except.d.ts
 /**
 Filter out keys from an object.
 
@@ -929,7 +961,7 @@ type PostPayloadFixed = Except<UserData, 'email'>;
 type Except<ObjectType, KeysType extends keyof ObjectType, Options extends ExceptOptions = {}> = _Except<ObjectType, KeysType, ApplyDefaultOptions<ExceptOptions, DefaultExceptOptions, Options>>;
 type _Except<ObjectType, KeysType extends keyof ObjectType, Options extends Required<ExceptOptions>> = { [KeyType in keyof ObjectType as Filter<KeyType, KeysType>]: ObjectType[KeyType] } & (Options['requireExactProps'] extends true ? Partial<Record<KeysType, never>> : {});
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/literal-union.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/literal-union.d.ts
 /**
 Create a union type by combining primitive types and literal types without sacrificing auto-completion in IDEs for the literal type part of the union.
 
@@ -1036,9 +1068,17 @@ type MigrationTarget = string | NoMigrations;
  * database connection is established.
  */
 interface MigrationOptions {
-  /** Optional target migration to reach. Defaults to latest if omitted. */
+  /**
+   * Optional target migration to reach.
+   *
+   * @defaultValue the latest migration
+   */
   readonly target?: MigrationTarget;
-  /** Direction to move along the migration timeline. Defaults to `latest`. */
+  /**
+   * Direction to move along the migration timeline.
+   *
+   * @defaultValue `'latest'`
+   */
   readonly direction?: 'latest' | 'up' | 'down';
   /** Number of steps to apply when direction is `up` or `down`. */
   readonly steps?: number;
@@ -1118,7 +1158,7 @@ declare class KyselyPg<Database extends object> extends Plugin {
   private connect;
   private disconnect;
   /**
-   * Runs migrations using the supplied options or defaults to `latest`.
+   * Runs migrations using the supplied options.
    *
    * @param options - Target migration or direction overrides
    */
@@ -1208,9 +1248,11 @@ type KyselyServiceConstructor<Database extends object = object> = TypedConstruct
  */
 interface KpgServiceRegistrationOptions {
   /**
-   * Optional override for the table name exposed via the service. Defaults to the provided key.
+   * Optional override for the table name exposed via the service.
    *
    * You should set this if your table name does not match the service key.
+   *
+   * @defaultValue the provided key
    */
   table?: string;
 }
@@ -1239,35 +1281,9 @@ interface KpgServiceRegistrationOptions {
  */
 declare function RegisterKpgService<TKey extends KpgServiceKeys>(key: TKey, options?: KpgServiceRegistrationOptions): <Ctor extends Constructor<KpgServices[TKey]>>(ctor: Ctor) => void;
 //#endregion
-//#region src/shared/WrapDatabaseError.d.ts
-/**
- * Catches and wraps database operation errors.
- *
- * Wraps non-CustomError exceptions in DatabaseError instances
- * with UUID tracking. Should be applied to database service methods.
- *
- * @typeParam TypeReturn - The return type of the decorated method
- * @param errorMessage - Message to include when wrapping errors
- * @decorator
- * @example
- * ```typescript
- * class UserService extends MongoService<IUser> {
- *   \@WrapDatabaseError('Failed to find user')
- *   async findById(id: string) {
- *     return this.model.findById(id);
- *   }
- * }
- * ```
- *
- * @see {@link DatabaseError}
- * @see {@link CustomError}
- * @see {@link MongoService}
- */
-declare function WrapDatabaseError<TypeReturn>(errorMessage: string): (_target: unknown, _propertyKey: string, descriptor: TypedPropertyDescriptor<(...args: any[]) => Promise<TypeReturn>>) => void;
-//#endregion
 //#region src/index.d.ts
 /** Package version */
 declare const version: string;
 //#endregion
-export { type KpgMigrationsOptions, type KpgOptions, KpgService, type KpgServiceRegistrationOptions, type KpgServices, KyselyPg, type MigrationOptions, type MigrationTarget, Mongo, type MongoDocument, MongoService, type MongoServices, RegisterKpgService, RegisterMongoModel, RegisterMongoService, type StepMigrationOptions, WrapDatabaseError, version };
+export { type KpgMigrationsOptions, type KpgOptions, KpgService, type KpgServiceRegistrationOptions, type KpgServices, KyselyPg, type MigrationOptions, type MigrationTarget, Mongo, type MongoDocument, MongoService, type MongoServices, RegisterKpgService, RegisterMongoModel, RegisterMongoService, type StepMigrationOptions, version };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1,20 +1,19 @@
 import "reflect-metadata";
-import { SeedcordError, SeedcordRangeError } from "@seedcord/services/internal";
+import { SeedcordErrorCode } from "@seedcord/errors";
+import { SeedcordError, SeedcordRangeError } from "@seedcord/errors/internal";
+import { Logger, ShutdownPhase } from "@seedcord/services";
+import { keepDefined, traverseDirectory } from "@seedcord/utils";
 import chalk from "chalk";
 import { Envapter } from "envapt";
 import mongoose from "mongoose";
-import { CustomError, HmrModuleHandler, Logger, Plugin, SeedcordErrorCode, ShutdownPhase, keepDefined, traverseDirectory } from "seedcord";
+import { HmrModuleHandler, Plugin } from "seedcord";
 import { Kysely, PostgresDialect } from "kysely";
 import { Pool } from "pg";
 import { promises } from "node:fs";
 import path from "node:path";
 import { pathToFileURL } from "node:url";
 import { inspect } from "node:util";
-import { keepDefined as keepDefined$1 } from "@seedcord/utils";
 import { FileMigrationProvider, Migrator, NO_MIGRATIONS } from "kysely/migration";
-import { DatabaseError, SeedcordError as SeedcordError$1 } from "seedcord/internal";
-import { randomUUID } from "node:crypto";
-import { Logger as Logger$1 } from "@seedcord/services";
 
 //#region src/mongo/decorators/RegisterMongoModel.ts
 const ModelMetadataKey = Symbol("db:model");
@@ -536,7 +535,7 @@ var KpgMigrationManager = class {
 			db: this.ctx.db,
 			provider,
 			allowUnorderedMigrations: config.allowUnorderedMigrations ?? false,
-			...keepDefined$1(config, "migrationTableName", "migrationLockTableName", "migrationTableSchema")
+			...keepDefined(config, "migrationTableName", "migrationLockTableName", "migrationTableSchema")
 		});
 	}
 	async getMigrationProvider() {
@@ -799,7 +798,7 @@ var KyselyPg = class extends Plugin {
 		this.logger.info(chalk.red.bold("Disconnected from Postgres"));
 	}
 	/**
-	* Runs migrations using the supplied options or defaults to `latest`.
+	* Runs migrations using the supplied options.
 	*
 	* @param options - Target migration or direction overrides
 	*/
@@ -897,69 +896,11 @@ var KyselyPg = class extends Plugin {
 	}
 };
 
-//#endregion
-//#region src/shared/throwDatabaseError.ts
-const logger = new Logger$1("DatabaseError");
-/**
-* Wraps an unknown error in a {@link DatabaseError} with a generated UUID for correlation, then
-* throws it. Used by `@WrapDatabaseError` to normalize raw database failures.
-*
-* @param error - The original error or value
-* @param message - Fallback message used when `error` is not an `Error`
-* @throws A {@link DatabaseError} carrying the message and a fresh UUID
-*
-* @internal
-*/
-function throwDatabaseError(error, message) {
-	logger.error("Throwing DatabaseError", error instanceof Error ? error.name : String(error));
-	throw new DatabaseError(error instanceof Error ? error.message : message, randomUUID());
-}
-
-//#endregion
-//#region src/shared/WrapDatabaseError.ts
-/**
-* Catches and wraps database operation errors.
-*
-* Wraps non-CustomError exceptions in DatabaseError instances
-* with UUID tracking. Should be applied to database service methods.
-*
-* @typeParam TypeReturn - The return type of the decorated method
-* @param errorMessage - Message to include when wrapping errors
-* @decorator
-* @example
-* ```typescript
-* class UserService extends MongoService<IUser> {
-*   \@WrapDatabaseError('Failed to find user')
-*   async findById(id: string) {
-*     return this.model.findById(id);
-*   }
-* }
-* ```
-*
-* @see {@link DatabaseError}
-* @see {@link CustomError}
-* @see {@link MongoService}
-*/
-function WrapDatabaseError(errorMessage) {
-	return function(_target, _propertyKey, descriptor) {
-		const originalMethod = descriptor.value;
-		descriptor.value = async function(...args) {
-			if (!originalMethod) throw new SeedcordError$1(SeedcordErrorCode.DecoratorMethodNotFound);
-			try {
-				return await originalMethod.apply(this, args);
-			} catch (error) {
-				if (!(error instanceof CustomError)) throwDatabaseError(error, errorMessage);
-				else throw error;
-			}
-		};
-	};
-}
-
 //#endregion
 //#region src/index.ts
 /** Package version */
-const version = "0.6.1";
+const version = "0.7.0-next.0";
 
 //#endregion
-export { KpgService, KyselyPg, Mongo, MongoService, RegisterKpgService, RegisterMongoModel, RegisterMongoService, WrapDatabaseError, version };
+export { KpgService, KyselyPg, Mongo, MongoService, RegisterKpgService, RegisterMongoModel, RegisterMongoService, version };
 //# sourceMappingURL=index.mjs.map