@prisma/orm-toolchain 0.16.0-dev.36

package/dist/bin__prisma-next.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin__prisma-next.mjs","names":["isCI"],"sources":["../../../../1-framework/3-tooling/cli/dist/cli.mjs"],"sourcesContent":["#!/usr/bin/env node\nimport { D as isCI, O as formatCommandHelp, g as parseGlobalFlagsOrExit, h as parseGlobalFlags, k as formatRootHelp, l as setCommandDescriptions, m as deriveCanPrompt, t as addGlobalOptions, u as setCommandExamples, v as installShutdownHandlers } from \"./command-helpers-CAoXqAY9.mjs\";\nimport { t as createContractEmitCommand } from \"./contract-emit-0hSjbuxp.mjs\";\nimport { t as createContractInferCommand } from \"./contract-infer-BnkqpftN.mjs\";\nimport { createDbInitCommand } from \"./commands/db-init.mjs\";\nimport { createDbSchemaCommand } from \"./commands/db-schema.mjs\";\nimport { createDbSignCommand } from \"./commands/db-sign.mjs\";\nimport { createDbUpdateCommand } from \"./commands/db-update.mjs\";\nimport { t as createDbVerifyCommand } from \"./db-verify-CKPsRFrj.mjs\";\nimport { t as createFormatCommand } from \"./format-ByDm2goZ.mjs\";\nimport { t as createMigrationListCommand } from \"./migration-list-BFBeo1_X.mjs\";\nimport { createMigrateCommand } from \"./commands/migrate.mjs\";\nimport { t as createMigrationCheckCommand } from \"./migration-check-CcG-fB8r.mjs\";\nimport { createMigrationGraphCommand } from \"./commands/migration-graph.mjs\";\nimport { t as createMigrationLogCommand } from \"./migration-log-CS5IWcNq.mjs\";\nimport { createMigrationNewCommand } from \"./commands/migration-new.mjs\";\nimport { t as createMigrationPlanCommand } from \"./migration-plan-q_L84PN1.mjs\";\nimport { createMigrationShowCommand } from \"./commands/migration-show.mjs\";\nimport { r as createMigrationStatusCommand } from \"./migration-status-CFlzlRmu.mjs\";\nimport { createRefCommand } from \"./commands/ref.mjs\";\nimport { t as createTelemetryCommand } from \"./telemetry-CmbCa3Ld.mjs\";\nimport { Command } from \"commander\";\nimport { createScaffoldSpecifierResolver } from \"@internal/publish-surface/import-roots\";\nimport { DEFAULT_CONTRACT_SOURCE_DIR } from \"@internal/config/config-types\";\nimport { keepInternalSpecifiers } from \"@internal/framework-components/emission\";\nimport { ensureInstallationId, readUserConfig, resolveGating, runTelemetry, userConfigPath } from \"@internal/cli-telemetry\";\nimport { distance } from \"closest-match\";\nimport { fileURLToPath } from \"node:url\";\n//#region package.json\nvar version = \"0.16.0-dev.36\";\n//#endregion\n//#region src/commands/init/templates/code-templates.ts\n/**\n* The resolver a scaffold for `target` is written against.\n*\n* A scaffold is always on the facade root: `init` writes an application around\n* one database package, and the workspace names are not published, so a project\n* scaffolded against them could not install (ADR 242). Both the files `init`\n* writes and the dependency it adds go through this, so they cannot disagree.\n*/\nfunction scaffoldSpecifierResolverFor(target) {\n\treturn createScaffoldSpecifierResolver({\n\t\tmode: \"facade\",\n\t\tfacade: target === \"postgres\" ? \"@prisma/orm-postgres\" : \"@prisma/orm-mongo\"\n\t});\n}\n/**\n* The package name a scaffolded project depends on and imports from, for the\n* import root it is being scaffolded against.\n*\n* Every specifier the scaffold writes derives from this one, and `init` builds\n* a single resolver and hands it to both the file templates and the dependency\n* it installs — so the two cannot disagree. The one caller that deliberately\n* does not thread a resolver is the re-init cleanup in `inputs.ts`, which\n* inspects a manifest an earlier run wrote rather than writing one.\n*\n* Resolvers for scaffolding should come from `createScaffoldSpecifierResolver`\n* in the publish-surface package, which rejects the roots a facade-shaped\n* scaffold cannot express. (Named without its scope on purpose: JSDoc survives\n* into the published bundle, where an internal package name would trip the\n* shell tarball checks.)\n*/\nfunction targetPackageName(target, resolveImportSpecifier = keepInternalSpecifiers) {\n\treturn resolveImportSpecifier(target === \"postgres\" ? \"@internal/postgres\" : \"@internal/mongo\");\n}\n/** One entrypoint of the scaffolded project's target package. */\nfunction targetEntrypoint(target, subpath, resolveImportSpecifier = keepInternalSpecifiers) {\n\treturn resolveImportSpecifier(`${target === \"postgres\" ? \"@internal/postgres\" : \"@internal/mongo\"}/${subpath}`);\n}\nfunction targetLabel(target) {\n\treturn target === \"postgres\" ? \"PostgreSQL\" : \"MongoDB\";\n}\nfunction defaultSchemaPath(authoring) {\n\tif (authoring === \"typescript\") return `${DEFAULT_CONTRACT_SOURCE_DIR}/contract.ts`;\n\treturn `${DEFAULT_CONTRACT_SOURCE_DIR}/contract.prisma`;\n}\nfunction starterSchema(target, authoring, resolveImportSpecifier = keepInternalSpecifiers) {\n\tif (authoring === \"typescript\") {\n\t\tconst builder = targetEntrypoint(target, \"contract-builder\", resolveImportSpecifier);\n\t\treturn target === \"mongo\" ? starterSchemaTsMongo(builder) : starterSchemaTsPostgres(builder);\n\t}\n\treturn target === \"mongo\" ? starterSchemaPslMongo() : starterSchemaPslPostgres();\n}\n/**\n* Renders a short authoring-appropriate schema sample (FR5.1) for embedding\n* in `prisma-next.md`. Returns a complete fenced markdown code block.\n*\n* The sample intentionally shows just one model: it's illustrative, not\n* a substitute for the full scaffolded contract file. The TS samples use\n* the same outer shape as `starterSchemaTs*` (FR5.3) so a user reading\n* the doc and the file side-by-side sees the same structure.\n*/\nfunction schemaSample(target, authoring, resolveImportSpecifier = keepInternalSpecifiers) {\n\tif (authoring === \"typescript\") {\n\t\tconst builder = targetEntrypoint(target, \"contract-builder\", resolveImportSpecifier);\n\t\treturn target === \"mongo\" ? schemaSampleTsMongo(builder) : schemaSampleTsPostgres(builder);\n\t}\n\treturn target === \"mongo\" ? schemaSamplePslMongo() : schemaSamplePslPostgres();\n}\nfunction schemaSamplePslPostgres() {\n\treturn `\\`\\`\\`prisma\nmodel User {\n  id       Int     @id @default(autoincrement())\n  email    String  @unique\n  username String?\n  name     String?\n}\n\\`\\`\\``;\n}\nfunction schemaSamplePslMongo() {\n\treturn `\\`\\`\\`prisma\nmodel User {\n  id       ObjectId @id @map(\"_id\")\n  email    String   @unique\n  username String?\n  name     String?\n  @@map(\"users\")\n}\n\\`\\`\\``;\n}\nfunction schemaSampleTsPostgres(builder) {\n\treturn `\\`\\`\\`typescript\nimport { defineContract } from '${builder}';\n\nexport const contract = defineContract(\n  {},\n  ({ field, model }) => ({\n    models: {\n      User: model('User', {\n        fields: {\n          id: field.id.uuidv7String(),\n          email: field.text().unique(),\n          username: field.text().optional(),\n          name: field.text().optional(),\n        },\n      }),\n    },\n  }),\n);\n\\`\\`\\``;\n}\nfunction schemaSampleTsMongo(builder) {\n\treturn `\\`\\`\\`typescript\nimport { defineContract } from '${builder}';\n\nexport const contract = defineContract(\n  {},\n  ({ field, model }) => ({\n    models: {\n      User: model('User', {\n        collection: 'users',\n        fields: {\n          _id: field.objectId(),\n          email: field.string(),\n          username: field.string().optional(),\n          name: field.string().optional(),\n        },\n      }),\n    },\n  }),\n);\n\\`\\`\\``;\n}\nfunction starterSchemaPslPostgres() {\n\treturn `// use prisma-next\n\nmodel User {\n  id        Int      @id @default(autoincrement())\n  email     String   @unique\n  username  String?\n  name      String?\n  posts     Post[]\n  createdAt DateTime @default(now())\n  updatedAt temporal.updatedAt()\n}\n\nmodel Post {\n  id        Int      @id @default(autoincrement())\n  title     String\n  content   String?\n  author    User     @relation(fields: [authorId], references: [id])\n  authorId  Int\n  createdAt DateTime @default(now())\n  updatedAt temporal.updatedAt()\n}\n`;\n}\nfunction starterSchemaPslMongo() {\n\treturn `// use prisma-next\n\nmodel User {\n  id       ObjectId @id @map(\"_id\")\n  email    String   @unique\n  username String?\n  name     String?\n  posts    Post[]\n  @@map(\"users\")\n}\n\nmodel Post {\n  id       ObjectId @id @map(\"_id\")\n  title    String\n  content  String?\n  author   User     @relation(fields: [authorId], references: [id])\n  authorId ObjectId\n  @@map(\"posts\")\n}\n`;\n}\nfunction starterSchemaTsPostgres(builder) {\n\treturn `import { defineContract } from '${builder}';\n\nexport const contract = defineContract(\n  {},\n  ({ field, model, rel }) => ({\n    models: {\n      User: model('User', {\n        fields: {\n          id: field.id.uuidv7String(),\n          email: field.text().unique(),\n          username: field.text().optional(),\n          name: field.text().optional(),\n          createdAt: field.temporal.createdAt(),\n          updatedAt: field.temporal.updatedAt(),\n        },\n        relations: {\n          posts: rel.hasMany('Post', { by: 'authorId' }),\n        },\n      }),\n\n      Post: model('Post', {\n        fields: {\n          id: field.id.uuidv7String(),\n          title: field.text(),\n          content: field.text().optional(),\n          authorId: field.uuidString(),\n          createdAt: field.temporal.createdAt(),\n          updatedAt: field.temporal.updatedAt(),\n        },\n        relations: {\n          author: rel.belongsTo('User', { from: 'authorId', to: 'id' }),\n        },\n      }),\n    },\n  }),\n);\n`;\n}\nfunction starterSchemaTsMongo(builder) {\n\treturn `import { defineContract } from '${builder}';\n\nexport const contract = defineContract(\n  {},\n  ({ field, model, rel }) => ({\n    models: {\n      User: model('User', {\n        collection: 'users',\n        fields: {\n          _id: field.objectId(),\n          email: field.string(),\n          username: field.string().optional(),\n          name: field.string().optional(),\n        },\n        relations: {\n          posts: rel.hasMany('Post', { from: '_id', to: 'authorId' }),\n        },\n      }),\n\n      Post: model('Post', {\n        collection: 'posts',\n        fields: {\n          _id: field.objectId(),\n          title: field.string(),\n          content: field.string().optional(),\n          authorId: field.objectId(),\n        },\n        relations: {\n          author: rel.belongsTo('User', { from: 'authorId', to: '_id' }),\n        },\n      }),\n    },\n  }),\n);\n`;\n}\nfunction configFile(target, contractPath, resolveImportSpecifier = keepInternalSpecifiers) {\n\treturn `import 'dotenv/config';\nimport { defineConfig } from '${targetEntrypoint(target, \"config\", resolveImportSpecifier)}';\n\nexport default defineConfig({\n  contract: ${JSON.stringify(contractPath)},\n  db: {\n    connection: process.env['DATABASE_URL']!,\n  },\n});\n`;\n}\nfunction dbFile(target, resolveImportSpecifier = keepInternalSpecifiers) {\n\tconst runtime = targetEntrypoint(target, \"runtime\", resolveImportSpecifier);\n\tif (target === \"postgres\") return `import postgres from '${runtime}';\nimport type { Contract } from './contract.d';\nimport contractJson from './contract.json' with { type: 'json' };\n\nexport const db = postgres<Contract>({\n  contractJson,\n  url: process.env['DATABASE_URL']!,\n});\n`;\n\treturn `import mongo from '${runtime}';\nimport type { Contract } from './contract.d';\nimport contractJson from './contract.json' with { type: 'json' };\n\nexport const db = mongo<Contract>({\n  contractJson,\n  url: process.env['DATABASE_URL']!,\n});\n`;\n}\n//#endregion\n//#region src/commands/init/index.ts\nfunction createInitCommand() {\n\tconst command = new Command(\"init\");\n\tsetCommandDescriptions(command, \"Initialize a new Prisma Next project\", `Scaffolds config, schema, and runtime files, installs dependencies,\nand emits the contract. Gets you from zero to typed queries in one step.\n\nRun interactively for a guided experience, or supply --target / --authoring\nand --yes for a fully scriptable run (CI, AI coding agents, automation).\n\nExit codes (see CLI Style Guide § Exit Codes):\n  0   OK                    Init succeeded.\\n  1   INTERNAL_ERROR        Unexpected bug in prisma-next (please report).\\n  2   PRECONDITION          Bad flags / missing prerequisite (e.g. no package.json).\\n  3   USER_ABORTED          User cancelled an interactive prompt.\\n  4   INSTALL_FAILED        Dependency installation failed (init-specific).\\n  5   EMIT_FAILED           \\`contract emit\\` failed after install (init-specific).\\n  6   SKILL_INSTALL_FAILED  Agent-skill install failed (re-run with --no-skill to skip).`);\n\tsetCommandExamples(command, [\n\t\t\"prisma-next init\",\n\t\t\"prisma-next init --yes --target postgres --authoring psl\",\n\t\t\"prisma-next init --yes --target mongodb --authoring typescript --json\",\n\t\t\"prisma-next init --yes --force --target postgres --authoring psl  # overwrite an existing scaffold\",\n\t\t\"prisma-next init --no-install                                       # skip pnpm/npm install + emit\",\n\t\t\"prisma-next init --no-skill                                         # skip the skills install (air-gapped / restricted env)\"\n\t]);\n\treturn addGlobalOptions(command).option(\"--target <db>\", \"Database target: postgres or mongodb\").option(\"--authoring <style>\", \"Schema authoring style: psl or typescript\").option(\"--schema-path <path>\", `Where to write the starter schema (default: ${defaultSchemaPath(\"psl\")})`).option(\"--force\", \"Overwrite an existing scaffold without prompting\").option(\"--write-env\", \"Write a .env file from .env.example (gitignored; default: only .env.example)\").option(\"--probe-db\", \"Connect to DATABASE_URL once and check the server version against the target minimum (opt-in; off by default)\").option(\"--strict-probe\", \"Treat a failed --probe-db as fatal (no-op without --probe-db; init is offline-by-default)\").option(\"--no-install\", \"Skip dependency installation and contract emission\").option(\"--no-skill\", \"Skip Prisma Next skills install (air-gapped CI, restricted registries, etc.)\").action(async (options) => {\n\t\tconst { runInit } = await import(\"./init-DHctXAI9.mjs\");\n\t\tconst flags = parseGlobalFlagsOrExit(options);\n\t\tconst canPrompt = deriveCanPrompt({\n\t\t\tflagsInteractive: flags.interactive,\n\t\t\toptionInteractive: options.interactive,\n\t\t\tstdinIsTTY: Boolean(process.stdin.isTTY)\n\t\t});\n\t\tconst exitCode = await runInit(process.cwd(), {\n\t\t\toptions,\n\t\t\tflags,\n\t\t\tcanPrompt\n\t\t});\n\t\tprocess.exit(exitCode);\n\t});\n}\n//#endregion\n//#region src/commands/lsp.ts\nfunction createLspCommand() {\n\tconst command = new Command(\"lsp\");\n\tsetCommandDescriptions(command, \"Start the Prisma Next language server\", \"Launches a Language Server Protocol server that publishes PSL parse diagnostics\\nand handles whole-document PSL formatting for the schema inputs declared in\\nyour config (contract.source.inputs). Formatting uses the Prisma Next PSL\\nformatter and the formatter block from the project config.\\nCommunicates over stdio; intended to be spawned by an\\neditor, not run interactively. The server keeps running until the editor client\\ndisconnects.\");\n\tsetCommandExamples(command, [\"prisma-next lsp --stdio\"]);\n\taddGlobalOptions(command).option(\"--stdio\", \"Communicate with the editor over stdio (the default and only transport)\").action(async () => {\n\t\tconst { startServer } = await import(\"@internal/language-server\");\n\t\tstartServer();\n\t});\n\treturn command;\n}\n//#endregion\n//#region src/utils/suggest-command.ts\n/**\n* Suggests similar command names for a mistyped input.\n*\n* Uses Levenshtein distance to find close matches. Only suggests commands\n* within a reasonable distance threshold (40% of the input length, minimum 2).\n* Returns up to 3 suggestions in case of ties.\n*\n* @returns Array of suggested command names (empty if nothing is close enough).\n*/\nfunction suggestCommands(input, candidates) {\n\tif (candidates.length === 0) return [];\n\tconst maxDistance = Math.max(2, Math.ceil(input.length * .4));\n\tconst scored = candidates.map((name) => ({\n\t\tname,\n\t\tdist: distance(input, name)\n\t})).filter((entry) => entry.dist <= maxDistance).sort((a, b) => a.dist - b.dist);\n\tif (scored.length === 0) return [];\n\tconst bestDist = scored[0].dist;\n\treturn scored.filter((entry) => entry.dist === bestDist).slice(0, 3).map((entry) => entry.name);\n}\n//#endregion\n//#region src/utils/telemetry.ts\n/**\n* Resolve the commander command path from a leaf `Command`, walking up\n* the parent chain. Result is rooted at the program name and ends at\n* the leaf — `['prisma-next', 'migration', 'new']` for\n* `prisma-next migration new …`.\n*/\nfunction commandPathFor(actionCommand) {\n\tconst path = [];\n\tlet cursor = actionCommand;\n\twhile (cursor !== null) {\n\t\tpath.unshift(cursor.name());\n\t\tcursor = cursor.parent;\n\t}\n\treturn path;\n}\nfunction commanderOptionSnapshots(actionCommand) {\n\treturn actionCommand.options.map((option) => {\n\t\tconst attributeName = option.attributeName();\n\t\treturn {\n\t\t\tattributeName,\n\t\t\tlongName: option.long ?? null,\n\t\t\tsource: actionCommand.getOptionValueSource(attributeName) ?? null\n\t\t};\n\t});\n}\n/**\n* Project commander's leaf `Command` into the wire-shape snapshot the\n* telemetry sanitiser consumes. Pure projection — no env, no I/O.\n*/\nfunction commanderSnapshotForTelemetry(actionCommand) {\n\treturn {\n\t\tcommandPath: commandPathFor(actionCommand),\n\t\tpositionalArgs: actionCommand.args,\n\t\toptions: commanderOptionSnapshots(actionCommand)\n\t};\n}\nfunction resolveTelemetryGate() {\n\tif (isCI()) return {\n\t\tenabled: false,\n\t\toutcome: {\n\t\t\tspawned: false,\n\t\t\treason: \"ci\"\n\t\t}\n\t};\n\tconst userConfig = readUserConfig();\n\tif (!resolveGating({\n\t\tenv: process.env,\n\t\tconfig: userConfig\n\t}).enabled) return {\n\t\tenabled: false,\n\t\toutcome: {\n\t\t\tspawned: false,\n\t\t\treason: \"gated-off\"\n\t\t}\n\t};\n\treturn {\n\t\tenabled: true,\n\t\tuserConfig\n\t};\n}\n/**\n* Path to the compiled sender script inside `@internal/cli-telemetry`'s\n* `dist/`. Resolved off this module's `import.meta.url` via the package\n* specifier `@internal/cli-telemetry/sender`, so the consumer pays\n* no attention to internal package layout.\n*/\nfunction senderPath() {\n\treturn fileURLToPath(new URL(import.meta.resolve(\"@internal/cli-telemetry/sender\")));\n}\nfunction fireTelemetry(actionCommand, userConfig) {\n\treturn runTelemetry({\n\t\tcommand: commanderSnapshotForTelemetry(actionCommand),\n\t\tversion,\n\t\tprojectRoot: process.cwd(),\n\t\tsenderPath: senderPath(),\n\t\tisCI: isCI(),\n\t\tenv: process.env,\n\t\tuserConfig\n\t});\n}\n/**\n* preAction-stage entry point. Synchronous by construction: resolve\n* env/CI/user-consent gates (cheap, all in-memory and a single tiny\n* user-config read), then — only when enabled — `fork()` the detached\n* sender script. The forked child loads `prisma-next.config.*` via\n* c12 on its own (see `loadProjectConfig` in cli-telemetry); the\n* parent does no project-config I/O on the command's hot path.\n*\n* Privacy invariant: gate resolution always happens before any project\n* config touches disk. The child loading user TS code is acceptable\n* only because it's gated behind the same resolved-enabled signal.\n*/\n/**\n* Builds the one-time first-run disclosure. The resolved absolute path to\n* the user-level config file is substituted in so the user can see exactly\n* which file to edit (it must not be confused with `prisma-next.config.ts`).\n* `prisma-next telemetry disable` is named as the primary, friendliest\n* opt-out, alongside the env vars and the config edit.\n*/\nfunction firstRunNotice(configPath) {\n\treturn [\n\t\t\"Prisma Next collects anonymous CLI usage data, enabled by default.\",\n\t\t\"What's collected and why: https://prisma-next.dev/docs/cli/telemetry.\",\n\t\t\"Opt out: run \\\"prisma-next telemetry disable\\\", set DO_NOT_TRACK=1 or\",\n\t\t`PRISMA_NEXT_DISABLE_TELEMETRY=1, or set \"enableTelemetry\": false in ${configPath}.`\n\t].join(\" \");\n}\n/**\n* Best-effort first-run disclosure + installationId mint. Runs only on the\n* gating-enabled path. Prints the notice to stderr (never stdout) and mints\n* a persistent id without touching `enableTelemetry`, so the opt-out default\n* stays intact and no unasked-for consent is recorded.\n*\n* Every step is wrapped so an un-writable config dir (or any other failure)\n* never throws and never blocks the command. Returns the minted (or\n* pre-existing) id so the caller can forward it to `runTelemetry` without a\n* redundant disk read. On mint failure it returns `undefined`: the notice may\n* reprint next run, and `runTelemetry` no-ops on the missing id.\n*/\nfunction discloseAndMintOnFirstRun() {\n\ttry {\n\t\tprocess.stderr.write(`${firstRunNotice(userConfigPath())}\\n`);\n\t} catch {}\n\ttry {\n\t\treturn ensureInstallationId();\n\t} catch {}\n}\n/**\n* True when the run is the `telemetry` command (or one of its\n* subcommands). The usage-telemetry preAction fire is exempted for it:\n* it would be absurd for `telemetry disable` to send a usage event before\n* disabling, or for `telemetry status` to mint an id + send while merely\n* reporting state. This is the only command-specific exemption.\n*\n* The check is rooted at the program: the path must be\n* `['prisma-next', 'telemetry', …]`, so it matches the top-level\n* `telemetry` command and its subcommands without matching a hypothetical\n* nested `… telemetry` elsewhere.\n*/\nfunction isTelemetryCommand(actionCommand) {\n\treturn commandPathFor(actionCommand)[1] === \"telemetry\";\n}\nfunction fireTelemetryFromPreAction(actionCommand) {\n\tif (isTelemetryCommand(actionCommand)) return {\n\t\tspawned: false,\n\t\treason: \"gated-off\"\n\t};\n\tconst gate = resolveTelemetryGate();\n\tif (!gate.enabled) return gate.outcome;\n\tconst storedId = gate.userConfig.installationId;\n\tif (typeof storedId !== \"string\" || storedId.length === 0) {\n\t\tconst installationId = discloseAndMintOnFirstRun();\n\t\treturn fireTelemetry(actionCommand, installationId === void 0 ? gate.userConfig : {\n\t\t\t...gate.userConfig,\n\t\t\tinstallationId\n\t\t});\n\t}\n\treturn fireTelemetry(actionCommand, gate.userConfig);\n}\n//#endregion\n//#region src/cli.ts\ninstallShutdownHandlers();\n/**\n* Lookup table mapping removed subcommands to their replacement verbs.\n* Keyed by `<parent>:<subcommand>` (e.g. `migration:apply`).\n* The handler consults this before falling back to the fuzzy suggest engine.\n*/\nconst removedVerbRedirects = {\n\t\"migration:apply\": \"Use `prisma-next migrate --to <contract>` instead.\",\n\t\"migration:ref\": \"Use `prisma-next ref set|list|delete` instead.\"\n};\n/**\n* Removed flags on specific subcommands. Keyed by `<parent>:<sub>:<flag>`.\n* Checked during the pre-parse argv scan before commander sees the flags.\n*/\nconst removedFlagRedirects = {\n\t\"migration:status:graph\": \"Use `prisma-next migration graph` to view the migration graph.\",\n\t\"migration:status:all\": \"Use `prisma-next migration log --db <url>` to view the full execution history.\",\n\t\"migration:status:limit\": \"Use `prisma-next migration log --db <url>` to view the full execution history.\",\n\t\"migration:status:ref\": \"Use `--to <contract>` instead of `--ref`.\"\n};\n/**\n* Formats the \"Did you mean ...?\" hint for an unknown command.\n*/\nfunction formatSuggestion(input, candidates) {\n\tconst suggestions = suggestCommands(input, candidates.map((c) => c));\n\tif (suggestions.length === 0) return \"\";\n\tif (suggestions.length === 1) return `\\nDid you mean ${suggestions[0]}?\\n`;\n\treturn `\\nDid you mean one of these?\\n${suggestions.map((s) => `  ${s}`).join(\"\\n\")}\\n`;\n}\nconst program = new Command();\nprogram.name(\"prisma-next\").description(\"Prisma Next CLI\").version(version);\nprogram.hook(\"preAction\", (_thisCommand, actionCommand) => {\n\ttry {\n\t\tfireTelemetryFromPreAction(actionCommand);\n\t} catch {}\n});\nconst versionOption = program.options.find((opt) => opt.flags.includes(\"--version\"));\nif (versionOption) versionOption.description = \"Output the version number\";\nprogram.configureOutput({\n\twriteErr: () => {},\n\twriteOut: (str) => {\n\t\tprocess.stdout.write(str);\n\t}\n});\nconst rootHelpFormatter = (cmd) => {\n\treturn formatRootHelp({\n\t\tprogram: cmd,\n\t\tflags: parseGlobalFlags({})\n\t});\n};\nprogram.configureHelp({\n\tformatHelp: rootHelpFormatter,\n\tsubcommandDescription: () => \"\"\n});\nprogram.exitOverride((err) => {\n\tif (err) {\n\t\tconst errorCode = err.code;\n\t\tconst errorMessage = String(err.message ?? \"\");\n\t\tconst errorName = err.name ?? \"\";\n\t\tif (errorCode === \"commander.unknownCommand\" || errorCode === \"commander.unknownArgument\" || errorName === \"CommanderError\" && (errorMessage.includes(\"unknown command\") || errorMessage.includes(\"unknown argument\"))) {\n\t\t\tconst flags = parseGlobalFlags({});\n\t\t\tconst match = errorMessage.match(/unknown command ['\"]([^'\"]+)['\"]/);\n\t\t\tconst commandName = match ? match[1] : process.argv[3] || process.argv[2] || \"unknown\";\n\t\t\tconst firstArg = process.argv[2];\n\t\t\tconst parentCommand = firstArg ? program.commands.find((cmd) => cmd.name() === firstArg) : void 0;\n\t\t\tif (parentCommand && commandName !== firstArg) {\n\t\t\t\tconst subNames = parentCommand.commands.map((c) => c.name());\n\t\t\t\tprocess.stderr.write(`Unknown command: ${commandName}${formatSuggestion(commandName, subNames)}\\n`);\n\t\t\t\tconst helpText = formatCommandHelp({\n\t\t\t\t\tcommand: parentCommand,\n\t\t\t\t\tflags\n\t\t\t\t});\n\t\t\t\tprocess.stderr.write(`${helpText}\\n`);\n\t\t\t} else {\n\t\t\t\tconst topNames = program.commands.map((c) => c.name());\n\t\t\t\tprocess.stderr.write(`Unknown command: ${commandName}${formatSuggestion(commandName, topNames)}\\n`);\n\t\t\t\tconst helpText = formatRootHelp({\n\t\t\t\t\tprogram,\n\t\t\t\t\tflags\n\t\t\t\t});\n\t\t\t\tprocess.stderr.write(`${helpText}\\n`);\n\t\t\t}\n\t\t\tprocess.exit(2);\n\t\t\treturn;\n\t\t}\n\t\tif (errorCode === \"commander.help\" || errorCode === \"commander.helpDisplayed\" || errorCode === \"outputHelp\" || errorMessage === \"(outputHelp)\" || errorMessage.includes(\"outputHelp\") || errorName === \"CommanderError\" && errorMessage.includes(\"outputHelp\")) {\n\t\t\tprocess.exit(0);\n\t\t\treturn;\n\t\t}\n\t\tif (errorCode === \"commander.missingArgument\" || errorCode === \"commander.missingMandatoryOptionValue\" || errorName === \"CommanderError\" && (errorMessage.includes(\"missing\") || errorMessage.includes(\"required\"))) {\n\t\t\tprocess.exit(2);\n\t\t\treturn;\n\t\t}\n\t\tprocess.stderr.write(`Unhandled error: ${err.message}\\n`);\n\t\tif (err.stack) process.stderr.write(`${err.stack}\\n`);\n\t\tprocess.exit(1);\n\t}\n\tprocess.exit(0);\n});\nconst contractCommand = new Command(\"contract\");\nsetCommandDescriptions(contractCommand, \"Contract management commands\", \"Define and emit your application data contract. The contract describes your schema as a\\ndeclarative data structure that can be signed and verified against your database.\");\ncontractCommand.configureHelp({\n\tformatHelp: (cmd) => {\n\t\treturn formatCommandHelp({\n\t\t\tcommand: cmd,\n\t\t\tflags: parseGlobalFlags({})\n\t\t});\n\t},\n\tsubcommandDescription: () => \"\"\n});\nconst contractEmitCommand = createContractEmitCommand();\ncontractCommand.addCommand(contractEmitCommand);\nconst contractInferCommand = createContractInferCommand();\ncontractCommand.addCommand(contractInferCommand);\nconst dbCommand = new Command(\"db\");\nsetCommandDescriptions(dbCommand, \"Database management commands\", \"Verify and sign your database with your contract. Ensure your database schema matches\\nyour contract, and sign it to record the contract hash for future verification.\");\ndbCommand.configureHelp({\n\tformatHelp: (cmd) => {\n\t\treturn formatCommandHelp({\n\t\t\tcommand: cmd,\n\t\t\tflags: parseGlobalFlags({})\n\t\t});\n\t},\n\tsubcommandDescription: () => \"\"\n});\nconst dbVerifyCommand = createDbVerifyCommand();\ndbCommand.addCommand(dbVerifyCommand);\nconst dbInitCommand = createDbInitCommand();\ndbCommand.addCommand(dbInitCommand);\nconst dbUpdateCommand = createDbUpdateCommand();\ndbCommand.addCommand(dbUpdateCommand);\nconst dbSchemaCommand = createDbSchemaCommand();\ndbCommand.addCommand(dbSchemaCommand);\nconst dbSignCommand = createDbSignCommand();\ndbCommand.addCommand(dbSignCommand);\nconst migrationCommand = new Command(\"migration\");\nsetCommandDescriptions(migrationCommand, \"On-disk migration management commands\", \"Plan, apply, and scaffold on-disk migration packages. Migrations are\\ncontract-to-contract edges stored as versioned directories under migrations/.\");\nmigrationCommand.configureHelp({\n\tformatHelp: (cmd) => {\n\t\treturn formatCommandHelp({\n\t\t\tcommand: cmd,\n\t\t\tflags: parseGlobalFlags({})\n\t\t});\n\t},\n\tsubcommandDescription: () => \"\"\n});\nconst migrationPlanCommand = createMigrationPlanCommand();\nmigrationCommand.addCommand(migrationPlanCommand);\nconst migrationNewCommand = createMigrationNewCommand();\nmigrationCommand.addCommand(migrationNewCommand);\nconst migrationShowCommand = createMigrationShowCommand();\nmigrationCommand.addCommand(migrationShowCommand);\nconst migrationStatusCommand = createMigrationStatusCommand();\nmigrationCommand.addCommand(migrationStatusCommand);\nconst migrationLogCommand = createMigrationLogCommand();\nmigrationCommand.addCommand(migrationLogCommand);\nconst migrationListCommand = createMigrationListCommand();\nmigrationCommand.addCommand(migrationListCommand);\nconst migrationGraphCommand = createMigrationGraphCommand();\nmigrationCommand.addCommand(migrationGraphCommand);\nconst migrationCheckCommand = createMigrationCheckCommand();\nmigrationCommand.addCommand(migrationCheckCommand);\nconst migrateCommand = createMigrateCommand();\nconst refCommand = createRefCommand();\nconst telemetryCommand = createTelemetryCommand();\nconst initCommand = createInitCommand();\nconst formatCommand = createFormatCommand();\nconst lspCommand = createLspCommand();\nprogram.addCommand(initCommand);\nprogram.addCommand(migrateCommand);\nprogram.addCommand(formatCommand);\nprogram.addCommand(lspCommand);\nprogram.addCommand(contractCommand);\nprogram.addCommand(dbCommand);\nprogram.addCommand(migrationCommand);\nprogram.addCommand(refCommand);\nprogram.addCommand(telemetryCommand);\nconst TELEMETRY_CRASH_TEST_SLEEP_MS = 200;\nif (process.env[\"PRISMA_NEXT_ENABLE_TEST_COMMANDS\"] === \"1\") {\n\tconst telemetryCrashTestCommand = new Command(\"__telemetry-crash-test\").description(\"Internal: deliberately throw for the telemetry e2e suite.\").action(async () => {\n\t\tawait new Promise((settle) => setTimeout(settle, TELEMETRY_CRASH_TEST_SLEEP_MS));\n\t\tthrow new Error(\"__telemetry-crash-test: intentional crash for e2e coverage\");\n\t});\n\ttelemetryCrashTestCommand.configureHelp({ visibleCommands: () => [] });\n\tprogram.addCommand(telemetryCrashTestCommand, { hidden: true });\n}\nconst helpCommand = new Command(\"help\").description(\"Show usage instructions\").configureHelp({ formatHelp: (cmd) => {\n\treturn formatCommandHelp({\n\t\tcommand: cmd,\n\t\tflags: parseGlobalFlags({})\n\t});\n} }).action(() => {\n\tconst flags = parseGlobalFlags({});\n\tconst helpText = formatRootHelp({\n\t\tprogram,\n\t\tflags\n\t});\n\tprocess.stdout.write(`${helpText}\\n`);\n\tprocess.exit(0);\n});\nprogram.addCommand(helpCommand);\nprogram.action(() => {\n\tconst flags = parseGlobalFlags({});\n\tconst helpText = formatRootHelp({\n\t\tprogram,\n\t\tflags\n\t});\n\tprocess.stderr.write(`${helpText}\\n`);\n\tprocess.exit(0);\n});\nconst args = process.argv.slice(2);\nif (args.length > 0) {\n\tconst commandName = args[0];\n\tif (commandName === \"--version\" || commandName === \"-V\") {\n\t\tprocess.stdout.write(`${program.version()}\\n`);\n\t\tprocess.exit(0);\n\t}\n\tif (!(commandName === \"--help\" || commandName === \"-h\")) {\n\t\tconst command = program.commands.find((cmd) => cmd.name() === commandName);\n\t\tif (!command) {\n\t\t\tconst flags = parseGlobalFlags({});\n\t\t\tconst topNames = program.commands.map((c) => c.name());\n\t\t\tprocess.stderr.write(`Unknown command: ${commandName}${formatSuggestion(commandName, topNames)}\\n`);\n\t\t\tconst helpText = formatRootHelp({\n\t\t\t\tprogram,\n\t\t\t\tflags\n\t\t\t});\n\t\t\tprocess.stderr.write(`${helpText}\\n`);\n\t\t\tprocess.exit(2);\n\t\t} else if (command.commands.length > 0 && args.length >= 2) {\n\t\t\tconst subcommandName = args[1];\n\t\t\tconst redirect = removedVerbRedirects[`${commandName}:${subcommandName}`];\n\t\t\tif (redirect) {\n\t\t\t\tprocess.stderr.write(`Unknown command: ${subcommandName}\\n${redirect}\\n`);\n\t\t\t\tprocess.exit(2);\n\t\t\t}\n\t\t\tfor (let i = 2; i < args.length; i++) {\n\t\t\t\tconst arg = args[i];\n\t\t\t\tif (!arg.startsWith(\"--\")) continue;\n\t\t\t\tconst flagRedirect = removedFlagRedirects[`${commandName}:${subcommandName}:${arg.slice(2)}`];\n\t\t\t\tif (flagRedirect) {\n\t\t\t\t\tprocess.stderr.write(`Unknown option: ${arg}\\n${flagRedirect}\\n`);\n\t\t\t\t\tprocess.exit(2);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tif (command.commands.length > 0 && args.length === 1) {\n\t\t\tconst helpText = formatCommandHelp({\n\t\t\t\tcommand,\n\t\t\t\tflags: parseGlobalFlags({})\n\t\t\t});\n\t\t\tprocess.stderr.write(`${helpText}\\n`);\n\t\t\tprocess.exit(0);\n\t\t}\n\t}\n}\nprogram.parse();\n//#endregion\nexport { schemaSample as a, targetLabel as c, scaffoldSpecifierResolverFor as i, targetPackageName as l, dbFile as n, starterSchema as o, defaultSchemaPath as r, targetEntrypoint as s, configFile as t, version as u };\n\n//# sourceMappingURL=cli.mjs.map"],"mappings":"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"}

