@tearleads/client-sdk 0.1.251 → 0.1.253

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 (226) hide show
  1. package/Tearleads.d.ts +0 -2
  2. package/Tearleads.js +17 -28
  3. package/Tearleads.js.map +1 -1
  4. package/client/containerContents/index.d.ts +2 -0
  5. package/client/containerContents/index.js +4 -9
  6. package/client/containerContents/index.js.map +1 -1
  7. package/client/containerContents/storeRuntime.d.ts +17 -0
  8. package/client/containerContents/storeRuntime.js +31 -0
  9. package/client/containerContents/storeRuntime.js.map +1 -0
  10. package/client/deviceFirst/index.d.ts +2 -3
  11. package/client/deviceFirst/index.js +44 -22
  12. package/client/deviceFirst/index.js.map +1 -1
  13. package/client/organizations/organizationReadModelPresentation.js +7 -4
  14. package/client/organizations/organizationReadModelPresentation.js.map +1 -1
  15. package/client/organizations/organizationReadModels.js +6 -5
  16. package/client/organizations/organizationReadModels.js.map +1 -1
  17. package/client/organizations/organizationWorkflowRuntime.js +1 -1
  18. package/client/organizations/organizationWorkflowRuntime.js.map +1 -1
  19. package/client/runtime/principalMutationApi.d.ts +4 -0
  20. package/client/runtime/principalMutationApi.js +9 -5
  21. package/client/runtime/principalMutationApi.js.map +1 -1
  22. package/client/runtime/runtimeIdentityResolution.js +23 -0
  23. package/client/runtime/runtimeIdentityResolution.js.map +1 -1
  24. package/client/runtime/runtimeSubscription.js +68 -0
  25. package/client/runtime/runtimeSubscription.js.map +1 -0
  26. package/client/runtime/workflowRuntime.d.ts +3 -1
  27. package/client/runtime/workflowRuntime.js +31 -81
  28. package/client/runtime/workflowRuntime.js.map +1 -1
  29. package/client/session/authenticationMachine.js +47 -0
  30. package/client/session/authenticationMachine.js.map +1 -0
  31. package/client/session/index.js +75 -93
  32. package/client/session/index.js.map +1 -1
  33. package/client/session/sessionBlobStore.js +39 -0
  34. package/client/session/sessionBlobStore.js.map +1 -0
  35. package/client/session/sessionContext.js +11 -0
  36. package/client/session/sessionContext.js.map +1 -1
  37. package/client/session/sessionIdentityTrust.d.ts +2 -1
  38. package/client/session/sessionIdentityTrust.js +8 -4
  39. package/client/session/sessionIdentityTrust.js.map +1 -1
  40. package/client/session/sessionLifetime.js +87 -0
  41. package/client/session/sessionLifetime.js.map +1 -0
  42. package/client/session/sessionLogin.js +114 -0
  43. package/client/session/sessionLogin.js.map +1 -0
  44. package/client/session/sessionOrganizationCreation.js +3 -2
  45. package/client/session/sessionOrganizationCreation.js.map +1 -1
  46. package/client/session/sessionPurgeRecovery.js +11 -3
  47. package/client/session/sessionPurgeRecovery.js.map +1 -1
  48. package/client/session/sessionTypes.d.ts +6 -2
  49. package/client/session/sessionTypes.js.map +1 -1
  50. package/data/blobs/blobContracts.d.ts +4 -3
  51. package/data/blobs/blobContracts.js.map +1 -1
  52. package/data/blobs/createBlobStore.js +1 -8
  53. package/data/blobs/createBlobStore.js.map +1 -1
  54. package/data/blobs/encryptedBlobStore.js +17 -12
  55. package/data/blobs/encryptedBlobStore.js.map +1 -1
  56. package/data/blobs/memoryBlobStore.js +8 -5
  57. package/data/blobs/memoryBlobStore.js.map +1 -1
  58. package/data/blobs/opfsBlobFile.js +36 -0
  59. package/data/blobs/opfsBlobFile.js.map +1 -0
  60. package/data/blobs/opfsBlobStore.d.ts +1 -1
  61. package/data/blobs/opfsBlobStore.js +91 -21
  62. package/data/blobs/opfsBlobStore.js.map +1 -1
  63. package/data/principals/principalPolicyCoordinator.js +8 -17
  64. package/data/principals/principalPolicyCoordinator.js.map +1 -1
  65. package/data/shared/domainScope.d.ts +2 -0
  66. package/data/shared/domainScope.js +2 -1
  67. package/data/shared/domainScope.js.map +1 -1
  68. package/data/shared/keyedQueue.js +15 -0
  69. package/data/shared/keyedQueue.js.map +1 -0
  70. package/data/sqlite/migrations/migrateLocalSchema.js +2 -3
  71. package/data/sqlite/migrations/migrateLocalSchema.js.map +1 -1
  72. package/data/sqlite/sqlExec.d.ts +6 -0
  73. package/data/sqlite/sqlExec.js +64 -13
  74. package/data/sqlite/sqlExec.js.map +1 -1
  75. package/data/sqlite/sqlitePersistenceRuntime.js +2 -3
  76. package/data/sqlite/sqlitePersistenceRuntime.js.map +1 -1
  77. package/data/sync/syncCoordinator.js +17 -10
  78. package/data/sync/syncCoordinator.js.map +1 -1
  79. package/data/trustedUserIdentity/service.js +2 -1
  80. package/data/trustedUserIdentity/service.js.map +1 -1
  81. package/data/trustedUserIdentity/types.d.ts +1 -1
  82. package/data/trustedUserIdentity/types.js.map +1 -1
  83. package/internal/api-client/ApiClient.d.ts +4 -1
  84. package/internal/api-client/apiRequestRuntime.d.ts +6 -3
  85. package/internal/api-client/apiRequestRuntime.js +86 -101
  86. package/internal/api-client/apiRequestRuntime.js.map +1 -1
  87. package/internal/api-client/binaryRequestOperationTransport.js +2 -1
  88. package/internal/api-client/binaryRequestOperationTransport.js.map +1 -1
  89. package/internal/api-client/binaryResponseOperationTransport.js +6 -2
  90. package/internal/api-client/binaryResponseOperationTransport.js.map +1 -1
  91. package/internal/api-client/client/blobs.d.ts +1 -0
  92. package/internal/api-client/client/blobs.js +12 -3
  93. package/internal/api-client/client/blobs.js.map +1 -1
  94. package/internal/api-client/client/laneListingRequest.js +4 -0
  95. package/internal/api-client/client/laneListingRequest.js.map +1 -1
  96. package/internal/api-client/client/session.d.ts +5 -1
  97. package/internal/api-client/client/session.js +12 -4
  98. package/internal/api-client/client/session.js.map +1 -1
  99. package/internal/api-client/client/writerProjections.js +12 -13
  100. package/internal/api-client/client/writerProjections.js.map +1 -1
  101. package/internal/api-client/operationResponse.d.ts +1 -1
  102. package/internal/api-client/operationResponse.js +10 -23
  103. package/internal/api-client/operationResponse.js.map +1 -1
  104. package/internal/api-client/operationTransport.js +2 -1
  105. package/internal/api-client/operationTransport.js.map +1 -1
  106. package/internal/api-client/principalHistoryRequest.js +25 -20
  107. package/internal/api-client/principalHistoryRequest.js.map +1 -1
  108. package/internal/api-client/principalHistoryRequestContext.js +30 -6
  109. package/internal/api-client/principalHistoryRequestContext.js.map +1 -1
  110. package/internal/api-client/principalPolicyPages.d.ts +4 -1
  111. package/internal/api-client/principalPolicyPages.js +4 -2
  112. package/internal/api-client/principalPolicyPages.js.map +1 -1
  113. package/internal/api-client/projectionPolicyHistoryPages.d.ts +4 -1
  114. package/internal/api-client/projectionPolicyHistoryPages.js +4 -2
  115. package/internal/api-client/projectionPolicyHistoryPages.js.map +1 -1
  116. package/internal/api-client/routes/blobs/blobDownloadBody.js +65 -0
  117. package/internal/api-client/routes/blobs/blobDownloadBody.js.map +1 -0
  118. package/internal/api-client/routes/blobs/get.js +9 -67
  119. package/internal/api-client/routes/blobs/get.js.map +1 -1
  120. package/internal/api-client/routes/blobs/multipartUpload.js +1 -1
  121. package/internal/api-client/routes/blobs/multipartUpload.js.map +1 -1
  122. package/internal/api-client/sessionRefresh.js +1 -1
  123. package/internal/api-client/sessionRefresh.js.map +1 -1
  124. package/internal/api-client/sessionRenewal.d.ts +31 -0
  125. package/internal/api-client/sessionRenewal.js +91 -6
  126. package/internal/api-client/sessionRenewal.js.map +1 -1
  127. package/internal/api-client/sessionRequestInit.js +22 -0
  128. package/internal/api-client/sessionRequestInit.js.map +1 -0
  129. package/internal/api-client/sessionResponse.js +39 -0
  130. package/internal/api-client/sessionResponse.js.map +1 -0
  131. package/internal/api-client/types.d.ts +1 -0
  132. package/internal/api-client/types.js.map +1 -1
  133. package/internal/api-client/webSocketTickets.d.ts +1 -0
  134. package/internal/api-client/webSocketTickets.js +4 -0
  135. package/internal/api-client/webSocketTickets.js.map +1 -1
  136. package/internal/sqlite-worker/client.d.ts +1 -1
  137. package/internal/sqlite-worker/client.js +6 -1
  138. package/internal/sqlite-worker/client.js.map +1 -1
  139. package/internal/sqlite-worker/purgeOpfsDatabase.d.ts +1 -1
  140. package/internal/sqlite-worker/purgeOpfsDatabase.js +3 -2
  141. package/internal/sqlite-worker/purgeOpfsDatabase.js.map +1 -1
  142. package/internal/sqlite-worker/types.d.ts +4 -0
  143. package/internal/sqlite-worker/types.js.map +1 -1
  144. package/package.json +1 -1
  145. package/sqlite/worker.js +1 -1
  146. package/stores/container-contents/containerContentsStore.d.ts +3 -9
  147. package/stores/container-contents/containerContentsStore.js +24 -21
  148. package/stores/container-contents/containerContentsStore.js.map +1 -1
  149. package/stores/container-contents/containerState/storeScope.js +6 -0
  150. package/stores/container-contents/containerState/storeScope.js.map +1 -0
  151. package/stores/container-contents/hydration/backgroundHydration.js +2 -1
  152. package/stores/container-contents/hydration/backgroundHydration.js.map +1 -1
  153. package/stores/container-contents/hydration/reconnectRefresh.d.ts +10 -0
  154. package/stores/container-contents/hydration/reconnectRefresh.js +68 -0
  155. package/stores/container-contents/hydration/reconnectRefresh.js.map +1 -0
  156. package/stores/container-contents/hydration/reconnectRefreshMachine.js +49 -0
  157. package/stores/container-contents/hydration/reconnectRefreshMachine.js.map +1 -0
  158. package/stores/container-contents/hydration/remoteHydrationRefresh.js +4 -1
  159. package/stores/container-contents/hydration/remoteHydrationRefresh.js.map +1 -1
  160. package/stores/container-contents/hydration/remoteHydrationRequest.js +79 -10
  161. package/stores/container-contents/hydration/remoteHydrationRequest.js.map +1 -1
  162. package/stores/container-contents/hydration/startupHydration.js +2 -9
  163. package/stores/container-contents/hydration/startupHydration.js.map +1 -1
  164. package/stores/container-contents/hydration/treeResetMachine.js +61 -0
  165. package/stores/container-contents/hydration/treeResetMachine.js.map +1 -0
  166. package/stores/container-contents/localRefresh.js +28 -12
  167. package/stores/container-contents/localRefresh.js.map +1 -1
  168. package/stores/container-contents/remoteEvents/remoteContainerIngestion.js +4 -1
  169. package/stores/container-contents/remoteEvents/remoteContainerIngestion.js.map +1 -1
  170. package/stores/container-contents/remoteWrites/writeGeneration.js +5 -2
  171. package/stores/container-contents/remoteWrites/writeGeneration.js.map +1 -1
  172. package/stores/container-contents/state.d.ts +3 -7
  173. package/stores/container-contents/state.js +27 -16
  174. package/stores/container-contents/state.js.map +1 -1
  175. package/stores/container-contents/syncAgent/index.d.ts +7 -2
  176. package/stores/container-contents/syncAgent/index.js +77 -49
  177. package/stores/container-contents/syncAgent/index.js.map +1 -1
  178. package/stores/container-contents/syncAgent/syncAgentTypes.d.ts +5 -2
  179. package/stores/container-contents/syncAgent/syncAgentTypes.js.map +1 -1
  180. package/stores/container-contents/syncAgent/syncLaneIteration.js +6 -3
  181. package/stores/container-contents/syncAgent/syncLaneIteration.js.map +1 -1
  182. package/stores/local-projection/localProjectionStore.js +24 -15
  183. package/stores/local-projection/localProjectionStore.js.map +1 -1
  184. package/stores/local-projection/registry.js +2 -2
  185. package/stores/local-projection/registry.js.map +1 -1
  186. package/workflows/container-contents/container-state/create/createChild.js +3 -15
  187. package/workflows/container-contents/container-state/create/createChild.js.map +1 -1
  188. package/workflows/container-contents/containerPersistence.d.ts +4 -8
  189. package/workflows/container-contents/containerPersistence.js +22 -12
  190. package/workflows/container-contents/containerPersistence.js.map +1 -1
  191. package/workflows/container-contents/localState.js +3 -0
  192. package/workflows/container-contents/localState.js.map +1 -1
  193. package/workflows/container-contents/remoteHydration/hydrateRemoteContainers.d.ts +12 -0
  194. package/workflows/container-contents/remoteHydration/hydrateRemoteContainers.js +93 -0
  195. package/workflows/container-contents/remoteHydration/hydrateRemoteContainers.js.map +1 -0
  196. package/workflows/container-contents/remoteHydration/index.d.ts +3 -11
  197. package/workflows/container-contents/remoteHydration/index.js +17 -66
  198. package/workflows/container-contents/remoteHydration/index.js.map +1 -1
  199. package/workflows/container-contents/remoteHydration/lanes/parentLaneFetch.js +3 -2
  200. package/workflows/container-contents/remoteHydration/lanes/parentLaneFetch.js.map +1 -1
  201. package/workflows/container-contents/remoteHydration/principalPolicyCache.js +57 -5
  202. package/workflows/container-contents/remoteHydration/principalPolicyCache.js.map +1 -1
  203. package/workflows/container-contents/remoteHydration/remoteContainers/remoteContainerPageHydration.js +105 -62
  204. package/workflows/container-contents/remoteHydration/remoteContainers/remoteContainerPageHydration.js.map +1 -1
  205. package/workflows/container-contents/remoteHydration/remoteContainers/remoteContainerState.js +15 -5
  206. package/workflows/container-contents/remoteHydration/remoteContainers/remoteContainerState.js.map +1 -1
  207. package/workflows/container-contents/remoteHydration/types.d.ts +13 -0
  208. package/workflows/container-contents/remoteHydration/types.js.map +1 -1
  209. package/workflows/container-contents/runtime.d.ts +3 -0
  210. package/workflows/container-contents/runtime.js.map +1 -1
  211. package/workflows/container-contents/storedContainerState.js +17 -7
  212. package/workflows/container-contents/storedContainerState.js.map +1 -1
  213. package/workflows/container-contents/syncLane.d.ts +1 -0
  214. package/workflows/container-contents/syncLane.js +9 -1
  215. package/workflows/container-contents/syncLane.js.map +1 -1
  216. package/workflows/documents/attachments/blobMutationLock.d.ts +1 -1
  217. package/workflows/documents/attachments/blobMutationLock.js +2 -2
  218. package/workflows/documents/attachments/blobMutationLock.js.map +1 -1
  219. package/workflows/organizations/readModel/readModelProjection.js +2 -0
  220. package/workflows/organizations/readModel/readModelProjection.js.map +1 -1
  221. package/workflows/registration/registerIdentity.js +2 -0
  222. package/workflows/registration/registerIdentity.js.map +1 -1
  223. package/workflows/shared/runtimeInput.d.ts +2 -0
  224. package/workflows/shared/runtimeInput.js.map +1 -1
  225. package/workflows/container-contents/remoteHydration/completeHydration.js +0 -25
  226. package/workflows/container-contents/remoteHydration/completeHydration.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"principalPolicyPages.js","sourceRoot":"","sources":["principalPolicyPages.ts"],"names":[],"mappings":"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","sourcesContent":["import { serializeKeyingCanonicalJson } from \"@tearleads/crypto\";\nimport { getPrincipalPolicyOperation } from \"@tearleads/validators/operation\";\nimport {\n isPrincipalPolicyPageResponse,\n isPrincipalPolicyUnchangedResponse,\n type PrincipalPolicyBundleResponse,\n type PrincipalPolicyPageResponse,\n type PrincipalPolicyReadResponse,\n} from \"@tearleads/validators/response\";\nimport type { ApiRequestRuntime } from \"./apiRequestRuntime\";\nimport { principalHistoryRequest } from \"./principalHistoryRequest\";\nimport { PrincipalHistoryRequestContext } from \"./principalHistoryRequestContext\";\nimport { getPrincipalPolicy } from \"./routes/principals/policy\";\nimport type { RequestResult, RequestResultOptions } from \"./types\";\n\nexport type PrincipalPolicyPageCurrent = Omit<\n PrincipalPolicyBundleResponse,\n \"previousStates\"\n>;\n\n/** A transport position. Only the caller can authenticate the saved prefix. */\nexport interface PrincipalPolicyPageResume {\n readonly current: PrincipalPolicyPageCurrent;\n readonly afterVersion: number;\n}\n\nexport interface PrincipalPolicyPageReadOptions extends RequestResultOptions {\n /** Select an exact signed head even before its first page has been read. */\n readonly stateHash?: string | undefined;\n /** Transport offset for a caller-authenticated prefix; requires stateHash. */\n readonly afterVersion?: number | undefined;\n readonly resume?: PrincipalPolicyPageResume | undefined;\n}\n\nfunction currentArtifacts(page: PrincipalPolicyPageResponse) {\n return {\n currentState: page.currentState,\n currentPayload: page.currentPayload,\n currentProjection: page.currentProjection,\n currentGrants: page.currentGrants,\n currentMemberEnvelopes: page.currentMemberEnvelopes,\n };\n}\n\nfunction validResume(\n principalType: \"group\" | \"organization\",\n principalId: string,\n resume: PrincipalPolicyPageResume,\n stateHash: string | undefined,\n): boolean {\n const state = resume.current.currentState;\n return (\n Number.isSafeInteger(resume.afterVersion) &&\n resume.afterVersion >= 0 &&\n resume.afterVersion < state.version &&\n state.principalType === principalType &&\n state.principalId === principalId &&\n (stateHash === undefined || state.stateHash === stateHash)\n );\n}\n\nfunction readResume(input: PrincipalPolicyPageResume | undefined) {\n if (input === undefined) return undefined;\n try {\n const page = {\n ...input.current,\n previousStates: [],\n historyPage: { afterVersion: input.afterVersion, nextAfterVersion: null },\n };\n if (!isPrincipalPolicyPageResponse(page)) return undefined;\n const current = structuredClone(currentArtifacts(page));\n return {\n current,\n afterVersion: page.historyPage.afterVersion,\n bytes: serializeKeyingCanonicalJson(current),\n };\n } catch {\n return undefined;\n }\n}\n\nfunction validPage(\n page: PrincipalPolicyPageResponse,\n expected: {\n principalType: \"group\" | \"organization\";\n principalId: string;\n stateHash: string | undefined;\n pinnedBytes: string | undefined;\n bytes: string;\n afterVersion: number;\n },\n): boolean {\n const { afterVersion } = expected;\n const lastVersion = afterVersion + page.previousStates.length;\n return (\n page.currentState.principalType === expected.principalType &&\n page.currentState.principalId === expected.principalId &&\n (expected.stateHash === undefined ||\n page.currentState.stateHash === expected.stateHash) &&\n (expected.pinnedBytes === undefined ||\n expected.bytes === expected.pinnedBytes) &&\n page.historyPage.afterVersion === afterVersion &&\n lastVersion < page.currentState.version &&\n page.previousStates.every(\n ({ state }, index) =>\n state.version === afterVersion + index + 1 &&\n state.principalId === expected.principalId &&\n state.principalType === expected.principalType,\n ) &&\n (page.historyPage.nextAfterVersion === null\n ? lastVersion === page.currentState.version - 1\n : lastVersion > afterVersion &&\n lastVersion < page.currentState.version - 1 &&\n page.historyPage.nextAfterVersion === lastVersion)\n );\n}\n\nfunction preparePrincipalPolicyRead(\n runtime: ApiRequestRuntime,\n principalType: \"group\" | \"organization\",\n principalId: string,\n options: PrincipalPolicyPageReadOptions,\n) {\n const query =\n options.stateHash === undefined\n ? {}\n : {\n afterVersion: options.afterVersion ?? 0,\n stateHash: options.stateHash,\n };\n const basePath = getPrincipalPolicy.path(principalType, principalId);\n const failure = (message: string) => ({\n ok: false as const,\n failure: pageFailure(runtime, basePath, options, message, null),\n });\n if (\n options.afterVersion !== undefined &&\n (options.stateHash === undefined ||\n options.resume !== undefined ||\n !Number.isSafeInteger(options.afterVersion))\n )\n return failure(\"Initial principal history cursor requires one exact head\");\n if (!getPrincipalPolicyOperation.query.safeParse(query).success)\n return failure(\"Invalid requested principal history head\");\n const resume = readResume(options.resume);\n if (\n options.resume !== undefined &&\n (!resume ||\n !validResume(principalType, principalId, resume, options.stateHash))\n )\n return failure(\"Invalid saved principal history position\");\n return {\n ok: true as const,\n firstPath: getPrincipalPolicy.path(principalType, principalId, query),\n afterVersion: options.afterVersion ?? 0,\n resume,\n };\n}\n\n/** Pull one page at a time; the caller owns verification and durable admission. */\nexport async function* readPrincipalPolicyPages(\n runtime: ApiRequestRuntime,\n principalType: \"group\" | \"organization\",\n principalId: string,\n options: PrincipalPolicyPageReadOptions,\n): AsyncGenerator<RequestResult<PrincipalPolicyPageResponse>, void> {\n const position = preparePrincipalPolicyRead(\n runtime,\n principalType,\n principalId,\n options,\n );\n if (!position.ok) {\n yield position.failure;\n return;\n }\n const { firstPath, resume } = position;\n const context = new PrincipalHistoryRequestContext(\n runtime,\n \"GET\",\n firstPath,\n options,\n );\n let pinned = resume?.current;\n let pinnedBytes = resume?.bytes;\n let afterVersion = resume?.afterVersion ?? position.afterVersion;\n while (true) {\n const path = pinned\n ? getPrincipalPolicy.path(principalType, principalId, {\n afterVersion,\n stateHash: pinned.currentState.stateHash,\n })\n : firstPath;\n const result = await principalHistoryRequest(runtime, {\n path,\n validator: isPrincipalPolicyPageResponse,\n method: \"GET\",\n operation: getPrincipalPolicyOperation,\n options,\n context,\n });\n if (!result.ok) {\n yield result;\n return;\n }\n const page = result.data;\n const artifacts = currentArtifacts(page);\n const bytes = serializeKeyingCanonicalJson(artifacts);\n const valid = validPage(page, {\n principalType,\n principalId,\n stateHash: options.stateHash,\n pinnedBytes,\n bytes,\n afterVersion,\n });\n if (!valid) {\n yield pageFailure(\n runtime,\n path,\n options,\n \"Principal history page changed its head, order, or cursor\",\n 200,\n );\n return;\n }\n pinned ??= structuredClone(artifacts);\n pinnedBytes ??= bytes;\n context.afterReadPage();\n const nextAfterVersion = page.historyPage.nextAfterVersion;\n yield result;\n // A page consumer may await verification or storage while its session ends.\n if (context.cancelled()) {\n yield context.failure();\n return;\n }\n if (nextAfterVersion === null) return;\n afterVersion = nextAfterVersion;\n }\n}\n\n/** A head the caller already holds and has authenticated. */\nexport interface PrincipalPolicyHeldHead {\n readonly version: number;\n readonly stateHash: string;\n}\n\nexport interface PrincipalPolicyDiscoveryOptions extends RequestResultOptions {\n readonly ifHead?: PrincipalPolicyHeldHead | undefined;\n}\n\n/**\n * One unpinned discovery read. With `ifHead`, a server whose live head is\n * exactly that head answers `{ unchanged, head }` instead of the first page.\n * The reply is untrusted: the caller must check the head is the one it holds.\n */\nexport async function readPrincipalPolicyDiscovery(\n runtime: ApiRequestRuntime,\n principalType: \"group\" | \"organization\",\n principalId: string,\n options: PrincipalPolicyDiscoveryOptions,\n): Promise<RequestResult<PrincipalPolicyReadResponse>> {\n const { ifHead, ...requestOptions } = options;\n const query = ifHead\n ? { ifVersion: ifHead.version, ifStateHash: ifHead.stateHash }\n : {};\n if (!getPrincipalPolicyOperation.query.safeParse(query).success)\n return pageFailure(\n runtime,\n getPrincipalPolicy.path(principalType, principalId),\n requestOptions,\n \"Invalid held principal history head\",\n null,\n );\n const path = getPrincipalPolicy.path(principalType, principalId, query);\n const result = await principalHistoryRequest(runtime, {\n path,\n validator: getPrincipalPolicy.isResponse,\n method: \"GET\",\n operation: getPrincipalPolicyOperation,\n options: requestOptions,\n });\n if (!result.ok) return result;\n const response = result.data;\n // Exactly one variant: the strict bare-head reply, only to a conditional\n // read and only for the requested principal, or a valid first page.\n const unchanged = isPrincipalPolicyUnchangedResponse(response);\n const page = isPrincipalPolicyPageResponse(response);\n const valid = unchanged\n ? !page &&\n ifHead !== undefined &&\n response.head.principalType === principalType &&\n response.head.principalId === principalId\n : page &&\n validPage(response, {\n principalType,\n principalId,\n stateHash: undefined,\n pinnedBytes: undefined,\n bytes: \"\",\n afterVersion: 0,\n });\n return valid\n ? result\n : pageFailure(\n runtime,\n path,\n requestOptions,\n \"Principal discovery reply does not match its request\",\n 200,\n );\n}\n\n/** Full-bundle adapter for consumers that have not adopted durable staging. */\nexport async function collectPrincipalPolicyPages(\n runtime: ApiRequestRuntime,\n principalType: \"group\" | \"organization\",\n principalId: string,\n options: RequestResultOptions,\n): Promise<PrincipalPolicyBundleResponse | null> {\n let current: PrincipalPolicyPageCurrent | undefined;\n const previousStates: PrincipalPolicyBundleResponse[\"previousStates\"] = [];\n for await (const result of readPrincipalPolicyPages(\n runtime,\n principalType,\n principalId,\n options,\n )) {\n if (!result.ok) return null;\n current ??= currentArtifacts(result.data);\n previousStates.push(...result.data.previousStates);\n }\n return current ? { ...current, previousStates } : null;\n}\n\nfunction pageFailure(\n runtime: ApiRequestRuntime,\n path: string,\n options: RequestResultOptions,\n message: string,\n status: number | null,\n) {\n return runtime.responseRequest.reportFailure({\n kind: \"shape\",\n message,\n method: \"GET\",\n options,\n path,\n status,\n statusText: \"\",\n });\n}\n"]}
