@vinktarhq/cli 0.1.0

package/dist/vite.js

@@ -0,0 +1,166 @@
+import { isAbsolute, join } from 'node:path';
+import { detectRelease, disabled, session } from './bundler/core.js';
+import { repairChunks, stampChunk, writeMaps } from './bundler/rollup.js';
+export function vinktar(options = {}) {
+    if (disabled(options))
+        return inert();
+    let env = {};
+    let release = '';
+    let outDir = '';
+    let base = '/';
+    let building = false;
+    const tracked = new Map();
+    const repaired = new Set();
+    let run = null;
+    const deleting = options.deleteSourcemapsAfterUpload ?? options.uploadSourcemaps !== false;
+    const stamping = options.injectDebugIds !== false;
+    return {
+        name: 'vinktar',
+        async config(rawConfig, rawEnv) {
+            const userConfig = rawConfig;
+            const { command, mode } = rawEnv;
+            // loadEnv is imported lazily so this module stays importable outside a Vite process.
+            const { loadEnv } = await import('vite');
+            env = loadEnv(mode, userConfig.root ?? process.cwd(), 'VINKTAR_');
+            // Only a build needs a release, and resolving one can shell out to git — not something to do
+            // on every dev-server start.
+            release = options.release ?? (command === 'build' ? detectRelease({ ...process.env, ...env }) : '');
+            const define = {
+                'import.meta.env.VINKTAR_KEY': JSON.stringify(env['VINKTAR_KEY'] ?? ''),
+                'import.meta.env.VINKTAR_HOST': JSON.stringify(env['VINKTAR_HOST'] ?? ''),
+                'import.meta.env.VINKTAR_ENVIRONMENT': JSON.stringify(env['VINKTAR_ENVIRONMENT'] ?? ''),
+                'import.meta.env.VINKTAR_RELEASE': JSON.stringify(release),
+            };
+            if (command !== 'build')
+                return { define };
+            const chosen = userConfig.build?.sourcemap;
+            if (chosen === 'inline') {
+                console.warn('[vinktar] build.sourcemap is "inline", so the maps are inside the chunks and cannot be uploaded. Use true or "hidden".');
+                return { define };
+            }
+            if (chosen === false) {
+                console.warn('[vinktar] build.sourcemap is false, so there is nothing to upload and no frame will resolve.');
+                return { define };
+            }
+            // 'hidden': maps exist for the upload, chunks carry no sourceMappingURL comment. Forced over
+            // an explicit `true` only while the maps are being deleted afterwards — a comment pointing at
+            // a file that is about to be removed is a 404 in every devtools session. Keep the maps
+            // (`deleteSourcemapsAfterUpload: false`) and `true` is left exactly as configured.
+            if (chosen === undefined || (chosen === true && deleting)) {
+                return { define, build: { sourcemap: 'hidden' } };
+            }
+            return { define };
+        },
+        configResolved(raw) {
+            const resolved = raw;
+            building = resolved.command === 'build';
+            base = resolved.base;
+            outDir = isAbsolute(resolved.build.outDir) ? resolved.build.outDir : join(resolved.root, resolved.build.outDir);
+        },
+        /**
+         * A watch rebuild can land on a different commit than the one the process started on, and a
+         * stale release is worse than none: the maps go up under a name the running application does
+         * not report. Cheap enough to redo — one `git rev-parse`, and only when nothing pinned it.
+         */
+        buildStart() {
+            if (!building)
+                return;
+            tracked.clear();
+            repaired.clear();
+            if (options.release === undefined && (env['VINKTAR_RELEASE'] ?? '') === '') {
+                release = detectRelease({ ...process.env, ...env });
+            }
+            run = session({ urlPrefix: base, ...options, release }, { ...process.env, ...env });
+        },
+        /**
+         * `order: 'post'` is load-bearing, not tidiness.
+         *
+         * Minification is itself a `renderChunk` hook, and esbuild strips any comment that is not
+         * `sourceMappingURL`. Running before it meant the `//# debugId=` line was deleted on every
+         * minified build, so the uploader could not read the id back — it re-derived one from the
+         * minified bytes instead and filed the map under an id no stack frame would ever report.
+         * Running last means the id is stamped into the final bytes, and still before Rollup computes
+         * the content hash in the filename.
+         */
+        renderChunk: {
+            order: 'post',
+            handler(code, chunk) {
+                if (!building || !stamping)
+                    return null;
+                return stampChunk(code, chunk, tracked, this);
+            },
+        },
+        /**
+         * Shift each map by the line the snippet took, and restore the comment the minifier stripped.
+         *
+         * `order: 'pre'` because Vite's own `vite:build-import-analysis` runs here too, and it
+         * re-combines the entry chunk's map with one measured against the code INCLUDING our line.
+         * Handing it a map that is a line short collapses that chunk's mappings to nothing.
+         */
+        generateBundle: {
+            order: 'pre',
+            handler(_options, bundle) {
+                if (!building)
+                    return;
+                repairChunks(bundle, tracked);
+            },
+        },
+        /**
+         * `writeBundle`, not `closeBundle`, because it is handed the output options — and the output
+         * directory is not always Vite's `build.outDir`. A config that sets
+         * `rollupOptions.output.dir` (a theme extension writing straight into `assets/`, say) leaves
+         * `build.outDir` at its default, so scanning that found an empty or missing directory and
+         * uploaded nothing, silently, on every build.
+         *
+         * Called once per output, and every one of them is uploaded. The previous version latched on
+         * the directory and returned early for the rest, so `@vitejs/plugin-legacy`'s second output —
+         * the chunks actually served to the browsers most likely to produce an unreadable stack — was
+         * never sent.
+         */
+        async writeBundle(rawOptions, bundle) {
+            if (!building)
+                return;
+            const dir = directoryOf(rawOptions) || outDir;
+            if (dir === '')
+                return;
+            // The maps are written again from the bundle, because Rollup emits a chunk's map from the
+            // reference it captured while rendering — an edit made in `generateBundle` reaches every
+            // other plugin and never reaches the file.
+            await writeMaps(dir, bundle, tracked, repaired);
+            // `buildStart` normally creates it; a plugin added to an already-running build might not
+            // have seen that hook, and an upload that silently does not happen is the whole problem.
+            run ??= session({ urlPrefix: base, ...options, release }, { ...process.env, ...env });
+            await run.upload(dir);
+            await run.cleanup();
+        },
+        async closeBundle() {
+            await run?.cleanup();
+        },
+    };
+}
+/**
+ * The plugin that does nothing, for `disable: true`.
+ *
+ * Vite configs are reused by vitest and Storybook, and both would otherwise pay for `loadEnv`, a
+ * `git rev-parse` and a walk of a directory they never built.
+ */
+function inert() {
+    return {
+        name: 'vinktar',
+        config: async () => ({ define: {} }),
+        configResolved: () => { },
+        buildStart: () => { },
+        renderChunk: { order: 'post', handler: () => null },
+        generateBundle: { order: 'pre', handler: () => { } },
+        writeBundle: async () => { },
+        closeBundle: async () => { },
+    };
+}
+/** Rollup's own output directory, which is the one the files were actually written to. */
+function directoryOf(rawOptions) {
+    const dir = rawOptions?.dir;
+    if (typeof dir !== 'string' || dir === '')
+        return '';
+    return isAbsolute(dir) ? dir : join(process.cwd(), dir);
+}
+//# sourceMappingURL=vite.js.map

