@autter/runtime-cli 0.0.0-stage → 1.1.0

package/dist/index.d.cts

@@ -0,0 +1,105 @@
+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. */
+declare const DEBUG_ID_RE: RegExp;
+/** Lowercased debug id, or null when the value isn't one. */
+declare function normalizeDebugId(value: unknown): string | null;
+/**
+ * The content-addressed debug id of a bundle: the first 16 bytes of
+ * sha256(bytes), shaped as a version-4 UUID. The same bytes always get the
+ * same id, so rebuilding identical output never produces a new one.
+ */
+declare function debugIdFor(bytes: Uint8Array | string): string;
+/** The id in the bundle's last `//# debugId=` comment, if any (ours, or one
+ * a bundler wrote natively). */
+declare function readDebugIdComment(code: string): string | null;
+/** Property the browser SDK reads: `globalThis._autterDebugIds[stack] = id`. */
+declare const DEBUG_ID_REGISTRY = "_autterDebugIds";
+/**
+ * One line of ES5 that records this bundle's id under the stack of an Error
+ * created inside it — the stack's first frame names the script URL the
+ * browser actually loaded, which the SDK maps back to the id. `g.Error` keeps
+ * working when the bundle shadows `Error` at top level. Never throws.
+ */
+declare function debugIdSnippet(id: string): string;
+/** Whether the bundle already carries our registration snippet. (The
+ * registry name alone is not enough: a bundle that includes the browser SDK
+ * 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. */
+declare const RELEASE_ENV_VARS: readonly ["GITHUB_SHA", "VERCEL_GIT_COMMIT_SHA", "CF_PAGES_COMMIT_SHA", "GIT_SHA"];
+interface ResolvedRelease {
+    release: string;
+    /** Where it came from: "--release", an env var name, or "git". */
+    source: string;
+}
+/** The commit at `cwd`, or null outside a git checkout / without git. */
+declare function gitHead(cwd?: string): string | null;
+/**
+ * The release to upload under: the explicit value, else the first CI commit
+ * variable that is set (GITHUB_SHA, VERCEL_GIT_COMMIT_SHA, CF_PAGES_COMMIT_SHA,
+ * GIT_SHA), else `git rev-parse HEAD`. Throws with a usable message when none
+ * is available or the value has characters the ingester rejects.
+ */
+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, SCOPES_KEY, SCOPES_VERSION, type ScopesResult, type SourceMapScopes, computeScopes, debugIdFor, debugIdSnippet, gitHead, hasDebugIdSnippet, normalizeDebugId, readDebugIdComment, resolveRelease };

package/dist/index.d.ts

@@ -0,0 +1,105 @@
+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. */
+declare const DEBUG_ID_RE: RegExp;
+/** Lowercased debug id, or null when the value isn't one. */
+declare function normalizeDebugId(value: unknown): string | null;
+/**
+ * The content-addressed debug id of a bundle: the first 16 bytes of
+ * sha256(bytes), shaped as a version-4 UUID. The same bytes always get the
+ * same id, so rebuilding identical output never produces a new one.
+ */
+declare function debugIdFor(bytes: Uint8Array | string): string;
+/** The id in the bundle's last `//# debugId=` comment, if any (ours, or one
+ * a bundler wrote natively). */
+declare function readDebugIdComment(code: string): string | null;
+/** Property the browser SDK reads: `globalThis._autterDebugIds[stack] = id`. */
+declare const DEBUG_ID_REGISTRY = "_autterDebugIds";
+/**
+ * One line of ES5 that records this bundle's id under the stack of an Error
+ * created inside it — the stack's first frame names the script URL the
+ * browser actually loaded, which the SDK maps back to the id. `g.Error` keeps
+ * working when the bundle shadows `Error` at top level. Never throws.
+ */
+declare function debugIdSnippet(id: string): string;
+/** Whether the bundle already carries our registration snippet. (The
+ * registry name alone is not enough: a bundle that includes the browser SDK
+ * 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. */
+declare const RELEASE_ENV_VARS: readonly ["GITHUB_SHA", "VERCEL_GIT_COMMIT_SHA", "CF_PAGES_COMMIT_SHA", "GIT_SHA"];
+interface ResolvedRelease {
+    release: string;
+    /** Where it came from: "--release", an env var name, or "git". */
+    source: string;
+}
+/** The commit at `cwd`, or null outside a git checkout / without git. */
+declare function gitHead(cwd?: string): string | null;
+/**
+ * The release to upload under: the explicit value, else the first CI commit
+ * variable that is set (GITHUB_SHA, VERCEL_GIT_COMMIT_SHA, CF_PAGES_COMMIT_SHA,
+ * GIT_SHA), else `git rev-parse HEAD`. Throws with a usable message when none
+ * is available or the value has characters the ingester rejects.
+ */
+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, SCOPES_KEY, SCOPES_VERSION, type ScopesResult, type SourceMapScopes, computeScopes, debugIdFor, debugIdSnippet, gitHead, hasDebugIdSnippet, normalizeDebugId, readDebugIdComment, resolveRelease };

package/dist/index.js

@@ -0,0 +1,72 @@
+import {
+  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,
+  formatUploadSummary,
+  gitHead,
+  hasDebugIdSnippet,
+  injectBundle,
+  injectDir,
+  mapPathFor,
+  normalizeDebugId,
+  processBuildOutput,
+  readDebugIdComment,
+  readSourceMappingUrl,
+  resolveEndpoint,
+  resolveRelease,
+  servedFilename,
+  shiftMappings,
+  snippetLine,
+  storedMapJson,
+  stripSourceMappingUrl,
+  uploadDir
+} 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,
+  formatUploadSummary,
+  gitHead,
+  hasDebugIdSnippet,
+  injectBundle,
+  injectDir,
+  mapPathFor,
+  normalizeDebugId,
+  processBuildOutput,
+  readDebugIdComment,
+  readSourceMappingUrl,
+  resolveEndpoint,
+  resolveRelease,
+  servedFilename,
+  shiftMappings,
+  snippetLine,
+  storedMapJson,
+  stripSourceMappingUrl,
+  uploadDir
+};