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

package/dist/entity/postgres-connector.js

@@ -0,0 +1,239 @@
+/**
+ * PostgreSQL Entity Connector
+ *
+ * Database connector for entity data persistence using Drizzle ORM.
+ * Implements the EntityConnector interface with PostgreSQL-specific query building.
+ *
+ * @module @pwfabric/runtime/entity/postgres-connector
+ */
+// ============================================================
+// SQL BUILDER HELPERS
+// ============================================================
+function escapeIdentifier(name) {
+    return `"${name.replace(/"/g, '""')}"`;
+}
+function buildFilterClause(filter, params, offset) {
+    const parts = [];
+    let currentOffset = offset;
+    if (filter.field && filter.operator) {
+        const col = escapeIdentifier(filter.field);
+        const paramIndex = currentOffset + 1;
+        currentOffset++;
+        switch (filter.operator) {
+            case 'eq':
+                parts.push(`${col} = $${paramIndex}`);
+                params.push(filter.value);
+                break;
+            case 'neq':
+                parts.push(`${col} != $${paramIndex}`);
+                params.push(filter.value);
+                break;
+            case 'gt':
+                parts.push(`${col} > $${paramIndex}`);
+                params.push(filter.value);
+                break;
+            case 'gte':
+                parts.push(`${col} >= $${paramIndex}`);
+                params.push(filter.value);
+                break;
+            case 'lt':
+                parts.push(`${col} < $${paramIndex}`);
+                params.push(filter.value);
+                break;
+            case 'lte':
+                parts.push(`${col} <= $${paramIndex}`);
+                params.push(filter.value);
+                break;
+            case 'in':
+                parts.push(`${col} = ANY($${paramIndex})`);
+                params.push(filter.value);
+                break;
+            case 'contains':
+                parts.push(`${col} ILIKE $${paramIndex}`);
+                params.push(`%${filter.value}%`);
+                break;
+            case 'startsWith':
+                parts.push(`${col} ILIKE $${paramIndex}`);
+                params.push(`${filter.value}%`);
+                break;
+        }
+    }
+    if (filter.and && filter.and.length > 0) {
+        for (const sub of filter.and) {
+            const result = buildFilterClause(sub, params, currentOffset);
+            parts.push(result.sql);
+            currentOffset = result.nextOffset;
+        }
+    }
+    if (filter.or && filter.or.length > 0) {
+        const orParts = [];
+        for (const sub of filter.or) {
+            const result = buildFilterClause(sub, params, currentOffset);
+            orParts.push(result.sql);
+            currentOffset = result.nextOffset;
+        }
+        if (orParts.length > 0) {
+            parts.push(`(${orParts.join(' OR ')})`);
+        }
+    }
+    return {
+        sql: parts.length > 0 ? parts.join(' AND ') : '1=1',
+        nextOffset: currentOffset,
+    };
+}
+function buildOrderClause(sort) {
+    if (sort.length === 0)
+        return '';
+    const parts = sort.map((s) => `${escapeIdentifier(s.field)} ${s.direction === 'desc' ? 'DESC' : 'ASC'}`);
+    return ` ORDER BY ${parts.join(', ')}`;
+}
+// ============================================================
+// POSTGRES ENTITY CONNECTOR
+// ============================================================
+/**
+ * PostgreSQL connector for entity data operations.
+ * Maps entity CRUD operations to SQL queries via a DatabaseAdapter.
+ */
+export class PostgresEntityConnector {
+    name;
+    type = 'database';
+    db;
+    tablePrefix;
+    defaultPageSize;
+    maxPageSize;
+    constructor(name, config) {
+        this.name = name;
+        this.tablePrefix = config.tablePrefix ?? '';
+        this.defaultPageSize = config.defaultPageSize ?? 50;
+        this.maxPageSize = config.maxPageSize ?? 1000;
+        if (typeof config.connection === 'string') {
+            throw new Error('String connection not yet supported. Pass a DatabaseAdapter instance. ' +
+                'Use createDatabaseAdapter() from your Drizzle setup.');
+        }
+        this.db = config.connection;
+    }
+    tableName(entityType) {
+        return escapeIdentifier(`${this.tablePrefix}${entityType}`);
+    }
+    async create(entityType, data) {
+        try {
+            const table = this.tableName(entityType);
+            const keys = Object.keys(data);
+            const cols = keys.map(escapeIdentifier).join(', ');
+            const placeholders = keys.map((_, i) => `$${i + 1}`).join(', ');
+            const values = keys.map((k) => data[k]);
+            const sql = `INSERT INTO ${table} (${cols}) VALUES (${placeholders}) RETURNING *`;
+            const result = await this.db.execute(sql, values);
+            if (result.rows.length === 0) {
+                return { success: false, error: 'Insert returned no rows' };
+            }
+            return { success: true, data: result.rows[0] ?? {} };
+        }
+        catch (err) {
+            return { success: false, error: err instanceof Error ? err.message : String(err) };
+        }
+    }
+    async read(entityType, instanceId) {
+        try {
+            const table = this.tableName(entityType);
+            const sql = `SELECT * FROM ${table} WHERE "id" = $1 LIMIT 1`;
+            const result = await this.db.execute(sql, [instanceId]);
+            if (result.rows.length === 0) {
+                return { success: false, error: `Entity ${entityType}/${instanceId} not found` };
+            }
+            return { success: true, data: result.rows[0] ?? {} };
+        }
+        catch (err) {
+            return { success: false, error: err instanceof Error ? err.message : String(err) };
+        }
+    }
+    async update(entityType, instanceId, data) {
+        try {
+            const table = this.tableName(entityType);
+            const keys = Object.keys(data);
+            if (keys.length === 0) {
+                return this.read(entityType, instanceId);
+            }
+            const setClauses = keys.map((key, i) => `${escapeIdentifier(key)} = $${i + 1}`);
+            const values = [...keys.map((k) => data[k]), instanceId];
+            const sql = `UPDATE ${table} SET ${setClauses.join(', ')} WHERE "id" = $${keys.length + 1} RETURNING *`;
+            const result = await this.db.execute(sql, values);
+            if (result.rows.length === 0) {
+                return { success: false, error: `Entity ${entityType}/${instanceId} not found` };
+            }
+            return { success: true, data: result.rows[0] ?? {} };
+        }
+        catch (err) {
+            return { success: false, error: err instanceof Error ? err.message : String(err) };
+        }
+    }
+    async delete(entityType, instanceId) {
+        try {
+            const table = this.tableName(entityType);
+            const sql = `DELETE FROM ${table} WHERE "id" = $1 RETURNING *`;
+            const result = await this.db.execute(sql, [instanceId]);
+            if (result.rows.length === 0) {
+                return { success: false, error: `Entity ${entityType}/${instanceId} not found` };
+            }
+            return { success: true, data: result.rows[0] ?? {} };
+        }
+        catch (err) {
+            return { success: false, error: err instanceof Error ? err.message : String(err) };
+        }
+    }
+    async query(entityType, query) {
+        try {
+            const table = this.tableName(entityType);
+            const params = [];
+            let paramOffset = 0;
+            // WHERE clause
+            let whereClause = '';
+            if (query.filter) {
+                const filterResult = buildFilterClause(query.filter, params, paramOffset);
+                whereClause = ` WHERE ${filterResult.sql}`;
+                paramOffset = filterResult.nextOffset;
+            }
+            // COUNT query
+            const countSql = `SELECT COUNT(*) as count FROM ${table}${whereClause}`;
+            const countResult = await this.db.execute(countSql, [...params]);
+            const total = Number(countResult.rows[0]?.count ?? 0);
+            // ORDER clause
+            const orderClause = query.sort ? buildOrderClause(query.sort) : '';
+            // PAGINATION
+            const limit = Math.min(query.pagination?.limit ?? this.defaultPageSize, this.maxPageSize);
+            const offset = query.pagination?.offset ?? 0;
+            paramOffset++;
+            const limitParam = `$${paramOffset}`;
+            params.push(limit);
+            paramOffset++;
+            const offsetParam = `$${paramOffset}`;
+            params.push(offset);
+            // DATA query
+            const dataSql = `SELECT * FROM ${table}${whereClause}${orderClause} LIMIT ${limitParam} OFFSET ${offsetParam}`;
+            const dataResult = await this.db.execute(dataSql, params);
+            return {
+                success: true,
+                result: {
+                    items: dataResult.rows,
+                    total,
+                    offset,
+                    limit,
+                    hasMore: total > offset + dataResult.rows.length,
+                },
+            };
+        }
+        catch (err) {
+            return { success: false, error: err instanceof Error ? err.message : String(err) };
+        }
+    }
+}
+// ============================================================
+// FACTORY
+// ============================================================
+/**
+ * Create a PostgreSQL entity connector
+ */
+export function createPostgresConnector(name, config) {
+    return new PostgresEntityConnector(name, config);
+}
+//# sourceMappingURL=postgres-connector.js.map

