@autter/runtime-cli 1.0.0 → 1.1.0

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-export { A as AutterSourceMapsOptions, B as BUNDLE_RE, a as BuildOutputResult, b as BundleWithMap, D as DEFAULT_ENDPOINT, F as FatalUploadError, I as InjectOptions, c as InjectResult, M as MAX_UPLOAD_BYTES, S as SNIPPET_LINE_KEY, U as UploadItem, d as UploadOptions, e as UploadSummary, f as findBundles, g as formatUploadSummary, i as injectBundle, h as injectDir, m as mapPathFor, p as processBuildOutput, r as readSourceMappingUrl, j as resolveEndpoint, s as servedFilename, k as shiftMappings, l as snippetLine, n as storedMapJson, o as stripSourceMappingUrl, u as uploadDir } from './build-BXFh_jbP.cjs';
+export { A as AutterSourceMapsOptions, B as BUNDLE_RE, a as BuildOutputResult, b as BundleWithMap, D as DEFAULT_ENDPOINT, F as FatalUploadError, I as InjectOptions, c as InjectResult, M as MAX_MAP_CHARS, d as MAX_UPLOAD_BYTES, S as SNIPPET_LINE_KEY, U as UploadItem, e as UploadOptions, f as UploadSummary, g as findBundles, h as formatUploadSummary, i as injectBundle, j as injectDir, m as mapPathFor, p as processBuildOutput, r as readSourceMappingUrl, k as resolveEndpoint, s as servedFilename, l as shiftMappings, n as snippetLine, o as storedMapJson, q as stripSourceMappingUrl, u as uploadDir } from './build-CPXR9Xd3.cjs';
 
 /** 8-4-4-4-12 hex: the debug id shape shared with Rollup, Turbopack, esbuild
  * and Sentry tooling, and what the ingester accepts. */
@@ -28,6 +28,61 @@ declare function debugIdSnippet(id: string): string;
  * contains it too.) */
 declare function hasDebugIdSnippet(code: string): boolean;
 
+/**
+ * Function scopes for scope-based frame names (like Sentry's
+ * js-source-scopes and PostHog cymbal's `token.scope()`).
+ *
+ * The ingester used to name a resolved frame with the name the source map
+ * holds at its CALLER's position. That is right for `computeTotal()`, and
+ * wrong whenever the call goes through a variable: `const run =
+ * actions.captured; run()` reported `run`, and handlers a framework calls
+ * got the framework's identifier (`func`, `listener`, `fn`). So `upload`
+ * parses each bundle (the final file the browser loads, after `inject`),
+ * collects every function's generated range and the token that names it,
+ * maps that token to its ORIGINAL identifier, and sends the result with the
+ * map as `x_autter_scopes`. The ingester names a frame after the innermost
+ * function that contains it.
+ */
+/** Source map extension field that carries the bundle's function scopes. */
+declare const SCOPES_KEY = "x_autter_scopes";
+declare const SCOPES_VERSION = 1;
+/**
+ * The `x_autter_scopes` value. `scopes` is encoded like `mappings`: base64
+ * VLQ, `;` between generated lines (the line each scope starts on), `,`
+ * between the scopes that start on one line, in start order (outer first on
+ * a tie). Each scope is 3 or 4 values, 0-based, in UTF-16 columns:
+ *
+ *   1. start column, relative to the previous scope's start on the same
+ *      line (absolute for a line's first scope);
+ *   2. end line, relative to the start line;
+ *   3. end column (exclusive), relative to the start column when the scope
+ *      ends on its start line, else absolute;
+ *   4. the name, when the function has one: an index into the map's own
+ *      `names` followed by these `names`, relative to the last name index
+ *      written (starting from 0).
+ *
+ * A 3-value scope is anonymous. `names` holds only names the map's own
+ * `names` lacks; a `null` entry stands for a minified name that could not
+ * be mapped back (the ingester then keeps the frame's call-site name).
+ */
+interface SourceMapScopes {
+    version: typeof SCOPES_VERSION;
+    names: Array<string | null>;
+    scopes: string;
+}
+type ScopesResult = {
+    scopes: SourceMapScopes;
+} | {
+    error: string;
+};
+/**
+ * The function scopes of `code` (the bundle exactly as served), named
+ * through its source map. Never throws: a bundle that does not parse, or a
+ * map without string `mappings`, gives `{ error }` (an upload then goes
+ * ahead without scopes).
+ */
+declare function computeScopes(code: string, map: Record<string, unknown>): ScopesResult;
+
 /** What the ingester accepts as a release. */
 declare const RELEASE_RE: RegExp;
 /** CI variables that carry the commit being built, in the order they are tried. */
