@powerhousedao/codegen 6.2.2-dev.41 → 6.2.2-dev.43

package/dist/{file-builders-DaV8C_6p.mjs → file-builders-BBNHqY4N.mjs}

@@ -5185,36 +5185,88 @@ ${buildCreatorsExports(v.specification.modules, v.camelCaseDocumentType)}
 `.raw;
 //#endregion
 //#region src/templates/document-model/gen/document-schema.ts
-const documentModelDocumentSchemaFileTemplate = (v) => ts$1`
+function priorVersions(versions, currentVersion) {
+	return versions.filter((k) => k < currentVersion);
+}
+function makeOlderStateSchemaImports(versions, currentVersion, phStateName) {
+	return priorVersions(versions, currentVersion).map((k) => `import { ${phStateName}Schema as ${phStateName}SchemaV${k} } from "../../v${k}/gen/document-schema.js";`).join("\n");
+}
+function makeStateSchemasByVersion(versions, currentVersion, phStateName) {
+	return `{ ${versions.filter((k) => k <= currentVersion).map((k) => {
+		return `${k}: ${k === currentVersion ? `${phStateName}Schema` : `${phStateName}SchemaV${k}`}`;
+	}).join(", ")} }`;
+}
+function makeDocumentSchemasByVersion(versions, currentVersion, v) {
+	return `{ ${versions.filter((k) => k <= currentVersion).map((k) => {
+		if (k === currentVersion) return `${k}: ${v.phDocumentSchemaName}`;
+		return `${k}: z.object({ header: ${v.phDocumentTypeName}HeaderSchema, state: ${v.phStateName}SchemaV${k}, initialState: ${v.phStateName}SchemaV${k} })`;
+	}).join(", ")} }`;
+}
 /**
- * WARNING: DO NOT EDIT
- * This file is auto-generated and updated by codegen
- */
-import {
-  BaseDocumentHeaderSchema,
-  BaseDocumentStateSchema,
-} from "document-model";
-import { z } from "zod";
-import { ${v.documentTypeVariableName} } from "./document-type.js";
-import { ${v.stateSchemaName} } from "./schema/zod.js";
-import type { ${v.phDocumentTypeName}, ${v.phStateName} } from "./types.js";
+* Version-aware validators are only emitted for versions with released
+* predecessors: a document is validated against the schema of the version it
+* is stamped with, so a later version may add non-nullable fields without
+* rejecting documents that have not been upgraded yet.
+*/
+function makeVersionAwareValidators(v) {
+	return `
+const ${v.phStateName}SchemasByVersion: Record<number, z.ZodType> = ${makeStateSchemasByVersion(v.versions, v.version, v.phStateName)};
 
-/** Schema for validating the header object of a ${v.pascalCaseDocumentType} document */
-export const ${v.phDocumentTypeName}HeaderSchema = BaseDocumentHeaderSchema.extend({
-  documentType: z.literal(${v.documentTypeVariableName}),
-});
+const ${v.phDocumentSchemaName}sByVersion: Record<number, z.ZodType> = ${makeDocumentSchemasByVersion(v.versions, v.version, v)};
 
-/** Schema for validating the state object of a ${v.pascalCaseDocumentType} document */
-export const ${v.phStateName}Schema = BaseDocumentStateSchema.extend({
-  global: ${v.stateSchemaName}(),
-});
+/** The document model version stamped in a state's document scope. States stamped with 0 or nothing predate versioning and are treated as version 1. */
+function stampedDocumentModelVersion(state: unknown): number {
+  if (typeof state !== "object" || state === null) return 1;
+  const documentScope = (state as { document?: unknown }).document;
+  if (typeof documentScope !== "object" || documentScope === null) return 1;
+  const version = (documentScope as { version?: unknown }).version;
+  return normalizeDocumentModelVersion(typeof version === "number" ? version : undefined);
+}
 
-export const ${v.phDocumentSchemaName} = z.object({
-  header: ${v.phDocumentTypeName}HeaderSchema,
-  state: ${v.phStateName}Schema,
-  initialState: ${v.phStateName}Schema,
-});
+function resolve${v.phStateName}Schema(state: unknown): z.ZodType {
+  const schema = ${v.phStateName}SchemasByVersion[stampedDocumentModelVersion(state)];
+  return schema ?? ${v.phStateName}Schema;
+}
+
+function resolve${v.phDocumentSchemaName}(document: unknown): z.ZodType {
+  const state = typeof document === "object" && document !== null
+    ? (document as { state?: unknown }).state
+    : undefined;
+  const schema = ${v.phDocumentSchemaName}sByVersion[stampedDocumentModelVersion(state)];
+  return schema ?? ${v.phDocumentSchemaName};
+}
+
+/** Simple helper function to check if a state object is a ${v.pascalCaseDocumentType} document state object. Validates against the schema of the version the state is stamped with. */
+export function ${v.isPhStateOfTypeFunctionName}(
+  state: unknown,
+): state is ${v.phStateName} {
+  return resolve${v.phStateName}Schema(state).safeParse(state).success;
+}
+
+/** Simple helper function to assert that a document state object is a ${v.pascalCaseDocumentType} document state object. Validates against the schema of the version the state is stamped with. */
+export function ${v.assertIsPhStateOfTypeFunctionName}(
+  state: unknown,
+): asserts state is ${v.phStateName} {
+  resolve${v.phStateName}Schema(state).parse(state);
+}
+
+/** Simple helper function to check if a document is a ${v.pascalCaseDocumentType} document. Validates against the schema of the version the document is stamped with, so documents on older versions remain valid until they are upgraded. */
+export function ${v.isPhDocumentOfTypeFunctionName}(
+  document: unknown,
+): document is ${v.phDocumentTypeName} {
+  return resolve${v.phDocumentSchemaName}(document).safeParse(document).success;
+}
 
+/** Simple helper function to assert that a document is a ${v.pascalCaseDocumentType} document. Validates against the schema of the version the document is stamped with, so documents on older versions remain valid until they are upgraded. */
+export function ${v.assertIsPhDocumentOfTypeFunctionName}(
+  document: unknown,
+): asserts document is ${v.phDocumentTypeName} {
+  resolve${v.phDocumentSchemaName}(document).parse(document);
+}
+`;
+}
+function makeSingleVersionValidators(v) {
+	return `
 /** Simple helper function to check if a state object is a ${v.pascalCaseDocumentType} document state object */
 export function ${v.isPhStateOfTypeFunctionName}(
   state: unknown,
@@ -5242,7 +5294,42 @@ export function ${v.assertIsPhDocumentOfTypeFunctionName}(
 ): asserts document is ${v.phDocumentTypeName} {
   ${v.phDocumentSchemaName}.parse(document);
 }
-`.raw;
+`;
+}
+const documentModelDocumentSchemaFileTemplate = (v) => {
+	const olderImports = makeOlderStateSchemaImports(v.versions, v.version, v.phStateName);
+	const hasPriorVersions = olderImports.length > 0;
+	return ts$1`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
+import {
+  BaseDocumentHeaderSchema,
+  BaseDocumentStateSchema,${hasPriorVersions ? "\n  normalizeDocumentModelVersion," : ""}
+} from "document-model";
+import { z } from "zod";
+import { ${v.documentTypeVariableName} } from "./document-type.js";
+import { ${v.stateSchemaName} } from "./schema/zod.js";
+import type { ${v.phDocumentTypeName}, ${v.phStateName} } from "./types.js";
+${hasPriorVersions ? olderImports + "\n" : ""}
+/** Schema for validating the header object of a ${v.pascalCaseDocumentType} document */
+export const ${v.phDocumentTypeName}HeaderSchema = BaseDocumentHeaderSchema.extend({
+  documentType: z.literal(${v.documentTypeVariableName}),
+});
+
+/** Schema for validating the state object of a ${v.pascalCaseDocumentType} document */
+export const ${v.phStateName}Schema = BaseDocumentStateSchema.extend({
+  global: ${v.stateSchemaName}(),
+});
+
+export const ${v.phDocumentSchemaName} = z.object({
+  header: ${v.phDocumentTypeName}HeaderSchema,
+  state: ${v.phStateName}Schema,
+  initialState: ${v.phStateName}Schema,
+});
+${hasPriorVersions ? makeVersionAwareValidators(v) : makeSingleVersionValidators(v)}`.raw;
+};
 //#endregion
 //#region src/templates/document-model/gen/document-type.ts
 const documentModelDocumentTypeTemplate = (v) => ts$1`
@@ -8720,4 +8807,4 @@ async function makeSubgraphsIndexFile(args) {
 //#endregion
 export { getVariableDeclarationByTypeName as $, upgradeManifestsTemplate as $n, documentModelPhFactoriesFileTemplate as $t, writeGeneratedProcessorsFiles as A, readmeTemplate as An, factoryBuildersTemplate as At, updateVersionedImports as B, mainTsxTemplate as Bn, makeOperationImportNames as Bt, buildBoilerplatePackageJson as C, documentEditorEditorFileTemplate as Cn, relationalDbSchemaTemplate as Ct, writeCIFiles as D, tsconfigPathsTemplate as Dn, relationalDbFactoryTemplate as Dt, writeAllGeneratedProjectFiles as E, tsConfigTemplate as En, relationalDbIndexTemplate as Et, tsMorphGenerateApp as F, pnpmWorkspaceTemplate as Fn, renderProcessorFilter as Ft, getAllImportModuleSpecifiers as G, indexHtmlTemplate as Gn, documentModelSrcIndexFileTemplate as Gt, DEFAULT_PROJECT_OPTIONS as H, reactorTsTemplate as Hn, makeTestCaseForOperation as Ht, makeEditorModuleFile as I, exportsTemplate as In, documentModelUtilsTemplate as It, getObjectLiteral as J, geminiSettingsTemplate as Jn, documentModelHooksFileTemplate as Jt, getAllImportNames as K, gitIgnoreTemplate as Kn, documentModelModuleFileTemplate as Kt, makeEditorsFile as L, packageJsonTemplate as Ln, upgradeTransitionTemplate as Lt, writeGeneratedSubgraphsFiles as M, buildPowerhouseConfigTemplate as Mn, analyticsIndexTemplate as Mt, writeModuleFiles as N, packageJsonExportsTemplate as Nn, analyticsFactoryTemplate as Nt, writeGeneratedDocumentModelsFiles as O, subgraphsIndexTemplate as On, processorsIndexTemplate as Ot, writeProjectRootFiles as P, packageJsonScriptsTemplate as Pn, parseFilterValues as Pt, getStringPropertyValue as Q, editorsTemplate as Qn, documentModelGenReducerFileTemplate as Qt, makeEditorsIndexFile as R, npmrcTemplate as Rn, upgradeManifestTemplate as Rt, writeCliDocsMarkdownFile as S, documentEditorModuleFileTemplate as Sn, subgraphIndexFileTemplate as St, writeAiConfigFiles as T, vitestConfigTemplate as Tn, relationalDbMigrationsTemplate as Tt, buildTsMorphProject as U, indexTsTemplate as Un, documentModelTestFileTemplate as Ut, getInitialStates as V, licenseTemplate as Vn, makeOperationsImports as Vt, getDefaultProjectOptions as W, legacyIndexHtmlTemplate as Wn, documentModelSrcUtilsTemplate as Wt, getProperyAssignmentByName as X, oxlintConfigTemplate as Xn, documentModelGenTypesTemplate as Xt, getObjectProperty as Y, oxfmtConfigTemplate as Yn, documentModelGenUtilsTemplate as Yt, getStringArrayPropertyElements as Z, editorsIndexTemplate as Zn, documentModelSchemaIndexTemplate as Zt, scalarsValidation as _, documentModelDocumentSchemaFileTemplate as _n, appDriveContentsFileTemplate as _r, parseArgs as _t, getOrCreateManifestFile as a, getDocumentModelDirName as an, connectEntrypointTemplate as ar, getOrCreateSourceFile as at, getCommandsHelpInfo as b, documentModelGenActionsFileTemplate as bn, customSubgraphSchemaTemplate as bt, operationHasEmptyInput as c, getEditorVariableNames as cn, agentsTemplate as cr, getProcessorMetadata as ct, generateDocumentModelZodSchemas as d, getActionInputName as dn, driveExplorerNavigationBreadcrumbsFileTemplate as dr, formatSafe as dt, documentModelOperationsModuleOperationsFileTemplate as en, documentModelsIndexTemplate as er, loadDocumentModelInDir as et, generateTypesAndZodSchemasFromGraphql as f, getActionInputTypeNames as fn, folderTreeFileTemplate as fr, formatSourceFileWithPrettier as ft, scalars as g, documentModelDocumentTypeTemplate as gn, driveExplorerFileTemplate as gr, configSpec as gt, getMockOverrideFieldNames as h, documentModelGenIndexFileTemplate as hn, emptyStateFileTemplate as hr, documentModelDocumentTypeMetadata as ht, createOrUpdateManifest as i, getModuleExportType as in, dockerfileTemplate as ir, getOrCreateDirectory as it, writeGeneratedProjectRootFiles as j, ManifestTemplate as jn, analyticsProcessorTemplate as jt, writeGeneratedEditorsFiles as k, styleTemplate as kn, processorsFactoryTemplate as kt, operationHasInput as l, getLatestDocumentModelSpec as ln, appEditorFileTemplate as lr, getAppMetadata as lt, getInputFieldNames as m, getActionTypeName as mn, appFilesFileTemplate as mr, getDocumentTypeMetadata as mt, tsMorphGenerateSubgraph as n, documentModelOperationsModuleCreatorsFileTemplate as nn, switchboardEntrypointTemplate as nr, buildStringLiteral as nt, pruneManifestSection as o, getDocumentModelSpecByVersionNumber as on, cursorMcpTemplate as or, getPreviousVersionSourceFile as ot, getDateLikeFieldNames as p, getActionType as pn, appFoldersFileTemplate as pr, runOxfmt as pt, getBooleanPropertyValue as q, syncAndPublishWorkflowTemplate as qn, documentModelIndexTemplate as qt, tsMorphGenerateProcessor as r, documentModelOperationModuleActionsFileTemplate as rn, nginxConfTemplate as rr, ensureDirectoriesExist as rt, makeModulesIndexFile as s, getDocumentModelVariableNames as sn, claudeSettingsLocalTemplate as sr, getSubgraphMetadata as st, makeSubgraphsIndexFile as t, documentModelOperationsModuleErrorFileTemplate as tn, documentModelsTemplate as tr, buildObjectLiteral as tt, tsMorphGenerateDocumentModel as u, getLatestDocumentModelSpecVersionNumber as un, appConfigFileTemplate as ur, getEditorMetadata as ut, tsMorphGenerateDocumentEditor as v, documentModelGenCreatorsFileTemplate as vn, createDocumentFileTemplate as vr, parseConfig as vt, applyProjectCustomizations as w, docsFromCliHelpTemplate as wn, relationalDbProcessorTemplate as wt, makeCliDocsFromHelp as x, documentModelRootActionsFileTemplate as xn, subgraphLibFileTemplate as xt, getCommandHelpInfo as y, documentModelGenControllerFileTemplate as yn, customSubgraphResolversTemplate as yt, validateDocumentModelState as z, mcpTemplate as zn, documentModelOperationsModuleTestFileTemplate as zt };
 
-//# sourceMappingURL=file-builders-DaV8C_6p.mjs.map
+//# sourceMappingURL=file-builders-BBNHqY4N.mjs.map