Function resolveSafeOutputIssueTarget

actions/setup/js/temporary_id.cjs:460–496

* Resolve a safe-output issue/PR target number from a message. * Handles temporary IDs, field aliases, and deferred resolution. * * Returns one of: * - `{ success: true, number: n }` — explicit number found and resolved * - `{ success: true, number: null }` — no explicit number; caller should u

({ message, resolvedTemporaryIds, tempIdMap, repoParts, handlerType, aliases = ["item_number", "issue_number", "pr_number", "pull_number"] })

 * @returns {{success: true, number: number|null} | {success: false, deferred?: boolean, error: string}}
 */
function resolveSafeOutputIssueTarget({ message, resolvedTemporaryIds, tempIdMap, repoParts, handlerType, aliases = ["item_number", "issue_number", "pr_number", "pull_number"] }) {
  const fieldNames = aliases;

  // Find the first non-null explicit value across all provided field aliases
  let explicitValue;
  for (const alias of fieldNames) {
    if (message[alias] !== undefined && message[alias] !== null) {
      explicitValue = message[alias];
      break;
    }
  }

  if (explicitValue === undefined) {
    // No explicit item number provided — caller should fall back to event context
    return { success: true, number: null };
  }

  const map = tempIdMap ?? loadTemporaryIdMapFromResolved(resolvedTemporaryIds);
  const resolvedTarget = resolveRepoIssueTarget(explicitValue, map, repoParts.owner, repoParts.repo);

  if (resolvedTarget.wasTemporaryId && !resolvedTarget.resolved) {
    core.info(`Deferring ${handlerType}: unresolved temporary ID (${explicitValue})`);
    return {
      success: false,
      deferred: true,
      error: resolvedTarget.errorMessage ?? `Unresolved temporary ID: ${explicitValue}`,
    };
  }

  if (resolvedTarget.errorMessage || !resolvedTarget.resolved) {
    const error = `Invalid item number: ${explicitValue}`;
    core.warning(error);
    return { success: false, error };
  }

  return { success: true, number: resolvedTarget.resolved.number };
}

/**
 * Check if text contains unresolved temporary ID references