@hammadj/better-auth-test-utils 1.5.0-beta.9

package/.turbo/turbo-build.log

@@ -0,0 +1,86 @@
+
+> @hammadj/better-auth-test-utils@1.5.0-beta.9 build /Users/hammadjutt/Dev/better-auth-fork/packages/test-utils
+> tsdown
+
+ℹ tsdown v0.20.1 powered by rolldown v1.0.0-rc.1
+ℹ config file: /Users/hammadjutt/Dev/better-auth-fork/packages/test-utils/tsdown.config.ts 
+ℹ entry: src/adapter/index.ts
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ Cleaning 6 files
+ℹ dist/adapter.mjs                 0.15 kB │ gzip: 0.10 kB
+ℹ dist/create-test-suite.mjs.map  39.07 kB │ gzip: 9.66 kB
+ℹ dist/test-adapter.mjs.map       18.06 kB │ gzip: 4.23 kB
+ℹ dist/create-test-suite.mjs      15.96 kB │ gzip: 3.98 kB
+ℹ dist/test-adapter.mjs            8.12 kB │ gzip: 1.97 kB
+ℹ dist/adapter.d.mts               0.27 kB │ gzip: 0.16 kB
+ℹ dist/create-test-suite.d.mts     5.13 kB │ gzip: 1.70 kB
+ℹ dist/test-adapter.d.mts          2.21 kB │ gzip: 0.87 kB
+ℹ 8 files, total: 88.97 kB
+src/adapter/test-adapter.ts (3:44) [UNRESOLVED_IMPORT] Warning: Could not resolve '@better-auth/core/db/adapter' in src/adapter/test-adapter.ts
+   ╭─[ src/adapter/test-adapter.ts:3:45 ]
+   │
+ 3 │ import { deepmerge, initGetModelName } from "@better-auth/core/db/adapter";
+   │                                             ───────────────┬──────────────  
+   │                                                            ╰──────────────── Module not found, treating it as an external dependency
+───╯
+
+src/adapter/test-adapter.ts (4:27) [UNRESOLVED_IMPORT] Warning: Could not resolve '@better-auth/core/env' in src/adapter/test-adapter.ts
+   ╭─[ src/adapter/test-adapter.ts:4:28 ]
+   │
+ 4 │ import { TTY_COLORS } from "@better-auth/core/env";
+   │                            ───────────┬───────────  
+   │                                       ╰───────────── Module not found, treating it as an external dependency
+───╯
+
+src/adapter/test-adapter.ts (5:30) [UNRESOLVED_IMPORT] Warning: Could not resolve 'better-auth/db' in src/adapter/test-adapter.ts
+   ╭─[ src/adapter/test-adapter.ts:5:31 ]
+   │
+ 5 │ import { getAuthTables } from "better-auth/db";
+   │                               ────────┬───────  
+   │                                       ╰───────── Module not found, treating it as an external dependency
+───╯
+
+src/adapter/create-test-suite.ts (8:30) [UNRESOLVED_IMPORT] Warning: Could not resolve '@better-auth/core/db' in src/adapter/create-test-suite.ts
+   ╭─[ src/adapter/create-test-suite.ts:8:31 ]
+   │
+ 8 │ import { getAuthTables } from "@better-auth/core/db";
+   │                               ───────────┬──────────  
+   │                                          ╰──────────── Module not found, treating it as an external dependency
+───╯
+
+src/adapter/create-test-suite.ts (14:7) [UNRESOLVED_IMPORT] Warning: Could not resolve '@better-auth/core/db/adapter' in src/adapter/create-test-suite.ts
+    ╭─[ src/adapter/create-test-suite.ts:14:8 ]
+    │
+ 14 │ } from "@better-auth/core/db/adapter";
+    │        ───────────────┬──────────────  
+    │                       ╰──────────────── Module not found, treating it as an external dependency
+────╯
+
+src/adapter/create-test-suite.ts (15:27) [UNRESOLVED_IMPORT] Warning: Could not resolve '@better-auth/core/env' in src/adapter/create-test-suite.ts
+    ╭─[ src/adapter/create-test-suite.ts:15:28 ]
+    │
+ 15 │ import { TTY_COLORS } from "@better-auth/core/env";
+    │                            ───────────┬───────────  
+    │                                       ╰───────────── Module not found, treating it as an external dependency
+────╯
+
+src/adapter/create-test-suite.ts (16:27) [UNRESOLVED_IMPORT] Warning: Could not resolve '@better-auth/core/utils/id' in src/adapter/create-test-suite.ts
+    ╭─[ src/adapter/create-test-suite.ts:16:28 ]
+    │
+ 16 │ import { generateId } from "@better-auth/core/utils/id";
+    │                            ──────────────┬─────────────  
+    │                                          ╰─────────────── Module not found, treating it as an external dependency
+────╯
+
+src/adapter/create-test-suite.ts (18:27) [UNRESOLVED_IMPORT] Warning: Could not resolve 'better-auth' in src/adapter/create-test-suite.ts
+    ╭─[ src/adapter/create-test-suite.ts:18:28 ]
+    │
+ 18 │ import { betterAuth } from "better-auth";
+    │                            ──────┬──────  
+    │                                  ╰──────── Module not found, treating it as an external dependency
+────╯
+
+[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugin `rolldown-plugin-dts:generate`. See https://rolldown.rs/options/checks#plugintimings for more details.
+
+✔ Build complete in 12440ms

package/LICENSE.md

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+Copyright (c) 2024 - present, Bereket Engida
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the “Software”), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.

