@pwfabric/runtime 0.0.0-stage → 1.0.0-rc.1

package/dist/entity/connectors/static.js

@@ -0,0 +1,245 @@
+/**
+ * Static Entity Connector
+ *
+ * In-memory Map-based connector for prototyping and testing.
+ * Supports filter, sort, and pagination operations.
+ *
+ * @module @pwfabric/runtime/entity/connectors/static
+ */
+// ============================================================
+// STATIC CONNECTOR
+// ============================================================
+/**
+ * In-memory static connector for prototyping and testing.
+ * Stores data in a Map keyed by entity type, then by instance id.
+ */
+export class StaticConnector {
+    name;
+    type = 'static';
+    store = new Map();
+    counter = 0;
+    constructor(name = 'static') {
+        this.name = name;
+    }
+    async create(entityType, data) {
+        const typeStore = this.getOrCreateTypeStore(entityType);
+        const id = this.generateId();
+        const record = { ...data, id };
+        typeStore.set(id, record);
+        return { success: true, data: record };
+    }
+    async read(entityType, instanceId) {
+        const typeStore = this.store.get(entityType);
+        if (!typeStore) {
+            return { success: false, error: `Entity type '${entityType}' has no data` };
+        }
+        const record = typeStore.get(instanceId);
+        if (!record) {
+            return { success: false, error: `Instance '${instanceId}' not found` };
+        }
+        return { success: true, data: { ...record } };
+    }
+    async update(entityType, instanceId, data) {
+        const typeStore = this.store.get(entityType);
+        if (!typeStore) {
+            return { success: false, error: `Entity type '${entityType}' has no data` };
+        }
+        const existing = typeStore.get(instanceId);
+        if (!existing) {
+            return { success: false, error: `Instance '${instanceId}' not found` };
+        }
+        const updated = { ...existing, ...data, id: instanceId };
+        typeStore.set(instanceId, updated);
+        return { success: true, data: updated };
+    }
+    async delete(entityType, instanceId) {
+        const typeStore = this.store.get(entityType);
+        if (!typeStore) {
+            return { success: false, error: `Entity type '${entityType}' has no data` };
+        }
+        const existing = typeStore.get(instanceId);
+        if (!existing) {
+            return { success: false, error: `Instance '${instanceId}' not found` };
+        }
+        typeStore.delete(instanceId);
+        return { success: true, data: existing };
+    }
+    async query(entityType, query) {
+        const typeStore = this.store.get(entityType);
+        if (!typeStore) {
+            return {
+                success: true,
+                result: {
+                    items: [],
+                    total: 0,
+                    offset: 0,
+                    limit: query.pagination?.limit ?? 50,
+                    hasMore: false,
+                },
+            };
+        }
+        let items = Array.from(typeStore.values());
+        // Apply filters
+        if (query.filter) {
+            items = this.applyFilter(items, query.filter);
+        }
+        const total = items.length;
+        // Apply sort
+        if (query.sort && query.sort.length > 0) {
+            items = this.applySort(items, query.sort);
+        }
+        // Apply pagination
+        const offset = query.pagination?.offset ?? 0;
+        const limit = query.pagination?.limit ?? 50;
+        const paginatedItems = items.slice(offset, offset + limit);
+        return {
+            success: true,
+            result: {
+                items: paginatedItems,
+                total,
+                offset,
+                limit,
+                hasMore: offset + limit < total,
+            },
+        };
+    }
+    /**
+     * Seed data into the connector for testing
+     */
+    seed(entityType, records) {
+        const typeStore = this.getOrCreateTypeStore(entityType);
+        for (const record of records) {
+            const id = record.id ?? this.generateId();
+            typeStore.set(id, { ...record, id });
+        }
+    }
+    /**
+     * Clear all data from the connector
+     */
+    clear() {
+        this.store.clear();
+        this.counter = 0;
+    }
+    /**
+     * Clear data for a specific entity type
+     */
+    clearType(entityType) {
+        this.store.delete(entityType);
+    }
+    /**
+     * Get the total count of records for an entity type
+     */
+    count(entityType) {
+        return this.store.get(entityType)?.size ?? 0;
+    }
+    getOrCreateTypeStore(entityType) {
+        let typeStore = this.store.get(entityType);
+        if (!typeStore) {
+            typeStore = new Map();
+            this.store.set(entityType, typeStore);
+        }
+        return typeStore;
+    }
+    generateId() {
+        this.counter++;
+        return `inst_${this.counter}`;
+    }
+    applyFilter(items, filter) {
+        let result = items;
+        // Apply the main condition
+        if (filter.field && filter.operator) {
+            result = result.filter((item) => this.matchesCondition(item, filter));
+        }
+        // Apply AND conditions
+        if (filter.and && filter.and.length > 0) {
+            for (const andFilter of filter.and) {
+                result = this.applyFilter(result, andFilter);
+            }
+        }
+        // Apply OR conditions
+        if (filter.or && filter.or.length > 0) {
+            const orResults = new Set();
+            for (const orFilter of filter.or) {
+                const orMatches = this.applyFilter(result, orFilter);
+                for (const match of orMatches) {
+                    orResults.add(match);
+                }
+            }
+            result = Array.from(orResults);
+        }
+        return result;
+    }
+    matchesCondition(item, filter) {
+        const fieldValue = item[filter.field];
+        const filterValue = filter.value;
+        switch (filter.operator) {
+            case 'eq':
+                return fieldValue === filterValue;
+            case 'neq':
+                return fieldValue !== filterValue;
+            case 'gt':
+                return typeof fieldValue === 'number' && typeof filterValue === 'number'
+                    ? fieldValue > filterValue
+                    : false;
+            case 'gte':
+                return typeof fieldValue === 'number' && typeof filterValue === 'number'
+                    ? fieldValue >= filterValue
+                    : false;
+            case 'lt':
+                return typeof fieldValue === 'number' && typeof filterValue === 'number'
+                    ? fieldValue < filterValue
+                    : false;
+            case 'lte':
+                return typeof fieldValue === 'number' && typeof filterValue === 'number'
+                    ? fieldValue <= filterValue
+                    : false;
+            case 'in':
+                return Array.isArray(filterValue) ? filterValue.includes(fieldValue) : false;
+            case 'contains':
+                return typeof fieldValue === 'string' && typeof filterValue === 'string'
+                    ? fieldValue.includes(filterValue)
+                    : false;
+            case 'startsWith':
+                return typeof fieldValue === 'string' && typeof filterValue === 'string'
+                    ? fieldValue.startsWith(filterValue)
+                    : false;
+            default:
+                return false;
+        }
+    }
+    applySort(items, sortFields) {
+        return [...items].sort((a, b) => {
+            for (const sortField of sortFields) {
+                const aVal = a[sortField.field];
+                const bVal = b[sortField.field];
+                let comparison = 0;
+                if (typeof aVal === 'string' && typeof bVal === 'string') {
+                    comparison = aVal.localeCompare(bVal);
+                }
+                else if (typeof aVal === 'number' && typeof bVal === 'number') {
+                    comparison = aVal - bVal;
+                }
+                else if (aVal === undefined || aVal === null) {
+                    comparison = -1;
+                }
+                else if (bVal === undefined || bVal === null) {
+                    comparison = 1;
+                }
+                if (comparison !== 0) {
+                    return sortField.direction === 'desc' ? -comparison : comparison;
+                }
+            }
+            return 0;
+        });
+    }
+}
+// ============================================================
+// FACTORY FUNCTION
+// ============================================================
+/**
+ * Create a static connector
+ */
+export function createStaticConnector(name) {
+    return new StaticConnector(name);
+}
+//# sourceMappingURL=static.js.map

