@open-mercato/shared 0.4.2-canary-c02407ff85

package/dist/lib/data/engine.js

@@ -0,0 +1,396 @@
+import { setRecordCustomFields } from "@open-mercato/core/modules/entities/lib/helpers";
+import { validateCustomFieldValuesServer } from "@open-mercato/core/modules/entities/lib/validation";
+import { CrudHttpError } from "../crud/errors.js";
+import { normalizeCustomFieldValues } from "../custom-fields/normalize.js";
+import { parseBooleanToken } from "../boolean.js";
+const COVERAGE_REFRESH_INTERVAL_MS = 5 * 60 * 1e3;
+const coverageRefreshTracker = /* @__PURE__ */ new Map();
+function shouldTriggerCoverageRefresh(entityType, tenantId) {
+  if (!entityType) return false;
+  const key = `${entityType}|${tenantId ?? "__null__"}`;
+  const now = Date.now();
+  const last = coverageRefreshTracker.get(key) ?? 0;
+  if (now - last < COVERAGE_REFRESH_INTERVAL_MS) return false;
+  coverageRefreshTracker.set(key, now);
+  return true;
+}
+class DefaultDataEngine {
+  constructor(em, container) {
+    this.em = em;
+    this.container = container;
+    this.pendingSideEffects = /* @__PURE__ */ new Map();
+  }
+  async setCustomFields(opts) {
+    const { entityId, recordId, organizationId = null, tenantId = null, values } = opts;
+    await this.validateCustomFieldValues(entityId, organizationId, tenantId, values);
+    let encryptionService = null;
+    try {
+      encryptionService = this.container.resolve("tenantEncryptionService");
+    } catch {
+      encryptionService = null;
+    }
+    await setRecordCustomFields(this.em, {
+      entityId,
+      recordId,
+      organizationId,
+      tenantId,
+      values,
+      encryptionService
+    });
+    if (opts.notify !== false) {
+      let bus = null;
+      try {
+        bus = this.container.resolve("eventBus");
+      } catch {
+        bus = null;
+      }
+      if (bus) {
+        const [mod, ent] = (entityId || "").split(":");
+        if (mod && ent) {
+          try {
+            await bus.emitEvent(`${mod}.${ent}.updated`, { id: recordId, organizationId, tenantId }, { persistent: true });
+          } catch {
+          }
+        }
+      }
+    }
+  }
+  normalizeDocValues(values) {
+    const out = {};
+    for (const [k, v] of Object.entries(values || {})) {
+      if (k === "id" || k === "entity_id" || k === "entityId") continue;
+      if (k.startsWith("cf_")) out[`cf:${k.slice(3)}`] = v;
+      else out[k] = v;
+    }
+    return out;
+  }
+  backcompatEavEnabled() {
+    try {
+      return parseBooleanToken(process.env.ENTITIES_BACKCOMPAT_EAV_FOR_CUSTOM ?? "") === true;
+    } catch {
+      return false;
+    }
+  }
+  async ensureStorageTableExists() {
+    const knex = this.em.getConnection().getKnex();
+    const exists = await knex("information_schema.tables").where({ table_name: "custom_entities_storage" }).first();
+    if (!exists) {
+      throw new Error("custom_entities_storage table is missing. Run migrations (yarn db:migrate).");
+    }
+  }
+  normalizeValuesForValidation(values) {
+    if (!values) return {};
+    const out = {};
+    for (const [key, value] of Object.entries(values)) {
+      if (value === void 0) continue;
+      if (key.startsWith("cf_") || key.startsWith("cf:")) {
+        const normalized = key.slice(3);
+        if (normalized) out[normalized] = value;
+        continue;
+      }
+      out[key] = value;
+    }
+    return out;
+  }
+  async validateCustomFieldValues(entityId, organizationId, tenantId, values) {
+    const prepared = this.normalizeValuesForValidation(values);
+    if (!entityId || Object.keys(prepared).length === 0) return;
+    const result = await validateCustomFieldValuesServer(this.em, {
+      entityId,
+      organizationId,
+      tenantId,
+      values: prepared
+    });
+    if (!result.ok) {
+      throw new CrudHttpError(400, { error: "Validation failed", fields: result.fieldErrors });
+    }
+  }
+  async createCustomEntityRecord(opts) {
+    const knex = this.em.getConnection().getKnex();
+    await this.ensureStorageTableExists();
+    await this.validateCustomFieldValues(opts.entityId, opts.organizationId ?? null, opts.tenantId ?? null, opts.values);
+    const rawId = String(opts.recordId ?? "").trim();
+    const isUuid = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(rawId);
+    const sentinel = rawId.toLowerCase();
+    const shouldGenerate = !rawId || !isUuid || sentinel === "create" || sentinel === "new" || sentinel === "null" || sentinel === "undefined";
+    const id = shouldGenerate ? (() => {
+      const g = globalThis;
+      if (g.crypto?.randomUUID) return g.crypto.randomUUID();
+      return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+        const r = Math.random() * 16 | 0;
+        const v = c === "x" ? r : r & 3 | 8;
+        return v.toString(16);
+      });
+    })() : rawId;
+    const orgId = opts.organizationId ?? null;
+    const tenantId = opts.tenantId ?? null;
+    const doc = { id, ...this.normalizeDocValues(opts.values || {}) };
+    const payload = {
+      entity_type: opts.entityId,
+      entity_id: id,
+      organization_id: orgId,
+      tenant_id: tenantId,
+      doc,
+      updated_at: knex.fn.now(),
+      created_at: knex.fn.now(),
+      deleted_at: null
+    };
+    try {
+      await knex("custom_entities_storage").insert(payload).onConflict(["entity_type", "entity_id", "organization_id"]).merge({ doc: payload.doc, updated_at: knex.fn.now(), deleted_at: null });
+    } catch {
+      try {
+        const updated = await knex("custom_entities_storage").where({ entity_type: opts.entityId, entity_id: id, organization_id: orgId }).update({ doc: payload.doc, updated_at: knex.fn.now(), deleted_at: null });
+        if (!updated) {
+          await knex("custom_entities_storage").insert(payload);
+        }
+      } catch (err) {
+        throw err;
+      }
+    }
+    if (this.backcompatEavEnabled() && opts.values && Object.keys(opts.values).length > 0) {
+      await this.setCustomFields({
+        entityId: opts.entityId,
+        recordId: id,
+        organizationId: orgId,
+        tenantId,
+        values: normalizeCustomFieldValues(opts.values),
+        notify: opts.notify
+        // defaults to true
+      });
+    }
+    return { id };
+  }
+  async updateCustomEntityRecord(opts) {
+    const knex = this.em.getConnection().getKnex();
+    await this.validateCustomFieldValues(opts.entityId, opts.organizationId ?? null, opts.tenantId ?? null, opts.values);
+    const id = String(opts.recordId);
+    const orgId = opts.organizationId ?? null;
+    const tenantId = opts.tenantId ?? null;
+    await this.ensureStorageTableExists();
+    const row = await knex("custom_entities_storage").where({ entity_type: opts.entityId, entity_id: id, organization_id: orgId }).first();
+    const prevDoc = row?.doc || { id };
+    const nextDoc = { ...prevDoc, ...this.normalizeDocValues(opts.values || {}), id };
+    try {
+      const updated = await knex("custom_entities_storage").where({ entity_type: opts.entityId, entity_id: id, organization_id: orgId }).update({ doc: nextDoc, updated_at: knex.fn.now(), deleted_at: null });
+      if (!updated) {
+        await knex("custom_entities_storage").insert({
+          entity_type: opts.entityId,
+          entity_id: id,
+          organization_id: orgId,
+          tenant_id: tenantId,
+          doc: nextDoc,
+          created_at: knex.fn.now(),
+          updated_at: knex.fn.now(),
+          deleted_at: null
+        });
+      }
+    } catch (err) {
+      throw err;
+    }
+    if (this.backcompatEavEnabled() && opts.values && Object.keys(opts.values).length > 0) {
+      await this.setCustomFields({
+        entityId: opts.entityId,
+        recordId: id,
+        organizationId: orgId,
+        tenantId,
+        values: normalizeCustomFieldValues(opts.values),
+        notify: opts.notify
+        // defaults to true
+      });
+    }
+  }
+  async deleteCustomEntityRecord(opts) {
+    const knex = this.em.getConnection().getKnex();
+    const id = String(opts.recordId);
+    const orgId = opts.organizationId ?? null;
+    const soft = opts.soft !== false;
+    if (soft) {
+      await knex("custom_entities_storage").where({ entity_type: opts.entityId, entity_id: id, organization_id: orgId }).update({ deleted_at: knex.fn.now(), updated_at: knex.fn.now() });
+    } else {
+      await knex("custom_entities_storage").where({ entity_type: opts.entityId, entity_id: id, organization_id: orgId }).delete();
+    }
+    try {
+      const { CustomFieldValue } = await import("@open-mercato/core/modules/entities/data/entities");
+      const values = await this.em.find(CustomFieldValue, {
+        entityId: opts.entityId,
+        recordId: id,
+        organizationId: orgId,
+        tenantId: opts.tenantId ?? null
+      });
+      const now = /* @__PURE__ */ new Date();
+      const mutated = values.filter((record) => {
+        if (record.deletedAt) return false;
+        record.deletedAt = now;
+        return true;
+      });
+      if (mutated.length) await this.em.persistAndFlush(values);
+    } catch {
+    }
+  }
+  async createOrmEntity(opts) {
+    const entity = this.em.create(
+      opts.entity,
+      opts.data
+    );
+    await this.em.persistAndFlush(entity);
+    return entity;
+  }
+  async updateOrmEntity(opts) {
+    const current = await this.em.findOne(opts.entity, opts.where);
+    if (!current) return null;
+    await opts.apply(current);
+    await this.em.persistAndFlush(current);
+    return current;
+  }
+  async deleteOrmEntity(opts) {
+    const current = await this.em.findOne(opts.entity, opts.where);
+    if (!current) return null;
+    if (opts.soft !== false) {
+      const field = opts.softDeleteField || "deletedAt";
+      if (typeof current === "object" && current !== null) {
+        ;
+        current[field] = /* @__PURE__ */ new Date();
+        await this.em.persistAndFlush(current);
+      }
+    } else {
+      await this.em.removeAndFlush(current);
+    }
+    return current;
+  }
+  async emitOrmEntityEvent(opts) {
+    const { action, entity, events, indexer, identifiers } = opts;
+    if (!events && !indexer) return;
+    if (!identifiers?.id) return;
+    let bus = null;
+    try {
+      bus = this.container.resolve("eventBus");
+    } catch {
+      bus = null;
+    }
+    if (!bus) return;
+    const ctx = {
+      action,
+      entity,
+      identifiers: {
+        id: identifiers.id,
+        organizationId: identifiers.organizationId ?? null,
+        tenantId: identifiers.tenantId ?? null
+      }
+    };
+    if (events) {
+      const eventName = `${events.module}.${events.entity}.${action}`;
+      const payload = events.buildPayload ? events.buildPayload(ctx) : {
+        id: ctx.identifiers.id,
+        organizationId: ctx.identifiers.organizationId,
+        tenantId: ctx.identifiers.tenantId
+      };
+      try {
+        await bus.emitEvent(eventName, payload, { persistent: !!events.persistent });
+      } catch {
+      }
+    }
+    if (indexer) {
+      const resolveCoverageBaseDelta = () => {
+        if (action === "created") return 1;
+        if (action === "deleted") return -1;
+        return void 0;
+      };
+      const coverageBaseDelta = resolveCoverageBaseDelta();
+      if (action === "deleted") {
+        const payload = indexer.buildDeletePayload ? indexer.buildDeletePayload(ctx) : {
+          entityType: indexer.entityType,
+          recordId: ctx.identifiers.id,
+          organizationId: ctx.identifiers.organizationId,
+          tenantId: ctx.identifiers.tenantId
+        };
+        const enrichedPayload = payload;
+        enrichedPayload.crudAction = action;
+        if (coverageBaseDelta !== void 0) enrichedPayload.coverageBaseDelta = coverageBaseDelta;
+        try {
+          await bus.emitEvent("query_index.delete_one", enrichedPayload);
+        } catch {
+        }
+      } else {
+        const payload = indexer.buildUpsertPayload ? indexer.buildUpsertPayload(ctx) : {
+          entityType: indexer.entityType,
+          recordId: ctx.identifiers.id,
+          organizationId: ctx.identifiers.organizationId,
+          tenantId: ctx.identifiers.tenantId
+        };
+        const enrichedPayload = payload;
+        enrichedPayload.crudAction = action;
+        if (coverageBaseDelta !== void 0) enrichedPayload.coverageBaseDelta = coverageBaseDelta;
+        try {
+          await bus.emitEvent("query_index.upsert_one", enrichedPayload);
+        } catch {
+        }
+      }
+      if (shouldTriggerCoverageRefresh(indexer.entityType, ctx.identifiers.tenantId ?? null)) {
+        void bus.emitEvent("query_index.coverage.refresh", {
+          entityType: indexer.entityType,
+          tenantId: ctx.identifiers.tenantId ?? null,
+          organizationId: null,
+          delayMs: 0
+        }).catch(() => void 0);
+      }
+    }
+  }
+  markOrmEntityChange(opts) {
+    const { entity, identifiers } = opts;
+    if (!entity) return;
+    if (!identifiers?.id) return;
+    const key = this.buildSideEffectKey(opts.action, identifiers);
+    const existing = this.pendingSideEffects.get(key);
+    if (existing) {
+      existing.entity = entity;
+      existing.identifiers = {
+        id: identifiers.id,
+        organizationId: identifiers.organizationId ?? null,
+        tenantId: identifiers.tenantId ?? null
+      };
+      if (opts.events) existing.events = opts.events;
+      if (opts.indexer) existing.indexer = opts.indexer;
+      this.pendingSideEffects.set(key, existing);
+      return;
+    }
+    const entry = {
+      action: opts.action,
+      entity,
+      identifiers: {
+        id: identifiers.id,
+        organizationId: identifiers.organizationId ?? null,
+        tenantId: identifiers.tenantId ?? null
+      }
+    };
+    if (opts.events) entry.events = opts.events;
+    if (opts.indexer) entry.indexer = opts.indexer;
+    this.pendingSideEffects.set(key, entry);
+  }
+  async flushOrmEntityChanges() {
+    if (!this.pendingSideEffects.size) return;
+    const entries = Array.from(this.pendingSideEffects.values());
+    this.pendingSideEffects.clear();
+    for (const entry of entries) {
+      try {
+        await this.emitOrmEntityEvent({
+          action: entry.action,
+          entity: entry.entity,
+          identifiers: entry.identifiers,
+          events: entry.events,
+          indexer: entry.indexer
+        });
+      } catch {
+      }
+    }
+  }
+  buildSideEffectKey(action, identifiers) {
+    const id = identifiers.id ?? "";
+    const org = identifiers.organizationId ?? "";
+    const tenant = identifiers.tenantId ?? "";
+    return [action, id, org, tenant].join("|");
+  }
+}
+export {
+  DefaultDataEngine
+};
+//# sourceMappingURL=engine.js.map

