Function exportBundle

packages/core/src/debug/debugController.ts:496–644

(options?: DebugBundleExportOptions)

  }

  async function exportBundle(options?: DebugBundleExportOptions): Promise<DebugBundle> {
    const maxRecords = normalizeBound(options?.maxRecords, DEBUG_BUNDLE_DEFAULT_MAX_RECORDS);
    const maxPayloadBytes = normalizeBound(
      options?.maxPayloadBytes,
      DEBUG_BUNDLE_DEFAULT_MAX_PAYLOAD_BYTES,
    );
    const maxTotalPayloadBytes = normalizeBound(
      options?.maxTotalPayloadBytes,
      DEBUG_BUNDLE_DEFAULT_MAX_TOTAL_PAYLOAD_BYTES,
    );
    const maxRecentFrames = normalizeBound(
      options?.maxRecentFrames,
      DEBUG_BUNDLE_DEFAULT_MAX_RECENT_FRAMES,
    );
    const includeRecentFrames = options?.includeRecentFrames !== false;

    const captureRawEvents = options?.includeRawEvents ?? currentConfig?.captureRawEvents ?? false;
    const captureDrawlistBytes =
      options?.includeDrawlistBytes ?? currentConfig?.captureDrawlistBytes ?? false;

    const stats = await backend.debugGetStats();
    const statsSnapshot = toBundleStats(stats);
    const terminalCaps = await resolveTerminalCaps(options?.terminalCaps);

    let queryResult: DebugQueryResult = {
      recordsReturned: 0,
      recordsAvailable: 0,
      oldestRecordId: 0n,
      newestRecordId: 0n,
      recordsDropped: 0,
    };
    let headersBytes: Uint8Array<ArrayBufferLike> = new Uint8Array(0);

    if (maxRecords > 0) {
      const queried = await backend.debugQuery({ maxRecords });
      headersBytes = queried.headers;
      queryResult = queried.result;
    }

    const parsedHeaders: DebugRecordHeader[] = [];
    const count = Math.min(
      queryResult.recordsReturned,
      Math.floor(headersBytes.byteLength / DEBUG_RECORD_HEADER_SIZE),
    );

    for (let i = 0; i < count; i++) {
      const offset = i * DEBUG_RECORD_HEADER_SIZE;
      const parsed = parseRecordHeader(headersBytes, offset);
      if (parsed.ok) {
        parsedHeaders.push(parsed.value);
      }
    }

    parsedHeaders.sort((a, b) => compareBigInt(a.recordId, b.recordId));

    let payloadBudgetRemaining = maxTotalPayloadBytes;
    const trace: Array<{
      header: DebugBundleHeader;