hikoutei 0.2.0

package/dist/adapter/persistence/providers/mikro-orm/api/MikroOrmTypedSheetsEntityManager.js

@@ -0,0 +1,105 @@
+/**
+ * MikroORM EntityManager bridge for the adapter-neutral typed-sheets engine.
+ *
+ * Stateful delegation stays in this class. Changeset normalization is kept in
+ * `MikroOrmFlushChanges.ts` so the lifecycle contract can be tested separately
+ * from transaction and identity-map behavior.
+ */
+import { collectMikroOrmFlushChanges } from "../storage/MikroOrmFlushChanges.js";
+/**
+ * Adapts one forked MikroORM manager to the typed-sheets engine contract.
+ *
+ * The subscriber is scoped to this manager instance and ignores events from
+ * other forks, preventing a request-local flush plan from leaking across
+ * identity maps or transactions.
+ */
+export class MikroOrmSqliteTypedSheetsEntityManager {
+    storage;
+    entityManager;
+    flushListener;
+    constructor(storage, entityManager) {
+        this.storage = storage;
+        this.entityManager = entityManager;
+        this.entityManager.getEventManager().registerSubscriber({
+            onFlush: async (args) => this.coordinateFlush(args),
+        });
+    }
+    /** Creates a manager with an independent MikroORM identity map. */
+    fork(options) {
+        const fork = this.entityManager.fork.bind(this.entityManager);
+        return new MikroOrmSqliteTypedSheetsEntityManager(this.storage, fork(options));
+    }
+    /** Delegates entity construction while keeping MikroORM types inside the adapter. */
+    create(entityName, data) {
+        const create = this.entityManager.create.bind(this.entityManager);
+        return create(entityName, data);
+    }
+    /** Reads a filtered entity collection through the local SQLite manager. */
+    async find(entityName, where, options) {
+        const find = this.entityManager.find.bind(this.entityManager);
+        return find(entityName, where, options);
+    }
+    /** Reads one filtered entity through the local SQLite manager. */
+    async findOne(entityName, where, options) {
+        const findOne = this.entityManager.findOne.bind(this.entityManager);
+        return findOne(entityName, where, options);
+    }
+    /** Marks one or more entities for MikroORM insertion or update. */
+    persist(entity) {
+        this.entityManager.persist(entity);
+    }
+    /** Marks one or more entities for MikroORM removal. */
+    remove(entity) {
+        this.entityManager.remove(entity);
+    }
+    /** Flushes the current MikroORM unit of work. */
+    async flush() {
+        await this.entityManager.flush();
+    }
+    /** Runs work through MikroORM's transaction boundary. */
+    async transactional(operation) {
+        return this.entityManager.transactional(async (transactionalEntityManager) => {
+            return operation(new MikroOrmSqliteTypedSheetsEntityManager(this.storage, transactionalEntityManager));
+        });
+    }
+    /** Clears MikroORM's request-local identity map. */
+    clear() {
+        this.entityManager.clear();
+    }
+    /** Reports whether this manager already owns a SQLite transaction. */
+    isInTransaction() {
+        return this.entityManager.isInTransaction();
+    }
+    /** Opens the explicit SQLite transaction used by the public facade. */
+    async begin() {
+        await this.entityManager.begin();
+    }
+    /** Commits the explicit SQLite transaction used by the public facade. */
+    async commit() {
+        await this.entityManager.commit();
+    }
+    /** Rolls back the explicit SQLite transaction used by the public facade. */
+    async rollback() {
+        await this.entityManager.rollback();
+    }
+    /** Stores the planner that must share this manager's flush transaction. */
+    onFlush(listener) {
+        this.flushListener = listener;
+    }
+    /** Converts a MikroORM flush event into one typed-sheets planning callback. */
+    async coordinateFlush(args) {
+        if (args.em !== this.entityManager)
+            return;
+        const listener = this.flushListener;
+        if (listener === undefined)
+            return;
+        const changes = collectMikroOrmFlushChanges(args);
+        if (changes.length === 0)
+            return;
+        await listener({
+            changes,
+            sql: this.storage.createSqlExecutor(this.entityManager),
+        });
+    }
+}
+//# sourceMappingURL=MikroOrmTypedSheetsEntityManager.js.map