1
+ {"version":3,"file":"principalPolicyPages.js","sourceRoot":"","sources":["principalPolicyPages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,EACL,6BAA6B,EAC7B,kCAAkC,GAInC,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAsBhE,SAAS,gBAAgB,CAAC,IAAiC;IACzD,OAAO;QACL,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;KACpD,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAClB,aAAuC,EACvC,WAAmB,EACnB,MAAiC,EACjC,SAA6B;IAE7B,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC;IAC1C,OAAO,CACL,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,YAAY,CAAC;QACzC,MAAM,CAAC,YAAY,IAAI,CAAC;QACxB,MAAM,CAAC,YAAY,GAAG,KAAK,CAAC,OAAO;QACnC,KAAK,CAAC,aAAa,KAAK,aAAa;QACrC,KAAK,CAAC,WAAW,KAAK,WAAW;QACjC,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAC3D,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAA4C;IAC9D,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG;YACX,GAAG,KAAK,CAAC,OAAO;YAChB,cAAc,EAAE,EAAE;YAClB,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,gBAAgB,EAAE,IAAI,EAAE;SAC1E,CAAC;QACF,IAAI,CAAC,6BAA6B,CAAC,IAAI,CAAC;YAAE,OAAO,SAAS,CAAC;QAC3D,MAAM,OAAO,GAAG,eAAe,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;QACxD,OAAO;YACL,OAAO;YACP,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,YAAY;YAC3C,KAAK,EAAE,4BAA4B,CAAC,OAAO,CAAC;SAC7C,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAChB,IAAiC,EACjC,QAOC;IAED,MAAM,EAAE,YAAY,EAAE,GAAG,QAAQ,CAAC;IAClC,MAAM,WAAW,GAAG,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;IAC9D,OAAO,CACL,IAAI,CAAC,YAAY,CAAC,aAAa,KAAK,QAAQ,CAAC,aAAa;QAC1D,IAAI,CAAC,YAAY,CAAC,WAAW,KAAK,QAAQ,CAAC,WAAW;QACtD,CAAC,QAAQ,CAAC,SAAS,KAAK,SAAS;YAC/B,IAAI,CAAC,YAAY,CAAC,SAAS,KAAK,QAAQ,CAAC,SAAS,CAAC;QACrD,CAAC,QAAQ,CAAC,WAAW,KAAK,SAAS;YACjC,QAAQ,CAAC,KAAK,KAAK,QAAQ,CAAC,WAAW,CAAC;QAC1C,IAAI,CAAC,WAAW,CAAC,YAAY,KAAK,YAAY;QAC9C,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO;QACvC,IAAI,CAAC,cAAc,CAAC,KAAK,CACvB,CAAC,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,CACnB,KAAK,CAAC,OAAO,KAAK,YAAY,GAAG,KAAK,GAAG,CAAC;YAC1C,KAAK,CAAC,WAAW,KAAK,QAAQ,CAAC,WAAW;YAC1C,KAAK,CAAC,aAAa,KAAK,QAAQ,CAAC,aAAa,CACjD;QACD,CAAC,IAAI,CAAC,WAAW,CAAC,gBAAgB,KAAK,IAAI;YACzC,CAAC,CAAC,WAAW,KAAK,IAAI,CAAC,YAAY,CAAC,OAAO,GAAG,CAAC;YAC/C,CAAC,CAAC,WAAW,GAAG,YAAY;gBAC1B,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,GAAG,CAAC;gBAC3C,IAAI,CAAC,WAAW,CAAC,gBAAgB,KAAK,WAAW,CAAC,CACvD,CAAC;AACJ,CAAC;AAED,SAAS,0BAA0B,CACjC,OAA0B,EAC1B,aAAuC,EACvC,WAAmB,EACnB,OAAuC;IAEvC,MAAM,KAAK,GACT,OAAO,CAAC,SAAS,KAAK,SAAS;QAC7B,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC;YACE,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,CAAC;YACvC,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC;IACR,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IACrE,MAAM,OAAO,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,CAAC;QACpC,EAAE,EAAE,KAAc;QAClB,OAAO,EAAE,WAAW,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;KAChE,CAAC,CAAC;IACH,IACE,OAAO,CAAC,YAAY,KAAK,SAAS;QAClC,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS;YAC9B,OAAO,CAAC,MAAM,KAAK,SAAS;YAC5B,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAE9C,OAAO,OAAO,CAAC,0DAA0D,CAAC,CAAC;IAC7E,IAAI,CAAC,2BAA2B,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO;QAC7D,OAAO,OAAO,CAAC,0CAA0C,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,IACE,OAAO,CAAC,MAAM,KAAK,SAAS;QAC5B,CAAC,CAAC,MAAM;YACN,CAAC,WAAW,CAAC,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAEtE,OAAO,OAAO,CAAC,0CAA0C,CAAC,CAAC;IAC7D,OAAO;QACL,EAAE,EAAE,IAAa;QACjB,SAAS,EAAE,kBAAkB,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,EAAE,KAAK,CAAC;QACrE,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,CAAC;QACvC,MAAM;KACP,CAAC;AACJ,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,wBAAwB,CAC7C,OAA0B,EAC1B,aAAuC,EACvC,WAAmB,EACnB,OAAuC;AACvC,8EAA8E;AAC9E,QAAQ,GAAG,8BAA8B,CAAC,eAAe,CAAC,OAAO,CAAC;IAElE,MAAM,QAAQ,GAAG,0BAA0B,CACzC,OAAO,EACP,aAAa,EACb,WAAW,EACX,OAAO,CACR,CAAC;IACF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,QAAQ,CAAC,OAAO,CAAC;QACvB,OAAO;IACT,CAAC;IACD,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,8BAA8B,CAChD,OAAO,EACP,KAAK,EACL,SAAS,EACT,OAAO,EACP,QAAQ,CACT,CAAC;IACF,IAAI,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC;IAC7B,IAAI,WAAW,GAAG,MAAM,EAAE,KAAK,CAAC;IAChC,IAAI,YAAY,GAAG,MAAM,EAAE,YAAY,IAAI,QAAQ,CAAC,YAAY,CAAC;IACjE,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM;YACjB,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,EAAE;gBAClD,YAAY;gBACZ,SAAS,EAAE,MAAM,CAAC,YAAY,CAAC,SAAS;aACzC,CAAC;YACJ,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,OAAO,EAAE;YACpD,IAAI;YACJ,SAAS,EAAE,6BAA6B;YACxC,MAAM,EAAE,KAAK;YACb,SAAS,EAAE,2BAA2B;YACtC,OAAO;YACP,OAAO;SACR,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,MAAM,CAAC;YACb,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,4BAA4B,CAAC,SAAS,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE;YAC5B,aAAa;YACb,WAAW;YACX,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,WAAW;YACX,KAAK;YACL,YAAY;SACb,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,WAAW,CACf,OAAO,EACP,IAAI,EACJ,OAAO,EACP,2DAA2D,EAC3D,GAAG,CACJ,CAAC;YACF,OAAO;QACT,CAAC;QACD,MAAM,KAAK,eAAe,CAAC,SAAS,CAAC,CAAC;QACtC,WAAW,KAAK,KAAK,CAAC;QACtB,OAAO,CAAC,aAAa,EAAE,CAAC;QACxB,MAAM,gBAAgB,GAAG,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC;QAC3D,MAAM,MAAM,CAAC;QACb,4EAA4E;QAC5E,IAAI,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;YACxB,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QACD,IAAI,gBAAgB,KAAK,IAAI;YAAE,OAAO;QACtC,YAAY,GAAG,gBAAgB,CAAC;IAClC,CAAC;AACH,CAAC;AAYD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,OAA0B,EAC1B,aAAuC,EACvC,WAAmB,EACnB,OAAwC;IAExC,MAAM,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,CAAC;IAC9C,MAAM,KAAK,GAAG,MAAM;QAClB,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE;QAC9D,CAAC,CAAC,EAAE,CAAC;IACP,IAAI,CAAC,2BAA2B,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO;QAC7D,OAAO,WAAW,CAChB,OAAO,EACP,kBAAkB,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,EACnD,cAAc,EACd,qCAAqC,EACrC,IAAI,CACL,CAAC;IACJ,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,OAAO,EAAE;QACpD,IAAI;QACJ,SAAS,EAAE,kBAAkB,CAAC,UAAU;QACxC,MAAM,EAAE,KAAK;QACb,SAAS,EAAE,2BAA2B;QACtC,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC;IAC9B,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;IAC7B,yEAAyE;IACzE,oEAAoE;IACpE,MAAM,SAAS,GAAG,kCAAkC,CAAC,QAAQ,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,6BAA6B,CAAC,QAAQ,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,SAAS;QACrB,CAAC,CAAC,CAAC,IAAI;YACL,MAAM,KAAK,SAAS;YACpB,QAAQ,CAAC,IAAI,CAAC,aAAa,KAAK,aAAa;YAC7C,QAAQ,CAAC,IAAI,CAAC,WAAW,KAAK,WAAW;QAC3C,CAAC,CAAC,IAAI;YACJ,SAAS,CAAC,QAAQ,EAAE;gBAClB,aAAa;gBACb,WAAW;gBACX,SAAS,EAAE,SAAS;gBACpB,WAAW,EAAE,SAAS;gBACtB,KAAK,EAAE,EAAE;gBACT,YAAY,EAAE,CAAC;aAChB,CAAC,CAAC;IACP,OAAO,KAAK;QACV,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,WAAW,CACT,OAAO,EACP,IAAI,EACJ,cAAc,EACd,sDAAsD,EACtD,GAAG,CACJ,CAAC;AACR,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,OAA0B,EAC1B,aAAuC,EACvC,WAAmB,EACnB,OAA6B;IAE7B,IAAI,OAA+C,CAAC;IACpD,MAAM,cAAc,GAAoD,EAAE,CAAC;IAC3E,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,wBAAwB,CACjD,OAAO,EACP,aAAa,EACb,WAAW,EACX,OAAO,CACR,EAAE,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QAC5B,OAAO,KAAK,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1C,cAAc,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACzD,CAAC;AAED,SAAS,WAAW,CAClB,OAA0B,EAC1B,IAAY,EACZ,OAA6B,EAC7B,OAAe,EACf,MAAqB;IAErB,OAAO,OAAO,CAAC,eAAe,CAAC,aAAa,CAAC;QAC3C,IAAI,EAAE,OAAO;QACb,OAAO;QACP,MAAM,EAAE,KAAK;QACb,OAAO;QACP,IAAI;QACJ,MAAM;QACN,UAAU,EAAE,EAAE;KACf,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { serializeKeyingCanonicalJson } from \"@tearleads/crypto\";\nimport { getPrincipalPolicyOperation } from \"@tearleads/validators/operation\";\nimport {\n isPrincipalPolicyPageResponse,\n isPrincipalPolicyUnchangedResponse,\n type PrincipalPolicyBundleResponse,\n type PrincipalPolicyPageResponse,\n type PrincipalPolicyReadResponse,\n} from \"@tearleads/validators/response\";\nimport type { ApiRequestRuntime } from \"./apiRequestRuntime\";\nimport { principalHistoryRequest } from \"./principalHistoryRequest\";\nimport { PrincipalHistoryRequestContext } from \"./principalHistoryRequestContext\";\nimport { getPrincipalPolicy } from \"./routes/principals/policy\";\nimport type { RequestResult, RequestResultOptions } from \"./types\";\n\nexport type PrincipalPolicyPageCurrent = Omit<\n PrincipalPolicyBundleResponse,\n \"previousStates\"\n>;\n\n/** A transport position. Only the caller can authenticate the saved prefix. */\nexport interface PrincipalPolicyPageResume {\n readonly current: PrincipalPolicyPageCurrent;\n readonly afterVersion: number;\n}\n\nexport interface PrincipalPolicyPageReadOptions extends RequestResultOptions {\n /** Select an exact signed head even before its first page has been read. */\n readonly stateHash?: string | undefined;\n /** Transport offset for a caller-authenticated prefix; requires stateHash. */\n readonly afterVersion?: number | undefined;\n readonly resume?: PrincipalPolicyPageResume | undefined;\n}\n\nfunction currentArtifacts(page: PrincipalPolicyPageResponse) {\n return {\n currentState: page.currentState,\n currentPayload: page.currentPayload,\n currentProjection: page.currentProjection,\n currentGrants: page.currentGrants,\n currentMemberEnvelopes: page.currentMemberEnvelopes,\n };\n}\n\nfunction validResume(\n principalType: \"group\" | \"organization\",\n principalId: string,\n resume: PrincipalPolicyPageResume,\n stateHash: string | undefined,\n): boolean {\n const state = resume.current.currentState;\n return (\n Number.isSafeInteger(resume.afterVersion) &&\n resume.afterVersion >= 0 &&\n resume.afterVersion < state.version &&\n state.principalType === principalType &&\n state.principalId === principalId &&\n (stateHash === undefined || state.stateHash === stateHash)\n );\n}\n\nfunction readResume(input: PrincipalPolicyPageResume | undefined) {\n if (input === undefined) return undefined;\n try {\n const page = {\n ...input.current,\n previousStates: [],\n historyPage: { afterVersion: input.afterVersion, nextAfterVersion: null },\n };\n if (!isPrincipalPolicyPageResponse(page)) return undefined;\n const current = structuredClone(currentArtifacts(page));\n return {\n current,\n afterVersion: page.historyPage.afterVersion,\n bytes: serializeKeyingCanonicalJson(current),\n };\n } catch {\n return undefined;\n }\n}\n\nfunction validPage(\n page: PrincipalPolicyPageResponse,\n expected: {\n principalType: \"group\" | \"organization\";\n principalId: string;\n stateHash: string | undefined;\n pinnedBytes: string | undefined;\n bytes: string;\n afterVersion: number;\n },\n): boolean {\n const { afterVersion } = expected;\n const lastVersion = afterVersion + page.previousStates.length;\n return (\n page.currentState.principalType === expected.principalType &&\n page.currentState.principalId === expected.principalId &&\n (expected.stateHash === undefined ||\n page.currentState.stateHash === expected.stateHash) &&\n (expected.pinnedBytes === undefined ||\n expected.bytes === expected.pinnedBytes) &&\n page.historyPage.afterVersion === afterVersion &&\n lastVersion < page.currentState.version &&\n page.previousStates.every(\n ({ state }, index) =>\n state.version === afterVersion + index + 1 &&\n state.principalId === expected.principalId &&\n state.principalType === expected.principalType,\n ) &&\n (page.historyPage.nextAfterVersion === null\n ? lastVersion === page.currentState.version - 1\n : lastVersion > afterVersion &&\n lastVersion < page.currentState.version - 1 &&\n page.historyPage.nextAfterVersion === lastVersion)\n );\n}\n\nfunction preparePrincipalPolicyRead(\n runtime: ApiRequestRuntime,\n principalType: \"group\" | \"organization\",\n principalId: string,\n options: PrincipalPolicyPageReadOptions,\n) {\n const query =\n options.stateHash === undefined\n ? {}\n : {\n afterVersion: options.afterVersion ?? 0,\n stateHash: options.stateHash,\n };\n const basePath = getPrincipalPolicy.path(principalType, principalId);\n const failure = (message: string) => ({\n ok: false as const,\n failure: pageFailure(runtime, basePath, options, message, null),\n });\n if (\n options.afterVersion !== undefined &&\n (options.stateHash === undefined ||\n options.resume !== undefined ||\n !Number.isSafeInteger(options.afterVersion))\n )\n return failure(\"Initial principal history cursor requires one exact head\");\n if (!getPrincipalPolicyOperation.query.safeParse(query).success)\n return failure(\"Invalid requested principal history head\");\n const resume = readResume(options.resume);\n if (\n options.resume !== undefined &&\n (!resume ||\n !validResume(principalType, principalId, resume, options.stateHash))\n )\n return failure(\"Invalid saved principal history position\");\n return {\n ok: true as const,\n firstPath: getPrincipalPolicy.path(principalType, principalId, query),\n afterVersion: options.afterVersion ?? 0,\n resume,\n };\n}\n\n/** Pull one page at a time; the caller owns verification and durable admission. */\nexport async function* readPrincipalPolicyPages(\n runtime: ApiRequestRuntime,\n principalType: \"group\" | \"organization\",\n principalId: string,\n options: PrincipalPolicyPageReadOptions,\n // Default parameters run when the iterator is created, before its first pull.\n identity = PrincipalHistoryRequestContext.captureIdentity(runtime),\n): AsyncGenerator<RequestResult<PrincipalPolicyPageResponse>, void> {\n const position = preparePrincipalPolicyRead(\n runtime,\n principalType,\n principalId,\n options,\n );\n if (!position.ok) {\n yield position.failure;\n return;\n }\n const { firstPath, resume } = position;\n const context = new PrincipalHistoryRequestContext(\n runtime,\n \"GET\",\n firstPath,\n options,\n identity,\n );\n let pinned = resume?.current;\n let pinnedBytes = resume?.bytes;\n let afterVersion = resume?.afterVersion ?? position.afterVersion;\n while (true) {\n const path = pinned\n ? getPrincipalPolicy.path(principalType, principalId, {\n afterVersion,\n stateHash: pinned.currentState.stateHash,\n })\n : firstPath;\n const result = await principalHistoryRequest(runtime, {\n path,\n validator: isPrincipalPolicyPageResponse,\n method: \"GET\",\n operation: getPrincipalPolicyOperation,\n options,\n context,\n });\n if (!result.ok) {\n yield result;\n return;\n }\n const page = result.data;\n const artifacts = currentArtifacts(page);\n const bytes = serializeKeyingCanonicalJson(artifacts);\n const valid = validPage(page, {\n principalType,\n principalId,\n stateHash: options.stateHash,\n pinnedBytes,\n bytes,\n afterVersion,\n });\n if (!valid) {\n yield pageFailure(\n runtime,\n path,\n options,\n \"Principal history page changed its head, order, or cursor\",\n 200,\n );\n return;\n }\n pinned ??= structuredClone(artifacts);\n pinnedBytes ??= bytes;\n context.afterReadPage();\n const nextAfterVersion = page.historyPage.nextAfterVersion;\n yield result;\n // A page consumer may await verification or storage while its session ends.\n if (context.cancelled()) {\n yield context.failure();\n return;\n }\n if (nextAfterVersion === null) return;\n afterVersion = nextAfterVersion;\n }\n}\n\n/** A head the caller already holds and has authenticated. */\nexport interface PrincipalPolicyHeldHead {\n readonly version: number;\n readonly stateHash: string;\n}\n\nexport interface PrincipalPolicyDiscoveryOptions extends RequestResultOptions {\n readonly ifHead?: PrincipalPolicyHeldHead | undefined;\n}\n\n/**\n * One unpinned discovery read. With `ifHead`, a server whose live head is\n * exactly that head answers `{ unchanged, head }` instead of the first page.\n * The reply is untrusted: the caller must check the head is the one it holds.\n */\nexport async function readPrincipalPolicyDiscovery(\n runtime: ApiRequestRuntime,\n principalType: \"group\" | \"organization\",\n principalId: string,\n options: PrincipalPolicyDiscoveryOptions,\n): Promise<RequestResult<PrincipalPolicyReadResponse>> {\n const { ifHead, ...requestOptions } = options;\n const query = ifHead\n ? { ifVersion: ifHead.version, ifStateHash: ifHead.stateHash }\n : {};\n if (!getPrincipalPolicyOperation.query.safeParse(query).success)\n return pageFailure(\n runtime,\n getPrincipalPolicy.path(principalType, principalId),\n requestOptions,\n \"Invalid held principal history head\",\n null,\n );\n const path = getPrincipalPolicy.path(principalType, principalId, query);\n const result = await principalHistoryRequest(runtime, {\n path,\n validator: getPrincipalPolicy.isResponse,\n method: \"GET\",\n operation: getPrincipalPolicyOperation,\n options: requestOptions,\n });\n if (!result.ok) return result;\n const response = result.data;\n // Exactly one variant: the strict bare-head reply, only to a conditional\n // read and only for the requested principal, or a valid first page.\n const unchanged = isPrincipalPolicyUnchangedResponse(response);\n const page = isPrincipalPolicyPageResponse(response);\n const valid = unchanged\n ? !page &&\n ifHead !== undefined &&\n response.head.principalType === principalType &&\n response.head.principalId === principalId\n : page &&\n validPage(response, {\n principalType,\n principalId,\n stateHash: undefined,\n pinnedBytes: undefined,\n bytes: \"\",\n afterVersion: 0,\n });\n return valid\n ? result\n : pageFailure(\n runtime,\n path,\n requestOptions,\n \"Principal discovery reply does not match its request\",\n 200,\n );\n}\n\n/** Full-bundle adapter for consumers that have not adopted durable staging. */\nexport async function collectPrincipalPolicyPages(\n runtime: ApiRequestRuntime,\n principalType: \"group\" | \"organization\",\n principalId: string,\n options: RequestResultOptions,\n): Promise<PrincipalPolicyBundleResponse | null> {\n let current: PrincipalPolicyPageCurrent | undefined;\n const previousStates: PrincipalPolicyBundleResponse[\"previousStates\"] = [];\n for await (const result of readPrincipalPolicyPages(\n runtime,\n principalType,\n principalId,\n options,\n )) {\n if (!result.ok) return null;\n current ??= currentArtifacts(result.data);\n previousStates.push(...result.data.previousStates);\n }\n return current ? { ...current, previousStates } : null;\n}\n\nfunction pageFailure(\n runtime: ApiRequestRuntime,\n path: string,\n options: RequestResultOptions,\n message: string,\n status: number | null,\n) {\n return runtime.responseRequest.reportFailure({\n kind: \"shape\",\n message,\n method: \"GET\",\n options,\n path,\n status,\n statusText: \"\",\n });\n}\n"]}
@@ -12,4 +12,7 @@ export interface ProjectionPolicyHistoryReadOptions extends RequestResultOptions
12
12
  readonly knownCurrentState?: PrincipalStateResponse | undefined;
