@tearleads/client-sdk 0.1.251 → 0.1.252

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 (141) hide show
  1. package/Tearleads.d.ts +0 -2
  2. package/Tearleads.js +14 -25
  3. package/Tearleads.js.map +1 -1
  4. package/client/organizations/organizationReadModelPresentation.js +7 -4
  5. package/client/organizations/organizationReadModelPresentation.js.map +1 -1
  6. package/client/organizations/organizationReadModels.js +6 -5
  7. package/client/organizations/organizationReadModels.js.map +1 -1
  8. package/client/organizations/organizationWorkflowRuntime.js +1 -1
  9. package/client/organizations/organizationWorkflowRuntime.js.map +1 -1
  10. package/client/runtime/principalMutationApi.d.ts +4 -0
  11. package/client/runtime/principalMutationApi.js +9 -5
  12. package/client/runtime/principalMutationApi.js.map +1 -1
  13. package/client/runtime/runtimeIdentityResolution.js +23 -0
  14. package/client/runtime/runtimeIdentityResolution.js.map +1 -1
  15. package/client/runtime/runtimeSubscription.js +68 -0
  16. package/client/runtime/runtimeSubscription.js.map +1 -0
  17. package/client/runtime/workflowRuntime.d.ts +1 -1
  18. package/client/runtime/workflowRuntime.js +20 -77
  19. package/client/runtime/workflowRuntime.js.map +1 -1
  20. package/client/session/authenticationMachine.js +47 -0
  21. package/client/session/authenticationMachine.js.map +1 -0
  22. package/client/session/index.js +75 -93
  23. package/client/session/index.js.map +1 -1
  24. package/client/session/sessionBlobStore.js +39 -0
  25. package/client/session/sessionBlobStore.js.map +1 -0
  26. package/client/session/sessionContext.js +11 -0
  27. package/client/session/sessionContext.js.map +1 -1
  28. package/client/session/sessionIdentityTrust.d.ts +2 -1
  29. package/client/session/sessionIdentityTrust.js +8 -4
  30. package/client/session/sessionIdentityTrust.js.map +1 -1
  31. package/client/session/sessionLifetime.js +87 -0
  32. package/client/session/sessionLifetime.js.map +1 -0
  33. package/client/session/sessionLogin.js +114 -0
  34. package/client/session/sessionLogin.js.map +1 -0
  35. package/client/session/sessionOrganizationCreation.js +3 -2
  36. package/client/session/sessionOrganizationCreation.js.map +1 -1
  37. package/client/session/sessionPurgeRecovery.js +11 -3
  38. package/client/session/sessionPurgeRecovery.js.map +1 -1
  39. package/client/session/sessionTypes.d.ts +6 -2
  40. package/client/session/sessionTypes.js.map +1 -1
  41. package/data/blobs/blobContracts.d.ts +4 -3
  42. package/data/blobs/blobContracts.js.map +1 -1
  43. package/data/blobs/createBlobStore.js +1 -8
  44. package/data/blobs/createBlobStore.js.map +1 -1
  45. package/data/blobs/encryptedBlobStore.js +17 -12
  46. package/data/blobs/encryptedBlobStore.js.map +1 -1
  47. package/data/blobs/memoryBlobStore.js +8 -5
  48. package/data/blobs/memoryBlobStore.js.map +1 -1
  49. package/data/blobs/opfsBlobFile.js +36 -0
  50. package/data/blobs/opfsBlobFile.js.map +1 -0
  51. package/data/blobs/opfsBlobStore.d.ts +1 -1
  52. package/data/blobs/opfsBlobStore.js +91 -21
  53. package/data/blobs/opfsBlobStore.js.map +1 -1
  54. package/data/principals/principalPolicyCoordinator.js +8 -17
  55. package/data/principals/principalPolicyCoordinator.js.map +1 -1
  56. package/data/shared/domainScope.d.ts +2 -0
  57. package/data/shared/domainScope.js +2 -1
  58. package/data/shared/domainScope.js.map +1 -1
  59. package/data/shared/keyedQueue.js +15 -0
  60. package/data/shared/keyedQueue.js.map +1 -0
  61. package/data/sqlite/migrations/migrateLocalSchema.js +2 -3
  62. package/data/sqlite/migrations/migrateLocalSchema.js.map +1 -1
  63. package/data/sqlite/sqlExec.d.ts +6 -0
  64. package/data/sqlite/sqlExec.js +64 -13
  65. package/data/sqlite/sqlExec.js.map +1 -1
  66. package/data/sqlite/sqlitePersistenceRuntime.js +2 -3
  67. package/data/sqlite/sqlitePersistenceRuntime.js.map +1 -1
  68. package/data/trustedUserIdentity/service.js +2 -1
  69. package/data/trustedUserIdentity/service.js.map +1 -1
  70. package/data/trustedUserIdentity/types.d.ts +1 -1
  71. package/data/trustedUserIdentity/types.js.map +1 -1
  72. package/internal/api-client/ApiClient.d.ts +4 -1
  73. package/internal/api-client/apiRequestRuntime.d.ts +6 -3
  74. package/internal/api-client/apiRequestRuntime.js +86 -101
  75. package/internal/api-client/apiRequestRuntime.js.map +1 -1
  76. package/internal/api-client/binaryRequestOperationTransport.js +2 -1
  77. package/internal/api-client/binaryRequestOperationTransport.js.map +1 -1
  78. package/internal/api-client/binaryResponseOperationTransport.js +6 -2
  79. package/internal/api-client/binaryResponseOperationTransport.js.map +1 -1
  80. package/internal/api-client/client/blobs.d.ts +1 -0
  81. package/internal/api-client/client/blobs.js +12 -3
  82. package/internal/api-client/client/blobs.js.map +1 -1
  83. package/internal/api-client/client/laneListingRequest.js +4 -0
  84. package/internal/api-client/client/laneListingRequest.js.map +1 -1
  85. package/internal/api-client/client/session.d.ts +5 -1
  86. package/internal/api-client/client/session.js +12 -4
  87. package/internal/api-client/client/session.js.map +1 -1
  88. package/internal/api-client/client/writerProjections.js +12 -13
  89. package/internal/api-client/client/writerProjections.js.map +1 -1
  90. package/internal/api-client/operationResponse.d.ts +1 -1
  91. package/internal/api-client/operationResponse.js +10 -23
  92. package/internal/api-client/operationResponse.js.map +1 -1
  93. package/internal/api-client/operationTransport.js +2 -1
  94. package/internal/api-client/operationTransport.js.map +1 -1
  95. package/internal/api-client/principalHistoryRequest.js +25 -20
  96. package/internal/api-client/principalHistoryRequest.js.map +1 -1
  97. package/internal/api-client/principalHistoryRequestContext.js +30 -6
  98. package/internal/api-client/principalHistoryRequestContext.js.map +1 -1
  99. package/internal/api-client/principalPolicyPages.d.ts +4 -1
  100. package/internal/api-client/principalPolicyPages.js +4 -2
  101. package/internal/api-client/principalPolicyPages.js.map +1 -1
  102. package/internal/api-client/projectionPolicyHistoryPages.d.ts +4 -1
  103. package/internal/api-client/projectionPolicyHistoryPages.js +4 -2
  104. package/internal/api-client/projectionPolicyHistoryPages.js.map +1 -1
  105. package/internal/api-client/routes/blobs/blobDownloadBody.js +65 -0
  106. package/internal/api-client/routes/blobs/blobDownloadBody.js.map +1 -0
  107. package/internal/api-client/routes/blobs/get.js +9 -67
  108. package/internal/api-client/routes/blobs/get.js.map +1 -1
  109. package/internal/api-client/routes/blobs/multipartUpload.js +1 -1
  110. package/internal/api-client/routes/blobs/multipartUpload.js.map +1 -1
  111. package/internal/api-client/sessionRefresh.js +1 -1
  112. package/internal/api-client/sessionRefresh.js.map +1 -1
  113. package/internal/api-client/sessionRenewal.d.ts +31 -0
  114. package/internal/api-client/sessionRenewal.js +91 -6
  115. package/internal/api-client/sessionRenewal.js.map +1 -1
  116. package/internal/api-client/sessionRequestInit.js +22 -0
  117. package/internal/api-client/sessionRequestInit.js.map +1 -0
  118. package/internal/api-client/sessionResponse.js +39 -0
  119. package/internal/api-client/sessionResponse.js.map +1 -0
  120. package/internal/api-client/types.d.ts +1 -0
  121. package/internal/api-client/types.js.map +1 -1
  122. package/internal/api-client/webSocketTickets.d.ts +1 -0
  123. package/internal/api-client/webSocketTickets.js +4 -0
  124. package/internal/api-client/webSocketTickets.js.map +1 -1
  125. package/internal/sqlite-worker/client.d.ts +1 -1
  126. package/internal/sqlite-worker/client.js +6 -1
  127. package/internal/sqlite-worker/client.js.map +1 -1
  128. package/internal/sqlite-worker/purgeOpfsDatabase.d.ts +1 -1
  129. package/internal/sqlite-worker/purgeOpfsDatabase.js +3 -2
  130. package/internal/sqlite-worker/purgeOpfsDatabase.js.map +1 -1
  131. package/internal/sqlite-worker/types.d.ts +4 -0
  132. package/internal/sqlite-worker/types.js.map +1 -1
  133. package/package.json +1 -1
  134. package/sqlite/worker.js +1 -1
  135. package/workflows/documents/attachments/blobMutationLock.d.ts +1 -1
  136. package/workflows/documents/attachments/blobMutationLock.js +2 -2
  137. package/workflows/documents/attachments/blobMutationLock.js.map +1 -1
  138. package/workflows/organizations/readModel/readModelProjection.js +2 -0
  139. package/workflows/organizations/readModel/readModelProjection.js.map +1 -1
  140. package/workflows/registration/registerIdentity.js +2 -0
  141. package/workflows/registration/registerIdentity.js.map +1 -1
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n DocumentAttributionRangesQuery,\n HttpOperation,\n HttpOperationMethod,\n} from \"@tearleads/validators/operation\";\nimport type { ReferencedPrincipalStateResponse } from \"@tearleads/validators/response\";\nimport type { ApiNetworkError } from \"./networkFailure\";\nimport type { WriterProjectionListing } from \"./verifiedManifestCitations\";\n\nexport type HttpMethod = HttpOperationMethod;\nexport type RequestBody = BodyInit;\n\nexport type ListDocumentEditAttributionRangesOptions = Omit<\n DocumentAttributionRangesQuery,\n \"cursor\"\n> & {\n cursor?: DocumentAttributionRangesQuery[\"cursor\"] | null;\n};\n\nexport interface RequestResultOptions {\n readonly signal?: AbortSignal | undefined;\n /** Expected target for a declared 402; mismatched response identities fail closed. */\n readonly expectedPaymentRequiredOrganizationId?: string | undefined;\n readonly headers?: Record<string, string> | undefined;\n readonly reportErrors?: boolean | undefined;\n /** Called after this request or a concurrent request renews the same session. */\n readonly onSessionRenewed?: (() => void) | undefined;\n readonly retryOnSessionExpired?: boolean | \"renew-only\" | undefined;\n /**\n * Writer-projection reads only: where a listing placed the container, so\n * an unplaced container can cite its listed parent's held bytes. It\n * changes which hashes the read cites, never what the read accepts.\n */\n readonly projectionListing?: WriterProjectionListing | undefined;\n /**\n * Group creates, group policy commits and shares only: the organization\n * read-model cursor the caller holds. The response then carries the\n * read-model delta from it when the commit advanced from that cursor.\n */\n readonly readModelCursor?: string | undefined;\n}\n\nexport type OperationRequestFn = <T>(\n path: string,\n validator: (value: unknown) => value is T,\n method: HttpMethod,\n body: RequestBody | undefined,\n options: RequestResultOptions | undefined,\n failureOperation: HttpOperation,\n) => Promise<T | null>;\n\nexport type OperationRequestResultFn = <T>(\n path: string,\n validator: (value: unknown) => value is T,\n method: HttpMethod,\n body: RequestBody | undefined,\n options: RequestResultOptions | undefined,\n failureOperation: HttpOperation,\n) => Promise<RequestResult<T>>;\n\nexport type RequestFailureKind =\n | \"storage\"\n | \"http\"\n | \"network\"\n | \"json\"\n | \"shape\"\n | \"cancelled\"\n | \"outcome-unknown\";\n\nexport interface RequestFailure {\n readonly code?: string | undefined;\n readonly kind: RequestFailureKind;\n readonly message: string;\n readonly method: HttpMethod;\n /** Set when the fetch itself threw: what the client could observe, without secrets. */\n readonly networkError?: ApiNetworkError | undefined;\n readonly ok: false;\n readonly path: string;\n readonly report: () => void;\n readonly status: number | null;\n readonly statusText: string;\n readonly stalePrincipalHeads?: ReferencedPrincipalStateResponse[] | undefined;\n /**\n * With `container_descendant_rekeys_required`, the full owed set, parent-first;\n * with `container_descendant_rekeys_inaccessible`, its unwritable subset.\n * A hint, never authority; verify each container before signing for it.\n */\n readonly requiredContainerIds?: readonly string[] | undefined;\n}\n\nexport interface RequestSuccess<T> {\n readonly data: T;\n readonly ok: true;\n}\n\nexport type RequestResult<T> = RequestFailure | RequestSuccess<T>;\n\nexport interface ResponseRequestValidationFailureInput {\n readonly code?: string | undefined;\n readonly kind: RequestFailureKind;\n readonly message: string;\n readonly method: HttpMethod;\n readonly options?: RequestResultOptions | undefined;\n readonly path: string;\n readonly status: number | null;\n readonly statusText: string;\n}\n\nexport interface OperationResponseRequestFn {\n (\n path: string,\n method: HttpMethod,\n body: RequestBody | undefined,\n options: RequestResultOptions,\n additionalSuccessStatuses: readonly number[],\n failureOperation: HttpOperation,\n ): Promise<RequestResult<Response>>;\n readonly reportFailure: (\n input: ResponseRequestValidationFailureInput,\n ) => RequestFailure;\n}\n"]}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n DocumentAttributionRangesQuery,\n HttpOperation,\n HttpOperationMethod,\n} from \"@tearleads/validators/operation\";\nimport type { ReferencedPrincipalStateResponse } from \"@tearleads/validators/response\";\nimport type { ApiNetworkError } from \"./networkFailure\";\nimport type { WriterProjectionListing } from \"./verifiedManifestCitations\";\n\nexport type HttpMethod = HttpOperationMethod;\nexport type RequestBody = BodyInit;\n\nexport type ListDocumentEditAttributionRangesOptions = Omit<\n DocumentAttributionRangesQuery,\n \"cursor\"\n> & {\n cursor?: DocumentAttributionRangesQuery[\"cursor\"] | null;\n};\n\nexport interface RequestResultOptions {\n readonly signal?: AbortSignal | undefined;\n /** Expected target for a declared 402; mismatched response identities fail closed. */\n readonly expectedPaymentRequiredOrganizationId?: string | undefined;\n readonly headers?: Record<string, string> | undefined;\n readonly reportErrors?: boolean | undefined;\n /** Called after this request or a concurrent request renews the same session. */\n readonly onSessionRenewed?: (() => void) | undefined;\n readonly retryOnSessionExpired?: boolean | \"renew-only\" | undefined;\n /**\n * Writer-projection reads only: where a listing placed the container, so\n * an unplaced container can cite its listed parent's held bytes. It\n * changes which hashes the read cites, never what the read accepts.\n */\n readonly projectionListing?: WriterProjectionListing | undefined;\n /**\n * Group creates, group policy commits and shares only: the organization\n * read-model cursor the caller holds. The response then carries the\n * read-model delta from it when the commit advanced from that cursor.\n */\n readonly readModelCursor?: string | undefined;\n}\n\nexport type OperationRequestFn = <T>(\n path: string,\n validator: (value: unknown) => value is T,\n method: HttpMethod,\n body: RequestBody | undefined,\n options: RequestResultOptions | undefined,\n failureOperation: HttpOperation,\n) => Promise<T | null>;\n\nexport type OperationRequestResultFn = <T>(\n path: string,\n validator: (value: unknown) => value is T,\n method: HttpMethod,\n body: RequestBody | undefined,\n options: RequestResultOptions | undefined,\n failureOperation: HttpOperation,\n) => Promise<RequestResult<T>>;\n\nexport type RequestFailureKind =\n | \"storage\"\n | \"http\"\n | \"network\"\n | \"json\"\n | \"shape\"\n | \"cancelled\"\n | \"outcome-unknown\";\n\nexport interface RequestFailure {\n readonly code?: string | undefined;\n readonly kind: RequestFailureKind;\n readonly message: string;\n readonly method: HttpMethod;\n /** Set when the fetch itself threw: what the client could observe, without secrets. */\n readonly networkError?: ApiNetworkError | undefined;\n readonly ok: false;\n readonly path: string;\n readonly report: () => void;\n readonly status: number | null;\n readonly statusText: string;\n readonly stalePrincipalHeads?: ReferencedPrincipalStateResponse[] | undefined;\n /**\n * With `container_descendant_rekeys_required`, the full owed set, parent-first;\n * with `container_descendant_rekeys_inaccessible`, its unwritable subset.\n * A hint, never authority; verify each container before signing for it.\n */\n readonly requiredContainerIds?: readonly string[] | undefined;\n}\n\nexport interface RequestSuccess<T> {\n readonly data: T;\n readonly ok: true;\n}\n\nexport type RequestResult<T> = RequestFailure | RequestSuccess<T>;\n\nexport interface ResponseRequestValidationFailureInput {\n readonly code?: string | undefined;\n readonly kind: RequestFailureKind;\n readonly message: string;\n readonly method: HttpMethod;\n readonly options?: RequestResultOptions | undefined;\n readonly path: string;\n readonly status: number | null;\n readonly statusText: string;\n}\n\nexport interface OperationResponseRequestFn {\n (\n path: string,\n method: HttpMethod,\n body: RequestBody | undefined,\n options: RequestResultOptions,\n additionalSuccessStatuses: readonly number[],\n failureOperation: HttpOperation,\n ): Promise<RequestResult<Response>>;\n readonly sessionSignal?: () => AbortSignal;\n readonly reportFailure: (\n input: ResponseRequestValidationFailureInput,\n ) => RequestFailure;\n}\n"]}
@@ -14,6 +14,7 @@ export declare class WebSocketTickets {
14
14
  private loginTicket;
15
15
  constructor(transport: Pick<OperationTransport, "request">, currentToken: () => string | null, now?: () => number);
16
16
  rememberLogin(login: VerifySuccessResponse): void;
17
+ retainVerifiedTicket(ticket: string | undefined): void;
17
18
  next(): Promise<string | null>;
18
19
  }