package/dist/entity/connectors/static.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static.js","sourceRoot":"","sources":["../../../src/entity/connectors/static.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Static Entity Connector\n *\n * In-memory Map-based connector for prototyping and testing.\n * Supports filter, sort, and pagination operations.\n *\n * @module @pwfabric/runtime/entity/connectors/static\n */\n\nimport type {\n  EntityTypeId,\n  EntityInstanceId,\n  EntityQuery,\n  EntityFilter,\n  EntitySortField,\n} from '../types.js'\nimport type { EntityConnector, ConnectorResult, ConnectorQueryResult } from '../connector.js'\n\n// ============================================================\n// STATIC CONNECTOR\n// ============================================================\n\n/**\n * In-memory static connector for prototyping and testing.\n * Stores data in a Map keyed by entity type, then by instance id.\n */\nexport class StaticConnector implements EntityConnector {\n  readonly name: string\n  readonly type = 'static' as const\n\n  private readonly store = new Map<EntityTypeId, Map<EntityInstanceId, Record<string, unknown>>>()\n  private counter = 0\n\n  constructor(name = 'static') {\n    this.name = name\n  }\n\n  async create(entityType: EntityTypeId, data: Record<string, unknown>): Promise<ConnectorResult> {\n    const typeStore = this.getOrCreateTypeStore(entityType)\n    const id = this.generateId()\n    const record = { ...data, id }\n\n    typeStore.set(id, record)\n\n    return { success: true, data: record }\n  }\n\n  async read(entityType: EntityTypeId, instanceId: EntityInstanceId): Promise<ConnectorResult> {\n    const typeStore = this.store.get(entityType)\n    if (!typeStore) {\n      return { success: false, error: `Entity type '${entityType}' has no data` }\n    }\n\n    const record = typeStore.get(instanceId)\n    if (!record) {\n      return { success: false, error: `Instance '${instanceId}' not found` }\n    }\n\n    return { success: true, data: { ...record } }\n  }\n\n  async update(\n    entityType: EntityTypeId,\n    instanceId: EntityInstanceId,\n    data: Record<string, unknown>\n  ): Promise<ConnectorResult> {\n    const typeStore = this.store.get(entityType)\n    if (!typeStore) {\n      return { success: false, error: `Entity type '${entityType}' has no data` }\n    }\n\n    const existing = typeStore.get(instanceId)\n    if (!existing) {\n      return { success: false, error: `Instance '${instanceId}' not found` }\n    }\n\n    const updated = { ...existing, ...data, id: instanceId }\n    typeStore.set(instanceId, updated)\n\n    return { success: true, data: updated }\n  }\n\n  async delete(entityType: EntityTypeId, instanceId: EntityInstanceId): Promise<ConnectorResult> {\n    const typeStore = this.store.get(entityType)\n    if (!typeStore) {\n      return { success: false, error: `Entity type '${entityType}' has no data` }\n    }\n\n    const existing = typeStore.get(instanceId)\n    if (!existing) {\n      return { success: false, error: `Instance '${instanceId}' not found` }\n    }\n\n    typeStore.delete(instanceId)\n\n    return { success: true, data: existing }\n  }\n\n  async query(entityType: EntityTypeId, query: EntityQuery): Promise<ConnectorQueryResult> {\n    const typeStore = this.store.get(entityType)\n    if (!typeStore) {\n      return {\n        success: true,\n        result: {\n          items: [],\n          total: 0,\n          offset: 0,\n          limit: query.pagination?.limit ?? 50,\n          hasMore: false,\n        },\n      }\n    }\n\n    let items = Array.from(typeStore.values())\n\n    // Apply filters\n    if (query.filter) {\n      items = this.applyFilter(items, query.filter)\n    }\n\n    const total = items.length\n\n    // Apply sort\n    if (query.sort && query.sort.length > 0) {\n      items = this.applySort(items, query.sort)\n    }\n\n    // Apply pagination\n    const offset = query.pagination?.offset ?? 0\n    const limit = query.pagination?.limit ?? 50\n    const paginatedItems = items.slice(offset, offset + limit)\n\n    return {\n      success: true,\n      result: {\n        items: paginatedItems,\n        total,\n        offset,\n        limit,\n        hasMore: offset + limit < total,\n      },\n    }\n  }\n\n  /**\n   * Seed data into the connector for testing\n   */\n  seed(entityType: EntityTypeId, records: Record<string, unknown>[]): void {\n    const typeStore = this.getOrCreateTypeStore(entityType)\n    for (const record of records) {\n      const id = (record.id as EntityInstanceId) ?? this.generateId()\n      typeStore.set(id, { ...record, id })\n    }\n  }\n\n  /**\n   * Clear all data from the connector\n   */\n  clear(): void {\n    this.store.clear()\n    this.counter = 0\n  }\n\n  /**\n   * Clear data for a specific entity type\n   */\n  clearType(entityType: EntityTypeId): void {\n    this.store.delete(entityType)\n  }\n\n  /**\n   * Get the total count of records for an entity type\n   */\n  count(entityType: EntityTypeId): number {\n    return this.store.get(entityType)?.size ?? 0\n  }\n\n  private getOrCreateTypeStore(\n    entityType: EntityTypeId\n  ): Map<EntityInstanceId, Record<string, unknown>> {\n    let typeStore = this.store.get(entityType)\n    if (!typeStore) {\n      typeStore = new Map()\n      this.store.set(entityType, typeStore)\n    }\n    return typeStore\n  }\n\n  private generateId(): EntityInstanceId {\n    this.counter++\n    return `inst_${this.counter}` as EntityInstanceId\n  }\n\n  private applyFilter(\n    items: Record<string, unknown>[],\n    filter: EntityFilter\n  ): Record<string, unknown>[] {\n    let result = items\n\n    // Apply the main condition\n    if (filter.field && filter.operator) {\n      result = result.filter((item) => this.matchesCondition(item, filter))\n    }\n\n    // Apply AND conditions\n    if (filter.and && filter.and.length > 0) {\n      for (const andFilter of filter.and) {\n        result = this.applyFilter(result, andFilter)\n      }\n    }\n\n    // Apply OR conditions\n    if (filter.or && filter.or.length > 0) {\n      const orResults = new Set<Record<string, unknown>>()\n      for (const orFilter of filter.or) {\n        const orMatches = this.applyFilter(result, orFilter)\n        for (const match of orMatches) {\n          orResults.add(match)\n        }\n      }\n      result = Array.from(orResults)\n    }\n\n    return result\n  }\n\n  private matchesCondition(item: Record<string, unknown>, filter: EntityFilter): boolean {\n    const fieldValue = item[filter.field]\n    const filterValue = filter.value\n\n    switch (filter.operator) {\n      case 'eq':\n        return fieldValue === filterValue\n      case 'neq':\n        return fieldValue !== filterValue\n      case 'gt':\n        return typeof fieldValue === 'number' && typeof filterValue === 'number'\n          ? fieldValue > filterValue\n          : false\n      case 'gte':\n        return typeof fieldValue === 'number' && typeof filterValue === 'number'\n          ? fieldValue >= filterValue\n          : false\n      case 'lt':\n        return typeof fieldValue === 'number' && typeof filterValue === 'number'\n          ? fieldValue < filterValue\n          : false\n      case 'lte':\n        return typeof fieldValue === 'number' && typeof filterValue === 'number'\n          ? fieldValue <= filterValue\n          : false\n      case 'in':\n        return Array.isArray(filterValue) ? filterValue.includes(fieldValue) : false\n      case 'contains':\n        return typeof fieldValue === 'string' && typeof filterValue === 'string'\n          ? fieldValue.includes(filterValue)\n          : false\n      case 'startsWith':\n        return typeof fieldValue === 'string' && typeof filterValue === 'string'\n          ? fieldValue.startsWith(filterValue)\n          : false\n      default:\n        return false\n    }\n  }\n\n  private applySort(\n    items: Record<string, unknown>[],\n    sortFields: readonly EntitySortField[]\n  ): Record<string, unknown>[] {\n    return [...items].sort((a, b) => {\n      for (const sortField of sortFields) {\n        const aVal = a[sortField.field]\n        const bVal = b[sortField.field]\n\n        let comparison = 0\n\n        if (typeof aVal === 'string' && typeof bVal === 'string') {\n          comparison = aVal.localeCompare(bVal)\n        } else if (typeof aVal === 'number' && typeof bVal === 'number') {\n          comparison = aVal - bVal\n        } else if (aVal === undefined || aVal === null) {\n          comparison = -1\n        } else if (bVal === undefined || bVal === null) {\n          comparison = 1\n        }\n\n        if (comparison !== 0) {\n          return sortField.direction === 'desc' ? -comparison : comparison\n        }\n      }\n      return 0\n    })\n  }\n}\n\n// ============================================================\n// FACTORY FUNCTION\n// ============================================================\n\n/**\n * Create a static connector\n */\nexport function createStaticConnector(name?: string): StaticConnector {\n  return new StaticConnector(name)\n}\n"]}

