@prisma/orm-toolchain 0.16.0-dev.36

package/dist/ref-resolution-BjJBWPjX.mjs

@@ -0,0 +1,250 @@
+import { l as validateRefName } from "./refs-BDbB9BRB-D6Za3Q49.mjs";
+import { notOk, ok } from "@prisma/orm-framework/utils/result";
+//#region ../../../1-framework/3-tooling/migration/dist/exports/ref-resolution.mjs
+const FULL_HASH_PATTERN = /^([0-9a-f]{64}|empty)$/;
+const HEX_PREFIX_PATTERN = /^[0-9a-f]{6,}$/;
+function isFullHash(input) {
+	return FULL_HASH_PATTERN.test(input);
+}
+function isHexPrefix(input) {
+	return HEX_PREFIX_PATTERN.test(input);
+}
+function findEdgeByDirName(graph, dirName) {
+	for (const edges of graph.forwardChain.values()) for (const edge of edges) if (edge.dirName === dirName) return edge;
+}
+/**
+* Resolve a user-supplied string to a contract hash using the unified
+* contract-reference grammar.
+*
+* Accepted forms:
+* - `@contract` — the on-disk working contract hash (offline; requires
+*   `ctx.contractHash` to be set)
+* - `@db` — the live database marker (connection-required); callers MUST
+*   check `result.value.provenance.kind === 'reserved-db'` and resolve the
+*   actual hash via `readAllMarkers()` before using `result.value.hash`
+* - Full storage hash (64 hex chars or `empty`)
+* - Hex prefix (6+ hex chars, must uniquely identify one contract)
+* - Ref name (looked up in the refs index)
+* - Migration directory name (resolves to the migration's `to`-contract)
+* - `<dir>^` (resolves to the migration's `from`-contract)
+*/
+function parseContractRef(input, ctx) {
+	if (!input) return notOk({
+		kind: "invalid-format",
+		input,
+		reason: "Reference cannot be empty"
+	});
+	if (input === "@contract") {
+		if (ctx.contractHash === void 0) return notOk({
+			kind: "not-found",
+			input,
+			grammar: "contract"
+		});
+		return ok({
+			hash: ctx.contractHash,
+			provenance: { kind: "reserved-contract" }
+		});
+	}
+	if (input === "@db") return ok({
+		hash: "",
+		provenance: { kind: "reserved-db" }
+	});
+	if (isFullHash(input)) {
+		if (ctx.graph.nodes.has(input)) return ok({
+			hash: input,
+			provenance: {
+				kind: "hash",
+				input
+			}
+		});
+		return notOk({
+			kind: "not-found",
+			input,
+			grammar: "contract"
+		});
+	}
+	if (input.endsWith("^")) {
+		const dirName = input.slice(0, -1);
+		if (!dirName) return notOk({
+			kind: "invalid-format",
+			input,
+			reason: "Missing directory name before ^"
+		});
+		const edge = findEdgeByDirName(ctx.graph, dirName);
+		if (edge) return ok({
+			hash: edge.from,
+			provenance: {
+				kind: "migration-from",
+				dirName
+			}
+		});
+		return notOk({
+			kind: "not-found",
+			input,
+			grammar: "contract"
+		});
+	}
+	const candidates = [];
+	if (validateRefName(input) && Object.hasOwn(ctx.refs, input)) {
+		const ref = ctx.refs[input];
+		if (ref) candidates.push({
+			hash: ref.hash,
+			provenance: {
+				kind: "ref",
+				refName: input
+			},
+			label: `ref "${input}"`
+		});
+	}
+	const edge = findEdgeByDirName(ctx.graph, input);
+	if (edge) candidates.push({
+		hash: edge.to,
+		provenance: {
+			kind: "migration-to",
+			dirName: input
+		},
+		label: `migration directory "${input}"`
+	});
+	if (isHexPrefix(input)) {
+		const matches = [...ctx.graph.nodes].filter((n) => n.startsWith(input));
+		const [firstMatch] = matches;
+		if (matches.length === 1 && firstMatch !== void 0) candidates.push({
+			hash: firstMatch,
+			provenance: {
+				kind: "hash",
+				input
+			},
+			label: `hash prefix "${input}"`
+		});
+		else if (matches.length > 1) return notOk({
+			kind: "ambiguous",
+			input,
+			candidates: matches,
+			grammar: "contract"
+		});
+	}
+	const [firstCandidate] = candidates;
+	if (candidates.length === 1 && firstCandidate !== void 0) return ok({
+		hash: firstCandidate.hash,
+		provenance: firstCandidate.provenance
+	});
+	if (candidates.length > 1) return notOk({
+		kind: "ambiguous",
+		input,
+		candidates: candidates.map((c) => c.label),
+		grammar: "contract"
+	});
+	return notOk({
+		kind: "not-found",
+		input,
+		grammar: "contract"
+	});
+}
+/**
+* Resolve a user-supplied string to a migration using the migration-reference
+* grammar.
+*
+* Accepted forms:
+* - Migration directory name (e.g. `20260101-add-users`)
+* - Migration hash (full or 6+ hex prefix)
+*
+* Wrong-grammar diagnostics are produced when the input matches a
+* contract-grammar form (ref name, `<dir>^`, contract-only hash) so the
+* user gets a targeted hint rather than a generic "not found".
+*/
+function parseMigrationRef(input, ctx) {
+	if (!input) return notOk({
+		kind: "invalid-format",
+		input,
+		reason: "Reference cannot be empty"
+	});
+	if (input.endsWith("^")) return notOk({
+		kind: "wrong-grammar",
+		input,
+		expectedGrammar: "migration",
+		message: "`^` syntax addresses contracts, not migrations",
+		fix: "Pass the migration directory name without `^`, or use a contract-accepting flag like `--to` or `--from`."
+	});
+	if (validateRefName(input) && Object.hasOwn(ctx.refs, input)) return notOk({
+		kind: "wrong-grammar",
+		input,
+		expectedGrammar: "migration",
+		message: `"${input}" is a ref name, not a migration`,
+		fix: "Refs point at contracts, not migrations. Use a migration directory name or migration hash."
+	});
+	const edge = findEdgeByDirName(ctx.graph, input);
+	if (edge) return ok({
+		dirName: edge.dirName,
+		migrationHash: edge.migrationHash,
+		from: edge.from,
+		to: edge.to,
+		provenance: {
+			kind: "dir-name",
+			dirName: input
+		}
+	});
+	if (isFullHash(input)) {
+		const migEdge = ctx.graph.migrationByHash.get(input);
+		if (migEdge) return ok({
+			dirName: migEdge.dirName,
+			migrationHash: migEdge.migrationHash,
+			from: migEdge.from,
+			to: migEdge.to,
+			provenance: {
+				kind: "hash",
+				input
+			}
+		});
+		if (ctx.graph.nodes.has(input)) return notOk({
+			kind: "wrong-grammar",
+			input,
+			expectedGrammar: "migration",
+			message: "Hash matched a contract but not a migration",
+			fix: "Use a contract-accepting flag like `--to` or `--from` to reference contracts by hash. Pass `migration show <dir>` for a specific migration."
+		});
+		return notOk({
+			kind: "not-found",
+			input,
+			grammar: "migration"
+		});
+	}
+	if (isHexPrefix(input)) {
+		const migMatches = [...ctx.graph.migrationByHash.entries()].filter(([hash]) => hash.startsWith(input));
+		const [firstMigMatch] = migMatches;
+		if (migMatches.length === 1 && firstMigMatch !== void 0) {
+			const [, matchedEdge] = firstMigMatch;
+			return ok({
+				dirName: matchedEdge.dirName,
+				migrationHash: matchedEdge.migrationHash,
+				from: matchedEdge.from,
+				to: matchedEdge.to,
+				provenance: {
+					kind: "hash",
+					input
+				}
+			});
+		}
+		if (migMatches.length > 1) return notOk({
+			kind: "ambiguous",
+			input,
+			candidates: migMatches.map(([hash]) => hash),
+			grammar: "migration"
+		});
+		if ([...ctx.graph.nodes].filter((n) => n.startsWith(input)).length > 0) return notOk({
+			kind: "wrong-grammar",
+			input,
+			expectedGrammar: "migration",
+			message: "Hash matched a contract but not a migration",
+			fix: "Use a contract-accepting flag like `--to` or `--from` to reference contracts by hash. Pass `migration show <dir>` for a specific migration."
+		});
+	}
+	return notOk({
+		kind: "not-found",
+		input,
+		grammar: "migration"
+	});
+}
+//#endregion
+export { parseContractRef as n, parseMigrationRef as r, findEdgeByDirName as t };
+
+//# sourceMappingURL=ref-resolution-BjJBWPjX.mjs.map

