sentry-vir 4.0.2 → 4.1.0

package/dist/event-context/event-context.d.ts

@@ -1,6 +1,7 @@
 import { type JsonCompatibleObject, type PartialWithUndefined } from '@augment-vir/common';
-import { type ScopeContext, type setTags } from '@sentry/core';
+import { type Attachment, type ScopeContext, type setTags } from '@sentry/core';
 import { type EventSeverityEnum } from './event-severity.js';
+export type { Attachment } from '@sentry/core';
 /**
  * Used for all extra context types. While keys must be strings, values can be whatever but must be
  * JSON compatible.
@@ -9,12 +10,13 @@ export type EventExtraContext = JsonCompatibleObject;
 /** Allowed tag value types for Sentry event tags. */
 export type EventTags = Parameters<typeof setTags>[0];
 /**
- * Combined context and tags parameter used for event logging functions. Both properties are
- * optional.
+ * Combined context, tags, and attachments parameter used for event logging functions. All
+ * properties are optional.
  */
 export type EventContextAndTags = PartialWithUndefined<{
     context: EventExtraContext;
     tags: EventTags;
+    attachments: ReadonlyArray<Attachment>;
 }>;
 /** Function that generates extra event context. */
 export type EventExtraContextCreator = () => EventExtraContext;
@@ -22,6 +24,7 @@ export type EventExtraContextCreator = () => EventExtraContext;
 export type EventDetails = {
     extraContext?: EventExtraContext | undefined;
     tags?: EventTags | undefined;
+    attachments?: ReadonlyArray<Attachment> | undefined;
     severity: EventSeverityEnum;
 };
 /** Options for creating contexts. Used internally. */

package/dist/event-context/event-context.js

