refactor: replace textExtensions with customLoaders and enhance test cases

Author: mayank1513

.changeset/upgrade.md

@@ -0,0 +1,17 @@
+---
+esbuild-raw-plugin: minor
+---
+
+### ✨ Enhancements
+
+- Replaced `textExtensions` with `customLoaders` for fine-grained extension-to-loader mapping.
+- Introduced `name` option for overriding the plugin name (useful for debugging or deduplication).
+- Added support for multiple query-based loaders: `?text`, `?base64`, `?dataurl`, `?file`, `?binary`.
+- Improved fallback logic for resolving files: now tries extensions or `index.[ext]` for folders.
+- Regex-based `onLoad` filtering boosts performance (leveraging Go-native ESBuild internals).
+
+### 🛠 Internal Refactors
+
+- Code refactored for better readability and maintainability.
+- Error messages are now clearer and more actionable.
+- Switched to consistent plugin naming (`"esbuild-raw-plugin"` instead of randomized suffix).

.gitignore

@@ -3,7 +3,7 @@ node_modules
 .turbo
 *.log
 .next
-dist
+dist*
 dist-ssr
 *.local
 .env

lib/__tests__/index.test.ts

@@ -46,7 +46,7 @@ describe("Raw plugin", () => {
   test("textExtensions", async ({ expect }) => {
     await esbuild.build({
       ...buildOptions,
-      plugins: [raw({ textExtensions: [".md"] })],
+      plugins: [raw({ customLoaders: { md: "text" } })],
       entryPoints: [path.resolve(__dirname, "test3.ts")],
     });
 
@@ -56,15 +56,45 @@ describe("Raw plugin", () => {
     expect(fileContent).toBe(generatedCodeContent);
   });
 
+  test("uses custom loader if provided", async ({ expect }) => {
+    await esbuild.build({
+      ...buildOptions,
+      entryPoints: [path.resolve(__dirname, "test-loader.ts")],
+      plugins: [raw({ loader: "base64" })],
+      outdir: "__tests__/dist2",
+    });
+    const fileContent = fs.readFileSync(path.resolve(__dirname, "../src/index.ts"));
+    // @ts-ignore
+    const generatedCodeContent = (await import("./dist2/test-loader.js")).getText();
+    expect(generatedCodeContent).toBe(fileContent.toString("base64"));
+  });
+
+  test("uses customLoaders mapping for extension", async ({ expect }) => {
+    await esbuild.build({
+      ...buildOptions,
+      plugins: [raw({ customLoaders: { md: "text" } })],
+      entryPoints: [path.resolve(__dirname, "test3.ts")],
+      outdir: "__tests__/dist3",
+    });
+    const fileContent = fs.readFileSync(path.resolve(__dirname, "test.md"), "utf-8");
+    // @ts-ignore
+    const generatedCodeContent = (await import("./dist3/test3.js")).getText();
+    expect(generatedCodeContent).toBe(fileContent);
+  });
+
+  test("uses custom plugin name if provided", ({ expect }) => {
+    const plugin = raw({ name: "custom-plugin-name" });
+    expect(plugin.name).toBe("custom-plugin-name");
+  });
   test("custom loader", async ({ expect }) => {
     await esbuild.build({
       ...buildOptions,
       entryPoints: [path.resolve(__dirname, "test-loader.ts")],
       plugins: [raw({ loader: "base64" })],
     });
-    const fileContent = fs.readFileSync(path.resolve(__dirname, "../src/index.ts"), "utf-8");
+    const fileContent = fs.readFileSync(path.resolve(__dirname, "../src/index.ts"));
     // @ts-ignore
     const generatedCodeContent = (await import("./dist/test-loader.js")).getText();
-    expect(fileContent).toBe(atob(generatedCodeContent));
+    expect(generatedCodeContent).toBe(fileContent.toString("base64"));
   });
 });