@backblaze-labs/b2-sdk 0.3.0 → 0.4.0

package/dist/sync/scanners/b2.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"b2.cjs","names":[],"sources":["../../../src/sync/scanners/b2.ts"],"sourcesContent":["import type { Bucket } from '../../bucket.ts'\nimport { FileAction, type FileVersion } from '../../types/file.ts'\nimport type { FileId } from '../../types/ids.ts'\nimport { isSignalAbortError } from '../../util/abort.ts'\nimport { sanitizeErrorReason } from '../../util/error-reason.ts'\nimport {\n  literalPrefixForSyncFilters,\n  pathPassesSyncFilters,\n  pathSkippedByRegExpInputLimit,\n} from '../filters.ts'\nimport { compareCodeUnits, compareSyncRelativePaths } from '../path-order.ts'\nimport { assertSyncPathAllowed } from '../paths.ts'\nimport {\n  asRawB2KeyPrefix,\n  b2KeyToRelativePathUnderPrefix,\n  localFilesystemCanonicalSyncPath,\n  localFilesystemSyncPathIsUnsafe,\n} from '../prefix.ts'\nimport { validateSyncFilters } from '../regexp-safety.ts'\nimport { emitScannerSkip, regexpInputTooLongSkip } from '../scan-events.ts'\nimport { assertScanEntryLimit, scanEntryLimit } from '../scan-limit.ts'\nimport { selectB2ComparableSha1, syncSha1StateOf } from '../sha1-metadata.ts'\nimport type {\n  B2SyncPath,\n  SyncErrorEvent,\n  SyncFolder,\n  SyncScanOptions,\n  SyncSkipReason,\n} from '../types.ts'\n\nconst MAX_EMPTY_B2_SCAN_PAGES = 100\n\ninterface B2ScanEntry {\n  relativePath: string\n  versions: FileVersion[]\n}\n\ninterface VisibleB2ScanEntry extends B2ScanEntry {\n  fileName: string\n  selectedVersion: FileVersion\n}\n\n/**\n * Scans a B2 bucket (optionally filtered by a raw B2 key prefix) and yields\n * {@link B2SyncPath} entries sorted by `compareSyncRelativePaths(relativePath)`. Hidden files are excluded.\n * Raw B2 file names are used only as an internal tie-breaker after collision handling.\n * All versions for the listed prefix are fetched, grouped, and sorted before\n * yielding; exclude filters are applied client-side and do not reduce that\n * B2 listing memory footprint.\n * SDK-reserved temporary names fail the scan because syncing them could corrupt\n * in-progress transfers.\n */\nexport class B2Folder implements SyncFolder {\n  readonly type = 'b2' as const\n  readonly appliesScanFilters = true as const\n  readonly appliesScanSorting = true as const\n  /** Raw B2 key prefix this folder scans, preserving caller-provided separators verbatim. */\n  readonly rawPrefix: string\n  private readonly bucket: Bucket\n\n  /**\n   * Creates a new B2Folder for the given bucket and optional prefix.\n   * @param bucket - The B2 bucket to scan.\n   * @param prefix - Optional raw B2 key prefix to restrict the scan scope.\n   * Backslashes are preserved as raw B2 key characters; pass `/` explicitly for slash prefixes.\n   */\n  constructor(bucket: Bucket, prefix = '') {\n    this.bucket = bucket\n    this.rawPrefix = asRawB2KeyPrefix(prefix)\n  }\n\n  /**\n   * Lists all file versions in the bucket, groups by name, and yields the latest visible version.\n   * @param options - Optional scan controls.\n   */\n  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: pagination, grouping, and filtering stay in one async iterator.\n  async *scan(options: SyncScanOptions = {}): AsyncGenerator<B2SyncPath> {\n    validateSyncFilters(options)\n    const maxScanEntries = scanEntryLimit(options)\n    const grouped = new Map<string, B2ScanEntry>()\n    const listPrefix = this.listPrefixFor(options)\n\n    let listedVersions = 0\n    let startFileName: string | undefined\n    let startFileId: FileId | undefined\n    let emptyPageCount = 0\n\n    while (true) {\n      if (scanIsAborted(options)) return\n\n      let listing: Awaited<ReturnType<Bucket['listFileVersions']>>\n      try {\n        listing = await this.bucket.listFileVersions({\n          ...(listPrefix !== '' ? { prefix: listPrefix } : {}),\n          ...(startFileName !== undefined ? { startFileName } : {}),\n          ...(startFileId !== undefined ? { startFileId } : {}),\n          ...(options.signal !== undefined ? { signal: options.signal } : {}),\n        })\n      } catch (err) {\n        if (isSignalAbortError(options.signal, err)) return\n        throw emitScanError(options, 'failed to scan B2 file versions', err)\n      }\n      if (scanIsAborted(options)) return\n\n      if (listing.files.length === 0) {\n        emptyPageCount++\n        if (emptyPageCount > MAX_EMPTY_B2_SCAN_PAGES) {\n          throw emitScanError(\n            options,\n            'failed to scan B2 file versions',\n            new Error('B2 pagination returned too many empty pages'),\n          )\n        }\n      } else {\n        emptyPageCount = 0\n      }\n\n      for (const fv of listing.files) {\n        if (scanIsAborted(options)) return\n        assertScanEntryLimit(listedVersions + 1, maxScanEntries)\n        listedVersions++\n\n        // Real B2 honors the prefix in listFileVersions, but custom\n        // transports and the simulator can over-return. Guard before\n        // stripping the raw prefix so relativePath is never corrupted.\n        if (this.rawPrefix !== '' && !fv.fileName.startsWith(this.rawPrefix)) {\n          this.emitSkip(\n            options,\n            fv.fileName,\n            fv.fileName,\n            'outside-prefix',\n            `listed object is outside configured B2 prefix ${JSON.stringify(this.rawPrefix)}`,\n          )\n          continue\n        }\n\n        if (options.requireLocalSafePaths === true && fv.fileName.includes('\\\\')) {\n          this.emitSkip(\n            options,\n            fv.fileName,\n            fv.fileName,\n            'local-unsafe-name',\n            'object name contains a backslash that is unsafe for local filesystem destinations',\n          )\n          continue\n        }\n\n        const relativePath = this.tryToRelativePath(fv.fileName)\n        if (relativePath === null) {\n          this.emitSkip(\n            options,\n            fv.fileName,\n            fv.fileName,\n            'unsafe-name',\n            'object name cannot be represented as a safe sync relative path',\n          )\n          continue\n        }\n\n        if (!pathPassesSyncFilters(relativePath, options)) {\n          if (pathSkippedByRegExpInputLimit(relativePath, options)) {\n            emitScannerSkip(options, {\n              ...regexpInputTooLongSkip(relativePath),\n              b2FileName: fv.fileName,\n            })\n          }\n          continue\n        }\n\n        const existing = grouped.get(fv.fileName)\n        if (existing) {\n          existing.versions.push(fv)\n        } else {\n          grouped.set(fv.fileName, { relativePath, versions: [fv] })\n        }\n      }\n\n      if (!listing.nextFileName) break\n      if (\n        listing.nextFileName === startFileName &&\n        (listing.nextFileId ?? undefined) === startFileId\n      ) {\n        throw emitScanError(\n          options,\n          'failed to scan B2 file versions',\n          new Error('B2 pagination did not advance'),\n        )\n      }\n      startFileName = listing.nextFileName\n      startFileId = listing.nextFileId ?? undefined\n    }\n\n    const visible = this.visibleCandidates(grouped, options)\n    const withoutRelativeCollisions = this.rejectRelativePathCollisions(visible, options)\n    const safeCandidates =\n      options.requireLocalSafePaths === true\n        ? this.rejectLocalPathCollisions(withoutRelativeCollisions, options)\n        : withoutRelativeCollisions\n    const sorted = safeCandidates.sort(\n      (a, b) =>\n        compareSyncRelativePaths(a.relativePath, b.relativePath) ||\n        compareCodeUnits(a.fileName, b.fileName),\n    )\n\n    for (const { relativePath, versions, selectedVersion } of sorted) {\n      if (scanIsAborted(options)) return\n      // Reserved SDK temp names are a hard safety failure, not an ordinary filter.\n      assertSyncPathAllowed(relativePath)\n      const contentSha1 = selectB2ComparableSha1(selectedVersion)\n      yield {\n        relativePath,\n        modTimeMillis: selectedVersion.uploadTimestamp,\n        size: selectedVersion.contentLength,\n        contentSha1,\n        contentSha1State: syncSha1StateOf({ contentSha1 }),\n        selectedVersion,\n        allVersions: versions,\n      }\n    }\n  }\n\n  private tryToRelativePath(fileName: string): string | null {\n    try {\n      return b2KeyToRelativePathUnderPrefix(this.rawPrefix, fileName)\n    } catch {\n      return null\n    }\n  }\n\n  private listPrefixFor(filters: SyncScanOptions | undefined): string {\n    const filterPrefix = literalPrefixForSyncFilters(filters)\n    if (filterPrefix === '') return this.rawPrefix\n    if (this.rawPrefix !== '' && !this.rawPrefix.endsWith('/')) return this.rawPrefix\n    return `${this.rawPrefix}${rawPrefixBeforeNormalizedSeparator(filterPrefix)}`\n  }\n\n  private visibleCandidates(\n    grouped: Map<string, B2ScanEntry>,\n    filters: SyncScanOptions | undefined,\n  ): VisibleB2ScanEntry[] {\n    const visible: VisibleB2ScanEntry[] = []\n\n    for (const [fileName, entry] of grouped) {\n      entry.versions.sort((a, b) => b.uploadTimestamp - a.uploadTimestamp)\n      const selected = entry.versions[0]\n      if (!selected || selected.action === FileAction.Hide) continue\n\n      if (\n        filters?.requireLocalSafePaths === true &&\n        localFilesystemSyncPathIsUnsafe(entry.relativePath)\n      ) {\n        this.emitSkip(\n          filters,\n          entry.relativePath,\n          fileName,\n          'local-unsafe-name',\n          'object name is unsafe for a local filesystem destination',\n        )\n        continue\n      }\n\n      visible.push({\n        fileName,\n        relativePath: entry.relativePath,\n        versions: entry.versions,\n        selectedVersion: selected,\n      })\n    }\n\n    return visible\n  }\n\n  private rejectRelativePathCollisions(\n    candidates: VisibleB2ScanEntry[],\n    filters: SyncScanOptions | undefined,\n  ): VisibleB2ScanEntry[] {\n    const accepted: VisibleB2ScanEntry[] = []\n    const owners = new Map<string, VisibleB2ScanEntry>()\n    const collidedRelativePaths = new Set<string>()\n\n    for (const candidate of candidates) {\n      if (collidedRelativePaths.has(candidate.relativePath)) {\n        this.emitSkip(\n          filters,\n          candidate.relativePath,\n          candidate.fileName,\n          'relative-path-collision',\n          'object normalizes to a relative path already rejected because of another raw B2 key',\n        )\n        continue\n      }\n\n      const owner = owners.get(candidate.relativePath)\n      if (owner !== undefined && owner.fileName !== candidate.fileName) {\n        owners.delete(candidate.relativePath)\n        removeAcceptedCandidate(accepted, owner)\n        collidedRelativePaths.add(candidate.relativePath)\n        this.emitSkip(\n          filters,\n          candidate.relativePath,\n          owner.fileName,\n          'relative-path-collision',\n          `object normalizes to the same relative path as ${JSON.stringify(candidate.fileName)}`,\n        )\n        this.emitSkip(\n          filters,\n          candidate.relativePath,\n          candidate.fileName,\n          'relative-path-collision',\n          `object normalizes to the same relative path as ${JSON.stringify(owner.fileName)}`,\n        )\n        continue\n      }\n\n      owners.set(candidate.relativePath, candidate)\n      accepted.push(candidate)\n    }\n\n    return accepted\n  }\n\n  private rejectLocalPathCollisions(\n    candidates: VisibleB2ScanEntry[],\n    filters: SyncScanOptions | undefined,\n  ): VisibleB2ScanEntry[] {\n    const accepted: VisibleB2ScanEntry[] = []\n    const owners = new Map<string, VisibleB2ScanEntry>()\n    const collidedLocalPaths = new Set<string>()\n\n    for (const candidate of candidates) {\n      const canonicalPath = localFilesystemCanonicalSyncPath(candidate.relativePath)\n      if (collidedLocalPaths.has(canonicalPath)) {\n        this.emitSkip(\n          filters,\n          candidate.relativePath,\n          candidate.fileName,\n          'local-path-collision',\n          'object collides with another object on case-insensitive or Unicode-normalizing filesystems',\n        )\n        continue\n      }\n\n      const owner = owners.get(canonicalPath)\n      if (owner !== undefined) {\n        owners.delete(canonicalPath)\n        removeAcceptedCandidate(accepted, owner)\n        collidedLocalPaths.add(canonicalPath)\n        this.emitSkip(\n          filters,\n          owner.relativePath,\n          owner.fileName,\n          'local-path-collision',\n          `object collides with ${JSON.stringify(candidate.fileName)} on local filesystems`,\n        )\n        this.emitSkip(\n          filters,\n          candidate.relativePath,\n          candidate.fileName,\n          'local-path-collision',\n          `object collides with ${JSON.stringify(owner.fileName)} on local filesystems`,\n        )\n        continue\n      }\n\n      owners.set(canonicalPath, candidate)\n      accepted.push(candidate)\n    }\n\n    return accepted\n  }\n\n  private emitSkip(\n    filters: SyncScanOptions | undefined,\n    path: string,\n    b2FileName: string,\n    reason: SyncSkipReason,\n    message: string,\n  ): void {\n    emitScannerSkip(filters, {\n      type: 'skip',\n      path,\n      size: 0,\n      message: `Skipped B2 object ${JSON.stringify(b2FileName)}: ${message}`,\n      reason,\n      b2FileName,\n    })\n  }\n}\n\nfunction rawPrefixBeforeNormalizedSeparator(filterPrefix: string): string {\n  const separatorIndex = filterPrefix.indexOf('/')\n  return separatorIndex === -1 ? filterPrefix : filterPrefix.slice(0, separatorIndex)\n}\n\nfunction emitScanError(options: SyncScanOptions, message: string, err: unknown): Error {\n  const event: SyncErrorEvent = {\n    type: 'error',\n    path: '',\n    size: 0,\n    message: `${message}: ${sanitizeErrorReason(err)}`,\n  }\n  options.onError?.(event)\n  return new Error(event.message)\n}\n\nfunction removeAcceptedCandidate(\n  candidates: VisibleB2ScanEntry[],\n  target: VisibleB2ScanEntry,\n): void {\n  const index = candidates.indexOf(target)\n  if (index !== -1) candidates.splice(index, 1)\n}\n\nfunction scanIsAborted(filters: SyncScanOptions | undefined): boolean {\n  return filters?.signal?.aborted === true\n}\n"],"mappings":"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"}
+{"version":3,"file":"b2.cjs","names":[],"sources":["../../../src/sync/scanners/b2.ts"],"sourcesContent":["import type { Bucket } from '../../bucket.ts'\nimport {\n  FileAction,\n  type FileVersion,\n  type ListedConcreteFileVersion,\n  type ListFileVersionsResponse,\n} from '../../types/file.ts'\nimport type { FileId } from '../../types/ids.ts'\nimport { isSignalAbortError } from '../../util/abort.ts'\nimport { sanitizeErrorReason } from '../../util/error-reason.ts'\nimport {\n  literalPrefixForSyncFilters,\n  pathPassesSyncFilters,\n  pathSkippedByRegExpInputLimit,\n} from '../filters.ts'\nimport { compareCodeUnits, compareSyncRelativePaths } from '../path-order.ts'\nimport { assertSyncPathAllowed } from '../paths.ts'\nimport {\n  asRawB2KeyPrefix,\n  b2KeyToRelativePathUnderPrefix,\n  localFilesystemCanonicalSyncPath,\n  localFilesystemSyncPathIsUnsafe,\n} from '../prefix.ts'\nimport { validateSyncFilters } from '../regexp-safety.ts'\nimport { emitScannerSkip, regexpInputTooLongSkip } from '../scan-events.ts'\nimport { assertScanEntryLimit, scanEntryLimit } from '../scan-limit.ts'\nimport { selectB2ComparableSha1, syncSha1StateOf } from '../sha1-metadata.ts'\nimport type {\n  B2SyncPath,\n  SyncErrorEvent,\n  SyncFolder,\n  SyncScanOptions,\n  SyncSkipReason,\n} from '../types.ts'\n\nconst MAX_EMPTY_B2_SCAN_PAGES = 100\n\ninterface B2ScanEntry {\n  relativePath: string\n  versions: ListedConcreteFileVersion[]\n}\n\ninterface VisibleB2ScanEntry extends B2ScanEntry {\n  fileName: string\n  selectedVersion: FileVersion\n}\n\n/**\n * Scans a B2 bucket (optionally filtered by a raw B2 key prefix) and yields\n * {@link B2SyncPath} entries sorted by `compareSyncRelativePaths(relativePath)`. Hidden files are excluded.\n * Raw B2 file names are used only as an internal tie-breaker after collision handling.\n * All versions for the listed prefix are fetched, grouped, and sorted before\n * yielding; exclude filters are applied client-side and do not reduce that\n * B2 listing memory footprint.\n * SDK-reserved temporary names fail the scan because syncing them could corrupt\n * in-progress transfers.\n */\nexport class B2Folder implements SyncFolder {\n  readonly type = 'b2' as const\n  readonly appliesScanFilters = true as const\n  readonly appliesScanSorting = true as const\n  /** Raw B2 key prefix this folder scans, preserving caller-provided separators verbatim. */\n  readonly rawPrefix: string\n  private readonly bucket: Bucket\n\n  /**\n   * Creates a new B2Folder for the given bucket and optional prefix.\n   * @param bucket - The B2 bucket to scan.\n   * @param prefix - Optional raw B2 key prefix to restrict the scan scope.\n   * Backslashes are preserved as raw B2 key characters; pass `/` explicitly for slash prefixes.\n   */\n  constructor(bucket: Bucket, prefix = '') {\n    this.bucket = bucket\n    this.rawPrefix = asRawB2KeyPrefix(prefix)\n  }\n\n  /**\n   * Lists all file versions in the bucket, groups by name, and yields the latest visible version.\n   * @param options - Optional scan controls.\n   */\n  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: pagination, grouping, and filtering stay in one async iterator.\n  async *scan(options: SyncScanOptions = {}): AsyncGenerator<B2SyncPath> {\n    validateSyncFilters(options)\n    const maxScanEntries = scanEntryLimit(options)\n    const grouped = new Map<string, B2ScanEntry>()\n    const listPrefix = this.listPrefixFor(options)\n\n    let listedVersions = 0\n    let startFileName: string | undefined\n    let startFileId: FileId | undefined\n    let emptyPageCount = 0\n\n    while (true) {\n      if (scanIsAborted(options)) return\n\n      let listing: ListFileVersionsResponse\n      try {\n        listing = await this.bucket.listFileVersions({\n          ...(listPrefix !== '' ? { prefix: listPrefix } : {}),\n          ...(startFileName !== undefined ? { startFileName } : {}),\n          ...(startFileId !== undefined ? { startFileId } : {}),\n          ...(options.signal !== undefined ? { signal: options.signal } : {}),\n        })\n      } catch (err) {\n        if (isSignalAbortError(options.signal, err)) return\n        throw emitScanError(options, 'failed to scan B2 file versions', err)\n      }\n      if (scanIsAborted(options)) return\n\n      if (listing.files.length === 0) {\n        emptyPageCount++\n        if (emptyPageCount > MAX_EMPTY_B2_SCAN_PAGES) {\n          throw emitScanError(\n            options,\n            'failed to scan B2 file versions',\n            new Error('B2 pagination returned too many empty pages'),\n          )\n        }\n      } else {\n        emptyPageCount = 0\n      }\n\n      for (const fv of listing.files) {\n        if (scanIsAborted(options)) return\n        assertScanEntryLimit(listedVersions + 1, maxScanEntries)\n        listedVersions++\n\n        const runtimeFile = fv as { readonly action?: unknown; readonly fileId?: unknown }\n        if (runtimeFile.action === FileAction.Folder || typeof runtimeFile.fileId !== 'string') {\n          throw emitScanError(\n            options,\n            'failed to scan B2 file versions',\n            new Error(\n              'B2 listFileVersions returned a delimiter folder row or row without a string fileId even though the scanner did not request delimiter grouping',\n            ),\n          )\n        }\n\n        // Real B2 honors the prefix in listFileVersions, but custom\n        // transports and the simulator can over-return. Guard before\n        // stripping the raw prefix so relativePath is never corrupted.\n        if (this.rawPrefix !== '' && !fv.fileName.startsWith(this.rawPrefix)) {\n          this.emitSkip(\n            options,\n            fv.fileName,\n            fv.fileName,\n            'outside-prefix',\n            `listed object is outside configured B2 prefix ${JSON.stringify(this.rawPrefix)}`,\n          )\n          continue\n        }\n\n        if (options.requireLocalSafePaths === true && fv.fileName.includes('\\\\')) {\n          this.emitSkip(\n            options,\n            fv.fileName,\n            fv.fileName,\n            'local-unsafe-name',\n            'object name contains a backslash that is unsafe for local filesystem destinations',\n          )\n          continue\n        }\n\n        const relativePath = this.tryToRelativePath(fv.fileName)\n        if (relativePath === null) {\n          this.emitSkip(\n            options,\n            fv.fileName,\n            fv.fileName,\n            'unsafe-name',\n            'object name cannot be represented as a safe sync relative path',\n          )\n          continue\n        }\n\n        if (!pathPassesSyncFilters(relativePath, options)) {\n          if (pathSkippedByRegExpInputLimit(relativePath, options)) {\n            emitScannerSkip(options, {\n              ...regexpInputTooLongSkip(relativePath),\n              b2FileName: fv.fileName,\n            })\n          }\n          continue\n        }\n\n        const existing = grouped.get(fv.fileName)\n        if (existing) {\n          existing.versions.push(fv)\n        } else {\n          grouped.set(fv.fileName, { relativePath, versions: [fv] })\n        }\n      }\n\n      if (!listing.nextFileName) break\n      if (\n        listing.nextFileName === startFileName &&\n        (listing.nextFileId ?? undefined) === startFileId\n      ) {\n        throw emitScanError(\n          options,\n          'failed to scan B2 file versions',\n          new Error('B2 pagination did not advance'),\n        )\n      }\n      startFileName = listing.nextFileName\n      startFileId = listing.nextFileId ?? undefined\n    }\n\n    const visible = this.visibleCandidates(grouped, options)\n    const withoutRelativeCollisions = this.rejectRelativePathCollisions(visible, options)\n    const safeCandidates =\n      options.requireLocalSafePaths === true\n        ? this.rejectLocalPathCollisions(withoutRelativeCollisions, options)\n        : withoutRelativeCollisions\n    const sorted = safeCandidates.sort(\n      (a, b) =>\n        compareSyncRelativePaths(a.relativePath, b.relativePath) ||\n        compareCodeUnits(a.fileName, b.fileName),\n    )\n\n    for (const { relativePath, versions, selectedVersion } of sorted) {\n      if (scanIsAborted(options)) return\n      // Reserved SDK temp names are a hard safety failure, not an ordinary filter.\n      assertSyncPathAllowed(relativePath)\n      const contentSha1 = selectB2ComparableSha1(selectedVersion)\n      yield {\n        relativePath,\n        modTimeMillis: selectedVersion.uploadTimestamp,\n        size: selectedVersion.contentLength,\n        contentSha1,\n        contentSha1State: syncSha1StateOf({ contentSha1 }),\n        selectedVersion,\n        allVersions: versions,\n      }\n    }\n  }\n\n  private tryToRelativePath(fileName: string): string | null {\n    try {\n      return b2KeyToRelativePathUnderPrefix(this.rawPrefix, fileName)\n    } catch {\n      return null\n    }\n  }\n\n  private listPrefixFor(filters: SyncScanOptions | undefined): string {\n    const filterPrefix = literalPrefixForSyncFilters(filters)\n    if (filterPrefix === '') return this.rawPrefix\n    if (this.rawPrefix !== '' && !this.rawPrefix.endsWith('/')) return this.rawPrefix\n    return `${this.rawPrefix}${rawPrefixBeforeNormalizedSeparator(filterPrefix)}`\n  }\n\n  private visibleCandidates(\n    grouped: Map<string, B2ScanEntry>,\n    filters: SyncScanOptions | undefined,\n  ): VisibleB2ScanEntry[] {\n    const visible: VisibleB2ScanEntry[] = []\n\n    for (const [fileName, entry] of grouped) {\n      entry.versions.sort((a, b) => b.uploadTimestamp - a.uploadTimestamp)\n      const selected = entry.versions[0]\n      if (!selected || selected.action === FileAction.Hide) continue\n\n      if (\n        filters?.requireLocalSafePaths === true &&\n        localFilesystemSyncPathIsUnsafe(entry.relativePath)\n      ) {\n        this.emitSkip(\n          filters,\n          entry.relativePath,\n          fileName,\n          'local-unsafe-name',\n          'object name is unsafe for a local filesystem destination',\n        )\n        continue\n      }\n\n      visible.push({\n        fileName,\n        relativePath: entry.relativePath,\n        versions: entry.versions,\n        selectedVersion: selected,\n      })\n    }\n\n    return visible\n  }\n\n  private rejectRelativePathCollisions(\n    candidates: VisibleB2ScanEntry[],\n    filters: SyncScanOptions | undefined,\n  ): VisibleB2ScanEntry[] {\n    const accepted: VisibleB2ScanEntry[] = []\n    const owners = new Map<string, VisibleB2ScanEntry>()\n    const collidedRelativePaths = new Set<string>()\n\n    for (const candidate of candidates) {\n      if (collidedRelativePaths.has(candidate.relativePath)) {\n        this.emitSkip(\n          filters,\n          candidate.relativePath,\n          candidate.fileName,\n          'relative-path-collision',\n          'object normalizes to a relative path already rejected because of another raw B2 key',\n        )\n        continue\n      }\n\n      const owner = owners.get(candidate.relativePath)\n      if (owner !== undefined && owner.fileName !== candidate.fileName) {\n        owners.delete(candidate.relativePath)\n        removeAcceptedCandidate(accepted, owner)\n        collidedRelativePaths.add(candidate.relativePath)\n        this.emitSkip(\n          filters,\n          candidate.relativePath,\n          owner.fileName,\n          'relative-path-collision',\n          `object normalizes to the same relative path as ${JSON.stringify(candidate.fileName)}`,\n        )\n        this.emitSkip(\n          filters,\n          candidate.relativePath,\n          candidate.fileName,\n          'relative-path-collision',\n          `object normalizes to the same relative path as ${JSON.stringify(owner.fileName)}`,\n        )\n        continue\n      }\n\n      owners.set(candidate.relativePath, candidate)\n      accepted.push(candidate)\n    }\n\n    return accepted\n  }\n\n  private rejectLocalPathCollisions(\n    candidates: VisibleB2ScanEntry[],\n    filters: SyncScanOptions | undefined,\n  ): VisibleB2ScanEntry[] {\n    const accepted: VisibleB2ScanEntry[] = []\n    const owners = new Map<string, VisibleB2ScanEntry>()\n    const collidedLocalPaths = new Set<string>()\n\n    for (const candidate of candidates) {\n      const canonicalPath = localFilesystemCanonicalSyncPath(candidate.relativePath)\n      if (collidedLocalPaths.has(canonicalPath)) {\n        this.emitSkip(\n          filters,\n          candidate.relativePath,\n          candidate.fileName,\n          'local-path-collision',\n          'object collides with another object on case-insensitive or Unicode-normalizing filesystems',\n        )\n        continue\n      }\n\n      const owner = owners.get(canonicalPath)\n      if (owner !== undefined) {\n        owners.delete(canonicalPath)\n        removeAcceptedCandidate(accepted, owner)\n        collidedLocalPaths.add(canonicalPath)\n        this.emitSkip(\n          filters,\n          owner.relativePath,\n          owner.fileName,\n          'local-path-collision',\n          `object collides with ${JSON.stringify(candidate.fileName)} on local filesystems`,\n        )\n        this.emitSkip(\n          filters,\n          candidate.relativePath,\n          candidate.fileName,\n          'local-path-collision',\n          `object collides with ${JSON.stringify(owner.fileName)} on local filesystems`,\n        )\n        continue\n      }\n\n      owners.set(canonicalPath, candidate)\n      accepted.push(candidate)\n    }\n\n    return accepted\n  }\n\n  private emitSkip(\n    filters: SyncScanOptions | undefined,\n    path: string,\n    b2FileName: string,\n    reason: SyncSkipReason,\n    message: string,\n  ): void {\n    emitScannerSkip(filters, {\n      type: 'skip',\n      path,\n      size: 0,\n      message: `Skipped B2 object ${JSON.stringify(b2FileName)}: ${message}`,\n      reason,\n      b2FileName,\n    })\n  }\n}\n\nfunction rawPrefixBeforeNormalizedSeparator(filterPrefix: string): string {\n  const separatorIndex = filterPrefix.indexOf('/')\n  return separatorIndex === -1 ? filterPrefix : filterPrefix.slice(0, separatorIndex)\n}\n\nfunction emitScanError(options: SyncScanOptions, message: string, err: unknown): Error {\n  const event: SyncErrorEvent = {\n    type: 'error',\n    path: '',\n    size: 0,\n    message: `${message}: ${sanitizeErrorReason(err)}`,\n  }\n  options.onError?.(event)\n  return new Error(event.message)\n}\n\nfunction removeAcceptedCandidate(\n  candidates: VisibleB2ScanEntry[],\n  target: VisibleB2ScanEntry,\n): void {\n  const index = candidates.indexOf(target)\n  if (index !== -1) candidates.splice(index, 1)\n}\n\nfunction scanIsAborted(filters: SyncScanOptions | undefined): boolean {\n  return filters?.signal?.aborted === true\n}\n"],"mappings":"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"}