package/dist/entity/entity-datasource.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Entity DataSource Adapter
+ *
+ * Wraps EntityStore.query() as a minimal DataSource-compatible
+ * adapter so the surface expression system can resolve entity data via the
+ * existing {{data.sourceName.field}} binding path.
+ *
+ * @module @pwfabric/runtime/entity/entity-datasource
+ */
+import type { EntityFacade } from './facade.js';
+import type { EntityTypeId, EntityQuery, EntityQueryResult } from './types.js';
+/**
+ * Configuration for an EntityDataSource instance.
+ * Matches the `entity`-typed entry in a surface definition's dataSources array.
+ */
+export interface EntityDataSourceConfig {
+    /** Unique identifier — matches the surface definition id used in expressions */
+    readonly id: string;
+    /** Entity type to query (e.g. 'Employee', 'Product') */
+    readonly entityType: EntityTypeId;
+    /** Optional query parameters (filter, sort, pagination) */
+    readonly query?: EntityQuery;
+}
+/**
+ * Minimal DataSource-compatible adapter for entity queries.
+ * fetch() delegates to EntityFacade.resolveBinding() and returns EntityQueryResult.
+ * Results are accessible via {{data.sourceName.items}} / {{data.sourceName.total}}.
+ */
+export interface EntityDataSource {
+    readonly id: string;
+    readonly type: 'entity';
+    fetch(): Promise<EntityQueryResult>;
+}
+/**
+ * Creates an EntityDataSource that wraps EntityStore.query() for a specific
+ * entity type. Register with the surface data context to make results
+ * available in block expression props.
+ *
+ * @example
+ * ```ts
+ * const employeesSource = createEntityDataSource(facade, {
+ *   id: 'employees',
+ *   entityType: 'Employee',
+ *   query: { sort: [{ field: 'name', direction: 'asc' }] },
+ * })
+ * const result = await employeesSource.fetch()
+ * // result.items — array of employee records
+ * ```
+ */
+export declare function createEntityDataSource(facade: EntityFacade, config: EntityDataSourceConfig): EntityDataSource;