package/dist/cli-telemetry.d.mts

@@ -0,0 +1,367 @@
+//#region ../../../1-framework/3-tooling/cli-telemetry/dist/exports/index.d.mts
+//#region src/endpoint.d.ts
+/**
+ * Production endpoint pinned to the deployed Prisma Compute backend.
+ * Compiled as a build-time constant; not user-configurable.
+ */
+declare const TELEMETRY_BACKEND_URL = "https://cmpbfbsdp09hr3jf7pojjs5qs.ewr.prisma.build";
+/**
+ * Path within the backend that accepts telemetry POSTs.
+ */
+declare const TELEMETRY_ENDPOINT_PATH = "/events";
+/**
+ * Resolve the full POST URL the sender targets. The
+ * `PRISMA_NEXT_TELEMETRY_ENDPOINT` env var is an integration-testing
+ * affordance only — it lets the test suite spin up a mock HTTP server
+ * on an ephemeral port and point the spawned sender at it. The override
+ * is intentionally undocumented in user-facing material.
+ *
+ * Fail-open: a malformed override (typo in a dev shell, bad CI config)
+ * silently falls back to the production backend rather than throwing,
+ * matching the telemetry layer's broader silent-on-failure contract.
+ */
+declare function resolveTelemetryEndpoint(env?: Readonly<Record<string, string | undefined>>): string;
+//#endregion
+//#region src/payload.d.ts
+/**
+ * Wire-shape payload the parent IPC-sends to the forked child sender.
+ * Mirrors only the fields the parent has naturally in hand at command
+ * start: installation id, sanitised command + flags, CLI version, and
+ * the project root the child uses to discover everything else. The
+ * child probes its own process (runtime/os/arch, package manager, ts
+ * version, agent) and reads the user's `prisma-next.config.*` via
+ * c12 to derive `databaseTarget` and `extensions`.
+ *
+ * Loading c12 on the parent side would put a `loadConfig()` await on
+ * the command's hot path between gate resolution and `fork()`,
+ * opening a race against any CLI command that throws synchronously
+ * before that await resolves (the parent exits before forking the
+ * sender, and the telemetry event is lost). Moving the load into the
+ * detached child eliminates that race; the trade is that the child
+ * now evaluates user TS config code, so it's gated behind the same
+ * privacy checks the parent already resolved before forking.
+ *
+ * `databaseTarget` is an optional parent-side override for the
+ * c12-derived value: the first-`init` invocation supplies the
+ * prompt-chosen target via this field because the config file does
+ * not yet exist on disk at that moment. Every other invocation
+ * leaves it unset (`undefined`) and the child's c12 load determines
+ * the value — there is no third state, so the field's type is
+ * `string | undefined`, not `string | null | undefined`.
+ *
+ * Both sides version-couple on this shape because the IPC carrier is
+ * structured-cloned by Node and there's no on-wire compat to maintain.
+ */
+interface ParentToSenderPayload {
+  readonly installationId: string;
+  readonly version: string;
+  readonly command: string;
+  readonly flags: readonly string[];
+  /**
+   * Absolute path of the user's project. The child reads
+   * `<projectRoot>/package.json` for `tsVersion` and loads
+   * `<projectRoot>/prisma-next.config.*` via c12 for `databaseTarget`
+   * + `extensions`.
+   */
+  readonly projectRoot: string;
+  /** Resolved endpoint URL (already includes the `/events` path). */
+  readonly endpoint: string;
+  /**
+   * Optional parent-side override for the c12-derived database target.
+   * Set by `fireTelemetryAfterInitConsent` (the first-`init` path,
+   * where the config file is about to be written but doesn't exist
+   * yet); left undefined by `fireTelemetryFromPreAction` (steady
+   * state, child resolves the value via c12). The wire-format
+   * `TelemetryEvent.databaseTarget: string | null` keeps `null` as
+   * the on-the-wire "no target known" marker, but the IPC override
+   * channel only needs two states so it's `string | undefined`.
+   */
+  readonly databaseTarget?: string;
+}
+/**
+ * The full event the child POSTs to the backend. Shape matches the
+ * backend's arktype schema (`apps/telemetry-backend/src/schema.ts`).
+ */
+interface TelemetryEvent {
+  readonly installationId: string;
+  readonly version: string;
+  readonly command: string;
+  readonly flags: readonly string[];
+  readonly runtimeName: string;
+  readonly runtimeVersion: string;
+  readonly os: string;
+  readonly arch: string;
+  readonly packageManager: string | null;
+  readonly databaseTarget: string | null;
+  readonly tsVersion: string | null;
+  readonly agent: string | null;
+  readonly extensions: readonly string[];
+}
+//#endregion
+//#region src/enrich.d.ts
+/**
+ * Subset of the user's `prisma-next.config.*` the telemetry event
+ * surfaces. Loaded inside the detached child via {@link loadProjectConfig}
+ * — see the design rationale on {@link ParentToSenderPayload} for why
+ * this side runs c12 instead of the parent CLI.
+ */
+interface ProjectConfigFields {
+  readonly databaseTarget: string | null;
+  readonly extensions: readonly string[];
+}
+/**
+ * Best-effort load of `prisma-next.config.*` from `projectRoot`,
+ * validated against the canonical `@internal/config` schema.
+ * Returns `{ databaseTarget: null, extensions: [] }` on any failure
+ * mode — missing config file (e.g. before `prisma-next init`), c12
+ * throws while evaluating user TS, validator rejects a malformed
+ * shape, etc. Telemetry is non-blocking and best-effort; an empty
+ * result is the only downside of an unloadable or invalid config.
+ *
+ * Both `c12` and `@internal/config/config-validation` are imported
+ * lazily so the detached sender's cold-start cost is paid only when
+ * telemetry actually fires, not on every fork even when gates
+ * short-circuit before reaching this code path.
+ */
+declare function loadProjectConfig(projectRoot: string): Promise<ProjectConfigFields>;
+//#endregion
+//#region src/user-config.d.ts
+/**
+ * The user-level config file. Persists the telemetry flag and the
+ * installation UUID. Under the opt-out model the flag stays `undefined`
+ * until the user makes an explicit choice (default-on first run mints
+ * only the id via {@link ensureInstallationId}), and an env-var opt-out
+ * never mutates disk. Once the id exists it survives any
+ * on → off → on cycle, keeping the same UUID (correct for MAU continuity).
+ *
+ * Readers tolerate unknown fields for forward compat; writers merge
+ * partials into the existing object so unknown fields are preserved.
+ */
+interface UserConfig {
+  readonly enableTelemetry?: boolean;
+  readonly installationId?: string;
+  readonly [key: string]: unknown;
+}
+/**
+ * Path to the user-level config file. Resolved per call so test
+ * harnesses can mutate `$XDG_CONFIG_HOME` between cases.
+ */
+declare function userConfigPath(): string;
+/**
+ * Reads the user-level config. File-missing, unreadable, or malformed →
+ * `{}` (the absence of consent is the same answer in every error mode).
+ * Unknown fields from a future client are passed through verbatim.
+ */
+declare function readUserConfig(): UserConfig;
+/**
+ * Merges `partial` into the current config and writes the result
+ * atomically (temp file + rename) so a crash mid-write never leaves a
+ * half-baked file readable on disk. Unknown fields already on disk are
+ * preserved.
+ *
+ * When `partial.enableTelemetry === true` and no `installationId` is
+ * stored yet, generates a v4 random UUID and persists both fields in
+ * the same write. An existing `installationId` is never rotated. This is
+ * the *explicit-consent* mint path: a `false` answer
+ * (`writeUserConfig({ enableTelemetry: false })`) writes no id, and a bare
+ * `writeUserConfig({ installationId })` mints nothing extra. The default-on
+ * first-send path mints its id separately via {@link ensureInstallationId},
+ * which records no consent answer.
+ */
+declare function writeUserConfig(partial: Partial<UserConfig>): void;
+/**
+ * Returns the stored `installationId`, minting and persisting a fresh v4
+ * UUID when none exists yet. Crucially, this persists *only* the id —
+ * `enableTelemetry` is left untouched (stays `undefined` on a default-on
+ * first run), so the interactive `init` consent prompt is not wrongly
+ * suppressed and no explicit consent the user never gave is recorded.
+ *
+ * Used by the default-on first-run fire path: the gate has already
+ * resolved enabled, so this only ever runs when telemetry is on.
+ */
+declare function ensureInstallationId(): string;
+//#endregion
+//#region src/gating.d.ts
+/**
+ * Why telemetry was disabled. Useful for debug-mode logging in the
+ * parent; never surfaces to users.
+ */
+type GatingDisabledReason = 'env-override' | 'stored-opt-out';
+type GatingResolution = {
+  readonly enabled: true;
+} | {
+  readonly enabled: false;
+  readonly reason: GatingDisabledReason;
+};
+interface GatingInputs {
+  /**
+   * Environment-variable lookups the resolver consults. Tests pass a
+   * literal record; production passes `process.env`. The two opt-out
+   * signals are `PRISMA_NEXT_DISABLE_TELEMETRY` (Prisma-specific) and
+   * `DO_NOT_TRACK` (community convention).
+   */
+  readonly env: Readonly<Record<string, string | undefined>>;
+  /** Result of `readUserConfig()` — file-missing tolerated as `{}`. */
+  readonly config: UserConfig;
+}
+/**
+ * Pure-function resolution of the gating decision. Same input → same
+ * output; no I/O. The caller is responsible for reading the env and the
+ * user config.
+ *
+ * Decision order:
+ *   1. Env-var override (`PRISMA_NEXT_DISABLE_TELEMETRY` truthy, or
+ *      `DO_NOT_TRACK=1`) → disabled. The env check runs first, so an
+ *      opt-out env var wins over any stored or unset preference.
+ *   2. Stored `enableTelemetry === false` → disabled (`stored-opt-out`).
+ *   3. Stored `enableTelemetry === true` → enabled.
+ *   4. Stored `enableTelemetry === undefined` (file missing, or field
+ *      not set) → ENABLED. This is the opt-out default: absence of an
+ *      explicit choice means telemetry is on. This is the load-bearing,
+ *      counter-intuitive branch — do not "fix" it to default-off.
+ *
+ * Telemetry is disabled only when an env override is active or
+ * `enableTelemetry` is explicitly `false`.
+ */
+declare function resolveGating(inputs: GatingInputs): GatingResolution;
+//#endregion
+//#region src/sanitize.d.ts
+interface CommanderOptionShape {
+  /** Commander's option attribute name, e.g. `dryRun` for `--dry-run`. */
+  readonly attributeName: string;
+  /** Commander's long, user-facing flag spelling, e.g. `--dry-run` or `--no-install`. */
+  readonly longName: string | null;
+  /** Commander's value source for this option. Only `cli` is user-supplied. */
+  readonly source: string | null;
+}
+/**
+ * Input shape: a thin projection of commander's parsed-result surface.
+ * The parent extracts the command path, positional args, and per-option
+ * metadata from the leaf command. The sanitiser never consumes raw
+ * argv, never reads `process.argv`, and never sees flag values.
+ */
+interface CommanderResultShape {
+  /**
+   * The full command path from the root program to the leaf, including
+   * the root program name as the first element (the sanitiser drops it).
+   * Example: `['prisma-next', 'migration', 'new']`.
+   */
+  readonly commandPath: readonly string[];
+  /**
+   * Positional arguments commander parsed for the leaf command.
+   * **Intentionally never read.** Accepted so the call site doesn't have
+   * to think about whether to pass it; the sanitiser's contract is that
+   * positionals never leave the parent process.
+   */
+  readonly positionalArgs: readonly string[];
+  /**
+   * Per-option Commander metadata. The sanitiser emits only options whose
+   * source is `cli`, and uses `longName` so telemetry sees user-facing
+   * names (`dry-run`, `connection-string`, `no-install`) rather than
+   * Commander's internal camelCase attribute names or defaulted options.
+   */
+  readonly options: readonly CommanderOptionShape[];
+}
+/**
+ * Output shape: the sanitised projection that flows into the telemetry
+ * payload. Two fields only — command name (space-delimited subcommand
+ * path) and flag names (in commander's option declaration order).
+ */
+interface SanitisedCommand {
+  readonly command: string;
+  readonly flags: readonly string[];
+}
+/**
+ * Project commander's parsed result into the wire-shape command and
+ * flag-name list. Pure; the only allowed inputs are the fields of
+ * `CommanderResultShape`.
+ *
+ * Sanitiser contract — no flag values, no positionals, no raw argv:
+ *   - Drop the root program name (`commandPath[0]`); the wire ships
+ *     `migration new`, not `prisma-next migration new`.
+ *   - Emit only options whose Commander source is `cli`.
+ *   - Emit the long user-facing flag spelling without the `--` prefix;
+ *     never emit Commander's camelCase attribute names.
+ *   - `positionalArgs` is accepted but never consumed; the field exists
+ *     in the input type to make it obvious at the call site that
+ *     positionals were deliberately excluded.
+ */
+declare function sanitizeCommanderResult(input: CommanderResultShape): SanitisedCommand;
+//#endregion
+//#region src/spawn.d.ts
+/**
+ * Inputs the CLI entry point hands the telemetry layer at command
+ * start. The CLI is responsible for stitching commander's result and
+ * the project root together; the telemetry module does no I/O of its
+ * own except for the user-config read (skipped when `userConfig` is
+ * provided). `extensions` is deliberately absent: the detached child
+ * loads `prisma-next.config.*` via c12 itself and derives the
+ * extension-pack ids from the validated config — see the rationale
+ * on `ParentToSenderPayload` for why c12 lives in the child rather
+ * than on the parent's hot path.
+ *
+ * `databaseTarget` is an optional parent-side override forwarded to
+ * the child. Set by `fireTelemetryAfterInitConsent` (where the
+ * config file does not yet exist on disk); left unset by the
+ * preAction-hook path so the child's c12 load supplies the value.
+ */
+interface RunTelemetryInputs {
+  /** Sanitised commander snapshot — see `CommanderResultShape`. */
+  readonly command: CommanderResultShape;
+  /** This CLI's own version (from its `package.json`). */
+  readonly version: string;
+  /** Absolute path of the project root (typically `process.cwd()`). */
+  readonly projectRoot: string;
+  /**
+   * Optional parent-side override for the c12-derived database target,
+   * forwarded verbatim to the child sender. Wins over the child's
+   * c12-derived value when present; `undefined` means "no override".
+   */
+  readonly databaseTarget?: string;
+  /**
+   * Path to the sender entry compiled into this package's `dist/`.
+   * Resolved by the caller because the compiled sender lives at
+   * `<package>/dist/sender.mjs` and only the consumer knows its own
+   * `import.meta.url`.
+   */
+  readonly senderPath: string;
+  /**
+   * `isCI()` result from the consumer. Telemetry is suppressed when
+   * `true` regardless of the stored consent answer — CI environments
+   * never emit (matches the colour-output convention's CI suppression).
+   */
+  readonly isCI: boolean;
+  /** Process env to read for opt-out signals. Defaults to `process.env`. */
+  readonly env?: Readonly<Record<string, string | undefined>>;
+  /** Cached user config when the caller already read it to resolve gates before other work. */
+  readonly userConfig?: UserConfig;
+}
+/**
+ * Best-effort telemetry spawn at command start. Returns synchronously —
+ * the fork runs in the background and never blocks the parent. Every
+ * failure mode is swallowed; the parent's stdout/stderr is untouched in
+ * normal operation, the only escape valve being
+ * `PRISMA_NEXT_DEBUG=1` which routes diagnostics to stderr.
+ *
+ * Returns the spawn outcome so debug-mode logging and the test-harness
+ * probe (which verifies test runs short-circuit the fork) can inspect
+ * the decision without scraping stderr.
+ */
+type TelemetryRunOutcome = {
+  readonly spawned: true;
+} | {
+  readonly spawned: false;
+  readonly reason: 'gated-off' | 'ci' | 'fork-failed';
+};
+declare function runTelemetry(inputs: RunTelemetryInputs): TelemetryRunOutcome;
+/**
+ * Resolve the path to the compiled sender entry relative to a consumer
+ * that has captured its own `import.meta.url`. The CLI's
+ * `tsdown`-emitted entry sits at `<package>/dist/sender.mjs`; the
+ * consumer asks `senderModuleUrl()` and forwards the result to
+ * `runTelemetry({ senderPath })`.
+ */
+declare function senderModuleUrl(importMetaUrl: string): string;
+//#endregion
+export { type CommanderOptionShape, type CommanderResultShape, type GatingDisabledReason, type GatingInputs, type GatingResolution, type ParentToSenderPayload, type ProjectConfigFields, type RunTelemetryInputs, type SanitisedCommand, TELEMETRY_BACKEND_URL, TELEMETRY_ENDPOINT_PATH, type TelemetryEvent, type TelemetryRunOutcome, type UserConfig, ensureInstallationId, loadProjectConfig, readUserConfig, resolveGating, resolveTelemetryEndpoint, runTelemetry, sanitizeCommanderResult, senderModuleUrl, userConfigPath, writeUserConfig };
+//# sourceMappingURL=cli-telemetry.d.mts.map

