@zero-transfer/webdav 0.4.6 → 0.4.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.mjs CHANGED
@@ -1,6 +1,68 @@
1
1
  // src/client/ZeroTransfer.ts
2
2
  import { EventEmitter } from "events";
3
3
 
4
+ // src/logging/redaction.ts
5
+ var REDACTED = "[REDACTED]";
6
+ var SENSITIVE_KEY_PATTERN = /(?:password|passphrase|privatekey|token|secret|username|user)$/i;
7
+ var SECRET_COMMAND_PATTERN = /^(PASS|USER|ACCT)\s+(.+)$/i;
8
+ var URL_KEY_PATTERN = /(?:url|uri|href)$/i;
9
+ function isSensitiveKey(key) {
10
+ return SENSITIVE_KEY_PATTERN.test(key.replace(/[_-]/g, ""));
11
+ }
12
+ function redactCommand(command) {
13
+ return command.replace(SECRET_COMMAND_PATTERN, (_fullMatch, commandName) => {
14
+ return `${commandName.toUpperCase()} ${REDACTED}`;
15
+ });
16
+ }
17
+ function redactValue(value) {
18
+ if (typeof value === "string") {
19
+ return redactCommand(value);
20
+ }
21
+ if (Array.isArray(value)) {
22
+ return value.map((item) => redactValue(item));
23
+ }
24
+ if (value !== null && typeof value === "object") {
25
+ return redactObject(value);
26
+ }
27
+ return value;
28
+ }
29
+ function redactObject(input) {
30
+ return Object.fromEntries(
31
+ Object.entries(input).map(([key, value]) => {
32
+ if (isSensitiveKey(key)) {
33
+ return [key, REDACTED];
34
+ }
35
+ if (URL_KEY_PATTERN.test(key) && typeof value === "string") {
36
+ return [key, redactUrlForLogging(value)];
37
+ }
38
+ return [key, redactValue(value)];
39
+ })
40
+ );
41
+ }
42
+ function redactUrlForLogging(url) {
43
+ let parsed;
44
+ try {
45
+ parsed = typeof url === "string" ? new URL(url) : url;
46
+ } catch {
47
+ return REDACTED;
48
+ }
49
+ const origin = parsed.host.length > 0 ? `${parsed.protocol}//${parsed.host}` : parsed.protocol;
50
+ const query = parsed.search.length > 0 ? `?${REDACTED}` : "";
51
+ return `${origin}${parsed.pathname}${query}`;
52
+ }
53
+ function redactErrorForLogging(error) {
54
+ if (error !== null && typeof error === "object") {
55
+ const candidate = error;
56
+ if (typeof candidate.toJSON === "function") {
57
+ return redactObject(candidate.toJSON());
58
+ }
59
+ }
60
+ if (error instanceof Error) {
61
+ return redactObject({ message: error.message, name: error.name });
62
+ }
63
+ return { message: redactValue(typeof error === "string" ? error : String(error)) };
64
+ }
65
+
4
66
  // src/errors/ZeroTransferError.ts
