@prisma-next/cli 0.14.0-dev.71 → 0.14.0-dev.73

package/dist/contract-space-aggregate-loader-BtDPwApY.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"contract-space-aggregate-loader-BtDPwApY.mjs","names":[],"sources":["../src/utils/contract-space-aggregate-loader.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport type { PrismaNextConfig } from '@prisma-next/config/config-types';\nimport type { Contract } from '@prisma-next/contract/types';\nimport type { ControlExtensionDescriptor } from '@prisma-next/framework-components/control';\nimport { createControlStack } from '@prisma-next/framework-components/control';\nimport type {\n  ContractSpaceAggregate,\n  DeclaredExtensionEntry,\n  IntegrityQueryOptions,\n  IntegrityViolation,\n} from '@prisma-next/migration-tools/aggregate';\nimport { loadContractSpaceAggregate } from '@prisma-next/migration-tools/aggregate';\nimport { EMPTY_CONTRACT_HASH } from '@prisma-next/migration-tools/constants';\nimport { MigrationToolsError } from '@prisma-next/migration-tools/errors';\nimport { blindCast } from '@prisma-next/utils/casts';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { CliStructuredError, errorUnexpected, mapMigrationToolsError } from './cli-errors';\nimport { readContractEnvelope, resolveContractPath } from './command-helpers';\nimport { toDeclaredExtensionsFromRaw } from './extension-pack-inputs';\n\nconst CONTRACT_SPACES_DOCS_URL = 'https://pris.ly/contract-spaces';\n\nfunction contractSpaceError5002(\n  summary: string,\n  options: {\n    readonly why: string;\n    readonly fix: string;\n    readonly violations: readonly IntegrityViolation[];\n  },\n): CliStructuredError {\n  return new CliStructuredError('5002', summary, {\n    domain: 'MIG',\n    why: options.why,\n    fix: options.fix,\n    docsUrl: CONTRACT_SPACES_DOCS_URL,\n    meta: { violations: options.violations },\n  });\n}\n\n/**\n * Build the `5002` structured-error envelope for a contract-space\n * target mismatch. Shared between the declared-extension precheck (the\n * descriptor's configured target disagrees with the project target) and\n * the on-disk-contract check surfaced by `checkIntegrity`.\n */\nfunction targetMismatchError(\n  spaceId: string,\n  expected: string,\n  actual: string,\n): CliStructuredError {\n  return contractSpaceError5002(`Contract-space target mismatch for \"${spaceId}\"`, {\n    why: `Space \"${spaceId}\" targets \"${actual}\" but the project's adapter targets \"${expected}\".`,\n    fix: 'Update the extension descriptor to target the configured database, or change the project adapter.',\n    violations: [{ kind: 'targetMismatch', spaceId, expected, actual }],\n  });\n}\n\n/**\n * Human-readable detail for an integrity violation, used as the `why`\n * of the `integrityFailure` envelope. Mirrors the messages the prior\n * throw-on-load loader produced so downstream consumers see the same\n * text for the same on-disk state.\n */\nfunction describeIntegrityViolation(violation: IntegrityViolation): string {\n  switch (violation.kind) {\n    case 'hashMismatch':\n      return `Migration \"${violation.dirName}\" stored hash \"${violation.stored}\" does not match computed hash \"${violation.computed}\".`;\n    case 'providedInvariantsMismatch':\n      return `Migration \"${violation.dirName}\" providedInvariants in migration.json disagrees with ops.json.`;\n    case 'packageUnloadable':\n      return `Migration \"${violation.dirName}\" could not be loaded: ${violation.detail}`;\n    case 'sameSourceAndTarget':\n      return `Migration \"${violation.dirName}\" has source equal to target (${violation.hash}) with no data invariant — a true no-op self-edge.`;\n    case 'headRefMissing':\n      return `Head ref \\`refs/head.json\\` is missing for contract space \"${violation.spaceId}\".`;\n    case 'headRefNotInGraph':\n      return `Head ref ${violation.hash} for contract space \"${violation.spaceId}\" is not present in the migration graph.`;\n    case 'refUnreadable':\n      return `Ref \"${violation.refName}\" for contract space \"${violation.spaceId}\" is unreadable: ${violation.detail}`;\n    case 'duplicateMigrationHash':\n      return `Multiple migrations in space \"${violation.spaceId}\" share migrationHash \"${violation.migrationHash}\" (${violation.dirNames.join(', ')}).`;\n    default: {\n      const spaceId = 'spaceId' in violation ? violation.spaceId : '*';\n      return `Integrity violation \"${violation.kind}\" for contract space \"${spaceId}\".`;\n    }\n  }\n}\n\n/**\n * Map the integrity violations `checkIntegrity` reports into a single\n * CLI structured-error envelope, preserving the error codes the prior\n * throw-on-load loader emitted: `5001` (layout drift, bundled) and\n * `5002` (target / disjointness / contract-validation / structural\n * integrity). Returns `null` when there is nothing to refuse on.\n *\n * Precedence reproduces the prior loader's first-failure ordering:\n * layout drift first (every offence bundled into one envelope), then\n * target mismatch, then disjointness, then a contract-validation\n * failure, then any remaining structural integrity violation.\n */\nexport function mapIntegrityViolations(\n  violations: readonly IntegrityViolation[],\n): CliStructuredError | null {\n  if (violations.length === 0) return null;\n\n  const layout = violations.filter(\n    (v): v is Extract<IntegrityViolation, { kind: 'orphanSpaceDir' | 'declaredButUnmigrated' }> =>\n      v.kind === 'orphanSpaceDir' || v.kind === 'declaredButUnmigrated',\n  );\n  if (layout.length > 0) {\n    const lines = layout.map((v) => `- [${v.kind}] ${v.spaceId}`);\n    const summary =\n      layout.length === 1\n        ? 'Contract-space layout violation detected'\n        : `Contract-space layout violations detected (${layout.length})`;\n    return new CliStructuredError('5001', summary, {\n      domain: 'MIG',\n      why: `The on-disk \\`migrations/\\` directory and your \\`extensionPacks\\` declaration are not in agreement.\\n${lines.join('\\n')}`,\n      fix: 'Declare the extension in `extensionPacks` and re-emit its contract-space artefacts, or remove the orphan `migrations/<space>` directory.',\n      docsUrl: CONTRACT_SPACES_DOCS_URL,\n      meta: { violations: layout },\n    });\n  }\n\n  const targetMismatch = violations.find((v) => v.kind === 'targetMismatch');\n  if (targetMismatch && targetMismatch.kind === 'targetMismatch') {\n    return targetMismatchError(\n      targetMismatch.spaceId,\n      targetMismatch.expected,\n      targetMismatch.actual,\n    );\n  }\n\n  const disjointness = violations.find((v) => v.kind === 'disjointness');\n  if (disjointness && disjointness.kind === 'disjointness') {\n    return contractSpaceError5002(\n      `Contract-space disjointness violation: storage element \"${disjointness.element}\" claimed by multiple spaces`,\n      {\n        why: `Spaces ${disjointness.claimedBy.map((s) => `\"${s}\"`).join(', ')} all claim the storage element \"${disjointness.element}\". Each storage element must be owned by exactly one contract space.`,\n        fix: 'Update the conflicting contracts so each storage element is claimed by exactly one space.',\n        violations: [disjointness],\n      },\n    );\n  }\n\n  const contractUnreadable = violations.find((v) => v.kind === 'contractUnreadable');\n  if (contractUnreadable && contractUnreadable.kind === 'contractUnreadable') {\n    return contractSpaceError5002(\n      `Contract-space contract validation failed for \"${contractUnreadable.spaceId}\"`,\n      {\n        why: contractUnreadable.detail,\n        fix: 'Re-emit the extension contract with `prisma-next contract emit`, or fix the extension pack descriptor producing the invalid contract.',\n        violations: [contractUnreadable],\n      },\n    );\n  }\n\n  // Any remaining recoverable structural violation refuses as an\n  // integrity failure, surfacing the first one's detail (every violation\n  // is still computed; the gate just renders one envelope).\n  const structural = violations[0]!;\n  const spaceId = 'spaceId' in structural ? structural.spaceId : '*';\n  return contractSpaceError5002(`Contract-space integrity failure for \"${spaceId}\"`, {\n    why: describeIntegrityViolation(structural),\n    fix: 'Re-emit the affected migration package(s) or restore the on-disk `migrations/` directory from version control.',\n    violations: [structural],\n  });\n}\n\n/**\n * Inputs needed to compose the aggregate loader at the CLI surface.\n *\n * Keeps the loader framework-neutral (no `Config` import) by accepting\n * already-resolved structural inputs: validated app contract, target\n * id, migrations root directory, and the set of extension descriptors.\n */\nexport interface BuildAggregateInputs<TFamilyId extends string, TTargetId extends string> {\n  readonly targetId: TTargetId;\n  readonly migrationsDir: string;\n  readonly appContract: Contract;\n  readonly extensionPacks: ReadonlyArray<ControlExtensionDescriptor<TFamilyId, TTargetId>>;\n  readonly deserializeContract: (contractJson: unknown) => Contract;\n}\n\nfunction declaredExtensionsFromInputs(\n  extensionPacks: BuildAggregateInputs<string, string>['extensionPacks'],\n): readonly DeclaredExtensionEntry[] {\n  return toDeclaredExtensionsFromRaw(extensionPacks as ReadonlyArray<unknown>);\n}\n\n/**\n * Reject extension descriptors whose configured target disagrees with\n * the project target before any on-disk read.\n */\nexport function refuseDeclaredExtensionTargetMismatch<\n  TFamilyId extends string,\n  TTargetId extends string,\n>(inputs: BuildAggregateInputs<TFamilyId, TTargetId>): CliStructuredError | null {\n  for (const declared of declaredExtensionsFromInputs(inputs.extensionPacks)) {\n    if (declared.targetId !== inputs.targetId) {\n      return targetMismatchError(declared.id, inputs.targetId, declared.targetId);\n    }\n  }\n  return null;\n}\n\n/**\n * Load the tolerant {@link ContractSpaceAggregate} once at the CLI\n * surface. Construction never throws on disk content; callers query\n * {@link ContractSpaceAggregate.app} / extension facets instead of\n * re-reading `migrations/`.\n */\nexport async function loadContractSpaceAggregateForCli<\n  TFamilyId extends string,\n  TTargetId extends string,\n>(\n  inputs: BuildAggregateInputs<TFamilyId, TTargetId>,\n): Promise<Result<ContractSpaceAggregate, CliStructuredError>> {\n  const targetFailure = refuseDeclaredExtensionTargetMismatch(inputs);\n  if (targetFailure) {\n    return notOk(targetFailure);\n  }\n\n  const aggregate = await loadContractSpaceAggregate({\n    migrationsDir: inputs.migrationsDir,\n    deserializeContract: inputs.deserializeContract,\n    appContract: inputs.appContract,\n  });\n  return ok(aggregate);\n}\n\n/**\n * Run `checkIntegrity` on a loaded aggregate and map violations into\n * the contract-space refusal envelope, or return `null` when the model\n * is acceptable for the requested check scope.\n */\nexport function refuseContractSpaceIntegrity(\n  aggregate: ContractSpaceAggregate,\n  options: IntegrityQueryOptions,\n): CliStructuredError | null {\n  return mapIntegrityViolations(aggregate.checkIntegrity(options));\n}\n\nconst PACKAGE_CORRUPTION_KINDS = new Set<IntegrityViolation['kind']>([\n  'hashMismatch',\n  'providedInvariantsMismatch',\n  'packageUnloadable',\n]);\n\n/**\n * Reader-subset integrity refusal for `migration status`: package\n * corruptions only (`hashMismatch`, `providedInvariantsMismatch`,\n * `packageUnloadable`).\n */\nexport function refusePackageCorruptionOnAggregate(\n  aggregate: ContractSpaceAggregate,\n): CliStructuredError | null {\n  const corruption = aggregate.checkIntegrity().filter((v) => PACKAGE_CORRUPTION_KINDS.has(v.kind));\n  return mapIntegrityViolations(corruption);\n}\n\n/**\n * Construct the tolerant {@link ContractSpaceAggregate} at the CLI\n * surface and apply the explicit integrity refusal.\n *\n * App-space migration packages are read from `migrations/<app>/` by the\n * loader itself; callers no longer thread them through.\n */\nexport async function buildContractSpaceAggregate<\n  TFamilyId extends string,\n  TTargetId extends string,\n>(\n  inputs: BuildAggregateInputs<TFamilyId, TTargetId>,\n): Promise<Result<ContractSpaceAggregate, CliStructuredError>> {\n  const declaredExtensions = declaredExtensionsFromInputs(inputs.extensionPacks);\n  const loaded = await loadContractSpaceAggregateForCli(inputs);\n  if (!loaded.ok) {\n    return loaded;\n  }\n  const failure = refuseContractSpaceIntegrity(loaded.value, {\n    declaredExtensions,\n    checkContracts: true,\n  });\n  if (failure) {\n    return notOk(failure);\n  }\n  return ok(loaded.value);\n}\n\n/**\n * Build a minimal app {@link Contract} carrying only the project's\n * contract-identity (`storage.storageHash` + `target` / `targetFamily`)\n * when the real `contract.json` is absent or undeserializable.\n *\n * `loadContractSpaceAggregate` requires an `appContract` to synthesise the\n * app space's head ref from its storage hash. Read commands query only that\n * hash and the target — never `models` — so an empty-`models` stand-in is\n * sufficient for them. It is *not* a valid contract for any consumer that\n * reads schema, which is why this is confined to the read-aggregate path.\n */\nexport function appContractStandInFromIdentity(args: {\n  readonly contractHash: string;\n  readonly targetId: string;\n  readonly targetFamily: string;\n}): Contract {\n  return blindCast<\n    Contract,\n    'read-aggregate consumers query only storage.storageHash and target; empty models stand in for an unreadable contract.json'\n  >({\n    storage: { storageHash: args.contractHash },\n    schemaVersion: '0.0.0',\n    target: args.targetId,\n    targetFamily: args.targetFamily,\n    models: {},\n    profileHash: EMPTY_CONTRACT_HASH,\n  });\n}\n\nexport async function loadContractRawSafely(config: {\n  contract?: { output?: string };\n}): Promise<unknown | null> {\n  try {\n    const path = resolveContractPath(config);\n    const raw = await readFile(path, 'utf-8');\n    return JSON.parse(raw);\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Tolerant {@link ContractSpaceAggregate} assembly for read-only CLI\n * commands. No integrity gate — callers query `aggregate.app` (or other\n * facets) without re-reading `migrations/`. When `contract.json` is absent\n * or undeserializable, the app contract falls back to an identity-only\n * stand-in ({@link appContractStandInFromIdentity}), so these commands\n * load without requiring a readable contract.\n */\nexport async function buildReadAggregate(\n  config: PrismaNextConfig,\n  options: { readonly migrationsDir: string },\n): Promise<\n  Result<\n    { readonly aggregate: ContractSpaceAggregate; readonly contractHash: string },\n    CliStructuredError\n  >\n> {\n  let contractHash: string = EMPTY_CONTRACT_HASH;\n  try {\n    const envelope = await readContractEnvelope(config);\n    contractHash = envelope.storageHash;\n  } catch {\n    // Contract unreadable — marker uses EMPTY_CONTRACT_HASH\n  }\n\n  try {\n    const contractRawForAggregate = await loadContractRawSafely(config);\n    const stack = createControlStack(config);\n    const familyInstance = config.family.create(stack);\n    const deserializeContract = (json: unknown): Contract =>\n      familyInstance.deserializeContract(json);\n    let appContractForLoad: Contract = appContractStandInFromIdentity({\n      contractHash,\n      targetId: config.target.id,\n      targetFamily: config.target.familyId,\n    });\n    if (contractRawForAggregate !== null) {\n      try {\n        appContractForLoad = deserializeContract(contractRawForAggregate);\n      } catch {\n        // Deserialization failed — identity-only stand-in fallback\n      }\n    }\n\n    const loaded = await loadContractSpaceAggregateForCli({\n      targetId: config.target.id,\n      migrationsDir: options.migrationsDir,\n      appContract: appContractForLoad,\n      extensionPacks: config.extensionPacks ?? [],\n      deserializeContract,\n    });\n    if (!loaded.ok) {\n      return loaded;\n    }\n    return ok({ aggregate: loaded.value, contractHash });\n  } catch (error) {\n    if (MigrationToolsError.is(error)) {\n      return notOk(mapMigrationToolsError(error));\n    }\n    return notOk(\n      errorUnexpected(error instanceof Error ? error.message : String(error), {\n        why: `Failed to read migrations directory: ${error instanceof Error ? error.message : String(error)}`,\n      }),\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/extension-pack-inputs-1ySHqxKG.mjs

@@ -1,62 +0,0 @@
-//#region src/utils/extension-pack-inputs.ts
-/**
-* Project the CLI's `Config.extensionPacks` array into the canonical
-* {@link ExtensionPackInput} shape. The single `as ExtensionPackLike`
-* structural cast in the CLI lives inside this function.
-*/
-function toExtensionInputs(extensionPacks) {
-	return extensionPacks.map((raw) => {
-		const pack = raw;
-		if (pack.contractSpace === void 0) return {
-			id: pack.id,
-			targetId: pack.targetId
-		};
-		return {
-			id: pack.id,
-			targetId: pack.targetId,
-			contractSpace: {
-				contractJson: pack.contractSpace.contractJson,
-				headRef: pack.contractSpace.headRef,
-				migrations: pack.contractSpace.migrations ?? []
-			}
-		};
-	});
-}
-/**
-* Minimal aggregate-loader projection that extracts `id` + `targetId`
-* from raw extension pack descriptors **without invoking any
-* `contractSpace` accessor**. Inspects the own-property descriptor so
-* that getter-backed `contractSpace` declarations are detected but
-* never called.
-*
-* Inclusion semantics match {@link toDeclaredExtensions}: a data
-* property whose value is explicitly `undefined` is treated as "no
-* contract-space declaration" and skipped, mirroring the
-* `pack.contractSpace === undefined` check used on canonicalised
-* inputs. Prototype-chain `contractSpace` properties (no own
-* descriptor) are also skipped.
-*
-* This variant must be used by `buildContractSpaceAggregate` so that
-* the aggregate path (including `db verify`) never reads
-* `contractSpace.contractJson` from extension descriptors — the loader
-* always reads the contract from on-disk artefacts instead.
-*/
-function toDeclaredExtensionsFromRaw(extensionPacks) {
-	const entries = [];
-	for (const raw of extensionPacks) {
-		if (typeof raw !== "object" || raw === null) continue;
-		const descriptor = Object.getOwnPropertyDescriptor(raw, "contractSpace");
-		if (descriptor === void 0) continue;
-		if ("value" in descriptor && descriptor.value === void 0) continue;
-		const pack = raw;
-		entries.push({
-			id: pack.id,
-			targetId: pack.targetId
-		});
-	}
-	return entries;
-}
-//#endregion
-export { toExtensionInputs as n, toDeclaredExtensionsFromRaw as t };
-
-//# sourceMappingURL=extension-pack-inputs-1ySHqxKG.mjs.map

package/dist/extension-pack-inputs-1ySHqxKG.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"extension-pack-inputs-1ySHqxKG.mjs","names":[],"sources":["../src/utils/extension-pack-inputs.ts"],"sourcesContent":["/**\n * Single descriptor-import boundary for CLI consumers of `Config.extensionPacks`.\n *\n * Every CLI command / utility that reads an extension descriptor's\n * `contractSpace` projection (loader, migrate-pass, extension-migrations\n * pass, migration commands) goes through {@link toExtensionInputs}. The\n * structural cast `pack as { contractSpace?: ... }` lives **only** here —\n * downstream code consumes the canonical shape and maps it to its own\n * narrower shape via the per-consumer adapters below.\n *\n * The CLI receives extension descriptors typed against the SQL family\n * (or any other family in the future); this helper only depends on the\n * structural shape of `contractSpace`. SQL-family callers pass the same\n * `contractJson` / `headRef.hash` value through unchanged.\n */\nimport type { DeclaredExtensionEntry } from '@prisma-next/migration-tools/aggregate';\nimport type { MigrationMetadata } from '@prisma-next/migration-tools/metadata';\nimport type { MigrationOps } from '@prisma-next/migration-tools/package';\n\n/**\n * In-memory authored migration package shipped by an extension descriptor.\n * Mirrors the `MigrationPackage` shape from\n * `@prisma-next/framework-components/control` minus `dirPath`; redeclared\n * structurally here so the helper does not couple to the SQL family's\n * `ExtensionMigrationPackage` type.\n */\nexport interface DescriptorMigrationPackage {\n  readonly dirName: string;\n  readonly metadata: MigrationMetadata;\n  readonly ops: MigrationOps;\n}\n\n/**\n * The most-general projection of a single declared extension pack\n * needed by the CLI's descriptor-import boundary.\n *\n * - `id` / `targetId` are always present.\n * - `contractSpace` is present only when the extension declares one.\n *   When present, it carries the canonical inputs every downstream\n *   consumer needs — `contractJson`, `headRef`, and the descriptor's\n *   pre-built migration packages.\n */\nexport interface ExtensionPackInput {\n  readonly id: string;\n  readonly targetId: string;\n  readonly contractSpace?: {\n    readonly contractJson: unknown;\n    readonly headRef: {\n      readonly hash: string;\n      readonly invariants: readonly string[];\n    };\n    readonly migrations: readonly DescriptorMigrationPackage[];\n  };\n}\n\n/**\n * Structural shape we read off each `Config.extensionPacks` entry.\n *\n * The CLI is the descriptor-import boundary; `extensionPacks` is the only\n * surface where the SQL-family-typed `ControlExtensionDescriptor` flows\n * into framework-neutral helpers. The structural cast lives here, and\n * here alone — every other CLI consumer reads the canonical\n * {@link ExtensionPackInput} shape produced by {@link toExtensionInputs}.\n */\ntype ExtensionPackLike = {\n  readonly id: string;\n  readonly targetId: string;\n  readonly contractSpace?: {\n    readonly contractJson: unknown;\n    readonly headRef: {\n      readonly hash: string;\n      readonly invariants: readonly string[];\n    };\n    readonly migrations?: readonly DescriptorMigrationPackage[];\n  };\n};\n\n/**\n * Project the CLI's `Config.extensionPacks` array into the canonical\n * {@link ExtensionPackInput} shape. The single `as ExtensionPackLike`\n * structural cast in the CLI lives inside this function.\n */\nexport function toExtensionInputs(\n  extensionPacks: ReadonlyArray<unknown>,\n): readonly ExtensionPackInput[] {\n  return extensionPacks.map((raw) => {\n    const pack = raw as ExtensionPackLike;\n    if (pack.contractSpace === undefined) {\n      return { id: pack.id, targetId: pack.targetId };\n    }\n    return {\n      id: pack.id,\n      targetId: pack.targetId,\n      contractSpace: {\n        contractJson: pack.contractSpace.contractJson,\n        headRef: pack.contractSpace.headRef,\n        migrations: pack.contractSpace.migrations ?? [],\n      },\n    };\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Per-consumer adapters: take the canonical `ExtensionPackInput[]` and\n// project to whatever narrower shape the downstream primitive needs.\n// ---------------------------------------------------------------------------\n\n/**\n * Aggregate-loader projection. Surfaces `id` + `targetId` per\n * contract-space-bearing extension to\n * {@link import('./contract-space-aggregate-loader').buildContractSpaceAggregate}.\n *\n * Codec-only extensions (no `contractSpace` declaration) are filtered\n * out: they contribute no contract space, so the aggregate loader\n * has nothing to do with them. Filtering happens at this descriptor-\n * import boundary so the loader stays oblivious to that distinction —\n * every entry it sees expects an on-disk `migrations/<id>/` directory.\n */\nexport function toDeclaredExtensions(\n  inputs: ReadonlyArray<ExtensionPackInput>,\n): readonly DeclaredExtensionEntry[] {\n  const entries: DeclaredExtensionEntry[] = [];\n  for (const pack of inputs) {\n    if (pack.contractSpace === undefined) continue;\n    entries.push({ id: pack.id, targetId: pack.targetId });\n  }\n  return entries;\n}\n\n/**\n * Minimal aggregate-loader projection that extracts `id` + `targetId`\n * from raw extension pack descriptors **without invoking any\n * `contractSpace` accessor**. Inspects the own-property descriptor so\n * that getter-backed `contractSpace` declarations are detected but\n * never called.\n *\n * Inclusion semantics match {@link toDeclaredExtensions}: a data\n * property whose value is explicitly `undefined` is treated as \"no\n * contract-space declaration\" and skipped, mirroring the\n * `pack.contractSpace === undefined` check used on canonicalised\n * inputs. Prototype-chain `contractSpace` properties (no own\n * descriptor) are also skipped.\n *\n * This variant must be used by `buildContractSpaceAggregate` so that\n * the aggregate path (including `db verify`) never reads\n * `contractSpace.contractJson` from extension descriptors — the loader\n * always reads the contract from on-disk artefacts instead.\n */\nexport function toDeclaredExtensionsFromRaw(\n  extensionPacks: ReadonlyArray<unknown>,\n): readonly DeclaredExtensionEntry[] {\n  const entries: DeclaredExtensionEntry[] = [];\n  for (const raw of extensionPacks) {\n    if (typeof raw !== 'object' || raw === null) continue;\n    const descriptor = Object.getOwnPropertyDescriptor(raw, 'contractSpace');\n    if (descriptor === undefined) continue;\n    if ('value' in descriptor && descriptor.value === undefined) continue;\n    const pack = raw as { readonly id: string; readonly targetId: string };\n    entries.push({ id: pack.id, targetId: pack.targetId });\n  }\n  return entries;\n}\n"],"mappings":";;;;;;AAkFA,SAAgB,kBACd,gBAC+B;CAC/B,OAAO,eAAe,KAAK,QAAQ;EACjC,MAAM,OAAO;EACb,IAAI,KAAK,kBAAkB,KAAA,GACzB,OAAO;GAAE,IAAI,KAAK;GAAI,UAAU,KAAK;EAAS;EAEhD,OAAO;GACL,IAAI,KAAK;GACT,UAAU,KAAK;GACf,eAAe;IACb,cAAc,KAAK,cAAc;IACjC,SAAS,KAAK,cAAc;IAC5B,YAAY,KAAK,cAAc,cAAc,CAAC;GAChD;EACF;CACF,CAAC;AACH;;;;;;;;;;;;;;;;;;;;AAgDA,SAAgB,4BACd,gBACmC;CACnC,MAAM,UAAoC,CAAC;CAC3C,KAAK,MAAM,OAAO,gBAAgB;EAChC,IAAI,OAAO,QAAQ,YAAY,QAAQ,MAAM;EAC7C,MAAM,aAAa,OAAO,yBAAyB,KAAK,eAAe;EACvE,IAAI,eAAe,KAAA,GAAW;EAC9B,IAAI,WAAW,cAAc,WAAW,UAAU,KAAA,GAAW;EAC7D,MAAM,OAAO;EACb,QAAQ,KAAK;GAAE,IAAI,KAAK;GAAI,UAAU,KAAK;EAAS,CAAC;CACvD;CACA,OAAO;AACT"}