package/dist/adapter/persistence/providers/mikro-orm/api/MikroOrmTypedSheetsEntityManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MikroOrmTypedSheetsEntityManager.js","sourceRoot":"","sources":["../../../../../../src/adapter/persistence/providers/mikro-orm/api/MikroOrmTypedSheetsEntityManager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AAMjF;;;;;;GAMG;AACH,MAAM,OAAO,sCAAsC;IAK9B;IACA;IAJX,aAAa,CAA6C;IAElE,YACmB,OAA8B,EAC9B,aAA0C;QAD1C,YAAO,GAAP,OAAO,CAAuB;QAC9B,kBAAa,GAAb,aAAa,CAA6B;QAE3D,IAAI,CAAC,aAAa,CAAC,eAAe,EAAE,CAAC,kBAAkB,CAAC;YACtD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;SACpD,CAAC,CAAC;IACL,CAAC;IAED,mEAAmE;IACnE,IAAI,CAAC,OAAgC;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAoB,CAAC;QACjF,OAAO,IAAI,sCAAsC,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACjF,CAAC;IAED,qFAAqF;IACrF,MAAM,CACJ,UAA8C,EAC9C,IAAmC;QAEnC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAsB,CAAC;QACvF,OAAO,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,2EAA2E;IAC3E,KAAK,CAAC,IAAI,CACR,UAA8C,EAC9C,KAAsC,EACtC,OAAgC;QAEhC,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAoB,CAAC;QACjF,OAAO,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,kEAAkE;IAClE,KAAK,CAAC,OAAO,CACX,UAA8C,EAC9C,KAAsC,EACtC,OAAgC;QAEhC,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAuB,CAAC;QAC1F,OAAO,OAAO,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,mEAAmE;IACnE,OAAO,CAAwB,MAAiC;QAC9D,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,MAAe,CAAC,CAAC;IAC9C,CAAC;IAED,uDAAuD;IACvD,MAAM,CAAwB,MAAiC;QAC7D,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,MAAe,CAAC,CAAC;IAC7C,CAAC;IAED,iDAAiD;IACjD,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;IACnC,CAAC;IAED,yDAAyD;IACzD,KAAK,CAAC,aAAa,CACjB,SAA6E;QAE7E,OAAO,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,KAAK,EAAE,0BAA0B,EAAE,EAAE;YAC3E,OAAO,SAAS,CACd,IAAI,sCAAsC,CAAC,IAAI,CAAC,OAAO,EAAE,0BAA0B,CAAC,CACrF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,oDAAoD;IACpD,KAAK;QACH,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED,sEAAsE;IACtE,eAAe;QACb,OAAO,IAAI,CAAC,aAAa,CAAC,eAAe,EAAE,CAAC;IAC9C,CAAC;IAED,uEAAuE;IACvE,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;IACnC,CAAC;IAED,yEAAyE;IACzE,KAAK,CAAC,MAAM;QACV,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;IACpC,CAAC;IAED,4EAA4E;IAC5E,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;IACtC,CAAC;IAED,2EAA2E;IAC3E,OAAO,CAAC,QAAwC;QAC9C,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC;IAChC,CAAC;IAED,+EAA+E;IACvE,KAAK,CAAC,eAAe,CAAC,IAAoB;QAChD,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,aAAa;YAAE,OAAO;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC;QACpC,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO;QACnC,MAAM,OAAO,GAAG,2BAA2B,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACjC,MAAM,QAAQ,CAAC;YACb,OAAO;YACP,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,aAAa,CAAC;SACxD,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/adapter/persistence/providers/mikro-orm/engine/MikroOrmMappedTypedSheets.d.ts

@@ -0,0 +1,39 @@
+/**
+ * MikroORM convenience entrypoints for the built-in entity-to-Sheets mapping.
+ *
+ * The public `TypedSheetsOrm` remains ours. This module only chooses MikroORM
+ * as the current SQLite execution engine and performs the mapping registry
+ * setup before the application begins calling `em.persist()` and `em.flush()`.
+ */
+import { type TypedSheetsEntityMapping, type TypedSheetsEntityMappingRegistry, type TypedSheetsEntityWriterOptions, type TypedSheetsOrm } from "../../../../../application/orm/index.js";
+import type { RegisteredSyncProjectionDefinition } from "../../../../../application/sync/gateway/SyncGatewayBootstrap.js";
+import { type InitializeMikroOrmSqliteAdapterOptions, type MikroOrmSqliteAdapter } from "../storage/MikroOrmSqliteAdapter.js";
+/** Options for creating a mapped public ORM around an existing MikroORM SQLite adapter. */
+export interface CreateMappedTypedSheetsOrmOptions {
+    readonly mappings: TypedSheetsEntityMappingRegistry | readonly TypedSheetsEntityMapping[];
+    readonly writer: TypedSheetsEntityWriterOptions;
+}
+/** Options for opening, migrating, registering, and mapping a dedicated SQLite runtime. */
+export interface InitializeMappedTypedSheetsOrmOptions extends InitializeMikroOrmSqliteAdapterOptions, CreateMappedTypedSheetsOrmOptions {
+    /**
+     * Optional control-plane hook invoked after local registry writes succeed.
+     *
+     * Applications can pass `provisionRegisteredSyncSheets()` here to provision
+     * the exact generated headers without duplicating route configuration.
+     */
+    readonly onRegisteredProjections?: (definitions: readonly RegisteredSyncProjectionDefinition[]) => Promise<void>;
+}
+/**
+ * Creates the public typed-sheets EntityManager facade with its built-in
+ * canonical/outbox planner. Mapping routes must already be registered.
+ */
+export declare function createMappedTypedSheetsOrm(storage: MikroOrmSqliteAdapter, options: CreateMappedTypedSheetsOrmOptions): TypedSheetsOrm;
+/**
+ * Opens a dedicated MikroORM SQLite runtime ready for mapped entity lifecycle work.
+ *
+ * Startup performs non-destructive entity/schema migration and idempotent local
+ * projection registration. Remote Apps Script provisioning remains explicit so
+ * a process cannot mutate a spreadsheet merely by opening its local database.
+ */
+export declare function initializeMappedTypedSheetsOrm(options: InitializeMappedTypedSheetsOrmOptions): Promise<TypedSheetsOrm>;
+//# sourceMappingURL=MikroOrmMappedTypedSheets.d.ts.map

package/dist/adapter/persistence/providers/mikro-orm/engine/MikroOrmMappedTypedSheets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MikroOrmMappedTypedSheets.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/persistence/providers/mikro-orm/engine/MikroOrmMappedTypedSheets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAKL,KAAK,wBAAwB,EAC7B,KAAK,gCAAgC,EACrC,KAAK,8BAA8B,EACnC,KAAK,cAAc,EACpB,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,iEAAiE,CAAC;AAI1H,OAAO,EAEL,KAAK,sCAAsC,EAC3C,KAAK,qBAAqB,EAC3B,MAAM,qCAAqC,CAAC;AAG7C,2FAA2F;AAC3F,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,QAAQ,EAAE,gCAAgC,GAAG,SAAS,wBAAwB,EAAE,CAAC;IAC1F,QAAQ,CAAC,MAAM,EAAE,8BAA8B,CAAC;CACjD;AAED,2FAA2F;AAC3F,MAAM,WAAW,qCACf,SAAQ,sCAAsC,EAAE,iCAAiC;IACjF;;;;;OAKG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CACjC,WAAW,EAAE,SAAS,kCAAkC,EAAE,KACvD,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,iCAAiC,GACzC,cAAc,CAQhB;AAED;;;;;;GAMG;AACH,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,qCAAqC,GAC7C,OAAO,CAAC,cAAc,CAAC,CAoBzB"}

package/dist/adapter/persistence/providers/mikro-orm/engine/MikroOrmMappedTypedSheets.js

