@posthog/core 1.23.4 → 1.24.1

package/dist/process/cli.d.ts

@@ -0,0 +1,23 @@
+import { ResolvedPluginConfig } from './config';
+/**
+ * Build CLI arguments for `posthog-cli sourcemap process`.
+ */
+export declare function buildSourcemapCliArgs(config: ResolvedPluginConfig, mode: {
+    stdin: true;
+} | {
+    directory: string;
+}): string[];
+/**
+ * Build environment variables for CLI invocation.
+ * Plugin config values override any existing process.env values.
+ */
+export declare function buildCliEnv(config: ResolvedPluginConfig): NodeJS.ProcessEnv;
+/**
+ * Spawn the PostHog CLI for sourcemap processing via stdin (file list).
+ */
+export declare function runSourcemapCli(config: ResolvedPluginConfig, options: {
+    filePaths: string[];
+} | {
+    directory: string;
+}): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/process/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/process/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAG/C;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAC5C,MAAM,EAAE,CA0BV;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAAC,UAAU,CAQ3E;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GACvD,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/dist/process/cli.js

@@ -0,0 +1,80 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    runSourcemapCli: ()=>runSourcemapCli,
+    buildCliEnv: ()=>buildCliEnv,
+    buildSourcemapCliArgs: ()=>buildSourcemapCliArgs
+});
+const external_spawn_local_js_namespaceObject = require("./spawn-local.js");
+function buildSourcemapCliArgs(config, mode) {
+    const args = [
+        'sourcemap',
+        'process'
+    ];
+    if ('stdin' in mode) args.push('--stdin');
+    else args.push('--directory', mode.directory);
+    if (config.sourcemaps.releaseName) args.push('--release-name', config.sourcemaps.releaseName);
+    if (config.sourcemaps.releaseVersion) args.push('--release-version', config.sourcemaps.releaseVersion);
+    if (config.sourcemaps.deleteAfterUpload) args.push('--delete-after');
+    if (config.sourcemaps.batchSize) args.push('--batch-size', config.sourcemaps.batchSize.toString());
+    return args;
+}
+function buildCliEnv(config) {
+    return {
+        ...process.env,
+        RUST_LOG: `posthog_cli=${config.logLevel}`,
+        POSTHOG_CLI_HOST: config.host,
+        POSTHOG_CLI_API_KEY: config.personalApiKey,
+        POSTHOG_CLI_PROJECT_ID: config.projectId
+    };
+}
+async function runSourcemapCli(config, options) {
+    const mode = 'filePaths' in options ? {
+        stdin: true
+    } : {
+        directory: options.directory
+    };
+    const args = buildSourcemapCliArgs(config, mode);
+    const env = buildCliEnv(config);
+    const spawnOptions = {
+        cwd: process.cwd(),
+        env,
+        stdio: 'inherit'
+    };
+    if ('filePaths' in options) spawnOptions.stdin = options.filePaths.join('\n') + '\n';
+    await (0, external_spawn_local_js_namespaceObject.spawnLocal)(config.cliBinaryPath, args, spawnOptions);
+}
+exports.buildCliEnv = __webpack_exports__.buildCliEnv;
+exports.buildSourcemapCliArgs = __webpack_exports__.buildSourcemapCliArgs;
+exports.runSourcemapCli = __webpack_exports__.runSourcemapCli;
+for(var __webpack_i__ in __webpack_exports__)if (-1 === [
+    "buildCliEnv",
+    "buildSourcemapCliArgs",
+    "runSourcemapCli"
+].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/process/cli.mjs

@@ -0,0 +1,40 @@
+import { spawnLocal } from "./spawn-local.mjs";
+function buildSourcemapCliArgs(config, mode) {
+    const args = [
+        'sourcemap',
+        'process'
+    ];
+    if ('stdin' in mode) args.push('--stdin');
+    else args.push('--directory', mode.directory);
+    if (config.sourcemaps.releaseName) args.push('--release-name', config.sourcemaps.releaseName);
+    if (config.sourcemaps.releaseVersion) args.push('--release-version', config.sourcemaps.releaseVersion);
+    if (config.sourcemaps.deleteAfterUpload) args.push('--delete-after');
+    if (config.sourcemaps.batchSize) args.push('--batch-size', config.sourcemaps.batchSize.toString());
+    return args;
+}
+function buildCliEnv(config) {
+    return {
+        ...process.env,
+        RUST_LOG: `posthog_cli=${config.logLevel}`,
+        POSTHOG_CLI_HOST: config.host,
+        POSTHOG_CLI_API_KEY: config.personalApiKey,
+        POSTHOG_CLI_PROJECT_ID: config.projectId
+    };
+}
+async function runSourcemapCli(config, options) {
+    const mode = 'filePaths' in options ? {
+        stdin: true
+    } : {
+        directory: options.directory
+    };
+    const args = buildSourcemapCliArgs(config, mode);
+    const env = buildCliEnv(config);
+    const spawnOptions = {
+        cwd: process.cwd(),
+        env,
+        stdio: 'inherit'
+    };
+    if ('filePaths' in options) spawnOptions.stdin = options.filePaths.join('\n') + '\n';
+    await spawnLocal(config.cliBinaryPath, args, spawnOptions);
+}
+export { buildCliEnv, buildSourcemapCliArgs, runSourcemapCli };

package/dist/process/config.d.ts

@@ -0,0 +1,42 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+export interface PluginConfig {
+    personalApiKey: string;
+    /** @deprecated Use projectId instead */
+    envId?: string;
+    projectId?: string;
+    host?: string;
+    logLevel?: LogLevel;
+    cliBinaryPath?: string;
+    sourcemaps?: {
+        enabled?: boolean;
+        /** @deprecated Use releaseName instead */
+        project?: string;
+        releaseName?: string;
+        /** @deprecated Use releaseVersion instead */
+        version?: string;
+        releaseVersion?: string;
+        deleteAfterUpload?: boolean;
+        batchSize?: number;
+    };
+}
+export interface ResolvedPluginConfig extends Omit<PluginConfig, 'envId' | 'projectId'> {
+    projectId?: string;
+    host: string;
+    logLevel: LogLevel;
+    cliBinaryPath: string;
+    sourcemaps: {
+        enabled: boolean;
+        releaseName?: string;
+        releaseVersion?: string;
+        deleteAfterUpload: boolean;
+        batchSize?: number;
+    };
+}
+export interface ResolveConfigOptions {
+    /** Default value for sourcemaps.enabled when not explicitly set. Defaults to true. */
+    defaultEnabled?: boolean;
+    /** The cwd used for resolving the CLI binary path. Defaults to process.cwd(). */
+    cwd?: string;
+}
+export declare function resolveConfig(options: PluginConfig, resolveOptions?: ResolveConfigOptions): ResolvedPluginConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/process/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/process/config.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;AAErE,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,CAAA;IACtB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,CAAC,EAAE;QACX,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,0CAA0C;QAC1C,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,6CAA6C;QAC7C,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,iBAAiB,CAAC,EAAE,OAAO,CAAA;QAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,CAAA;CACF;AAED,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAAC,YAAY,EAAE,OAAO,GAAG,WAAW,CAAC;IACrF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,QAAQ,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE;QACV,OAAO,EAAE,OAAO,CAAA;QAChB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,iBAAiB,EAAE,OAAO,CAAA;QAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,CAAA;CACF;AAED,MAAM,WAAW,oBAAoB;IACnC,sFAAsF;IACtF,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,iFAAiF;IACjF,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,cAAc,CAAC,EAAE,oBAAoB,GAAG,oBAAoB,CAuChH"}

package/dist/process/config.js

@@ -0,0 +1,67 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    resolveConfig: ()=>resolveConfig
+});
+const external_utils_js_namespaceObject = require("./utils.js");
+function resolveConfig(options, resolveOptions) {
+    const projectId = options.projectId ?? options.envId;
+    const host = options.host ?? 'https://us.i.posthog.com';
+    const logLevel = options.logLevel ?? 'info';
+    const cwd = resolveOptions?.cwd ?? process.cwd();
+    const cliBinaryPath = options.cliBinaryPath ?? (0, external_utils_js_namespaceObject.resolveBinaryPath)('posthog-cli', {
+        path: process.env.PATH ?? '',
+        cwd
+    });
+    const userSourcemaps = options.sourcemaps ?? {};
+    const defaultEnabled = resolveOptions?.defaultEnabled ?? true;
+    const enabled = userSourcemaps.enabled ?? defaultEnabled;
+    if (enabled) {
+        if (!projectId) throw new Error('projectId is required when sourcemaps are enabled (envId is deprecated)');
+        if (!options.personalApiKey) throw new Error('personalApiKey is required when sourcemaps are enabled');
+    }
+    return {
+        personalApiKey: options.personalApiKey,
+        projectId,
+        host,
+        logLevel,
+        cliBinaryPath,
+        sourcemaps: {
+            enabled,
+            releaseName: userSourcemaps.releaseName ?? userSourcemaps.project,
+            releaseVersion: userSourcemaps.releaseVersion ?? userSourcemaps.version,
+            deleteAfterUpload: userSourcemaps.deleteAfterUpload ?? true,
+            batchSize: userSourcemaps.batchSize
+        }
+    };
+}
+exports.resolveConfig = __webpack_exports__.resolveConfig;
+for(var __webpack_i__ in __webpack_exports__)if (-1 === [
+    "resolveConfig"
+].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/process/config.mjs

@@ -0,0 +1,33 @@
+import { resolveBinaryPath } from "./utils.mjs";
+function resolveConfig(options, resolveOptions) {
+    const projectId = options.projectId ?? options.envId;
+    const host = options.host ?? 'https://us.i.posthog.com';
+    const logLevel = options.logLevel ?? 'info';
+    const cwd = resolveOptions?.cwd ?? process.cwd();
+    const cliBinaryPath = options.cliBinaryPath ?? resolveBinaryPath('posthog-cli', {
+        path: process.env.PATH ?? '',
+        cwd
+    });
+    const userSourcemaps = options.sourcemaps ?? {};
+    const defaultEnabled = resolveOptions?.defaultEnabled ?? true;
+    const enabled = userSourcemaps.enabled ?? defaultEnabled;
+    if (enabled) {
+        if (!projectId) throw new Error('projectId is required when sourcemaps are enabled (envId is deprecated)');
+        if (!options.personalApiKey) throw new Error('personalApiKey is required when sourcemaps are enabled');
+    }
+    return {
+        personalApiKey: options.personalApiKey,
+        projectId,
+        host,
+        logLevel,
+        cliBinaryPath,
+        sourcemaps: {
+            enabled,
+            releaseName: userSourcemaps.releaseName ?? userSourcemaps.project,
+            releaseVersion: userSourcemaps.releaseVersion ?? userSourcemaps.version,
+            deleteAfterUpload: userSourcemaps.deleteAfterUpload ?? true,
+            batchSize: userSourcemaps.batchSize
+        }
+    };
+}
+export { resolveConfig };

package/dist/process/index.d.ts

@@ -1,4 +1,5 @@
 export * from './spawn-local';
 export { resolveBinaryPath } from './utils';
-export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export * from './config';
+export * from './cli';
 //# sourceMappingURL=index.d.ts.map

package/dist/process/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/process/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAE3C,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/process/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAC3C,cAAc,UAAU,CAAA;AACxB,cAAc,OAAO,CAAA"}

package/dist/process/index.js

@@ -1,5 +1,11 @@
 "use strict";
 var __webpack_modules__ = {
+    "./cli": function(module) {
+        module.exports = require("./cli.js");
+    },
+    "./config": function(module) {
+        module.exports = require("./config.js");
+    },
     "./spawn-local": function(module) {
         module.exports = require("./spawn-local.js");
     },
@@ -63,6 +69,24 @@ var __webpack_exports__ = {};
     }).bind(0, __WEBPACK_IMPORT_KEY__);
     __webpack_require__.d(__webpack_exports__, __WEBPACK_REEXPORT_OBJECT__);
     var _utils__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__("./utils?198b");
