hikoutei 0.5.22 → 0.7.0

package/README.ja.md

@@ -215,41 +215,60 @@ MikroORM は実装の詳細であり、Hikoutei の公開エンティティ API
 - スキーマ変更・手動編集・競合更新には、依然としてアプリケーションの運用
   ポリシーが必要です。
 
+## ローカルクエリ
+
+読み取りは Hikoutei 独自の型付き演算子を使い、常に SQLite で実行されます。
+
+```ts
+const [users, total] = await em.findAndCount(
+  User,
+  {
+    name: { like: "Ada%" },
+    age: { gte: 18, lt: 65 },
+    active: { in: [true] },
+  },
+  {
+    orderBy: { age: "desc", name: "asc" },
+    limit: 20,
+    offset: 0,
+  },
+);
+```
+
+`eq`、`ne`、`gt`、`gte`、`lt`、`lte`、`in`、`nin` は、宣言された
+スカラー型で有効な範囲で利用でき、`like` は文字列専用です。
+`{ active: true }` のような等価条件の省略記法も引き続き利用できます。
+`count()` はページネーション前のフィルター総数を返し、`findAndCount()` は
+1 つの SQLite スナップショットからページと総数を読み取ります。明示的な
+並び順には最後のタイブレーカーとして主キーが追加され、`orderBy` のない
+ページネーションは主キーの昇順を使用します。
+
 ## プロジェクトステータス
 
 Hikoutei は活発に開発中です。現在の EntityManager は、スカラーエンティティの
-ライフサイクル操作、等価条件を使う `find()` / `findOne()`、`find()` の
-`limit` / `offset` ページネーション、コールバック形式の `transactional()` を
-サポートします。通常の読み取り元は常に SQLite であり、Google Sheets では
-ありません。
-`hikoutei setup` CLI がスプレッドシートとサービスアカウントをプロビジョニ
-ングし、direct Google Sheets API provider(環境変数による自動開始)が唯一の
-同期経路です — Apps Script ゲートウェイはありません。シート編集の取り込みと
+ライフサイクル操作、型付きローカルフィルターと並び順、`limit` / `offset`
+ページネーション、`count()`、スナップショット整合性のある `findAndCount()`、
+コールバック形式の `transactional()` をサポートします。通常の読み取り元は
+常に SQLite であり、Google Sheets ではありません。シート編集の取り込みと
 競合表示はまだ発展途上です。マイナーバージョンのアップグレード前にリリース
 ノートを確認してください。
 
 ## ロードマップ
 
-EntityManager のロードマップは、以下の実装順序に従います。段階の順序は確定
-していますが、日付やリリース番号は約束しません。
+最初の EntityManager 段階である豊富なローカル読み取りは完了しました。残る段階は
+以下の実装順序に従い、日付やリリース番号は約束しません。
 
-1. **豊富なローカル読み取り**
-   - Hikoutei 独自の型付きクエリ契約に、明示的な `eq`、`ne`、`gt`、
-     `gte`、`lt`、`lte`、`in`、`nin`、`like` 条件と `orderBy`、
-     `count()`、`findAndCount()` を追加します。
-   - MikroORM のクエリ型を公開せず、これらを既存の `limit` / `offset`
-     ページネーションと組み合わせます。
-2. **ライフサイクル安全な書き込み**
+1. **ライフサイクル安全な書き込み**
    - `upsert` と direct/bulk mutation 機能は、エンティティテーブル、
      canonical state、永続的な Sheet effect outbox を 1 つの SQLite
      トランザクションで処理する Hikoutei 独自の契約を通じてのみ追加します。
    - この原子的なライフサイクルを迂回し得る、生の `nativeInsert`、
      `nativeUpdate`、`nativeDelete`、または SQL パススルー API は約束しません。