package/dist/entity/entity-datasource.js

@@ -0,0 +1,33 @@
+/**
+ * Entity DataSource Adapter
+ *
+ * Wraps EntityStore.query() as a minimal DataSource-compatible
+ * adapter so the surface expression system can resolve entity data via the
+ * existing {{data.sourceName.field}} binding path.
+ *
+ * @module @pwfabric/runtime/entity/entity-datasource
+ */
+/**
+ * Creates an EntityDataSource that wraps EntityStore.query() for a specific
+ * entity type. Register with the surface data context to make results
+ * available in block expression props.
+ *
+ * @example
+ * ```ts
+ * const employeesSource = createEntityDataSource(facade, {
+ *   id: 'employees',
+ *   entityType: 'Employee',
+ *   query: { sort: [{ field: 'name', direction: 'asc' }] },
+ * })
+ * const result = await employeesSource.fetch()
+ * // result.items — array of employee records
+ * ```
+ */
+export function createEntityDataSource(facade, config) {
+    return {
+        id: config.id,
+        type: 'entity',
+        fetch: () => facade.resolveBinding(config.entityType, config.query),
+    };
+}
+//# sourceMappingURL=entity-datasource.js.map

package/dist/entity/entity-datasource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-datasource.js","sourceRoot":"","sources":["../../src/entity/entity-datasource.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiCH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAoB,EACpB,MAA8B;IAE9B,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC;KACpE,CAAA;AACH,CAAC","sourcesContent":["/**\n * Entity DataSource Adapter\n *\n * Wraps EntityStore.query() as a minimal DataSource-compatible\n * adapter so the surface expression system can resolve entity data via the\n * existing {{data.sourceName.field}} binding path.\n *\n * @module @pwfabric/runtime/entity/entity-datasource\n */\n\nimport type { EntityFacade } from './facade.js'\nimport type { EntityTypeId, EntityQuery, EntityQueryResult } from './types.js'\n\n// ============================================================\n// ENTITY DATA SOURCE\n// ============================================================\n\n/**\n * Configuration for an EntityDataSource instance.\n * Matches the `entity`-typed entry in a surface definition's dataSources array.\n */\nexport interface EntityDataSourceConfig {\n  /** Unique identifier — matches the surface definition id used in expressions */\n  readonly id: string\n  /** Entity type to query (e.g. 'Employee', 'Product') */\n  readonly entityType: EntityTypeId\n  /** Optional query parameters (filter, sort, pagination) */\n  readonly query?: EntityQuery\n}\n\n/**\n * Minimal DataSource-compatible adapter for entity queries.\n * fetch() delegates to EntityFacade.resolveBinding() and returns EntityQueryResult.\n * Results are accessible via {{data.sourceName.items}} / {{data.sourceName.total}}.\n */\nexport interface EntityDataSource {\n  readonly id: string\n  readonly type: 'entity'\n  fetch(): Promise<EntityQueryResult>\n}\n\n/**\n * Creates an EntityDataSource that wraps EntityStore.query() for a specific\n * entity type. Register with the surface data context to make results\n * available in block expression props.\n *\n * @example\n * ```ts\n * const employeesSource = createEntityDataSource(facade, {\n *   id: 'employees',\n *   entityType: 'Employee',\n *   query: { sort: [{ field: 'name', direction: 'asc' }] },\n * })\n * const result = await employeesSource.fetch()\n * // result.items — array of employee records\n * ```\n */\nexport function createEntityDataSource(\n  facade: EntityFacade,\n  config: EntityDataSourceConfig\n): EntityDataSource {\n  return {\n    id: config.id,\n    type: 'entity',\n    fetch: () => facade.resolveBinding(config.entityType, config.query),\n  }\n}\n"]}