@@ -0,0 +1,54 @@
+/**
+ * MikroORM convenience entrypoints for the built-in entity-to-Sheets mapping.
+ *
+ * The public `TypedSheetsOrm` remains ours. This module only chooses MikroORM
+ * as the current SQLite execution engine and performs the mapping registry
+ * setup before the application begins calling `em.persist()` and `em.flush()`.
+ */
+import { createMappedTypedSheetsFlushCoordinator, createTypedSheetsEntityMappingRegistry, registeredTypedSheetsProjectionDefinitions, registerTypedSheetsEntityMappings, } from "../../../../../application/orm/index.js";
+import { createTypedSheetsOrm, } from "./MikroOrmTypedSheetsEngine.js";
+import { initializeMikroOrmSqliteAdapter, } from "../storage/MikroOrmSqliteAdapter.js";
+import { migrateMikroOrmSqliteStorageSchema } from "../storage/MikroOrmSqliteSchema.js";
+/**
+ * Creates the public typed-sheets EntityManager facade with its built-in
+ * canonical/outbox planner. Mapping routes must already be registered.
+ */
+export function createMappedTypedSheetsOrm(storage, options) {
+    const mappings = mappingRegistry(options.mappings);
+    return createTypedSheetsOrm(storage, {
+        flushCoordinator: createMappedTypedSheetsFlushCoordinator({
+            mappings,
+            writer: options.writer,
+        }),
+    });
+}
+/**
+ * Opens a dedicated MikroORM SQLite runtime ready for mapped entity lifecycle work.
+ *
+ * Startup performs non-destructive entity/schema migration and idempotent local
+ * projection registration. Remote Apps Script provisioning remains explicit so
+ * a process cannot mutate a spreadsheet merely by opening its local database.
+ */
+export async function initializeMappedTypedSheetsOrm(options) {
+    const { mappings: mappingsInput, writer, onRegisteredProjections, ...adapterOptions } = options;
+    const mappings = mappingRegistry(mappingsInput);
+    const storage = await initializeMikroOrmSqliteAdapter(adapterOptions);
+    try {
+        await migrateMikroOrmSqliteStorageSchema(storage);
+        const registrations = await registerTypedSheetsEntityMappings(storage, mappings, writer);
+        if (onRegisteredProjections !== undefined) {
+            await onRegisteredProjections(registeredTypedSheetsProjectionDefinitions(registrations));
+        }
+        return createMappedTypedSheetsOrm(storage, { mappings, writer });
+    }
+    catch (error) {
+        await storage.close(true);
+        throw error;
+    }
+}
+function mappingRegistry(input) {
+    if ("findByEntityName" in input)
+        return input;
+    return createTypedSheetsEntityMappingRegistry(input);
+}
+//# sourceMappingURL=MikroOrmMappedTypedSheets.js.map

package/dist/adapter/persistence/providers/mikro-orm/engine/MikroOrmMappedTypedSheets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MikroOrmMappedTypedSheets.js","sourceRoot":"","sources":["../../../../../../src/adapter/persistence/providers/mikro-orm/engine/MikroOrmMappedTypedSheets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,uCAAuC,EACvC,sCAAsC,EACtC,0CAA0C,EAC1C,iCAAiC,GAKlC,MAAM,yCAAyC,CAAC;AAEjD,OAAO,EACL,oBAAoB,GACrB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,+BAA+B,GAGhC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,kCAAkC,EAAE,MAAM,oCAAoC,CAAC;AAsBxF;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAA8B,EAC9B,OAA0C;IAE1C,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnD,OAAO,oBAAoB,CAAC,OAAO,EAAE;QACnC,gBAAgB,EAAE,uCAAuC,CAAC;YACxD,QAAQ;YACR,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,OAA8C;IAE9C,MAAM,EACJ,QAAQ,EAAE,aAAa,EACvB,MAAM,EACN,uBAAuB,EACvB,GAAG,cAAc,EAClB,GAAG,OAAO,CAAC;IACZ,MAAM,QAAQ,GAAG,eAAe,CAAC,aAAa,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,MAAM,+BAA+B,CAAC,cAAc,CAAC,CAAC;IACtE,IAAI,CAAC;QACH,MAAM,kCAAkC,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,aAAa,GAAG,MAAM,iCAAiC,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QACzF,IAAI,uBAAuB,KAAK,SAAS,EAAE,CAAC;YAC1C,MAAM,uBAAuB,CAAC,0CAA0C,CAAC,aAAa,CAAC,CAAC,CAAC;QAC3F,CAAC;QACD,OAAO,0BAA0B,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IACnE,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CACtB,KAA6E;IAE7E,IAAI,kBAAkB,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IAC9C,OAAO,sCAAsC,CAAC,KAAK,CAAC,CAAC;AACvD,CAAC"}

package/dist/adapter/persistence/providers/mikro-orm/engine/MikroOrmTypedSheetsEngine.d.ts

