@contember/bindx 0.1.0

package/dist/adapter/ContemberAdapter.d.ts

@@ -0,0 +1,40 @@
+import { GraphQlClient } from '@contember/graphql-client';
+import { ContentClient, ContentQueryBuilder, SchemaNames } from '@contember/client-content';
+import type { BackendAdapter, Query, QueryResult, QueryOptions, PersistResult, CreateResult, DeleteResult } from './types.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 declare class ContemberAdapter implements BackendAdapter {
+    private readonly contentClient;
+    private readonly queryBuilder;
+    constructor(contentClient: ContentClient, queryBuilder: ContentQueryBuilder);
+    query(queries: readonly Query[], options?: QueryOptions): Promise<QueryResult[]>;
+    private buildGetQuery;
+    private buildListQuery;
+    persist(entityType: string, id: string, changes: Record<string, unknown>): Promise<PersistResult>;
+    create(entityType: string, data: Record<string, unknown>): Promise<CreateResult>;
+    delete(entityType: string, id: string): Promise<DeleteResult>;
+    /**
+     * Converts Contember mutation result to our ContemberMutationResult type.
+     */
+    private toMutationResult;
+    /**
+     * Builds ContentEntitySelection from QuerySpec
+     */
+    private buildEntitySelection;
+    /**
+     * Recursively applies QueryFieldSpec[] to ContentEntitySelection
+     */
+    private applyFieldsToSelection;
+}
+//# sourceMappingURL=ContemberAdapter.d.ts.map

package/dist/adapter/ContemberAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContemberAdapter.d.ts","sourceRoot":"","sources":["../../src/adapter/ContemberAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EACN,aAAa,EACb,mBAAmB,EAEnB,WAAW,EAMX,MAAM,2BAA2B,CAAA;AAGlC,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAuB,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAGlJ;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC,8BAA8B;IAC9B,MAAM,EAAE,aAAa,CAAA;IACrB,gDAAgD;IAChD,MAAM,EAAE,WAAW,CAAA;CACnB;AAED;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,cAAc;IAGrD,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBADZ,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,mBAAmB;IAI7C,KAAK,CAAC,OAAO,EAAE,SAAS,KAAK,EAAE,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAoCtF,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,cAAc;IAWhB,OAAO,CACZ,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,aAAa,CAAC;IAmBnB,MAAM,CACX,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,OAAO,CAAC,YAAY,CAAC;IAqBlB,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAenE;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAwBxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;OAEG;IACH,OAAO,CAAC,sBAAsB;CA4C9B"}

package/dist/adapter/MockAdapter.d.ts

