suparisma 0.0.2 → 0.0.3

package/dist/hooks/generated/index.js

@@ -0,0 +1,33 @@
+"use strict";
+// THIS FILE IS AUTO-GENERATED - DO NOT EDIT DIRECTLY
+// Edit the generator script instead: scripts/generate-realtime-hooks.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+const useSuparismaUser_1 = require("./useSuparismaUser");
+/**
+ * Main Suparisma hook object with dot notation access to all model hooks.
+ *
+ * @example
+ * // Get hooks for different models
+ * import useSuparisma from './hooks/generated';
+ *
+ * // Access user model with all hook methods
+ * const users = useSuparisma.user();
+ * const { data, loading, error } = users;
+ *
+ * // Create a new record
+ * await users.create({ name: "John" });
+ *
+ * // Delete a record
+ * await users.delete({ id: "123" });
+ *
+ * @example
+ * // Use with filtering and options
+ * const admins = useSuparisma.user({
+ *   where: { role: 'admin' },
+ *   orderBy: { created_at: 'desc' }
+ * });
+ */
+const useSuparisma = {
+    user: useSuparismaUser_1.useSuparismaUser,
+};
+exports.default = useSuparisma;

package/dist/hooks/generated/useSuparismaUser.js

@@ -0,0 +1,60 @@
+"use strict";
+// THIS FILE IS AUTO-GENERATED - DO NOT EDIT DIRECTLY
+// Edit the generator script instead: scripts/generate-realtime-hooks.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useSuparismaUser = void 0;
+const core_1 = require("./core");
+/**
+ * A Prisma-like hook for interacting with User records with real-time capabilities.
+ *
+ * This hook provides CRUD operations, real-time updates, and search functionality.
+ *
+ * @param options - Optional configuration options for the hook
+ * @returns An object with data state and methods for interacting with User records
+ *
+ * @example
+ * // Basic usage - get all User records with realtime updates
+ * const user = useSuparismaUser();
+ * const { data, loading, error } = user;
+ *
+ * @example
+ * // With filtering and ordering
+ * const user = useSuparismaUser({
+ *   where: { active: true },
+ *   orderBy: { created_at: 'desc' },
+ *   limit: 10
+ * });
+ *
+ * @example
+ * // Create a new record
+ * const result = await user.create({
+ *   name: "Example Name",
+ *   // other fields...
+ * });
+ *
+ * @example
+ * // Update a record
+ * const result = await user.update({
+ *   where: { id: "123" },
+ *   data: { name: "Updated Name" }
+ * });
+ *
+ * @example
+ * // Delete a record
+ * const result = await user.delete({ id: "123" });
+ *
+ * @example
+ * // Find records with specific criteria
+ * const result = await user.findMany({
+ *   where: { // filters },
+ *   orderBy: { // ordering },
+ *   take: 20 // limit
+ * });
+ */
+exports.useSuparismaUser = (0, core_1.createSuparismaHook)({
+    tableName: 'User',
+    hasCreatedAt: true,
+    hasUpdatedAt: true,
+    // Default values from schema
+    defaultValues: { "id": "uuid(", "createdAt": "now(" }
+});

package/dist/index.js

@@ -39,12 +39,59 @@ const typeGenerator_1 = require("./generators/typeGenerator");
 const hookGenerator_1 = require("./generators/hookGenerator");
 const indexGenerator_1 = require("./generators/indexGenerator");
 const supabaseClientGenerator_1 = require("./generators/supabaseClientGenerator");