@@ -0,0 +1,38 @@
+/**
+ * MikroORM implementation of the replaceable typed-sheets entity engine.
+ *
+ * This module owns engine construction and shutdown only. EntityManager
+ * delegation and changeset normalization live in focused adapter modules.
+ */
+import type { TypedSheetsEntityEngine, TypedSheetsEntityEngineManager } from "../../../../../application/orm/api/contracts.js";
+import type { CreateTypedSheetsOrmOptions, TypedSheetsOrm } from "../../../../../application/orm/api/TypedSheetsOrm.js";
+import { type InitializeMikroOrmSqliteAdapterOptions, type MikroOrmSqliteAdapter } from "../storage/MikroOrmSqliteAdapter.js";
+/** Options for initializing a dedicated typed-sheets SQLite ORM instance. */
+export interface InitializeTypedSheetsOrmOptions extends InitializeMikroOrmSqliteAdapterOptions {
+    /** Plans canonical and Sheets outbox work for every durable entity flush. */
+    readonly flushCoordinator: CreateTypedSheetsOrmOptions["flushCoordinator"];
+}
+/**
+ * Wraps the MikroORM SQLite adapter as our replaceable entity execution engine.
+ *
+ * A future Drizzle or another ORM implementation only needs to implement the
+ * same typed-sheets engine contract; application lifecycle calls stay stable.
+ */
+export declare class MikroOrmSqliteTypedSheetsEngine implements TypedSheetsEntityEngine {
+    private readonly storage;
+    constructor(storage: MikroOrmSqliteAdapter);
+    /** Opens a MikroORM-backed manager behind the typed-sheets engine boundary. */
+    fork(): TypedSheetsEntityEngineManager;
+    /** Closes the dedicated MikroORM SQLite connection. */
+    close(force?: boolean): Promise<void>;
+}
+/** Creates the replaceable typed-sheets engine backed by one SQLite adapter. */
+export declare function createMikroOrmSqliteTypedSheetsEngine(storage: MikroOrmSqliteAdapter): MikroOrmSqliteTypedSheetsEngine;
+/** Creates our public entity facade around an existing MikroORM SQLite adapter. */
+export declare function createTypedSheetsOrm(storage: MikroOrmSqliteAdapter, options: CreateTypedSheetsOrmOptions): TypedSheetsOrm;
+/**
+ * Opens and migrates a dedicated SQLite runtime, then returns our public ORM
+ * facade. Startup cleanup closes the adapter if migration or construction fails.
+ */
+export declare function initializeTypedSheetsOrm(options: InitializeTypedSheetsOrmOptions): Promise<TypedSheetsOrm>;
+//# sourceMappingURL=MikroOrmTypedSheetsEngine.d.ts.map

package/dist/adapter/persistence/providers/mikro-orm/engine/MikroOrmTypedSheetsEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MikroOrmTypedSheetsEngine.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/persistence/providers/mikro-orm/engine/MikroOrmTypedSheetsEngine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,uBAAuB,EACvB,8BAA8B,EAC/B,MAAM,iDAAiD,CAAC;AACzD,OAAO,KAAK,EACV,2BAA2B,EAC3B,cAAc,EACf,MAAM,sDAAsD,CAAC;AAC9D,OAAO,EAEL,KAAK,sCAAsC,EAC3C,KAAK,qBAAqB,EAC3B,MAAM,qCAAqC,CAAC;AAI7C,6EAA6E;AAC7E,MAAM,WAAW,+BAAgC,SAAQ,sCAAsC;IAC7F,6EAA6E;IAC7E,QAAQ,CAAC,gBAAgB,EAAE,2BAA2B,CAAC,kBAAkB,CAAC,CAAC;CAC5E;AAED;;;;;GAKG;AACH,qBAAa,+BAAgC,YAAW,uBAAuB;IACjE,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,qBAAqB;IAE3D,+EAA+E;IAC/E,IAAI,IAAI,8BAA8B;IAOtC,uDAAuD;IACjD,KAAK,CAAC,KAAK,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAG1C;AAED,gFAAgF;AAChF,wBAAgB,qCAAqC,CACnD,OAAO,EAAE,qBAAqB,GAC7B,+BAA+B,CAEjC;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,2BAA2B,GACnC,cAAc,CAEhB;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,cAAc,CAAC,CAUzB"}

package/dist/adapter/persistence/providers/mikro-orm/engine/MikroOrmTypedSheetsEngine.js

@@ -0,0 +1,55 @@
+/**
+ * MikroORM implementation of the replaceable typed-sheets entity engine.
+ *
+ * This module owns engine construction and shutdown only. EntityManager
+ * delegation and changeset normalization live in focused adapter modules.
+ */
+import { createTypedSheetsOrm as createTypedSheetsOrmFacade } from "../../../../../application/orm/api/TypedSheetsOrm.js";
+import { initializeMikroOrmSqliteAdapter, } from "../storage/MikroOrmSqliteAdapter.js";
+import { MikroOrmSqliteTypedSheetsEntityManager } from "../api/MikroOrmTypedSheetsEntityManager.js";
+import { migrateMikroOrmSqliteStorageSchema } from "../storage/MikroOrmSqliteSchema.js";
+/**
+ * Wraps the MikroORM SQLite adapter as our replaceable entity execution engine.
+ *
+ * A future Drizzle or another ORM implementation only needs to implement the
+ * same typed-sheets engine contract; application lifecycle calls stay stable.
+ */
+export class MikroOrmSqliteTypedSheetsEngine {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /** Opens a MikroORM-backed manager behind the typed-sheets engine boundary. */
+    fork() {
+        return new MikroOrmSqliteTypedSheetsEntityManager(this.storage, this.storage.forkEntityManager());
+    }
+    /** Closes the dedicated MikroORM SQLite connection. */
+    async close(force = false) {
+        await this.storage.close(force);
+    }
+}
+/** Creates the replaceable typed-sheets engine backed by one SQLite adapter. */
+export function createMikroOrmSqliteTypedSheetsEngine(storage) {
+    return new MikroOrmSqliteTypedSheetsEngine(storage);
+}
+/** Creates our public entity facade around an existing MikroORM SQLite adapter. */
+export function createTypedSheetsOrm(storage, options) {
+    return createTypedSheetsOrmFacade(createMikroOrmSqliteTypedSheetsEngine(storage), options);
+}
+/**
+ * Opens and migrates a dedicated SQLite runtime, then returns our public ORM
+ * facade. Startup cleanup closes the adapter if migration or construction fails.
+ */
+export async function initializeTypedSheetsOrm(options) {
+    const { flushCoordinator, ...adapterOptions } = options;
+    const storage = await initializeMikroOrmSqliteAdapter(adapterOptions);
+    try {
+        await migrateMikroOrmSqliteStorageSchema(storage);
+        return createTypedSheetsOrm(storage, { flushCoordinator });
+    }
+    catch (error) {
+        await storage.close(true);
+        throw error;
+    }
+}
+//# sourceMappingURL=MikroOrmTypedSheetsEngine.js.map

