@contember/bindx 0.1.0

package/dist/store/snapshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshots.d.ts","sourceRoot":"","sources":["../../src/store/snapshots.ts"],"names":[],"mappings":"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"}

package/dist/undo/UndoManager.d.ts

@@ -0,0 +1,120 @@
+import type { ActionMiddleware } from '../core/ActionDispatcher.js';
+import type { SnapshotStore } from '../store/SnapshotStore.js';
+import type { UndoManagerConfig, UndoState } from './types.js';
+type Subscriber = () => void;
+/**
+ * UndoManager provides undo/redo functionality for the Bindx store.
+ *
+ * Features:
+ * - Automatic debounced grouping of rapid changes
+ * - Manual grouping via beginGroup/endGroup
+ * - Configurable history size
+ * - Block/unblock during persist operations
+ * - React integration via subscribe/getState
+ */
+export declare class UndoManager {
+    private readonly store;
+    private undoStack;
+    private redoStack;
+    private pendingEntry;
+    private debounceTimer;
+    private isBlocked;
+    private manualGroupId;
+    private manualGroupLabel;
+    private subscribers;
+    private cachedState;
+    private readonly maxHistorySize;
+    private readonly debounceMs;
+    constructor(store: SnapshotStore, config?: UndoManagerConfig);
+    /**
+     * Creates middleware for ActionDispatcher.
+     * Must be added to dispatcher to enable undo tracking.
+     */
+    createMiddleware(): ActionMiddleware;
+    /**
+     * Handles an action, capturing state for undo if trackable.
+     */
+    private handleAction;
+    /**
+     * Handles action in manual group mode.
+     */
+    private handleManualGroupAction;
+    /**
+     * Handles action in debounced auto-group mode.
+     */
+    private handleDebouncedAction;
+    /**
+     * Gets keys that are in source but not in target.
+     */
+    private getNewKeys;
+    /**
+     * Checks if keys object is empty.
+     */
+    private isEmptyKeys;
+    /**
+     * Merges additional snapshot into target.
+     */
+    private mergeSnapshots;
+    /**
+     * Starts the debounce timer.
+     */
+    private startDebounceTimer;
+    /**
+     * Resets the debounce timer.
+     */
+    private resetDebounceTimer;
+    /**
+     * Flushes pending entry to undo stack.
+     */
+    private flushPendingEntry;
+    /**
+     * Trims history to max size.
+     */
+    private trimHistory;
+    /**
+     * Starts a manual group. All actions until endGroup are grouped as one undo entry.
+     * Returns group ID that must be passed to endGroup.
+     */
+    beginGroup(label?: string): string;
+    /**
+     * Ends a manual group and pushes to undo stack.
+     */
+    endGroup(groupId: string): void;
+    /**
+     * Undoes the last entry.
+     */
+    undo(): void;
+    /**
+     * Redoes the last undone entry.
+     */
+    redo(): void;
+    /**
+     * Blocks undo/redo operations.
+     * Use during persist to prevent inconsistent state.
+     */
+    block(): void;
+    /**
+     * Unblocks undo/redo operations.
+     */
+    unblock(): void;
+    /**
+     * Clears all undo/redo history.
+     */
+    clear(): void;
+    /**
+     * Subscribes to state changes.
+     * Returns unsubscribe function.
+     */
+    subscribe(callback: Subscriber): () => void;
+    /**
+     * Gets current state for React integration.
+     * Returns a cached object to satisfy useSyncExternalStore's referential equality requirement.
+     */
+    getState(): UndoState;
+    /**
+     * Notifies all subscribers of state change.
+     */
+    private notifySubscribers;
+}
+export {};
+//# sourceMappingURL=UndoManager.d.ts.map