@@ -0,0 +1,81 @@
+import type { BackendAdapter, Query, QueryResult, QueryOptions, PersistResult, CreateResult, DeleteResult } from './types.js';
+/**
+ * In-memory data store structure
+ */
+export type MockDataStore = {
+    [entityType: string]: {
+        [id: string]: Record<string, unknown>;
+    };
+};
+/**
+ * Options for MockAdapter
+ */
+export interface MockAdapterOptions {
+    /** Simulated network delay in milliseconds (default: 100) */
+    delay?: number;
+    /** Whether to log operations to console (default: false) */
+    debug?: boolean;
+}
+/**
+ * Mock backend adapter for testing and development.
+ * Stores data in memory and simulates async operations.
+ */
+export declare class MockAdapter implements BackendAdapter {
+    private store;
+    private readonly delay;
+    private readonly debug;
+    private readonly queryEngine;
+    constructor(store: MockDataStore, options?: MockAdapterOptions);
+    /**
+     * Simulates network delay with abort support
+     */
+    private simulateDelay;
+    /**
+     * Logs operations if debug is enabled
+     */
+    private log;
+    query(queries: readonly Query[], options?: QueryOptions): Promise<QueryResult[]>;
+    private executeGet;
+    private executeList;
+    persist(entityType: string, id: string, changes: Record<string, unknown>): Promise<PersistResult>;
+    /**
+     * Applies changes to an entity, handling Contember-style relation operations.
+     * Supports:
+     * - Scalar fields: direct assignment
+     * - HasOne: { connect: { id } }, { disconnect: true }, { delete: true }, { create: {...} }, { update: {...} }
+     * - HasMany: [{ connect: { id } }, { disconnect: { id } }, { delete: { id } }, { create: {...} }, { update: { by: { id }, data: {...} } }]
+     */
+    private applyChanges;
+    /**
+     * Applies hasMany relation operations.
+     */
+    private applyHasManyOperations;
+    /**
+     * Resolves a related entity by ID from any entity store.
+     * Returns a copy of the entity data or { id } if not found.
+     */
+    private resolveRelatedEntity;
+    /**
+     * Creates a related entity with a generated ID.
+     */
+    private createRelatedEntity;
+    /**
+     * Deletes a related entity from any entity store.
+     */
+    private deleteRelatedEntity;
+    create(entityType: string, data: Record<string, unknown>): Promise<CreateResult>;
+    delete(entityType: string, id: string): Promise<DeleteResult>;
+    /**
+     * Generates a simple unique ID
+     */
+    private generateId;
+    /**
+     * Gets the current store state (for testing/debugging)
+     */
+    getStore(): MockDataStore;
+    /**
+     * Resets the store to initial state
+     */
+    resetStore(newStore: MockDataStore): void;
+}
+//# sourceMappingURL=MockAdapter.d.ts.map

package/dist/adapter/MockAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockAdapter.d.ts","sourceRoot":"","sources":["../../src/adapter/MockAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAuB,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAGlJ;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC3B,CAAC,UAAU,EAAE,MAAM,GAAG;QACrB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACrC,CAAA;CACD,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4DAA4D;IAC5D,KAAK,CAAC,EAAE,OAAO,CAAA;CACf;AAED;;;GAGG;AACH,qBAAa,WAAY,YAAW,cAAc;IAMhD,OAAO,CAAC,KAAK;IALd,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiB;gBAGpC,KAAK,EAAE,aAAa,EAC5B,OAAO,GAAE,kBAAuB;IAOjC;;OAEG;YACW,aAAa;IA0B3B;;OAEG;IACH,OAAO,CAAC,GAAG;IAML,KAAK,CAAC,OAAO,EAAE,SAAS,KAAK,EAAE,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAatF,OAAO,CAAC,UAAU;IAiClB,OAAO,CAAC,WAAW;IA2Bb,OAAO,CACZ,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,aAAa,CAAC;IA2BzB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAuDpB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA0D9B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAK3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IASrB,MAAM,CACX,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,OAAO,CAAC,YAAY,CAAC;IAmBlB,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAYnE;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,QAAQ,IAAI,aAAa;IAIzB;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;CAGzC"}

package/dist/adapter/MockQueryEngine.d.ts

@@ -0,0 +1,43 @@
+import type { QueryFieldSpec } from '../selection/buildQuery.js';
+/**
+ * MockQueryEngine provides in-memory query operations for MockAdapter.
+ * Extracted for better testability and separation of concerns.
+ *
+ * Supports:
+ * - Filtering with various operators (eq, notEq, in, lt, gt, contains, etc.)
+ * - Ordering with multi-field support and null handling
+ * - Pagination (offset/limit)
+ * - Field projection with nested relation support
+ */
+export declare class MockQueryEngine {
+    /**
+     * Filters entities based on a filter object.
+     */
+    filter(entities: Record<string, unknown>[], filter: Record<string, unknown>): Record<string, unknown>[];
+    /**
+     * Orders entities based on orderBy specifications.
+     */
+    orderBy(entities: Record<string, unknown>[], orderBy: readonly Record<string, unknown>[]): Record<string, unknown>[];
+    /**
+     * Paginates entities using offset and limit.
+     */
+    paginate(entities: Record<string, unknown>[], offset?: number, limit?: number): Record<string, unknown>[];
+    /**
+     * Projects only the requested fields from source data.
+     * Supports nested relations (hasOne and hasMany).
+     */
+    projectFields(source: Record<string, unknown>, fields: QueryFieldSpec[], basePath?: string[]): Record<string, unknown>;
+    /**
+     * Checks if an entity matches a filter.
+     */
+    private matchesFilter;
+    /**
+     * Checks if a value matches a condition object.
+     */
+    private matchesCondition;
+    /**
+     * Gets a nested value from an object using a path.
+     */
+    private getNestedValue;
+}
+//# sourceMappingURL=MockQueryEngine.d.ts.map