package/dist/ref-resolution-BjJBWPjX.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-resolution-BjJBWPjX.mjs","names":[],"sources":["../../../../1-framework/3-tooling/migration/dist/exports/ref-resolution.mjs"],"sourcesContent":["import { l as validateRefName } from \"../refs-BDbB9BRB.mjs\";\nimport { notOk, ok } from \"@internal/utils/result\";\n//#region src/refs/types.ts\nconst FULL_HASH_PATTERN = /^([0-9a-f]{64}|empty)$/;\nconst HEX_PREFIX_PATTERN = /^[0-9a-f]{6,}$/;\nfunction isFullHash(input) {\n\treturn FULL_HASH_PATTERN.test(input);\n}\nfunction isHexPrefix(input) {\n\treturn HEX_PREFIX_PATTERN.test(input);\n}\nfunction findEdgeByDirName(graph, dirName) {\n\tfor (const edges of graph.forwardChain.values()) for (const edge of edges) if (edge.dirName === dirName) return edge;\n}\n//#endregion\n//#region src/refs/contract-ref.ts\n/**\n* Resolve a user-supplied string to a contract hash using the unified\n* contract-reference grammar.\n*\n* Accepted forms:\n* - `@contract` — the on-disk working contract hash (offline; requires\n*   `ctx.contractHash` to be set)\n* - `@db` — the live database marker (connection-required); callers MUST\n*   check `result.value.provenance.kind === 'reserved-db'` and resolve the\n*   actual hash via `readAllMarkers()` before using `result.value.hash`\n* - Full storage hash (64 hex chars or `empty`)\n* - Hex prefix (6+ hex chars, must uniquely identify one contract)\n* - Ref name (looked up in the refs index)\n* - Migration directory name (resolves to the migration's `to`-contract)\n* - `<dir>^` (resolves to the migration's `from`-contract)\n*/\nfunction parseContractRef(input, ctx) {\n\tif (!input) return notOk({\n\t\tkind: \"invalid-format\",\n\t\tinput,\n\t\treason: \"Reference cannot be empty\"\n\t});\n\tif (input === \"@contract\") {\n\t\tif (ctx.contractHash === void 0) return notOk({\n\t\t\tkind: \"not-found\",\n\t\t\tinput,\n\t\t\tgrammar: \"contract\"\n\t\t});\n\t\treturn ok({\n\t\t\thash: ctx.contractHash,\n\t\t\tprovenance: { kind: \"reserved-contract\" }\n\t\t});\n\t}\n\tif (input === \"@db\") return ok({\n\t\thash: \"\",\n\t\tprovenance: { kind: \"reserved-db\" }\n\t});\n\tif (isFullHash(input)) {\n\t\tif (ctx.graph.nodes.has(input)) return ok({\n\t\t\thash: input,\n\t\t\tprovenance: {\n\t\t\t\tkind: \"hash\",\n\t\t\t\tinput\n\t\t\t}\n\t\t});\n\t\treturn notOk({\n\t\t\tkind: \"not-found\",\n\t\t\tinput,\n\t\t\tgrammar: \"contract\"\n\t\t});\n\t}\n\tif (input.endsWith(\"^\")) {\n\t\tconst dirName = input.slice(0, -1);\n\t\tif (!dirName) return notOk({\n\t\t\tkind: \"invalid-format\",\n\t\t\tinput,\n\t\t\treason: \"Missing directory name before ^\"\n\t\t});\n\t\tconst edge = findEdgeByDirName(ctx.graph, dirName);\n\t\tif (edge) return ok({\n\t\t\thash: edge.from,\n\t\t\tprovenance: {\n\t\t\t\tkind: \"migration-from\",\n\t\t\t\tdirName\n\t\t\t}\n\t\t});\n\t\treturn notOk({\n\t\t\tkind: \"not-found\",\n\t\t\tinput,\n\t\t\tgrammar: \"contract\"\n\t\t});\n\t}\n\tconst candidates = [];\n\tif (validateRefName(input) && Object.hasOwn(ctx.refs, input)) {\n\t\tconst ref = ctx.refs[input];\n\t\tif (ref) candidates.push({\n\t\t\thash: ref.hash,\n\t\t\tprovenance: {\n\t\t\t\tkind: \"ref\",\n\t\t\t\trefName: input\n\t\t\t},\n\t\t\tlabel: `ref \"${input}\"`\n\t\t});\n\t}\n\tconst edge = findEdgeByDirName(ctx.graph, input);\n\tif (edge) candidates.push({\n\t\thash: edge.to,\n\t\tprovenance: {\n\t\t\tkind: \"migration-to\",\n\t\t\tdirName: input\n\t\t},\n\t\tlabel: `migration directory \"${input}\"`\n\t});\n\tif (isHexPrefix(input)) {\n\t\tconst matches = [...ctx.graph.nodes].filter((n) => n.startsWith(input));\n\t\tconst [firstMatch] = matches;\n\t\tif (matches.length === 1 && firstMatch !== void 0) candidates.push({\n\t\t\thash: firstMatch,\n\t\t\tprovenance: {\n\t\t\t\tkind: \"hash\",\n\t\t\t\tinput\n\t\t\t},\n\t\t\tlabel: `hash prefix \"${input}\"`\n\t\t});\n\t\telse if (matches.length > 1) return notOk({\n\t\t\tkind: \"ambiguous\",\n\t\t\tinput,\n\t\t\tcandidates: matches,\n\t\t\tgrammar: \"contract\"\n\t\t});\n\t}\n\tconst [firstCandidate] = candidates;\n\tif (candidates.length === 1 && firstCandidate !== void 0) return ok({\n\t\thash: firstCandidate.hash,\n\t\tprovenance: firstCandidate.provenance\n\t});\n\tif (candidates.length > 1) return notOk({\n\t\tkind: \"ambiguous\",\n\t\tinput,\n\t\tcandidates: candidates.map((c) => c.label),\n\t\tgrammar: \"contract\"\n\t});\n\treturn notOk({\n\t\tkind: \"not-found\",\n\t\tinput,\n\t\tgrammar: \"contract\"\n\t});\n}\n//#endregion\n//#region src/refs/migration-ref.ts\n/**\n* Resolve a user-supplied string to a migration using the migration-reference\n* grammar.\n*\n* Accepted forms:\n* - Migration directory name (e.g. `20260101-add-users`)\n* - Migration hash (full or 6+ hex prefix)\n*\n* Wrong-grammar diagnostics are produced when the input matches a\n* contract-grammar form (ref name, `<dir>^`, contract-only hash) so the\n* user gets a targeted hint rather than a generic \"not found\".\n*/\nfunction parseMigrationRef(input, ctx) {\n\tif (!input) return notOk({\n\t\tkind: \"invalid-format\",\n\t\tinput,\n\t\treason: \"Reference cannot be empty\"\n\t});\n\tif (input.endsWith(\"^\")) return notOk({\n\t\tkind: \"wrong-grammar\",\n\t\tinput,\n\t\texpectedGrammar: \"migration\",\n\t\tmessage: \"`^` syntax addresses contracts, not migrations\",\n\t\tfix: \"Pass the migration directory name without `^`, or use a contract-accepting flag like `--to` or `--from`.\"\n\t});\n\tif (validateRefName(input) && Object.hasOwn(ctx.refs, input)) return notOk({\n\t\tkind: \"wrong-grammar\",\n\t\tinput,\n\t\texpectedGrammar: \"migration\",\n\t\tmessage: `\"${input}\" is a ref name, not a migration`,\n\t\tfix: \"Refs point at contracts, not migrations. Use a migration directory name or migration hash.\"\n\t});\n\tconst edge = findEdgeByDirName(ctx.graph, input);\n\tif (edge) return ok({\n\t\tdirName: edge.dirName,\n\t\tmigrationHash: edge.migrationHash,\n\t\tfrom: edge.from,\n\t\tto: edge.to,\n\t\tprovenance: {\n\t\t\tkind: \"dir-name\",\n\t\t\tdirName: input\n\t\t}\n\t});\n\tif (isFullHash(input)) {\n\t\tconst migEdge = ctx.graph.migrationByHash.get(input);\n\t\tif (migEdge) return ok({\n\t\t\tdirName: migEdge.dirName,\n\t\t\tmigrationHash: migEdge.migrationHash,\n\t\t\tfrom: migEdge.from,\n\t\t\tto: migEdge.to,\n\t\t\tprovenance: {\n\t\t\t\tkind: \"hash\",\n\t\t\t\tinput\n\t\t\t}\n\t\t});\n\t\tif (ctx.graph.nodes.has(input)) return notOk({\n\t\t\tkind: \"wrong-grammar\",\n\t\t\tinput,\n\t\t\texpectedGrammar: \"migration\",\n\t\t\tmessage: \"Hash matched a contract but not a migration\",\n\t\t\tfix: \"Use a contract-accepting flag like `--to` or `--from` to reference contracts by hash. Pass `migration show <dir>` for a specific migration.\"\n\t\t});\n\t\treturn notOk({\n\t\t\tkind: \"not-found\",\n\t\t\tinput,\n\t\t\tgrammar: \"migration\"\n\t\t});\n\t}\n\tif (isHexPrefix(input)) {\n\t\tconst migMatches = [...ctx.graph.migrationByHash.entries()].filter(([hash]) => hash.startsWith(input));\n\t\tconst [firstMigMatch] = migMatches;\n\t\tif (migMatches.length === 1 && firstMigMatch !== void 0) {\n\t\t\tconst [, matchedEdge] = firstMigMatch;\n\t\t\treturn ok({\n\t\t\t\tdirName: matchedEdge.dirName,\n\t\t\t\tmigrationHash: matchedEdge.migrationHash,\n\t\t\t\tfrom: matchedEdge.from,\n\t\t\t\tto: matchedEdge.to,\n\t\t\t\tprovenance: {\n\t\t\t\t\tkind: \"hash\",\n\t\t\t\t\tinput\n\t\t\t\t}\n\t\t\t});\n\t\t}\n\t\tif (migMatches.length > 1) return notOk({\n\t\t\tkind: \"ambiguous\",\n\t\t\tinput,\n\t\t\tcandidates: migMatches.map(([hash]) => hash),\n\t\t\tgrammar: \"migration\"\n\t\t});\n\t\tif ([...ctx.graph.nodes].filter((n) => n.startsWith(input)).length > 0) return notOk({\n\t\t\tkind: \"wrong-grammar\",\n\t\t\tinput,\n\t\t\texpectedGrammar: \"migration\",\n\t\t\tmessage: \"Hash matched a contract but not a migration\",\n\t\t\tfix: \"Use a contract-accepting flag like `--to` or `--from` to reference contracts by hash. Pass `migration show <dir>` for a specific migration.\"\n\t\t});\n\t}\n\treturn notOk({\n\t\tkind: \"not-found\",\n\t\tinput,\n\t\tgrammar: \"migration\"\n\t});\n}\n//#endregion\nexport { findEdgeByDirName, parseContractRef, parseMigrationRef };\n\n//# sourceMappingURL=ref-resolution.mjs.map"],"mappings":"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"}

