@tearleads/client-sdk 0.1.43 → 0.1.44

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (82) hide show
  1. package/client/containerDocumentDiscovery.js +71 -29
  2. package/client/containerDocumentDiscovery.js.map +1 -1
  3. package/client/deviceFirst.js +4 -5
  4. package/client/deviceFirst.js.map +1 -1
  5. package/data/persistence/containers/containerSyncWatermarkPersistence.d.ts +11 -3
  6. package/data/persistence/containers/containerSyncWatermarkPersistence.js +46 -58
  7. package/data/persistence/containers/containerSyncWatermarkPersistence.js.map +1 -1
  8. package/data/sqlite/schema.d.ts +34 -134
  9. package/data/sqlite/schema.js +22 -35
  10. package/data/sqlite/schema.js.map +1 -1
  11. package/internal/api-client/ApiClient.d.ts +6 -34
  12. package/internal/api-client/ApiClient.js +8 -10
  13. package/internal/api-client/ApiClient.js.map +1 -1
  14. package/internal/api-client/apiRequestRuntime.d.ts +2 -0
  15. package/internal/api-client/apiRequestRuntime.js +4 -0
  16. package/internal/api-client/apiRequestRuntime.js.map +1 -1
  17. package/internal/api-client/requestInternals.js +7 -7
  18. package/internal/api-client/requestInternals.js.map +1 -1
  19. package/internal/api-client/routes/containers/reads.d.ts +13 -7
  20. package/internal/api-client/routes/containers/reads.js +36 -15
  21. package/internal/api-client/routes/containers/reads.js.map +1 -1
  22. package/internal/api-client/types.d.ts +1 -5
  23. package/internal/api-client/types.js.map +1 -1
  24. package/internal/validators/containerReadRefinements.js +15 -5
  25. package/internal/validators/containerReadRefinements.js.map +1 -1
  26. package/internal/validators/containerReadSchemas.d.ts +36 -0
  27. package/internal/validators/containerReadSchemas.js +64 -1
  28. package/internal/validators/containerReadSchemas.js.map +1 -1
  29. package/internal/validators/operation/containerReads.d.ts +118 -182
  30. package/internal/validators/operation/containerReads.js +20 -54
  31. package/internal/validators/operation/containerReads.js.map +1 -1
  32. package/internal/validators/operation/index.d.ts +1 -1
  33. package/internal/validators/operation/index.js +1 -1
  34. package/internal/validators/operation/index.js.map +1 -1
  35. package/internal/validators/operation/registry.d.ts +2 -2
  36. package/internal/validators/operation/registry.js +2 -2
  37. package/internal/validators/operation/registry.js.map +1 -1
  38. package/internal/validators/request/containerDocumentLanes.d.ts +23 -0
  39. package/internal/validators/request/containerDocumentLanes.js +23 -0
  40. package/internal/validators/request/containerDocumentLanes.js.map +1 -0
  41. package/internal/validators/request/containerParentLanes.js +5 -35
  42. package/internal/validators/request/containerParentLanes.js.map +1 -1
  43. package/internal/validators/request/index.d.ts +1 -0
  44. package/internal/validators/request/index.js +1 -0
  45. package/internal/validators/request/index.js.map +1 -1
  46. package/internal/validators/response/containerDocumentLanes.d.ts +82 -0
  47. package/internal/validators/response/containerDocumentLanes.js +35 -0
  48. package/internal/validators/response/containerDocumentLanes.js.map +1 -0
  49. package/internal/validators/response/containerParentLanes.js +3 -15
  50. package/internal/validators/response/containerParentLanes.js.map +1 -1
  51. package/internal/validators/response/index.d.ts +2 -1
  52. package/internal/validators/response/index.js +1 -1
  53. package/internal/validators/response/index.js.map +1 -1
  54. package/package.json +1 -1
  55. package/sync/reconciliation/knownContainerSweep.js +57 -54
  56. package/sync/reconciliation/knownContainerSweep.js.map +1 -1
  57. package/sync/reconciliation/reconcileContainer.js +49 -17
  58. package/sync/reconciliation/reconcileContainer.js.map +1 -1
  59. package/sync/reconciliation/service.js +44 -16
  60. package/sync/reconciliation/service.js.map +1 -1
  61. package/sync/reconciliation/serviceTypes.d.ts +23 -2
  62. package/sync/reconciliation/serviceTypes.js.map +1 -1
  63. package/workflows/container-contents/containerDocumentListing.js +92 -38
  64. package/workflows/container-contents/containerDocumentListing.js.map +1 -1
  65. package/workflows/container-contents/containerPersistence.d.ts +8 -2
  66. package/workflows/container-contents/containerPersistence.js +6 -7
  67. package/workflows/container-contents/containerPersistence.js.map +1 -1
  68. package/workflows/container-contents/documentDiscovery.d.ts +3 -3
  69. package/workflows/container-contents/documentDiscovery.js +24 -96
  70. package/workflows/container-contents/documentDiscovery.js.map +1 -1
  71. package/workflows/container-contents/documentDiscoveryApply.js +65 -0
  72. package/workflows/container-contents/documentDiscoveryApply.js.map +1 -0
  73. package/workflows/container-contents/documentDiscoveryLanes.js +53 -0
  74. package/workflows/container-contents/documentDiscoveryLanes.js.map +1 -0
  75. package/workflows/container-contents/documentDiscoveryTypes.d.ts +25 -19
  76. package/workflows/container-contents/documentDiscoveryTypes.js.map +1 -1
  77. package/workflows/container-contents/remoteHydration/laneFetchMarkers.js +11 -17
  78. package/workflows/container-contents/remoteHydration/laneFetchMarkers.js.map +1 -1
  79. package/workflows/sync/remoteResetCursorScope.js +10 -18
  80. package/workflows/sync/remoteResetCursorScope.js.map +1 -1
  81. package/workflows/sync/remoteResetScope.js +4 -11
  82. package/workflows/sync/remoteResetScope.js.map +1 -1
