@tearleads/client-sdk 0.1.14 → 0.1.15

package/internal/api-client/ApiClient.d.ts

@@ -1,8 +1,9 @@
 import type { NativeSubscriptionStore } from "../validators/billing.js";
 import { type RootIdentitiesQuery, type RootOrganizationPageQuery, type RootOrganizationsQuery } from "../validators/operation/index.js";
-import type { BlobAttachmentBindRequest, BlobAttachmentDetachRequest, CommitOrganizationGroupPolicyRequest, CompleteMultipartBlobStageRequest, ContainerCreateWithMetadataDocumentRequest, ContainerMutationRequest, ContainerReciteRequest, ContainerRotationRequest, CreateOrganizationGroupWithPolicyRequest, CreateOrganizationRequest, DeleteOrganizationGroupRequest, DocumentCreateRequest, DocumentLinkSetMutationRequest, DocumentPurgeRequest, DocumentSyncRequest, InitiateMultipartBlobStageRequest, ListContainerParentLanesRequest, OrganizationPrincipalPolicyRequest, RegistrationRequest, UpdateOrganizationProfileRequest, UpdateOrganizationRosterEntryRequest } from "../validators/request/index.js";
+import type { BlobAttachmentBindRequest, BlobAttachmentDetachRequest, CommitOrganizationGroupPolicyRequest, CompleteMultipartBlobStageRequest, ContainerCreateWithMetadataDocumentRequest, ContainerMutationRequest, ContainerReciteRequest, ContainerRotationRequest, CreateOrganizationGroupWithPolicyRequest, CreateOrganizationRequest, DeleteOrganizationGroupRequest, DocumentCreateRequest, DocumentLinkSetMutationRequest, DocumentPurgeRequest, DocumentSyncRequest, InitiateMultipartBlobStageRequest, ListContainerParentLanesRequest, RegistrationRequest, UpdateOrganizationProfileRequest, UpdateOrganizationRosterEntryRequest } from "../validators/request/index.js";
 import type { CommitOrganizationGroupPolicyResponse, ContainerCreateWithMetadataDocumentResponse, ContainerDeleteResponse, ContainerMutationResponse, ContainerRotationResponse, ContainerWriterProjectionResponse, DocumentCreateResponse, DocumentSyncResponse, DocumentWriterProjectionResponse, ListContainerDocumentsResponse, OrganizationDataUsageResponse, OrganizationPolicyHistoryResponse, OrganizationReadModelResponse, RootDataUsageReportResponse, RootIdentitiesResponse, RootIdentityDetailResponse, RootIdentityOrganizationsResponse, RootOrganizationDetailResponse, RootOrganizationIdentitiesResponse, RootOrganizationsResponse } from "../validators/response/index.js";
 import type { PrincipalPolicyPageReadOptions } from "./principalPolicyPages.js";
+import { PrincipalPolicyRequests } from "./principalPolicyRequests.js";
 import { type UploadMultipartBlobPartBytesRequest } from "./routes/blobs/get.js";
 import { type ContainerKekLogOptions } from "./routes/containers/reads.js";
 import { type DocumentPurgeProofOptions } from "./routes/documents/mutations.js";
@@ -1062,7 +1063,93 @@ export declare class ApiClient {
             version: number;
         };
     }>, void, any>;