package/dist/ref-resolution-COGOSL57.d.mts

@@ -0,0 +1,127 @@
+import { i as Refs } from "./refs-BNCUu58Y-BIso5Jfg.mjs";
+import { n as MigrationGraph, t as MigrationEdge } from "./graph-bDjJ4GL9-BhFevsJS.mjs";
+import { Result } from "@prisma/orm-framework/utils/result";
+//#region ../../../1-framework/3-tooling/migration/dist/exports/ref-resolution.d.mts
+//#region src/refs/types.d.ts
+/** Context required to resolve a contract or migration reference. */
+interface RefResolutionContext {
+  readonly graph: MigrationGraph;
+  readonly refs: Refs;
+  /**
+   * Hash of the on-disk contract (`contract.json`). Required to resolve the
+   * `@contract` reserved token, which is an offline-resolvable alias for
+   * "the working contract the app carries."
+   */
+  readonly contractHash?: string;
+}
+type ContractRefProvenance = {
+  readonly kind: 'hash';
+  readonly input: string;
+} | {
+  readonly kind: 'ref';
+  readonly refName: string;
+} | {
+  readonly kind: 'migration-to';
+  readonly dirName: string;
+} | {
+  readonly kind: 'migration-from';
+  readonly dirName: string;
+} |
+/**
+ * Resolved from the `@contract` reserved token — the hash of the on-disk
+ * working contract (`contract.json`). Offline-resolvable.
+ */
+{
+  readonly kind: 'reserved-contract';
+} |
+/**
+ * Resolved from the `@db` reserved token — the live database marker.
+ * The `hash` field is a placeholder; callers must resolve the actual hash
+ * via `readAllMarkers()` before using it. Check `provenance.kind ===
+ * 'reserved-db'` to detect this case and perform the DB lookup.
+ */
+{
+  readonly kind: 'reserved-db';
+};
+/** A resolved contract reference: the target hash and how it was derived. */
+interface ContractRef {
+  readonly hash: string;
+  readonly provenance: ContractRefProvenance;
+}
+type MigrationRefProvenance = {
+  readonly kind: 'dir-name';
+  readonly dirName: string;
+} | {
+  readonly kind: 'hash';
+  readonly input: string;
+};
+/** A resolved migration reference. */
+interface MigrationRef {
+  readonly dirName: string;
+  readonly migrationHash: string;
+  readonly from: string;
+  readonly to: string;
+  readonly provenance: MigrationRefProvenance;
+}
+interface RefResolutionNotFound {
+  readonly kind: 'not-found';
+  readonly input: string;
+  readonly grammar: 'contract' | 'migration';
+}
+interface RefResolutionAmbiguous {
+  readonly kind: 'ambiguous';
+  readonly input: string;
+  readonly candidates: readonly string[];
+  readonly grammar: 'contract' | 'migration';
+}
+interface RefResolutionWrongGrammar {
+  readonly kind: 'wrong-grammar';
+  readonly input: string;
+  readonly expectedGrammar: 'contract' | 'migration';
+  readonly message: string;
+  readonly fix: string;
+}
+interface RefResolutionInvalidFormat {
+  readonly kind: 'invalid-format';
+  readonly input: string;
+  readonly reason: string;
+}
+type RefResolutionError = RefResolutionNotFound | RefResolutionAmbiguous | RefResolutionWrongGrammar | RefResolutionInvalidFormat;
+declare function findEdgeByDirName(graph: MigrationGraph, dirName: string): MigrationEdge | undefined;
+//#endregion
+//#region src/refs/contract-ref.d.ts
+/**
+ * Resolve a user-supplied string to a contract hash using the unified
+ * contract-reference grammar.
+ *
+ * Accepted forms:
+ * - `@contract` — the on-disk working contract hash (offline; requires
+ *   `ctx.contractHash` to be set)
+ * - `@db` — the live database marker (connection-required); callers MUST
+ *   check `result.value.provenance.kind === 'reserved-db'` and resolve the
+ *   actual hash via `readAllMarkers()` before using `result.value.hash`
+ * - Full storage hash (64 hex chars or `empty`)
+ * - Hex prefix (6+ hex chars, must uniquely identify one contract)
+ * - Ref name (looked up in the refs index)
+ * - Migration directory name (resolves to the migration's `to`-contract)
+ * - `<dir>^` (resolves to the migration's `from`-contract)
+ */
+declare function parseContractRef(input: string, ctx: RefResolutionContext): Result<ContractRef, RefResolutionError>;
+//#endregion
+//#region src/refs/migration-ref.d.ts
+/**
+ * Resolve a user-supplied string to a migration using the migration-reference
+ * grammar.
+ *
+ * Accepted forms:
+ * - Migration directory name (e.g. `20260101-add-users`)
+ * - Migration hash (full or 6+ hex prefix)
+ *
+ * Wrong-grammar diagnostics are produced when the input matches a
+ * contract-grammar form (ref name, `<dir>^`, contract-only hash) so the
+ * user gets a targeted hint rather than a generic "not found".
+ */
+declare function parseMigrationRef(input: string, ctx: RefResolutionContext): Result<MigrationRef, RefResolutionError>;
+//#endregion
+export { RefResolutionAmbiguous as a, RefResolutionInvalidFormat as c, findEdgeByDirName as d, parseContractRef as f, MigrationRefProvenance as i, RefResolutionNotFound as l, ContractRefProvenance as n, RefResolutionContext as o, parseMigrationRef as p, MigrationRef as r, RefResolutionError as s, ContractRef as t, RefResolutionWrongGrammar as u };
+//# sourceMappingURL=ref-resolution-COGOSL57.d.mts.map