@@ -1,7 +1,7 @@
1
1
  import type { NativeSubscriptionStore } from "../validators/billing.js";
2
2
  import { type RootIdentitiesQuery, type RootOrganizationPageQuery, type RootOrganizationsQuery } from "../validators/operation/index.js";
3
- import type { BlobAttachmentBindRequest, BlobAttachmentDetachRequest, CommitOrganizationGroupPolicyRequest, ContainerCreateWithMetadataDocumentRequest, ContainerMutationRequest, ContainerReciteRequest, ContainerRotationRequest, CreateOrganizationRequest, DocumentCreateRequest, DocumentLinkSetMutationRequest, DocumentPurgeRequest, DocumentSyncRequest, InitiateMultipartBlobStageRequest, ListContainerParentLanesRequest, RegistrationRequest, UpdateOrganizationProfileRequest, UpdateOrganizationRosterEntryRequest } from "../validators/request/index.js";
4
- 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";
3
+ import type { BlobAttachmentBindRequest, BlobAttachmentDetachRequest, CommitOrganizationGroupPolicyRequest, ContainerCreateWithMetadataDocumentRequest, ContainerMutationRequest, ContainerReciteRequest, ContainerRotationRequest, CreateOrganizationRequest, DocumentCreateRequest, DocumentLinkSetMutationRequest, DocumentPurgeRequest, DocumentSyncRequest, InitiateMultipartBlobStageRequest, ListContainerDocumentLanesRequest, ListContainerParentLanesRequest, RegistrationRequest, UpdateOrganizationProfileRequest, UpdateOrganizationRosterEntryRequest } from "../validators/request/index.js";
4
+ import type { CommitOrganizationGroupPolicyResponse, ContainerCreateWithMetadataDocumentResponse, ContainerDeleteResponse, ContainerMutationResponse, ContainerRotationResponse, ContainerWriterProjectionResponse, DocumentCreateResponse, DocumentSyncResponse, DocumentWriterProjectionResponse, ListContainerDocumentLanesResponse, OrganizationDataUsageResponse, OrganizationPolicyHistoryResponse, OrganizationReadModelResponse, RootDataUsageReportResponse, RootIdentitiesResponse, RootIdentityDetailResponse, RootIdentityOrganizationsResponse, RootOrganizationDetailResponse, RootOrganizationIdentitiesResponse, RootOrganizationsResponse } from "../validators/response/index.js";
5
5
  import type { ApiRequestInstrumentation } from "./apiRequestMetrics.js";
