prisma-flare 1.1.0 → 1.1.1

package/dist/cli/db-migrate.cjs

@@ -86,7 +86,7 @@ function parseRelations(schemaContent, models) {
       if (fieldMatch) {
         const fieldName = fieldMatch[1];
         const fieldType = fieldMatch[2];
-        const isArray = !!fieldMatch[3];
+        const _isArray = !!fieldMatch[3];
         if (models.includes(fieldType)) {
           const modelRelations = relations.get(modelName) || [];
           modelRelations.push({ fieldName, targetModel: fieldType });
@@ -188,7 +188,7 @@ export default class ${model} extends FlareBuilder<'${modelCamel}'> {
     registrationLines.push(`modelRegistry.register('${modelCamel}', ${model});`);
     registrationLines.push(`modelRegistry.register('${modelPlural}', ${model});`);
   });
-  relations.forEach((rels, modelName) => {
+  relations.forEach((rels, _modelName) => {
     rels.forEach((rel) => {
       registrationLines.push(`modelRegistry.register('${rel.fieldName}', ${rel.targetModel});`);
     });
@@ -255,7 +255,7 @@ exports.DB = DB;
     relationMapEntries.push(`    ${modelCamel}: ${model};`);
     relationMapEntries.push(`    ${modelPlural}: ${model};`);
   });
-  relations.forEach((rels, modelName) => {
+  relations.forEach((rels, _modelName) => {
     rels.forEach((rel) => {
       const entry = `    ${rel.fieldName}: ${rel.targetModel};`;
       if (!relationMapEntries.includes(entry)) {

package/dist/cli/db-migrate.js

@@ -63,7 +63,7 @@ function parseRelations(schemaContent, models) {
       if (fieldMatch) {
         const fieldName = fieldMatch[1];
         const fieldType = fieldMatch[2];
-        const isArray = !!fieldMatch[3];
+        const _isArray = !!fieldMatch[3];
         if (models.includes(fieldType)) {
           const modelRelations = relations.get(modelName) || [];
           modelRelations.push({ fieldName, targetModel: fieldType });
@@ -165,7 +165,7 @@ export default class ${model} extends FlareBuilder<'${modelCamel}'> {
     registrationLines.push(`modelRegistry.register('${modelCamel}', ${model});`);
     registrationLines.push(`modelRegistry.register('${modelPlural}', ${model});`);
   });
-  relations.forEach((rels, modelName) => {
+  relations.forEach((rels, _modelName) => {
     rels.forEach((rel) => {
       registrationLines.push(`modelRegistry.register('${rel.fieldName}', ${rel.targetModel});`);
     });
@@ -232,7 +232,7 @@ exports.DB = DB;
     relationMapEntries.push(`    ${modelCamel}: ${model};`);
     relationMapEntries.push(`    ${modelPlural}: ${model};`);
   });
-  relations.forEach((rels, modelName) => {
+  relations.forEach((rels, _modelName) => {
     rels.forEach((rel) => {
       const entry = `    ${rel.fieldName}: ${rel.targetModel};`;
       if (!relationMapEntries.includes(entry)) {

package/dist/cli/index.cjs

@@ -83,7 +83,7 @@ function parseRelations(schemaContent, models) {
       if (fieldMatch) {
         const fieldName = fieldMatch[1];
         const fieldType = fieldMatch[2];
-        const isArray = !!fieldMatch[3];
+        const _isArray = !!fieldMatch[3];
         if (models.includes(fieldType)) {
           const modelRelations = relations.get(modelName) || [];
           modelRelations.push({ fieldName, targetModel: fieldType });
@@ -185,7 +185,7 @@ export default class ${model} extends FlareBuilder<'${modelCamel}'> {
     registrationLines.push(`modelRegistry.register('${modelCamel}', ${model});`);
     registrationLines.push(`modelRegistry.register('${modelPlural}', ${model});`);
   });
-  relations.forEach((rels, modelName) => {
+  relations.forEach((rels, _modelName) => {
     rels.forEach((rel) => {
       registrationLines.push(`modelRegistry.register('${rel.fieldName}', ${rel.targetModel});`);
     });
@@ -252,7 +252,7 @@ exports.DB = DB;
     relationMapEntries.push(`    ${modelCamel}: ${model};`);
     relationMapEntries.push(`    ${modelPlural}: ${model};`);
   });
-  relations.forEach((rels, modelName) => {
+  relations.forEach((rels, _modelName) => {
     rels.forEach((rel) => {
       const entry = `    ${rel.fieldName}: ${rel.targetModel};`;
       if (!relationMapEntries.includes(entry)) {
@@ -283,15 +283,52 @@ ${gettersTypes}
   fs2.writeFileSync(generatedDtsPath, generatedDtsContent);
 }
 
+// src/cli/generate-callbacks.ts
+var fs3 = __toESM(require("fs"), 1);
+var path3 = __toESM(require("path"), 1);
+function generateCallbacksIndex() {
+  const rootDir = findProjectRoot(process.cwd());
+  const config = loadConfig(rootDir);
+  const callbacksDir = path3.join(rootDir, config.callbacksPath);
+  if (!fs3.existsSync(callbacksDir)) {
+    console.log(`\u2139\uFE0F  Callbacks directory not found: ${callbacksDir}`);
+    return;
+  }
+  const files = fs3.readdirSync(callbacksDir);
+  const callbackFiles = files.filter((file) => {
+    if (file === "index.ts" || file === "index.js" || file.startsWith(".")) {
+      return false;
+    }
+    return file.endsWith(".ts") || file.endsWith(".js");
+  });
+  if (callbackFiles.length === 0) {
+    console.log(`\u2139\uFE0F  No callback files found in: ${callbacksDir}`);
+    return;
+  }
+  const imports = callbackFiles.map((file) => {
+    const basename = file.replace(/\.(ts|js)$/, "");
+    return `import './${basename}';`;
+  }).join("\n");
+  const content = `// AUTO-GENERATED by prisma-flare - DO NOT EDIT
+// This file imports all callbacks to ensure they are registered.
+// Re-run 'npx prisma-flare generate' after adding new callback files.
+
+${imports}
+`;
+  const indexPath = path3.join(callbacksDir, "index.ts");
+  fs3.writeFileSync(indexPath, content);
+  console.log(`\u2705 Generated callbacks index: ${callbacksDir}/index.ts (${callbackFiles.length} callbacks)`);
+}
+
 // src/cli/index.ts
 var import_child_process = require("child_process");
-var path3 = __toESM(require("path"), 1);
-var fs3 = __toESM(require("fs"), 1);
+var path4 = __toESM(require("path"), 1);
+var fs4 = __toESM(require("fs"), 1);
 var import_url = require("url");
 var import_meta = {};
 var getDirname = () => {
   try {
-    return path3.dirname((0, import_url.fileURLToPath)(import_meta.url));
+    return path4.dirname((0, import_url.fileURLToPath)(import_meta.url));
   } catch {
     return __dirname;
   }
@@ -313,6 +350,7 @@ if (!command) {
 switch (command) {
   case "generate":
     generateQueries();
+    generateCallbacksIndex();
     break;
   case "create":
   case "drop":
@@ -338,10 +376,10 @@ function runScript(scriptName) {
     console.error(`No script found for ${scriptName}`);
     return;
   }
-  let scriptPath = path3.join(__dirname_, file.replace(".ts", ".js"));
-  if (!fs3.existsSync(scriptPath)) {
-    const cliScriptPath = path3.join(__dirname_, "cli", file.replace(".ts", ".js"));
-    if (fs3.existsSync(cliScriptPath)) {
+  let scriptPath = path4.join(__dirname_, file.replace(".ts", ".js"));
+  if (!fs4.existsSync(scriptPath)) {
+    const cliScriptPath = path4.join(__dirname_, "cli", file.replace(".ts", ".js"));
+    if (fs4.existsSync(cliScriptPath)) {
       scriptPath = cliScriptPath;
     }
   }

package/dist/cli/index.js

@@ -60,7 +60,7 @@ function parseRelations(schemaContent, models) {
       if (fieldMatch) {
         const fieldName = fieldMatch[1];
         const fieldType = fieldMatch[2];
-        const isArray = !!fieldMatch[3];
+        const _isArray = !!fieldMatch[3];
         if (models.includes(fieldType)) {
           const modelRelations = relations.get(modelName) || [];
           modelRelations.push({ fieldName, targetModel: fieldType });
@@ -162,7 +162,7 @@ export default class ${model} extends FlareBuilder<'${modelCamel}'> {
     registrationLines.push(`modelRegistry.register('${modelCamel}', ${model});`);
     registrationLines.push(`modelRegistry.register('${modelPlural}', ${model});`);
   });
-  relations.forEach((rels, modelName) => {
+  relations.forEach((rels, _modelName) => {
     rels.forEach((rel) => {
       registrationLines.push(`modelRegistry.register('${rel.fieldName}', ${rel.targetModel});`);
     });
@@ -229,7 +229,7 @@ exports.DB = DB;
     relationMapEntries.push(`    ${modelCamel}: ${model};`);
     relationMapEntries.push(`    ${modelPlural}: ${model};`);
   });
-  relations.forEach((rels, modelName) => {
+  relations.forEach((rels, _modelName) => {
     rels.forEach((rel) => {
       const entry = `    ${rel.fieldName}: ${rel.targetModel};`;
       if (!relationMapEntries.includes(entry)) {
@@ -260,14 +260,51 @@ ${gettersTypes}
   fs2.writeFileSync(generatedDtsPath, generatedDtsContent);
 }
 
+// src/cli/generate-callbacks.ts
+import * as fs3 from "fs";
+import * as path3 from "path";
+function generateCallbacksIndex() {
+  const rootDir = findProjectRoot(process.cwd());
+  const config = loadConfig(rootDir);
+  const callbacksDir = path3.join(rootDir, config.callbacksPath);
+  if (!fs3.existsSync(callbacksDir)) {
+    console.log(`\u2139\uFE0F  Callbacks directory not found: ${callbacksDir}`);
+    return;
+  }
+  const files = fs3.readdirSync(callbacksDir);
+  const callbackFiles = files.filter((file) => {
+    if (file === "index.ts" || file === "index.js" || file.startsWith(".")) {
+      return false;
+    }
+    return file.endsWith(".ts") || file.endsWith(".js");
+  });
+  if (callbackFiles.length === 0) {
+    console.log(`\u2139\uFE0F  No callback files found in: ${callbacksDir}`);
+    return;
+  }
+  const imports = callbackFiles.map((file) => {
+    const basename = file.replace(/\.(ts|js)$/, "");
+    return `import './${basename}';`;
+  }).join("\n");
+  const content = `// AUTO-GENERATED by prisma-flare - DO NOT EDIT
+// This file imports all callbacks to ensure they are registered.
+// Re-run 'npx prisma-flare generate' after adding new callback files.
+
+${imports}
+`;
+  const indexPath = path3.join(callbacksDir, "index.ts");
+  fs3.writeFileSync(indexPath, content);
+  console.log(`\u2705 Generated callbacks index: ${callbacksDir}/index.ts (${callbackFiles.length} callbacks)`);
+}
+
 // src/cli/index.ts
 import { spawn } from "child_process";
-import * as path3 from "path";
-import * as fs3 from "fs";
+import * as path4 from "path";
+import * as fs4 from "fs";
 import { fileURLToPath } from "url";
 var getDirname = () => {
   try {
-    return path3.dirname(fileURLToPath(import.meta.url));
+    return path4.dirname(fileURLToPath(import.meta.url));
   } catch {
     return __dirname;
   }
@@ -289,6 +326,7 @@ if (!command) {
 switch (command) {
   case "generate":
     generateQueries();
+    generateCallbacksIndex();
     break;
   case "create":
   case "drop":
@@ -314,10 +352,10 @@ function runScript(scriptName) {
     console.error(`No script found for ${scriptName}`);
     return;
   }
-  let scriptPath = path3.join(__dirname_, file.replace(".ts", ".js"));
-  if (!fs3.existsSync(scriptPath)) {
-    const cliScriptPath = path3.join(__dirname_, "cli", file.replace(".ts", ".js"));
-    if (fs3.existsSync(cliScriptPath)) {
+  let scriptPath = path4.join(__dirname_, file.replace(".ts", ".js"));
+  if (!fs4.existsSync(scriptPath)) {
+    const cliScriptPath = path4.join(__dirname_, "cli", file.replace(".ts", ".js"));
+    if (fs4.existsSync(cliScriptPath)) {
       scriptPath = cliScriptPath;
     }
   }

package/dist/core/flareBuilder.d.cts

@@ -20,12 +20,12 @@ interface RelationModelMap {
 /**
  * Helper type to get the model class for a relation name
  */
-type GetRelationModel<K extends string> = K extends keyof RelationModelMap ? RelationModelMap[K] : FlareBuilder<any, {}>;
+type GetRelationModel<K extends string> = K extends keyof RelationModelMap ? RelationModelMap[K] : FlareBuilder<any, Record<string, never>>;
 /**
  * FlareBuilder for chainable Prisma queries with full type safety
  * The type safety is enforced through the ModelDelegate parameter
  */
-declare class FlareBuilder<T extends ModelName, Args extends Record<string, any> = {}> {
+declare class FlareBuilder<T extends ModelName, Args extends Record<string, any> = Record<string, never>> {
     protected model: ModelDelegate<T>;
     protected query: QueryArgs;
     constructor(model: ModelDelegate<T>, query?: QueryArgs);
@@ -122,7 +122,7 @@ declare class FlareBuilder<T extends ModelName, Args extends Record<string, any>
      *   , 'OR')
      *   .findMany()
      */
-    whereGroup(callback: (builder: FlareBuilder<T, {}>) => FlareBuilder<T, any>, mode?: 'AND' | 'OR'): FlareBuilder<T, Args & {
+    whereGroup(callback: (builder: FlareBuilder<T, Record<string, never>>) => FlareBuilder<T, any>, mode?: 'AND' | 'OR'): FlareBuilder<T, Args & {
         where: WhereInput<T>;
     }>;
     /**
@@ -141,7 +141,7 @@ declare class FlareBuilder<T extends ModelName, Args extends Record<string, any>
      *   )
      *   .findMany()
      */
-    orWhereGroup(callback: (builder: FlareBuilder<T, {}>) => FlareBuilder<T, any>): FlareBuilder<T, Args & {
+    orWhereGroup(callback: (builder: FlareBuilder<T, Record<string, never>>) => FlareBuilder<T, any>): FlareBuilder<T, Args & {
         where: WhereInput<T>;
     }>;
     /**

package/dist/core/flareBuilder.d.ts

@@ -20,12 +20,12 @@ interface RelationModelMap {
 /**
  * Helper type to get the model class for a relation name
  */
-type GetRelationModel<K extends string> = K extends keyof RelationModelMap ? RelationModelMap[K] : FlareBuilder<any, {}>;
+type GetRelationModel<K extends string> = K extends keyof RelationModelMap ? RelationModelMap[K] : FlareBuilder<any, Record<string, never>>;
 /**
  * FlareBuilder for chainable Prisma queries with full type safety
  * The type safety is enforced through the ModelDelegate parameter
  */
-declare class FlareBuilder<T extends ModelName, Args extends Record<string, any> = {}> {
+declare class FlareBuilder<T extends ModelName, Args extends Record<string, any> = Record<string, never>> {
     protected model: ModelDelegate<T>;
     protected query: QueryArgs;
     constructor(model: ModelDelegate<T>, query?: QueryArgs);
@@ -122,7 +122,7 @@ declare class FlareBuilder<T extends ModelName, Args extends Record<string, any>
      *   , 'OR')
      *   .findMany()
      */
-    whereGroup(callback: (builder: FlareBuilder<T, {}>) => FlareBuilder<T, any>, mode?: 'AND' | 'OR'): FlareBuilder<T, Args & {
+    whereGroup(callback: (builder: FlareBuilder<T, Record<string, never>>) => FlareBuilder<T, any>, mode?: 'AND' | 'OR'): FlareBuilder<T, Args & {
         where: WhereInput<T>;
     }>;
     /**
@@ -141,7 +141,7 @@ declare class FlareBuilder<T extends ModelName, Args extends Record<string, any>
      *   )
      *   .findMany()
      */
-    orWhereGroup(callback: (builder: FlareBuilder<T, {}>) => FlareBuilder<T, any>): FlareBuilder<T, Args & {
+    orWhereGroup(callback: (builder: FlareBuilder<T, Record<string, never>>) => FlareBuilder<T, any>): FlareBuilder<T, Args & {
         where: WhereInput<T>;
     }>;
     /**

package/dist/index.cjs

@@ -52,7 +52,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/core/extendedPrismaClient.ts
-var import_client = require("@prisma/client");
+var import_client2 = require("@prisma/client");
 
 // src/core/modelRegistry.ts
 var ModelRegistry = class {
@@ -710,53 +710,6 @@ var FlareBuilder = class _FlareBuilder {
   }
 };
 
-// src/core/extendedPrismaClient.ts
-var FlareClient = class extends import_client.PrismaClient {
-  constructor(options = {}) {
-    super(options);
-  }
-  /**
-   * Creates a new FlareBuilder instance for the specified model.
-   * @param modelName - The name of the model.
-   * @returns FlareBuilder instance
-   */
-  from(modelName) {
-    const key = modelName.charAt(0).toLowerCase() + modelName.slice(1);
-    const model = this[key];
-    if (!model) {
-      throw new Error(`Model ${modelName} does not exist on PrismaClient.`);
-    }
-    return new FlareBuilder(model);
-  }
-  /**
-   * Executes a transaction with the FlareClient capabilities.
-   * @param fn - The transaction function.
-   * @param options - Transaction options.
-   * @returns The result of the transaction.
-   */
-  async transaction(fn, options) {
-    return super.$transaction(async (tx) => {
-      const extendedTx = new Proxy(tx, {
-        get: (target, prop, receiver) => {
-          if (prop === "from") {
-            return (modelName) => {
-              const key = modelName.charAt(0).toLowerCase() + modelName.slice(1);
-              const model = target[key];
-              if (!model) {
-                throw new Error(`Model ${modelName} does not exist on TransactionClient.`);
-              }
-              return new FlareBuilder(model);
-            };
-          }
-          return Reflect.get(target, prop, receiver);
-        }
-      });
-      return fn(extendedTx);
-    }, options);
-  }
-};
-var ExtendedPrismaClient = FlareClient;
-
 // src/core/hookRegistry.ts
 function valuesEqual(a, b) {
   if (a == null && b == null) return true;
@@ -928,74 +881,8 @@ var HookRegistry = class {
 var hookRegistry = new HookRegistry();
 var hookRegistry_default = hookRegistry;
 
-// src/core/hooks.ts
-function normalizeModelName(model) {
-  return model.toLowerCase();
-}
-function beforeCreate(model, callback) {
-  hookRegistry_default.addHook(normalizeModelName(model), "create", "before", callback);
-}
-function beforeDelete(model, callback) {
-  hookRegistry_default.addHook(normalizeModelName(model), "delete", "before", callback);
-}
-function afterCreate(model, callback) {
-  hookRegistry_default.addHook(normalizeModelName(model), "create", "after", callback);
-}
-function afterDelete(model, callback) {
-  hookRegistry_default.addHook(normalizeModelName(model), "delete", "after", callback);
-}
-function beforeUpdate(model, callback) {
-  hookRegistry_default.addHook(normalizeModelName(model), "update", "before", callback);
-}
-function afterUpdate(model, callback) {
-  hookRegistry_default.addHook(normalizeModelName(model), "update", "after", callback);
-}
-function afterChange(model, column, callback) {
-  hookRegistry_default.addColumnHook(normalizeModelName(model), column, callback);
-}
-function afterUpsert(model, callback) {
-  hookRegistry_default.addHook(normalizeModelName(model), "upsert", "after", callback);
-}
-
-// src/core/hookMiddleware.ts
-var import_client2 = require("@prisma/client");
-
-// src/cli/config.ts
-var fs = __toESM(require("fs"), 1);
-var path = __toESM(require("path"), 1);
-function findProjectRoot(currentDir) {
-  if (fs.existsSync(path.join(currentDir, "package.json"))) {
-    return currentDir;
-  }
-  const parentDir = path.dirname(currentDir);
-  if (parentDir === currentDir) {
-    throw new Error("Could not find package.json");
-  }
-  return findProjectRoot(parentDir);
-}
-function loadConfig(rootDir) {
-  const projectRoot = rootDir || findProjectRoot(process.cwd());
-  const configPath = path.join(projectRoot, "prisma-flare.config.json");
-  let config = {
-    modelsPath: "prisma/models",
-    dbPath: "prisma/db",
-    callbacksPath: "prisma/callbacks"
-  };
-  if (fs.existsSync(configPath)) {
-    try {
-      const configFile = fs.readFileSync(configPath, "utf-8");
-      const userConfig = JSON.parse(configFile);
-      config = { ...config, ...userConfig };
-    } catch {
-      console.warn("\u26A0\uFE0F Could not read prisma-flare.config.json, using defaults.");
-    }
-  }
-  return {
-    ...config
-  };
-}
-
 // src/core/hookMiddleware.ts
+var import_client = require("@prisma/client");
 var import_fs = __toESM(require("fs"), 1);
 var import_path = __toESM(require("path"), 1);
 function supportsTypeScriptImports() {
@@ -1094,7 +981,7 @@ function supportsPrisma6Middleware(prisma) {
   return typeof prisma.$use === "function";
 }
 function createHooksExtension(basePrisma) {
-  return import_client2.Prisma.defineExtension({
+  return import_client.Prisma.defineExtension({
     name: "prisma-flare-hooks",
     query: {
       $allModels: {
@@ -1117,23 +1004,102 @@ function registerHooksLegacy(prisma) {
     return executeHookLogic(prisma, model, action, args, () => next(params));
   });
 }
-async function registerHooks(prisma) {
-  let client;
+function registerHooks(prisma) {
   if (supportsPrisma6Middleware(prisma)) {
     registerHooksLegacy(prisma);
-    client = prisma;
+    return prisma;
   } else {
     const extension = createHooksExtension(prisma);
-    client = prisma.$extends(extension);
+    return prisma.$extends(extension);
+  }
+}
+
+// src/core/extendedPrismaClient.ts
+function supportsPrisma6Middleware2(prisma) {
+  return typeof prisma.$use === "function";
+}
+var FlareClient = class extends import_client2.PrismaClient {
+  constructor(options = {}) {
+    const { callbacks = true, ...prismaOptions } = options;
+    super(prismaOptions);
+    if (callbacks) {
+      if (supportsPrisma6Middleware2(this)) {
+        registerHooksLegacy(this);
+      } else {
+        const extension = createHooksExtension(this);
+        return this.$extends(extension);
+      }
+    }
+  }
+  /**
+   * Creates a new FlareBuilder instance for the specified model.
+   * @param modelName - The name of the model.
+   * @returns FlareBuilder instance
+   */
+  from(modelName) {
+    const key = modelName.charAt(0).toLowerCase() + modelName.slice(1);
+    const model = this[key];
+    if (!model) {
+      throw new Error(`Model ${modelName} does not exist on PrismaClient.`);
+    }
+    return new FlareBuilder(model);
   }
-  try {
-    const config = loadConfig();
-    const projectRoot = findProjectRoot(process.cwd());
-    const callbacksPath = import_path.default.join(projectRoot, config.callbacksPath);
-    await loadCallbacks(callbacksPath);
-  } catch {
+  /**
+   * Executes a transaction with the FlareClient capabilities.
+   * @param fn - The transaction function.
+   * @param options - Transaction options.
+   * @returns The result of the transaction.
+   */
+  async transaction(fn, options) {
+    return super.$transaction(async (tx) => {
+      const extendedTx = new Proxy(tx, {
+        get: (target, prop, receiver) => {
+          if (prop === "from") {
+            return (modelName) => {
+              const key = modelName.charAt(0).toLowerCase() + modelName.slice(1);
+              const model = target[key];
+              if (!model) {
+                throw new Error(`Model ${modelName} does not exist on TransactionClient.`);
+              }
+              return new FlareBuilder(model);
+            };
+          }
+          return Reflect.get(target, prop, receiver);
+        }
+      });
+      return fn(extendedTx);
+    }, options);
   }
-  return client;
+};
+var ExtendedPrismaClient = FlareClient;
+
+// src/core/hooks.ts
+function normalizeModelName(model) {
+  return model.toLowerCase();
+}
+function beforeCreate(model, callback) {
+  hookRegistry_default.addHook(normalizeModelName(model), "create", "before", callback);
+}
+function beforeDelete(model, callback) {
+  hookRegistry_default.addHook(normalizeModelName(model), "delete", "before", callback);
+}
+function afterCreate(model, callback) {
+  hookRegistry_default.addHook(normalizeModelName(model), "create", "after", callback);
+}
+function afterDelete(model, callback) {
+  hookRegistry_default.addHook(normalizeModelName(model), "delete", "after", callback);
+}
+function beforeUpdate(model, callback) {
+  hookRegistry_default.addHook(normalizeModelName(model), "update", "before", callback);
+}
+function afterUpdate(model, callback) {
+  hookRegistry_default.addHook(normalizeModelName(model), "update", "after", callback);
+}
+function afterChange(model, column, callback) {
+  hookRegistry_default.addColumnHook(normalizeModelName(model), column, callback);
+}
+function afterUpsert(model, callback) {
+  hookRegistry_default.addHook(normalizeModelName(model), "upsert", "after", callback);
 }
 
 // src/core/adapters/postgres.ts
@@ -1216,8 +1182,8 @@ function parseDatabaseUrl(url) {
 }
 
 // src/core/adapters/sqlite.ts
-var fs3 = __toESM(require("fs"), 1);
-var path3 = __toESM(require("path"), 1);
+var fs2 = __toESM(require("fs"), 1);
+var path2 = __toESM(require("path"), 1);
 var SqliteAdapter = {
   name: "sqlite",
   matches(url) {
@@ -1225,13 +1191,13 @@ var SqliteAdapter = {
   },
   async create(url) {
     const filePath = parseSqliteUrl(url);
-    const dir = path3.dirname(filePath);
+    const dir = path2.dirname(filePath);
     try {
-      if (!fs3.existsSync(dir)) {
-        fs3.mkdirSync(dir, { recursive: true });
+      if (!fs2.existsSync(dir)) {
+        fs2.mkdirSync(dir, { recursive: true });
       }
-      if (!fs3.existsSync(filePath)) {
-        fs3.writeFileSync(filePath, "");
+      if (!fs2.existsSync(filePath)) {
+        fs2.writeFileSync(filePath, "");
         console.log(`\u2705 SQLite database created at "${filePath}"`);
       } else {
         console.log(`\u26A0\uFE0F  SQLite database already exists at "${filePath}"`);
@@ -1244,20 +1210,20 @@ var SqliteAdapter = {
   async drop(url) {
     const filePath = parseSqliteUrl(url);
     try {
-      if (fs3.existsSync(filePath)) {
-        fs3.unlinkSync(filePath);
+      if (fs2.existsSync(filePath)) {
+        fs2.unlinkSync(filePath);
         console.log(`\u2705 SQLite database at "${filePath}" dropped successfully.`);
       } else {
         console.log(`\u26A0\uFE0F  SQLite database does not exist at "${filePath}"`);
       }
-      if (fs3.existsSync(`${filePath}-journal`)) {
-        fs3.unlinkSync(`${filePath}-journal`);
+      if (fs2.existsSync(`${filePath}-journal`)) {
+        fs2.unlinkSync(`${filePath}-journal`);
       }
-      if (fs3.existsSync(`${filePath}-wal`)) {
-        fs3.unlinkSync(`${filePath}-wal`);
+      if (fs2.existsSync(`${filePath}-wal`)) {
+        fs2.unlinkSync(`${filePath}-wal`);
       }
-      if (fs3.existsSync(`${filePath}-shm`)) {
-        fs3.unlinkSync(`${filePath}-shm`);
+      if (fs2.existsSync(`${filePath}-shm`)) {
+        fs2.unlinkSync(`${filePath}-shm`);
       }
     } catch (error) {
       console.error("\u274C Error dropping SQLite database:", error);
@@ -1267,8 +1233,8 @@ var SqliteAdapter = {
 };
 function parseSqliteUrl(url) {
   let cleanPath = url.replace(/^file:/, "");
-  if (!path3.isAbsolute(cleanPath)) {
-    cleanPath = path3.resolve(process.cwd(), cleanPath);
+  if (!path2.isAbsolute(cleanPath)) {
+    cleanPath = path2.resolve(process.cwd(), cleanPath);
   }
   return cleanPath;
 }

package/dist/index.d.cts

@@ -8,8 +8,18 @@ import { M as ModelName, l as PrismaOperation, m as HookTiming, B as BeforeHookC
 export { r as AggregateResult, o as CreateArgs, C as CreateData, p as CreateManyArgs, b as CreateManyData, c as DeleteArgs, n as FindFirstArgs, F as FindManyArgs, a as ModelDelegate, R as RecordType, q as UpdateArgs, f as UpsertArgs } from './prisma.types-nGNe1CG8.cjs';
 export { afterChange, afterCreate, afterDelete, afterUpdate, afterUpsert, beforeCreate, beforeDelete, beforeUpdate } from './core/hooks.cjs';
 
+interface FlareClientOptions extends PrismaClientOptions {
+    /**
+     * Enable callbacks/hooks middleware. When true (default), the middleware
+     * that executes your registered callbacks (beforeCreate, afterUpdate, etc.)
+     * is automatically attached.
+     *
+     * @default true
+     */
+    callbacks?: boolean;
+}
 declare class FlareClient extends PrismaClient {
-    constructor(options?: PrismaClientOptions);
+    constructor(options?: FlareClientOptions);
     /**
      * Creates a new FlareBuilder instance for the specified model.
      * @param modelName - The name of the model.
@@ -186,22 +196,21 @@ declare function createHooksExtension(basePrisma: PrismaClient): (client: any) =
  */
 declare function registerHooksLegacy(prisma: PrismaClient): void;
 /**
- * Registers hooks on the Prisma client and automatically loads callbacks.
- * Automatically detects Prisma version and uses the appropriate API:
- * - Prisma ≤6: Uses $use middleware
- * - Prisma 7+: Returns extended client with hooks extension
- *
- * Callbacks are loaded from the path specified in prisma-flare.config.json
- * (defaults to 'prisma/callbacks'). Set `callbacksPath` in config to customize.
- *
- * @param prisma - The Prisma client instance
- * @returns Promise resolving to the Prisma client (possibly extended for Prisma 7+)
+ * @deprecated Use `new FlareClient()` instead. FlareClient now automatically
+ * attaches the callbacks middleware. This function will be removed in a future version.
  *
  * @example
- * // In your db setup file:
- * export const db = await registerHooks(new FlareClient());
+ * // Old way (deprecated):
+ * import './callbacks';
+ * import { FlareClient, registerHooks } from 'prisma-flare';
+ * export const db = registerHooks(new FlareClient());
+ *
+ * // New way:
+ * import './callbacks';
+ * import { FlareClient } from 'prisma-flare';
+ * export const db = new FlareClient();
  */
-declare function registerHooks<T extends PrismaClient>(prisma: T): Promise<T>;
+declare function registerHooks<T extends PrismaClient>(prisma: T): T;
 
 /**
  * Database Adapter Interface
@@ -234,4 +243,4 @@ declare class AdapterRegistry {
 }
 declare const registry: AdapterRegistry;
 
-export { AfterHookCallback, BeforeHookCallback, ColumnChangeCallback, type DatabaseAdapter, ExtendedPrismaClient, FlareBuilder, FlareClient, type HookConfig, HookTiming, ModelName, PrismaOperation, createHooksExtension, registry as dbAdapterRegistry, hookRegistry, loadCallbacks, modelRegistry, registerHooks, registerHooksLegacy };
+export { AfterHookCallback, BeforeHookCallback, ColumnChangeCallback, type DatabaseAdapter, ExtendedPrismaClient, FlareBuilder, FlareClient, type FlareClientOptions, type HookConfig, HookTiming, ModelName, PrismaOperation, createHooksExtension, registry as dbAdapterRegistry, hookRegistry, loadCallbacks, modelRegistry, registerHooks, registerHooksLegacy };

package/dist/index.d.ts

@@ -8,8 +8,18 @@ import { M as ModelName, l as PrismaOperation, m as HookTiming, B as BeforeHookC
 export { r as AggregateResult, o as CreateArgs, C as CreateData, p as CreateManyArgs, b as CreateManyData, c as DeleteArgs, n as FindFirstArgs, F as FindManyArgs, a as ModelDelegate, R as RecordType, q as UpdateArgs, f as UpsertArgs } from './prisma.types-nGNe1CG8.js';
 export { afterChange, afterCreate, afterDelete, afterUpdate, afterUpsert, beforeCreate, beforeDelete, beforeUpdate } from './core/hooks.js';
 
+interface FlareClientOptions extends PrismaClientOptions {
+    /**
+     * Enable callbacks/hooks middleware. When true (default), the middleware
+     * that executes your registered callbacks (beforeCreate, afterUpdate, etc.)
+     * is automatically attached.
+     *
+     * @default true
+     */
+    callbacks?: boolean;
+}
 declare class FlareClient extends PrismaClient {
-    constructor(options?: PrismaClientOptions);
+    constructor(options?: FlareClientOptions);
     /**
      * Creates a new FlareBuilder instance for the specified model.
      * @param modelName - The name of the model.
@@ -186,22 +196,21 @@ declare function createHooksExtension(basePrisma: PrismaClient): (client: any) =
  */
 declare function registerHooksLegacy(prisma: PrismaClient): void;
 /**
- * Registers hooks on the Prisma client and automatically loads callbacks.
- * Automatically detects Prisma version and uses the appropriate API:
- * - Prisma ≤6: Uses $use middleware
- * - Prisma 7+: Returns extended client with hooks extension
- *
- * Callbacks are loaded from the path specified in prisma-flare.config.json
- * (defaults to 'prisma/callbacks'). Set `callbacksPath` in config to customize.
- *
- * @param prisma - The Prisma client instance
- * @returns Promise resolving to the Prisma client (possibly extended for Prisma 7+)
+ * @deprecated Use `new FlareClient()` instead. FlareClient now automatically
+ * attaches the callbacks middleware. This function will be removed in a future version.
  *
  * @example
- * // In your db setup file:
- * export const db = await registerHooks(new FlareClient());
+ * // Old way (deprecated):
+ * import './callbacks';
+ * import { FlareClient, registerHooks } from 'prisma-flare';
+ * export const db = registerHooks(new FlareClient());
+ *
+ * // New way:
+ * import './callbacks';
+ * import { FlareClient } from 'prisma-flare';
+ * export const db = new FlareClient();
  */
-declare function registerHooks<T extends PrismaClient>(prisma: T): Promise<T>;
+declare function registerHooks<T extends PrismaClient>(prisma: T): T;
 
 /**
  * Database Adapter Interface
@@ -234,4 +243,4 @@ declare class AdapterRegistry {
 }
 declare const registry: AdapterRegistry;
 
-export { AfterHookCallback, BeforeHookCallback, ColumnChangeCallback, type DatabaseAdapter, ExtendedPrismaClient, FlareBuilder, FlareClient, type HookConfig, HookTiming, ModelName, PrismaOperation, createHooksExtension, registry as dbAdapterRegistry, hookRegistry, loadCallbacks, modelRegistry, registerHooks, registerHooksLegacy };
+export { AfterHookCallback, BeforeHookCallback, ColumnChangeCallback, type DatabaseAdapter, ExtendedPrismaClient, FlareBuilder, FlareClient, type FlareClientOptions, type HookConfig, HookTiming, ModelName, PrismaOperation, createHooksExtension, registry as dbAdapterRegistry, hookRegistry, loadCallbacks, modelRegistry, registerHooks, registerHooksLegacy };

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/core/extendedPrismaClient.ts
-import { PrismaClient } from "@prisma/client";
+import { PrismaClient as PrismaClient2 } from "@prisma/client";
 
 // src/core/modelRegistry.ts
 var ModelRegistry = class {
@@ -657,53 +657,6 @@ var FlareBuilder = class _FlareBuilder {
   }
 };
 
-// src/core/extendedPrismaClient.ts
-var FlareClient = class extends PrismaClient {
-  constructor(options = {}) {
-    super(options);
-  }
-  /**
-   * Creates a new FlareBuilder instance for the specified model.
-   * @param modelName - The name of the model.
-   * @returns FlareBuilder instance
-   */
-  from(modelName) {
-    const key = modelName.charAt(0).toLowerCase() + modelName.slice(1);
-    const model = this[key];
-    if (!model) {
-      throw new Error(`Model ${modelName} does not exist on PrismaClient.`);
-    }
-    return new FlareBuilder(model);
-  }
-  /**
-   * Executes a transaction with the FlareClient capabilities.
-   * @param fn - The transaction function.
-   * @param options - Transaction options.
-   * @returns The result of the transaction.
-   */
-  async transaction(fn, options) {
-    return super.$transaction(async (tx) => {
-      const extendedTx = new Proxy(tx, {
-        get: (target, prop, receiver) => {
-          if (prop === "from") {
-            return (modelName) => {
-              const key = modelName.charAt(0).toLowerCase() + modelName.slice(1);
-              const model = target[key];
-              if (!model) {
-                throw new Error(`Model ${modelName} does not exist on TransactionClient.`);
-              }
-              return new FlareBuilder(model);
-            };
-          }
-          return Reflect.get(target, prop, receiver);
-        }
-      });
-      return fn(extendedTx);
-    }, options);
-  }
-};
-var ExtendedPrismaClient = FlareClient;
-
 // src/core/hookRegistry.ts
 function valuesEqual(a, b) {
   if (a == null && b == null) return true;
@@ -875,76 +828,10 @@ var HookRegistry = class {
 var hookRegistry = new HookRegistry();
 var hookRegistry_default = hookRegistry;
 
-// src/core/hooks.ts
-function normalizeModelName(model) {
-  return model.toLowerCase();
-}
-function beforeCreate(model, callback) {
-  hookRegistry_default.addHook(normalizeModelName(model), "create", "before", callback);
-}
-function beforeDelete(model, callback) {
-  hookRegistry_default.addHook(normalizeModelName(model), "delete", "before", callback);
-}
-function afterCreate(model, callback) {
-  hookRegistry_default.addHook(normalizeModelName(model), "create", "after", callback);
-}
-function afterDelete(model, callback) {
-  hookRegistry_default.addHook(normalizeModelName(model), "delete", "after", callback);
-}
-function beforeUpdate(model, callback) {
-  hookRegistry_default.addHook(normalizeModelName(model), "update", "before", callback);
-}
-function afterUpdate(model, callback) {
-  hookRegistry_default.addHook(normalizeModelName(model), "update", "after", callback);
-}
-function afterChange(model, column, callback) {
-  hookRegistry_default.addColumnHook(normalizeModelName(model), column, callback);
-}
-function afterUpsert(model, callback) {
-  hookRegistry_default.addHook(normalizeModelName(model), "upsert", "after", callback);
-}
-
 // src/core/hookMiddleware.ts
 import { Prisma } from "@prisma/client";
-
-// src/cli/config.ts
-import * as fs from "fs";
-import * as path from "path";
-function findProjectRoot(currentDir) {
-  if (fs.existsSync(path.join(currentDir, "package.json"))) {
-    return currentDir;
-  }
-  const parentDir = path.dirname(currentDir);
-  if (parentDir === currentDir) {
-    throw new Error("Could not find package.json");
-  }
-  return findProjectRoot(parentDir);
-}
-function loadConfig(rootDir) {
-  const projectRoot = rootDir || findProjectRoot(process.cwd());
-  const configPath = path.join(projectRoot, "prisma-flare.config.json");
-  let config = {
-    modelsPath: "prisma/models",
-    dbPath: "prisma/db",
-    callbacksPath: "prisma/callbacks"
-  };
-  if (fs.existsSync(configPath)) {
-    try {
-      const configFile = fs.readFileSync(configPath, "utf-8");
-      const userConfig = JSON.parse(configFile);
-      config = { ...config, ...userConfig };
-    } catch {
-      console.warn("\u26A0\uFE0F Could not read prisma-flare.config.json, using defaults.");
-    }
-  }
-  return {
-    ...config
-  };
-}
-
-// src/core/hookMiddleware.ts
-import fs2 from "fs";
-import path2 from "path";
+import fs from "fs";
+import path from "path";
 function supportsTypeScriptImports() {
   if (process.env.TS_NODE || /* @__PURE__ */ Symbol.for("ts-node.register.instance") in process) {
     return true;
@@ -962,16 +849,16 @@ function supportsTypeScriptImports() {
 }
 async function loadCallbacks(callbacksDir) {
   if (!callbacksDir) {
-    callbacksDir = path2.join(process.cwd(), "prisma", "callbacks");
+    callbacksDir = path.join(process.cwd(), "prisma", "callbacks");
   }
-  if (!fs2.existsSync(callbacksDir)) {
+  if (!fs.existsSync(callbacksDir)) {
     console.warn(`Callbacks directory not found: ${callbacksDir}`);
     return;
   }
   const canImportTs = supportsTypeScriptImports();
-  const files = fs2.readdirSync(callbacksDir);
+  const files = fs.readdirSync(callbacksDir);
   for (const file of files) {
-    const filePath = path2.join(callbacksDir, file);
+    const filePath = path.join(callbacksDir, file);
     if (file.endsWith(".js")) {
       await import(filePath);
     } else if (file.endsWith(".ts") && canImportTs) {
@@ -1064,23 +951,102 @@ function registerHooksLegacy(prisma) {
     return executeHookLogic(prisma, model, action, args, () => next(params));
   });
 }
-async function registerHooks(prisma) {
-  let client;
+function registerHooks(prisma) {
   if (supportsPrisma6Middleware(prisma)) {
     registerHooksLegacy(prisma);
-    client = prisma;
+    return prisma;
   } else {
     const extension = createHooksExtension(prisma);
-    client = prisma.$extends(extension);
+    return prisma.$extends(extension);
   }
-  try {
-    const config = loadConfig();
-    const projectRoot = findProjectRoot(process.cwd());
-    const callbacksPath = path2.join(projectRoot, config.callbacksPath);
-    await loadCallbacks(callbacksPath);
-  } catch {
+}
+
+// src/core/extendedPrismaClient.ts
+function supportsPrisma6Middleware2(prisma) {
+  return typeof prisma.$use === "function";
+}
+var FlareClient = class extends PrismaClient2 {
+  constructor(options = {}) {
+    const { callbacks = true, ...prismaOptions } = options;
+    super(prismaOptions);
+    if (callbacks) {
+      if (supportsPrisma6Middleware2(this)) {
+        registerHooksLegacy(this);
+      } else {
+        const extension = createHooksExtension(this);
+        return this.$extends(extension);
+      }
+    }
+  }
+  /**
+   * Creates a new FlareBuilder instance for the specified model.
+   * @param modelName - The name of the model.
+   * @returns FlareBuilder instance
+   */
+  from(modelName) {
+    const key = modelName.charAt(0).toLowerCase() + modelName.slice(1);
+    const model = this[key];
+    if (!model) {
+      throw new Error(`Model ${modelName} does not exist on PrismaClient.`);
+    }
+    return new FlareBuilder(model);
+  }
+  /**
+   * Executes a transaction with the FlareClient capabilities.
+   * @param fn - The transaction function.
+   * @param options - Transaction options.
+   * @returns The result of the transaction.
+   */
+  async transaction(fn, options) {
+    return super.$transaction(async (tx) => {
+      const extendedTx = new Proxy(tx, {
+        get: (target, prop, receiver) => {
+          if (prop === "from") {
+            return (modelName) => {
+              const key = modelName.charAt(0).toLowerCase() + modelName.slice(1);
+              const model = target[key];
+              if (!model) {
+                throw new Error(`Model ${modelName} does not exist on TransactionClient.`);
+              }
+              return new FlareBuilder(model);
+            };
+          }
+          return Reflect.get(target, prop, receiver);
+        }
+      });
+      return fn(extendedTx);
+    }, options);
   }
-  return client;
+};
+var ExtendedPrismaClient = FlareClient;
+
+// src/core/hooks.ts
+function normalizeModelName(model) {
+  return model.toLowerCase();
+}
+function beforeCreate(model, callback) {
+  hookRegistry_default.addHook(normalizeModelName(model), "create", "before", callback);
+}
+function beforeDelete(model, callback) {
+  hookRegistry_default.addHook(normalizeModelName(model), "delete", "before", callback);
+}
+function afterCreate(model, callback) {
+  hookRegistry_default.addHook(normalizeModelName(model), "create", "after", callback);
+}
+function afterDelete(model, callback) {
+  hookRegistry_default.addHook(normalizeModelName(model), "delete", "after", callback);
+}
+function beforeUpdate(model, callback) {
+  hookRegistry_default.addHook(normalizeModelName(model), "update", "before", callback);
+}
+function afterUpdate(model, callback) {
+  hookRegistry_default.addHook(normalizeModelName(model), "update", "after", callback);
+}
+function afterChange(model, column, callback) {
+  hookRegistry_default.addColumnHook(normalizeModelName(model), column, callback);
+}
+function afterUpsert(model, callback) {
+  hookRegistry_default.addHook(normalizeModelName(model), "upsert", "after", callback);
 }
 
 // src/core/adapters/postgres.ts
@@ -1163,8 +1129,8 @@ function parseDatabaseUrl(url) {
 }
 
 // src/core/adapters/sqlite.ts
-import * as fs3 from "fs";
-import * as path3 from "path";
+import * as fs2 from "fs";
+import * as path2 from "path";
 var SqliteAdapter = {
   name: "sqlite",
   matches(url) {
@@ -1172,13 +1138,13 @@ var SqliteAdapter = {
   },
   async create(url) {
     const filePath = parseSqliteUrl(url);
-    const dir = path3.dirname(filePath);
+    const dir = path2.dirname(filePath);
     try {
-      if (!fs3.existsSync(dir)) {
-        fs3.mkdirSync(dir, { recursive: true });
+      if (!fs2.existsSync(dir)) {
+        fs2.mkdirSync(dir, { recursive: true });
       }
-      if (!fs3.existsSync(filePath)) {
-        fs3.writeFileSync(filePath, "");
+      if (!fs2.existsSync(filePath)) {
+        fs2.writeFileSync(filePath, "");
         console.log(`\u2705 SQLite database created at "${filePath}"`);
       } else {
         console.log(`\u26A0\uFE0F  SQLite database already exists at "${filePath}"`);
@@ -1191,20 +1157,20 @@ var SqliteAdapter = {
   async drop(url) {
     const filePath = parseSqliteUrl(url);
     try {
-      if (fs3.existsSync(filePath)) {
-        fs3.unlinkSync(filePath);
+      if (fs2.existsSync(filePath)) {
+        fs2.unlinkSync(filePath);
         console.log(`\u2705 SQLite database at "${filePath}" dropped successfully.`);
       } else {
         console.log(`\u26A0\uFE0F  SQLite database does not exist at "${filePath}"`);
       }
-      if (fs3.existsSync(`${filePath}-journal`)) {
-        fs3.unlinkSync(`${filePath}-journal`);
+      if (fs2.existsSync(`${filePath}-journal`)) {
+        fs2.unlinkSync(`${filePath}-journal`);
       }
-      if (fs3.existsSync(`${filePath}-wal`)) {
-        fs3.unlinkSync(`${filePath}-wal`);
+      if (fs2.existsSync(`${filePath}-wal`)) {
+        fs2.unlinkSync(`${filePath}-wal`);
       }
-      if (fs3.existsSync(`${filePath}-shm`)) {
-        fs3.unlinkSync(`${filePath}-shm`);
+      if (fs2.existsSync(`${filePath}-shm`)) {
+        fs2.unlinkSync(`${filePath}-shm`);
       }
     } catch (error) {
       console.error("\u274C Error dropping SQLite database:", error);
@@ -1214,8 +1180,8 @@ var SqliteAdapter = {
 };
 function parseSqliteUrl(url) {
   let cleanPath = url.replace(/^file:/, "");
-  if (!path3.isAbsolute(cleanPath)) {
-    cleanPath = path3.resolve(process.cwd(), cleanPath);
+  if (!path2.isAbsolute(cleanPath)) {
+    cleanPath = path2.resolve(process.cwd(), cleanPath);
   }
   return cleanPath;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prisma-flare",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Prisma utilities package with callback system and query builder for chained operations",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",

package/readme.md

@@ -73,27 +73,49 @@ prisma-flare automatically detects your Prisma version at runtime and uses the a
 Replace your standard `PrismaClient` with `FlareClient` in your database setup file (e.g., `src/db.ts` or `src/lib/prisma.ts`).
 
 ```typescript
-// src/db.ts
-import { FlareClient, registerHooks } from 'prisma-flare';
+// prisma/db.ts
+import './callbacks';  // Import generated index to register all hooks
+import { FlareClient } from 'prisma-flare';
 
-// Initialize hooks middleware and auto-load callbacks
-export const db = await registerHooks(new FlareClient());
+export const db = new FlareClient();
 ```
 
-`registerHooks()` is async and:
-- Registers the hooks middleware (using the appropriate API for your Prisma version)
-- Automatically loads all callback files from `prisma/callbacks` (or your configured path)
-- Returns the extended client instance
+`FlareClient` automatically attaches the callbacks middleware (using the appropriate API for your Prisma version). The callbacks import loads a generated barrel file that registers all your hooks - this pattern works in all environments (bundlers, Node.js, serverless, etc.).
 
-### 2. Generate Query Classes
+**With Prisma adapters:**
 
-Run the generator to create type-safe query classes for your specific schema.
+```typescript
+import './callbacks';
+import { PrismaPg } from '@prisma/adapter-pg';
+import { FlareClient } from 'prisma-flare';
+
+const adapter = new PrismaPg({ connectionString: process.env.DATABASE_URL });
+
+export const db = new FlareClient({ adapter });
+```
+
+**Disable callbacks middleware:**
+
+```typescript
+import { FlareClient } from 'prisma-flare';
+
+// If you don't use callbacks, disable the middleware for slightly less overhead
+export const db = new FlareClient({ callbacks: false });
+```
+
+### 2. Generate Query Classes & Callbacks Index
+
+Run the generator to create type-safe query classes and the callbacks barrel file.
 
 ```bash
 npx prisma-flare generate
 ```
 
-By default, this will look for your `db` instance in `src/db` and output queries to `src/models`.
+This command:
+- Generates query classes based on your `schema.prisma`
+- Generates `prisma/callbacks/index.ts` that imports all your callback files
+
+**Important:** Re-run this command after adding new callback files to update the index.
 
 ### 3. Configuration (Optional)
 
@@ -110,7 +132,7 @@ If your project structure is different, create a `prisma-flare.config.json` in y
 
 - `modelsPath`: Where to generate the query classes (defaults to `prisma/models`).
 - `dbPath`: Path to the file exporting your `db` instance (relative to project root, defaults to `prisma/db`).
-- `callbacksPath`: Directory containing your callback/hook files (defaults to `prisma/callbacks`). All `.ts`/`.js` files in this directory are automatically loaded when `registerHooks()` is called.
+- `callbacksPath`: Directory containing your callback/hook files (defaults to `prisma/callbacks`). The generator creates an `index.ts` barrel file in this directory.
 - `envPath`: Path to your environment file (optional, defaults to `.env`).
 - `plurals`: Custom pluralization for model names (optional).
 
@@ -203,7 +225,7 @@ await DB.instance.transaction(async (tx) => {
 
 ### Callhooks & Middleware
 
-Define hooks to run logic before or after database operations. Create callback files in your callbacks directory (default: `prisma/callbacks`) and they'll be automatically loaded.
+Define hooks to run logic before or after database operations. Create callback files in your callbacks directory (default: `prisma/callbacks`), then run `npx prisma-flare generate` to update the index.
 
 ```typescript
 // prisma/callbacks/user.ts
@@ -235,7 +257,7 @@ afterChange('post', 'published', async (oldValue, newValue, record) => {
 });
 ```
 
-All files in the callbacks directory are automatically imported when `registerHooks()` is called. No manual loading required.
+After creating callback files, run `npx prisma-flare generate` to update the index. The generated `index.ts` imports all callbacks, which you then import in your db setup file.
 
 #### Hook Configuration
 
@@ -306,25 +328,22 @@ This prevents false positives when:
 
 #### Advanced Hook Registration
 
-For more control over hook registration, prisma-flare exports additional utilities:
+For advanced use cases, prisma-flare exports lower-level utilities:
 
 ```typescript
 import {
-  registerHooks,           // Auto-detects Prisma version + auto-loads callbacks (recommended)
-  registerHooksLegacy,     // Force legacy $use API (Prisma ≤6 only, no auto-load)
+  registerHooksLegacy,     // Force legacy $use API (Prisma ≤6 only)
   createHooksExtension,    // Get raw extension for manual use
-  loadCallbacks            // Manually load callbacks from a custom path
+  loadCallbacks            // Manually load callbacks at runtime (dev only)
 } from 'prisma-flare';
 
-// Option 1: Auto-detect with auto-loading (recommended)
-const db = await registerHooks(new FlareClient());
-
-// Option 2: Manual callback loading from custom path
+// Manual extension on raw PrismaClient (advanced)
 import { PrismaClient } from '@prisma/client';
 const prisma = new PrismaClient().$extends(createHooksExtension(new PrismaClient()));
-await loadCallbacks('/custom/path/to/callbacks');
 ```
 
+For most use cases, just use `new FlareClient()` which handles everything automatically.
+
 ## CLI Utilities
 
 Prisma Flare comes with a suite of CLI tools to manage your database workflow. It supports **PostgreSQL** and **SQLite** out of the box, and is extensible for other databases.