package/dist/cli-telemetry.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-telemetry.d.mts","names":[],"sources":["../../../../1-framework/3-tooling/cli-telemetry/dist/exports/index.d.mts"],"mappings":";;;;;;cAKc;;;;cAIA;;;;;;;;;;;;iBAYG,yBAAyB,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAgC/C;WACC;WACA;WACA;WACA;;;;;;;WAOA;;WAEA;;;;;;;;;;;WAWA;;;;;;UAMD;WACC;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;;;;;;;;;;UAUD;WACC;WACA;;;;;;;;;;;;;;;;iBAgBM,kBAAkB,sBAAsB,QAAQ;;;;;;;;;;;;;;UAcvD;WACC;WACA;YACC;;;;;;iBAMK;;;;;;iBAMA,kBAAkB;;;;;;;;;;;;;;;;iBAgBlB,gBAAgB,SAAS,QAAQ;;;;;;;;;;;iBAWjC;;;;;;;KAOZ;KACA;WACM;;WAEA;WACA,QAAQ;;UAET;;;;;;;WAOC,KAAK,SAAS;;WAEd,QAAQ;;;;;;;;;;;;;;;;;;;;;iBAqBF,cAAc,QAAQ,eAAe;;;UAG5C;;WAEC;;WAEA;;WAEA;;;;;;;;UAQD;;;;;;WAMC;;;;;;;WAOA;;;;;;;WAOA,kBAAkB;;;;;;;UAOnB;WACC;WACA;;;;;;;;;;;;;;;;;iBAiBM,wBAAwB,OAAO,uBAAuB;;;;;;;;;;;;;;;;;;;UAmB7D;;WAEC,SAAS;;WAET;;WAEA;;;;;;WAMA;;;;;;;WAOA;;;;;;WAMA;;WAEA,MAAM,SAAS;;WAEf,aAAa;;;;;;;;;;;;;KAanB;WACM;;WAEA;WACA;;iBAEM,aAAa,QAAQ,qBAAqB;;;;;;;;iBAQ1C,gBAAgB"}