6
6
  import { getOrganizationPolicyHistoryResult as organizationHistory } from "./organizationPolicyHistory.js";
7
7
  import type { PrincipalPolicyPageReadOptions } from "./principalPolicyPages.js";
@@ -9,14 +9,14 @@ import { PrincipalPolicyRequests } from "./principalPolicyRequests.js";
9
9
  import { type UploadMultipartBlobPartBytesRequest } from "./routes/blobs/get.js";
10
10
  import { type ContainerKekLogOptions } from "./routes/containers/reads.js";
11
11
  import { type DocumentPurgeProofOptions } from "./routes/documents/mutations.js";
12
- import type { HttpMethod, ListContainerDocumentsOptions, ListDocumentEditAttributionRangesOptions, RequestResult, RequestResultOptions } from "./types.js";
12
+ import type { HttpMethod, ListDocumentEditAttributionRangesOptions, RequestResult, RequestResultOptions } from "./types.js";
13
13
  import type { VerifiedManifestCitations } from "./verifiedManifestCitations.js";
14
14
  type ExpiredHandler = () => boolean | Promise<boolean>;
15
15
  type PaymentRequiredHandler = (organizationId: string | null) => void;
16
16
  export declare class ApiClient {
17
17
  private readonly requestRuntime;
18
18
  private verifiedManifestCitations;
19
- private readonly containerDocumentListRequestsByKey;
19
+ private readonly containerDocumentLaneRequestsByKey;
20
20
  private readonly containerParentLaneRequestsByKey;
21
21
  private readonly containerWriterProjectionRequestsByContainerId;
22
22
  private readonly documentWriterProjectionRequestsByDocumentId;
@@ -3571,36 +3571,8 @@ export declare class ApiClient {
3571
3571
  };
3572
3572
  }[];
3573
3573
  } | null>;