+    var _config__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__("./config");
+    var __WEBPACK_REEXPORT_OBJECT__ = {};
+    for(var __WEBPACK_IMPORT_KEY__ in _config__WEBPACK_IMPORTED_MODULE_2__)if ([
+        "resolveBinaryPath",
+        "default"
+    ].indexOf(__WEBPACK_IMPORT_KEY__) < 0) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
+        return _config__WEBPACK_IMPORTED_MODULE_2__[key];
+    }).bind(0, __WEBPACK_IMPORT_KEY__);
+    __webpack_require__.d(__webpack_exports__, __WEBPACK_REEXPORT_OBJECT__);
+    var _cli__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__("./cli");
+    var __WEBPACK_REEXPORT_OBJECT__ = {};
+    for(var __WEBPACK_IMPORT_KEY__ in _cli__WEBPACK_IMPORTED_MODULE_3__)if ([
+        "resolveBinaryPath",
+        "default"
+    ].indexOf(__WEBPACK_IMPORT_KEY__) < 0) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
+        return _cli__WEBPACK_IMPORTED_MODULE_3__[key];
+    }).bind(0, __WEBPACK_IMPORT_KEY__);
+    __webpack_require__.d(__webpack_exports__, __WEBPACK_REEXPORT_OBJECT__);
 })();
 exports.resolveBinaryPath = __webpack_exports__.resolveBinaryPath;
 for(var __webpack_i__ in __webpack_exports__)if (-1 === [

package/dist/process/index.mjs

@@ -1,3 +1,5 @@
 import { resolveBinaryPath } from "./utils.mjs";
 export * from "./spawn-local.mjs";
+export * from "./config.mjs";
+export * from "./cli.mjs";
 export { resolveBinaryPath };

package/dist/process/spawn-local.d.ts

@@ -2,5 +2,6 @@ export declare function spawnLocal(executable: string, args: string[], options:
     env: NodeJS.ProcessEnv;
     stdio: 'inherit' | 'ignore';
     cwd: string;
+    stdin?: string;
 }): Promise<void>;
 //# sourceMappingURL=spawn-local.d.ts.map

package/dist/process/spawn-local.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spawn-local.d.ts","sourceRoot":"","sources":["../../src/process/spawn-local.ts"],"names":[],"mappings":"AAEA,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE;IACP,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;IACtB,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAA;IAC3B,GAAG,EAAE,MAAM,CAAA;CACZ,GACA,OAAO,CAAC,IAAI,CAAC,CAoBf"}
+{"version":3,"file":"spawn-local.d.ts","sourceRoot":"","sources":["../../src/process/spawn-local.ts"],"names":[],"mappings":"AAEA,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE;IACP,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;IACtB,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAA;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,GACA,OAAO,CAAC,IAAI,CAAC,CAiCf"}

package/dist/process/spawn-local.js

@@ -28,13 +28,25 @@ __webpack_require__.d(__webpack_exports__, {
 });
 const external_cross_spawn_namespaceObject = require("cross-spawn");
 async function spawnLocal(executable, args, options) {
+    const stdioOption = void 0 !== options.stdin ? [
+        'pipe',
+        options.stdio,
+        options.stdio
+    ] : options.stdio;
     const child = (0, external_cross_spawn_namespaceObject.spawn)(executable, [
         ...args
     ], {
-        stdio: options.stdio ?? 'inherit',
+        stdio: stdioOption,
         env: options.env,
         cwd: options.cwd
     });
+    if (void 0 !== options.stdin && child.stdin) {
+        child.stdin.on('error', (err)=>{
+            if ('EPIPE' !== err.code) throw err;
+        });
+        child.stdin.write(options.stdin);
+        child.stdin.end();
+    }
     await new Promise((resolve, reject)=>{
         child.on('close', (code)=>{
             if (0 === code) resolve();

package/dist/process/spawn-local.mjs

@@ -1,12 +1,24 @@
 import { spawn } from "cross-spawn";
 async function spawnLocal(executable, args, options) {
+    const stdioOption = void 0 !== options.stdin ? [
+        'pipe',
+        options.stdio,
+        options.stdio
+    ] : options.stdio;
     const child = spawn(executable, [
         ...args
     ], {
-        stdio: options.stdio ?? 'inherit',
+        stdio: stdioOption,
         env: options.env,
         cwd: options.cwd
     });
+    if (void 0 !== options.stdin && child.stdin) {
+        child.stdin.on('error', (err)=>{
+            if ('EPIPE' !== err.code) throw err;
+        });
+        child.stdin.write(options.stdin);
+        child.stdin.end();
+    }
     await new Promise((resolve, reject)=>{
         child.on('close', (code)=>{
             if (0 === code) resolve();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@posthog/core",
-  "version": "1.23.4",
+  "version": "1.24.1",
   "license": "MIT",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/process/cli.ts

@@ -0,0 +1,74 @@
+import { ResolvedPluginConfig } from './config'
+import { spawnLocal } from './spawn-local'
+
+/**
+ * Build CLI arguments for `posthog-cli sourcemap process`.
+ */
+export function buildSourcemapCliArgs(
+  config: ResolvedPluginConfig,
+  mode: { stdin: true } | { directory: string }
+): string[] {
+  const args = ['sourcemap', 'process']
+
+  if ('stdin' in mode) {
+    args.push('--stdin')
+  } else {
+    args.push('--directory', mode.directory)
+  }
+
+  if (config.sourcemaps.releaseName) {
+    args.push('--release-name', config.sourcemaps.releaseName)
+  }
+
+  if (config.sourcemaps.releaseVersion) {
+    args.push('--release-version', config.sourcemaps.releaseVersion)
+  }
+
+  if (config.sourcemaps.deleteAfterUpload) {
+    args.push('--delete-after')
+  }
+
+  if (config.sourcemaps.batchSize) {
+    args.push('--batch-size', config.sourcemaps.batchSize.toString())
+  }
+
+  return args
+}
+
+/**
+ * Build environment variables for CLI invocation.
+ * Plugin config values override any existing process.env values.
+ */
+export function buildCliEnv(config: ResolvedPluginConfig): NodeJS.ProcessEnv {
+  return {
+    ...process.env,
+    RUST_LOG: `posthog_cli=${config.logLevel}`,
+    POSTHOG_CLI_HOST: config.host,
+    POSTHOG_CLI_API_KEY: config.personalApiKey,
+    POSTHOG_CLI_PROJECT_ID: config.projectId,
+  }
+}
+
+/**
+ * Spawn the PostHog CLI for sourcemap processing via stdin (file list).
+ */
+export async function runSourcemapCli(
+  config: ResolvedPluginConfig,
+  options: { filePaths: string[] } | { directory: string }
+): Promise<void> {
+  const mode = 'filePaths' in options ? { stdin: true as const } : { directory: options.directory }
+  const args = buildSourcemapCliArgs(config, mode)
+  const env = buildCliEnv(config)
+
+  const spawnOptions: Parameters<typeof spawnLocal>[2] = {
+    cwd: process.cwd(),
+    env,
+    stdio: 'inherit',
+  }
+
+  if ('filePaths' in options) {
+    spawnOptions.stdin = options.filePaths.join('\n') + '\n'
+  }
+
+  await spawnLocal(config.cliBinaryPath, args, spawnOptions)
+}

package/src/process/config.ts

@@ -0,0 +1,86 @@
+import { resolveBinaryPath } from './utils'
+
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent'
+
+export interface PluginConfig {
+  personalApiKey: string
+  /** @deprecated Use projectId instead */
+  envId?: string
+  projectId?: string
+  host?: string
+  logLevel?: LogLevel
+  cliBinaryPath?: string
+  sourcemaps?: {
+    enabled?: boolean
+    /** @deprecated Use releaseName instead */
+    project?: string
+    releaseName?: string
+    /** @deprecated Use releaseVersion instead */
+    version?: string
+    releaseVersion?: string
+    deleteAfterUpload?: boolean
+    batchSize?: number
+  }
+}
+
+export interface ResolvedPluginConfig extends Omit<PluginConfig, 'envId' | 'projectId'> {
+  projectId?: string
+  host: string
+  logLevel: LogLevel
+  cliBinaryPath: string
+  sourcemaps: {
+    enabled: boolean
+    releaseName?: string
+    releaseVersion?: string
+    deleteAfterUpload: boolean
+    batchSize?: number
+  }
+}
+
+export interface ResolveConfigOptions {
+  /** Default value for sourcemaps.enabled when not explicitly set. Defaults to true. */
+  defaultEnabled?: boolean
+  /** The cwd used for resolving the CLI binary path. Defaults to process.cwd(). */
+  cwd?: string
+}
+
+export function resolveConfig(options: PluginConfig, resolveOptions?: ResolveConfigOptions): ResolvedPluginConfig {
+  const projectId = options.projectId ?? options.envId
+  const host = options.host ?? 'https://us.i.posthog.com'
+  const logLevel = options.logLevel ?? 'info'
+  const cwd = resolveOptions?.cwd ?? process.cwd()
+  const cliBinaryPath =
+    options.cliBinaryPath ??
+    resolveBinaryPath('posthog-cli', {
+      path: process.env.PATH ?? '',
+      cwd,
+    })
+
+  const userSourcemaps = options.sourcemaps ?? {}
+  const defaultEnabled = resolveOptions?.defaultEnabled ?? true
+  const enabled = userSourcemaps.enabled ?? defaultEnabled
+
+  if (enabled) {
+    if (!projectId) {
+      throw new Error('projectId is required when sourcemaps are enabled (envId is deprecated)')
+    }
+    if (!options.personalApiKey) {
+      throw new Error('personalApiKey is required when sourcemaps are enabled')
+    }
+  }
+
+  return {
+    personalApiKey: options.personalApiKey,
+    projectId,
+    host,
+    logLevel,
+    cliBinaryPath,
+    sourcemaps: {
+      enabled,
+      releaseName: userSourcemaps.releaseName ?? userSourcemaps.project,
+      releaseVersion: userSourcemaps.releaseVersion ?? userSourcemaps.version,
+      deleteAfterUpload: userSourcemaps.deleteAfterUpload ?? true,
+      batchSize: userSourcemaps.batchSize,
+    },
+  }
+}

package/src/process/index.ts

@@ -1,4 +1,4 @@
 export * from './spawn-local'
 export { resolveBinaryPath } from './utils'
-
-export type LogLevel = 'debug' | 'info' | 'warn' | 'error'
+export * from './config'
+export * from './cli'

package/src/process/spawn-local.ts

@@ -7,14 +7,28 @@ export async function spawnLocal(
     env: NodeJS.ProcessEnv
     stdio: 'inherit' | 'ignore'
     cwd: string
+    stdin?: string
   }
 ): Promise<void> {
+  const stdioOption = options.stdin !== undefined ? ['pipe' as const, options.stdio, options.stdio] : options.stdio
+
   const child = spawn(executable, [...args], {
-    stdio: options.stdio ?? 'inherit',
+    stdio: stdioOption,
     env: options.env,
     cwd: options.cwd,
   })
 
+  if (options.stdin !== undefined && child.stdin) {
+    child.stdin.on('error', (err: any) => {
+      if (err.code !== 'EPIPE') {
+        throw err
+      }
+      // Swallow EPIPE: child may exit before consuming all stdin
+    })
+    child.stdin.write(options.stdin)
+    child.stdin.end()
+  }
+
   await new Promise<void>((resolve, reject) => {
     child.on('close', (code) => {
       if (code === 0) {