package/dist/entity/postgres-connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-connector.js","sourceRoot":"","sources":["../../src/entity/postgres-connector.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * PostgreSQL Entity Connector\n *\n * Database connector for entity data persistence using Drizzle ORM.\n * Implements the EntityConnector interface with PostgreSQL-specific query building.\n *\n * @module @pwfabric/runtime/entity/postgres-connector\n */\n\nimport type {\n  EntityTypeId,\n  EntityInstanceId,\n  EntityQuery,\n  EntityFilter,\n  EntitySortField,\n} from './types.js'\nimport type {\n  EntityConnector,\n  EntityConnectorType,\n  ConnectorResult,\n  ConnectorQueryResult,\n} from './connector.js'\n\n// ============================================================\n// CONFIGURATION\n// ============================================================\n\n/**\n * PostgreSQL connector configuration\n */\nexport interface PostgresConnectorConfig {\n  /**\n   * Database connection — either a connection string or a Drizzle db instance.\n   * When a string, the connector will create its own connection.\n   * When an object, it must implement the DatabaseAdapter interface.\n   */\n  readonly connection: string | DatabaseAdapter\n\n  /** Optional table name prefix for multi-tenant isolation */\n  readonly tablePrefix?: string\n\n  /** Default page size for queries */\n  readonly defaultPageSize?: number\n\n  /** Maximum page size to prevent excessive queries */\n  readonly maxPageSize?: number\n}\n\n/**\n * Minimal database adapter interface.\n * This abstracts over Drizzle ORM or any SQL-capable client.\n */\nexport interface DatabaseAdapter {\n  execute(sql: string, params?: unknown[]): Promise<DatabaseResult>\n}\n\n/**\n * Result of a database query execution\n */\nexport interface DatabaseResult {\n  readonly rows: Record<string, unknown>[]\n  readonly rowCount: number\n}\n\n// ============================================================\n// SQL BUILDER HELPERS\n// ============================================================\n\nfunction escapeIdentifier(name: string): string {\n  return `\"${name.replace(/\"/g, '\"\"')}\"`\n}\n\nfunction buildFilterClause(\n  filter: EntityFilter,\n  params: unknown[],\n  offset: number\n): { sql: string; nextOffset: number } {\n  const parts: string[] = []\n  let currentOffset = offset\n\n  if (filter.field && filter.operator) {\n    const col = escapeIdentifier(filter.field)\n    const paramIndex = currentOffset + 1\n    currentOffset++\n\n    switch (filter.operator) {\n      case 'eq':\n        parts.push(`${col} = $${paramIndex}`)\n        params.push(filter.value)\n        break\n      case 'neq':\n        parts.push(`${col} != $${paramIndex}`)\n        params.push(filter.value)\n        break\n      case 'gt':\n        parts.push(`${col} > $${paramIndex}`)\n        params.push(filter.value)\n        break\n      case 'gte':\n        parts.push(`${col} >= $${paramIndex}`)\n        params.push(filter.value)\n        break\n      case 'lt':\n        parts.push(`${col} < $${paramIndex}`)\n        params.push(filter.value)\n        break\n      case 'lte':\n        parts.push(`${col} <= $${paramIndex}`)\n        params.push(filter.value)\n        break\n      case 'in':\n        parts.push(`${col} = ANY($${paramIndex})`)\n        params.push(filter.value)\n        break\n      case 'contains':\n        parts.push(`${col} ILIKE $${paramIndex}`)\n        params.push(`%${filter.value}%`)\n        break\n      case 'startsWith':\n        parts.push(`${col} ILIKE $${paramIndex}`)\n        params.push(`${filter.value}%`)\n        break\n    }\n  }\n\n  if (filter.and && filter.and.length > 0) {\n    for (const sub of filter.and) {\n      const result = buildFilterClause(sub, params, currentOffset)\n      parts.push(result.sql)\n      currentOffset = result.nextOffset\n    }\n  }\n\n  if (filter.or && filter.or.length > 0) {\n    const orParts: string[] = []\n    for (const sub of filter.or) {\n      const result = buildFilterClause(sub, params, currentOffset)\n      orParts.push(result.sql)\n      currentOffset = result.nextOffset\n    }\n    if (orParts.length > 0) {\n      parts.push(`(${orParts.join(' OR ')})`)\n    }\n  }\n\n  return {\n    sql: parts.length > 0 ? parts.join(' AND ') : '1=1',\n    nextOffset: currentOffset,\n  }\n}\n\nfunction buildOrderClause(sort: readonly EntitySortField[]): string {\n  if (sort.length === 0) return ''\n  const parts = sort.map(\n    (s) => `${escapeIdentifier(s.field)} ${s.direction === 'desc' ? 'DESC' : 'ASC'}`\n  )\n  return ` ORDER BY ${parts.join(', ')}`\n}\n\n// ============================================================\n// POSTGRES ENTITY CONNECTOR\n// ============================================================\n\n/**\n * PostgreSQL connector for entity data operations.\n * Maps entity CRUD operations to SQL queries via a DatabaseAdapter.\n */\nexport class PostgresEntityConnector implements EntityConnector {\n  readonly name: string\n  readonly type: EntityConnectorType = 'database'\n\n  private readonly db: DatabaseAdapter\n  private readonly tablePrefix: string\n  private readonly defaultPageSize: number\n  private readonly maxPageSize: number\n\n  constructor(name: string, config: PostgresConnectorConfig) {\n    this.name = name\n    this.tablePrefix = config.tablePrefix ?? ''\n    this.defaultPageSize = config.defaultPageSize ?? 50\n    this.maxPageSize = config.maxPageSize ?? 1000\n\n    if (typeof config.connection === 'string') {\n      throw new Error(\n        'String connection not yet supported. Pass a DatabaseAdapter instance. ' +\n          'Use createDatabaseAdapter() from your Drizzle setup.'\n      )\n    }\n\n    this.db = config.connection\n  }\n\n  private tableName(entityType: EntityTypeId): string {\n    return escapeIdentifier(`${this.tablePrefix}${entityType}`)\n  }\n\n  async create(entityType: EntityTypeId, data: Record<string, unknown>): Promise<ConnectorResult> {\n    try {\n      const table = this.tableName(entityType)\n      const keys = Object.keys(data)\n      const cols = keys.map(escapeIdentifier).join(', ')\n      const placeholders = keys.map((_, i) => `$${i + 1}`).join(', ')\n      const values = keys.map((k) => data[k])\n\n      const sql = `INSERT INTO ${table} (${cols}) VALUES (${placeholders}) RETURNING *`\n      const result = await this.db.execute(sql, values)\n\n      if (result.rows.length === 0) {\n        return { success: false, error: 'Insert returned no rows' }\n      }\n\n      return { success: true, data: result.rows[0] ?? {} }\n    } catch (err) {\n      return { success: false, error: err instanceof Error ? err.message : String(err) }\n    }\n  }\n\n  async read(entityType: EntityTypeId, instanceId: EntityInstanceId): Promise<ConnectorResult> {\n    try {\n      const table = this.tableName(entityType)\n      const sql = `SELECT * FROM ${table} WHERE \"id\" = $1 LIMIT 1`\n      const result = await this.db.execute(sql, [instanceId])\n\n      if (result.rows.length === 0) {\n        return { success: false, error: `Entity ${entityType}/${instanceId} not found` }\n      }\n\n      return { success: true, data: result.rows[0] ?? {} }\n    } catch (err) {\n      return { success: false, error: err instanceof Error ? err.message : String(err) }\n    }\n  }\n\n  async update(\n    entityType: EntityTypeId,\n    instanceId: EntityInstanceId,\n    data: Record<string, unknown>\n  ): Promise<ConnectorResult> {\n    try {\n      const table = this.tableName(entityType)\n      const keys = Object.keys(data)\n\n      if (keys.length === 0) {\n        return this.read(entityType, instanceId)\n      }\n\n      const setClauses = keys.map((key, i) => `${escapeIdentifier(key)} = $${i + 1}`)\n      const values = [...keys.map((k) => data[k]), instanceId]\n\n      const sql = `UPDATE ${table} SET ${setClauses.join(', ')} WHERE \"id\" = $${keys.length + 1} RETURNING *`\n      const result = await this.db.execute(sql, values)\n\n      if (result.rows.length === 0) {\n        return { success: false, error: `Entity ${entityType}/${instanceId} not found` }\n      }\n\n      return { success: true, data: result.rows[0] ?? {} }\n    } catch (err) {\n      return { success: false, error: err instanceof Error ? err.message : String(err) }\n    }\n  }\n\n  async delete(entityType: EntityTypeId, instanceId: EntityInstanceId): Promise<ConnectorResult> {\n    try {\n      const table = this.tableName(entityType)\n      const sql = `DELETE FROM ${table} WHERE \"id\" = $1 RETURNING *`\n      const result = await this.db.execute(sql, [instanceId])\n\n      if (result.rows.length === 0) {\n        return { success: false, error: `Entity ${entityType}/${instanceId} not found` }\n      }\n\n      return { success: true, data: result.rows[0] ?? {} }\n    } catch (err) {\n      return { success: false, error: err instanceof Error ? err.message : String(err) }\n    }\n  }\n\n  async query(entityType: EntityTypeId, query: EntityQuery): Promise<ConnectorQueryResult> {\n    try {\n      const table = this.tableName(entityType)\n      const params: unknown[] = []\n      let paramOffset = 0\n\n      // WHERE clause\n      let whereClause = ''\n      if (query.filter) {\n        const filterResult = buildFilterClause(query.filter, params, paramOffset)\n        whereClause = ` WHERE ${filterResult.sql}`\n        paramOffset = filterResult.nextOffset\n      }\n\n      // COUNT query\n      const countSql = `SELECT COUNT(*) as count FROM ${table}${whereClause}`\n      const countResult = await this.db.execute(countSql, [...params])\n      const total = Number(countResult.rows[0]?.count ?? 0)\n\n      // ORDER clause\n      const orderClause = query.sort ? buildOrderClause(query.sort) : ''\n\n      // PAGINATION\n      const limit = Math.min(query.pagination?.limit ?? this.defaultPageSize, this.maxPageSize)\n      const offset = query.pagination?.offset ?? 0\n      paramOffset++\n      const limitParam = `$${paramOffset}`\n      params.push(limit)\n      paramOffset++\n      const offsetParam = `$${paramOffset}`\n      params.push(offset)\n\n      // DATA query\n      const dataSql = `SELECT * FROM ${table}${whereClause}${orderClause} LIMIT ${limitParam} OFFSET ${offsetParam}`\n      const dataResult = await this.db.execute(dataSql, params)\n\n      return {\n        success: true,\n        result: {\n          items: dataResult.rows,\n          total,\n          offset,\n          limit,\n          hasMore: total > offset + dataResult.rows.length,\n        },\n      }\n    } catch (err) {\n      return { success: false, error: err instanceof Error ? err.message : String(err) }\n    }\n  }\n}\n\n// ============================================================\n// FACTORY\n// ============================================================\n\n/**\n * Create a PostgreSQL entity connector\n */\nexport function createPostgresConnector(\n  name: string,\n  config: PostgresConnectorConfig\n): PostgresEntityConnector {\n  return new PostgresEntityConnector(name, config)\n}\n"]}

