@powerhousedao/codegen 6.0.0-dev.19 → 6.0.0-dev.191

package/dist/src/utils/index.d.mts

@@ -0,0 +1,125 @@
+import { o as DocumentModelDocumentTypeMetadata } from "../../types-e2ztuDtG.mjs";
+import { a as parseConfig, i as parseArgs, n as validateDocumentModelState, r as configSpec, t as DocumentModelStateValidationResult } from "../../validation-Bpg_44mW.mjs";
+import * as ts_morph0 from "ts-morph";
+import { IndentationText, ObjectLiteralExpression, Project, SourceFile, SyntaxKind, VariableStatement, ts } from "ts-morph";
+
+//#region src/utils/constants.d.ts
+/** Document model metadata for the `powerhouse/document-model` document type.
+ *
+ * Assumed to always be present during codegen.
+ */
+declare const documentModelDocumentTypeMetadata: {
+  readonly documentModelId: "powerhouse/document-model";
+  readonly documentModelDocumentTypeName: "DocumentModelDocument";
+  readonly documentModelDirName: "document-model";
+  readonly documentModelImportPath: "document-model";
+};
+//#endregion
+//#region src/utils/document-type-metadata.d.ts
+type GetDocumentTypeMetadataArgs = {
+  project: Project;
+  documentModelId: string;
+  documentModelsDirPath: string;
+};
+/** Gets the document model metadata for the --document-type argument
+ * passed to the `generate --editor` and `generate --app` commands.
+ */
+declare function getDocumentTypeMetadata({
+  project,
+  documentModelId,
+  documentModelsDirPath
+}: GetDocumentTypeMetadataArgs): DocumentModelDocumentTypeMetadata;
+declare function getPHDocumentTypeNameFromSourceFile(sourceFile: SourceFile): string | undefined;
+//#endregion
+//#region src/utils/format-with-prettier.d.ts
+/** Formats the text of a ts-morph source file with prettier before writing the text to memory */
+declare function formatSourceFileWithPrettier(sourceFile: SourceFile): Promise<void>;
+declare function runPrettier(): Promise<void>;
+//#endregion
+//#region src/utils/source-files.d.ts
+/** Gets a SourceFile by name in a ts-morph Project, or creates a new one
+ * if none with that path exists.
+ */
+declare function getOrCreateSourceFile(project: Project, filePath: string): {
+  alreadyExists: boolean;
+  sourceFile: ts_morph0.SourceFile;
+};
+/** Gets a Directory by name in a ts-morph Project, or creates a new one
+ * if none with that path exists.
+ */
+declare function getOrCreateDirectory(project: Project, dirPath: string): {
+  alreadyExists: boolean;
+  directory: ts_morph0.Directory;
+};
+/** Ensures that the directories at the given paths exist within the
+ * ts-morph Project
+ */
+declare function ensureDirectoriesExist(project: Project, ...pathsToEnsure: string[]): Promise<void>;
+declare function getPreviousVersionSourceFile(args: {
+  project: Project;
+  version: number;
+  filePath: string;
+}): ts_morph0.SourceFile | undefined;
+//#endregion
+//#region src/utils/syntax-builders.d.ts
+/** Builds a ts-morph ObjectLiteralExpression from a ts/js object
+ * Useful for substituting the value of a runtime object in templates
+ */
+declare function buildObjectLiteral(inputObject: object, sourceFile: SourceFile): string;
+declare function buildStringLiteral(value: string): ts.StringLiteral;
+//#endregion
+//#region src/utils/syntax-getters.d.ts
+/** Returns a ts-morph ObjectLiteralExpression from a variable statement
+ * if the type matches
+ */
+declare function getObjectLiteral(statement: VariableStatement | undefined): ObjectLiteralExpression | undefined;
+/** Returns the value of a property in a ts-morph ObjectLiteralExpression of type T if it exists */
+declare function getObjectProperty<T extends SyntaxKind>(object: ObjectLiteralExpression | undefined, propertyName: string, propertyType: T): ts_morph0.KindToNodeMappings[T] | undefined;
+declare function getVariableDeclarationByTypeName(sourceFile: SourceFile, typeName: string): ts_morph0.VariableDeclaration | undefined;
+//#endregion
+//#region src/utils/ts-morph-project.d.ts
+declare const DEFAULT_PROJECT_OPTIONS: {
+  readonly skipAddingFilesFromTsConfig: true;
+  readonly skipLoadingLibFiles: true;
+  readonly manipulationSettings: {
+    readonly useTrailingCommas: true;
+    readonly indentationText: IndentationText.TwoSpaces;
+    readonly indentMultiLineObjectLiteralBeginningOnBlankLine: true;
+  };
+};
+/** Returns the minimal typescript config for use in ts-morph file generation */
+declare function getDefaultProjectOptions(tsConfigFilePath: string): {
+  tsConfigFilePath: string;
+  skipAddingFilesFromTsConfig: true;
+  skipLoadingLibFiles: true;
+  manipulationSettings: {
+    readonly useTrailingCommas: true;
+    readonly indentationText: IndentationText.TwoSpaces;
+    readonly indentMultiLineObjectLiteralBeginningOnBlankLine: true;
+  };
+};
+/** Instantiates a ts-morph Project using the default typescript config and nearest tsconfig.json file */
+declare function buildTsMorphProject(projectDir: string): Project;
+//#endregion
+//#region src/utils/unsafe-utils.d.ts
+declare function getInitialStates(scopeState: {
+  global: any;
+  local: any;
+}): {
+  initialGlobalState: string;
+  initialLocalState: string;
+};
+//#endregion
+//#region src/utils/graphql-type-prefixes.d.ts
+/**
+ * Extract type names from a GraphQL schema.
+ * Finds all type, enum, union, interface, and input definitions.
+ */
+declare function extractTypeNames(schema: string): string[];
+/**
+ * Apply type prefixes to GraphQL schema to namespace types and avoid collisions.
+ */
+declare function applyGraphQLTypePrefixes(schema: string, prefix: string, externalTypeNames?: string[]): string;
+//#endregion
+export { DEFAULT_PROJECT_OPTIONS, DocumentModelStateValidationResult, applyGraphQLTypePrefixes, buildObjectLiteral, buildStringLiteral, buildTsMorphProject, configSpec, documentModelDocumentTypeMetadata, ensureDirectoriesExist, extractTypeNames, formatSourceFileWithPrettier, getDefaultProjectOptions, getDocumentTypeMetadata, getInitialStates, getObjectLiteral, getObjectProperty, getOrCreateDirectory, getOrCreateSourceFile, getPHDocumentTypeNameFromSourceFile, getPreviousVersionSourceFile, getVariableDeclarationByTypeName, parseArgs, parseConfig, runPrettier, validateDocumentModelState };
+//# sourceMappingURL=index.d.mts.map

