@trigger.dev/core 4.5.11 → 4.5.13

package/dist/esm/v3/isomorphic/runOpsResidency.test.js

@@ -1,7 +1,9 @@
 import { describe, expect, it } from "vitest";
-import { RunId, WaitpointId, BatchId, SnapshotId, generateRunOpsId } from "./friendlyId.js";
-import { ownerEngine, classifyResidency, classifyKind, isClassifiable } from "./runOpsResidency.js";
+import { RunId, WaitpointId, BatchId, SnapshotId, generateRunOpsId, generateRunOpsIdV2, } from "./friendlyId.js";
+import { ownerEngine, classifyResidency, classifyKind, isClassifiable, resolveShard, } from "./runOpsResidency.js";
 const SAMPLES = 50_000; // property-scale; CI-fast. (Bump locally toward "millions" for deeper coverage.)
+/** Every legal gen-2 shard char: the full DNS-safe lowercase range. */
+const SHARD_CHARS = "abcdefghijklmnopqrstuvwxyz0123456789".split("");
 describe("ownerEngine — residency classifier (version char at fixed position, not length)", () => {
     it("cuid ids (default mint) classify LEGACY, friendly + internal", () => {
         for (const util of [RunId, WaitpointId]) {
@@ -23,10 +25,11 @@ describe("ownerEngine — residency classifier (version char at fixed position,
             expect(classifyKind(id)).toBe("runOpsId");
         }
     });
-    it("discriminates on the version char, not length: 26+'1' → NEW, 26+'2' → LEGACY", () => {
+    it("discriminates on the version char, not length: 26+'1' → NEW, 26+'2' → NEW (gen-2)", () => {
         const v1 = "a".repeat(24) + "e1";
         expect(ownerEngine(v1)).toBe("NEW");
-        expect(ownerEngine("a".repeat(24) + "e2")).toBe("LEGACY");
+        expect(ownerEngine("a".repeat(24) + "e2")).toBe("NEW"); // gen-2: shard "e"
+        expect(ownerEngine("a".repeat(24) + "e9")).toBe("LEGACY"); // unallocated version char
         expect(ownerEngine("a".repeat(26))).toBe("LEGACY"); // 26 chars but no version marker
     });
     it("malformed v1 shapes fall back to LEGACY (never throw)", () => {
@@ -53,4 +56,84 @@ describe("ownerEngine — residency classifier (version char at fixed position,
         expect(ownerEngine(SnapshotId.generate().id)).toBe("LEGACY");
     });
 });
+describe("resolveShard — the gen-2 refinement inside the dedicated family", () => {
+    it("returns the shard char for every legal gen-2 shard key, friendly + internal", () => {
+        for (const c of SHARD_CHARS) {
+            const id = generateRunOpsIdV2(c);
+            expect(resolveShard(id)).toBe(c);
+            expect(resolveShard(RunId.toFriendlyId(id))).toBe(c);
+            expect(resolveShard(WaitpointId.toFriendlyId(id))).toBe(c);
+            expect(resolveShard(BatchId.toFriendlyId(id))).toBe(c);
+        }
+    });
+    it("returns 'new' for a gen-1 v1 body, friendly + internal", () => {
+        for (const region of [undefined, "us-east-1", "us-west-2", "eu-central-1"]) {
+            const id = generateRunOpsId(region);
+            expect(resolveShard(id)).toBe("new");
+            expect(resolveShard(RunId.toFriendlyId(id))).toBe("new");
+        }
+    });
+    it("returns 'legacy' for a cuid, a nanoid, a pre-cutover base62 id and malformed input", () => {
+        expect(resolveShard(RunId.generate().id)).toBe("legacy"); // cuid, 25
+        expect(resolveShard(RunId.generate().friendlyId)).toBe("legacy");
+        expect(resolveShard("123456789abcdefghijkm")).toBe("legacy"); // nanoid, 21
+        expect(resolveShard("b".repeat(27))).toBe("legacy"); // pre-cutover base62, 27
+        for (const bad of [
+            "",
+            "x".repeat(24) + "01", // 'x' outside base32hex
+            "x".repeat(24) + "02", // 'x' outside base32hex, gen-2 version
+            "A".repeat(25) + "1", // uppercase
+            "A".repeat(25) + "2", // uppercase, gen-2 version
+            "a".repeat(24) + "-1", // hyphen positional char
+            "a".repeat(24) + "-2", // hyphen positional char, gen-2 version
+            "a".repeat(26), // 26 chars, no version marker
+            "a".repeat(24) + "e9", // unallocated version char
+            "x".repeat(40),
+        ]) {
+            expect(resolveShard(bad)).toBe("legacy");
+        }
+    });
+    it("never throws, for any input string", () => {
+        for (const input of ["", "x", "-".repeat(26), " ".repeat(26), "\u{1F642}".repeat(26)]) {
+            expect(() => resolveShard(input)).not.toThrow();
+        }
+    });
+    it("the reserved keys are multi-char, so no single-char shard key can collide", () => {
+        for (const reserved of ["legacy", "new"]) {
+            expect(reserved.length).toBeGreaterThan(1);
+            expect(SHARD_CHARS).not.toContain(reserved);
+        }
+    });
+});
+describe("gen-2 ids classify NEW — the dedicated family widens in meaning only", () => {
+    it("a gen-2 id is NEW / runOpsId across id-shape co-located entities", () => {
+        for (const util of [RunId, WaitpointId, BatchId]) {
+            const id = generateRunOpsIdV2("a");
+            const friendlyId = util.toFriendlyId(id);
+            expect(ownerEngine(id)).toBe("NEW");
+            expect(ownerEngine(friendlyId)).toBe("NEW");
+            expect(classifyResidency(id)).toBe("NEW");
+            expect(classifyKind(id)).toBe("runOpsId");
+            expect(isClassifiable(id)).toBe(true);
+        }
+    });
+    it("26+'2' is now a gen-2 shard route, not LEGACY (the one deliberate flip)", () => {
+        const genTwo = "a".repeat(24) + "e2";
+        expect(ownerEngine(genTwo)).toBe("NEW");
+        expect(resolveShard(genTwo)).toBe("e");
+    });
+    it("three-way disjointness: cuid, gen-1 v1 and gen-2 never cross-classify", () => {
+        for (let i = 0; i < SAMPLES; i++) {
+            const cuid = RunId.generate().id;
+            const v1 = generateRunOpsId();
+            const v2 = generateRunOpsIdV2(SHARD_CHARS[i % SHARD_CHARS.length]);
+            expect(ownerEngine(cuid)).toBe("LEGACY");
+            expect(resolveShard(cuid)).toBe("legacy");
+            expect(ownerEngine(v1)).toBe("NEW");
+            expect(resolveShard(v1)).toBe("new");
+            expect(ownerEngine(v2)).toBe("NEW");
+            expect(resolveShard(v2)).toBe(SHARD_CHARS[i % SHARD_CHARS.length]);
+        }
+    });
+});
 //# sourceMappingURL=runOpsResidency.test.js.map

package/dist/esm/v3/isomorphic/runOpsResidency.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"runOpsResidency.test.js","sourceRoot":"","sources":["../../../../src/v3/isomorphic/runOpsResidency.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runOpsResidency.test.js","sourceRoot":"","sources":["../../../../src/v3/isomorphic/runOpsResidency.test.ts"],"names":[],"mappings":"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"}

package/dist/esm/v3/isomorphic/waitpointMint.d.ts

@@ -0,0 +1,9 @@
+import { type ShardKey } from "./runOpsResidency.js";
+export declare function mintWaitpointIdForShard(key: ShardKey): {
+    id: string;
+    friendlyId: string;
+};
+export declare function mintWaitpointIdFor(anchorId: string | undefined): {
+    id: string;
+    friendlyId: string;
+};

package/dist/esm/v3/isomorphic/waitpointMint.js

@@ -0,0 +1,18 @@
+import { generateRunOpsIdV2, WaitpointId } from "./friendlyId.js";
+import { resolveShard } from "./runOpsResidency.js";
+// A Postgres waitpoint id, not the Redis store format (version "w"), which has no row to route.
+// The core is always fresh, or the body would equal the anchor's own id.
+export function mintWaitpointIdForShard(key) {
+    if (key === "new" || key === "legacy") {
+        return WaitpointId.generate();
+    }
+    const id = generateRunOpsIdV2(key);
+    return { id, friendlyId: WaitpointId.toFriendlyId(id) };
+}
+// Every Postgres waitpoint mint goes through here: the router refuses an unstamped id on a shard.
+export function mintWaitpointIdFor(anchorId) {
+    return anchorId === undefined
+        ? WaitpointId.generate()
+        : mintWaitpointIdForShard(resolveShard(anchorId));
+}
+//# sourceMappingURL=waitpointMint.js.map

package/dist/esm/v3/isomorphic/waitpointMint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitpointMint.js","sourceRoot":"","sources":["../../../../src/v3/isomorphic/waitpointMint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAiB,MAAM,sBAAsB,CAAC;AAEnE,gGAAgG;AAChG,yEAAyE;AACzE,MAAM,UAAU,uBAAuB,CAAC,GAAa;IACnD,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,WAAW,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED,MAAM,EAAE,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACnC,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,WAAW,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,CAAC;AAC1D,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,kBAAkB,CAAC,QAA4B;IAI7D,OAAO,QAAQ,KAAK,SAAS;QAC3B,CAAC,CAAC,WAAW,CAAC,QAAQ,EAAE;QACxB,CAAC,CAAC,uBAAuB,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;AACtD,CAAC"}

package/dist/esm/v3/isomorphic/waitpointMint.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/v3/isomorphic/waitpointMint.test.js

@@ -0,0 +1,95 @@
+import { describe, expect, it } from "vitest";
+import { mintWaitpointIdFor, mintWaitpointIdForShard } from "./waitpointMint.js";
+import { generateRunOpsId, generateRunOpsIdV2, isValidShardChar, parseRunOpsIdBody, parseRunOpsIdV2Body, } from "./friendlyId.js";
+import { resolveShard } from "./runOpsResidency.js";
+const GEN2_RUN = `run_${"a".repeat(24)}a2`; // shard "a", version "2"
+const GEN1_RUN = `run_${"a".repeat(24)}01`; // region "0", version "1"
+const CUID_RUN = `run_${"b".repeat(25)}`;
+describe("mintWaitpointIdForShard", () => {
+    it("a gen-2 shard key mints a gen-2 body with that char at index 24", () => {
+        const r = mintWaitpointIdForShard("a");
+        expect(r.id.length).toBe(26);
+        expect(r.id[24]).toBe("a");
+        expect(r.id[25]).toBe("2");
+        expect(r.friendlyId).toBe(`waitpoint_${r.id}`);
+        expect(parseRunOpsIdV2Body(r.id)?.shard).toBe("a");
+    });
+    it("the reserved key 'new' mints a cuid, unchanged from today", () => {
+        const r = mintWaitpointIdForShard("new");
+        expect(r.id.length).toBe(25);
+        expect(resolveShard(r.id)).toBe("legacy");
+    });
+    it("the reserved key 'legacy' mints a cuid", () => {
+        expect(mintWaitpointIdForShard("legacy").id.length).toBe(25);
+    });
+    it("two calls for one shard never collide", () => {
+        expect(mintWaitpointIdForShard("a").id).not.toBe(mintWaitpointIdForShard("a").id);
+    });
+    it("every gen-2 id it mints routes back to its own shard", () => {
+        for (const key of ["a", "b", "0", "z", "9"]) {
+            expect(isValidShardChar(key)).toBe(true);
+            expect(resolveShard(mintWaitpointIdForShard(key).id)).toBe(key);
+        }
+    });
+});
+describe("mintWaitpointIdFor", () => {
+    it("a gen-2 anchor stamps the anchor's shard char", () => {
+        const r = mintWaitpointIdFor(GEN2_RUN);
+        expect(r.id[24]).toBe("a");
+        expect(r.id[25]).toBe("2");
+    });
+    it("a gen-2 anchor yields a FRESH core, never the anchor's own body", () => {
+        const r = mintWaitpointIdFor(GEN2_RUN);
+        expect(r.id).not.toBe(GEN2_RUN.slice(4));
+        expect(r.id.slice(0, 24)).not.toBe("a".repeat(24));
+    });
+    it("accepts the bare internal form as well as the prefixed form", () => {
+        expect(mintWaitpointIdFor(GEN2_RUN.slice(4)).id[24]).toBe("a");
+    });
+    it("a gen-1 v1 anchor mints a cuid", () => {
+        expect(mintWaitpointIdFor(GEN1_RUN).id.length).toBe(25);
+    });
+    it("a cuid anchor mints a cuid", () => {
+        expect(mintWaitpointIdFor(CUID_RUN).id.length).toBe(25);
+    });
+    it("no anchor mints a cuid", () => {
+        expect(mintWaitpointIdFor(undefined).id.length).toBe(25);
+    });
+});
+describe("resolveShard shape checks match the decoding parsers", () => {
+    // Pins the shape/decode equivalence: a drift misroutes rather than erroring.
+    const classifyByDecode = (body) => {
+        const genTwo = parseRunOpsIdV2Body(body);
+        if (genTwo)
+            return genTwo.shard;
+        return parseRunOpsIdBody(body) !== undefined ? "new" : "legacy";
+    };
+    it("agrees on freshly minted gen-1 and gen-2 bodies", () => {
+        for (let i = 0; i < 500; i++) {
+            const one = generateRunOpsId();
+            const two = generateRunOpsIdV2("abcdefghijklmnopqrstuvwxyz0123456789"[i % 36]);
+            expect(resolveShard(one)).toBe(classifyByDecode(one));
+            expect(resolveShard(two)).toBe(classifyByDecode(two));
+        }
+    });
+    it("agrees on 26-char strings carrying out-of-alphabet characters", () => {
+        const alpha = "0123456789abcdefghijklmnopqrstuvwxyz-_.ZW!";
+        for (let i = 0; i < 2000; i++) {
+            let s = "";
+            for (let j = 0; j < 26; j++)
+                s += alpha[(i * 7 + j * 13) % alpha.length];
+            for (const body of [s, s.slice(0, 25) + "1", s.slice(0, 25) + "2"]) {
+                expect({ body, shape: resolveShard(body) }).toEqual({
+                    body,
+                    shape: classifyByDecode(body),
+                });
+            }
+        }
+    });
+    it("agrees on the shapes the plan pins as legacy", () => {
+        for (const body of ["", "a", "a".repeat(25), "a".repeat(27), `${"a".repeat(24)}e2`]) {
+            expect(resolveShard(body)).toBe(classifyByDecode(body));
+        }
+    });
+});
+//# sourceMappingURL=waitpointMint.test.js.map

package/dist/esm/v3/isomorphic/waitpointMint.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitpointMint.test.js","sourceRoot":"","sources":["../../../../src/v3/isomorphic/waitpointMint.test.ts"],"names":[],"mappings":"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"}

package/dist/esm/v3/lifecycleHooks/types.d.ts

@@ -18,7 +18,7 @@ export type TaskStartHookParams<TPayload = unknown, TInitOutput extends TaskInit
 };
 export type OnStartHookFunction<TPayload, TInitOutput extends TaskInitOutput = TaskInitOutput> = (params: TaskStartHookParams<TPayload, TInitOutput>) => undefined | void | Promise<undefined | void>;
 export type AnyOnStartHookFunction = OnStartHookFunction<unknown, TaskInitOutput>;
-export type TaskStartAttemptHookParams<TPayload = unknown> = {
+type TaskStartAttemptHookParams<TPayload = unknown> = {
     ctx: TaskRunContext;
     payload: TPayload;
     task: string;
@@ -80,11 +80,11 @@ export type TaskSuccessHookParams<TPayload = unknown, TOutput = unknown, TInitOu
 };
 export type OnSuccessHookFunction<TPayload, TOutput, TInitOutput extends TaskInitOutput = TaskInitOutput> = (params: TaskSuccessHookParams<TPayload, TOutput, TInitOutput>) => undefined | void | Promise<undefined | void>;
 export type AnyOnSuccessHookFunction = OnSuccessHookFunction<unknown, unknown, TaskInitOutput>;
-export type TaskCompleteSuccessResult<TOutput> = {
+type TaskCompleteSuccessResult<TOutput> = {
     ok: true;
     data: TOutput;
 };
-export type TaskCompleteErrorResult = {
+type TaskCompleteErrorResult = {
     ok: false;
     error: unknown;
 };
@@ -205,3 +205,4 @@ export interface LifecycleHooksManager {
     registerOnCancelHookListener(listener: () => Promise<void>): void;
     callOnCancelHookListeners(): Promise<void>;
 }
+export {};

package/dist/esm/v3/locals/manager.js

@@ -1,7 +1,7 @@
 export class NoopLocalsManager {
     createLocal(id) {
         return {
-            __type: Symbol(),
+            __type: Symbol(id),
             id,
         };
     }

package/dist/esm/v3/locals/manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../../src/v3/locals/manager.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,iBAAiB;IAC5B,WAAW,CAAI,EAAU;QACvB,OAAO;YACL,MAAM,EAAE,MAAM,EAAE;YAChB,EAAE;SACH,CAAC;IACJ,CAAC;IAED,QAAQ,CAAI,GAAiB;QAC3B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,QAAQ,CAAI,GAAiB,EAAE,KAAQ,IAAS,CAAC;CAClD;AAED,MAAM,OAAO,qBAAqB;IACxB,KAAK,GAAyB,IAAI,GAAG,EAAE,CAAC;IAEhD,WAAW,CAAI,EAAU;QACvB,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3B,OAAO;YACL,MAAM,EAAE,GAAG;YACX,EAAE;SACH,CAAC;IACJ,CAAC;IAED,QAAQ,CAAI,GAAiB;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAkB,CAAC;IACrD,CAAC;IAED,QAAQ,CAAI,GAAiB,EAAE,KAAQ;QACrC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../../src/v3/locals/manager.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,iBAAiB;IAC5B,WAAW,CAAI,EAAU;QACvB,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;YAClB,EAAE;SACH,CAAC;IACJ,CAAC;IAED,QAAQ,CAAI,GAAiB;QAC3B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,QAAQ,CAAI,GAAiB,EAAE,KAAQ,IAAS,CAAC;CAClD;AAED,MAAM,OAAO,qBAAqB;IACxB,KAAK,GAAyB,IAAI,GAAG,EAAE,CAAC;IAEhD,WAAW,CAAI,EAAU;QACvB,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3B,OAAO;YACL,MAAM,EAAE,GAAG;YACX,EAAE;SACH,CAAC;IACJ,CAAC;IAED,QAAQ,CAAI,GAAiB;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAkB,CAAC;IACrD,CAAC;IAED,QAAQ,CAAI,GAAiB,EAAE,KAAQ;QACrC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}

package/dist/esm/v3/logger/taskLogger.d.ts

@@ -4,7 +4,7 @@ import type { TriggerTracer } from "../tracer.js";
 import type { Prettify } from "../types/utils.js";
 export type LogLevel = "none" | "error" | "warn" | "info" | "debug" | "log";
 export declare const logLevels: Array<LogLevel>;
-export type TaskLoggerConfig = {
+type TaskLoggerConfig = {
     logger: Logger;
     tracer: TriggerTracer;
     level: LogLevel;
@@ -44,3 +44,4 @@ export declare class NoopTaskLogger implements TaskLogger {
     trace<T>(name: string, fn: (span: Span) => Promise<T>): Promise<T>;
     startSpan(): Span;
 }
+export {};

package/dist/esm/v3/otel/tracingSDK.d.ts

@@ -1,9 +1,10 @@
 import type { TracerProvider } from "@opentelemetry/api";
 import { type Instrumentation } from "@opentelemetry/instrumentation";
 import type { Resource } from "@opentelemetry/resources";
-import type { LogRecordExporter } from "@opentelemetry/sdk-logs";
+import type { LogRecordExporter, ReadableLogRecord } from "@opentelemetry/sdk-logs";
 import { LoggerProvider } from "@opentelemetry/sdk-logs";
 import { type MetricReader, type PushMetricExporter } from "@opentelemetry/sdk-metrics";
+import { RandomIdGenerator } from "@opentelemetry/sdk-trace-base";
 import type { SpanExporter } from "@opentelemetry/sdk-trace-node";
 export type TracingDiagnosticLogLevel = "none" | "error" | "warn" | "info" | "debug" | "verbose" | "all";
 export type TracingSDKConfig = {
@@ -35,19 +36,62 @@ export declare class TracingSDK {
     private readonly _spanExporter;
     private readonly _traceProvider;
     private readonly _meterProvider;
+    private readonly _metricReaders;
     readonly getLogger: LoggerProvider["getLogger"];
     readonly getTracer: TracerProvider["getTracer"];
     constructor(config: TracingSDKConfig);
     flush(): Promise<void>;
+    private _flushMetricReadersSerially;
+    private _shutdownMetricReadersSerially;
+    private _eachMetricReaderSerially;
     shutdown(): Promise<void>;
 }
+/** Only the current run and the tail of recently ended ones can still export. */
+export declare const MAX_TRACKED_INTERNAL_TRACES = 64;
+/**
+ * External trace ids for runs that carry no external trace context — with
+ * `processKeepAlive` the `TracingSDK` outlives the run, so an id captured at
+ * construction merges every run on the process into one trace.
+ *
+ * A record's id comes from its own internal trace id rather than from whatever
+ * run is current when the exporter is called. Batch processors drain
+ * asynchronously, so a run's records are routinely exported after the next run
+ * has started, and reading ambient state then would stamp them with the wrong
+ * run's id. It also makes a run's spans and logs agree without coordinating.
+ *
+ * Granularity therefore follows the internal trace, not the run: a run tree
+ * shares one internal trace, so a parent and the runs it triggers land on one
+ * external trace together, which is the grouping you want.
+ */
+export declare class FallbackExternalTraceIds {
+    private seed;
+    private traceIdGenerator;
+    private readonly byInternalTrace;
+    constructor(seed: string, traceIdGenerator?: Pick<RandomIdGenerator, "generateTraceId">);
+    /** False when no external trace id was configured, i.e. external export is off. */
+    get enabled(): boolean;
+    forInternalTrace(internalTraceId: string): string;
+}
 export declare class ExternalSpanExporterWrapper {
     private underlyingExporter;
-    private externalTraceId;
-    constructor(underlyingExporter: SpanExporter, externalTraceId: string);
+    private fallback;
+    constructor(underlyingExporter: SpanExporter, fallback: FallbackExternalTraceIds);
     private transformSpan;
     export(spans: any[], resultCallback: (result: any) => void): void;
     shutdown(): Promise<void>;
     forceFlush?(): Promise<void>;
 }
-export declare function parseOtelResourceAttributes(rawEnvAttributes: string | undefined | null): Record<string, string>;
+export declare class ExternalLogRecordExporterWrapper {
+    private underlyingExporter;
+    private fallback;
+    constructor(underlyingExporter: LogRecordExporter, fallback: FallbackExternalTraceIds);
+    export(logs: any[], resultCallback: (result: any) => void): void;
+    shutdown(): Promise<void>;
+    forceFlush(): Promise<void>;
+    transformLogRecord(logRecord: ReadableLogRecord, externalTraceContext: {
+        traceId: string;
+        spanId: string;
+        tracestate?: string;
+        traceFlags: number;
+    } | undefined): ReadableLogRecord;
+}