@odla-ai/chapter 0.33.0 → 0.33.2

package/dist/index.d.cts

@@ -300,17 +300,35 @@ interface ChapterPolicy {
 type ChapterMode = "chapter" | "hub";
 /** One odla-db transaction op — the wire shape both the real admin client and a
  *  test double (`FakeDb`) accept. Built as a plain object, never via a `tx` proxy. */
-interface DbOp {
+interface DbOp<Id extends string | {
+    ns: string;
+    attr: string;
+    value: string | number | boolean;
+} = string> {
     t: "update" | "merge" | "retract" | "delete";
     ns: string;
-    id: string;
+    id: Id;
     attrs?: Record<string, unknown>;
 }
 /** The structural view of the odla-db admin client the worker builds and the
  *  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>>>>;
-    transact(ops: DbOp[], opts?: {
+    /** 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<string | {
+        ns: string;
+        attr: string;
+        value: string | number | boolean;
+    }>[], opts?: {
         mutationId?: string;
     }): Promise<{
         txId: number;
@@ -2016,7 +2034,7 @@ interface SignupControlReceipt {
     acknowledgedAt: number;
 }
 /** Stable reason codes returned when a follower refuses desired state. */
-type SignupControlRejection = "invalid_document" | "invalid_digest" | "wrong_source" | "wrong_target" | "wrong_environment" | "wrong_stripe_mode" | "stale_revision" | "conflicting_revision";
+type SignupControlRejection = "invalid_document" | "invalid_digest" | "wrong_source" | "wrong_target" | "wrong_environment" | "wrong_stripe_mode" | "stale_revision" | "conflicting_revision" | "materialization_failed";
 /** Normalized document result returned by the package validator. */
 type SignupControlValidation = {
     ok: true;

package/dist/index.d.ts

@@ -300,17 +300,35 @@ interface ChapterPolicy {
 type ChapterMode = "chapter" | "hub";
 /** One odla-db transaction op — the wire shape both the real admin client and a
  *  test double (`FakeDb`) accept. Built as a plain object, never via a `tx` proxy. */
-interface DbOp {
+interface DbOp<Id extends string | {
+    ns: string;
+    attr: string;
+    value: string | number | boolean;
+} = string> {
     t: "update" | "merge" | "retract" | "delete";
     ns: string;
-    id: string;
+    id: Id;
     attrs?: Record<string, unknown>;
 }
 /** The structural view of the odla-db admin client the worker builds and the
  *  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>>>>;
-    transact(ops: DbOp[], opts?: {
+    /** 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<string | {
+        ns: string;
+        attr: string;
+        value: string | number | boolean;
+    }>[], opts?: {
         mutationId?: string;
     }): Promise<{
         txId: number;
@@ -2016,7 +2034,7 @@ interface SignupControlReceipt {
     acknowledgedAt: number;
 }
 /** Stable reason codes returned when a follower refuses desired state. */
-type SignupControlRejection = "invalid_document" | "invalid_digest" | "wrong_source" | "wrong_target" | "wrong_environment" | "wrong_stripe_mode" | "stale_revision" | "conflicting_revision";
+type SignupControlRejection = "invalid_document" | "invalid_digest" | "wrong_source" | "wrong_target" | "wrong_environment" | "wrong_stripe_mode" | "stale_revision" | "conflicting_revision" | "materialization_failed";
 /** Normalized document result returned by the package validator. */
 type SignupControlValidation = {
     ok: true;