package/dist/lib/data/engine.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/data/engine.ts"],
+  "sourcesContent": ["import type { EntityData, EntityName, FilterQuery, RequiredEntityData } from '@mikro-orm/core'\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport type { AwilixContainer } from 'awilix'\nimport { setRecordCustomFields } from '@open-mercato/core/modules/entities/lib/helpers'\nimport { validateCustomFieldValuesServer } from '@open-mercato/core/modules/entities/lib/validation'\nimport type { EventBus } from '@open-mercato/events/types'\nimport type {\n  CrudEventAction,\n  CrudEventsConfig,\n  CrudIndexerConfig,\n  CrudEntityIdentifiers,\n} from '../crud/types'\nimport { CrudHttpError } from '../crud/errors'\nimport { normalizeCustomFieldValues } from '../custom-fields/normalize'\nimport { parseBooleanToken } from '../boolean'\n\nconst COVERAGE_REFRESH_INTERVAL_MS = 5 * 60 * 1000\nconst coverageRefreshTracker = new Map<string, number>()\n\nfunction shouldTriggerCoverageRefresh(entityType: string | undefined, tenantId: string | null): boolean {\n  if (!entityType) return false\n  const key = `${entityType}|${tenantId ?? '__null__'}`\n  const now = Date.now()\n  const last = coverageRefreshTracker.get(key) ?? 0\n  if (now - last < COVERAGE_REFRESH_INTERVAL_MS) return false\n  coverageRefreshTracker.set(key, now)\n  return true\n}\n\ntype CustomEntityValues = Record<string, unknown>\n\ntype QueuedCrudSideEffect = {\n  action: CrudEventAction\n  entity: unknown\n  identifiers: CrudEntityIdentifiers\n  events?: CrudEventsConfig<unknown>\n  indexer?: CrudIndexerConfig<unknown>\n}\n\nexport interface DataEngine {\n  setCustomFields(opts: {\n    entityId: string\n    recordId: string\n    organizationId?: string | null\n    tenantId?: string | null\n    values: Record<string, string | number | boolean | null | undefined | Array<string | number | boolean | null | undefined>>\n    notify?: boolean // default true -> emit '<module>.<entity>.updated'\n  }): Promise<void>\n\n  // Storage for user-defined entities (doc-based)\n  createCustomEntityRecord(opts: {\n    entityId: string // '<module>:<entity>'\n    recordId?: string // optional; auto-generate if not provided\n    organizationId?: string | null\n    tenantId?: string | null\n    values: CustomEntityValues\n    notify?: boolean // keep event emitting as it is via setCustomFields (updated)\n  }): Promise<{ id: string }>\n\n  updateCustomEntityRecord(opts: {\n    entityId: string\n    recordId: string\n    organizationId?: string | null\n    tenantId?: string | null\n    values: CustomEntityValues\n    notify?: boolean // keep event emitting as it is via setCustomFields (updated)\n  }): Promise<void>\n\n  deleteCustomEntityRecord(opts: {\n    entityId: string\n    recordId: string\n    organizationId?: string | null\n    tenantId?: string | null\n    soft?: boolean // default true: sets deleted_at\n    notify?: boolean // keep event emitting as it is (no extra events here)\n  }): Promise<void>\n\n  // Generic ORM-backed entity operations used by CrudFactory\n  createOrmEntity<T extends object>(opts: {\n    entity: EntityName<T>\n    data: EntityData<T>\n  }): Promise<T>\n\n  updateOrmEntity<T extends object>(opts: {\n    entity: EntityName<T>\n    where: FilterQuery<T>\n    apply: (current: T) => Promise<void> | void\n  }): Promise<T | null>\n\n  deleteOrmEntity<T extends object>(opts: {\n    entity: EntityName<T>\n    where: FilterQuery<T>\n    soft?: boolean\n    softDeleteField?: keyof T & string\n  }): Promise<T | null>\n\n  emitOrmEntityEvent<T>(opts: {\n    action: CrudEventAction\n    entity: T\n    events?: CrudEventsConfig<T>\n    indexer?: CrudIndexerConfig<T>\n    identifiers: CrudEntityIdentifiers\n  }): Promise<void>\n\n  markOrmEntityChange<T>(opts: {\n    action: CrudEventAction\n    entity: T | null | undefined\n    events?: CrudEventsConfig<T>\n    indexer?: CrudIndexerConfig<T>\n    identifiers: CrudEntityIdentifiers\n  }): void\n\n  flushOrmEntityChanges(): Promise<void>\n}\n\nexport class DefaultDataEngine implements DataEngine {\n  private pendingSideEffects = new Map<string, QueuedCrudSideEffect>()\n  constructor(private em: EntityManager, private container: AwilixContainer) {}\n\n  async setCustomFields(opts: Parameters<DataEngine['setCustomFields']>[0]): Promise<void> {\n    const { entityId, recordId, organizationId = null, tenantId = null, values } = opts\n    await this.validateCustomFieldValues(entityId, organizationId, tenantId, values as Record<string, unknown>)\n    let encryptionService: any = null\n    try {\n      encryptionService = this.container.resolve('tenantEncryptionService') as any\n    } catch {\n      encryptionService = null\n    }\n    await setRecordCustomFields(this.em, {\n      entityId,\n      recordId,\n      organizationId,\n      tenantId,\n      values,\n      encryptionService,\n    })\n    if (opts.notify !== false) {\n      let bus: EventBus | null = null\n      try {\n        bus = (this.container.resolve('eventBus') as EventBus)\n      } catch {\n        bus = null\n      }\n      if (bus) {\n        const [mod, ent] = (entityId || '').split(':')\n        if (mod && ent) {\n          try {\n            await bus.emitEvent(`${mod}.${ent}.updated`, { id: recordId, organizationId, tenantId }, { persistent: true })\n          } catch {\n            // non-blocking\n          }\n        }\n      }\n    }\n  }\n\n  private normalizeDocValues(values: CustomEntityValues): CustomEntityValues {\n    const out: CustomEntityValues = {}\n    for (const [k, v] of Object.entries(values || {})) {\n      // Never allow callers to override reserved identifiers in the doc\n      if (k === 'id' || k === 'entity_id' || k === 'entityId') continue\n      // Accept both 'cf_<key>' and 'cf:<key>' inputs and normalize to 'cf:<key>'\n      if (k.startsWith('cf_')) out[`cf:${k.slice(3)}`] = v\n      else out[k] = v\n    }\n    return out\n  }\n\n  private backcompatEavEnabled(): boolean {\n    try {\n      return parseBooleanToken(process.env.ENTITIES_BACKCOMPAT_EAV_FOR_CUSTOM ?? '') === true\n    } catch { return false }\n  }\n\n  private async ensureStorageTableExists(): Promise<void> {\n    const knex = this.em.getConnection().getKnex()\n    const exists = await knex('information_schema.tables')\n      .where({ table_name: 'custom_entities_storage' })\n      .first()\n    if (!exists) {\n      throw new Error('custom_entities_storage table is missing. Run migrations (yarn db:migrate).')\n    }\n  }\n\n  private normalizeValuesForValidation(values: Record<string, unknown> | undefined | null): Record<string, unknown> {\n    if (!values) return {}\n    const out: Record<string, unknown> = {}\n    for (const [key, value] of Object.entries(values)) {\n      if (value === undefined) continue\n      if (key.startsWith('cf_') || key.startsWith('cf:')) {\n        const normalized = key.slice(3)\n        if (normalized) out[normalized] = value\n        continue\n      }\n      out[key] = value\n    }\n    return out\n  }\n\n  private async validateCustomFieldValues(\n    entityId: string,\n    organizationId: string | null,\n    tenantId: string | null,\n    values: Record<string, unknown> | undefined | null,\n  ): Promise<void> {\n    const prepared = this.normalizeValuesForValidation(values)\n    if (!entityId || Object.keys(prepared).length === 0) return\n    const result = await validateCustomFieldValuesServer(this.em, {\n      entityId,\n      organizationId,\n      tenantId,\n      values: prepared,\n    })\n    if (!result.ok) {\n      throw new CrudHttpError(400, { error: 'Validation failed', fields: result.fieldErrors })\n    }\n  }\n\n  async createCustomEntityRecord(opts: Parameters<DataEngine['createCustomEntityRecord']>[0]): Promise<{ id: string }> {\n    const knex = this.em.getConnection().getKnex()\n    await this.ensureStorageTableExists()\n    await this.validateCustomFieldValues(opts.entityId, opts.organizationId ?? null, opts.tenantId ?? null, opts.values)\n    const rawId = String(opts.recordId ?? '').trim()\n    const isUuid = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(rawId)\n    const sentinel = rawId.toLowerCase()\n    const shouldGenerate = !rawId || !isUuid || sentinel === 'create' || sentinel === 'new' || sentinel === 'null' || sentinel === 'undefined'\n    const id = shouldGenerate ? ((): string => {\n      const g = globalThis as { crypto?: { randomUUID?: () => string } }\n      if (g.crypto?.randomUUID) return g.crypto.randomUUID()\n      // Fallback UUIDv4 generator\n      return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {\n        const r = (Math.random() * 16) | 0\n        const v = c === 'x' ? r : (r & 0x3) | 0x8\n        return v.toString(16)\n      })\n    })() : rawId\n    const orgId = opts.organizationId ?? null\n    const tenantId = opts.tenantId ?? null\n    const doc: Record<string, unknown> = { id, ...this.normalizeDocValues(opts.values || {}) }\n\n    const payload = {\n      entity_type: opts.entityId,\n      entity_id: id,\n      organization_id: orgId,\n      tenant_id: tenantId,\n      doc,\n      updated_at: knex.fn.now(),\n      created_at: knex.fn.now(),\n      deleted_at: null,\n    }\n\n    // Upsert by scoped uniqueness\n    try {\n      await knex('custom_entities_storage')\n        .insert(payload)\n        .onConflict(['entity_type', 'entity_id', 'organization_id'])\n        .merge({ doc: payload.doc, updated_at: knex.fn.now(), deleted_at: null })\n    } catch {\n      // Fallback for global scope uniqueness\n      try {\n        const updated = await knex('custom_entities_storage')\n          .where({ entity_type: opts.entityId, entity_id: id, organization_id: orgId })\n          .update({ doc: payload.doc, updated_at: knex.fn.now(), deleted_at: null })\n        if (!updated) {\n          await knex('custom_entities_storage').insert(payload)\n        }\n      } catch (err) {\n        // Surface a clear error so it doesn't silently fall back only to EAV\n        throw err\n      }\n    }\n\n    // Optional EAV backward compatibility (disabled by default)\n    if (this.backcompatEavEnabled() && opts.values && Object.keys(opts.values).length > 0) {\n      await this.setCustomFields({\n        entityId: opts.entityId,\n        recordId: id,\n        organizationId: orgId,\n        tenantId: tenantId,\n        values: normalizeCustomFieldValues(opts.values),\n        notify: opts.notify, // defaults to true\n      })\n    }\n\n    return { id }\n  }\n\n  async updateCustomEntityRecord(opts: Parameters<DataEngine['updateCustomEntityRecord']>[0]): Promise<void> {\n    const knex = this.em.getConnection().getKnex()\n    await this.validateCustomFieldValues(opts.entityId, opts.organizationId ?? null, opts.tenantId ?? null, opts.values)\n    const id = String(opts.recordId)\n    const orgId = opts.organizationId ?? null\n    const tenantId = opts.tenantId ?? null\n\n    // Merge doc shallowly: load existing doc and overlay\n    await this.ensureStorageTableExists()\n    const row = await knex('custom_entities_storage')\n      .where({ entity_type: opts.entityId, entity_id: id, organization_id: orgId })\n      .first()\n    const prevDoc: Record<string, unknown> = row?.doc || { id }\n    const nextDoc: Record<string, unknown> = { ...prevDoc, ...this.normalizeDocValues(opts.values || {}), id }\n    try {\n      const updated = await knex('custom_entities_storage')\n        .where({ entity_type: opts.entityId, entity_id: id, organization_id: orgId })\n        .update({ doc: nextDoc, updated_at: knex.fn.now(), deleted_at: null })\n      if (!updated) {\n        await knex('custom_entities_storage').insert({\n          entity_type: opts.entityId,\n          entity_id: id,\n          organization_id: orgId,\n          tenant_id: tenantId,\n          doc: nextDoc,\n          created_at: knex.fn.now(),\n          updated_at: knex.fn.now(),\n          deleted_at: null,\n        })\n      }\n    } catch (err) {\n      throw err\n    }\n\n    // Optional EAV backward compatibility (disabled by default)\n    if (this.backcompatEavEnabled() && opts.values && Object.keys(opts.values).length > 0) {\n      await this.setCustomFields({\n        entityId: opts.entityId,\n        recordId: id,\n        organizationId: orgId,\n        tenantId: tenantId,\n        values: normalizeCustomFieldValues(opts.values),\n        notify: opts.notify, // defaults to true\n      })\n    }\n  }\n\n  async deleteCustomEntityRecord(opts: Parameters<DataEngine['deleteCustomEntityRecord']>[0]): Promise<void> {\n    const knex = this.em.getConnection().getKnex()\n    const id = String(opts.recordId)\n    const orgId = opts.organizationId ?? null\n    const soft = opts.soft !== false\n\n    if (soft) {\n      await knex('custom_entities_storage')\n        .where({ entity_type: opts.entityId, entity_id: id, organization_id: orgId })\n        .update({ deleted_at: knex.fn.now(), updated_at: knex.fn.now() })\n    } else {\n      await knex('custom_entities_storage')\n        .where({ entity_type: opts.entityId, entity_id: id, organization_id: orgId })\n        .delete()\n    }\n\n    // Soft-delete EAV values to preserve current behavior\n    try {\n      const { CustomFieldValue } = await import('@open-mercato/core/modules/entities/data/entities')\n      const values = await this.em.find(CustomFieldValue, {\n        entityId: opts.entityId,\n        recordId: id,\n        organizationId: orgId,\n        tenantId: opts.tenantId ?? null,\n      })\n      const now = new Date()\n      const mutated = values.filter((record) => {\n        if (record.deletedAt) return false\n        record.deletedAt = now\n        return true\n      })\n      if (mutated.length) await this.em.persistAndFlush(values)\n    } catch { /* non-blocking */ }\n  }\n\n  async createOrmEntity<T extends object>(opts: { entity: EntityName<T>; data: EntityData<T> }): Promise<T> {\n    const entity = this.em.create(\n      opts.entity,\n      opts.data as RequiredEntityData<T, never, true>\n    )\n    await this.em.persistAndFlush(entity)\n    return entity\n  }\n\n  async updateOrmEntity<T extends object>(opts: {\n    entity: EntityName<T>\n    where: FilterQuery<T>\n    apply: (current: T) => Promise<void> | void\n  }): Promise<T | null> {\n    const current = await this.em.findOne(opts.entity, opts.where)\n    if (!current) return null\n    await opts.apply(current)\n    await this.em.persistAndFlush(current)\n    return current\n  }\n\n  async deleteOrmEntity<T extends object>(opts: {\n    entity: EntityName<T>\n    where: FilterQuery<T>\n    soft?: boolean\n    softDeleteField?: keyof T & string\n  }): Promise<T | null> {\n    const current = await this.em.findOne(opts.entity, opts.where)\n    if (!current) return null\n    if (opts.soft !== false) {\n      const field = opts.softDeleteField || ('deletedAt' as keyof T & string)\n      if (typeof current === 'object' && current !== null) {\n        ;(current as Record<string, unknown>)[field] = new Date()\n        await this.em.persistAndFlush(current)\n      }\n    } else {\n      await this.em.removeAndFlush(current)\n    }\n    return current\n  }\n\n  async emitOrmEntityEvent<T>(opts: { action: CrudEventAction; entity: T; events?: CrudEventsConfig<T>; indexer?: CrudIndexerConfig<T>; identifiers: CrudEntityIdentifiers }): Promise<void> {\n    const { action, entity, events, indexer, identifiers } = opts\n    if (!events && !indexer) return\n    if (!identifiers?.id) return\n\n    let bus: EventBus | null = null\n    try {\n      bus = (this.container.resolve('eventBus') as EventBus)\n    } catch {\n      bus = null\n    }\n    if (!bus) return\n\n    const ctx = {\n      action,\n      entity,\n      identifiers: {\n        id: identifiers.id,\n        organizationId: identifiers.organizationId ?? null,\n        tenantId: identifiers.tenantId ?? null,\n      },\n    }\n\n    if (events) {\n      const eventName = `${events.module}.${events.entity}.${action}`\n      const payload = events.buildPayload\n        ? events.buildPayload(ctx)\n        : {\n            id: ctx.identifiers.id,\n            organizationId: ctx.identifiers.organizationId,\n            tenantId: ctx.identifiers.tenantId,\n          }\n      try {\n        await bus.emitEvent(eventName, payload, { persistent: !!events.persistent })\n      } catch {\n        // non-blocking\n      }\n    }\n\n    if (indexer) {\n      const resolveCoverageBaseDelta = (): number | undefined => {\n        if (action === 'created') return 1\n        if (action === 'deleted') return -1\n        return undefined\n      }\n      const coverageBaseDelta = resolveCoverageBaseDelta()\n\n      if (action === 'deleted') {\n        const payload = indexer.buildDeletePayload\n          ? indexer.buildDeletePayload(ctx)\n          : {\n              entityType: indexer.entityType,\n              recordId: ctx.identifiers.id,\n              organizationId: ctx.identifiers.organizationId,\n              tenantId: ctx.identifiers.tenantId,\n            }\n        const enrichedPayload = payload as Record<string, unknown>\n        enrichedPayload.crudAction = action\n        if (coverageBaseDelta !== undefined) enrichedPayload.coverageBaseDelta = coverageBaseDelta\n        try {\n          await bus.emitEvent('query_index.delete_one', enrichedPayload)\n        } catch {\n          // non-blocking\n        }\n      } else {\n        const payload = indexer.buildUpsertPayload\n          ? indexer.buildUpsertPayload(ctx)\n          : {\n              entityType: indexer.entityType,\n              recordId: ctx.identifiers.id,\n              organizationId: ctx.identifiers.organizationId,\n              tenantId: ctx.identifiers.tenantId,\n            }\n        const enrichedPayload = payload as Record<string, unknown>\n        enrichedPayload.crudAction = action\n        if (coverageBaseDelta !== undefined) enrichedPayload.coverageBaseDelta = coverageBaseDelta\n        try {\n          await bus.emitEvent('query_index.upsert_one', enrichedPayload)\n        } catch {\n          // non-blocking\n        }\n      }\n\n      if (shouldTriggerCoverageRefresh(indexer.entityType, ctx.identifiers.tenantId ?? null)) {\n        void bus.emitEvent('query_index.coverage.refresh', {\n          entityType: indexer.entityType,\n          tenantId: ctx.identifiers.tenantId ?? null,\n          organizationId: null,\n          delayMs: 0,\n        }).catch(() => undefined)\n      }\n    }\n  }\n\n  markOrmEntityChange<T>(opts: { action: CrudEventAction; entity: T | null | undefined; events?: CrudEventsConfig<T>; indexer?: CrudIndexerConfig<T>; identifiers: CrudEntityIdentifiers }): void {\n    const { entity, identifiers } = opts\n    if (!entity) return\n    if (!identifiers?.id) return\n    const key = this.buildSideEffectKey(opts.action, identifiers)\n    const existing = this.pendingSideEffects.get(key)\n    if (existing) {\n      existing.entity = entity\n      existing.identifiers = {\n        id: identifiers.id,\n        organizationId: identifiers.organizationId ?? null,\n        tenantId: identifiers.tenantId ?? null,\n      }\n      if (opts.events) existing.events = opts.events as CrudEventsConfig<unknown>\n      if (opts.indexer) existing.indexer = opts.indexer as CrudIndexerConfig<unknown>\n      this.pendingSideEffects.set(key, existing)\n      return\n    }\n    const entry: QueuedCrudSideEffect = {\n      action: opts.action,\n      entity,\n      identifiers: {\n        id: identifiers.id,\n        organizationId: identifiers.organizationId ?? null,\n        tenantId: identifiers.tenantId ?? null,\n      },\n    }\n    if (opts.events) entry.events = opts.events as CrudEventsConfig<unknown>\n    if (opts.indexer) entry.indexer = opts.indexer as CrudIndexerConfig<unknown>\n    this.pendingSideEffects.set(key, entry)\n  }\n\n  async flushOrmEntityChanges(): Promise<void> {\n    if (!this.pendingSideEffects.size) return\n    const entries = Array.from(this.pendingSideEffects.values())\n    this.pendingSideEffects.clear()\n    for (const entry of entries) {\n      try {\n        await this.emitOrmEntityEvent({\n          action: entry.action,\n          entity: entry.entity,\n          identifiers: entry.identifiers,\n          events: entry.events as CrudEventsConfig<unknown>,\n          indexer: entry.indexer as CrudIndexerConfig<unknown>,\n        })\n      } catch {\n        // best-effort; continue with remaining side effects\n      }\n    }\n  }\n\n  private buildSideEffectKey(action: CrudEventAction, identifiers: CrudEntityIdentifiers): string {\n    const id = identifiers.id ?? ''\n    const org = identifiers.organizationId ?? ''\n    const tenant = identifiers.tenantId ?? ''\n    return [action, id, org, tenant].join('|')\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/lib/db/escapeLikePattern.js

@@ -0,0 +1,5 @@
+const escapeLikePattern = (value) => value.replace(/\\/g, "\\\\").replace(/[%_]/g, "\\$&");
+export {
+  escapeLikePattern
+};
+//# sourceMappingURL=escapeLikePattern.js.map

package/dist/lib/db/escapeLikePattern.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/db/escapeLikePattern.ts"],
+  "sourcesContent": ["export const escapeLikePattern = (value: string): string =>\n  value.replace(/\\\\/g, '\\\\\\\\').replace(/[%_]/g, '\\\\$&')\n"],
+  "mappings": "AAAO,MAAM,oBAAoB,CAAC,UAChC,MAAM,QAAQ,OAAO,MAAM,EAAE,QAAQ,SAAS,MAAM;",
+  "names": []
+}