package/dist/ref-resolution-COGOSL57.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-resolution-COGOSL57.d.mts","names":[],"sources":["../../../../1-framework/3-tooling/migration/dist/exports/ref-resolution.d.mts"],"mappings":";;;;;;UAKU;WACC,OAAO;WACP,MAAM;;;;;;WAMN;;KAEN;WACM;WACA;;WAEA;WACA;;WAEA;WACA;;WAEA;WACA;;;;;;;WAOA;;;;;;;;;WASA;;;UAGD;WACC;WACA,YAAY;;KAElB;WACM;WACA;;WAEA;WACA;;;UAGD;WACC;WACA;WACA;WACA;WACA,YAAY;;UAEb;WACC;WACA;WACA;;UAED;WACC;WACA;WACA;WACA;;UAED;WACC;WACA;WACA;WACA;WACA;;UAED;WACC;WACA;WACA;;KAEN,qBAAqB,wBAAwB,yBAAyB,4BAA4B;iBACtF,kBAAkB,OAAO,gBAAgB,kBAAkB;;;;;;;;;;;;;;;;;;;iBAmB3D,iBAAiB,eAAe,KAAK,uBAAuB,OAAO,aAAa;;;;;;;;;;;;;;;iBAehF,kBAAkB,eAAe,KAAK,uBAAuB,OAAO,cAAc"}

