@9apes/cli 0.1.0

package/README.md

@@ -0,0 +1,145 @@
+# @9apes/cli
+
+**Sourcemap tooling by [9Apes](https://9apes.com)**
+
+> Inject debug IDs into your JavaScript bundles and upload source maps to the 9Apes platform -- as a CLI or a Vite plugin.
+
+---
+
+## Overview
+
+`@9apes/cli` connects your production builds to the 9Apes error tracking pipeline. It generates unique debug IDs, injects them into compiled JavaScript files and their source maps, then uploads everything to your 9Apes project so stack traces can be un-minified in the dashboard.
+
+**A valid 9Apes API key is required.** Get yours at [9apes.com](https://9apes.com).
+
+### Two ways to use it
+
+| Method | Best for |
+| --- | --- |
+| **Vite plugin** (`@9apes/cli/vite`) | Vite-based apps -- runs automatically at the end of `vite build` |
+| **CLI** (`apesdev-cli` / `apeslocal-cli`) | Any build tool -- run as a post-build step |
+
+---
+
+## Installation
+
+```bash
+pnpm add -D @9apes/cli
+```
+
+---
+
+## Vite Plugin
+
+Add `withNineapesSourcemaps` to your Vite config and remove any manual post-build CLI step -- the plugin handles injection and upload automatically when `vite build` finishes.
+
+```typescript
+// vite.config.ts
+import { defineConfig } from 'vite';
+import vue from '@vitejs/plugin-vue';
+import { withNineapesSourcemaps } from '@9apes/cli/vite';
+
+export default defineConfig({
+  plugins: [
+    vue(),
+    withNineapesSourcemaps({
+      projectId: 'my-project',
+      apiKey: 'YOUR_API_KEY',
+    }),
+  ],
+  build: {
+    sourcemap: true,
+  },
+});
+```
+
+### Options
+
+| Option | Type | Required | Description |
+| --- | --- | --- | --- |
+| `projectId` | `string` | Yes | Project identifier in your 9Apes dashboard |
+| `apiKey` | `string` | Yes | 9Apes API key |
+| `baseUrl` | `string` | No | API base URL (defaults to `https://dev.nineapes.com/api/v1`) |
+| `releaseVersion` | `string` | No | Tag uploads with a release version |
+
+> Make sure `build.sourcemap` is `true` in your Vite config -- the plugin needs `.js.map` files to work.
+
+---
+
+## CLI Usage
+
+Two binaries are provided for different environments:
+
+| Binary | API endpoint | Config file |
+| --- | --- | --- |
+| `apesdev-cli` | `https://dev.nineapes.com/api/v1` | `config-dev.json` |
+| `apeslocal-cli` | `http://127.0.0.1:8000/api/v1` | `config-local.json` |
+
+Both CLIs share the same command structure.
+
+### `config set [apikey]`
+
+Save an API key for subsequent commands.
+
+```bash
+apesdev-cli config set              # interactive prompt
+apesdev-cli config set YOUR_KEY     # inline
+```
+
+### `config show`
+
+Display the currently saved API key.
+
+```bash
+apesdev-cli config show
+```
+
+### `sourcemaps inject <path>`
+
+Inject debug IDs and upload source maps from a build output directory.
+
+```bash
+apesdev-cli sourcemaps inject ./dist --projectid my-project
+apesdev-cli sourcemaps inject ./dist --projectid my-project --release-version 1.2.0
+apesdev-cli sourcemaps inject ./dist --projectid my-project --apikey YOUR_KEY
+```
+
+| Argument / Option | Required | Description |
+| --- | --- | --- |
+| `<path>` | Yes | Directory containing `.js` and `.js.map` files |
+| `--projectid <id>` | Yes | Project identifier |
+| `--release-version <version>` | No | Release version tag |
+| `--apikey <key>` | No | API key (overrides saved config) |
+
+---
+
+## How It Works
+
+1. Scans the output directory for `.js` and `.js.map` file pairs
+2. Generates a unique UUID (debug ID) per file pair
+3. Injects a small runtime snippet into each `.js` file that maps stack traces to its debug ID
+4. Adds a `debug_id` field to each `.js.map` file
+5. Uploads both files to 9Apes with project ID, release version, and git commit hash
+6. The 9Apes dashboard uses these debug IDs to match production errors to their original source maps
+
+---
+
+## License
+
+This software is proprietary and provided under a commercial license by **9Apes Technologies**.
+Unauthorized copying, modification, distribution, or use of this software outside the terms
+of your subscription agreement is strictly prohibited.
+
+Refer to your service agreement or contact [support@9apes.com](mailto:support@9apes.com) for licensing details.
+
+---
+
+## Support
+
+| Channel | Details |
+| --- | --- |
+| Documentation | [docs.9apes.com](https://docs.9apes.com) |
+| Email | [support@9apes.com](mailto:support@9apes.com) |
+| Dashboard | [app.9apes.com](https://dash.9apes.com) |
+
+For enterprise support plans and SLAs, contact your account manager.

package/dist/command.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Setup commands for the CLI program
+ * @param configFileName - Name of the config file (e.g., 'config-local.json' or 'config-dev.json')
+ * @param baseUrl - Base URL for the API (e.g., 'http://127.0.0.1:8000/api/v1' or 'https://dev.nineapes.com/api/v1')
+ * @param cliName - Name of the CLI for error messages (e.g., 'apeslocal-cli' or 'apesdev-cli')
+ */
+export declare function setupCommands(configFileName: string, baseUrl: string, cliName: string): void;
+//# sourceMappingURL=command.d.ts.map

package/dist/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,QAuFrF"}

package/dist/command.js

@@ -0,0 +1,90 @@
+import { program } from 'commander';
+import { input } from '@inquirer/prompts';
+import { loadConfig, saveConfig } from './config.js';
+import { injectDebugIdsAndUpload } from './sourcemap.js';
+/**
+ * Setup commands for the CLI program
+ * @param configFileName - Name of the config file (e.g., 'config-local.json' or 'config-dev.json')
+ * @param baseUrl - Base URL for the API (e.g., 'http://127.0.0.1:8000/api/v1' or 'https://dev.nineapes.com/api/v1')
+ * @param cliName - Name of the CLI for error messages (e.g., 'apeslocal-cli' or 'apesdev-cli')
+ */
+export function setupCommands(configFileName, baseUrl, cliName) {
+    // Config command with subcommands
+    const configCommand = program
+        .command('config')
+        .description('Manage configuration');
+    // Config set subcommand
+    configCommand
+        .command('set')
+        .description('Set API key')
+        .argument('[apikey]', 'API key (optional, will prompt if not provided)')
+        .action(async (apikey) => {
+        try {
+            let finalApiKey = apikey;
+            if (!finalApiKey) {
+                finalApiKey = await input({
+                    message: 'Enter your API key:',
+                });
+            }
+            const configPath = saveConfig({ apiKey: finalApiKey }, configFileName);
+            console.log('✅ API key saved successfully at : ' + configPath);
+        }
+        catch (error) {
+            console.error('❌ Error setting API key:', error);
+            process.exit(1);
+        }
+    });
+    // Config show subcommand
+    configCommand
+        .command('show')
+        .description('Show current API key')
+        .action(() => {
+        try {
+            const config = loadConfig(configFileName);
+            if (!config) {
+                console.log(`❌ No configuration found. Run "${cliName} config set" to set your API key.`);
+                process.exit(1);
+            }
+            console.log('Current API key:', config.apiKey);
+        }
+        catch (error) {
+            console.error('❌ Error reading config:', error);
+            process.exit(1);
+        }
+    });
+    // Sourcemaps command with subcommands
+    const sourcemapsCommand = program
+        .command('sourcemaps')
+        .description('Manage source maps');
+    // Sourcemaps inject subcommand
+    sourcemapsCommand
+        .command('inject')
+        .description('Inject debug IDs into JavaScript files and source maps')
+        .argument('<path>', 'Directory path to process')
+        .requiredOption('--projectid <id>', 'Project ID (required)')
+        .option('--release-version <version>', 'Release version (optional)')
+        .option('--apikey <apikey>', 'Api key (optional, if config not set)')
+        .action(async (path, options) => {
+        try {
+            // Load configuration
+            const config = loadConfig(configFileName);
+            const apiKey = options.apikey || config?.apiKey;
+            if (!apiKey) {
+                console.log(`❌ No API key found. Run "${cliName} config set" to set your API key or use --apikey <apikey> to set the API key.`);
+                process.exit(1);
+            }
+            // Validate path parameter
+            if (!path) {
+                console.log('❌ Path argument is required.');
+                process.exit(1);
+            }
+            // Inject debug IDs into JavaScript files and source maps
+            await injectDebugIdsAndUpload(path, { apiKey }, options.projectid, baseUrl, options.releaseVersion);
+        }
+        catch (error) {
+            console.error('❌ Error processing sourcemaps:', error);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=command.js.map

package/dist/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,7 @@
+export interface Config {
+    apiKey: string;
+}
+export declare function getConfigPath(configFileName: string): string;
+export declare function loadConfig(configFileName: string): Config | null;
+export declare function saveConfig(config: Config, configFileName: string): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAahE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAiBzE"}

package/dist/config.js

@@ -0,0 +1,37 @@
+import * as fs from 'fs';
+import * as path from 'path';
+export function getConfigPath(configFileName) {
+    return path.join(process.cwd(), configFileName);
+}
+export function loadConfig(configFileName) {
+    try {
+        const configPath = getConfigPath(configFileName);
+        if (!fs.existsSync(configPath)) {
+            return null;
+        }
+        const configData = fs.readFileSync(configPath, 'utf8');
+        return JSON.parse(configData);
+    }
+    catch (error) {
+        console.error('Error loading config:', error);
+        return null;
+    }
+}
+export function saveConfig(config, configFileName) {
+    try {
+        const configPath = getConfigPath(configFileName);
+        const configDir = path.dirname(configPath);
+        // Create directory if it doesn't exist
+        if (!fs.existsSync(configDir)) {
+            fs.mkdirSync(configDir, { recursive: true });
+        }
+        // Write config file
+        fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+        return configPath;
+    }
+    catch (error) {
+        console.error('Error saving config:', error);
+        throw error;
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAM7B,MAAM,UAAU,aAAa,CAAC,cAAsB;IAClD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,cAAsB;IAC/C,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;QACjD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAW,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,cAAsB;IAC/D,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAE3C,uCAAuC;QACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,oBAAoB;QACpB,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9D,OAAO,UAAU,CAAC;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;QAC7C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/index-dev.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index-dev.d.ts.map

package/dist/index-dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-dev.d.ts","sourceRoot":"","sources":["../src/index-dev.ts"],"names":[],"mappings":""}

package/dist/index-dev.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { program } from 'commander';
+import { setupCommands } from './command.js';
+// CLI version and description
+program
+    .name('apesdev-cli')
+    .description('A CLI tool for dev environment')
+    .version('1.0.0');
+// Setup commands with dev mode
+setupCommands('config-dev.json', 'https://dev.nineapes.com/api/v1', 'apesdev-cli');
+// Parse command line arguments
+program.parse();
+//# sourceMappingURL=index-dev.js.map

package/dist/index-dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-dev.js","sourceRoot":"","sources":["../src/index-dev.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,8BAA8B;AAC9B,OAAO;KACJ,IAAI,CAAC,aAAa,CAAC;KACnB,WAAW,CAAC,gCAAgC,CAAC;KAC7C,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,+BAA+B;AAC/B,aAAa,CAAC,iBAAiB,EAAE,iCAAiC,EAAE,aAAa,CAAC,CAAC;AAEnF,+BAA+B;AAC/B,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/index-local.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index-local.d.ts.map

package/dist/index-local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-local.d.ts","sourceRoot":"","sources":["../src/index-local.ts"],"names":[],"mappings":""}

package/dist/index-local.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { program } from 'commander';
+import { setupCommands } from './command.js';
+// CLI version and description
+program
+    .name('apeslocal-cli')
+    .description('A CLI tool for local development environment')
+    .version('1.0.0');
+// Setup commands with local mode
+setupCommands('config-local.json', 'http://127.0.0.1:8000/api/v1', 'apeslocal-cli');
+// Parse command line arguments
+program.parse();
+//# sourceMappingURL=index-local.js.map

package/dist/index-local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-local.js","sourceRoot":"","sources":["../src/index-local.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,8BAA8B;AAC9B,OAAO;KACJ,IAAI,CAAC,eAAe,CAAC;KACrB,WAAW,CAAC,8CAA8C,CAAC;KAC3D,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,iCAAiC;AACjC,aAAa,CAAC,mBAAmB,EAAE,8BAA8B,EAAE,eAAe,CAAC,CAAC;AAEpF,+BAA+B;AAC/B,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import './command.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { program } from 'commander';
+import './command.js';
+// CLI version and description
+program
+    .name('apes-cli')
+    .description('A CLI tool built with TypeScript')
+    .version('1.0.0');
+// Parse command line arguments
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,cAAc,CAAC;AAEtB,8BAA8B;AAC9B,OAAO;KACJ,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CAAC,kCAAkC,CAAC;KAC/C,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,+BAA+B;AAC/B,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/inject.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Inject debug ID into JavaScript file
+ * @param jsFile - Path to JavaScript file
+ * @param debugIdSnippet - Debug ID snippet to inject
+ * @param debugId - Debug ID
+ */
+export declare function injectDebugIdIntoFile(jsFile: string, debugIdSnippet: string, debugId: string): Promise<void>;
+/**
+ * Inject debug ID into source map file
+ * @param mapFile - Path to source map file
+ * @param debugId - Debug ID to inject
+ */
+export declare function injectDebugIdIntoMapFile(mapFile: string | null, debugId: string): Promise<void>;
+//# sourceMappingURL=inject.d.ts.map

package/dist/inject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject.d.ts","sourceRoot":"","sources":["../src/inject.ts"],"names":[],"mappings":"AAkHA;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAID;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CA+Bf"}

package/dist/inject.js

@@ -0,0 +1,161 @@
+import { promises as fs } from 'fs';
+/**
+ * Read file as buffer and decode to UTF-8 with automatic BOM stripping
+ * @param jsFile - Path to JavaScript file
+ * @returns File content as UTF-8 string
+ */
+async function readFileAsUtf8(jsFile) {
+    const buffer = await fs.readFile(jsFile);
+    const decoder = new TextDecoder('utf-8');
+    return decoder.decode(buffer);
+}
+/**
+ * Find existing debug ID snippet in file content
+ * @param content - File content to search
+ * @returns Object with debug ID and its index if found, null otherwise
+ */
+function findExistingDebugId(content) {
+    const debugIdPattern = /_apesDebugIdIdentifier="apes-dbid-([^"]+)"/;
+    const match = content.match(debugIdPattern);
+    if (!match || match.index === undefined) {
+        return null;
+    }
+    return {
+        id: match[1],
+        index: match.index,
+    };
+}
+/**
+ * Find the start position of the debug ID snippet
+ * @param content - File content to search
+ * @param debugIdIndex - Index where the debug ID identifier is found
+ * @returns Start index of the snippet, or -1 if not found
+ */
+function findSnippetStart(content, debugIdIndex) {
+    const snippetStartMarker = ';{try{';
+    for (let i = debugIdIndex; i >= 0; i--) {
+        if (content.slice(i, i + snippetStartMarker.length) === snippetStartMarker) {
+            return i;
+        }
+    }
+    return -1;
+}
+/**
+ * Find the end position of the debug ID snippet
+ * @param content - File content to search
+ * @param debugIdIndex - Index where the debug ID identifier is found
+ * @returns End index (exclusive) of the snippet, or -1 if not found
+ */
+function findSnippetEnd(content, debugIdIndex) {
+    const snippetEndMarker = '};';
+    for (let i = debugIdIndex; i < content.length; i++) {
+        if (content.slice(i, i + snippetEndMarker.length) === snippetEndMarker && i > debugIdIndex) {
+            return i + snippetEndMarker.length;
+        }
+    }
+    return -1;
+}
+/**
+ * Remove existing debug ID snippet from file content
+ * @param content - File content
+ * @param existingDebugId - Object containing the existing debug ID and its index
+ * @returns Content with the snippet removed
+ */
+function removeExistingSnippet(content, existingDebugId) {
+    const snippetStart = findSnippetStart(content, existingDebugId.index);
+    const snippetEnd = findSnippetEnd(content, existingDebugId.index);
+    if (snippetStart >= 0 && snippetEnd > snippetStart) {
+        return content.slice(0, snippetStart) + content.slice(snippetEnd);
+    }
+    return content;
+}
+/**
+ * Calculate the insertion position for the debug ID snippet
+ * Inserts after shebang (if present) and/or "use strict" directive (if present)
+ * @param content - File content
+ * @returns Index where the snippet should be inserted
+ */
+function calculateInsertionPosition(content) {
+    let position = 0;
+    let insertPosition = 0;
+    // Check for shebang (must be at start, ends at first newline)
+    const shebangMatch = content.match(/^#!.*(\r?\n)?/);
+    if (shebangMatch) {
+        position += shebangMatch[0].length;
+        insertPosition = position;
+    }
+    // Check for "use strict" after shebang
+    // Pattern: optional whitespace, then "use strict" with quotes, optional semicolon, optional whitespace
+    const useStrictPattern = /^\s*["']use strict["'];?\s*/;
+    const remainingContent = content.slice(position);
+    const useStrictMatch = remainingContent.match(useStrictPattern);
+    if (useStrictMatch) {
+        insertPosition = position + useStrictMatch[0].length;
+    }
+    return insertPosition;
+}
+/**
+ * Inject debug ID into JavaScript file
+ * @param jsFile - Path to JavaScript file
+ * @param debugIdSnippet - Debug ID snippet to inject
+ * @param debugId - Debug ID
+ */
+export async function injectDebugIdIntoFile(jsFile, debugIdSnippet, debugId) {
+    try {
+        let content = await readFileAsUtf8(jsFile);
+        const existingDebugId = findExistingDebugId(content);
+        // If existing debug ID matches the one to inject, skip injection
+        if (existingDebugId && existingDebugId.id === debugId) {
+            return;
+        }
+        // If different debug ID exists, remove the old snippet
+        if (existingDebugId) {
+            content = removeExistingSnippet(content, existingDebugId);
+        }
+        // Calculate insertion position and inject the new snippet
+        const insertPosition = calculateInsertionPosition(content);
+        const before = content.slice(0, insertPosition);
+        const after = content.slice(insertPosition);
+        const modifiedContent = before + debugIdSnippet + after;
+        // Write back to file
+        await fs.writeFile(jsFile, modifiedContent, 'utf-8');
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to inject debug ID into ${jsFile}: ${errorMessage}`);
+    }
+}
+/**
+ * Inject debug ID into source map file
+ * @param mapFile - Path to source map file
+ * @param debugId - Debug ID to inject
+ */
+export async function injectDebugIdIntoMapFile(mapFile, debugId) {
+    try {
+        if (!mapFile) {
+            return;
+        }
+        const content = await fs.readFile(mapFile, 'utf-8');
+        let sourcemap;
+        try {
+            sourcemap = JSON.parse(content);
+        }
+        catch (parseError) {
+            throw new Error(`Invalid JSON in sourcemap file: ${parseError}`);
+        }
+        // Skip if already has the same debug_id
+        if (sourcemap.debug_id === debugId) {
+            return;
+        }
+        // Add the debug_id field
+        sourcemap.debug_id = debugId;
+        // Use compact JSON (no pretty-printing)
+        const modifiedContent = JSON.stringify(sourcemap);
+        await fs.writeFile(mapFile, modifiedContent, 'utf-8');
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to inject debug ID into ${mapFile}: ${errorMessage}`);
+    }
+}
+//# sourceMappingURL=inject.js.map

package/dist/inject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject.js","sourceRoot":"","sources":["../src/inject.ts"],"names":[],"mappings":"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"}

package/dist/sourcemap.d.ts

@@ -0,0 +1,48 @@
+import { Config } from './config.js';
+/**
+ * Represents a pair of JavaScript file and its corresponding source map file
+ */
+export interface FilePair {
+    jsFile: string;
+    mapFile: string | null;
+}
+/**
+ * Validate and resolve a directory path
+ * @param dirPath - Directory path to validate
+ * @returns Resolved absolute path
+ * @throws Error if path doesn't exist, isn't a directory, or lacks permissions
+ */
+export declare function validateDirectoryPath(dirPath: string): Promise<string>;
+/**
+ * Scan directory for JavaScript files and their corresponding source maps
+ * @param dirPath - Directory path to scan
+ * @returns Tuple containing file pairs with both .js and .js.map files, and JS files without maps
+ */
+export declare function scanForJavaScriptFiles(dirPath: string): Promise<FilePair[]>;
+/**
+ * Get the current Git commit hash (HEAD)
+ * @param dirPath - Directory path to check for git repository
+ * @returns Git commit hash or undefined if not available
+ */
+export declare function getGitCommitHash(dirPath: string): Promise<string | undefined>;
+/**
+ * Generate a unique debug ID using UUID v4
+ * @returns UUID string
+ */
+export declare function generateDebugId(): string;
+/**
+ * Get the debug ID snippet for the given debug ID
+ * @param debugId - Debug ID to get the snippet for
+ * @returns Debug ID snippet
+ */
+export declare function getDebugIdSnippet(debugId: string): string;
+/**
+ * Inject debug IDs into JavaScript files and their corresponding source maps
+ * @param dirPath - Directory path to process
+ * @param config - Configuration object containing API key
+ * @param projectId - Project ID (required)
+ * @param baseUrl - Base URL for the API
+ * @param releaseVersion - Release version (optional)
+ */
+export declare function injectDebugIdsAndUpload(dirPath: string, config: Config, projectId: string, baseUrl: string, releaseVersion?: string): Promise<void>;
+//# sourceMappingURL=sourcemap.d.ts.map

package/dist/sourcemap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourcemap.d.ts","sourceRoot":"","sources":["../src/sourcemap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAerC;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA0B5E;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAwCjF;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAenF;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAID;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,CA6Jf"}