package/dist/entity/registry.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Entity Registry
+ *
+ * Registration and lookup of entity definitions with Zod-based validation.
+ *
+ * @module @pwfabric/runtime/entity/registry
+ */
+import type { EntityTypeId, EntityDefinition, EntityValidationResult } from './types.js';
+/**
+ * Registry for entity type definitions
+ */
+export interface EntityRegistry {
+    /**
+     * Register an entity definition
+     * @throws Error if definition with the same id is already registered
+     */
+    register(definition: EntityDefinition): void;
+    /**
+     * Get an entity definition by id
+     */
+    get(id: EntityTypeId): EntityDefinition | undefined;
+    /**
+     * Check if an entity definition is registered
+     */
+    has(id: EntityTypeId): boolean;
+    /**
+     * List all registered entity type ids
+     */
+    list(): readonly EntityTypeId[];
+    /**
+     * Validate data against an entity definition's Zod schema
+     */
+    validate(id: EntityTypeId, data: unknown): EntityValidationResult;
+    /**
+     * Remove an entity definition
+     */
+    unregister(id: EntityTypeId): boolean;
+    /**
+     * Remove all entity definitions
+     */
+    clear(): void;
+}
+/**
+ * In-memory implementation of EntityRegistry
+ */
+export declare class InMemoryEntityRegistry implements EntityRegistry {
+    private readonly definitions;
+    register(definition: EntityDefinition): void;
+    get(id: EntityTypeId): EntityDefinition | undefined;
+    has(id: EntityTypeId): boolean;
+    list(): readonly EntityTypeId[];
+    validate(id: EntityTypeId, data: unknown): EntityValidationResult;
+    unregister(id: EntityTypeId): boolean;
+    clear(): void;
+}
+/**
+ * Create an entity registry
+ */
+export declare function createEntityRegistry(): EntityRegistry;