package/dist/src/utils/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/utils/constants.ts","../../../src/utils/document-type-metadata.ts","../../../src/utils/format-with-prettier.ts","../../../src/utils/source-files.ts","../../../src/utils/syntax-builders.ts","../../../src/utils/syntax-getters.ts","../../../src/utils/ts-morph-project.ts","../../../src/utils/unsafe-utils.ts","../../../src/utils/graphql-type-prefixes.ts"],"mappings":";;;;;;;;;;cAIa,iCAAA;EAAA;;;;;;;KCER,2BAAA;EACH,OAAA,EAAS,OAAA;EACT,eAAA;EACA,qBAAA;AAAA;ADLF;;;AAAA,iBCUgB,uBAAA,CAAA;EACd,OAAA;EACA,eAAA;EACA;AAAA,GACC,2BAAA,GAA2B,iCAAA;AAAA,iBAiGd,mCAAA,CAAoC,UAAA,EAAY,UAAA;;;;iBC9G1C,4BAAA,CAA6B,UAAA,EAAY,UAAA,GAAU,OAAA;AAAA,iBAanD,WAAA,CAAA,GAAW,OAAA;;;;;;iBCbjB,qBAAA,CAAsB,OAAA,EAAS,OAAA,EAAS,QAAA;;cAAF,SAAA,CAAA,UAAA;AAAA;;;;iBAkBtC,oBAAA,CAAqB,OAAA,EAAS,OAAA,EAAS,OAAA;;aAAF,SAAA,CAAA,SAAA;AAAA;;;;iBAkB/B,sBAAA,CACpB,OAAA,EAAS,OAAA,KACN,aAAA,aAAuB,OAAA;AAAA,iBAWZ,4BAAA,CAA6B,IAAA;EAC3C,OAAA,EAAS,OAAA;EACT,OAAA;EACA,QAAA;AAAA,IAFgB,SAAA,CAGjB,UAAA;;;;;;iBCpDe,kBAAA,CACd,WAAA,UACA,UAAA,EAAY,UAAA;AAAA,iBAwCE,kBAAA,CAAmB,KAAA,WAAa,EAAA,CAAA,aAAA;;;;;;iBCtChC,gBAAA,CAAiB,SAAA,EAAW,iBAAA,eAA6B,uBAAA;;iBAQzD,iBAAA,WAA4B,UAAA,CAAA,CAC1C,MAAA,EAAQ,uBAAA,cACR,YAAA,UACA,YAAA,EAAc,CAAA,GAAC,SAAA,CAAA,kBAAA,CAAA,CAAA;AAAA,iBAUD,gCAAA,CACd,UAAA,EAAY,UAAA,EACZ,QAAA,WADsB,SAAA,CACN,mBAAA;;;cC9BL,uBAAA;EAAA;;;;8BAWH,eAAA,CAAA,SAAA;IAAA;;;;iBAGM,wBAAA,CAAyB,gBAAA;;;;;;8BAAD,eAAA,CAAA,SAAA;IAAA;;;;iBAQxB,mBAAA,CAAoB,UAAA,WAAkB,OAAA;;;iBCtBtC,gBAAA,CAAiB,UAAA;EAAc,MAAA;EAAa,KAAA;AAAA;;;;;;;;;;iBCC5C,gBAAA,CAAiB,MAAA;;;ARAjC;iBQiBgB,wBAAA,CACd,MAAA,UACA,MAAA,UACA,iBAAA"}

package/dist/src/utils/index.mjs

