atmn 2.0.11 → 2.0.12

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"version":"7.0.0-dev.20260511.1","root":["../src/bin.ts","../src/cli.ts","../src/index.ts","../src/version.ts","../src/actions/env.ts","../src/actions/login.ts","../src/actions/pull.ts","../src/actions/push.ts","../src/actions/api/callApi.ts","../src/actions/api/registerApiCommands.ts","../src/actions/env/fetchOrgInfo.ts","../src/actions/env/types/orgInfo.ts","../src/actions/init/runInit.ts","../src/actions/login/keyless.ts","../src/actions/pull/appendPlanVersionFixture.ts","../src/actions/pull/applyPreview.ts","../src/actions/pull/applySettingsPreview.ts","../src/actions/pull/changedFixtureKeys.ts","../src/actions/pull/listSourceFiles.ts","../src/actions/pull/locateFixture.ts","../src/actions/pull/resolveCollectionTarget.ts","../src/actions/pull/rewriteConfig.ts","../src/actions/pull/scaffoldConfig.ts","../src/actions/push/backfillInternalIds.ts","../src/actions/push/deprecatedFields.ts","../src/actions/reset/runReset.ts","../src/actions/sandbox/createSandbox.ts","../src/actions/sandbox/deleteSandbox.ts","../src/actions/sandbox/listSandboxes.ts","../src/actions/sandbox/useSandbox.ts","../src/actions/sandbox/withSandboxScopeHint.ts","../src/actions/sandbox/types/sandboxClient.ts","../src/actions/skills/skills.ts","../src/auth/announceAuthorizationUrl.ts","../src/auth/buildAuthorizationUrl.ts","../src/auth/callbackPages.ts","../src/auth/createOrgApiKeys.ts","../src/auth/keyless.ts","../src/auth/oauthConfig.ts","../src/auth/runOAuthFlow.ts","../src/auth/browser/openSystemBrowser.ts","../src/auth/browser/tryOpenBrowser.ts","../src/auth/browser/watchLauncher.ts","../src/auth/types/browserOpener.ts","../src/auth/types/impersonationTokens.ts","../src/auth/types/oauthTokens.ts","../src/auth/types/orgApiKeys.ts","../src/config/configPackageName.ts","../src/config/legacyConfig.ts","../src/config/loadConfig.ts","../src/env/assertSandboxTarget.ts","../src/env/loadEnv.ts","../src/env/resolveTarget.ts","../src/env/sandboxKeyName.ts","../src/generated/apiRoutes.ts","../src/generated/client.ts","../src/generated/emit.ts","../src/generated/emitRuntime.ts","../src/generated/features.ts","../src/generated/labels.ts","../src/generated/licenses.ts","../src/generated/lintRules.ts","../src/generated/lintRuntime.ts","../src/generated/plans.ts","../src/generated/referralPrograms.ts","../src/generated/rewards.ts","../src/generated/settings.ts","../src/generated/skills.ts","../src/generated/variants.ts","../src/generated/wire.ts","../src/http/autumnFetch.ts","../src/project/chooseConfigDir.ts","../src/project/resolveProject.ts","../src/project/rootMarker.ts","../src/prompt/prompt.ts","../src/prompt/select.ts","../src/render/renderEnv.ts","../src/render/renderPreview.ts","../src/render/renderSandboxes.ts","../src/render/stripTerminalControls.ts","../src/repo/findRepoRoot.ts","../src/surgery/appendPropertyEdit.ts","../src/surgery/appendToArray.ts","../src/surgery/appendToBinding.ts","../src/surgery/appendToCollection.ts","../src/surgery/appendToFixtureArray.ts","../src/surgery/arrayBinding.ts","../src/surgery/deleteFixtureLiteral.ts","../src/surgery/deleteReference.ts","../src/surgery/ensureBuilderImport.ts","../src/surgery/findFixture.ts","../src/surgery/fixtureEdit.ts","../src/surgery/fixtureLocation.ts","../src/surgery/insertCollection.ts","../src/surgery/insertFirstProperty.ts","../src/surgery/patchFixtureProperty.ts","../src/surgery/patchSingletonProperty.ts","../src/surgery/replaceFixture.ts","../src/surgery/setFixtureProperty.ts","../src/surgery/staticFixtureRule.ts","../test/apiCommand.test.ts","../test/authorizationUrl.test.ts","../test/autumnFetch.test.ts","../test/backfill.test.ts","../test/backfillInlineVariants.test.ts","../test/backfillSlug.test.ts","../test/backfillVariants.test.ts","../test/chooseConfigDir.test.ts","../test/cliTargetFlags.test.ts","../test/client.test.ts","../test/configPackageName.test.ts","../test/emitFixture.test.ts","../test/env.test.ts","../test/envWriter.test.ts","../test/init.test.ts","../test/keyless.test.ts","../test/legacyConfig.test.ts","../test/lintDocument.test.ts","../test/loadConfigNode.test.ts","../test/loadConfigV2.test.ts","../test/login.test.ts","../test/nodeNextTypes.test.ts","../test/plans.test.ts","../test/previewIsEmpty.test.ts","../test/prompt.test.ts","../test/pull.test.ts","../test/pullByReference.test.ts","../test/pullFieldLevel.test.ts","../test/pullOmitDefaults.test.ts","../test/pullPlans.test.ts","../test/pullStatesSlugs.test.ts","../test/pullTwoCollections.test.ts","../test/renameHint.test.ts","../test/renderPreview.test.ts","../test/renderSandboxes.test.ts","../test/renderSettings.test.ts","../test/reset.test.ts","../test/resolveCollectionTarget.test.ts","../test/resolveProject.test.ts","../test/resolveTarget.test.ts","../test/sandboxActions.test.ts","../test/sandboxKeyName.test.ts","../test/sandboxUse.test.ts","../test/settingsActions.test.ts","../test/settingsWire.test.ts","../test/skills.test.ts","../test/watchLauncher.test.ts","../test/wireDocument.test.ts","../test/helpers/targetFor.ts","../test/surgery/appendToCollection.test.ts","../test/surgery/deleteFixtureLiteral.test.ts","../test/surgery/deleteReference.test.ts","../test/surgery/findFixture.test.ts","../test/surgery/fixtureLocation.test.ts","../test/surgery/insertCollection.test.ts","../test/surgery/insertFirstProperty.test.ts","../test/surgery/patchFixtureProperty.test.ts","../test/surgery/patchSingletonProperty.test.ts","../test/surgery/replaceFixture.test.ts","../test/surgery/staticFixtureRule.test.ts"]}
+{"version":"7.0.0-dev.20260511.1","root":["../src/bin.ts","../src/cli.ts","../src/index.ts","../src/version.ts","../src/actions/env.ts","../src/actions/login.ts","../src/actions/pull.ts","../src/actions/push.ts","../src/actions/api/callApi.ts","../src/actions/api/registerApiCommands.ts","../src/actions/env/fetchOrgInfo.ts","../src/actions/env/types/orgInfo.ts","../src/actions/init/runInit.ts","../src/actions/login/keyless.ts","../src/actions/pull/appendPlanVersionFixture.ts","../src/actions/pull/applyMappings.ts","../src/actions/pull/applyPreview.ts","../src/actions/pull/applySettingsPreview.ts","../src/actions/pull/changedFixtureKeys.ts","../src/actions/pull/listSourceFiles.ts","../src/actions/pull/locateFixture.ts","../src/actions/pull/resolveCollectionTarget.ts","../src/actions/pull/rewriteConfig.ts","../src/actions/pull/scaffoldConfig.ts","../src/actions/push/backfillInternalIds.ts","../src/actions/push/deprecatedFields.ts","../src/actions/reset/runReset.ts","../src/actions/sandbox/createSandbox.ts","../src/actions/sandbox/deleteSandbox.ts","../src/actions/sandbox/listSandboxes.ts","../src/actions/sandbox/useSandbox.ts","../src/actions/sandbox/withSandboxScopeHint.ts","../src/actions/sandbox/types/sandboxClient.ts","../src/actions/skills/ignoreBundledSkills.ts","../src/actions/skills/skills.ts","../src/auth/announceAuthorizationUrl.ts","../src/auth/buildAuthorizationUrl.ts","../src/auth/callbackPages.ts","../src/auth/createOrgApiKeys.ts","../src/auth/keyless.ts","../src/auth/oauthConfig.ts","../src/auth/runOAuthFlow.ts","../src/auth/browser/openSystemBrowser.ts","../src/auth/browser/tryOpenBrowser.ts","../src/auth/browser/watchLauncher.ts","../src/auth/types/browserOpener.ts","../src/auth/types/impersonationTokens.ts","../src/auth/types/oauthTokens.ts","../src/auth/types/orgApiKeys.ts","../src/config/configPackageName.ts","../src/config/legacyConfig.ts","../src/config/loadConfig.ts","../src/env/assertSandboxTarget.ts","../src/env/loadEnv.ts","../src/env/resolveTarget.ts","../src/env/sandboxKeyName.ts","../src/generated/apiRoutes.ts","../src/generated/client.ts","../src/generated/emit.ts","../src/generated/emitRuntime.ts","../src/generated/features.ts","../src/generated/labels.ts","../src/generated/licenses.ts","../src/generated/lintRules.ts","../src/generated/lintRuntime.ts","../src/generated/mappingAssignments.ts","../src/generated/plans.ts","../src/generated/referralPrograms.ts","../src/generated/rewards.ts","../src/generated/settings.ts","../src/generated/skills.ts","../src/generated/variants.ts","../src/generated/wire.ts","../src/http/autumnFetch.ts","../src/project/chooseConfigDir.ts","../src/project/resolveProject.ts","../src/project/rootMarker.ts","../src/prompt/prompt.ts","../src/prompt/select.ts","../src/render/renderEnv.ts","../src/render/renderPreview.ts","../src/render/renderSandboxes.ts","../src/render/stripTerminalControls.ts","../src/repo/findRepoRoot.ts","../src/surgery/appendPropertyEdit.ts","../src/surgery/appendToArray.ts","../src/surgery/appendToBinding.ts","../src/surgery/appendToCollection.ts","../src/surgery/appendToFixtureArray.ts","../src/surgery/arrayBinding.ts","../src/surgery/deleteFixtureLiteral.ts","../src/surgery/deleteReference.ts","../src/surgery/ensureBuilderImport.ts","../src/surgery/findFixture.ts","../src/surgery/fixtureEdit.ts","../src/surgery/fixtureLocation.ts","../src/surgery/insertCollection.ts","../src/surgery/insertFirstProperty.ts","../src/surgery/patchFixturePaths.ts","../src/surgery/patchFixtureProperty.ts","../src/surgery/patchSingletonProperty.ts","../src/surgery/readFixtureValue.ts","../src/surgery/replaceFixture.ts","../src/surgery/setFixtureProperty.ts","../src/surgery/staticFixtureRule.ts","../test/apiCommand.test.ts","../test/authorizationUrl.test.ts","../test/autumnFetch.test.ts","../test/backfill.test.ts","../test/backfillInlineVariants.test.ts","../test/backfillSlug.test.ts","../test/backfillVariants.test.ts","../test/chooseConfigDir.test.ts","../test/cliTargetFlags.test.ts","../test/client.test.ts","../test/configPackageName.test.ts","../test/emitFixture.test.ts","../test/env.test.ts","../test/envWriter.test.ts","../test/ignoreBundledSkills.test.ts","../test/init.test.ts","../test/keyless.test.ts","../test/legacyConfig.test.ts","../test/lintDocument.test.ts","../test/loadConfigNode.test.ts","../test/loadConfigV2.test.ts","../test/locateFixtureUnique.test.ts","../test/login.test.ts","../test/nodeNextTypes.test.ts","../test/patchFixturePaths.test.ts","../test/plans.test.ts","../test/previewIsEmpty.test.ts","../test/prompt.test.ts","../test/pull.test.ts","../test/pullByReference.test.ts","../test/pullFieldLevel.test.ts","../test/pullMappings.test.ts","../test/pullOmitDefaults.test.ts","../test/pullPlans.test.ts","../test/pullStatesSlugs.test.ts","../test/pullTwoCollections.test.ts","../test/readFixtureValue.test.ts","../test/renameHint.test.ts","../test/renderPreview.test.ts","../test/renderSandboxes.test.ts","../test/renderSettings.test.ts","../test/reset.test.ts","../test/resolveCollectionTarget.test.ts","../test/resolveProject.test.ts","../test/resolveTarget.test.ts","../test/sandboxActions.test.ts","../test/sandboxKeyName.test.ts","../test/sandboxUse.test.ts","../test/settingsActions.test.ts","../test/settingsWire.test.ts","../test/skills.test.ts","../test/watchLauncher.test.ts","../test/wireDocument.test.ts","../test/helpers/targetFor.ts","../test/surgery/appendToCollection.test.ts","../test/surgery/deleteFixtureLiteral.test.ts","../test/surgery/deleteReference.test.ts","../test/surgery/findFixture.test.ts","../test/surgery/fixtureLocation.test.ts","../test/surgery/insertCollection.test.ts","../test/surgery/insertFirstProperty.test.ts","../test/surgery/patchFixtureProperty.test.ts","../test/surgery/patchSingletonProperty.test.ts","../test/surgery/replaceFixture.test.ts","../test/surgery/staticFixtureRule.test.ts"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "atmn",
-  "version": "2.0.11",
+  "version": "2.0.12",
   "license": "MIT",
   "description": "The CLI for Autumn — define your pricing in code, sync it to Autumn, and keep everything in version control.",
   "bin": {
@@ -49,5 +49,5 @@
     "open": "10.2.0",
     "yaml": "2.9.0"
   },
-  "gitHead": "b19c41f62894316db8ed1d5d6a87ad5f8c3f3798"
+  "gitHead": "778e19f6d88f8becb9faeeacb5967d9f0675aef0"
 }

package/src/actions/init/runInit.ts

@@ -29,6 +29,7 @@ import {
 	runKeylessLogin,
 } from "../login/keyless";
 import { scaffoldConfig } from "../pull/scaffoldConfig";
+import { ignoreBundledSkills } from "../skills/ignoreBundledSkills";
 import { installSkills, SKILLS_DIR_NAME } from "../skills/skills";
 
 /** The network, behind functions so a test can hand over fakes. */
@@ -385,6 +386,7 @@ export const runInit = async ({
 
 	const skillsDir = join(configDir, SKILLS_DIR_NAME);
 	const { written } = installSkills({ dir: skillsDir, write: () => {} });
+	ignoreBundledSkills({ repoRoot, configDir });
 	prompter.write(
 		`${done(`Skills: ${relative(repoRoot, skillsDir)}/${written.join(", ")}`)}\n`,
 	);

package/src/actions/pull/applyMappings.ts

@@ -0,0 +1,100 @@
+import { COLLECTIONS, NESTED_FIXTURES } from "../../generated/emit";
+import { resolveBranch } from "../../generated/emitRuntime";
+import { mappingAssignments } from "../../generated/mappingAssignments";
+import { patchFixturePaths } from "../../surgery/patchFixturePaths";
+import { readFixtureValue } from "../../surgery/readFixtureValue";
+import { locateFixture } from "./locateFixture";
+
+export const applyMappings = ({
+	catalog,
+	configPath,
+	files,
+}: {
+	catalog: Record<string, unknown>;
+	configPath: string;
+	files: Map<string, string>;
+}): {
+	replaced: string[];
+	unlocated: { collection: string; id: string; action: string }[];
+} => {
+	const replaced: string[] = [];
+	const unlocated: { collection: string; id: string; action: string }[] = [];
+	const builders = Object.values(NESTED_FIXTURES).map(({ builder }) => builder);
+	for (const [collection, collectionSpec] of Object.entries(COLLECTIONS)) {
+		const rows = catalog[collection];
+		if (!collectionSpec.pull || !Array.isArray(rows)) continue;
+		for (const entry of rows) {
+			const { spec, row } = resolveBranch({ spec: collectionSpec, row: entry });
+			const id = row[spec.responseIdField];
+			if (!spec.mappings || typeof id !== "string" || row.archived === true)
+				continue;
+			const key = spec.versioned ? `${id}@${row.versionSlug ?? "v1"}` : id;
+			const located = locateFixture({
+				configPath,
+				files,
+				builder: spec.builder,
+				idField: spec.idField,
+				id,
+				internalId:
+					typeof row.internalId === "string" ? row.internalId : undefined,
+				where: spec.versioned
+					? [
+							{
+								field: "versionSlug",
+								equals:
+									typeof row.versionSlug === "string" ? row.versionSlug : "v1",
+								absentMeans: "v1",
+							},
+						]
+					: undefined,
+				allowDynamic: true,
+				requireUnique: true,
+			});
+			if (!located) {
+				unlocated.push({
+					collection,
+					id: key,
+					action: "cannot locate the fixture to write processor mappings",
+				});
+				continue;
+			}
+			const planned = mappingAssignments({
+				projection: spec.mappings,
+				local: readFixtureValue({
+					node: located.node,
+					builders: [spec.builder, ...builders],
+				}),
+				remote: row,
+			});
+			if (planned.errors.length) {
+				unlocated.push(
+					...planned.errors.map((action) => ({ collection, id: key, action })),
+				);
+				continue;
+			}
+			if (!planned.assignments.length) continue;
+			const patched = patchFixturePaths({
+				source: located.source,
+				builder: located.builder,
+				idField: located.idField,
+				id: located.id,
+				where: located.where,
+				builders,
+				assignments: planned.assignments,
+			});
+			if (!patched || patched.skipped.length) {
+				unlocated.push({
+					collection,
+					id: key,
+					action:
+						"cannot safely splice processor mappings into a computed or ambiguous value",
+				});
+				continue;
+			}
+			if (patched.source === located.source) continue;
+			files.set(located.file, patched.source);
+			replaced.push(key);
+		}
+	}
+	return { replaced, unlocated };
+};

package/src/actions/pull/locateFixture.ts

@@ -2,7 +2,7 @@ import type { SgNode } from "@ast-grep/napi";
 import {
 	type FixtureConstraint,
 	type FixtureShape,
-	findFixture,
+	findFixtures,
 } from "../../surgery/findFixture";
 
 /** The file, its source, the node, and the lookup that found it — reuse the
@@ -35,6 +35,7 @@ export const locateFixture = ({
 	internalId,
 	where,
 	allowDynamic = false,
+	requireUnique = false,
 }: {
 	configPath: string;
 	files: Map<string, string>;
@@ -44,6 +45,7 @@ export const locateFixture = ({
 	internalId?: string | null;
 	where?: FixtureConstraint[];
 	allowDynamic?: boolean;
+	requireUnique?: boolean;
 }): LocatedFixture | null => {
 	const others = [...files.keys()].filter((file) => file !== configPath);
 	const ordered = [configPath, ...others];
@@ -59,20 +61,33 @@ export const locateFixture = ({
 	];
 	const shapes = Array.isArray(builder) ? builder : [builder];
 	for (const attempt of attempts) {
+		const matches = new Map<string, LocatedFixture>();
 		for (const file of ordered) {
 			const source = files.get(file);
 			if (source === undefined) continue;
 			for (const shape of shapes) {
-				const node = findFixture({
+				const nodes = findFixtures({
 					source,
 					builder: shape,
 					allowDynamic,
 					...attempt,
 				});
-				if (node !== null)
-					return { file, source, node, builder: shape, ...attempt };
+				for (const node of nodes) {
+					const located = { file, source, node, builder: shape, ...attempt };
+					if (!requireUnique) return located;
+					const range = node.range();
+					const key = JSON.stringify([
+						file,
+						range.start.index,
+						range.end.index,
+					]);
+					matches.set(key, located);
+					if (matches.size > 1) return null;
+				}
 			}
 		}
+		const match = matches.values().next().value;
+		if (match !== undefined) return match;
 	}
 	return null;
 };

package/src/actions/pull.ts

@@ -16,6 +16,7 @@ import { resolveProject } from "../project/resolveProject";
 import { writeRootMarker } from "../project/rootMarker";
 import { createPrompter, done, type Prompter } from "../prompt/prompt";
 import type { SettingsPreview } from "../render/renderPreview";
+import { applyMappings } from "./pull/applyMappings";
 import { applyPreview, type PreviewEntry } from "./pull/applyPreview";
 import { applySettingsPreview } from "./pull/applySettingsPreview";
 import { listSourceFiles } from "./pull/listSourceFiles";
@@ -341,6 +342,27 @@ export const runPull = async ({
 		);
 	}
 
+	if (includeMappings) {
+		const managedCatalog = Object.fromEntries(
+			Object.entries(COLLECTIONS)
+				.filter(
+					([, spec]) =>
+						spec.wireKey !== undefined && wire[spec.wireKey] !== undefined,
+				)
+				.map(([collection]) => [collection, catalogRows[collection]]),
+		);
+		const mapped = applyMappings({
+			catalog: managedCatalog,
+			configPath,
+			files,
+		});
+		unlocated.push(...mapped.unlocated);
+		for (const id of mapped.replaced) {
+			if (!replaced.includes(id) && !appended.includes(id)) replaced.push(id);
+			lines.push(`↳ wrote processor mappings into ${id}`);
+		}
+	}
+
 	// A fixture that is not a plain literal cannot be edited in place; saying
 	// so before writing anything beats a half-applied pull.
 	if (unlocated.length > 0) throw new UnlocatableFixturesError({ unlocated });

package/src/actions/skills/ignoreBundledSkills.ts

@@ -0,0 +1,32 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { isAbsolute, join, relative, sep } from "node:path";
+import { SKILLS_DIR_NAME } from "./skills";
+
+export const ignoreBundledSkills = ({
+	repoRoot,
+	configDir,
+}: {
+	repoRoot: string;
+	configDir: string;
+}): void => {
+	const path = relative(repoRoot, join(configDir, SKILLS_DIR_NAME));
+	if (isAbsolute(path) || path === ".." || path.startsWith(`..${sep}`)) return;
+	if (/[\r\n]/.test(path)) return;
+	const pattern = `/${path
+		.split(sep)
+		.join("/")
+		.replace(/[\\*?[\] ]/g, "\\$&")}/`;
+	const ignorePath = join(repoRoot, ".gitignore");
+	const contents = existsSync(ignorePath)
+		? readFileSync(ignorePath, "utf8")
+		: "";
+	if (contents.split(/\r?\n/).includes(pattern)) return;
+	const newline = contents.includes("\r\n") ? "\r\n" : "\n";
+	const separator =
+		contents.length > 0 && !contents.endsWith("\n") ? newline : "";
+	writeFileSync(
+		ignorePath,
+		`${contents}${separator}${pattern}${newline}`,
+		"utf8",
+	);
+};

package/src/cli.ts

@@ -21,6 +21,7 @@ import { runSandboxDelete } from "./actions/sandbox/deleteSandbox";
 import { runSandboxList } from "./actions/sandbox/listSandboxes";
 import { runSandboxUse } from "./actions/sandbox/useSandbox";
 import { withSandboxScopeHint } from "./actions/sandbox/withSandboxScopeHint";
+import { ignoreBundledSkills } from "./actions/skills/ignoreBundledSkills";
 import {
 	installSkills,
 	linkSkills,
@@ -431,6 +432,8 @@ Linking a keyless org to an account:
 			async (options: { dir?: string; link?: boolean }, command: Command) => {
 				const dir = skillsDirOf({ command, dir: options.dir });
 				installSkills({ dir, write: (text) => process.stdout.write(text) });
+				if (options.dir === undefined)
+					ignoreBundledSkills(projectOf({ command }));
 				if (options.link === true)
 					await linkSkills({
 						dir,
@@ -449,6 +452,8 @@ Linking a keyless org to an account:
 		.action((options: { dir?: string }, command: Command) => {
 			const dir = skillsDirOf({ command, dir: options.dir });
 			updateSkills({ dir, write: (text) => process.stdout.write(text) });
+			if (options.dir === undefined)
+				ignoreBundledSkills(projectOf({ command }));
 		});
 
 	program

package/src/generated/emit.ts

@@ -5,6 +5,7 @@ import type { CollectionSpec, SingletonSpec } from "./emitRuntime";
 
 export const COLLECTIONS: Readonly<Record<string, CollectionSpec>> = {
 	features: {
+		wireKey: "features",
 		builder: "feature",
 		idField: "featureId",
 		responseIdField: "id",
@@ -80,11 +81,13 @@ export const COLLECTIONS: Readonly<Record<string, CollectionSpec>> = {
 			"providerMarkups.*.markup",
 			"type",
 		],
+		mappings: { properties: { processors: { mapping: true } } },
 		defaults: {},
 		pull: true,
 		deprecated: [],
 	},
 	plans: {
+		wireKey: "plans",
 		builder: "plan",
 		idField: "planId",
 		responseIdField: "id",
@@ -865,6 +868,43 @@ export const COLLECTIONS: Readonly<Record<string, CollectionSpec>> = {
 			"variants.versionSlug",
 			"versionSlug",
 		],
+		mappings: {
+			properties: {
+				processors: { mapping: true },
+				price: { properties: { processors: { mapping: true } } },
+				items: {
+					items: {
+						properties: {
+							price: { properties: { processors: { mapping: true } } },
+						},
+					},
+					identity: {
+						responseField: "mappingIdentity",
+						components: [
+							{ paths: ["featureId"], default: "" },
+							{ paths: ["price.billingMethod"], default: "" },
+							{ paths: ["price.interval", "reset.interval"], default: "" },
+							{
+								paths: ["price.intervalCount", "reset.intervalCount"],
+								default: "",
+								defaultWhen: { component: 2, value: 1 },
+							},
+						],
+					},
+				},
+				variants: {
+					items: {
+						properties: {
+							processors: { mapping: true, sourcePath: ["plan", "processors"] },
+						},
+					},
+					identity: {
+						responseField: "mappingIdentity",
+						components: [{ paths: ["variantPlanId"], default: "" }],
+					},
+				},
+			},
+		},
 		defaults: {
 			addOn: false,
 			autoEnable: false,
@@ -961,6 +1001,7 @@ export const COLLECTIONS: Readonly<Record<string, CollectionSpec>> = {
 		],
 	},
 	rewards: {
+		wireKey: "rewards",
 		builder: "reward",
 		idField: "id",
 		responseIdField: "id",
@@ -1103,6 +1144,7 @@ export const COLLECTIONS: Readonly<Record<string, CollectionSpec>> = {
 		],
 	},
 	referralPrograms: {
+		wireKey: "referral_programs",
 		builder: "referralProgram",
 		idField: "id",
 		responseIdField: "id",

package/src/generated/emitRuntime.ts

@@ -1,13 +1,11 @@
 // Copied by @autumn/atmn-generator from packages/atmn-generator/src/emit/runtime/emitFixture.ts.
 // Do not edit — change that file and run `bun generate` instead.
 
-/**
- * Copied verbatim into the CLI by the generator, so this file imports nothing:
- * a pulled server row becomes fixture source here, in the exact shape the
- * surgery module splices into the user's config.
- */
+import type { MappingProjection } from "./mappingAssignments";
 
 export type CollectionSpec = {
+	readonly wireKey?: string;
+	readonly mappings?: MappingProjection;
 	readonly builder: string;
 	readonly idField: string;
 	readonly responseIdField: string;

package/src/generated/mappingAssignments.ts

@@ -0,0 +1,204 @@
+// Copied by @autumn/atmn-generator from packages/atmn-generator/src/emit/runtime/mappingAssignments.ts.
+// Do not edit — change that file and run `bun generate` instead.
+
+export type MappingIdentity = {
+	readonly responseField: string;
+	readonly components: readonly {
+		readonly paths: readonly string[];
+		readonly default: string | number;
+		readonly defaultWhen?: {
+			readonly component: number;
+			readonly value: string | number;
+		};
+	}[];
+};
+
+export type MappingProjection = {
+	readonly mapping?: boolean;
+	readonly sourcePath?: readonly string[];
+	readonly properties?: Readonly<Record<string, MappingProjection>>;
+	readonly items?: MappingProjection;
+	readonly identity?: MappingIdentity;
+};
+
+export type MappingAssignment = {
+	path: (string | number)[];
+	text: string | null;
+};
+
+const isRecord = (value: unknown): value is Record<string, unknown> =>
+	typeof value === "object" && value !== null && !Array.isArray(value);
+
+const valueAt = ({
+	value,
+	path,
+}: {
+	value: unknown;
+	path: readonly string[];
+}): unknown => {
+	for (const key of path) {
+		if (typeof value === "symbol") return value;
+		value = isRecord(value) ? value[key] : undefined;
+	}
+	return value;
+};
+
+export const mappingIdentityOf = ({
+	value,
+	identity,
+}: {
+	value: unknown;
+	identity: MappingIdentity;
+}): string | undefined => {
+	const values: (string | number)[] = [];
+	for (const component of identity.components) {
+		let selected: unknown;
+		for (const path of component.paths) {
+			selected = valueAt({ value, path: path.split(".") });
+			if (selected !== undefined && selected !== null) break;
+		}
+		if (selected === undefined || selected === null) {
+			selected =
+				component.defaultWhen && values[component.defaultWhen.component]
+					? component.defaultWhen.value
+					: component.default;
+		}
+		if (typeof selected !== "string" && typeof selected !== "number")
+			return undefined;
+		values.push(selected);
+	}
+	return JSON.stringify(values);
+};
+
+const hasMappings = ({
+	node,
+	value,
+	local = false,
+}: {
+	node: MappingProjection;
+	value: unknown;
+	local?: boolean;
+}): boolean => {
+	if (value === undefined || value === null) return false;
+	if (node.mapping) return true;
+	const items = node.items;
+	if (items)
+		return (
+			Array.isArray(value) &&
+			value.some((entry) => hasMappings({ node: items, value: entry, local }))
+		);
+	return Object.entries(node.properties ?? {}).some(([key, child]) =>
+		hasMappings({
+			node: child,
+			value: valueAt({
+				value,
+				path: local ? [key] : (child.sourcePath ?? [key]),
+			}),
+			local,
+		}),
+	);
+};
+
+export const mappingAssignments = ({
+	projection,
+	local,
+	remote,
+}: {
+	projection: MappingProjection;
+	local: unknown;
+	remote: unknown;
+}): { assignments: MappingAssignment[]; errors: string[] } => {
+	const assignments: MappingAssignment[] = [];
+	const errors: string[] = [];
+	const visit = ({
+		node,
+		localValue,
+		remoteValue,
+		path,
+	}: {
+		node: MappingProjection;
+		localValue: unknown;
+		remoteValue: unknown;
+		path: (string | number)[];
+	}): void => {
+		if (node.mapping) {
+			if (remoteValue === undefined || remoteValue === null) {
+				if (localValue !== undefined) assignments.push({ path, text: null });
+				return;
+			}
+			assignments.push({ path, text: JSON.stringify(remoteValue) });
+			return;
+		}
+		if (
+			!hasMappings({ node, value: remoteValue }) &&
+			!hasMappings({ node, value: localValue, local: true })
+		)
+			return;
+		if (remoteValue === undefined || remoteValue === null) return;
+		if (typeof localValue === "symbol") {
+			errors.push(`${path.join(".")}: cannot address a computed value`);
+			return;
+		}
+		if (localValue === undefined || localValue === null) {
+			errors.push(
+				`${path.join(".")}: mapping container is not stated in the fixture`,
+			);
+			return;
+		}
+		if (node.items) {
+			if (
+				!Array.isArray(localValue) ||
+				!Array.isArray(remoteValue) ||
+				!node.identity
+			) {
+				errors.push(`${path.join(".")}: array identity is unavailable`);
+				return;
+			}
+			const identity = node.identity;
+			const localKeys = localValue.map((value) =>
+				mappingIdentityOf({ value, identity }),
+			);
+			const remoteKeys = remoteValue.map((value) =>
+				valueAt({ value, path: identity.responseField.split(".") }),
+			);
+			for (const [index, value] of localValue.entries()) {
+				const key = localKeys[index];
+				const matches = remoteKeys.flatMap((candidate, position) =>
+					candidate === key ? [position] : [],
+				);
+				const match = matches[0];
+				if (
+					key === undefined ||
+					match === undefined ||
+					localKeys.filter((candidate) => candidate === key).length !== 1 ||
+					matches.length !== 1
+				) {
+					errors.push(
+						`${[...path, index].join(".")}: no unique server identity match`,
+					);
+					continue;
+				}
+				visit({
+					node: node.items,
+					localValue: value,
+					remoteValue: remoteValue[match],
+					path: [...path, index],
+				});
+			}
+			return;
+		}
+		for (const [key, child] of Object.entries(node.properties ?? {})) {
+			visit({
+				node: child,
+				localValue: valueAt({ value: localValue, path: [key] }),
+				remoteValue: valueAt({
+					value: remoteValue,
+					path: child.sourcePath ?? [key],
+				}),
+				path: [...path, key],
+			});
+		}
+	};
+	visit({ node: projection, localValue: local, remoteValue: remote, path: [] });
+	return { assignments, errors };
+};