5
67
  var ZeroTransferError = class extends Error {
6
68
  /** Stable machine-readable error code. */
@@ -42,6 +104,11 @@ var ZeroTransferError = class extends Error {
42
104
  /**
43
105
  * Serializes the error into a plain object suitable for logs or API responses.
44
106
  *
107
+ * `details` and `command` are passed through secret redaction so serialized
108
+ * errors never leak credentials, signed URLs, or raw protocol commands. The
109
+ * live {@link ZeroTransferError.details | details} property stays unredacted
110
+ * for programmatic consumers.
111
+ *
45
112
  * @returns A JSON-safe object containing public structured error fields.
46
113
  */
47
114
  toJSON() {
@@ -51,12 +118,12 @@ var ZeroTransferError = class extends Error {
51
118
  message: this.message,
52
119
  protocol: this.protocol,
53
120
  host: this.host,
54
- command: this.command,
121
+ command: this.command === void 0 ? void 0 : redactCommand(this.command),
55
122
  ftpCode: this.ftpCode,
56
123
  sftpCode: this.sftpCode,
57
124
  path: this.path,
58
125
  retryable: this.retryable,
59
- details: this.details
126
+ details: this.details === void 0 ? void 0 : redactObject(this.details)
60
127
  };
61
128
  }
62
129
  };
@@ -579,15 +646,20 @@ var ProviderRegistry = class {
579
646
  var TransferClient = class {
580
647
  /** Provider registry used by this client. */
581
648
  registry;
649
+ /** Execution defaults applied when call sites omit their own values. */
650
+ defaults;
582
651
  logger;
583
652
  /**
584
653
  * Creates a transfer client without opening any provider connections.
585
654
  *
586
- * @param options - Optional registry, provider factories, and logger.
655
+ * @param options - Optional registry, provider factories, logger, and execution defaults.
587
656
  */
588
657
  constructor(options = {}) {
589
658
  this.registry = options.registry ?? new ProviderRegistry();
590
659
  this.logger = options.logger ?? noopLogger;
660
+ if (options.defaults !== void 0) {
661
+ this.defaults = { ...options.defaults };
662
+ }
591
663
  for (const provider of options.providers ?? []) {
592
664
  this.registry.register(provider);
593
665
  }
@@ -1160,18 +1232,25 @@ var TransferEngine = class {
1160
1232
  for (let attemptNumber = 1; attemptNumber <= maxAttempts; attemptNumber += 1) {
1161
1233
  this.throwIfAborted(abortScope.signal, job);
1162
1234
  const attemptStartedAt = this.now();
1235
+ const attemptScope = createAttemptScope(
1236
+ abortScope.signal,
1237
+ options.timeout,
1238
+ job,
1239
+ attemptNumber
1240
+ );
1163
1241
  const context = this.createExecutionContext(
1164
1242
  job,
1165
1243
  attemptNumber,
1166
1244
  attemptStartedAt,
1167
1245
  options,
1168
- abortScope.signal,
1246
+ attemptScope.signal,
1169
1247
  (bytesTransferred) => {
1170
1248
  latestBytesTransferred = bytesTransferred;
1171
- }
1249
+ },
1250
+ attemptScope.notifyProgress
1172
1251
  );
1173
1252
  try {
1174
- const result = await runExecutor(executor, context, abortScope.signal, job);
1253
+ const result = await runExecutor(executor, context, attemptScope.signal, job);
1175
1254
  context.throwIfAborted();
1176
1255
  latestBytesTransferred = result.bytesTransferred;
1177
1256
  const completedAt = this.now();
@@ -1189,16 +1268,27 @@ var TransferEngine = class {
1189
1268
  summarizeError(error)
1190
1269
  );
1191
1270
  attempts.push(attempt);
1192
- if (error instanceof AbortError || error instanceof TimeoutError) {
1271
+ if (error instanceof AbortError || abortScope.signal?.aborted === true) {
1193
1272
  throw error;
1194
1273
  }
1195
- const retryInput = { attempt: attemptNumber, error, job };
1274
+ const retryInput = {
1275
+ attempt: attemptNumber,
1276
+ elapsedMs: Math.max(0, completedAt.getTime() - startedAt.getTime()),
1277
+ error,
1278
+ job
1279
+ };
1196
1280
  const shouldRetry = attemptNumber < maxAttempts && (options.retry?.shouldRetry?.(retryInput) ?? isRetryable(error));
1197
1281
  if (shouldRetry) {
1198
1282
  options.retry?.onRetry?.(retryInput);
1283
+ const delayMs = normalizeDelayMs(options.retry?.getDelayMs?.(retryInput));
1284
+ if (delayMs > 0) {
1285
+ await sleepWithAbort(delayMs, abortScope.signal, job);
1286
+ }
1199
1287
  continue;
1200
1288
  }
1201
1289
  throw createTransferFailure(job, error, attempts);
1290
+ } finally {
1291
+ attemptScope.dispose();
1202
1292
  }
1203
1293
  }
1204
1294
  throw createTransferFailure(job, void 0, attempts);
@@ -1206,12 +1296,13 @@ var TransferEngine = class {
1206
1296
  abortScope.dispose();
1207
1297
  }
1208
1298
  }
1209
- createExecutionContext(job, attempt, startedAt, options, signal, updateBytesTransferred) {
1299
+ createExecutionContext(job, attempt, startedAt, options, signal, updateBytesTransferred, notifyProgress) {
1210
1300
  const context = {
1211
1301
  attempt,
1212
1302
  job,
1213
1303
  reportProgress: (bytesTransferred, totalBytes) => {
1214
1304
  this.throwIfAborted(signal, job);
1305
+ notifyProgress();
1215
1306
  updateBytesTransferred(bytesTransferred);
1216
1307
  const progressInput = {
1217
1308
  bytesTransferred,
@@ -1280,6 +1371,96 @@ function createAbortScope(parentSignal, timeout, job) {
1280
1371
  signal: controller.signal
1281
1372
  };
1282
1373
  }
1374
+ function createAttemptScope(parentSignal, timeout, job, attempt) {
1375
+ const attemptTimeoutMs = normalizeTimeoutMs(timeout?.attemptTimeoutMs);
1376
+ const stallTimeoutMs = normalizeTimeoutMs(timeout?.stallTimeoutMs);
1377
+ if (attemptTimeoutMs === void 0 && stallTimeoutMs === void 0) {
1378
+ const scope = {
1379
+ dispose: () => void 0,
1380
+ notifyProgress: () => void 0
1381
+ };
1382
+ if (parentSignal !== void 0) scope.signal = parentSignal;
1383
+ return scope;
1384
+ }
1385
+ const controller = new AbortController();
1386
+ const retryable = timeout?.retryable ?? true;
1387
+ const abortFromParent = () => controller.abort(parentSignal?.reason);
1388
+ if (parentSignal?.aborted === true) {
1389
+ abortFromParent();
1390
+ } else {
1391
+ parentSignal?.addEventListener("abort", abortFromParent, { once: true });
1392
+ }
1393
+ const attemptTimer = attemptTimeoutMs === void 0 ? void 0 : setTimeout(() => {
1394
+ controller.abort(
1395
+ new TimeoutError({
1396
+ details: { attempt, attemptTimeoutMs, jobId: job.id, operation: job.operation },
1397
+ message: `Transfer attempt ${String(attempt)} timed out after ${String(attemptTimeoutMs)}ms: ${job.id}`,
1398
+ retryable
1399
+ })
1400
+ );
1401
+ }, attemptTimeoutMs);
1402
+ let stallTimer;
1403
+ const armStallWatchdog = () => {
1404
+ if (stallTimeoutMs === void 0 || controller.signal.aborted) return;
1405
+ if (stallTimer !== void 0) clearTimeout(stallTimer);
1406
+ stallTimer = setTimeout(() => {
1407
+ controller.abort(
1408
+ new TimeoutError({
1409
+ details: { attempt, jobId: job.id, operation: job.operation, stallTimeoutMs },
1410
+ message: `Transfer attempt ${String(attempt)} stalled (no progress for ${String(stallTimeoutMs)}ms): ${job.id}`,
1411
+ retryable
1412
+ })
1413
+ );
1414
+ }, stallTimeoutMs);
1415
+ };
1416
+ armStallWatchdog();
1417
+ return {
1418
+ dispose: () => {
1419
+ if (attemptTimer !== void 0) clearTimeout(attemptTimer);
1420
+ if (stallTimer !== void 0) clearTimeout(stallTimer);
1421
+ parentSignal?.removeEventListener("abort", abortFromParent);
1422
+ },
1423
+ notifyProgress: armStallWatchdog,
1424
+ signal: controller.signal
1425
+ };
1426
+ }
1427
+ function sleepWithAbort(delayMs, signal, job) {
1428
+ return new Promise((resolve, reject) => {
1429
+ if (signal === void 0) {
1430
+ setTimeout(resolve, delayMs);
1431
+ return;
1432
+ }
1433
+ if (signal.aborted) {
1434
+ reject(toAbortFailure(signal, job));
1435
+ return;
1436
+ }
1437
+ const rejectAbort = () => {
1438
+ clearTimeout(timer);
1439
+ reject(toAbortFailure(signal, job));
1440
+ };
1441
+ const timer = setTimeout(() => {
1442
+ signal.removeEventListener("abort", rejectAbort);
1443
+ resolve();
1444
+ }, delayMs);
1445
+ signal.addEventListener("abort", rejectAbort, { once: true });
1446
+ });
1447
+ }
1448
+ function toAbortFailure(signal, job) {
1449
+ if (signal.reason instanceof ZeroTransferError) {
1450
+ return signal.reason;
1451
+ }
1452
+ return new AbortError({
1453
+ details: { jobId: job.id, operation: job.operation },
1454
+ message: `Transfer job aborted: ${job.id}`,
1455
+ retryable: false
1456
+ });
1457
+ }
1458
+ function normalizeDelayMs(value) {
1459
+ if (value === void 0 || !Number.isFinite(value) || value <= 0) {
1460
+ return 0;
1461
+ }
1462
+ return Math.floor(value);
1463
+ }
1283
1464
  function normalizeTimeoutMs(value) {
1284
1465
  if (value === void 0 || !Number.isFinite(value) || value <= 0) {
1285
1466
  return void 0;
@@ -1448,7 +1629,7 @@ async function runRoute(options) {
1448
1629
  const executor = createProviderTransferExecutor({
1449
1630
  resolveSession: ({ role }) => sessions.get(role)
1450
1631
  });
1451
- return await engine.execute(job, executor, buildExecuteOptions(options));
1632
+ return await engine.execute(job, executor, buildExecuteOptions(options, client));
1452
1633
  } finally {
1453
1634
  if (destinationSession !== void 0) {
1454
1635
  await destinationSession.disconnect();
@@ -1485,12 +1666,14 @@ function defaultJobId(route, now) {
1485
1666
  const timestamp = (now?.() ?? /* @__PURE__ */ new Date()).getTime();
1486
1667
  return `route:${route.id}:${timestamp.toString(36)}`;
1487
1668
  }
1488
- function buildExecuteOptions(options) {
1669
+ function buildExecuteOptions(options, client) {
1489
1670
  const execute = {};
1671
+ const retry = options.retry ?? client.defaults?.retry;
1672
+ const timeout = options.timeout ?? client.defaults?.timeout;
1490
1673
  if (options.signal !== void 0) execute.signal = options.signal;
1491
- if (options.retry !== void 0) execute.retry = options.retry;
1674
+ if (retry !== void 0) execute.retry = retry;
1492
1675
  if (options.onProgress !== void 0) execute.onProgress = options.onProgress;
1493
- if (options.timeout !== void 0) execute.timeout = options.timeout;
1676
+ if (timeout !== void 0) execute.timeout = timeout;
1494
1677
  if (options.bandwidthLimit !== void 0) execute.bandwidthLimit = options.bandwidthLimit;
1495
1678
  return execute;
1496
1679
  }
@@ -1547,41 +1730,6 @@ function defaultRouteSuffix(source, destination) {
1547
1730
  return `${source}->${destination}`;
1548
1731
  }
1549
1732
 
1550
- // src/logging/redaction.ts
1551
- var REDACTED = "[REDACTED]";
1552
- var SENSITIVE_KEY_PATTERN = /(?:password|passphrase|privatekey|token|secret|username|user)$/i;
1553
- var SECRET_COMMAND_PATTERN = /^(PASS|USER|ACCT)\s+(.+)$/i;
1554
- function isSensitiveKey(key) {
1555
- return SENSITIVE_KEY_PATTERN.test(key.replace(/[_-]/g, ""));
1556
- }
1557
- function redactCommand(command) {
1558
- return command.replace(SECRET_COMMAND_PATTERN, (_fullMatch, commandName) => {
1559
- return `${commandName.toUpperCase()} ${REDACTED}`;
1560
- });
1561
- }
1562
- function redactValue(value) {
1563
- if (typeof value === "string") {
1564
- return redactCommand(value);
1565
- }
1566
- if (Array.isArray(value)) {
1567
- return value.map((item) => redactValue(item));
1568
- }
1569
- if (value !== null && typeof value === "object") {
1570
- return redactObject(value);
1571
- }
1572
- return value;
1573
- }
1574
- function redactObject(input) {
1575
- return Object.fromEntries(
1576
- Object.entries(input).map(([key, value]) => {
1577
- if (isSensitiveKey(key)) {
1578
- return [key, REDACTED];
1579
- }
1580
- return [key, redactValue(value)];
1581
- })
1582
- );
1583
- }
1584
-
1585
1733
  // src/profiles/SecretSource.ts
1586
1734
  import { Buffer as Buffer2 } from "buffer";
1587
1735
  import { readFile } from "fs/promises";
@@ -1963,11 +2111,11 @@ import {
1963
2111
  import path from "path";
1964
2112
 
1965
2113
  // src/utils/path.ts
1966
- var UNSAFE_FTP_ARGUMENT_PATTERN = /[\r\n]/;
2114
+ var UNSAFE_FTP_ARGUMENT_PATTERN = /[\r\n\0]/;
1967
2115
  function assertSafeFtpArgument(value, label = "path") {
1968
2116
  if (UNSAFE_FTP_ARGUMENT_PATTERN.test(value)) {
1969
2117
  throw new ConfigurationError({
1970
- message: `Unsafe FTP ${label}: CR and LF characters are not allowed`,
2118
+ message: `Unsafe FTP ${label}: CR, LF, and NUL characters are not allowed`,
1971
2119
  retryable: false,
1972
2120
  details: {
1973
2121
  label
@@ -3269,7 +3417,6 @@ function expandAlgorithms(values) {
3269
3417
  }
3270
3418
 
3271
3419
  // src/profiles/importers/FileZillaImporter.ts
3272
- import { Buffer as Buffer5 } from "buffer";
3273
3420
  function importFileZillaSites(xml) {
3274
3421
  const events = tokenizeXml(xml);
3275
3422
  if (events.length === 0) {
@@ -3285,7 +3432,6 @@ function importFileZillaSites(xml) {
3285
3432
  const folderNamePending = [];
3286
3433
  let inServer = false;
3287
3434
  let serverFields = {};
3288
- let serverPasswordEncoding;
3289
3435
  let activeTag;
3290
3436
  let captureFolderName = false;
3291
3437
  for (const event of events) {
@@ -3298,13 +3444,9 @@ function importFileZillaSites(xml) {
3298
3444
  if (event.name === "Server") {
3299
3445
  inServer = true;
3300
3446
  serverFields = {};
3301
- serverPasswordEncoding = void 0;
3302
3447
  continue;
3303
3448
  }
3304
3449
  activeTag = event.name;
3305
- if (event.name === "Pass" && inServer) {
3306
- serverPasswordEncoding = event.attributes["encoding"];
3307
- }
3308
3450
  if (event.name === "Name" && !inServer && folderNamePending.length > 0) {
3309
3451
  captureFolderName = true;
3310
3452
  }
@@ -3330,7 +3472,7 @@ function importFileZillaSites(xml) {
3330
3472
  }
3331
3473
  if (event.name === "Server") {
3332
3474
  const folder = folderStack.filter((segment) => segment !== "");
3333
- const result = buildSiteFromFields(serverFields, serverPasswordEncoding);
3475
+ const result = buildSiteFromFields(serverFields);
3334
3476
  if (result.kind === "site") {
3335
3477
  sites.push({ ...result.site, folder });
3336
3478
  } else {
@@ -3342,7 +3484,6 @@ function importFileZillaSites(xml) {
3342
3484
  }
3343
3485
  inServer = false;
3344
3486
  serverFields = {};
3345
- serverPasswordEncoding = void 0;
3346
3487
  activeTag = void 0;
3347
3488
  continue;
3348
3489
  }
@@ -3351,7 +3492,7 @@ function importFileZillaSites(xml) {
3351
3492
  }
3352
3493
  return { sites, skipped };
3353
3494
  }
3354
- function buildSiteFromFields(fields, passwordEncoding) {
3495
+ function buildSiteFromFields(fields) {
3355
3496
  const name = (fields["Name"] ?? fields["Host"] ?? "Untitled").trim();
3356
3497
  const host = (fields["Host"] ?? "").trim();
3357
3498
  if (host === "") return { kind: "skipped", name };
@@ -3370,18 +3511,9 @@ function buildSiteFromFields(fields, passwordEncoding) {
3370
3511
  }
3371
3512
  const user = fields["User"]?.trim();
3372
3513
  if (user !== void 0 && user !== "") profile.username = { value: user };
3373
- let password;
3374
3514
  const rawPass = fields["Pass"];
3375
- if (rawPass !== void 0 && rawPass !== "") {
3376
- if (passwordEncoding === "base64") {
3377
- password = Buffer5.from(rawPass, "base64").toString("utf8");
3378
- } else {
3379
- password = rawPass;
3380
- }
3381
- if (password !== void 0 && password !== "") profile.password = { value: password };
3382
- }
3383
- const site = { name, profile };
3384
- if (password !== void 0) site.password = password;
3515
+ const hasStoredPassword = rawPass !== void 0 && rawPass !== "";
3516
+ const site = { hasStoredPassword, name, profile };
3385
3517
  const logonText = fields["Logontype"];
3386
3518
  if (logonText !== void 0) {
3387
3519
  const logonType = Number.parseInt(logonText.trim(), 10);
@@ -3624,6 +3756,62 @@ function mapFtp550(details) {
3624
3756
  return new PermissionDeniedError(details);
3625
3757
  }
3626
3758
 
3759
+ // src/transfers/createDefaultRetryPolicy.ts
3760
+ var DEFAULT_MAX_ATTEMPTS = 4;
3761
+ var DEFAULT_BASE_DELAY_MS = 250;
3762
+ var DEFAULT_MAX_DELAY_MS = 3e4;
3763
+ var DEFAULT_MAX_ELAPSED_MS = 3e5;
3764
+ function createDefaultRetryPolicy(options = {}) {
3765
+ const maxAttempts = normalizePositiveInteger(options.maxAttempts, DEFAULT_MAX_ATTEMPTS);
3766
+ const baseDelayMs = normalizeNonNegative(options.baseDelayMs, DEFAULT_BASE_DELAY_MS);
3767
+ const maxDelayMs = normalizeNonNegative(options.maxDelayMs, DEFAULT_MAX_DELAY_MS);
3768
+ const maxElapsedMs = normalizeNonNegative(options.maxElapsedMs, DEFAULT_MAX_ELAPSED_MS);
3769
+ const random = options.random ?? Math.random;
3770
+ return {
3771
+ getDelayMs(input) {
3772
+ const retryAfterMs = readRetryAfterMs(input.error);
3773
+ if (retryAfterMs !== void 0) {
3774
+ return retryAfterMs;
3775
+ }
3776
+ const exponentialMs = baseDelayMs * 2 ** (input.attempt - 1);
3777
+ const cappedMs = Math.min(maxDelayMs, exponentialMs);
3778
+ return Math.floor(random() * cappedMs);
3779
+ },
3780
+ maxAttempts,
3781
+ shouldRetry(input) {
3782
+ if (!(input.error instanceof ZeroTransferError) || !input.error.retryable) {
3783
+ return false;
3784
+ }
3785
+ if (input.elapsedMs >= maxElapsedMs) {
3786
+ return false;
3787
+ }
3788
+ const retryAfterMs = readRetryAfterMs(input.error);
3789
+ if (retryAfterMs !== void 0 && input.elapsedMs + retryAfterMs > maxElapsedMs) {
3790
+ return false;
3791
+ }
3792
+ return true;
3793
+ }
3794
+ };
3795
+ }
3796
+ function readRetryAfterMs(error) {
3797
+ if (!(error instanceof ZeroTransferError)) return void 0;
3798
+ const value = error.details?.["retryAfterMs"];
3799
+ if (typeof value !== "number" || !Number.isFinite(value) || value < 0) return void 0;
3800
+ return Math.floor(value);
3801
+ }
3802
+ function normalizePositiveInteger(value, fallback) {
3803
+ if (value === void 0 || !Number.isFinite(value) || value < 1) {
3804
+ return fallback;
3805
+ }
3806
+ return Math.floor(value);
3807
+ }
3808
+ function normalizeNonNegative(value, fallback) {
3809
+ if (value === void 0 || !Number.isFinite(value) || value < 0) {
3810
+ return fallback;
3811
+ }
3812
+ return Math.floor(value);
3813
+ }
3814
+
3627
3815
  // src/transfers/TransferPlan.ts
3628
3816
  function createTransferPlan(input) {
3629
3817
  const plan = {
@@ -3721,8 +3909,8 @@ var TransferQueue = class {
3721
3909
  this.concurrency = normalizeConcurrency(options.concurrency);
3722
3910
  this.defaultExecutor = options.executor;
3723
3911
  this.resolveExecutor = options.resolveExecutor;
3724
- this.retry = options.retry;
3725
- this.timeout = options.timeout;
3912
+ this.retry = options.retry ?? options.client?.defaults?.retry;
3913
+ this.timeout = options.timeout ?? options.client?.defaults?.timeout;
3726
3914
  this.bandwidthLimit = options.bandwidthLimit;
3727
3915
  this.onProgress = options.onProgress;
3728
3916
  this.onReceipt = options.onReceipt;
@@ -4799,10 +4987,30 @@ function isMainModule(importMetaUrl) {
4799
4987
  }
4800
4988
 
4801
4989
  // src/providers/web/WebDavProvider.ts
4802
- import { Buffer as Buffer7 } from "buffer";
4990
+ import { Buffer as Buffer6 } from "buffer";
4803
4991
 
4804
4992
  // src/providers/web/httpInternals.ts
4805
- import { Buffer as Buffer6 } from "buffer";
4993
+ import { Buffer as Buffer5 } from "buffer";
4994
+ function assertHttpsEnforced(input) {
4995
+ if (input.enforceHttps && !input.secure) {
4996
+ throw new ConfigurationError({
4997
+ details: { provider: input.providerId },
4998
+ message: `Provider "${input.providerId}" is configured with enforceHttps but its transport is cleartext http; set secure: true (or drop enforceHttps to explicitly accept cleartext)`,
4999
+ retryable: false
5000
+ });
5001
+ }
5002
+ }
5003
+ var cleartextWarnedKeys = /* @__PURE__ */ new Set();
5004
+ function warnCleartextCredentials(input) {
5005
+ if (!input.hasCredentials) return;
5006
+ const key = `${input.providerId}:${input.host}`;
5007
+ if (cleartextWarnedKeys.has(key)) return;
5008
+ cleartextWarnedKeys.add(key);
5009
+ process.emitWarning(
5010
+ `Provider "${input.providerId}" is sending credentials to ${input.host} over cleartext http; use https or set enforceHttps to block this`,
5011
+ { code: "ZERO_TRANSFER_CLEARTEXT_CREDENTIALS", type: "SecurityWarning" }
5012
+ );
5013
+ }
4806
5014
  function buildBaseUrl(profile, options) {
4807
5015
  const protocol = options.secure ? "https:" : "http:";
4808
5016
  const portSegment = profile.port !== void 0 ? `:${profile.port}` : "";
@@ -4850,18 +5058,19 @@ async function dispatchRequest(options, url, init) {
4850
5058
  signal: controller.signal
4851
5059
  });
4852
5060
  } catch (error) {
5061
+ const safeUrl = redactUrlForLogging(url);
4853
5062
  if (controller.signal.aborted && upstreamSignal?.aborted !== true) {
4854
5063
  throw new TimeoutError({
4855
5064
  cause: error,
4856
- details: { timeoutMs: options.timeoutMs, url: url.toString() },
4857
- message: `HTTP request to ${url.toString()} timed out after ${String(options.timeoutMs)}ms`,
5065
+ details: { timeoutMs: options.timeoutMs, url: safeUrl },
5066
+ message: `HTTP request to ${safeUrl} timed out after ${String(options.timeoutMs)}ms`,
4858
5067
  retryable: true
4859
5068
  });
4860
5069
  }
4861
5070
  throw new ConnectionError({
4862
5071
  cause: error,
4863
- details: { url: url.toString() },
4864
- message: `HTTP request to ${url.toString()} failed`,
5072
+ details: { url: safeUrl },
5073
+ message: `HTTP request to ${safeUrl} failed`,
4865
5074
  retryable: true
4866
5075
  });
4867
5076
  } finally {
@@ -4893,8 +5102,48 @@ function formatRangeHeader(offset, length) {
4893
5102
  const end = offset + length - 1;
4894
5103
  return `bytes=${String(offset)}-${String(end)}`;
4895
5104
  }
4896
- function mapResponseError(response, path2) {
4897
- const details = { path: path2, status: response.status, statusText: response.statusText };
5105
+ var ERROR_BODY_EXCERPT_LIMIT = 2048;
5106
+ async function readErrorBodyExcerpt(response) {
5107
+ try {
5108
+ const text = await response.text();
5109
+ if (text.length === 0) return void 0;
5110
+ return text.length > ERROR_BODY_EXCERPT_LIMIT ? `${text.slice(0, ERROR_BODY_EXCERPT_LIMIT)}... [truncated]` : text;
5111
+ } catch {
5112
+ return void 0;
5113
+ }
5114
+ }
5115
+ function parseRetryAfterMs(value, now = Date.now) {
5116
+ if (value === null) return void 0;
5117
+ const trimmed = value.trim();
5118
+ if (trimmed.length === 0) return void 0;
5119
+ if (/^\d+$/.test(trimmed)) {
5120
+ const seconds = Number.parseInt(trimmed, 10);
5121
+ return Number.isFinite(seconds) ? seconds * 1e3 : void 0;
5122
+ }
5123
+ if (!/[A-Za-z]/.test(trimmed)) return void 0;
5124
+ const retryAt = Date.parse(trimmed);
5125
+ if (Number.isNaN(retryAt)) return void 0;
5126
+ return Math.max(0, retryAt - now());
5127
+ }
5128
+ async function mapResponseErrorWithBody(response, path2) {
5129
+ return mapResponseError(response, path2, await readErrorBodyExcerpt(response));
5130
+ }
5131
+ function mapResponseError(response, path2, bodyExcerpt) {
5132
+ const details = {
5133
+ path: path2,
5134
+ status: response.status,
5135
+ statusText: response.statusText
5136
+ };
5137
+ if (bodyExcerpt !== void 0) details["body"] = bodyExcerpt;
5138
+ if (response.status === 429 || response.status === 503) {
5139
+ const retryAfterMs = parseRetryAfterMs(response.headers.get("retry-after"));
5140
+ if (retryAfterMs !== void 0) details["retryAfterMs"] = retryAfterMs;
5141
+ return new ConnectionError({
5142
+ details,
5143
+ message: response.status === 429 ? `HTTP request for ${path2} was rate limited (429)` : `HTTP service unavailable for ${path2} (503)`,
5144
+ retryable: true
5145
+ });
5146
+ }
4898
5147
  if (response.status === 401) {
4899
5148
  return new AuthenticationError({
4900
5149
  details,
@@ -4926,18 +5175,58 @@ async function* webStreamToAsyncIterable(body) {
4926
5175
  const reader = body.getReader();
4927
5176
  try {
4928
5177
  while (true) {
4929
- const { done, value } = await reader.read();
4930
- if (done) break;
4931
- if (value !== void 0) yield value;
5178
+ let result;
5179
+ try {
5180
+ result = await reader.read();
5181
+ } catch (error) {
5182
+ if (error instanceof ZeroTransferError) throw error;
5183
+ throw new ConnectionError({
5184
+ cause: error,
5185
+ message: "HTTP response stream was interrupted before completion",
5186
+ retryable: true
5187
+ });
5188
+ }
5189
+ if (result.done) break;
5190
+ if (result.value !== void 0) yield result.value;
4932
5191
  }
4933
5192
  } finally {
4934
5193
  reader.releaseLock();
4935
5194
  }
4936
5195
  }
5196
+ function asyncIterableToReadableStream(source, onChunk) {
5197
+ const iterator = source[Symbol.asyncIterator]();
5198
+ return new ReadableStream({
5199
+ async pull(controller) {
5200
+ try {
5201
+ const next = await iterator.next();
5202
+ if (next.done === true) {
5203
+ controller.close();
5204
+ return;
5205
+ }
5206
+ const chunk = next.value;
5207
+ if (chunk.byteLength === 0) {
5208
+ return;
5209
+ }
5210
+ controller.enqueue(chunk);
5211
+ onChunk(chunk);
5212
+ } catch (error) {
5213
+ controller.error(error);
5214
+ }
5215
+ },
5216
+ async cancel(reason) {
5217
+ if (typeof iterator.return === "function") {
5218
+ try {
5219
+ await iterator.return(reason);
5220
+ } catch {
5221
+ }
5222
+ }
5223
+ }
5224
+ });
5225
+ }
4937
5226
  function secretToString(value) {
4938
5227
  if (typeof value === "string") return value;
4939
- if (value instanceof Uint8Array || Buffer6.isBuffer(value)) {
4940
- return Buffer6.from(value).toString("utf8");
5228
+ if (value instanceof Uint8Array || Buffer5.isBuffer(value)) {
5229
+ return Buffer5.from(value).toString("utf8");
4941
5230
  }
4942
5231
  return String(value);
4943
5232
  }
@@ -4949,7 +5238,8 @@ function createWebDavProviderFactory(options = {}) {
4949
5238
  const secure = options.secure ?? false;
4950
5239
  const basePath = options.basePath ?? "";
4951
5240
  const fetchImpl = options.fetch ?? globalThis.fetch;
4952
- const uploadStreaming = options.uploadStreaming ?? "when-known-size";
5241
+ const uploadStreaming = options.uploadStreaming ?? "always";
5242
+ assertHttpsEnforced({ enforceHttps: options.enforceHttps ?? false, providerId: id, secure });
4953
5243
  if (typeof fetchImpl !== "function") {
4954
5244
  throw new ConfigurationError({
4955
5245
  message: "Global fetch is unavailable; supply WebDavProviderOptions.fetch explicitly",
@@ -5001,13 +5291,20 @@ var WebDavProvider = class {
5001
5291
  id;
5002
5292
  capabilities;
5003
5293
  async connect(profile) {
5294
+ if (!this.internals.secure) {
5295
+ warnCleartextCredentials({
5296
+ hasCredentials: profile.username !== void 0 || profile.password !== void 0,
5297
+ host: profile.host,
5298
+ providerId: this.internals.id
5299
+ });
5300
+ }
5004
5301
  const headers = { ...this.internals.defaultHeaders };
5005
5302
  if (profile.username !== void 0) {
5006
5303
  const username = await resolveSecret(profile.username);
5007
5304
  const password = profile.password !== void 0 ? await resolveSecret(profile.password) : "";
5008
5305
  const usernameText = secretToString(username);
5009
5306
  const passwordText = secretToString(password);
5010
- headers["Authorization"] = `Basic ${Buffer7.from(`${usernameText}:${passwordText}`).toString(
5307
+ headers["Authorization"] = `Basic ${Buffer6.from(`${usernameText}:${passwordText}`).toString(
5011
5308
  "base64"
5012
5309
  )}`;
5013
5310
  }
@@ -5055,7 +5352,7 @@ var WebDavFileSystem = class {
5055
5352
  method: "PROPFIND"
5056
5353
  });
5057
5354
  if (!response.ok && response.status !== 207) {
5058
- throw mapResponseError(response, normalized);
5355
+ throw await mapResponseErrorWithBody(response, normalized);
5059
5356
  }
5060
5357
  const body = await response.text();
5061
5358
  const entries = parsePropfindResponses(body, this.options.baseUrl);
@@ -5069,7 +5366,7 @@ var WebDavFileSystem = class {
5069
5366
  method: "PROPFIND"
5070
5367
  });
5071
5368
  if (!response.ok && response.status !== 207) {
5072
- throw mapResponseError(response, normalized);
5369
+ throw await mapResponseErrorWithBody(response, normalized);
5073
5370
  }
5074
5371
  const body = await response.text();
5075
5372
  const entries = parsePropfindResponses(body, this.options.baseUrl);
@@ -5114,12 +5411,12 @@ var WebDavTransferOperations = class {
5114
5411
  if (request.signal !== void 0) init.signal = request.signal;
5115
5412
  const response = await dispatchRequest(this.options, url, init);
5116
5413
  if (!response.ok && response.status !== 206) {
5117
- throw mapResponseError(response, normalized);
5414
+ throw await mapResponseErrorWithBody(response, normalized);
5118
5415
  }
5119
5416
  const body = response.body;
5120
5417
  if (body === null) {
5121
5418
  throw new ConnectionError({
5122
- message: `WebDAV response had no body for ${url.toString()}`,
5419
+ message: `WebDAV response had no body for ${redactUrlForLogging(url)}`,
5123
5420
  retryable: true
5124
5421
  });
5125
5422
  }
@@ -5163,7 +5460,7 @@ var WebDavTransferOperations = class {
5163
5460
  if (request.signal !== void 0) init2.signal = request.signal;
5164
5461
  const response2 = await dispatchRequest(this.options, url, init2);
5165
5462
  if (!response2.ok) {
5166
- throw mapResponseError(response2, normalized);
5463
+ throw await mapResponseErrorWithBody(response2, normalized);
5167
5464
  }
5168
5465
  request.reportProgress(buffered.byteLength, buffered.byteLength);
5169
5466
  const result2 = {
@@ -5199,7 +5496,7 @@ var WebDavTransferOperations = class {
5199
5496
  if (request.signal !== void 0) init.signal = request.signal;
5200
5497
  const response = await dispatchRequest(this.options, url, init);
5201
5498
  if (!response.ok) {
5202
- throw mapResponseError(response, normalized);
5499
+ throw await mapResponseErrorWithBody(response, normalized);
5203
5500
  }
5204
5501
  const result = {
5205
5502
  bytesTransferred,
@@ -5225,36 +5522,6 @@ async function collectChunks(source) {
5225
5522
  }
5226
5523
  return out;
5227
5524
  }
5228
- function asyncIterableToReadableStream(source, onChunk) {
5229
- const iterator = source[Symbol.asyncIterator]();
5230
- return new ReadableStream({
5231
- async pull(controller) {
5232
- try {
5233
- const next = await iterator.next();
5234
- if (next.done === true) {
5235
- controller.close();
5236
- return;
5237
- }
5238
- const chunk = next.value;
5239
- if (chunk.byteLength === 0) {
5240
- return;
5241
- }
5242
- controller.enqueue(chunk);
5243
- onChunk(chunk);
5244
- } catch (error) {
5245
- controller.error(error);
5246
- }
5247
- },
5248
- async cancel(reason) {
5249
- if (typeof iterator.return === "function") {
5250
- try {
5251
- await iterator.return(reason);
5252
- } catch {
5253
- }
5254
- }
5255
- }
5256
- });
5257
- }
5258
5525
  function parsePropfindResponses(xml, baseUrl) {
5259
5526
  const entries = [];
5260
5527
  const responseRegex = /<(?:[a-zA-Z0-9-]+:)?response\b[^>]*>([\s\S]*?)<\/(?:[a-zA-Z0-9-]+:)?response>/gi;
@@ -5364,6 +5631,7 @@ export {
5364
5631
  copyBetween,
5365
5632
  createAtomicDeployPlan,
5366
5633
  createBandwidthThrottle,
5634
+ createDefaultRetryPolicy,
5367
5635
  createLocalProviderFactory,
5368
5636
  createMemoryProviderFactory,
5369
5637
  createOAuthTokenSecretSource,
@@ -5400,8 +5668,10 @@ export {
5400
5668
  parseRemoteManifest,
5401
5669
  redactCommand,
5402
5670
  redactConnectionProfile,
5671
+ redactErrorForLogging,
5403
5672
  redactObject,
5404
5673
  redactSecretSource,
5674
+ redactUrlForLogging,
5405
5675
  redactValue,
5406
5676
  resolveConnectionProfileSecrets,
5407
5677
  resolveOpenSshHost,