package/dist/entity/facade.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Entity Facade
+ *
+ * Facade that combines Registry, Store, ConnectorRegistry, and
+ * EntityLifecycleEngine into a single facade for surface integration.
+ *
+ * Renamed from EntityCapability to EntityFacade to avoid collision
+ * with the canonical Platform Capability interface.
+ *
+ * de-behaviorization: `behaviors` field renamed to `entityLifecycle`.
+ * `behaviors` kept as deprecated accessor for one minor version.
+ *
+ * @module @pwfabric/runtime/entity/facade
+ */
+import type { EntityTypeId, EntityDefinition, EntityQuery, EntityQueryResult, EntityAggregate, EntityAggregateResult } from './types.js';
+import type { EntityRegistry } from './registry.js';
+import type { EntityStore } from './store.js';
+import type { ConnectorRegistry } from './connector.js';
+import type { EntityLifecycleEngine } from './behavior.js';
+/**
+ * Facade that provides unified access to the entity system
+ */
+export interface EntityFacade {
+    /** Entity type registry */
+    readonly registry: EntityRegistry;
+    /** Entity CRUD store */
+    readonly store: EntityStore;
+    /** Connector registry for data source binding */
+    readonly connectors: ConnectorRegistry;
+    /** Entity lifecycle engine for hook registration and execution (onCreate/onUpdate/onDelete/onRead) */
+    readonly entityLifecycle: EntityLifecycleEngine;
+    /**
+     * Convenience method to register an entity definition and bind it to a connector
+     */
+    registerEntity(definition: EntityDefinition, connectorName: string): void;
+    /**
+     * Resolve a binding for Surface expression resolution.
+     * Queries the entity store for the given entity type and query.
+     */
+    resolveBinding(entityType: EntityTypeId, query?: EntityQuery): Promise<EntityQueryResult>;
+    /**
+     * Resolve an AGGREGATE source: one number over the collection.
+     * Rejects when the number cannot be served (never answers a false 0).
+     * OPTIONAL so a host facade built before this still type-checks; the
+     * renderer lists and reduces in memory when it is absent.
+     */
+    resolveAggregate?(entityType: EntityTypeId, aggregate: EntityAggregate): Promise<EntityAggregateResult>;
+}
+/**
+ * Default implementation of EntityFacade
+ */
+export declare class DefaultEntityFacade implements EntityFacade {
+    readonly registry: EntityRegistry;
+    readonly store: EntityStore;
+    readonly connectors: ConnectorRegistry;
+    readonly entityLifecycle: EntityLifecycleEngine;
+    constructor(registry: EntityRegistry, store: EntityStore, connectors: ConnectorRegistry, entityLifecycle: EntityLifecycleEngine);
+    registerEntity(definition: EntityDefinition, connectorName: string): void;
+    resolveBinding(entityType: EntityTypeId, query?: EntityQuery): Promise<EntityQueryResult>;
+    resolveAggregate(entityType: EntityTypeId, aggregate: EntityAggregate): Promise<EntityAggregateResult>;
+}
+/**
+ * Create an entity facade with all subsystems wired together
+ */
+export declare function createEntityFacade(options?: {
+    registry?: EntityRegistry;
+    connectors?: ConnectorRegistry;
+    /** Primary option — entity lifecycle engine for hook registration */
+    entityLifecycle?: EntityLifecycleEngine;
+}): EntityFacade;