package/dist/adapter/persistence/providers/mikro-orm/engine/MikroOrmTypedSheetsEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MikroOrmTypedSheetsEngine.js","sourceRoot":"","sources":["../../../../../../src/adapter/persistence/providers/mikro-orm/engine/MikroOrmTypedSheetsEngine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,IAAI,0BAA0B,EAAE,MAAM,sDAAsD,CAAC;AAS1H,OAAO,EACL,+BAA+B,GAGhC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,sCAAsC,EAAE,MAAM,4CAA4C,CAAC;AACpG,OAAO,EAAE,kCAAkC,EAAE,MAAM,oCAAoC,CAAC;AAQxF;;;;;GAKG;AACH,MAAM,OAAO,+BAA+B;IACb;IAA7B,YAA6B,OAA8B;QAA9B,YAAO,GAAP,OAAO,CAAuB;IAAG,CAAC;IAE/D,+EAA+E;IAC/E,IAAI;QACF,OAAO,IAAI,sCAAsC,CAC/C,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,CACjC,CAAC;IACJ,CAAC;IAED,uDAAuD;IACvD,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK;QACvB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;CACF;AAED,gFAAgF;AAChF,MAAM,UAAU,qCAAqC,CACnD,OAA8B;IAE9B,OAAO,IAAI,+BAA+B,CAAC,OAAO,CAAC,CAAC;AACtD,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,oBAAoB,CAClC,OAA8B,EAC9B,OAAoC;IAEpC,OAAO,0BAA0B,CAAC,qCAAqC,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;AAC7F,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAwC;IAExC,MAAM,EAAE,gBAAgB,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,CAAC;IACxD,MAAM,OAAO,GAAG,MAAM,+BAA+B,CAAC,cAAc,CAAC,CAAC;IACtE,IAAI,CAAC;QACH,MAAM,kCAAkC,CAAC,OAAO,CAAC,CAAC;QAClD,OAAO,oBAAoB,CAAC,OAAO,EAAE,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/adapter/persistence/providers/mikro-orm/index.d.ts

@@ -0,0 +1,16 @@
+export { createMikroOrmSqliteAdapter, initializeMikroOrmSqliteAdapter, MikroOrmSqliteAdapter, } from "./storage/MikroOrmSqliteAdapter.js";
+export { createMikroOrmSqliteTypedSheetsEngine, createTypedSheetsOrm, initializeTypedSheetsOrm, MikroOrmSqliteTypedSheetsEngine, } from "./engine/MikroOrmTypedSheetsEngine.js";
+export { persistMappedObservedRowWithMikroOrm } from "./observation/MikroOrmMappedObservation.js";
+export { createMappedTypedSheetsOrm, initializeMappedTypedSheetsOrm, } from "./engine/MikroOrmMappedTypedSheets.js";
+export { TypedSheetsEntityManager, TypedSheetsOrm, } from "../../../../application/orm/index.js";
+export { migrateMikroOrmSqliteSchema, migrateMikroOrmSqliteStorageSchema, } from "./storage/MikroOrmSqliteSchema.js";
+export { runSyncEffectWorkerWithAdapter } from "../../../../application/sync/outbound/effects/SyncEffectWorker.js";
+export { createSyncEffectWorkerSupervisor, SyncEffectWorkerSupervisor, } from "../../../../application/sync/outbound/effects/SyncEffectSupervisor.js";
+export type { InitializeMikroOrmSqliteAdapterOptions, MikroOrmSqlite, MikroOrmSqliteConfiguration, MikroOrmSqliteEntity, MikroOrmSqliteEntityManager, MikroOrmSqliteTransaction, } from "./storage/MikroOrmSqliteAdapter.js";
+export type { InitializeTypedSheetsOrmOptions, } from "./engine/MikroOrmTypedSheetsEngine.js";
+export type { PersistMappedObservedRowOptions } from "./observation/MikroOrmMappedObservation.js";
+export type { CreateMappedTypedSheetsOrmOptions, InitializeMappedTypedSheetsOrmOptions, } from "./engine/MikroOrmMappedTypedSheets.js";
+export type { CreateTypedSheetsOrmOptions } from "../../../../application/orm/index.js";
+export type { SyncEffectWorkerReport, SyncEffectWorkerWithAdapterOptions, } from "../../../../application/sync/outbound/effects/SyncEffectWorker.js";
+export type { CreateSyncEffectWorkerSupervisorOptions, SyncEffectWorkerSupervisorReconciliationOptions, SyncEffectWorkerSupervisorLoopOptions, SyncEffectWorkerSupervisorWait, } from "../../../../application/sync/outbound/effects/SyncEffectSupervisor.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/adapter/persistence/providers/mikro-orm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/adapter/persistence/providers/mikro-orm/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,EAC/B,qBAAqB,GACtB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,qCAAqC,EACrC,oBAAoB,EACpB,wBAAwB,EACxB,+BAA+B,GAChC,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,oCAAoC,EAAE,MAAM,4CAA4C,CAAC;AAClG,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,wBAAwB,EACxB,cAAc,GACf,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,2BAA2B,EAC3B,kCAAkC,GACnC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,8BAA8B,EAAE,MAAM,mEAAmE,CAAC;AACnH,OAAO,EACL,gCAAgC,EAChC,0BAA0B,GAC3B,MAAM,uEAAuE,CAAC;AAC/E,YAAY,EACV,sCAAsC,EACtC,cAAc,EACd,2BAA2B,EAC3B,oBAAoB,EACpB,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,oCAAoC,CAAC;AAC5C,YAAY,EACV,+BAA+B,GAChC,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EAAE,+BAA+B,EAAE,MAAM,4CAA4C,CAAC;AAClG,YAAY,EACV,iCAAiC,EACjC,qCAAqC,GACtC,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACxF,YAAY,EACV,sBAAsB,EACtB,kCAAkC,GACnC,MAAM,mEAAmE,CAAC;AAC3E,YAAY,EACV,uCAAuC,EACvC,+CAA+C,EAC/C,qCAAqC,EACrC,8BAA8B,GAC/B,MAAM,uEAAuE,CAAC"}