3574
- listContainerDocuments(containerId: string, options?: ListContainerDocumentsOptions): Promise<{
3575
- hasMore: boolean;
3576
- items: {
3577
- createdAt: string;
3578
- currentAccessEpoch: number;
3579
- currentAccessStateHash: string;
3580
- effectiveAccessLevel: "admin" | "read" | "write";
3581
- id: string;
3582
- linkedContainerIds: string[];
3583
- referencedPrincipals: {
3584
- keyEpoch: number;
3585
- keyFingerprint: string;
3586
- principalId: string;
3587
- principalType: "group" | "organization";
3588
- stateHash: string;
3589
- version: number;
3590
- }[];
3591
- updatedAt: string;
3592
- }[];
3593
- nextWatermark: {
3594
- id: string;
3595
- updatedAt: string;
3596
- } | null;
3597
- tombstones: {
3598
- containerId: string;
3599
- documentId: string;
3600
- updatedAt: string;
3601
- }[];
3602
- } | null>;
3603
- listContainerDocumentsResult(containerId: string, options?: ListContainerDocumentsOptions, requestOptions?: RequestResultOptions): Promise<RequestResult<ListContainerDocumentsResponse>>;
3574
+ /** Batched document listing; see `containerDocumentLanes.settle`. */
3575
+ listContainerDocumentLanes(input: ListContainerDocumentLanesRequest, options?: Pick<RequestResultOptions, "reportErrors">): Promise<ListContainerDocumentLanesResponse | null>;
3604
3576
  unlinkDocument(documentId: string, input: DocumentLinkSetMutationRequest, options?: RequestResultOptions): Promise<{
3605
3577
  accessManifest: {
3606
3578
  event: {
@@ -1,19 +1,19 @@
1
1
  import { sign } from "../crypto/index.js";
2
- import { bindBlobAttachmentOperation, cancelStripeSubscriptionOperation, challengeOperation, claimNativeOrganizationSubscriptionOperation, createContainerOperation, createContainerWithMetadataDocumentOperation, createDocumentOperation, createOrganizationOperation, createStripeCheckoutOperation, createStripeCheckoutSessionOperation, createStripePortalOperation, deleteContainerOperation, destroySessionOperation, detachBlobAttachmentOperation, documentSyncOperation, getContainerKekLogOperation, getContainerReplacementAuthorizationsOperation, getContainerWriterProjectionOperation, getDocumentWriterProjectionOperation, getHealthOperation, getMultipartBlobStageOperation, getOrganizationBillingHistoryOperation, getOrganizationBillingManagementUrlOperation, getOrganizationBillingOperation, getOrganizationDataUsageOperation, getOrganizationNativePurchaseEligibilityOperation, getOrganizationReadModelOperation, getRootIdentityOperation, getRootOrganizationDataUsageOperation, getRootOrganizationOperation, getStripeCheckoutOptionsOperation, initiateMultipartBlobStageOperation, linkDocumentOperation, listContainerDocumentsOperation, listContainerParentLanesOperation, listDocumentAttachmentsOperation, listOrganizationGroupMembersOperation, listRootDataUsageReportOperation, listRootIdentitiesOperation, listRootIdentityOrganizationsOperation, listRootOrganizationIdentitiesOperation, listRootOrganizationsOperation, listSessionsOperation, logoutOperation, moveContainerOperation, reciteContainerOperation, registerOperation, rekeyContainerOperation, revokeContainerOperation, shareContainerOperation, startOrganizationTrialOperation, unlinkDocumentOperation, updateOrganizationProfileOperation, updateOrganizationRosterEntryOperation, userIdentityOperation, verifyOperation, } from "../validators/operation/index.js";
2
+ import { bindBlobAttachmentOperation, cancelStripeSubscriptionOperation, challengeOperation, claimNativeOrganizationSubscriptionOperation, createContainerOperation, createContainerWithMetadataDocumentOperation, createDocumentOperation, createOrganizationOperation, createStripeCheckoutOperation, createStripeCheckoutSessionOperation, createStripePortalOperation, deleteContainerOperation, destroySessionOperation, detachBlobAttachmentOperation, documentSyncOperation, getContainerKekLogOperation, getContainerReplacementAuthorizationsOperation, getContainerWriterProjectionOperation, getDocumentWriterProjectionOperation, getHealthOperation, getMultipartBlobStageOperation, getOrganizationBillingHistoryOperation, getOrganizationBillingManagementUrlOperation, getOrganizationBillingOperation, getOrganizationDataUsageOperation, getOrganizationNativePurchaseEligibilityOperation, getOrganizationReadModelOperation, getRootIdentityOperation, getRootOrganizationDataUsageOperation, getRootOrganizationOperation, getStripeCheckoutOptionsOperation, initiateMultipartBlobStageOperation, linkDocumentOperation, listContainerDocumentLanesOperation, listContainerParentLanesOperation, listDocumentAttachmentsOperation, listOrganizationGroupMembersOperation, listRootDataUsageReportOperation, listRootIdentitiesOperation, listRootIdentityOrganizationsOperation, listRootOrganizationIdentitiesOperation, listRootOrganizationsOperation, listSessionsOperation, logoutOperation, moveContainerOperation, reciteContainerOperation, registerOperation, rekeyContainerOperation, revokeContainerOperation, shareContainerOperation, startOrganizationTrialOperation, unlinkDocumentOperation, updateOrganizationProfileOperation, updateOrganizationRosterEntryOperation, userIdentityOperation, verifyOperation, } from "../validators/operation/index.js";
3
3
  import { BoundedCache } from "./ApiCache.js";
4
4
  import { ApiRequestRuntime } from "./apiRequestRuntime.js";
5
5
  import { getDocumentPurgeProof as readPurgeProof, purgeDocument as submitDocumentPurge, } from "./documentPurge.js";
6
6
  import { createOperationTransport, } from "./operationTransportFactory.js";
7
7
  import { getOrganizationPolicyHistoryResult as organizationHistory } from "./organizationPolicyHistory.js";
8
8
  import { PrincipalPolicyRequests } from "./principalPolicyRequests.js";
9
- import { bindPrototypeMethods, cachedRequest, dedupedRequest, evictWriterProjectionIfSyncChanged, listContainerDocumentsRequestKey, listContainerParentLanesRequestKey, } from "./requestInternals.js";
9
+ import { bindPrototypeMethods, cachedRequest, dedupedRequest, evictWriterProjectionIfSyncChanged, listContainerDocumentLanesRequestKey, listContainerParentLanesRequestKey, } from "./requestInternals.js";
10
10
  import { destroySession as authDestroySession, listSessions as authListSessions, logout as authLogout, userIdentity as authUserIdentity, } from "./routes/auth/session.js";
11
11
  import { bindBlobAttachment as blobAttachmentBind, detachBlobAttachment as blobAttachmentDetach, } from "./routes/blobs/attachments.js";
12
12
  import { getBlobBytes, } from "./routes/blobs/get.js";
13
13
  import { getMultipartBlobStage as multipartGet, initiateMultipartBlobStage as multipartInitiate, } from "./routes/blobs/multipart.js";
14
14
  import { uploadMultipartBlobPartBytes } from "./routes/blobs/multipartUpload.js";
15
15
  import { containerCreate, containerCreateWithMetadataDocument, containerDelete, containerMove, containerRecite, containerRekey, containerRevoke, containerShare, } from "./routes/containers/mutations.js";
16
- import { containerDocuments, containerKekLog, containerParentLanes, } from "./routes/containers/reads.js";
16
+ import { containerDocumentLanes, containerKekLog, containerParentLanes, } from "./routes/containers/reads.js";
17
17
  import { listDocumentAttachments as documentAttachmentsList } from "./routes/documents/attachments.js";
18
18
  import { DocumentAttributionRequests } from "./routes/documents/attributionRequests.js";
19
19
  import { documentCreate, documentLink, documentUnlink, } from "./routes/documents/mutations.js";
@@ -37,7 +37,7 @@ const CONTAINER_ROTATIONS = {
37
37
  export class ApiClient {
38
38
  requestRuntime;
39
39
  verifiedManifestCitations = null;
40
- containerDocumentListRequestsByKey = new Map();
40
+ containerDocumentLaneRequestsByKey = new Map();
41
41
  containerParentLaneRequestsByKey = new Map();
42
42
  containerWriterProjectionRequestsByContainerId = new CitingProjectionCache();
43
43
  documentWriterProjectionRequestsByDocumentId = new CitingProjectionCache();
@@ -64,7 +64,7 @@ export class ApiClient {
64
64
  this.webSocketTickets = new WebSocketTickets(this.transport, () => this.getAuthToken());
65
65
  }
66
66
  clearAuthScopedCaches() {
67
- this.containerDocumentListRequestsByKey.clear();
67
+ this.containerDocumentLaneRequestsByKey.clear();
68
68
  this.containerParentLaneRequestsByKey.clear();
69
69
  this.documentAttachmentListRequestsByDocumentId.clear();
70
70
  this.documentAttributionRequests.clear();
@@ -673,11 +673,9 @@ export class ApiClient {
673
673
  listContainerParentLanes(input) {
674
674
  return dedupedRequest(this.containerParentLaneRequestsByKey, listContainerParentLanesRequestKey(input), () => this.request(containerParentLanes.path, (value) => containerParentLanes.isResponseForRequest(input, value), containerParentLanes.method, JSON.stringify(input), undefined, listContainerParentLanesOperation));
675
675
  }
676
- listContainerDocuments(containerId, options) {
677
- return dedupedRequest(this.containerDocumentListRequestsByKey, listContainerDocumentsRequestKey(containerId, options), () => this.request(containerDocuments.path(containerId, options), containerDocuments.isResponse, containerDocuments.method, undefined, undefined, listContainerDocumentsOperation));
678
- }
679
- listContainerDocumentsResult(containerId, options, requestOptions = {}) {
680
- return this.requestResult(containerDocuments.path(containerId, options), containerDocuments.isResponse, containerDocuments.method, undefined, requestOptions, listContainerDocumentsOperation);
676
+ /** Batched document listing; see `containerDocumentLanes.settle`. */
677
+ async listContainerDocumentLanes(input, options = {}) {
678
+ return containerDocumentLanes.settle(await dedupedRequest(this.containerDocumentLaneRequestsByKey, listContainerDocumentLanesRequestKey(input), () => this.requestResult(containerDocumentLanes.path, (value) => containerDocumentLanes.isResponseForRequest(input, value), containerDocumentLanes.method, JSON.stringify(input), { reportErrors: false }, listContainerDocumentLanesOperation)), options.reportErrors ?? true, (message) => this.requestRuntime.reportError(message));
681
679
  }
682
680
  unlinkDocument(documentId, input, options = {}) {
683
681
  this.invalidateDocumentAttribution(documentId);