package/dist/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.js","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"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","sourcesContent":["import { isAbsolute, join } from 'node:path';\n\nimport { detectRelease, disabled, session, type BundlerOptions, type Session } from './bundler/core.js';\nimport { repairChunks, stampChunk, writeMaps, type ChunkStamp } from './bundler/rollup.js';\n\n/**\n * The plugin's shape, declared here rather than imported as Vite's `Plugin`.\n *\n * Two copies of Vite's types at different patch versions — the consumer's and this package's —\n * are structurally identical and nominally incompatible, so importing `Plugin` makes\n * `plugins: [vinktar()]` fail to typecheck for anyone whose lockfile resolves a different patch\n * than ours. Structural typing has no such problem, and it also means this package's public types\n * do not depend on `vite` at all.\n */\nexport interface VitePlugin {\n  name: string;\n  /**\n   * `unknown` parameters, deliberately, and it is the direction that matters: a hook which accepts\n   * ANYTHING can stand in for one Vite will call with its own config types, whatever version those\n   * come from. A hook typed against a narrower shape cannot — which is the whole failure this\n   * exists to avoid, and `never` (the first thing that looks right) has exactly the wrong variance.\n   */\n  config(userConfig: unknown, env: unknown): Promise<{\n    define: Record<string, string>;\n    build?: { sourcemap: 'hidden' };\n  }>;\n  configResolved(resolved: unknown): void;\n  buildStart(): void;\n  renderChunk: {\n    order: 'post';\n    handler(this: unknown, code: string, chunk: unknown): { code: string; map: null } | null;\n  };\n  generateBundle: { order: 'pre'; handler(options: unknown, bundle: Record<string, unknown>): void };\n  writeBundle(options: unknown, bundle: Record<string, unknown>): Promise<void>;\n  closeBundle(): Promise<void>;\n}\n\n/** What the plugin actually reads out of Vite's config, and nothing more. */\ninterface UserConfigShape {\n  root?: string | undefined;\n  build?: { sourcemap?: unknown } | undefined;\n}\n\ninterface ResolvedConfigShape {\n  command: string;\n  base: string;\n  root: string;\n  build: { outDir: string };\n}\n\n/**\n * The Vite side of Vinktar, as one plugin.\n *\n * ```ts\n * // vite.config.ts\n * import { vinktar } from '@vinktarhq/cli/vite';\n *\n * export default defineConfig({ plugins: [vinktar()] });\n * ```\n *\n * What it does, all driven by the same VINKTAR_* variables every other Vinktar SDK reads\n * (from the process env and Vite's .env files):\n *\n * - Exposes `import.meta.env.VINKTAR_KEY`, `VINKTAR_HOST`, `VINKTAR_ENVIRONMENT` and\n *   `VINKTAR_RELEASE` to the bundle, so `init({ key: import.meta.env.VINKTAR_KEY, … })` is the\n *   whole application-side setup. `VINKTAR_CLI_KEY` is NEVER exposed — a bundle is public.\n * - `VINKTAR_RELEASE` falls back to the CI commit, then the git SHA, so errors correlate to a\n *   deploy without anyone wiring a release string.\n * - Turns on `build.sourcemap: 'hidden'`.\n * - Stamps a debug id into each chunk **as it is rendered**, then after the build uploads the maps\n *   under the same release the bundle reports, and removes them from the output directory.\n *\n * ## Why injection is a `renderChunk` hook\n *\n * The previous version rewrote the files in `closeBundle`, after Vite had already written them.\n * That is after Rollup computed the content hash in each filename, after `vite-plugin-pwa` wrote\n * its precache revisions, and after any integrity or precompression plugin had run — so every one\n * of those recorded a hash of bytes that no longer existed on disk. A service worker built that\n * way serves a permanently stale chunk. Injecting during `renderChunk` makes the snippet part of\n * the artifact everything downstream measures.\n */\nexport interface VinktarPluginOptions extends BundlerOptions {}\n\nexport function vinktar(options: VinktarPluginOptions = {}): VitePlugin {\n  if (disabled(options)) return inert();\n\n  let env: Record<string, string> = {};\n  let release = '';\n  let outDir = '';\n  let base = '/';\n  let building = false;\n  const tracked = new Map<string, ChunkStamp>();\n  const repaired = new Set<string>();\n  let run: Session | null = null;\n\n  const deleting = options.deleteSourcemapsAfterUpload ?? options.uploadSourcemaps !== false;\n  const stamping = options.injectDebugIds !== false;\n\n  return {\n    name: 'vinktar',\n\n    async config(rawConfig: unknown, rawEnv: unknown) {\n      const userConfig = rawConfig as UserConfigShape;\n      const { command, mode } = rawEnv as { command: string; mode: string };\n\n      // loadEnv is imported lazily so this module stays importable outside a Vite process.\n      const { loadEnv } = await import('vite');\n      env = loadEnv(mode, userConfig.root ?? process.cwd(), 'VINKTAR_');\n      // Only a build needs a release, and resolving one can shell out to git — not something to do\n      // on every dev-server start.\n      release = options.release ?? (command === 'build' ? detectRelease({ ...process.env, ...env }) : '');\n\n      const define = {\n        'import.meta.env.VINKTAR_KEY': JSON.stringify(env['VINKTAR_KEY'] ?? ''),\n        'import.meta.env.VINKTAR_HOST': JSON.stringify(env['VINKTAR_HOST'] ?? ''),\n        'import.meta.env.VINKTAR_ENVIRONMENT': JSON.stringify(env['VINKTAR_ENVIRONMENT'] ?? ''),\n        'import.meta.env.VINKTAR_RELEASE': JSON.stringify(release),\n      };\n\n      if (command !== 'build') return { define };\n\n      const chosen = userConfig.build?.sourcemap;\n\n      if (chosen === 'inline') {\n        console.warn(\n          '[vinktar] build.sourcemap is \"inline\", so the maps are inside the chunks and cannot be uploaded. Use true or \"hidden\".',\n        );\n\n        return { define };\n      }\n\n      if (chosen === false) {\n        console.warn('[vinktar] build.sourcemap is false, so there is nothing to upload and no frame will resolve.');\n\n        return { define };\n      }\n\n      // 'hidden': maps exist for the upload, chunks carry no sourceMappingURL comment. Forced over\n      // an explicit `true` only while the maps are being deleted afterwards — a comment pointing at\n      // a file that is about to be removed is a 404 in every devtools session. Keep the maps\n      // (`deleteSourcemapsAfterUpload: false`) and `true` is left exactly as configured.\n      if (chosen === undefined || (chosen === true && deleting)) {\n        return { define, build: { sourcemap: 'hidden' as const } };\n      }\n\n      return { define };\n    },\n\n    configResolved(raw: unknown) {\n      const resolved = raw as ResolvedConfigShape;\n\n      building = resolved.command === 'build';\n      base = resolved.base;\n      outDir = isAbsolute(resolved.build.outDir) ? resolved.build.outDir : join(resolved.root, resolved.build.outDir);\n    },\n\n    /**\n     * A watch rebuild can land on a different commit than the one the process started on, and a\n     * stale release is worse than none: the maps go up under a name the running application does\n     * not report. Cheap enough to redo — one `git rev-parse`, and only when nothing pinned it.\n     */\n    buildStart() {\n      if (!building) return;\n\n      tracked.clear();\n      repaired.clear();\n      if (options.release === undefined && (env['VINKTAR_RELEASE'] ?? '') === '') {\n        release = detectRelease({ ...process.env, ...env });\n      }\n      run = session({ urlPrefix: base, ...options, release }, { ...process.env, ...env });\n    },\n\n    /**\n     * `order: 'post'` is load-bearing, not tidiness.\n     *\n     * Minification is itself a `renderChunk` hook, and esbuild strips any comment that is not\n     * `sourceMappingURL`. Running before it meant the `//# debugId=` line was deleted on every\n     * minified build, so the uploader could not read the id back — it re-derived one from the\n     * minified bytes instead and filed the map under an id no stack frame would ever report.\n     * Running last means the id is stamped into the final bytes, and still before Rollup computes\n     * the content hash in the filename.\n     */\n    renderChunk: {\n      order: 'post',\n      handler(this: unknown, code: string, chunk: unknown) {\n        if (!building || !stamping) return null;\n\n        return stampChunk(code, chunk, tracked, this);\n      },\n    },\n\n    /**\n     * Shift each map by the line the snippet took, and restore the comment the minifier stripped.\n     *\n     * `order: 'pre'` because Vite's own `vite:build-import-analysis` runs here too, and it\n     * re-combines the entry chunk's map with one measured against the code INCLUDING our line.\n     * Handing it a map that is a line short collapses that chunk's mappings to nothing.\n     */\n    generateBundle: {\n      order: 'pre',\n      handler(_options: unknown, bundle: Record<string, unknown>) {\n        if (!building) return;\n\n        repairChunks(bundle, tracked);\n      },\n    },\n\n    /**\n     * `writeBundle`, not `closeBundle`, because it is handed the output options — and the output\n     * directory is not always Vite's `build.outDir`. A config that sets\n     * `rollupOptions.output.dir` (a theme extension writing straight into `assets/`, say) leaves\n     * `build.outDir` at its default, so scanning that found an empty or missing directory and\n     * uploaded nothing, silently, on every build.\n     *\n     * Called once per output, and every one of them is uploaded. The previous version latched on\n     * the directory and returned early for the rest, so `@vitejs/plugin-legacy`'s second output —\n     * the chunks actually served to the browsers most likely to produce an unreadable stack — was\n     * never sent.\n     */\n    async writeBundle(rawOptions: unknown, bundle: Record<string, unknown>) {\n      if (!building) return;\n\n      const dir = directoryOf(rawOptions) || outDir;\n      if (dir === '') return;\n\n      // The maps are written again from the bundle, because Rollup emits a chunk's map from the\n      // reference it captured while rendering — an edit made in `generateBundle` reaches every\n      // other plugin and never reaches the file.\n      await writeMaps(dir, bundle, tracked, repaired);\n\n      // `buildStart` normally creates it; a plugin added to an already-running build might not\n      // have seen that hook, and an upload that silently does not happen is the whole problem.\n      run ??= session({ urlPrefix: base, ...options, release }, { ...process.env, ...env });\n\n      await run.upload(dir);\n      await run.cleanup();\n    },\n\n    async closeBundle() {\n      await run?.cleanup();\n    },\n  };\n}\n\n/**\n * The plugin that does nothing, for `disable: true`.\n *\n * Vite configs are reused by vitest and Storybook, and both would otherwise pay for `loadEnv`, a\n * `git rev-parse` and a walk of a directory they never built.\n */\nfunction inert(): VitePlugin {\n  return {\n    name: 'vinktar',\n    config: async () => ({ define: {} }),\n    configResolved: () => {},\n    buildStart: () => {},\n    renderChunk: { order: 'post', handler: () => null },\n    generateBundle: { order: 'pre', handler: () => {} },\n    writeBundle: async () => {},\n    closeBundle: async () => {},\n  };\n}\n\n/** Rollup's own output directory, which is the one the files were actually written to. */\nfunction directoryOf(rawOptions: unknown): string {\n  const dir = (rawOptions as { dir?: unknown } | null)?.dir;\n  if (typeof dir !== 'string' || dir === '') return '';\n\n  return isAbsolute(dir) ? dir : join(process.cwd(), dir);\n}\n"]}

