import type { PackageInstallerContext } from '../package-installer.js';
/**
 * Identity (IAM + OAuth) package installer.
 *
 * Runs after both the `iam` and `o-auth` template trees have been copied by
 * the meta-package dispatch in `addBackPackage`. Responsible for:
 *
 * 1. Installing the union of runtime dependencies.
 * 2. Wiring `@bridges/bridges.module.ts` to the golden-reference shape.
 * 3. Authoring `@bridges/providers/index.ts` barrel.
 * 4. Formatting both touched files with the consumer's own Prettier (so
 *    eslint-plugin-prettier/recommended passes without further changes).
 * 5. Setting `OAUTH_STRATEGY=local-provider` in `.env`.
 * 6. Running GraphQL typings regeneration last (D6).
 *
 * MUST NOT:
 * - Edit `@aurora/decorators/auth.decorator.ts`.
 * - Auto-run `catalyst keys` or any seeder.
 *
 * Returns the "Next steps" banner as a string so the `add` command can print
 * it AFTER `spinner.succeed()`, keeping spinner output clean.
 */
export default function install(ctx: PackageInstallerContext): Promise<string>;
