@oimlsmart/platform-server 0.2.2 → 0.2.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oimlsmart/platform-server",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "The OIML SMART platform server kernel: the store seam (ServerStore + the D1 and SQLite implementations), the canonical D1 migration set both deployments apply, the instance profile, the mailer, the RBAC map, the OIDC/OAuth client cones, and the shared role/permission vocabulary. Consumed by the smart monorepo (browser/) and the identity service.",
   "type": "module",
   "repository": {

package/src/store/d1.ts

@@ -3235,8 +3235,16 @@ export class D1ServerStore implements ServerStore {
   // ── the workflow entity store + change journal ───────────────────
 
   async listEntities(store: string): Promise<EntityRow[]> {
+    // The ORDER BY is the seam's contract (the 0.2.3 pin): the answer
+    // arrives in (org_id, rowid) order — the read's observable order
+    // since migration 0001, when the planner walked
+    // idx_entities_store_org. Migration 0023's expression index offered
+    // a second store-prefixed walk and the unnamed order flipped to
+    // insertion (the smart app's render-baseline red, oimlsmart/smart
+    // PR #264) — a list read's order is a consumer-visible contract,
+    // never the planner's pick.
     const res = await this.stmt(
-      'SELECT store, id, org_id, data, updated_at FROM entities WHERE store = ?', store,
+      'SELECT store, id, org_id, data, updated_at FROM entities WHERE store = ? ORDER BY org_id, rowid', store,
     ).all<EntityRow>()
     return res.results
   }

package/src/store/sqlite/entities.ts

@@ -21,8 +21,13 @@ export { ORG_FIELDS, CATALOG_STORES, orgIdOf } from '../../store'
 import type { EntityRow, EntityChange } from '../../store'
 
 export function listEntities(store: string): EntityRow[] {
+  // The ORDER BY is the seam's contract (the 0.2.3 pin, the D1 half's
+  // twin): (org_id, rowid) — the read's observable order since
+  // migration 0001's idx_entities_store_org walk, made planner-proof
+  // when migration 0023's expression index offered a second
+  // store-prefixed plan.
   return getDb()
-    .prepare('SELECT store, id, org_id, data, updated_at FROM entities WHERE store = ?')
+    .prepare('SELECT store, id, org_id, data, updated_at FROM entities WHERE store = ? ORDER BY org_id, rowid')
     .all(store) as EntityRow[]
 }
 

package/src/store.ts

@@ -2221,6 +2221,12 @@ export interface ServerStore {
   ): Promise<InstrumentRegistration | null>
 
   // ── the workflow entity store + change journal ──
+  /** The store's rows, in the seam's declared order: (org_id, rowid) —
+   *  the read's observable order since migration 0001 (NULL org ids
+   *  first, then by org id, then by insertion). Both backends spell the
+   *  ORDER BY explicitly — a list read's order is a consumer-visible
+   *  contract, never the planner's pick (the 0.2.3 pin, after
+   *  migration 0023's expression index flipped the unnamed walk). */
   listEntities(store: string): Promise<EntityRow[]>
   getEntity(store: string, id: string): Promise<EntityRow | undefined>
   putEntity(store: string, id: string, orgId: string | null, data: string): Promise<void>