package/dist/entity/registry.js

@@ -0,0 +1,90 @@
+/**
+ * Entity Registry
+ *
+ * Registration and lookup of entity definitions with Zod-based validation.
+ *
+ * @module @pwfabric/runtime/entity/registry
+ */
+// ============================================================
+// IN-MEMORY ENTITY REGISTRY
+// ============================================================
+/**
+ * In-memory implementation of EntityRegistry
+ */
+export class InMemoryEntityRegistry {
+    definitions = new Map();
+    register(definition) {
+        if (!definition.id) {
+            throw new Error('Entity definition must have an id');
+        }
+        if (!definition.name) {
+            throw new Error('Entity definition must have a name');
+        }
+        if (!definition.schema) {
+            throw new Error('Entity definition must have a schema');
+        }
+        if (!definition.primaryKey) {
+            throw new Error('Entity definition must have a primaryKey');
+        }
+        if (this.definitions.has(definition.id)) {
+            throw new Error(`Entity type '${definition.id}' is already registered`);
+        }
+        this.definitions.set(definition.id, definition);
+    }
+    get(id) {
+        return this.definitions.get(id);
+    }
+    has(id) {
+        return this.definitions.has(id);
+    }
+    list() {
+        return Array.from(this.definitions.keys());
+    }
+    validate(id, data) {
+        const definition = this.definitions.get(id);
+        if (!definition) {
+            return {
+                valid: false,
+                errors: [
+                    {
+                        field: '_entity',
+                        message: `Entity type '${id}' is not registered`,
+                        code: 'entity_not_found',
+                    },
+                ],
+            };
+        }
+        const result = definition.schema.safeParse(data);
+        if (result.success) {
+            return {
+                valid: true,
+                data: result.data,
+            };
+        }
+        const errors = result.error.issues.map((issue) => ({
+            field: issue.path.join('.') || '_root',
+            message: issue.message,
+            code: issue.code,
+        }));
+        return {
+            valid: false,
+            errors,
+        };
+    }
+    unregister(id) {
+        return this.definitions.delete(id);
+    }
+    clear() {
+        this.definitions.clear();
+    }
+}
+// ============================================================
+// FACTORY FUNCTION
+// ============================================================
+/**
+ * Create an entity registry
+ */
+export function createEntityRegistry() {
+    return new InMemoryEntityRegistry();
+}
+//# sourceMappingURL=registry.js.map

