hikoutei 0.3.0 → 0.3.1

package/README.ja.md

@@ -46,7 +46,8 @@ SQLite provider が内部で利用しますが、ルート public API に MikroO
 
 ## クイックスタート
 
-エンティティ定義と環境ごとの Sheet route を分離し、ルート API だけを使います。
+エンティティ定義と SQLite の lifecycle はルート API だけを使います。Sheet route、
+gateway credential、provisioning、polling は内部 service bootstrap の責務です。
 
 ```ts
 import { createTypedSheets, defineTypedSheetsEntity } from "hikoutei";
@@ -63,14 +64,6 @@ const User = defineTypedSheetsEntity({
 const hikoutei = await createTypedSheets({
   dbName: "./hikoutei.sqlite",
   entities: [User],
-  sheets: {
-    spreadsheetId: process.env.SHEET_ID!,
-    routes: {
-      User: {
-        systemState: { tabName: "Users_System", registeredRange: "A:Z" },
-      },
-    },
-  },
 });
 
 const em = hikoutei.em.fork();
@@ -82,10 +75,11 @@ user.name = "Ada Lovelace";
 await em.flush();
 ```
 
-`createTypedSheets()` は SQLite とローカル canonical/outbox だけを準備します。
-リモートのタブとヘッダーは `hikoutei.setupSheets(provisioner)` を明示的に呼び出して
-プロビジョニングします。`flush()` の成功は SQLite と durable outbox のコミットを
-意味し、リモート Sheet への配信は別の worker が非同期に行います。
+`createTypedSheets()` はローカルの entity table だけを準備し、Google Sheets へ接続
+しません。内部 sync service が mapping を登録してタブを provision し、outbound
+worker と User_Input polling を開始します。service mode では `flush()` が entity、
+canonical state、durable outbox を SQLite transaction としてコミットし、リモート
+Sheet への配信は非同期に行います。
 
 ## Hikoutei が適しているケース
 
@@ -108,17 +102,15 @@ await em.flush();
 
 ## Google Sheets の設定
 