package/dist/entity/facade.js

@@ -0,0 +1,70 @@
+/**
+ * Entity Facade
+ *
+ * Facade that combines Registry, Store, ConnectorRegistry, and
+ * EntityLifecycleEngine into a single facade for surface integration.
+ *
+ * Renamed from EntityCapability to EntityFacade to avoid collision
+ * with the canonical Platform Capability interface.
+ *
+ * de-behaviorization: `behaviors` field renamed to `entityLifecycle`.
+ * `behaviors` kept as deprecated accessor for one minor version.
+ *
+ * @module @pwfabric/runtime/entity/facade
+ */
+import { createEntityRegistry } from './registry.js';
+import { createEntityStore } from './store.js';
+import { createConnectorRegistry } from './connector.js';
+import { createEntityLifecycleEngine } from './behavior.js';
+import { aggregateThrough } from './aggregate.js';
+// ============================================================
+// DEFAULT ENTITY FACADE
+// ============================================================
+/**
+ * Default implementation of EntityFacade
+ */
+export class DefaultEntityFacade {
+    registry;
+    store;
+    connectors;
+    entityLifecycle;
+    constructor(registry, store, connectors, entityLifecycle) {
+        this.registry = registry;
+        this.store = store;
+        this.connectors = connectors;
+        this.entityLifecycle = entityLifecycle;
+    }
+    registerEntity(definition, connectorName) {
+        // Register the entity definition
+        this.registry.register(definition);
+        // Bind entity type to connector
+        this.connectors.bind(definition.id, connectorName);
+    }
+    async resolveBinding(entityType, query) {
+        return this.store.query(entityType, query ?? {});
+    }
+    async resolveAggregate(entityType, aggregate) {
+        if (typeof this.store.aggregate === 'function')
+            return this.store.aggregate(entityType, aggregate);
+        // A host store without `aggregate`: list through `query`, reduce here.
+        const store = this.store;
+        const result = await aggregateThrough({ query: async (t, q) => ({ success: true, result: await store.query(t, q) }) }, entityType, aggregate);
+        if (!result.success)
+            throw new Error(result.error);
+        return result.result;
+    }
+}
+// ============================================================
+// FACTORY FUNCTION
+// ============================================================
+/**
+ * Create an entity facade with all subsystems wired together
+ */
+export function createEntityFacade(options) {
+    const registry = options?.registry ?? createEntityRegistry();
+    const connectors = options?.connectors ?? createConnectorRegistry();
+    const entityLifecycle = options?.entityLifecycle ?? createEntityLifecycleEngine();
+    const store = createEntityStore(registry, connectors);
+    return new DefaultEntityFacade(registry, store, connectors, entityLifecycle);
+}
+//# sourceMappingURL=facade.js.map

