@hue-run/sdk 0.18.1 → 0.19.0

package/dist/types.d.ts

@@ -136,11 +136,13 @@ export interface ExportReport {
     instrumentationFailures: number;
     /** Whole span attributes, inline media, attachments and opted-in file helper uploads stored
      * apart from their records (or already held by Hue), each listed under the record's
-     * `hue.blobs`. */
+     * `hue.blobs`; counted when the upload completes, which can be after the export that listed
+     * it. */
     uploadedValues: number;
     /** Whole-attribute, inline-media, attachment and opted-in file helper uploads that could not be
-     * attached. Content falls back to truncation, media digests, or file metadata, with a warning
-     * issue. */
+     * attached, each with a warning issue: values exported in their fallback form (truncation,
+     * media digests, or file metadata), and values whose upload failed after their record was
+     * exported (their `hue.blobs` entries stay). */
     uploadFallbacks: number;
 }
 /** Caller budget for {@link HueClient.flushSafe} and {@link HueClient.shutdownSafe}. */
@@ -256,11 +258,19 @@ export interface FileRecord {
     mediaType: string;
     /** Hex SHA-256 of the file's bytes; computed from `data` when omitted. */
     sha256?: string;
-    /** Upload supplied bytes on this span when content capture is enabled. Defaults to false. */
+    /** Upload the file's bytes (`data`, or the file at `path`) on this span when content capture is
+     * enabled. Defaults to false. */
     upload?: boolean;
     /** The file's bytes, hashed and measured locally by default; a string is hashed as UTF-8.
-     * Data larger than 25 MiB is omitted and counted as an instrumentation failure. */
+     * Data larger than 25 MiB, which would be held in memory until it is uploaded, is omitted and
+     * counted as an instrumentation failure. Give `data` or `path`, not both. */
     data?: Uint8Array | string;
+    /** A file to hash and measure locally (Node.js file system) instead of `data`. Up to 25 MiB it is
+     * read now, as `data` is. A larger regular file, up to Hue's 1 GB upload limit, is hashed now a
+     * slice at a time and, with `upload: true`, read again from disk when it is uploaded: it must
+     * stay unchanged until the client flushes, and is uploaded only if it still has the size and
+     * SHA-256 it was recorded with (otherwise it counts as an upload fallback). */
+    path?: string;
     /** Size in bytes; computed from `data` when omitted. */
     byteSize?: number;
     /** File name, recorded as `hue.file.name` only when `captureContent` is true. */

package/dist/version.d.ts

@@ -1,2 +1,2 @@
 /** Package version shared by the instrumentation scope and the export User-Agent. */
-export declare const sdkVersion = "0.18.1";
+export declare const sdkVersion = "0.19.0";

package/dist/version.js

@@ -1,3 +1,3 @@
 // Generated by scripts/write-version.mjs from package.json; do not edit by hand.
 /** Package version shared by the instrumentation scope and the export User-Agent. */
-export const sdkVersion = "0.18.1";
+export const sdkVersion = "0.19.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hue-run/sdk",
-  "version": "0.18.1",
+  "version": "0.19.0",
   "private": false,
   "license": "MIT",
   "publishConfig": {