package/dist/adapter.d.mts

@@ -0,0 +1,3 @@
+import { Logger, testAdapter } from "./test-adapter.mjs";
+import { InsertRandomFn, TestEntry, TestSuiteStats, createTestSuite } from "./create-test-suite.mjs";
+export { type InsertRandomFn, type Logger, type TestEntry, type TestSuiteStats, createTestSuite, testAdapter };

package/dist/adapter.mjs

@@ -0,0 +1,4 @@
+import { createTestSuite } from "./create-test-suite.mjs";
+import { testAdapter } from "./test-adapter.mjs";
+
+export { createTestSuite, testAdapter };

package/dist/create-test-suite.d.mts

@@ -0,0 +1,118 @@
+import { Logger } from "./test-adapter.mjs";
+import { Account, Session, User, Verification } from "@better-auth/core/db";
+import { DBAdapter } from "@better-auth/core/db/adapter";
+import { Auth } from "better-auth";
+import { BetterAuthOptions } from "@better-auth/core";
+
+//#region src/adapter/create-test-suite.d.ts
+/**
+ * Test entry type that supports both callback and object formats.
+ * Object format allows specifying migration options that will be applied before the test runs.
+ */
+type TestEntry = ((context: {
+  readonly skip: {
+    (note?: string | undefined): never;
+    (condition: boolean, note?: string | undefined): void;
+  };
+}) => Promise<void>) | {
+  migrateBetterAuth?: BetterAuthOptions;
+  test: (context: {
+    readonly skip: {
+      (note?: string | undefined): never;
+      (condition: boolean, note?: string | undefined): void;
+    };
+  }) => Promise<void>;
+};
+/**
+ * Statistics tracking for test suites.
+ */
+type TestSuiteStats = {
+  migrationCount: number;
+  totalMigrationTime: number;
+  testCount: number;
+  suiteStartTime: number;
+  suiteDuration: number;
+  suiteName: string;
+  groupingStats?: {
+    totalGroups: number;
+    averageTestsPerGroup: number;
+    largestGroupSize: number;
+    smallestGroupSize: number;
+    groupsWithMultipleTests: number;
+    totalTestsInGroups: number;
+  };
+};
+type GenerateFn = <M extends "user" | "session" | "verification" | "account">(Model: M) => Promise<M extends "user" ? User : M extends "session" ? Session : M extends "verification" ? Verification : M extends "account" ? Account : undefined>;
+type Success<T> = {
+  data: T;
+  error: null;
+};
+type Failure<E> = {
+  data: null;
+  error: E;
+};
+type Result<T, E = Error> = Success<T> | Failure<E>;
+type InsertRandomFn = <M extends "user" | "session" | "verification" | "account", Count extends number = 1>(model: M, count?: Count | undefined) => Promise<Count extends 1 ? M extends "user" ? [User] : M extends "session" ? [User, Session] : M extends "verification" ? [Verification] : M extends "account" ? [User, Account] : [undefined] : Array<M extends "user" ? [User] : M extends "session" ? [User, Session] : M extends "verification" ? [Verification] : M extends "account" ? [User, Account] : [undefined]>>;
+declare const createTestSuite: <Tests extends Record<string, TestEntry>, AdditionalOptions extends Record<string, any> = {}>(suiteName: string, config: {
+  defaultBetterAuthOptions?: BetterAuthOptions | undefined;
+  /**
+   * Helpful if the default better auth options require migrations to be run.
+   */
+  alwaysMigrate?: boolean | undefined;
+  prefixTests?: string | undefined;
+  customIdGenerator?: () => any | Promise<any> | undefined;
+}, tests: (helpers: {
+  adapter: DBAdapter;
+  log: Logger;
+  generate: GenerateFn;
+  insertRandom: InsertRandomFn;
+  /**
+   * A light cleanup function that will only delete rows it knows about.
+   */
+  cleanup: () => Promise<void>;
+  /**
+   * A hard cleanup function that will delete all rows from the database.
+   */
+  hardCleanup: () => Promise<void>;
+  modifyBetterAuthOptions: (options: BetterAuthOptions, shouldRunMigrations: boolean) => Promise<BetterAuthOptions>;
+  getBetterAuthOptions: () => BetterAuthOptions;
+  sortModels: (models: Array<Record<string, any> & {
+    id: string;
+  }>, by?: ("id" | "createdAt") | undefined) => (Record<string, any> & {
+    id: string;
+  })[];
+  getAuth: () => Promise<Auth>;
+  tryCatch<T, E = Error>(promise: Promise<T>): Promise<Result<T, E>>;
+  customIdGenerator?: () => any | Promise<any> | undefined;
+  transformIdOutput?: (id: any) => string | undefined;
+  /**
+   * Some adapters may change the ID type, this function allows you to pass the entire model
+   * data and it will return the correct better-auth-expected transformed data.
+   *
+   * Eg:
+   * MongoDB uses ObjectId for IDs, but it's possible the user can disable that option in the adapter config.
+   * Because of this, the expected data would be a string.
+   * These sorts of conversions will cause issues with the test when you use the `generate` function.
+   * This is because the `generate` function will return the raw data expected to be saved in DB, not the excpected BA output.
+   */
+  transformGeneratedModel: (data: Record<string, any>) => Record<string, any>;
+}, additionalOptions?: AdditionalOptions | undefined) => Tests) => (options?: ({
+  disableTests?: Partial<Record<keyof Tests, boolean> & {
+    ALL?: boolean;
+  }>;
+} & AdditionalOptions) | undefined) => (helpers: {
+  adapter: () => Promise<DBAdapter<BetterAuthOptions>>;
+  log: Logger;
+  adapterDisplayName: string;
+  getBetterAuthOptions: () => BetterAuthOptions;
+  modifyBetterAuthOptions: (options: BetterAuthOptions) => Promise<BetterAuthOptions>;
+  cleanup: () => Promise<void>;
+  runMigrations: () => Promise<void>;
+  prefixTests?: string | undefined;
+  onTestFinish: (stats: TestSuiteStats) => Promise<void>;
+  customIdGenerator?: () => any | Promise<any> | undefined;
+  transformIdOutput?: (id: any) => string | undefined;
+}) => Promise<void>;
+//#endregion
+export { InsertRandomFn, TestEntry, TestSuiteStats, createTestSuite };
+//# sourceMappingURL=create-test-suite.d.mts.map