package/dist/entity/facade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"facade.js","sourceRoot":"","sources":["../../src/entity/facade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAeH,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AACxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAA;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AA0CjD,+DAA+D;AAC/D,wBAAwB;AACxB,+DAA+D;AAE/D;;GAEG;AACH,MAAM,OAAO,mBAAmB;IACrB,QAAQ,CAAgB;IACxB,KAAK,CAAa;IAClB,UAAU,CAAmB;IAC7B,eAAe,CAAuB;IAE/C,YACE,QAAwB,EACxB,KAAkB,EAClB,UAA6B,EAC7B,eAAsC;QAEtC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;QAC5B,IAAI,CAAC,eAAe,GAAG,eAAe,CAAA;IACxC,CAAC;IAED,cAAc,CAAC,UAA4B,EAAE,aAAqB;QAChE,iCAAiC;QACjC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;QAElC,gCAAgC;QAChC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,aAAa,CAAC,CAAA;IACpD,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,UAAwB,EAAE,KAAmB;QAChE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,CAAA;IAClD,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,UAAwB,EAAE,SAA0B;QACzE,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,KAAK,UAAU;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,CAAA;QAClG,uEAAuE;QACvE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;QACxB,MAAM,MAAM,GAAG,MAAM,gBAAgB,CACnC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAC/E,UAAU,EACV,SAAS,CACV,CAAA;QACD,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAClD,OAAO,MAAM,CAAC,MAAM,CAAA;IACtB,CAAC;CACF;AAED,+DAA+D;AAC/D,mBAAmB;AACnB,+DAA+D;AAE/D;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAKlC;IACC,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,oBAAoB,EAAE,CAAA;IAC5D,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,uBAAuB,EAAE,CAAA;IACnE,MAAM,eAAe,GACnB,OAAO,EAAE,eAAe,IAAI,2BAA2B,EAAE,CAAA;IAC3D,MAAM,KAAK,GAAG,iBAAiB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;IAErD,OAAO,IAAI,mBAAmB,CAAC,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,eAAe,CAAC,CAAA;AAC9E,CAAC","sourcesContent":["/**\n * Entity Facade\n *\n * Facade that combines Registry, Store, ConnectorRegistry, and\n * EntityLifecycleEngine into a single facade for surface integration.\n *\n * Renamed from EntityCapability to EntityFacade to avoid collision\n * with the canonical Platform Capability interface.\n *\n * de-behaviorization: `behaviors` field renamed to `entityLifecycle`.\n * `behaviors` kept as deprecated accessor for one minor version.\n *\n * @module @pwfabric/runtime/entity/facade\n */\n\nimport type {\n  EntityTypeId,\n  EntityDefinition,\n  EntityQuery,\n  EntityQueryResult,\n  EntityAggregate,\n  EntityAggregateResult,\n} from './types.js'\nimport type { EntityRegistry } from './registry.js'\nimport type { EntityStore } from './store.js'\nimport type { ConnectorRegistry } from './connector.js'\nimport type { EntityLifecycleEngine } from './behavior.js'\n\nimport { createEntityRegistry } from './registry.js'\nimport { createEntityStore } from './store.js'\nimport { createConnectorRegistry } from './connector.js'\nimport { createEntityLifecycleEngine } from './behavior.js'\nimport { aggregateThrough } from './aggregate.js'\n\n// ============================================================\n// ENTITY FACADE INTERFACE\n// ============================================================\n\n/**\n * Facade that provides unified access to the entity system\n */\nexport interface EntityFacade {\n  /** Entity type registry */\n  readonly registry: EntityRegistry\n\n  /** Entity CRUD store */\n  readonly store: EntityStore\n\n  /** Connector registry for data source binding */\n  readonly connectors: ConnectorRegistry\n\n  /** Entity lifecycle engine for hook registration and execution (onCreate/onUpdate/onDelete/onRead) */\n  readonly entityLifecycle: EntityLifecycleEngine\n\n  /**\n   * Convenience method to register an entity definition and bind it to a connector\n   */\n  registerEntity(definition: EntityDefinition, connectorName: string): void\n\n  /**\n   * Resolve a binding for Surface expression resolution.\n   * Queries the entity store for the given entity type and query.\n   */\n  resolveBinding(entityType: EntityTypeId, query?: EntityQuery): Promise<EntityQueryResult>\n\n  /**\n   * Resolve an AGGREGATE source: one number over the collection.\n   * Rejects when the number cannot be served (never answers a false 0).\n   * OPTIONAL so a host facade built before this still type-checks; the\n   * renderer lists and reduces in memory when it is absent.\n   */\n  resolveAggregate?(entityType: EntityTypeId, aggregate: EntityAggregate): Promise<EntityAggregateResult>\n}\n\n// ============================================================\n// DEFAULT ENTITY FACADE\n// ============================================================\n\n/**\n * Default implementation of EntityFacade\n */\nexport class DefaultEntityFacade implements EntityFacade {\n  readonly registry: EntityRegistry\n  readonly store: EntityStore\n  readonly connectors: ConnectorRegistry\n  readonly entityLifecycle: EntityLifecycleEngine\n\n  constructor(\n    registry: EntityRegistry,\n    store: EntityStore,\n    connectors: ConnectorRegistry,\n    entityLifecycle: EntityLifecycleEngine\n  ) {\n    this.registry = registry\n    this.store = store\n    this.connectors = connectors\n    this.entityLifecycle = entityLifecycle\n  }\n\n  registerEntity(definition: EntityDefinition, connectorName: string): void {\n    // Register the entity definition\n    this.registry.register(definition)\n\n    // Bind entity type to connector\n    this.connectors.bind(definition.id, connectorName)\n  }\n\n  async resolveBinding(entityType: EntityTypeId, query?: EntityQuery): Promise<EntityQueryResult> {\n    return this.store.query(entityType, query ?? {})\n  }\n\n  async resolveAggregate(entityType: EntityTypeId, aggregate: EntityAggregate): Promise<EntityAggregateResult> {\n    if (typeof this.store.aggregate === 'function') return this.store.aggregate(entityType, aggregate)\n    // A host store without `aggregate`: list through `query`, reduce here.\n    const store = this.store\n    const result = await aggregateThrough(\n      { query: async (t, q) => ({ success: true, result: await store.query(t, q) }) },\n      entityType,\n      aggregate\n    )\n    if (!result.success) throw new Error(result.error)\n    return result.result\n  }\n}\n\n// ============================================================\n// FACTORY FUNCTION\n// ============================================================\n\n/**\n * Create an entity facade with all subsystems wired together\n */\nexport function createEntityFacade(options?: {\n  registry?: EntityRegistry\n  connectors?: ConnectorRegistry\n  /** Primary option — entity lifecycle engine for hook registration */\n  entityLifecycle?: EntityLifecycleEngine\n}): EntityFacade {\n  const registry = options?.registry ?? createEntityRegistry()\n  const connectors = options?.connectors ?? createConnectorRegistry()\n  const entityLifecycle =\n    options?.entityLifecycle ?? createEntityLifecycleEngine()\n  const store = createEntityStore(registry, connectors)\n\n  return new DefaultEntityFacade(registry, store, connectors, entityLifecycle)\n}\n"]}

package/dist/entity/http-connector.d.ts