package/dist/refs-BDbB9BRB-D6Za3Q49.mjs

@@ -0,0 +1,241 @@
+import { b as errorInvalidRefName, t as MigrationToolsError, x as errorInvalidRefValue, y as errorInvalidRefFile } from "./errors-IpZm1Skp-BH495dRd.mjs";
+import { dirname, join, relative } from "pathe";
+import { mkdir, readFile, readdir, rename, rmdir, unlink, writeFile } from "node:fs/promises";
+import { type } from "arktype";
+//#region ../../../1-framework/3-tooling/migration/dist/refs-BDbB9BRB.mjs
+/**
+* The system head ref lives at `refs/head.json`. It is read (and its
+* corruption judged) through `readContractSpaceHeadRef`, not as a
+* user-authored ref, so {@link readRefsTolerant} excludes it.
+*/
+const HEAD_REF_NAME = "head";
+const REF_NAME_PATTERN = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\/[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$/;
+const REF_VALUE_PATTERN = /^(empty|[0-9a-f]{64})$/;
+function validateRefName(name) {
+	if (name.length === 0) return false;
+	if (name.includes("..")) return false;
+	if (name.includes("//")) return false;
+	if (name.startsWith(".")) return false;
+	return REF_NAME_PATTERN.test(name);
+}
+function validateRefValue(value) {
+	return REF_VALUE_PATTERN.test(value);
+}
+const RefEntrySchema = type({
+	hash: "string",
+	invariants: "string[]"
+}).narrow((entry, ctx) => {
+	if (!validateRefValue(entry.hash)) return ctx.mustBe(`a valid contract hash (got "${entry.hash}")`);
+	return true;
+});
+function refFilePath(refsDir, name) {
+	return join(refsDir, `${name}.json`);
+}
+function refNameFromPath(refsDir, filePath) {
+	return relative(refsDir, filePath).replace(/\.json$/, "");
+}
+async function readRef(refsDir, name) {
+	if (!validateRefName(name)) throw errorInvalidRefName(name);
+	const filePath = refFilePath(refsDir, name);
+	let raw;
+	try {
+		raw = await readFile(filePath, "utf-8");
+	} catch (error) {
+		if (error instanceof Error && error.code === "ENOENT") throw new MigrationToolsError("MIGRATION.UNKNOWN_REF", `Unknown ref "${name}"`, {
+			why: `No ref file found at "${filePath}".`,
+			fix: `Create the ref with: prisma-next ref set ${name} <hash>`,
+			details: {
+				refName: name,
+				filePath
+			}
+		});
+		throw error;
+	}
+	let parsed;
+	try {
+		parsed = JSON.parse(raw);
+	} catch {
+		throw errorInvalidRefFile(filePath, "Failed to parse as JSON");
+	}
+	const result = RefEntrySchema(parsed);
+	if (result instanceof type.errors) throw errorInvalidRefFile(filePath, result.summary);
+	return result;
+}
+async function readRefs(refsDir) {
+	let entries;
+	try {
+		entries = await readdir(refsDir, {
+			recursive: true,
+			encoding: "utf-8"
+		});
+	} catch (error) {
+		if (error instanceof Error && error.code === "ENOENT") return {};
+		throw error;
+	}
+	const jsonFiles = entries.filter((entry) => entry.endsWith(".json") && !entry.endsWith(".contract.json"));
+	const refs = {};
+	for (const jsonFile of jsonFiles) {
+		const filePath = join(refsDir, jsonFile);
+		const name = refNameFromPath(refsDir, filePath);
+		let raw;
+		try {
+			raw = await readFile(filePath, "utf-8");
+		} catch (error) {
+			const code = error instanceof Error ? error.code : void 0;
+			if (code === "ENOENT" || code === "EISDIR") continue;
+			throw error;
+		}
+		let parsed;
+		try {
+			parsed = JSON.parse(raw);
+		} catch {
+			throw errorInvalidRefFile(filePath, "Failed to parse as JSON");
+		}
+		const result = RefEntrySchema(parsed);
+		if (result instanceof type.errors) throw errorInvalidRefFile(filePath, result.summary);
+		refs[name] = result;
+	}
+	return refs;
+}
+/**
+* Read a space's user-authored refs without ever throwing on disk
+* content. A ref whose JSON is unparseable or whose shape fails
+* {@link RefEntrySchema} is omitted from `refs` and reported as a
+* {@link RefLoadProblem}; the remaining well-formed refs are still
+* returned. A missing `refs/` directory yields no refs and no problems.
+*
+* `refs/head.json` is deliberately skipped here: the system head ref is
+* read through `readContractSpaceHeadRef` (which validates head-ref
+* shape, distinct from the strict user-ref hash grammar), so it is judged
+* there and never doubles as a user ref. Genuine I/O faults (EACCES, EIO,
+* …) still propagate — only parse / schema problems are made tolerant.
+*/
+async function readRefsTolerant(refsDir) {
+	let entries;
+	try {
+		entries = await readdir(refsDir, {
+			recursive: true,
+			encoding: "utf-8"
+		});
+	} catch (error) {
+		if (error instanceof Error && error.code === "ENOENT") return {
+			refs: {},
+			problems: []
+		};
+		throw error;
+	}
+	const jsonFiles = entries.filter((entry) => entry.endsWith(".json") && !entry.endsWith(".contract.json") && entry !== `head.json`);
+	const refs = {};
+	const problems = [];
+	for (const jsonFile of jsonFiles) {
+		const filePath = join(refsDir, jsonFile);
+		const name = refNameFromPath(refsDir, filePath);
+		let raw;
+		try {
+			raw = await readFile(filePath, "utf-8");
+		} catch (error) {
+			const code = error instanceof Error ? error.code : void 0;
+			if (code === "ENOENT" || code === "EISDIR") continue;
+			throw error;
+		}
+		let parsed;
+		try {
+			parsed = JSON.parse(raw);
+		} catch (e) {
+			problems.push({
+				refName: name,
+				detail: e instanceof Error ? e.message : String(e)
+			});
+			continue;
+		}
+		const result = RefEntrySchema(parsed);
+		if (result instanceof type.errors) {
+			problems.push({
+				refName: name,
+				detail: result.summary
+			});
+			continue;
+		}
+		refs[name] = result;
+	}
+	return {
+		refs,
+		problems
+	};
+}
+async function writeRef(refsDir, name, entry) {
+	if (!validateRefName(name)) throw errorInvalidRefName(name);
+	if (!validateRefValue(entry.hash)) throw errorInvalidRefValue(entry.hash);
+	const filePath = refFilePath(refsDir, name);
+	const dir = dirname(filePath);
+	await mkdir(dir, { recursive: true });
+	const tmpPath = join(dir, `.${name.split("/").pop()}.json.${Date.now()}.tmp`);
+	await writeFile(tmpPath, `${JSON.stringify({
+		hash: entry.hash,
+		invariants: [...entry.invariants]
+	}, null, 2)}\n`);
+	await rename(tmpPath, filePath);
+}
+async function deleteRef(refsDir, name) {
+	if (!validateRefName(name)) throw errorInvalidRefName(name);
+	const filePath = refFilePath(refsDir, name);
+	try {
+		await unlink(filePath);
+	} catch (error) {
+		if (error instanceof Error && error.code === "ENOENT") throw new MigrationToolsError("MIGRATION.UNKNOWN_REF", `Unknown ref "${name}"`, {
+			why: `No ref file found at "${filePath}".`,
+			fix: "Run `prisma-next ref list` to see available refs.",
+			details: {
+				refName: name,
+				filePath
+			}
+		});
+		throw error;
+	}
+	let dir = dirname(filePath);
+	while (dir !== refsDir && dir.startsWith(refsDir)) try {
+		await rmdir(dir);
+		dir = dirname(dir);
+	} catch (error) {
+		const code = error instanceof Error ? error.code : void 0;
+		if (code === "ENOTEMPTY" || code === "EEXIST" || code === "ENOENT") break;
+		throw error;
+	}
+}
+/**
+* Index user-authored refs by the contract hash each ref points at.
+* Each bucket is sorted lex-asc for deterministic output.
+*/
+function refsByContractHash(refs) {
+	const byHash = /* @__PURE__ */ new Map();
+	for (const [name, entry] of Object.entries(refs)) {
+		const bucket = byHash.get(entry.hash);
+		if (bucket) bucket.push(name);
+		else byHash.set(entry.hash, [name]);
+	}
+	for (const bucket of byHash.values()) bucket.sort();
+	return byHash;
+}
+/**
+* Read `migrations/<space>/refs/*.json` and index by destination hash.
+* Returns an empty map when the refs directory does not exist.
+*/
+async function resolveRefsByContractHash(refsDir) {
+	return refsByContractHash(await readRefs(refsDir));
+}
+function resolveRef(refs, name) {
+	if (!validateRefName(name)) throw errorInvalidRefName(name);
+	if (!Object.hasOwn(refs, name)) throw new MigrationToolsError("MIGRATION.UNKNOWN_REF", `Unknown ref "${name}"`, {
+		why: `No ref named "${name}" exists.`,
+		fix: `Available refs: ${Object.keys(refs).join(", ") || "(none)"}. Create a ref with: prisma-next ref set ${name} <hash>`,
+		details: {
+			refName: name,
+			availableRefs: Object.keys(refs)
+		}
+	});
+	return refs[name];
+}
+//#endregion
+export { readRefsTolerant as a, resolveRefsByContractHash as c, writeRef as d, readRefs as i, validateRefName as l, deleteRef as n, refsByContractHash as o, readRef as r, resolveRef as s, HEAD_REF_NAME as t, validateRefValue as u };
+
+//# sourceMappingURL=refs-BDbB9BRB-D6Za3Q49.mjs.map

package/dist/refs-BDbB9BRB-D6Za3Q49.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs-BDbB9BRB-D6Za3Q49.mjs","names":[],"sources":["../../../../1-framework/3-tooling/migration/dist/refs-BDbB9BRB.mjs"],"sourcesContent":["import { b as errorInvalidRefName, t as MigrationToolsError, x as errorInvalidRefValue, y as errorInvalidRefFile } from \"./errors-IpZm1Skp.mjs\";\nimport { dirname, join, relative } from \"pathe\";\nimport { mkdir, readFile, readdir, rename, rmdir, unlink, writeFile } from \"node:fs/promises\";\nimport { type } from \"arktype\";\n//#region src/refs.ts\n/**\n* The system head ref lives at `refs/head.json`. It is read (and its\n* corruption judged) through `readContractSpaceHeadRef`, not as a\n* user-authored ref, so {@link readRefsTolerant} excludes it.\n*/\nconst HEAD_REF_NAME = \"head\";\nconst REF_NAME_PATTERN = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\/[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$/;\nconst REF_VALUE_PATTERN = /^(empty|[0-9a-f]{64})$/;\nfunction validateRefName(name) {\n\tif (name.length === 0) return false;\n\tif (name.includes(\"..\")) return false;\n\tif (name.includes(\"//\")) return false;\n\tif (name.startsWith(\".\")) return false;\n\treturn REF_NAME_PATTERN.test(name);\n}\nfunction validateRefValue(value) {\n\treturn REF_VALUE_PATTERN.test(value);\n}\nconst RefEntrySchema = type({\n\thash: \"string\",\n\tinvariants: \"string[]\"\n}).narrow((entry, ctx) => {\n\tif (!validateRefValue(entry.hash)) return ctx.mustBe(`a valid contract hash (got \"${entry.hash}\")`);\n\treturn true;\n});\nfunction refFilePath(refsDir, name) {\n\treturn join(refsDir, `${name}.json`);\n}\nfunction refNameFromPath(refsDir, filePath) {\n\treturn relative(refsDir, filePath).replace(/\\.json$/, \"\");\n}\nasync function readRef(refsDir, name) {\n\tif (!validateRefName(name)) throw errorInvalidRefName(name);\n\tconst filePath = refFilePath(refsDir, name);\n\tlet raw;\n\ttry {\n\t\traw = await readFile(filePath, \"utf-8\");\n\t} catch (error) {\n\t\tif (error instanceof Error && error.code === \"ENOENT\") throw new MigrationToolsError(\"MIGRATION.UNKNOWN_REF\", `Unknown ref \"${name}\"`, {\n\t\t\twhy: `No ref file found at \"${filePath}\".`,\n\t\t\tfix: `Create the ref with: prisma-next ref set ${name} <hash>`,\n\t\t\tdetails: {\n\t\t\t\trefName: name,\n\t\t\t\tfilePath\n\t\t\t}\n\t\t});\n\t\tthrow error;\n\t}\n\tlet parsed;\n\ttry {\n\t\tparsed = JSON.parse(raw);\n\t} catch {\n\t\tthrow errorInvalidRefFile(filePath, \"Failed to parse as JSON\");\n\t}\n\tconst result = RefEntrySchema(parsed);\n\tif (result instanceof type.errors) throw errorInvalidRefFile(filePath, result.summary);\n\treturn result;\n}\nasync function readRefs(refsDir) {\n\tlet entries;\n\ttry {\n\t\tentries = await readdir(refsDir, {\n\t\t\trecursive: true,\n\t\t\tencoding: \"utf-8\"\n\t\t});\n\t} catch (error) {\n\t\tif (error instanceof Error && error.code === \"ENOENT\") return {};\n\t\tthrow error;\n\t}\n\tconst jsonFiles = entries.filter((entry) => entry.endsWith(\".json\") && !entry.endsWith(\".contract.json\"));\n\tconst refs = {};\n\tfor (const jsonFile of jsonFiles) {\n\t\tconst filePath = join(refsDir, jsonFile);\n\t\tconst name = refNameFromPath(refsDir, filePath);\n\t\tlet raw;\n\t\ttry {\n\t\t\traw = await readFile(filePath, \"utf-8\");\n\t\t} catch (error) {\n\t\t\tconst code = error instanceof Error ? error.code : void 0;\n\t\t\tif (code === \"ENOENT\" || code === \"EISDIR\") continue;\n\t\t\tthrow error;\n\t\t}\n\t\tlet parsed;\n\t\ttry {\n\t\t\tparsed = JSON.parse(raw);\n\t\t} catch {\n\t\t\tthrow errorInvalidRefFile(filePath, \"Failed to parse as JSON\");\n\t\t}\n\t\tconst result = RefEntrySchema(parsed);\n\t\tif (result instanceof type.errors) throw errorInvalidRefFile(filePath, result.summary);\n\t\trefs[name] = result;\n\t}\n\treturn refs;\n}\n/**\n* Read a space's user-authored refs without ever throwing on disk\n* content. A ref whose JSON is unparseable or whose shape fails\n* {@link RefEntrySchema} is omitted from `refs` and reported as a\n* {@link RefLoadProblem}; the remaining well-formed refs are still\n* returned. A missing `refs/` directory yields no refs and no problems.\n*\n* `refs/head.json` is deliberately skipped here: the system head ref is\n* read through `readContractSpaceHeadRef` (which validates head-ref\n* shape, distinct from the strict user-ref hash grammar), so it is judged\n* there and never doubles as a user ref. Genuine I/O faults (EACCES, EIO,\n* …) still propagate — only parse / schema problems are made tolerant.\n*/\nasync function readRefsTolerant(refsDir) {\n\tlet entries;\n\ttry {\n\t\tentries = await readdir(refsDir, {\n\t\t\trecursive: true,\n\t\t\tencoding: \"utf-8\"\n\t\t});\n\t} catch (error) {\n\t\tif (error instanceof Error && error.code === \"ENOENT\") return {\n\t\t\trefs: {},\n\t\t\tproblems: []\n\t\t};\n\t\tthrow error;\n\t}\n\tconst jsonFiles = entries.filter((entry) => entry.endsWith(\".json\") && !entry.endsWith(\".contract.json\") && entry !== `head.json`);\n\tconst refs = {};\n\tconst problems = [];\n\tfor (const jsonFile of jsonFiles) {\n\t\tconst filePath = join(refsDir, jsonFile);\n\t\tconst name = refNameFromPath(refsDir, filePath);\n\t\tlet raw;\n\t\ttry {\n\t\t\traw = await readFile(filePath, \"utf-8\");\n\t\t} catch (error) {\n\t\t\tconst code = error instanceof Error ? error.code : void 0;\n\t\t\tif (code === \"ENOENT\" || code === \"EISDIR\") continue;\n\t\t\tthrow error;\n\t\t}\n\t\tlet parsed;\n\t\ttry {\n\t\t\tparsed = JSON.parse(raw);\n\t\t} catch (e) {\n\t\t\tproblems.push({\n\t\t\t\trefName: name,\n\t\t\t\tdetail: e instanceof Error ? e.message : String(e)\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\t\tconst result = RefEntrySchema(parsed);\n\t\tif (result instanceof type.errors) {\n\t\t\tproblems.push({\n\t\t\t\trefName: name,\n\t\t\t\tdetail: result.summary\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\t\trefs[name] = result;\n\t}\n\treturn {\n\t\trefs,\n\t\tproblems\n\t};\n}\nasync function writeRef(refsDir, name, entry) {\n\tif (!validateRefName(name)) throw errorInvalidRefName(name);\n\tif (!validateRefValue(entry.hash)) throw errorInvalidRefValue(entry.hash);\n\tconst filePath = refFilePath(refsDir, name);\n\tconst dir = dirname(filePath);\n\tawait mkdir(dir, { recursive: true });\n\tconst tmpPath = join(dir, `.${name.split(\"/\").pop()}.json.${Date.now()}.tmp`);\n\tawait writeFile(tmpPath, `${JSON.stringify({\n\t\thash: entry.hash,\n\t\tinvariants: [...entry.invariants]\n\t}, null, 2)}\\n`);\n\tawait rename(tmpPath, filePath);\n}\nasync function deleteRef(refsDir, name) {\n\tif (!validateRefName(name)) throw errorInvalidRefName(name);\n\tconst filePath = refFilePath(refsDir, name);\n\ttry {\n\t\tawait unlink(filePath);\n\t} catch (error) {\n\t\tif (error instanceof Error && error.code === \"ENOENT\") throw new MigrationToolsError(\"MIGRATION.UNKNOWN_REF\", `Unknown ref \"${name}\"`, {\n\t\t\twhy: `No ref file found at \"${filePath}\".`,\n\t\t\tfix: \"Run `prisma-next ref list` to see available refs.\",\n\t\t\tdetails: {\n\t\t\t\trefName: name,\n\t\t\t\tfilePath\n\t\t\t}\n\t\t});\n\t\tthrow error;\n\t}\n\tlet dir = dirname(filePath);\n\twhile (dir !== refsDir && dir.startsWith(refsDir)) try {\n\t\tawait rmdir(dir);\n\t\tdir = dirname(dir);\n\t} catch (error) {\n\t\tconst code = error instanceof Error ? error.code : void 0;\n\t\tif (code === \"ENOTEMPTY\" || code === \"EEXIST\" || code === \"ENOENT\") break;\n\t\tthrow error;\n\t}\n}\n/**\n* Index user-authored refs by the contract hash each ref points at.\n* Each bucket is sorted lex-asc for deterministic output.\n*/\nfunction refsByContractHash(refs) {\n\tconst byHash = /* @__PURE__ */ new Map();\n\tfor (const [name, entry] of Object.entries(refs)) {\n\t\tconst bucket = byHash.get(entry.hash);\n\t\tif (bucket) bucket.push(name);\n\t\telse byHash.set(entry.hash, [name]);\n\t}\n\tfor (const bucket of byHash.values()) bucket.sort();\n\treturn byHash;\n}\n/**\n* Read `migrations/<space>/refs/*.json` and index by destination hash.\n* Returns an empty map when the refs directory does not exist.\n*/\nasync function resolveRefsByContractHash(refsDir) {\n\treturn refsByContractHash(await readRefs(refsDir));\n}\nfunction resolveRef(refs, name) {\n\tif (!validateRefName(name)) throw errorInvalidRefName(name);\n\tif (!Object.hasOwn(refs, name)) throw new MigrationToolsError(\"MIGRATION.UNKNOWN_REF\", `Unknown ref \"${name}\"`, {\n\t\twhy: `No ref named \"${name}\" exists.`,\n\t\tfix: `Available refs: ${Object.keys(refs).join(\", \") || \"(none)\"}. Create a ref with: prisma-next ref set ${name} <hash>`,\n\t\tdetails: {\n\t\t\trefName: name,\n\t\t\tavailableRefs: Object.keys(refs)\n\t\t}\n\t});\n\treturn refs[name];\n}\n//#endregion\nexport { readRefsTolerant as a, resolveRefsByContractHash as c, writeRef as d, readRefs as i, validateRefName as l, deleteRef as n, refsByContractHash as o, readRef as r, resolveRef as s, HEAD_REF_NAME as t, validateRefValue as u };\n\n//# sourceMappingURL=refs-BDbB9BRB.mjs.map"],"mappings":"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"}