+/**
+ * Prints the help message showing available commands
+ */
+function printHelp() {
+    console.log(`
+Suparisma - Typesafe React realtime CRUD hooks generator for Supabase, powered by Prisma.
+
+Usage:
+  npx suparisma <command>
+
+Commands:
+  generate    Generate hooks based on your Prisma schema (runs in current directory)
+  help        Show this help message
+
+Example:
+  npx suparisma generate
+  `);
+}
+/**
+ * Checks for essential environment variables and throws an error if any are missing.
+ */
+function checkEnvironmentVariables() {
+    const requiredEnvVars = [
+        'DATABASE_URL',
+        'NEXT_PUBLIC_SUPABASE_URL',
+        'NEXT_PUBLIC_SUPABASE_ANON_KEY',
+    ];
+    const missingVars = requiredEnvVars.filter(varName => !process.env[varName]);
+    if (missingVars.length > 0) {
+        let errorMessage = 'Error: Missing required environment variables:\n';
+        missingVars.forEach(varName => {
+            errorMessage += `- ${varName}: This variable is essential for the generator to function correctly. `;
+            if (varName === 'DATABASE_URL') {
+                errorMessage += 'It is used by Prisma to connect to your database. Please ensure it is set in your .env file or as an environment variable (e.g., postgresql://user:password@host:port/database).\n';
+            }
+            else if (varName === 'NEXT_PUBLIC_SUPABASE_URL') {
+                errorMessage += 'This is your Supabase project URL. It is required by the Supabase client. Please set it in your .env file or as an environment variable (e.g., https://your-project-id.supabase.co).\n';
+            }
+            else if (varName === 'NEXT_PUBLIC_SUPABASE_ANON_KEY') {
+                errorMessage += 'This is your Supabase project public anonymous key. It is required by the Supabase client. Please set it in your .env file or as an environment variable.\n';
+            }
+        });
+        errorMessage += '\nPlease add these variables to your .env file or ensure they are available in your environment and try again.';
+        throw new Error(errorMessage);
+    }
+    console.log('✅ All required environment variables are set.');
+}
 function analyzePrismaSchema(schemaPath) {
     try {
         const schemaContent = fs_1.default.readFileSync(schemaPath, 'utf8');
         const modelInfos = [];
         // Regular expression to match model definitions with comments
-        const modelRegex = /(?:\/\/\s*@enableRealtime\s*)?\s*model\s+(\w+)\s*{([\s\S]*?)}/g;
+        const modelRegex = /(?:\/\/\s*@disableRealtime\s*)?\s*model\s+(\w+)\s*{([\s\S]*?)}/g;
         let modelMatch;
         while ((modelMatch = modelRegex.exec(schemaContent)) !== null) {
             const modelName = modelMatch[1];
@@ -56,8 +103,9 @@ function analyzePrismaSchema(schemaPath) {
             const tableName = modelMatch[0].includes('@map')
                 ? modelMatch[0].match(/@map\s*\(\s*["'](.+?)["']\s*\)/)?.at(1) || modelName
                 : modelName;
-            // Check if model has @enableRealtime comment
-            const enableRealtime = modelMatch[0].includes('// @enableRealtime');
+            // Check if model has @disableRealtime comment
+            // Default is to enable realtime unless explicitly disabled
+            const enableRealtime = !modelMatch[0].includes('// @disableRealtime');
             // Find fields with @enableSearch comment
             const searchFields = [];
             const fieldRegex = /(\w+)\s+(\w+)(?:\?.+?)?\s+(?:@.+?)?\s*(?:\/\/\s*@enableSearch)?/g;
@@ -86,7 +134,7 @@ function analyzePrismaSchema(schemaPath) {
 }
 /**
  * Configure database tables for proper realtime functionality and search
- * 1. Sets REPLICA IDENTITY FULL and enables realtime for models with @enableRealtime
+ * 1. Sets REPLICA IDENTITY FULL and enables realtime for all models (unless they have @disableRealtime)
  * 2. Creates search functions for fields with @enableSearch
  */
 async function configurePrismaTablesForSuparisma(schemaPath) {
@@ -98,8 +146,7 @@ async function configurePrismaTablesForSuparisma(schemaPath) {
         // Get direct PostgreSQL connection URL
         const directUrl = process.env.DIRECT_URL;
         if (!directUrl) {
-            console.warn('⚠️ DIRECT_URL environment variable not found. Skipping database configuration.');
-            return;
+            throw new Error('❌ Error: DIRECT_URL environment variable not found. This is required for database configuration (e.g., setting up realtime). Please define it in your .env file or as an environment variable and try again. This should be a direct PostgreSQL connection string.\n');
         }
         // Analyze Prisma schema for models, realtime and search annotations
         const modelInfos = analyzePrismaSchema(schemaPath);
@@ -129,6 +176,7 @@ async function configurePrismaTablesForSuparisma(schemaPath) {
                 // Use the exact case of the table as it exists in the database
                 const actualTableName = matchingTable.table_name;
                 console.log(`🔍 Model ${model.name} -> Actual table: ${actualTableName}`);
+                console.log(`ℹ️ Model ${model.name}: enableRealtime is ${model.enableRealtime}`);
                 if (model.enableRealtime) {
                     // Explicitly use double quotes for mixed case identifiers
                     // try {
@@ -138,10 +186,10 @@ async function configurePrismaTablesForSuparisma(schemaPath) {
                     //   console.error(`❌ Failed to set REPLICA IDENTITY on "${actualTableName}": ${err.message}`);
                     // }
                     // Directly add the table to Supabase Realtime publication
+                    const alterPublicationQuery = `ALTER PUBLICATION supabase_realtime ADD TABLE "${actualTableName}";`;
+                    console.log(`ℹ️ Executing SQL: ${alterPublicationQuery}`);
                     try {
-                        await pool.query(`
-              ALTER PUBLICATION supabase_realtime ADD TABLE "${actualTableName}";
-            `);
+                        await pool.query(alterPublicationQuery);
                         console.log(`✅ Added "${actualTableName}" to supabase_realtime publication`);
                     }
                     catch (err) {
@@ -150,7 +198,7 @@ async function configurePrismaTablesForSuparisma(schemaPath) {
                             console.log(`ℹ️ Table "${actualTableName}" was already in supabase_realtime publication`);
                         }
                         else {
-                            console.error(`❌ Failed to add "${actualTableName}" to supabase_realtime: ${err.message}`);
+                            console.error(`❌ Failed to add "${actualTableName}" to supabase_realtime. Full error:`, err);
                         }
                     }
                 }
@@ -222,38 +270,68 @@ async function configurePrismaTablesForSuparisma(schemaPath) {
     }
 }
 /**
- * Main execution function
+ * Main execution function for hook generation
  */
-async function main() {
+async function generateHooks() {
     try {
-        console.log('Generating Supabase realtime hooks with improved architecture...');
-        // Ensure output directory exists
-        if (!fs_1.default.existsSync(config_1.OUTPUT_DIR)) {
-            fs_1.default.mkdirSync(config_1.OUTPUT_DIR, { recursive: true });
+        console.log('🚀 Starting Suparisma hook generation...');
+        checkEnvironmentVariables();
+        console.log(`Prisma schema path: ${config_1.PRISMA_SCHEMA_PATH}`);
+        console.log(`Output directory: ${config_1.OUTPUT_DIR}`);
+        // Delete the entire output directory if it exists to clean up any stale files
+        if (fs_1.default.existsSync(config_1.OUTPUT_DIR)) {
+            console.log(`🧹 Cleaning up previous generated files in ${config_1.OUTPUT_DIR}...`);
+            fs_1.default.rmSync(config_1.OUTPUT_DIR, { recursive: true, force: true });
+            console.log(`✅ Removed previous generated directory`);
         }
-        // Generate Supabase client file first
+        // Ensure all specific output directories exist, OUTPUT_DIR is the root and will be created if needed by sub-creations.
+        const dirsToEnsure = [config_1.TYPES_DIR, config_1.HOOKS_DIR, config_1.UTILS_DIR];
+        dirsToEnsure.forEach(dir => {
+            if (!fs_1.default.existsSync(dir)) {
+                fs_1.default.mkdirSync(dir, { recursive: true });
+                console.log(`Created directory: ${dir}`);
+            }
+        });
+        // Generate Supabase client file (goes to UTILS_DIR)
         (0, supabaseClientGenerator_1.generateSupabaseClientFile)();
-        // First, generate the core hook factory
+        // Generate the core hook factory (goes to UTILS_DIR)
         (0, coreGenerator_1.generateCoreFile)();
-        // Parse models from Prisma schema
         const models = (0, parser_1.parsePrismaSchema)(config_1.PRISMA_SCHEMA_PATH);
-        // Configure database tables for real-time and search functionality
         await configurePrismaTablesForSuparisma(config_1.PRISMA_SCHEMA_PATH);
-        // Generate type definitions and hooks for each model
         const modelInfos = [];
         for (const model of models) {
             const modelInfo = (0, typeGenerator_1.generateModelTypesFile)(model);
             (0, hookGenerator_1.generateModelHookFile)(modelInfo);
             modelInfos.push(modelInfo);
         }
-        // Generate the main module file
         (0, indexGenerator_1.generateMainIndexFile)(modelInfos);
-        console.log('✅ Successfully generated all suparisma hooks!');
+        console.log(`✅ Successfully generated all suparisma hooks and types in "${config_1.OUTPUT_DIR}"!`);
     }
     catch (error) {
         console.error('❌ Error generating hooks:', error);
         process.exit(1);
     }
 }
-// Execute main function
-main();
+/**
+ * Main CLI entry point
+ */
+function run() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    switch (command) {
+        case 'generate':
+            generateHooks();
+            break;
+        case 'help':
+        case '--help':
+        case '-h':
+            printHelp();
+            break;
+        default:
+            console.log(`Unknown command: ${command}`);
+            printHelp();
+            process.exit(1);
+    }
+}
+// Execute the CLI command
+run();

package/dist/suparisma/generated/hooks/useSuparismaUser.js

@@ -0,0 +1,61 @@
+"use strict";
+// THIS FILE IS AUTO-GENERATED - DO NOT EDIT DIRECTLY
+// Edit the generator script instead: scripts/generate-realtime-hooks.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useSuparismaUser = void 0;
+// Corrected import for core hook factory
+const core_1 = require("../utils/core");
+/**
+ * A Prisma-like hook for interacting with User records with real-time capabilities.
+ *
+ * This hook provides CRUD operations, real-time updates, and search functionality.
+ *
+ * @param options - Optional configuration options for the hook
+ * @returns An object with data state and methods for interacting with User records
+ *
+ * @example
+ * // Basic usage - get all User records with realtime updates
+ * const user = useSuparismaUser();
+ * const { data, loading, error } = user;
+ *
+ * @example
+ * // With filtering and ordering
+ * const user = useSuparismaUser({
+ *   where: { active: true },
+ *   orderBy: { created_at: 'desc' },
+ *   limit: 10
+ * });
+ *
+ * @example
+ * // Create a new record
+ * const result = await user.create({
+ *   name: "Example Name",
+ *   // other fields...
+ * });
+ *
+ * @example
+ * // Update a record
+ * const result = await user.update({
+ *   where: { id: "123" },
+ *   data: { name: "Updated Name" }
+ * });
+ *
+ * @example
+ * // Delete a record
+ * const result = await user.delete({ id: "123" });
+ *
+ * @example
+ * // Find records with specific criteria
+ * const result = await user.findMany({
+ *   where: { // filters },
+ *   orderBy: { // ordering },
+ *   take: 20 // limit
+ * });
+ */
+exports.useSuparismaUser = (0, core_1.createSuparismaHook)({
+    tableName: 'User',
+    hasCreatedAt: true,
+    hasUpdatedAt: true,
+    // Default values from schema
+    defaultValues: { "id": "uuid(", "createdAt": "now(" }
+});

package/dist/suparisma/generated/index.js

@@ -0,0 +1,33 @@
+"use strict";
+// THIS FILE IS AUTO-GENERATED - DO NOT EDIT DIRECTLY
+// Edit the generator script instead: scripts/generate-realtime-hooks.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+const useSuparismaUser_1 = require("./hooks/useSuparismaUser");
+/**
+ * Main Suparisma hook object with dot notation access to all model hooks.
+ *
+ * @example
+ * // Get hooks for different models
+ * import useSuparisma from './your-output-dir'; // e.g., from './suparisma/generated'
+ *
+ * // Access user model with all hook methods
+ * const users = useSuparisma.user();
+ * const { data, loading, error } = users;
+ *
+ * // Create a new record
+ * await users.create({ name: "John" });
+ *
+ * // Delete a record
+ * await users.delete({ id: "123" });
+ *
+ * @example
+ * // Use with filtering and options
+ * const admins = useSuparisma.user({
+ *   where: { role: 'admin' },
+ *   orderBy: { created_at: 'desc' }
+ * });
+ */
+const useSuparisma = {
+    user: useSuparismaUser_1.useSuparismaUser,
+};
+exports.default = useSuparisma;

package/dist/suparisma/generated/types/UserTypes.js

@@ -0,0 +1,4 @@
+"use strict";
+// THIS FILE IS AUTO-GENERATED - DO NOT EDIT DIRECTLY
+// Edit the generator script instead
+Object.defineProperty(exports, "__esModule", { value: true });