13
13
  }
14
14
  /** One bounded public page at a time. Only the caller authenticates its contents. */
15
- export declare function readProjectionPolicyHistoryPages(runtime: ApiRequestRuntime, input: PrincipalPolicyHistorySourceResponse, options?: ProjectionPolicyHistoryReadOptions): AsyncGenerator<RequestResult<PrincipalPolicySnapshotPage>, void>;
15
+ export declare function readProjectionPolicyHistoryPages(runtime: ApiRequestRuntime, input: PrincipalPolicyHistorySourceResponse, options?: ProjectionPolicyHistoryReadOptions, identity?: {
16
+ credentialCurrent: () => boolean | Promise<boolean>;
17
+ session: AbortSignal | undefined;
18
+ }): AsyncGenerator<RequestResult<PrincipalPolicySnapshotPage>, void>;
@@ -56,7 +56,9 @@ function readStart(input, options) {
56
56
  };
57
57
  }
58
58
  /** One bounded public page at a time. Only the caller authenticates its contents. */
59
- export async function* readProjectionPolicyHistoryPages(runtime, input, options = {}) {
59
+ export async function* readProjectionPolicyHistoryPages(runtime, input, options = {},
60
+ // Default parameters run when the iterator is created, before its first pull.
61
+ identity = PrincipalHistoryRequestContext.captureIdentity(runtime)) {
60
62
  const invalid = (message, status = null) => runtime.responseRequest.reportFailure({
61
63
  kind: "shape",
62
64
  message,
@@ -73,7 +75,7 @@ export async function* readProjectionPolicyHistoryPages(runtime, input, options
73
75
  }
74
76
  const { source, knownCurrentState } = start;
75
77
  let afterVersion = start.afterVersion;
76
- const context = new PrincipalHistoryRequestContext(runtime, "GET", "/principals/history", options);
78
+ const context = new PrincipalHistoryRequestContext(runtime, "GET", "/principals/history", options, identity);
77
79
  let pinnedBytes;
78
80
  while (true) {
79
81
  const path = operationRequestPathWithQuery(getProjectionPolicyHistoryOperation, {}, {
@@ -1 +1 @@
1
- {"version":3,"file":"projectionPolicyHistoryPages.js","sourceRoot":"","sources":["projectionPolicyHistoryPages.ts"],"names":[],"mappings":"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","sourcesContent":["import { serializeKeyingCanonicalJson } from \"@tearleads/crypto\";\nimport {\n getProjectionPolicyHistoryOperation,\n operationRequestPathWithQuery,\n} from \"@tearleads/validators/operation\";\nimport {\n isPrincipalPolicySnapshotPageResponse,\n isPrincipalStateResponse,\n type PrincipalPolicyHistorySourceResponse,\n PrincipalPolicyHistorySourceResponseSchema,\n type PrincipalPolicySnapshotPage,\n type PrincipalPolicySnapshotPageResponse,\n type PrincipalStateResponse,\n} from \"@tearleads/validators/response\";\nimport type { ApiRequestRuntime } from \"./apiRequestRuntime\";\nimport { principalHistoryRequest } from \"./principalHistoryRequest\";\nimport { PrincipalHistoryRequestContext } from \"./principalHistoryRequestContext\";\nimport type { RequestResult, RequestResultOptions } from \"./types\";\n\nexport interface ProjectionPolicyHistoryReadOptions\n extends RequestResultOptions {\n /** Only skip a prefix already authenticated by the caller. */\n readonly afterVersion?: number | undefined;\n /**\n * A signed state the caller holds for exactly the source head. The server\n * then omits its copy and every page carries this one; the caller verifies\n * it as it would a served state.\n */\n readonly knownCurrentState?: PrincipalStateResponse | undefined;\n}\n\nfunction matchesHead(\n state: PrincipalStateResponse,\n head: PrincipalPolicyHistorySourceResponse[\"head\"],\n): boolean {\n return (\n state.principalType === head.principalType &&\n state.principalId === head.principalId &&\n state.version === head.version &&\n state.stateHash === head.stateHash &&\n state.keyEpoch === head.keyEpoch &&\n state.keyFingerprint === head.keyFingerprint\n );\n}\n\n/** A held state replaces only an explicit omission; a served one must be absent from the request. */\nfunction currentPage(\n page: PrincipalPolicySnapshotPageResponse,\n known: PrincipalStateResponse | undefined,\n): PrincipalPolicySnapshotPage | undefined {\n if (known) {\n return page.currentState === null\n ? { ...page, currentState: structuredClone(known) }\n : undefined;\n }\n const currentState = page.currentState;\n return currentState === null ? undefined : { ...page, currentState };\n}\n\nfunction validPage(\n page: PrincipalPolicySnapshotPage,\n source: PrincipalPolicyHistorySourceResponse,\n after: number,\n): boolean {\n const head = source.head;\n const through = after + page.previousStates.length;\n return (\n matchesHead(page.currentState, head) &&\n page.historyPage.afterVersion === after &&\n through < head.version &&\n page.previousStates.every(\n ({ state: entry }, index) =>\n entry.version === after + index + 1 &&\n entry.principalType === head.principalType &&\n entry.principalId === head.principalId,\n ) &&\n (page.historyPage.nextAfterVersion === null\n ? through === head.version - 1\n : through > after &&\n through < head.version - 1 &&\n page.historyPage.nextAfterVersion === through)\n );\n}\n\n/** Owned copies of a valid source, cursor and held head, or undefined. */\nfunction readStart(\n input: PrincipalPolicyHistorySourceResponse,\n options: ProjectionPolicyHistoryReadOptions,\n) {\n const parsed = PrincipalPolicyHistorySourceResponseSchema.safeParse(input);\n const afterVersion = options.afterVersion ?? 0;\n const known = options.knownCurrentState;\n if (\n !parsed.success ||\n !Number.isSafeInteger(afterVersion) ||\n afterVersion < 0 ||\n afterVersion >= parsed.data.head.version ||\n (known !== undefined &&\n (!isPrincipalStateResponse(known) ||\n !matchesHead(known, parsed.data.head)))\n )\n return undefined;\n return {\n source: structuredClone(parsed.data),\n afterVersion,\n knownCurrentState: known && structuredClone(known),\n };\n}\n\n/** One bounded public page at a time. Only the caller authenticates its contents. */\nexport async function* readProjectionPolicyHistoryPages(\n runtime: ApiRequestRuntime,\n input: PrincipalPolicyHistorySourceResponse,\n options: ProjectionPolicyHistoryReadOptions = {},\n): AsyncGenerator<RequestResult<PrincipalPolicySnapshotPage>, void> {\n const invalid = (message: string, status: number | null = null) =>\n runtime.responseRequest.reportFailure({\n kind: \"shape\",\n message,\n method: \"GET\",\n options,\n path: \"/principals/history\",\n status,\n statusText: \"\",\n });\n const start = readStart(input, options);\n if (!start) {\n yield invalid(\"Invalid projection history source or cursor\");\n return;\n }\n const { source, knownCurrentState } = start;\n let afterVersion = start.afterVersion;\n const context = new PrincipalHistoryRequestContext(\n runtime,\n \"GET\",\n \"/principals/history\",\n options,\n );\n let pinnedBytes: string | undefined;\n while (true) {\n const path = operationRequestPathWithQuery(\n getProjectionPolicyHistoryOperation,\n {},\n {\n grant: source.grant,\n afterVersion,\n ...(knownCurrentState\n ? { knownStateHash: knownCurrentState.stateHash }\n : {}),\n },\n );\n const result = await principalHistoryRequest(runtime, {\n path,\n validator: isPrincipalPolicySnapshotPageResponse,\n method: \"GET\",\n operation: getProjectionPolicyHistoryOperation,\n options,\n context,\n });\n if (!result.ok) {\n yield result;\n return;\n }\n const page = currentPage(result.data, knownCurrentState);\n const bytes =\n page &&\n serializeKeyingCanonicalJson({\n currentState: page.currentState,\n currentProjection: page.currentProjection,\n currentGrants: page.currentGrants,\n });\n if (\n !page ||\n !validPage(page, source, afterVersion) ||\n (pinnedBytes !== undefined && bytes !== pinnedBytes)\n ) {\n yield invalid(\n \"Projection history page changed its head, order, or cursor\",\n 200,\n );\n return;\n }\n pinnedBytes ??= bytes;\n context.afterReadPage();\n const next = page.historyPage.nextAfterVersion;\n yield { ...result, data: page };\n if (context.cancelled()) {\n yield context.failure();\n return;\n }\n if (next === null) return;\n afterVersion = next;\n }\n}\n"]}
1
+ {"version":3,"file":"projectionPolicyHistoryPages.js","sourceRoot":"","sources":["projectionPolicyHistoryPages.ts"],"names":[],"mappings":"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","sourcesContent":["import { serializeKeyingCanonicalJson } from \"@tearleads/crypto\";\nimport {\n getProjectionPolicyHistoryOperation,\n operationRequestPathWithQuery,\n} from \"@tearleads/validators/operation\";\nimport {\n isPrincipalPolicySnapshotPageResponse,\n isPrincipalStateResponse,\n type PrincipalPolicyHistorySourceResponse,\n PrincipalPolicyHistorySourceResponseSchema,\n type PrincipalPolicySnapshotPage,\n type PrincipalPolicySnapshotPageResponse,\n type PrincipalStateResponse,\n} from \"@tearleads/validators/response\";\nimport type { ApiRequestRuntime } from \"./apiRequestRuntime\";\nimport { principalHistoryRequest } from \"./principalHistoryRequest\";\nimport { PrincipalHistoryRequestContext } from \"./principalHistoryRequestContext\";\nimport type { RequestResult, RequestResultOptions } from \"./types\";\n\nexport interface ProjectionPolicyHistoryReadOptions\n extends RequestResultOptions {\n /** Only skip a prefix already authenticated by the caller. */\n readonly afterVersion?: number | undefined;\n /**\n * A signed state the caller holds for exactly the source head. The server\n * then omits its copy and every page carries this one; the caller verifies\n * it as it would a served state.\n */\n readonly knownCurrentState?: PrincipalStateResponse | undefined;\n}\n\nfunction matchesHead(\n state: PrincipalStateResponse,\n head: PrincipalPolicyHistorySourceResponse[\"head\"],\n): boolean {\n return (\n state.principalType === head.principalType &&\n state.principalId === head.principalId &&\n state.version === head.version &&\n state.stateHash === head.stateHash &&\n state.keyEpoch === head.keyEpoch &&\n state.keyFingerprint === head.keyFingerprint\n );\n}\n\n/** A held state replaces only an explicit omission; a served one must be absent from the request. */\nfunction currentPage(\n page: PrincipalPolicySnapshotPageResponse,\n known: PrincipalStateResponse | undefined,\n): PrincipalPolicySnapshotPage | undefined {\n if (known) {\n return page.currentState === null\n ? { ...page, currentState: structuredClone(known) }\n : undefined;\n }\n const currentState = page.currentState;\n return currentState === null ? undefined : { ...page, currentState };\n}\n\nfunction validPage(\n page: PrincipalPolicySnapshotPage,\n source: PrincipalPolicyHistorySourceResponse,\n after: number,\n): boolean {\n const head = source.head;\n const through = after + page.previousStates.length;\n return (\n matchesHead(page.currentState, head) &&\n page.historyPage.afterVersion === after &&\n through < head.version &&\n page.previousStates.every(\n ({ state: entry }, index) =>\n entry.version === after + index + 1 &&\n entry.principalType === head.principalType &&\n entry.principalId === head.principalId,\n ) &&\n (page.historyPage.nextAfterVersion === null\n ? through === head.version - 1\n : through > after &&\n through < head.version - 1 &&\n page.historyPage.nextAfterVersion === through)\n );\n}\n\n/** Owned copies of a valid source, cursor and held head, or undefined. */\nfunction readStart(\n input: PrincipalPolicyHistorySourceResponse,\n options: ProjectionPolicyHistoryReadOptions,\n) {\n const parsed = PrincipalPolicyHistorySourceResponseSchema.safeParse(input);\n const afterVersion = options.afterVersion ?? 0;\n const known = options.knownCurrentState;\n if (\n !parsed.success ||\n !Number.isSafeInteger(afterVersion) ||\n afterVersion < 0 ||\n afterVersion >= parsed.data.head.version ||\n (known !== undefined &&\n (!isPrincipalStateResponse(known) ||\n !matchesHead(known, parsed.data.head)))\n )\n return undefined;\n return {\n source: structuredClone(parsed.data),\n afterVersion,\n knownCurrentState: known && structuredClone(known),\n };\n}\n\n/** One bounded public page at a time. Only the caller authenticates its contents. */\nexport async function* readProjectionPolicyHistoryPages(\n runtime: ApiRequestRuntime,\n input: PrincipalPolicyHistorySourceResponse,\n options: ProjectionPolicyHistoryReadOptions = {},\n // Default parameters run when the iterator is created, before its first pull.\n identity = PrincipalHistoryRequestContext.captureIdentity(runtime),\n): AsyncGenerator<RequestResult<PrincipalPolicySnapshotPage>, void> {\n const invalid = (message: string, status: number | null = null) =>\n runtime.responseRequest.reportFailure({\n kind: \"shape\",\n message,\n method: \"GET\",\n options,\n path: \"/principals/history\",\n status,\n statusText: \"\",\n });\n const start = readStart(input, options);\n if (!start) {\n yield invalid(\"Invalid projection history source or cursor\");\n return;\n }\n const { source, knownCurrentState } = start;\n let afterVersion = start.afterVersion;\n const context = new PrincipalHistoryRequestContext(\n runtime,\n \"GET\",\n \"/principals/history\",\n options,\n identity,\n );\n let pinnedBytes: string | undefined;\n while (true) {\n const path = operationRequestPathWithQuery(\n getProjectionPolicyHistoryOperation,\n {},\n {\n grant: source.grant,\n afterVersion,\n ...(knownCurrentState\n ? { knownStateHash: knownCurrentState.stateHash }\n : {}),\n },\n );\n const result = await principalHistoryRequest(runtime, {\n path,\n validator: isPrincipalPolicySnapshotPageResponse,\n method: \"GET\",\n operation: getProjectionPolicyHistoryOperation,\n options,\n context,\n });\n if (!result.ok) {\n yield result;\n return;\n }\n const page = currentPage(result.data, knownCurrentState);\n const bytes =\n page &&\n serializeKeyingCanonicalJson({\n currentState: page.currentState,\n currentProjection: page.currentProjection,\n currentGrants: page.currentGrants,\n });\n if (\n !page ||\n !validPage(page, source, afterVersion) ||\n (pinnedBytes !== undefined && bytes !== pinnedBytes)\n ) {\n yield invalid(\n \"Projection history page changed its head, order, or cursor\",\n 200,\n );\n return;\n }\n pinnedBytes ??= bytes;\n context.afterReadPage();\n const next = page.historyPage.nextAfterVersion;\n yield { ...result, data: page };\n if (context.cancelled()) {\n yield context.failure();\n return;\n }\n if (next === null) return;\n afterVersion = next;\n }\n}\n"]}
@@ -0,0 +1,65 @@
1
+ // A native HTTP bridge can have a successful buffered response with no body
2
+ // stream. Both transports retain the sign-in until the consumer reads a chunk.
3
+ export async function blobDownloadBody(response, signal, redact = false) {
4
+ const stream = response.body ?? bufferedResponseBodyStream(await response.arrayBuffer());
5
+ if (!signal && !redact)
6
+ return stream;
7
+ const reader = stream.getReader();
8
+ function cancelRetired() {
9
+ void reader.cancel().catch(() => { });
10
+ }
11
+ return new ReadableStream({
12
+ async pull(controller) {
13
+ signal?.addEventListener("abort", cancelRetired, { once: true });
14
+ try {
15
+ if (signal?.aborted)
16
+ cancelRetired();
17
+ signal?.throwIfAborted();
18
+ const { done, value } = await reader.read();
19
+ signal?.throwIfAborted();
20
+ if (done) {
21
+ controller.close();
22
+ reader.releaseLock();
23
+ }
24
+ else {
25
+ controller.enqueue(value);
26
+ }
27
+ }
28
+ catch (error) {
29
+ controller.error(redact ? new Error("Blob download interrupted") : error);
30
+ reader.releaseLock();
31
+ }
32
+ finally {
33
+ signal?.removeEventListener("abort", cancelRetired);
34
+ }
35
+ },
36
+ async cancel(reason) {
37
+ try {
38
+ await reader.cancel(reason);
39
+ }
40
+ catch (error) {
41
+ throw redact ? new Error("Blob download cancellation failed") : error;
42
+ }
43
+ finally {
44
+ reader.releaseLock();
45
+ }
46
+ },
47
+ }, { highWaterMark: 0 });
48
+ }
49
+ // Wraps a fully-buffered response body as a single-chunk ReadableStream, so a
50
+ // native HTTP bridge that only exposes the buffered bytes (no WHATWG
51
+ // `response.body` stream) can still satisfy the streaming
52
+ // `BlobBytesResponse.encryptedBytes` contract. An empty buffer yields an
53
+ // immediately-closed, zero-chunk stream.
54
+ function bufferedResponseBodyStream(buffer) {
55
+ const bytes = new Uint8Array(buffer);
56
+ return new ReadableStream({
57
+ start(controller) {
58
+ if (bytes.byteLength > 0) {
59
+ controller.enqueue(bytes);
60
+ }
61
+ controller.close();
62
+ },
63
+ });
64
+ }
65
+ //# sourceMappingURL=blobDownloadBody.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"blobDownloadBody.js","sourceRoot":"","sources":["blobDownloadBody.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAAkB,EAClB,MAAoB,EACpB,MAAM,GAAG,KAAK;IAEd,MAAM,MAAM,GACV,QAAQ,CAAC,IAAI,IAAI,0BAA0B,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5E,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM;QAAE,OAAO,MAAM,CAAC;IACtC,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;IAClC,SAAS,aAAa;QACpB,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,cAAc,CACvB;QACE,KAAK,CAAC,IAAI,CAAC,UAAU;YACnB,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACjE,IAAI,CAAC;gBACH,IAAI,MAAM,EAAE,OAAO;oBAAE,aAAa,EAAE,CAAC;gBACrC,MAAM,EAAE,cAAc,EAAE,CAAC;gBACzB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC5C,MAAM,EAAE,cAAc,EAAE,CAAC;gBACzB,IAAI,IAAI,EAAE,CAAC;oBACT,UAAU,CAAC,KAAK,EAAE,CAAC;oBACnB,MAAM,CAAC,WAAW,EAAE,CAAC;gBACvB,CAAC;qBAAM,CAAC;oBACN,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,UAAU,CAAC,KAAK,CACd,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC,KAAK,CACxD,CAAC;gBACF,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,CAAC;oBAAS,CAAC;gBACT,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,MAAM;YACjB,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YACxE,CAAC;oBAAS,CAAC;gBACT,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,CAAC;QACH,CAAC;KACF,EACD,EAAE,aAAa,EAAE,CAAC,EAAE,CACrB,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,qEAAqE;AACrE,0DAA0D;AAC1D,yEAAyE;AACzE,yCAAyC;AACzC,SAAS,0BAA0B,CACjC,MAAmB;IAEnB,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACrC,OAAO,IAAI,cAAc,CAAa;QACpC,KAAK,CAAC,UAAU;YACd,IAAI,KAAK,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;gBACzB,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;YACD,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["// A native HTTP bridge can have a successful buffered response with no body\n// stream. Both transports retain the sign-in until the consumer reads a chunk.\nexport async function blobDownloadBody(\n response: Response,\n signal?: AbortSignal,\n redact = false,\n): Promise<ReadableStream<Uint8Array>> {\n const stream =\n response.body ?? bufferedResponseBodyStream(await response.arrayBuffer());\n if (!signal && !redact) return stream;\n const reader = stream.getReader();\n function cancelRetired() {\n void reader.cancel().catch(() => {});\n }\n return new ReadableStream<Uint8Array>(\n {\n async pull(controller) {\n signal?.addEventListener(\"abort\", cancelRetired, { once: true });\n try {\n if (signal?.aborted) cancelRetired();\n signal?.throwIfAborted();\n const { done, value } = await reader.read();\n signal?.throwIfAborted();\n if (done) {\n controller.close();\n reader.releaseLock();\n } else {\n controller.enqueue(value);\n }\n } catch (error) {\n controller.error(\n redact ? new Error(\"Blob download interrupted\") : error,\n );\n reader.releaseLock();\n } finally {\n signal?.removeEventListener(\"abort\", cancelRetired);\n }\n },\n async cancel(reason) {\n try {\n await reader.cancel(reason);\n } catch (error) {\n throw redact ? new Error(\"Blob download cancellation failed\") : error;\n } finally {\n reader.releaseLock();\n }\n },\n },\n { highWaterMark: 0 },\n );\n}\n\n// Wraps a fully-buffered response body as a single-chunk ReadableStream, so a\n// native HTTP bridge that only exposes the buffered bytes (no WHATWG\n// `response.body` stream) can still satisfy the streaming\n// `BlobBytesResponse.encryptedBytes` contract. An empty buffer yields an\n// immediately-closed, zero-chunk stream.\nfunction bufferedResponseBodyStream(\n buffer: ArrayBuffer,\n): ReadableStream<Uint8Array> {\n const bytes = new Uint8Array(buffer);\n return new ReadableStream<Uint8Array>({\n start(controller) {\n if (bytes.byteLength > 0) {\n controller.enqueue(bytes);\n }\n controller.close();\n },\n });\n}\n"]}
@@ -1,4 +1,5 @@
1
1
  import { blobWireHeaderKeys, getBlobBytesOperation, getBlobDownloadOperation, } from "../../../validators/operation/index.js";
2
+ import { blobDownloadBody } from "./blobDownloadBody.js";
2
3
  import { storageFetchOptions } from "./storageFetchOptions.js";
3
4
  /** A server without download descriptors (404) still streams the blob. */
4
5
  function descriptorFailureFallback(transport, blobId, failure, options) {
@@ -15,6 +16,8 @@ export async function getBlobBytes(transport, blobId, downloadFetch = (url, init
15
16
  if (options.signal?.aborted)
16
17
  return null;
17
18
  const result = await transport.requestResult(getBlobDownloadOperation, { params: { blobId } }, { ...options, reportErrors: false });
19
+ if (options.signal?.aborted)
20
+ return null;
18
21
  if (!result.ok) {
19
22
  return descriptorFailureFallback(transport, blobId, result, options);
20
23
  }
@@ -57,7 +60,7 @@ async function fetchSignedBlob(descriptor, url, downloadFetch, options) {
57
60
  await response.body?.cancel().catch(() => { });
58
61
  return response.status === 403 ? "retry" : "fallback";
59
62
  }
60
- return await signedBlobResponse(descriptor, response);
63
+ return await signedBlobResponse(descriptor, response, options.signal);
61
64
  }
62
65
  catch {
63
66
  // The downstream SDK still verifies length, hash and authenticated
@@ -65,50 +68,14 @@ async function fetchSignedBlob(descriptor, url, downloadFetch, options) {
65
68
  return "retry";
66
69
  }
67
70
  }
68
- async function signedBlobResponse(descriptor, response) {
71
+ async function signedBlobResponse(descriptor, response, signal) {
69
72
  return {
70
73
  blobId: descriptor.blobId,
71
74
  byteLength: descriptor.byteLength,
72
75
  sha256: descriptor.sha256,
73
- encryptedBytes: response.body
74
- ? signedDownloadBodyStream(response.body)
75
- : bufferedResponseBodyStream(await response.arrayBuffer()),
76
+ encryptedBytes: await blobDownloadBody(response, signal, true),
76
77
  };
77
78
  }
78
- function signedDownloadBodyStream(stream) {
79
- const reader = stream.getReader();
80
- // Native network errors may contain the bearer URL. Keep failures generic
81
- // before downstream readers log them, without buffering or eager reads.
82
- return new ReadableStream({
83
- async pull(controller) {
84
- try {
85
- const { done, value } = await reader.read();
86
- if (done) {
87
- controller.close();
88
- reader.releaseLock();
89
- }
90
- else {
91
- controller.enqueue(value);
92
- }
93
- }
94
- catch {
95
- controller.error(new Error("Blob download interrupted"));
96
- reader.releaseLock();
97
- }
98
- },
99
- async cancel(reason) {
100
- try {
101
- await reader.cancel(reason);
102
- }
103
- catch {
104
- throw new Error("Blob download cancellation failed");
105
- }
106
- finally {
107
- reader.releaseLock();
108
- }
109
- },
110
- }, { highWaterMark: 0 });
111
- }
112
79
  async function getBlobStream(transport, blobId, options) {
113
80
  if (options.signal?.aborted)
114
81
  return null;
@@ -120,18 +87,9 @@ async function getBlobStream(transport, blobId, options) {
120
87
  }
121
88
  const { headers, response } = result;
122
89
  const byteLength = Number(headers[blobWireHeaderKeys.blobByteLength]);
123
- // On the browser / WKWebView-fetch path the body is streamed, so
124
- // `response.body` is a live ReadableStream. Under a native HTTP bridge
125
- // (CapacitorHttp — which the Capacitor iOS/Android builds enable so cross-origin
126
- // API requests reach the backend at all; the WKWebView's own fetch fails from
127
- // the app's https://localhost origin) the response is buffered natively and
128
- // `response.body` is null even for a valid 200. So take the bytes either way:
129
- // the stream when present, otherwise buffer the response and re-wrap it as a
130
- // one-shot ReadableStream so callers keep a single streaming interface. This
131
- // does not weaken validation — a truncated or corrupted body is still caught
132
- // downstream by the X-Tearleads-Blob-Sha256 integrity check; it only stops a
133
- // buffered-but-valid response from being rejected here as malformed.
134
- const encryptedBytes = response.body ?? bufferedResponseBodyStream(await response.arrayBuffer());
90
+ const encryptedBytes = await blobDownloadBody(response, options.signal);
91
+ if (options.signal?.aborted)
92
+ return null;
135
93
  return {
136
94
  blobId: headers[blobWireHeaderKeys.blobId],
137
95
  byteLength,
@@ -139,20 +97,4 @@ async function getBlobStream(transport, blobId, options) {
139
97
  sha256: headers[blobWireHeaderKeys.blobSha256],
140
98
  };
141
99
  }
142
- // Wraps a fully-buffered response body as a single-chunk ReadableStream, so a
143
- // native HTTP bridge that only exposes the buffered bytes (no WHATWG
144
- // `response.body` stream) can still satisfy the streaming
145
- // `BlobBytesResponse.encryptedBytes` contract. An empty buffer yields an
146
- // immediately-closed, zero-chunk stream.
147
- function bufferedResponseBodyStream(buffer) {
148
- const bytes = new Uint8Array(buffer);
149
- return new ReadableStream({
150
- start(controller) {
151
- if (bytes.byteLength > 0) {
152
- controller.enqueue(bytes);
153
- }
154
- controller.close();
155
- },
156
- });
157
- }
158
100
  //# sourceMappingURL=get.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"get.js","sourceRoot":"","sources":["get.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n blobWireHeaderKeys,\n getBlobBytesOperation,\n getBlobDownloadOperation,\n} from \"@tearleads/validators/operation\";\nimport type { MultipartBlobPartUploadSource } from \"@tearleads/validators/util\";\nimport type { BinaryResponseOperationTransport } from \"../../binaryResponseOperationTransport\";\nimport type { JsonOperationTransport } from \"../../operationTransport\";\nimport type {\n OperationResponseRequestFn,\n RequestFailure,\n RequestResultOptions,\n} from \"../../types\";\nimport { storageFetchOptions } from \"./storageFetchOptions\";\n\nexport interface BlobBytesResponse {\n readonly blobId: string;\n readonly byteLength: number;\n readonly encryptedBytes: ReadableStream<Uint8Array>;\n readonly sha256: string;\n}\n\nexport interface UploadMultipartBlobPartBytesRequest {\n readonly byteLength: number;\n readonly encryptedBytes: Blob | BufferSource;\n readonly sha256: string;\n /**\n * An upload source the stage initiation already issued for this part. The\n * first attempt uses it instead of authorizing; a failed attempt still\n * reauthorizes once, exactly as when no source was issued.\n */\n readonly source?: MultipartBlobPartUploadSource | undefined;\n readonly uploadId: string;\n}\n\ntype BlobDownloadTransport = Pick<JsonOperationTransport, \"requestResult\"> &\n Pick<BinaryResponseOperationTransport, \"requestBinaryResponse\"> &\n Pick<OperationResponseRequestFn, \"reportFailure\">;\n\ntype DownloadFetch = (url: string, init: RequestInit) => Promise<Response>;\n\n/** A server without download descriptors (404) still streams the blob. */\nfunction descriptorFailureFallback(\n transport: BlobDownloadTransport,\n blobId: string,\n failure: RequestFailure,\n options: RequestResultOptions,\n): Promise<BlobBytesResponse | null> | null {\n if (failure.kind === \"http\" && failure.status === 404) {\n return getBlobStream(transport, blobId, options);\n }\n failure.report();\n return null;\n}\n\nexport async function getBlobBytes(\n transport: BlobDownloadTransport,\n blobId: string,\n downloadFetch: DownloadFetch = (url, init) => fetch(url, init),\n options: RequestResultOptions = {},\n): Promise<BlobBytesResponse | null> {\n // Refresh at most once. R2 expiration errors can appear as CORS/network\n // failures in browsers, so both rejected fetches and 403s need a fresh URL.\n for (let attempt = 0; attempt < 2; attempt += 1) {\n if (options.signal?.aborted) return null;\n const result = await transport.requestResult(\n getBlobDownloadOperation,\n { params: { blobId } },\n { ...options, reportErrors: false },\n );\n if (!result.ok) {\n return descriptorFailureFallback(transport, blobId, result, options);\n }\n const descriptor = result.data;\n if (descriptor.blobId !== blobId) {\n transport.reportFailure({\n kind: \"shape\",\n method: \"GET\",\n path: `/blobs/${blobId}/download`,\n status: 200,\n statusText: \"\",\n message: `Blob ${blobId} download descriptor has the wrong identity`,\n });\n return null;\n }\n if (descriptor.source.kind === \"api\") {\n return getBlobStream(transport, blobId, options);\n }\n const outcome = await fetchSignedBlob(\n descriptor,\n descriptor.source.url,\n downloadFetch,\n options,\n );\n if (outcome === \"fallback\") break;\n if (outcome !== \"retry\") return outcome;\n }\n // Preserve downloads when storage is unreachable or a native HTTP bridge\n // cannot use the signed URL. This endpoint checks current access again.\n // A storage failure alone must not signal that the API is offline.\n return getBlobStream(transport, blobId, options);\n}\n\n/**\n * One signed-URL attempt: the bytes, `\"retry\"` with a fresh URL (403 or a\n * rejected fetch), or `\"fallback\"` to the API stream (any other status).\n */\nasync function fetchSignedBlob(\n descriptor: Pick<BlobBytesResponse, \"blobId\" | \"byteLength\" | \"sha256\">,\n url: string,\n downloadFetch: DownloadFetch,\n options: RequestResultOptions,\n): Promise<BlobBytesResponse | \"retry\" | \"fallback\"> {\n try {\n // Never send the application's session or cookies to the object store.\n // Reject redirects and keep bearer URLs out of referrers and errors.\n const response = await downloadFetch(url, storageFetchOptions(options));\n if (response.status !== 200) {\n await response.body?.cancel().catch(() => {});\n return response.status === 403 ? \"retry\" : \"fallback\";\n }\n return await signedBlobResponse(descriptor, response);\n } catch {\n // The downstream SDK still verifies length, hash and authenticated\n // encryption. An error after streaming begins propagates to that reader.\n return \"retry\";\n }\n}\n\nasync function signedBlobResponse(\n descriptor: Pick<BlobBytesResponse, \"blobId\" | \"byteLength\" | \"sha256\">,\n response: Response,\n): Promise<BlobBytesResponse> {\n return {\n blobId: descriptor.blobId,\n byteLength: descriptor.byteLength,\n sha256: descriptor.sha256,\n encryptedBytes: response.body\n ? signedDownloadBodyStream(response.body)\n : bufferedResponseBodyStream(await response.arrayBuffer()),\n };\n}\n\nfunction signedDownloadBodyStream(\n stream: ReadableStream<Uint8Array>,\n): ReadableStream<Uint8Array> {\n const reader = stream.getReader();\n // Native network errors may contain the bearer URL. Keep failures generic\n // before downstream readers log them, without buffering or eager reads.\n return new ReadableStream<Uint8Array>(\n {\n async pull(controller) {\n try {\n const { done, value } = await reader.read();\n if (done) {\n controller.close();\n reader.releaseLock();\n } else {\n controller.enqueue(value);\n }\n } catch {\n controller.error(new Error(\"Blob download interrupted\"));\n reader.releaseLock();\n }\n },\n async cancel(reason) {\n try {\n await reader.cancel(reason);\n } catch {\n throw new Error(\"Blob download cancellation failed\");\n } finally {\n reader.releaseLock();\n }\n },\n },\n { highWaterMark: 0 },\n );\n}\n\nasync function getBlobStream(\n transport: Pick<BinaryResponseOperationTransport, \"requestBinaryResponse\">,\n blobId: string,\n options: RequestResultOptions,\n): Promise<BlobBytesResponse | null> {\n if (options.signal?.aborted) return null;\n const result = await transport.requestBinaryResponse(\n getBlobBytesOperation,\n {\n params: { blobId },\n },\n options,\n );\n if (!result) {\n return null;\n }\n\n const { headers, response } = result;\n const byteLength = Number(headers[blobWireHeaderKeys.blobByteLength]);\n\n // On the browser / WKWebView-fetch path the body is streamed, so\n // `response.body` is a live ReadableStream. Under a native HTTP bridge\n // (CapacitorHttp — which the Capacitor iOS/Android builds enable so cross-origin\n // API requests reach the backend at all; the WKWebView's own fetch fails from\n // the app's https://localhost origin) the response is buffered natively and\n // `response.body` is null even for a valid 200. So take the bytes either way:\n // the stream when present, otherwise buffer the response and re-wrap it as a\n // one-shot ReadableStream so callers keep a single streaming interface. This\n // does not weaken validation — a truncated or corrupted body is still caught\n // downstream by the X-Tearleads-Blob-Sha256 integrity check; it only stops a\n // buffered-but-valid response from being rejected here as malformed.\n const encryptedBytes =\n response.body ?? bufferedResponseBodyStream(await response.arrayBuffer());\n\n return {\n blobId: headers[blobWireHeaderKeys.blobId],\n byteLength,\n encryptedBytes,\n sha256: headers[blobWireHeaderKeys.blobSha256],\n };\n}\n\n// Wraps a fully-buffered response body as a single-chunk ReadableStream, so a\n// native HTTP bridge that only exposes the buffered bytes (no WHATWG\n// `response.body` stream) can still satisfy the streaming\n// `BlobBytesResponse.encryptedBytes` contract. An empty buffer yields an\n// immediately-closed, zero-chunk stream.\nfunction bufferedResponseBodyStream(\n buffer: ArrayBuffer,\n): ReadableStream<Uint8Array> {\n const bytes = new Uint8Array(buffer);\n return new ReadableStream<Uint8Array>({\n start(controller) {\n if (bytes.byteLength > 0) {\n controller.enqueue(bytes);\n }\n controller.close();\n },\n });\n}\n"]}
1
+ {"version":3,"file":"get.js","sourceRoot":"","sources":["get.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n blobWireHeaderKeys,\n getBlobBytesOperation,\n getBlobDownloadOperation,\n} from \"@tearleads/validators/operation\";\nimport type { MultipartBlobPartUploadSource } from \"@tearleads/validators/util\";\nimport type { BinaryResponseOperationTransport } from \"../../binaryResponseOperationTransport\";\nimport type { JsonOperationTransport } from \"../../operationTransport\";\nimport type {\n OperationResponseRequestFn,\n RequestFailure,\n RequestResultOptions,\n} from \"../../types\";\nimport { blobDownloadBody } from \"./blobDownloadBody\";\nimport { storageFetchOptions } from \"./storageFetchOptions\";\n\nexport interface BlobBytesResponse {\n readonly blobId: string;\n readonly byteLength: number;\n readonly encryptedBytes: ReadableStream<Uint8Array>;\n readonly sha256: string;\n}\n\nexport interface UploadMultipartBlobPartBytesRequest {\n readonly byteLength: number;\n readonly encryptedBytes: Blob | BufferSource;\n readonly sha256: string;\n /**\n * An upload source the stage initiation already issued for this part. The\n * first attempt uses it instead of authorizing; a failed attempt still\n * reauthorizes once, exactly as when no source was issued.\n */\n readonly source?: MultipartBlobPartUploadSource | undefined;\n readonly uploadId: string;\n}\n\ntype BlobDownloadTransport = Pick<JsonOperationTransport, \"requestResult\"> &\n Pick<BinaryResponseOperationTransport, \"requestBinaryResponse\"> &\n Pick<OperationResponseRequestFn, \"reportFailure\">;\n\ntype DownloadFetch = (url: string, init: RequestInit) => Promise<Response>;\n\n/** A server without download descriptors (404) still streams the blob. */\nfunction descriptorFailureFallback(\n transport: BlobDownloadTransport,\n blobId: string,\n failure: RequestFailure,\n options: RequestResultOptions,\n): Promise<BlobBytesResponse | null> | null {\n if (failure.kind === \"http\" && failure.status === 404) {\n return getBlobStream(transport, blobId, options);\n }\n failure.report();\n return null;\n}\n\nexport async function getBlobBytes(\n transport: BlobDownloadTransport,\n blobId: string,\n downloadFetch: DownloadFetch = (url, init) => fetch(url, init),\n options: RequestResultOptions = {},\n): Promise<BlobBytesResponse | null> {\n // Refresh at most once. R2 expiration errors can appear as CORS/network\n // failures in browsers, so both rejected fetches and 403s need a fresh URL.\n for (let attempt = 0; attempt < 2; attempt += 1) {\n if (options.signal?.aborted) return null;\n const result = await transport.requestResult(\n getBlobDownloadOperation,\n { params: { blobId } },\n { ...options, reportErrors: false },\n );\n if (options.signal?.aborted) return null;\n if (!result.ok) {\n return descriptorFailureFallback(transport, blobId, result, options);\n }\n const descriptor = result.data;\n if (descriptor.blobId !== blobId) {\n transport.reportFailure({\n kind: \"shape\",\n method: \"GET\",\n path: `/blobs/${blobId}/download`,\n status: 200,\n statusText: \"\",\n message: `Blob ${blobId} download descriptor has the wrong identity`,\n });\n return null;\n }\n if (descriptor.source.kind === \"api\") {\n return getBlobStream(transport, blobId, options);\n }\n const outcome = await fetchSignedBlob(\n descriptor,\n descriptor.source.url,\n downloadFetch,\n options,\n );\n if (outcome === \"fallback\") break;\n if (outcome !== \"retry\") return outcome;\n }\n // Preserve downloads when storage is unreachable or a native HTTP bridge\n // cannot use the signed URL. This endpoint checks current access again.\n // A storage failure alone must not signal that the API is offline.\n return getBlobStream(transport, blobId, options);\n}\n\n/**\n * One signed-URL attempt: the bytes, `\"retry\"` with a fresh URL (403 or a\n * rejected fetch), or `\"fallback\"` to the API stream (any other status).\n */\nasync function fetchSignedBlob(\n descriptor: Pick<BlobBytesResponse, \"blobId\" | \"byteLength\" | \"sha256\">,\n url: string,\n downloadFetch: DownloadFetch,\n options: RequestResultOptions,\n): Promise<BlobBytesResponse | \"retry\" | \"fallback\"> {\n try {\n // Never send the application's session or cookies to the object store.\n // Reject redirects and keep bearer URLs out of referrers and errors.\n const response = await downloadFetch(url, storageFetchOptions(options));\n if (response.status !== 200) {\n await response.body?.cancel().catch(() => {});\n return response.status === 403 ? \"retry\" : \"fallback\";\n }\n return await signedBlobResponse(descriptor, response, options.signal);\n } catch {\n // The downstream SDK still verifies length, hash and authenticated\n // encryption. An error after streaming begins propagates to that reader.\n return \"retry\";\n }\n}\n\nasync function signedBlobResponse(\n descriptor: Pick<BlobBytesResponse, \"blobId\" | \"byteLength\" | \"sha256\">,\n response: Response,\n signal: AbortSignal | undefined,\n): Promise<BlobBytesResponse> {\n return {\n blobId: descriptor.blobId,\n byteLength: descriptor.byteLength,\n sha256: descriptor.sha256,\n encryptedBytes: await blobDownloadBody(response, signal, true),\n };\n}\n\nasync function getBlobStream(\n transport: Pick<BinaryResponseOperationTransport, \"requestBinaryResponse\">,\n blobId: string,\n options: RequestResultOptions,\n): Promise<BlobBytesResponse | null> {\n if (options.signal?.aborted) return null;\n const result = await transport.requestBinaryResponse(\n getBlobBytesOperation,\n {\n params: { blobId },\n },\n options,\n );\n if (!result) {\n return null;\n }\n\n const { headers, response } = result;\n const byteLength = Number(headers[blobWireHeaderKeys.blobByteLength]);\n\n const encryptedBytes = await blobDownloadBody(response, options.signal);\n\n if (options.signal?.aborted) return null;\n return {\n blobId: headers[blobWireHeaderKeys.blobId],\n byteLength,\n encryptedBytes,\n sha256: headers[blobWireHeaderKeys.blobSha256],\n };\n}\n"]}
@@ -147,7 +147,7 @@ export async function uploadMultipartBlobPartBytes(transport, stageId, partNumbe
147
147
  return null;
148
148
  const source = firstAttemptSource(attempt, input.source) ??
149
149
  (await authorizePart(context));
150
- if (!source)
150
+ if (!source || options.signal?.aborted)
151
151
  return null;
152
152
  if (source.kind === "api")
153
153
  return uploadThroughApi(context, file);
@@ -1 +1 @@
1
- {"version":3,"file":"multipartUpload.js","sourceRoot":"","sources":["multipartUpload.ts"],"names":[],"mappings":"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","sourcesContent":["import { md5 } from \"@noble/hashes/legacy.js\";\nimport { bytesToHex } from \"@tearleads/crypto\";\nimport {\n authorizeMultipartBlobPartUploadOperation,\n blobWireHeaderKeys,\n operationRequestPath,\n uploadMultipartBlobPartBytesOperation,\n} from \"@tearleads/validators/operation\";\nimport type { UploadMultipartBlobPartResponse } from \"@tearleads/validators/response\";\nimport {\n MAX_MULTIPART_BLOB_PART_BYTES,\n type MultipartBlobPartDescriptor,\n type MultipartBlobPartUploadSource,\n} from \"@tearleads/validators/util\";\nimport type { OperationTransport } from \"../../operationTransportFactory\";\nimport type { RequestResultOptions } from \"../../types\";\nimport type { UploadMultipartBlobPartBytesRequest } from \"./get\";\nimport { storageFetchOptions } from \"./storageFetchOptions\";\n\ntype UploadFetch = (url: string, init: RequestInit) => Promise<Response>;\n\nfunction invalidPart(transport: OperationTransport, path: string) {\n transport.reportFailure({\n kind: \"shape\",\n method: authorizeMultipartBlobPartUploadOperation.method,\n path,\n status: null,\n statusText: \"\",\n message: \"Multipart part bytes do not match the declared length or SHA-256\",\n });\n return null;\n}\n\nasync function retryStorageStatus(status: number, attempt: number) {\n if (status === 403) return true;\n const transient = status === 429 || (status >= 500 && status <= 599);\n if (transient && attempt === 0) {\n await new Promise<void>((resolve) => setTimeout(resolve, 250));\n }\n return transient;\n}\n\nfunction contentMd5Base64(bytes: Uint8Array): string {\n return btoa(String.fromCharCode(...md5(bytes)));\n}\n\n/**\n * Describe an encrypted part the way a stage initiation lists the parts it\n * will send first: number, exact length, and the Content-MD5 a signed upload\n * URL binds.\n */\nexport function describeMultipartBlobPart(\n partNumber: number,\n encryptedBytes: Uint8Array,\n): MultipartBlobPartDescriptor {\n return {\n byteLength: encryptedBytes.byteLength,\n contentMd5: contentMd5Base64(encryptedBytes),\n partNumber,\n };\n}\n\nasync function preparePart(input: UploadMultipartBlobPartBytesRequest) {\n // File snapshots mutable buffers and preserves ciphertext across Capacitor's\n // native HTTP bridge. Uint8Array is UTF-8 decoded there; a plain Blob becomes\n // JSON. File's base64 bridge path is byte-for-byte, including non-UTF-8 data.\n const file =\n input.encryptedBytes instanceof File\n ? input.encryptedBytes\n : new File([input.encryptedBytes], \"encrypted-blob-part\", {\n type: \"application/octet-stream\",\n });\n if (\n file.size !== input.byteLength ||\n file.size < 1 ||\n file.size > MAX_MULTIPART_BLOB_PART_BYTES\n ) {\n throw new TypeError(\"Invalid multipart part byte length\");\n }\n const bytes = await file.arrayBuffer();\n if (\n bytesToHex(new Uint8Array(await crypto.subtle.digest(\"SHA-256\", bytes))) !==\n input.sha256\n ) {\n throw new TypeError(\"Multipart part SHA-256 does not match its bytes\");\n }\n return { file, contentMd5: contentMd5Base64(new Uint8Array(bytes)) };\n}\n\ninterface PartUploadContext {\n readonly contentMd5: string;\n readonly input: UploadMultipartBlobPartBytesRequest;\n readonly options: RequestResultOptions;\n readonly partNumber: number;\n readonly path: string;\n readonly stageId: string;\n readonly transport: OperationTransport;\n}\n\n// Sign just in time for this part. The returned descriptor must name exactly\n// the part, upload, length, and checksum that were requested.\nasync function authorizePart(\n context: PartUploadContext,\n): Promise<MultipartBlobPartUploadSource | null> {\n const operation = authorizeMultipartBlobPartUploadOperation;\n const { input, partNumber, stageId } = context;\n const result = await context.transport.requestResult(\n operation,\n {\n params: { stageId, partNumber },\n body: {\n byteLength: input.byteLength,\n contentMd5: context.contentMd5,\n uploadId: input.uploadId,\n },\n },\n context.options,\n );\n if (!result.ok) return null;\n const descriptor = result.data;\n if (\n descriptor.stageId !== stageId ||\n descriptor.uploadId !== input.uploadId ||\n descriptor.partNumber !== partNumber ||\n descriptor.byteLength !== input.byteLength ||\n descriptor.contentMd5 !== context.contentMd5\n ) {\n context.transport.reportFailure({\n kind: \"shape\",\n method: operation.method,\n path: context.path,\n status: 200,\n statusText: \"\",\n message: \"Multipart upload descriptor does not match its part\",\n });\n return null;\n }\n return descriptor.source;\n}\n\n// Parts can wait behind other transfers in the shared pool. An issued URL that\n// is about to lapse would only spend this part's retry on a certain 403, so\n// authorize afresh instead; a skewed clock errs toward authorizing.\nconst ISSUED_URL_MIN_REMAINING_MS = 30_000;\n\nfunction isUsableIssuedSource(\n source: MultipartBlobPartUploadSource | undefined,\n): source is MultipartBlobPartUploadSource {\n return (\n source !== undefined &&\n (source.kind === \"api\" ||\n Date.parse(source.expiresAt) - Date.now() > ISSUED_URL_MIN_REMAINING_MS)\n );\n}\n\n// A capability path for memory/custom stores; S3/R2 never proxy parts.\nfunction uploadThroughApi(context: PartUploadContext, file: File) {\n const { input } = context;\n return context.transport.requestBinaryRequest(\n uploadMultipartBlobPartBytesOperation,\n {\n params: { stageId: context.stageId, partNumber: context.partNumber },\n body: input.encryptedBytes,\n headers: {\n [blobWireHeaderKeys.partByteLength]: input.byteLength.toString(),\n [blobWireHeaderKeys.partSha256]: input.sha256,\n [blobWireHeaderKeys.partUploadId]: input.uploadId,\n },\n },\n { ...context.options, encodeBody: () => file },\n );\n}\n\nfunction firstAttemptSource(\n attempt: number,\n source: MultipartBlobPartUploadSource | undefined,\n): MultipartBlobPartUploadSource | null {\n return attempt === 0 && isUsableIssuedSource(source) ? source : null;\n}\n\nexport async function uploadMultipartBlobPartBytes(\n transport: OperationTransport,\n stageId: string,\n partNumber: number,\n input: UploadMultipartBlobPartBytesRequest,\n uploadFetch: UploadFetch = (url, init) => fetch(url, init),\n options: RequestResultOptions = {},\n): Promise<UploadMultipartBlobPartResponse | null> {\n if (options.signal?.aborted) return null;\n const path = operationRequestPath(authorizeMultipartBlobPartUploadOperation, {\n stageId,\n partNumber,\n });\n const prepared = await preparePart(input).catch(() =>\n invalidPart(transport, path),\n );\n if (!prepared) return null;\n const { file, contentMd5 } = prepared;\n const context: PartUploadContext = {\n contentMd5,\n input,\n options,\n partNumber,\n path,\n stageId,\n transport,\n };\n let status: number | null = null;\n // The first attempt uses the source the stage initiation issued, if any. A\n // network failure may be an expired URL hidden by R2 CORS, or a lost success\n // response; reauthorize once and send the same immutable bytes to the same\n // part number.\n for (let attempt = 0; attempt < 2; attempt += 1) {\n if (options.signal?.aborted) return null;\n const source =\n firstAttemptSource(attempt, input.source) ??\n (await authorizePart(context));\n if (!source) return null;\n if (source.kind === \"api\") return uploadThroughApi(context, file);\n const outcome = await putStoragePart(\n context,\n file,\n source.url,\n uploadFetch,\n attempt,\n );\n if (outcome.kind === \"uploaded\") return outcome.response;\n status = outcome.status;\n if (!outcome.retry) break;\n }\n reportStorageFailureUnlessAborted(context, status);\n return null;\n}\n\nfunction reportStorageFailureUnlessAborted(\n context: PartUploadContext,\n status: number | null,\n): void {\n if (context.options.signal?.aborted) return;\n reportStorageFailure(\n context.transport,\n context.path,\n context.partNumber,\n status,\n );\n}\n\ntype StoragePartAttempt =\n | {\n readonly kind: \"uploaded\";\n readonly response: UploadMultipartBlobPartResponse;\n }\n | {\n readonly kind: \"failed\";\n readonly retry: boolean;\n readonly status: number | null;\n };\n\nasync function putStoragePart(\n context: PartUploadContext,\n file: File,\n url: string,\n uploadFetch: UploadFetch,\n attempt: number,\n): Promise<StoragePartAttempt> {\n const { input, partNumber } = context;\n try {\n const response = await uploadFetch(url, {\n method: \"PUT\",\n body: file,\n headers: {\n \"Content-Type\": \"application/octet-stream\",\n \"Content-MD5\": context.contentMd5,\n },\n ...storageFetchOptions(context.options),\n });\n const status = response.status;\n const etag = response.headers.get(\"ETag\")?.trim();\n await response.body?.cancel().catch(() => {});\n if (status === 200 && etag) {\n return {\n kind: \"uploaded\",\n response: {\n stageId: context.stageId,\n uploadId: input.uploadId,\n part: { byteLength: input.byteLength, partNumber, etag },\n },\n };\n }\n const retry = await retryStorageStatus(status, attempt);\n return { kind: \"failed\", retry, status };\n } catch {\n // Never expose a provider exception or body: it may contain the bearer URL.\n return { kind: \"failed\", retry: true, status: null };\n }\n}\n\nfunction reportStorageFailure(\n transport: OperationTransport,\n path: string,\n partNumber: number,\n status: number | null,\n) {\n transport.reportFailure({\n kind: \"storage\",\n method: authorizeMultipartBlobPartUploadOperation.method,\n path,\n status,\n statusText: \"\",\n message:\n status === 200\n ? `Multipart part ${partNumber} storage response is missing ETag; check storage CORS exposure`\n : `Multipart part ${partNumber} storage upload failed${status === null ? \"\" : ` (HTTP ${status})`}`,\n });\n}\n"]}
1
+ {"version":3,"file":"multipartUpload.js","sourceRoot":"","sources":["multipartUpload.ts"],"names":[],"mappings":"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","sourcesContent":["import { md5 } from \"@noble/hashes/legacy.js\";\nimport { bytesToHex } from \"@tearleads/crypto\";\nimport {\n authorizeMultipartBlobPartUploadOperation,\n blobWireHeaderKeys,\n operationRequestPath,\n uploadMultipartBlobPartBytesOperation,\n} from \"@tearleads/validators/operation\";\nimport type { UploadMultipartBlobPartResponse } from \"@tearleads/validators/response\";\nimport {\n MAX_MULTIPART_BLOB_PART_BYTES,\n type MultipartBlobPartDescriptor,\n type MultipartBlobPartUploadSource,\n} from \"@tearleads/validators/util\";\nimport type { OperationTransport } from \"../../operationTransportFactory\";\nimport type { RequestResultOptions } from \"../../types\";\nimport type { UploadMultipartBlobPartBytesRequest } from \"./get\";\nimport { storageFetchOptions } from \"./storageFetchOptions\";\n\ntype UploadFetch = (url: string, init: RequestInit) => Promise<Response>;\n\nfunction invalidPart(transport: OperationTransport, path: string) {\n transport.reportFailure({\n kind: \"shape\",\n method: authorizeMultipartBlobPartUploadOperation.method,\n path,\n status: null,\n statusText: \"\",\n message: \"Multipart part bytes do not match the declared length or SHA-256\",\n });\n return null;\n}\n\nasync function retryStorageStatus(status: number, attempt: number) {\n if (status === 403) return true;\n const transient = status === 429 || (status >= 500 && status <= 599);\n if (transient && attempt === 0) {\n await new Promise<void>((resolve) => setTimeout(resolve, 250));\n }\n return transient;\n}\n\nfunction contentMd5Base64(bytes: Uint8Array): string {\n return btoa(String.fromCharCode(...md5(bytes)));\n}\n\n/**\n * Describe an encrypted part the way a stage initiation lists the parts it\n * will send first: number, exact length, and the Content-MD5 a signed upload\n * URL binds.\n */\nexport function describeMultipartBlobPart(\n partNumber: number,\n encryptedBytes: Uint8Array,\n): MultipartBlobPartDescriptor {\n return {\n byteLength: encryptedBytes.byteLength,\n contentMd5: contentMd5Base64(encryptedBytes),\n partNumber,\n };\n}\n\nasync function preparePart(input: UploadMultipartBlobPartBytesRequest) {\n // File snapshots mutable buffers and preserves ciphertext across Capacitor's\n // native HTTP bridge. Uint8Array is UTF-8 decoded there; a plain Blob becomes\n // JSON. File's base64 bridge path is byte-for-byte, including non-UTF-8 data.\n const file =\n input.encryptedBytes instanceof File\n ? input.encryptedBytes\n : new File([input.encryptedBytes], \"encrypted-blob-part\", {\n type: \"application/octet-stream\",\n });\n if (\n file.size !== input.byteLength ||\n file.size < 1 ||\n file.size > MAX_MULTIPART_BLOB_PART_BYTES\n ) {\n throw new TypeError(\"Invalid multipart part byte length\");\n }\n const bytes = await file.arrayBuffer();\n if (\n bytesToHex(new Uint8Array(await crypto.subtle.digest(\"SHA-256\", bytes))) !==\n input.sha256\n ) {\n throw new TypeError(\"Multipart part SHA-256 does not match its bytes\");\n }\n return { file, contentMd5: contentMd5Base64(new Uint8Array(bytes)) };\n}\n\ninterface PartUploadContext {\n readonly contentMd5: string;\n readonly input: UploadMultipartBlobPartBytesRequest;\n readonly options: RequestResultOptions;\n readonly partNumber: number;\n readonly path: string;\n readonly stageId: string;\n readonly transport: OperationTransport;\n}\n\n// Sign just in time for this part. The returned descriptor must name exactly\n// the part, upload, length, and checksum that were requested.\nasync function authorizePart(\n context: PartUploadContext,\n): Promise<MultipartBlobPartUploadSource | null> {\n const operation = authorizeMultipartBlobPartUploadOperation;\n const { input, partNumber, stageId } = context;\n const result = await context.transport.requestResult(\n operation,\n {\n params: { stageId, partNumber },\n body: {\n byteLength: input.byteLength,\n contentMd5: context.contentMd5,\n uploadId: input.uploadId,\n },\n },\n context.options,\n );\n if (!result.ok) return null;\n const descriptor = result.data;\n if (\n descriptor.stageId !== stageId ||\n descriptor.uploadId !== input.uploadId ||\n descriptor.partNumber !== partNumber ||\n descriptor.byteLength !== input.byteLength ||\n descriptor.contentMd5 !== context.contentMd5\n ) {\n context.transport.reportFailure({\n kind: \"shape\",\n method: operation.method,\n path: context.path,\n status: 200,\n statusText: \"\",\n message: \"Multipart upload descriptor does not match its part\",\n });\n return null;\n }\n return descriptor.source;\n}\n\n// Parts can wait behind other transfers in the shared pool. An issued URL that\n// is about to lapse would only spend this part's retry on a certain 403, so\n// authorize afresh instead; a skewed clock errs toward authorizing.\nconst ISSUED_URL_MIN_REMAINING_MS = 30_000;\n\nfunction isUsableIssuedSource(\n source: MultipartBlobPartUploadSource | undefined,\n): source is MultipartBlobPartUploadSource {\n return (\n source !== undefined &&\n (source.kind === \"api\" ||\n Date.parse(source.expiresAt) - Date.now() > ISSUED_URL_MIN_REMAINING_MS)\n );\n}\n\n// A capability path for memory/custom stores; S3/R2 never proxy parts.\nfunction uploadThroughApi(context: PartUploadContext, file: File) {\n const { input } = context;\n return context.transport.requestBinaryRequest(\n uploadMultipartBlobPartBytesOperation,\n {\n params: { stageId: context.stageId, partNumber: context.partNumber },\n body: input.encryptedBytes,\n headers: {\n [blobWireHeaderKeys.partByteLength]: input.byteLength.toString(),\n [blobWireHeaderKeys.partSha256]: input.sha256,\n [blobWireHeaderKeys.partUploadId]: input.uploadId,\n },\n },\n { ...context.options, encodeBody: () => file },\n );\n}\n\nfunction firstAttemptSource(\n attempt: number,\n source: MultipartBlobPartUploadSource | undefined,\n): MultipartBlobPartUploadSource | null {\n return attempt === 0 && isUsableIssuedSource(source) ? source : null;\n}\n\nexport async function uploadMultipartBlobPartBytes(\n transport: OperationTransport,\n stageId: string,\n partNumber: number,\n input: UploadMultipartBlobPartBytesRequest,\n uploadFetch: UploadFetch = (url, init) => fetch(url, init),\n options: RequestResultOptions = {},\n): Promise<UploadMultipartBlobPartResponse | null> {\n if (options.signal?.aborted) return null;\n const path = operationRequestPath(authorizeMultipartBlobPartUploadOperation, {\n stageId,\n partNumber,\n });\n const prepared = await preparePart(input).catch(() =>\n invalidPart(transport, path),\n );\n if (!prepared) return null;\n const { file, contentMd5 } = prepared;\n const context: PartUploadContext = {\n contentMd5,\n input,\n options,\n partNumber,\n path,\n stageId,\n transport,\n };\n let status: number | null = null;\n // The first attempt uses the source the stage initiation issued, if any. A\n // network failure may be an expired URL hidden by R2 CORS, or a lost success\n // response; reauthorize once and send the same immutable bytes to the same\n // part number.\n for (let attempt = 0; attempt < 2; attempt += 1) {\n if (options.signal?.aborted) return null;\n const source =\n firstAttemptSource(attempt, input.source) ??\n (await authorizePart(context));\n if (!source || options.signal?.aborted) return null;\n if (source.kind === \"api\") return uploadThroughApi(context, file);\n const outcome = await putStoragePart(\n context,\n file,\n source.url,\n uploadFetch,\n attempt,\n );\n if (outcome.kind === \"uploaded\") return outcome.response;\n status = outcome.status;\n if (!outcome.retry) break;\n }\n reportStorageFailureUnlessAborted(context, status);\n return null;\n}\n\nfunction reportStorageFailureUnlessAborted(\n context: PartUploadContext,\n status: number | null,\n): void {\n if (context.options.signal?.aborted) return;\n reportStorageFailure(\n context.transport,\n context.path,\n context.partNumber,\n status,\n );\n}\n\ntype StoragePartAttempt =\n | {\n readonly kind: \"uploaded\";\n readonly response: UploadMultipartBlobPartResponse;\n }\n | {\n readonly kind: \"failed\";\n readonly retry: boolean;\n readonly status: number | null;\n };\n\nasync function putStoragePart(\n context: PartUploadContext,\n file: File,\n url: string,\n uploadFetch: UploadFetch,\n attempt: number,\n): Promise<StoragePartAttempt> {\n const { input, partNumber } = context;\n try {\n const response = await uploadFetch(url, {\n method: \"PUT\",\n body: file,\n headers: {\n \"Content-Type\": \"application/octet-stream\",\n \"Content-MD5\": context.contentMd5,\n },\n ...storageFetchOptions(context.options),\n });\n const status = response.status;\n const etag = response.headers.get(\"ETag\")?.trim();\n await response.body?.cancel().catch(() => {});\n if (status === 200 && etag) {\n return {\n kind: \"uploaded\",\n response: {\n stageId: context.stageId,\n uploadId: input.uploadId,\n part: { byteLength: input.byteLength, partNumber, etag },\n },\n };\n }\n const retry = await retryStorageStatus(status, attempt);\n return { kind: \"failed\", retry, status };\n } catch {\n // Never expose a provider exception or body: it may contain the bearer URL.\n return { kind: \"failed\", retry: true, status: null };\n }\n}\n\nfunction reportStorageFailure(\n transport: OperationTransport,\n path: string,\n partNumber: number,\n status: number | null,\n) {\n transport.reportFailure({\n kind: \"storage\",\n method: authorizeMultipartBlobPartUploadOperation.method,\n path,\n status,\n statusText: \"\",\n message:\n status === 200\n ? `Multipart part ${partNumber} storage response is missing ETag; check storage CORS exposure`\n : `Multipart part ${partNumber} storage upload failed${status === null ? \"\" : ` (HTTP ${status})`}`,\n });\n}\n"]}
@@ -24,7 +24,7 @@ function concurrentRenewal(input, authToken) {
24
24
  * ends: the renewal is shared with other requests and keeps running, and a
25
25
  * rejection it settles with later is still delivered to them.
26
26
  */
27
- function renewalUnlessAborted(renewal, signal) {
27
+ export function renewalUnlessAborted(renewal, signal) {
28
28
  if (!signal)
29
29
  return Promise.resolve(renewal);
30
30
  // Starting the renewal can abort the signal before a listener exists. The
@@ -1 +1 @@
1
- {"version":3,"file":"sessionRefresh.js","sourceRoot":"","sources":["sessionRefresh.ts"],"names":[],"mappings":"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","sourcesContent":["import { KeyingVerificationError } from \"@tearleads/crypto\";\nimport {\n errorMessage,\n isRefreshableSessionError,\n isReplayableRequestBody,\n} from \"./requestInternals\";\nimport type { RequestBody, RequestResultOptions } from \"./types\";\n\ninterface SessionRefreshInput {\n readonly authToken: string | null;\n readonly body: RequestBody | undefined;\n readonly code: string | null;\n readonly getCurrentAuthToken: () => string | null;\n readonly isKnownSessionRenewal: (from: string, to: string) => boolean;\n readonly options: RequestResultOptions;\n readonly pendingSessionRenewal: (from: string) => Promise<boolean> | null;\n readonly refreshSession: () => boolean | Promise<boolean>;\n readonly reportError: (message: string) => void;\n readonly responseStatus: number;\n}\n\n/**\n * Checks for a renewal that another request already started or finished: a\n * boolean is the final answer, otherwise `pending` (null when none) is awaited.\n */\nfunction concurrentRenewal(\n input: SessionRefreshInput,\n authToken: string,\n): boolean | { readonly pending: Promise<boolean> | null } {\n const currentAuthToken = input.getCurrentAuthToken();\n if (currentAuthToken === authToken) return { pending: null };\n const renewed =\n currentAuthToken !== null &&\n input.isKnownSessionRenewal(authToken, currentAuthToken);\n if (renewed) {\n input.options.onSessionRenewed?.();\n return true;\n }\n const pending = input.pendingSessionRenewal(authToken);\n if (!currentAuthToken || !pending) return false;\n return { pending };\n}\n\n/**\n * Ends a request's wait for a renewal when its signal aborts. Only the wait\n * ends: the renewal is shared with other requests and keeps running, and a\n * rejection it settles with later is still delivered to them.\n */\nfunction renewalUnlessAborted(\n renewal: boolean | Promise<boolean>,\n signal: AbortSignal | undefined,\n): Promise<boolean> {\n if (!signal) return Promise.resolve(renewal);\n // Starting the renewal can abort the signal before a listener exists. The\n // renewal is still consumed, so a later rejection is never unhandled.\n if (signal.aborted) {\n Promise.resolve(renewal).catch(() => undefined);\n return Promise.resolve(false);\n }\n return new Promise<boolean>((resolve, reject) => {\n const abandon = () => resolve(false);\n signal.addEventListener(\"abort\", abandon, { once: true });\n Promise.resolve(renewal).then(\n (renewed) => {\n signal.removeEventListener(\"abort\", abandon);\n resolve(renewed);\n },\n (error: unknown) => {\n signal.removeEventListener(\"abort\", abandon);\n reject(error);\n },\n );\n });\n}\n\n/**\n * Decides whether a failed request can be replayed after session renewal.\n * Identity-integrity failures are terminal and must retain their typed error.\n */\nexport async function shouldRetryAfterSessionExpired(\n input: SessionRefreshInput,\n): Promise<boolean> {\n if (\n input.options.retryOnSessionExpired === false ||\n !input.authToken ||\n !isReplayableRequestBody(input.body) ||\n !isRefreshableSessionError(input.responseStatus, input.code)\n ) {\n return false;\n }\n\n const concurrent = concurrentRenewal(input, input.authToken);\n if (typeof concurrent === \"boolean\") return concurrent;\n const pending = concurrent.pending;\n // An aborted request has no use for a renewal and must not start one.\n if (input.options.signal?.aborted) return false;\n\n let refreshed = false;\n try {\n refreshed = await renewalUnlessAborted(\n pending ?? input.refreshSession(),\n input.options.signal,\n );\n } catch (error: unknown) {\n if (error instanceof KeyingVerificationError) {\n throw error;\n }\n if (input.options.reportErrors ?? true) {\n input.reportError(`Session refresh failed: ${errorMessage(error)}`);\n }\n }\n\n const refreshedToken = input.getCurrentAuthToken();\n const renewed = Boolean(\n refreshed &&\n refreshedToken &&\n input.isKnownSessionRenewal(input.authToken, refreshedToken),\n );\n if (renewed) input.options.onSessionRenewed?.();\n return renewed;\n}\n"]}
1
+ {"version":3,"file":"sessionRefresh.js","sourceRoot":"","sources":["sessionRefresh.ts"],"names":[],"mappings":"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","sourcesContent":["import { KeyingVerificationError } from \"@tearleads/crypto\";\nimport {\n errorMessage,\n isRefreshableSessionError,\n isReplayableRequestBody,\n} from \"./requestInternals\";\nimport type { RequestBody, RequestResultOptions } from \"./types\";\n\ninterface SessionRefreshInput {\n readonly authToken: string | null;\n readonly body: RequestBody | undefined;\n readonly code: string | null;\n readonly getCurrentAuthToken: () => string | null;\n readonly isKnownSessionRenewal: (from: string, to: string) => boolean;\n readonly options: RequestResultOptions;\n readonly pendingSessionRenewal: (from: string) => Promise<boolean> | null;\n readonly refreshSession: () => boolean | Promise<boolean>;\n readonly reportError: (message: string) => void;\n readonly responseStatus: number;\n}\n\n/**\n * Checks for a renewal that another request already started or finished: a\n * boolean is the final answer, otherwise `pending` (null when none) is awaited.\n */\nfunction concurrentRenewal(\n input: SessionRefreshInput,\n authToken: string,\n): boolean | { readonly pending: Promise<boolean> | null } {\n const currentAuthToken = input.getCurrentAuthToken();\n if (currentAuthToken === authToken) return { pending: null };\n const renewed =\n currentAuthToken !== null &&\n input.isKnownSessionRenewal(authToken, currentAuthToken);\n if (renewed) {\n input.options.onSessionRenewed?.();\n return true;\n }\n const pending = input.pendingSessionRenewal(authToken);\n if (!currentAuthToken || !pending) return false;\n return { pending };\n}\n\n/**\n * Ends a request's wait for a renewal when its signal aborts. Only the wait\n * ends: the renewal is shared with other requests and keeps running, and a\n * rejection it settles with later is still delivered to them.\n */\nexport function renewalUnlessAborted(\n renewal: boolean | Promise<boolean>,\n signal: AbortSignal | undefined,\n): Promise<boolean> {\n if (!signal) return Promise.resolve(renewal);\n // Starting the renewal can abort the signal before a listener exists. The\n // renewal is still consumed, so a later rejection is never unhandled.\n if (signal.aborted) {\n Promise.resolve(renewal).catch(() => undefined);\n return Promise.resolve(false);\n }\n return new Promise<boolean>((resolve, reject) => {\n const abandon = () => resolve(false);\n signal.addEventListener(\"abort\", abandon, { once: true });\n Promise.resolve(renewal).then(\n (renewed) => {\n signal.removeEventListener(\"abort\", abandon);\n resolve(renewed);\n },\n (error: unknown) => {\n signal.removeEventListener(\"abort\", abandon);\n reject(error);\n },\n );\n });\n}\n\n/**\n * Decides whether a failed request can be replayed after session renewal.\n * Identity-integrity failures are terminal and must retain their typed error.\n */\nexport async function shouldRetryAfterSessionExpired(\n input: SessionRefreshInput,\n): Promise<boolean> {\n if (\n input.options.retryOnSessionExpired === false ||\n !input.authToken ||\n !isReplayableRequestBody(input.body) ||\n !isRefreshableSessionError(input.responseStatus, input.code)\n ) {\n return false;\n }\n\n const concurrent = concurrentRenewal(input, input.authToken);\n if (typeof concurrent === \"boolean\") return concurrent;\n const pending = concurrent.pending;\n // An aborted request has no use for a renewal and must not start one.\n if (input.options.signal?.aborted) return false;\n\n let refreshed = false;\n try {\n refreshed = await renewalUnlessAborted(\n pending ?? input.refreshSession(),\n input.options.signal,\n );\n } catch (error: unknown) {\n if (error instanceof KeyingVerificationError) {\n throw error;\n }\n if (input.options.reportErrors ?? true) {\n input.reportError(`Session refresh failed: ${errorMessage(error)}`);\n }\n }\n\n const refreshedToken = input.getCurrentAuthToken();\n const renewed = Boolean(\n refreshed &&\n refreshedToken &&\n input.isKnownSessionRenewal(input.authToken, refreshedToken),\n );\n if (renewed) input.options.onSessionRenewed?.();\n return renewed;\n}\n"]}
@@ -0,0 +1,31 @@
1
+ import type { RequestResultOptions } from "./types.js";
2
+ export declare function sessionAuthChallengeBytes(baseUrl: string, challengeHex: string, fingerprint: string): Uint8Array;
3
+ export type SessionBoundary = "replacement" | "renewal-refused";
4
+ type RenewSession = (() => boolean | Promise<boolean>) | null;
5
+ /** An identity change invalidates renewal evidence, including an awaited callback. */
6
+ export declare class SessionRenewalTracker {
7
+ private readonly readToken;
8
+ private revision;
9
+ private lastUnverifiedChange;
10
+ private sessionRequests;
11
+ private renewalWaiters;
12
+ private readonly sourceSignals;
13
+ private readonly refusedSessions;
14
+ private known;
15
+ private inFlight;
16
+ constructor(readToken: () => string | null);
17
+ private provisionalRenewal;
18
+ captureCredential(): () => boolean | Promise<boolean>;
19
+ get signal(): AbortSignal;
20
+ withSessionSignal(options: RequestResultOptions): RequestResultOptions;
21
+ withRenewalWaitSignal(options: RequestResultOptions): RequestResultOptions;
22
+ private callerSignal;
23
+ refused(session: AbortSignal): boolean;
24
+ tokenChanged(boundary?: SessionBoundary): void;
25
+ isKnown(from: string, to: string): boolean;
26
+ currentToken(from: string | null): string | null;
27
+ pending(from: string): Promise<boolean> | null;
28
+ renew(handler: RenewSession): Promise<boolean>;
29
+ private complete;
30
+ }
31
+ export {};