-1. `createTypedSheets()` で scalar entity と環境ごとの Sheet route を定義します。
-2. [クイックスタート](docs/quick-start.md#sheet-setup-and-delivery) に従い、
-   [`apps-script/gateway/Code.gs`](apps-script/gateway/Code.gs) を対象の
+1. [`apps-script/gateway/Code.gs`](apps-script/gateway/Code.gs) を対象の
    Spreadsheet にバインドした Apps Script プロジェクトへコピーし、Web App として
    デプロイします。その後 `/exec` URL を入力して `setupSyncGateway()` を実行します。
-3. 生成された `TYPED_SHEETS_GATEWAY_URL`、
-   `TYPED_SHEETS_GATEWAY_SHARED_SECRET`、
+2. `TYPED_SHEETS_GATEWAY_URL`、`TYPED_SHEETS_GATEWAY_SHARED_SECRET`、
    `TYPED_SHEETS_GATEWAY_SHEET_ID` を、追跡対象外のサーバー環境ファイルまたは
    secret store に保管します。shared secret をブラウザコードや Git に入れないでください。
-4. `hikoutei.setupSheets(provisioner)` を明示的に呼び出して登録済みのタブとヘッダーを
-   プロビジョニングし、保留中の outbox effect を配信する sync worker を実行します。
+3. 内部 sync bootstrap を開始すると private route/ownership configuration を検証し、
+   タブとヘッダーを provision した後、outbox 配信と User_Input polling を実行します。
+   アプリケーションは gateway API を直接呼び出しません。
 
 外部サーバーからアクセスするには、Web App のアクセス範囲でサーバーを許可する必要が
 あり、通常は **Anyone** が必要です。エディタ専用の `/dev` ではなく、デプロイ用の
@@ -128,7 +120,7 @@ await em.flush();
 
 ## ドキュメント
 
-- [クイックスタート](docs/quick-start.md) — インストール、マッピング、Gateway 設定。
+- [クイックスタート](docs/quick-start.md) — インストール、ORM lifecycle、service-side sync 設定。
 - [アーキテクチャ](docs/architecture.md) — ローカルストアと Sheet ビューの関係。
 - [書き込みと同期の流れ](docs/write-and-synchronization-flow.md) — 非同期配信と復旧動作。
 - [開発ガイド](docs/development.md) — ローカル開発とテストコマンド。

package/README.ko.md

@@ -46,7 +46,8 @@ SQLite provider가 내부적으로 사용하지만 루트 public API에는 Mikro
 
 ## 빠른 시작
 
-엔티티 정의와 환경별 Sheet route를 분리하고 루트 API만 사용합니다.
+엔티티 정의와 SQLite lifecycle은 루트 API만 사용합니다. Sheet route,
+gateway credential, provisioning, polling은 내부 service bootstrap의 책임입니다.
 
 ```ts
 import { createTypedSheets, defineTypedSheetsEntity } from "hikoutei";
@@ -63,14 +64,6 @@ const User = defineTypedSheetsEntity({
 const hikoutei = await createTypedSheets({
   dbName: "./hikoutei.sqlite",
   entities: [User],
-  sheets: {
-    spreadsheetId: process.env.SHEET_ID!,
-    routes: {
-      User: {
-        systemState: { tabName: "Users_System", registeredRange: "A:Z" },
-      },
-    },
-  },
 });
 
 const em = hikoutei.em.fork();
@@ -82,10 +75,11 @@ user.name = "Ada Lovelace";
 await em.flush();
 ```
 
-`createTypedSheets()`는 SQLite와 로컬 canonical/outbox만 준비합니다. 원격
-탭과 헤더 provisioning은 `hikoutei.setupSheets(provisioner)`를 명시적으로
-호출해야 합니다. `flush()`가 성공하면 SQLite 변경과 durable outbox가
-커밋되며 원격 Sheet 전달은 별도 worker가 비동기로 수행합니다.
+`createTypedSheets()`는 로컬 entity table만 준비하며 Google Sheets에 연결하지
+않습니다. 내부 sync service가 mapping을 등록하고 탭을 provisioning한 뒤
+outbound worker와 User_Input polling을 시작합니다. service mode에서
+`flush()`는 entity, canonical state, durable outbox를 SQLite transaction으로
+커밋하고 원격 Sheet 전달은 비동기로 수행합니다.
 
 ## Hikoutei를 사용하기 좋은 경우
 
@@ -110,19 +104,17 @@ await em.flush();
 
 ## Google Sheets 설정
 
-1. `createTypedSheets()`에서 scalar entity와 환경별 Sheet route를 정의합니다.
-2. [빠른 시작](docs/quick-start.md#sheet-setup-and-delivery)을 따라
-   [`apps-script/gateway/Code.gs`](apps-script/gateway/Code.gs)를 대상
+1. [`apps-script/gateway/Code.gs`](apps-script/gateway/Code.gs)를 대상
    Spreadsheet에 bound된 Apps Script 프로젝트에 복사하고 Web App으로
    배포한 뒤 `/exec` URL을 입력하고 `setupSyncGateway()`를 실행합니다.
-3. 생성된 `TYPED_SHEETS_GATEWAY_URL`,
-   `TYPED_SHEETS_GATEWAY_SHARED_SECRET`,
+2. `TYPED_SHEETS_GATEWAY_URL`, `TYPED_SHEETS_GATEWAY_SHARED_SECRET`,
    `TYPED_SHEETS_GATEWAY_SHEET_ID`를 추적하지 않는 서버 환경 파일이나
    secret store에 보관합니다. shared secret은 브라우저 코드나 Git에 넣지
    마세요.
-4. `hikoutei.setupSheets(provisioner)`를 명시적으로 호출해 등록된 탭과
-   헤더를 provisioning한 뒤, 대기 중인 outbox effect를 전달하는 sync worker를
-   실행합니다.
+3. 내부 sync bootstrap을 시작하면 private route/ownership configuration을
+   검증하고 탭과 헤더를 provisioning한 뒤 outbox delivery와 User_Input
+   polling을 실행합니다. 애플리케이션 코드는 gateway API를 호출하지
+   않습니다.
 
 외부 서버에서 접근하려면 Web App의 액세스 범위가 서버를 허용해야 하며,
 일반적으로 **Anyone** 설정이 필요합니다. 편집기 전용 `/dev`가 아니라 배포용
@@ -132,7 +124,7 @@ await em.flush();
 
 ## 문서
 
-- [빠른 시작](docs/quick-start.md) — 설치, 매핑, Gateway 설정.
+- [빠른 시작](docs/quick-start.md) — 설치, ORM lifecycle, service-side sync 설정.
 - [아키텍처](docs/architecture.md) — 로컬 저장소와 Sheet 화면의 관계.
 - [쓰기 및 동기화 흐름](docs/write-and-synchronization-flow.md) — 비동기 전달과
   복구 동작.

package/README.md

@@ -27,7 +27,8 @@ replacement, a Prisma/JPA clone, or a general Google Sheets API wrapper.
 ## Why Hikoutei?
 
 - Entity-oriented lifecycle: create, find, mutate, persist, remove, and flush.
-- Typed field mappings with runtime validation for Sheet data.
+- Typed scalar entity fields with runtime validation at the local boundary.
+- Internal projection mappings with runtime validation for Sheet data.
 - Local SQLite reads for application workflows that should not wait on a remote
   spreadsheet request.
 - Asynchronous Google Sheets views for human review and lightweight
@@ -49,9 +50,10 @@ without changing the entity lifecycle API.
 
 ## Quick start
 
-Define a scalar entity and configure its environment-specific Sheet route
-separately. The application reads and writes the local SQLite authority through
-a request-local manager.
+Define a scalar entity and use the local SQLite authority through a
+request-local manager. Sheet routes, gateway credentials, provisioning, and
+polling belong to the internal service bootstrap rather than the application
+API.
 
 ```ts
 import { createTypedSheets, defineTypedSheetsEntity } from "hikoutei";
@@ -68,14 +70,6 @@ const User = defineTypedSheetsEntity({
 const hikoutei = await createTypedSheets({
   dbName: "./hikoutei.sqlite",
   entities: [User],
-  sheets: {
-    spreadsheetId: process.env.SHEET_ID!,
-    routes: {
-      User: {
-        systemState: { tabName: "Users_System", registeredRange: "A:Z" },
-      },
-    },
-  },
 });
 
 const em = hikoutei.em.fork();
@@ -87,11 +81,11 @@ user.name = "Ada Lovelace";
 await em.flush();
 ```
 
-`createTypedSheets()` only opens SQLite and registers local sync state. Call
-`hikoutei.setupSheets(provisioner)` explicitly when a deployment is ready to
-provision or validate remote tabs and headers. `flush()` commits the entity,
-canonical sync state, and durable Sheet outbox locally; remote delivery remains
-asynchronous.
+`createTypedSheets()` opens the local entity tables only. The internal sync
+service separately registers mappings, provisions remote tabs, starts the
+outbound worker, and polls User_Input. In service mode, `flush()` commits the
+entity, canonical sync state, and durable Sheet outbox locally; remote delivery
+remains asynchronous.
 
 ## When to use Hikoutei
 
@@ -116,29 +110,31 @@ Use a conventional database and direct Google APIs when you need:
 
 ## Google Sheets setup
 
-1. Define scalar entities and environment-specific routes in
-   `createTypedSheets()`.
-2. Follow the [Quick start](docs/quick-start.md#sheet-setup-and-delivery) to
-   copy [`apps-script/gateway/Code.gs`](apps-script/gateway/Code.gs) into a
+Google Sheets synchronization is a service-side concern. Applications do not
+import a gateway client, pass Sheet routes to `createTypedSheets()`, call
+`setupSheets()`, or choose an operation for each write.
+
+1. Copy [`apps-script/gateway/Code.gs`](apps-script/gateway/Code.gs) into a
    spreadsheet-bound Apps Script project, deploy it as a Web App, set the
    `/exec` URL, and run `setupSyncGateway()`.
-3. Keep the generated `TYPED_SHEETS_GATEWAY_URL`,
+2. Keep `TYPED_SHEETS_GATEWAY_URL`,
    `TYPED_SHEETS_GATEWAY_SHARED_SECRET`, and
-   `TYPED_SHEETS_GATEWAY_SHEET_ID` values in an untracked server environment or
-   secret store. Never put the shared secret in browser code or Git.
-4. Call `hikoutei.setupSheets(provisioner)` explicitly to provision and verify
-   the registered tabs and headers, then run the worker that delivers pending
-   outbox effects.
+   `TYPED_SHEETS_GATEWAY_SHEET_ID` in an untracked server environment or secret
+   store. Never put the shared secret in browser code or Git.
+3. Start the internal sync bootstrap. It validates the private route/ownership
+   configuration, provisions and verifies headers, then starts outbox delivery
+   and User_Input polling.
 
 The gateway must be deployed with an access audience that can reach the
 service; an external server normally requires **Anyone**. Use the deployed
 `/exec` URL, not the editor-only `/dev` URL. When `Code.gs` changes, update the
-existing Web App deployment with a new version before relying on the change.
+existing Web App deployment with a new version. Live Google calls are opt-in;
+fake gateways and SQLite fixtures are the normal verification path.
 The detailed setup and troubleshooting steps are in the [Quick start](docs/quick-start.md).
 
 ## Documentation
 
-- [Quick start](docs/quick-start.md) — installation, mapping, and gateway setup.
+- [Quick start](docs/quick-start.md) — installation, ORM lifecycle, and service-side sync setup.
 - [Architecture](docs/architecture.md) — how the local store and Sheet views
   fit together.
 - [Write and synchronization flow](docs/write-and-synchronization-flow.md) —

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

@@ -9,6 +9,14 @@
 export type SqlParameter = string | number | bigint | boolean | Uint8Array | null;
 /** A generated identifier returned by a database mutation when one exists. */
 export type SqlGeneratedId = string | number | bigint;
+/** Untrusted row shape returned by a SQL driver before column promotion. */
+export type SqlRow = Readonly<Record<string, unknown>>;
+/** Decoder used to promote one untrusted SQL row into a storage contract. */
+export type SqlRowDecoder<Row extends object> = (row: SqlRow, index?: number) => Row;
+/** Promotes a raw SQL result through an explicit row decoder. */
+export declare function decodeSqlRow<Row extends object>(value: unknown, decoder: SqlRowDecoder<Row>, label?: string): Row;
+/** Promotes every raw SQL result through one explicit row decoder. */
+export declare function decodeSqlRows<Row extends object>(values: readonly unknown[], decoder: SqlRowDecoder<Row>, label?: string): readonly Row[];
 /** Observable outcome of one SQL data-definition or data-mutation statement. */
 export interface SqlMutationResult {
     /** Number of rows changed by the statement. */
@@ -23,9 +31,15 @@ export interface SqlMutationResult {
  * keeps this executor bound to the current transaction when one exists.
  */
 export interface SqlExecutor {
-    /** Returns every row produced by a query. */
+    /**
+     * Returns every raw object row produced by a query.
+     *
+     * Callers should request `SqlRow` and use `decodeSqlRows()` before passing
+     * values into storage/domain contracts; the generic is retained for adapter
+     * compatibility while migrations move callers to explicit promotion.
+     */
     all<Row extends object>(sql: string, parameters?: readonly SqlParameter[]): Promise<readonly Row[]>;
-    /** Returns the first query row, or undefined when no row matches. */
+    /** Returns the first raw object row, or undefined when no row matches. */
     get<Row extends object>(sql: string, parameters?: readonly SqlParameter[]): Promise<Row | undefined>;
     /** Runs a statement that changes schema or persisted state. */
     run(sql: string, parameters?: readonly SqlParameter[]): Promise<SqlMutationResult>;

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

@@ -1 +1 @@
-{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../../../../src/adapter/persistence/contracts/sql.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,yEAAyE;AACzE,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,IAAI,CAAC;AAElF,8EAA8E;AAC9E,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEtD,gFAAgF;AAChF,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4EAA4E;IAC5E,QAAQ,CAAC,YAAY,CAAC,EAAE,cAAc,CAAC;CACxC;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,GAAG,CAAC,GAAG,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC;IAEpG,qEAAqE;IACrE,GAAG,CAAC,GAAG,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;IAErG,+DAA+D;IAC/D,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACpF;AAED,sEAAsE;AACtE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,iFAAiF;IACjF,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE3E,qFAAqF;IACrF,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACnF"}
+{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../../../../src/adapter/persistence/contracts/sql.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,yEAAyE;AACzE,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,IAAI,CAAC;AAElF,8EAA8E;AAC9E,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEtD,4EAA4E;AAC5E,MAAM,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEvD,6EAA6E;AAC7E,MAAM,MAAM,aAAa,CAAC,GAAG,SAAS,MAAM,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,GAAG,CAAC;AAErF,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,GAAG,SAAS,MAAM,EAC7C,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,EAC3B,KAAK,SAAY,GAChB,GAAG,CAKL;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,GAAG,SAAS,MAAM,EAC9C,MAAM,EAAE,SAAS,OAAO,EAAE,EAC1B,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,EAC3B,KAAK,SAAa,GACjB,SAAS,GAAG,EAAE,CAEhB;AAED,gFAAgF;AAChF,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4EAA4E;IAC5E,QAAQ,CAAC,YAAY,CAAC,EAAE,cAAc,CAAC;CACxC;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC;IAEpG,0EAA0E;IAC1E,GAAG,CAAC,GAAG,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;IAErG,+DAA+D;IAC/D,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACpF;AAED,sEAAsE;AACtE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,iFAAiF;IACjF,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE3E,qFAAqF;IACrF,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACnF"}

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

@@ -5,5 +5,15 @@
  * particular ORM. An adapter may implement them with MikroORM today and a
  * different persistence library later without changing sync semantics.
  */
-export {};
+/** Promotes a raw SQL result through an explicit row decoder. */
+export function decodeSqlRow(value, decoder, label = "SQL row") {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw new TypeError(`${label} must be an object`);
+    }
+    return decoder(value);
+}
+/** Promotes every raw SQL result through one explicit row decoder. */
+export function decodeSqlRows(values, decoder, label = "SQL rows") {
+    return values.map((value, index) => decodeSqlRow(value, decoder, `${label}[${index}]`));
+}
 //# sourceMappingURL=sql.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"sql.js","sourceRoot":"","sources":["../../../../src/adapter/persistence/contracts/sql.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}
+{"version":3,"file":"sql.js","sourceRoot":"","sources":["../../../../src/adapter/persistence/contracts/sql.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH,iEAAiE;AACjE,MAAM,UAAU,YAAY,CAC1B,KAAc,EACd,OAA2B,EAC3B,KAAK,GAAG,SAAS;IAEjB,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,oBAAoB,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,OAAO,CAAC,KAAe,CAAC,CAAC;AAClC,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,aAAa,CAC3B,MAA0B,EAC1B,OAA2B,EAC3B,KAAK,GAAG,UAAU;IAElB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,KAAK,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;AAC1F,CAAC"}

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

@@ -14,7 +14,7 @@ import type { TypedSheetsOrm } from "../../../../../application/orm/api/TypedShe
 /** Internal mapping from a public descriptor to its generated MikroORM entity. */
 export interface MikroOrmScalarEntityBinding {
     readonly descriptor: ResolvedHikouteiEntityDescriptor;
-    readonly entity: TypedSheetsEntityReference<object>;
+    readonly entity: TypedSheetsEntityReference<Record<string, unknown>>;
 }
 /**
  * Adapts one mapped MikroORM runtime to the provider-neutral scalar contract.

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,EAEV,0BAA0B,EAG3B,MAAM,iDAAiD,CAAC;AACzD,OAAO,KAAK,EAEV,cAAc,EACf,MAAM,sDAAsD,CAAC;AAE9D,kFAAkF;AAClF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,UAAU,EAAE,gCAAgC,CAAC;IACtD,QAAQ,CAAC,MAAM,EAAE,0BAA0B,CAAC,MAAM,CAAC,CAAC;CACrD;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;;;;;;;;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"}

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

@@ -8,6 +8,8 @@
  * public entrypoint.
  */
 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.
  *
@@ -127,27 +129,51 @@ 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 = {};
-    const record = entity;
     for (const property of descriptor.properties) {
-        const value = record[property.name];
-        if (property.type === "date") {
-            if (value === null || value === undefined) {
-                values[property.name] = null;
-                continue;
-            }
-            if (typeof value !== "string") {
-                throw new HikouteiError(HIKOUTEI_ERROR_CODES.INVALID_SCALAR_VALUE, `${property.name} returned a non-string stored date.`);
+        const value = 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.`);
             }
-            const date = new Date(value);
-            if (!Number.isFinite(date.getTime()) || date.toISOString() !== value) {
-                throw new HikouteiError(HIKOUTEI_ERROR_CODES.INVALID_SCALAR_VALUE, `${property.name} contains a non-canonical stored date.`);
+            if (!property.nullable && value === null) {
+                throw new HikouteiError(HIKOUTEI_ERROR_CODES.INVALID_SCALAR_VALUE, `${property.name} is unexpectedly null in the stored entity.`);
             }
-            values[property.name] = date;
+            values[property.name] = null;
             continue;
         }
-        values[property.name] = value === undefined ? null : value;
+        switch (property.type) {
+            case "string":
+                if (typeof value !== "string")
+                    throwInvalidStoredScalar(property.name, "string");
+                values[property.name] = value;
+                break;
+            case "number":
+                if (typeof value !== "number" || !Number.isFinite(value)) {
+                    throwInvalidStoredScalar(property.name, "finite number");
+                }
+                values[property.name] = value;
+                break;
+            case "boolean":
+                if (typeof value !== "boolean")
+                    throwInvalidStoredScalar(property.name, "boolean");
+                values[property.name] = value;
+                break;
+            case "date": {
+                if (typeof value !== "string" || !isCanonicalUtcIsoDate(value)) {
+                    throwInvalidStoredScalar(property.name, "canonical UTC date string");
+                }
+                values[property.name] = new Date(value);
+                break;
+            }
+        }
     }
     return values;
 }
+function throwInvalidStoredScalar(propertyName, expected) {
+    throw new HikouteiError(HIKOUTEI_ERROR_CODES.INVALID_SCALAR_VALUE, `${propertyName} must be a ${expected} in the stored entity.`);
+}
 //# sourceMappingURL=MikroOrmScalarPersistenceProvider.js.map

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

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

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

@@ -23,6 +23,8 @@ export declare class MikroOrmSqliteTypedSheetsEntityManager implements TypedShee
     fork(options?: TypedSheetsForkOptions): TypedSheetsEntityEngineManager;
     /** Delegates entity construction while keeping MikroORM types inside the adapter. */
     create<Entity extends object>(entityName: TypedSheetsEntityReference<Entity>, data: TypedSheetsEntityData<Entity>): Entity;
+    /** Converts public partial data into the untyped provider data boundary. */
+    private toMikroData;
     /** Reads a filtered entity collection through the local SQLite manager. */
     find<Entity extends object>(entityName: TypedSheetsEntityReference<Entity>, where: TypedSheetsEntityFilter<Entity>, options?: TypedSheetsFindOptions): Promise<readonly Entity[]>;
     /** Reads one filtered entity through the local SQLite manager. */

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

@@ -1 +1 @@
-{"version":3,"file":"MikroOrmTypedSheetsEntityManager.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/persistence/providers/mikro-orm/api/MikroOrmTypedSheetsEntityManager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EACV,qBAAqB,EACrB,8BAA8B,EAC9B,uBAAuB,EACvB,8BAA8B,EAC9B,0BAA0B,EAC1B,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,iDAAiD,CAAC;AAEzD,OAAO,KAAK,EACV,qBAAqB,EACrB,2BAA2B,EAC5B,MAAM,qCAAqC,CAAC;AAE7C;;;;;;GAMG;AACH,qBAAa,sCACX,YAAW,8BAA8B;IAIvC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAJhC,OAAO,CAAC,aAAa,CAA6C;gBAG/C,OAAO,EAAE,qBAAqB,EAC9B,aAAa,EAAE,2BAA2B;IAO7D,mEAAmE;IACnE,IAAI,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,8BAA8B;IAKtE,qFAAqF;IACrF,MAAM,CAAC,MAAM,SAAS,MAAM,EAC1B,UAAU,EAAE,0BAA0B,CAAC,MAAM,CAAC,EAC9C,IAAI,EAAE,qBAAqB,CAAC,MAAM,CAAC,GAClC,MAAM;IAKT,2EAA2E;IACrE,IAAI,CAAC,MAAM,SAAS,MAAM,EAC9B,UAAU,EAAE,0BAA0B,CAAC,MAAM,CAAC,EAC9C,KAAK,EAAE,uBAAuB,CAAC,MAAM,CAAC,EACtC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC;IAK7B,kEAAkE;IAC5D,OAAO,CAAC,MAAM,SAAS,MAAM,EACjC,UAAU,EAAE,0BAA0B,CAAC,MAAM,CAAC,EAC9C,KAAK,EAAE,uBAAuB,CAAC,MAAM,CAAC,EACtC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKzB,mEAAmE;IACnE,OAAO,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI;IAIvE,uDAAuD;IACvD,MAAM,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI;IAItE,iDAAiD;IAC3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,yDAAyD;IACnD,aAAa,CAAC,MAAM,EACxB,SAAS,EAAE,CAAC,aAAa,EAAE,8BAA8B,KAAK,OAAO,CAAC,MAAM,CAAC,GAC5E,OAAO,CAAC,MAAM,CAAC;IAQlB,oDAAoD;IACpD,KAAK,IAAI,IAAI;IAIb,sEAAsE;IACtE,eAAe,IAAI,OAAO;IAI1B,uEAAuE;IACjE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,yEAAyE;IACnE,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B,4EAA4E;IACtE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,EAAE,8BAA8B,GAAG,IAAI;IAIvD,+EAA+E;YACjE,eAAe;CAW9B"}
+{"version":3,"file":"MikroOrmTypedSheetsEntityManager.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/persistence/providers/mikro-orm/api/MikroOrmTypedSheetsEntityManager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EACV,qBAAqB,EACrB,8BAA8B,EAC9B,uBAAuB,EACvB,8BAA8B,EAC9B,0BAA0B,EAC1B,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,iDAAiD,CAAC;AAEzD,OAAO,KAAK,EACV,qBAAqB,EACrB,2BAA2B,EAC5B,MAAM,qCAAqC,CAAC;AAE7C;;;;;;GAMG;AACH,qBAAa,sCACX,YAAW,8BAA8B;IAIvC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAJhC,OAAO,CAAC,aAAa,CAA6C;gBAG/C,OAAO,EAAE,qBAAqB,EAC9B,aAAa,EAAE,2BAA2B;IAO7D,mEAAmE;IACnE,IAAI,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,8BAA8B;IAOtE,qFAAqF;IACrF,MAAM,CAAC,MAAM,SAAS,MAAM,EAC1B,UAAU,EAAE,0BAA0B,CAAC,MAAM,CAAC,EAC9C,IAAI,EAAE,qBAAqB,CAAC,MAAM,CAAC,GAClC,MAAM;IAQT,4EAA4E;IAC5E,OAAO,CAAC,WAAW;IAInB,2EAA2E;IACrE,IAAI,CAAC,MAAM,SAAS,MAAM,EAC9B,UAAU,EAAE,0BAA0B,CAAC,MAAM,CAAC,EAC9C,KAAK,EAAE,uBAAuB,CAAC,MAAM,CAAC,EACtC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC;IAQ7B,kEAAkE;IAC5D,OAAO,CAAC,MAAM,SAAS,MAAM,EACjC,UAAU,EAAE,0BAA0B,CAAC,MAAM,CAAC,EAC9C,KAAK,EAAE,uBAAuB,CAAC,MAAM,CAAC,EACtC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQzB,mEAAmE;IACnE,OAAO,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI;IAIvE,uDAAuD;IACvD,MAAM,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI;IAItE,iDAAiD;IAC3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,yDAAyD;IACnD,aAAa,CAAC,MAAM,EACxB,SAAS,EAAE,CAAC,aAAa,EAAE,8BAA8B,KAAK,OAAO,CAAC,MAAM,CAAC,GAC5E,OAAO,CAAC,MAAM,CAAC;IAQlB,oDAAoD;IACpD,KAAK,IAAI,IAAI;IAIb,sEAAsE;IACtE,eAAe,IAAI,OAAO;IAI1B,uEAAuE;IACjE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,yEAAyE;IACnE,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B,4EAA4E;IACtE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,EAAE,8BAA8B,GAAG,IAAI;IAIvD,+EAA+E;YACjE,eAAe;CAW9B"}

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

@@ -26,23 +26,38 @@ export class MikroOrmSqliteTypedSheetsEntityManager {
     }
     /** 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));
+        const forked = options?.clear === undefined
+            ? this.entityManager.fork()
+            : this.entityManager.fork({ clear: options.clear });
+        return new MikroOrmSqliteTypedSheetsEntityManager(this.storage, forked);
     }
     /** 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);
+        if (typeof entityName === "string") {
+            const metadata = this.entityManager.getMetadata().getByUniqueName(entityName);
+            return this.entityManager.create(metadata.class, this.toMikroData(data), { partial: true });
+        }
+        return this.entityManager.create(entityName, this.toMikroData(data), { partial: true });
+    }
+    /** Converts public partial data into the untyped provider data boundary. */
+    toMikroData(data) {
+        return Object.fromEntries(Object.entries(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);
+        if (typeof entityName === "string") {
+            const metadata = this.entityManager.getMetadata().getByUniqueName(entityName);
+            return this.entityManager.find(metadata.class, where, options);
+        }
+        return this.entityManager.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);
+        if (typeof entityName === "string") {
+            const metadata = this.entityManager.getMetadata().getByUniqueName(entityName);
+            return this.entityManager.findOne(metadata.class, where, options);
+        }
+        return this.entityManager.findOne(entityName, where, options);
     }
     /** Marks one or more entities for MikroORM insertion or update. */
     persist(entity) {

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

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

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

@@ -6,7 +6,7 @@
  * setup before the application begins calling `em.persist()` and `em.flush()`.
  */
 import { type TypedSheetsEntityMapping, type TypedSheetsEntityMappingRegistry } from "../../../../../application/orm/mapping/entityMapping.js";
-import type { TypedSheetsEntityWriterOptions } from "../../../../../application/orm/persistence/support/contracts.js";
+import type { RegisteredTypedSheetsMappedProjection, TypedSheetsEntityWriterOptions } from "../../../../../application/orm/persistence/support/contracts.js";
 import type { TypedSheetsOrm } from "../../../../../application/orm/api/TypedSheetsOrm.js";
 import type { RegisteredSyncProjectionDefinition } from "../../../../../application/sync/gateway/SyncGatewayBootstrap.js";
 import { type InitializeMikroOrmSqliteAdapterOptions, type MikroOrmSqliteAdapter } from "../storage/MikroOrmSqliteAdapter.js";
@@ -18,13 +18,20 @@ export interface CreateMappedTypedSheetsOrmOptions {
 /** 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.
+     * Optional internal hook invoked after local registry writes succeed.
      *
-     * Applications can pass `provisionRegisteredSyncSheets()` here to provision
-     * the exact generated headers without duplicating route configuration.
+     * The hook receives the exact generated projection definitions so the sync
+     * service can provision a remote gateway without duplicating route metadata.
      */
     readonly onRegisteredProjections?: (definitions: readonly RegisteredSyncProjectionDefinition[]) => Promise<void>;
 }
+/** Internal mapped runtime resources shared by the ORM facade and sync worker. */
+export interface InitializedMappedTypedSheetsRuntime {
+    readonly storage: MikroOrmSqliteAdapter;
+    readonly orm: TypedSheetsOrm;
+    readonly mappings: TypedSheetsEntityMappingRegistry;
+    readonly registrations: readonly RegisteredTypedSheetsMappedProjection[];
+}
 /**
  * Creates the public typed-sheets EntityManager facade with its built-in
  * canonical/outbox planner. Mapping routes must already be registered.
@@ -37,5 +44,7 @@ export declare function createMappedTypedSheetsOrm(storage: MikroOrmSqliteAdapte
  * projection registration. Remote Apps Script provisioning remains explicit so
  * a process cannot mutate a spreadsheet merely by opening its local database.
  */
+export declare function initializeMappedTypedSheetsRuntime(options: InitializeMappedTypedSheetsOrmOptions): Promise<InitializedMappedTypedSheetsRuntime>;
+/** Opens a mapped runtime and returns only its ORM facade for existing callers. */
 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

@@ -1 +1 @@
-{"version":3,"file":"MikroOrmMappedTypedSheets.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/persistence/providers/mikro-orm/engine/MikroOrmMappedTypedSheets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,gCAAgC,EACtC,MAAM,yDAAyD,CAAC;AACjE,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,iEAAiE,CAAC;AACtH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sDAAsD,CAAC;AAC3F,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"}
+{"version":3,"file":"MikroOrmMappedTypedSheets.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/persistence/providers/mikro-orm/engine/MikroOrmMappedTypedSheets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,gCAAgC,EACtC,MAAM,yDAAyD,CAAC;AACjE,OAAO,KAAK,EACV,qCAAqC,EACrC,8BAA8B,EAC/B,MAAM,iEAAiE,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sDAAsD,CAAC;AAC3F,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,kFAAkF;AAClF,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,gCAAgC,CAAC;IACpD,QAAQ,CAAC,aAAa,EAAE,SAAS,qCAAqC,EAAE,CAAC;CAC1E;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,iCAAiC,GACzC,cAAc,CAQhB;AAED;;;;;;GAMG;AACH,wBAAsB,kCAAkC,CACtD,OAAO,EAAE,qCAAqC,GAC7C,OAAO,CAAC,mCAAmC,CAAC,CAyB9C;AAED,mFAAmF;AACnF,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,qCAAqC,GAC7C,OAAO,CAAC,cAAc,CAAC,CAGzB"}