hikoutei 0.3.4 → 0.3.6

package/README.ja.md

@@ -8,7 +8,7 @@
 
 <a href="https://www.npmjs.com/package/hikoutei">npm パッケージ</a> ·
 <a href="https://github.com/ManddarinShop/Hikoutei/issues">Issues</a> ·
-<a href="apps-script/gateway/Code.gs">Apps Script Gateway</a>
+<a href="docs/quick-start.md">クイックスタート</a>
 
 [![npm version](https://img.shields.io/npm/v/hikoutei?style=flat-square)](https://www.npmjs.com/package/hikoutei)
 [![license](https://img.shields.io/npm/l/hikoutei?style=flat-square)](LICENSE)
@@ -18,8 +18,9 @@
 
 Hikoutei は、TypeScript と Node.js のアプリケーションで Google Sheets を
 MVP や社内ワークフローの人間向けの画面として利用できるようにします。
-アプリケーションは型付きエンティティとローカル SQLite を使い、付属の
-Apps Script Gateway を通して変更を Google Sheets へ非同期に届けられます。
+アプリケーションは型付きエンティティとローカル SQLite を使い、サービス
+アカウントの Google Sheets provider を通して変更を Google Sheets へ非同期に
+届けられます。
 
 Hikoutei の対象は意図的に限定されています。汎用データベースの代替、
 Prisma/JPA のクローン、汎用 Google Sheets API ラッパーを目的としていません。
@@ -47,7 +48,7 @@ SQLite provider が内部で利用しますが、ルート public API に MikroO
 ## クイックスタート
 
 エンティティ定義と SQLite の lifecycle はルート API だけを使います。Sheet route、
-gateway credential、provisioning、polling は内部 service bootstrap の責務です。
+provider credential、provisioning、polling は内部 service bootstrap の責務です。
 
 ```ts
 import { createTypedSheets, defineTypedSheetsEntity } from "hikoutei";
@@ -102,21 +103,43 @@ Sheet への配信は非同期に行います。
 
 ## Google Sheets の設定
 
-1. [`apps-script/gateway/Code.gs`](apps-script/gateway/Code.gs) を対象の
-   Spreadsheet にバインドした Apps Script プロジェクトへコピーし、Web App として
-   デプロイします。その後 `/exec` URL を入力して `setupSyncGateway()` を実行します。
-2. `TYPED_SHEETS_GATEWAY_URL`、`TYPED_SHEETS_GATEWAY_SHARED_SECRET`、
-   `TYPED_SHEETS_GATEWAY_SHEET_ID` を、追跡対象外のサーバー環境ファイルまたは
-   secret store に保管します。shared secret をブラウザコードや Git に入れないでください。
-3. 内部 sync bootstrap を開始すると private route/ownership configuration を検証し、
-   タブとヘッダーを provision した後、outbox 配信と User_Input polling を実行します。
-   アプリケーションは gateway API を直接呼び出しません。
-
-外部サーバーからアクセスするには、Web App のアクセス範囲でサーバーを許可する必要が
-あり、通常は **Anyone** が必要です。エディタ専用の `/dev` ではなく、デプロイ用の
-`/exec` URL を使用してください。`Code.gs` を変更した場合は、Web App deployment を
-新しいバージョンに更新してから利用します。詳しい設定とトラブルシューティングは
-[クイックスタート](docs/quick-start.md)を参照してください。
+Google Sheets の同期は service-side の責務です。推奨経路はサービスアカウントの
+`googleSheetsApi` provider で、ひとつのサービスアカウントがタブの provisioning、
+outbound effect の書き込み（高速 append、guarded update/delete、レシート、
+応答喪失の復旧）、テーブル読み取り、行アンカー、ユーザー編集の観察をすべて
+行います。アプリケーションは provider クライアントを import したり、Sheet route
+を `createTypedSheets()` に渡したりしません。
+
+1. `https://www.googleapis.com/auth/spreadsheets` スコープを持つ Google Cloud
+   サービスアカウントを作成し、対象スプレッドシートをそのメールアドレスに
+   **編集者**として共有します。provider がタブ作成、effect 行とレシート記録、
+   行アンカー管理を行うため、閲覧者権限では不十分です。Cloud プロジェクトで
+   Google Sheets API を有効化します。
+2. サービスアカウントキーのファイルパスをサーバーの
+   `GOOGLE_APPLICATION_CREDENTIALS` に置き、スプレッドシート ID はコミットされない
+   シークレットストアに保管します。キーをブラウザコードや Git に入れないでください。
+3. `googleSheetsApi` で内部 sync bootstrap を起動します。登録タブのヘッダーを
+   作成・検証した後、outbox 配信と User_Input polling を開始します。
+
+シートの整合性はリクエスト間の Sheet トランザクションから生まれるのではなく、
+隠された effect-receipt タブ、effect-id/payload-hash の重複排除、SQLite の
+durable outbox、フェンシング、フィールド単位の compare-and-set 証拠、
+postcondition 復旧から生まれます。provider は資格情報・スプレッドシート ID・
+URL・payload をログに残さず、要求開始間隔をクラスごと（読み取り/書き込み）
+1,100ms に調整して Google の quota window を守ります。`flush()` はローカル
+コミットのみを意味し、配信は非同期で、すべての書き込みはレシートで記録され、
+同じ effect worker が復旧します。
+
+追跡される live シナリオはこの provider で実行されます。
+[docs/sync-bulk-write-benchmark.md](docs/sync-bulk-write-benchmark.md) の
+10,000 行 append と update/delete の live 証拠も同じ REST 経路です。
+`scripts/bench/` の生トランスポート実験はレシート/CAS のない unguarded 経路
+なので、worker 経由の測定までは性能値を検証済みと見なさないでください。live
+呼び出しは opt-in で、通常の検証は fake provider と SQLite fixture を使います。
+
+従来の Apps Script Gateway と `appsScript`/`googleApiWorker` オプションは削除され、
+上記のサービスアカウント provider が唯一の同期経路です。詳しい設定と
+トラブルシューティングは [クイックスタート](docs/quick-start.md) を参照してください。
 
 ## ドキュメント
 
@@ -128,7 +151,7 @@ Sheet への配信は非同期に行います。
 
 ## 制限事項
 
-- Google Sheets にはクォータ、レイテンシー、Apps Script の実行時間制限があります。
+- Google Sheets にはクォータ、レイテンシー、API のレート制限があります。
 - Sheet の更新は非同期なので、アプリケーションはローカル状態を読み取るべきです。
 - SQLite はサービスにローカルなもので、分散調整レイヤーではありません。
 - スキーマ変更、手動編集、競合する変更に対する運用方針は、アプリケーション側で
@@ -138,7 +161,7 @@ Sheet への配信は非同期に行います。
 
 - Google Sheets から意図的なユーザー編集を取り込む機能を完成させる。
 - update/delete の競合処理と表示を改善する。
-- レジストリと Apps Script デプロイ用のセットアップツールを追加する。
+- レジストリと直接 provider デプロイ用のセットアップツールを追加する。
 - 公開パッケージのリリースを安定化する。
 
 現在の作業については [open issues](https://github.com/ManddarinShop/Hikoutei/issues)

package/README.ko.md

@@ -8,7 +8,7 @@
 
 <a href="https://www.npmjs.com/package/hikoutei">npm 패키지</a> ·
 <a href="https://github.com/ManddarinShop/Hikoutei/issues">이슈</a> ·
-<a href="apps-script/gateway/Code.gs">Apps Script Gateway</a>
+<a href="docs/quick-start.md">빠른 시작</a>
 
 [![npm version](https://img.shields.io/npm/v/hikoutei?style=flat-square)](https://www.npmjs.com/package/hikoutei)
 [![license](https://img.shields.io/npm/l/hikoutei?style=flat-square)](LICENSE)
@@ -18,8 +18,9 @@
 
 Hikoutei는 TypeScript와 Node.js 애플리케이션에서 Google Sheets를 MVP 또는
 내부 업무 흐름의 사람이 읽기 쉬운 화면으로 사용할 수 있게 합니다. 애플리케이션은
-타입이 지정된 엔티티와 로컬 SQLite를 사용하고, 포함된 Apps Script Gateway를
-통해 변경 내용을 Google Sheets에 비동기적으로 전달할 수 있습니다.
+타입이 지정된 엔티티와 로컬 SQLite를 사용하고, 서비스 계정 기반 Google
+Sheets provider를 통해 변경 내용을 Google Sheets에 비동기적으로 전달할 수
+있습니다.
 
 Hikoutei의 범위는 의도적으로 작습니다. 범용 데이터베이스 대체재, Prisma/JPA
 클론, 범용 Google Sheets API 래퍼를 목표로 하지 않습니다.
@@ -47,7 +48,7 @@ SQLite provider가 내부적으로 사용하지만 루트 public API에는 Mikro
 ## 빠른 시작
 
 엔티티 정의와 SQLite lifecycle은 루트 API만 사용합니다. Sheet route,
-gateway credential, provisioning, polling은 내부 service bootstrap의 책임입니다.
+provider credential, provisioning, polling은 내부 service bootstrap의 책임입니다.
 
 ```ts
 import { createTypedSheets, defineTypedSheetsEntity } from "hikoutei";
@@ -104,23 +105,42 @@ outbound worker와 User_Input polling을 시작합니다. service mode에서
 
 ## Google Sheets 설정
 
-1. [`apps-script/gateway/Code.gs`](apps-script/gateway/Code.gs)를 대상
-   Spreadsheet에 bound된 Apps Script 프로젝트에 복사하고 Web App으로
-   배포한 뒤 `/exec` URL을 입력하고 `setupSyncGateway()`를 실행합니다.
-2. `TYPED_SHEETS_GATEWAY_URL`, `TYPED_SHEETS_GATEWAY_SHARED_SECRET`,
-   `TYPED_SHEETS_GATEWAY_SHEET_ID`를 추적하지 않는 서버 환경 파일이나
-   secret store에 보관합니다. shared secret은 브라우저 코드나 Git에 넣지
-   마세요.
-3. 내부 sync bootstrap을 시작하면 private route/ownership configuration을
-   검증하고 탭과 헤더를 provisioning한 뒤 outbox delivery와 User_Input
-   polling을 실행합니다. 애플리케이션 코드는 gateway API를 호출하지
-   않습니다.
-
-외부 서버에서 접근하려면 Web App의 액세스 범위가 서버를 허용해야 하며,
-일반적으로 **Anyone** 설정이 필요합니다. 편집기 전용 `/dev`가 아니라 배포용
-`/exec` URL을 사용하세요. `Code.gs`를 변경하면 Web App deployment를 새
-버전으로 갱신해야 합니다. 상세한 설정과 문제 해결 방법은
-[빠른 시작](docs/quick-start.md)에 설명되어 있습니다.
+Google Sheets 동기화는 service-side의 책임입니다. 권장 경로는 서비스 계정
+기반 `googleSheetsApi` provider로, 하나의 서비스 계정으로 탭 provisioning,
+outbound effect 쓰기(빠른 append, guarded update/delete, receipt, 응답 유실
+복구), 테이블 읽기, 행 anchor, 사용자 편집 관찰을 모두 수행합니다.
+애플리케이션은 provider client를 import하거나 Sheet route를
+`createTypedSheets()`에 넘기지 않습니다.
+
+1. `https://www.googleapis.com/auth/spreadsheets` scope를 가진 Google Cloud
+   서비스 계정을 만들고, 대상 스프레드시트를 이메일로 **Editor** 권한으로
+   공유합니다. provider가 탭 생성, effect 행과 receipt 기록, 행 anchor 관리를
+   하므로 Viewer 권한으로는 부족합니다. Cloud 프로젝트에서 Google Sheets API를
+   활성화합니다.
+2. 서비스 계정 키 파일 경로를 서버의 `GOOGLE_APPLICATION_CREDENTIALS`에 두고,
+   스프레드시트 ID는 커밋되지 않는 시크릿 저장소에 보관합니다. 키를 브라우저
+   코드나 Git에 넣지 마세요.
+3. `googleSheetsApi`로 내부 sync bootstrap을 시작합니다. 등록된 탭의 헤더를
+   생성/검증한 뒤 outbox 전달과 User_Input polling을 시작합니다.
+
+시트 일관성은 요청 간 Sheet 트랜잭션에서 오지 않습니다. 숨겨진
+effect-receipt 탭, effect-id/payload-hash 중복 제거, SQLite durable outbox,
+fencing, 필드 단위 compare-and-set 증거, postcondition 복구에서 옵니다.
+provider는 자격 증명, 스프레드시트 ID, URL, payload를 로그에 남기지 않으며,
+요청 시작 간격을 클래스별(읽기/쓰기) 1,100ms로 조절해 Google quota window를
+지킵니다. `flush()`는 로컬 커밋만 의미하고 전달은 비동기이며, 모든 쓰기는
+receipt로 기록되고 같은 effect worker가 복구합니다.
+
+추적되는 live 시나리오는 이 provider로 실행됩니다.
+[docs/sync-bulk-write-benchmark.md](docs/sync-bulk-write-benchmark.md)의
+10,000행 append와 update/delete live 증거도 같은 REST 경로를 사용합니다.
+`scripts/bench/`의 원시 전송 실험은 receipt/CAS 없는 unguarded 경로이므로,
+worker를 통한 측정 전에는 성능 수치를 검증된 것으로 보지 마세요. live 호출은
+opt-in이며, 일반 검증은 fake provider와 SQLite fixture를 사용합니다.
+
+기존 Apps Script Gateway와 `appsScript`/`googleApiWorker` 옵션은 제거되어
+위 서비스 계정 provider가 유일한 동기화 경로입니다. 상세한 설정과 문제 해결
+방법은 [빠른 시작](docs/quick-start.md)에 설명되어 있습니다.
 
 ## 문서
 
@@ -134,7 +154,7 @@ outbound worker와 User_Input polling을 시작합니다. service mode에서
 
 ## 제한사항
 
-- Google Sheets에는 quota, 지연 시간, Apps Script 실행 시간 제한이 있습니다.
+- Google Sheets에는 quota, 지연 시간, API rate limit이 있습니다.
 - Sheet 업데이트는 비동기이므로 애플리케이션은 로컬 상태를 읽어야 합니다.
 - SQLite는 서비스에 로컬이며 분산 조정 계층이 아닙니다.
 - 스키마 변경, 수동 편집, 충돌하는 변경에 대한 운영 정책은 애플리케이션이
@@ -144,7 +164,7 @@ outbound worker와 User_Input polling을 시작합니다. service mode에서
 
 - Google Sheets에서 의도적인 사용자 편집을 수집하는 기능 완성.
 - update/delete 충돌 처리와 표시 개선.
-- 레지스트리 및 Apps Script 배포를 위한 설정 도구 추가.
+- 레지스트리 및 직접 provider 배포를 위한 설정 도구 추가.
 - 공개 패키지 릴리스 안정화.
 
 현재 작업은 [open issues](https://github.com/ManddarinShop/Hikoutei/issues)

package/README.md

@@ -8,7 +8,7 @@
 
 <a href="https://www.npmjs.com/package/hikoutei">npm package</a> ·
 <a href="https://github.com/ManddarinShop/Hikoutei/issues">Issues</a> ·
-<a href="apps-script/gateway/Code.gs">Apps Script gateway</a>
+<a href="docs/quick-start.md">Quick start</a>
 
 [![npm version](https://img.shields.io/npm/v/hikoutei?style=flat-square)](https://www.npmjs.com/package/hikoutei)
 [![license](https://img.shields.io/npm/l/hikoutei?style=flat-square)](LICENSE)
@@ -19,7 +19,7 @@
 Hikoutei helps TypeScript and Node.js applications use Google Sheets as a
 human-friendly part of an MVP or internal workflow. Your application works
 with typed entities and local SQLite; changes can be delivered to Google
-Sheets asynchronously through the included Apps Script gateway.
+Sheets asynchronously through a service-account Google Sheets provider.
 
 Hikoutei is intentionally focused. It is not a general-purpose database
 replacement, a Prisma/JPA clone, or a general Google Sheets API wrapper.
@@ -51,7 +51,7 @@ without changing the entity lifecycle API.
 ## Quick start
 
 Define a scalar entity and use the local SQLite authority through a
-request-local manager. Sheet routes, gateway credentials, provisioning, and
+request-local manager. Sheet routes, provider credentials, provisioning, and
 polling belong to the internal service bootstrap rather than the application
 API.
 
@@ -111,36 +111,52 @@ Use a conventional database and direct Google APIs when you need:
 ## Google Sheets setup
 
 Google Sheets synchronization is a service-side concern. Applications do not
-import a gateway client, pass Sheet routes to `createTypedSheets()`, call
+import a provider 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 and deploy it as a Web App. Paste the
-   deployed `/exec` URL into the `TYPED_SHEETS_GATEWAY_URL` constant in
-   `Code.gs` and run `setupSyncGateway()` from the editor; it stores the bound
-   spreadsheet ID and a generated shared secret in Script Properties and logs
-   a copyable local `.env` block.
-2. Keep `TYPED_SHEETS_GATEWAY_URL`,
-   `TYPED_SHEETS_GATEWAY_SHARED_SECRET`, and
-   `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 MVP path is a single `Code.gs` file: it requires no `appsscript.json`
-manifest, no Apps Script Advanced Sheets Service, no Google Cloud Sheets API
-activation, and no service account. Sheet consistency does not come from
-cross-request Sheet transactions; it comes from the Apps Script script lock,
-the hidden effect-receipt tab, effect-id/payload-hash dedupe, the SQLite
-durable outbox, fencing, and postcondition recovery.
-
-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. 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).
+### Service-account provider (googleSheetsApi)
+
+The sync runtime uses one Google Sheets API provider (the internal
+`googleSheetsApi` bootstrap option) with a service account — no Apps Script
+deployment. The provider provisions the registered tabs, writes outbound
+effects (fast append, guarded update/delete, receipts, response-loss
+recovery), reads table values, assigns row anchors, and observes human edits:
+
+1. Create a Google Cloud service account with the
+   `https://www.googleapis.com/auth/spreadsheets` scope and share the target
+   spreadsheet with its email as an Editor: the provider creates tabs, writes
+   effect rows and receipt records, and manages row anchors, so Viewer access
+   is not enough. Enable the Google Sheets API for the Cloud project.
+2. Keep the service-account key file path in
+   `GOOGLE_APPLICATION_CREDENTIALS` on the server, and the spreadsheet ID in
+   an untracked secret store. Never put the key in browser code or Git.
+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.
+
+Sheet consistency does not come from cross-request Sheet transactions; it
+comes from the hidden effect-receipt tab, effect-id/payload-hash dedupe, the
+SQLite durable outbox, fencing, field-level compare-and-set evidence, and
+postcondition recovery. The provider never logs credentials, spreadsheet IDs,
+URLs, or payloads; it spaces request starts at 1,100 ms per class (reads and
+writes separately) to stay inside Google's quota windows, and it keeps the
+same SQLite-authoritative model: `flush()` commits locally, delivery is
+asynchronous, and every write is receipted and recovered through the same
+effect worker.
+
+The tracked live scenario runs through this provider. The 10,000-row append
+and update/delete live evidence recorded in
+[docs/sync-bulk-write-benchmark.md](docs/sync-bulk-write-benchmark.md) uses
+the same REST path; the raw-transport experiments under `scripts/bench/`
+measure the unguarded API path (no receipts, no compare-and-set), so treat
+any throughput number as unverified until it is measured through the full
+worker. Live Google calls are opt-in; fake providers and SQLite fixtures are
+the normal verification path.
+
+The previous Apps Script gateway and the `appsScript`/`googleApiWorker`
+options were removed; the service-account provider above is the only sync
+path. The detailed setup and troubleshooting steps are in the
+[Quick start](docs/quick-start.md).
 
 ## Documentation
 
@@ -155,7 +171,7 @@ The detailed setup and troubleshooting steps are in the [Quick start](docs/quick
 
 ## Limitations
 
-- Google Sheets has quota, latency, and Apps Script execution limits.
+- Google Sheets has quota, latency, and API rate limits.
 - Sheet updates are asynchronous; the application should read its local state.
 - SQLite is local to the service and is not a distributed coordination layer.
 - Schema changes, manual edits, and conflicting updates still need an
@@ -165,7 +181,7 @@ The detailed setup and troubleshooting steps are in the [Quick start](docs/quick
 
 - Complete ingestion of intentional user edits from Google Sheets.
 - Improve update/delete conflict handling and presentation.
-- Add setup tooling for registry and Apps Script deployment.
+- Add setup tooling for registry and direct provider deployment.
 - Stabilize the public package release.
 
 See the [open issues](https://github.com/ManddarinShop/Hikoutei/issues)

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

@@ -8,7 +8,7 @@
 import { type TypedSheetsEntityMapping, type TypedSheetsEntityMappingRegistry } from "../../../../../application/orm/mapping/entityMapping.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 { RegisteredSyncProjectionDefinition } from "../../../../../application/sync/sheets/sheetsProvisioning.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 {
@@ -21,7 +21,7 @@ export interface InitializeMappedTypedSheetsOrmOptions extends InitializeMikroOr
      * Optional internal hook invoked after local registry writes succeed.
      *
      * The hook receives the exact generated projection definitions so the sync
-     * service can provision a remote gateway without duplicating route metadata.
+     * service can provision a remote provider without duplicating route metadata.
      */
     readonly onRegisteredProjections?: (definitions: readonly RegisteredSyncProjectionDefinition[]) => Promise<void>;
 }
@@ -41,7 +41,7 @@ export declare function createMappedTypedSheetsOrm(storage: MikroOrmSqliteAdapte
  * 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
+ * projection registration. Remote provider-side provisioning remains explicit so
  * a process cannot mutate a spreadsheet merely by opening its local database.
  */
 export declare function initializeMappedTypedSheetsRuntime(options: InitializeMappedTypedSheetsOrmOptions): Promise<InitializedMappedTypedSheetsRuntime>;

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,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"}
+{"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,8DAA8D,CAAC;AAIvH,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"}

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

@@ -27,7 +27,7 @@ export function createMappedTypedSheetsOrm(storage, options) {
  * 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
+ * projection registration. Remote provider-side provisioning remains explicit so
  * a process cannot mutate a spreadsheet merely by opening its local database.
  */
 export async function initializeMappedTypedSheetsRuntime(options) {

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

@@ -2,7 +2,7 @@
  * Materializes scalar entity schemas and provider bindings without sync code.
  *
  * The root ORM factory imports this module only. Projection mapping, canonical
- * state, and gateway code remain behind the internal sync-service path.
+ * state, and provider code remain behind the internal sync-service path.
  */
 import type { HikouteiEntity } from "../../../../../api/entity.js";
 import type { MikroOrmSqliteEntity } from "../storage/MikroOrmSqliteAdapter.js";

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

@@ -2,7 +2,7 @@
  * Materializes scalar entity schemas and provider bindings without sync code.
  *
  * The root ORM factory imports this module only. Projection mapping, canonical
- * state, and gateway code remain behind the internal sync-service path.
+ * state, and provider code remain behind the internal sync-service path.
  */
 import { defineEntity, p } from "@mikro-orm/sql";
 import { getEntityDescriptor } from "../../../../../api/entity.js";

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

@@ -12,7 +12,7 @@ import { TYPED_SHEETS_ORM_ERROR_CODES, TypedSheetsOrmError, } from "../../../../
 import { createMikroOrmScalarEntityRuntime, } from "./MikroOrmScalarEntityRuntime.js";
 import { FIELD_OWNERSHIPS } from "../../../../../domain/model/constants.js";
 import { NORMALIZED_CELL_KINDS, } from "../../../../../shared/encoding/constants.js";
-import { SYNC_GATEWAY_PROJECTIONS } from "../../../../../application/sync/gateway/constants.js";
+import { SYNC_PROJECTIONS } from "../../../../../application/sync/sheets/constants.js";
 /**
  * Adds internal projection mappings to the provider materialization.
  *
@@ -51,14 +51,14 @@ function createMapping(descriptor, reference, entityConfig, spreadsheetId) {
             spreadsheetId,
             tabName: entityConfig.systemState.tabName,
             registeredRange: entityConfig.systemState.registeredRange,
-            projection: SYNC_GATEWAY_PROJECTIONS.SYSTEM_STATE,
+            projection: SYNC_PROJECTIONS.SYSTEM_STATE,
         },
         ...(entityConfig.userInput === undefined ? [] : [{
                 physicalSheetId: `${logicalSheetId}:user_input`,
                 spreadsheetId,
                 tabName: entityConfig.userInput.tabName,
                 registeredRange: entityConfig.userInput.registeredRange,
-                projection: SYNC_GATEWAY_PROJECTIONS.USER_INPUT,
+                projection: SYNC_PROJECTIONS.USER_INPUT,
             }]),
     ];
     return defineTypedSheetsEntityMapping({

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

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

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

@@ -2,12 +2,12 @@
  * Polls User_Input projections and applies accepted edits to the local entity
  * table through the observation writer.
  *
- * The gateway is treated as an untrusted observation source: only rows with a
+ * The provider is treated as an untrusted observation source: only rows with a
  * known SQLite business key and literal/blank cells are promoted. Canonical
  * state, field revisions, conflict candidates, and the System_State outbox
  * remain the durable source of truth.
  */
-import type { SyncSheetObservationGateway } from "../../../../../application/sync/gateway/syncGateway.js";
+import type { SyncSheetsObservationProvider } from "../../../../../application/sync/sheets/syncSheets.js";
 import { type SyncTimingSink } from "../../../../../application/sync/telemetry/syncTiming.js";
 import type { TypedSheetsEntityMapping, TypedSheetsEntityMappingRegistry } from "../../../../../application/orm/mapping/entityMapping.js";
 import type { TypedSheetsEntityWriterOptions } from "../../../../../application/orm/persistence/support/contracts.js";
@@ -67,7 +67,7 @@ export interface MappedUserInputPollingReport {
 /** Options for the provider-specific first inbound worker slice. */
 export interface PollMappedUserInputWithMikroOrmOptions {
     readonly storage: MikroOrmSqliteAdapter;
-    readonly gateway: SyncSheetObservationGateway;
+    readonly provider: SyncSheetsObservationProvider;
     readonly mappings: TypedSheetsEntityMappingRegistry | readonly TypedSheetsEntityMapping[];
     readonly writer: TypedSheetsEntityWriterOptions;
     readonly physicalSheetIds?: readonly string[];

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

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

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

@@ -2,14 +2,14 @@
  * Polls User_Input projections and applies accepted edits to the local entity
  * table through the observation writer.
  *
- * The gateway is treated as an untrusted observation source: only rows with a
+ * The provider is treated as an untrusted observation source: only rows with a
  * known SQLite business key and literal/blank cells are promoted. Canonical
  * state, field revisions, conflict candidates, and the System_State outbox
  * remain the durable source of truth.
  */
 import { emptySyncTimingOperationCounts, SYNC_TIMING_SCOPES, } from "../../../../../application/sync/telemetry/syncTiming.js";
-import { isSyncSheetTableReaderGateway, observeSyncSnapshots, } from "../../../../../application/sync/gateway/syncGateway.js";
-import { SYNC_GATEWAY_PROJECTIONS, SYNC_GATEWAY_SNAPSHOT_READ_MODES, } from "../../../../../application/sync/gateway/constants.js";
+import { isSyncSheetsTableReader, observeSyncSnapshots, } from "../../../../../application/sync/sheets/syncSheets.js";
+import { SYNC_PROJECTIONS, SYNC_SNAPSHOT_READ_MODES, } from "../../../../../application/sync/sheets/constants.js";
 import { createTypedSheetsEntityMappingRegistry, requireTypedSheetsEntityProjection, typedSheetsEntityProjectionHeaders, } from "../../../../../application/orm/mapping/entityMapping.js";
 import { resolveTypedSheetsEntityWriterOptions } from "../../../../../application/orm/persistence/flush/flushCoordinator.js";
 import { claimWriterLeaseWithAdapter, WRITER_LEASE_CLAIM_RESULT_KINDS, } from "../../../../../infrastructure/storage/index.js";
@@ -82,10 +82,10 @@ export async function pollMappedUserInputWithMikroOrm(options) {
     const accumulators = mappings.map((mapping) => createAccumulator(mapping));
     const canUseAdaptivePath = requestedMode === MAPPED_USER_INPUT_POLL_MODES.ADAPTIVE &&
         options.forceFull !== true &&
-        isSyncSheetTableReaderGateway(options.gateway);
+        isSyncSheetsTableReader(options.provider);
     if (canUseAdaptivePath) {
         const valuesReadStartedAt = Date.now();
-        const fastResults = await options.gateway.readRowsBatch(mappings.map(toTableRowsRequest));
+        const fastResults = await options.provider.readRowsBatch(mappings.map(toTableRowsRequest));
         emitPollingTiming(timingSink, POLLING_TIMING_PHASES.VALUES_ONLY_READ, Date.now() - valuesReadStartedAt);
         assertTableReadCount(fastResults, mappings.length);
         const fullMappings = [];
@@ -125,7 +125,7 @@ export async function pollMappedUserInputWithMikroOrm(options) {
             return report;
         }
         const observationStartedAt = Date.now();
-        const observed = await observeSyncSnapshots(options.gateway, fullMappings.map(toSnapshotRequest));
+        const observed = await observeSyncSnapshots(options.provider, fullMappings.map(toSnapshotRequest));
         emitPollingTiming(timingSink, POLLING_TIMING_PHASES.FULL_METADATA_OBSERVATION, Date.now() - observationStartedAt);
         assertObservationCount(observed, fullMappings.length);
         const prepared = prepareObservedRows(fullMappings, observed, state, fullAccumulators);
@@ -145,7 +145,7 @@ export async function pollMappedUserInputWithMikroOrm(options) {
         return report;
     }
     const observationStartedAt = Date.now();
-    const observed = await observeSyncSnapshots(options.gateway, mappings.map(toSnapshotRequest));
+    const observed = await observeSyncSnapshots(options.provider, mappings.map(toSnapshotRequest));
     emitPollingTiming(timingSink, POLLING_TIMING_PHASES.FULL_METADATA_OBSERVATION, Date.now() - observationStartedAt);
     assertObservationCount(observed, mappings.length);
     const prepared = prepareObservedRows(mappings, observed, state, accumulators);
@@ -265,14 +265,14 @@ function createPollingReport(startedAt, accumulators, metrics) {
     };
 }
 function toTableRowsRequest(mapping) {
-    const projection = requireTypedSheetsEntityProjection(mapping, SYNC_GATEWAY_PROJECTIONS.USER_INPUT);
+    const projection = requireTypedSheetsEntityProjection(mapping, SYNC_PROJECTIONS.USER_INPUT);
     return {
         physicalSheetId: projection.physicalSheetId,
         sheetName: projection.tabName,
         registeredRange: projection.registeredRange,
-        projection: SYNC_GATEWAY_PROJECTIONS.USER_INPUT,
+        projection: SYNC_PROJECTIONS.USER_INPUT,
         schemaVersion: mapping.schemaVersion,
-        headers: typedSheetsEntityProjectionHeaders(mapping, SYNC_GATEWAY_PROJECTIONS.USER_INPUT),
+        headers: typedSheetsEntityProjectionHeaders(mapping, SYNC_PROJECTIONS.USER_INPUT),
     };
 }
 function selectMappings(input, physicalSheetIds) {
@@ -283,21 +283,21 @@ function selectMappings(input, physicalSheetIds) {
         ? undefined
         : new Set(physicalSheetIds);
     return registry.mappings.filter((mapping) => {
-        const projection = mapping.projections.find((candidate) => candidate.projection === SYNC_GATEWAY_PROJECTIONS.USER_INPUT);
+        const projection = mapping.projections.find((candidate) => candidate.projection === SYNC_PROJECTIONS.USER_INPUT);
         return projection !== undefined && (selected === undefined || selected.has(projection.physicalSheetId));
     });
 }
 function toSnapshotRequest(mapping) {
-    const projection = requireTypedSheetsEntityProjection(mapping, SYNC_GATEWAY_PROJECTIONS.USER_INPUT);
+    const projection = requireTypedSheetsEntityProjection(mapping, SYNC_PROJECTIONS.USER_INPUT);
     return {
         physicalSheetId: projection.physicalSheetId,
         sheetName: projection.tabName,
         registeredRange: projection.registeredRange,
-        projection: SYNC_GATEWAY_PROJECTIONS.USER_INPUT,
+        projection: SYNC_PROJECTIONS.USER_INPUT,
         schemaVersion: mapping.schemaVersion,
         // Polling must retain formula/merge/error metadata so invalid cells are
         // quarantined instead of being mistaken for literal user edits.
-        readMode: SYNC_GATEWAY_SNAPSHOT_READ_MODES.FULL,
+        readMode: SYNC_SNAPSHOT_READ_MODES.FULL,
     };
 }
 async function readMappedPollingState(storage, mappings) {
@@ -324,7 +324,7 @@ function createAccumulator(mapping) {
 }
 function toSheetReport(accumulator) {
     return {
-        physicalSheetId: requireTypedSheetsEntityProjection(accumulator.mapping, SYNC_GATEWAY_PROJECTIONS.USER_INPUT).physicalSheetId,
+        physicalSheetId: requireTypedSheetsEntityProjection(accumulator.mapping, SYNC_PROJECTIONS.USER_INPUT).physicalSheetId,
         logicalSheetId: accumulator.mapping.logicalSheetId,
         rowsScanned: accumulator.rowsScanned,
         changedRows: accumulator.changedRows,