package/dist/undo/UndoManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UndoManager.d.ts","sourceRoot":"","sources":["../../src/undo/UndoManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AASnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,KAAK,EAIX,iBAAiB,EACjB,SAAS,EACT,MAAM,YAAY,CAAA;AAEnB,KAAK,UAAU,GAAG,MAAM,IAAI,CAAA;AAS5B;;;;;;;;;GASG;AACH,qBAAa,WAAW;IAetB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAdvB,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,aAAa,CAA6C;IAClE,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,WAAW,CAAyB;IAE5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;gBAGjB,KAAK,EAAE,aAAa,EACrC,MAAM,GAAE,iBAAsB;IAM/B;;;OAGG;IACH,gBAAgB,IAAI,gBAAgB;IAQpC;;OAEG;IACH,OAAO,CAAC,YAAY;IAuBpB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAsB/B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAqC7B;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,cAAc;IAuBtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAqBzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAMnB;;;OAGG;IACH,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM;IAUlC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAW/B;;OAEG;IACH,IAAI,IAAI,IAAI;IA4BZ;;OAEG;IACH,IAAI,IAAI,IAAI;IAyBZ;;;OAGG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,OAAO,IAAI,IAAI;IAKf;;OAEG;IACH,KAAK,IAAI,IAAI;IAab;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,IAAI;IAO3C;;;OAGG;IACH,QAAQ,IAAI,SAAS;IAarB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAMzB"}

package/dist/undo/index.d.ts