package/dist/lib/db/mikro.js

@@ -0,0 +1,82 @@
+import "dotenv/config";
+import "reflect-metadata";
+import { MikroORM } from "@mikro-orm/core";
+import { PostgreSqlDriver } from "@mikro-orm/postgresql";
+let ormInstance = null;
+let _entities = null;
+function registerOrmEntities(entities) {
+  if (_entities !== null && process.env.NODE_ENV === "development") {
+    console.debug("[Bootstrap] ORM entities re-registered (this may occur during HMR)");
+  }
+  _entities = entities;
+}
+function getOrmEntities() {
+  if (!_entities) {
+    throw new Error("[Bootstrap] ORM entities not registered. Call registerOrmEntities() at bootstrap.");
+  }
+  return _entities;
+}
+async function getOrm() {
+  if (ormInstance) {
+    return ormInstance;
+  }
+  const entities = getOrmEntities();
+  const clientUrl = process.env.DATABASE_URL;
+  if (!clientUrl) throw new Error("DATABASE_URL is not set");
+  const poolMin = parseInt(process.env.DB_POOL_MIN || "2");
+  const poolMax = parseInt(process.env.DB_POOL_MAX || "50");
+  const poolIdleTimeout = parseInt(process.env.DB_POOL_IDLE_TIMEOUT || "3000");
+  const poolAcquireTimeout = parseInt(process.env.DB_POOL_ACQUIRE_TIMEOUT || "6000");
+  const idleSessionTimeoutEnv = parseInt(process.env.DB_IDLE_SESSION_TIMEOUT_MS || "");
+  const idleInTxTimeoutEnv = parseInt(process.env.DB_IDLE_IN_TRANSACTION_TIMEOUT_MS || "");
+  const idleSessionTimeoutMs = Number.isFinite(idleSessionTimeoutEnv) ? idleSessionTimeoutEnv : process.env.NODE_ENV === "production" ? void 0 : 6e5;
+  const idleInTransactionTimeoutMs = Number.isFinite(idleInTxTimeoutEnv) ? idleInTxTimeoutEnv : process.env.NODE_ENV === "production" ? void 0 : 12e4;
+  const connectionOptions = idleSessionTimeoutMs && idleSessionTimeoutMs > 0 ? `-c idle_session_timeout=${idleSessionTimeoutMs}` : void 0;
+  ormInstance = await MikroORM.init({
+    driver: PostgreSqlDriver,
+    clientUrl,
+    entities,
+    debug: false,
+    // Connection pooling configuration
+    pool: {
+      min: poolMin,
+      max: poolMax,
+      idleTimeoutMillis: poolIdleTimeout,
+      acquireTimeoutMillis: poolAcquireTimeout,
+      // Close idle connections after 30 seconds
+      destroyTimeoutMillis: process.env.NODE_ENV === "production" ? 3e4 : 3e3
+    },
+    // Connection options
+    driverOptions: {
+      // Enable connection pooling
+      connection: {
+        // Maximum number of connections in the pool
+        max: poolMax,
+        // Minimum number of connections in the pool
+        min: poolMin,
+        // Close connections after this many milliseconds of inactivity
+        idleTimeoutMillis: poolIdleTimeout,
+        // Maximum time to wait for a connection from the pool
+        acquireTimeoutMillis: poolAcquireTimeout,
+        idle_in_transaction_session_timeout: idleInTransactionTimeoutMs,
+        options: connectionOptions
+      }
+    }
+  });
+  return ormInstance;
+}
+async function closeOrmIfLoaded() {
+  if (ormInstance) {
+    await ormInstance.close(true);
+    ormInstance = null;
+  }
+}
+if (process.env.NODE_ENV !== "production") {
+  void closeOrmIfLoaded();
+}
+export {
+  getOrm,
+  getOrmEntities,
+  registerOrmEntities
+};
+//# sourceMappingURL=mikro.js.map