package/dist/cli-telemetry.mjs

@@ -0,0 +1,48 @@
+import { a as resolveGating, c as sanitizeCommanderResult, d as writeUserConfig, i as readUserConfig, l as senderModuleUrl, n as TELEMETRY_ENDPOINT_PATH, o as resolveTelemetryEndpoint, r as ensureInstallationId, s as runTelemetry, t as TELEMETRY_BACKEND_URL, u as userConfigPath } from "./exports-BN0vFTxG.mjs";
+import "pathe";
+import "node:fs";
+import "@vercel/detect-agent";
+//#region ../../../1-framework/3-tooling/cli-telemetry/dist/enrich-CtoCke3N.mjs
+const EMPTY_PROJECT_CONFIG = {
+	databaseTarget: null,
+	extensions: []
+};
+/**
+* Best-effort load of `prisma-next.config.*` from `projectRoot`,
+* validated against the canonical `@internal/config` schema.
+* Returns `{ databaseTarget: null, extensions: [] }` on any failure
+* mode — missing config file (e.g. before `prisma-next init`), c12
+* throws while evaluating user TS, validator rejects a malformed
+* shape, etc. Telemetry is non-blocking and best-effort; an empty
+* result is the only downside of an unloadable or invalid config.
+*
+* Both `c12` and `@internal/config/config-validation` are imported
+* lazily so the detached sender's cold-start cost is paid only when
+* telemetry actually fires, not on every fork even when gates
+* short-circuit before reaching this code path.
+*/
+async function loadProjectConfig(projectRoot) {
+	try {
+		const { loadConfig } = await import("c12");
+		const config = (await loadConfig({
+			name: "prisma-next",
+			cwd: projectRoot,
+			dotenv: false,
+			rcFile: false,
+			globalRc: false
+		})).config ?? null;
+		if (config === null || Object.keys(config).length === 0) return EMPTY_PROJECT_CONFIG;
+		const validate = (await import("@prisma/orm-framework/config/config-validation")).validateConfig;
+		validate(config);
+		return {
+			databaseTarget: config.target.targetId,
+			extensions: (config.extensions ?? []).map((pack) => pack.id)
+		};
+	} catch {
+		return EMPTY_PROJECT_CONFIG;
+	}
+}
+//#endregion
+export { TELEMETRY_BACKEND_URL, TELEMETRY_ENDPOINT_PATH, ensureInstallationId, loadProjectConfig, readUserConfig, resolveGating, resolveTelemetryEndpoint, runTelemetry, sanitizeCommanderResult, senderModuleUrl, userConfigPath, writeUserConfig };
+
+//# sourceMappingURL=cli-telemetry.mjs.map