package/dist/adapter/persistence/providers/mikro-orm/index.js

@@ -0,0 +1,9 @@
+export { createMikroOrmSqliteAdapter, initializeMikroOrmSqliteAdapter, MikroOrmSqliteAdapter, } from "./storage/MikroOrmSqliteAdapter.js";
+export { createMikroOrmSqliteTypedSheetsEngine, createTypedSheetsOrm, initializeTypedSheetsOrm, MikroOrmSqliteTypedSheetsEngine, } from "./engine/MikroOrmTypedSheetsEngine.js";
+export { persistMappedObservedRowWithMikroOrm } from "./observation/MikroOrmMappedObservation.js";
+export { createMappedTypedSheetsOrm, initializeMappedTypedSheetsOrm, } from "./engine/MikroOrmMappedTypedSheets.js";
+export { TypedSheetsEntityManager, TypedSheetsOrm, } from "../../../../application/orm/index.js";
+export { migrateMikroOrmSqliteSchema, migrateMikroOrmSqliteStorageSchema, } from "./storage/MikroOrmSqliteSchema.js";
+export { runSyncEffectWorkerWithAdapter } from "../../../../application/sync/outbound/effects/SyncEffectWorker.js";
+export { createSyncEffectWorkerSupervisor, SyncEffectWorkerSupervisor, } from "../../../../application/sync/outbound/effects/SyncEffectSupervisor.js";
+//# sourceMappingURL=index.js.map

package/dist/adapter/persistence/providers/mikro-orm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/adapter/persistence/providers/mikro-orm/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,EAC/B,qBAAqB,GACtB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,qCAAqC,EACrC,oBAAoB,EACpB,wBAAwB,EACxB,+BAA+B,GAChC,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,oCAAoC,EAAE,MAAM,4CAA4C,CAAC;AAClG,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,wBAAwB,EACxB,cAAc,GACf,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,2BAA2B,EAC3B,kCAAkC,GACnC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,8BAA8B,EAAE,MAAM,mEAAmE,CAAC;AACnH,OAAO,EACL,gCAAgC,EAChC,0BAA0B,GAC3B,MAAM,uEAAuE,CAAC"}

package/dist/adapter/persistence/providers/mikro-orm/observation/MikroOrmMappedObservation.d.ts

@@ -0,0 +1,27 @@
+/**
+ * MikroORM bridge for applying accepted Sheet observations to mapped entities.
+ *
+ * It deliberately uses MikroORM's native write methods rather than the public
+ * Unit of Work(작업 단위). The observation has already created its canonical and
+ * outbox records, and replaying `onFlush` here would incorrectly schedule a
+ * second outbound Sheets projection.
+ */
+import { type FencingContext, type PersistObservedRowInput, type PersistObservedRowResult } from "../../../../../infrastructure/storage/index.js";
+import { type TypedSheetsEntityMapping, type TypedSheetsEntityMappingRegistry } from "../../../../../application/orm/mapping/entityMapping.js";
+import type { MikroOrmSqliteAdapter } from "../storage/MikroOrmSqliteAdapter.js";
+/** Input for committing one pre-evaluated Sheet observation and its entity update together. */
+export interface PersistMappedObservedRowOptions {
+    readonly mappings: TypedSheetsEntityMappingRegistry | readonly TypedSheetsEntityMapping[];
+    readonly fence: FencingContext;
+    readonly input: PersistObservedRowInput;
+}
+/**
+ * Persists a normalized observation and the matching MikroORM entity mutation
+ * in one SQLite transaction.
+ *
+ * Only a `persisted`(저장 완료) observation with a present canonical commit can
+ * change the entity table. Duplicate, quarantined, stale, fenced-out, and
+ * conflict-only observations leave application entities untouched.
+ */
+export declare function persistMappedObservedRowWithMikroOrm(storage: MikroOrmSqliteAdapter, options: PersistMappedObservedRowOptions): Promise<PersistObservedRowResult>;
+//# sourceMappingURL=MikroOrmMappedObservation.d.ts.map

package/dist/adapter/persistence/providers/mikro-orm/observation/MikroOrmMappedObservation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MikroOrmMappedObservation.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/persistence/providers/mikro-orm/observation/MikroOrmMappedObservation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC9B,MAAM,gDAAgD,CAAC;AAExD,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,gCAAgC,EACtC,MAAM,yDAAyD,CAAC;AASjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAEjF,+FAA+F;AAC/F,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,QAAQ,EAAE,gCAAgC,GAAG,SAAS,wBAAwB,EAAE,CAAC;IAC1F,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;CACzC;AAYD;;;;;;;GAOG;AACH,wBAAsB,oCAAoC,CACxD,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,wBAAwB,CAAC,CA+BnC"}

package/dist/adapter/persistence/providers/mikro-orm/observation/MikroOrmMappedObservation.js