-3. **リレーションとロード**
+2. **リレーションとロード**
    - many-to-one、one-to-many、`populate()` 機能を追加します。
    - 公開前に、リレーションの SQLite マッピング、Sheets プロジェクション
      表現、スキーマ動作、競合セマンティクスを一体として設計します。
-4. **スキーマ運用**
+3. **スキーマ運用**
    - マイグレーションとスキーマドリフト管理を追加します。
    - 検証と運用フローを既存のセットアップツールと統合します。
 

package/README.ko.md

@@ -208,39 +208,57 @@ MikroORM은 구현 세부 사항이며 Hikoutei의 공개 엔티티 API에는
 - 스키마 변경, 수동 편집, 충돌 업데이트에는 여전히 애플리케이션의 운영 정책이
   필요합니다.
 
+## 로컬 쿼리
+
+읽기는 Hikoutei가 정의한 타입 연산자를 사용하며 항상 SQLite에서 실행됩니다.
+
+```ts
+const [users, total] = await em.findAndCount(
+  User,
+  {
+    name: { like: "Ada%" },
+    age: { gte: 18, lt: 65 },
+    active: { in: [true] },
+  },
+  {
+    orderBy: { age: "desc", name: "asc" },
+    limit: 20,
+    offset: 0,
+  },
+);
+```
+
+`eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `in`, `nin`은 선언된 스칼라 타입에
+허용되는 범위에서 사용할 수 있고, `like`는 문자열 전용입니다. `{ active: true }`
+같은 동등 조건 축약도 계속 지원합니다. `count()`는 페이지네이션 전 필터 전체 개수를
+반환하고, `findAndCount()`는 한 SQLite 스냅샷에서 페이지와 전체 개수를 읽습니다.
+명시적 정렬에는 마지막 동률 해소 기준으로 PK가 추가되며, `orderBy` 없는
+페이지네이션은 PK 오름차순을 사용합니다.
+
 ## 프로젝트 상태
 
-Hikoutei는 활발히 개발 중입니다. 현재 EntityManager는 스칼라 엔티티의 생명주기
-작업, 동등 조건을 사용하는 `find()` / `findOne()`, `find()`의 `limit` /
-`offset` 페이지네이션, 콜백형 `transactional()`을 지원합니다. 일반 읽기는
-Google Sheets가 아니라 항상 SQLite에서 수행됩니다. `hikoutei setup` CLI가
-스프레드시트와 서비스 계정을 프로비저닝하며, direct Google Sheets API
-provider(환경 변수 자동 시작)가 유일한 sync 경로입니다 — Apps Script
-gateway가 없습니다. 시트 편집 수집과 충돌 표시는
+Hikoutei는 활발히 개발 중입니다. 현재 EntityManager는 스칼라 엔티티 생명주기,
+타입 로컬 필터와 정렬, `limit` / `offset` 페이지네이션, `count()`, 스냅샷이
+일관된 `findAndCount()`, 콜백형 `transactional()`을 지원합니다. 일반 읽기는
+Google Sheets가 아니라 항상 SQLite에서 수행됩니다. 시트 편집 수집과 충돌 표시는
 아직 발전 중입니다. 마이너 버전 업그레이드 전에 릴리스 노트를 확인하세요.
 
 ## 로드맵
 
-EntityManager 로드맵은 아래 구현 순서를 따릅니다. 단계 순서는 확정되어 있지만,
-일정이나 릴리스 번호는 약속하지 않습니다.
+첫 EntityManager 단계인 풍부한 로컬 읽기는 완료됐습니다. 남은 단계는 아래 구현
+순서를 따르며, 일정이나 릴리스 번호는 약속하지 않습니다.
 
-1. **풍부한 로컬 읽기**
-   - Hikoutei가 정의한 타입 쿼리 계약에 명시적 `eq`, `ne`, `gt`, `gte`,
-     `lt`, `lte`, `in`, `nin`, `like` 조건과 `orderBy`, `count()`,
-     `findAndCount()`를 추가합니다.
-   - MikroORM 쿼리 타입을 노출하지 않고 이 기능들을 기존 `limit` / `offset`
-     페이지네이션과 조합합니다.
-2. **생명주기 안전 쓰기**
+1. **생명주기 안전 쓰기**
    - `upsert`와 direct/bulk mutation 기능은 엔티티 테이블, canonical state,
      내구성 있는 Sheet effect outbox를 하나의 SQLite 트랜잭션에서 처리하는
      Hikoutei 정의 계약을 통해서만 추가합니다.
    - 이 원자적 생명주기를 우회할 수 있는 원시 `nativeInsert`, `nativeUpdate`,
      `nativeDelete` 또는 SQL 패스스루 API는 약속하지 않습니다.
-3. **관계와 로딩**
+2. **관계와 로딩**
    - many-to-one, one-to-many, `populate()` 기능을 추가합니다.
    - 공개 전에 관계의 SQLite 매핑, Sheets 프로젝션 표현, 스키마 동작, 충돌
      의미론을 함께 설계합니다.
-4. **스키마 운영**
+3. **스키마 운영**
    - 마이그레이션과 스키마 드리프트 관리를 추가합니다.
    - 검증 및 운영 흐름을 기존 설정 도구와 통합합니다.
 

package/README.md

@@ -12,7 +12,7 @@ changes are asynchronously projected to Google Sheets for human review and
 lightweight collaboration.
 
 <a href="https://www.npmjs.com/package/hikoutei">npm</a> ·
-<a href="docs/quick-start.md">Quick start</a> ·
+<a href="website/guide/quick-start.md">Quick start</a> ·
 <a href="https://github.com/ManddarinShop/Hikoutei/issues">Issues</a>
 
 [![npm version](https://img.shields.io/npm/v/hikoutei?style=flat-square)](https://www.npmjs.com/package/hikoutei)
@@ -48,6 +48,8 @@ const User = defineTypedSheetsEntity({
   properties: {
     id: { type: "string", primary: true },
     name: { type: "string" },
+    age: { type: "number" },
+    active: { type: "boolean" },
   },
 });
 
@@ -57,7 +59,7 @@ const hikoutei = await createTypedSheets({
 });
 
 const em = hikoutei.em.fork();
-const user = em.create(User, { id: "u1", name: "Ada" });
+const user = em.create(User, { id: "u1", name: "Ada", age: 36, active: true });
 em.persist(user);
 await em.flush();
 
@@ -257,12 +259,12 @@ Hikoutei uses a durable local outbox, idempotent delivery, and conflict-aware
 updates so temporary API failures do not lose committed application writes. The
 provider never logs credentials, spreadsheet IDs, URLs, or payloads, and it
 spaces request starts to stay inside Google's quota windows. See the
-[internal consistency model](docs/internal-consistency-model.md) for the
+[internal consistency model](website/guide/internal-consistency.md) for the
 detailed state machine and recovery rules.
 
 Live Google calls are opt-in; fake providers and SQLite fixtures are the normal
 verification path. The detailed setup and troubleshooting steps are in the
-[Quick start](docs/quick-start.md).
+[Quick start](website/guide/quick-start.md).
 
 ## Installation
 
@@ -278,16 +280,18 @@ entity API.
 
 ## Documentation
 
-- [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) —
+- [Quick start](website/guide/quick-start.md) — installation, ORM lifecycle,
+  and service-side sync setup.
+- [Architecture](website/guide/architecture.md) — how the local store and
+  Sheet views fit together.
+- [Write and synchronization flow](website/guide/sync-flow.md) —
   asynchronous delivery and recovery behavior.
-- [Internal consistency model](docs/internal-consistency-model.md) — durable
-  outbox, idempotent delivery, and conflict-aware updates.
-- [Development](docs/development.md) — local development and test commands.
-- [Benchmark notes](docs/sync-bulk-write-benchmark.md) — dated measurements
-  and their limitations.
+- [Internal consistency model](website/guide/internal-consistency.md) —
+  durable outbox, idempotent delivery, and conflict-aware updates.
+- [Contributing](website/guide/contributing.md) — local development and test
+  commands.
+- [Benchmark notes](website/guide/benchmarks.md) — dated measurements and
+  their limitations.
 
 ## Limitations
 
@@ -296,41 +300,79 @@ entity API.
 - SQLite is local to the service and is not a distributed coordination layer.
 - Schema changes, manual edits, and conflicting updates still need an
   operational policy from the application.
+- The EntityManager is an ORM-style facade over scalar entities, not a full
+  ORM: entity definitions are scalar-only (`string`, `number`, `boolean`,
+  `date`), and v1 permits uniqueness only on the primary/business key.
+- Relations, joins, `populate()`, migrations, cascades, bulk/ORM query
+  builders, and raw SQL are unsupported in this milestone. Sheets is an async
+  projection and human input surface, never a live query database.
+
+## Local queries
+
+Reads use Hikoutei-owned typed operators and always execute against SQLite:
+
+```ts
+const [users, total] = await em.findAndCount(
+  User,
+  {
+    name: { like: "Ada%" },
+    age: { gte: 18, lt: 65 },
+    active: { in: [true] },
+  },
+  {
+    orderBy: { age: "desc", name: "asc" },
+    limit: 20,
+    offset: 0,
+  },
+);
+```
+
+`eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `in`, and `nin` are available where
+valid for the declared scalar type; `like` is string-only. Equality shorthand
+such as `{ active: true }` remains supported. `count()` returns the unpaged
+filter total, and `findAndCount()` returns the filtered page plus a total
+that ignores `limit`/`offset` — both read from one SQLite snapshot. When an
+explicit `orderBy` omits the primary key, Hikoutei appends it in ascending
+order as the final tie-breaker; when the primary key is explicitly ordered,
+its supplied position and direction are preserved. Pagination without
+`orderBy` uses primary-key ascending order.
+
+An `offset` alone (no `limit`) is a valid offset-only read, and an explicit
+`limit: 0` returns an empty page rather than being treated as "no limit".
+`findOne()` returns one entity or `null` and accepts ordering but no paging
+options. Malformed filters, operators, ordering, and paging options fail with
+a stable `HikouteiError`; branch on `error.code` through the exported
+`HIKOUTEI_ERROR_CODES` constants (`HIKOUTEI_ERROR_CODES.INVALID_QUERY` and
+`HIKOUTEI_ERROR_CODES.INVALID_SCALAR_VALUE`, which resolve to the lowercase
+runtime codes `invalid_query` and `invalid_scalar_value`) instead of guessing
+strings or parsing messages.
 
 ## Project status
 
 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. 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
