@terminal3/t3n-sdk 3.14.0 → 3.16.0

package/dist/index.d.ts

@@ -2717,15 +2717,28 @@ interface DeleteGrantsInput {
     orgDid: string;
     contractId: string;
 }
-interface WriteDataInput {
+interface WriteDataInputBase {
     orgDid: string;
     scope: string;
     payloadHex: string;
-    /** Explicit entry ID (32 hex chars). When present, enables idempotent upsert. */
-    entryId?: string;
-    /** Client-supplied monotonic counter for ID derivation when `entryId` is absent. */
-    clientSeqNo?: number;
 }
+/**
+ * Write input. Exactly one identity source is required:
+ * - supply `entryId` (32 hex chars) for an idempotent upsert; or
+ * - omit `entryId` and supply `clientSeqNo`, and the entry ID is derived from
+ *   `(org_did, scope, writer_did, client_seq_no)`.
+ * The compiler rejects calls that provide neither.
+ */
+type WriteDataInput = (WriteDataInputBase & {
+    /** Explicit entry ID (32 hex chars). Enables idempotent upsert. */
+    entryId: string;
+    /** Optional; ignored when `entryId` is present. */
+    clientSeqNo?: number;
+}) | (WriteDataInputBase & {
+    entryId?: never;
+    /** Client-supplied monotonic counter for ID derivation. */
+    clientSeqNo: number;
+});
 interface DeleteDataInput {
     orgDid: string;
     scope: string;
@@ -3330,15 +3343,23 @@ interface TenantSelfAdmitResult {
     granted_credits: number | null;
 }
 type MapVisibility = string;
-type WriterSet = "all" | "All" | {
+/**
+ * Who may write a map. Canonical wire shape on both input and response is
+ * `"all" | { only: number[] }` (the contract enum is
+ * `#[serde(rename_all = "snake_case")]` with no aliases, so PascalCase forms
+ * like `"All"` / `{ Only }` are rejected on input).
+ */
+type WriterSet = "all" | {
     only: number[];
-} | {
-    Only: number[];
 };
-type ReaderSet = "all" | "All" | {
+/**
+ * Who may read a map. Canonical wire shape on both input and response is
+ * `"all" | { only: number[] }` (the contract enum is
+ * `#[serde(rename_all = "snake_case")]` with no aliases, so PascalCase forms
+ * like `"All"` / `{ Only }` are rejected on input).
+ */
+type ReaderSet = "all" | {
     only: number[];
-} | {
-    Only: number[];
 };
 interface MapCreateInput {
     tail: string;