package/dist/adapter/MockQueryEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockQueryEngine.d.ts","sourceRoot":"","sources":["../../src/adapter/MockQueryEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAEhE;;;;;;;;;GASG;AACH,qBAAa,eAAe;IAC3B;;OAEG;IACH,MAAM,CACL,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;IAI5B;;OAEG;IACH,OAAO,CACN,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACnC,OAAO,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GACzC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;IA0B5B;;OAEG;IACH,QAAQ,CACP,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACnC,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;IAW5B;;;OAGG;IACH,aAAa,CACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,cAAc,EAAE,EACxB,QAAQ,GAAE,MAAM,EAAO,GACrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAgD1B;;OAEG;IACH,OAAO,CAAC,aAAa;IAqCrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgDxB;;OAEG;IACH,OAAO,CAAC,cAAc;CAYtB"}

package/dist/adapter/index.d.ts

@@ -0,0 +1,5 @@
+export type { BackendAdapter, QueryOptions, Query, GetQuery, ListQuery, QueryResult, GetQueryResult, ListQueryResult, PersistResult, CreateResult, DeleteResult, EntityUniqueWhere, UniqueWhereValue, TransactionMutation, TransactionMutationResult, TransactionResult, } from './types.js';
+export { MockAdapter, type MockDataStore, type MockAdapterOptions } from './MockAdapter.js';
+export { MockQueryEngine } from './MockQueryEngine.js';
+export { ContemberAdapter, type ContemberAdapterOptions } from './ContemberAdapter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapter/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,cAAc,EACd,YAAY,EACZ,KAAK,EACL,QAAQ,EACR,SAAS,EACT,WAAW,EACX,cAAc,EACd,eAAe,EACf,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,yBAAyB,EACzB,iBAAiB,GACjB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC3F,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/adapter/types.d.ts