package/dist/entity/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/entity/registry.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Entity Registry\n *\n * Registration and lookup of entity definitions with Zod-based validation.\n *\n * @module @pwfabric/runtime/entity/registry\n */\n\nimport type {\n  EntityTypeId,\n  EntityDefinition,\n  EntityValidationResult,\n  EntityValidationError,\n} from './types.js'\n\n// ============================================================\n// ENTITY REGISTRY INTERFACE\n// ============================================================\n\n/**\n * Registry for entity type definitions\n */\nexport interface EntityRegistry {\n  /**\n   * Register an entity definition\n   * @throws Error if definition with the same id is already registered\n   */\n  register(definition: EntityDefinition): void\n\n  /**\n   * Get an entity definition by id\n   */\n  get(id: EntityTypeId): EntityDefinition | undefined\n\n  /**\n   * Check if an entity definition is registered\n   */\n  has(id: EntityTypeId): boolean\n\n  /**\n   * List all registered entity type ids\n   */\n  list(): readonly EntityTypeId[]\n\n  /**\n   * Validate data against an entity definition's Zod schema\n   */\n  validate(id: EntityTypeId, data: unknown): EntityValidationResult\n\n  /**\n   * Remove an entity definition\n   */\n  unregister(id: EntityTypeId): boolean\n\n  /**\n   * Remove all entity definitions\n   */\n  clear(): void\n}\n\n// ============================================================\n// IN-MEMORY ENTITY REGISTRY\n// ============================================================\n\n/**\n * In-memory implementation of EntityRegistry\n */\nexport class InMemoryEntityRegistry implements EntityRegistry {\n  private readonly definitions = new Map<EntityTypeId, EntityDefinition>()\n\n  register(definition: EntityDefinition): void {\n    if (!definition.id) {\n      throw new Error('Entity definition must have an id')\n    }\n\n    if (!definition.name) {\n      throw new Error('Entity definition must have a name')\n    }\n\n    if (!definition.schema) {\n      throw new Error('Entity definition must have a schema')\n    }\n\n    if (!definition.primaryKey) {\n      throw new Error('Entity definition must have a primaryKey')\n    }\n\n    if (this.definitions.has(definition.id)) {\n      throw new Error(`Entity type '${definition.id}' is already registered`)\n    }\n\n    this.definitions.set(definition.id, definition)\n  }\n\n  get(id: EntityTypeId): EntityDefinition | undefined {\n    return this.definitions.get(id)\n  }\n\n  has(id: EntityTypeId): boolean {\n    return this.definitions.has(id)\n  }\n\n  list(): readonly EntityTypeId[] {\n    return Array.from(this.definitions.keys())\n  }\n\n  validate(id: EntityTypeId, data: unknown): EntityValidationResult {\n    const definition = this.definitions.get(id)\n    if (!definition) {\n      return {\n        valid: false,\n        errors: [\n          {\n            field: '_entity',\n            message: `Entity type '${id}' is not registered`,\n            code: 'entity_not_found',\n          },\n        ],\n      }\n    }\n\n    const result = definition.schema.safeParse(data)\n\n    if (result.success) {\n      return {\n        valid: true,\n        data: result.data as Record<string, unknown>,\n      }\n    }\n\n    const errors: EntityValidationError[] = result.error.issues.map((issue) => ({\n      field: issue.path.join('.') || '_root',\n      message: issue.message,\n      code: issue.code,\n    }))\n\n    return {\n      valid: false,\n      errors,\n    }\n  }\n\n  unregister(id: EntityTypeId): boolean {\n    return this.definitions.delete(id)\n  }\n\n  clear(): void {\n    this.definitions.clear()\n  }\n}\n\n// ============================================================\n// FACTORY FUNCTION\n// ============================================================\n\n/**\n * Create an entity registry\n */\nexport function createEntityRegistry(): EntityRegistry {\n  return new InMemoryEntityRegistry()\n}\n"]}