@@ -0,0 +1,380 @@
+import { spawnAsync } from "@powerhousedao/shared/clis";
+import path from "path";
+import { IndentationText, Project, SyntaxKind, ts } from "ts-morph";
+import arg from "arg";
+import { format } from "prettier";
+//#region src/utils/cli.ts
+const configSpec = {
+	"--document-models": String,
+	"--editors": String,
+	"--interactive": Boolean,
+	"--skip-format": Boolean,
+	"--watch": Boolean,
+	"-i": "--interactive",
+	"-sf": "--skip-format",
+	"-w": "--watch"
+};
+function parseArgs(argv, spec) {
+	return arg(spec, {
+		permissive: true,
+		argv
+	});
+}
+function parseConfig(argv) {
+	const config = {};
+	const args = parseArgs(argv, configSpec);
+	if ("--document-models" in args) config.documentModelsDir = args["--document-models"];
+	if ("--editors" in args) config.editorsDir = args["--editors"];
+	if ("--skip-format" in args) config.skipFormat = true;
+	if ("--interactive" in args) config.interactive = true;
+	if ("--watch" in args) config.watch = true;
+	return config;
+}
+//#endregion
+//#region src/utils/constants.ts
+/** Document model metadata for the `powerhouse/document-model` document type.
+*
+* Assumed to always be present during codegen.
+*/
+const documentModelDocumentTypeMetadata = {
+	documentModelId: "powerhouse/document-model",
+	documentModelDocumentTypeName: "DocumentModelDocument",
+	documentModelDirName: "document-model",
+	documentModelImportPath: "document-model"
+};
+//#endregion
+//#region src/utils/syntax-getters.ts
+/** Returns a ts-morph ObjectLiteralExpression from a variable statement
+* if the type matches
+*/
+function getObjectLiteral(statement) {
+	return statement?.getDeclarations().at(0)?.getInitializerIfKind(SyntaxKind.ObjectLiteralExpression);
+}
+/** Returns the value of a property in a ts-morph ObjectLiteralExpression of type T if it exists */
+function getObjectProperty(object, propertyName, propertyType) {
+	return object?.getProperty(propertyName)?.asKind(SyntaxKind.PropertyAssignment)?.getChildren().find((child) => child.getKind() === propertyType)?.asKindOrThrow(propertyType);
+}
+function getVariableDeclarationByTypeName(sourceFile, typeName) {
+	return sourceFile.getVariableDeclaration((declaration) => {
+		if ((declaration.getTypeNode()?.getText() ?? "").includes(typeName)) return true;
+		return declaration.getType().getText().includes(typeName);
+	});
+}
+//#endregion
+//#region src/utils/document-type-metadata.ts
+/** Gets the document model metadata for the --document-type argument
+* passed to the `generate --editor` and `generate --app` commands.
+*/
+function getDocumentTypeMetadata({ project, documentModelId, documentModelsDirPath }) {
+	const sourceFile = project.getSourceFiles().filter((file) => {
+		return file.getBaseName() === "document-model.ts";
+	}).find((file) => getDocumentModelFileByDocumentId(file, documentModelId));
+	if (!sourceFile) throw new Error(`No document-model.ts file exists for ${documentModelId}`);
+	const documentModelsDir = project.getDirectory(documentModelsDirPath);
+	if (!documentModelsDir) throw new Error(`No document-models dir exists for ${documentModelId}`);
+	const documentModelDir = project.getDirectories().find((dir) => sourceFile.getDirectory().isDescendantOf(dir) && dir.isDescendantOf(documentModelsDir));
+	if (!documentModelDir) throw new Error(`No document model dir exists for ${documentModelId}`);
+	const documentModelDirName = documentModelDir.getBaseName();
+	const documentModelImportPath = path.join("document-models", documentModelDirName);
+	const sourceFileDir = sourceFile.getDirectoryPath();
+	const documentModelGenTypesFilePath = path.join(sourceFileDir, "types.ts");
+	const documentModelGenTypesFile = project.getSourceFile(documentModelGenTypesFilePath);
+	if (!documentModelGenTypesFile) throw new Error(`No generated types file exists for ${documentModelId}`);
+	const documentModelDocumentTypeName = getPHDocumentTypeNameFromSourceFile(documentModelGenTypesFile);
+	if (!documentModelDocumentTypeName) throw new Error(`Generated type file is missing PHDocument type declaration for ${documentModelId}`);
+	return {
+		documentModelDirName,
+		documentModelDocumentTypeName,
+		documentModelId,
+		documentModelImportPath
+	};
+}
+function getDocumentModelFileByDocumentId(sourceFile, documentModelId) {
+	const documentModelStatement = sourceFile.getVariableStatement("documentModel");
+	if (!documentModelStatement) return false;
+	const documentModelObject = getObjectLiteral(documentModelStatement);
+	if (!documentModelObject) return false;
+	return getObjectProperty(documentModelObject, "id", SyntaxKind.StringLiteral)?.getLiteralValue() === documentModelId;
+}
+function getPHDocumentTypeNameFromSourceFile(sourceFile) {
+	return sourceFile.getTypeAliases().find((alias) => {
+		return (alias.getTypeNode()?.getText())?.includes("PHDocument");
+	})?.getName();
+}
+//#endregion
+//#region src/utils/format-with-prettier.ts
+/** Formats the text of a ts-morph source file with prettier before writing the text to memory */
+async function formatSourceFileWithPrettier(sourceFile) {
+	const sourceText = sourceFile.getFullText();
+	let formattedText = sourceText;
+	try {
+		formattedText = await format(sourceText, { parser: "typescript" });
+	} catch (error) {
+		console.error(error);
+	}
+	sourceFile.replaceWithText(formattedText);
+}
+async function runPrettier() {
+	await spawnAsync("npx", [
+		"prettier",
+		"--write",
+		"."
+	]);
+}
+//#endregion
+//#region src/utils/source-files.ts
+/** Gets a SourceFile by name in a ts-morph Project, or creates a new one
+* if none with that path exists.
+*/
+function getOrCreateSourceFile(project, filePath) {
+	const sourceFile = project.getSourceFile(filePath);
+	if (!sourceFile) return {
+		alreadyExists: false,
+		sourceFile: project.createSourceFile(filePath, "")
+	};
+	return {
+		alreadyExists: true,
+		sourceFile
+	};
+}
+/** Gets a Directory by name in a ts-morph Project, or creates a new one
+* if none with that path exists.
+*/
+function getOrCreateDirectory(project, dirPath) {
+	const directory = project.getDirectory(dirPath);
+	if (!directory) return {
+		alreadyExists: false,
+		directory: project.createDirectory(dirPath)
+	};
+	return {
+		alreadyExists: true,
+		directory
+	};
+}
+/** Ensures that the directories at the given paths exist within the
+* ts-morph Project
+*/
+async function ensureDirectoriesExist(project, ...pathsToEnsure) {
+	for (const dirPath of pathsToEnsure) if (!project.getDirectory(dirPath)) project.createDirectory(dirPath);
+	await project.save();
+}
+function getPreviousVersionSourceFile(args) {
+	const { project, version, filePath } = args;
+	const previousVersion = version - 1;
+	if (previousVersion < 1) return;
+	const previousVersionFilePath = filePath.replace(`/v${version}/`, `/v${previousVersion}/`);
+	return project.getSourceFile(previousVersionFilePath);
+}
+//#endregion
+//#region src/utils/syntax-builders.ts
+/** Builds a ts-morph ObjectLiteralExpression from a ts/js object
+* Useful for substituting the value of a runtime object in templates
+*/
+function buildObjectLiteral(inputObject, sourceFile) {
+	const propertyAssignments = [];
+	for (const [key, value] of Object.entries(inputObject)) {
+		const propertyAssignment = buildPropertyAssignment(key, value);
+		propertyAssignments.push(propertyAssignment);
+	}
+	const objectLiteral = ts.factory.createObjectLiteralExpression(propertyAssignments, true);
+	return buildNodePrinter(sourceFile)(objectLiteral);
+}
+function buildFalse() {
+	return ts.factory.createFalse();
+}
+function buildTrue() {
+	return ts.factory.createTrue();
+}
+function buildBoolean(value) {
+	return value ? buildTrue() : buildFalse();
+}
+function buildNull() {
+	return ts.factory.createNull();
+}
+function buildUndefined() {
+	return ts.factory.createIdentifier("undefined");
+}
+function buildNumericLiteral(value) {
+	return ts.factory.createNumericLiteral(value);
+}
+function buildStringLiteral(value) {
+	return ts.factory.createStringLiteral(value);
+}
+function buildArrayLiteral(elements) {
+	return ts.factory.createArrayLiteralExpression(elements, true);
+}
+function valueToExpression(value) {
+	if (value === null) return buildNull();
+	if (value === void 0) return buildUndefined();
+	if (typeof value === "boolean") return buildBoolean(value);
+	if (typeof value === "string") return buildStringLiteral(value);
+	if (typeof value === "number") return buildNumericLiteral(value);
+	if (Array.isArray(value)) return buildArrayLiteral(value.map((item) => valueToExpression(item)));
+	if (typeof value === "object") return ts.factory.createObjectLiteralExpression(Object.entries(value).map(([key, v]) => {
+		const name = ts.factory.createIdentifier(key);
+		return ts.factory.createPropertyAssignment(name, valueToExpression(v));
+	}), true);
+	throw new Error("Invalid value passed: ", value);
+}
+function buildPropertyAssignment(name, value) {
+	const nameIdentifier = ts.factory.createIdentifier(name);
+	const valueExpression = valueToExpression(value);
+	return ts.factory.createPropertyAssignment(nameIdentifier, valueExpression);
+}
+function buildNodePrinter(sourceFile) {
+	const printer = ts.createPrinter({ newLine: ts.NewLineKind.LineFeed });
+	return (node) => printer.printNode(ts.EmitHint.Unspecified, node, sourceFile.compilerNode);
+}
+//#endregion
+//#region src/utils/ts-morph-project.ts
+const DEFAULT_PROJECT_OPTIONS = {
+	skipAddingFilesFromTsConfig: true,
+	skipLoadingLibFiles: true,
+	manipulationSettings: {
+		useTrailingCommas: true,
+		indentationText: IndentationText.TwoSpaces,
+		indentMultiLineObjectLiteralBeginningOnBlankLine: true
+	}
+};
+/** Returns the minimal typescript config for use in ts-morph file generation */
+function getDefaultProjectOptions(tsConfigFilePath) {
+	return {
+		...DEFAULT_PROJECT_OPTIONS,
+		tsConfigFilePath
+	};
+}
+/** Instantiates a ts-morph Project using the default typescript config and nearest tsconfig.json file */
+function buildTsMorphProject(projectDir) {
+	return new Project(getDefaultProjectOptions(path.join(projectDir, "tsconfig.json")));
+}
+//#endregion
+//#region src/utils/unsafe-utils.ts
+function getInitialStates(scopeState) {
+	const { global, local } = scopeState;
+	const scopes = {
+		global,
+		local
+	};
+	Object.entries(scopes).forEach(([scope, state]) => {
+		if (!isEmptyStateSchema(state.schema) && state.initialValue === "") throw new Error(`${scope.charAt(0).toLocaleUpperCase() + scope.slice(1)} scope has a defined schema but is missing an initial value.`);
+	});
+	return {
+		initialGlobalState: handleEmptyState(global.initialValue),
+		initialLocalState: handleEmptyState(local.initialValue)
+	};
+}
+function isEmptyStateSchema(schema) {
+	return schema === "" || !schema.includes("{");
+}
+function handleEmptyState(state) {
+	return state === "" ? "{}" : state;
+}
+//#endregion
+//#region src/utils/validation.ts
+/**
+* Validates that a DocumentModelGlobalState has all required properties for successful code generation.
+*
+* @param documentModelState - The DocumentModelGlobalState to validate
+* @returns Validation result with isValid flag and error messages
+*/
+function validateDocumentModelState(documentModelState) {
+	const errors = [];
+	if (!documentModelState.id || typeof documentModelState.id !== "string" || documentModelState.id.trim() === "") errors.push("Property \"id\" is required and must be a non-empty string");
+	if (!documentModelState.name || typeof documentModelState.name !== "string" || documentModelState.name.trim() === "") errors.push("Property \"name\" is required and must be a non-empty string");
+	if (typeof documentModelState.extension !== "string") errors.push("Property \"extension\" must be a string");
+	if (!Array.isArray(documentModelState.specifications) || documentModelState.specifications.length === 0) {
+		errors.push("Property \"specifications\" is required and must be a non-empty array");
+		return {
+			isValid: false,
+			errors
+		};
+	}
+	const latestSpec = documentModelState.specifications[documentModelState.specifications.length - 1];
+	if (!latestSpec) {
+		errors.push("Latest specification is missing or invalid");
+		return {
+			isValid: false,
+			errors
+		};
+	}
+	if (!latestSpec.state) {
+		errors.push("Latest specification must have a \"state\" property");
+		return {
+			isValid: false,
+			errors
+		};
+	}
+	if (!latestSpec.state.global) errors.push("Latest specification state must have a \"global\" property");
+	else {
+		const globalState = latestSpec.state.global;
+		if (typeof globalState.schema !== "string") errors.push("Global state \"schema\" must be a string");
+		if (typeof globalState.initialValue !== "string") errors.push("Global state \"initialValue\" must be a string");
+		if (globalState.schema && globalState.schema.trim() !== "" && globalState.schema.includes("{") && (!globalState.initialValue || globalState.initialValue.trim() === "")) errors.push("Global state has a defined schema but is missing an initial value");
+	}
+	if (!latestSpec.state.local) errors.push("Latest specification state must have a \"local\" property");
+	else {
+		const localState = latestSpec.state.local;
+		if (typeof localState.schema !== "string") errors.push("Local state \"schema\" must be a string");
+		if (typeof localState.initialValue !== "string") errors.push("Local state \"initialValue\" must be a string");
+		if (localState.schema && localState.schema.trim() !== "" && localState.schema.includes("{") && (!localState.initialValue || localState.initialValue.trim() === "")) errors.push("Local state has a defined schema but is missing an initial value");
+	}
+	if (!Array.isArray(latestSpec.modules)) errors.push("Latest specification must have a \"modules\" array");
+	else {
+		if (latestSpec.modules.length === 0) errors.push("Latest specification must have at least one module defined");
+		latestSpec.modules.forEach((module, moduleIndex) => {
+			if (!module.name || typeof module.name !== "string" || module.name.trim() === "") errors.push(`Module at index ${moduleIndex} must have a non-empty "name" property`);
+			if (!Array.isArray(module.operations)) errors.push(`Module "${module.name || `at index ${moduleIndex}`}" must have an "operations" array`);
+			else {
+				if (module.operations.length === 0) errors.push(`Module "${module.name || `at index ${moduleIndex}`}" must have at least one operation defined`);
+				module.operations.forEach((operation, operationIndex) => {
+					const operationId = operation.name || `at index ${operationIndex}`;
+					const moduleId = module.name || `at index ${moduleIndex}`;
+					if (!operation.name || typeof operation.name !== "string" || operation.name.trim() === "") errors.push(`Operation ${operationId} in module "${moduleId}" must have a non-empty "name" property`);
+					if (operation.schema !== null && typeof operation.schema !== "string") errors.push(`Operation "${operationId}" in module "${moduleId}" must have a "schema" that is either null or a string`);
+					if (operation.scope !== void 0 && typeof operation.scope !== "string") errors.push(`Operation "${operationId}" in module "${moduleId}" must have a "scope" that is a string if provided`);
+					if (!Array.isArray(operation.errors)) errors.push(`Operation "${operationId}" in module "${moduleId}" must have an "errors" array`);
+				});
+			}
+		});
+	}
+	return {
+		isValid: errors.length === 0,
+		errors
+	};
+}
+//#endregion
+//#region src/utils/graphql-type-prefixes.ts
+/**
+* Extract type names from a GraphQL schema.
+* Finds all type, enum, union, interface, and input definitions.
+*/
+function extractTypeNames(schema) {
+	const found = schema.match(/(type|enum|union|interface|input)\s+(\w+)\s/g);
+	if (!found) return [];
+	return found.map((f) => f.replaceAll("type ", "").replaceAll("enum ", "").replaceAll("union ", "").replaceAll("interface ", "").replaceAll("input ", "").trim());
+}
+/**
+* Apply type prefixes to GraphQL schema to namespace types and avoid collisions.
+*/
+function applyGraphQLTypePrefixes(schema, prefix, externalTypeNames = []) {
+	if (!schema || !schema.trim()) return schema;
+	let processedSchema = schema;
+	const localTypeNames = extractTypeNames(schema);
+	const allTypeNames = [...new Set([...localTypeNames, ...externalTypeNames])];
+	if (allTypeNames.length === 0) return schema;
+	allTypeNames.forEach((typeName) => {
+		const typeRegex = new RegExp(`(?<![_A-Za-z0-9])(${typeName})(?![_A-Za-z0-9])|\\[(${typeName})\\]|\\[(${typeName})!\\]|\\[(${typeName})\\]!|\\[(${typeName})!\\]!`, "g");
+		processedSchema = processedSchema.replace(typeRegex, (match, p1, p2, p3, p4, p5) => {
+			if (match.startsWith("[")) {
+				const captured = p2 || p3 || p4 || p5;
+				return match.replace(captured, `${prefix}_${captured}`);
+			}
+			return `${prefix}_${p1}`;
+		});
+	});
+	return processedSchema;
+}
+//#endregion
+export { DEFAULT_PROJECT_OPTIONS, applyGraphQLTypePrefixes, buildObjectLiteral, buildStringLiteral, buildTsMorphProject, configSpec, documentModelDocumentTypeMetadata, ensureDirectoriesExist, extractTypeNames, formatSourceFileWithPrettier, getDefaultProjectOptions, getDocumentTypeMetadata, getInitialStates, getObjectLiteral, getObjectProperty, getOrCreateDirectory, getOrCreateSourceFile, getPHDocumentTypeNameFromSourceFile, getPreviousVersionSourceFile, getVariableDeclarationByTypeName, parseArgs, parseConfig, runPrettier, validateDocumentModelState };
+
+//# sourceMappingURL=index.mjs.map