@@ -0,0 +1,184 @@
+import type { QuerySpec } from '../selection/buildQuery.js';
+import type { EntityWhere, EntityOrderBy } from '../selection/queryTypes.js';
+import type { ContemberMutationResult } from '../errors/pathMapper.js';
+/**
+ * Options for query operations
+ */
+export interface QueryOptions {
+    /**
+     * AbortSignal for cancelling the request
+     */
+    readonly signal?: AbortSignal;
+}
+/**
+ * Recursive value type for unique where fields (string or number identifiers).
+ * Structurally compatible with Input.UniqueWhere from @contember/schema.
+ */
+export type UniqueWhereValue = string | number | {
+    readonly [field: string]: UniqueWhereValue;
+};
+/**
+ * Unique field lookup for single entity queries.
+ * Supports id and any other unique field.
+ */
+export type EntityUniqueWhere = {
+    readonly [field: string]: UniqueWhereValue;
+};
+/**
+ * Query for a single entity by unique field(s)
+ */
+export interface GetQuery {
+    readonly type: 'get';
+    readonly entityType: string;
+    readonly by: EntityUniqueWhere;
+    readonly spec: QuerySpec;
+}
+/**
+ * Query for a list of entities
+ */
+export interface ListQuery<TEntity = unknown> {
+    readonly type: 'list';
+    readonly entityType: string;
+    readonly filter?: EntityWhere<TEntity>;
+    readonly orderBy?: readonly EntityOrderBy<TEntity>[];
+    readonly limit?: number;
+    readonly offset?: number;
+    readonly spec: QuerySpec;
+}
+/**
+ * Union of all query types
+ */
+export type Query<TEntity = unknown> = GetQuery | ListQuery<TEntity>;
+/**
+ * Result for a single get query
+ */
+export interface GetQueryResult {
+    readonly type: 'get';
+    readonly data: Record<string, unknown> | null;
+}
+/**
+ * Result for a list query
+ */
+export interface ListQueryResult {
+    readonly type: 'list';
+    readonly data: readonly Record<string, unknown>[];
+}
+/**
+ * Union of query results
+ */
+export type QueryResult = GetQueryResult | ListQueryResult;
+/**
+ * Result of a persist operation.
+ * Contains detailed error information for error mapping.
+ */
+export interface PersistResult {
+    readonly ok: boolean;
+    readonly errorMessage?: string;
+    /** Detailed mutation result for error mapping (Contember-specific) */
+    readonly mutationResult?: ContemberMutationResult;
+}
+/**
+ * Result of a create operation.
+ * Contains the created entity data or error information.
+ */
+export interface CreateResult {
+    readonly ok: boolean;
+    readonly errorMessage?: string;
+    /** The created entity data (when ok is true) */
+    readonly data?: Record<string, unknown>;
+    /** Detailed mutation result for error mapping (Contember-specific) */
+    readonly mutationResult?: ContemberMutationResult;
+}
+/**
+ * Result of a delete operation.
+ */
+export interface DeleteResult {
+    readonly ok: boolean;
+    readonly errorMessage?: string;
+    /** Detailed mutation result for error mapping (Contember-specific) */
+    readonly mutationResult?: ContemberMutationResult;
+}
+/**
+ * A single mutation in a transaction.
+ */
+export interface TransactionMutation {
+    readonly entityType: string;
+    readonly entityId: string;
+    readonly operation: 'create' | 'update' | 'delete';
+    readonly data?: Record<string, unknown>;
+}
+/**
+ * Result of a single mutation in a transaction.
+ */
+export interface TransactionMutationResult {
+    readonly entityType: string;
+    readonly entityId: string;
+    readonly ok: boolean;
+    /** Server-assigned ID for creates */
+    readonly persistedId?: string;
+    readonly errorMessage?: string;
+    readonly mutationResult?: ContemberMutationResult;
+}
+/**
+ * Result of a transaction persist operation.
+ * All-or-nothing: if any mutation fails, all are rolled back.
+ */
+export interface TransactionResult {
+    /** Whether all mutations succeeded */
+    readonly ok: boolean;
+    /** Results per mutation, in same order as input */
+    readonly results: readonly TransactionMutationResult[];
+}
+/**
+ * Interface for backend adapters.
+ * Implement this to connect bindx to your data source.
+ */
+export interface BackendAdapter {
+    /**
+     * Execute one or more queries in a single request.
+     * When multiple queries are provided, the adapter should batch them
+     * into a single network request where possible.
+     *
+     * @param queries - Array of queries to execute
+     * @param options - Optional query options including AbortSignal
+     * @returns Array of results in the same order as queries
+     */
+    query(queries: readonly Query[], options?: QueryOptions): Promise<QueryResult[]>;
+    /**
+     * Persists changes to an entity.
+     * Returns a result object with success/failure status and error details.
+     *
+     * @param entityType - The type/name of the entity
+     * @param id - The entity's unique identifier
+     * @param changes - The changed fields to persist
+     * @returns Result with ok status and optional error details
+     */
+    persist(entityType: string, id: string, changes: Record<string, unknown>): Promise<PersistResult>;
+    /**
+     * Creates a new entity.
+     * Returns a result object with the created entity or error details.
+     *
+     * @param entityType - The type/name of the entity
+     * @param data - The initial data for the entity
+     * @returns Result with ok status, created entity data, and optional error details
+     */
+    create?(entityType: string, data: Record<string, unknown>): Promise<CreateResult>;
+    /**
+     * Deletes an entity.
+     * Returns a result object with success/failure status.
+     *
+     * @param entityType - The type/name of the entity
+     * @param id - The entity's unique identifier
+     * @returns Result with ok status and optional error details
+     */
+    delete?(entityType: string, id: string): Promise<DeleteResult>;
+    /**
+     * Persists multiple mutations in a single transaction.
+     * All-or-nothing: if any mutation fails, all are rolled back.
+     *
+     * @param mutations - Array of mutations to execute
+     * @returns Result with success status and per-mutation results
+     */
+    persistTransaction?(mutations: readonly TransactionMutation[]): Promise<TransactionResult>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/brand/ComponentBrand.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ComponentBrand provides unique identity for each component created with createComponent.
+ * Each instance has a unique runtime Symbol for brand validation.
+ * The class structure itself provides nominal typing in TypeScript.
+ */
+export declare class ComponentBrand {
+    readonly name: string;
+    /**
+     * Private property to ensure nominal typing.
+     * Each class instance is considered a unique type.
+     */
+    private readonly __nominal;
+    /**
+     * Runtime symbol for brand validation.
+     * Used to check that EntityRef includes required component brands.
+     */
+    readonly brandSymbol: symbol;
+    constructor(name: string);
+}
+/**
+ * Type alias for any ComponentBrand.
+ * Used as default/base type in generic constraints.
+ */
+export type AnyBrand = ComponentBrand;
+//# sourceMappingURL=ComponentBrand.d.ts.map

package/dist/brand/ComponentBrand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentBrand.d.ts","sourceRoot":"","sources":["../../src/brand/ComponentBrand.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,cAAc;aAaE,IAAI,EAAE,MAAM;IAZxC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAO;IAEjC;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;gBAEA,IAAI,EAAE,MAAM;CAGxC;AAED;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,cAAc,CAAA"}

package/dist/contember/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Contember-specific utilities for bindx
+ *
+ * @packageDocumentation
+ */
+export { MutationCollector, type EntityMutationResult } from '../persistence/MutationCollector.js';
+export { ContemberSchemaMutationAdapter } from '../persistence/ContemberSchemaMutationAdapter.js';
+export type { MutationSchemaProvider } from '../persistence/MutationSchemaProvider.js';
+export type { SchemaNames, SchemaEntityNames, ContentClientInput, } from '@contember/client-content';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contember/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,MAAM,qCAAqC,CAAA;AAClG,OAAO,EAAE,8BAA8B,EAAE,MAAM,kDAAkD,CAAA;AACjG,YAAY,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAA;AAGtF,YAAY,EACX,WAAW,EACX,iBAAiB,EACjB,kBAAkB,GAClB,MAAM,2BAA2B,CAAA"}

package/dist/core/ActionDispatcher.d.ts

@@ -0,0 +1,64 @@
+import type { SnapshotStore } from '../store/SnapshotStore.js';
+import type { Action } from './actions.js';
+import { EventEmitter } from '../events/EventEmitter.js';
+/**
+ * ActionDispatcher centralizes all state mutations.
+ * All changes to the store go through this dispatcher.
+ *
+ * Benefits:
+ * - Single point of control for all mutations
+ * - Easy to add logging, debugging, middleware
+ * - Ensures consistent state updates
+ * - Enables action replay/undo if needed
+ * - Event system for subscriptions and interceptors
+ */
+export declare class ActionDispatcher {
+    private readonly store;
+    private readonly middlewares;
+    private readonly eventEmitter;
+    constructor(store: SnapshotStore, eventEmitter?: EventEmitter);
+    /**
+     * Gets the event emitter for external access.
+     */
+    getEventEmitter(): EventEmitter;
+    /**
+     * Dispatches an action to update the store.
+     * Runs synchronous interceptors (before-events) and emits after-events.
+     * Async interceptors are skipped with a warning — use dispatchAsync() for those.
+     */
+    dispatch(action: Action): void;
+    /**
+     * Dispatches an action with full interceptor support.
+     * Returns true if the action was executed, false if it was cancelled by an interceptor.
+     */
+    dispatchAsync(action: Action): Promise<boolean>;
+    /**
+     * Updates an action based on a modified before event.
+     * Used when an interceptor modifies the event.
+     */
+    private updateActionFromEvent;
+    /**
+     * Adds a middleware to the dispatcher.
+     * Middlewares are called in order before action execution.
+     */
+    addMiddleware(middleware: ActionMiddleware): void;
+    /**
+     * Removes a middleware from the dispatcher.
+     */
+    removeMiddleware(middleware: ActionMiddleware): void;
+    /**
+     * Executes an action, updating the store.
+     */
+    private execute;
+}
+/**
+ * Middleware function type.
+ * Can inspect/modify actions before execution.
+ * Return false to cancel the action.
+ */
+export type ActionMiddleware = (action: Action, store: SnapshotStore) => boolean | void;
+/**
+ * Creates a logging middleware for debugging.
+ */
+export declare function createLoggingMiddleware(prefix?: string): ActionMiddleware;
+//# sourceMappingURL=ActionDispatcher.d.ts.map

package/dist/core/ActionDispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionDispatcher.d.ts","sourceRoot":"","sources":["../../src/core/ActionDispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAOxD;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB;IAK3B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;IACrD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;gBAGzB,KAAK,EAAE,aAAa,EACrC,YAAY,CAAC,EAAE,YAAY;IAK5B;;OAEG;IACH,eAAe,IAAI,YAAY;IAI/B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAqC9B;;;OAGG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAsCrD;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IA4B7B;;;OAGG;IACH,aAAa,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI;IAIjD;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI;IAOpD;;OAEG;IACH,OAAO,CAAC,OAAO;CA8Nf;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,KAAK,OAAO,GAAG,IAAI,CAAA;AAEvF;;GAEG;AACH,wBAAgB,uBAAuB,CACtC,MAAM,GAAE,MAAkB,GACxB,gBAAgB,CAIlB"}

package/dist/core/Disposable.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Disposable pattern for cleanup management.
+ * Ensures proper cleanup of subscriptions and resources.
+ */
+/**
+ * Interface for objects that can be disposed.
+ */
+export interface Disposable {
+    dispose(): void;
+}
+/**
+ * A group of disposables that can be disposed together.
+ * Provides safe cleanup even if individual dispose() calls throw.
+ */
+export declare class DisposableGroup implements Disposable {
+    private disposables;
+    private disposed;
+    /**
+     * Adds a disposable to the group.
+     * If the group is already disposed, the disposable is disposed immediately.
+     */
+    add(disposable: Disposable): void;
+    /**
+     * Adds a callback as a disposable.
+     */
+    addCallback(callback: () => void): void;
+    /**
+     * Adds an unsubscribe function as a disposable.
+     */
+    addUnsubscribe(unsubscribe: () => void): void;
+    /**
+     * Disposes all items in the group.
+     * Each item is disposed even if previous ones throw.
+     */
+    dispose(): void;
+    /**
+     * Checks if the group has been disposed.
+     */
+    isDisposed(): boolean;
+    /**
+     * Gets the number of disposables in the group.
+     */
+    get size(): number;
+}
+/**
+ * Creates a disposable from a callback function.
+ */
+export declare function createDisposable(callback: () => void): Disposable;
+/**
+ * Combines multiple disposables into one.
+ */
+export declare function combineDisposables(...disposables: Disposable[]): Disposable;
+/**
+ * Type guard to check if something is disposable.
+ */
+export declare function isDisposable(value: unknown): value is Disposable;
+//# sourceMappingURL=Disposable.d.ts.map

package/dist/core/Disposable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Disposable.d.ts","sourceRoot":"","sources":["../../src/core/Disposable.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,OAAO,IAAI,IAAI,CAAA;CACf;AAED;;;GAGG;AACH,qBAAa,eAAgB,YAAW,UAAU;IACjD,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,QAAQ,CAAQ;IAExB;;;OAGG;IACH,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAajC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAIvC;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,IAAI,GAAG,IAAI;IAI7C;;;OAGG;IACH,OAAO,IAAI,IAAI;IAqBf;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,UAAU,CASjE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,WAAW,EAAE,UAAU,EAAE,GAAG,UAAU,CAM3E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAMhE"}

package/dist/core/EntityLoader.d.ts

@@ -0,0 +1,80 @@
+import type { BackendAdapter } from '../adapter/types.js';
+import type { SnapshotStore } from '../store/SnapshotStore.js';
+import type { QuerySpec } from '../selection/buildQuery.js';
+import type { EntityWhere, EntityOrderBy } from '../selection/queryTypes.js';
+import { type FieldError } from '../errors/types.js';
+/**
+ * Result of entity loading operation
+ */
+export type EntityLoadResult<T> = {
+    status: 'success';
+    data: T;
+} | {
+    status: 'error';
+    error: FieldError;
+} | {
+    status: 'not_found';
+};
+/**
+ * Result of entity list loading operation
+ */
+export type EntityListLoadResult<T> = {
+    status: 'success';
+    data: T[];
+} | {
+    status: 'error';
+    error: FieldError;
+};
+/**
+ * Options for loading a single entity
+ */
+export interface LoadEntityOptions {
+    entityType: string;
+    id: string;
+    query: QuerySpec;
+    useCache?: boolean;
+    signal?: AbortSignal;
+}
+/**
+ * Options for loading entity list
+ */
+export interface LoadEntityListOptions<TEntity = unknown> {
+    entityType: string;
+    query: QuerySpec;
+    filter?: EntityWhere<TEntity>;
+    orderBy?: readonly EntityOrderBy<TEntity>[];
+    limit?: number;
+    offset?: number;
+    signal?: AbortSignal;
+}
+/**
+ * Non-React service for loading entities.
+ * Can be used in any JavaScript environment.
+ */
+export declare class EntityLoader {
+    private readonly adapter;
+    private readonly store;
+    constructor(adapter: BackendAdapter, store: SnapshotStore);
+    /**
+     * Loads a single entity by ID.
+     */
+    loadOne<T>(options: LoadEntityOptions): Promise<EntityLoadResult<T>>;
+    /**
+     * Loads multiple entities matching filter.
+     */
+    loadMany<T, TEntity = unknown>(options: LoadEntityListOptions<TEntity>): Promise<EntityListLoadResult<T>>;
+    /**
+     * Checks if entity exists in cache.
+     */
+    hasInCache(entityType: string, id: string): boolean;
+    /**
+     * Gets entity from cache if available.
+     */
+    getFromCache<T>(entityType: string, id: string): T | null;
+}
+/**
+ * Creates an EntityLoader instance.
+ * Factory function for easier testing and dependency injection.
+ */
+export declare function createEntityLoader(adapter: BackendAdapter, store: SnapshotStore): EntityLoader;
+//# sourceMappingURL=EntityLoader.d.ts.map

package/dist/core/EntityLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityLoader.d.ts","sourceRoot":"","sources":["../../src/core/EntityLoader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAC5E,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAgBrE;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAC3B;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC9B;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GACtC;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,CAAA;AAE1B;;GAEG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAC/B;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,CAAC,EAAE,CAAA;CAAE,GAChC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAA;AAEzC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,SAAS,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,WAAW,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB,CAAC,OAAO,GAAG,OAAO;IACvD,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,SAAS,CAAA;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;IAC7B,OAAO,CAAC,EAAE,SAAS,aAAa,CAAC,OAAO,CAAC,EAAE,CAAA;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,WAAW,CAAA;CACpB;AAED;;;GAGG;AACH,qBAAa,YAAY;IAEvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,aAAa;IAGtC;;OAEG;IACG,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAkC1E;;OAEG;IACG,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,OAAO,EAAE,qBAAqB,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;IAkC/G;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO;IAInD;;OAEG;IACH,YAAY,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;CAIzD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,aAAa,GAClB,YAAY,CAEd"}