19
20
  /**
@@ -29,6 +29,10 @@ export class WebSocketTickets {
29
29
  token: login.token,
30
30
  };
31
31
  }
32
+ retainVerifiedTicket(ticket) {
33
+ if (this.loginTicket?.ticket !== ticket)
34
+ this.loginTicket = null;
35
+ }
32
36
  async next() {
33
37
  const login = this.loginTicket;
34
38
  this.loginTicket = null;
@@ -1 +1 @@
1
- {"version":3,"file":"webSocketTickets.js","sourceRoot":"","sources":["webSocketTickets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAIvE;;;GAGG;AACH,MAAM,uBAAuB,GAAG,CAAC,qBAAqB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;AAQnE;;;;;;GAMG;AACH,MAAM,OAAO,gBAAgB;IAIR;IACA;IACA;IALX,WAAW,GAAuB,IAAI,CAAC;IAE/C,YACmB,SAA8C,EAC9C,YAAiC,EACjC,MAAoB,IAAI,CAAC,GAAG;QAF5B,cAAS,GAAT,SAAS,CAAqC;QAC9C,iBAAY,GAAZ,YAAY,CAAqB;QACjC,QAAG,GAAH,GAAG,CAAyB;IAC5C,CAAC;IAEJ,aAAa,CAAC,KAA4B;QACxC,IAAI,CAAC,WAAW,GAAG;YACjB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,uBAAuB;YAC/C,MAAM,EAAE,KAAK,CAAC,QAAQ;YACtB,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC;QAC/B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IACE,KAAK;YACL,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,YAAY,EAAE;YACnC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS;YAE5B,OAAO,KAAK,CAAC,MAAM,CAAC;QACtB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,wBAAwB,EAAE;YACtE,MAAM,EAAE,EAAE;SACX,CAAC,CAAC;QACH,OAAO,QAAQ,EAAE,MAAM,IAAI,IAAI,CAAC;IAClC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAa,EACb,MAAc,EACd,eAA2C,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC;IAEtE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAC3B,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACvC,OAAO,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;AACtC,CAAC","sourcesContent":["import { webSocketTicketOperation } from \"@tearleads/validators/operation\";\nimport { WS_TICKET_TTL_SECONDS } from \"@tearleads/validators/realtime\";\nimport type { VerifySuccessResponse } from \"@tearleads/validators/response\";\nimport type { OperationTransport } from \"./operationTransportFactory\";\n\n/**\n * A login ticket is handed out only within half the server's ticket lifetime,\n * measured on this client's clock from when the login response arrived.\n */\nconst LOGIN_TICKET_MAX_AGE_MS = (WS_TICKET_TTL_SECONDS * 1000) / 2;\n\ninterface LoginTicket {\n readonly expiresAt: number;\n readonly ticket: string;\n readonly token: string;\n}\n\n/**\n * Single-use websocket upgrade tickets. `POST /auth/verify` returns the new\n * session's first ticket, so the first connect after login needs no\n * `POST /auth/ws-ticket`. That ticket is handed out at most once, and only\n * while the session it was issued for is still the client's current one; every\n * other connect mints a fresh ticket.\n */\nexport class WebSocketTickets {\n private loginTicket: LoginTicket | null = null;\n\n constructor(\n private readonly transport: Pick<OperationTransport, \"request\">,\n private readonly currentToken: () => string | null,\n private readonly now: () => number = Date.now,\n ) {}\n\n rememberLogin(login: VerifySuccessResponse): void {\n this.loginTicket = {\n expiresAt: this.now() + LOGIN_TICKET_MAX_AGE_MS,\n ticket: login.wsTicket,\n token: login.token,\n };\n }\n\n async next(): Promise<string | null> {\n const login = this.loginTicket;\n this.loginTicket = null;\n if (\n login &&\n login.token === this.currentToken() &&\n this.now() < login.expiresAt\n )\n return login.ticket;\n const response = await this.transport.request(webSocketTicketOperation, {\n params: {},\n });\n return response?.ticket ?? null;\n }\n}\n\n/**\n * Opens the API's server-events socket with a ticket from\n * {@link WebSocketTickets.next}. The handshake cannot carry the bearer header,\n * so the single-use ticket rides in the query; it replaces any `ticket` the\n * configured URL already has and keeps the URL's other parameters.\n */\nexport function openServerEventsSocket(\n wsUrl: string,\n ticket: string,\n createSocket: (url: string) => WebSocket = (url) => new WebSocket(url),\n): WebSocket {\n const url = new URL(wsUrl);\n url.searchParams.set(\"ticket\", ticket);\n return createSocket(url.toString());\n}\n"]}
1
+ {"version":3,"file":"webSocketTickets.js","sourceRoot":"","sources":["webSocketTickets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAIvE;;;GAGG;AACH,MAAM,uBAAuB,GAAG,CAAC,qBAAqB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;AAQnE;;;;;;GAMG;AACH,MAAM,OAAO,gBAAgB;IAIR;IACA;IACA;IALX,WAAW,GAAuB,IAAI,CAAC;IAE/C,YACmB,SAA8C,EAC9C,YAAiC,EACjC,MAAoB,IAAI,CAAC,GAAG;QAF5B,cAAS,GAAT,SAAS,CAAqC;QAC9C,iBAAY,GAAZ,YAAY,CAAqB;QACjC,QAAG,GAAH,GAAG,CAAyB;IAC5C,CAAC;IAEJ,aAAa,CAAC,KAA4B;QACxC,IAAI,CAAC,WAAW,GAAG;YACjB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,uBAAuB;YAC/C,MAAM,EAAE,KAAK,CAAC,QAAQ;YACtB,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC;IACJ,CAAC;IAED,oBAAoB,CAAC,MAA0B;QAC7C,IAAI,IAAI,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM;YAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC;QAC/B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IACE,KAAK;YACL,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,YAAY,EAAE;YACnC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS;YAE5B,OAAO,KAAK,CAAC,MAAM,CAAC;QACtB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,wBAAwB,EAAE;YACtE,MAAM,EAAE,EAAE;SACX,CAAC,CAAC;QACH,OAAO,QAAQ,EAAE,MAAM,IAAI,IAAI,CAAC;IAClC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAa,EACb,MAAc,EACd,eAA2C,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC;IAEtE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAC3B,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACvC,OAAO,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;AACtC,CAAC","sourcesContent":["import { webSocketTicketOperation } from \"@tearleads/validators/operation\";\nimport { WS_TICKET_TTL_SECONDS } from \"@tearleads/validators/realtime\";\nimport type { VerifySuccessResponse } from \"@tearleads/validators/response\";\nimport type { OperationTransport } from \"./operationTransportFactory\";\n\n/**\n * A login ticket is handed out only within half the server's ticket lifetime,\n * measured on this client's clock from when the login response arrived.\n */\nconst LOGIN_TICKET_MAX_AGE_MS = (WS_TICKET_TTL_SECONDS * 1000) / 2;\n\ninterface LoginTicket {\n readonly expiresAt: number;\n readonly ticket: string;\n readonly token: string;\n}\n\n/**\n * Single-use websocket upgrade tickets. `POST /auth/verify` returns the new\n * session's first ticket, so the first connect after login needs no\n * `POST /auth/ws-ticket`. That ticket is handed out at most once, and only\n * while the session it was issued for is still the client's current one; every\n * other connect mints a fresh ticket.\n */\nexport class WebSocketTickets {\n private loginTicket: LoginTicket | null = null;\n\n constructor(\n private readonly transport: Pick<OperationTransport, \"request\">,\n private readonly currentToken: () => string | null,\n private readonly now: () => number = Date.now,\n ) {}\n\n rememberLogin(login: VerifySuccessResponse): void {\n this.loginTicket = {\n expiresAt: this.now() + LOGIN_TICKET_MAX_AGE_MS,\n ticket: login.wsTicket,\n token: login.token,\n };\n }\n\n retainVerifiedTicket(ticket: string | undefined): void {\n if (this.loginTicket?.ticket !== ticket) this.loginTicket = null;\n }\n\n async next(): Promise<string | null> {\n const login = this.loginTicket;\n this.loginTicket = null;\n if (\n login &&\n login.token === this.currentToken() &&\n this.now() < login.expiresAt\n )\n return login.ticket;\n const response = await this.transport.request(webSocketTicketOperation, {\n params: {},\n });\n return response?.ticket ?? null;\n }\n}\n\n/**\n * Opens the API's server-events socket with a ticket from\n * {@link WebSocketTickets.next}. The handshake cannot carry the bearer header,\n * so the single-use ticket rides in the query; it replaces any `ticket` the\n * configured URL already has and keeps the URL's other parameters.\n */\nexport function openServerEventsSocket(\n wsUrl: string,\n ticket: string,\n createSocket: (url: string) => WebSocket = (url) => new WebSocket(url),\n): WebSocket {\n const url = new URL(wsUrl);\n url.searchParams.set(\"ticket\", ticket);\n return createSocket(url.toString());\n}\n"]}
@@ -14,7 +14,7 @@ export interface DatabaseWorkerClient {
14
14
  * permanently destroying the on-disk data (vs {@link close}, which only
15
15
  * releases the handles). Callers terminate the worker after this resolves.
16
16
  */
17
- delete(): Promise<DatabaseWorkerDeleted>;
17
+ delete(current?: () => boolean): Promise<DatabaseWorkerDeleted>;
18
18
  /**
19
19
  * Device reset: ask the worker to remove everything in this origin's OPFS.
20
20
  * Only a worker that has not opened persistent storage accepts it; the app
@@ -88,7 +88,12 @@ export function createDatabaseWorkerClient(worker, requestIdSequence = { current
88
88
  close() {
89
89
  return request("close", undefined);
90
90
  },
91
- delete() {
91
+ async delete(current) {
92
+ if (current) {
93
+ await request("prepareDelete", undefined);
94
+ if (!current())
95
+ return request("close", undefined);
96
+ }
92
97
  return request("delete", undefined);
93
98
  },
94
99
  wipeStorage() {
@@ -1 +1 @@
1
- {"version":3,"file":"client.js","sourceRoot":"","sources":["client.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n DatabaseWorkerClosed,\n DatabaseWorkerDeleted,\n DatabaseWorkerExecOptions,\n DatabaseWorkerExecResult,\n DatabaseWorkerInitOptions,\n DatabaseWorkerPingResult,\n DatabaseWorkerReady,\n DatabaseWorkerStorageWiped,\n WorkerMethod,\n WorkerRequestMap,\n} from \"./types\";\nimport { workerCrashErrorFromEvent } from \"./workerCrash\";\n\nexport interface DatabaseWorkerClient {\n ping(): Promise<DatabaseWorkerPingResult>;\n init(options: DatabaseWorkerInitOptions): Promise<DatabaseWorkerReady>;\n exec(options: DatabaseWorkerExecOptions): Promise<DatabaseWorkerExecResult>;\n /**\n * Ask the worker to gracefully release its database and persistent-VFS OPFS\n * handles. Resolves when the worker confirms; callers terminate the worker\n * after this so the next worker can acquire the handles without contention.\n */\n close(): Promise<DatabaseWorkerClosed>;\n /**\n * Ask the worker to close its database and WIPE the persistent-VFS OPFS files,\n * permanently destroying the on-disk data (vs {@link close}, which only\n * releases the handles). Callers terminate the worker after this resolves.\n */\n delete(): Promise<DatabaseWorkerDeleted>;\n /**\n * Device reset: ask the worker to remove everything in this origin's OPFS.\n * Only a worker that has not opened persistent storage accepts it; the app\n * sends it before the page's first `init` when the main thread has no OPFS.\n */\n wipeStorage(): Promise<DatabaseWorkerStorageWiped>;\n destroy(): void;\n}\n\nfunction toError(value: unknown, defaultMessage: string): Error {\n if (value instanceof Error) {\n return value;\n }\n\n if (typeof value === \"string\" && value.length > 0) {\n return new Error(value);\n }\n\n return new Error(defaultMessage);\n}\n\nfunction rejectPendingRequests(\n pending: Map<number, PendingRequest>,\n error: Error,\n): void {\n for (const callback of pending.values()) {\n callback.reject(error);\n }\n\n pending.clear();\n}\n\ntype PendingRequest = {\n resolve: (value: WorkerRequestMap[WorkerMethod][\"result\"]) => void;\n reject: (error: Error) => void;\n};\n\nexport interface WorkerLike {\n postMessage(message: unknown, transfer?: Transferable[]): void;\n addEventListener(\n type: \"message\" | \"error\",\n listener: (event: Event) => void,\n ): void;\n removeEventListener(\n type: \"message\" | \"error\",\n listener: (event: Event) => void,\n ): void;\n}\n\nfunction makeMessageHandler(pending: Map<number, PendingRequest>) {\n return (event: Event) => {\n if (!(event instanceof MessageEvent)) {\n return;\n }\n\n const response = event.data;\n const callback = pending.get(response.id);\n\n if (!callback) {\n return;\n }\n\n pending.delete(response.id);\n\n if (!response.result.ok) {\n callback.reject(new Error(response.result.message));\n return;\n }\n\n callback.resolve(response.result);\n };\n}\n\n// A worker crash rejects every in-flight request rather than leaving it to hang:\n// the worker will never answer them. The error is minted on the main thread (see\n// workerCrash.ts) unless the event already carries the instance from the site\n// that observed the crash.\nfunction makeErrorHandler(pending: Map<number, PendingRequest>) {\n return (event: Event) => {\n rejectPendingRequests(pending, workerCrashErrorFromEvent(event));\n };\n}\n\n// Runs on the main thread.\n//\n// `requestIdSequence` is a caller-owned monotonic counter. When a worker is\n// reused across clients (see DatabaseRuntime.renewClient), the replacement client\n// must NOT restart request ids at 1: a delayed response to the previous client's\n// in-flight request (its listeners already removed) would otherwise arrive at the\n// new client and match a new pending request by its bare numeric id, falsely\n// completing it — potentially returning the old database's rows to a new-database\n// query. Sharing one ever-increasing sequence keeps every generation's ids\n// disjoint. Defaults to a private sequence for the common single-client case.\nexport function createDatabaseWorkerClient(\n worker: WorkerLike,\n requestIdSequence: { current: number } = { current: 1 },\n): DatabaseWorkerClient {\n const pending = new Map<number, PendingRequest>();\n let isDestroyed = false;\n\n const handleMessage = makeMessageHandler(pending);\n const handleError = makeErrorHandler(pending);\n\n worker.addEventListener(\"message\", handleMessage);\n worker.addEventListener(\"error\", handleError);\n\n function request(\n method: \"ping\",\n params: undefined,\n ): Promise<DatabaseWorkerPingResult>;\n function request(\n method: \"init\",\n params: DatabaseWorkerInitOptions,\n ): Promise<DatabaseWorkerReady>;\n function request(\n method: \"exec\",\n params: DatabaseWorkerExecOptions,\n ): Promise<DatabaseWorkerExecResult>;\n function request(\n method: \"close\",\n params: undefined,\n ): Promise<DatabaseWorkerClosed>;\n function request(\n method: \"delete\",\n params: undefined,\n ): Promise<DatabaseWorkerDeleted>;\n function request(\n method: \"wipeStorage\",\n params: undefined,\n ): Promise<DatabaseWorkerStorageWiped>;\n function request(\n method: WorkerMethod,\n params: WorkerRequestMap[WorkerMethod][\"params\"],\n ): Promise<WorkerRequestMap[WorkerMethod][\"result\"]> {\n if (isDestroyed) {\n return Promise.reject(\n new Error(\"Database worker client has been destroyed.\"),\n );\n }\n\n const id = requestIdSequence.current++;\n const message = { id, method, params };\n\n return new Promise((resolve, reject) => {\n pending.set(id, { resolve, reject });\n\n try {\n worker.postMessage(message);\n } catch (error) {\n pending.delete(id);\n reject(toError(error, \"Failed to post message to database worker.\"));\n }\n });\n }\n\n return {\n ping() {\n return request(\"ping\", undefined);\n },\n init(options) {\n return request(\"init\", options);\n },\n exec(options) {\n return request(\"exec\", options);\n },\n close() {\n return request(\"close\", undefined);\n },\n delete() {\n return request(\"delete\", undefined);\n },\n wipeStorage() {\n return request(\"wipeStorage\", undefined);\n },\n destroy() {\n if (isDestroyed) {\n return;\n }\n\n isDestroyed = true;\n worker.removeEventListener(\"message\", handleMessage);\n worker.removeEventListener(\"error\", handleError);\n rejectPendingRequests(\n pending,\n new Error(\"Database worker client has been destroyed.\"),\n );\n },\n };\n}\n"]}
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["client.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n DatabaseWorkerClosed,\n DatabaseWorkerDeleted,\n DatabaseWorkerExecOptions,\n DatabaseWorkerExecResult,\n DatabaseWorkerInitOptions,\n DatabaseWorkerPingResult,\n DatabaseWorkerReady,\n DatabaseWorkerStorageWiped,\n WorkerMethod,\n WorkerRequestMap,\n} from \"./types\";\nimport { workerCrashErrorFromEvent } from \"./workerCrash\";\n\nexport interface DatabaseWorkerClient {\n ping(): Promise<DatabaseWorkerPingResult>;\n init(options: DatabaseWorkerInitOptions): Promise<DatabaseWorkerReady>;\n exec(options: DatabaseWorkerExecOptions): Promise<DatabaseWorkerExecResult>;\n /**\n * Ask the worker to gracefully release its database and persistent-VFS OPFS\n * handles. Resolves when the worker confirms; callers terminate the worker\n * after this so the next worker can acquire the handles without contention.\n */\n close(): Promise<DatabaseWorkerClosed>;\n /**\n * Ask the worker to close its database and WIPE the persistent-VFS OPFS files,\n * permanently destroying the on-disk data (vs {@link close}, which only\n * releases the handles). Callers terminate the worker after this resolves.\n */\n delete(current?: () => boolean): Promise<DatabaseWorkerDeleted>;\n /**\n * Device reset: ask the worker to remove everything in this origin's OPFS.\n * Only a worker that has not opened persistent storage accepts it; the app\n * sends it before the page's first `init` when the main thread has no OPFS.\n */\n wipeStorage(): Promise<DatabaseWorkerStorageWiped>;\n destroy(): void;\n}\n\nfunction toError(value: unknown, defaultMessage: string): Error {\n if (value instanceof Error) {\n return value;\n }\n\n if (typeof value === \"string\" && value.length > 0) {\n return new Error(value);\n }\n\n return new Error(defaultMessage);\n}\n\nfunction rejectPendingRequests(\n pending: Map<number, PendingRequest>,\n error: Error,\n): void {\n for (const callback of pending.values()) {\n callback.reject(error);\n }\n\n pending.clear();\n}\n\ntype PendingRequest = {\n resolve: (value: WorkerRequestMap[WorkerMethod][\"result\"]) => void;\n reject: (error: Error) => void;\n};\n\nexport interface WorkerLike {\n postMessage(message: unknown, transfer?: Transferable[]): void;\n addEventListener(\n type: \"message\" | \"error\",\n listener: (event: Event) => void,\n ): void;\n removeEventListener(\n type: \"message\" | \"error\",\n listener: (event: Event) => void,\n ): void;\n}\n\nfunction makeMessageHandler(pending: Map<number, PendingRequest>) {\n return (event: Event) => {\n if (!(event instanceof MessageEvent)) {\n return;\n }\n\n const response = event.data;\n const callback = pending.get(response.id);\n\n if (!callback) {\n return;\n }\n\n pending.delete(response.id);\n\n if (!response.result.ok) {\n callback.reject(new Error(response.result.message));\n return;\n }\n\n callback.resolve(response.result);\n };\n}\n\n// A worker crash rejects every in-flight request rather than leaving it to hang:\n// the worker will never answer them. The error is minted on the main thread (see\n// workerCrash.ts) unless the event already carries the instance from the site\n// that observed the crash.\nfunction makeErrorHandler(pending: Map<number, PendingRequest>) {\n return (event: Event) => {\n rejectPendingRequests(pending, workerCrashErrorFromEvent(event));\n };\n}\n\n// Runs on the main thread.\n//\n// `requestIdSequence` is a caller-owned monotonic counter. When a worker is\n// reused across clients (see DatabaseRuntime.renewClient), the replacement client\n// must NOT restart request ids at 1: a delayed response to the previous client's\n// in-flight request (its listeners already removed) would otherwise arrive at the\n// new client and match a new pending request by its bare numeric id, falsely\n// completing it — potentially returning the old database's rows to a new-database\n// query. Sharing one ever-increasing sequence keeps every generation's ids\n// disjoint. Defaults to a private sequence for the common single-client case.\nexport function createDatabaseWorkerClient(\n worker: WorkerLike,\n requestIdSequence: { current: number } = { current: 1 },\n): DatabaseWorkerClient {\n const pending = new Map<number, PendingRequest>();\n let isDestroyed = false;\n\n const handleMessage = makeMessageHandler(pending);\n const handleError = makeErrorHandler(pending);\n\n worker.addEventListener(\"message\", handleMessage);\n worker.addEventListener(\"error\", handleError);\n\n function request(\n method: \"ping\",\n params: undefined,\n ): Promise<DatabaseWorkerPingResult>;\n function request(\n method: \"init\",\n params: DatabaseWorkerInitOptions,\n ): Promise<DatabaseWorkerReady>;\n function request(\n method: \"exec\",\n params: DatabaseWorkerExecOptions,\n ): Promise<DatabaseWorkerExecResult>;\n function request(\n method: \"close\",\n params: undefined,\n ): Promise<DatabaseWorkerClosed>;\n function request(\n method: \"prepareDelete\" | \"delete\",\n params: undefined,\n ): Promise<DatabaseWorkerDeleted>;\n function request(\n method: \"wipeStorage\",\n params: undefined,\n ): Promise<DatabaseWorkerStorageWiped>;\n function request(\n method: WorkerMethod,\n params: WorkerRequestMap[WorkerMethod][\"params\"],\n ): Promise<WorkerRequestMap[WorkerMethod][\"result\"]> {\n if (isDestroyed) {\n return Promise.reject(\n new Error(\"Database worker client has been destroyed.\"),\n );\n }\n\n const id = requestIdSequence.current++;\n const message = { id, method, params };\n\n return new Promise((resolve, reject) => {\n pending.set(id, { resolve, reject });\n\n try {\n worker.postMessage(message);\n } catch (error) {\n pending.delete(id);\n reject(toError(error, \"Failed to post message to database worker.\"));\n }\n });\n }\n\n return {\n ping() {\n return request(\"ping\", undefined);\n },\n init(options) {\n return request(\"init\", options);\n },\n exec(options) {\n return request(\"exec\", options);\n },\n close() {\n return request(\"close\", undefined);\n },\n async delete(current) {\n if (current) {\n await request(\"prepareDelete\", undefined);\n if (!current()) return request(\"close\", undefined);\n }\n return request(\"delete\", undefined);\n },\n wipeStorage() {\n return request(\"wipeStorage\", undefined);\n },\n destroy() {\n if (isDestroyed) {\n return;\n }\n\n isDestroyed = true;\n worker.removeEventListener(\"message\", handleMessage);\n worker.removeEventListener(\"error\", handleError);\n rejectPendingRequests(\n pending,\n new Error(\"Database worker client has been destroyed.\"),\n );\n },\n };\n}\n"]}
@@ -10,4 +10,4 @@
10
10
  * it must not run while a worker still holds those handles — call it only after