@@ -0,0 +1,123 @@
+/**
+ * HTTP Entity Connector
+ *
+ * REST API connector for entity data persistence and retrieval.
+ * Implements the EntityConnector interface using fetch for HTTP communication.
+ *
+ * @module @pwfabric/runtime/entity/http-connector
+ */
+import type { EntityTypeId, EntityInstanceId, EntityQuery, EntityAggregate } from './types.js';
+import type { EntityConnector, EntityConnectorType, ConnectorResult, ConnectorQueryResult, ConnectorAggregateResult } from './connector.js';
+/**
+ * HTTP connector authentication configuration
+ */
+export interface HttpAuthConfig {
+    readonly type: 'bearer' | 'api-key' | 'basic';
+    /**
+     * A fixed value, or a RESOLVER re-invoked on every request.
+     *
+     * A string or a resolver. A delegated PKCE token expires within about an
+     * hour, so a fixed string cannot serve a session; an engine that needs a
+     * live token passes a resolver instead of reimplementing the transport
+     * (and losing retry, timeout and the result envelope on the way).
+     *
+     * A string is used as is; a resolver is awaited per request and its answer
+     * is never cached here, which is the whole point.
+     */
+    readonly token?: string | (() => Promise<string | null>);
+    readonly apiKey?: string;
+    readonly headerName?: string;
+    readonly username?: string;
+    readonly password?: string;
+}
+/**
+ * HTTP connector retry configuration
+ */
+export interface HttpRetryConfig {
+    readonly maxRetries: number;
+    readonly baseDelay: number;
+    readonly maxDelay: number;
+    readonly retryableStatuses: readonly number[];
+}
+/**
+ * HTTP connector configuration
+ */
+export interface HttpConnectorConfig {
+    readonly baseUrl: string;
+    readonly headers?: Record<string, string>;
+    readonly timeout?: number;
+    readonly auth?: HttpAuthConfig;
+    /**
+     * Fetch credentials mode. Set 'include' so cookie-authoritative APIs
+     * receive the session cookie on cross-origin entity requests
+     * the visitor facade has no bearer token to send.
+     */
+    readonly credentials?: RequestCredentials;
+    readonly retry?: HttpRetryConfig;
+    /**
+     * Query parameters this API requires on every read.
+     *
+     * GENERIC, and the distinction matters because three vendor-shaped widenings
+     * were proposed and reverted the same day. Azure wants `api-version`, plenty
+     * of APIs want `format=json`, Graph wants `expand=fields`: "this endpoint
+     * takes constant parameters" is a REST fact, not one provider's dance, and no
+     * provider name appears here.
+     *
+     * It exists because the alternative is worse. A caller that put its constants
+     * in `entityPathMapper` would produce `...?expand=fields?limit=50` the moment
+     * a query carried pagination, and `...?expand=fields/1` on a delete — the URL
+     * is assembled as `params ? url + '?' + params : url`.
+     */
+    readonly defaultQueryParams?: Readonly<Record<string, string>>;
+    readonly entityPathMapper?: (entityType: EntityTypeId) => string;
+    /**
+     * Maps a vendor response body to the connector's query result shape
+     * `entityPathMapper`'s response-side twin.
+     *
+     * `entityPathMapper` has always let a caller say how an entity type becomes a
+     * URL path; nothing let it say how the answer comes back. So a vendor whose
+     * body is its own shape — Graph replies `{ value: [{ id, fields }] }`, not
+     * `{ items }` — could not use this class at all, and that was the other half
+     * of why every Graph engine forked. Absent, the built-in shapes below apply
+     * unchanged.
+     */
+    readonly responseMapper?: (raw: unknown) => {
+        items: unknown[];
+        total?: number;
+    };
+}
+/**
+ * HTTP/REST connector for entity data operations.
+ * Maps entity CRUD operations to standard REST API endpoints.
+ */
+export declare class HttpEntityConnector implements EntityConnector {
+    readonly name: string;
+    readonly type: EntityConnectorType;
+    private readonly config;
+    constructor(name: string, config: HttpConnectorConfig);
+    create(entityType: EntityTypeId, data: Record<string, unknown>): Promise<ConnectorResult>;
+    read(entityType: EntityTypeId, instanceId: EntityInstanceId): Promise<ConnectorResult>;
+    update(entityType: EntityTypeId, instanceId: EntityInstanceId, data: Record<string, unknown>): Promise<ConnectorResult>;
+    delete(entityType: EntityTypeId, instanceId: EntityInstanceId): Promise<ConnectorResult>;
+    query(entityType: EntityTypeId, query: EntityQuery): Promise<ConnectorQueryResult>;
+    /**
+     * One number over the collection, computed by the server.
+     *
+     * `GET <base>/<type>/count[?filter=]` for a plain count and
+     * `GET <base>/<type>/aggregate?fn=&field=&filter=` for the rest — the two
+     * routes a host registers ahead of the read-one route.
+     * Constants (`defaultQueryParams`) and `entityPathMapper` apply as on
+     * every other read.
+     */
+    aggregate(entityType: EntityTypeId, aggregate: EntityAggregate): Promise<ConnectorAggregateResult>;
+    private buildUrl;
+    private buildQueryParams;
+    private buildHeaders;
+    private resolveAuthHeader;
+    private request;
+    private sleep;
+}
+/**
+ * Create an HTTP entity connector
+ */
+export declare function createHttpConnector(name: string, config: HttpConnectorConfig): HttpEntityConnector;