@@ -0,0 +1,3 @@
+export { UndoManager } from './UndoManager.js';
+export type { PartialStoreSnapshot, PendingUndoEntry, UndoEntry, UndoManagerConfig, UndoState, StoreAffectedKeys, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/undo/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/undo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,YAAY,EACX,oBAAoB,EACpB,gBAAgB,EAChB,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,iBAAiB,GACjB,MAAM,YAAY,CAAA"}

package/dist/undo/types.d.ts

@@ -0,0 +1,74 @@
+import type { StoreAffectedKeys } from '../core/actionClassification.js';
+import type { EntitySnapshot } from '../store/snapshots.js';
+import type { StoredRelationState, StoredHasManyState, EntityMeta } from '../store/SnapshotStore.js';
+/**
+ * Partial snapshot of store state.
+ * Contains only the data affected by an action or group of actions.
+ */
+export interface PartialStoreSnapshot {
+    /** Entity snapshots (frozen, immutable) */
+    entitySnapshots: Map<string, EntitySnapshot>;
+    /** Has-one relation states */
+    relationStates: Map<string, StoredRelationState>;
+    /** Has-many list states */
+    hasManyStates: Map<string, StoredHasManyState>;
+    /** Entity metadata (existsOnServer, deletion flags) */
+    entityMetas: Map<string, EntityMeta>;
+}
+/**
+ * A single undo/redo entry.
+ * Contains the snapshot of state BEFORE the action(s) were applied.
+ */
+export interface UndoEntry {
+    /** Unique identifier for this entry */
+    id: string;
+    /** Optional human-readable label */
+    label?: string;
+    /** Snapshot of state BEFORE the action(s) */
+    beforeSnapshot: PartialStoreSnapshot;
+    /** Keys that were affected (for redo snapshot capture) */
+    affectedKeys: StoreAffectedKeys;
+    /** When this entry was created */
+    timestamp: number;
+}
+/**
+ * Pending entry during debounce window.
+ * Accumulates affected keys while waiting for debounce to complete.
+ */
+export interface PendingUndoEntry {
+    /** Snapshot captured before the first action in the group */
+    beforeSnapshot: PartialStoreSnapshot;
+    /** Accumulated affected keys */
+    affectedKeys: StoreAffectedKeys;
+    /** When the first action occurred */
+    timestamp: number;
+    /** Optional label for manual grouping */
+    label?: string;
+}
+/**
+ * Configuration options for UndoManager.
+ */
+export interface UndoManagerConfig {
+    /** Maximum number of undo entries to keep (default: 100) */
+    maxHistorySize?: number;
+    /** Debounce time in milliseconds for auto-grouping (default: 300) */
+    debounceMs?: number;
+}
+/**
+ * Current state of the undo manager.
+ * Used for React integration via useSyncExternalStore.
+ */
+export interface UndoState {
+    /** Whether undo is available */
+    canUndo: boolean;
+    /** Whether redo is available */
+    canRedo: boolean;
+    /** Whether undo/redo is currently blocked (e.g., during persist) */
+    isBlocked: boolean;
+    /** Number of entries in undo stack */
+    undoCount: number;
+    /** Number of entries in redo stack */
+    redoCount: number;
+}
+export type { StoreAffectedKeys } from '../core/actionClassification.js';
+//# sourceMappingURL=types.d.ts.map

package/dist/undo/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/undo/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,KAAK,EACX,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,EACV,MAAM,2BAA2B,CAAA;AAElC;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACpC,2CAA2C;IAC3C,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IAC5C,8BAA8B;IAC9B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;IAChD,2BAA2B;IAC3B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;IAC9C,uDAAuD;IACvD,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACzB,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAA;IACV,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6CAA6C;IAC7C,cAAc,EAAE,oBAAoB,CAAA;IACpC,0DAA0D;IAC1D,YAAY,EAAE,iBAAiB,CAAA;IAC/B,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAA;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAChC,6DAA6D;IAC7D,cAAc,EAAE,oBAAoB,CAAA;IACpC,gCAAgC;IAChC,YAAY,EAAE,iBAAiB,CAAA;IAC/B,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAA;IACjB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACzB,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,oEAAoE;IACpE,SAAS,EAAE,OAAO,CAAA;IAClB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAA;IACjB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAA;CACjB;AAGD,YAAY,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA"}

package/dist/utils/aliasGenerator.d.ts

@@ -0,0 +1,25 @@
+import type { HasManyParams } from '../selection/SelectionScope.js';
+/**
+ * Generates an alias for a has-many relation based on field name and parameters.
+ *
+ * If no parameters are provided or all are undefined, returns the fieldName as-is.
+ * Otherwise, generates a deterministic alias by hashing the parameters.
+ *
+ * @param fieldName - The original field name
+ * @param params - Optional has-many parameters (filter, orderBy, limit, offset)
+ * @returns The alias to use for this has-many relation
+ *
+ * @example
+ * ```ts
+ * // No params - returns fieldName
+ * generateHasManyAlias('tags') // => 'tags'
+ *
+ * // With filter - generates unique alias
+ * generateHasManyAlias('tags', { filter: { active: true } }) // => 'tags_a7x9k2'
+ *
+ * // Different params - different aliases
+ * generateHasManyAlias('tags', { filter: { active: false } }) // => 'tags_b3m1p8'
+ * ```
+ */
+export declare function generateHasManyAlias(fieldName: string, params?: HasManyParams): string;
+//# sourceMappingURL=aliasGenerator.d.ts.map

package/dist/utils/aliasGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aliasGenerator.d.ts","sourceRoot":"","sources":["../../src/utils/aliasGenerator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAEnE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM,CA+BtF"}

package/dist/utils/deepEqual.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Deep equality check for values.
+ * Handles objects, arrays, and primitives.
+ */
+export declare function deepEqual(a: unknown, b: unknown): boolean;
+//# sourceMappingURL=deepEqual.d.ts.map

package/dist/utils/deepEqual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepEqual.d.ts","sourceRoot":"","sources":["../../src/utils/deepEqual.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CA4BzD"}

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+export { deepEqual } from './deepEqual.js';
+export { generateHasManyAlias } from './aliasGenerator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA"}

package/package.json

@@ -0,0 +1,29 @@
+{
+	"name": "@contember/bindx",
+	"version": "0.1.0",
+	"description": "Type-safe data binding framework (core)",
+	"type": "module",
+	"main": "./src/index.ts",
+	"exports": {
+		".": "./src/index.ts"
+	},
+	"scripts": {
+		"build": "tsc --build",
+		"typecheck": "tsc --build"
+	},
+	"files": [
+		"dist",
+		"src"
+	],
+	"license": "MIT",
+	"dependencies": {
+		"@contember/client-content": "^2.1.0-alpha.30",
+		"@contember/graphql-builder": "^2.1.0-alpha.30",
+		"@contember/graphql-client": "^2.1.0-alpha.30"
+	},
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/contember/bindx.git",
+		"directory": "packages/bindx"
+	}
+}

package/src/adapter/ContemberAdapter.ts