+entity lifecycle operations, typed local filters and ordering, `limit` /
+`offset` pagination, `count()`, snapshot-consistent `findAndCount()`, 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.
 
 ## Roadmap
 
-The EntityManager roadmap follows the implementation order below. The sequence
-is committed, but no milestone is tied to a date or release number.
+The first EntityManager milestone, rich local reads, is complete. Remaining
+milestones follow the implementation order below; no milestone is tied to a
+date or release number.
 
-1. **Rich local reads**
-   - Add a Hikoutei-owned typed query contract for explicit `eq`, `ne`, `gt`,
-     `gte`, `lt`, `lte`, `in`, `nin`, and `like` conditions, plus `orderBy`,
-     `count()`, and `findAndCount()`.
-   - Compose these capabilities with the existing `limit` / `offset`
-     pagination without exposing MikroORM query types.
-2. **Lifecycle-safe writes**
+1. **Lifecycle-safe writes**
    - Add `upsert` and direct/bulk mutation capabilities only through a
      Hikoutei-owned contract that preserves one SQLite transaction across the
      entity table, canonical state, and durable Sheet effect outbox.
    - Do not promise raw `nativeInsert`, `nativeUpdate`, `nativeDelete`, or SQL
      pass-through APIs that could bypass that atomic lifecycle.