@@ -1,16 +1,17 @@
+import { safeCopyThroughJson, } from '@augment-vir/common';
 /**
  * Maps internal EventDetails type to Sentry's required type for event severity, extra context, and
  * tags.
  */
 export function convertEventDetailsToSentryContext(eventDetails, options) {
-    const extra = {
+    const extra = safeCopyThroughJson({
         ...(options.wasSentPrematurely
             ? {
                 wasSentPrematurely: true,
             }
             : {}),
         ...eventDetails.extraContext,
-    };
+    });
     return {
         extra,
         level: eventDetails.severity,

package/dist/event-context/extra-context.error.d.ts

@@ -1,5 +1,6 @@
+import { type Attachment } from '@sentry/core';
 import { type EventContextAndTags, type EventExtraContext, type EventTags } from './event-context.js';
-import { extraEventContextSymbol, extraEventTagsSymbol } from './extra-event-context.js';
+import { extraEventAttachmentsSymbol, extraEventContextSymbol, extraEventTagsSymbol } from './extra-event-context.js';
 /**
  * Constructs an error with extra event context attached to it in the same way that
  * throwWithExtraContext attaches data.
@@ -14,6 +15,7 @@ import { extraEventContextSymbol, extraEventTagsSymbol } from './extra-event-con
 export declare class ExtraContextError extends Error {
     readonly [extraEventContextSymbol]: EventExtraContext | undefined;
     readonly [extraEventTagsSymbol]: EventTags | undefined;
+    readonly [extraEventAttachmentsSymbol]: ReadonlyArray<Attachment> | undefined;
     constructor(message: string, extraData: EventContextAndTags);
 }
 /**

package/dist/event-context/extra-context.error.js

@@ -1,5 +1,5 @@
 import { ensureError } from '@augment-vir/common';
-import { extraEventContextSymbol, extraEventTagsSymbol, } from './extra-event-context.js';
+import { extraEventAttachmentsSymbol, extraEventContextSymbol, extraEventTagsSymbol, } from './extra-event-context.js';
 /**
  * Constructs an error with extra event context attached to it in the same way that
  * throwWithExtraContext attaches data.
@@ -14,6 +14,7 @@ import { extraEventContextSymbol, extraEventTagsSymbol, } from './extra-event-co
 export class ExtraContextError extends Error {
     [extraEventContextSymbol];
     [extraEventTagsSymbol];
+    [extraEventAttachmentsSymbol];
     constructor(message, extraData) {
         super(message);
         if (extraData.context) {
@@ -22,6 +23,9 @@ export class ExtraContextError extends Error {
         if (extraData.tags) {
             this[extraEventTagsSymbol] = extraData.tags;
         }
+        if (extraData.attachments) {
+            this[extraEventAttachmentsSymbol] = extraData.attachments;
+        }
     }
 }
 /**
@@ -36,5 +40,8 @@ export function throwWithExtraContext(originalError, extraData) {
     if (extraData.tags) {
         error[extraEventTagsSymbol] = extraData.tags;
     }
+    if (extraData.attachments) {
+        error[extraEventAttachmentsSymbol] = extraData.attachments;
+    }
     throw error;
 }

package/dist/event-context/extra-event-context.d.ts

@@ -1,4 +1,4 @@
-import { type Event, type EventHint } from '@sentry/core';
+import { type Attachment, type Event, type EventHint } from '@sentry/core';
 import { type EventExtraContext, type EventTags } from './event-context.js';
 /**
  * Symbol used to attach extra event context to events. This is particularly useful for errors so
@@ -10,6 +10,11 @@ export declare const extraEventContextSymbol: unique symbol;
  * attaching tag data to thrown errors.
  */
 export declare const extraEventTagsSymbol: unique symbol;
+/**
+ * Symbol used to attach extra event attachments to events. Used alongside extraEventContextSymbol
+ * for attaching file data to thrown errors.
+ */
+export declare const extraEventAttachmentsSymbol: unique symbol;
 /** Simply describes an object that has extra event context. */
 export type HasExtraContext = {
     [extraEventContextSymbol]: EventExtraContext;
@@ -18,10 +23,16 @@ export type HasExtraContext = {
 export type HasExtraTags = {
     [extraEventTagsSymbol]: EventTags;
 };
+/** Simply describes an object that has extra event attachments. */
+export type HasExtraAttachments = {
+    [extraEventAttachmentsSymbol]: ReadonlyArray<Attachment>;
+};
 /** Type guard for whether any given input has extra event context. */
 export declare function hasExtraEventContext(input: unknown): input is HasExtraContext;
 /** Type guard for whether any given input has extra event tags. */
 export declare function hasExtraEventTags(input: unknown): input is HasExtraTags;
+/** Type guard for whether any given input has extra event attachments. */
+export declare function hasExtraEventAttachments(input: unknown): input is HasExtraAttachments;
 /**
  * Checks if extra event context has been injected into the input via extraEventContextSymbol and,
  * if so, extracts it.
@@ -32,6 +43,11 @@ export declare function extractExtraContentFromSymbol(input: unknown): EventExtr
  * extracts them.
  */
 export declare function extractExtraTagsFromSymbol(input: unknown): EventTags | undefined;
+/**
+ * Checks if extra event attachments have been injected into the input via
+ * extraEventAttachmentsSymbol and, if so, extracts them.
+ */
+export declare function extractExtraAttachmentsFromSymbol(input: unknown): ReadonlyArray<Attachment> | undefined;
 /**
  * Tries to extract extra event context via extraEventContextSymbol. Returns undefined if there is
  * no extra event context.
@@ -42,3 +58,8 @@ export declare function extractExtraEventContext(event: EventHint | Event): Even
  * extra event tags.
  */
 export declare function extractExtraEventTags(event: EventHint | Event): EventTags | undefined;
+/**
+ * Tries to extract extra event attachments via extraEventAttachmentsSymbol. Returns undefined if
+ * there are no extra event attachments.
+ */
+export declare function extractExtraEventAttachments(event: EventHint | Event): ReadonlyArray<Attachment> | undefined;

package/dist/event-context/extra-event-context.js

@@ -9,6 +9,11 @@ export const extraEventContextSymbol = Symbol('extra-event-context');
  * attaching tag data to thrown errors.
  */
 export const extraEventTagsSymbol = Symbol('extra-event-tags');
+/**
+ * Symbol used to attach extra event attachments to events. Used alongside extraEventContextSymbol
+ * for attaching file data to thrown errors.
+ */
+export const extraEventAttachmentsSymbol = Symbol('extra-event-attachments');
 /** Type guard for whether any given input has extra event context. */
 export function hasExtraEventContext(input) {
     return check.hasKey(input, extraEventContextSymbol) && !!input[extraEventContextSymbol];
@@ -17,6 +22,10 @@ export function hasExtraEventContext(input) {
 export function hasExtraEventTags(input) {
     return check.hasKey(input, extraEventTagsSymbol) && !!input[extraEventTagsSymbol];
 }
+/** Type guard for whether any given input has extra event attachments. */
+export function hasExtraEventAttachments(input) {
+    return check.hasKey(input, extraEventAttachmentsSymbol) && !!input[extraEventAttachmentsSymbol];
+}
 /**
  * Checks if extra event context has been injected into the input via extraEventContextSymbol and,
  * if so, extracts it.
@@ -39,6 +48,16 @@ export function extractExtraTagsFromSymbol(input) {
     }
     return undefined;
 }
+/**
+ * Checks if extra event attachments have been injected into the input via
+ * extraEventAttachmentsSymbol and, if so, extracts them.
+ */
+export function extractExtraAttachmentsFromSymbol(input) {
+    if (hasExtraEventAttachments(input)) {
+        return input[extraEventAttachmentsSymbol];
+    }
+    return undefined;
+}
 /**
  * Tries to extract extra event context via extraEventContextSymbol. Returns undefined if there is
  * no extra event context.
@@ -83,3 +102,23 @@ export function extractExtraEventTags(event) {
         return undefined;
     }
 }
+/**
+ * Tries to extract extra event attachments via extraEventAttachmentsSymbol. Returns undefined if
+ * there are no extra event attachments.
+ */
+export function extractExtraEventAttachments(event) {
+    const fromRootSymbol = extractExtraAttachmentsFromSymbol(event);
+    const fromSubSymbol = 'originalException' in event
+        ? extractExtraAttachmentsFromSymbol(event.originalException)
+        : undefined;
+    const combined = [
+        ...(fromRootSymbol || []),
+        ...(fromSubSymbol || []),
+    ];
+    if (combined.length) {
+        return combined;
+    }
+    else {
+        return undefined;
+    }
+}

package/dist/logging/handle-error.js

@@ -1,6 +1,7 @@
 import { extractErrorMessage } from '@augment-vir/common';
 import { convertEventDetailsToSentryContext, } from '../event-context/event-context.js';
 import { EventSeverityEnum } from '../event-context/event-severity.js';
+import { extractExtraAttachmentsFromSymbol } from '../event-context/extra-event-context.js';
 import { LoggingState, logToConsoleWithoutSentry } from '../processing/log-to-console.js';
 import { addPrematureEvent } from './premature-events.js';
 import { sentryClientForLogging } from './sentry-client-for-logging.js';
@@ -34,7 +35,19 @@ function internalHandleError(error, eventOptions, options) {
             tags: eventOptions?.tags,
             severity: EventSeverityEnum.Error,
         }, options);
-        const eventId = sentryClientForLogging.captureException(error, scopeContext);
+        const client = sentryClientForLogging;
+        const allAttachments = [
+            ...(eventOptions?.attachments || []),
+            ...(extractExtraAttachmentsFromSymbol(error) || []),
+        ];
+        const eventId = allAttachments.length
+            ? client.withScope((scope) => {
+                allAttachments.forEach((attachment) => {
+                    scope.addAttachment(attachment);
+                });
+                return client.captureException(error, scopeContext);
+            })
+            : client.captureException(error, scopeContext);
         return eventId;
     }
     catch (caught) {

package/dist/logging/send-log.js

@@ -20,6 +20,7 @@ function wrapLogWithSeverity(severity) {
         return sendLogToSentry(info, {
             extraContext: eventOptions?.context,
             tags: eventOptions?.tags,
+            attachments: eventOptions?.attachments,
             severity,
         }, {
             wasSentPrematurely: false,
@@ -54,12 +55,23 @@ function sendLogToSentry(logInfo, eventDetails, options) {
             return undefined;
         }
         const scopeContext = convertEventDetailsToSentryContext(eventDetails, options);
-        const eventId = check.isString(resolvedLogInfo)
-            ? sentryClientForLogging.captureMessage(resolvedLogInfo, scopeContext)
-            : sentryClientForLogging.captureEvent({
-                ...resolvedLogInfo,
-                ...scopeContext,
-            });
+        const client = sentryClientForLogging;
+        function captureWithClient() {
+            return check.isString(resolvedLogInfo)
+                ? client.captureMessage(resolvedLogInfo, scopeContext)
+                : client.captureEvent({
+                    ...resolvedLogInfo,
+                    ...scopeContext,
+                });
+        }
+        const eventId = eventDetails.attachments?.length
+            ? client.withScope((scope) => {
+                eventDetails.attachments?.forEach((attachment) => {
+                    scope.addAttachment(attachment);
+                });
+                return captureWithClient();
+            })
+            : captureWithClient();
         return eventId;
     }
     catch (caught) {

package/dist/logging/sentry-client-for-logging.d.ts

@@ -1,7 +1,7 @@
 import { type MaybePromise } from '@augment-vir/common';
 import { type SentryDep } from '../env/execution-env.js';
 /** The bare minimum Sentry client needed for logging events. */
-export type SentryClientForLogging = Pick<SentryDep, 'captureMessage' | 'captureException' | 'captureEvent' | 'setTags'>;
+export type SentryClientForLogging = Pick<SentryDep, 'captureMessage' | 'captureException' | 'captureEvent' | 'setTags' | 'withScope'>;
 /** Internal sentry client used for logging. */
 export declare let sentryClientForLogging: SentryClientForLogging | undefined;
 /**

package/dist/processing/event-processor.js

@@ -1,4 +1,4 @@
-import { extractErrorMessage } from '@augment-vir/common';
+import { extractErrorMessage, safeCopyThroughJson } from '@augment-vir/common';
 import { convertEventDetailsToSentryContext, } from '../event-context/event-context.js';
 import { extractEventSeverity } from '../event-context/event-severity.js';
 import { extractExtraEventContext, extractExtraEventTags, } from '../event-context/extra-event-context.js';
@@ -10,12 +10,12 @@ event,
 hint, 
 /** Optional callback for creating extra event context. */
 createUniversalContext) {
-    const extraContext = {
+    const extraContext = safeCopyThroughJson({
         ...extractExtraEventContext(hint),
         ...extractExtraEventContext(event),
         ...createUniversalContext?.(),
         originalFullMessage: event.message || extractErrorMessage(hint.originalException),
-    };
+    });
     const extraTags = {
         ...extractExtraEventTags(hint),
         ...extractExtraEventTags(event),

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "sentry-vir",
-    "version": "4.0.2",
+    "version": "4.1.0",
     "description": "Easily use Sentry.",
     "keywords": [
         "config",
@@ -44,55 +44,55 @@
         "test:update": "npm test update"
     },
     "dependencies": {
-        "@augment-vir/assert": "^31.67.0",
-        "@augment-vir/common": "^31.67.0",
-        "@sentry/browser": "^10.39.0",
-        "@sentry/core": "^10.39.0",
-        "@sentry/node": "^10.39.0",
-        "date-vir": "^8.2.0",
-        "type-fest": "^5.4.4"
+        "@augment-vir/assert": "^31.68.2",
+        "@augment-vir/common": "^31.68.2",
+        "@sentry/browser": "^10.46.0",
+        "@sentry/core": "^10.46.0",
+        "@sentry/node": "^10.46.0",
+        "date-vir": "^8.2.1",
+        "type-fest": "^5.5.0"
     },
     "devDependencies": {
-        "@augment-vir/test": "^31.67.0",
-        "@eslint/eslintrc": "^3.3.4",
+        "@augment-vir/test": "^31.68.2",
+        "@eslint/eslintrc": "^3.3.5",
         "@eslint/js": "^9.39.2",
-        "@stylistic/eslint-plugin": "^5.9.0",
+        "@stylistic/eslint-plugin": "^5.10.0",
         "@stylistic/eslint-plugin-ts": "^4.4.1",
-        "@typescript-eslint/eslint-plugin": "^8.56.1",
+        "@typescript-eslint/eslint-plugin": "^8.57.2",
         "@web/dev-server-esbuild": "^1.0.5",
         "@web/test-runner": "^0.20.2",
         "@web/test-runner-commands": "^0.9.0",
         "@web/test-runner-playwright": "^0.11.1",
         "@web/test-runner-visual-regression": "^0.10.0",
         "cspell": "^9.7.0",
-        "dependency-cruiser": "^17.3.8",
-        "esbuild": "^0.27.3",
+        "dependency-cruiser": "^17.3.10",
+        "esbuild": "^0.27.4",
         "eslint": "^9.39.2",
         "eslint-config-prettier": "^10.1.8",
-        "eslint-plugin-jsdoc": "^62.7.1",
+        "eslint-plugin-jsdoc": "^62.8.1",
         "eslint-plugin-monorepo-cop": "^1.0.2",
-        "eslint-plugin-playwright": "^2.7.0",
+        "eslint-plugin-playwright": "^2.10.1",
         "eslint-plugin-prettier": "^5.5.5",
         "eslint-plugin-require-extensions": "^0.1.3",
-        "eslint-plugin-sonarjs": "^4.0.0",
-        "eslint-plugin-unicorn": "^63.0.0",
+        "eslint-plugin-sonarjs": "^4.0.2",
+        "eslint-plugin-unicorn": "^64.0.0",
         "istanbul-smart-text-reporter": "^1.1.5",
         "markdown-code-example-inserter": "^3.0.3",
-        "npm-check-updates": "^19.6.3",
+        "npm-check-updates": "^19.6.6",
         "prettier": "~3.3.3",
         "prettier-plugin-interpolated-html-tags": "^2.0.1",
         "prettier-plugin-jsdoc": "^1.8.0",
-        "prettier-plugin-multiline-arrays": "^4.1.4",
+        "prettier-plugin-multiline-arrays": "^4.1.5",
         "prettier-plugin-organize-imports": "^4.3.0",
-        "prettier-plugin-packagejson": "^3.0.0",
+        "prettier-plugin-packagejson": "^3.0.2",
         "prettier-plugin-sort-json": "^4.2.0",
         "prettier-plugin-toml": "^2.0.6",
         "runstorm": "^1.0.0",
-        "typedoc": "^0.28.17",
+        "typedoc": "^0.28.18",
         "typescript": "^5.9.3",
-        "typescript-eslint": "^8.56.1",
-        "virmator": "^14.7.2",
-        "vite": "^7.3.1"
+        "typescript-eslint": "^8.57.1",
+        "virmator": "^14.10.3",
+        "vite": "^8.0.3"
     },
     "engines": {
         "node": ">=22"