package/dist/lib/db/mikro.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/db/mikro.ts"],
+  "sourcesContent": ["import 'dotenv/config'\nimport 'reflect-metadata'\nimport { MikroORM } from '@mikro-orm/core'\nimport { PostgreSqlDriver } from '@mikro-orm/postgresql'\n\nlet ormInstance: MikroORM<PostgreSqlDriver> | null = null\n\n// Registration pattern for publishable packages\nlet _entities: any[] | null = null\n\nexport function registerOrmEntities(entities: any[]) {\n  if (_entities !== null && process.env.NODE_ENV === 'development') {\n    console.debug('[Bootstrap] ORM entities re-registered (this may occur during HMR)')\n  }\n  _entities = entities\n}\n\nexport function getOrmEntities(): any[] {\n  if (!_entities) {\n    throw new Error('[Bootstrap] ORM entities not registered. Call registerOrmEntities() at bootstrap.')\n  }\n  return _entities\n}\n\nexport async function getOrm() {\n  if (ormInstance) {\n    return ormInstance\n  }\n  const entities = getOrmEntities()\n  const clientUrl = process.env.DATABASE_URL\n  if (!clientUrl) throw new Error('DATABASE_URL is not set')\n  \n  // Parse connection pool settings from environment\n  const poolMin = parseInt(process.env.DB_POOL_MIN || '2')\n  const poolMax = parseInt(process.env.DB_POOL_MAX || '50')\n  const poolIdleTimeout = parseInt(process.env.DB_POOL_IDLE_TIMEOUT || '3000')\n  const poolAcquireTimeout = parseInt(process.env.DB_POOL_ACQUIRE_TIMEOUT || '6000')\n  const idleSessionTimeoutEnv = parseInt(process.env.DB_IDLE_SESSION_TIMEOUT_MS || '')\n  const idleInTxTimeoutEnv = parseInt(process.env.DB_IDLE_IN_TRANSACTION_TIMEOUT_MS || '')\n  const idleSessionTimeoutMs = Number.isFinite(idleSessionTimeoutEnv)\n    ? idleSessionTimeoutEnv\n    : process.env.NODE_ENV === 'production'\n      ? undefined\n      : 600_000\n  const idleInTransactionTimeoutMs = Number.isFinite(idleInTxTimeoutEnv)\n    ? idleInTxTimeoutEnv\n    : process.env.NODE_ENV === 'production'\n      ? undefined\n      : 120_000\n  const connectionOptions =\n    idleSessionTimeoutMs && idleSessionTimeoutMs > 0\n      ? `-c idle_session_timeout=${idleSessionTimeoutMs}`\n      : undefined\n  \n  ormInstance = await MikroORM.init<PostgreSqlDriver>({\n    driver: PostgreSqlDriver,\n    clientUrl,\n    entities,\n    debug: false,\n    // Connection pooling configuration\n    pool: {\n      min: poolMin,\n      max: poolMax,\n      idleTimeoutMillis: poolIdleTimeout,\n      acquireTimeoutMillis: poolAcquireTimeout,\n      // Close idle connections after 30 seconds\n      destroyTimeoutMillis: process.env.NODE_ENV === 'production' ? 30000 : 3000,\n    },\n    // Connection options\n    driverOptions: {\n      // Enable connection pooling\n      connection: {\n        // Maximum number of connections in the pool\n        max: poolMax,\n        // Minimum number of connections in the pool\n        min: poolMin,\n        // Close connections after this many milliseconds of inactivity\n        idleTimeoutMillis: poolIdleTimeout,\n        // Maximum time to wait for a connection from the pool\n        acquireTimeoutMillis: poolAcquireTimeout,\n        idle_in_transaction_session_timeout: idleInTransactionTimeoutMs,\n        options: connectionOptions,\n      },\n    },\n  })\n  return ormInstance\n}\n\n\nasync function closeOrmIfLoaded(): Promise<void> {\n  if (ormInstance) {\n    await ormInstance.close(true)\n    ormInstance = null\n  }\n}\n\n// In dev mode, handle reloads cleanly without leaving dangling connections.\nif (process.env.NODE_ENV !== 'production') {\n  void closeOrmIfLoaded()\n}"],
+  "mappings": "AAAA,OAAO;AACP,OAAO;AACP,SAAS,gBAAgB;AACzB,SAAS,wBAAwB;AAEjC,IAAI,cAAiD;AAGrD,IAAI,YAA0B;AAEvB,SAAS,oBAAoB,UAAiB;AACnD,MAAI,cAAc,QAAQ,QAAQ,IAAI,aAAa,eAAe;AAChE,YAAQ,MAAM,oEAAoE;AAAA,EACpF;AACA,cAAY;AACd;AAEO,SAAS,iBAAwB;AACtC,MAAI,CAAC,WAAW;AACd,UAAM,IAAI,MAAM,mFAAmF;AAAA,EACrG;AACA,SAAO;AACT;AAEA,eAAsB,SAAS;AAC7B,MAAI,aAAa;AACf,WAAO;AAAA,EACT;AACA,QAAM,WAAW,eAAe;AAChC,QAAM,YAAY,QAAQ,IAAI;AAC9B,MAAI,CAAC,UAAW,OAAM,IAAI,MAAM,yBAAyB;AAGzD,QAAM,UAAU,SAAS,QAAQ,IAAI,eAAe,GAAG;AACvD,QAAM,UAAU,SAAS,QAAQ,IAAI,eAAe,IAAI;AACxD,QAAM,kBAAkB,SAAS,QAAQ,IAAI,wBAAwB,MAAM;AAC3E,QAAM,qBAAqB,SAAS,QAAQ,IAAI,2BAA2B,MAAM;AACjF,QAAM,wBAAwB,SAAS,QAAQ,IAAI,8BAA8B,EAAE;AACnF,QAAM,qBAAqB,SAAS,QAAQ,IAAI,qCAAqC,EAAE;AACvF,QAAM,uBAAuB,OAAO,SAAS,qBAAqB,IAC9D,wBACA,QAAQ,IAAI,aAAa,eACvB,SACA;AACN,QAAM,6BAA6B,OAAO,SAAS,kBAAkB,IACjE,qBACA,QAAQ,IAAI,aAAa,eACvB,SACA;AACN,QAAM,oBACJ,wBAAwB,uBAAuB,IAC3C,2BAA2B,oBAAoB,KAC/C;AAEN,gBAAc,MAAM,SAAS,KAAuB;AAAA,IAClD,QAAQ;AAAA,IACR;AAAA,IACA;AAAA,IACA,OAAO;AAAA;AAAA,IAEP,MAAM;AAAA,MACJ,KAAK;AAAA,MACL,KAAK;AAAA,MACL,mBAAmB;AAAA,MACnB,sBAAsB;AAAA;AAAA,MAEtB,sBAAsB,QAAQ,IAAI,aAAa,eAAe,MAAQ;AAAA,IACxE;AAAA;AAAA,IAEA,eAAe;AAAA;AAAA,MAEb,YAAY;AAAA;AAAA,QAEV,KAAK;AAAA;AAAA,QAEL,KAAK;AAAA;AAAA,QAEL,mBAAmB;AAAA;AAAA,QAEnB,sBAAsB;AAAA,QACtB,qCAAqC;AAAA,QACrC,SAAS;AAAA,MACX;AAAA,IACF;AAAA,EACF,CAAC;AACD,SAAO;AACT;AAGA,eAAe,mBAAkC;AAC/C,MAAI,aAAa;AACf,UAAM,YAAY,MAAM,IAAI;AAC5B,kBAAc;AAAA,EAChB;AACF;AAGA,IAAI,QAAQ,IAAI,aAAa,cAAc;AACzC,OAAK,iBAAiB;AACxB;",
+  "names": []
+}