11
11
  * the runtime has been torn down.
12
12
  */
13
- export declare function purgeOpfsSqliteDatabase(dbName: string): Promise<void>;
13
+ export declare function purgeOpfsSqliteDatabase(dbName: string, current?: () => boolean): Promise<void>;
@@ -19,7 +19,7 @@ function isNotFound(error) {
19
19
  * it must not run while a worker still holds those handles — call it only after
20
20
  * the runtime has been torn down.
21
21
  */
22
- export async function purgeOpfsSqliteDatabase(dbName) {
22
+ export async function purgeOpfsSqliteDatabase(dbName, current = () => true) {
23
23
  if (typeof navigator !== "object" ||
24
24
  !hasStorageDirectory(navigator.storage)) {
25
25
  return;
@@ -41,7 +41,8 @@ export async function purgeOpfsSqliteDatabase(dbName) {
41
41
  for (const parent of parents) {
42
42
  dir = await dir.getDirectoryHandle(parent);
43
43
  }
44
- await dir.removeEntry(leaf, { recursive: true });
44
+ if (current())
45
+ await dir.removeEntry(leaf, { recursive: true });
45
46
  }
46
47
  catch (error) {
47
48
  if (isNotFound(error)) {
@@ -1 +1 @@
1
- {"version":3,"file":"purgeOpfsDatabase.js","sourceRoot":"","sources":["purgeOpfsDatabase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,MAAM,kBAAkB,CAAC;AAMrE,SAAS,mBAAmB,CAC1B,OAAmC;IAEnC,OAAO,CACL,OAAO,KAAK,SAAS;QACrB,cAAc,IAAI,OAAO;QACzB,OAAO,OAAO,CAAC,YAAY,KAAK,UAAU,CAC3C,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,KAAK,YAAY,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,CAAC;AACzE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,MAAc;IAC1D,IACE,OAAO,SAAS,KAAK,QAAQ;QAC7B,CAAC,mBAAmB,CAAC,SAAS,CAAC,OAAO,CAAC,EACvC,CAAC;QACD,OAAO;IACT,CAAC;IAED,2EAA2E;IAC3E,qDAAqD;IACrD,MAAM,EAAE,SAAS,EAAE,GAAG,iCAAiC,CAAC,MAAM,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9E,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO;IACT,CAAC;IACD,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAEtC,IAAI,GAAG,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;IACjD,IAAI,CAAC;QACH,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,GAAG,GAAG,MAAM,GAAG,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC7C,CAAC;QACD,MAAM,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC","sourcesContent":["import { persistentSahPoolStorageForDbName } from \"./sahPoolStorage\";\n\ninterface StorageDirectoryProvider {\n getDirectory: () => Promise<FileSystemDirectoryHandle>;\n}\n\nfunction hasStorageDirectory(\n storage: StorageManager | undefined,\n): storage is StorageManager & StorageDirectoryProvider {\n return (\n storage !== undefined &&\n \"getDirectory\" in storage &&\n typeof storage.getDirectory === \"function\"\n );\n}\n\nfunction isNotFound(error: unknown): boolean {\n return error instanceof DOMException && error.name === \"NotFoundError\";\n}\n\n/**\n * Main-thread fallback that deletes the OPFS directory backing a persistent\n * database's SAHPool VFS, by database name. Use when no worker is alive to run\n * the in-worker `delete` op (worker cleared/killed/failed to boot) but the\n * persisted SQLite files must still be wiped — e.g. logging out and discarding\n * local data. No-op when OPFS is unavailable or the directory was never\n * created; never throws on a missing directory.\n *\n * This removes the whole SAHPool directory (all of its access-handle files), so\n * it must not run while a worker still holds those handles — call it only after\n * the runtime has been torn down.\n */\nexport async function purgeOpfsSqliteDatabase(dbName: string): Promise<void> {\n if (\n typeof navigator !== \"object\" ||\n !hasStorageDirectory(navigator.storage)\n ) {\n return;\n }\n\n // `directory` is an OPFS-absolute path like `/tearleads-sqlite/<segment>`;\n // navigate it segment-by-segment from the OPFS root.\n const { directory } = persistentSahPoolStorageForDbName(dbName);\n const segments = directory.split(\"/\").filter((segment) => segment.length > 0);\n if (segments.length === 0) {\n return;\n }\n\n const leaf = segments[segments.length - 1];\n if (leaf === undefined) {\n return;\n }\n const parents = segments.slice(0, -1);\n\n let dir = await navigator.storage.getDirectory();\n try {\n for (const parent of parents) {\n dir = await dir.getDirectoryHandle(parent);\n }\n await dir.removeEntry(leaf, { recursive: true });\n } catch (error) {\n if (isNotFound(error)) {\n return;\n }\n throw error;\n }\n}\n"]}
1
+ {"version":3,"file":"purgeOpfsDatabase.js","sourceRoot":"","sources":["purgeOpfsDatabase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,MAAM,kBAAkB,CAAC;AAMrE,SAAS,mBAAmB,CAC1B,OAAmC;IAEnC,OAAO,CACL,OAAO,KAAK,SAAS;QACrB,cAAc,IAAI,OAAO;QACzB,OAAO,OAAO,CAAC,YAAY,KAAK,UAAU,CAC3C,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,KAAK,YAAY,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,CAAC;AACzE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAAc,EACd,UAAyB,GAAG,EAAE,CAAC,IAAI;IAEnC,IACE,OAAO,SAAS,KAAK,QAAQ;QAC7B,CAAC,mBAAmB,CAAC,SAAS,CAAC,OAAO,CAAC,EACvC,CAAC;QACD,OAAO;IACT,CAAC;IAED,2EAA2E;IAC3E,qDAAqD;IACrD,MAAM,EAAE,SAAS,EAAE,GAAG,iCAAiC,CAAC,MAAM,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9E,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO;IACT,CAAC;IACD,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAEtC,IAAI,GAAG,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;IACjD,IAAI,CAAC;QACH,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,GAAG,GAAG,MAAM,GAAG,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC7C,CAAC;QACD,IAAI,OAAO,EAAE;YAAE,MAAM,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC","sourcesContent":["import { persistentSahPoolStorageForDbName } from \"./sahPoolStorage\";\n\ninterface StorageDirectoryProvider {\n getDirectory: () => Promise<FileSystemDirectoryHandle>;\n}\n\nfunction hasStorageDirectory(\n storage: StorageManager | undefined,\n): storage is StorageManager & StorageDirectoryProvider {\n return (\n storage !== undefined &&\n \"getDirectory\" in storage &&\n typeof storage.getDirectory === \"function\"\n );\n}\n\nfunction isNotFound(error: unknown): boolean {\n return error instanceof DOMException && error.name === \"NotFoundError\";\n}\n\n/**\n * Main-thread fallback that deletes the OPFS directory backing a persistent\n * database's SAHPool VFS, by database name. Use when no worker is alive to run\n * the in-worker `delete` op (worker cleared/killed/failed to boot) but the\n * persisted SQLite files must still be wiped — e.g. logging out and discarding\n * local data. No-op when OPFS is unavailable or the directory was never\n * created; never throws on a missing directory.\n *\n * This removes the whole SAHPool directory (all of its access-handle files), so\n * it must not run while a worker still holds those handles — call it only after\n * the runtime has been torn down.\n */\nexport async function purgeOpfsSqliteDatabase(\n dbName: string,\n current: () => boolean = () => true,\n): Promise<void> {\n if (\n typeof navigator !== \"object\" ||\n !hasStorageDirectory(navigator.storage)\n ) {\n return;\n }\n\n // `directory` is an OPFS-absolute path like `/tearleads-sqlite/<segment>`;\n // navigate it segment-by-segment from the OPFS root.\n const { directory } = persistentSahPoolStorageForDbName(dbName);\n const segments = directory.split(\"/\").filter((segment) => segment.length > 0);\n if (segments.length === 0) {\n return;\n }\n\n const leaf = segments[segments.length - 1];\n if (leaf === undefined) {\n return;\n }\n const parents = segments.slice(0, -1);\n\n let dir = await navigator.storage.getDirectory();\n try {\n for (const parent of parents) {\n dir = await dir.getDirectoryHandle(parent);\n }\n if (current()) await dir.removeEntry(leaf, { recursive: true });\n } catch (error) {\n if (isNotFound(error)) {\n return;\n }\n throw error;\n }\n}\n"]}
@@ -77,6 +77,10 @@ export interface WorkerRequestMap {
77
77
  params: undefined;
78
78
  result: DatabaseWorkerClosed;
79
79
  };
80
+ prepareDelete: {
81
+ params: undefined;
82
+ result: DatabaseWorkerReady;
83
+ };
80
84
  delete: {
81
85
  params: undefined;
82
86
  result: DatabaseWorkerDeleted;
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"AAqHA,MAAM,CAAC,MAAM,gCAAgC,GAAG,+BAA+B,CAAC;AAChF,MAAM,CAAC,MAAM,mCAAmC,GAC9C,kCAAkC,CAAC;AACrC,MAAM,CAAC,MAAM,qCAAqC,GAChD,oCAAoC,CAAC","sourcesContent":["export type CipherName =\n | \"sqlcipher\"\n | \"chacha20\"\n | \"aes128cbc\"\n | \"aes256cbc\"\n | \"ascon128\";\n\n/**\n * Where the database file lives.\n *\n * - `\"memory\"`: transient in-memory database (the historical default). Wiped on\n * every reload / worker restart.\n * - `\"opfs-sahpool\"`: persistent database backed by the OPFS SyncAccessHandle\n * Pool VFS. Survives reloads (including hard / shift+reload) because the bytes\n * live in the Origin Private File System, not in the worker heap or the HTTP\n * cache. Requires neither `SharedArrayBuffer` nor COOP/COEP headers.\n *\n * When `\"opfs-sahpool\"` is requested but OPFS is unavailable (or the VFS fails\n * to install), `initDatabase` throws rather than silently degrading to memory —\n * persistence is opt-in and a missing backend is treated as a hard error.\n */\nexport type DatabasePersistenceMode = \"memory\" | \"opfs-sahpool\";\n\nexport interface DatabaseWorkerInitOptions {\n dbName: string;\n cipher: CipherName;\n key: string;\n /**\n * Storage backend for the database. Defaults to `\"memory\"` to preserve the\n * historical behavior for callers that do not opt into persistence.\n */\n persistence?: DatabasePersistenceMode;\n}\n\nexport type SqliteBindValue = string | number | null;\nexport type SqliteBind =\n | Record<string, SqliteBindValue>\n | ReadonlyArray<SqliteBindValue>;\nexport type SqliteRowMode = \"object\" | \"array\";\nexport type SqliteObjectRow = Record<string, SqliteBindValue>;\nexport type SqliteArrayRow = SqliteBindValue[];\nexport type SqliteRow = SqliteObjectRow | SqliteArrayRow;\n\nexport interface DatabaseWorkerExecOptions {\n sql: string;\n bind?: SqliteBind;\n rowMode?: SqliteRowMode;\n}\n\nexport interface DatabaseWorkerExecResult {\n ok: true;\n rows: SqliteRow[];\n}\n\nexport interface DatabaseWorkerReady {\n ok: true;\n}\n\nexport interface DatabaseWorkerClosed {\n ok: true;\n}\n\nexport interface DatabaseWorkerDeleted {\n ok: true;\n}\n\nexport interface DatabaseWorkerStorageWiped {\n ok: true;\n}\n\nexport interface DatabaseWorkerPingResult {\n ok: true;\n message: \"pong\";\n}\n\nexport interface DatabaseWorkerError {\n ok: false;\n message: string;\n}\n\nexport type DatabaseWorkerResult<T> = T | DatabaseWorkerError;\n\nexport interface WorkerRequestMap {\n ping: {\n params: undefined;\n result: DatabaseWorkerPingResult;\n };\n init: {\n params: DatabaseWorkerInitOptions;\n result: DatabaseWorkerReady;\n };\n exec: {\n params: DatabaseWorkerExecOptions;\n result: DatabaseWorkerExecResult;\n };\n // Graceful shutdown: close the db and release the persistent VFS's OPFS access\n // handles before the worker is terminated, so the next worker (reload / other\n // tab) can acquire them without losing the SAHPool lock-contention race.\n close: {\n params: undefined;\n result: DatabaseWorkerClosed;\n };\n // Destructive shutdown: close the db and WIPE the persistent VFS's OPFS files\n // (not merely release the handles). Used to forget local data on logout.\n delete: {\n params: undefined;\n result: DatabaseWorkerDeleted;\n };\n // Device reset: remove everything in this origin's OPFS from the worker, for\n // shells whose main thread has no OPFS (WKWebView). Rejected once this worker\n // has opened persistent storage, whose access handles it would still hold.\n wipeStorage: {\n params: undefined;\n result: DatabaseWorkerStorageWiped;\n };\n}\n\nexport const WORKER_CONNECT_PORT_MESSAGE_TYPE = \"tearleads:sqlite-connect-port\";\nexport const WORKER_DISCONNECT_PORT_MESSAGE_TYPE =\n \"tearleads:sqlite-disconnect-port\";\nexport const WORKER_PORT_DISCONNECTED_MESSAGE_TYPE =\n \"tearleads:sqlite-port-disconnected\";\n\nexport type WorkerMethod = keyof WorkerRequestMap;\n\nexport type WorkerRequest<K extends WorkerMethod = WorkerMethod> =\n K extends WorkerMethod\n ? {\n id: number;\n method: K;\n params: WorkerRequestMap[K][\"params\"];\n }\n : never;\n\nexport type WorkerResponse<K extends WorkerMethod = WorkerMethod> =\n K extends WorkerMethod\n ? {\n id: number;\n result: DatabaseWorkerResult<WorkerRequestMap[K][\"result\"]>;\n }\n : never;\n"]}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"AA0HA,MAAM,CAAC,MAAM,gCAAgC,GAAG,+BAA+B,CAAC;AAChF,MAAM,CAAC,MAAM,mCAAmC,GAC9C,kCAAkC,CAAC;AACrC,MAAM,CAAC,MAAM,qCAAqC,GAChD,oCAAoC,CAAC","sourcesContent":["export type CipherName =\n | \"sqlcipher\"\n | \"chacha20\"\n | \"aes128cbc\"\n | \"aes256cbc\"\n | \"ascon128\";\n\n/**\n * Where the database file lives.\n *\n * - `\"memory\"`: transient in-memory database (the historical default). Wiped on\n * every reload / worker restart.\n * - `\"opfs-sahpool\"`: persistent database backed by the OPFS SyncAccessHandle\n * Pool VFS. Survives reloads (including hard / shift+reload) because the bytes\n * live in the Origin Private File System, not in the worker heap or the HTTP\n * cache. Requires neither `SharedArrayBuffer` nor COOP/COEP headers.\n *\n * When `\"opfs-sahpool\"` is requested but OPFS is unavailable (or the VFS fails\n * to install), `initDatabase` throws rather than silently degrading to memory —\n * persistence is opt-in and a missing backend is treated as a hard error.\n */\nexport type DatabasePersistenceMode = \"memory\" | \"opfs-sahpool\";\n\nexport interface DatabaseWorkerInitOptions {\n dbName: string;\n cipher: CipherName;\n key: string;\n /**\n * Storage backend for the database. Defaults to `\"memory\"` to preserve the\n * historical behavior for callers that do not opt into persistence.\n */\n persistence?: DatabasePersistenceMode;\n}\n\nexport type SqliteBindValue = string | number | null;\nexport type SqliteBind =\n | Record<string, SqliteBindValue>\n | ReadonlyArray<SqliteBindValue>;\nexport type SqliteRowMode = \"object\" | \"array\";\nexport type SqliteObjectRow = Record<string, SqliteBindValue>;\nexport type SqliteArrayRow = SqliteBindValue[];\nexport type SqliteRow = SqliteObjectRow | SqliteArrayRow;\n\nexport interface DatabaseWorkerExecOptions {\n sql: string;\n bind?: SqliteBind;\n rowMode?: SqliteRowMode;\n}\n\nexport interface DatabaseWorkerExecResult {\n ok: true;\n rows: SqliteRow[];\n}\n\nexport interface DatabaseWorkerReady {\n ok: true;\n}\n\nexport interface DatabaseWorkerClosed {\n ok: true;\n}\n\nexport interface DatabaseWorkerDeleted {\n ok: true;\n}\n\nexport interface DatabaseWorkerStorageWiped {\n ok: true;\n}\n\nexport interface DatabaseWorkerPingResult {\n ok: true;\n message: \"pong\";\n}\n\nexport interface DatabaseWorkerError {\n ok: false;\n message: string;\n}\n\nexport type DatabaseWorkerResult<T> = T | DatabaseWorkerError;\n\nexport interface WorkerRequestMap {\n ping: {\n params: undefined;\n result: DatabaseWorkerPingResult;\n };\n init: {\n params: DatabaseWorkerInitOptions;\n result: DatabaseWorkerReady;\n };\n exec: {\n params: DatabaseWorkerExecOptions;\n result: DatabaseWorkerExecResult;\n };\n // Graceful shutdown: close the db and release the persistent VFS's OPFS access\n // handles before the worker is terminated, so the next worker (reload / other\n // tab) can acquire them without losing the SAHPool lock-contention race.\n close: {\n params: undefined;\n result: DatabaseWorkerClosed;\n };\n // Drain previously accepted database work before the host authorizes a wipe.\n prepareDelete: {\n params: undefined;\n result: DatabaseWorkerReady;\n };\n // Destructive shutdown: close the db and WIPE the persistent VFS's OPFS files\n // (not merely release the handles). Used to forget local data on logout.\n delete: {\n params: undefined;\n result: DatabaseWorkerDeleted;\n };\n // Device reset: remove everything in this origin's OPFS from the worker, for\n // shells whose main thread has no OPFS (WKWebView). Rejected once this worker\n // has opened persistent storage, whose access handles it would still hold.\n wipeStorage: {\n params: undefined;\n result: DatabaseWorkerStorageWiped;\n };\n}\n\nexport const WORKER_CONNECT_PORT_MESSAGE_TYPE = \"tearleads:sqlite-connect-port\";\nexport const WORKER_DISCONNECT_PORT_MESSAGE_TYPE =\n \"tearleads:sqlite-disconnect-port\";\nexport const WORKER_PORT_DISCONNECTED_MESSAGE_TYPE =\n \"tearleads:sqlite-port-disconnected\";\n\nexport type WorkerMethod = keyof WorkerRequestMap;\n\nexport type WorkerRequest<K extends WorkerMethod = WorkerMethod> =\n K extends WorkerMethod\n ? {\n id: number;\n method: K;\n params: WorkerRequestMap[K][\"params\"];\n }\n : never;\n\nexport type WorkerResponse<K extends WorkerMethod = WorkerMethod> =\n K extends WorkerMethod\n ? {\n id: number;\n result: DatabaseWorkerResult<WorkerRequestMap[K][\"result\"]>;\n }\n : never;\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tearleads/client-sdk",
3
- "version": "0.1.251",
3
+ "version": "0.1.252",
4
4
  "description": "React-free Tearleads client runtime: local SQLite persistence, keys, sync, encrypted blobs, and domain workflows.",
5
5
  "license": "UNLICENSED",
6
6
  "repository": {