@@ -0,0 +1,67 @@
+/**
+ * MikroORM bridge for applying accepted Sheet observations to mapped entities.
+ *
+ * It deliberately uses MikroORM's native write methods rather than the public
+ * Unit of Work(작업 단위). The observation has already created its canonical and
+ * outbox records, and replaying `onFlush` here would incorrectly schedule a
+ * second outbound Sheets projection.
+ */
+import { PRESENCE_KINDS } from "../../../../../shared/state/index.js";
+import { persistObservedRowWithSql, } from "../../../../../infrastructure/storage/index.js";
+import { OBSERVATION_WRITE_RESULT_KINDS } from "../../../../../infrastructure/storage/state/observation/observationConstants.js";
+import { createTypedSheetsEntityMappingRegistry, } from "../../../../../application/orm/mapping/entityMapping.js";
+import { MAPPED_OBSERVATION_ENTITY_MUTATION_KINDS, planMappedObservationEntityMutation, } from "../../../../../application/orm/mapping/observationMapping.js";
+import { TYPED_SHEETS_ORM_ERROR_CODES, TypedSheetsOrmError, } from "../../../../../application/orm/errors.js";
+/**
+ * Persists a normalized observation and the matching MikroORM entity mutation
+ * in one SQLite transaction.
+ *
+ * Only a `persisted`(저장 완료) observation with a present canonical commit can
+ * change the entity table. Duplicate, quarantined, stale, fenced-out, and
+ * conflict-only observations leave application entities untouched.
+ */
+export async function persistMappedObservedRowWithMikroOrm(storage, options) {
+    const mappings = mappingRegistry(options.mappings);
+    const mapping = mappings.findByPhysicalSheetId(options.input.physicalSheetId);
+    if (mapping === undefined || mapping.logicalSheetId !== options.input.batch.sheetId) {
+        throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.ENTITY_MAPPING_NOT_FOUND, `no entity mapping is registered for observed sheet ${options.input.physicalSheetId}.`);
+    }
+    return storage.transactional(async ({ entityManager, sql }) => {
+        const result = await persistObservedRowWithSql(sql, options.fence, options.input);
+        const canonical = options.input.canonical;
+        if (result.kind !== OBSERVATION_WRITE_RESULT_KINDS.PERSISTED ||
+            canonical.kind !== PRESENCE_KINDS.PRESENT) {
+            return result;
+        }
+        const mutation = planMappedObservationEntityMutation(mapping, canonical.value.commit);
+        await applyMappedMutation(entityManager, mapping, mutation);
+        return result;
+    });
+}
+async function applyMappedMutation(entityManager, mapping, mutation) {
+    switch (mutation.kind) {
+        case MAPPED_OBSERVATION_ENTITY_MUTATION_KINDS.NONE:
+            return;
+        case MAPPED_OBSERVATION_ENTITY_MUTATION_KINDS.INSERT:
+            await entityManager.insert(mapping.entity, { ...mutation.data });
+            return;
+        case MAPPED_OBSERVATION_ENTITY_MUTATION_KINDS.UPDATE:
+            await requireExactlyOneMutation(entityManager.nativeUpdate(mapping.entity, { [mapping.primaryKey]: mutation.entityId }, { ...mutation.data }), mapping, mutation.entityId, "update");
+            return;
+        case MAPPED_OBSERVATION_ENTITY_MUTATION_KINDS.DELETE:
+            await requireExactlyOneMutation(entityManager.nativeDelete(mapping.entity, { [mapping.primaryKey]: mutation.entityId }), mapping, mutation.entityId, "delete");
+            return;
+    }
+}
+async function requireExactlyOneMutation(mutation, mapping, entityId, operation) {
+    const changed = await mutation;
+    if (changed === 1)
+        return;
+    throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.OBSERVATION_ENTITY_MUTATION_FAILED, `accepted observation could not ${operation} exactly one ${mapping.entityName}:${entityId}.`);
+}
+function mappingRegistry(input) {
+    if ("findByEntityName" in input)
+        return input;
+    return createTypedSheetsEntityMappingRegistry(input);
+}
+//# sourceMappingURL=MikroOrmMappedObservation.js.map

package/dist/adapter/persistence/providers/mikro-orm/observation/MikroOrmMappedObservation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MikroOrmMappedObservation.js","sourceRoot":"","sources":["../../../../../../src/adapter/persistence/providers/mikro-orm/observation/MikroOrmMappedObservation.ts"],"names":[],"mappings":"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"}

package/dist/adapter/persistence/providers/mikro-orm/storage/MikroOrmFlushChanges.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Pure translation from MikroORM changesets to the adapter-neutral lifecycle
+ * contract. No database writes or EntityManager state changes happen here.
+ */
+import { ChangeSetType } from "@mikro-orm/core";
+import type { ChangeSet, FlushEventArgs } from "@mikro-orm/core";
+import { type TypedSheetsEntityChange, type TypedSheetsEntityChangeKind } from "../../../../../application/orm/api/contracts.js";
+/**
+ * Collects one effective change per entity from MikroORM's early and regular
+ * changesets. A create-then-delete pair cancels before the planner sees it.
+ */
+export declare function collectMikroOrmFlushChanges(args: FlushEventArgs): readonly TypedSheetsEntityChange[];
+/** Converts one MikroORM changeset into the public lifecycle shape. */
+export declare function toTypedSheetsEntityChange(changeSet: ChangeSet<object>): TypedSheetsEntityChange;
+/** Coalesces multiple changesets for one entity without mutating either input. */
+export declare function mergeMikroOrmEntityChanges(current: TypedSheetsEntityChange, next: TypedSheetsEntityChange): TypedSheetsEntityChange;
+/** Maps every MikroORM changeset type to our closed lifecycle set. */
+export declare function toTypedSheetsChangeKind(changeSetType: ChangeSetType): TypedSheetsEntityChangeKind;
+//# sourceMappingURL=MikroOrmFlushChanges.d.ts.map

package/dist/adapter/persistence/providers/mikro-orm/storage/MikroOrmFlushChanges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MikroOrmFlushChanges.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/persistence/providers/mikro-orm/storage/MikroOrmFlushChanges.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjE,OAAO,EAGL,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,EACjC,MAAM,iDAAiD,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,cAAc,GACnB,SAAS,uBAAuB,EAAE,CAmBpC;AAED,uEAAuE;AACvE,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,GAC3B,uBAAuB,CAQzB;AAED,kFAAkF;AAClF,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,uBAAuB,EAChC,IAAI,EAAE,uBAAuB,GAC5B,uBAAuB,CAazB;AAED,sEAAsE;AACtE,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,aAAa,GAC3B,2BAA2B,CAW7B"}

package/dist/adapter/persistence/providers/mikro-orm/storage/MikroOrmFlushChanges.js

