@odla-ai/chapter 0.33.0 → 0.33.1

package/README.md

@@ -445,6 +445,11 @@ join-config, application tier validation, and checkout already read. Public
 application contract, and theme. Applicant requests therefore use local
 last-known-good state and never depend on the hub being reachable.
 
+The first delivery is empty-history safe: Chapter checks a bounded aggregate
+count before asking odla-db to order revision history. A freshly provisioned
+follower therefore acknowledges revision 1 immediately instead of depending on
+an ordered query over an empty result set.
+
 The hub owns a durable outbox: create/verify immutable Stripe Prices first,
 persist the desired revision, retry signed delivery, and mark it active only
 after the exact revision/digest receipt. Version history is for audit and

package/dist/index.d.cts

@@ -310,6 +310,16 @@ interface DbOp {
  *  member routes consume — so route logic is testable against an in-memory fake. */
 interface ChapterDb {
     query(q: Record<string, unknown>): Promise<Record<string, Array<Record<string, unknown>>>>;
+    /** Optional bounded aggregate supported by the real privileged odla-db
+     * client. Routes use it to prove a result set is non-empty before issuing
+     * an ordered lookup, while small test doubles may continue to omit it. */
+    aggregate?(ns: string, spec: {
+        count?: boolean;
+    }, opts?: {
+        where?: Record<string, unknown>;
+    }): Promise<{
+        count?: number;
+    }>;
     transact(ops: DbOp[], opts?: {
         mutationId?: string;
     }): Promise<{

package/dist/index.d.ts

@@ -310,6 +310,16 @@ interface DbOp {
  *  member routes consume — so route logic is testable against an in-memory fake. */
 interface ChapterDb {
     query(q: Record<string, unknown>): Promise<Record<string, Array<Record<string, unknown>>>>;
+    /** Optional bounded aggregate supported by the real privileged odla-db
+     * client. Routes use it to prove a result set is non-empty before issuing
+     * an ordered lookup, while small test doubles may continue to omit it. */
+    aggregate?(ns: string, spec: {
+        count?: boolean;
+    }, opts?: {
+        where?: Record<string, unknown>;
+    }): Promise<{
+        count?: number;
+    }>;
     transact(ops: DbOp[], opts?: {
         mutationId?: string;
     }): Promise<{

package/dist/worker/index.cjs

@@ -527,7 +527,16 @@ function asStored(row) {
   if (!row || typeof row.document !== "object" || row.document === null) return null;
   return row;
 }
+async function hasSignupControl(db, targetId, environment, active) {
+  const where = { targetId, environment, ...active ? { active: true } : {} };
+  if (db.aggregate) {
+    return Number((await db.aggregate("signupControls", { count: true }, { where })).count ?? 0) > 0;
+  }
+  const rows2 = (await db.query({ signupControls: {} })).signupControls;
+  return Array.isArray(rows2) && rows2.some((row) => row.targetId === targetId && row.environment === environment && (!active || row.active === true));
+}
 async function loadLatestSignupControl(db, targetId, environment) {
+  if (!await hasSignupControl(db, targetId, environment)) return null;
   const rows2 = (await db.query({ signupControls: { $: {
     where: { targetId, environment },
     order: { revision: "desc" },
@@ -537,6 +546,7 @@ async function loadLatestSignupControl(db, targetId, environment) {
   return asStored(latest);
 }
 async function loadActiveSignupControl(db, targetId, environment) {
+  if (!await hasSignupControl(db, targetId, environment, true)) return null;
   const rows2 = (await db.query({ signupControls: { $: {
     where: { targetId, environment, active: true },
     order: { revision: "desc" },