@dpuse/dpuse-development 0.3.811 → 0.3.812

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.
@@ -280,34 +280,63 @@ async function Ie(e) {
280
280
  async function Le(e, t, r) {
281
281
  x(`${e} Insert licenses into 'README.md'`);
282
282
  let [i, a] = await Promise.all([c("licenses/licenses.json"), c("licenses/licenseTree.json")]), o = /* @__PURE__ */ new Map();
283
- for (let [e, t] of Object.entries(i)) o.set(e, Ve(e, t));
283
+ for (let [e, t] of Object.entries(i)) o.set(e, We(e, t));
284
284
  await Promise.all(o.values().map(async (e) => {
285
- let t = await He(e.name, e.installedVersion);
285
+ let t = await Ge(e.name, e.installedVersion);
286
286
  e.latestVersion = t.latestVersion, e.latestPublishedDate = t.latestPublishedDate, e.publishedDate = t.publishedDate;
287
287
  }));
288
- let s = `${ze(t)}\n\n|Dependency|Version|License(s)|Document|\n|:-|:-:|:-|:-|\n`;
289
- for (let e of o.values()) s += Ue(e);
288
+ let s = `${He(t)}\n\n|Dependency|Version|License(s)|Document|\n|:-|:-:|:-|:-|\n`;
289
+ for (let e of o.values()) s += Ke(e);
290
290
  let l = [];
291
- a.dependencies != null && We(a.dependencies, o, r, l, 0);
291
+ a.dependencies != null && qe(a.dependencies, o, r, l, 0);
292
292
  let u = `${Pe}\n\n${l.join("\n")}`;
293
293
  await n(`${M}\n\n${s.trimEnd()}\n\n### Dependency Tree\n\n${u}`, A, j);
294
294
  }
295
295
  async function Re() {
296
- let e = await i("package-lock.json"), t = e === null ? {} : JSON.parse(e).packages ?? {}, n = /* @__PURE__ */ new Set(), r = /* @__PURE__ */ new Set();
296
+ let e = await i("package-lock.json"), t = e === null ? {} : JSON.parse(e).packages ?? {}, n = ze(t), r = /* @__PURE__ */ new Set(), a = /* @__PURE__ */ new Set();
297
297
  for (let [e, i] of Object.entries(t)) {
298
298
  if (e === "" || i.version === void 0) continue;
299
299
  let t = `${i.name ?? e.slice(e.lastIndexOf("node_modules/") + 13)}@${i.version}`;
300
- i.dev === !0 || i.devOptional === !0 ? r.add(t) : n.add(t);
300
+ n.has(e) ? r.add(t) : a.add(t);
301
301
  }
302
- return r.values().filter((e) => !n.has(e)).toArray();
302
+ return a.values().filter((e) => !r.has(e)).toArray();
303
303
  }
304
304
  function ze(e) {
305
- return `License data is updated each time \`npm run document\` is run, using [license-checker](https://github.com/RSeidelsohn/license-checker-rseidelsohn). The following table lists all production dependencies. These dependencies (including transitive ones) have been checked and confirmed to use ${Be(e.split(";"))}, all of which allow commercial use. All are used unmodified, so any licence conditions that apply only to modified versions are not triggered. These checks cover the dependencies of the published library; developers cloning this repository should independently verify development dependencies.`;
305
+ let t = /* @__PURE__ */ new Set(), n = [""];
306
+ for (; n.length > 0;) {
307
+ let r = n.pop() ?? "", i = e[r];
308
+ if (i !== void 0) for (let a of Be(i)) {
309
+ let i = Ve(e, r, a);
310
+ i === void 0 || t.has(i) || (t.add(i), n.push(i));
311
+ }
312
+ }
313
+ return t;
306
314
  }
307
315
  function Be(e) {
316
+ let t = Object.keys(e.peerDependencies ?? {}).filter((t) => e.peerDependenciesMeta?.[t]?.optional !== !0);
317
+ return [
318
+ ...Object.keys(e.dependencies ?? {}),
319
+ ...Object.keys(e.optionalDependencies ?? {}),
320
+ ...t
321
+ ];
322
+ }
323
+ function Ve(e, t, n) {
324
+ let r = t;
325
+ for (;;) {
326
+ let t = r === "" ? `node_modules/${n}` : `${r}/node_modules/${n}`, i = e[t];
327
+ if (i !== void 0) return i.link === !0 && i.resolved !== void 0 ? i.resolved : t;
328
+ if (r === "") return;
329
+ let a = r.lastIndexOf("/node_modules/");
330
+ r = a === -1 ? "" : r.slice(0, a);
331
+ }
332
+ }
333
+ function He(e) {
334
+ return `License data is updated each time \`npm run document\` is run, using [license-checker](https://github.com/RSeidelsohn/license-checker-rseidelsohn). The following table lists all production dependencies. These dependencies (including transitive ones) have been checked and confirmed to use ${Ue(e.split(";"))}, all of which allow commercial use. All are used unmodified, so any licence conditions that apply only to modified versions are not triggered. These checks cover the dependencies of the published library; developers cloning this repository should independently verify development dependencies.`;
335
+ }
336
+ function Ue(e) {
308
337
  return e.length === 1 ? e[0] ?? "" : e.length === 2 ? `${String(e[0])} or ${String(e[1])}` : `${e.slice(0, -1).join(", ")}, or ${String(e.at(-1))}`;
309
338
  }
310
- function Ve(e, t) {
339
+ function We(e, t) {
311
340
  let n = e.lastIndexOf("@"), r = n > 0 ? e.slice(0, n) : e, i = n > 0 ? e.slice(n + 1) : "";
312
341
  return {
313
342
  name: r,
@@ -321,7 +350,7 @@ function Ve(e, t) {
321
350
  ...t.licenseFile != null && { licenseFileLink: t.licenseFile }
322
351
  };
323
352
  }
324
- async function He(e, t) {
353
+ async function Ge(e, t) {
325
354
  try {
326
355
  let n = await fetch(`https://registry.npmjs.org/${encodeURIComponent(e)}`);
327
356
  if (n.ok) {
@@ -339,27 +368,27 @@ async function He(e, t) {
339
368
  publishedDate: ""
340
369
  };
341
370
  }
342
- function Ue(e) {
371
+ function Ke(e) {
343
372
  let t = e.licenseFileLink == null || e.licenseFileLink === "" ? "⚠️ No license file" : `[LICENSE](licenses/${e.licenseFileLink})`;
344
373
  return `|[${e.name}](${e.repository})|${e.installedVersion}|${e.licenseTypes}|${t}|\n`;
345
374
  }
346
- function We(e, t, n, r, i) {
375
+ function qe(e, t, n, r, i) {
347
376
  let a = " ".repeat(i);
348
377
  for (let [o, s] of Object.entries(e)) {
349
378
  let e = s.version ?? "";
350
379
  if (n.has(`${o}@${e}`)) continue;
351
- let c = t.get(`${o}@${e}`), l = c == null ? o : `[${o}](${c.repository})`, u = Ge(c);
352
- r.push(`${a}- **${l}** ${e}${u}`), s.dependencies != null && We(s.dependencies, t, n, r, i + 1);
380
+ let c = t.get(`${o}@${e}`), l = c == null ? o : `[${o}](${c.repository})`, u = Je(c);
381
+ r.push(`${a}- **${l}** ${e}${u}`), s.dependencies != null && qe(s.dependencies, t, n, r, i + 1);
353
382
  }
354
383
  }
355
- function Ge(e) {
384
+ function Je(e) {
356
385
  if (e == null) return "";
357
- let t = e.publishedDate ? Ke(e.publishedDate.split("T", 1)[0]) : "";
386
+ let t = e.publishedDate ? Ye(e.publishedDate.split("T", 1)[0]) : "";
358
387
  if (e.latestVersion === "" || e.latestVersion === e.installedVersion) return t === "" ? "" : ` — ${t}`;
359
- let n = e.latestPublishedDate ? Ke(e.latestPublishedDate.split("T", 1)[0]) : "", r = n === "" ? `**latest**: ${e.latestVersion} ❗` : `**latest**: ${e.latestVersion} — ${n} ❗`;
388
+ let n = e.latestPublishedDate ? Ye(e.latestPublishedDate.split("T", 1)[0]) : "", r = n === "" ? `**latest**: ${e.latestVersion} ❗` : `**latest**: ${e.latestVersion} — ${n} ❗`;
360
389
  return t === "" ? ` — → ${r}` : ` — ${t} → ${r}`;
361
390
  }
362
- function Ke(e) {
391
+ function Ye(e) {
363
392
  if (e == null || e === "") return "n/a";
364
393
  let t = e.split("T", 1)[0];
365
394
  if (t == null || t === "") return "n/a";
@@ -368,31 +397,31 @@ function Ke(e) {
368
397
  }
369
398
  //#endregion
370
399
  //#region src/actions/documentOpening.ts
371
- var qe = "<!-- OPENING_START -->", Je = "<!-- OPENING_END -->";
372
- async function Ye() {
400
+ var Xe = "<!-- OPENING_START -->", Ze = "<!-- OPENING_END -->";
401
+ async function Qe() {
373
402
  try {
374
403
  f("Document Opening"), x("1️⃣ Insert opening content into 'README.md'");
375
- let e = await c("package.json"), r = await c("config.json"), { owner: i, repo: a } = t(e, "document opening"), s = Xe(e), l = Qe(r), u = $e(i, a, s, _(r.id).publishedTo === "npm" ? Ze(e) : void 0, e.description, l);
376
- await n(u, qe, Je), o("Opening documented");
404
+ let e = await c("package.json"), r = await c("config.json"), { owner: i, repo: a } = t(e, "document opening"), s = $e(e), l = tt(r), u = nt(i, a, s, _(r.id).publishedTo === "npm" ? et(e) : void 0, e.description, l);
405
+ await n(u, Xe, Ze), o("Opening documented");
377
406
  } catch (e) {
378
407
  console.error("❌ Error documenting opening", e), process.exit(1);
379
408
  }
380
409
  }
381
- function Xe(e) {
410
+ function $e(e) {
382
411
  let t = e.license;
383
412
  if (t == null || t === "") throw Error("package.json 'license' field is required to document opening.");
384
413
  return t;
385
414
  }
386
- function Ze(e) {
415
+ function et(e) {
387
416
  let t = e.name;
388
417
  if (t == null || t === "") throw Error("package.json 'name' field is required to document opening.");
389
418
  return t;
390
419
  }
391
- function Qe(e) {
420
+ function tt(e) {
392
421
  let t = e.description.en?.trim();
393
422
  return t === void 0 || t === "" ? void 0 : t;
394
423
  }
395
- function $e(e, t, n, r, i, a) {
424
+ function nt(e, t, n, r, i, a) {
396
425
  let o = `https://github.com/${e}/${t}`;
397
426
  return `[![License: ${n}](https://img.shields.io/badge/License-${n.replaceAll("-", "--")}-blue.svg)](./LICENSE)
398
427
  [![DPUse version](https://img.shields.io/github/v/release/${e}/${t}?color=f6821f&label=DPUse)](${o}/releases/latest)${r === void 0 ? "" : `\n[![npm version](https://img.shields.io/npm/v/${r}?color=cb3837&label=npm)](https://www.npmjs.com/package/${r})`}
@@ -414,31 +443,31 @@ In addition, DPUse provides [Tools](https://www.dpuse.app) used by the applicati
414
443
  }
415
444
  //#endregion
416
445
  //#region src/actions/documentQualitySecurity.ts
417
- var et = {
446
+ var rt = {
418
447
  "Branch-Protection": 3,
419
448
  "Code-Review": 0,
420
449
  Contributors: 0
421
- }, tt = /* @__PURE__ */ new Set(["CII-Best-Practices"]), nt = "coverage/coverage-final.json", rt = "coverage/coverage-summary.json", N = 80, it = 60, P = "code-health-reports/vitest/badge.json", at = {
450
+ }, it = /* @__PURE__ */ new Set(["CII-Best-Practices"]), at = "coverage/coverage-final.json", ot = "coverage/coverage-summary.json", N = 80, st = 60, P = "code-health-reports/vitest/badge.json", ct = {
422
451
  actions: "GitHub Actions",
423
452
  "javascript-typescript": "JavaScript/TypeScript",
424
453
  rust: "Rust"
425
- }, ot = {
454
+ }, lt = {
426
455
  A: "brightgreen",
427
456
  B: "green",
428
457
  C: "yellow",
429
458
  D: "orange",
430
459
  F: "red"
431
- }, F = `${m}/health.json`, st = ae(oe);
432
- async function ct() {
460
+ }, F = `${m}/health.json`, ut = ae(oe);
461
+ async function dt() {
433
462
  try {
434
463
  f("Document Quality & Security");
435
- let e = await c("package.json"), r = await lt(e), i = await dt(e, r === void 0 ? [] : ["--coverage", nt]), { owner: a, repo: s } = t(e, "document quality and security");
464
+ let e = await c("package.json"), r = await ft(e), i = await mt(e, r === void 0 ? [] : ["--coverage", at]), { owner: a, repo: s } = t(e, "document quality and security");
436
465
  x("4️⃣ Read security checks and settings");
437
- let l = await pt(a, s, e);
466
+ let l = await gt(a, s, e);
438
467
  x("5️⃣ Look up OpenSSF Best Practices badge and Scorecard results");
439
- let [u, d] = await Promise.all([mt(`https://github.com/${a}/${s}`), ht(`github.com/${a}/${s}`)]);
468
+ let [u, d] = await Promise.all([_t(`https://github.com/${a}/${s}`), vt(`github.com/${a}/${s}`)]);
440
469
  x("6️⃣ Insert quality and security content into 'README.md'");
441
- let p = vt(a, s, {
470
+ let p = xt(a, s, {
442
471
  coveragePercent: r,
443
472
  fallowHealth: i,
444
473
  securitySettings: l
@@ -448,7 +477,7 @@ async function ct() {
448
477
  console.error("❌ Error documenting quality and security", e), process.exit(1);
449
478
  }
450
479
  }
451
- async function lt(e) {
480
+ async function ft(e) {
452
481
  if (e.devDependencies?.["@vitest/coverage-v8"] == null) {
453
482
  x("1️⃣ Test coverage NOT measured, as '@vitest/coverage-v8' is not installed");
454
483
  return;
@@ -458,17 +487,17 @@ async function lt(e) {
458
487
  "--passWithNoTests",
459
488
  "--coverage"
460
489
  ]);
461
- let t = await i(rt);
490
+ let t = await i(ot);
462
491
  if (t === null) return;
463
492
  let n = JSON.parse(t).total.lines.pct;
464
- return await ut(n), n;
493
+ return await pt(n), n;
465
494
  }
466
- async function ut(e) {
495
+ async function pt(e) {
467
496
  let t = [
468
497
  "red",
469
498
  "yellow",
470
499
  "brightgreen"
471
- ], n = Number(e >= it) + Number(e >= N);
500
+ ], n = Number(e >= st) + Number(e >= N);
472
501
  await r(P, {
473
502
  schemaVersion: 1,
474
503
  label: "coverage",
@@ -476,7 +505,7 @@ async function ut(e) {
476
505
  color: t[n]
477
506
  });
478
507
  }
479
- async function dt(e, t) {
508
+ async function mt(e, t) {
480
509
  if (e.devDependencies?.fallow == null) {
481
510
  x("2️⃣ Code health NOT measured, as Fallow is not installed"), x("3️⃣ Code health report NOT required");
482
511
  return;
@@ -489,18 +518,18 @@ async function dt(e, t) {
489
518
  ...t
490
519
  ], F), await a("3️⃣ Write code health report", "fallow", ["--format", "markdown"], s, !0);
491
520
  let n = await c(F);
492
- return await ft(n), n;
521
+ return await ht(n), n;
493
522
  }
494
- async function ft(e) {
523
+ async function ht(e) {
495
524
  let { score: t, grade: n } = e.health_score;
496
525
  await r(y, {
497
526
  schemaVersion: 1,
498
527
  label: "fallow",
499
528
  message: `${n} (${String(Math.round(t))})`,
500
- color: ot[n] ?? "lightgrey"
529
+ color: lt[n] ?? "lightgrey"
501
530
  });
502
531
  }
503
- async function pt(e, t, n) {
532
+ async function gt(e, t, n) {
504
533
  let [r, a, o, s] = await Promise.all([
505
534
  i(".github/workflows/ci.yml"),
506
535
  i(".github/workflows/codeql.yml"),
@@ -513,7 +542,7 @@ async function pt(e, t, n) {
513
542
  I(`repos/${e}/${t}/commits/main/check-runs?per_page=100`)
514
543
  ]), p = c === void 0 ? void 0 : JSON.parse(c).security_and_analysis, m = (e) => p?.[e] === void 0 ? void 0 : p[e].status === "enabled", h = new Set((f === void 0 ? [] : JSON.parse(f).check_runs).map((e) => e.app?.slug)), g = o?.match(/package-ecosystem:/g)?.length ?? 0, _ = o?.match(/open-pull-requests-limit: 0\b/g)?.length ?? 0;
515
544
  return {
516
- codeQLLanguages: (a ?? "").matchAll(/- language: ([\w-]+)/g).filter(([, e]) => e !== "rust" || s !== null).map(([, e = ""]) => at[e] ?? e).toArray(),
545
+ codeQLLanguages: (a ?? "").matchAll(/- language: ([\w-]+)/g).filter(([, e]) => e !== "rust" || s !== null).map(([, e = ""]) => ct[e] ?? e).toArray(),
517
546
  codeQLQueries: /queries: ([\w-]+)/.exec(a ?? "")?.[1],
518
547
  dependabotAlerts: d !== void 0,
519
548
  dependabotSecurityUpdates: m("dependabot_security_updates"),
@@ -532,27 +561,27 @@ async function pt(e, t, n) {
532
561
  }
533
562
  async function I(e) {
534
563
  try {
535
- let { stdout: t } = await st("gh", ["api", e]);
564
+ let { stdout: t } = await ut("gh", ["api", e]);
536
565
  return t;
537
566
  } catch (e) {
538
567
  if (String(e.stderr).includes("HTTP 404")) return;
539
568
  throw e;
540
569
  }
541
570
  }
542
- async function mt(e) {
571
+ async function _t(e) {
543
572
  let t = await fetch(`https://www.bestpractices.dev/projects.json?url=${encodeURIComponent(e)}`);
544
573
  if (!t.ok) throw Error(`OpenSSF Best Practices lookup failed with status ${String(t.status)}.`);
545
574
  return (await t.json()).find((t) => t.repo_url === e)?.id;
546
575
  }
547
- async function ht(e) {
576
+ async function vt(e) {
548
577
  let t = await fetch(`https://api.scorecard.dev/projects/${e}`);
549
578
  if (t.status !== 404) {
550
579
  if (!t.ok) throw Error(`OpenSSF Scorecard lookup failed with status ${String(t.status)}.`);
551
580
  return await t.json();
552
581
  }
553
582
  }
554
- function gt(e) {
555
- return e.checks.every(({ name: e, score: t }) => t === -1 || t === 10 || tt.has(e) || et[e] !== void 0 && t >= et[e]);
583
+ function yt(e) {
584
+ return e.checks.every(({ name: e, score: t }) => t === -1 || t === 10 || it.has(e) || rt[e] !== void 0 && t >= rt[e]);
556
585
  }
557
586
  function L(e) {
558
587
  return e === !1 ? " These are handled manually." : "";
@@ -572,7 +601,7 @@ ${t.map((e) => `|${e.join("|")}|`).join("\n")}
572
601
  function B(e, t, n, r) {
573
602
  return `![${n}](https://img.shields.io/endpoint?url=${encodeURIComponent(`https://raw.githubusercontent.com/${e}/${t}/main/${r}`)})`;
574
603
  }
575
- function _t(e, t, { coveragePercent: n, fallowHealth: r, securitySettings: i }) {
604
+ function bt(e, t, { coveragePercent: n, fallowHealth: r, securitySettings: i }) {
576
605
  let a = `https://github.com/${e}/${t}`, o = (e) => e ? ` Part of the [CI workflow](${a}/actions/workflows/ci.yml) on every push and pull request to \`main\`.` : "", c = [[
577
606
  "Unit tests",
578
607
  R(i.testsInCI),
@@ -648,11 +677,11 @@ function _t(e, t, { coveragePercent: n, fallowHealth: r, securitySettings: i })
648
677
 
649
678
  ${z("Testing", c)}${z("Code Quality", u)}${z("Security Analysis", h)}${z("Dependencies", _)}`;
650
679
  }
651
- function vt(e, t, n, r, i) {
652
- let a = `https://github.com/${e}/${t}`, o = `github.com/${e}/${t}`, s = `https://www.bestpractices.dev/projects/${String(r)}`, c = i !== void 0 && gt(i) ? "\n\n> [!NOTE]\n> Apart from the Best Practices badge above, the remaining Scorecard gaps need multi-person review or a pull-request workflow, which this solo-maintained project doesn't use." : "", l = r === void 0 ? "" : `[![OpenSSF Best Practices](${s}/badge)](${s})\n`, u = n.securitySettings.privateVulnerabilityReporting === !0 ? `Use [GitHub private vulnerability reporting](${a}/security/advisories/new) instead. See [SECURITY.md](./SECURITY.md) for the full disclosure policy, contact details, and expected response times.` : "See [SECURITY.md](./SECURITY.md) for how to report one privately, the full disclosure policy, and expected response times.";
680
+ function xt(e, t, n, r, i) {
681
+ let a = `https://github.com/${e}/${t}`, o = `github.com/${e}/${t}`, s = `https://www.bestpractices.dev/projects/${String(r)}`, c = i !== void 0 && yt(i) ? "\n\n> [!NOTE]\n> Apart from the Best Practices badge above, the remaining Scorecard gaps need multi-person review or a pull-request workflow, which this solo-maintained project doesn't use." : "", l = r === void 0 ? "" : `[![OpenSSF Best Practices](${s}/badge)](${s})\n`, u = n.securitySettings.privateVulnerabilityReporting === !0 ? `Use [GitHub private vulnerability reporting](${a}/security/advisories/new) instead. See [SECURITY.md](./SECURITY.md) for the full disclosure policy, contact details, and expected response times.` : "See [SECURITY.md](./SECURITY.md) for how to report one privately, the full disclosure policy, and expected response times.";
653
682
  return `## Quality & Security
654
683
 
655
- ${_t(e, t, n)}### OpenSSF 🚧
684
+ ${bt(e, t, n)}### OpenSSF 🚧
656
685
 
657
686
  ${l}[![OpenSSF Scorecard](https://api.scorecard.dev/projects/${o}/badge)](https://scorecard.dev/viewer/?uri=${o})
658
687
 
@@ -664,26 +693,26 @@ Please do not open public GitHub issues for security vulnerabilities. ${u}`;
664
693
  }
665
694
  //#endregion
666
695
  //#region src/actions/documentUsage.ts
667
- var yt = "<!-- USAGE_START -->", bt = "<!-- USAGE_END -->", xt = /* @__PURE__ */ new Set([
696
+ var St = "<!-- USAGE_START -->", Ct = "<!-- USAGE_END -->", wt = /* @__PURE__ */ new Set([
668
697
  "connector",
669
698
  "cookbook",
670
699
  "presenter"
671
- ]), St = /* @__PURE__ */ new Set(["development", "eslint"]), Ct = "> [!WARNING]\n> This project is not designed for general use. It is custom built for the DPUse CI/CD process. You are welcome to clone and customise it for your own purposes, but you will need to adapt it to your own project structure and tooling.", wt = "This repository manages itself using the actions it implements.", Tt = "This repository is managed using the common set of actions provided by [@dpuse/dpuse-development](https://github.com/dpuse/dpuse-development).";
672
- async function Et() {
700
+ ]), Tt = /* @__PURE__ */ new Set(["development", "eslint"]), Et = "> [!WARNING]\n> This project is not designed for general use. It is custom built for the DPUse CI/CD process. You are welcome to clone and customise it for your own purposes, but you will need to adapt it to your own project structure and tooling.", Dt = "This repository manages itself using the actions it implements.", Ot = "This repository is managed using the common set of actions provided by [@dpuse/dpuse-development](https://github.com/dpuse/dpuse-development).";
701
+ async function kt() {
673
702
  try {
674
703
  f("Document Usage"), x("1️⃣ Insert usage content into 'README.md'");
675
- let [e, t] = await Promise.all([c("package.json"), c("config.json")]), r = Dt(e), i = Ot(r), a = V(e.engines?.node), s = V(e.engines?.npm), l = V(e.devDependencies?.typescript), u = kt(_(t.id), e.name), d = `${r.replace(/\.git$/, "")}/blob/main/package.json`, p = At(u, r, i, a, s, l, `${e.name === "@dpuse/dpuse-development" ? wt : Tt} See the \`scripts\` block in [package.json](${d}) for details.`);
676
- await n(p, yt, bt), o("Usage documented");
704
+ let [e, t] = await Promise.all([c("package.json"), c("config.json")]), r = At(e), i = jt(r), a = V(e.engines?.node), s = V(e.engines?.npm), l = V(e.devDependencies?.typescript), u = Mt(_(t.id), e.name), d = `${r.replace(/\.git$/, "")}/blob/main/package.json`, p = Nt(u, r, i, a, s, l, `${e.name === "@dpuse/dpuse-development" ? Dt : Ot} See the \`scripts\` block in [package.json](${d}) for details.`);
705
+ await n(p, St, Ct), o("Usage documented");
677
706
  } catch (e) {
678
707
  console.error("❌ Error documenting usage", e), process.exit(1);
679
708
  }
680
709
  }
681
- function Dt(e) {
710
+ function At(e) {
682
711
  let t = e.repository, n = typeof t == "string" ? t : t?.url;
683
712
  if (n == null || n === "") throw Error("package.json 'repository' field is required to document usage.");
684
713
  return n.replace(/^git\+/, "");
685
714
  }
686
- function Ot(e) {
715
+ function jt(e) {
687
716
  return (e.split("/").at(-1) ?? "").replace(/\.git$/, "");
688
717
  }
689
718
  function V(e) {
@@ -692,9 +721,9 @@ function V(e) {
692
721
  if (t == null) throw Error(`Unable to parse version from '${e}'.`);
693
722
  return t[0];
694
723
  }
695
- function kt(e, t) {
724
+ function Mt(e, t) {
696
725
  let { typeId: n } = e;
697
- if (xt.has(n)) return `This ${n} is automatically uploaded to the DPUse Engine cloud once released and becomes instantly available to all new browser app instances, with existing instances notified of the update.
726
+ if (wt.has(n)) return `This ${n} is automatically uploaded to the DPUse Engine cloud once released and becomes instantly available to all new browser app instances, with existing instances notified of the update.
698
727
 
699
728
  You may view or clone this repository for your own purposes, such as building a new, similar ${n}, though there is currently no process to accept third-party ${n}s into DPUse at this stage.`;
700
729
  if (e.publishedTo === "npm") {
@@ -705,11 +734,11 @@ You may view or clone this repository for your own purposes, such as building a
705
734
  npm install ${t}
706
735
  \`\`\`
707
736
 
708
- ${St.has(n) ? `${Ct}\n\n` : ""}To work on the source instead, clone this repository.`;
737
+ ${Tt.has(n) ? `${Et}\n\n` : ""}To work on the source instead, clone this repository.`;
709
738
  }
710
739
  return "You may view or clone this repository for your own purposes.";
711
740
  }
712
- function At(e, t, n, r, i, a, o) {
741
+ function Nt(e, t, n, r, i, a, o) {
713
742
  return `## Usage
714
743
 
715
744
  ${e}
@@ -727,7 +756,7 @@ ${o}`;
727
756
  //#endregion
728
757
  //#region src/actions/documentApiReference.ts
729
758
  var H = "API_REFERENCE.md";
730
- async function jt() {
759
+ async function Pt() {
731
760
  try {
732
761
  f("Document API Reference");
733
762
  let { writeAPIReference: e } = await import("./apiReference-Fj5_02JP.js");
@@ -738,90 +767,90 @@ async function jt() {
738
767
  }
739
768
  //#endregion
740
769
  //#region src/actions/documentBundleSizes.ts
741
- var U = "bundle-analysis-reports/sonda/index.json", Mt = "<!-- BUNDLE_START -->", Nt = "<!-- BUNDLE_END -->", W = "&nbsp;&nbsp;&nbsp;&nbsp;", G = 20, K = "█", q = "▒", Pt = 100 / G / 2, Ft = 100 / G, It = "This report is updated with each release, from the bundle the release builds, using [Sonda](https://sonda.dev/), which analyses final source maps to reveal the actual effects of tree-shaking and minification rather than relying on pre-build estimates.\n\n_Note: Sonda's Vite reports currently exclude CSS files, since Vite does not generate source maps for CSS._", J = "Bars show each row's share of its output file.", Lt = "↳ rows are part of the row above.", Y = "(bundler output, whitespace & JSON)", Rt = `${Y} = bytes Sonda can't trace to a source file: whitespace (indentation and line breaks), code the bundler generates (region comments, the combined import/export lines, its small runtime helper and wrappers), and imported JSON such as \`config.json\`, which the bundler doesn't map. The JSON and the generated code are real bytes that ship; the whitespace mostly disappears once compressed.`;
742
- async function zt(e) {
770
+ var U = "bundle-analysis-reports/sonda/index.json", Ft = "<!-- BUNDLE_START -->", It = "<!-- BUNDLE_END -->", W = "&nbsp;&nbsp;&nbsp;&nbsp;", G = 20, K = "█", q = "▒", Lt = 100 / G / 2, Rt = 100 / G, zt = "This report is updated with each release, from the bundle the release builds, using [Sonda](https://sonda.dev/), which analyses final source maps to reveal the actual effects of tree-shaking and minification rather than relying on pre-build estimates.\n\n_Note: Sonda's Vite reports currently exclude CSS files, since Vite does not generate source maps for CSS._", J = "Bars show each row's share of its output file.", Bt = "↳ rows are part of the row above.", Y = "(bundler output, whitespace & JSON)", Vt = `${Y} = bytes Sonda can't trace to a source file: whitespace (indentation and line breaks), code the bundler generates (region comments, the combined import/export lines, its small runtime helper and wrappers), and imported JSON such as \`config.json\`, which the bundler doesn't map. The JSON and the generated code are real bytes that ship; the whitespace mostly disappears once compressed.`;
771
+ async function Ht(e) {
743
772
  try {
744
773
  f("Document Bundle Sizes"), x("1️⃣ Read bundle analysis report");
745
774
  let t = await c(U);
746
775
  x("2️⃣ Insert table into 'README.md'");
747
- let r = Bt(t, e?.moduleLevel ?? !1), i = r.includes("↳") ? `${J} ${Lt}` : J;
748
- await n(`## Bundle Analysis\n\n${It}\n\n${r}\n\n${i}\n\n${Rt}`, Mt, Nt), o("Bundle sizes documented");
776
+ let r = Ut(t, e?.moduleLevel ?? !1), i = r.includes("↳") ? `${J} ${Bt}` : J;
777
+ await n(`## Bundle Analysis\n\n${zt}\n\n${r}\n\n${i}\n\n${Vt}`, Ft, It), o("Bundle sizes documented");
749
778
  } catch (e) {
750
779
  console.error("❌ Error documenting bundle sizes", e), process.exit(1);
751
780
  }
752
781
  }
753
- function Bt(e, t) {
754
- let n = qt(e), r = n.values().flatMap((e) => e.values().toArray()).reduce((e, t) => e + t.sizes.uncompressed, 0), i = e.resources.filter((e) => e.kind === "asset").map((e) => [e.name, Q(e)]).toSorted((e, t) => t[1].uncompressed - e[1].uncompressed), a = ["|Chunk/Module/File|Composition|", "|:------ |:-----------|"];
782
+ function Ut(e, t) {
783
+ let n = Xt(e), r = n.values().flatMap((e) => e.values().toArray()).reduce((e, t) => e + t.sizes.uncompressed, 0), i = e.resources.filter((e) => e.kind === "asset").map((e) => [e.name, Q(e)]).toSorted((e, t) => t[1].uncompressed - e[1].uncompressed), a = ["|Chunk/Module/File|Composition|", "|:------ |:-----------|"];
755
784
  for (let [e, o] of i) {
756
- let i = [...n.get(e) ?? /* @__PURE__ */ new Map()].toSorted(Vt), s = i.reduce((e, [, t]) => e + t.sizes.uncompressed, 0), c = s > 0 && r > 0 ? ` · ${tn(s, r)} of the build` : "";
757
- a.push(`| **${e}** | ${Zt(o)}${c} |`, ...Ht(i, s, t));
785
+ let i = [...n.get(e) ?? /* @__PURE__ */ new Map()].toSorted(Wt), s = i.reduce((e, [, t]) => e + t.sizes.uncompressed, 0), c = s > 0 && r > 0 ? ` · ${an(s, r)} of the build` : "";
786
+ a.push(`| **${e}** | ${en(o)}${c} |`, ...Gt(i, s, t));
758
787
  }
759
788
  return a.join("\n");
760
789
  }
761
- function Vt(e, t) {
790
+ function Wt(e, t) {
762
791
  return e[0] === Y == (t[0] === Y) ? t[1].sizes.uncompressed - e[1].sizes.uncompressed : e[0] === Y ? 1 : -1;
763
792
  }
764
- function Ht(e, t, n) {
793
+ function Gt(e, t, n) {
765
794
  let r = [];
766
795
  for (let [i, { sizes: a, files: o }] of e) {
767
796
  if (o.size === 1) {
768
- let e = Kt(o);
769
- r.push(`| ${W}${Gt(i, e)} | ${X(a.uncompressed, t)} |`);
797
+ let e = Yt(o);
798
+ r.push(`| ${W}${Jt(i, e)} | ${X(a.uncompressed, t)} |`);
770
799
  continue;
771
800
  }
772
- r.push(`| ${W}${i} | ${X(a.uncompressed, t)} |`), n || r.push(...Ut(o, t));
801
+ r.push(`| ${W}${i} | ${X(a.uncompressed, t)} |`), n || r.push(...Kt(o, t));
773
802
  }
774
803
  return r;
775
804
  }
776
- function Ut(e, t) {
777
- let n = [...e].toSorted((e, t) => t[1].uncompressed - e[1].uncompressed), r = Wt(n, t), i = (r > 0 ? n.slice(0, -r) : n).map(([e, n]) => `| ${W}${W}↳ ${e} | ${X(n.uncompressed, t, q)} |`);
805
+ function Kt(e, t) {
806
+ let n = [...e].toSorted((e, t) => t[1].uncompressed - e[1].uncompressed), r = qt(n, t), i = (r > 0 ? n.slice(0, -r) : n).map(([e, n]) => `| ${W}${W}↳ ${e} | ${X(n.uncompressed, t, q)} |`);
778
807
  if (r > 0) {
779
808
  let e = n.slice(-r).reduce((e, [, t]) => e + t.uncompressed, 0);
780
809
  i.push(`| ${W}${W}↳ ${String(r)} smaller files | ${X(e, t, q)} |`);
781
810
  }
782
811
  return i;
783
812
  }
784
- function Wt(e, t) {
813
+ function qt(e, t) {
785
814
  if (t <= 0) return 0;
786
815
  let n = 0, r = 0;
787
816
  for (let [, i] of e.toReversed()) {
788
- let e = i.uncompressed / t * 100 < Pt, a = (r + i.uncompressed) / t * 100 <= Ft;
817
+ let e = i.uncompressed / t * 100 < Lt, a = (r + i.uncompressed) / t * 100 <= Rt;
789
818
  if (!e || !a) break;
790
819
  n++, r += i.uncompressed;
791
820
  }
792
821
  return n >= 2 ? n : 0;
793
822
  }
794
823
  function X(e, t, n = K) {
795
- return `${Qt(t > 0 ? e / t * 100 : 0, n)} · ${$(e)}`;
824
+ return `${tn(t > 0 ? e / t * 100 : 0, n)} · ${$(e)}`;
796
825
  }
797
- function Gt(e, t) {
826
+ function Jt(e, t) {
798
827
  return t === "" ? e : `${e} → ${t}`;
799
828
  }
800
- function Kt(e) {
829
+ function Yt(e) {
801
830
  let [t] = e.keys();
802
831
  if (t === void 0) throw Error("Expected exactly one file");
803
832
  return t;
804
833
  }
805
- function qt(e) {
806
- let t = Jt(e.dependencies), n = /* @__PURE__ */ new Map();
834
+ function Xt(e) {
835
+ let t = Zt(e.dependencies), n = /* @__PURE__ */ new Map();
807
836
  for (let r of e.resources) {
808
837
  if (r.kind !== "chunk" || !r.parent) continue;
809
- let { group: e, file: i } = Yt(r.name, t), a = Q(r), o = n.get(r.parent) ?? /* @__PURE__ */ new Map();
838
+ let { group: e, file: i } = Qt(r.name, t), a = Q(r), o = n.get(r.parent) ?? /* @__PURE__ */ new Map();
810
839
  n.set(r.parent, o);
811
840
  let s = o.get(e) ?? {
812
- sizes: $t(),
841
+ sizes: nn(),
813
842
  files: /* @__PURE__ */ new Map()
814
843
  };
815
- o.set(e, s), en(s.sizes, a);
816
- let c = s.files.get(i) ?? $t();
817
- s.files.set(i, c), en(c, a);
844
+ o.set(e, s), rn(s.sizes, a);
845
+ let c = s.files.get(i) ?? nn();
846
+ s.files.set(i, c), rn(c, a);
818
847
  }
819
848
  return n;
820
849
  }
821
- function Jt(e) {
850
+ function Zt(e) {
822
851
  return e.flatMap((e) => e.paths.map((t) => [t, e.name])).toSorted((e, t) => t[0].length - e[0].length);
823
852
  }
824
- function Yt(e, t) {
853
+ function Qt(e, t) {
825
854
  let n = t.find(([t]) => e === t || e.startsWith(`${t}/`));
826
855
  if (n) {
827
856
  let [t, r] = n;
@@ -838,13 +867,13 @@ function Yt(e, t) {
838
867
  file: e.slice(1)
839
868
  } : e.startsWith("rust/") ? {
840
869
  group: "wasm",
841
- file: Xt(e)
870
+ file: $t(e)
842
871
  } : {
843
872
  group: "src",
844
873
  file: Z(e)
845
874
  };
846
875
  }
847
- function Xt(e) {
876
+ function $t(e) {
848
877
  let t = e.split("/", 2)[1] ?? "", n = Z(e);
849
878
  return t !== "" && n.startsWith(t) ? `…${n.slice(t.length)}` : n;
850
879
  }
@@ -857,23 +886,23 @@ function Q(e) {
857
886
  gzip: e.gzip ?? 0
858
887
  };
859
888
  }
860
- function Zt(e) {
889
+ function en(e) {
861
890
  return `${$(e.uncompressed)} · gzip ${$(e.gzip)}`;
862
891
  }
863
- function Qt(e, t = K) {
892
+ function tn(e, t = K) {
864
893
  let n = Math.round(e / 100 * G);
865
894
  return `\`${t.repeat(n)}${"░".repeat(G - n)}\` ${e.toFixed(1)}%`;
866
895
  }
867
- function $t() {
896
+ function nn() {
868
897
  return {
869
898
  uncompressed: 0,
870
899
  gzip: 0
871
900
  };
872
901
  }
873
- function en(e, t) {
902
+ function rn(e, t) {
874
903
  e.uncompressed += t.uncompressed, e.gzip += t.gzip;
875
904
  }
876
- function tn(e, t) {
905
+ function an(e, t) {
877
906
  return `${(e / t * 100).toFixed(1)}%`;
878
907
  }
879
908
  function $(e) {
@@ -881,12 +910,12 @@ function $(e) {
881
910
  }
882
911
  //#endregion
883
912
  //#region src/actions/documentProject.ts
884
- async function nn(e = "MIT", t = !1) {
913
+ async function on(e = "MIT", t = !1) {
885
914
  try {
886
915
  let n = await c("config.json"), r = _(n.id).typeId === "connector";
887
- await Ye(), r && await ke(), await Et(), await Fe(e), await i("bundle-analysis-reports/sonda/index.json") === null ? x(`ℹ️ Bundle sizes NOT documented, as there is no '${U}' yet. Build the project first.`) : await zt({ moduleLevel: t }), await ct(), await Ae();
916
+ await Qe(), r && await ke(), await kt(), await Fe(e), await i("bundle-analysis-reports/sonda/index.json") === null ? x(`ℹ️ Bundle sizes NOT documented, as there is no '${U}' yet. Build the project first.`) : await Ht({ moduleLevel: t }), await dt(), await Ae();
888
917
  let a = await i(H) !== null;
889
- a ? await jt() : x(`ℹ️ '${H}' NOT required by this project`), await S("ℹ️ Format generated files", "prettier", [
918
+ a ? await Pt() : x(`ℹ️ '${H}' NOT required by this project`), await S("ℹ️ Format generated files", "prettier", [
890
919
  "--write",
891
920
  "README.md",
892
921
  ...a ? [H] : []
@@ -897,7 +926,7 @@ async function nn(e = "MIT", t = !1) {
897
926
  }
898
927
  //#endregion
899
928
  //#region src/actions/formatCode.ts
900
- async function rn() {
929
+ async function sn() {
901
930
  try {
902
931
  f("Format Code");
903
932
  let e = [
@@ -918,7 +947,7 @@ async function rn() {
918
947
  }
919
948
  //#endregion
920
949
  //#region src/actions/lintCode.ts
921
- async function an() {
950
+ async function cn() {
922
951
  try {
923
952
  f("Lint Code"), await S("1️⃣ Lint", "eslint", ["."]), o("Code linted");
924
953
  } catch (e) {
@@ -927,7 +956,7 @@ async function an() {
927
956
  }
928
957
  //#endregion
929
958
  //#region src/utilities/cloudflare.ts
930
- async function on() {
959
+ async function ln() {
931
960
  let e = await c("config.json"), t = {
932
961
  body: JSON.stringify(e),
933
962
  headers: { "Content-Type": "application/json" },
@@ -935,7 +964,7 @@ async function on() {
935
964
  }, n = await fetch(`https://api.dpuse.app/configs/${e.id}`, t);
936
965
  if (!n.ok) throw Error(await n.text());
937
966
  }
938
- async function sn(e, t) {
967
+ async function un(e, t) {
939
968
  async function n(e, t, r) {
940
969
  for (let i of r) {
941
970
  let r = `${e}/${i}`, a = `${t}/${i}`;
@@ -953,7 +982,7 @@ async function sn(e, t) {
953
982
  let r = await v(`${e}/${t}/`);
954
983
  await n(`${e}/${t}`, t, r);
955
984
  }
956
- async function cn(e) {
985
+ async function dn(e) {
957
986
  let t = e.id, n = {
958
987
  body: JSON.stringify(e),
959
988
  headers: { "Content-Type": "application/json" },
@@ -961,7 +990,7 @@ async function cn(e) {
961
990
  }, r = await fetch(`https://api.dpuse.app/configs/${t}`, n);
962
991
  if (!r.ok) throw Error(await r.text());
963
992
  }
964
- async function ln(e, t) {
993
+ async function fn(e, t) {
965
994
  let n = `v${e.version ?? "unknown"}`;
966
995
  async function r(e, r = "") {
967
996
  let i = await v(e, { withFileTypes: !0 });
@@ -985,34 +1014,34 @@ async function ln(e, t) {
985
1014
  }
986
1015
  //#endregion
987
1016
  //#region src/actions/publishProject.ts
988
- async function un() {
1017
+ async function pn() {
989
1018
  try {
990
1019
  f("Publish Project");
991
1020
  let e = await c("package.json"), t = await c("config.json"), n = _(t.id);
992
- n.publishedTo === "npm" ? await S("1️⃣ Publish to npm", "npm", ["publish", "--provenance"]) : x("1️⃣ Publishing to npm NOT required"), await dn("2️⃣ ", e, t, n), o(`Project version '${e.version ?? "unknown"}' published.`);
1021
+ n.publishedTo === "npm" ? await S("1️⃣ Publish to npm", "npm", ["publish", "--provenance"]) : x("1️⃣ Publishing to npm NOT required"), await mn("2️⃣ ", e, t, n), o(`Project version '${e.version ?? "unknown"}' published.`);
993
1022
  } catch (e) {
994
1023
  console.error("❌ Error publishing project", e), process.exit(1);
995
1024
  }
996
1025
  }
997
- async function dn(e, t, n, r) {
998
- if (r.typeId === "app") x(`${e} Register module`), await on();
999
- else if (r.typeId === "engine") x(`${e} Register module`), await ln(t, `dpuse-engine-eu/${r.uploadGroupName ?? "unknown"}`), await cn(n);
1026
+ async function mn(e, t, n, r) {
1027
+ if (r.typeId === "app") x(`${e} Register module`), await ln();
1028
+ else if (r.typeId === "engine") x(`${e} Register module`), await fn(t, `dpuse-engine-eu/${r.uploadGroupName ?? "unknown"}`), await dn(n);
1000
1029
  else if (r.uploadGroupName === void 0) x(`${e} Registration NOT required`);
1001
1030
  else {
1002
1031
  x(`${e} Register module`);
1003
1032
  let i = n.id.split("-").slice(2).join("-");
1004
- await ln(t, `dpuse-engine-eu/${r.uploadGroupName}/${i}`), await cn(n);
1033
+ await fn(t, `dpuse-engine-eu/${r.uploadGroupName}/${i}`), await dn(n);
1005
1034
  }
1006
1035
  }
1007
1036
  //#endregion
1008
1037
  //#region src/actions/releaseProject.ts
1009
- async function fn(e = "MIT", t = !1) {
1038
+ async function hn(e = "MIT", t = !1) {
1010
1039
  try {
1011
1040
  f("Release Project");
1012
1041
  let n = await c("package.json"), r = await c("config.json"), i = _(r.id);
1013
1042
  await b("1️⃣ ", n);
1014
1043
  let a = await g("2️⃣ ", n, i);
1015
- if (await D("3️⃣ ", n), x("4️⃣ Regenerate README"), await nn(e, t), await d("5️⃣ Stage changes", "git", ["add", "."]), await d("6️⃣ Commit changes", "git", [
1044
+ if (await D("3️⃣ ", n), x("4️⃣ Regenerate README"), await on(e, t), await d("5️⃣ Stage changes", "git", ["add", "."]), await d("6️⃣ Commit changes", "git", [
1016
1045
  "commit",
1017
1046
  "-m",
1018
1047
  `v${n.version ?? "unknown"}`
@@ -1020,7 +1049,7 @@ async function fn(e = "MIT", t = !1) {
1020
1049
  "push",
1021
1050
  "origin",
1022
1051
  "main:main"
1023
- ]), await dn("8️⃣ ", n, a, i), i.publishedTo === "npm") {
1052
+ ]), await mn("8️⃣ ", n, a, i), i.publishedTo === "npm") {
1024
1053
  let e = `v${n.version ?? "unknown"}`;
1025
1054
  await S("9️⃣ Create GitHub release", "gh", [
1026
1055
  "release",
@@ -1039,7 +1068,7 @@ async function fn(e = "MIT", t = !1) {
1039
1068
  }
1040
1069
  //#endregion
1041
1070
  //#region src/actions/syncProjectWithGitHub.ts
1042
- async function pn() {
1071
+ async function gn() {
1043
1072
  try {
1044
1073
  f("Synchronise Project with GitHub");
1045
1074
  let e = await c("package.json"), t = await c("config.json"), n = _(t.id);
@@ -1058,12 +1087,12 @@ async function pn() {
1058
1087
  }
1059
1088
  //#endregion
1060
1089
  //#region src/actions/testProject.ts
1061
- var mn = [
1090
+ var _n = [
1062
1091
  "1️⃣ ",
1063
1092
  "2️⃣ ",
1064
1093
  "3️⃣ ",
1065
1094
  "4️⃣ "
1066
- ], hn = [{
1095
+ ], vn = [{
1067
1096
  id: "unit",
1068
1097
  label: "Run unit tests",
1069
1098
  command: "vitest",
@@ -1076,13 +1105,13 @@ var mn = [
1076
1105
  arguments: ["test", "--pass-with-no-tests"],
1077
1106
  configFileName: "playwright.config.ts"
1078
1107
  }];
1079
- async function gn(e = ["unit"]) {
1108
+ async function yn(e = ["unit"]) {
1080
1109
  try {
1081
1110
  f("Test Project");
1082
1111
  let t = 0;
1083
- for (let n of hn) {
1112
+ for (let n of vn) {
1084
1113
  if (!e.includes(n.id) || await i(n.configFileName) === null) continue;
1085
- let r = `${mn[t] ?? ""} ${n.label}`;
1114
+ let r = `${_n[t] ?? ""} ${n.label}`;
1086
1115
  await S(r, n.command, n.arguments), t += 1;
1087
1116
  }
1088
1117
  if (t === 0) {
@@ -1095,4 +1124,4 @@ async function gn(e = ["unit"]) {
1095
1124
  }
1096
1125
  }
1097
1126
  //#endregion
1098
- export { ue as auditDependencies, de as buildProject, Ce as checkProject, nn as documentProject, rn as formatCode, an as lintCode, un as publishProject, fn as releaseProject, pn as syncProjectWithGitHub, gn as testProject, sn as uploadDirectoryToR2 };
1127
+ export { ue as auditDependencies, de as buildProject, Ce as checkProject, on as documentProject, sn as formatCode, cn as lintCode, pn as publishProject, hn as releaseProject, gn as syncProjectWithGitHub, yn as testProject, un as uploadDirectoryToR2 };