@@ -0,0 +1,67 @@
+/**
+ * Pure translation from MikroORM changesets to the adapter-neutral lifecycle
+ * contract. No database writes or EntityManager state changes happen here.
+ */
+import { ChangeSetType } from "@mikro-orm/core";
+import { primaryKeyPresence, TYPED_SHEETS_ENTITY_CHANGE_KINDS, } from "../../../../../application/orm/api/contracts.js";
+/**
+ * Collects one effective change per entity from MikroORM's early and regular
+ * changesets. A create-then-delete pair cancels before the planner sees it.
+ */
+export function collectMikroOrmFlushChanges(args) {
+    const changesByEntity = new Map();
+    for (const changeSet of args.uow.getChangeSets()) {
+        const next = toTypedSheetsEntityChange(changeSet);
+        const current = changesByEntity.get(next.entity);
+        if (current === undefined) {
+            changesByEntity.set(next.entity, next);
+            continue;
+        }
+        if (current.kind === TYPED_SHEETS_ENTITY_CHANGE_KINDS.CREATE &&
+            next.kind === TYPED_SHEETS_ENTITY_CHANGE_KINDS.DELETE) {
+            changesByEntity.delete(next.entity);
+            continue;
+        }
+        changesByEntity.set(next.entity, mergeMikroOrmEntityChanges(current, next));
+    }
+    return [...changesByEntity.values()];
+}
+/** Converts one MikroORM changeset into the public lifecycle shape. */
+export function toTypedSheetsEntityChange(changeSet) {
+    return {
+        kind: toTypedSheetsChangeKind(changeSet.type),
+        entityName: changeSet.meta.className,
+        entity: changeSet.entity,
+        primaryKey: primaryKeyPresence(changeSet.getSerializedPrimaryKey()),
+        payload: { ...changeSet.payload },
+    };
+}
+/** Coalesces multiple changesets for one entity without mutating either input. */
+export function mergeMikroOrmEntityChanges(current, next) {
+    const kind = next.kind === TYPED_SHEETS_ENTITY_CHANGE_KINDS.DELETE
+        ? TYPED_SHEETS_ENTITY_CHANGE_KINDS.DELETE
+        : current.kind === TYPED_SHEETS_ENTITY_CHANGE_KINDS.CREATE
+            ? TYPED_SHEETS_ENTITY_CHANGE_KINDS.CREATE
+            : next.kind;
+    return {
+        ...next,
+        kind,
+        payload: kind === TYPED_SHEETS_ENTITY_CHANGE_KINDS.DELETE
+            ? next.payload
+            : { ...current.payload, ...next.payload },
+    };
+}
+/** Maps every MikroORM changeset type to our closed lifecycle set. */
+export function toTypedSheetsChangeKind(changeSetType) {
+    switch (changeSetType) {
+        case ChangeSetType.CREATE:
+            return TYPED_SHEETS_ENTITY_CHANGE_KINDS.CREATE;
+        case ChangeSetType.UPDATE:
+        case ChangeSetType.UPDATE_EARLY:
+            return TYPED_SHEETS_ENTITY_CHANGE_KINDS.UPDATE;
+        case ChangeSetType.DELETE:
+        case ChangeSetType.DELETE_EARLY:
+            return TYPED_SHEETS_ENTITY_CHANGE_KINDS.DELETE;
+    }
+}
+//# sourceMappingURL=MikroOrmFlushChanges.js.map

package/dist/adapter/persistence/providers/mikro-orm/storage/MikroOrmFlushChanges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MikroOrmFlushChanges.js","sourceRoot":"","sources":["../../../../../../src/adapter/persistence/providers/mikro-orm/storage/MikroOrmFlushChanges.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EACL,kBAAkB,EAClB,gCAAgC,GAGjC,MAAM,iDAAiD,CAAC;AAEzD;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,IAAoB;IAEpB,MAAM,eAAe,GAAG,IAAI,GAAG,EAAmC,CAAC;IACnE,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,CAAC;QACjD,MAAM,IAAI,GAAG,yBAAyB,CAAC,SAAS,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACvC,SAAS;QACX,CAAC;QACD,IACE,OAAO,CAAC,IAAI,KAAK,gCAAgC,CAAC,MAAM;YACxD,IAAI,CAAC,IAAI,KAAK,gCAAgC,CAAC,MAAM,EACrD,CAAC;YACD,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACpC,SAAS;QACX,CAAC;QACD,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,0BAA0B,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,CAAC,GAAG,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,yBAAyB,CACvC,SAA4B;IAE5B,OAAO;QACL,IAAI,EAAE,uBAAuB,CAAC,SAAS,CAAC,IAAI,CAAC;QAC7C,UAAU,EAAE,SAAS,CAAC,IAAI,CAAC,SAAS;QACpC,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,UAAU,EAAE,kBAAkB,CAAC,SAAS,CAAC,uBAAuB,EAAE,CAAC;QACnE,OAAO,EAAE,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE;KAClC,CAAC;AACJ,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,0BAA0B,CACxC,OAAgC,EAChC,IAA6B;IAE7B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,gCAAgC,CAAC,MAAM;QAChE,CAAC,CAAC,gCAAgC,CAAC,MAAM;QACzC,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,gCAAgC,CAAC,MAAM;YACxD,CAAC,CAAC,gCAAgC,CAAC,MAAM;YACzC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAChB,OAAO;QACL,GAAG,IAAI;QACP,IAAI;QACJ,OAAO,EAAE,IAAI,KAAK,gCAAgC,CAAC,MAAM;YACvD,CAAC,CAAC,IAAI,CAAC,OAAO;YACd,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE;KAC5C,CAAC;AACJ,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,uBAAuB,CACrC,aAA4B;IAE5B,QAAQ,aAAa,EAAE,CAAC;QACtB,KAAK,aAAa,CAAC,MAAM;YACvB,OAAO,gCAAgC,CAAC,MAAM,CAAC;QACjD,KAAK,aAAa,CAAC,MAAM,CAAC;QAC1B,KAAK,aAAa,CAAC,YAAY;YAC7B,OAAO,gCAAgC,CAAC,MAAM,CAAC;QACjD,KAAK,aAAa,CAAC,MAAM,CAAC;QAC1B,KAAK,aAAa,CAAC,YAAY;YAC7B,OAAO,gCAAgC,CAAC,MAAM,CAAC;IACnD,CAAC;AACH,CAAC"}