@williamthorsen/release-kit 5.4.0 → 7.0.0

package/dist/esm/resolveCommandTags.js

@@ -1,50 +1,53 @@
+import { reportError } from '@williamthorsen/nmr-core';
 import { deriveWorkspaceConfig } from "./deriveWorkspaceConfig.js";
 import { discoverWorkspaces } from "./discoverWorkspaces.js";
 import { resolveReleaseTags } from "./resolveReleaseTags.js";
-async function resolveCommandTags(tags) {
-  let discoveredPaths;
-  try {
-    discoveredPaths = await discoverWorkspaces();
-  } catch (error) {
-    console.error(`Error discovering workspaces: ${error instanceof Error ? error.message : String(error)}`);
-    process.exit(1);
-  }
-  let workspaces;
-  let singleWorkspace;
-  try {
-    if (discoveredPaths === void 0) {
-      singleWorkspace = deriveWorkspaceConfig(".");
-    } else {
-      workspaces = discoveredPaths.map((workspacePath) => deriveWorkspaceConfig(workspacePath));
-    }
-  } catch (error) {
-    console.error(`Error resolving workspaces: ${error instanceof Error ? error.message : String(error)}`);
-    process.exit(1);
-  }
-  let resolvedTags;
-  if (workspaces !== void 0) {
-    resolvedTags = resolveReleaseTags({ workspaces });
-  } else if (singleWorkspace !== void 0) {
-    resolvedTags = resolveReleaseTags({ singleWorkspace });
-  } else {
-    throw new Error("resolveCommandTags: invariant violated \u2014 neither workspaces nor singleWorkspace was derived");
-  }
-  if (resolvedTags.length === 0) {
-    console.error("Error: No release tags found on HEAD. Create tags with `release-kit tag` first.");
-    process.exit(1);
-  }
-  if (tags !== void 0) {
-    const availableTagNames = resolvedTags.map((t) => t.tag);
-    for (const name of tags) {
-      if (!availableTagNames.includes(name)) {
-        console.error(`Error: Unknown tag "${name}" in --tags. Available: ${availableTagNames.join(", ")}`);
+export async function resolveCommandTags(tags) {
+    let discoveredPaths;
+    try {
+        discoveredPaths = await discoverWorkspaces();
+    }
+    catch (error) {
+        reportError(`Failed to discover workspaces: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
+    let workspaces;
+    let singleWorkspace;
+    try {
+        if (discoveredPaths === undefined) {
+            singleWorkspace = deriveWorkspaceConfig('.');
+        }
+        else {
+            workspaces = discoveredPaths.map((workspacePath) => deriveWorkspaceConfig(workspacePath));
+        }
+    }
+    catch (error) {
+        reportError(`Failed to resolve workspaces: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
+    let resolvedTags;
+    if (workspaces !== undefined) {
+        resolvedTags = resolveReleaseTags({ workspaces });
+    }
+    else if (singleWorkspace !== undefined) {
+        resolvedTags = resolveReleaseTags({ singleWorkspace });
+    }
+    else {
+        throw new Error('resolveCommandTags: invariant violated — neither workspaces nor singleWorkspace was derived');
+    }
+    if (resolvedTags.length === 0) {
+        reportError('No release tags found on HEAD. Create tags with `release-kit tag` first.');
         process.exit(1);
-      }
     }
-    resolvedTags = resolvedTags.filter((t) => tags.includes(t.tag));
-  }
-  return resolvedTags;
+    if (tags !== undefined) {
+        const availableTagNames = resolvedTags.map((t) => t.tag);
+        for (const name of tags) {
+            if (!availableTagNames.includes(name)) {
+                reportError(`Unknown tag "${name}" in --tags. Available: ${availableTagNames.join(', ')}`);
+                process.exit(1);
+            }
+        }
+        resolvedTags = resolvedTags.filter((t) => tags.includes(t.tag));
+    }
+    return resolvedTags;
 }
-export {
-  resolveCommandTags
-};

package/dist/esm/resolveReleaseNotesConfig.d.ts

@@ -1,4 +1,4 @@
-import type { ReleaseNotesConfig } from './types.ts';
+import type { ReleaseNotesConfig } from './types.js';
 export interface ResolvedReleaseNotesConfig {
     releaseNotes: ReleaseNotesConfig;
     changelogJsonOutputPath: string;

package/dist/esm/resolveReleaseNotesConfig.js

@@ -1,49 +1,47 @@
+import { reportError } from '@williamthorsen/nmr-core';
 import { DEFAULT_CHANGELOG_JSON_CONFIG, DEFAULT_RELEASE_NOTES_CONFIG } from "./defaults.js";
 import { loadConfig, resolveWorkTypes } from "./loadConfig.js";
 import { validateConfig } from "./validateConfig.js";
-async function resolveReleaseNotesConfig(options = {}) {
-  const { strictLoad = false } = options;
-  let rawConfig;
-  try {
-    rawConfig = await loadConfig();
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    if (strictLoad) {
-      console.error(`Error: failed to load config: ${message}`);
-      process.exit(1);
+export async function resolveReleaseNotesConfig(options = {}) {
+    const { strictLoad = false } = options;
+    let rawConfig;
+    try {
+        rawConfig = await loadConfig();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (strictLoad) {
+            reportError(`Failed to load config: ${message}`);
+            process.exit(1);
+        }
+        console.warn(`Warning: failed to load config; using defaults: ${message}`);
+    }
+    if (rawConfig === undefined) {
+        return {
+            releaseNotes: { ...DEFAULT_RELEASE_NOTES_CONFIG },
+            changelogJsonOutputPath: DEFAULT_CHANGELOG_JSON_CONFIG.outputPath,
+            sectionOrder: deriveSectionOrder(resolveWorkTypes()),
+        };
+    }
+    const { config, errors, warnings } = validateConfig(rawConfig);
+    if (errors.length > 0) {
+        process.stderr.write('Invalid config:\n');
+        for (const err of errors) {
+            process.stderr.write(`  ❌ ${err}\n`);
+        }
+        process.exit(1);
+    }
+    for (const warning of warnings) {
+        console.warn(`  ⚠️  ${warning}`);
     }
-    console.warn(`Warning: failed to load config; using defaults: ${message}`);
-  }
-  if (rawConfig === void 0) {
     return {
-      releaseNotes: { ...DEFAULT_RELEASE_NOTES_CONFIG },
-      changelogJsonOutputPath: DEFAULT_CHANGELOG_JSON_CONFIG.outputPath,
-      sectionOrder: deriveSectionOrder(resolveWorkTypes())
+        releaseNotes: {
+            shouldInjectIntoReadme: config.releaseNotes?.shouldInjectIntoReadme ?? DEFAULT_RELEASE_NOTES_CONFIG.shouldInjectIntoReadme,
+        },
+        changelogJsonOutputPath: config.changelogJson?.outputPath ?? DEFAULT_CHANGELOG_JSON_CONFIG.outputPath,
+        sectionOrder: deriveSectionOrder(resolveWorkTypes(config.workTypes)),
     };
-  }
-  const { config, errors, warnings } = validateConfig(rawConfig);
-  if (errors.length > 0) {
-    console.error("Invalid config:");
-    for (const err of errors) {
-      console.error(`  \u274C ${err}`);
-    }
-    process.exit(1);
-  }
-  for (const warning of warnings) {
-    console.warn(`  \u26A0\uFE0F  ${warning}`);
-  }
-  return {
-    releaseNotes: {
-      shouldInjectIntoReadme: config.releaseNotes?.shouldInjectIntoReadme ?? DEFAULT_RELEASE_NOTES_CONFIG.shouldInjectIntoReadme
-    },
-    changelogJsonOutputPath: config.changelogJson?.outputPath ?? DEFAULT_CHANGELOG_JSON_CONFIG.outputPath,
-    sectionOrder: deriveSectionOrder(resolveWorkTypes(config.workTypes))
-  };
 }
-function deriveSectionOrder(workTypes) {
-  return Object.values(workTypes).map((entry) => entry.header);
+export function deriveSectionOrder(workTypes) {
+    return Object.values(workTypes).map((entry) => entry.header);
 }
-export {
-  deriveSectionOrder,
-  resolveReleaseNotesConfig
-};

package/dist/esm/resolveReleaseTags.d.ts

@@ -1,4 +1,4 @@
-import type { WorkspaceConfig } from './types.ts';
+import type { WorkspaceConfig } from './types.js';
 export interface ResolvedTag {
     tag: string;
     dir: string;

package/dist/esm/resolveReleaseTags.js

@@ -1,51 +1,50 @@
-import { execFileSync } from "node:child_process";
+import { execFileSync } from 'node:child_process';
 const VERSION_PATTERN = /^v\d+\.\d+\.\d+/;
 const SEMVER_SUFFIX_PATTERN = /^\d+\.\d+\.\d+/;
-function resolveReleaseTags(args) {
-  const output = execFileSync("git", ["tag", "--points-at", "HEAD"], { encoding: "utf8" });
-  const tags = output.split("\n").map((line) => line.trim()).filter((line) => line.length > 0);
-  if (args === void 0) {
-    return resolveSinglePackageTags(tags);
-  }
-  if ("workspaces" in args) {
-    return resolveMonorepoTags(tags, args.workspaces);
-  }
-  return resolveSinglePackageTags(tags, args.singleWorkspace);
+export function resolveReleaseTags(args) {
+    const output = execFileSync('git', ['tag', '--points-at', 'HEAD'], { encoding: 'utf8' });
+    const tags = output
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+    if (args === undefined) {
+        return resolveSinglePackageTags(tags);
+    }
+    if ('workspaces' in args) {
+        return resolveMonorepoTags(tags, args.workspaces);
+    }
+    return resolveSinglePackageTags(tags, args.singleWorkspace);
 }
 function resolveSinglePackageTags(tags, singleWorkspace) {
-  const matched = tags.filter((tag) => VERSION_PATTERN.test(tag));
-  const isPublishable = singleWorkspace?.isPublishable ?? true;
-  if (matched.length > 1) {
-    console.warn(
-      `Warning: Multiple version tags found on HEAD: ${matched.join(", ")}. Publishing the same package multiple times is almost certainly unintended. Using only the first tag.`
-    );
-    return matched.slice(0, 1).map((tag) => ({ tag, dir: ".", workspacePath: ".", isPublishable }));
-  }
-  return matched.map((tag) => ({ tag, dir: ".", workspacePath: ".", isPublishable }));
+    const matched = tags.filter((tag) => VERSION_PATTERN.test(tag));
+    const isPublishable = singleWorkspace?.isPublishable ?? true;
+    if (matched.length > 1) {
+        console.warn(`Warning: Multiple version tags found on HEAD: ${matched.join(', ')}. ` +
+            `Publishing the same package multiple times is almost certainly unintended. Using only the first tag.`);
+        return matched.slice(0, 1).map((tag) => ({ tag, dir: '.', workspacePath: '.', isPublishable }));
+    }
+    return matched.map((tag) => ({ tag, dir: '.', workspacePath: '.', isPublishable }));
 }
 function resolveMonorepoTags(tags, workspaces) {
-  const sortedWorkspaces = [...workspaces].sort((a, b) => b.tagPrefix.length - a.tagPrefix.length);
-  const resolved = [];
-  for (const tag of tags) {
-    const match = findMatchingWorkspace(tag, sortedWorkspaces);
-    if (match !== void 0) {
-      resolved.push({ tag, dir: match.dir, workspacePath: match.workspacePath, isPublishable: match.isPublishable });
+    const sortedWorkspaces = [...workspaces].sort((a, b) => b.tagPrefix.length - a.tagPrefix.length);
+    const resolved = [];
+    for (const tag of tags) {
+        const match = findMatchingWorkspace(tag, sortedWorkspaces);
+        if (match !== undefined) {
+            resolved.push({ tag, dir: match.dir, workspacePath: match.workspacePath, isPublishable: match.isPublishable });
+        }
     }
-  }
-  return resolved;
+    return resolved;
 }
 function findMatchingWorkspace(tag, sortedWorkspaces) {
-  for (const workspace of sortedWorkspaces) {
-    if (!tag.startsWith(workspace.tagPrefix)) {
-      continue;
-    }
-    const versionSuffix = tag.slice(workspace.tagPrefix.length);
-    if (SEMVER_SUFFIX_PATTERN.test(versionSuffix)) {
-      return workspace;
+    for (const workspace of sortedWorkspaces) {
+        if (!tag.startsWith(workspace.tagPrefix)) {
+            continue;
+        }
+        const versionSuffix = tag.slice(workspace.tagPrefix.length);
+        if (SEMVER_SUFFIX_PATTERN.test(versionSuffix)) {
+            return workspace;
+        }
     }
-  }
-  return void 0;
+    return undefined;
 }
-export {
-  resolveReleaseTags
-};

package/dist/esm/runGitCliff.js

@@ -1,34 +1,31 @@
-import { execFileSync } from "node:child_process";
-import { copyFileSync, mkdtempSync, rmSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-function runGitCliff(cliffConfigPath, cliffArgs, stdio) {
-  let configPath = cliffConfigPath;
-  let tempDir;
-  try {
-    if (cliffConfigPath.endsWith(".template")) {
-      tempDir = mkdtempSync(join(tmpdir(), "cliff-"));
-      configPath = join(tempDir, "cliff.toml");
-      copyFileSync(cliffConfigPath, configPath);
+import { execFileSync } from 'node:child_process';
+import { copyFileSync, mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+export function runGitCliff(cliffConfigPath, cliffArgs, stdio) {
+    let configPath = cliffConfigPath;
+    let tempDir;
+    try {
+        if (cliffConfigPath.endsWith('.template')) {
+            tempDir = mkdtempSync(join(tmpdir(), 'cliff-'));
+            configPath = join(tempDir, 'cliff.toml');
+            copyFileSync(cliffConfigPath, configPath);
+        }
+        return execFileSync('npx', ['--prefer-offline', '--yes', 'git-cliff', '--config', configPath, ...cliffArgs], {
+            encoding: 'utf8',
+            stdio,
+            env: { ...process.env, npm_config_progress: 'false' },
+        });
     }
-    return execFileSync("npx", ["--prefer-offline", "--yes", "git-cliff", "--config", configPath, ...cliffArgs], {
-      encoding: "utf8",
-      stdio,
-      env: { ...process.env, npm_config_progress: "false" }
-    });
-  } finally {
-    if (tempDir !== void 0) {
-      rmSync(tempDir, { recursive: true, force: true });
+    finally {
+        if (tempDir !== undefined) {
+            rmSync(tempDir, { recursive: true, force: true });
+        }
     }
-  }
 }
-function refreshGitCliffCache() {
-  execFileSync("npx", ["--yes", "git-cliff", "--version"], {
-    stdio: ["ignore", "pipe", "inherit"],
-    env: { ...process.env, npm_config_progress: "false" }
-  });
+export function refreshGitCliffCache() {
+    execFileSync('npx', ['--yes', 'git-cliff', '--version'], {
+        stdio: ['ignore', 'pipe', 'inherit'],
+        env: { ...process.env, npm_config_progress: 'false' },
+    });
 }
-export {
-  refreshGitCliffCache,
-  runGitCliff
-};

package/dist/esm/showTagPrefixesCommand.js

@@ -1,84 +1,62 @@
 import { detectRepoType } from "./init/detectRepoType.js";
 import { previewTagPrefixes } from "./previewTagPrefixes.js";
-async function showTagPrefixesCommand() {
-  if (detectRepoType() === "single-package") {
-    process.stdout.write(renderSinglePackage());
-    return 0;
-  }
-  const preview = await previewTagPrefixes();
-  process.stdout.write(renderMonorepo(preview));
-  return computeExitCode(preview);
+export async function showTagPrefixesCommand() {
+    if (detectRepoType() === 'single-package') {
+        process.stdout.write(renderSinglePackage());
+        return 0;
+    }
+    const preview = await previewTagPrefixes();
+    process.stdout.write(renderMonorepo(preview));
+    return computeExitCode(preview);
 }
 function renderSinglePackage() {
-  const lines = [
-    "Workspace   Derived prefix   Status",
-    ".           v                (single-package mode)",
-    ""
-  ];
-  return lines.join("\n");
+    const lines = [
+        'Workspace   Derived prefix   Status',
+        '.           v                (single-package mode)',
+        '',
+    ];
+    return lines.join('\n');
 }
 function renderMonorepo(preview) {
-  const lines = ["Workspace tag prefixes:", ""];
-  for (const row of preview.workspaces) {
-    lines.push(...renderWorkspaceRow(row));
-  }
-  if (preview.collisions.length > 0) {
-    lines.push(
-      "",
-      ...preview.collisions.map(
-        (collision) => `\u26D4 tag prefix collision: '${collision.tagPrefix}' used by ${collision.workspacePaths.join(", ")}`
-      )
-    );
-  }
-  if (preview.undeclaredCandidates.length > 0) {
-    lines.push(
-      "",
-      "Undeclared tag prefixes:",
-      "",
-      ...preview.undeclaredCandidates.map(
-        (candidate) => `  '${candidate.prefix}' \u2014 ${candidate.tagCount} tags (e.g., ${candidate.exampleTags.join(", ")})`
-      ),
-      "",
-      "Suggested config snippet (adjust `dir` to match your workspace if the guess is wrong, and replace the `name` placeholder with the legacy npm name):",
-      "",
-      renderSuggestedSnippet(preview.undeclaredCandidates),
-      "",
-      "If the suggested `dir` does not match your workspace, adjust before pasting. Each legacy identity requires a `name` \u2014 replace the `TODO-fill-in-legacy-npm-name` placeholder with the package's prior npm name."
-    );
-  }
-  lines.push("");
-  return lines.join("\n");
+    const lines = ['Workspace tag prefixes:', ''];
+    for (const row of preview.workspaces) {
+        lines.push(...renderWorkspaceRow(row));
+    }
+    if (preview.collisions.length > 0) {
+        lines.push('', ...preview.collisions.map((collision) => `⛔ tag prefix collision: '${collision.tagPrefix}' used by ${collision.workspacePaths.join(', ')}`));
+    }
+    if (preview.undeclaredCandidates.length > 0) {
+        lines.push('', 'Undeclared tag prefixes:', '', ...preview.undeclaredCandidates.map((candidate) => `  '${candidate.prefix}' — ${candidate.tagCount} tags (e.g., ${candidate.exampleTags.join(', ')})`), '', 'Suggested config snippet (adjust `dir` to match your workspace if the guess is wrong, and replace the `name` placeholder with the legacy npm name):', '', renderSuggestedSnippet(preview.undeclaredCandidates), '', "If the suggested `dir` does not match your workspace, adjust before pasting. Each legacy identity requires a `name` — replace the `TODO-fill-in-legacy-npm-name` placeholder with the package's prior npm name.");
+    }
+    lines.push('');
+    return lines.join('\n');
 }
 function renderWorkspaceRow(row) {
-  const lines = [];
-  if (row.derivedPrefix === null) {
-    lines.push(`  ${row.workspacePath} \u2014 \u26D4 derivation failed: ${row.derivationError ?? "unknown error"}`);
-    return lines;
-  }
-  const statusMarker = row.derivedTagCount > 0 ? `\u2705 ${row.derivedTagCount} tags` : "\u26A0\uFE0F no existing tags";
-  lines.push(`  ${row.workspacePath} \u2014 derived prefix '${row.derivedPrefix}', ${statusMarker}`);
-  for (const entry of row.legacyEntries) {
-    if (entry.tagCount > 0) {
-      lines.push(`      \u2705 ${entry.tagCount} legacy tags with '${entry.prefix}' prefix (recognized)`);
-    } else {
-      lines.push(`      \u26A0\uFE0F recorded legacy prefix '${entry.prefix}' has no tags`);
+    const lines = [];
+    if (row.derivedPrefix === null) {
+        lines.push(`  ${row.workspacePath} — ⛔ derivation failed: ${row.derivationError ?? 'unknown error'}`);
+        return lines;
+    }
+    const statusMarker = row.derivedTagCount > 0 ? `✅ ${row.derivedTagCount} tags` : '⚠️ no existing tags';
+    lines.push(`  ${row.workspacePath} — derived prefix '${row.derivedPrefix}', ${statusMarker}`);
+    for (const entry of row.legacyEntries) {
+        if (entry.tagCount > 0) {
+            lines.push(`      ✅ ${entry.tagCount} legacy tags with '${entry.prefix}' prefix (recognized)`);
+        }
+        else {
+            lines.push(`      ⚠️ recorded legacy prefix '${entry.prefix}' has no tags`);
+        }
     }
-  }
-  return lines;
+    return lines;
 }
 function renderSuggestedSnippet(candidates) {
-  const entries = candidates.map(
-    (candidate) => `    { dir: '${candidate.suggestedDir}', legacyIdentities: [{ name: 'TODO-fill-in-legacy-npm-name', tagPrefix: '${candidate.prefix}' }] },`
-  ).join("\n");
-  return `  workspaces: [
-${entries}
-  ],`;
+    const entries = candidates
+        .map((candidate) => `    { dir: '${candidate.suggestedDir}', legacyIdentities: [{ name: 'TODO-fill-in-legacy-npm-name', tagPrefix: '${candidate.prefix}' }] },`)
+        .join('\n');
+    return `  workspaces: [\n${entries}\n  ],`;
 }
 function computeExitCode(preview) {
-  const hasDerivationFailure = preview.workspaces.some((row) => row.derivedPrefix === null);
-  const hasCollision = preview.collisions.length > 0;
-  return hasDerivationFailure || hasCollision ? 1 : 0;
+    const hasDerivationFailure = preview.workspaces.some((row) => row.derivedPrefix === null);
+    const hasCollision = preview.collisions.length > 0;
+    return hasDerivationFailure || hasCollision ? 1 : 0;
 }
-export {
-  showTagPrefixesCommand
-};

package/dist/esm/stripEmojiPrefix.js

@@ -1,7 +1,4 @@
 const LEADING_EMOJI = /^\p{Extended_Pictographic}️? /u;
-function stripEmojiPrefix(value) {
-  return value.replace(LEADING_EMOJI, "");
+export function stripEmojiPrefix(value) {
+    return value.replace(LEADING_EMOJI, '');
 }
-export {
-  stripEmojiPrefix
-};

package/dist/esm/stripScope.js

@@ -1,24 +1,21 @@
 import { COMMIT_PREPROCESSOR_PATTERNS } from "./parseCommitMessage.js";
-function stripScope(message) {
-  let ticketPrefix = "";
-  let remainder = message;
-  for (const pattern of COMMIT_PREPROCESSOR_PATTERNS) {
-    const match = remainder.match(pattern);
-    if (match) {
-      ticketPrefix += match[0];
-      remainder = remainder.slice(match[0].length);
+export function stripScope(message) {
+    let ticketPrefix = '';
+    let remainder = message;
+    for (const pattern of COMMIT_PREPROCESSOR_PATTERNS) {
+        const match = remainder.match(pattern);
+        if (match) {
+            ticketPrefix += match[0];
+            remainder = remainder.slice(match[0].length);
+        }
     }
-  }
-  const pipeMatch = remainder.match(/^[^|]+\|(.*)$/);
-  if (pipeMatch) {
-    return `${ticketPrefix}${pipeMatch[1]}`;
-  }
-  const parenMatch = remainder.match(/^(\w+)\([^)]+\)(.*)$/);
-  if (parenMatch) {
-    return `${ticketPrefix}${parenMatch[1]}${parenMatch[2]}`;
-  }
-  return message;
+    const pipeMatch = remainder.match(/^[^|]+\|(.*)$/);
+    if (pipeMatch) {
+        return `${ticketPrefix}${pipeMatch[1]}`;
+    }
+    const parenMatch = remainder.match(/^(\w+)\([^)]+\)(.*)$/);
+    if (parenMatch) {
+        return `${ticketPrefix}${parenMatch[1]}${parenMatch[2]}`;
+    }
+    return message;
 }
-export {
-  stripScope
-};

package/dist/esm/sync-labels/generateCommand.d.ts

@@ -1,4 +1,4 @@
-import type { LabelDefinition } from './types.ts';
+import type { LabelDefinition } from './types.js';
 export declare const LABELS_OUTPUT_PATH = ".github/labels.yaml";
 export declare function formatLabelsYaml(labels: LabelDefinition[], presetHashes: Map<string, string>): string;
 export declare function generateCommand(): Promise<number>;