package/dist/sync/scanners/b2.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"b2.d.ts","sourceRoot":"","sources":["../../../src/sync/scanners/b2.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAsB7C,OAAO,KAAK,EACV,UAAU,EAEV,UAAU,EACV,eAAe,EAEhB,MAAM,aAAa,CAAA;AAcpB;;;;;;;;;GASG;AACH,qBAAa,QAAS,YAAW,UAAU;IACzC,QAAQ,CAAC,IAAI,EAAG,IAAI,CAAS;IAC7B,QAAQ,CAAC,kBAAkB,EAAG,IAAI,CAAS;IAC3C,QAAQ,CAAC,kBAAkB,EAAG,IAAI,CAAS;IAC3C,2FAA2F;IAC3F,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAE/B;;;;;OAKG;gBACS,MAAM,EAAE,MAAM,EAAE,MAAM,SAAK;IAKvC;;;OAGG;IAEI,IAAI,CAAC,OAAO,GAAE,eAAoB,GAAG,cAAc,CAAC,UAAU,CAAC;IAiJtE,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,iBAAiB;IAoCzB,OAAO,CAAC,4BAA4B;IAiDpC,OAAO,CAAC,yBAAyB;IAkDjC,OAAO,CAAC,QAAQ;CAgBjB"}
+{"version":3,"file":"b2.d.ts","sourceRoot":"","sources":["../../../src/sync/scanners/b2.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AA2B7C,OAAO,KAAK,EACV,UAAU,EAEV,UAAU,EACV,eAAe,EAEhB,MAAM,aAAa,CAAA;AAcpB;;;;;;;;;GASG;AACH,qBAAa,QAAS,YAAW,UAAU;IACzC,QAAQ,CAAC,IAAI,EAAG,IAAI,CAAS;IAC7B,QAAQ,CAAC,kBAAkB,EAAG,IAAI,CAAS;IAC3C,QAAQ,CAAC,kBAAkB,EAAG,IAAI,CAAS;IAC3C,2FAA2F;IAC3F,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAE/B;;;;;OAKG;gBACS,MAAM,EAAE,MAAM,EAAE,MAAM,SAAK;IAKvC;;;OAGG;IAEI,IAAI,CAAC,OAAO,GAAE,eAAoB,GAAG,cAAc,CAAC,UAAU,CAAC;IA4JtE,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,iBAAiB;IAoCzB,OAAO,CAAC,4BAA4B;IAiDpC,OAAO,CAAC,yBAAyB;IAkDjC,OAAO,CAAC,QAAQ;CAgBjB"}

package/dist/sync/scanners/b2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"b2.d.ts","sourceRoot":"","sources":["../../../src/sync/scanners/b2.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAsB7C,OAAO,KAAK,EACV,UAAU,EAEV,UAAU,EACV,eAAe,EAEhB,MAAM,aAAa,CAAA;AAcpB;;;;;;;;;GASG;AACH,qBAAa,QAAS,YAAW,UAAU;IACzC,QAAQ,CAAC,IAAI,EAAG,IAAI,CAAS;IAC7B,QAAQ,CAAC,kBAAkB,EAAG,IAAI,CAAS;IAC3C,QAAQ,CAAC,kBAAkB,EAAG,IAAI,CAAS;IAC3C,2FAA2F;IAC3F,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAE/B;;;;;OAKG;gBACS,MAAM,EAAE,MAAM,EAAE,MAAM,SAAK;IAKvC;;;OAGG;IAEI,IAAI,CAAC,OAAO,GAAE,eAAoB,GAAG,cAAc,CAAC,UAAU,CAAC;IAiJtE,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,iBAAiB;IAoCzB,OAAO,CAAC,4BAA4B;IAiDpC,OAAO,CAAC,yBAAyB;IAkDjC,OAAO,CAAC,QAAQ;CAgBjB"}
+{"version":3,"file":"b2.d.ts","sourceRoot":"","sources":["../../../src/sync/scanners/b2.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AA2B7C,OAAO,KAAK,EACV,UAAU,EAEV,UAAU,EACV,eAAe,EAEhB,MAAM,aAAa,CAAA;AAcpB;;;;;;;;;GASG;AACH,qBAAa,QAAS,YAAW,UAAU;IACzC,QAAQ,CAAC,IAAI,EAAG,IAAI,CAAS;IAC7B,QAAQ,CAAC,kBAAkB,EAAG,IAAI,CAAS;IAC3C,QAAQ,CAAC,kBAAkB,EAAG,IAAI,CAAS;IAC3C,2FAA2F;IAC3F,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAE/B;;;;;OAKG;gBACS,MAAM,EAAE,MAAM,EAAE,MAAM,SAAK;IAKvC;;;OAGG;IAEI,IAAI,CAAC,OAAO,GAAE,eAAoB,GAAG,cAAc,CAAC,UAAU,CAAC;IA4JtE,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,iBAAiB;IAoCzB,OAAO,CAAC,4BAA4B;IAiDpC,OAAO,CAAC,yBAAyB;IAkDjC,OAAO,CAAC,QAAQ;CAgBjB"}

package/dist/sync/scanners/b2.js

@@ -74,6 +74,8 @@ var B2Folder = class {
 				if (scanIsAborted(options)) return;
 				assertScanEntryLimit(listedVersions + 1, maxScanEntries);
 				listedVersions++;
+				const runtimeFile = fv;
+				if (runtimeFile.action === FileAction.Folder || typeof runtimeFile.fileId !== "string") throw emitScanError(options, "failed to scan B2 file versions", /* @__PURE__ */ new Error("B2 listFileVersions returned a delimiter folder row or row without a string fileId even though the scanner did not request delimiter grouping"));
 				if (this.rawPrefix !== "" && !fv.fileName.startsWith(this.rawPrefix)) {
 					this.emitSkip(options, fv.fileName, fv.fileName, "outside-prefix", `listed object is outside configured B2 prefix ${JSON.stringify(this.rawPrefix)}`);
 					continue;

package/dist/sync/scanners/b2.js.map

@@ -1 +1 @@
-{"version":3,"file":"b2.js","names":[],"sources":["../../../src/sync/scanners/b2.ts"],"sourcesContent":["import type { Bucket } from '../../bucket.ts'\nimport { FileAction, type FileVersion } from '../../types/file.ts'\nimport type { FileId } from '../../types/ids.ts'\nimport { isSignalAbortError } from '../../util/abort.ts'\nimport { sanitizeErrorReason } from '../../util/error-reason.ts'\nimport {\n  literalPrefixForSyncFilters,\n  pathPassesSyncFilters,\n  pathSkippedByRegExpInputLimit,\n} from '../filters.ts'\nimport { compareCodeUnits, compareSyncRelativePaths } from '../path-order.ts'\nimport { assertSyncPathAllowed } from '../paths.ts'\nimport {\n  asRawB2KeyPrefix,\n  b2KeyToRelativePathUnderPrefix,\n  localFilesystemCanonicalSyncPath,\n  localFilesystemSyncPathIsUnsafe,\n} from '../prefix.ts'\nimport { validateSyncFilters } from '../regexp-safety.ts'\nimport { emitScannerSkip, regexpInputTooLongSkip } from '../scan-events.ts'\nimport { assertScanEntryLimit, scanEntryLimit } from '../scan-limit.ts'\nimport { selectB2ComparableSha1, syncSha1StateOf } from '../sha1-metadata.ts'\nimport type {\n  B2SyncPath,\n  SyncErrorEvent,\n  SyncFolder,\n  SyncScanOptions,\n  SyncSkipReason,\n} from '../types.ts'\n\nconst MAX_EMPTY_B2_SCAN_PAGES = 100\n\ninterface B2ScanEntry {\n  relativePath: string\n  versions: FileVersion[]\n}\n\ninterface VisibleB2ScanEntry extends B2ScanEntry {\n  fileName: string\n  selectedVersion: FileVersion\n}\n\n/**\n * Scans a B2 bucket (optionally filtered by a raw B2 key prefix) and yields\n * {@link B2SyncPath} entries sorted by `compareSyncRelativePaths(relativePath)`. Hidden files are excluded.\n * Raw B2 file names are used only as an internal tie-breaker after collision handling.\n * All versions for the listed prefix are fetched, grouped, and sorted before\n * yielding; exclude filters are applied client-side and do not reduce that\n * B2 listing memory footprint.\n * SDK-reserved temporary names fail the scan because syncing them could corrupt\n * in-progress transfers.\n */\nexport class B2Folder implements SyncFolder {\n  readonly type = 'b2' as const\n  readonly appliesScanFilters = true as const\n  readonly appliesScanSorting = true as const\n  /** Raw B2 key prefix this folder scans, preserving caller-provided separators verbatim. */\n  readonly rawPrefix: string\n  private readonly bucket: Bucket\n\n  /**\n   * Creates a new B2Folder for the given bucket and optional prefix.\n   * @param bucket - The B2 bucket to scan.\n   * @param prefix - Optional raw B2 key prefix to restrict the scan scope.\n   * Backslashes are preserved as raw B2 key characters; pass `/` explicitly for slash prefixes.\n   */\n  constructor(bucket: Bucket, prefix = '') {\n    this.bucket = bucket\n    this.rawPrefix = asRawB2KeyPrefix(prefix)\n  }\n\n  /**\n   * Lists all file versions in the bucket, groups by name, and yields the latest visible version.\n   * @param options - Optional scan controls.\n   */\n  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: pagination, grouping, and filtering stay in one async iterator.\n  async *scan(options: SyncScanOptions = {}): AsyncGenerator<B2SyncPath> {\n    validateSyncFilters(options)\n    const maxScanEntries = scanEntryLimit(options)\n    const grouped = new Map<string, B2ScanEntry>()\n    const listPrefix = this.listPrefixFor(options)\n\n    let listedVersions = 0\n    let startFileName: string | undefined\n    let startFileId: FileId | undefined\n    let emptyPageCount = 0\n\n    while (true) {\n      if (scanIsAborted(options)) return\n\n      let listing: Awaited<ReturnType<Bucket['listFileVersions']>>\n      try {\n        listing = await this.bucket.listFileVersions({\n          ...(listPrefix !== '' ? { prefix: listPrefix } : {}),\n          ...(startFileName !== undefined ? { startFileName } : {}),\n          ...(startFileId !== undefined ? { startFileId } : {}),\n          ...(options.signal !== undefined ? { signal: options.signal } : {}),\n        })\n      } catch (err) {\n        if (isSignalAbortError(options.signal, err)) return\n        throw emitScanError(options, 'failed to scan B2 file versions', err)\n      }\n      if (scanIsAborted(options)) return\n\n      if (listing.files.length === 0) {\n        emptyPageCount++\n        if (emptyPageCount > MAX_EMPTY_B2_SCAN_PAGES) {\n          throw emitScanError(\n            options,\n            'failed to scan B2 file versions',\n            new Error('B2 pagination returned too many empty pages'),\n          )\n        }\n      } else {\n        emptyPageCount = 0\n      }\n\n      for (const fv of listing.files) {\n        if (scanIsAborted(options)) return\n        assertScanEntryLimit(listedVersions + 1, maxScanEntries)\n        listedVersions++\n\n        // Real B2 honors the prefix in listFileVersions, but custom\n        // transports and the simulator can over-return. Guard before\n        // stripping the raw prefix so relativePath is never corrupted.\n        if (this.rawPrefix !== '' && !fv.fileName.startsWith(this.rawPrefix)) {\n          this.emitSkip(\n            options,\n            fv.fileName,\n            fv.fileName,\n            'outside-prefix',\n            `listed object is outside configured B2 prefix ${JSON.stringify(this.rawPrefix)}`,\n          )\n          continue\n        }\n\n        if (options.requireLocalSafePaths === true && fv.fileName.includes('\\\\')) {\n          this.emitSkip(\n            options,\n            fv.fileName,\n            fv.fileName,\n            'local-unsafe-name',\n            'object name contains a backslash that is unsafe for local filesystem destinations',\n          )\n          continue\n        }\n\n        const relativePath = this.tryToRelativePath(fv.fileName)\n        if (relativePath === null) {\n          this.emitSkip(\n            options,\n            fv.fileName,\n            fv.fileName,\n            'unsafe-name',\n            'object name cannot be represented as a safe sync relative path',\n          )\n          continue\n        }\n\n        if (!pathPassesSyncFilters(relativePath, options)) {\n          if (pathSkippedByRegExpInputLimit(relativePath, options)) {\n            emitScannerSkip(options, {\n              ...regexpInputTooLongSkip(relativePath),\n              b2FileName: fv.fileName,\n            })\n          }\n          continue\n        }\n\n        const existing = grouped.get(fv.fileName)\n        if (existing) {\n          existing.versions.push(fv)\n        } else {\n          grouped.set(fv.fileName, { relativePath, versions: [fv] })\n        }\n      }\n\n      if (!listing.nextFileName) break\n      if (\n        listing.nextFileName === startFileName &&\n        (listing.nextFileId ?? undefined) === startFileId\n      ) {\n        throw emitScanError(\n          options,\n          'failed to scan B2 file versions',\n          new Error('B2 pagination did not advance'),\n        )\n      }\n      startFileName = listing.nextFileName\n      startFileId = listing.nextFileId ?? undefined\n    }\n\n    const visible = this.visibleCandidates(grouped, options)\n    const withoutRelativeCollisions = this.rejectRelativePathCollisions(visible, options)\n    const safeCandidates =\n      options.requireLocalSafePaths === true\n        ? this.rejectLocalPathCollisions(withoutRelativeCollisions, options)\n        : withoutRelativeCollisions\n    const sorted = safeCandidates.sort(\n      (a, b) =>\n        compareSyncRelativePaths(a.relativePath, b.relativePath) ||\n        compareCodeUnits(a.fileName, b.fileName),\n    )\n\n    for (const { relativePath, versions, selectedVersion } of sorted) {\n      if (scanIsAborted(options)) return\n      // Reserved SDK temp names are a hard safety failure, not an ordinary filter.\n      assertSyncPathAllowed(relativePath)\n      const contentSha1 = selectB2ComparableSha1(selectedVersion)\n      yield {\n        relativePath,\n        modTimeMillis: selectedVersion.uploadTimestamp,\n        size: selectedVersion.contentLength,\n        contentSha1,\n        contentSha1State: syncSha1StateOf({ contentSha1 }),\n        selectedVersion,\n        allVersions: versions,\n      }\n    }\n  }\n\n  private tryToRelativePath(fileName: string): string | null {\n    try {\n      return b2KeyToRelativePathUnderPrefix(this.rawPrefix, fileName)\n    } catch {\n      return null\n    }\n  }\n\n  private listPrefixFor(filters: SyncScanOptions | undefined): string {\n    const filterPrefix = literalPrefixForSyncFilters(filters)\n    if (filterPrefix === '') return this.rawPrefix\n    if (this.rawPrefix !== '' && !this.rawPrefix.endsWith('/')) return this.rawPrefix\n    return `${this.rawPrefix}${rawPrefixBeforeNormalizedSeparator(filterPrefix)}`\n  }\n\n  private visibleCandidates(\n    grouped: Map<string, B2ScanEntry>,\n    filters: SyncScanOptions | undefined,\n  ): VisibleB2ScanEntry[] {\n    const visible: VisibleB2ScanEntry[] = []\n\n    for (const [fileName, entry] of grouped) {\n      entry.versions.sort((a, b) => b.uploadTimestamp - a.uploadTimestamp)\n      const selected = entry.versions[0]\n      if (!selected || selected.action === FileAction.Hide) continue\n\n      if (\n        filters?.requireLocalSafePaths === true &&\n        localFilesystemSyncPathIsUnsafe(entry.relativePath)\n      ) {\n        this.emitSkip(\n          filters,\n          entry.relativePath,\n          fileName,\n          'local-unsafe-name',\n          'object name is unsafe for a local filesystem destination',\n        )\n        continue\n      }\n\n      visible.push({\n        fileName,\n        relativePath: entry.relativePath,\n        versions: entry.versions,\n        selectedVersion: selected,\n      })\n    }\n\n    return visible\n  }\n\n  private rejectRelativePathCollisions(\n    candidates: VisibleB2ScanEntry[],\n    filters: SyncScanOptions | undefined,\n  ): VisibleB2ScanEntry[] {\n    const accepted: VisibleB2ScanEntry[] = []\n    const owners = new Map<string, VisibleB2ScanEntry>()\n    const collidedRelativePaths = new Set<string>()\n\n    for (const candidate of candidates) {\n      if (collidedRelativePaths.has(candidate.relativePath)) {\n        this.emitSkip(\n          filters,\n          candidate.relativePath,\n          candidate.fileName,\n          'relative-path-collision',\n          'object normalizes to a relative path already rejected because of another raw B2 key',\n        )\n        continue\n      }\n\n      const owner = owners.get(candidate.relativePath)\n      if (owner !== undefined && owner.fileName !== candidate.fileName) {\n        owners.delete(candidate.relativePath)\n        removeAcceptedCandidate(accepted, owner)\n        collidedRelativePaths.add(candidate.relativePath)\n        this.emitSkip(\n          filters,\n          candidate.relativePath,\n          owner.fileName,\n          'relative-path-collision',\n          `object normalizes to the same relative path as ${JSON.stringify(candidate.fileName)}`,\n        )\n        this.emitSkip(\n          filters,\n          candidate.relativePath,\n          candidate.fileName,\n          'relative-path-collision',\n          `object normalizes to the same relative path as ${JSON.stringify(owner.fileName)}`,\n        )\n        continue\n      }\n\n      owners.set(candidate.relativePath, candidate)\n      accepted.push(candidate)\n    }\n\n    return accepted\n  }\n\n  private rejectLocalPathCollisions(\n    candidates: VisibleB2ScanEntry[],\n    filters: SyncScanOptions | undefined,\n  ): VisibleB2ScanEntry[] {\n    const accepted: VisibleB2ScanEntry[] = []\n    const owners = new Map<string, VisibleB2ScanEntry>()\n    const collidedLocalPaths = new Set<string>()\n\n    for (const candidate of candidates) {\n      const canonicalPath = localFilesystemCanonicalSyncPath(candidate.relativePath)\n      if (collidedLocalPaths.has(canonicalPath)) {\n        this.emitSkip(\n          filters,\n          candidate.relativePath,\n          candidate.fileName,\n          'local-path-collision',\n          'object collides with another object on case-insensitive or Unicode-normalizing filesystems',\n        )\n        continue\n      }\n\n      const owner = owners.get(canonicalPath)\n      if (owner !== undefined) {\n        owners.delete(canonicalPath)\n        removeAcceptedCandidate(accepted, owner)\n        collidedLocalPaths.add(canonicalPath)\n        this.emitSkip(\n          filters,\n          owner.relativePath,\n          owner.fileName,\n          'local-path-collision',\n          `object collides with ${JSON.stringify(candidate.fileName)} on local filesystems`,\n        )\n        this.emitSkip(\n          filters,\n          candidate.relativePath,\n          candidate.fileName,\n          'local-path-collision',\n          `object collides with ${JSON.stringify(owner.fileName)} on local filesystems`,\n        )\n        continue\n      }\n\n      owners.set(canonicalPath, candidate)\n      accepted.push(candidate)\n    }\n\n    return accepted\n  }\n\n  private emitSkip(\n    filters: SyncScanOptions | undefined,\n    path: string,\n    b2FileName: string,\n    reason: SyncSkipReason,\n    message: string,\n  ): void {\n    emitScannerSkip(filters, {\n      type: 'skip',\n      path,\n      size: 0,\n      message: `Skipped B2 object ${JSON.stringify(b2FileName)}: ${message}`,\n      reason,\n      b2FileName,\n    })\n  }\n}\n\nfunction rawPrefixBeforeNormalizedSeparator(filterPrefix: string): string {\n  const separatorIndex = filterPrefix.indexOf('/')\n  return separatorIndex === -1 ? filterPrefix : filterPrefix.slice(0, separatorIndex)\n}\n\nfunction emitScanError(options: SyncScanOptions, message: string, err: unknown): Error {\n  const event: SyncErrorEvent = {\n    type: 'error',\n    path: '',\n    size: 0,\n    message: `${message}: ${sanitizeErrorReason(err)}`,\n  }\n  options.onError?.(event)\n  return new Error(event.message)\n}\n\nfunction removeAcceptedCandidate(\n  candidates: VisibleB2ScanEntry[],\n  target: VisibleB2ScanEntry,\n): void {\n  const index = candidates.indexOf(target)\n  if (index !== -1) candidates.splice(index, 1)\n}\n\nfunction scanIsAborted(filters: SyncScanOptions | undefined): boolean {\n  return filters?.signal?.aborted === true\n}\n"],"mappings":"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"}
+{"version":3,"file":"b2.js","names":[],"sources":["../../../src/sync/scanners/b2.ts"],"sourcesContent":["import type { Bucket } from '../../bucket.ts'\nimport {\n  FileAction,\n  type FileVersion,\n  type ListedConcreteFileVersion,\n  type ListFileVersionsResponse,\n} from '../../types/file.ts'\nimport type { FileId } from '../../types/ids.ts'\nimport { isSignalAbortError } from '../../util/abort.ts'\nimport { sanitizeErrorReason } from '../../util/error-reason.ts'\nimport {\n  literalPrefixForSyncFilters,\n  pathPassesSyncFilters,\n  pathSkippedByRegExpInputLimit,\n} from '../filters.ts'\nimport { compareCodeUnits, compareSyncRelativePaths } from '../path-order.ts'\nimport { assertSyncPathAllowed } from '../paths.ts'\nimport {\n  asRawB2KeyPrefix,\n  b2KeyToRelativePathUnderPrefix,\n  localFilesystemCanonicalSyncPath,\n  localFilesystemSyncPathIsUnsafe,\n} from '../prefix.ts'\nimport { validateSyncFilters } from '../regexp-safety.ts'\nimport { emitScannerSkip, regexpInputTooLongSkip } from '../scan-events.ts'\nimport { assertScanEntryLimit, scanEntryLimit } from '../scan-limit.ts'\nimport { selectB2ComparableSha1, syncSha1StateOf } from '../sha1-metadata.ts'\nimport type {\n  B2SyncPath,\n  SyncErrorEvent,\n  SyncFolder,\n  SyncScanOptions,\n  SyncSkipReason,\n} from '../types.ts'\n\nconst MAX_EMPTY_B2_SCAN_PAGES = 100\n\ninterface B2ScanEntry {\n  relativePath: string\n  versions: ListedConcreteFileVersion[]\n}\n\ninterface VisibleB2ScanEntry extends B2ScanEntry {\n  fileName: string\n  selectedVersion: FileVersion\n}\n\n/**\n * Scans a B2 bucket (optionally filtered by a raw B2 key prefix) and yields\n * {@link B2SyncPath} entries sorted by `compareSyncRelativePaths(relativePath)`. Hidden files are excluded.\n * Raw B2 file names are used only as an internal tie-breaker after collision handling.\n * All versions for the listed prefix are fetched, grouped, and sorted before\n * yielding; exclude filters are applied client-side and do not reduce that\n * B2 listing memory footprint.\n * SDK-reserved temporary names fail the scan because syncing them could corrupt\n * in-progress transfers.\n */\nexport class B2Folder implements SyncFolder {\n  readonly type = 'b2' as const\n  readonly appliesScanFilters = true as const\n  readonly appliesScanSorting = true as const\n  /** Raw B2 key prefix this folder scans, preserving caller-provided separators verbatim. */\n  readonly rawPrefix: string\n  private readonly bucket: Bucket\n\n  /**\n   * Creates a new B2Folder for the given bucket and optional prefix.\n   * @param bucket - The B2 bucket to scan.\n   * @param prefix - Optional raw B2 key prefix to restrict the scan scope.\n   * Backslashes are preserved as raw B2 key characters; pass `/` explicitly for slash prefixes.\n   */\n  constructor(bucket: Bucket, prefix = '') {\n    this.bucket = bucket\n    this.rawPrefix = asRawB2KeyPrefix(prefix)\n  }\n\n  /**\n   * Lists all file versions in the bucket, groups by name, and yields the latest visible version.\n   * @param options - Optional scan controls.\n   */\n  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: pagination, grouping, and filtering stay in one async iterator.\n  async *scan(options: SyncScanOptions = {}): AsyncGenerator<B2SyncPath> {\n    validateSyncFilters(options)\n    const maxScanEntries = scanEntryLimit(options)\n    const grouped = new Map<string, B2ScanEntry>()\n    const listPrefix = this.listPrefixFor(options)\n\n    let listedVersions = 0\n    let startFileName: string | undefined\n    let startFileId: FileId | undefined\n    let emptyPageCount = 0\n\n    while (true) {\n      if (scanIsAborted(options)) return\n\n      let listing: ListFileVersionsResponse\n      try {\n        listing = await this.bucket.listFileVersions({\n          ...(listPrefix !== '' ? { prefix: listPrefix } : {}),\n          ...(startFileName !== undefined ? { startFileName } : {}),\n          ...(startFileId !== undefined ? { startFileId } : {}),\n          ...(options.signal !== undefined ? { signal: options.signal } : {}),\n        })\n      } catch (err) {\n        if (isSignalAbortError(options.signal, err)) return\n        throw emitScanError(options, 'failed to scan B2 file versions', err)\n      }\n      if (scanIsAborted(options)) return\n\n      if (listing.files.length === 0) {\n        emptyPageCount++\n        if (emptyPageCount > MAX_EMPTY_B2_SCAN_PAGES) {\n          throw emitScanError(\n            options,\n            'failed to scan B2 file versions',\n            new Error('B2 pagination returned too many empty pages'),\n          )\n        }\n      } else {\n        emptyPageCount = 0\n      }\n\n      for (const fv of listing.files) {\n        if (scanIsAborted(options)) return\n        assertScanEntryLimit(listedVersions + 1, maxScanEntries)\n        listedVersions++\n\n        const runtimeFile = fv as { readonly action?: unknown; readonly fileId?: unknown }\n        if (runtimeFile.action === FileAction.Folder || typeof runtimeFile.fileId !== 'string') {\n          throw emitScanError(\n            options,\n            'failed to scan B2 file versions',\n            new Error(\n              'B2 listFileVersions returned a delimiter folder row or row without a string fileId even though the scanner did not request delimiter grouping',\n            ),\n          )\n        }\n\n        // Real B2 honors the prefix in listFileVersions, but custom\n        // transports and the simulator can over-return. Guard before\n        // stripping the raw prefix so relativePath is never corrupted.\n        if (this.rawPrefix !== '' && !fv.fileName.startsWith(this.rawPrefix)) {\n          this.emitSkip(\n            options,\n            fv.fileName,\n            fv.fileName,\n            'outside-prefix',\n            `listed object is outside configured B2 prefix ${JSON.stringify(this.rawPrefix)}`,\n          )\n          continue\n        }\n\n        if (options.requireLocalSafePaths === true && fv.fileName.includes('\\\\')) {\n          this.emitSkip(\n            options,\n            fv.fileName,\n            fv.fileName,\n            'local-unsafe-name',\n            'object name contains a backslash that is unsafe for local filesystem destinations',\n          )\n          continue\n        }\n\n        const relativePath = this.tryToRelativePath(fv.fileName)\n        if (relativePath === null) {\n          this.emitSkip(\n            options,\n            fv.fileName,\n            fv.fileName,\n            'unsafe-name',\n            'object name cannot be represented as a safe sync relative path',\n          )\n          continue\n        }\n\n        if (!pathPassesSyncFilters(relativePath, options)) {\n          if (pathSkippedByRegExpInputLimit(relativePath, options)) {\n            emitScannerSkip(options, {\n              ...regexpInputTooLongSkip(relativePath),\n              b2FileName: fv.fileName,\n            })\n          }\n          continue\n        }\n\n        const existing = grouped.get(fv.fileName)\n        if (existing) {\n          existing.versions.push(fv)\n        } else {\n          grouped.set(fv.fileName, { relativePath, versions: [fv] })\n        }\n      }\n\n      if (!listing.nextFileName) break\n      if (\n        listing.nextFileName === startFileName &&\n        (listing.nextFileId ?? undefined) === startFileId\n      ) {\n        throw emitScanError(\n          options,\n          'failed to scan B2 file versions',\n          new Error('B2 pagination did not advance'),\n        )\n      }\n      startFileName = listing.nextFileName\n      startFileId = listing.nextFileId ?? undefined\n    }\n\n    const visible = this.visibleCandidates(grouped, options)\n    const withoutRelativeCollisions = this.rejectRelativePathCollisions(visible, options)\n    const safeCandidates =\n      options.requireLocalSafePaths === true\n        ? this.rejectLocalPathCollisions(withoutRelativeCollisions, options)\n        : withoutRelativeCollisions\n    const sorted = safeCandidates.sort(\n      (a, b) =>\n        compareSyncRelativePaths(a.relativePath, b.relativePath) ||\n        compareCodeUnits(a.fileName, b.fileName),\n    )\n\n    for (const { relativePath, versions, selectedVersion } of sorted) {\n      if (scanIsAborted(options)) return\n      // Reserved SDK temp names are a hard safety failure, not an ordinary filter.\n      assertSyncPathAllowed(relativePath)\n      const contentSha1 = selectB2ComparableSha1(selectedVersion)\n      yield {\n        relativePath,\n        modTimeMillis: selectedVersion.uploadTimestamp,\n        size: selectedVersion.contentLength,\n        contentSha1,\n        contentSha1State: syncSha1StateOf({ contentSha1 }),\n        selectedVersion,\n        allVersions: versions,\n      }\n    }\n  }\n\n  private tryToRelativePath(fileName: string): string | null {\n    try {\n      return b2KeyToRelativePathUnderPrefix(this.rawPrefix, fileName)\n    } catch {\n      return null\n    }\n  }\n\n  private listPrefixFor(filters: SyncScanOptions | undefined): string {\n    const filterPrefix = literalPrefixForSyncFilters(filters)\n    if (filterPrefix === '') return this.rawPrefix\n    if (this.rawPrefix !== '' && !this.rawPrefix.endsWith('/')) return this.rawPrefix\n    return `${this.rawPrefix}${rawPrefixBeforeNormalizedSeparator(filterPrefix)}`\n  }\n\n  private visibleCandidates(\n    grouped: Map<string, B2ScanEntry>,\n    filters: SyncScanOptions | undefined,\n  ): VisibleB2ScanEntry[] {\n    const visible: VisibleB2ScanEntry[] = []\n\n    for (const [fileName, entry] of grouped) {\n      entry.versions.sort((a, b) => b.uploadTimestamp - a.uploadTimestamp)\n      const selected = entry.versions[0]\n      if (!selected || selected.action === FileAction.Hide) continue\n\n      if (\n        filters?.requireLocalSafePaths === true &&\n        localFilesystemSyncPathIsUnsafe(entry.relativePath)\n      ) {\n        this.emitSkip(\n          filters,\n          entry.relativePath,\n          fileName,\n          'local-unsafe-name',\n          'object name is unsafe for a local filesystem destination',\n        )\n        continue\n      }\n\n      visible.push({\n        fileName,\n        relativePath: entry.relativePath,\n        versions: entry.versions,\n        selectedVersion: selected,\n      })\n    }\n\n    return visible\n  }\n\n  private rejectRelativePathCollisions(\n    candidates: VisibleB2ScanEntry[],\n    filters: SyncScanOptions | undefined,\n  ): VisibleB2ScanEntry[] {\n    const accepted: VisibleB2ScanEntry[] = []\n    const owners = new Map<string, VisibleB2ScanEntry>()\n    const collidedRelativePaths = new Set<string>()\n\n    for (const candidate of candidates) {\n      if (collidedRelativePaths.has(candidate.relativePath)) {\n        this.emitSkip(\n          filters,\n          candidate.relativePath,\n          candidate.fileName,\n          'relative-path-collision',\n          'object normalizes to a relative path already rejected because of another raw B2 key',\n        )\n        continue\n      }\n\n      const owner = owners.get(candidate.relativePath)\n      if (owner !== undefined && owner.fileName !== candidate.fileName) {\n        owners.delete(candidate.relativePath)\n        removeAcceptedCandidate(accepted, owner)\n        collidedRelativePaths.add(candidate.relativePath)\n        this.emitSkip(\n          filters,\n          candidate.relativePath,\n          owner.fileName,\n          'relative-path-collision',\n          `object normalizes to the same relative path as ${JSON.stringify(candidate.fileName)}`,\n        )\n        this.emitSkip(\n          filters,\n          candidate.relativePath,\n          candidate.fileName,\n          'relative-path-collision',\n          `object normalizes to the same relative path as ${JSON.stringify(owner.fileName)}`,\n        )\n        continue\n      }\n\n      owners.set(candidate.relativePath, candidate)\n      accepted.push(candidate)\n    }\n\n    return accepted\n  }\n\n  private rejectLocalPathCollisions(\n    candidates: VisibleB2ScanEntry[],\n    filters: SyncScanOptions | undefined,\n  ): VisibleB2ScanEntry[] {\n    const accepted: VisibleB2ScanEntry[] = []\n    const owners = new Map<string, VisibleB2ScanEntry>()\n    const collidedLocalPaths = new Set<string>()\n\n    for (const candidate of candidates) {\n      const canonicalPath = localFilesystemCanonicalSyncPath(candidate.relativePath)\n      if (collidedLocalPaths.has(canonicalPath)) {\n        this.emitSkip(\n          filters,\n          candidate.relativePath,\n          candidate.fileName,\n          'local-path-collision',\n          'object collides with another object on case-insensitive or Unicode-normalizing filesystems',\n        )\n        continue\n      }\n\n      const owner = owners.get(canonicalPath)\n      if (owner !== undefined) {\n        owners.delete(canonicalPath)\n        removeAcceptedCandidate(accepted, owner)\n        collidedLocalPaths.add(canonicalPath)\n        this.emitSkip(\n          filters,\n          owner.relativePath,\n          owner.fileName,\n          'local-path-collision',\n          `object collides with ${JSON.stringify(candidate.fileName)} on local filesystems`,\n        )\n        this.emitSkip(\n          filters,\n          candidate.relativePath,\n          candidate.fileName,\n          'local-path-collision',\n          `object collides with ${JSON.stringify(owner.fileName)} on local filesystems`,\n        )\n        continue\n      }\n\n      owners.set(canonicalPath, candidate)\n      accepted.push(candidate)\n    }\n\n    return accepted\n  }\n\n  private emitSkip(\n    filters: SyncScanOptions | undefined,\n    path: string,\n    b2FileName: string,\n    reason: SyncSkipReason,\n    message: string,\n  ): void {\n    emitScannerSkip(filters, {\n      type: 'skip',\n      path,\n      size: 0,\n      message: `Skipped B2 object ${JSON.stringify(b2FileName)}: ${message}`,\n      reason,\n      b2FileName,\n    })\n  }\n}\n\nfunction rawPrefixBeforeNormalizedSeparator(filterPrefix: string): string {\n  const separatorIndex = filterPrefix.indexOf('/')\n  return separatorIndex === -1 ? filterPrefix : filterPrefix.slice(0, separatorIndex)\n}\n\nfunction emitScanError(options: SyncScanOptions, message: string, err: unknown): Error {\n  const event: SyncErrorEvent = {\n    type: 'error',\n    path: '',\n    size: 0,\n    message: `${message}: ${sanitizeErrorReason(err)}`,\n  }\n  options.onError?.(event)\n  return new Error(event.message)\n}\n\nfunction removeAcceptedCandidate(\n  candidates: VisibleB2ScanEntry[],\n  target: VisibleB2ScanEntry,\n): void {\n  const index = candidates.indexOf(target)\n  if (index !== -1) candidates.splice(index, 1)\n}\n\nfunction scanIsAborted(filters: SyncScanOptions | undefined): boolean {\n  return filters?.signal?.aborted === true\n}\n"],"mappings":"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"}

package/dist/sync/scanners/local.cjs

@@ -4,9 +4,9 @@ const require_filters = require("../filters.cjs");
 const require_path_order = require("../path-order.cjs");
 const require_scan_limit = require("../scan-limit.cjs");
 const require_local_file_identity = require("../local-file-identity.cjs");
+const require_filesystem_errors = require("../filesystem-errors.cjs");
 const require_path_safety = require("../path-safety.cjs");
 const require_download_staging = require("../download-staging.cjs");
-const require_filesystem_errors = require("../filesystem-errors.cjs");
 const require_local_filesystem_root = require("../local-filesystem-root.cjs");
 //#region src/sync/scanners/local.ts
 /**
@@ -40,8 +40,17 @@ var LocalFolder = class {
 		require_regexp_safety.validateSyncFilters(options);
 		const nodeDeps = await loadLocalNodeDeps();
 		const root = nodeDeps.resolve(this.root);
+		const followSymlinks = options.localSymlinks === "follow" && options.requireLocalSafePaths !== true;
+		let scanRoot = root;
 		const collected = [];
-		await this.walk(root, root, collected, options, require_scan_limit.scanEntryLimit(options), nodeDeps);
+		const activeDirectoryIds = /* @__PURE__ */ new Set();
+		const followedDirectoryIds = /* @__PURE__ */ new Set();
+		if (followSymlinks) try {
+			scanRoot = await nodeDeps.realpath(root);
+			const rootStats = await nodeDeps.stat(scanRoot);
+			if (rootStats.isDirectory()) activeDirectoryIds.add(localNodeIdentity(rootStats));
+		} catch {}
+		await this.walk(scanRoot, scanRoot, "", collected, options, require_scan_limit.scanEntryLimit(options), nodeDeps, activeDirectoryIds, followedDirectoryIds);
 		collected.sort((a, b) => require_path_order.compareSyncRelativePaths(a.relativePath, b.relativePath));
 		for (const entry of collected) {
 			throwIfScanAborted(options);
@@ -52,25 +61,28 @@ var LocalFolder = class {
 	* Recursively collects files from {@link dir} into {@link out}.
 	* @param root - Resolved scan root used for relative path calculation.
 	* @param dir - Absolute path of the directory to scan.
+	* @param dirRel - Sync-relative path represented by {@link dir}.
 	* @param out - Accumulator array that receives discovered file entries.
 	* @param options - Optional scan controls.
 	* @param maxScanEntries - Maximum number of entries to retain before failing.
 	* @param nodeDeps - Lazy-loaded Node filesystem and path helpers.
+	* @param activeDirectoryIds - Directory identities in the current recursion stack.
+	* @param followedDirectoryIds - Followed symlink directory identities already traversed.
 	*/
-	async walk(root, dir, out, options, maxScanEntries, nodeDeps) {
+	async walk(root, dir, dirRel, out, options, maxScanEntries, nodeDeps, activeDirectoryIds, followedDirectoryIds) {
 		throwIfScanAborted(options);
 		let entries;
 		try {
 			entries = await nodeDeps.readdir(dir, { withFileTypes: true });
 		} catch (err) {
-			const error = this.emitScanError(options, relativePathFromRoot(root, dir, nodeDeps), "directory", err);
+			const error = this.emitScanError(options, dirRel, "directory", err);
 			if (dir === root) throw error;
 			return;
 		}
 		for (const entry of entries) {
 			throwIfScanAborted(options);
 			const fullPath = nodeDeps.join(dir, entry.name);
-			const rel = relativePathFromRoot(root, fullPath, nodeDeps);
+			const rel = joinSyncRelativePath(dirRel, entry.name);
 			if (require_download_staging.isDownloadStagingDirectorySegment(rel) && entry.isDirectory() && require_download_staging.isDownloadStagingDirectorySegment(entry.name) && await require_download_staging.isManagedDownloadStagingRoot(fullPath)) continue;
 			if (rel.includes("\\")) {
 				require_scan_events.emitScannerSkip(options, {
@@ -93,35 +105,130 @@ var LocalFolder = class {
 				continue;
 			}
 			if (entry.isDirectory()) {
-				if (require_filters.directoryMayContainSyncPaths(rel, options)) await this.walk(root, fullPath, out, options, maxScanEntries, nodeDeps);
-			} else if (entry.isFile()) {
-				if (!require_filters.pathPassesSyncFilters(rel, options)) {
-					if (require_filters.pathSkippedByRegExpInputLimit(rel, options)) require_scan_events.emitScannerSkip(options, require_scan_events.regexpInputTooLongSkip(rel));
-					continue;
-				}
-				let s;
-				try {
-					s = await nodeDeps.lstat(fullPath);
-					/* v8 ignore start -- lstat race after a Dirent file result is not deterministic */
-					if (!s.isFile()) {
-						this.emitScanError(options, rel, "file", /* @__PURE__ */ new Error("not a regular file"));
-						continue;
-					}
-				} catch (err) {
-					/* v8 ignore next -- stat TOCTOU failures are not deterministic to trigger */
-					this.emitScanError(options, relativePathFromRoot(root, fullPath, nodeDeps), "file", err);
-					continue;
+				if (require_filters.directoryMayContainSyncPaths(rel, options)) await this.walkDirectory(root, fullPath, rel, out, options, maxScanEntries, nodeDeps, activeDirectoryIds, followedDirectoryIds);
+			} else if (entry.isFile()) await this.collectFile(fullPath, rel, out, options, maxScanEntries, nodeDeps);
+			else if (entry.isSymbolicLink()) await this.handleSymlink(root, fullPath, rel, out, options, maxScanEntries, nodeDeps, activeDirectoryIds, followedDirectoryIds);
+		}
+	}
+	async walkDirectory(root, dir, rel, out, options, maxScanEntries, nodeDeps, activeDirectoryIds, followedDirectoryIds, knownStats) {
+		let stats = knownStats;
+		if (stats === void 0) try {
+			stats = await nodeDeps.stat(dir);
+		} catch (err) {
+			/* v8 ignore start -- stat TOCTOU failures after a Dirent directory result are not deterministic */
+			this.emitScanError(options, rel, "directory", err);
+			return;
+		}
+		/* v8 ignore start -- stat TOCTOU races after a Dirent directory result are not deterministic */
+		if (!stats.isDirectory()) {
+			this.emitScanError(options, rel, "directory", /* @__PURE__ */ new Error("not a directory"));
+			return;
+		}
+		/* v8 ignore stop */
+		const identity = localNodeIdentity(stats);
+		if (activeDirectoryIds.has(identity)) {
+			require_scan_events.emitScannerSkip(options, {
+				type: "skip",
+				path: rel,
+				size: 0,
+				reason: "local-symlink-loop",
+				message: `Skipped local path ${JSON.stringify(rel)}: symlink would revisit an ancestor directory`
+			});
+			return;
+		}
+		activeDirectoryIds.add(identity);
+		try {
+			await this.walk(root, dir, rel, out, options, maxScanEntries, nodeDeps, activeDirectoryIds, followedDirectoryIds);
+		} finally {
+			activeDirectoryIds.delete(identity);
+		}
+	}
+	async collectFile(fullPath, rel, out, options, maxScanEntries, nodeDeps, knownStats) {
+		if (!require_filters.pathPassesSyncFilters(rel, options)) {
+			if (require_filters.pathSkippedByRegExpInputLimit(rel, options)) require_scan_events.emitScannerSkip(options, require_scan_events.regexpInputTooLongSkip(rel));
+			return;
+		}
+		let s = knownStats;
+		if (s === void 0) try {
+			s = await nodeDeps.lstat(fullPath);
+			/* v8 ignore start -- lstat race after a Dirent file result is not deterministic */
+			if (!s.isFile()) {
+				this.emitScanError(options, rel, "file", /* @__PURE__ */ new Error("not a regular file"));
+				return;
+			}
+		} catch (err) {
+			/* v8 ignore start -- stat TOCTOU failures are not deterministic to trigger */
+			this.emitScanError(options, rel, "file", err);
+			return;
+		}
+		require_scan_limit.assertScanEntryLimit(out.length + 1, maxScanEntries);
+		out.push({
+			relativePath: rel,
+			absolutePath: fullPath,
+			modTimeMillis: Math.floor(s.mtimeMs),
+			size: s.size,
+			fileIdentity: require_local_file_identity.localFileIdentityFromStats(s)
+		});
+	}
+	async handleSymlink(root, fullPath, rel, out, options, maxScanEntries, nodeDeps, activeDirectoryIds, followedDirectoryIds) {
+		if ((options.localSymlinks ?? "skip") === "skip" || options.requireLocalSafePaths === true) {
+			require_scan_events.emitScannerSkip(options, {
+				type: "skip",
+				path: rel,
+				size: 0,
+				reason: "local-symlink",
+				message: `Skipped local path ${JSON.stringify(rel)}: local symlinks are disabled`
+			});
+			return;
+		}
+		let targetPath;
+		let targetStats;
+		try {
+			targetPath = await nodeDeps.realpath(fullPath);
+			targetStats = await nodeDeps.stat(targetPath);
+		} catch (err) {
+			this.emitScanError(options, rel, "symlink", err);
+			return;
+		}
+		if (!isPathInsideRoot(root, targetPath, nodeDeps)) {
+			require_scan_events.emitScannerSkip(options, {
+				type: "skip",
+				path: rel,
+				size: 0,
+				reason: "local-symlink",
+				message: `Skipped local path ${JSON.stringify(rel)}: symlink target is outside the sync root`
+			});
+			return;
+		}
+		if (targetStats.isDirectory()) {
+			if (require_filters.directoryMayContainSyncPaths(rel, options)) {
+				const identity = localNodeIdentity(targetStats);
+				if (followedDirectoryIds.has(identity)) {
+					require_scan_events.emitScannerSkip(options, {
+						type: "skip",
+						path: rel,
+						size: 0,
+						reason: "local-symlink-loop",
+						message: `Skipped local path ${JSON.stringify(rel)}: symlink target was already visited`
+					});
+					return;
 				}
-				require_scan_limit.assertScanEntryLimit(out.length + 1, maxScanEntries);
-				out.push({
-					relativePath: rel,
-					absolutePath: fullPath,
-					modTimeMillis: Math.floor(s.mtimeMs),
-					size: s.size,
-					fileIdentity: require_local_file_identity.localFileIdentityFromStats(s)
-				});
+				followedDirectoryIds.add(identity);
+				await this.walkDirectory(root, targetPath, rel, out, options, maxScanEntries, nodeDeps, activeDirectoryIds, followedDirectoryIds, targetStats);
 			}
+			return;
 		}
+		if (targetStats.isFile()) {
+			await this.collectFile(targetPath, rel, out, options, maxScanEntries, nodeDeps, targetStats);
+			return;
+		}
+		require_scan_events.emitScannerSkip(options, {
+			type: "skip",
+			path: rel,
+			size: 0,
+			reason: "local-symlink",
+			message: `Skipped local path ${JSON.stringify(rel)}: symlink target is not a regular file or directory`
+		});
 	}
 	emitScanError(options, path, kind, err) {
 		const event = {
@@ -139,9 +246,12 @@ async function loadLocalNodeDeps() {
 	return {
 		readdir: fsPromises.readdir,
 		lstat: fsPromises.lstat,
+		stat: fsPromises.stat,
 		join: path.join,
 		relative: path.relative,
+		realpath: fsPromises.realpath,
 		resolve: path.resolve,
+		isAbsolute: path.isAbsolute,
 		sep: path.sep
 	};
 }
@@ -205,8 +315,15 @@ function normalizePathSegments(segments, separator) {
 	}
 	return out.join(separator);
 }
-function relativePathFromRoot(root, path, nodeDeps) {
-	return nodeDeps.relative(root, path).split(nodeDeps.sep).join("/");
+function joinSyncRelativePath(parent, child) {
+	return parent === "" ? child : `${parent}/${child}`;
+}
+function isPathInsideRoot(root, path, nodeDeps) {
+	const rel = nodeDeps.relative(root, path);
+	return rel === "" || !rel.startsWith(`..${nodeDeps.sep}`) && rel !== ".." && !nodeDeps.isAbsolute(rel);
+}
+function localNodeIdentity(stats) {
+	return `${stats.dev}:${stats.ino}`;
 }
 function throwIfScanAborted(options) {
 	if (options.signal?.aborted === true) throw options.signal.reason ?? new DOMException("Aborted", "AbortError");

package/dist/sync/scanners/local.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"local.cjs","names":[],"sources":["../../../src/sync/scanners/local.ts"],"sourcesContent":["import {\n  isDownloadStagingDirectorySegment,\n  isManagedDownloadStagingRoot,\n} from '../download-staging.ts'\nimport { localFilesystemErrorReason } from '../filesystem-errors.ts'\nimport {\n  directoryMayContainSyncPaths,\n  pathPassesSyncFilters,\n  pathSkippedByRegExpInputLimit,\n} from '../filters.ts'\nimport { localFileIdentityFromStats } from '../local-file-identity.ts'\nimport { registerLocalFilesystemRoot } from '../local-filesystem-root.ts'\nimport { compareSyncRelativePaths } from '../path-order.ts'\nimport { isReservedSyncTempFileName } from '../path-safety.ts'\nimport { validateSyncFilters } from '../regexp-safety.ts'\nimport { emitScannerSkip, regexpInputTooLongSkip } from '../scan-events.ts'\nimport { assertScanEntryLimit, scanEntryLimit } from '../scan-limit.ts'\nimport type { LocalSyncPath, SyncErrorEvent, SyncFolder, SyncScanOptions } from '../types.ts'\n\ntype LocalDirent = {\n  readonly name: string\n  isDirectory(): boolean\n  isFile(): boolean\n}\n\ntype LocalStats = {\n  readonly dev: number\n  readonly ino: number\n  readonly mtimeMs: number\n  readonly ctimeMs: number\n  readonly size: number\n  isFile(): boolean\n}\n\ntype LocalNodeDeps = {\n  readdir(path: string, options: { readonly withFileTypes: true }): Promise<LocalDirent[]>\n  lstat(path: string): Promise<LocalStats>\n  join(...paths: string[]): string\n  relative(from: string, to: string): string\n  resolve(...paths: string[]): string\n  sep: string\n}\n\n/**\n * Scans a local directory tree and yields {@link LocalSyncPath} entries sorted by relative path.\n * A root directory read failure aborts the scan with an error diagnostic. Per-entry file or\n * directory failures are reported through `onError` and the scan continues over readable siblings.\n * SDK-managed partial download file names are skipped so unfinished internal\n * temp files are not synchronized.\n * The current implementation collects matching entries before sorting, so memory usage is\n * proportional to the number of matched files.\n */\nexport class LocalFolder implements SyncFolder {\n  readonly type = 'local' as const\n  readonly appliesScanFilters = true as const\n  readonly appliesScanSorting = true as const\n  /** Resolved absolute path to the local root directory. */\n  readonly root: string\n\n  /**\n   * Creates a new LocalFolder for the given root directory.\n   * @param root - Absolute or relative path to the local directory to scan.\n   */\n  constructor(root: string) {\n    this.root = resolvePathAtConstruction(root)\n    registerLocalFilesystemRoot(this)\n  }\n\n  /**\n   * Recursively walks the directory and yields files in sync path order.\n   * @param options - Optional scan controls.\n   */\n  async *scan(options: SyncScanOptions = {}): AsyncGenerator<LocalSyncPath> {\n    validateSyncFilters(options)\n    const nodeDeps = await loadLocalNodeDeps()\n    const root = nodeDeps.resolve(this.root)\n    const collected: LocalSyncPath[] = []\n    await this.walk(root, root, collected, options, scanEntryLimit(options), nodeDeps)\n    collected.sort((a, b) => compareSyncRelativePaths(a.relativePath, b.relativePath))\n    for (const entry of collected) {\n      throwIfScanAborted(options)\n      yield entry\n    }\n  }\n\n  /**\n   * Recursively collects files from {@link dir} into {@link out}.\n   * @param root - Resolved scan root used for relative path calculation.\n   * @param dir - Absolute path of the directory to scan.\n   * @param out - Accumulator array that receives discovered file entries.\n   * @param options - Optional scan controls.\n   * @param maxScanEntries - Maximum number of entries to retain before failing.\n   * @param nodeDeps - Lazy-loaded Node filesystem and path helpers.\n   */\n  private async walk(\n    root: string,\n    dir: string,\n    out: LocalSyncPath[],\n    options: SyncScanOptions,\n    maxScanEntries: number,\n    nodeDeps: LocalNodeDeps,\n  ): Promise<void> {\n    throwIfScanAborted(options)\n    let entries: LocalDirent[]\n    try {\n      entries = await nodeDeps.readdir(dir, { withFileTypes: true })\n    } catch (err) {\n      const error = this.emitScanError(\n        options,\n        relativePathFromRoot(root, dir, nodeDeps),\n        'directory',\n        err,\n      )\n      if (dir === root) throw error\n      return\n    }\n\n    for (const entry of entries) {\n      throwIfScanAborted(options)\n      const fullPath = nodeDeps.join(dir, entry.name)\n      const rel = relativePathFromRoot(root, fullPath, nodeDeps)\n      if (\n        isDownloadStagingDirectorySegment(rel) &&\n        entry.isDirectory() &&\n        isDownloadStagingDirectorySegment(entry.name) &&\n        (await isManagedDownloadStagingRoot(fullPath))\n      ) {\n        continue\n      }\n      if (rel.includes('\\\\')) {\n        emitScannerSkip(options, {\n          type: 'skip',\n          path: rel,\n          size: 0,\n          reason: 'unsafe-name',\n          message: `Skipped local path ${JSON.stringify(rel)}: backslashes are not safe sync path characters`,\n        })\n        continue\n      }\n      if (isReservedSyncTempFileName(entry.name)) {\n        emitScannerSkip(options, {\n          type: 'skip',\n          path: rel,\n          size: 0,\n          reason: 'stale-download-partial',\n          message: `Skipped local path ${JSON.stringify(rel)}: reserved SDK partial download file`,\n        })\n        continue\n      }\n      // Symlinks, FIFOs, sockets, and device nodes are not syncable files.\n      // Ignore them without poisoning delete-mode orphan handling for unrelated paths.\n      if (entry.isDirectory()) {\n        if (directoryMayContainSyncPaths(rel, options)) {\n          await this.walk(root, fullPath, out, options, maxScanEntries, nodeDeps)\n        }\n      } else if (entry.isFile()) {\n        if (!pathPassesSyncFilters(rel, options)) {\n          if (pathSkippedByRegExpInputLimit(rel, options)) {\n            emitScannerSkip(options, regexpInputTooLongSkip(rel))\n          }\n          continue\n        }\n        let s: LocalStats\n        try {\n          s = await nodeDeps.lstat(fullPath)\n          /* v8 ignore start -- lstat race after a Dirent file result is not deterministic */\n          if (!s.isFile()) {\n            this.emitScanError(options, rel, 'file', new Error('not a regular file'))\n            continue\n          }\n          /* v8 ignore stop */\n        } catch (err) {\n          /* v8 ignore next -- stat TOCTOU failures are not deterministic to trigger */\n          this.emitScanError(options, relativePathFromRoot(root, fullPath, nodeDeps), 'file', err)\n          continue\n        }\n        assertScanEntryLimit(out.length + 1, maxScanEntries)\n        out.push({\n          relativePath: rel,\n          absolutePath: fullPath,\n          modTimeMillis: Math.floor(s.mtimeMs),\n          size: s.size,\n          fileIdentity: localFileIdentityFromStats(s),\n        })\n      }\n    }\n  }\n\n  private emitScanError(\n    options: SyncScanOptions,\n    path: string,\n    kind: 'directory' | 'file',\n    err: unknown,\n  ): Error {\n    const event: SyncErrorEvent = {\n      type: 'error',\n      path,\n      size: 0,\n      message: `failed to scan local ${kind}: ${localFilesystemErrorReason(err)}`,\n    }\n    options.onError?.(event)\n    return new Error(event.message)\n  }\n}\n\nasync function loadLocalNodeDeps(): Promise<LocalNodeDeps> {\n  const [fsPromises, path] = await Promise.all([import('node:fs/promises'), import('node:path')])\n  return {\n    readdir: fsPromises.readdir as LocalNodeDeps['readdir'],\n    lstat: fsPromises.lstat as LocalNodeDeps['lstat'],\n    join: path.join,\n    relative: path.relative,\n    resolve: path.resolve,\n    sep: path.sep,\n  }\n}\n\nfunction resolvePathAtConstruction(root: string): string {\n  const processLike = (\n    globalThis as {\n      process?: { cwd?: () => string; platform?: string }\n    }\n  ).process\n  if (typeof processLike?.cwd !== 'function') return root\n\n  const cwd = processLike.cwd()\n  if (processLike.platform === 'win32') return resolveWindowsPath(cwd, root)\n  return resolvePosixPath(cwd, root)\n}\n\nfunction resolvePosixPath(cwd: string, root: string): string {\n  const joined = root.startsWith('/') ? root : `${cwd}/${root}`\n  const resolved = normalizePathSegments(joined.split('/'), '/')\n  return resolved === '' ? '/' : `/${resolved}`\n}\n\nfunction resolveWindowsPath(cwd: string, root: string): string {\n  const normalizedRoot = root.replaceAll('/', '\\\\')\n  const normalizedCwd = cwd.replaceAll('/', '\\\\')\n  const drive = /^[A-Za-z]:/.exec(normalizedCwd)?.[0] ?? ''\n  const cwdUnc = splitUncPath(normalizedCwd)\n  if (/^\\\\\\\\/.test(normalizedRoot)) return normalizeUncPath(normalizedRoot)\n  if (/^[A-Za-z]:\\\\/.test(normalizedRoot)) {\n    const prefix = normalizedRoot.slice(0, 2)\n    const rest = normalizedRoot.slice(3).split('\\\\')\n    return joinWindowsRoot(prefix, normalizePathSegments(rest, '\\\\'))\n  }\n  if (/^[A-Za-z]:/.test(normalizedRoot)) {\n    throw new Error('LocalFolder root must not be a drive-relative Windows path')\n  }\n  if (normalizedRoot.startsWith('\\\\')) {\n    const rest = normalizePathSegments(normalizedRoot.slice(1).split('\\\\'), '\\\\')\n    return joinWindowsRoot(cwdUnc?.prefix ?? drive, rest)\n  }\n  if (cwdUnc !== undefined) {\n    const resolved = normalizePathSegments([...cwdUnc.rest, ...normalizedRoot.split('\\\\')], '\\\\')\n    return joinWindowsRoot(cwdUnc.prefix, resolved)\n  }\n  const base = /^[A-Za-z]:\\\\/.test(normalizedCwd) ? normalizedCwd : `${drive}\\\\`\n  const prefix = /^[A-Za-z]:/.exec(base)?.[0] ?? drive\n  const baseRest = base.slice(prefix.length).replace(/^\\\\/, '').split('\\\\')\n  const resolved = normalizePathSegments([...baseRest, ...normalizedRoot.split('\\\\')], '\\\\')\n  return joinWindowsRoot(prefix, resolved)\n}\n\nfunction normalizeUncPath(path: string): string {\n  const unc = splitUncPath(path)\n  if (unc === undefined) return path\n  return joinWindowsRoot(unc.prefix, normalizePathSegments(unc.rest, '\\\\'))\n}\n\nfunction splitUncPath(\n  path: string,\n): { readonly prefix: string; readonly rest: string[] } | undefined {\n  if (!path.startsWith('\\\\\\\\')) return undefined\n  const parts = path.split('\\\\').filter((part) => part !== '')\n  const [server, share, ...rest] = parts\n  if (server === undefined || share === undefined) return undefined\n  return { prefix: `\\\\\\\\${server}\\\\${share}`, rest }\n}\n\nfunction joinWindowsRoot(prefix: string, rest: string): string {\n  return rest === '' ? `${prefix}\\\\` : `${prefix}\\\\${rest}`\n}\n\nfunction normalizePathSegments(segments: readonly string[], separator: '/' | '\\\\'): string {\n  const out: string[] = []\n  for (const segment of segments) {\n    if (segment === '' || segment === '.') continue\n    if (segment === '..') {\n      out.pop()\n      continue\n    }\n    out.push(segment)\n  }\n  return out.join(separator)\n}\n\nfunction relativePathFromRoot(root: string, path: string, nodeDeps: LocalNodeDeps): string {\n  return nodeDeps.relative(root, path).split(nodeDeps.sep).join('/')\n}\n\nfunction throwIfScanAborted(options: SyncScanOptions): void {\n  if (options.signal?.aborted === true) {\n    throw options.signal.reason ?? new DOMException('Aborted', 'AbortError')\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"local.cjs","names":[],"sources":["../../../src/sync/scanners/local.ts"],"sourcesContent":["import {\n  isDownloadStagingDirectorySegment,\n  isManagedDownloadStagingRoot,\n} from '../download-staging.ts'\nimport { localFilesystemErrorReason } from '../filesystem-errors.ts'\nimport {\n  directoryMayContainSyncPaths,\n  pathPassesSyncFilters,\n  pathSkippedByRegExpInputLimit,\n} from '../filters.ts'\nimport { localFileIdentityFromStats } from '../local-file-identity.ts'\nimport { registerLocalFilesystemRoot } from '../local-filesystem-root.ts'\nimport { compareSyncRelativePaths } from '../path-order.ts'\nimport { isReservedSyncTempFileName } from '../path-safety.ts'\nimport { validateSyncFilters } from '../regexp-safety.ts'\nimport { emitScannerSkip, regexpInputTooLongSkip } from '../scan-events.ts'\nimport { assertScanEntryLimit, scanEntryLimit } from '../scan-limit.ts'\nimport type { LocalSyncPath, SyncErrorEvent, SyncFolder, SyncScanOptions } from '../types.ts'\n\ntype LocalDirent = {\n  readonly name: string\n  isDirectory(): boolean\n  isFile(): boolean\n  isSymbolicLink(): boolean\n}\n\ntype LocalStats = {\n  readonly dev: number\n  readonly ino: number\n  readonly mtimeMs: number\n  readonly ctimeMs: number\n  readonly size: number\n  isDirectory(): boolean\n  isFile(): boolean\n}\n\ntype LocalNodeDeps = {\n  readdir(path: string, options: { readonly withFileTypes: true }): Promise<LocalDirent[]>\n  lstat(path: string): Promise<LocalStats>\n  stat(path: string): Promise<LocalStats>\n  join(...paths: string[]): string\n  relative(from: string, to: string): string\n  realpath(path: string): Promise<string>\n  resolve(...paths: string[]): string\n  isAbsolute(path: string): boolean\n  sep: string\n}\n\n/**\n * Scans a local directory tree and yields {@link LocalSyncPath} entries sorted by relative path.\n * A root directory read failure aborts the scan with an error diagnostic. Per-entry file or\n * directory failures are reported through `onError` and the scan continues over readable siblings.\n * SDK-managed partial download file names are skipped so unfinished internal\n * temp files are not synchronized.\n * The current implementation collects matching entries before sorting, so memory usage is\n * proportional to the number of matched files.\n */\nexport class LocalFolder implements SyncFolder {\n  readonly type = 'local' as const\n  readonly appliesScanFilters = true as const\n  readonly appliesScanSorting = true as const\n  /** Resolved absolute path to the local root directory. */\n  readonly root: string\n\n  /**\n   * Creates a new LocalFolder for the given root directory.\n   * @param root - Absolute or relative path to the local directory to scan.\n   */\n  constructor(root: string) {\n    this.root = resolvePathAtConstruction(root)\n    registerLocalFilesystemRoot(this)\n  }\n\n  /**\n   * Recursively walks the directory and yields files in sync path order.\n   * @param options - Optional scan controls.\n   */\n  async *scan(options: SyncScanOptions = {}): AsyncGenerator<LocalSyncPath> {\n    validateSyncFilters(options)\n    const nodeDeps = await loadLocalNodeDeps()\n    const root = nodeDeps.resolve(this.root)\n    const followSymlinks =\n      options.localSymlinks === 'follow' && options.requireLocalSafePaths !== true\n    let scanRoot = root\n    const collected: LocalSyncPath[] = []\n    const activeDirectoryIds = new Set<string>()\n    const followedDirectoryIds = new Set<string>()\n    if (followSymlinks) {\n      try {\n        scanRoot = await nodeDeps.realpath(root)\n        const rootStats = await nodeDeps.stat(scanRoot)\n        if (rootStats.isDirectory()) activeDirectoryIds.add(localNodeIdentity(rootStats))\n      } catch {\n        // Root read errors are reported by walk(), preserving the existing diagnostic shape.\n      }\n    }\n    await this.walk(\n      scanRoot,\n      scanRoot,\n      '',\n      collected,\n      options,\n      scanEntryLimit(options),\n      nodeDeps,\n      activeDirectoryIds,\n      followedDirectoryIds,\n    )\n    collected.sort((a, b) => compareSyncRelativePaths(a.relativePath, b.relativePath))\n    for (const entry of collected) {\n      throwIfScanAborted(options)\n      yield entry\n    }\n  }\n\n  /**\n   * Recursively collects files from {@link dir} into {@link out}.\n   * @param root - Resolved scan root used for relative path calculation.\n   * @param dir - Absolute path of the directory to scan.\n   * @param dirRel - Sync-relative path represented by {@link dir}.\n   * @param out - Accumulator array that receives discovered file entries.\n   * @param options - Optional scan controls.\n   * @param maxScanEntries - Maximum number of entries to retain before failing.\n   * @param nodeDeps - Lazy-loaded Node filesystem and path helpers.\n   * @param activeDirectoryIds - Directory identities in the current recursion stack.\n   * @param followedDirectoryIds - Followed symlink directory identities already traversed.\n   */\n  private async walk(\n    root: string,\n    dir: string,\n    dirRel: string,\n    out: LocalSyncPath[],\n    options: SyncScanOptions,\n    maxScanEntries: number,\n    nodeDeps: LocalNodeDeps,\n    activeDirectoryIds: Set<string>,\n    followedDirectoryIds: Set<string>,\n  ): Promise<void> {\n    throwIfScanAborted(options)\n    let entries: LocalDirent[]\n    try {\n      entries = await nodeDeps.readdir(dir, { withFileTypes: true })\n    } catch (err) {\n      const error = this.emitScanError(options, dirRel, 'directory', err)\n      if (dir === root) throw error\n      return\n    }\n\n    for (const entry of entries) {\n      throwIfScanAborted(options)\n      const fullPath = nodeDeps.join(dir, entry.name)\n      const rel = joinSyncRelativePath(dirRel, entry.name)\n      if (\n        isDownloadStagingDirectorySegment(rel) &&\n        entry.isDirectory() &&\n        isDownloadStagingDirectorySegment(entry.name) &&\n        (await isManagedDownloadStagingRoot(fullPath))\n      ) {\n        continue\n      }\n      if (rel.includes('\\\\')) {\n        emitScannerSkip(options, {\n          type: 'skip',\n          path: rel,\n          size: 0,\n          reason: 'unsafe-name',\n          message: `Skipped local path ${JSON.stringify(rel)}: backslashes are not safe sync path characters`,\n        })\n        continue\n      }\n      if (isReservedSyncTempFileName(entry.name)) {\n        emitScannerSkip(options, {\n          type: 'skip',\n          path: rel,\n          size: 0,\n          reason: 'stale-download-partial',\n          message: `Skipped local path ${JSON.stringify(rel)}: reserved SDK partial download file`,\n        })\n        continue\n      }\n      // Symlinks, FIFOs, sockets, and device nodes are not syncable files.\n      // Ignore them without poisoning delete-mode orphan handling for unrelated paths.\n      if (entry.isDirectory()) {\n        if (directoryMayContainSyncPaths(rel, options)) {\n          await this.walkDirectory(\n            root,\n            fullPath,\n            rel,\n            out,\n            options,\n            maxScanEntries,\n            nodeDeps,\n            activeDirectoryIds,\n            followedDirectoryIds,\n          )\n        }\n      } else if (entry.isFile()) {\n        await this.collectFile(fullPath, rel, out, options, maxScanEntries, nodeDeps)\n      } else if (entry.isSymbolicLink()) {\n        await this.handleSymlink(\n          root,\n          fullPath,\n          rel,\n          out,\n          options,\n          maxScanEntries,\n          nodeDeps,\n          activeDirectoryIds,\n          followedDirectoryIds,\n        )\n      }\n    }\n  }\n\n  private async walkDirectory(\n    root: string,\n    dir: string,\n    rel: string,\n    out: LocalSyncPath[],\n    options: SyncScanOptions,\n    maxScanEntries: number,\n    nodeDeps: LocalNodeDeps,\n    activeDirectoryIds: Set<string>,\n    followedDirectoryIds: Set<string>,\n    knownStats?: LocalStats,\n  ): Promise<void> {\n    let stats = knownStats\n    if (stats === undefined) {\n      try {\n        stats = await nodeDeps.stat(dir)\n      } catch (err) {\n        /* v8 ignore start -- stat TOCTOU failures after a Dirent directory result are not deterministic */\n        this.emitScanError(options, rel, 'directory', err)\n        return\n        /* v8 ignore stop */\n      }\n    }\n    /* v8 ignore start -- stat TOCTOU races after a Dirent directory result are not deterministic */\n    if (!stats.isDirectory()) {\n      this.emitScanError(options, rel, 'directory', new Error('not a directory'))\n      return\n    }\n    /* v8 ignore stop */\n\n    const identity = localNodeIdentity(stats)\n    if (activeDirectoryIds.has(identity)) {\n      emitScannerSkip(options, {\n        type: 'skip',\n        path: rel,\n        size: 0,\n        reason: 'local-symlink-loop',\n        message: `Skipped local path ${JSON.stringify(rel)}: symlink would revisit an ancestor directory`,\n      })\n      return\n    }\n\n    activeDirectoryIds.add(identity)\n    try {\n      await this.walk(\n        root,\n        dir,\n        rel,\n        out,\n        options,\n        maxScanEntries,\n        nodeDeps,\n        activeDirectoryIds,\n        followedDirectoryIds,\n      )\n    } finally {\n      activeDirectoryIds.delete(identity)\n    }\n  }\n\n  private async collectFile(\n    fullPath: string,\n    rel: string,\n    out: LocalSyncPath[],\n    options: SyncScanOptions,\n    maxScanEntries: number,\n    nodeDeps: LocalNodeDeps,\n    knownStats?: LocalStats,\n  ): Promise<void> {\n    if (!pathPassesSyncFilters(rel, options)) {\n      if (pathSkippedByRegExpInputLimit(rel, options)) {\n        emitScannerSkip(options, regexpInputTooLongSkip(rel))\n      }\n      return\n    }\n\n    let s = knownStats\n    if (s === undefined) {\n      try {\n        s = await nodeDeps.lstat(fullPath)\n        /* v8 ignore start -- lstat race after a Dirent file result is not deterministic */\n        if (!s.isFile()) {\n          this.emitScanError(options, rel, 'file', new Error('not a regular file'))\n          return\n        }\n        /* v8 ignore stop */\n      } catch (err) {\n        /* v8 ignore start -- stat TOCTOU failures are not deterministic to trigger */\n        this.emitScanError(options, rel, 'file', err)\n        return\n        /* v8 ignore stop */\n      }\n    }\n\n    assertScanEntryLimit(out.length + 1, maxScanEntries)\n    out.push({\n      relativePath: rel,\n      absolutePath: fullPath,\n      modTimeMillis: Math.floor(s.mtimeMs),\n      size: s.size,\n      fileIdentity: localFileIdentityFromStats(s),\n    })\n  }\n\n  private async handleSymlink(\n    root: string,\n    fullPath: string,\n    rel: string,\n    out: LocalSyncPath[],\n    options: SyncScanOptions,\n    maxScanEntries: number,\n    nodeDeps: LocalNodeDeps,\n    activeDirectoryIds: Set<string>,\n    followedDirectoryIds: Set<string>,\n  ): Promise<void> {\n    if ((options.localSymlinks ?? 'skip') === 'skip' || options.requireLocalSafePaths === true) {\n      emitScannerSkip(options, {\n        type: 'skip',\n        path: rel,\n        size: 0,\n        reason: 'local-symlink',\n        message: `Skipped local path ${JSON.stringify(rel)}: local symlinks are disabled`,\n      })\n      return\n    }\n\n    let targetPath: string\n    let targetStats: LocalStats\n    try {\n      targetPath = await nodeDeps.realpath(fullPath)\n      targetStats = await nodeDeps.stat(targetPath)\n    } catch (err) {\n      this.emitScanError(options, rel, 'symlink', err)\n      return\n    }\n\n    if (!isPathInsideRoot(root, targetPath, nodeDeps)) {\n      emitScannerSkip(options, {\n        type: 'skip',\n        path: rel,\n        size: 0,\n        reason: 'local-symlink',\n        message: `Skipped local path ${JSON.stringify(rel)}: symlink target is outside the sync root`,\n      })\n      return\n    }\n\n    if (targetStats.isDirectory()) {\n      if (directoryMayContainSyncPaths(rel, options)) {\n        const identity = localNodeIdentity(targetStats)\n        if (followedDirectoryIds.has(identity)) {\n          emitScannerSkip(options, {\n            type: 'skip',\n            path: rel,\n            size: 0,\n            reason: 'local-symlink-loop',\n            message: `Skipped local path ${JSON.stringify(rel)}: symlink target was already visited`,\n          })\n          return\n        }\n        followedDirectoryIds.add(identity)\n        await this.walkDirectory(\n          root,\n          targetPath,\n          rel,\n          out,\n          options,\n          maxScanEntries,\n          nodeDeps,\n          activeDirectoryIds,\n          followedDirectoryIds,\n          targetStats,\n        )\n      }\n      return\n    }\n\n    if (targetStats.isFile()) {\n      await this.collectFile(targetPath, rel, out, options, maxScanEntries, nodeDeps, targetStats)\n      return\n    }\n\n    emitScannerSkip(options, {\n      type: 'skip',\n      path: rel,\n      size: 0,\n      reason: 'local-symlink',\n      message: `Skipped local path ${JSON.stringify(rel)}: symlink target is not a regular file or directory`,\n    })\n  }\n\n  private emitScanError(\n    options: SyncScanOptions,\n    path: string,\n    kind: 'directory' | 'file' | 'symlink',\n    err: unknown,\n  ): Error {\n    const event: SyncErrorEvent = {\n      type: 'error',\n      path,\n      size: 0,\n      message: `failed to scan local ${kind}: ${localFilesystemErrorReason(err)}`,\n    }\n    options.onError?.(event)\n    return new Error(event.message)\n  }\n}\n\nasync function loadLocalNodeDeps(): Promise<LocalNodeDeps> {\n  const [fsPromises, path] = await Promise.all([import('node:fs/promises'), import('node:path')])\n  return {\n    readdir: fsPromises.readdir as LocalNodeDeps['readdir'],\n    lstat: fsPromises.lstat as LocalNodeDeps['lstat'],\n    stat: fsPromises.stat as LocalNodeDeps['stat'],\n    join: path.join,\n    relative: path.relative,\n    realpath: fsPromises.realpath,\n    resolve: path.resolve,\n    isAbsolute: path.isAbsolute,\n    sep: path.sep,\n  }\n}\n\nfunction resolvePathAtConstruction(root: string): string {\n  const processLike = (\n    globalThis as {\n      process?: { cwd?: () => string; platform?: string }\n    }\n  ).process\n  if (typeof processLike?.cwd !== 'function') return root\n\n  const cwd = processLike.cwd()\n  if (processLike.platform === 'win32') return resolveWindowsPath(cwd, root)\n  return resolvePosixPath(cwd, root)\n}\n\nfunction resolvePosixPath(cwd: string, root: string): string {\n  const joined = root.startsWith('/') ? root : `${cwd}/${root}`\n  const resolved = normalizePathSegments(joined.split('/'), '/')\n  return resolved === '' ? '/' : `/${resolved}`\n}\n\nfunction resolveWindowsPath(cwd: string, root: string): string {\n  const normalizedRoot = root.replaceAll('/', '\\\\')\n  const normalizedCwd = cwd.replaceAll('/', '\\\\')\n  const drive = /^[A-Za-z]:/.exec(normalizedCwd)?.[0] ?? ''\n  const cwdUnc = splitUncPath(normalizedCwd)\n  if (/^\\\\\\\\/.test(normalizedRoot)) return normalizeUncPath(normalizedRoot)\n  if (/^[A-Za-z]:\\\\/.test(normalizedRoot)) {\n    const prefix = normalizedRoot.slice(0, 2)\n    const rest = normalizedRoot.slice(3).split('\\\\')\n    return joinWindowsRoot(prefix, normalizePathSegments(rest, '\\\\'))\n  }\n  if (/^[A-Za-z]:/.test(normalizedRoot)) {\n    throw new Error('LocalFolder root must not be a drive-relative Windows path')\n  }\n  if (normalizedRoot.startsWith('\\\\')) {\n    const rest = normalizePathSegments(normalizedRoot.slice(1).split('\\\\'), '\\\\')\n    return joinWindowsRoot(cwdUnc?.prefix ?? drive, rest)\n  }\n  if (cwdUnc !== undefined) {\n    const resolved = normalizePathSegments([...cwdUnc.rest, ...normalizedRoot.split('\\\\')], '\\\\')\n    return joinWindowsRoot(cwdUnc.prefix, resolved)\n  }\n  const base = /^[A-Za-z]:\\\\/.test(normalizedCwd) ? normalizedCwd : `${drive}\\\\`\n  const prefix = /^[A-Za-z]:/.exec(base)?.[0] ?? drive\n  const baseRest = base.slice(prefix.length).replace(/^\\\\/, '').split('\\\\')\n  const resolved = normalizePathSegments([...baseRest, ...normalizedRoot.split('\\\\')], '\\\\')\n  return joinWindowsRoot(prefix, resolved)\n}\n\nfunction normalizeUncPath(path: string): string {\n  const unc = splitUncPath(path)\n  if (unc === undefined) return path\n  return joinWindowsRoot(unc.prefix, normalizePathSegments(unc.rest, '\\\\'))\n}\n\nfunction splitUncPath(\n  path: string,\n): { readonly prefix: string; readonly rest: string[] } | undefined {\n  if (!path.startsWith('\\\\\\\\')) return undefined\n  const parts = path.split('\\\\').filter((part) => part !== '')\n  const [server, share, ...rest] = parts\n  if (server === undefined || share === undefined) return undefined\n  return { prefix: `\\\\\\\\${server}\\\\${share}`, rest }\n}\n\nfunction joinWindowsRoot(prefix: string, rest: string): string {\n  return rest === '' ? `${prefix}\\\\` : `${prefix}\\\\${rest}`\n}\n\nfunction normalizePathSegments(segments: readonly string[], separator: '/' | '\\\\'): string {\n  const out: string[] = []\n  for (const segment of segments) {\n    if (segment === '' || segment === '.') continue\n    if (segment === '..') {\n      out.pop()\n      continue\n    }\n    out.push(segment)\n  }\n  return out.join(separator)\n}\n\nfunction joinSyncRelativePath(parent: string, child: string): string {\n  return parent === '' ? child : `${parent}/${child}`\n}\n\nfunction isPathInsideRoot(root: string, path: string, nodeDeps: LocalNodeDeps): boolean {\n  const rel = nodeDeps.relative(root, path)\n  return (\n    rel === '' ||\n    (!rel.startsWith(`..${nodeDeps.sep}`) && rel !== '..' && !nodeDeps.isAbsolute(rel))\n  )\n}\n\nfunction localNodeIdentity(stats: LocalStats): string {\n  return `${stats.dev}:${stats.ino}`\n}\n\nfunction throwIfScanAborted(options: SyncScanOptions): void {\n  if (options.signal?.aborted === true) {\n    throw options.signal.reason ?? new DOMException('Aborted', 'AbortError')\n  }\n}\n"],"mappings":"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"}

package/dist/sync/scanners/local.d.cts

@@ -28,12 +28,18 @@ export declare class LocalFolder implements SyncFolder {
      * Recursively collects files from {@link dir} into {@link out}.
      * @param root - Resolved scan root used for relative path calculation.
      * @param dir - Absolute path of the directory to scan.
+     * @param dirRel - Sync-relative path represented by {@link dir}.
      * @param out - Accumulator array that receives discovered file entries.
      * @param options - Optional scan controls.
      * @param maxScanEntries - Maximum number of entries to retain before failing.
      * @param nodeDeps - Lazy-loaded Node filesystem and path helpers.
+     * @param activeDirectoryIds - Directory identities in the current recursion stack.
+     * @param followedDirectoryIds - Followed symlink directory identities already traversed.
      */
     private walk;
+    private walkDirectory;
+    private collectFile;
+    private handleSymlink;
     private emitScanError;
 }
 //# sourceMappingURL=local.d.ts.map

package/dist/sync/scanners/local.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../../src/sync/scanners/local.js"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,aAAa,EAAkB,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AA0B7F;;;;;;;;GAQG;AACH,qBAAa,WAAY,YAAW,UAAU;IAC5C,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAS;IAChC,QAAQ,CAAC,kBAAkB,EAAG,IAAI,CAAS;IAC3C,QAAQ,CAAC,kBAAkB,EAAG,IAAI,CAAS;IAC3C,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;;OAGG;gBACS,IAAI,EAAE,MAAM;IAKxB;;;OAGG;IACI,IAAI,CAAC,OAAO,GAAE,eAAoB,GAAG,cAAc,CAAC,aAAa,CAAC;IAazE;;;;;;;;OAQG;YACW,IAAI;IA8FlB,OAAO,CAAC,aAAa;CAetB"}
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../../src/sync/scanners/local.js"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,aAAa,EAAkB,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AA+B7F;;;;;;;;GAQG;AACH,qBAAa,WAAY,YAAW,UAAU;IAC5C,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAS;IAChC,QAAQ,CAAC,kBAAkB,EAAG,IAAI,CAAS;IAC3C,QAAQ,CAAC,kBAAkB,EAAG,IAAI,CAAS;IAC3C,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;;OAGG;gBACS,IAAI,EAAE,MAAM;IAKxB;;;OAGG;IACI,IAAI,CAAC,OAAO,GAAE,eAAoB,GAAG,cAAc,CAAC,aAAa,CAAC;IAqCzE;;;;;;;;;;;OAWG;YACW,IAAI;YAuFJ,aAAa;YA4Db,WAAW;YA4CX,aAAa;IAuF3B,OAAO,CAAC,aAAa;CAetB"}

package/dist/sync/scanners/local.d.ts

@@ -28,12 +28,18 @@ export declare class LocalFolder implements SyncFolder {
      * Recursively collects files from {@link dir} into {@link out}.
      * @param root - Resolved scan root used for relative path calculation.
      * @param dir - Absolute path of the directory to scan.
+     * @param dirRel - Sync-relative path represented by {@link dir}.
      * @param out - Accumulator array that receives discovered file entries.
      * @param options - Optional scan controls.
      * @param maxScanEntries - Maximum number of entries to retain before failing.
      * @param nodeDeps - Lazy-loaded Node filesystem and path helpers.
+     * @param activeDirectoryIds - Directory identities in the current recursion stack.
+     * @param followedDirectoryIds - Followed symlink directory identities already traversed.
      */
     private walk;
+    private walkDirectory;
+    private collectFile;
+    private handleSymlink;
     private emitScanError;
 }
 //# sourceMappingURL=local.d.ts.map