hikoutei 0.5.20 → 0.5.22

package/README.ja.md

@@ -121,9 +121,12 @@ API クライアントを直接使ってください。
 
 Google Sheets の同期はサービス側の関心事です。アプリケーションは provider
 クライアントを import したり、`createTypedSheets()` にシートルートを渡したり、
-書き込みごとに操作を選んだりしません。同期ランタイムはサービスアカウントを
-使う単一の Google Sheets API provider(内部 `googleSheetsApi` bootstrap オプ
-ション)を使用します — Apps Script のデプロイは不要です。
+書き込みごとに操作を選んだりしません — ルート API が受け取るのは `dbName` と
+`entities` だけです。同期ランタイムはサービスアカウントを使う単一の内部
+Google Sheets API provider を使用します — Apps Script のデプロイは不要です。
+同期の自動開始は `HIKOUTEI_SYNC_SPREADSHEET_URL` と
+`GOOGLE_APPLICATION_CREDENTIALS` で選択され、設定する公開
+`googleSheetsApi` bootstrap オプションはありません。
 
 ### 環境変数による同期の自動開始
 
@@ -145,7 +148,7 @@ const hikoutei = await createTypedSheets({ dbName: "./hikoutei.sqlite", entities
 不正、資格情報ファイルの欠落・不正、スプレッドシートに共有されていない
 サービスアカウント (共有すべきメールアドレスをエラーが教えてくれます)。
 
-### Service-account provider (googleSheetsApi)
+### 手動でのサービスアカウント設定
 
 1. **サービスアカウントを作成する。** Cloud プロジェクトで Google Sheets API
    を有効化し、`https://www.googleapis.com/auth/spreadsheets` スコープの
@@ -157,9 +160,17 @@ const hikoutei = await createTypedSheets({ dbName: "./hikoutei.sqlite", entities
    `GOOGLE_APPLICATION_CREDENTIALS` に、スプレッドシート ID は追跡されない
    シークレットストアに置きます。キーをブラウザコードや Git に入れないで
    ください。
-3. **内部 sync bootstrap を起動する。** `googleSheetsApi` を設定すると、
-   登録済みタブのヘッダーを作成・検証した後、outbox 配信と User_Input ポー
-   リングを開始します。
+3. **アプリケーションを通常どおり実行する。** `GOOGLE_APPLICATION_CREDENTIALS`
+   と `HIKOUTEI_SYNC_SPREADSHEET_URL` を設定した状態でアプリを起動すると、
+   `createTypedSheets()` がそれを検出して内部 sync bootstrap を開始します —
+   登録済みタブのヘッダーを作成・検証した後、outbox 配信と User_Input
+   ポーリングを開始します。渡す provider オプションも、手動で開始する内部
+   bootstrap もありません。
+
+> **レガシースプレッドシートの注意。** 旧 Apps Script provider が developer
+> metadata の行アンカーでプロビジョニングしたスプレッドシートは移行されませ
+> ん。`User_Input` タブは `__hikoutei_row_id` システム列を必要とするため、
+> レガシータブは再プロビジョニングが必要です。
 
 Hikoutei は、永続的なローカル outbox・冪等な配信・競合を考慮した更新を使う
 ため、一時的な API 障害でコミット済みのアプリケーション書き込みが失われる
@@ -211,8 +222,11 @@ Hikoutei は活発に開発中です。現在の EntityManager は、スカラ
 `limit` / `offset` ページネーション、コールバック形式の `transactional()` を
 サポートします。通常の読み取り元は常に SQLite であり、Google Sheets では
 ありません。
-シート編集の取り込みと競合表示はまだ発展途上です。マイナーバージョンの
-アップグレード前にリリースノートを確認してください。
+`hikoutei setup` CLI がスプレッドシートとサービスアカウントをプロビジョニ
+ングし、direct Google Sheets API provider(環境変数による自動開始)が唯一の
+同期経路です — Apps Script ゲートウェイはありません。シート編集の取り込みと
+競合表示はまだ発展途上です。マイナーバージョンのアップグレード前にリリース
+ノートを確認してください。
 
 ## ロードマップ
 
@@ -245,7 +259,6 @@ EntityManager のロードマップは、以下の実装順序に従います。
 
 - Google Sheets からの意図的なユーザー編集の取り込みを完了する
 - 更新・削除の競合処理と表示を改善する
-- レジストリと direct-provider デプロイのセットアップツールを改善する
 
 現在の作業は[オープンな Issues](https://github.com/ManddarinShop/Hikoutei/issues)を
 参照してください。

package/README.ko.md

@@ -118,9 +118,11 @@ Hikoutei는 `google-spreadsheet`나 `@googleapis/sheets`를 대체하지 않습
 
 Google Sheets 동기화는 서비스 측 관심사입니다. 애플리케이션은 provider
 클라이언트를 import하거나, Sheet 라우트를 `createTypedSheets()`에 넘기거나,
-쓰기마다 연산을 선택하지 않습니다. 동기화 런타임은 서비스 계정을 사용하는
-하나의 Google Sheets API provider(내부 `googleSheetsApi` bootstrap 옵션)를
-사용합니다 — Apps Script 배포가 없습니다.
+쓰기마다 연산을 선택하지 않습니다 — 루트 API는 `dbName`과 `entities`만
+받습니다. 동기화 런타임은 서비스 계정을 사용하는 하나의 내부 Google Sheets
+API provider를 사용합니다 — Apps Script 배포가 없습니다. 동기화 자동 시작은
+`HIKOUTEI_SYNC_SPREADSHEET_URL`과 `GOOGLE_APPLICATION_CREDENTIALS`로
+선택되며, 설정할 공개 `googleSheetsApi` bootstrap 옵션은 없습니다.
 
 ### 환경 변수 기반 동기화 자동 시작
 
@@ -142,7 +144,7 @@ const hikoutei = await createTypedSheets({ dbName: "./hikoutei.sqlite", entities
 없거나 잘못된 자격 증명 파일, 스프레드시트에 공유되지 않은 서비스 계정
 (어떤 이메일을 공유해야 하는지 에러가 알려줍니다).
 
-### Service-account provider (googleSheetsApi)
+### 수동 서비스 계정 설정
 
 1. **서비스 계정을 만듭니다.** Cloud 프로젝트에서 Google Sheets API를
    활성화하고, `https://www.googleapis.com/auth/spreadsheets` 스코프의
@@ -152,9 +154,16 @@ const hikoutei = await createTypedSheets({ dbName: "./hikoutei.sqlite", entities
 2. **키를 서버 측에 둡니다.** 서비스 계정 키 경로를 서버의
    `GOOGLE_APPLICATION_CREDENTIALS`에, 스프레드시트 ID는 추적되지 않는
    비밀 저장소에 둡니다. 키를 브라우저 코드나 Git에 넣지 마세요.
-3. **내부 sync bootstrap을 기동합니다.** `googleSheetsApi`를 설정하면
+3. **애플리케이션을 정상적으로 실행합니다.** `GOOGLE_APPLICATION_CREDENTIALS`와
+   `HIKOUTEI_SYNC_SPREADSHEET_URL`을 설정한 상태로 앱을 시작하면
+   `createTypedSheets()`가 이를 감지해 내부 sync bootstrap을 시작합니다 —
    등록된 탭의 헤더를 만들고 검증한 뒤 outbox 전달과 User_Input 폴링을
-   시작합니다.
+   시작합니다. 넘길 provider 옵션이나 직접 시작할 내부 bootstrap은 없습니다.
+
+> **레거시 스프레드시트 참고.** 이전 Apps Script provider가 developer
+> metadata 행 anchor로 프로비저닝한 스프레드시트는 마이그레이션되지
+> 않습니다. `User_Input` 탭은 이제 `__hikoutei_row_id` 시스템 컬럼이
+> 필요하므로 레거시 탭을 다시 프로비저닝해야 합니다.
 
 Hikoutei는 내구성 있는 로컬 outbox, 멱등 전달, 충돌을 인지하는 업데이트를
 사용하므로 일시적인 API 실패가 커밋된 애플리케이션 쓰기를 잃게 하지 않습니다.
@@ -204,7 +213,10 @@ MikroORM은 구현 세부 사항이며 Hikoutei의 공개 엔티티 API에는
 Hikoutei는 활발히 개발 중입니다. 현재 EntityManager는 스칼라 엔티티의 생명주기
 작업, 동등 조건을 사용하는 `find()` / `findOne()`, `find()`의 `limit` /
 `offset` 페이지네이션, 콜백형 `transactional()`을 지원합니다. 일반 읽기는
-Google Sheets가 아니라 항상 SQLite에서 수행됩니다. 시트 편집 수집과 충돌 표시는
+Google Sheets가 아니라 항상 SQLite에서 수행됩니다. `hikoutei setup` CLI가
+스프레드시트와 서비스 계정을 프로비저닝하며, direct Google Sheets API
+provider(환경 변수 자동 시작)가 유일한 sync 경로입니다 — Apps Script
+gateway가 없습니다. 시트 편집 수집과 충돌 표시는
 아직 발전 중입니다. 마이너 버전 업그레이드 전에 릴리스 노트를 확인하세요.
 
 ## 로드맵
@@ -238,7 +250,6 @@ EntityManager 로드맵은 아래 구현 순서를 따릅니다. 단계 순서
 
 - Google Sheets에서 의도적인 사용자 편집 수집 완성
 - 업데이트·삭제 충돌 처리와 표시 개선
-- 레지스트리 및 direct-provider 배포를 위한 설정 도구 개선
 
 현재 작업은 [오픈 이슈](https://github.com/ManddarinShop/Hikoutei/issues)를
 참고하세요.

package/README.md

@@ -121,9 +121,11 @@ client directly.
 
 Google Sheets synchronization is a service-side concern. Applications do not
 import a provider client, pass Sheet routes to `createTypedSheets()`, or choose
-an operation for each write. The sync runtime uses one Google Sheets API
-provider (the internal `googleSheetsApi` bootstrap option) with a service
-account — no Apps Script deployment.
+an operation for each write — the root API accepts only `dbName` and
+`entities`. The sync runtime uses one internal Google Sheets API provider with
+a service account — no Apps Script deployment. Sync auto-start is selected by
+`HIKOUTEI_SYNC_SPREADSHEET_URL` plus `GOOGLE_APPLICATION_CREDENTIALS`; there is
+no public `googleSheetsApi` bootstrap option to configure.
 
 **Fastest path:** install the gcloud CLI, then run `npx hikoutei setup` from your
 project directory. On an interactive terminal it offers (press Enter) to
@@ -224,7 +226,7 @@ local-only (SQLite). Startup failures are diagnosed with clear messages:
 invalid URL, missing/invalid credentials file, or a service account not
 shared on the spreadsheet (the error tells you which email to share).
 
-### Service-account provider (googleSheetsApi)
+### Manual service-account setup
 
 1. **Create a service account.** Enable the Google Sheets API in a Cloud
    project, create a service account with the
@@ -239,9 +241,17 @@ shared on the spreadsheet (the error tells you which email to share).
    `.gitignore` — the defaults created by `hikoutei setup` are already
    ignored, but a `.gitignore` is not a security boundary and does not
    protect already-tracked files.
-3. **Start the internal sync bootstrap** with `googleSheetsApi` configured. It
-   creates and verifies headers on the registered tabs, then starts outbox
-   delivery and User_Input polling.
+3. **Run the application normally.** Start the app with
+   `GOOGLE_APPLICATION_CREDENTIALS` and `HIKOUTEI_SYNC_SPREADSHEET_URL` set;
+   `createTypedSheets()` detects them and starts the internal sync bootstrap —
+   it creates and verifies headers on the registered tabs, then starts outbox
+   delivery and User_Input polling. There is no provider option to pass and no
+   internal bootstrap to start by hand.
+
+> **Legacy spreadsheet note.** Spreadsheets provisioned by the old Apps Script
+> provider with developer-metadata row anchors are not migrated: `User_Input`
+> tabs now require the `__hikoutei_row_id` system column, so legacy tabs must
+> be re-provisioned.
 
 Hikoutei uses a durable local outbox, idempotent delivery, and conflict-aware
 updates so temporary API failures do not lose committed application writes. The
@@ -293,9 +303,11 @@ Hikoutei is in active development. The current EntityManager supports scalar
 entity lifecycle operations, equality-filtered `find()` / `findOne()`,
 `limit` / `offset` pagination on `find()`, and callback-style
 `transactional()` work.
-Normal reads always come from SQLite, never Google Sheets. Sheet edit ingestion
-and conflict presentation are still evolving. Review release notes before
-upgrading minor versions.
+Normal reads always come from SQLite, never Google Sheets. The `hikoutei
+setup` CLI provisions the spreadsheet and service account, and the direct
+Google Sheets API provider (env-driven auto-start) is the only sync path — no
+Apps Script gateway. Sheet edit ingestion and conflict presentation are still
+evolving. Review release notes before upgrading minor versions.
 
 ## Roadmap
 
@@ -329,7 +341,6 @@ The following work continues in parallel with the EntityManager milestones:
 
 - Complete ingestion of intentional user edits from Google Sheets.
 - Improve update/delete conflict handling and presentation.
-- Improve setup tooling for registry and direct-provider deployment.
 
 See the [open issues](https://github.com/ManddarinShop/Hikoutei/issues)
 for current work.

package/dist/adapter/persistence/contracts/scalar.d.ts

@@ -12,6 +12,7 @@
  * include any canonical-state and durable-outbox work associated with a row
  * change. Those sync details remain provider-internal.
  */
+import type { SqlExecutor } from "./sql.js";
 /** Scalar value bound for one entity column. */
 export type ScalarEntityValue = string | number | boolean | Date | null;
 /** Storage affinity for one scalar entity column. */
@@ -31,6 +32,7 @@ export interface ScalarEntityTableDefinition {
 }
 /** A row to insert into one scalar entity table. */
 export interface ScalarEntityInsert {
+    readonly entityName: string;
     readonly tableName: string;
     readonly primaryKeyColumn: string;
     /** Column-to-value map for every declared property of the entity. */
@@ -38,17 +40,49 @@ export interface ScalarEntityInsert {
 }
 /** A changed row to update inside one scalar entity table. */
 export interface ScalarEntityUpdate {
+    readonly entityName: string;
     readonly tableName: string;
     readonly primaryKeyColumn: string;
     readonly primaryKeyValue: ScalarEntityValue;
+    /** Complete post-update row used by canonical and projection planning. */
+    readonly values: Readonly<Record<string, ScalarEntityValue>>;
     /** Only the columns whose values changed since the loaded snapshot. */
     readonly changedValues: Readonly<Record<string, ScalarEntityValue>>;
 }
 /** A row to delete from one scalar entity table by primary key. */
 export interface ScalarEntityDelete {
+    readonly entityName: string;
     readonly tableName: string;
     readonly primaryKeyColumn: string;
     readonly primaryKeyValue: ScalarEntityValue;
+    /** Complete persisted row snapshot used for delete canonical evidence. */
+    readonly values: Readonly<Record<string, ScalarEntityValue>>;
+}
+/** Runtime operation tags used by the provider-neutral flush plan. */
+export declare const SCALAR_ENTITY_CHANGE_KINDS: {
+    readonly INSERT: "insert";
+    readonly UPDATE: "update";
+    readonly DELETE: "delete";
+};
+/** One lifecycle row operation promoted from Hikoutei's Unit of Work. */
+export type ScalarEntityFlushChange = {
+    readonly kind: typeof SCALAR_ENTITY_CHANGE_KINDS.INSERT;
+    readonly row: ScalarEntityInsert;
+} | {
+    readonly kind: typeof SCALAR_ENTITY_CHANGE_KINDS.UPDATE;
+    readonly row: ScalarEntityUpdate;
+} | {
+    readonly kind: typeof SCALAR_ENTITY_CHANGE_KINDS.DELETE;
+    readonly row: ScalarEntityDelete;
+};
+/** SQL context used by a provider to plan canonical and outbox work. */
+export interface ScalarEntityFlushContext {
+    readonly changes: readonly ScalarEntityFlushChange[];
+    readonly sql: SqlExecutor;
+}
+/** Callback for sync-aware providers to plan work before entity SQL is flushed. */
+export interface ScalarEntityFlushCoordinator {
+    onFlush(context: ScalarEntityFlushContext): Promise<void>;
 }
 /** Equality filter and paging for a scalar entity read. */
 export interface ScalarEntityQuery {

package/dist/adapter/persistence/contracts/scalar.d.ts.map

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

package/dist/adapter/persistence/contracts/scalar.js

@@ -12,5 +12,10 @@
  * include any canonical-state and durable-outbox work associated with a row
  * change. Those sync details remain provider-internal.
  */
-export {};
+/** Runtime operation tags used by the provider-neutral flush plan. */
+export const SCALAR_ENTITY_CHANGE_KINDS = {
+    INSERT: "insert",
+    UPDATE: "update",
+    DELETE: "delete",
+};
 //# sourceMappingURL=scalar.js.map

package/dist/adapter/persistence/contracts/scalar.js.map

@@ -1 +1 @@
-{"version":3,"file":"scalar.js","sourceRoot":"","sources":["../../../../src/adapter/persistence/contracts/scalar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}
+{"version":3,"file":"scalar.js","sourceRoot":"","sources":["../../../../src/adapter/persistence/contracts/scalar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAwDH,sEAAsE;AACtE,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACR,CAAC"}

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

@@ -1,38 +1,37 @@
 /**
  * MikroORM implementation of Hikoutei's scalar persistence SPI.
  *
- * The public Unit of Work prepares provider-neutral row changes. This adapter
- * translates those changes into the existing mapped MikroORM facade, whose
- * flush coordinator still commits canonical state and the durable Sheet
- * outbox in the same SQLite transaction. No MikroORM type crosses the root
- * public entrypoint.
+ * Hikoutei's Unit of Work is the only lifecycle authority. This adapter merely
+ * schedules its provider-neutral row plan on a transaction-bound MikroORM
+ * manager, runs the optional mapped canonical/outbox planner, and flushes the
+ * entity statements in the same SQLite transaction.
  */
 import type { ResolvedHikouteiEntityDescriptor } from "../../../../../api/entity.js";
-import type { ScalarEntityPersistenceProvider, ScalarEntityQuery, ScalarEntityRow, ScalarEntityTransaction } from "../../../contracts/scalar.js";
-import type { TypedSheetsEntityReference } from "../../../../../application/orm/api/contracts.js";
-import type { TypedSheetsOrm } from "../../../../../application/orm/api/TypedSheetsOrm.js";
+import type { ScalarEntityFlushCoordinator, ScalarEntityPersistenceProvider, ScalarEntityQuery, ScalarEntityRow, ScalarEntityTransaction } from "../../../contracts/scalar.js";
+import type { MikroOrmSqliteAdapter } from "../storage/MikroOrmSqliteAdapter.js";
+import type { MappedEntityReference } from "../../../../../application/orm/mapping/contracts.js";
 /** Internal mapping from a public descriptor to its generated MikroORM entity. */
 export interface MikroOrmScalarEntityBinding {
     readonly descriptor: ResolvedHikouteiEntityDescriptor;
-    readonly entity: TypedSheetsEntityReference<Record<string, unknown>>;
+    /** Kept opaque so MikroORM types remain inside this adapter module. */
+    readonly entity: MappedEntityReference<Record<string, unknown>>;
 }
 /**
- * Adapts one mapped MikroORM runtime to the provider-neutral scalar contract.
- *
- * Entity tables are created by the generated schemas before this adapter is
- * constructed. Every transaction delegates through `TypedSheetsOrm.em`, so
- * its existing canonical/outbox flush coordinator remains in the same SQLite
- * transaction as the generated entity rows.
+ * Adapts generated MikroORM entity bindings to the provider-neutral scalar
+ * contract. A mapped coordinator, when supplied, runs before entity SQL and
+ * shares the active manager's transaction-bound SQL executor.
  */
 export declare class MikroOrmScalarPersistenceProvider implements ScalarEntityPersistenceProvider {
-    private readonly orm;
+    private readonly storage;
+    private readonly flushCoordinator?;
     private readonly bindings;
-    constructor(orm: TypedSheetsOrm, bindings: readonly MikroOrmScalarEntityBinding[]);
-    /** Reads through a fresh internal manager so public identity maps stay local. */
+    private readonly bindingsByTable;
+    constructor(storage: MikroOrmSqliteAdapter, bindings: readonly MikroOrmScalarEntityBinding[], flushCoordinator?: ScalarEntityFlushCoordinator | undefined);
+    /** Reads through a clean manager without flushing another Unit of Work. */
     read(query: ScalarEntityQuery): Promise<readonly ScalarEntityRow[]>;
-    /** Runs one common-UoW transaction through the mapped MikroORM facade. */
+    /** Runs the common UoW plan and mapped work in one SQLite transaction. */
     beginTransaction<Result>(work: (transaction: ScalarEntityTransaction) => Promise<Result>): Promise<Result>;
-    /** Closes the internal mapped runtime and its SQLite connection. */
+    /** Closes the one SQLite connection owned by this provider. */
     close(): Promise<void>;
     private requireBindingByTable;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"MikroOrmScalarPersistenceProvider.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/persistence/providers/mikro-orm/api/MikroOrmScalarPersistenceProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,gCAAgC,EACjC,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAGV,+BAA+B,EAC/B,iBAAiB,EACjB,eAAe,EACf,uBAAuB,EAGxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACV,0BAA0B,EAE3B,MAAM,iDAAiD,CAAC;AACzD,OAAO,KAAK,EAEV,cAAc,EACf,MAAM,sDAAsD,CAAC;AAI9D,kFAAkF;AAClF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,UAAU,EAAE,gCAAgC,CAAC;IACtD,QAAQ,CAAC,MAAM,EAAE,0BAA0B,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtE;AAED;;;;;;;GAOG;AACH,qBAAa,iCAAkC,YAAW,+BAA+B;IAIrF,OAAO,CAAC,QAAQ,CAAC,GAAG;IAHtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmD;gBAGzD,GAAG,EAAE,cAAc,EACpC,QAAQ,EAAE,SAAS,2BAA2B,EAAE;IAKlD,iFAAiF;IAC3E,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC;IAMzE,0EAA0E;IACpE,gBAAgB,CAAC,MAAM,EAC3B,IAAI,EAAE,CAAC,WAAW,EAAE,uBAAuB,KAAK,OAAO,CAAC,MAAM,CAAC,GAC9D,OAAO,CAAC,MAAM,CAAC;IAOlB,oEAAoE;IAC9D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,OAAO,CAAC,qBAAqB;CAS9B"}
+{"version":3,"file":"MikroOrmScalarPersistenceProvider.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/persistence/providers/mikro-orm/api/MikroOrmScalarPersistenceProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,8BAA8B,CAAC;AAErF,OAAO,KAAK,EAGV,4BAA4B,EAE5B,+BAA+B,EAC/B,iBAAiB,EACjB,eAAe,EACf,uBAAuB,EAGxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACV,qBAAqB,EAEtB,MAAM,qCAAqC,CAAC;AAG7C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qDAAqD,CAAC;AAEjG,kFAAkF;AAClF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,UAAU,EAAE,gCAAgC,CAAC;IACtD,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACjE;AAED;;;;GAIG;AACH,qBAAa,iCAAkC,YAAW,+BAA+B;IAKrF,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IANpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmD;IAC5E,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmD;gBAGhE,OAAO,EAAE,qBAAqB,EAC/C,QAAQ,EAAE,SAAS,2BAA2B,EAAE,EAC/B,gBAAgB,CAAC,EAAE,4BAA4B,YAAA;IAMlE,2EAA2E;IACrE,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC;IAKzE,0EAA0E;IACpE,gBAAgB,CAAC,MAAM,EAC3B,IAAI,EAAE,CAAC,WAAW,EAAE,uBAAuB,KAAK,OAAO,CAAC,MAAM,CAAC,GAC9D,OAAO,CAAC,MAAM,CAAC;IAalB,+DAA+D;IACzD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,OAAO,CAAC,qBAAqB;CAK9B"}

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

@@ -1,116 +1,169 @@
 /**
  * MikroORM implementation of Hikoutei's scalar persistence SPI.
  *
- * The public Unit of Work prepares provider-neutral row changes. This adapter
- * translates those changes into the existing mapped MikroORM facade, whose
- * flush coordinator still commits canonical state and the durable Sheet
- * outbox in the same SQLite transaction. No MikroORM type crosses the root
- * public entrypoint.
+ * Hikoutei's Unit of Work is the only lifecycle authority. This adapter merely
+ * schedules its provider-neutral row plan on a transaction-bound MikroORM
+ * manager, runs the optional mapped canonical/outbox planner, and flushes the
+ * entity statements in the same SQLite transaction.
  */
 import { HIKOUTEI_ERROR_CODES, HikouteiError } from "../../../../../api/errors.js";
 import { isCanonicalUtcIsoDate } from "../../../../../shared/validation.js";
 import { isRecord } from "../../../../../shared/encoding/typeGuards.js";
 /**
- * Adapts one mapped MikroORM runtime to the provider-neutral scalar contract.
- *
- * Entity tables are created by the generated schemas before this adapter is
- * constructed. Every transaction delegates through `TypedSheetsOrm.em`, so
- * its existing canonical/outbox flush coordinator remains in the same SQLite
- * transaction as the generated entity rows.
+ * Adapts generated MikroORM entity bindings to the provider-neutral scalar
+ * contract. A mapped coordinator, when supplied, runs before entity SQL and
+ * shares the active manager's transaction-bound SQL executor.
  */
 export class MikroOrmScalarPersistenceProvider {
-    orm;
+    storage;
+    flushCoordinator;
     bindings;
-    constructor(orm, bindings) {
-        this.orm = orm;
+    bindingsByTable;
+    constructor(storage, bindings, flushCoordinator) {
+        this.storage = storage;
+        this.flushCoordinator = flushCoordinator;
         this.bindings = new Map(bindings.map((binding) => [binding.descriptor.name, binding]));
+        this.bindingsByTable = new Map(bindings.map((binding) => [binding.descriptor.tableName, binding]));
     }
-    /** Reads through a fresh internal manager so public identity maps stay local. */
+    /** Reads through a clean manager without flushing another Unit of Work. */
     async read(query) {
-        const binding = this.requireBindingByTable(query.tableName);
-        const manager = this.orm.em.fork();
-        return readRows(manager, binding, query);
+        const manager = this.storage.forkEntityManager();
+        return readRows(manager, this.requireBindingByTable(query.tableName), query);
     }
-    /** Runs one common-UoW transaction through the mapped MikroORM facade. */
+    /** Runs the common UoW plan and mapped work in one SQLite transaction. */
     async beginTransaction(work) {
-        return this.orm.em.transactional(async (manager) => {
-            const transaction = new MikroOrmScalarTransaction(manager, this.bindings);
+        return this.storage.transactional(async ({ entityManager }) => {
+            const transaction = new MikroOrmScalarTransaction(this.storage, entityManager, this.bindings, this.bindingsByTable, this.flushCoordinator);
             return work(transaction);
         });
     }
-    /** Closes the internal mapped runtime and its SQLite connection. */
+    /** Closes the one SQLite connection owned by this provider. */
     async close() {
-        await this.orm.close(true);
+        await this.storage.close(true);
     }
     requireBindingByTable(tableName) {
-        for (const binding of this.bindings.values()) {
-            if (binding.descriptor.tableName === tableName)
-                return binding;
-        }
-        throw new HikouteiError(HIKOUTEI_ERROR_CODES.UNREGISTERED_ENTITY, `entity table "${tableName}" is not registered with this runtime.`);
+        const binding = this.bindingsByTable.get(tableName);
+        if (binding !== undefined)
+            return binding;
+        throw unregisteredTable(tableName);
     }
 }
-/** Transaction-bound translation from scalar plans to mapped entity writes. */
-class MikroOrmScalarTransaction {
-    manager;
+/** Transaction-bound reader shared by provider reads and flush-time lookups. */
+class MikroOrmScalarReader {
+    entityManager;
     bindings;
-    constructor(manager, bindings) {
-        this.manager = manager;
+    bindingsByTable;
+    constructor(entityManager, bindings, bindingsByTable) {
+        this.entityManager = entityManager;
         this.bindings = bindings;
+        this.bindingsByTable = bindingsByTable;
+    }
+    async read(query) {
+        return readRows(this.entityManager, this.requireBindingByTable(query.tableName), query);
+    }
+    requireBindingByTable(tableName) {
+        const binding = this.bindingsByTable.get(tableName);
+        if (binding !== undefined)
+            return binding;
+        throw unregisteredTable(tableName);
+    }
+    requireBindingForRow(entityName, tableName) {
+        const binding = this.bindings.get(entityName);
+        if (binding !== undefined && binding.descriptor.tableName === tableName)
+            return binding;
+        throw new HikouteiError(HIKOUTEI_ERROR_CODES.UNREGISTERED_ENTITY, `entity "${entityName}" is not registered for table "${tableName}".`);
+    }
+}
+/**
+ * Schedules a Hikoutei flush plan on the active MikroORM manager.
+ *
+ * The coordinator runs before MikroORM emits entity SQL. Both its SQL and the
+ * later entity statements are owned by the surrounding `transactional()` call,
+ * so either side can reject without leaving a partial canonical/outbox write.
+ */
+class MikroOrmScalarTransaction extends MikroOrmScalarReader {
+    storage;
+    flushCoordinator;
+    changes = [];
+    constructor(storage, entityManager, bindings, bindingsByTable, flushCoordinator) {
+        super(entityManager, bindings, bindingsByTable);
+        this.storage = storage;
+        this.flushCoordinator = flushCoordinator;
     }
     async insert(row) {
-        const binding = this.requireBindingByTable(row.tableName);
-        const entity = this.manager.create(binding.entity, toInternalData(binding.descriptor, row.values));
-        this.manager.persist(entity);
+        const binding = this.requireBindingForRow(row.entityName, row.tableName);
+        const entity = createManagedEntity(this.entityManager, binding, row.values);
+        this.entityManager.persist(entity);
+        this.changes.push({ kind: "insert", row });
     }
     async update(row) {
-        const binding = this.requireBindingByTable(row.tableName);
+        const binding = this.requireBindingForRow(row.entityName, row.tableName);
         const existing = await this.findOne(binding, row.primaryKeyColumn, row.primaryKeyValue);
         if (existing === null) {
             throw new HikouteiError(HIKOUTEI_ERROR_CODES.ENTITY_NOT_FOUND, `cannot update missing entity in table "${row.tableName}".`);
         }
         Object.assign(existing, toInternalData(binding.descriptor, row.changedValues));
-        this.manager.persist(existing);
+        this.entityManager.persist(existing);
+        this.changes.push({ kind: "update", row });
     }
     async delete(row) {
-        const binding = this.requireBindingByTable(row.tableName);
+        const binding = this.requireBindingForRow(row.entityName, row.tableName);
         const existing = await this.findOne(binding, row.primaryKeyColumn, row.primaryKeyValue);
         if (existing === null) {
             throw new HikouteiError(HIKOUTEI_ERROR_CODES.ENTITY_NOT_FOUND, `cannot delete missing entity in table "${row.tableName}".`);
         }
-        this.manager.remove(existing);
+        this.entityManager.remove(existing);
+        this.changes.push({ kind: "delete", row });
     }
-    async read(query) {
-        const binding = this.requireBindingByTable(query.tableName);
-        return readRows(this.manager, binding, query);
-    }
-    /** Forces MikroORM's mapped flush before the common UoW advances snapshots. */
+    /** Plans mapped state first, then flushes the scheduled entity statements. */
     async flush() {
-        await this.manager.flush();
+        if (this.changes.length > 0 && this.flushCoordinator !== undefined) {
+            await this.flushCoordinator.onFlush({
+                changes: [...this.changes],
+                sql: this.storage.createSqlExecutor(this.entityManager),
+            });
+        }
+        await this.entityManager.flush();
+        this.changes.length = 0;
     }
     async findOne(binding, primaryKeyColumn, primaryKeyValue) {
-        const result = await this.manager.findOne(binding.entity, { [primaryKeyColumn]: toInternalValue(binding.descriptor, primaryKeyColumn, primaryKeyValue) });
+        const result = await Reflect.apply(this.entityManager.findOne, this.entityManager, [
+            binding.entity,
+            { [primaryKeyColumn]: toInternalValue(binding.descriptor, primaryKeyColumn, primaryKeyValue) },
+        ]);
+        if (result === null)
+            return null;
+        if (!isRecord(result)) {
+            throw new HikouteiError(HIKOUTEI_ERROR_CODES.INVALID_SCALAR_VALUE, "MikroORM findOne result must be an entity object or null.");
+        }
         return result;
     }
-    requireBindingByTable(tableName) {
-        for (const binding of this.bindings.values()) {
-            if (binding.descriptor.tableName === tableName)
-                return binding;
-        }
-        throw new HikouteiError(HIKOUTEI_ERROR_CODES.UNREGISTERED_ENTITY, `entity table "${tableName}" is not registered with this runtime.`);
+}
+function createManagedEntity(entityManager, binding, values) {
+    const result = Reflect.apply(entityManager.create, entityManager, [binding.entity, toInternalData(binding.descriptor, values), { partial: true, persist: false }]);
+    if (!isRecord(result)) {
+        throw new HikouteiError(HIKOUTEI_ERROR_CODES.INVALID_SCALAR_VALUE, "MikroORM create result must be an entity object.");
     }
+    return result;
 }
-async function readRows(manager, binding, query) {
-    const entities = await manager.find(binding.entity, toInternalFilter(binding.descriptor, query.where), toFindOptions(query));
-    return entities.map((entity) => fromInternalEntity(binding.descriptor, entity));
+async function readRows(entityManager, binding, query) {
+    const result = await Reflect.apply(entityManager.find, entityManager, [
+        binding.entity,
+        toMikroOrmFilter(binding.descriptor, query.where),
+        toMikroOrmQueryOptions(query),
+    ]);
+    if (!Array.isArray(result) || !result.every(isRecord)) {
+        throw new HikouteiError(HIKOUTEI_ERROR_CODES.INVALID_SCALAR_VALUE, "MikroORM find result must be an array of entity objects.");
+    }
+    return result.map((entity) => fromInternalEntity(binding.descriptor, entity));
 }
-function toFindOptions(query) {
+function toMikroOrmQueryOptions(query) {
     return {
         ...(query.limit === undefined ? {} : { limit: query.limit }),
         ...(query.offset === undefined ? {} : { offset: query.offset }),
     };
 }
-function toInternalFilter(descriptor, where) {
+function toMikroOrmFilter(descriptor, where) {
     return Object.fromEntries(Object.entries(where).map(([property, value]) => [
         property,
         toInternalValue(descriptor, property, value),
@@ -129,18 +182,12 @@ function toInternalValue(descriptor, propertyName, value) {
     return value;
 }
 function fromInternalEntity(descriptor, entity) {
-    if (!isRecord(entity)) {
-        throw new HikouteiError(HIKOUTEI_ERROR_CODES.INVALID_SCALAR_VALUE, "stored entity must be an object");
-    }
     const values = {};
     for (const property of descriptor.properties) {
-        const value = entity[property.name];
+        const value = Reflect.get(entity, property.name);
         if (value === null || value === undefined) {
-            if (!property.nullable && value === undefined) {
-                throw new HikouteiError(HIKOUTEI_ERROR_CODES.INVALID_SCALAR_VALUE, `${property.name} is missing from the stored entity.`);
-            }
-            if (!property.nullable && value === null) {
-                throw new HikouteiError(HIKOUTEI_ERROR_CODES.INVALID_SCALAR_VALUE, `${property.name} is unexpectedly null in the stored entity.`);
+            if (!property.nullable) {
+                throw new HikouteiError(HIKOUTEI_ERROR_CODES.INVALID_SCALAR_VALUE, `${property.name} is unexpectedly ${value === null ? "null" : "missing"} in the stored entity.`);
             }
             values[property.name] = null;
             continue;
@@ -176,4 +223,7 @@ function fromInternalEntity(descriptor, entity) {
 function throwInvalidStoredScalar(propertyName, expected) {
     throw new HikouteiError(HIKOUTEI_ERROR_CODES.INVALID_SCALAR_VALUE, `${propertyName} must be a ${expected} in the stored entity.`);
 }
+function unregisteredTable(tableName) {
+    return new HikouteiError(HIKOUTEI_ERROR_CODES.UNREGISTERED_ENTITY, `entity table "${tableName}" is not registered with this runtime.`);
+}
 //# sourceMappingURL=MikroOrmScalarPersistenceProvider.js.map