@noldova/desktop.build 0.0.2 → 0.0.3

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.
Files changed (56) hide show
  1. package/README.md +1 -1
  2. package/models/modules/module-declaration.js +29 -2
  3. package/models/modules/module-declaration.js.map +1 -1
  4. package/models/modules/web-view-keys.js +3 -0
  5. package/models/modules/web-view-keys.js.map +1 -1
  6. package/models/packaging/company-package.js +25 -8
  7. package/models/packaging/company-package.js.map +1 -1
  8. package/models/packaging/locked-package.js +28 -6
  9. package/models/packaging/locked-package.js.map +1 -1
  10. package/models/packaging/package-target.js +8 -4
  11. package/models/packaging/package-target.js.map +1 -1
  12. package/models/release/release-request.js +42 -2
  13. package/models/release/release-request.js.map +1 -1
  14. package/models/release/release-version.js +0 -8
  15. package/models/release/release-version.js.map +1 -1
  16. package/package.json +2 -2
  17. package/resources.js +133 -25
  18. package/resources.js.map +1 -1
  19. package/services/build-command-line.js +3 -2
  20. package/services/build-command-line.js.map +1 -1
  21. package/services/commands/module-range.js +21 -2
  22. package/services/commands/module-range.js.map +1 -1
  23. package/services/commands/package-smoke.js +6 -4
  24. package/services/commands/package-smoke.js.map +1 -1
  25. package/services/commands/package.js +7 -2
  26. package/services/commands/package.js.map +1 -1
  27. package/services/commands/release-assets.js +1 -1
  28. package/services/commands/release-assets.js.map +1 -1
  29. package/services/commands/release-check.js +18 -8
  30. package/services/commands/release-check.js.map +1 -1
  31. package/services/commands/release-publish.js +3 -3
  32. package/services/commands/release-publish.js.map +1 -1
  33. package/services/desktop/electron-binary.js +6 -2
  34. package/services/desktop/electron-binary.js.map +1 -1
  35. package/services/modules/module-artifacts.js +5 -1
  36. package/services/modules/module-artifacts.js.map +1 -1
  37. package/services/modules/module-catalog.js +15 -0
  38. package/services/modules/module-catalog.js.map +1 -1
  39. package/services/modules/module-web-views.js +18 -12
  40. package/services/modules/module-web-views.js.map +1 -1
  41. package/services/packages/addon-builder.js +7 -2
  42. package/services/packages/addon-builder.js.map +1 -1
  43. package/services/packaging/package-configuration.js +6 -3
  44. package/services/packaging/package-configuration.js.map +1 -1
  45. package/services/packaging/package-installer.js +2 -2
  46. package/services/packaging/package-installer.js.map +1 -1
  47. package/services/packaging/package-stage.js +15 -6
  48. package/services/packaging/package-stage.js.map +1 -1
  49. package/services/packaging/packaged-architecture.js +34 -11
  50. package/services/packaging/packaged-architecture.js.map +1 -1
  51. package/services/release/release-file-set.js +12 -10
  52. package/services/release/release-file-set.js.map +1 -1
  53. package/services/release/release-notes.js +9 -6
  54. package/services/release/release-notes.js.map +1 -1
  55. package/services/release/release-publisher.js +29 -21
  56. package/services/release/release-publisher.js.map +1 -1