package/dist/cli-telemetry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-telemetry.mjs","names":[],"sources":["../../../../1-framework/3-tooling/cli-telemetry/dist/enrich-CtoCke3N.mjs"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { determineAgent } from \"@vercel/detect-agent\";\nimport { join } from \"pathe\";\n//#region src/enrich.ts\nconst EMPTY_PROJECT_CONFIG = {\n\tdatabaseTarget: null,\n\textensions: []\n};\n/**\n* Best-effort load of `prisma-next.config.*` from `projectRoot`,\n* validated against the canonical `@internal/config` schema.\n* Returns `{ databaseTarget: null, extensions: [] }` on any failure\n* mode — missing config file (e.g. before `prisma-next init`), c12\n* throws while evaluating user TS, validator rejects a malformed\n* shape, etc. Telemetry is non-blocking and best-effort; an empty\n* result is the only downside of an unloadable or invalid config.\n*\n* Both `c12` and `@internal/config/config-validation` are imported\n* lazily so the detached sender's cold-start cost is paid only when\n* telemetry actually fires, not on every fork even when gates\n* short-circuit before reaching this code path.\n*/\nasync function loadProjectConfig(projectRoot) {\n\ttry {\n\t\tconst { loadConfig } = await import(\"c12\");\n\t\tconst config = (await loadConfig({\n\t\t\tname: \"prisma-next\",\n\t\t\tcwd: projectRoot,\n\t\t\tdotenv: false,\n\t\t\trcFile: false,\n\t\t\tglobalRc: false\n\t\t})).config ?? null;\n\t\tif (config === null || Object.keys(config).length === 0) return EMPTY_PROJECT_CONFIG;\n\t\tconst validate = (await import(\"@internal/config/config-validation\")).validateConfig;\n\t\tvalidate(config);\n\t\treturn {\n\t\t\tdatabaseTarget: config.target.targetId,\n\t\t\textensions: (config.extensions ?? []).map((pack) => pack.id)\n\t\t};\n\t} catch {\n\t\treturn EMPTY_PROJECT_CONFIG;\n\t}\n}\n/**\n* Identify the runtime the sender is running in. Same-runtime as the\n* parent is a correctness requirement: the parent forked us via\n* `child_process.fork`, which inherits the parent's runtime. Detection\n* keys on the runtime-specific version field rather than env vars so a\n* spoofed env can't lie about the actual interpreter.\n*/\nfunction resolveRuntime(versions) {\n\tif (versions.bun !== void 0) return {\n\t\tname: \"bun\",\n\t\tversion: versions.bun\n\t};\n\tif (versions.deno !== void 0) return {\n\t\tname: \"deno\",\n\t\tversion: versions.deno\n\t};\n\treturn {\n\t\tname: \"node\",\n\t\tversion: versions.node\n\t};\n}\n/**\n* Parse `npm_config_user_agent` into a `<pm>/<version>` token. The\n* value, when present, looks like\n* `\"pnpm/10.27.0 npm/? node/v24.13.0 darwin arm64\"` — we take the first\n* whitespace-separated token. Any failure → `null`.\n*/\nfunction parsePackageManager(userAgent) {\n\tif (userAgent === void 0) return null;\n\tconst first = userAgent.split(/\\s+/)[0];\n\tif (first === void 0 || first.length === 0) return null;\n\tif (!first.includes(\"/\")) return null;\n\treturn first;\n}\n/**\n* Read the user's project `package.json` and resolve a TypeScript\n* version from `devDependencies.typescript` (preferred) or\n* `dependencies.typescript`. Strips a leading `^` or `~` semver\n* prefix. Returns `null` on any failure mode — file missing,\n* unreadable, malformed JSON, key absent, not a string.\n*/\nfunction readTsVersionFromPackageJson(raw) {\n\tif (raw === null) return null;\n\tlet parsed;\n\ttry {\n\t\tparsed = JSON.parse(raw);\n\t} catch {\n\t\treturn null;\n\t}\n\tconst candidate = pickStringDep(parsed[\"devDependencies\"]) ?? pickStringDep(parsed[\"dependencies\"]);\n\tif (candidate === null) return null;\n\treturn candidate.replace(/^[\\^~]/, \"\");\n}\nfunction pickStringDep(deps) {\n\tif (deps === null || typeof deps !== \"object\" || Array.isArray(deps)) return null;\n\tconst value = deps[\"typescript\"];\n\treturn typeof value === \"string\" ? value : null;\n}\n/**\n* Build the full backend event from the parent's payload, the\n* c12-loaded project-config slice, and the child's per-process\n* snapshot. Pure given a `projectConfig` + `EnrichEnvironment`.\n*/\nfunction buildTelemetryEvent(payload, projectConfig, env) {\n\tconst runtime = resolveRuntime(env.versions);\n\treturn {\n\t\tinstallationId: payload.installationId,\n\t\tversion: payload.version,\n\t\tcommand: payload.command,\n\t\tflags: payload.flags,\n\t\truntimeName: runtime.name,\n\t\truntimeVersion: runtime.version,\n\t\tos: env.platform,\n\t\tarch: env.arch,\n\t\tpackageManager: parsePackageManager(env.env[\"npm_config_user_agent\"]),\n\t\tdatabaseTarget: projectConfig.databaseTarget,\n\t\ttsVersion: readTsVersionFromPackageJson(env.readProjectPackageJson()),\n\t\tagent: env.agent,\n\t\textensions: projectConfig.extensions\n\t};\n}\n/**\n* Resolve the agent label for the telemetry event via\n* `@vercel/detect-agent`, collapsing its discriminated result to the\n* event's `string | null` shape. Any detection failure counts as\n* \"no agent\" — telemetry is best-effort and non-blocking.\n*/\nasync function resolveAgentLabel() {\n\ttry {\n\t\tconst result = await determineAgent();\n\t\treturn result.isAgent ? result.agent.name : null;\n\t} catch {\n\t\treturn null;\n\t}\n}\n/**\n* Convenience for the sender entry: build the event from the live\n* `process` plus a c12 load of `prisma-next.config.*` from\n* `payload.projectRoot` plus a real project-package.json reader,\n* swallowing any I/O errors in the file read.\n*\n* The parent's `payload.databaseTarget` (when present) wins over the\n* c12-derived value. The parent sets this for the first-`init` run,\n* where the config file does not exist on disk yet but the user has\n* just declared a target via the consent prompt; every other\n* invocation leaves it unset and the c12 load supplies the value.\n*/\nasync function buildTelemetryEventFromProcess(payload) {\n\tconst loadedConfig = await loadProjectConfig(payload.projectRoot);\n\treturn buildTelemetryEvent(payload, {\n\t\tdatabaseTarget: payload.databaseTarget ?? loadedConfig.databaseTarget,\n\t\textensions: loadedConfig.extensions\n\t}, {\n\t\tplatform: process.platform,\n\t\tarch: process.arch,\n\t\tversions: process.versions,\n\t\tenv: process.env,\n\t\tagent: await resolveAgentLabel(),\n\t\treadProjectPackageJson: () => {\n\t\t\ttry {\n\t\t\t\treturn readFileSync(join(payload.projectRoot, \"package.json\"), \"utf-8\");\n\t\t\t} catch {\n\t\t\t\treturn null;\n\t\t\t}\n\t\t}\n\t});\n}\n//#endregion\nexport { loadProjectConfig as n, buildTelemetryEventFromProcess as t };\n\n//# sourceMappingURL=enrich-CtoCke3N.mjs.map"],"mappings":";;;;;AAIA,MAAM,uBAAuB;CAC5B,gBAAgB;CAChB,YAAY,CAAC;AACd;;;;;;;;;;;;;;;AAeA,eAAe,kBAAkB,aAAa;CAC7C,IAAI;EACH,MAAM,EAAE,eAAe,MAAM,OAAO;EACpC,MAAM,UAAU,MAAM,WAAW;GAChC,MAAM;GACN,KAAK;GACL,QAAQ;GACR,QAAQ;GACR,UAAU;EACX,CAAC,EAAA,CAAG,UAAU;EACd,IAAI,WAAW,QAAQ,OAAO,KAAK,MAAM,CAAC,CAAC,WAAW,GAAG,OAAO;EAChE,MAAM,YAAY,MAAM,OAAO,kDAAA,CAAuC;EACtE,SAAS,MAAM;EACf,OAAO;GACN,gBAAgB,OAAO,OAAO;GAC9B,aAAa,OAAO,cAAc,CAAC,EAAA,CAAG,KAAK,SAAS,KAAK,EAAE;EAC5D;CACD,QAAQ;EACP,OAAO;CACR;AACD"}

