@contember/bindx 0.1.0 → 0.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@contember/bindx",
-	"version": "0.1.0",
+	"version": "0.1.2",
 	"description": "Type-safe data binding framework (core)",
 	"type": "module",
 	"main": "./src/index.ts",

package/src/handles/proxyFactory.ts

@@ -36,7 +36,7 @@ const BASE_ENTITY_PROPERTIES: (string | symbol)[] = [
 export const ENTITY_HANDLE_PROPERTIES = new Set<string | symbol>([
 	...BASE_ENTITY_PROPERTIES,
 	// Entity-specific internals
-	'fieldHandleCache', 'relationHandleCache',
+	'type', 'fieldHandleCache', 'relationHandleCache',
 	// Internal methods (unlikely to be field names)
 	'field', 'hasOne', 'hasMany', 'getSnapshot',
 	'reset', 'commit',

package/dist/core/PersistenceManager.d.ts

@@ -1,126 +0,0 @@
-import type { BackendAdapter } from '../adapter/types.js';
-import type { SnapshotStore } from '../store/SnapshotStore.js';
-import type { ActionDispatcher } from './ActionDispatcher.js';
-import type { UndoManager } from '../undo/UndoManager.js';
-import type { SchemaRegistry } from '../schema/SchemaRegistry.js';
-import { type ContemberMutationResult } from '../errors/pathMapper.js';
-import type { MutationDataCollector } from '../persistence/types.js';
-export type { MutationDataCollector } from '../persistence/types.js';
-/**
- * Options for PersistenceManager
- */
-export interface PersistenceManagerOptions {
-    /**
-     * Custom mutation collector for building complex mutation inputs.
-     * If provided, will be used instead of simple field diff.
-     */
-    mutationCollector?: MutationDataCollector;
-    /**
-     * UndoManager instance to block during persist operations.
-     * When provided, undo/redo will be blocked during persistence.
-     */
-    undoManager?: UndoManager;
-    /**
-     * Schema registry for mapping server errors to fields.
-     * Required for detailed error mapping.
-     */
-    schema?: SchemaRegistry;
-}
-/**
- * Error thrown when persist fails due to client validation errors.
- */
-export declare class ClientValidationError extends Error {
-    constructor(entityType: string, id: string);
-}
-/**
- * Error thrown when persist fails due to server errors.
- * Contains the detailed mutation result for inspection.
- */
-export declare class PersistError extends Error {
-    readonly entityType: string;
-    readonly entityId: string;
-    readonly mutationResult?: ContemberMutationResult | undefined;
-    constructor(message: string, entityType: string, entityId: string, mutationResult?: ContemberMutationResult | undefined);
-}
-/**
- * PersistenceManager handles entity persistence with concurrency control.
- *
- * Key features:
- * - One persist operation per entity at a time (concurrent requests are queued)
- * - Optimistic updates (changes visible immediately)
- * - Abort support for cleanup
- * - Proper error handling with field-level error mapping
- * - Optional custom mutation collector for nested operations
- * - Blocks persist when client validation errors exist
- */
-export declare class PersistenceManager {
-    private readonly adapter;
-    private readonly store;
-    private readonly dispatcher;
-    /** Pending persist operations keyed by "entityType:id" */
-    private readonly pending;
-    private readonly mutationCollector?;
-    private readonly undoManager?;
-    private readonly schema?;
-    constructor(adapter: BackendAdapter, store: SnapshotStore, dispatcher: ActionDispatcher, options?: PersistenceManagerOptions);
-    /**
-     * Gets the key for an entity.
-     */
-    private getKey;
-    /**
-     * Checks if an entity is currently being persisted.
-     */
-    isPersisting(entityType: string, id: string): boolean;
-    /**
-     * Persists an entity's changes to the backend.
-     * Handles both create (new entities) and update (existing entities) operations.
-     *
-     * If already persisting, waits for the existing operation to complete.
-     * This prevents duplicate requests and ensures consistency.
-     *
-     * @throws {ClientValidationError} If entity has client validation errors
-     * @throws {PersistError} If server returns an error
-     */
-    persist(entityType: string, id: string): Promise<void>;
-    /**
-     * Performs the actual persist operation.
-     */
-    private doPersist;
-    /**
-     * Performs the create operation for new entities.
-     */
-    private doCreate;
-    /**
-     * Collects data for creating a new entity.
-     * Excludes the temporary ID.
-     */
-    private collectCreateData;
-    /**
-     * Collects changed fields by comparing data to serverData.
-     */
-    private collectChanges;
-    /**
-     * Maps server errors from mutation result to entity fields/relations.
-     */
-    private mapServerErrors;
-    /**
-     * Cancels a pending persist operation.
-     */
-    cancel(entityType: string, id: string): void;
-    /**
-     * Cancels all pending persist operations.
-     */
-    cancelAll(): void;
-    /**
-     * Creates a new entity on the backend.
-     */
-    create(entityType: string, data: Record<string, unknown>): Promise<{
-        id: string;
-        data: Record<string, unknown>;
-    }>;
-    /**
-     * Deletes an entity on the backend.
-     */
-    delete(entityType: string, id: string): Promise<void>;
-}
-//# sourceMappingURL=PersistenceManager.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"PersistenceManager.d.ts","sourceRoot":"","sources":["../../src/core/PersistenceManager.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,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAG7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EAAuB,KAAK,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AAO3F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAGpE,YAAY,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAUpE;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACzC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,qBAAqB,CAAA;IACzC;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,cAAc,CAAA;CACvB;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;gBACnC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;CAI1C;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAK;aAGrB,UAAU,EAAE,MAAM;aAClB,QAAQ,EAAE,MAAM;aAChB,cAAc,CAAC,EAAE,uBAAuB;gBAHxD,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,uBAAuB,YAAA;CAKzD;AAED;;;;;;;;;;GAUG;AACH,qBAAa,kBAAkB;IAQ7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAT5B,0DAA0D;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAuB;IAC1D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAa;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAgB;gBAGtB,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,gBAAgB,EAC7C,OAAO,CAAC,EAAE,yBAAyB;IAOpC;;OAEG;IACH,OAAO,CAAC,MAAM;IAId;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO;IAKrD;;;;;;;;;OASG;IACG,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkF5D;;OAEG;YACW,SAAS;IA+DvB;;OAEG;YACW,QAAQ;IAsEtB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAsBzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAiBtB;;OAEG;IACH,OAAO,CAAC,eAAe;IA+CvB;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAW5C;;OAEG;IACH,SAAS,IAAI,IAAI;IAOjB;;OAEG;IACG,MAAM,CACX,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAyBzD;;OAEG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAmB3D"}

package/dist/roles/RoleSchemaRegistry.d.ts

@@ -1,77 +0,0 @@
-/**
- * Runtime registry for role-based schemas.
- *
- * Manages multiple schema registries (one per role) and provides
- * utilities for role-aware field access and query building.
- */
-import { SchemaRegistry } from '../schema/SchemaRegistry.js';
-import type { RoleSchemaDefinitions } from './types.js';
-/**
- * Registry that manages multiple schemas, one for each role.
- *
- * @typeParam TRoleSchemas - Map of role names to their model types
- *
- * @example
- * ```typescript
- * interface RoleSchemas {
- *   public: { Article: PublicArticle; Author: PublicAuthor }
- *   editor: { Article: EditorArticle; Author: EditorAuthor }
- *   admin: { Article: AdminArticle; Author: AdminAuthor }
- * }
- *
- * const registry = new RoleSchemaRegistry<RoleSchemas>({
- *   public: publicSchemaDefinition,
- *   editor: editorSchemaDefinition,
- *   admin: adminSchemaDefinition,
- * })
- * ```
- */
-export declare class RoleSchemaRegistry<TRoleSchemas extends {
-    [K in keyof TRoleSchemas]: {
-        [E: string]: object;
-    };
-}> {
-    private readonly registries;
-    private readonly roleNames;
-    constructor(schemas: RoleSchemaDefinitions<TRoleSchemas>);
-    /**
-     * Gets all registered role names.
-     */
-    getRoleNames(): readonly (keyof TRoleSchemas)[];
-    /**
-     * Gets the SchemaRegistry for a specific role.
-     */
-    getSchemaForRole<TRole extends keyof TRoleSchemas>(role: TRole): SchemaRegistry;
-    /**
-     * Checks if a role exists in the registry.
-     */
-    hasRole(role: keyof TRoleSchemas): boolean;
-    /**
-     * Gets field names available for an entity across ALL specified roles (intersection).
-     *
-     * @param roles - Roles to check
-     * @param entityName - Entity to get fields for
-     * @returns Array of field names available in ALL specified roles
-     */
-    getFieldsForRoles(roles: readonly (keyof TRoleSchemas)[], entityName: string): string[];
-    /**
-     * Gets entity names available across ALL specified roles (intersection).
-     *
-     * @param roles - Roles to check
-     * @returns Array of entity names available in ALL specified roles
-     */
-    getEntityNamesForRoles(roles: readonly (keyof TRoleSchemas)[]): string[];
-    /**
-     * Checks if a field is accessible for all specified roles.
-     */
-    isFieldAccessible(roles: readonly (keyof TRoleSchemas)[], entityName: string, fieldName: string): boolean;
-    /**
-     * Checks if an entity is accessible for all specified roles.
-     */
-    isEntityAccessible(roles: readonly (keyof TRoleSchemas)[], entityName: string): boolean;
-    /**
-     * Validates all registered schemas.
-     */
-    validate(): void;
-}
-//# sourceMappingURL=RoleSchemaRegistry.d.ts.map

package/dist/roles/RoleSchemaRegistry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"RoleSchemaRegistry.d.ts","sourceRoot":"","sources":["../../src/roles/RoleSchemaRegistry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAE5D,OAAO,KAAK,EAAE,qBAAqB,EAAa,MAAM,YAAY,CAAA;AAElE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,kBAAkB,CAAC,YAAY,SAAS;KAAG,CAAC,IAAI,MAAM,YAAY,GAAG;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE;CAAE;IAC1G,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyC;IACpE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;gBAE/C,OAAO,EAAE,qBAAqB,CAAC,YAAY,CAAC;IAUxD;;OAEG;IACH,YAAY,IAAI,SAAS,CAAC,MAAM,YAAY,CAAC,EAAE;IAI/C;;OAEG;IACH,gBAAgB,CAAC,KAAK,SAAS,MAAM,YAAY,EAAE,IAAI,EAAE,KAAK,GAAG,cAAc;IAQ/E;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,YAAY,GAAG,OAAO;IAI1C;;;;;;OAMG;IACH,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,YAAY,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IA6BvF;;;;;OAKG;IACH,sBAAsB,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,YAAY,CAAC,EAAE,GAAG,MAAM,EAAE;IA6BxE;;OAEG;IACH,iBAAiB,CAChB,KAAK,EAAE,SAAS,CAAC,MAAM,YAAY,CAAC,EAAE,EACtC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GACf,OAAO;IAgBV;;OAEG;IACH,kBAAkB,CACjB,KAAK,EAAE,SAAS,CAAC,MAAM,YAAY,CAAC,EAAE,EACtC,UAAU,EAAE,MAAM,GAChB,OAAO;IAWV;;OAEG;IACH,QAAQ,IAAI,IAAI;CAWhB"}

package/dist/roles/index.d.ts

@@ -1,11 +0,0 @@
-/**
- * Role-based schema module for Bindx.
- *
- * Provides type-safe role-aware entity access with schema narrowing.
- *
- * @packageDocumentation
- */
-export type { UnionToIntersection, RoleSchemaMap, RoleNames, IntersectRoleSchemas, IntersectSchemaEntities, PickCommonProperties, EntityForRoles, SchemaForRole, EntityNamesForRoles, RoleSchemaDefinitions, RoleBindxConfig, RolesAreSubset, RequireRoleSubset, AssertRoleCompatibility, SingleSchemaRoles, IsSingleSchema, AllRoles, DefaultRole, } from './types.js';
-export { isValidRole, DEFAULT_ROLE } from './types.js';
-export { RoleSchemaRegistry } from './RoleSchemaRegistry.js';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/roles/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EACX,mBAAmB,EACnB,aAAa,EACb,SAAS,EACT,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,cAAc,EACd,QAAQ,EACR,WAAW,GACX,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/roles/types.d.ts

@@ -1,242 +0,0 @@
-/**
- * Role-based schema types for Bindx.
- *
- * Provides type-safe role-aware entity access with schema narrowing
- * based on user roles.
- */
-import type { SchemaDefinition, EntitySchemaDef } from '../schema/types.js';
-/**
- * Converts a union type to an intersection type.
- *
- * @example
- * ```typescript
- * type Union = { a: string } | { b: number }
- * type Intersection = UnionToIntersection<Union>
- * // Result: { a: string } & { b: number }
- * ```
- */
-export type UnionToIntersection<U> = (U extends unknown ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
-/**
- * Extracts keys that exist in ALL members of a union type.
- * Uses distributive conditional to check each union member.
- *
- * @example
- * ```typescript
- * type A = { id: string; title: string; content: string }
- * type B = { id: string; title: string; notes: string }
- * type Common = KeysInAll<A | B>
- * // Result: 'id' | 'title'
- * ```
- */
-type KeysInAll<T, K = keyof T> = T extends unknown ? K extends keyof T ? K : never : never;
-/**
- * Picks only the common properties from a union of object types.
- * Returns an object with only keys that exist in ALL union members.
- * Property values are unions of the original types.
- *
- * @example
- * ```typescript
- * type A = { id: string; title: string; content: string }
- * type B = { id: string; title: string; notes: string }
- * type Common = PickCommonProperties<A | B>
- * // Result: { id: string; title: string }
- * ```
- */
-export type PickCommonProperties<T> = {
-    [K in KeysInAll<T>]: T extends {
-        readonly [P in K]: infer V;
-    } ? V : never;
-};
-/**
- * Applies PickCommonProperties to each entity in a schema union.
- * For a union of schemas, extracts only common entity names and their common properties.
- *
- * @example
- * ```typescript
- * type SchemaA = { Article: { id: string; title: string }; Author: { id: string } }
- * type SchemaB = { Article: { id: string; content: string }; Author: { id: string } }
- * type Common = IntersectSchemaEntities<SchemaA | SchemaB>
- * // Result: { Article: { id: string }; Author: { id: string } }
- * ```
- */
-export type IntersectSchemaEntities<TSchemaUnion> = {
-    [K in KeysInAll<TSchemaUnion>]: PickCommonProperties<TSchemaUnion extends {
-        readonly [P in K]: infer V;
-    } ? V : never>;
-};
-/**
- * Base constraint for role schema maps.
- * Uses a mapped type to allow interfaces without index signatures.
- */
-export type RoleSchemasConstraint = {
-    [role: string]: {
-        [entity: string]: object;
-    };
-};
-/**
- * Mapping of role names to their respective schema types.
- *
- * @example
- * ```typescript
- * interface MyRoleSchemas {
- *   public: PublicSchema
- *   editor: EditorSchema
- *   admin: AdminSchema
- * }
- * ```
- */
-export type RoleSchemaMap<TRoleSchemas> = {
-    [K in keyof TRoleSchemas]: TRoleSchemas[K];
-};
-/**
- * Extracts all role names from a role schema map.
- */
-export type RoleNames<TRoleSchemas> = keyof TRoleSchemas & string;
-/**
- * Intersects schemas from multiple roles.
- * Used when multiple roles are specified - returns fields accessible to ALL roles.
- *
- * This performs a TRUE property intersection: only properties that exist in ALL
- * role schemas are accessible. This is different from TypeScript's & operator
- * which creates a type with ALL properties from all schemas.
- *
- * @example
- * ```typescript
- * interface EditorSchema { Article: { id: string; title: string; content: string } }
- * interface ReviewerSchema { Article: { id: string; title: string; status: string } }
- *
- * type Combined = IntersectRoleSchemas<{ editor: EditorSchema; reviewer: ReviewerSchema }, ['editor', 'reviewer']>
- * // Result: { Article: { id: string; title: string } } (only common properties)
- * ```
- */
-export type IntersectRoleSchemas<TRoleSchemas, TRoles extends readonly (keyof TRoleSchemas)[]> = IntersectSchemaEntities<TRoleSchemas[TRoles[number]]>;
-/**
- * Gets the entity type for specific roles.
- *
- * @typeParam TRoleSchemas - Map of role names to their schemas
- * @typeParam TRoles - Tuple of role names to intersect
- * @typeParam TEntityName - Name of the entity to extract
- */
-export type EntityForRoles<TRoleSchemas, TRoles extends readonly (keyof TRoleSchemas)[], TEntityName extends string> = TEntityName extends keyof IntersectRoleSchemas<TRoleSchemas, TRoles> ? IntersectRoleSchemas<TRoleSchemas, TRoles>[TEntityName] : never;
-/**
- * Gets the schema type for a specific role.
- */
-export type SchemaForRole<TRoleSchemas, TRole extends keyof TRoleSchemas> = TRoleSchemas[TRole];
-/**
- * Extracts all entity names that exist in ALL specified roles.
- */
-export type EntityNamesForRoles<TRoleSchemas, TRoles extends readonly (keyof TRoleSchemas)[]> = keyof IntersectRoleSchemas<TRoleSchemas, TRoles> & string;
-/**
- * Maps role names to their schema definitions (runtime structure).
- */
-export type RoleSchemaDefinitions<TRoleSchemas> = {
-    [K in keyof TRoleSchemas]: TRoleSchemas[K] extends {
-        [E: string]: object;
-    } ? SchemaDefinition<TRoleSchemas[K]> : never;
-};
-/**
- * Configuration for role-aware bindx.
- */
-export interface RoleBindxConfig<TRoleSchemas> {
-    /**
-     * Schema definitions for each role.
-     */
-    readonly schemas: RoleSchemaDefinitions<TRoleSchemas>;
-    /**
-     * Function to check if the current user has a specific role.
-     * Used at runtime to determine which branches to render.
-     */
-    readonly hasRole: (role: keyof TRoleSchemas) => boolean;
-    /**
-     * Current roles of the user.
-     * Used for query building - determines which fields to fetch.
-     */
-    readonly currentRoles: readonly (keyof TRoleSchemas)[];
-}
-/**
- * Check if TRequired roles are a subset of TAvailable roles.
- * Returns true if every role in TRequired exists in TAvailable.
- *
- * @example
- * ```typescript
- * type Test1 = RolesAreSubset<['admin'], ['editor', 'admin']> // true
- * type Test2 = RolesAreSubset<['admin'], ['editor']> // false
- * type Test3 = RolesAreSubset<[], ['editor']> // true (empty is subset of all)
- * ```
- */
-export type RolesAreSubset<TRequired extends readonly string[], TAvailable extends readonly string[]> = TRequired extends readonly [] ? true : TRequired extends readonly [infer First extends string, ...infer Rest extends string[]] ? First extends TAvailable[number] ? RolesAreSubset<Rest, TAvailable> : false : boolean;
-/**
- * Enforces that TRequired roles must be a subset of TAvailable roles.
- * Returns TRequired if valid, never if not.
- *
- * @example
- * ```typescript
- * type Valid = RequireRoleSubset<['admin'], ['editor', 'admin']> // ['admin']
- * type Invalid = RequireRoleSubset<['admin'], ['editor']> // never
- * ```
- */
-export type RequireRoleSubset<TRequired extends readonly string[], TAvailable extends readonly string[]> = RolesAreSubset<TRequired, TAvailable> extends true ? TRequired : never;
-/**
- * Asserts that TComponentRoles are compatible with TAvailableRoles.
- * Used for type-level validation when using role-aware components.
- *
- * When component requires ['admin'] and scope has ['editor', 'admin']:
- * - ['admin'] ⊆ ['editor', 'admin'] = true (compatible)
- *
- * When component requires ['admin'] and scope has ['editor']:
- * - ['admin'] ⊆ ['editor'] = false (incompatible)
- */
-export type AssertRoleCompatibility<TComponentRoles extends readonly string[], TAvailableRoles extends readonly string[]> = RolesAreSubset<TComponentRoles, TAvailableRoles> extends true ? TComponentRoles : ['Error: Component requires roles', TComponentRoles, 'but available roles are', TAvailableRoles];
-/**
- * Type predicate to check if a value is a valid role.
- */
-export declare function isValidRole<TRoleSchemas>(roleSchemas: TRoleSchemas, role: unknown): role is keyof TRoleSchemas;
-export type { SchemaDefinition, EntitySchemaDef };
-/**
- * Wraps a single schema as a role schema map with a default role.
- * This allows single-schema usage to be a special case of role-aware bindx.
- *
- * @example
- * ```typescript
- * type Models = { Article: ArticleType; Author: AuthorType }
- *
- * // Single schema becomes:
- * type RoleSchemas = SingleSchemaRoles<Models>
- * // = { _default: { Article: ArticleType; Author: AuthorType } }
- *
- * // IntersectRoleSchemas<RoleSchemas, ['_default']> = Models
- * ```
- */
-export type SingleSchemaRoles<TModels extends Record<string, object>> = {
-    _default: TModels;
-};
-/**
- * Check if TRoleSchemas represents a single-schema case.
- * Returns true if the only key is '_default'.
- *
- * @example
- * ```typescript
- * type Test1 = IsSingleSchema<{ _default: Models }> // true
- * type Test2 = IsSingleSchema<{ admin: AdminModels; public: PublicModels }> // false
- * ```
- */
-export type IsSingleSchema<TRoleSchemas> = keyof TRoleSchemas extends '_default' ? '_default' extends keyof TRoleSchemas ? true : false : false;
-/**
- * Gets all role names from a role schema map as a readonly array type.
- *
- * @example
- * ```typescript
- * type Roles = AllRoles<{ admin: AdminModels; public: PublicModels }>
- * // = readonly ('admin' | 'public')[]
- * ```
- */
-export type AllRoles<TRoleSchemas> = readonly (keyof TRoleSchemas & string)[];
-/**
- * Default role name for single-schema case.
- */
-export declare const DEFAULT_ROLE: "_default";
-/**
- * Type for the default role name.
- */
-export type DefaultRole = typeof DEFAULT_ROLE;
-//# sourceMappingURL=types.d.ts.map

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

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