@@ -47,4 +102,4 @@ declare function gitHead(cwd?: string): string | null;
  */
 declare function resolveRelease(explicit?: string | null, env?: NodeJS.ProcessEnv, cwd?: string): ResolvedRelease;
 
-export { DEBUG_ID_RE, DEBUG_ID_REGISTRY, RELEASE_ENV_VARS, RELEASE_RE, type ResolvedRelease, debugIdFor, debugIdSnippet, gitHead, hasDebugIdSnippet, normalizeDebugId, readDebugIdComment, resolveRelease };
+export { DEBUG_ID_RE, DEBUG_ID_REGISTRY, RELEASE_ENV_VARS, RELEASE_RE, type ResolvedRelease, SCOPES_KEY, SCOPES_VERSION, type ScopesResult, type SourceMapScopes, computeScopes, debugIdFor, debugIdSnippet, gitHead, hasDebugIdSnippet, normalizeDebugId, readDebugIdComment, resolveRelease };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { A as AutterSourceMapsOptions, B as BUNDLE_RE, a as BuildOutputResult, b as BundleWithMap, D as DEFAULT_ENDPOINT, F as FatalUploadError, I as InjectOptions, c as InjectResult, M as MAX_UPLOAD_BYTES, S as SNIPPET_LINE_KEY, U as UploadItem, d as UploadOptions, e as UploadSummary, f as findBundles, g as formatUploadSummary, i as injectBundle, h as injectDir, m as mapPathFor, p as processBuildOutput, r as readSourceMappingUrl, j as resolveEndpoint, s as servedFilename, k as shiftMappings, l as snippetLine, n as storedMapJson, o as stripSourceMappingUrl, u as uploadDir } from './build-BXFh_jbP.js';
+export { A as AutterSourceMapsOptions, B as BUNDLE_RE, a as BuildOutputResult, b as BundleWithMap, D as DEFAULT_ENDPOINT, F as FatalUploadError, I as InjectOptions, c as InjectResult, M as MAX_MAP_CHARS, d as MAX_UPLOAD_BYTES, S as SNIPPET_LINE_KEY, U as UploadItem, e as UploadOptions, f as UploadSummary, g as findBundles, h as formatUploadSummary, i as injectBundle, j as injectDir, m as mapPathFor, p as processBuildOutput, r as readSourceMappingUrl, k as resolveEndpoint, s as servedFilename, l as shiftMappings, n as snippetLine, o as storedMapJson, q as stripSourceMappingUrl, u as uploadDir } from './build-CPXR9Xd3.js';
 
 /** 8-4-4-4-12 hex: the debug id shape shared with Rollup, Turbopack, esbuild
  * and Sentry tooling, and what the ingester accepts. */
@@ -28,6 +28,61 @@ declare function debugIdSnippet(id: string): string;
  * contains it too.) */
 declare function hasDebugIdSnippet(code: string): boolean;
 