-    getCurrentPrincipalPolicy(principalType: "group" | "organization", principalId: string, options?: RequestResultOptions): Promise<{
+    getProjectionPolicyHistoryPages(...args: Parameters<PrincipalPolicyRequests["publicPages"]>): AsyncGenerator<RequestResult<{
+        currentGrants: {
+            accessLevel: "admin" | "read" | "write";
+            containerId: string;
+        }[];
+        currentProjection: {
+            role: "member" | "admin";
+            userId: string;
+        }[];
+        currentState: {
+            createdAt: string;
+            encapsulationPublicKey: string;
+            externalAuthority: {
+                keyEpoch: number;
+                keyFingerprint: string;
+                principalId: string;
+                principalType: "group";
+                stateHash: string;
+                version: number;
+            } | null;
+            grantCount: number;
+            grantRoot: string;
+            keyEpoch: number;
+            keyFingerprint: string;
+            memberCount: number;
+            memberEnvelopesRoot: string;
+            membershipMode: "projection";
+            membershipRoot: string;
+            payloadCiphertextHash: string;
+            prevStateHash: string | null;
+            principalId: string;
+            principalType: "group" | "organization";
+            projectionRoot: string;
+            signature: string;
+            signedAt: string;
+            signerUserId: string;
+            signerUserKeyFingerprint: string;
+            stateHash: string;
+            version: number;
+        };
+        previousStates: {
+            grants: {
+                accessLevel: "admin" | "read" | "write";
+                containerId: string;
+            }[];
+            projection: {
+                role: "member" | "admin";
+                userId: string;
+            }[];
+            state: {
+                createdAt: string;
+                encapsulationPublicKey: string;
+                externalAuthority: {
+                    keyEpoch: number;
+                    keyFingerprint: string;
+                    principalId: string;
+                    principalType: "group";
+                    stateHash: string;
+                    version: number;
+                } | null;
+                grantCount: number;
+                grantRoot: string;
+                keyEpoch: number;
+                keyFingerprint: string;
+                memberCount: number;
+                memberEnvelopesRoot: string;
+                membershipMode: "projection";
+                membershipRoot: string;
+                payloadCiphertextHash: string;
+                prevStateHash: string | null;
+                principalId: string;
+                principalType: "group" | "organization";
+                projectionRoot: string;
+                signature: string;
+                signedAt: string;
+                signerUserId: string;
+                signerUserKeyFingerprint: string;
+                stateHash: string;
+                version: number;
+            };
+        }[];
+        historyPage: {
+            afterVersion: number;
+            nextAfterVersion: number | null;
+        };
+    }>, void, any>;
+    getCurrentPrincipalPolicy(...args: Parameters<PrincipalPolicyRequests["get"]>): Promise<{
         previousStates: {
             grants: {
                 accessLevel: "admin" | "read" | "write";
@@ -1165,7 +1252,7 @@ export declare class ApiClient {
             version: number;
         };
     } | null>;
-    putPrincipalPolicy(principalType: "organization", principalId: string, input: OrganizationPrincipalPolicyRequest, options?: RequestResultOptions): Promise<{
+    putPrincipalPolicy(...args: Parameters<PrincipalPolicyRequests["put"]>): Promise<{
         containerMutations: {
             createdAt: string;
             manifestHead: {
@@ -1287,6 +1374,129 @@ export declare class ApiClient {
             version: number;
         };
     } | null>;
+    /** Preserves unknown outcomes for authored organization directory writes. */
+    putPrincipalPolicyResult(...args: Parameters<PrincipalPolicyRequests["putResult"]>): Promise<RequestResult<{
+        containerMutations: {
+            createdAt: string;
+            manifestHead: {
+                epoch: number;
+                manifestHash: string;
+            };
+            organizationId: string;
+            parentId: string | null;
+            referencedPrincipalHeads: {
+                principalType: "group";
+                keyEpoch: number;
+                keyFingerprint: string;
+                principalId: string;
+                stateHash: string;
+                version: number;
+            }[];
+            updatedAt: string;
+            accessManifest: {
+                event: {
+                    body: unknown;
+                    event: Record<string, unknown>;
+                    eventHash: string;
+                };
+                manifest: Record<string, unknown>;
+                manifestHash: string;
+                state: Record<string, unknown>;
+            };
+            containerId: string;
+            containerKek: {
+                accessManifestHash: string;
+                containerId: string;
+                containerKeyEpoch: number;
+                containerKeyEpochId: string;
+                containerManifestHistory: {
+                    event: {
+                        body: unknown;
+                        event: Record<string, unknown>;
+                        eventHash: string;
+                    };
+                    manifest: Record<string, unknown>;
+                    manifestHash: string;
+                    state: Record<string, unknown>;
+                }[];
+                keyEpoch: Record<string, unknown>;
+                keyEpochHash: string;
+                keyring: {
+                    containerId: string;
+                    containerKeyEpochId: string;
+                    iv: string;
+                    sealed: string;
+                    sealingSuite: string;
+                    version: number;
+                } | null;
+                keyTargetHash: string;
+                parentContainerKeyEpochId: string | null;
+                recipientTargets: Record<string, unknown>[];
+                wraps: Record<string, unknown>[];
+            };
+            systemSlot?: string | null | undefined;
+        }[];
+        currentGrants: {
+            accessLevel: "admin" | "read" | "write";
+            containerId: string;
+        }[];
+        currentMemberEnvelopes: {
+            envelopes: {
+                kemCipherText: string;
+                memberKeyFingerprint: string;
+                userId: string;
+                wrappedKey: string;
+            }[];
+            epoch: number;
+            principalId: string;
+            principalType: "group" | "organization";
+            stateHash: string;
+        };
+        currentPayload: {
+            cipherSuite: "aes-256-gcm";
+            ciphertext: string;
+            ciphertextHash: string;
+            createdAt: string;
+            principalId: string;
+            principalType: "group" | "organization";
+            stateHash: string;
+        };
+        currentProjection: {
+            role: "member" | "admin";
+            userId: string;
+        }[];
+        currentState: {
+            createdAt: string;
+            encapsulationPublicKey: string;
+            externalAuthority: {
+                keyEpoch: number;
+                keyFingerprint: string;
+                principalId: string;
+                principalType: "group";
+                stateHash: string;
+                version: number;
+            } | null;
+            grantCount: number;
+            grantRoot: string;
+            keyEpoch: number;
+            keyFingerprint: string;
+            memberCount: number;
+            memberEnvelopesRoot: string;
+            membershipMode: "projection";
+            membershipRoot: string;
+            payloadCiphertextHash: string;
+            prevStateHash: string | null;
+            principalId: string;
+            principalType: "group" | "organization";
+            projectionRoot: string;
+            signature: string;
+            signedAt: string;
+            signerUserId: string;
+            signerUserKeyFingerprint: string;
+            stateHash: string;
+            version: number;
+        };
+    }>>;
     commitOrganizationGroupPolicy(organizationId: string, groupId: string, input: CommitOrganizationGroupPolicyRequest): Promise<{
         groupPolicy: {
             containerMutations: {
@@ -2010,177 +2220,45 @@ export declare class ApiClient {
     getContainerWriterProjection(containerId: string): Promise<{
         policyEvidence: {
             organization: {
-                currentGrants: {
-                    accessLevel: "admin" | "read" | "write";
-                    containerId: string;
-                }[];
-                currentProjection: {
-                    role: "member" | "admin";
-                    userId: string;
-                }[];
-                currentState: {
-                    createdAt: string;
-                    encapsulationPublicKey: string;
-                    externalAuthority: {
-                        keyEpoch: number;
-                        keyFingerprint: string;
-                        principalId: string;
-                        principalType: "group";
-                        stateHash: string;
-                        version: number;
-                    } | null;
-                    grantCount: number;
-                    grantRoot: string;
+                head: {
                     keyEpoch: number;
                     keyFingerprint: string;
-                    memberCount: number;
-                    memberEnvelopesRoot: string;
-                    membershipMode: "projection";
-                    membershipRoot: string;
-                    payloadCiphertextHash: string;
-                    prevStateHash: string | null;
                     principalId: string;
                     principalType: "group" | "organization";
-                    projectionRoot: string;
-                    signature: string;
-                    signedAt: string;
-                    signerUserId: string;
-                    signerUserKeyFingerprint: string;
                     stateHash: string;
                     version: number;
                 };
-                previousStates: {
-                    grants: {
-                        accessLevel: "admin" | "read" | "write";
-                        containerId: string;
-                    }[];
-                    projection: {
-                        role: "member" | "admin";
-                        userId: string;
-                    }[];
-                    state: {
-                        createdAt: string;
-                        encapsulationPublicKey: string;
-                        externalAuthority: {
-                            keyEpoch: number;
-                            keyFingerprint: string;
-                            principalId: string;
-                            principalType: "group";
-                            stateHash: string;
-                            version: number;
-                        } | null;
-                        grantCount: number;
-                        grantRoot: string;
-                        keyEpoch: number;
-                        keyFingerprint: string;
-                        memberCount: number;
-                        memberEnvelopesRoot: string;
-                        membershipMode: "projection";
-                        membershipRoot: string;
-                        payloadCiphertextHash: string;
-                        prevStateHash: string | null;
-                        principalId: string;
-                        principalType: "group" | "organization";
-                        projectionRoot: string;
-                        signature: string;
-                        signedAt: string;
-                        signerUserId: string;
-                        signerUserKeyFingerprint: string;
-                        stateHash: string;
-                        version: number;
-                    };
-                }[];
+                grant: string;
             } | null;
             organizationPayloads: {
-                cipherSuite: "aes-256-gcm";
-                ciphertext: string;
-                ciphertextHash: string;
-                createdAt: string;
-                principalId: string;
-                principalType: "group" | "organization";
-                stateHash: string;
+                reference: {
+                    keyEpoch: number;
+                    keyFingerprint: string;
+                    principalId: string;
+                    principalType: "group" | "organization";
+                    stateHash: string;
+                    version: number;
+                };
+                payload: {
+                    cipherSuite: "aes-256-gcm";
+                    ciphertext: string;
+                    ciphertextHash: string;
+                    createdAt: string;
+                    principalId: string;
+                    principalType: "group" | "organization";
+                    stateHash: string;
+                };
             }[];
             groups: {
-                currentGrants: {
-                    accessLevel: "admin" | "read" | "write";
-                    containerId: string;
-                }[];
-                currentProjection: {
-                    role: "member" | "admin";
-                    userId: string;
-                }[];
-                currentState: {
-                    createdAt: string;
-                    encapsulationPublicKey: string;
-                    externalAuthority: {
-                        keyEpoch: number;
-                        keyFingerprint: string;
-                        principalId: string;
-                        principalType: "group";
-                        stateHash: string;
-                        version: number;
-                    } | null;
-                    grantCount: number;
-                    grantRoot: string;
+                head: {
                     keyEpoch: number;
                     keyFingerprint: string;
-                    memberCount: number;
-                    memberEnvelopesRoot: string;
-                    membershipMode: "projection";
-                    membershipRoot: string;
-                    payloadCiphertextHash: string;
-                    prevStateHash: string | null;
                     principalId: string;
                     principalType: "group" | "organization";
-                    projectionRoot: string;
-                    signature: string;
-                    signedAt: string;
-                    signerUserId: string;
-                    signerUserKeyFingerprint: string;
                     stateHash: string;
                     version: number;
                 };
-                previousStates: {
-                    grants: {
-                        accessLevel: "admin" | "read" | "write";
-                        containerId: string;
-                    }[];
-                    projection: {
-                        role: "member" | "admin";
-                        userId: string;
-                    }[];
-                    state: {
-                        createdAt: string;
-                        encapsulationPublicKey: string;
-                        externalAuthority: {
-                            keyEpoch: number;
-                            keyFingerprint: string;
-                            principalId: string;
-                            principalType: "group";
-                            stateHash: string;
-                            version: number;
-                        } | null;
-                        grantCount: number;
-                        grantRoot: string;
-                        keyEpoch: number;
-                        keyFingerprint: string;
-                        memberCount: number;
-                        memberEnvelopesRoot: string;
-                        membershipMode: "projection";
-                        membershipRoot: string;
-                        payloadCiphertextHash: string;
-                        prevStateHash: string | null;
-                        principalId: string;
-                        principalType: "group" | "organization";
-                        projectionRoot: string;
-                        signature: string;
-                        signedAt: string;
-                        signerUserId: string;
-                        signerUserKeyFingerprint: string;
-                        stateHash: string;
-                        version: number;
-                    };
-                }[];
+                grant: string;
             }[];
         };
         containerId: string;
@@ -2906,177 +2984,45 @@ export declare class ApiClient {
     getDocumentWriterProjection(documentId: string): Promise<{
         policyEvidence: {
             organization: {
-                currentGrants: {
-                    accessLevel: "admin" | "read" | "write";
-                    containerId: string;
-                }[];
-                currentProjection: {
-                    role: "member" | "admin";
-                    userId: string;
-                }[];
-                currentState: {
-                    createdAt: string;
-                    encapsulationPublicKey: string;
-                    externalAuthority: {
-                        keyEpoch: number;
-                        keyFingerprint: string;
-                        principalId: string;
-                        principalType: "group";
-                        stateHash: string;
-                        version: number;
-                    } | null;
-                    grantCount: number;
-                    grantRoot: string;
+                head: {
                     keyEpoch: number;
                     keyFingerprint: string;
-                    memberCount: number;
-                    memberEnvelopesRoot: string;
-                    membershipMode: "projection";
-                    membershipRoot: string;
-                    payloadCiphertextHash: string;
-                    prevStateHash: string | null;
                     principalId: string;
                     principalType: "group" | "organization";
-                    projectionRoot: string;
-                    signature: string;
-                    signedAt: string;
-                    signerUserId: string;
-                    signerUserKeyFingerprint: string;
                     stateHash: string;
                     version: number;
                 };
-                previousStates: {
-                    grants: {
-                        accessLevel: "admin" | "read" | "write";
-                        containerId: string;
-                    }[];
-                    projection: {
-                        role: "member" | "admin";
-                        userId: string;
-                    }[];
-                    state: {
-                        createdAt: string;
-                        encapsulationPublicKey: string;
-                        externalAuthority: {
-                            keyEpoch: number;
-                            keyFingerprint: string;
-                            principalId: string;
-                            principalType: "group";
-                            stateHash: string;
-                            version: number;
-                        } | null;
-                        grantCount: number;
-                        grantRoot: string;
-                        keyEpoch: number;
-                        keyFingerprint: string;
-                        memberCount: number;
-                        memberEnvelopesRoot: string;
-                        membershipMode: "projection";
-                        membershipRoot: string;
-                        payloadCiphertextHash: string;
-                        prevStateHash: string | null;
-                        principalId: string;
-                        principalType: "group" | "organization";
-                        projectionRoot: string;
-                        signature: string;
-                        signedAt: string;
-                        signerUserId: string;
-                        signerUserKeyFingerprint: string;
-                        stateHash: string;
-                        version: number;
-                    };
-                }[];
+                grant: string;
             } | null;
             organizationPayloads: {
-                cipherSuite: "aes-256-gcm";
-                ciphertext: string;
-                ciphertextHash: string;
-                createdAt: string;
-                principalId: string;
-                principalType: "group" | "organization";
-                stateHash: string;
+                reference: {
+                    keyEpoch: number;
+                    keyFingerprint: string;
+                    principalId: string;
+                    principalType: "group" | "organization";
+                    stateHash: string;
+                    version: number;
+                };
+                payload: {
+                    cipherSuite: "aes-256-gcm";
+                    ciphertext: string;
+                    ciphertextHash: string;
+                    createdAt: string;
+                    principalId: string;
+                    principalType: "group" | "organization";
+                    stateHash: string;
+                };
             }[];
             groups: {
-                currentGrants: {
-                    accessLevel: "admin" | "read" | "write";
-                    containerId: string;
-                }[];
-                currentProjection: {
-                    role: "member" | "admin";
-                    userId: string;
-                }[];
-                currentState: {
-                    createdAt: string;
-                    encapsulationPublicKey: string;
-                    externalAuthority: {
-                        keyEpoch: number;
-                        keyFingerprint: string;
-                        principalId: string;
-                        principalType: "group";
-                        stateHash: string;
-                        version: number;
-                    } | null;
-                    grantCount: number;
-                    grantRoot: string;
+                head: {
                     keyEpoch: number;
                     keyFingerprint: string;
-                    memberCount: number;
-                    memberEnvelopesRoot: string;
-                    membershipMode: "projection";
-                    membershipRoot: string;
-                    payloadCiphertextHash: string;
-                    prevStateHash: string | null;
                     principalId: string;
                     principalType: "group" | "organization";
-                    projectionRoot: string;
-                    signature: string;
-                    signedAt: string;
-                    signerUserId: string;
-                    signerUserKeyFingerprint: string;
                     stateHash: string;
                     version: number;
                 };
-                previousStates: {
-                    grants: {
-                        accessLevel: "admin" | "read" | "write";
-                        containerId: string;
-                    }[];
-                    projection: {
-                        role: "member" | "admin";
-                        userId: string;
-                    }[];
-                    state: {
-                        createdAt: string;
-                        encapsulationPublicKey: string;
-                        externalAuthority: {
-                            keyEpoch: number;
-                            keyFingerprint: string;
-                            principalId: string;
-                            principalType: "group";
-                            stateHash: string;
-                            version: number;
-                        } | null;
-                        grantCount: number;
-                        grantRoot: string;
-                        keyEpoch: number;
-                        keyFingerprint: string;
-                        memberCount: number;
-                        memberEnvelopesRoot: string;
-                        membershipMode: "projection";
-                        membershipRoot: string;
-                        payloadCiphertextHash: string;
-                        prevStateHash: string | null;
-                        principalId: string;
-                        principalType: "group" | "organization";
-                        projectionRoot: string;
-                        signature: string;
-                        signedAt: string;
-                        signerUserId: string;
-                        signerUserKeyFingerprint: string;
-                        stateHash: string;
-                        version: number;
-                    };
-                }[];
+                grant: string;
             }[];
         };
         authorizingContainerPaths: {

package/internal/api-client/ApiClient.js

@@ -26,6 +26,7 @@ import { organizationStripeCheckout } from "./routes/organizations/stripeCheckou
 import { containerWriterProjection, documentWriterProjection, } from "./routes/writerProjections.js";
 import { CitingProjectionCache, evictWriterProjectionsCiting, } from "./writerProjectionCitations.js";
 import { primeWriterProjectionSlot } from "./writerProjectionPrime.js";
+import { writerProjectionRequests } from "./writerProjectionRequests.js";
 /** The rotations that may carry descendant rekeys, each with its operation. */
 const CONTAINER_ROTATIONS = {
     move: { operation: moveContainerOperation, route: containerMove },
@@ -53,8 +54,9 @@ export class ApiClient {
         bindPrototypeMethods(this, ApiClient.prototype);
         this.requestRuntime = new ApiRequestRuntime(baseUrl);
         this.principalPolicyRequests = new PrincipalPolicyRequests(this.requestRuntime, this.principalPolicyRequestsByKey, this.clearWriterProjectionCaches);
-        this.request = this.projectionHistory.wrapRequest(this.requestRuntime.request);
-        this.requestResult = this.projectionHistory.wrapRequestResult(this.requestRuntime.requestResult);
+        const projectionRequests = writerProjectionRequests(this.requestRuntime);
+        this.request = this.projectionHistory.wrapRequest(projectionRequests.request);
+        this.requestResult = this.projectionHistory.wrapRequestResult(projectionRequests.requestResult);
         this.transport = createOperationTransport(this.requestRuntime.responseRequest);
         this.documentAttributionRequests = new DocumentAttributionRequests(this.transport);
     }
@@ -260,11 +262,18 @@ export class ApiClient {
     getPrincipalPolicyPages(principalType, principalId, options = {}) {
         return this.principalPolicyRequests.pages(principalType, principalId, options);
     }
-    getCurrentPrincipalPolicy(principalType, principalId, options = {}) {
-        return this.principalPolicyRequests.get(principalType, principalId, options);
+    getProjectionPolicyHistoryPages(...args) {
+        return this.principalPolicyRequests.publicPages(...args);
     }
-    putPrincipalPolicy(principalType, principalId, input, options = {}) {
-        return this.principalPolicyRequests.put(principalType, principalId, input, options);
+    getCurrentPrincipalPolicy(...args) {
+        return this.principalPolicyRequests.get(...args);
+    }
+    putPrincipalPolicy(...args) {
+        return this.principalPolicyRequests.put(...args);
+    }
+    /** Preserves unknown outcomes for authored organization directory writes. */
+    putPrincipalPolicyResult(...args) {
+        return this.principalPolicyRequests.putResult(...args);
     }
     commitOrganizationGroupPolicy(organizationId, groupId, input) {
         return this.commitOrganizationGroupPolicyResult(organizationId, groupId, input).then((result) => (result.ok ? result.data : null));