package/dist/entity/store.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Entity Store
+ *
+ * Uniform CRUD and query interface backed by connectors.
+ * The store handles validation and delegates persistence to connectors.
+ *
+ * @module @pwfabric/runtime/entity/store
+ */
+import type { EntityTypeId, EntityInstanceId, EntityQuery, EntityQueryResult, EntityMutationResult, EntityReadResult, EntityAggregate, EntityAggregateResult } from './types.js';
+import type { EntityRegistry } from './registry.js';
+import type { ConnectorRegistry } from './connector.js';
+import type { SurfaceEventBus } from '@pwfabric/contracts';
+/**
+ * Entity store interface for CRUD operations
+ */
+export interface EntityStore {
+    /**
+     * Create a new entity instance
+     */
+    create(entityType: EntityTypeId, data: Record<string, unknown>): Promise<EntityMutationResult>;
+    /**
+     * Read a single entity instance
+     */
+    read(entityType: EntityTypeId, instanceId: EntityInstanceId): Promise<EntityReadResult>;
+    /**
+     * Update an existing entity instance
+     */
+    update(entityType: EntityTypeId, instanceId: EntityInstanceId, data: Record<string, unknown>): Promise<EntityMutationResult>;
+    /**
+     * Delete an entity instance
+     */
+    delete(entityType: EntityTypeId, instanceId: EntityInstanceId): Promise<EntityMutationResult>;
+    /**
+     * Query entity instances
+     */
+    query(entityType: EntityTypeId, query: EntityQuery): Promise<EntityQueryResult>;
+    /**
+     * One number over the collection. Server-side when the connector
+     * can; otherwise the connector's rows are reduced in memory. REJECTS when
+     * the number cannot be served — unlike `query`, whose honest failure is an
+     * empty list, a counter's `0` would be a lie.
+     *
+     * OPTIONAL so a host-written `EntityStore` keeps compiling; the facade
+     * lists and reduces through `query` when a store has none.
+     */
+    aggregate?(entityType: EntityTypeId, aggregate: EntityAggregate): Promise<EntityAggregateResult>;
+}
+export declare class DefaultEntityStore implements EntityStore {
+    private readonly registry;
+    private readonly connectors;
+    private readonly eventBus;
+    constructor(registry: EntityRegistry, connectors: ConnectorRegistry, eventBus?: SurfaceEventBus);
+    create(entityType: EntityTypeId, data: Record<string, unknown>): Promise<EntityMutationResult>;
+    read(entityType: EntityTypeId, instanceId: EntityInstanceId): Promise<EntityReadResult>;
+    update(entityType: EntityTypeId, instanceId: EntityInstanceId, data: Record<string, unknown>): Promise<EntityMutationResult>;
+    delete(entityType: EntityTypeId, instanceId: EntityInstanceId): Promise<EntityMutationResult>;
+    query(entityType: EntityTypeId, query: EntityQuery): Promise<EntityQueryResult>;
+    aggregate(entityType: EntityTypeId, aggregate: EntityAggregate): Promise<EntityAggregateResult>;
+}
+/**
+ * Create an entity store.
+ *
+ * Pass an optional `eventBus` to enable surface-scoped event
+ * emission on successful CRUD operations (entity:created, entity:updated, entity:deleted).
+ */
+export declare function createEntityStore(registry: EntityRegistry, connectors: ConnectorRegistry, eventBus?: SurfaceEventBus): EntityStore;