+/**
+ * Function scopes for scope-based frame names (like Sentry's
+ * js-source-scopes and PostHog cymbal's `token.scope()`).
+ *
+ * The ingester used to name a resolved frame with the name the source map
+ * holds at its CALLER's position. That is right for `computeTotal()`, and
+ * wrong whenever the call goes through a variable: `const run =
+ * actions.captured; run()` reported `run`, and handlers a framework calls
+ * got the framework's identifier (`func`, `listener`, `fn`). So `upload`
+ * parses each bundle (the final file the browser loads, after `inject`),
+ * collects every function's generated range and the token that names it,
+ * maps that token to its ORIGINAL identifier, and sends the result with the
+ * map as `x_autter_scopes`. The ingester names a frame after the innermost
+ * function that contains it.
+ */
+/** Source map extension field that carries the bundle's function scopes. */
+declare const SCOPES_KEY = "x_autter_scopes";
+declare const SCOPES_VERSION = 1;
+/**
+ * The `x_autter_scopes` value. `scopes` is encoded like `mappings`: base64
+ * VLQ, `;` between generated lines (the line each scope starts on), `,`
+ * between the scopes that start on one line, in start order (outer first on
+ * a tie). Each scope is 3 or 4 values, 0-based, in UTF-16 columns:
+ *
+ *   1. start column, relative to the previous scope's start on the same
+ *      line (absolute for a line's first scope);
+ *   2. end line, relative to the start line;
+ *   3. end column (exclusive), relative to the start column when the scope
+ *      ends on its start line, else absolute;
+ *   4. the name, when the function has one: an index into the map's own
+ *      `names` followed by these `names`, relative to the last name index
+ *      written (starting from 0).
+ *
+ * A 3-value scope is anonymous. `names` holds only names the map's own
+ * `names` lacks; a `null` entry stands for a minified name that could not
+ * be mapped back (the ingester then keeps the frame's call-site name).
+ */
+interface SourceMapScopes {
+    version: typeof SCOPES_VERSION;
+    names: Array<string | null>;
+    scopes: string;
+}
+type ScopesResult = {
+    scopes: SourceMapScopes;
+} | {
+    error: string;
+};
+/**
+ * The function scopes of `code` (the bundle exactly as served), named
+ * through its source map. Never throws: a bundle that does not parse, or a
+ * map without string `mappings`, gives `{ error }` (an upload then goes
+ * ahead without scopes).
+ */
+declare function computeScopes(code: string, map: Record<string, unknown>): ScopesResult;
+
 /** What the ingester accepts as a release. */
 declare const RELEASE_RE: RegExp;
 /** CI variables that carry the commit being built, in the order they are tried. */
@@ -47,4 +102,4 @@ declare function gitHead(cwd?: string): string | null;
  */
 declare function resolveRelease(explicit?: string | null, env?: NodeJS.ProcessEnv, cwd?: string): ResolvedRelease;
 
-export { DEBUG_ID_RE, DEBUG_ID_REGISTRY, RELEASE_ENV_VARS, RELEASE_RE, type ResolvedRelease, debugIdFor, debugIdSnippet, gitHead, hasDebugIdSnippet, normalizeDebugId, readDebugIdComment, resolveRelease };
+export { DEBUG_ID_RE, DEBUG_ID_REGISTRY, RELEASE_ENV_VARS, RELEASE_RE, type ResolvedRelease, SCOPES_KEY, SCOPES_VERSION, type ScopesResult, type SourceMapScopes, computeScopes, debugIdFor, debugIdSnippet, gitHead, hasDebugIdSnippet, normalizeDebugId, readDebugIdComment, resolveRelease };

package/dist/index.js

@@ -4,10 +4,14 @@ import {
   DEBUG_ID_REGISTRY,
   DEFAULT_ENDPOINT,
   FatalUploadError,
+  MAX_MAP_CHARS,
   MAX_UPLOAD_BYTES,
   RELEASE_ENV_VARS,
   RELEASE_RE,
+  SCOPES_KEY,
+  SCOPES_VERSION,
   SNIPPET_LINE_KEY,
+  computeScopes,
   debugIdFor,
   debugIdSnippet,
   findBundles,
@@ -29,17 +33,21 @@ import {
   storedMapJson,
   stripSourceMappingUrl,
   uploadDir
-} from "./chunk-SIRFO2QU.js";
+} from "./chunk-DQLLM2NT.js";
 export {
   BUNDLE_RE,
   DEBUG_ID_RE,
   DEBUG_ID_REGISTRY,
   DEFAULT_ENDPOINT,
   FatalUploadError,
+  MAX_MAP_CHARS,
   MAX_UPLOAD_BYTES,
   RELEASE_ENV_VARS,
   RELEASE_RE,
+  SCOPES_KEY,
+  SCOPES_VERSION,
   SNIPPET_LINE_KEY,
+  computeScopes,
   debugIdFor,
   debugIdSnippet,
   findBundles,