nuxt-users 1.1.1 → 1.1.2

package/README.md

@@ -37,6 +37,8 @@ npx nuxt-users migrate
 npx nuxt-users create-user user@example.com "John Doe" password123
 ```
 
+> **Note**: For SQLite (default), the module automatically creates the database file. If installation hangs with other databases, add `skipDatabaseChecks: true` to your configuration. See [Troubleshooting](/docs/troubleshooting/hanging-during-install) for more details.
+
 ## Documentation
 
 📚 **Full documentation is available at: [docs/](/docs/)**

package/dist/module.d.mts

@@ -8,6 +8,9 @@ type DatabaseConfig = {
     user?: string;
     password?: string;
     database?: string;
+    connectTimeout?: number;
+    acquireTimeout?: number;
+    connectionTimeoutMillis?: number;
 };
 interface ModuleOptions {
     connector?: {
@@ -29,6 +32,11 @@ interface ModuleOptions {
      * @default 'http://localhost:3000' // Example, will be set in module defaults
      */
     passwordResetBaseUrl?: string;
+    /**
+     * Skip database checks during module setup to prevent hanging
+     * @default false
+     */
+    skipDatabaseChecks?: boolean;
 }
 interface MailerOptions {
     host: string;

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "nuxt-users",
   "configKey": "nuxtUsers",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "builder": {
     "@nuxt/module-builder": "1.0.1",
     "unbuild": "2.0.0"

package/dist/module.mjs

@@ -1,7 +1,9 @@
 import { defineNuxtModule, createResolver, addServerHandler, addPlugin, addComponent } from '@nuxt/kit';
 import { defu } from 'defu';
-import { checkUsersTableExists, checkPersonalAccessTokensTableExists, checkPasswordResetTokensTableExists, hasAnyUsers } from '../dist/runtime/server/utils/db.js';
+import { hasAnyUsers, checkUsersTableExists, checkPersonalAccessTokensTableExists, checkPasswordResetTokensTableExists } from '../dist/runtime/server/utils/db.js';
 import { getAppliedMigrations } from '../dist/runtime/server/utils/migrate.js';
+import { promises } from 'node:fs';
+import { dirname } from 'node:path';
 
 const defaultOptions = {
   connector: {
@@ -30,8 +32,39 @@ const defaultOptions = {
       from: '"Nuxt Users Module" <noreply@example.com>'
     }
   },
-  passwordResetBaseUrl: "http://localhost:3000"
+  passwordResetBaseUrl: "http://localhost:3000",
   // Added
+  // Add option to disable database checks during setup
+  skipDatabaseChecks: false
+};
+const runWithTimeout = async (operation, timeoutMs = 5e3) => {
+  return Promise.race([
+    operation(),
+    new Promise((resolve) => {
+      setTimeout(() => {
+        console.warn("[Nuxt Users DB] \u26A0\uFE0F  Database operation timed out after", timeoutMs, "ms");
+        resolve(null);
+      }, timeoutMs);
+    })
+  ]);
+};
+const ensureSqliteDatabaseExists = async (options) => {
+  if (options.connector?.name === "sqlite" && options.connector.options.path) {
+    const dbPath = options.connector.options.path;
+    try {
+      await promises.access(dbPath);
+      console.log(`[Nuxt Users DB] \u2139\uFE0F  SQLite database exists: ${dbPath}`);
+    } catch {
+      try {
+        const dbDir = dirname(dbPath);
+        await promises.mkdir(dbDir, { recursive: true });
+        console.log(`[Nuxt Users DB] \u2139\uFE0F  Created SQLite database directory: ${dbDir}`);
+        console.log(`[Nuxt Users DB] \u2139\uFE0F  SQLite database will be created at: ${dbPath}`);
+      } catch (error) {
+        console.warn(`[Nuxt Users DB] \u26A0\uFE0F  Failed to create database directory: ${error instanceof Error ? error.message : "Unknown error"}`);
+      }
+    }
+  }
 };
 const module = defineNuxtModule({
   meta: {
@@ -42,29 +75,20 @@ const module = defineNuxtModule({
   defaults: defaultOptions,
   async setup(options, nuxt) {
     const resolver = createResolver(import.meta.url);
-    const appliedMigrations = await getAppliedMigrations(options);
-    const requiredMigrations = [
-      "create_migrations_table",
-      "create_users_table",
-      "create_personal_access_tokens_table",
-      "create_password_reset_tokens_table"
-    ];
-    const missingMigrations = requiredMigrations.filter((migration) => !appliedMigrations.includes(migration));
-    if (missingMigrations.length > 0) {
-      console.warn(`[Nuxt Users DB] \u26A0\uFE0F  Missing migrations: ${missingMigrations.join(", ")}`);
-      console.warn("[Nuxt Users DB] \u26A0\uFE0F  Run migrations with: npx nuxt-users-migrate");
-    }
-    const hasUsersTable = await checkUsersTableExists(options);
-    if (!hasUsersTable) {
-      console.warn("[Nuxt Users DB] \u26A0\uFE0F  Users table does not exist, you should run the migration script to create it by running: npx nuxt-users-migrate");
-    }
-    const hasPersonalAccessTokensTable = await checkPersonalAccessTokensTableExists(options);
-    if (!hasPersonalAccessTokensTable) {
-      console.warn("[Nuxt Users DB] \u26A0\uFE0F  Personal access tokens table does not exist, you should run the migration script to create it by running: npx nuxt-users-migrate");
-    }
-    const hasPasswordResetTokensTable = await checkPasswordResetTokensTableExists(options);
-    if (!hasPasswordResetTokensTable) {
-      console.warn("[Nuxt Users DB] \u26A0\uFE0F  Password reset tokens table does not exist, you should run the migration script to create it by running: npx nuxt-users-migrate");
+    await ensureSqliteDatabaseExists(options);
+    if (!options.skipDatabaseChecks) {
+      const appliedMigrations = await runWithTimeout(() => getAppliedMigrations(options)) || [];
+      const requiredMigrations = [
+        "create_migrations_table",
+        "create_users_table",
+        "create_personal_access_tokens_table",
+        "create_password_reset_tokens_table"
+      ];
+      const missingMigrations = requiredMigrations.filter((migration) => !appliedMigrations.includes(migration));
+      if (missingMigrations.length > 0) {
+        console.warn(`[Nuxt Users DB] \u26A0\uFE0F  Missing migrations: ${missingMigrations.join(", ")}`);
+        console.warn("[Nuxt Users DB] \u26A0\uFE0F  Run migrations with: npx nuxt-users-migrate");
+      }
     }
     const runtimeConfigOptions = defu(options, nuxt.options.runtimeConfig.nuxtUsers || {}, defaultOptions);
     nuxt.options.runtimeConfig.nuxtUsers = {
@@ -75,19 +99,37 @@ const module = defineNuxtModule({
         passwordResetTokens: options.tables?.passwordResetTokens || "password_reset_tokens"
       }
     };
+    let hasUsersTable = false;
+    let hasPersonalAccessTokensTable = false;
+    let hasPasswordResetTokensTable = false;
+    if (!options.skipDatabaseChecks) {
+      hasUsersTable = await runWithTimeout(() => checkUsersTableExists(options)) || false;
+      if (!hasUsersTable) {
+        console.warn("[Nuxt Users DB] \u26A0\uFE0F  Users table does not exist, you should run the migration script to create it by running: npx nuxt-users-migrate");
+      }
+      hasPersonalAccessTokensTable = await runWithTimeout(() => checkPersonalAccessTokensTableExists(options)) || false;
+      if (!hasPersonalAccessTokensTable) {
+        console.warn("[Nuxt Users DB] \u26A0\uFE0F  Personal access tokens table does not exist, you should run the migration script to create it by running: npx nuxt-users-migrate");
+      }
+      hasPasswordResetTokensTable = await runWithTimeout(() => checkPasswordResetTokensTableExists(options)) || false;
+      if (!hasPasswordResetTokensTable) {
+        console.warn("[Nuxt Users DB] \u26A0\uFE0F  Password reset tokens table does not exist, you should run the migration script to create it by running: npx nuxt-users-migrate");
+      }
+      const hasUsers = await runWithTimeout(() => hasAnyUsers(options)) || false;
+      if (!hasUsers) {
+        console.warn('[Nuxt Users DB] \u26A0\uFE0F  No users found! Create a default user by running: npx nuxt-users-create-user rrd@example.com "John Doe" mypassword123');
+      }
+    } else {
+      console.log("[Nuxt Users DB] \u2139\uFE0F  Skipping database checks during setup");
+    }
     nuxt.options.runtimeConfig.public = nuxt.options.runtimeConfig.public || {};
     nuxt.options.runtimeConfig.public.nuxtUsers = {
       tables: {
         users: hasUsersTable,
         personalAccessTokens: hasPersonalAccessTokensTable,
         passwordResetTokens: hasPasswordResetTokensTable
-        // Use stored value
       }
     };
-    const hasUsers = await hasAnyUsers(options);
-    if (!hasUsers) {
-      console.warn('[Nuxt Users DB] \u26A0\uFE0F  No users found! Create a default user by running: npx nuxt-users-create-user rrd@example.com "John Doe" mypassword123');
-    }
     addServerHandler({
       route: "/api/login",
       method: "post",

package/dist/runtime/server/utils/db.js

@@ -18,7 +18,19 @@ export const useDb = async (options) => {
   if (connectorName !== "sqlite") {
     delete connectorOptions.path;
   }
-  return createDatabase(connector(connectorOptions));
+  if (connectorName === "mysql") {
+    connectorOptions.connectTimeout = 5e3;
+    connectorOptions.acquireTimeout = 5e3;
+  }
+  if (connectorName === "postgresql") {
+    connectorOptions.connectionTimeoutMillis = 5e3;
+  }
+  try {
+    return createDatabase(connector(connectorOptions));
+  } catch (error) {
+    console.warn(`[Nuxt Users DB] \u26A0\uFE0F  Failed to connect to ${connectorName} database:`, error instanceof Error ? error.message : "Unknown error");
+    throw error;
+  }
 };
 export const checkPasswordResetTokensTableExists = async (options) => {
   return await checkTableExists(options, options.tables.passwordResetTokens);
@@ -30,8 +42,8 @@ export const checkPersonalAccessTokensTableExists = async (options) => {
   return await checkTableExists(options, options.tables.personalAccessTokens);
 };
 export const checkTableExists = async (options, tableName) => {
-  const db = await useDb(options);
   try {
+    const db = await useDb(options);
     await db.sql`SELECT 1 FROM {${tableName}} LIMIT 1`;
     return true;
   } catch {
@@ -39,8 +51,8 @@ export const checkTableExists = async (options, tableName) => {
   }
 };
 export const hasAnyUsers = async (options) => {
-  const db = await useDb(options);
   try {
+    const db = await useDb(options);
     const users = await db.sql`SELECT COUNT(*) as count FROM {${options.tables.users}}`;
     return users.rows?.[0]?.count > 0;
   } catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nuxt-users",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "Nuxt users module",
   "repository": "rrd108/nuxt-users",
   "license": "MIT",
@@ -21,13 +21,14 @@
   },
   "files": [
     "dist",
-    "src/cli"
+    "src/cli",
+    "data"
   ],
   "bin": {
     "nuxt-users": "./src/cli/main.ts"
   },
   "scripts": {
-    "prepack": "nuxt-module-build build",
+    "prepack": "npm run db:create-empty-sqlite && nuxt-module-build build",
     "predev": "node -v | grep -q 'v22' || (echo 'Please use Node.js v22 for deployment' && exit 1)",
     "dev": "npm run dev:prepare && nuxi dev playground",
     "dev:build": "nuxi build playground",
@@ -49,6 +50,7 @@
     "db:create-password-reset-tokens-table": "tsx src/cli/create-password-reset-tokens-table.ts",
     "db:create-migrations-table": "tsx src/cli/create-migrations-table.ts",
     "db:migrate": "tsx src/cli/migrate.ts",
+    "db:create-empty-sqlite": "node scripts/create-empty-sqlite.js",
     "docs:dev": "vitepress dev docs",
     "docs:build": "vitepress build docs",
     "docs:preview": "vitepress preview docs",