algolia-codegen 0.1.1 → 0.1.3

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 nightlightmare
+
+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/README.md

@@ -1,12 +1,20 @@
 # Algolia Type Generator
 
+[![npm version](https://img.shields.io/npm/v/algolia-codegen.svg?style=flat-square)](https://www.npmjs.com/package/algolia-codegen)
+[![npm downloads](https://img.shields.io/npm/dm/algolia-codegen.svg?style=flat-square)](https://www.npmjs.com/package/algolia-codegen)
+[![npm bundle size](https://img.shields.io/bundlephobia/minzip/algolia-codegen?style=flat-square)](https://bundlephobia.com/package/algolia-codegen)
+[![GitHub stars](https://img.shields.io/github/stars/nightlightmare/algolia-codegen.svg?style=flat-square&logo=github)](https://github.com/nightlightmare/algolia-codegen)
+[![GitHub issues](https://img.shields.io/github/issues/nightlightmare/algolia-codegen.svg?style=flat-square&logo=github)](https://github.com/nightlightmare/algolia-codegen/issues)
+[![GitHub license](https://img.shields.io/github/license/nightlightmare/algolia-codegen.svg?style=flat-square)](https://github.com/nightlightmare/algolia-codegen/blob/main/LICENSE)
+[![Node.js version](https://img.shields.io/node/v/algolia-codegen.svg?style=flat-square)](https://nodejs.org/)
+
 This script automatically generates TypeScript types from your Algolia indices by fetching sample records and analyzing their structure. It supports multiple indices and flexible configuration through a config file.
 
 **Repository**: [https://github.com/nightlightmare/algolia-codegen](https://github.com/nightlightmare/algolia-codegen)
 
 ## Prerequisites
 
-- Node.js >= 18
+- Node.js >= 20
 - Algolia account with at least one index
 
 ## Installation
@@ -30,17 +38,17 @@ yarn add algolia-codegen
 1. Create a configuration file named `algolia-codegen.ts` (or `.js`) in your project root:
 
 ```typescript
-import type { AlgoliaCodegenConfig } from "algolia-codegen";
+import type { AlgoliaCodegenConfig } from 'algolia-codegen';
 
 const config: AlgoliaCodegenConfig = {
   overwrite: true,
   generates: {
-    "src/algolia/types.ts": {
-      appId: "YOUR_APP_ID",
-      searchKey: "YOUR_SEARCH_API_KEY",
-      indexName: "products",
-      prefix: "Algolia", // Optional
-      postfix: "Type", // Optional
+    'src/algolia/types.ts': {
+      appId: 'YOUR_APP_ID',
+      searchKey: 'YOUR_SEARCH_API_KEY',
+      indexName: 'products',
+      prefix: 'Algolia', // Optional
+      postfix: 'Type', // Optional
     },
   },
 };
@@ -65,17 +73,17 @@ npx algolia-codegen
 Create a configuration file named `algolia-codegen.ts` (or `.js`) in your project root. The config file should export a default object with the following structure:
 
 ```typescript
-import type { AlgoliaCodegenConfig } from "algolia-codegen";
+import type { AlgoliaCodegenConfig } from 'algolia-codegen';
 
 const config: AlgoliaCodegenConfig = {
   overwrite: true,
   generates: {
-    "src/algolia/types.ts": {
-      appId: "YOUR_APP_ID",
-      searchKey: "YOUR_SEARCH_API_KEY",
-      indexName: "products",
-      prefix: "Algolia", // Optional
-      postfix: "Type", // Optional
+    'src/algolia/types.ts': {
+      appId: 'YOUR_APP_ID',
+      searchKey: 'YOUR_SEARCH_API_KEY',
+      indexName: 'products',
+      prefix: 'Algolia', // Optional
+      postfix: 'Type', // Optional
     },
   },
 };
@@ -91,15 +99,15 @@ You can generate types for multiple indices:
 const config: AlgoliaCodegenConfig = {
   overwrite: true,
   generates: {
-    "src/algolia/products.ts": {
-      appId: "YOUR_APP_ID",
-      searchKey: "YOUR_SEARCH_API_KEY",
-      indexName: "products",
+    'src/algolia/products.ts': {
+      appId: 'YOUR_APP_ID',
+      searchKey: 'YOUR_SEARCH_API_KEY',
+      indexName: 'products',
     },
-    "src/algolia/users.ts": {
-      appId: "YOUR_APP_ID",
-      searchKey: "YOUR_SEARCH_API_KEY",
-      indexName: "users",
+    'src/algolia/users.ts': {
+      appId: 'YOUR_APP_ID',
+      searchKey: 'YOUR_SEARCH_API_KEY',
+      indexName: 'users',
     },
   },
 };
@@ -114,17 +122,17 @@ const config: AlgoliaCodegenConfig = {
   overwrite: true,
   generates: [
     {
-      "src/algolia/products.ts": {
-        appId: "YOUR_APP_ID",
-        searchKey: "YOUR_SEARCH_API_KEY",
-        indexName: "products",
+      'src/algolia/products.ts': {
+        appId: 'YOUR_APP_ID',
+        searchKey: 'YOUR_SEARCH_API_KEY',
+        indexName: 'products',
       },
     },
     {
-      "src/algolia/users.ts": {
-        appId: "YOUR_APP_ID",
-        searchKey: "YOUR_SEARCH_API_KEY",
-        indexName: "users",
+      'src/algolia/users.ts': {
+        appId: 'YOUR_APP_ID',
+        searchKey: 'YOUR_SEARCH_API_KEY',
+        indexName: 'users',
       },
     },
   ],
@@ -180,19 +188,20 @@ type AlgoliaCodegenGeneratorConfig = {
 
 ## How It Works
 
-1. **Loads Configuration**: Reads the `algolia-codegen.ts` config file (or custom path)
-2. **Processes Each Path**: For each file path specified in the config:
+1. **Loads Environment Variables**: Automatically loads `.env` file if present in the current directory
+2. **Loads Configuration**: Reads the `algolia-codegen.ts` config file (or custom path), supporting both TypeScript and JavaScript
+3. **Processes Each Path**: For each file path specified in the config:
    - Connects to Algolia using the provided credentials
    - Fetches a sample record from the specified index
    - Analyzes the record structure and generates TypeScript types
    - Creates a single TypeScript file containing all types found in the index
-3. **Type Generation**: The generator automatically:
+4. **Type Generation**: The generator automatically:
    - Infers types from the sample record structure
    - Handles nested objects, arrays, and complex types
    - Detects and generates generic `IdValue<T>` types for Algolia's id-value pattern arrays
    - Generates proper TypeScript interfaces with JSDoc comments
    - Sorts types by dependencies for correct ordering
-4. **Error Handling**: Continues processing other files even if one fails, with detailed error messages
+5. **Error Handling**: Continues processing other files even if one fails, with detailed error messages
 
 Each generated file contains all types found in the index, including nested types, properly organized and sorted by dependencies.
 
@@ -201,7 +210,8 @@ Each generated file contains all types found in the index, including nested type
 - Each index must have at least one record for the script to work
 - The script processes files sequentially and continues even if one fails
 - Make sure your config file exports a default object
-- For TypeScript config files, you may need to use `tsx` or compile them first: `tsx algolia-codegen`
+- TypeScript config files (`.ts`) are automatically supported - no compilation needed
+- Environment variables from `.env` file are automatically loaded if present in the current directory
 - Each generated file contains all types found in the index (including nested types) in a single file
 - Types are automatically sorted by dependencies to ensure correct ordering
 - The generator handles arrays, nested objects, optional fields, and null values
@@ -211,44 +221,11 @@ Each generated file contains all types found in the index, including nested type
 
 ## Examples
 
-### Generated Type Example
-
-Given an Algolia record like:
-
-```json
-{
-  "objectID": "123",
-  "name": "Product Name",
-  "price": 99.99,
-  "tags": ["tag1", "tag2"],
-  "metadata": {
-    "category": "electronics",
-    "rating": 4.5
-  }
-}
-```
-
-The generator will create TypeScript types:
-
-```typescript
-/**
- * Generated TypeScript types for Algolia index: products
- * This file is auto-generated. Do not edit manually.
- */
-
-export interface AlgoliaHitType {
-  metadata: AlgoliaMetadataType;
-  name: string;
-  objectID: string;
-  price: number;
-  tags: string[];
-}
-
-export interface AlgoliaMetadataType {
-  category: string;
-  rating: number;
-}
-```
+See the [examples directory](./examples/) for comprehensive examples including:
+- Framework integrations (Next.js, React, Vue)
+- CI/CD integration (GitHub Actions)
+- Custom prefixes/postfixes
+- Multiple indices configuration
 
 ## Repository
 

package/dist/{chunk-4FWQJC54.js → chunk-4T5DZK75.js}

@@ -1,15 +1,32 @@
-// src/utils/config-loader.ts
+// src/utils/load-config.ts
 import { existsSync } from "fs";
 import { resolve } from "path";
 import { pathToFileURL } from "url";
 
+// src/utils/load-typescript-config.ts
+import { readFileSync } from "fs";
+async function loadTypeScriptConfig(resolvedPath) {
+  const esbuild = await import("esbuild");
+  const source = readFileSync(resolvedPath, "utf-8");
+  const result = esbuild.transformSync(source, {
+    loader: "ts",
+    format: "esm",
+    target: "node20",
+    sourcefile: resolvedPath
+  });
+  if (!result.code) {
+    throw new Error("Failed to transform TypeScript config file");
+  }
+  const dataUrl = `data:text/javascript;charset=utf-8,${encodeURIComponent(result.code)}`;
+  const module = await import(dataUrl);
+  return module;
+}
+
 // src/utils/validations/generator-config.ts
 function validateGeneratorConfig(config, path) {
   if (typeof config !== "object" || config === null || Array.isArray(config)) {
-    throw new Error(
-      `Invalid generator config: must be an object
-Path: ${path}`
-    );
+    throw new Error(`Invalid generator config: must be an object
+Path: ${path}`);
   }
   const cfg = config;
   const requiredFields = [
@@ -51,10 +68,8 @@ Received: ${typeof cfg.postfix}`
 // src/utils/validations/url-schema.ts
 function validateUrlSchema(urlSchema, path) {
   if (typeof urlSchema !== "object" || urlSchema === null || Array.isArray(urlSchema)) {
-    throw new Error(
-      `Invalid generates entry: must be an object
-Path: ${path}`
-    );
+    throw new Error(`Invalid generates entry: must be an object
+Path: ${path}`);
   }
   const schema = urlSchema;
   for (const [filePath, generatorConfig] of Object.entries(schema)) {
@@ -71,10 +86,8 @@ Path: ${path}[${filePath}]`
 // src/utils/validations/config.ts
 function validateConfig(config, configPath) {
   if (typeof config !== "object" || config === null || Array.isArray(config)) {
-    throw new Error(
-      `Invalid config: must be an object
-Config file: ${configPath}`
-    );
+    throw new Error(`Invalid config: must be an object
+Config file: ${configPath}`);
   }
   const cfg = config;
   if (!("overwrite" in cfg)) {
@@ -112,7 +125,7 @@ Received: ${typeof generates}`
   }
 }
 
-// src/utils/config-loader.ts
+// src/utils/load-config.ts
 async function loadConfig(configPath) {
   const defaultConfigPath = "algolia-codegen.ts";
   const finalConfigPath = configPath || defaultConfigPath;
@@ -125,34 +138,38 @@ Please create a config file or specify a different path using --config option.`
   }
   const configUrl = pathToFileURL(resolvedPath).href;
   let configModule;
-  try {
-    configModule = await import(configUrl);
-  } catch (importError) {
-    const jsPath = resolvedPath.replace(/\.ts$/, ".js");
-    if (existsSync(jsPath)) {
-      const jsUrl = pathToFileURL(jsPath).href;
-      try {
-        configModule = await import(jsUrl);
-      } catch (jsImportError) {
+  if (resolvedPath.endsWith(".ts")) {
+    try {
+      configModule = await loadTypeScriptConfig(resolvedPath);
+    } catch (tsError) {
+      const jsPath = resolvedPath.replace(/\.ts$/, ".js");
+      if (existsSync(jsPath)) {
+        const jsUrl = pathToFileURL(jsPath).href;
+        try {
+          configModule = await import(jsUrl);
+        } catch (jsImportError) {
+          throw new Error(
+            `Failed to import config file: ${resolvedPath}
+Tried both .ts (via esbuild) and .js extensions.
+TypeScript error: ${tsError instanceof Error ? tsError.message : String(tsError)}
+JavaScript error: ${jsImportError instanceof Error ? jsImportError.message : String(jsImportError)}`
+          );
+        }
+      } else {
         throw new Error(
-          `Failed to import config file: ${resolvedPath}
-Tried both .ts and .js extensions.
-Error: ${jsImportError instanceof Error ? jsImportError.message : String(jsImportError)}
-Note: If using TypeScript config, you may need to compile it first or use a tool like tsx.`
+          `Failed to load TypeScript config file: ${resolvedPath}
+Error: ${tsError instanceof Error ? tsError.message : String(tsError)}
+Make sure esbuild is installed as a dependency.`
         );
       }
-    } else {
+    }
+  } else {
+    try {
+      configModule = await import(configUrl);
+    } catch (importError) {
       const errorMessage = importError instanceof Error ? importError.message : String(importError);
-      const isTypeScriptError = resolvedPath.endsWith(".ts") && (errorMessage.includes("Cannot find module") || errorMessage.includes("Unknown file extension"));
-      throw new Error(
-        `Failed to import config file: ${resolvedPath}
-` + (isTypeScriptError ? `Node.js cannot directly import TypeScript files.
-Please either:
-  1. Compile your config to JavaScript (.js)
-  2. Use a tool like tsx to run the CLI: tsx algolia-codegen
-  3. Or use a JavaScript config file instead
-` : `Error: ${errorMessage}`)
-      );
+      throw new Error(`Failed to import config file: ${resolvedPath}
+Error: ${errorMessage}`);
     }
   }
   if (!configModule.default) {
@@ -173,7 +190,7 @@ Received: ${typeof config}`
 }
 
 // src/utils/fetch-algolia-data.ts
-import algoliasearch from "algoliasearch";
+import { algoliasearch } from "algoliasearch";
 import { existsSync as existsSync2, writeFileSync, mkdirSync } from "fs";
 import { resolve as resolve2, dirname } from "path";
 
@@ -281,7 +298,7 @@ var TypeGenerator = class {
       return `${this.prefix}Hit${this.postfix}`;
     }
     const lastPart = path[path.length - 1];
-    const parts = lastPart.replace(/[\[\]]/g, "").split(/[-_\s]+/).filter(Boolean);
+    const parts = lastPart.replace(/[[\]]/g, "").split(/[-_\s]+/).filter(Boolean);
     const pascalCase = parts.map((part) => part.charAt(0).toUpperCase() + part.slice(1).toLowerCase()).join("");
     if (path.length > 1) {
       const parent = path[path.length - 2];
@@ -447,10 +464,7 @@ Set overwrite: true in config to allow overwriting existing files.`
   console.log(`App ID: ${generatorConfig.appId}`);
   let client;
   try {
-    client = algoliasearch(
-      generatorConfig.appId,
-      generatorConfig.searchKey
-    );
+    client = algoliasearch(generatorConfig.appId, generatorConfig.searchKey);
   } catch (error) {
     throw new Error(
       `Failed to initialize Algolia client: ${error instanceof Error ? error.message : String(error)}`
@@ -462,8 +476,8 @@ Set overwrite: true in config to allow overwriting existing files.`
     results = await client.search([
       {
         indexName: generatorConfig.indexName,
-        query: "",
         params: {
+          query: "",
           hitsPerPage: 1
         }
       }

package/dist/cli.cjs

@@ -24,20 +24,40 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/cli.ts
+var import_dotenv = require("dotenv");
+var import_fs4 = require("fs");
+var import_path3 = require("path");
 var import_commander = require("commander");
 
-// src/utils/config-loader.ts
-var import_fs = require("fs");
+// src/utils/load-config.ts
+var import_fs2 = require("fs");
 var import_path = require("path");
 var import_url = require("url");
 
+// src/utils/load-typescript-config.ts
+var import_fs = require("fs");
+async function loadTypeScriptConfig(resolvedPath) {
+  const esbuild = await import("esbuild");
+  const source = (0, import_fs.readFileSync)(resolvedPath, "utf-8");
+  const result = esbuild.transformSync(source, {
+    loader: "ts",
+    format: "esm",
+    target: "node20",
+    sourcefile: resolvedPath
+  });
+  if (!result.code) {
+    throw new Error("Failed to transform TypeScript config file");
+  }
+  const dataUrl = `data:text/javascript;charset=utf-8,${encodeURIComponent(result.code)}`;
+  const module2 = await import(dataUrl);
+  return module2;
+}
+
 // src/utils/validations/generator-config.ts
 function validateGeneratorConfig(config, path) {
   if (typeof config !== "object" || config === null || Array.isArray(config)) {
-    throw new Error(
-      `Invalid generator config: must be an object
-Path: ${path}`
-    );
+    throw new Error(`Invalid generator config: must be an object
+Path: ${path}`);
   }
   const cfg = config;
   const requiredFields = [
@@ -79,10 +99,8 @@ Received: ${typeof cfg.postfix}`
 // src/utils/validations/url-schema.ts
 function validateUrlSchema(urlSchema, path) {
   if (typeof urlSchema !== "object" || urlSchema === null || Array.isArray(urlSchema)) {
-    throw new Error(
-      `Invalid generates entry: must be an object
-Path: ${path}`
-    );
+    throw new Error(`Invalid generates entry: must be an object
+Path: ${path}`);
   }
   const schema = urlSchema;
   for (const [filePath, generatorConfig] of Object.entries(schema)) {
@@ -99,10 +117,8 @@ Path: ${path}[${filePath}]`
 // src/utils/validations/config.ts
 function validateConfig(config, configPath) {
   if (typeof config !== "object" || config === null || Array.isArray(config)) {
-    throw new Error(
-      `Invalid config: must be an object
-Config file: ${configPath}`
-    );
+    throw new Error(`Invalid config: must be an object
+Config file: ${configPath}`);
   }
   const cfg = config;
   if (!("overwrite" in cfg)) {
@@ -140,12 +156,12 @@ Received: ${typeof generates}`
   }
 }
 
-// src/utils/config-loader.ts
+// src/utils/load-config.ts
 async function loadConfig(configPath) {
   const defaultConfigPath = "algolia-codegen.ts";
   const finalConfigPath = configPath || defaultConfigPath;
   const resolvedPath = (0, import_path.resolve)(process.cwd(), finalConfigPath);
-  if (!(0, import_fs.existsSync)(resolvedPath)) {
+  if (!(0, import_fs2.existsSync)(resolvedPath)) {
     throw new Error(
       `Config file not found: ${resolvedPath}
 Please create a config file or specify a different path using --config option.`
@@ -153,34 +169,38 @@ Please create a config file or specify a different path using --config option.`
   }
   const configUrl = (0, import_url.pathToFileURL)(resolvedPath).href;
   let configModule;
-  try {
-    configModule = await import(configUrl);
-  } catch (importError) {
-    const jsPath = resolvedPath.replace(/\.ts$/, ".js");
-    if ((0, import_fs.existsSync)(jsPath)) {
-      const jsUrl = (0, import_url.pathToFileURL)(jsPath).href;
-      try {
-        configModule = await import(jsUrl);
-      } catch (jsImportError) {
+  if (resolvedPath.endsWith(".ts")) {
+    try {
+      configModule = await loadTypeScriptConfig(resolvedPath);
+    } catch (tsError) {
+      const jsPath = resolvedPath.replace(/\.ts$/, ".js");
+      if ((0, import_fs2.existsSync)(jsPath)) {
+        const jsUrl = (0, import_url.pathToFileURL)(jsPath).href;
+        try {
+          configModule = await import(jsUrl);
+        } catch (jsImportError) {
+          throw new Error(
+            `Failed to import config file: ${resolvedPath}
+Tried both .ts (via esbuild) and .js extensions.
+TypeScript error: ${tsError instanceof Error ? tsError.message : String(tsError)}
+JavaScript error: ${jsImportError instanceof Error ? jsImportError.message : String(jsImportError)}`
+          );
+        }
+      } else {
         throw new Error(
-          `Failed to import config file: ${resolvedPath}
-Tried both .ts and .js extensions.
-Error: ${jsImportError instanceof Error ? jsImportError.message : String(jsImportError)}
-Note: If using TypeScript config, you may need to compile it first or use a tool like tsx.`
+          `Failed to load TypeScript config file: ${resolvedPath}
+Error: ${tsError instanceof Error ? tsError.message : String(tsError)}
+Make sure esbuild is installed as a dependency.`
         );
       }
-    } else {
+    }
+  } else {
+    try {
+      configModule = await import(configUrl);
+    } catch (importError) {
       const errorMessage = importError instanceof Error ? importError.message : String(importError);
-      const isTypeScriptError = resolvedPath.endsWith(".ts") && (errorMessage.includes("Cannot find module") || errorMessage.includes("Unknown file extension"));
-      throw new Error(
-        `Failed to import config file: ${resolvedPath}
-` + (isTypeScriptError ? `Node.js cannot directly import TypeScript files.
-Please either:
-  1. Compile your config to JavaScript (.js)
-  2. Use a tool like tsx to run the CLI: tsx algolia-codegen
-  3. Or use a JavaScript config file instead
-` : `Error: ${errorMessage}`)
-      );
+      throw new Error(`Failed to import config file: ${resolvedPath}
+Error: ${errorMessage}`);
     }
   }
   if (!configModule.default) {
@@ -201,8 +221,8 @@ Received: ${typeof config}`
 }
 
 // src/utils/fetch-algolia-data.ts
-var import_algoliasearch = __toESM(require("algoliasearch"), 1);
-var import_fs2 = require("fs");
+var import_algoliasearch = require("algoliasearch");
+var import_fs3 = require("fs");
 var import_path2 = require("path");
 
 // src/utils/generate-typescript-types.ts
@@ -309,7 +329,7 @@ var TypeGenerator = class {
       return `${this.prefix}Hit${this.postfix}`;
     }
     const lastPart = path[path.length - 1];
-    const parts = lastPart.replace(/[\[\]]/g, "").split(/[-_\s]+/).filter(Boolean);
+    const parts = lastPart.replace(/[[\]]/g, "").split(/[-_\s]+/).filter(Boolean);
     const pascalCase = parts.map((part) => part.charAt(0).toUpperCase() + part.slice(1).toLowerCase()).join("");
     if (path.length > 1) {
       const parent = path[path.length - 2];
@@ -465,7 +485,7 @@ async function fetchAlgoliaData(filePath, generatorConfig, overwrite) {
   console.log(`
 Processing file: ${filePath}`);
   const resolvedPath = (0, import_path2.resolve)(process.cwd(), filePath);
-  if ((0, import_fs2.existsSync)(resolvedPath) && !overwrite) {
+  if ((0, import_fs3.existsSync)(resolvedPath) && !overwrite) {
     throw new Error(
       `File already exists: ${resolvedPath}
 Set overwrite: true in config to allow overwriting existing files.`
@@ -475,10 +495,7 @@ Set overwrite: true in config to allow overwriting existing files.`
   console.log(`App ID: ${generatorConfig.appId}`);
   let client;
   try {
-    client = (0, import_algoliasearch.default)(
-      generatorConfig.appId,
-      generatorConfig.searchKey
-    );
+    client = (0, import_algoliasearch.algoliasearch)(generatorConfig.appId, generatorConfig.searchKey);
   } catch (error) {
     throw new Error(
       `Failed to initialize Algolia client: ${error instanceof Error ? error.message : String(error)}`
@@ -490,8 +507,8 @@ Set overwrite: true in config to allow overwriting existing files.`
     results = await client.search([
       {
         indexName: generatorConfig.indexName,
-        query: "",
         params: {
+          query: "",
           hitsPerPage: 1
         }
       }
@@ -532,10 +549,10 @@ Set overwrite: true in config to allow overwriting existing files.`
   console.log(`ObjectID: ${sampleHit.objectID || "N/A"}`);
   const fileContent = generateTypeScriptTypes(sampleHit, generatorConfig);
   const dir = (0, import_path2.dirname)(resolvedPath);
-  if (!(0, import_fs2.existsSync)(dir)) {
-    (0, import_fs2.mkdirSync)(dir, { recursive: true });
+  if (!(0, import_fs3.existsSync)(dir)) {
+    (0, import_fs3.mkdirSync)(dir, { recursive: true });
   }
-  (0, import_fs2.writeFileSync)(resolvedPath, fileContent, "utf-8");
+  (0, import_fs3.writeFileSync)(resolvedPath, fileContent, "utf-8");
   console.log(`Generated file: ${filePath}`);
 }
 
@@ -579,6 +596,10 @@ Error processing file: ${filePath}`);
 };
 
 // src/cli.ts
+var envPath = (0, import_path3.resolve)(process.cwd(), ".env");
+if ((0, import_fs4.existsSync)(envPath)) {
+  (0, import_dotenv.config)({ path: envPath });
+}
 var program = new import_commander.Command();
 program.name("algolia-codegen").description("Generate TypeScript types from Algolia index").option("-c, --config <path>", "Config file path").action(async (options) => {
   await main(options.config);

package/dist/cli.js

@@ -1,10 +1,17 @@
 #!/usr/bin/env node
 import {
   main
-} from "./chunk-4FWQJC54.js";
+} from "./chunk-4T5DZK75.js";
 
 // src/cli.ts
+import { config as loadDotenv } from "dotenv";
+import { existsSync } from "fs";
+import { resolve } from "path";
 import { Command } from "commander";
+var envPath = resolve(process.cwd(), ".env");
+if (existsSync(envPath)) {
+  loadDotenv({ path: envPath });
+}
 var program = new Command();
 program.name("algolia-codegen").description("Generate TypeScript types from Algolia index").option("-c, --config <path>", "Config file path").action(async (options) => {
   await main(options.config);

package/dist/index.cjs

@@ -37,18 +37,35 @@ __export(src_exports, {
 });
 module.exports = __toCommonJS(src_exports);
 
-// src/utils/config-loader.ts
-var import_fs = require("fs");
+// src/utils/load-config.ts
+var import_fs2 = require("fs");
 var import_path = require("path");
 var import_url = require("url");
 
+// src/utils/load-typescript-config.ts
+var import_fs = require("fs");
+async function loadTypeScriptConfig(resolvedPath) {
+  const esbuild = await import("esbuild");
+  const source = (0, import_fs.readFileSync)(resolvedPath, "utf-8");
+  const result = esbuild.transformSync(source, {
+    loader: "ts",
+    format: "esm",
+    target: "node20",
+    sourcefile: resolvedPath
+  });
+  if (!result.code) {
+    throw new Error("Failed to transform TypeScript config file");
+  }
+  const dataUrl = `data:text/javascript;charset=utf-8,${encodeURIComponent(result.code)}`;
+  const module2 = await import(dataUrl);
+  return module2;
+}
+
 // src/utils/validations/generator-config.ts
 function validateGeneratorConfig(config, path) {
   if (typeof config !== "object" || config === null || Array.isArray(config)) {
-    throw new Error(
-      `Invalid generator config: must be an object
-Path: ${path}`
-    );
+    throw new Error(`Invalid generator config: must be an object
+Path: ${path}`);
   }
   const cfg = config;
   const requiredFields = [
@@ -90,10 +107,8 @@ Received: ${typeof cfg.postfix}`
 // src/utils/validations/url-schema.ts
 function validateUrlSchema(urlSchema, path) {
   if (typeof urlSchema !== "object" || urlSchema === null || Array.isArray(urlSchema)) {
-    throw new Error(
-      `Invalid generates entry: must be an object
-Path: ${path}`
-    );
+    throw new Error(`Invalid generates entry: must be an object
+Path: ${path}`);
   }
   const schema = urlSchema;
   for (const [filePath, generatorConfig] of Object.entries(schema)) {
@@ -110,10 +125,8 @@ Path: ${path}[${filePath}]`
 // src/utils/validations/config.ts
 function validateConfig(config, configPath) {
   if (typeof config !== "object" || config === null || Array.isArray(config)) {
-    throw new Error(
-      `Invalid config: must be an object
-Config file: ${configPath}`
-    );
+    throw new Error(`Invalid config: must be an object
+Config file: ${configPath}`);
   }
   const cfg = config;
   if (!("overwrite" in cfg)) {
@@ -151,12 +164,12 @@ Received: ${typeof generates}`
   }
 }
 
-// src/utils/config-loader.ts
+// src/utils/load-config.ts
 async function loadConfig(configPath) {
   const defaultConfigPath = "algolia-codegen.ts";
   const finalConfigPath = configPath || defaultConfigPath;
   const resolvedPath = (0, import_path.resolve)(process.cwd(), finalConfigPath);
-  if (!(0, import_fs.existsSync)(resolvedPath)) {
+  if (!(0, import_fs2.existsSync)(resolvedPath)) {
     throw new Error(
       `Config file not found: ${resolvedPath}
 Please create a config file or specify a different path using --config option.`
@@ -164,34 +177,38 @@ Please create a config file or specify a different path using --config option.`
   }
   const configUrl = (0, import_url.pathToFileURL)(resolvedPath).href;
   let configModule;
-  try {
-    configModule = await import(configUrl);
-  } catch (importError) {
-    const jsPath = resolvedPath.replace(/\.ts$/, ".js");
-    if ((0, import_fs.existsSync)(jsPath)) {
-      const jsUrl = (0, import_url.pathToFileURL)(jsPath).href;
-      try {
-        configModule = await import(jsUrl);
-      } catch (jsImportError) {
+  if (resolvedPath.endsWith(".ts")) {
+    try {
+      configModule = await loadTypeScriptConfig(resolvedPath);
+    } catch (tsError) {
+      const jsPath = resolvedPath.replace(/\.ts$/, ".js");
+      if ((0, import_fs2.existsSync)(jsPath)) {
+        const jsUrl = (0, import_url.pathToFileURL)(jsPath).href;
+        try {
+          configModule = await import(jsUrl);
+        } catch (jsImportError) {
+          throw new Error(
+            `Failed to import config file: ${resolvedPath}
+Tried both .ts (via esbuild) and .js extensions.
+TypeScript error: ${tsError instanceof Error ? tsError.message : String(tsError)}
+JavaScript error: ${jsImportError instanceof Error ? jsImportError.message : String(jsImportError)}`
+          );
+        }
+      } else {
         throw new Error(
-          `Failed to import config file: ${resolvedPath}
-Tried both .ts and .js extensions.
-Error: ${jsImportError instanceof Error ? jsImportError.message : String(jsImportError)}
-Note: If using TypeScript config, you may need to compile it first or use a tool like tsx.`
+          `Failed to load TypeScript config file: ${resolvedPath}
+Error: ${tsError instanceof Error ? tsError.message : String(tsError)}
+Make sure esbuild is installed as a dependency.`
         );
       }
-    } else {
+    }
+  } else {
+    try {
+      configModule = await import(configUrl);
+    } catch (importError) {
       const errorMessage = importError instanceof Error ? importError.message : String(importError);
-      const isTypeScriptError = resolvedPath.endsWith(".ts") && (errorMessage.includes("Cannot find module") || errorMessage.includes("Unknown file extension"));
-      throw new Error(
-        `Failed to import config file: ${resolvedPath}
-` + (isTypeScriptError ? `Node.js cannot directly import TypeScript files.
-Please either:
-  1. Compile your config to JavaScript (.js)
-  2. Use a tool like tsx to run the CLI: tsx algolia-codegen
-  3. Or use a JavaScript config file instead
-` : `Error: ${errorMessage}`)
-      );
+      throw new Error(`Failed to import config file: ${resolvedPath}
+Error: ${errorMessage}`);
     }
   }
   if (!configModule.default) {
@@ -212,8 +229,8 @@ Received: ${typeof config}`
 }
 
 // src/utils/fetch-algolia-data.ts
-var import_algoliasearch = __toESM(require("algoliasearch"), 1);
-var import_fs2 = require("fs");
+var import_algoliasearch = require("algoliasearch");
+var import_fs3 = require("fs");
 var import_path2 = require("path");
 
 // src/utils/generate-typescript-types.ts
@@ -320,7 +337,7 @@ var TypeGenerator = class {
       return `${this.prefix}Hit${this.postfix}`;
     }
     const lastPart = path[path.length - 1];
-    const parts = lastPart.replace(/[\[\]]/g, "").split(/[-_\s]+/).filter(Boolean);
+    const parts = lastPart.replace(/[[\]]/g, "").split(/[-_\s]+/).filter(Boolean);
     const pascalCase = parts.map((part) => part.charAt(0).toUpperCase() + part.slice(1).toLowerCase()).join("");
     if (path.length > 1) {
       const parent = path[path.length - 2];
@@ -476,7 +493,7 @@ async function fetchAlgoliaData(filePath, generatorConfig, overwrite) {
   console.log(`
 Processing file: ${filePath}`);
   const resolvedPath = (0, import_path2.resolve)(process.cwd(), filePath);
-  if ((0, import_fs2.existsSync)(resolvedPath) && !overwrite) {
+  if ((0, import_fs3.existsSync)(resolvedPath) && !overwrite) {
     throw new Error(
       `File already exists: ${resolvedPath}
 Set overwrite: true in config to allow overwriting existing files.`
@@ -486,10 +503,7 @@ Set overwrite: true in config to allow overwriting existing files.`
   console.log(`App ID: ${generatorConfig.appId}`);
   let client;
   try {
-    client = (0, import_algoliasearch.default)(
-      generatorConfig.appId,
-      generatorConfig.searchKey
-    );
+    client = (0, import_algoliasearch.algoliasearch)(generatorConfig.appId, generatorConfig.searchKey);
   } catch (error) {
     throw new Error(
       `Failed to initialize Algolia client: ${error instanceof Error ? error.message : String(error)}`
@@ -501,8 +515,8 @@ Set overwrite: true in config to allow overwriting existing files.`
     results = await client.search([
       {
         indexName: generatorConfig.indexName,
-        query: "",
         params: {
+          query: "",
           hitsPerPage: 1
         }
       }
@@ -543,10 +557,10 @@ Set overwrite: true in config to allow overwriting existing files.`
   console.log(`ObjectID: ${sampleHit.objectID || "N/A"}`);
   const fileContent = generateTypeScriptTypes(sampleHit, generatorConfig);
   const dir = (0, import_path2.dirname)(resolvedPath);
-  if (!(0, import_fs2.existsSync)(dir)) {
-    (0, import_fs2.mkdirSync)(dir, { recursive: true });
+  if (!(0, import_fs3.existsSync)(dir)) {
+    (0, import_fs3.mkdirSync)(dir, { recursive: true });
   }
-  (0, import_fs2.writeFileSync)(resolvedPath, fileContent, "utf-8");
+  (0, import_fs3.writeFileSync)(resolvedPath, fileContent, "utf-8");
   console.log(`Generated file: ${filePath}`);
 }
 

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   validateConfig,
   validateGeneratorConfig,
   validateUrlSchema
-} from "./chunk-4FWQJC54.js";
+} from "./chunk-4T5DZK75.js";
 export {
   main,
   validateConfig,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "algolia-codegen",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Generate TypeScript types from Algolia indices",
   "license": "MIT",
   "author": "nightlightmare",
@@ -37,17 +37,25 @@
     "dist"
   ],
   "dependencies": {
-    "algoliasearch": "^4.24.0",
-    "commander": "^12.0.0"
+    "algoliasearch": "^5.46.2",
+    "commander": "^14.0.2",
+    "dotenv": "^17.2.3",
+    "esbuild": "^0.27.0",
+    "tsx": "^4.21.0"
   },
   "devDependencies": {
     "@types/node": "^25.0.3",
+    "@vitest/coverage-v8": "^2.1.8",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "^3.7.4",
     "tsup": "^8.0.0",
-    "tsx": "^4.21.0",
-    "typescript": "^5.4.0"
+    "typescript": "^5.4.0",
+    "typescript-eslint": "^8.50.1",
+    "vitest": "^2.1.8"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "publishConfig": {
     "access": "public"
@@ -56,6 +64,13 @@
     "build": "tsup",
     "dev": "tsup --watch",
     "clean": "rm -rf dist",
-    "type-check": "tsc --noEmit"
+    "type-check": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
   }
 }