@@ -0,0 +1,239 @@
+import { GraphQlClient } from '@contember/graphql-client'
+import {
+	ContentClient,
+	ContentQueryBuilder,
+	ContentEntitySelection,
+	SchemaNames,
+	ContentQuery,
+	type EntitySelectionManyArgs,
+	type EntitySelectionOneArgs,
+	type EntitySelectionColumnArgs,
+	type ContentClientInput,
+} from '@contember/client-content'
+import { type Input } from '@contember/schema'
+import type { QuerySpec, QueryFieldSpec } from '../selection/buildQuery.js'
+import type { BackendAdapter, Query, QueryResult, QueryOptions, GetQuery, ListQuery, PersistResult, CreateResult, DeleteResult } from './types.js'
+import type { ContemberMutationResult } from '../errors/pathMapper.js'
+
+/**
+ * Options for ContemberAdapter
+ */
+export interface ContemberAdapterOptions {
+	/** GraphQL client instance */
+	client: GraphQlClient
+	/** Contember schema names for query building */
+	schema: SchemaNames
+}
+
+/**
+ * Backend adapter for Contember Content API.
+ * Uses @contember/client-content for type-safe GraphQL operations.
+ */
+export class ContemberAdapter implements BackendAdapter {
+
+	constructor(
+		private readonly contentClient: ContentClient,
+		private readonly queryBuilder: ContentQueryBuilder,
+	) {
+	}
+
+	async query(queries: readonly Query[], options?: QueryOptions): Promise<QueryResult[]> {
+		if (queries.length === 0) return []
+
+		// Build ContentQuery for each query
+		const contentQueries: Record<string, ContentQuery<unknown>> = {}
+
+		for (let i = 0; i < queries.length; i++) {
+			const q = queries[i]!
+			const key = `q${i}`
+
+			if (q.type === 'get') {
+				contentQueries[key] = this.buildGetQuery(q)
+			} else {
+				contentQueries[key] = this.buildListQuery(q)
+			}
+		}
+
+		// Execute all queries in single request
+		const results = await this.contentClient.query(contentQueries, {
+			signal: options?.signal,
+		})
+
+		// Map results back to QueryResult array
+		// Content client transforms already unwrap paginateRelation → flat arrays
+		return queries.map((q, i) => {
+			const key = `q${i}`
+			const data = (results as Record<string, unknown>)[key]
+
+			if (q.type === 'get') {
+				return { type: 'get' as const, data: data as Record<string, unknown> | null }
+			} else {
+				return { type: 'list' as const, data: (data ?? []) as readonly Record<string, unknown>[] }
+			}
+		})
+	}
+
+	private buildGetQuery(query: GetQuery): ContentQuery<unknown> {
+		const selection = this.buildEntitySelection(query.spec)
+		return this.queryBuilder.get(query.entityType, { by: query.by }, selection)
+	}
+
+	private buildListQuery(query: ListQuery): ContentQuery<unknown> {
+		const selection = this.buildEntitySelection(query.spec)
+		const args: ContentClientInput.AnyListQueryInput = {
+			filter: query.filter as Input.OptionalWhere | undefined,
+			orderBy: query.orderBy as ContentClientInput.AnyOrderBy | undefined,
+			limit: query.limit,
+			offset: query.offset,
+		}
+		return this.queryBuilder.list(query.entityType, args, selection)
+	}
+
+	async persist(
+		entityType: string,
+		id: string,
+		changes: Record<string, unknown>,
+	): Promise<PersistResult> {
+		const mutation = this.queryBuilder.update(entityType, {
+			by: { id },
+			data: changes as Input.UpdateDataInput,
+		})
+
+		const result = await this.contentClient.mutate(mutation)
+
+		if (!result.ok) {
+			return {
+				ok: false,
+				errorMessage: result.errorMessage ?? `Failed to update ${entityType}:${id}`,
+				mutationResult: this.toMutationResult(result),
+			}
+		}
+
+		return { ok: true }
+	}
+
+	async create(
+		entityType: string,
+		data: Record<string, unknown>,
+	): Promise<CreateResult> {
+		// Build selection to return created entity
+		const selection = (s: ContentEntitySelection) => s.$('id')
+
+		const mutation = this.queryBuilder.create(entityType, { data: data as Input.CreateDataInput }, selection)
+		const result = await this.contentClient.mutate(mutation)
+
+		if (!result.ok) {
+			return {
+				ok: false,
+				errorMessage: result.errorMessage ?? `Failed to create ${entityType}`,
+				mutationResult: this.toMutationResult(result),
+			}
+		}
+
+		return {
+			ok: true,
+			data: result.node as Record<string, unknown>,
+		}
+	}
+
+	async delete(entityType: string, id: string): Promise<DeleteResult> {
+		const mutation = this.queryBuilder.delete(entityType, { by: { id } })
+		const result = await this.contentClient.mutate(mutation)
+
+		if (!result.ok) {
+			return {
+				ok: false,
+				errorMessage: result.errorMessage ?? `Failed to delete ${entityType}:${id}`,
+				mutationResult: this.toMutationResult(result),
+			}
+		}
+
+		return { ok: true }
+	}
+
+	/**
+	 * Converts Contember mutation result to our ContemberMutationResult type.
+	 */
+	private toMutationResult(result: {
+		ok: boolean
+		errorMessage: string | null
+		errors: Array<{ paths: Array<Array<{ field: string } | { index: number; alias: string | null }>>; message: string; type: string }>
+		validation: { valid: boolean; errors: Array<{ path: Array<{ field: string } | { index: number; alias: string | null }>; message: { text: string } }> }
+	}): ContemberMutationResult {
+		return {
+			ok: result.ok,
+			errorMessage: result.errorMessage,
+			errors: result.errors.map(e => ({
+				paths: e.paths,
+				message: e.message,
+				type: e.type,
+			})),
+			validation: {
+				valid: result.validation.valid,
+				errors: result.validation.errors.map(e => ({
+					path: e.path,
+					message: { text: e.message.text },
+				})),
+			},
+		}
+	}
+
+	/**
+	 * Builds ContentEntitySelection from QuerySpec
+	 */
+	private buildEntitySelection(
+		query: QuerySpec,
+	): (selection: ContentEntitySelection) => ContentEntitySelection {
+		return (selection: ContentEntitySelection) => {
+			return this.applyFieldsToSelection(selection, query.fields)
+		}
+	}
+
+	/**
+	 * Recursively applies QueryFieldSpec[] to ContentEntitySelection
+	 */
+	private applyFieldsToSelection(
+		selection: ContentEntitySelection,
+		fields: QueryFieldSpec[],
+	): ContentEntitySelection {
+		let result = selection
+
+		for (const field of fields) {
+			const fieldName = field.sourcePath[0]
+			if (!fieldName) continue
+
+			if (field.nested) {
+				// Relation field (has-one or has-many)
+				const nestedCallback = (s: ContentEntitySelection) =>
+					this.applyFieldsToSelection(s, field.nested!.fields)
+
+				if (field.isArray) {
+					// has-many relation — always uses paginateRelation
+					const manyArgs: EntitySelectionManyArgs = {
+						...(field.name !== fieldName ? { as: field.name } : undefined),
+						...(field.filter !== undefined ? { filter: field.filter as Input.OptionalWhere } : undefined),
+						...(field.orderBy !== undefined ? { orderBy: field.orderBy as ContentClientInput.AnyOrderBy } : undefined),
+						...(field.limit !== undefined ? { limit: field.limit } : undefined),
+						...(field.offset !== undefined ? { offset: field.offset } : undefined),
+						...(field.totalCount ? { totalCount: true } : undefined),
+					}
+
+					result = result.$(fieldName, manyArgs, nestedCallback)
+				} else {
+					// has-one relation
+					const oneArgs: EntitySelectionOneArgs = {
+						...(field.name !== fieldName ? { as: field.name } : undefined),
+					}
+					result = result.$(fieldName, oneArgs, nestedCallback)
+				}
+			} else {
+				// Scalar field
+				const columnArgs: EntitySelectionColumnArgs | undefined =
+					field.name !== fieldName ? { as: field.name } : undefined
+				result = result.$(fieldName, columnArgs)
+			}
+		}
+
+		return result
+	}
+}