package/dist/src/utils/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/utils/cli.ts","../../../src/utils/constants.ts","../../../src/utils/syntax-getters.ts","../../../src/utils/document-type-metadata.ts","../../../src/utils/format-with-prettier.ts","../../../src/utils/source-files.ts","../../../src/utils/syntax-builders.ts","../../../src/utils/ts-morph-project.ts","../../../src/utils/unsafe-utils.ts","../../../src/utils/validation.ts","../../../src/utils/graphql-type-prefixes.ts"],"sourcesContent":["import arg from \"arg\";\n\nexport const configSpec = {\n  \"--document-models\": String,\n  \"--editors\": String,\n  \"--interactive\": Boolean,\n  \"--skip-format\": Boolean,\n  \"--watch\": Boolean,\n  \"-i\": \"--interactive\",\n  \"-sf\": \"--skip-format\",\n  \"-w\": \"--watch\",\n} as const;\n\nexport function parseArgs<T extends arg.Spec>(argv: string[], spec: T) {\n  const args = arg(spec, {\n    permissive: true,\n    argv,\n  });\n\n  return args;\n}\n\nexport function parseConfig(argv: string[]) {\n  const config: Partial<{\n    documentModelsDir?: string;\n    editorsDir?: string;\n    skipFormat?: boolean;\n    interactive?: boolean;\n    watch?: boolean;\n  }> = {};\n  const args = parseArgs(argv, configSpec);\n\n  if (\"--document-models\" in args) {\n    config.documentModelsDir = args[\"--document-models\"];\n  }\n\n  if (\"--editors\" in args) {\n    config.editorsDir = args[\"--editors\"];\n  }\n\n  if (\"--skip-format\" in args) {\n    config.skipFormat = true;\n  }\n  if (\"--interactive\" in args) {\n    config.interactive = true;\n  }\n  if (\"--watch\" in args) {\n    config.watch = true;\n  }\n\n  return config;\n}\n","/** Document model metadata for the `powerhouse/document-model` document type.\n *\n * Assumed to always be present during codegen.\n */\nexport const documentModelDocumentTypeMetadata = {\n  documentModelId: \"powerhouse/document-model\",\n  documentModelDocumentTypeName: \"DocumentModelDocument\",\n  documentModelDirName: \"document-model\",\n  documentModelImportPath: \"document-model\",\n} as const;\n","import type {\n  ObjectLiteralExpression,\n  SourceFile,\n  VariableStatement,\n} from \"ts-morph\";\nimport { SyntaxKind } from \"ts-morph\";\n\n/** Returns a ts-morph ObjectLiteralExpression from a variable statement\n * if the type matches\n */\nexport function getObjectLiteral(statement: VariableStatement | undefined) {\n  return statement\n    ?.getDeclarations()\n    .at(0)\n    ?.getInitializerIfKind(SyntaxKind.ObjectLiteralExpression);\n}\n\n/** Returns the value of a property in a ts-morph ObjectLiteralExpression of type T if it exists */\nexport function getObjectProperty<T extends SyntaxKind>(\n  object: ObjectLiteralExpression | undefined,\n  propertyName: string,\n  propertyType: T,\n) {\n  return object\n    ?.getProperty(propertyName)\n    ?.asKind(SyntaxKind.PropertyAssignment)\n    ?.getChildren()\n    .find((child) => child.getKind() === propertyType)\n    ?.asKindOrThrow(propertyType);\n}\n\nexport function getVariableDeclarationByTypeName(\n  sourceFile: SourceFile,\n  typeName: string,\n) {\n  const declaration = sourceFile.getVariableDeclaration((declaration) => {\n    // First try matching the type annotation text (more reliable when types\n    // can't be fully resolved, e.g. in external projects with linked deps)\n    const typeAnnotation = declaration.getTypeNode()?.getText() ?? \"\";\n    if (typeAnnotation.includes(typeName)) return true;\n    // Fall back to resolved type text\n    return declaration.getType().getText().includes(typeName);\n  });\n  return declaration;\n}\n","import type { DocumentModelDocumentTypeMetadata } from \"file-builders\";\nimport path from \"path\";\nimport type { Project, SourceFile } from \"ts-morph\";\nimport { SyntaxKind } from \"ts-morph\";\nimport { getObjectLiteral, getObjectProperty } from \"./syntax-getters.js\";\n\ntype GetDocumentTypeMetadataArgs = {\n  project: Project;\n  documentModelId: string;\n  documentModelsDirPath: string;\n};\n/** Gets the document model metadata for the --document-type argument\n * passed to the `generate --editor` and `generate --app` commands.\n */\nexport function getDocumentTypeMetadata({\n  project,\n  documentModelId,\n  documentModelsDirPath,\n}: GetDocumentTypeMetadataArgs) {\n  const sourceFiles = project.getSourceFiles().filter((file) => {\n    return file.getBaseName() === \"document-model.ts\";\n  });\n\n  const sourceFile = sourceFiles.find((file) =>\n    getDocumentModelFileByDocumentId(file, documentModelId),\n  );\n\n  if (!sourceFile) {\n    throw new Error(`No document-model.ts file exists for ${documentModelId}`);\n  }\n\n  const documentModelsDir = project.getDirectory(documentModelsDirPath);\n\n  if (!documentModelsDir) {\n    throw new Error(`No document-models dir exists for ${documentModelId}`);\n  }\n\n  const documentModelDir = project\n    .getDirectories()\n    .find(\n      (dir) =>\n        sourceFile.getDirectory().isDescendantOf(dir) &&\n        dir.isDescendantOf(documentModelsDir),\n    );\n\n  if (!documentModelDir) {\n    throw new Error(`No document model dir exists for ${documentModelId}`);\n  }\n\n  const documentModelDirName = documentModelDir.getBaseName();\n\n  const documentModelImportPath = path.join(\n    \"document-models\",\n    documentModelDirName,\n  );\n\n  // types.ts lives in the same gen/ directory as document-model.ts\n  // For non-versioned: <model>/gen/types.ts\n  // For versioned: <model>/v1/gen/types.ts\n  const sourceFileDir = sourceFile.getDirectoryPath();\n  const documentModelGenTypesFilePath = path.join(sourceFileDir, \"types.ts\");\n\n  const documentModelGenTypesFile = project.getSourceFile(\n    documentModelGenTypesFilePath,\n  );\n\n  if (!documentModelGenTypesFile) {\n    throw new Error(`No generated types file exists for ${documentModelId}`);\n  }\n\n  const documentModelDocumentTypeName = getPHDocumentTypeNameFromSourceFile(\n    documentModelGenTypesFile,\n  );\n\n  if (!documentModelDocumentTypeName) {\n    throw new Error(\n      `Generated type file is missing PHDocument type declaration for ${documentModelId}`,\n    );\n  }\n  const documentTypeMetadata: DocumentModelDocumentTypeMetadata = {\n    documentModelDirName,\n    documentModelDocumentTypeName,\n    documentModelId,\n    documentModelImportPath,\n  };\n\n  return documentTypeMetadata;\n}\n\nfunction getDocumentModelFileByDocumentId(\n  sourceFile: SourceFile,\n  documentModelId: string,\n) {\n  const documentModelStatement =\n    sourceFile.getVariableStatement(\"documentModel\");\n\n  if (!documentModelStatement) {\n    return false;\n  }\n\n  const documentModelObject = getObjectLiteral(documentModelStatement);\n\n  if (!documentModelObject) {\n    return false;\n  }\n\n  const documentModelIdProperty = getObjectProperty(\n    documentModelObject,\n    \"id\",\n    SyntaxKind.StringLiteral,\n  );\n\n  return documentModelIdProperty?.getLiteralValue() === documentModelId;\n}\n\nexport function getPHDocumentTypeNameFromSourceFile(sourceFile: SourceFile) {\n  return sourceFile\n    .getTypeAliases()\n    .find((alias) => {\n      const typeNodeText = alias.getTypeNode()?.getText();\n      return typeNodeText?.includes(\"PHDocument\");\n    })\n    ?.getName();\n}\n","import { spawnAsync } from \"@powerhousedao/shared/clis\";\nimport { format } from \"prettier\";\nimport type { SourceFile } from \"ts-morph\";\n\n/** Formats the text of a ts-morph source file with prettier before writing the text to memory */\nexport async function formatSourceFileWithPrettier(sourceFile: SourceFile) {\n  const sourceText = sourceFile.getFullText();\n  let formattedText = sourceText;\n  try {\n    formattedText = await format(sourceText, {\n      parser: \"typescript\",\n    });\n  } catch (error) {\n    console.error(error);\n  }\n  sourceFile.replaceWithText(formattedText);\n}\n\nexport async function runPrettier() {\n  await spawnAsync(\"npx\", [\"prettier\", \"--write\", \".\"]);\n}\n","import type { Project } from \"ts-morph\";\n\n/** Gets a SourceFile by name in a ts-morph Project, or creates a new one\n * if none with that path exists.\n */\nexport function getOrCreateSourceFile(project: Project, filePath: string) {\n  const sourceFile = project.getSourceFile(filePath);\n  if (!sourceFile) {\n    const newSourceFile = project.createSourceFile(filePath, \"\");\n    return {\n      alreadyExists: false,\n      sourceFile: newSourceFile,\n    };\n  }\n  return {\n    alreadyExists: true,\n    sourceFile,\n  };\n}\n\n/** Gets a Directory by name in a ts-morph Project, or creates a new one\n * if none with that path exists.\n */\nexport function getOrCreateDirectory(project: Project, dirPath: string) {\n  const directory = project.getDirectory(dirPath);\n  if (!directory) {\n    const newDirectory = project.createDirectory(dirPath);\n    return {\n      alreadyExists: false,\n      directory: newDirectory,\n    };\n  }\n  return {\n    alreadyExists: true,\n    directory,\n  };\n}\n\n/** Ensures that the directories at the given paths exist within the\n * ts-morph Project\n */\nexport async function ensureDirectoriesExist(\n  project: Project,\n  ...pathsToEnsure: string[]\n) {\n  for (const dirPath of pathsToEnsure) {\n    const dir = project.getDirectory(dirPath);\n    if (!dir) {\n      project.createDirectory(dirPath);\n    }\n  }\n  await project.save();\n}\n\nexport function getPreviousVersionSourceFile(args: {\n  project: Project;\n  version: number;\n  filePath: string;\n}) {\n  const { project, version, filePath } = args;\n  const previousVersion = version - 1;\n  if (previousVersion < 1) return;\n  const previousVersionFilePath = filePath.replace(\n    `/v${version}/`,\n    `/v${previousVersion}/`,\n  );\n\n  const previousVersionFile = project.getSourceFile(previousVersionFilePath);\n\n  return previousVersionFile;\n}\n","import type { SourceFile } from \"ts-morph\";\nimport { ts } from \"ts-morph\";\n\n/** Builds a ts-morph ObjectLiteralExpression from a ts/js object\n * Useful for substituting the value of a runtime object in templates\n */\nexport function buildObjectLiteral(\n  inputObject: object,\n  sourceFile: SourceFile,\n) {\n  const propertyAssignments: ts.PropertyAssignment[] = [];\n  for (const [key, value] of Object.entries(inputObject)) {\n    const propertyAssignment = buildPropertyAssignment(key, value);\n    propertyAssignments.push(propertyAssignment);\n  }\n  const objectLiteral = ts.factory.createObjectLiteralExpression(\n    propertyAssignments,\n    true,\n  );\n\n  const printNode = buildNodePrinter(sourceFile);\n  return printNode(objectLiteral);\n}\n\nfunction buildFalse() {\n  return ts.factory.createFalse();\n}\n\nfunction buildTrue() {\n  return ts.factory.createTrue();\n}\n\nfunction buildBoolean(value: boolean) {\n  return value ? buildTrue() : buildFalse();\n}\n\nfunction buildNull() {\n  return ts.factory.createNull();\n}\n\nfunction buildUndefined() {\n  return ts.factory.createIdentifier(\"undefined\");\n}\n\nfunction buildNumericLiteral(value: number) {\n  return ts.factory.createNumericLiteral(value);\n}\n\nexport function buildStringLiteral(value: string) {\n  return ts.factory.createStringLiteral(value);\n}\n\nfunction buildArrayLiteral(elements: ts.Expression[]) {\n  return ts.factory.createArrayLiteralExpression(elements, true);\n}\n\nfunction valueToExpression(value: unknown): ts.Expression {\n  if (value === null) return buildNull();\n  if (value === undefined) return buildUndefined();\n  if (typeof value === \"boolean\") return buildBoolean(value);\n  if (typeof value === \"string\") return buildStringLiteral(value);\n  if (typeof value === \"number\") return buildNumericLiteral(value);\n\n  if (Array.isArray(value)) {\n    const elements = value.map((item) => valueToExpression(item));\n    return buildArrayLiteral(elements);\n  }\n\n  if (typeof value === \"object\") {\n    return ts.factory.createObjectLiteralExpression(\n      Object.entries(value).map(([key, v]) => {\n        const name = ts.factory.createIdentifier(key);\n        return ts.factory.createPropertyAssignment(name, valueToExpression(v));\n      }),\n      true,\n    );\n  }\n\n  throw new Error(\"Invalid value passed: \", value);\n}\n\nfunction buildPropertyAssignment(name: string, value: unknown) {\n  const nameIdentifier = ts.factory.createIdentifier(name);\n  const valueExpression = valueToExpression(value);\n\n  const propertyAssignment = ts.factory.createPropertyAssignment(\n    nameIdentifier,\n    valueExpression,\n  );\n\n  return propertyAssignment;\n}\n\nfunction buildNodePrinter(sourceFile: SourceFile) {\n  const printer = ts.createPrinter({ newLine: ts.NewLineKind.LineFeed });\n  return (node: ts.Node) =>\n    printer.printNode(ts.EmitHint.Unspecified, node, sourceFile.compilerNode);\n}\n","import path from \"path\";\nimport { IndentationText, Project } from \"ts-morph\";\n\nexport const DEFAULT_PROJECT_OPTIONS = {\n  // don't add files from the tsconfig.json file, only use the ones we need\n  skipAddingFilesFromTsConfig: true,\n  // don't load library files, we only need the files we're adding\n  skipLoadingLibFiles: true,\n  // use formatting rules which match prettier\n  manipulationSettings: {\n    useTrailingCommas: true,\n    indentationText: IndentationText.TwoSpaces,\n    indentMultiLineObjectLiteralBeginningOnBlankLine: true,\n  },\n} as const;\n\n/** Returns the minimal typescript config for use in ts-morph file generation */\nexport function getDefaultProjectOptions(tsConfigFilePath: string) {\n  return {\n    ...DEFAULT_PROJECT_OPTIONS,\n    tsConfigFilePath,\n  };\n}\n\n/** Instantiates a ts-morph Project using the default typescript config and nearest tsconfig.json file */\nexport function buildTsMorphProject(projectDir: string) {\n  const tsConfigFilePath = path.join(projectDir, \"tsconfig.json\");\n  const project = new Project(getDefaultProjectOptions(tsConfigFilePath));\n  return project;\n}\n","/* eslint-disable @typescript-eslint/no-unsafe-assignment */\n/* eslint-disable @typescript-eslint/no-unsafe-member-access */\n/* eslint-disable @typescript-eslint/no-unsafe-argument */\nexport function getInitialStates(scopeState: { global: any; local: any }) {\n  const { global, local } = scopeState;\n  const scopes = { global, local };\n\n  Object.entries(scopes).forEach(([scope, state]) => {\n    if (!isEmptyStateSchema(state.schema) && state.initialValue === \"\") {\n      throw new Error(\n        `${\n          scope.charAt(0).toLocaleUpperCase() + scope.slice(1)\n        } scope has a defined schema but is missing an initial value.`,\n      );\n    }\n  });\n\n  return {\n    initialGlobalState: handleEmptyState(global.initialValue),\n    initialLocalState: handleEmptyState(local.initialValue),\n  };\n}\n\nfunction isEmptyStateSchema(schema: string | string[]) {\n  return schema === \"\" || !schema.includes(\"{\");\n}\n\nfunction handleEmptyState(state: string) {\n  return state === \"\" ? \"{}\" : state;\n}\n","import type { DocumentModelGlobalState } from \"@powerhousedao/shared/document-model\";\n\n/**\n * Validation result for DocumentModelGlobalState code generation requirements\n */\nexport interface DocumentModelStateValidationResult {\n  /** Whether the DocumentModelGlobalState is valid for code generation */\n  isValid: boolean;\n  /** Array of validation error messages if validation fails */\n  errors: string[];\n}\n\n/**\n * Validates that a DocumentModelGlobalState has all required properties for successful code generation.\n *\n * @param documentModelState - The DocumentModelGlobalState to validate\n * @returns Validation result with isValid flag and error messages\n */\nexport function validateDocumentModelState(\n  documentModelState: DocumentModelGlobalState,\n): DocumentModelStateValidationResult {\n  const errors: string[] = [];\n\n  // Validate top-level required properties\n  if (\n    !documentModelState.id ||\n    typeof documentModelState.id !== \"string\" ||\n    documentModelState.id.trim() === \"\"\n  ) {\n    errors.push('Property \"id\" is required and must be a non-empty string');\n  }\n\n  if (\n    !documentModelState.name ||\n    typeof documentModelState.name !== \"string\" ||\n    documentModelState.name.trim() === \"\"\n  ) {\n    errors.push('Property \"name\" is required and must be a non-empty string');\n  }\n\n  // Extension field is optional (can be empty string)\n  if (typeof documentModelState.extension !== \"string\") {\n    errors.push('Property \"extension\" must be a string');\n  }\n\n  // Validate specifications array\n  if (\n    !Array.isArray(documentModelState.specifications) ||\n    documentModelState.specifications.length === 0\n  ) {\n    errors.push(\n      'Property \"specifications\" is required and must be a non-empty array',\n    );\n    return { isValid: false, errors };\n  }\n\n  // Get the latest specification (used by code generation)\n  const latestSpec =\n    documentModelState.specifications[\n      documentModelState.specifications.length - 1\n    ];\n\n  if (!latestSpec) {\n    errors.push(\"Latest specification is missing or invalid\");\n    return { isValid: false, errors };\n  }\n\n  // Validate state structure\n  if (!latestSpec.state) {\n    errors.push('Latest specification must have a \"state\" property');\n    return { isValid: false, errors };\n  }\n\n  // Validate global state (required)\n  if (!latestSpec.state.global) {\n    errors.push('Latest specification state must have a \"global\" property');\n  } else {\n    const globalState = latestSpec.state.global;\n\n    if (typeof globalState.schema !== \"string\") {\n      errors.push('Global state \"schema\" must be a string');\n    }\n\n    if (typeof globalState.initialValue !== \"string\") {\n      errors.push('Global state \"initialValue\" must be a string');\n    }\n\n    // Check if schema is non-empty but initialValue is missing\n    const hasNonEmptySchema =\n      globalState.schema &&\n      globalState.schema.trim() !== \"\" &&\n      globalState.schema.includes(\"{\");\n    if (\n      hasNonEmptySchema &&\n      (!globalState.initialValue || globalState.initialValue.trim() === \"\")\n    ) {\n      errors.push(\n        \"Global state has a defined schema but is missing an initial value\",\n      );\n    }\n  }\n\n  // Validate local state (required - templates directly access it)\n  if (!latestSpec.state.local) {\n    errors.push('Latest specification state must have a \"local\" property');\n  } else {\n    const localState = latestSpec.state.local;\n\n    if (typeof localState.schema !== \"string\") {\n      errors.push('Local state \"schema\" must be a string');\n    }\n\n    if (typeof localState.initialValue !== \"string\") {\n      errors.push('Local state \"initialValue\" must be a string');\n    }\n\n    // Check if schema is non-empty but initialValue is missing\n    const hasNonEmptySchema =\n      localState.schema &&\n      localState.schema.trim() !== \"\" &&\n      localState.schema.includes(\"{\");\n    if (\n      hasNonEmptySchema &&\n      (!localState.initialValue || localState.initialValue.trim() === \"\")\n    ) {\n      errors.push(\n        \"Local state has a defined schema but is missing an initial value\",\n      );\n    }\n  }\n\n  // Validate modules array (required but can be empty)\n  if (!Array.isArray(latestSpec.modules)) {\n    errors.push('Latest specification must have a \"modules\" array');\n  } else {\n    // Validate that there's at least one module\n    if (latestSpec.modules.length === 0) {\n      errors.push(\"Latest specification must have at least one module defined\");\n    }\n\n    latestSpec.modules.forEach((module, moduleIndex) => {\n      if (\n        !module.name ||\n        typeof module.name !== \"string\" ||\n        module.name.trim() === \"\"\n      ) {\n        errors.push(\n          `Module at index ${moduleIndex} must have a non-empty \"name\" property`,\n        );\n      }\n\n      if (!Array.isArray(module.operations)) {\n        errors.push(\n          `Module \"${module.name || `at index ${moduleIndex}`}\" must have an \"operations\" array`,\n        );\n      } else {\n        // Validate that each module has at least one operation\n        if (module.operations.length === 0) {\n          errors.push(\n            `Module \"${module.name || `at index ${moduleIndex}`}\" must have at least one operation defined`,\n          );\n        }\n\n        module.operations.forEach((operation, operationIndex) => {\n          const operationId = operation.name || `at index ${operationIndex}`;\n          const moduleId = module.name || `at index ${moduleIndex}`;\n\n          // operation.name is required for code generation\n          if (\n            !operation.name ||\n            typeof operation.name !== \"string\" ||\n            operation.name.trim() === \"\"\n          ) {\n            errors.push(\n              `Operation ${operationId} in module \"${moduleId}\" must have a non-empty \"name\" property`,\n            );\n          }\n\n          // operation.schema can be null or string (required property)\n          if (\n            operation.schema !== null &&\n            typeof operation.schema !== \"string\"\n          ) {\n            errors.push(\n              `Operation \"${operationId}\" in module \"${moduleId}\" must have a \"schema\" that is either null or a string`,\n            );\n          }\n\n          // operation.scope is optional - template uses `a.scope || \"global\"` fallback\n          if (\n            operation.scope !== undefined &&\n            typeof operation.scope !== \"string\"\n          ) {\n            errors.push(\n              `Operation \"${operationId}\" in module \"${moduleId}\" must have a \"scope\" that is a string if provided`,\n            );\n          }\n\n          // operation.errors is required - templates directly access it\n          if (!Array.isArray(operation.errors)) {\n            errors.push(\n              `Operation \"${operationId}\" in module \"${moduleId}\" must have an \"errors\" array`,\n            );\n          }\n        });\n      }\n    });\n  }\n\n  return {\n    isValid: errors.length === 0,\n    errors,\n  };\n}\n","/**\n * Extract type names from a GraphQL schema.\n * Finds all type, enum, union, interface, and input definitions.\n */\nexport function extractTypeNames(schema: string): string[] {\n  const found = schema.match(/(type|enum|union|interface|input)\\s+(\\w+)\\s/g);\n  if (!found) return [];\n  return found.map((f) =>\n    f\n      .replaceAll(\"type \", \"\")\n      .replaceAll(\"enum \", \"\")\n      .replaceAll(\"union \", \"\")\n      .replaceAll(\"interface \", \"\")\n      .replaceAll(\"input \", \"\")\n      .trim(),\n  );\n}\n\n/**\n * Apply type prefixes to GraphQL schema to namespace types and avoid collisions.\n */\nexport function applyGraphQLTypePrefixes(\n  schema: string,\n  prefix: string,\n  externalTypeNames: string[] = [],\n): string {\n  if (!schema || !schema.trim()) {\n    return schema;\n  }\n\n  let processedSchema = schema;\n\n  // Find types defined in this schema\n  const localTypeNames = extractTypeNames(schema);\n\n  // Combine with external type names (remove duplicates)\n  const allTypeNames = [...new Set([...localTypeNames, ...externalTypeNames])];\n\n  if (allTypeNames.length === 0) {\n    return schema;\n  }\n\n  allTypeNames.forEach((typeName) => {\n    const typeRegex = new RegExp(\n      // Match type references in various GraphQL contexts\n      `(?<![_A-Za-z0-9])(${typeName})(?![_A-Za-z0-9])|` +\n        `\\\\[(${typeName})\\\\]|` +\n        `\\\\[(${typeName})!\\\\]|` +\n        `\\\\[(${typeName})\\\\]!|` +\n        `\\\\[(${typeName})!\\\\]!`,\n      \"g\",\n    );\n\n    processedSchema = processedSchema.replace(\n      typeRegex,\n      (\n        match: string,\n        p1: string,\n        p2: string,\n        p3: string,\n        p4: string,\n        p5: string,\n      ) => {\n        if (match.startsWith(\"[\")) {\n          const captured = p2 || p3 || p4 || p5;\n          return match.replace(captured, `${prefix}_${captured}`);\n        }\n        // Basic type reference\n        return `${prefix}_${p1}`;\n      },\n    );\n  });\n\n  return processedSchema;\n}\n"],"mappings":"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"}