package/resources.js CHANGED
@@ -89,6 +89,8 @@ export class Resources {
89
89
  static addonOutputFolder = "native";
90
90
  static addonExtension = ".node";
91
91
  static releaseAddonsVariable = "RELEASE_ADDONS";
92
+ static targetArchitectureVariable = "NOLDOVA_DESKTOP_ARCHITECTURE";
93
+ static electronArchitectureVariable = "npm_config_arch";
92
94
  static addonWindowsTargets = ["win32-x64", "win32-arm64"];
93
95
  static addonPosixTargets = ["linux-x64", "linux-arm64", "darwin-x64", "darwin-arm64"];
94
96
  static addonTargets = [...Resources.addonWindowsTargets, ...Resources.addonPosixTargets];
@@ -424,9 +426,8 @@ export class Resources {
424
426
  static stageNoticeSeparator = `\n${"-".repeat(Resources.stageNoticeRuleWidth)}\n\n`;
425
427
  static stageUnreachableRegistry = "http://127.0.0.1:9/";
426
428
  static stageOverridesInvalid = "The root package.json's overrides must be an object, as npm reads them.";
427
- static stageOverrideConflictMarker = "code EOVERRIDE";
428
- static stageOverrideAdvice = "\nThe stage installs each shipped package from its archive as a direct dependency, and npm refuses a top-level override of a direct dependency; "
429
- + "write the override nested under the dependent it is for, as { \"<dependent>\": { \"<package>\": \"<version>\" } }.";
429
+ static stageOverrideReferencePrefix = "$";
430
+ static stageOverrideSelfKey = ".";
430
431
  static stageInstallArguments = [
431
432
  "install", "--offline", "--no-save", "--no-package-lock", "--omit=dev", "--legacy-peer-deps", "--ignore-scripts", "--no-audit", "--no-fund", "--loglevel=error",
432
433
  `--registry=${Resources.stageUnreachableRegistry}`, "--cache"
@@ -435,7 +436,6 @@ export class Resources {
435
436
  static stageIconsRole = "the icons folder that desktop.product.icons names";
436
437
  static stageDictionariesRole = "the spelling dictionaries the window checks text with";
437
438
  static stageNoGallery = "The packaged window holds no Gallery.\n";
438
- static machHeaderLength = 8;
439
439
  static machCpuTypeOffset = 4;
440
440
  static machUniversalCountOffset = 4;
441
441
  static machThinMagic = 0xfeedfacf;
@@ -445,6 +445,21 @@ export class Resources {
445
445
  static machCpuTypes = { arm64: 0x0100000c, x64: 0x01000007 };
446
446
  static machUniversalFile = "a universal Mach-O file";
447
447
  static mach32BitFile = "a 32-bit Mach-O file";
448
+ static machKind = "Mach-O";
449
+ static peHeaderOffsetField = 0x3c;
450
+ static peSignatureLength = 6;
451
+ static peMachineOffset = 4;
452
+ static peMachines = { arm64: 0xaa64, x64: 0x8664 };
453
+ static peKind = "PE";
454
+ static elfClassOffset = 4;
455
+ static elf64BitClass = 2;
456
+ static elfDataOffset = 5;
457
+ static elfLittleEndianData = 1;
458
+ static elfMachineOffset = 18;
459
+ static elfMachines = { arm64: 183, x64: 62 };
460
+ static elfKind = "ELF";
461
+ static elf32BitFile = "a 32-bit ELF file";
462
+ static elfBigEndianFile = "a big-endian ELF file";
448
463
  static packagedBuildCommandLineName = "../build-command-line";
449
464
  static packagedBuildOptions = [Resources.buildCommand, "--packaged", "--output"];
450
465
  static packagedWindowFolder = "window";
@@ -693,6 +708,8 @@ export class Resources {
693
708
  static defaultField = "default";
694
709
  static keysField = "keys";
695
710
  static macKeysField = "macKeys";
711
+ static loadingKeysField = "loadingKeys";
712
+ static escapeKey = "Escape";
696
713
  static newWindowsField = "newWindows";
697
714
  static parametersField = "parameters";
698
715
  static valuesField = "values";
@@ -767,6 +784,8 @@ export class Resources {
767
784
  static moduleDisplayNameMissing = "must have a display name";
768
785
  static moduleDescriptionMissing = "must have a description";
769
786
  static moduleContributesNotObject = "must list its contributions as an object";
787
+ static moduleFormerNamesNotObject = "must give its former names as an object from a command's or a document's name to the names it had before";
788
+ static formerNamesField = "formerNames";
770
789
  static modulePlaceholderRepeated = "declares more than one placeholder, and a window shows one";
771
790
  static modulePlaceholderWithoutWindow = "declares a placeholder without a window part, which registers it";
772
791
  static moduleSettingsPagesWithoutWindow = "declares settings pages without a window part, which registers them";
@@ -905,7 +924,7 @@ export class Resources {
905
924
  "Network.setRequestInterception", "Network.continueInterceptedRequest"
906
925
  ];
907
926
  static webViewRefusedDomains = ["Target", "Browser", "Fetch", "Security"];
908
- static webViewFields = [Resources.methodsKind, Resources.eventsKind, Resources.keysField, Resources.newWindowsField];
927
+ static webViewFields = [Resources.methodsKind, Resources.eventsKind, Resources.keysField, Resources.newWindowsField, Resources.loadingKeysField];
909
928
  static webViewMethodFields = [Resources.nameField, Resources.parametersField];
910
929
  static webViewKeyFields = [Resources.nameField, Resources.keysField, Resources.macKeysField];
911
930
  static webViewRuleFields = [
@@ -913,11 +932,11 @@ export class Resources {
913
932
  ];
914
933
  static webViewStandardPlatforms = "Windows and Linux";
915
934
  static webViewMacPlatform = "macOS";
916
- static webViewFileInvalid = `must be an object with optional ${Resources.methodsKind}, ${Resources.eventsKind}, ${Resources.keysField} and ${Resources.newWindowsField}`;
935
+ static webViewFileInvalid = `must be an object with optional ${Resources.methodsKind}, ${Resources.eventsKind}, ${Resources.keysField}, ${Resources.newWindowsField} and ${Resources.loadingKeysField}`;
917
936
  static webViewMethodRepeated = "names a method more than once";
918
937
  static webViewEventsInvalid = "must list its events once each as a debugging protocol domain, a dot and a name, such as Page.loadEventFired";
919
938
  static webViewNewWindowsNotBoolean = `must say ${Resources.newWindowsField} as true or false`;
920
- static webViewKeysInvalid = `must name each of its keys once, with at most ${Resources.webViewKeysLimit} names`;
939
+ static webViewKeysInvalid = `must name each of its keys and loading keys once, with at most ${Resources.webViewKeysLimit} names in all`;
921
940
  static modulePackageFixturesFolder = `${Resources.moduleFixtureFolder}/packages`;
922
941
  static modulesSourceFolder = `${Resources.sourceFolder}/modules`;
923
942
  static angularCorePackage = "@angular/core";
@@ -1075,11 +1094,17 @@ export class Resources {
1075
1094
  static optionalTargetArchitecture = Resources.architectureArm64;
1076
1095
  static publishedVersionsVariable = "PUBLISHED_VERSIONS";
1077
1096
  static moduleRangeNoOutputFile = `${Resources.githubOutputVariable} names no file for the step's range and version outputs.`;
1097
+ static moduleRangeNoPin = `The root ${Resources.packageManifestFileName} pins no Noldova Desktop package to one exact version, the version a module builds and tests against.`;
1078
1098
  static moduleRangeNoPublished = `${Resources.publishedVersionsVariable} holds no list of versions as npm view's JSON gives it.`;
1079
1099
  static feedSkipVariable = "SKIP_FEED_CHECK";
1080
1100
  static feedVersionVariable = "FEED_VERSION";
1081
1101
  static feedUrlVariable = "FEED_URL";
1082
1102
  static releaseRepositoryVariable = "RELEASE_REPOSITORY";
1103
+ static releaseSourceRepositoryVariable = "RELEASE_SOURCE_REPOSITORY";
1104
+ static releaseBuildRepositoryVariable = "RELEASE_BUILD_REPOSITORY";
1105
+ static gitHubPrivateField = "private";
1106
+ static sourceRepositoryLabel = "the source repository";
1107
+ static releaseTagPrefixVariable = "RELEASE_TAG_PREFIX";
1083
1108
  static feedWaitVariable = "FEED_WAIT_SECONDS";
1084
1109
  static feedSkipValue = "true";
1085
1110
  static feedSkipValues = [String.empty, "false", Resources.feedSkipValue];
@@ -1344,6 +1369,7 @@ export class Resources {
1344
1369
  static manifestVersionField = "version";
1345
1370
  static manifestDependenciesField = "dependencies";
1346
1371
  static manifestOptionalDependenciesField = "optionalDependencies";
1372
+ static manifestDevDependenciesField = "devDependencies";
1347
1373
  static manifestFilesField = "files";
1348
1374
  static manifestExportsField = "exports";
1349
1375
  static manifestCommitField = "gitHead";
@@ -1542,6 +1568,8 @@ export class Resources {
1542
1568
  static lockedPackageVersion = /^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.+-]+)?$/;
1543
1569
  static lockResolvedField = "resolved";
1544
1570
  static lockInBundleField = "inBundle";
1571
+ static lockLinkField = "link";
1572
+ static ownArchiveFolder = /^(?:\.\.\/)*_packages$/u;
1545
1573
  static omittedOptionalsField = "omittedOptionals";
1546
1574
  static omittedOptionalsShape = `The root package.json's ${Resources.omittedOptionalsSection} must map each package, as <name>@<version>, to `
1547
1575
  + "{ \"dependencies\": [<optional dependency name>, ...], \"reason\": \"<why the app never loads them>\" }.";
@@ -1669,6 +1697,7 @@ export class Resources {
1669
1697
  static releaseRevisionPattern = /^[0-9a-f]{40}$/u;
1670
1698
  static releaseVersionPattern = /^(0|[1-9]\d{0,8})\.(0|[1-9]\d{0,8})\.(0|[1-9]\d{0,8})$/u;
1671
1699
  static releaseTagPrefix = "v";
1700
+ static releaseTagPrefixPattern = /^(?:v|[a-z0-9]+(?:-[a-z0-9]+)*-)$/u;
1672
1701
  static gitCommand = "git";
1673
1702
  static gitTimeout = 60_000;
1674
1703
  static successExitCodes = [0];
@@ -1788,7 +1817,7 @@ export class Resources {
1788
1817
  static formatStagePartsMissing(missing) {
1789
1818
  return `The stage needs ${missing.join(Resources.listSeparator)}, which is not a package under src/.`;
1790
1819
  }
1791
- static formatMachArchitectureUnknown(architecture, known) {
1820
+ static formatNativeArchitectureUnknown(architecture, known) {
1792
1821
  return `The package's architecture ${architecture} is none of ${known.join(Resources.listSeparator)}.`;
1793
1822
  }
1794
1823
  static formatPackagedModulesNotActive(problems) {
@@ -2185,15 +2214,21 @@ export class Resources {
2185
2214
  static formatStageLicensedPackage(id, license) {
2186
2215
  return `${id} (${license})`;
2187
2216
  }
2188
- static formatMachArchitectureMismatch(file, found, architecture) {
2189
- return `The installed ${file} is ${found}, not an ${architecture}-only Mach-O file, so it would not run natively on ${architecture}.`;
2217
+ static formatNativeArchitectureMismatch(file, found, kind, architecture) {
2218
+ return `The file ${file} is ${found}, not an ${architecture}-only ${kind} file, so it would not run natively on ${architecture}.`;
2190
2219
  }
2191
- static formatMachArchitectureVerified(application, count, architecture) {
2192
- return `Every Mach-O file in ${application}, ${count} in all, is ${architecture} alone.`;
2220
+ static formatNativeArchitectureVerified(folder, count, architecture) {
2221
+ return `Every Mach-O, PE and ELF file in ${folder}, ${count} in all, is ${architecture} alone.`;
2193
2222
  }
2194
2223
  static formatMachCpuType(type) {
2195
2224
  return `a Mach-O file for CPU type 0x${type.toString(16)}`;
2196
2225
  }
2226
+ static formatPeMachine(machine) {
2227
+ return `a PE file for machine 0x${machine.toString(16)}`;
2228
+ }
2229
+ static formatElfMachine(machine) {
2230
+ return `an ELF file for machine ${String(machine)}`;
2231
+ }
2197
2232
  static formatPackagedBuildFailed(exitCode) {
2198
2233
  return `The packaged build failed with exit code ${exitCode}.`;
2199
2234
  }
@@ -2585,11 +2620,11 @@ export class Resources {
2585
2620
  static formatWebViewKeyRepeated(platform) {
2586
2621
  return `gives a key more than once on ${platform}`;
2587
2622
  }
2588
- static formatWebViewKeyInvalid(index) {
2589
- return `must describe ${Resources.keysField}[${index}] with a name, its keys and optionally its macOS keys`;
2623
+ static formatWebViewKeyInvalid(field, index) {
2624
+ return `must describe ${field}[${index}] with a name, its keys and optionally its macOS keys`;
2590
2625
  }
2591
- static formatWebViewKeyNameInvalid(index) {
2592
- return `must name ${Resources.keysField}[${index}] with a lowercase letter followed by letters and digits`;
2626
+ static formatWebViewKeyNameInvalid(field, index) {
2627
+ return `must name ${field}[${index}] with a lowercase letter followed by letters and digits`;
2593
2628
  }
2594
2629
  static formatWebViewChordsInvalid(where) {
2595
2630
  return `must give ${where} one to ${Resources.webViewChordsLimit} keys`;
@@ -2598,7 +2633,7 @@ export class Resources {
2598
2633
  return `gives ${where} ${text}, which is not a key in Noldova Desktop's format, such as Mod+R or F5`;
2599
2634
  }
2600
2635
  static formatWebViewKeyRefused(where, text, platform) {
2601
- return `gives ${where} ${text}, which cannot be declared on ${platform}: it needs Mod, Ctrl or Alt, or a function key, and it must not be a key that editing, the operating system or Noldova Desktop holds`;
2636
+ return `gives ${where} ${text}, which cannot be declared on ${platform}: it needs Mod, Ctrl or Alt, or a function key, or is Escape among the loading keys, and it must not be a key that editing, the operating system or Noldova Desktop holds`;
2602
2637
  }
2603
2638
  static formatWebViewMethodInvalid(index) {
2604
2639
  return `must describe ${Resources.methodsKind}[${index}] with a name and optionally parameters`;
@@ -2651,6 +2686,21 @@ export class Resources {
2651
2686
  static formatCatalogPermissionsModuleInvalid(name) {
2652
2687
  return `The root ${Resources.packageManifestFileName}'s ${Resources.desktopField}.${Resources.productField}.${Resources.permissionsModuleField} must be the id of a module in ${Resources.modulesListSection}, not ${JSON.stringify(name)}.`;
2653
2688
  }
2689
+ static formatModuleFormerNamesUndeclared(name) {
2690
+ return `gives former names for "${name}", which isn't one of its commands or documents`;
2691
+ }
2692
+ static formatModuleFormerNamesInvalid(name) {
2693
+ return `must give "${name}" its former names as a list of different qualified names, such as "notes.add", none of them its own name`;
2694
+ }
2695
+ static formatModuleFormerNamesReserved(name, former) {
2696
+ return `gives "${name}" the former name "${former}", which belongs to the shell or a reserved id: ${Resources.moduleReservedIds.join(", ")}`;
2697
+ }
2698
+ static formatCatalogFormerNamesRepeated(repeated) {
2699
+ return `Former names repeat in the build, and a former name moves to one command or document: ${repeated.map(([name, files]) => Resources.formatNameInFile(name, files.join(", "))).join("; ")}.`;
2700
+ }
2701
+ static formatCatalogFormerNamesCurrent(current) {
2702
+ return `Former names are names a module contributes in the build: ${current.map(([name, files]) => Resources.formatNameInFile(name, files.join(", "))).join("; ")}.`;
2703
+ }
2654
2704
  static formatContributionPlace(file, kind) {
2655
2705
  return `${file} (${kind})`;
2656
2706
  }
@@ -2832,6 +2882,14 @@ export class Resources {
2832
2882
  static formatModuleRangeNotFollowing(file, range, minimum, following) {
2833
2883
  return `${file}'s ${Resources.noldovaDesktopField} is ${range}, but a range from ${minimum} ends below the next version that may break modules: ${following}.`;
2834
2884
  }
2885
+ static formatModuleRangePinNotExact(name, version) {
2886
+ return `The root ${Resources.packageManifestFileName} names ${name} at ${version}, not at one exact version; `
2887
+ + `a module pins each Noldova Desktop package to the exact version its range starts at, as MODULES.md's "Noldova Desktop versions" says.`;
2888
+ }
2889
+ static formatModuleRangeNotPin(file, range, name, pin) {
2890
+ return `${file}'s ${Resources.noldovaDesktopField} is ${range}, but the root ${Resources.packageManifestFileName} pins ${name} at ${pin}; `
2891
+ + `the range's lowest version is the module's exact development pin, as MODULES.md's "Noldova Desktop versions" says.`;
2892
+ }
2835
2893
  static formatModuleRangeNoneInside(file, range) {
2836
2894
  return `No published Noldova Desktop version is inside ${file}'s ${Resources.noldovaDesktopField} range ${range}.`;
2837
2895
  }
@@ -2900,7 +2958,11 @@ export class Resources {
2900
2958
  return `The packaged product file names the update feed ${JSON.stringify(feed ?? null)}, not ${expected}, so its packages cannot be released.`;
2901
2959
  }
2902
2960
  static formatReleaseCheckUsage(command) {
2903
- return `Usage: ${Resources.releaseRepositoryVariable}=<owner/name> ${Resources.releaseVersionVariable}=<N.N.N> ${Resources.releaseRevisionVariable}=<commit> ${command} ${Resources.releaseCheckCommand}\n`;
2961
+ return `Usage: ${Resources.releaseRepositoryVariable}=<owner/name> ${Resources.releaseVersionVariable}=<N.N.N> ${Resources.releaseRevisionVariable}=<commit> `
2962
+ + `${Resources.formatReleaseSourceOptions()} ${command} ${Resources.releaseCheckCommand}\n`;
2963
+ }
2964
+ static formatReleaseSourceOptions() {
2965
+ return `[${Resources.releaseSourceRepositoryVariable}=<owner/name>] [${Resources.releaseBuildRepositoryVariable}=<owner/name>] [${Resources.releaseTagPrefixVariable}=<prefix>]`;
2904
2966
  }
2905
2967
  static formatRootVersionMismatch(rootVersion, version) {
2906
2968
  return `The root manifest's version is ${rootVersion}, not ${version}; raise it on ${Resources.mainBranch} first.`;
@@ -2935,7 +2997,7 @@ export class Resources {
2935
2997
  }
2936
2998
  static formatReleasePublishUsage(command) {
2937
2999
  return `Usage: ${Resources.releaseRepositoryVariable}=<owner/name> ${Resources.releaseVersionVariable}=<N.N.N> ${Resources.releaseRevisionVariable}=<commit> ${Resources.releaseFolderVariable}=<folder> `
2938
- + `${Resources.releaseReportsVariable}=<folder> ${Resources.releaseRunVariable}=<url> [${Resources.releaseUpdateFeedVariable}=<loopback URL> | ${Resources.releaseInternalVariable}=<N.N.N-internal.N>] ${command} ${Resources.releasePublishCommand}\n`;
3000
+ + `${Resources.formatReleaseSourceOptions()} ${Resources.releaseReportsVariable}=<folder> ${Resources.releaseRunVariable}=<url> [${Resources.releaseUpdateFeedVariable}=<loopback URL> | ${Resources.releaseInternalVariable}=<N.N.N-internal.N>] ${command} ${Resources.releasePublishCommand}\n`;
2939
3001
  }
2940
3002
  static formatTestFeedPublishesNothing(feed) {
2941
3003
  return `This run tests updating with the feed ${feed}, so it publishes nothing.\n`;
@@ -3133,6 +3195,9 @@ export class Resources {
3133
3195
  static formatAddonBuildFailed(packageName, kind, addon, exitCode, text) {
3134
3196
  return `Building ${packageName}'s ${kind} addon ${addon} failed with exit code ${exitCode}:\n${text}`;
3135
3197
  }
3198
+ static formatAddonArchitectureRefused(packageName, architecture, machineArchitecture) {
3199
+ return `${packageName}'s addons can't be built for ${architecture} on this ${machineArchitecture} machine, since node-gyp builds for the machine's own processor. Build on a ${architecture} machine, or name a folder of release builds in ${Resources.releaseAddonsVariable}.`;
3200
+ }
3136
3201
  static formatReleaseAddonMissing(target, packageName, addon, directory, build) {
3137
3202
  return `${Resources.releaseAddonsVariable} lacks the ${target} build of ${packageName}'s addon ${addon}, ${directory}/${build}.`;
3138
3203
  }
@@ -3367,6 +3432,26 @@ export class Resources {
3367
3432
  static formatLockedPackageUnlocked(name, version, location) {
3368
3433
  return `${name}@${version} at ${location} is installed but not locked in package-lock.json, and only a package installed from the app's own archive may ship unlocked.`;
3369
3434
  }
3435
+ static formatLockedPackageLinked(location, resolved) {
3436
+ return `${location} in package-lock.json links to the folder ${resolved}; a linked folder cannot ship, so lock the package to its archive in the repository's own ${Resources.archivesFolder} folder.`;
3437
+ }
3438
+ static formatLockedArchiveRefused(name, version, location, resolved) {
3439
+ return `${name}@${version} at ${location} in package-lock.json is locked to ${resolved}; a locked file ships only as a ${Resources.packageArchiveExtension} archive of a Noldova package `
3440
+ + `directly in the ${Resources.archivesFolder} folder of the app's folder or of a folder above it.`;
3441
+ }
3442
+ static formatLockedArchiveMisnamed(name, version, location, resolved, expected) {
3443
+ return `${name}@${version} at ${location} in package-lock.json is locked to ${resolved}; its archive must be named ${expected}, the name npm pack gives ${name}@${version}.`;
3444
+ }
3445
+ static formatLockedArchiveOutside(id, archive, repository) {
3446
+ return `${id} is locked to ${archive}, which is outside the repository at ${repository}; an app ships only the archives in its own repository's ${Resources.archivesFolder} folders.`;
3447
+ }
3448
+ static formatLockedArchiveThroughLink(id, archive, real) {
3449
+ return `${id} is locked to ${archive}, which a link leads to ${real}; an app ships an archive only from its repository's own ${Resources.archivesFolder} folder, not through a link.`;
3450
+ }
3451
+ static formatLockedArchiveNoIntegrity(name, version, location, resolved) {
3452
+ return `${name}@${version} at ${location} in package-lock.json is locked to ${resolved} with an integrity that holds no SHA-512, so its archive cannot be verified; `
3453
+ + `write "integrity": "sha512-<the archive's SHA-512 digest in base64>" beside its "resolved", or leave the integrity out to ship the archive as it is.`;
3454
+ }
3370
3455
  static formatLockedPackageUnresolved(name, version, location) {
3371
3456
  return `${name}@${version} at ${location} in package-lock.json is not resolved to a registry tarball, so it cannot ship.`;
3372
3457
  }
@@ -3382,8 +3467,8 @@ export class Resources {
3382
3467
  static formatTargetId(platform, architecture) {
3383
3468
  return `${platform}-${architecture}`;
3384
3469
  }
3385
- static formatTargetFileName(productName, platform, architecture, extension) {
3386
- return `${productName}-${platform}-${architecture}.${extension}`;
3470
+ static formatTargetFileName(productName, version, platform, architecture, extension) {
3471
+ return `${productName}-${version}-${platform}-${architecture}.${extension}`;
3387
3472
  }
3388
3473
  static formatTarEntryType(type) {
3389
3474
  return `a tar entry of type ${type}`;
@@ -3477,6 +3562,9 @@ export class Resources {
3477
3562
  static formatReleaseRunCheck(runUrl) {
3478
3563
  return `Each target's package passed its install check on that target's own runner in the run that built it: ${runUrl}`;
3479
3564
  }
3565
+ static formatReleaseSource(repository, revision) {
3566
+ return `Built from ${repository} at ${revision}.`;
3567
+ }
3480
3568
  static formatUnsignedTestRelease(name, repository) {
3481
3569
  return `Unsigned test release of ${name}, published in ${repository}; an installed ${name} never updates from it.`;
3482
3570
  }
@@ -3568,6 +3656,23 @@ export class Resources {
3568
3656
  static formatTagAnnotated(tag) {
3569
3657
  return `The tag ${tag} is annotated; a release's tag points straight at its commit.`;
3570
3658
  }
3659
+ static formatReleaseTagTaken(tag, repository) {
3660
+ return `The tag ${tag} already exists in ${repository}, which isn't the source repository, so it can't be this release's own; this release needs a new version.`;
3661
+ }
3662
+ static formatReleaseTagMissing(tag, repository) {
3663
+ return `The tag ${tag} doesn't exist in ${repository}, though its release is published.`;
3664
+ }
3665
+ static formatReleaseTagPrefixNeeded(repository, sourceRepository) {
3666
+ return `${Resources.releaseTagPrefixVariable} must name the app, such as app-, for a release in ${repository}, which isn't its source repository ${sourceRepository}: `
3667
+ + `a v tag there can't say which app it belongs to.`;
3668
+ }
3669
+ static formatReleaseSourceNotPublic(sourceRepository, buildRepository) {
3670
+ return `The release runs in ${buildRepository} and reads its source ${sourceRepository} with the run's own token, which reads no other private repository, so ${sourceRepository} must be public; it is private or doesn't exist.`;
3671
+ }
3672
+ static formatSeparateReleaseNeedsFeed(repository, sourceRepository) {
3673
+ return `The release publishes in ${repository}, not in its source repository ${sourceRepository}, so product.json must name its updateFeed: `
3674
+ + `the latest release of ${repository} may be another app's.`;
3675
+ }
3571
3676
  static formatTagMoved(tag, commit, revision) {
3572
3677
  return `The tag ${tag} already points at ${commit}, not at ${revision}; a tag is never moved, so this release needs a new version.`;
3573
3678
  }
@@ -3583,8 +3688,11 @@ export class Resources {
3583
3688
  static formatYamlQuoted(text) {
3584
3689
  return `'${text.replaceAll("'", "''")}'`;
3585
3690
  }
3586
- static formatReleaseRepositoryInvalid(repository) {
3587
- return `${Resources.releaseRepositoryVariable} must name a repository as owner/name, not "${repository}".`;
3691
+ static formatReleaseRepositoryInvalid(repository, variable = Resources.releaseRepositoryVariable) {
3692
+ return `${variable} must name a repository as owner/name, not "${repository}".`;
3693
+ }
3694
+ static formatReleaseTagPrefixInvalid(prefix) {
3695
+ return `${Resources.releaseTagPrefixVariable} must be v, or lowercase words joined by dashes and ending in a dash, such as app-, not "${prefix}".`;
3588
3696
  }
3589
3697
  static formatReleaseRevisionInvalid(revision) {
3590
3698
  return `${Resources.releaseRevisionVariable} must be a full commit SHA of 40 lowercase hexadecimal digits, not "${revision}".`;
@@ -3592,8 +3700,8 @@ export class Resources {
3592
3700
  static formatReleaseVersionInvalid(source, text) {
3593
3701
  return `${source} must be a plain version such as 0.0.2, not "${text}".`;
3594
3702
  }
3595
- static formatReleaseTagInvalid(source, tag) {
3596
- return `${source} must be a tag such as v0.0.2, not "${tag}".`;
3703
+ static formatReleaseTagInvalid(source, tag, prefix) {
3704
+ return `${source} must be a tag such as ${prefix}0.0.2, not "${tag}".`;
3597
3705
  }
3598
3706
  static formatTagReferencesContext(tag) {
3599
3707
  return `the references of the tag ${tag}`;