package/package.json

@@ -0,0 +1,141 @@
+{
+  "name": "@vinktarhq/cli",
+  "version": "0.1.0",
+  "description": "Vinktar CLI: upload source maps so stack traces resolve to your original code.",
+  "keywords": [
+    "vinktar",
+    "sourcemaps",
+    "error-tracking",
+    "cli"
+  ],
+  "homepage": "https://vinktar.com",
+  "bugs": {
+    "url": "https://github.com/vinktarhq/cli/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vinktarhq/cli.git"
+  },
+  "license": "MIT",
+  "author": "john.vink",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    },
+    "./vite": {
+      "import": {
+        "types": "./dist/vite.d.ts",
+        "default": "./dist/vite.js"
+      }
+    },
+    "./rollup": {
+      "import": {
+        "types": "./dist/bundler/rollup.d.ts",
+        "default": "./dist/bundler/rollup.js"
+      },
+      "require": {
+        "types": "./dist/cjs/bundler/rollup.d.ts",
+        "default": "./dist/cjs/bundler/rollup.js"
+      }
+    },
+    "./webpack": {
+      "import": {
+        "types": "./dist/bundler/webpack.d.ts",
+        "default": "./dist/bundler/webpack.js"
+      },
+      "require": {
+        "types": "./dist/cjs/bundler/webpack.d.ts",
+        "default": "./dist/cjs/bundler/webpack.js"
+      }
+    },
+    "./rspack": {
+      "import": {
+        "types": "./dist/bundler/rspack.d.ts",
+        "default": "./dist/bundler/rspack.js"
+      },
+      "require": {
+        "types": "./dist/cjs/bundler/rspack.d.ts",
+        "default": "./dist/cjs/bundler/rspack.js"
+      }
+    },
+    "./esbuild": {
+      "import": {
+        "types": "./dist/bundler/esbuild.d.ts",
+        "default": "./dist/bundler/esbuild.js"
+      },
+      "require": {
+        "types": "./dist/cjs/bundler/esbuild.d.ts",
+        "default": "./dist/cjs/bundler/esbuild.js"
+      }
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "vinktar": "dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && tsc -p tsconfig.cjs.json && node scripts/postbuild.mjs",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm test && npm run test:bundlers",
+    "test": "vitest run",
+    "test:bundlers": "vitest run --config vitest.bundlers.config.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "devDependencies": {
+    "@rspack/core": "^1.6.0",
+    "@types/node": "^24.0.0",
+    "esbuild": "^0.28.2",
+    "rollup": "^4.63.1",
+    "typescript": "^5.6.0",
+    "vite": "^7.3.6",
+    "vite8": "npm:vite@^8",
+    "vitest": "^3.0.0",
+    "webpack": "^5.110.1"
+  },
+  "peerDependencies": {
+    "@rspack/core": ">=1",
+    "esbuild": ">=0.19",
+    "rollup": ">=3",
+    "vite": ">=5",
+    "webpack": ">=5"
+  },
+  "peerDependenciesMeta": {
+    "@rspack/core": {
+      "optional": true
+    },
+    "esbuild": {
+      "optional": true
+    },
+    "rollup": {
+      "optional": true
+    },
+    "vite": {
+      "optional": true
+    },
+    "webpack": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}