-3. **Relationships and loading**
+2. **Relationships and loading**
    - Add many-to-one, one-to-many, and `populate()` capabilities.
    - Design SQLite relationship mapping, Sheets projection representation,
      schema behavior, and conflict semantics together before public release.
-4. **Schema operations**
+3. **Schema operations**
    - Add migration and schema drift management.
    - Integrate validation and operational workflows with the existing setup
      tooling.

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

@@ -84,27 +84,79 @@ export interface ScalarEntityFlushContext {
 export interface ScalarEntityFlushCoordinator {
     onFlush(context: ScalarEntityFlushContext): Promise<void>;
 }
-/** Equality filter and paging for a scalar entity read. */
-export interface ScalarEntityQuery {
+/** Non-null scalar comparison represented independently from any ORM syntax. */
+export interface ScalarEntityComparisonPredicate {
+    readonly kind: "comparison";
+    readonly field: string;
+    readonly operator: "eq" | "ne" | "gt" | "gte" | "lt" | "lte";
+    readonly value: Exclude<ScalarEntityValue, null>;
+}
+/** Non-empty set membership predicate after public-array validation. */
+export interface ScalarEntitySetPredicate {
+    readonly kind: "set";
+    readonly field: string;
+    readonly operator: "in" | "nin";
+    readonly values: readonly Exclude<ScalarEntityValue, null>[];
+}
+/** SQLite LIKE predicate over one validated string field and pattern. */
+export interface ScalarEntityLikePredicate {
+    readonly kind: "like";
+    readonly field: string;
+    readonly pattern: string;
+}
+/** Explicit nullable-field predicate that avoids SQL three-valued ambiguity. */
+export interface ScalarEntityNullPredicate {
+    readonly kind: "null";
+    readonly field: string;
+    readonly operator: "is_null" | "is_not_null";
+}
+/** Query constant produced by empty filters and empty membership sets. */
+export interface ScalarEntityConstantPredicate {
+    readonly kind: "constant";
+    readonly value: boolean;
+}
+/** Internal logical group used only after public field filters are validated. */
+export interface ScalarEntityPredicateGroup {
+    readonly kind: "all" | "any";
+    readonly predicates: readonly ScalarEntityPredicate[];
+}
+/** Provider-neutral query predicate promoted from the public filter boundary. */
+export type ScalarEntityPredicate = ScalarEntityComparisonPredicate | ScalarEntitySetPredicate | ScalarEntityLikePredicate | ScalarEntityNullPredicate | ScalarEntityConstantPredicate | ScalarEntityPredicateGroup;
+/** One normalized sort key in deterministic precedence order. */
+export interface ScalarEntityOrder {
+    readonly field: string;
+    readonly direction: "asc" | "desc";
+}
+/** Validated filter shared by collection reads and count queries. */
+export interface ScalarEntityCountQuery {
     readonly tableName: string;
     readonly primaryKeyColumn: string;
-    /** Equality filter on one or more declared columns. */
-    readonly where: Readonly<Record<string, ScalarEntityValue>>;
+    readonly predicate: ScalarEntityPredicate;
+}
+/** Validated filter, ordering, and paging for one scalar entity read. */
+export interface ScalarEntityQuery extends ScalarEntityCountQuery {
+    readonly orderBy: readonly ScalarEntityOrder[];
     readonly limit?: number;
     readonly offset?: number;
 }
+/** One scalar entity row returned by a read. */
+export type ScalarEntityRow = Readonly<Record<string, ScalarEntityValue>>;
+/** Read operations available both outside and inside provider transactions. */
+export interface ScalarEntityReader {
+    read(query: ScalarEntityQuery): Promise<readonly ScalarEntityRow[]>;
+    /** Returns the unpaged number of rows matching the query predicate. */
+    count(query: ScalarEntityCountQuery): Promise<number>;
+}
 /**
  * Write surface available inside one atomic transaction.
  *
  * Inserts, updates, and deletes run against the active transaction so a single
  * `flush()` either commits every entity row or rolls them all back.
  */
-export interface ScalarEntityTransaction {
+export interface ScalarEntityTransaction extends ScalarEntityReader {
     insert(row: ScalarEntityInsert): Promise<void>;
     update(row: ScalarEntityUpdate): Promise<void>;
     delete(row: ScalarEntityDelete): Promise<void>;
-    /** Reads rows through the active transaction's view of the table. */
-    read(query: ScalarEntityQuery): Promise<readonly ScalarEntityRow[]>;
     /**
      * Flushes provider-scheduled entity, canonical-state, and outbox work before
      * the common UoW advances snapshots. The enclosing transaction must still be
@@ -112,8 +164,6 @@ export interface ScalarEntityTransaction {
      */
     flush(): Promise<void>;
 }
-/** One scalar entity row returned by a read. */
-export type ScalarEntityRow = Readonly<Record<string, ScalarEntityValue>>;
 /**
  * Replaceable local persistence engine behind the public EntityManager.
  *
@@ -122,11 +172,11 @@ export type ScalarEntityRow = Readonly<Record<string, ScalarEntityValue>>;
  * callback within one SQLite transaction and roll the whole callback back when
  * it rejects.
  */
-export interface ScalarEntityPersistenceProvider {
+export interface ScalarEntityPersistenceProvider extends ScalarEntityReader {
     /** Runs one atomic transaction and rolls back every write on rejection. */
     beginTransaction<Result>(work: (transaction: ScalarEntityTransaction) => Promise<Result>): Promise<Result>;
-    /** Reads rows outside any transaction using a fresh persistence context. */
-    read(query: ScalarEntityQuery): Promise<readonly ScalarEntityRow[]>;
+    /** Runs read operations against one consistent persistence snapshot. */
+    readSnapshot<Result>(work: (reader: ScalarEntityReader) => Promise<Result>): Promise<Result>;
     /** Releases resources owned by the underlying SQLite connection. */
     close(): Promise<void>;
 }

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":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,gDAAgD;AAChD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC;AAExE,qDAAqD;AACrD,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAElE,kFAAkF;AAClF,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,uBAAuB,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED,iFAAiF;AACjF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,4BAA4B,EAAE,CAAC;CAC3D;AAED,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;CAC9D;AAED,8DAA8D;AAC9D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,iBAAiB,CAAC;IAC5C,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC7D,uEAAuE;IACvE,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;CACrE;AAED,mEAAmE;AACnE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,iBAAiB,CAAC;IAC5C,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;CAC9D;AAED,sEAAsE;AACtE,eAAO,MAAM,0BAA0B;;;;CAI7B,CAAC;AAEX,yEAAyE;AACzE,MAAM,MAAM,uBAAuB,GAC/B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,0BAA0B,CAAC,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAA;CAAE,GAC7F;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,0BAA0B,CAAC,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAA;CAAE,GAC7F;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,0BAA0B,CAAC,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAElG,wEAAwE;AACxE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACrD,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;CAC3B;AAED,mFAAmF;AACnF,MAAM,WAAW,4BAA4B;IAC3C,OAAO,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D;AAED,2DAA2D;AAC3D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,qEAAqE;IACrE,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAAC;IACpE;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,gDAAgD;AAChD,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAE1E;;;;;;;GAOG;AACH,MAAM,WAAW,+BAA+B;IAC9C,2EAA2E;IAC3E,gBAAgB,CAAC,MAAM,EACrB,IAAI,EAAE,CAAC,WAAW,EAAE,uBAAuB,KAAK,OAAO,CAAC,MAAM,CAAC,GAC9D,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,4EAA4E;IAC5E,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAAC;IACpE,oEAAoE;IACpE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}
+{"version":3,"file":"scalar.d.ts","sourceRoot":"","sources":["../../../../src/adapter/persistence/contracts/scalar.ts"],"names":[],"mappings":"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"}

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

@@ -7,7 +7,7 @@
  * entity statements in the same SQLite transaction.
  */
 import type { ResolvedHikouteiEntityDescriptor } from "../../../../../api/entity.js";
-import type { ScalarEntityFlushCoordinator, ScalarEntityPersistenceProvider, ScalarEntityQuery, ScalarEntityRow, ScalarEntityTransaction } from "../../../contracts/scalar.js";
+import type { ScalarEntityCountQuery, ScalarEntityFlushCoordinator, ScalarEntityPersistenceProvider, ScalarEntityQuery, ScalarEntityReader, 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. */
@@ -29,6 +29,10 @@ export declare class MikroOrmScalarPersistenceProvider implements ScalarEntityPe
     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[]>;
+    /** Counts rows through a clean manager without materializing entities. */
+    count(query: ScalarEntityCountQuery): Promise<number>;
+    /** Runs sequential reads through one consistent SQLite read transaction. */
+    readSnapshot<Result>(work: (reader: ScalarEntityReader) => Promise<Result>): Promise<Result>;
     /** Runs the common UoW plan and mapped work in one SQLite transaction. */
     beginTransaction<Result>(work: (transaction: ScalarEntityTransaction) => Promise<Result>): Promise<Result>;
     /** Closes the one SQLite connection owned by this provider. */

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;;;;;;;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"}
+{"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,EACV,sBAAsB,EAGtB,4BAA4B,EAE5B,+BAA+B,EAE/B,iBAAiB,EACjB,kBAAkB,EAClB,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,KAAK,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC;IAK3D,4EAA4E;IACtE,YAAY,CAAC,MAAM,EACvB,IAAI,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC,MAAM,CAAC,GACpD,OAAO,CAAC,MAAM,CAAC;IAUlB,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

@@ -30,6 +30,17 @@ export class MikroOrmScalarPersistenceProvider {
         const manager = this.storage.forkEntityManager();
         return readRows(manager, this.requireBindingByTable(query.tableName), query);
     }
+    /** Counts rows through a clean manager without materializing entities. */
+    async count(query) {
+        const manager = this.storage.forkEntityManager();
+        return countRows(manager, this.requireBindingByTable(query.tableName), query);
+    }
+    /** Runs sequential reads through one consistent SQLite read transaction. */
+    async readSnapshot(work) {
+        return this.storage.transactional(async ({ entityManager }) => {
+            return work(new MikroOrmScalarReader(entityManager, this.bindings, this.bindingsByTable));
+        });
+    }
     /** Runs the common UoW plan and mapped work in one SQLite transaction. */
     async beginTransaction(work) {
         return this.storage.transactional(async ({ entityManager }) => {
@@ -61,6 +72,9 @@ class MikroOrmScalarReader {
     async read(query) {
         return readRows(this.entityManager, this.requireBindingByTable(query.tableName), query);
     }
+    async count(query) {
+        return countRows(this.entityManager, this.requireBindingByTable(query.tableName), query);
+    }
     requireBindingByTable(tableName) {
         const binding = this.bindingsByTable.get(tableName);
         if (binding !== undefined)
@@ -149,7 +163,7 @@ function createManagedEntity(entityManager, binding, values) {
 async function readRows(entityManager, binding, query) {
     const result = await Reflect.apply(entityManager.find, entityManager, [
         binding.entity,
-        toMikroOrmFilter(binding.descriptor, query.where),
+        toMikroOrmFilter(toInternalPredicate(binding.descriptor, query.predicate), query.primaryKeyColumn),
         toMikroOrmQueryOptions(query),
     ]);
     if (!Array.isArray(result) || !result.every(isRecord)) {
@@ -157,17 +171,79 @@ async function readRows(entityManager, binding, query) {
     }
     return result.map((entity) => fromInternalEntity(binding.descriptor, entity));
 }
+async function countRows(entityManager, binding, query) {
+    const result = await Reflect.apply(entityManager.count, entityManager, [
+        binding.entity,
+        toMikroOrmFilter(toInternalPredicate(binding.descriptor, query.predicate), query.primaryKeyColumn),
+    ]);
+    if (typeof result !== "number" || !Number.isSafeInteger(result) || result < 0) {
+        throw new HikouteiError(HIKOUTEI_ERROR_CODES.INVALID_SCALAR_VALUE, "MikroORM count result must be a non-negative safe integer.");
+    }
+    return result;
+}
 function toMikroOrmQueryOptions(query) {
+    const orderBy = query.orderBy.map((order) => ({ [order.field]: order.direction }));
+    // SQLite rejects a bare `OFFSET` (it requires a preceding `LIMIT`), so an
+    // offset-only public query must use the SQLite idiom for "all rows after a
+    // skip": a negative `LIMIT`, which SQLite treats as no upper bound. The
+    // public option contract still allows `{ offset }` independently of
+    // `{ limit }`; this `LIMIT -1` stays inside the MikroORM adapter boundary and
+    // is never exposed as raw SQL to application code. `limit` is `0`-safe via
+    // nullish coalescing: an explicit `limit: 0` is preserved unchanged.
+    const limit = query.limit ?? (query.offset === undefined ? undefined : -1);
     return {
-        ...(query.limit === undefined ? {} : { limit: query.limit }),
+        ...(orderBy.length === 0 ? {} : { orderBy }),
+        ...(limit === undefined ? {} : { limit }),
         ...(query.offset === undefined ? {} : { offset: query.offset }),
     };
 }
-function toMikroOrmFilter(descriptor, where) {
-    return Object.fromEntries(Object.entries(where).map(([property, value]) => [
-        property,
-        toInternalValue(descriptor, property, value),
-    ]));
+function toInternalPredicate(descriptor, predicate) {
+    switch (predicate.kind) {
+        case "comparison":
+            return {
+                ...predicate,
+                value: toInternalValue(descriptor, predicate.field, predicate.value),
+            };
+        case "set":
+            return {
+                ...predicate,
+                values: predicate.values.map((value) => toInternalValue(descriptor, predicate.field, value)),
+            };
+        case "all":
+        case "any":
+            return {
+                ...predicate,
+                predicates: predicate.predicates.map((child) => toInternalPredicate(descriptor, child)),
+            };
+        case "like":
+        case "null":
+        case "constant":
+            return predicate;
+    }
+}
+function toMikroOrmFilter(predicate, primaryKeyColumn) {
+    switch (predicate.kind) {
+        case "comparison":
+            return { [predicate.field]: { [`$${predicate.operator}`]: predicate.value } };
+        case "set":
+            return { [predicate.field]: { [`$${predicate.operator}`]: [...predicate.values] } };
+        case "like":
+            return { [predicate.field]: { $like: predicate.pattern } };
+        case "null":
+            return predicate.operator === "is_null"
+                ? { [predicate.field]: null }
+                : { [predicate.field]: { $ne: null } };
+        case "constant":
+            return predicate.value ? {} : { [primaryKeyColumn]: { $in: [] } };
+        case "all":
+            return {
+                $and: predicate.predicates.map((child) => toMikroOrmFilter(child, primaryKeyColumn)),
+            };
+        case "any":
+            return {
+                $or: predicate.predicates.map((child) => toMikroOrmFilter(child, primaryKeyColumn)),
+            };
+    }
 }
 function toInternalData(descriptor, values) {
     return Object.fromEntries(Object.entries(values).map(([property, value]) => [