package/dist/cli-telemetry__sender.d.mts

@@ -0,0 +1 @@
+export {}

package/dist/cli-telemetry__sender.mjs

@@ -0,0 +1 @@
+export {};

package/dist/cli.d.mts

@@ -0,0 +1,31 @@
+import { t as createContractEmitCommand } from "./contract-emit-B65_UiFn.mjs";
+import { Command } from "commander";
+import { Contract } from "@prisma/orm-framework/contract/types";
+//#region ../../../1-framework/3-tooling/cli/dist/exports/index.d.mts
+//#region src/commands/format.d.ts
+declare function createFormatCommand(): Command;
+//#endregion
+//#region src/load-ts-contract.d.ts
+interface LoadTsContractOptions {
+  readonly allowlist?: ReadonlyArray<string>;
+}
+/**
+ * Loads a contract from a TypeScript file and returns it as Contract.
+ *
+ * **Responsibility: Parsing Only**
+ * This function loads and parses a TypeScript contract file. It does NOT normalize the contract.
+ * The contract should already be normalized if it was built using the contract builder.
+ *
+ * Normalization must happen in the contract builder when the contract is created.
+ * This function only validates that the contract is JSON-serializable and returns it as-is.
+ *
+ * @param entryPath - Path to the TypeScript contract file
+ * @param options - Optional configuration (import allowlist)
+ * @returns The contract as Contract (should already be normalized)
+ * @throws structured errors: `CLI.FILE_NOT_FOUND`, `CONTRACT.SOURCE_LOAD_FAILED`,
+ *   `CONTRACT.SOURCE_IMPORT_DISALLOWED`, `CONTRACT.MODULE_EXPORT_MISSING`, `CONTRACT.EXPORT_INVALID`
+ */
+declare function loadContractFromTs(entryPath: string, options?: LoadTsContractOptions): Promise<Contract>;
+//#endregion
+export { type LoadTsContractOptions, createContractEmitCommand, createFormatCommand, loadContractFromTs };
+//# sourceMappingURL=cli.d.mts.map

package/dist/cli.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.mts","names":[],"sources":["../../../../1-framework/3-tooling/cli/dist/exports/index.d.mts"],"mappings":";;;;;iBAIiB,uBAAuB;;;UAG9B;WACC,YAAY;;;;;;;;;;;;;;;;;;iBAkBN,mBAAmB,mBAAmB,UAAU,wBAAwB,QAAQ"}