@oxy.so/core 1.18.1 → 3.0.0
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.
- package/README.md +13 -7
- package/dist/cjs/HttpService.js +159 -111
- package/dist/cjs/OxyServices.errors.js +48 -1
- package/dist/cjs/OxyServices.js +263 -60
- package/dist/cjs/api/accounts.js +231 -0
- package/dist/cjs/api/agency.js +102 -0
- package/dist/cjs/api/appData.js +45 -0
- package/dist/cjs/api/apps.js +197 -0
- package/dist/cjs/api/assets.js +329 -0
- package/dist/cjs/api/auth.js +900 -0
- package/dist/cjs/api/billing.js +44 -0
- package/dist/cjs/api/civic.js +289 -0
- package/dist/cjs/api/contacts.js +16 -0
- package/dist/cjs/api/devices.js +351 -0
- package/dist/cjs/api/follows.js +240 -0
- package/dist/cjs/api/identity.js +569 -0
- package/dist/cjs/api/linkedAccounts.js +48 -0
- package/dist/cjs/api/nodes.js +75 -0
- package/dist/cjs/api/notifications.js +75 -0
- package/dist/cjs/api/privacy.js +105 -0
- package/dist/cjs/api/reputation.js +74 -0
- package/dist/cjs/api/session.js +177 -0
- package/dist/cjs/api/store.js +199 -0
- package/dist/cjs/api/topics.js +66 -0
- package/dist/cjs/api/users.js +309 -0
- package/dist/cjs/boot/sessionColdBoot.js +4 -4
- package/dist/cjs/civic/index.js +16 -0
- package/dist/cjs/civic/payloads.js +156 -0
- package/dist/cjs/client/context.js +2 -0
- package/dist/cjs/crypto/identityLink.js +5 -5
- package/dist/cjs/crypto/index.js +44 -0
- package/dist/cjs/crypto/internal.js +37 -0
- package/dist/cjs/crypto/keyManager.js +2 -2
- package/dist/cjs/crypto/polyfill.js +9 -80
- package/dist/cjs/crypto/recoveryPhrase.js +1 -0
- package/dist/cjs/crypto/registrationPow.js +1 -1
- package/dist/cjs/crypto/signatureService.js +1 -0
- package/dist/cjs/i18n/accountCategoryLabels.js +3 -3
- package/dist/cjs/i18n/accountRoleLabels.js +7 -7
- package/dist/cjs/i18n/index.js +130 -52
- package/dist/cjs/i18n/locales/{ar-SA.json → ar-SA.js} +134 -52
- package/dist/cjs/i18n/locales/{ca-ES.json → ca-ES.js} +134 -52
- package/dist/{esm/i18n/locales/de-DE.json → cjs/i18n/locales/de-DE.js} +136 -54
- package/dist/{esm/i18n/locales/en-US.json → cjs/i18n/locales/en-US.js} +163 -245
- package/dist/{esm/i18n/locales/es-ES.json → cjs/i18n/locales/es-ES.js} +163 -245
- package/dist/cjs/i18n/locales/{fr-FR.json → fr-FR.js} +134 -52
- package/dist/cjs/i18n/locales/{it-IT.json → it-IT.js} +134 -52
- package/dist/{esm/i18n/locales/ja-JP.json → cjs/i18n/locales/ja-JP.js} +134 -52
- package/dist/cjs/i18n/locales/{ko-KR.json → ko-KR.js} +134 -52
- package/dist/{esm/i18n/locales/pt-PT.json → cjs/i18n/locales/pt-PT.js} +136 -54
- package/dist/{esm/i18n/locales/zh-CN.json → cjs/i18n/locales/zh-CN.js} +135 -53
- package/dist/cjs/i18n/reputationCategoryLabels.js +2 -2
- package/dist/cjs/i18n/trustTierLabels.js +2 -2
- package/dist/cjs/index.js +55 -263
- package/dist/cjs/inference/index.js +21 -0
- package/dist/cjs/server/OxyServer.js +521 -0
- package/dist/cjs/server/auth.js +2 -2
- package/dist/cjs/server/index.js +23 -6
- package/dist/cjs/server/middleware.js +1154 -0
- package/dist/cjs/server/namespaces.js +214 -0
- package/dist/cjs/server/rateLimit.js +2 -2
- package/dist/cjs/server/requesterAssertion.js +5 -5
- package/dist/cjs/server/securityHeaders.js +3 -3
- package/dist/cjs/server/traffic.js +7 -6
- package/dist/cjs/server/trafficNodeHttp.js +9 -3
- package/dist/cjs/server/userInvalidation.js +5 -5
- package/dist/cjs/session/accountDialogController.js +23 -23
- package/dist/cjs/session/authStateStore.js +2 -2
- package/dist/cjs/session/identitySession.js +3 -3
- package/dist/cjs/session/index.js +131 -0
- package/dist/cjs/session/refresh.js +37 -30
- package/dist/cjs/session/sessionClientHost.js +5 -5
- package/dist/cjs/session/sharedDeviceCredential.js +3 -2
- package/dist/cjs/shared/utils/networkUtils.js +2 -2
- package/dist/cjs/utils/accountCacheSweep.js +11 -15
- package/dist/cjs/utils/asyncUtils.js +22 -163
- package/dist/cjs/utils/authHelpers.js +2 -2
- package/dist/cjs/utils/authWebUrl.js +3 -4
- package/dist/cjs/utils/avatarUtils.js +2 -2
- package/dist/cjs/utils/cache.js +32 -2
- package/dist/cjs/utils/cacheKey.js +5 -10
- package/dist/cjs/utils/deviceManager.js +17 -16
- package/dist/cjs/utils/edgeRegion.js +2 -3
- package/dist/cjs/utils/identityCacheSweep.js +6 -10
- package/dist/cjs/utils/oxyServiceEnvironment.js +3 -7
- package/dist/cjs/utils/requestUtils.js +40 -33
- package/dist/cjs/utils/sessionUtils.js +0 -2
- package/dist/cjs/utils/tokenClaims.js +34 -0
- package/dist/esm/HttpService.js +160 -112
- package/dist/esm/OxyServices.errors.js +45 -0
- package/dist/esm/OxyServices.js +262 -57
- package/dist/esm/api/accounts.js +218 -0
- package/dist/esm/api/agency.js +95 -0
- package/dist/esm/api/appData.js +40 -0
- package/dist/esm/api/apps.js +191 -0
- package/dist/esm/api/assets.js +324 -0
- package/dist/esm/api/auth.js +858 -0
- package/dist/esm/api/billing.js +40 -0
- package/dist/esm/api/civic.js +250 -0
- package/dist/esm/api/contacts.js +12 -0
- package/dist/esm/api/devices.js +346 -0
- package/dist/esm/api/follows.js +236 -0
- package/dist/esm/api/identity.js +527 -0
- package/dist/esm/api/linkedAccounts.js +44 -0
- package/dist/esm/api/nodes.js +71 -0
- package/dist/esm/api/notifications.js +71 -0
- package/dist/esm/api/privacy.js +101 -0
- package/dist/esm/api/reputation.js +70 -0
- package/dist/esm/api/session.js +173 -0
- package/dist/esm/api/store.js +192 -0
- package/dist/esm/api/topics.js +62 -0
- package/dist/esm/api/users.js +272 -0
- package/dist/esm/boot/sessionColdBoot.js +4 -4
- package/dist/esm/civic/index.js +10 -0
- package/dist/esm/civic/payloads.js +118 -0
- package/dist/esm/client/context.js +1 -0
- package/dist/esm/crypto/identityLink.js +5 -5
- package/dist/esm/crypto/index.js +24 -0
- package/dist/esm/crypto/internal.js +19 -0
- package/dist/esm/crypto/keyManager.js +2 -2
- package/dist/esm/crypto/polyfill.js +10 -81
- package/dist/esm/crypto/recoveryPhrase.js +1 -0
- package/dist/esm/crypto/registrationPow.js +1 -1
- package/dist/esm/crypto/signatureService.js +1 -0
- package/dist/esm/i18n/accountCategoryLabels.js +2 -2
- package/dist/esm/i18n/accountRoleLabels.js +1 -1
- package/dist/esm/i18n/index.js +93 -52
- package/dist/esm/i18n/locales/{ar-SA.json → ar-SA.js} +132 -52
- package/dist/esm/i18n/locales/{ca-ES.json → ca-ES.js} +132 -52
- package/dist/{cjs/i18n/locales/de-DE.json → esm/i18n/locales/de-DE.js} +134 -54
- package/dist/{cjs/i18n/locales/en-US.json → esm/i18n/locales/en-US.js} +161 -245
- package/dist/{cjs/i18n/locales/es-ES.json → esm/i18n/locales/es-ES.js} +161 -245
- package/dist/esm/i18n/locales/{fr-FR.json → fr-FR.js} +132 -52
- package/dist/esm/i18n/locales/{it-IT.json → it-IT.js} +132 -52
- package/dist/{cjs/i18n/locales/ja-JP.json → esm/i18n/locales/ja-JP.js} +132 -52
- package/dist/esm/i18n/locales/{ko-KR.json → ko-KR.js} +132 -52
- package/dist/{cjs/i18n/locales/pt-PT.json → esm/i18n/locales/pt-PT.js} +134 -54
- package/dist/{cjs/i18n/locales/zh-CN.json → esm/i18n/locales/zh-CN.js} +133 -53
- package/dist/esm/i18n/reputationCategoryLabels.js +1 -1
- package/dist/esm/i18n/trustTierLabels.js +1 -1
- package/dist/esm/index.js +30 -166
- package/dist/esm/inference/index.js +13 -0
- package/dist/esm/server/OxyServer.js +516 -0
- package/dist/esm/server/auth.js +2 -2
- package/dist/esm/server/index.js +10 -5
- package/dist/esm/server/middleware.js +1147 -0
- package/dist/esm/server/namespaces.js +206 -0
- package/dist/esm/server/rateLimit.js +2 -2
- package/dist/esm/server/requesterAssertion.js +5 -5
- package/dist/esm/server/securityHeaders.js +3 -3
- package/dist/esm/server/traffic.js +7 -6
- package/dist/esm/server/trafficNodeHttp.js +9 -3
- package/dist/esm/server/userInvalidation.js +5 -5
- package/dist/esm/session/accountDialogController.js +23 -23
- package/dist/esm/session/authStateStore.js +2 -2
- package/dist/esm/session/identitySession.js +3 -3
- package/dist/esm/session/index.js +82 -0
- package/dist/esm/session/refresh.js +37 -30
- package/dist/esm/session/sessionClientHost.js +5 -5
- package/dist/esm/session/sharedDeviceCredential.js +3 -2
- package/dist/esm/shared/utils/networkUtils.js +2 -2
- package/dist/esm/utils/accountCacheSweep.js +11 -15
- package/dist/esm/utils/asyncUtils.js +22 -151
- package/dist/esm/utils/authHelpers.js +2 -2
- package/dist/esm/utils/authWebUrl.js +3 -4
- package/dist/esm/utils/avatarUtils.js +2 -2
- package/dist/esm/utils/cache.js +32 -2
- package/dist/esm/utils/cacheKey.js +5 -10
- package/dist/esm/utils/deviceManager.js +17 -16
- package/dist/esm/utils/edgeRegion.js +1 -2
- package/dist/esm/utils/identityCacheSweep.js +6 -10
- package/dist/esm/utils/oxyServiceEnvironment.js +3 -7
- package/dist/esm/utils/requestUtils.js +40 -33
- package/dist/esm/utils/sessionUtils.js +0 -2
- package/dist/esm/utils/tokenClaims.js +31 -0
- package/dist/types/HttpService.d.ts +26 -9
- package/dist/types/OxyServices.d.ts +160 -131
- package/dist/types/OxyServices.errors.d.ts +42 -0
- package/dist/types/api/accounts.d.ts +415 -0
- package/dist/types/api/agency.d.ts +135 -0
- package/dist/types/api/appData.d.ts +27 -0
- package/dist/types/api/apps.d.ts +433 -0
- package/dist/types/api/assets.d.ts +174 -0
- package/dist/types/api/auth.d.ts +766 -0
- package/dist/types/api/billing.d.ts +113 -0
- package/dist/types/api/civic.d.ts +203 -0
- package/dist/types/api/contacts.d.ts +31 -0
- package/{src/mixins/OxyServices.deviceBoot.ts → dist/types/api/devices.d.ts} +130 -110
- package/dist/types/api/follows.d.ts +236 -0
- package/dist/types/api/identity.d.ts +275 -0
- package/dist/types/api/linkedAccounts.d.ts +48 -0
- package/dist/types/api/nodes.d.ts +102 -0
- package/dist/types/api/notifications.d.ts +77 -0
- package/dist/types/api/privacy.d.ts +43 -0
- package/dist/types/api/reputation.d.ts +50 -0
- package/dist/types/api/session.d.ts +85 -0
- package/dist/types/api/store.d.ts +278 -0
- package/dist/types/api/topics.d.ts +34 -0
- package/dist/types/api/users.d.ts +134 -0
- package/dist/types/boot/sessionColdBoot.d.ts +1 -1
- package/dist/types/civic/index.d.ts +10 -0
- package/dist/types/civic/payloads.d.ts +83 -0
- package/dist/types/client/context.d.ts +33 -0
- package/dist/types/crypto/identityLink.d.ts +5 -5
- package/dist/types/crypto/index.d.ts +24 -0
- package/dist/types/crypto/internal.d.ts +19 -0
- package/dist/types/crypto/polyfill.d.ts +6 -9
- package/dist/types/crypto/registrationPow.d.ts +1 -1
- package/dist/types/i18n/accountCategoryLabels.d.ts +1 -1
- package/dist/types/i18n/accountRoleLabels.d.ts +1 -1
- package/dist/types/i18n/index.d.ts +20 -1
- package/dist/types/i18n/locales/ar-SA.d.ts +386 -0
- package/dist/types/i18n/locales/ca-ES.d.ts +386 -0
- package/dist/types/i18n/locales/de-DE.d.ts +386 -0
- package/dist/types/i18n/locales/en-US.d.ts +2034 -0
- package/dist/types/i18n/locales/es-ES.d.ts +2034 -0
- package/dist/types/i18n/locales/fr-FR.d.ts +386 -0
- package/dist/types/i18n/locales/it-IT.d.ts +386 -0
- package/dist/types/i18n/locales/ja-JP.d.ts +386 -0
- package/dist/types/i18n/locales/ko-KR.d.ts +386 -0
- package/dist/types/i18n/locales/pt-PT.d.ts +386 -0
- package/dist/types/i18n/locales/zh-CN.d.ts +386 -0
- package/dist/types/index.d.ts +46 -95
- package/dist/types/inference/index.d.ts +22 -0
- package/dist/types/models/interfaces.d.ts +1 -22
- package/dist/types/server/OxyServer.d.ts +183 -0
- package/dist/types/server/auth.d.ts +10 -7
- package/dist/types/server/index.d.ts +10 -4
- package/dist/types/server/middleware.d.ts +291 -0
- package/dist/types/server/namespaces.d.ts +98 -0
- package/dist/types/server/rateLimit.d.ts +7 -5
- package/dist/types/server/requesterAssertion.d.ts +14 -11
- package/dist/types/server/securityHeaders.d.ts +4 -5
- package/dist/types/server/userInvalidation.d.ts +10 -8
- package/dist/types/session/accountDelegationAccess.d.ts +1 -1
- package/dist/types/session/accountDialogController.d.ts +8 -8
- package/dist/types/session/accountSwitchTargets.d.ts +1 -1
- package/dist/types/session/authStateStore.d.ts +7 -6
- package/dist/types/session/index.d.ts +40 -0
- package/dist/types/utils/accountCacheSweep.d.ts +7 -10
- package/dist/types/utils/apiUtils.d.ts +3 -3
- package/dist/types/utils/asyncUtils.d.ts +11 -58
- package/dist/types/utils/authWebUrl.d.ts +3 -4
- package/dist/types/utils/avatarUtils.d.ts +5 -6
- package/dist/types/utils/cache.d.ts +11 -3
- package/dist/types/utils/commonsApproval.d.ts +1 -1
- package/dist/types/utils/edgeRegion.d.ts +1 -2
- package/dist/types/utils/identityCacheSweep.d.ts +6 -4
- package/dist/types/utils/oauthPkce.d.ts +2 -2
- package/dist/types/utils/oxyServiceEnvironment.d.ts +3 -7
- package/dist/types/utils/requestUtils.d.ts +18 -14
- package/dist/types/utils/tokenClaims.d.ts +9 -0
- package/package.json +68 -7
- package/src/HttpService.ts +166 -131
- package/src/OxyServices.errors.ts +73 -0
- package/src/OxyServices.ts +289 -164
- package/src/api/accounts.ts +579 -0
- package/src/api/agency.ts +277 -0
- package/src/api/appData.ts +63 -0
- package/src/api/apps.ts +596 -0
- package/src/api/assets.ts +416 -0
- package/src/api/auth.ts +1457 -0
- package/src/api/billing.ts +144 -0
- package/src/api/civic.ts +428 -0
- package/src/api/contacts.ts +41 -0
- package/src/api/devices.ts +438 -0
- package/src/api/follows.ts +414 -0
- package/src/api/identity.ts +727 -0
- package/src/api/linkedAccounts.ts +78 -0
- package/src/api/nodes.ts +169 -0
- package/src/api/notifications.ts +135 -0
- package/src/api/privacy.ts +120 -0
- package/src/api/reputation.ts +134 -0
- package/src/api/session.ts +210 -0
- package/src/api/store.ts +435 -0
- package/src/api/topics.ts +83 -0
- package/src/api/users.ts +357 -0
- package/src/boot/sessionColdBoot.ts +4 -4
- package/src/civic/index.ts +12 -0
- package/src/civic/payloads.ts +175 -0
- package/src/client/context.ts +34 -0
- package/src/crypto/identityLink.ts +5 -5
- package/src/crypto/index.ts +39 -0
- package/src/crypto/internal.ts +20 -0
- package/src/crypto/keyManager.ts +2 -2
- package/src/crypto/polyfill.ts +9 -89
- package/src/crypto/recoveryPhrase.ts +1 -0
- package/src/crypto/registrationPow.ts +1 -1
- package/src/crypto/signatureService.ts +1 -0
- package/src/i18n/accountCategoryLabels.ts +2 -2
- package/src/i18n/accountRoleLabels.ts +2 -2
- package/src/i18n/index.ts +105 -54
- package/src/i18n/locales/{ar-SA.json → ar-SA.ts} +132 -52
- package/src/i18n/locales/{ca-ES.json → ca-ES.ts} +132 -52
- package/{dist/cjs/i18n/locales/locales/de-DE.json → src/i18n/locales/de-DE.ts} +134 -54
- package/src/i18n/locales/{en-US.json → en-US.ts} +161 -245
- package/{dist/cjs/i18n/locales/locales/es-ES.json → src/i18n/locales/es-ES.ts} +161 -245
- package/src/i18n/locales/{fr-FR.json → fr-FR.ts} +132 -52
- package/src/i18n/locales/{it-IT.json → it-IT.ts} +132 -52
- package/{dist/cjs/i18n/locales/locales/ja-JP.json → src/i18n/locales/ja-JP.ts} +132 -52
- package/src/i18n/locales/{ko-KR.json → ko-KR.ts} +132 -52
- package/src/i18n/locales/{pt-PT.json → pt-PT.ts} +134 -54
- package/src/i18n/locales/{zh-CN.json → zh-CN.ts} +133 -53
- package/src/i18n/reputationCategoryLabels.ts +1 -1
- package/src/i18n/trustTierLabels.ts +1 -1
- package/src/index.ts +170 -501
- package/src/inference/index.ts +48 -0
- package/src/models/interfaces.ts +1 -22
- package/src/server/OxyServer.ts +637 -0
- package/src/server/auth.ts +12 -8
- package/src/server/index.ts +28 -5
- package/src/server/middleware.ts +1520 -0
- package/src/server/namespaces.ts +257 -0
- package/src/server/rateLimit.ts +10 -9
- package/src/server/requesterAssertion.ts +13 -10
- package/src/server/securityHeaders.ts +7 -8
- package/src/server/traffic.ts +6 -6
- package/src/server/trafficNodeHttp.ts +7 -3
- package/src/server/userInvalidation.ts +9 -9
- package/src/session/accountDelegationAccess.ts +1 -1
- package/src/session/accountDialogController.ts +24 -24
- package/src/session/accountSwitchTargets.ts +1 -1
- package/src/session/authStateStore.ts +9 -8
- package/src/session/identitySession.ts +3 -3
- package/src/session/index.ts +210 -0
- package/src/session/refresh.ts +36 -30
- package/src/session/sessionClientHost.ts +5 -5
- package/src/session/sharedDeviceCredential.ts +3 -2
- package/src/shared/utils/networkUtils.ts +2 -2
- package/src/utils/accountCacheSweep.ts +11 -15
- package/src/utils/apiUtils.ts +3 -3
- package/src/utils/asyncUtils.ts +38 -235
- package/src/utils/authHelpers.ts +2 -2
- package/src/utils/authWebUrl.ts +3 -4
- package/src/utils/avatarUtils.ts +4 -7
- package/src/utils/cache.ts +36 -5
- package/src/utils/cacheKey.ts +5 -9
- package/src/utils/commonsApproval.ts +1 -1
- package/src/utils/deviceManager.ts +17 -16
- package/src/utils/edgeRegion.ts +1 -2
- package/src/utils/identityCacheSweep.ts +7 -12
- package/src/utils/oauthPkce.ts +2 -2
- package/src/utils/oxyServiceEnvironment.ts +3 -7
- package/src/utils/requestUtils.ts +48 -44
- package/src/utils/sessionUtils.ts +0 -2
- package/src/utils/tokenClaims.ts +38 -0
- package/dist/cjs/.tsbuildinfo +0 -1
- package/dist/cjs/OxyServices.base.js +0 -392
- package/dist/cjs/i18n/locales/locales/ar-SA.json +0 -306
- package/dist/cjs/i18n/locales/locales/ca-ES.json +0 -306
- package/dist/cjs/i18n/locales/locales/en-US.json +0 -2127
- package/dist/cjs/i18n/locales/locales/fr-FR.json +0 -306
- package/dist/cjs/i18n/locales/locales/it-IT.json +0 -306
- package/dist/cjs/i18n/locales/locales/ko-KR.json +0 -306
- package/dist/cjs/i18n/locales/locales/pt-PT.json +0 -306
- package/dist/cjs/i18n/locales/locales/zh-CN.json +0 -306
- package/dist/cjs/mixins/OxyServices.accounts.js +0 -555
- package/dist/cjs/mixins/OxyServices.agency.js +0 -154
- package/dist/cjs/mixins/OxyServices.analytics.js +0 -49
- package/dist/cjs/mixins/OxyServices.appData.js +0 -108
- package/dist/cjs/mixins/OxyServices.assets.js +0 -854
- package/dist/cjs/mixins/OxyServices.auth.js +0 -1495
- package/dist/cjs/mixins/OxyServices.chains.js +0 -73
- package/dist/cjs/mixins/OxyServices.civic.js +0 -611
- package/dist/cjs/mixins/OxyServices.connectedApps.js +0 -95
- package/dist/cjs/mixins/OxyServices.contacts.js +0 -50
- package/dist/cjs/mixins/OxyServices.deviceBoot.js +0 -191
- package/dist/cjs/mixins/OxyServices.devices.js +0 -116
- package/dist/cjs/mixins/OxyServices.features.js +0 -335
- package/dist/cjs/mixins/OxyServices.followGraph.js +0 -221
- package/dist/cjs/mixins/OxyServices.identity.js +0 -562
- package/dist/cjs/mixins/OxyServices.identityBackup.js +0 -172
- package/dist/cjs/mixins/OxyServices.inference.js +0 -59
- package/dist/cjs/mixins/OxyServices.language.js +0 -125
- package/dist/cjs/mixins/OxyServices.linkedAccounts.js +0 -79
- package/dist/cjs/mixins/OxyServices.location.js +0 -43
- package/dist/cjs/mixins/OxyServices.nodes.js +0 -175
- package/dist/cjs/mixins/OxyServices.notifications.js +0 -63
- package/dist/cjs/mixins/OxyServices.payment.js +0 -158
- package/dist/cjs/mixins/OxyServices.privacy.js +0 -199
- package/dist/cjs/mixins/OxyServices.reputation.js +0 -289
- package/dist/cjs/mixins/OxyServices.security.js +0 -89
- package/dist/cjs/mixins/OxyServices.store.js +0 -266
- package/dist/cjs/mixins/OxyServices.topics.js +0 -137
- package/dist/cjs/mixins/OxyServices.user.js +0 -954
- package/dist/cjs/mixins/OxyServices.utility.js +0 -1402
- package/dist/cjs/mixins/index.js +0 -136
- package/dist/cjs/mixins/mixinHelpers.js +0 -53
- package/dist/cjs/utils/webauthnOrigin.js +0 -51
- package/dist/esm/.tsbuildinfo +0 -1
- package/dist/esm/OxyServices.base.js +0 -388
- package/dist/esm/i18n/locales/locales/ar-SA.json +0 -306
- package/dist/esm/i18n/locales/locales/ca-ES.json +0 -306
- package/dist/esm/i18n/locales/locales/de-DE.json +0 -306
- package/dist/esm/i18n/locales/locales/en-US.json +0 -2127
- package/dist/esm/i18n/locales/locales/es-ES.json +0 -2127
- package/dist/esm/i18n/locales/locales/fr-FR.json +0 -306
- package/dist/esm/i18n/locales/locales/it-IT.json +0 -306
- package/dist/esm/i18n/locales/locales/ja-JP.json +0 -306
- package/dist/esm/i18n/locales/locales/ko-KR.json +0 -306
- package/dist/esm/i18n/locales/locales/pt-PT.json +0 -306
- package/dist/esm/i18n/locales/locales/zh-CN.json +0 -306
- package/dist/esm/mixins/OxyServices.accounts.js +0 -543
- package/dist/esm/mixins/OxyServices.agency.js +0 -151
- package/dist/esm/mixins/OxyServices.analytics.js +0 -46
- package/dist/esm/mixins/OxyServices.appData.js +0 -103
- package/dist/esm/mixins/OxyServices.assets.js +0 -851
- package/dist/esm/mixins/OxyServices.auth.js +0 -1455
- package/dist/esm/mixins/OxyServices.chains.js +0 -70
- package/dist/esm/mixins/OxyServices.civic.js +0 -605
- package/dist/esm/mixins/OxyServices.connectedApps.js +0 -92
- package/dist/esm/mixins/OxyServices.contacts.js +0 -47
- package/dist/esm/mixins/OxyServices.deviceBoot.js +0 -186
- package/dist/esm/mixins/OxyServices.devices.js +0 -113
- package/dist/esm/mixins/OxyServices.features.js +0 -332
- package/dist/esm/mixins/OxyServices.followGraph.js +0 -218
- package/dist/esm/mixins/OxyServices.identity.js +0 -558
- package/dist/esm/mixins/OxyServices.identityBackup.js +0 -169
- package/dist/esm/mixins/OxyServices.inference.js +0 -56
- package/dist/esm/mixins/OxyServices.language.js +0 -122
- package/dist/esm/mixins/OxyServices.linkedAccounts.js +0 -76
- package/dist/esm/mixins/OxyServices.location.js +0 -40
- package/dist/esm/mixins/OxyServices.nodes.js +0 -172
- package/dist/esm/mixins/OxyServices.notifications.js +0 -60
- package/dist/esm/mixins/OxyServices.payment.js +0 -155
- package/dist/esm/mixins/OxyServices.privacy.js +0 -196
- package/dist/esm/mixins/OxyServices.reputation.js +0 -286
- package/dist/esm/mixins/OxyServices.security.js +0 -86
- package/dist/esm/mixins/OxyServices.store.js +0 -263
- package/dist/esm/mixins/OxyServices.topics.js +0 -134
- package/dist/esm/mixins/OxyServices.user.js +0 -951
- package/dist/esm/mixins/OxyServices.utility.js +0 -1397
- package/dist/esm/mixins/index.js +0 -133
- package/dist/esm/mixins/mixinHelpers.js +0 -48
- package/dist/esm/utils/webauthnOrigin.js +0 -48
- package/dist/types/.tsbuildinfo +0 -1
- package/dist/types/OxyServices.base.d.ts +0 -189
- package/dist/types/mixins/OxyServices.accounts.d.ts +0 -868
- package/dist/types/mixins/OxyServices.agency.d.ts +0 -176
- package/dist/types/mixins/OxyServices.analytics.d.ts +0 -72
- package/dist/types/mixins/OxyServices.appData.d.ts +0 -108
- package/dist/types/mixins/OxyServices.assets.d.ts +0 -371
- package/dist/types/mixins/OxyServices.auth.d.ts +0 -998
- package/dist/types/mixins/OxyServices.chains.d.ts +0 -156
- package/dist/types/mixins/OxyServices.civic.d.ts +0 -520
- package/dist/types/mixins/OxyServices.connectedApps.d.ts +0 -184
- package/dist/types/mixins/OxyServices.contacts.d.ts +0 -100
- package/dist/types/mixins/OxyServices.deviceBoot.d.ts +0 -185
- package/dist/types/mixins/OxyServices.devices.d.ts +0 -103
- package/dist/types/mixins/OxyServices.features.d.ts +0 -250
- package/dist/types/mixins/OxyServices.followGraph.d.ts +0 -223
- package/dist/types/mixins/OxyServices.identity.d.ts +0 -337
- package/dist/types/mixins/OxyServices.identityBackup.d.ts +0 -129
- package/dist/types/mixins/OxyServices.inference.d.ts +0 -95
- package/dist/types/mixins/OxyServices.language.d.ts +0 -87
- package/dist/types/mixins/OxyServices.linkedAccounts.d.ts +0 -107
- package/dist/types/mixins/OxyServices.location.d.ts +0 -70
- package/dist/types/mixins/OxyServices.nodes.d.ts +0 -198
- package/dist/types/mixins/OxyServices.notifications.d.ts +0 -143
- package/dist/types/mixins/OxyServices.payment.d.ts +0 -117
- package/dist/types/mixins/OxyServices.privacy.d.ts +0 -146
- package/dist/types/mixins/OxyServices.reputation.d.ts +0 -202
- package/dist/types/mixins/OxyServices.security.d.ts +0 -84
- package/dist/types/mixins/OxyServices.store.d.ts +0 -334
- package/dist/types/mixins/OxyServices.topics.d.ts +0 -110
- package/dist/types/mixins/OxyServices.user.d.ts +0 -600
- package/dist/types/mixins/OxyServices.utility.d.ts +0 -526
- package/dist/types/mixins/index.d.ts +0 -87
- package/dist/types/mixins/mixinHelpers.d.ts +0 -31
- package/dist/types/utils/webauthnOrigin.d.ts +0 -32
- package/src/OxyServices.base.ts +0 -480
- package/src/__tests__/authSocket.test.ts +0 -96
- package/src/__tests__/fixEsmImports.test.ts +0 -132
- package/src/__tests__/httpServiceAbort.test.ts +0 -308
- package/src/__tests__/httpServiceActivityId.test.ts +0 -49
- package/src/__tests__/httpServiceAuthSelfAwait.test.ts +0 -108
- package/src/__tests__/httpServiceCache.test.ts +0 -318
- package/src/__tests__/httpServiceFormEncoded.test.ts +0 -139
- package/src/__tests__/httpServiceQueueDeadlock.test.ts +0 -128
- package/src/__tests__/httpServiceRateLimitedRefresh.test.ts +0 -160
- package/src/__tests__/httpServiceUnwrapEnvelope.test.ts +0 -115
- package/src/__tests__/httpServiceWrites.test.ts +0 -175
- package/src/__tests__/inSessionRefresh.test.ts +0 -313
- package/src/__tests__/linkedClient.test.ts +0 -363
- package/src/__tests__/nearExpiryMintStorm.test.ts +0 -165
- package/src/__tests__/parseHttpErrorBody.test.ts +0 -116
- package/src/__tests__/publicInterfaceParity.test.ts +0 -75
- package/src/__tests__/serverValueImportsDeclared.test.ts +0 -120
- package/src/__tests__/serviceIdentityWhenAnonymous.test.ts +0 -159
- package/src/__tests__/serviceTokenWorkloadFallback.test.ts +0 -85
- package/src/__tests__/userIdentity.test.ts +0 -143
- package/src/boot/__tests__/sessionColdBoot.identity.test.ts +0 -393
- package/src/boot/__tests__/sessionColdBoot.sharedDevice.test.ts +0 -325
- package/src/boot/__tests__/sessionColdBoot.test.ts +0 -570
- package/src/crypto/__tests__/backupMaterial.test.ts +0 -86
- package/src/crypto/__tests__/cryptoPrimitives.test.ts +0 -226
- package/src/crypto/__tests__/identityLink.test.ts +0 -18
- package/src/crypto/__tests__/identityMocks.ts +0 -125
- package/src/crypto/__tests__/identityProof.test.ts +0 -81
- package/src/crypto/__tests__/keyManager.atomicity.test.ts +0 -272
- package/src/crypto/__tests__/keyManager.cacheSafety.test.ts +0 -175
- package/src/crypto/__tests__/keyManager.deviceBackup.test.ts +0 -310
- package/src/crypto/__tests__/keyManager.identityStatus.test.ts +0 -217
- package/src/crypto/__tests__/keyManager.recoveryLadder.test.ts +0 -179
- package/src/crypto/__tests__/keyManager.recoveryMnemonic.test.ts +0 -138
- package/src/crypto/__tests__/keyManager.sharedSlotSync.test.ts +0 -150
- package/src/crypto/__tests__/keyManager.storageMigration.test.ts +0 -227
- package/src/crypto/__tests__/keyManager.test.ts +0 -329
- package/src/crypto/__tests__/polyfill.test.ts +0 -109
- package/src/crypto/__tests__/polyfillOrder.test.ts +0 -114
- package/src/crypto/__tests__/recoveryPhrase.test.ts +0 -61
- package/src/crypto/__tests__/registrationPow.test.ts +0 -61
- package/src/crypto/__tests__/scopedSeed.test.ts +0 -126
- package/src/crypto/__tests__/signChallengeShared.test.ts +0 -63
- package/src/crypto/__tests__/signedRecord.test.ts +0 -230
- package/src/i18n/__tests__/accountCategoryLabels.test.ts +0 -62
- package/src/i18n/__tests__/accountRoleLabels.test.ts +0 -54
- package/src/i18n/__tests__/reputationCategoryLabels.test.ts +0 -56
- package/src/i18n/__tests__/trustTierLabels.test.ts +0 -47
- package/src/i18n/locales/de-DE.json +0 -306
- package/src/i18n/locales/es-ES.json +0 -2127
- package/src/i18n/locales/ja-JP.json +0 -306
- package/src/inference/__tests__/OxyInferenceClient.test.ts +0 -899
- package/src/logger/__tests__/logger.test.ts +0 -207
- package/src/mixins/OxyServices.accounts.ts +0 -1330
- package/src/mixins/OxyServices.agency.ts +0 -353
- package/src/mixins/OxyServices.analytics.ts +0 -53
- package/src/mixins/OxyServices.appData.ts +0 -158
- package/src/mixins/OxyServices.assets.ts +0 -964
- package/src/mixins/OxyServices.auth.ts +0 -2083
- package/src/mixins/OxyServices.chains.ts +0 -134
- package/src/mixins/OxyServices.civic.ts +0 -945
- package/src/mixins/OxyServices.connectedApps.ts +0 -212
- package/src/mixins/OxyServices.contacts.ts +0 -73
- package/src/mixins/OxyServices.devices.ts +0 -120
- package/src/mixins/OxyServices.features.ts +0 -454
- package/src/mixins/OxyServices.followGraph.ts +0 -293
- package/src/mixins/OxyServices.identity.ts +0 -787
- package/src/mixins/OxyServices.identityBackup.ts +0 -250
- package/src/mixins/OxyServices.inference.ts +0 -57
- package/src/mixins/OxyServices.language.ts +0 -144
- package/src/mixins/OxyServices.linkedAccounts.ts +0 -129
- package/src/mixins/OxyServices.location.ts +0 -46
- package/src/mixins/OxyServices.nodes.ts +0 -337
- package/src/mixins/OxyServices.notifications.ts +0 -142
- package/src/mixins/OxyServices.payment.ts +0 -163
- package/src/mixins/OxyServices.privacy.ts +0 -219
- package/src/mixins/OxyServices.reputation.ts +0 -436
- package/src/mixins/OxyServices.security.ts +0 -110
- package/src/mixins/OxyServices.store.ts +0 -585
- package/src/mixins/OxyServices.topics.ts +0 -169
- package/src/mixins/OxyServices.user.ts +0 -1208
- package/src/mixins/OxyServices.utility.ts +0 -1803
- package/src/mixins/__tests__/OxyServices.civic.test.ts +0 -1095
- package/src/mixins/__tests__/OxyServices.deviceBoot.test.ts +0 -124
- package/src/mixins/__tests__/OxyServices.identity.test.ts +0 -301
- package/src/mixins/__tests__/OxyServices.nodes.test.ts +0 -341
- package/src/mixins/__tests__/OxyServices.rotateKey.test.ts +0 -323
- package/src/mixins/__tests__/OxyServices.serviceAssetMetadata.test.ts +0 -192
- package/src/mixins/__tests__/OxyServices.serviceAssetMetadataBySha.test.ts +0 -135
- package/src/mixins/__tests__/OxyServices.serviceLinkedDownloadUrl.test.ts +0 -139
- package/src/mixins/__tests__/accountEvents.test.ts +0 -158
- package/src/mixins/__tests__/accounts.test.ts +0 -727
- package/src/mixins/__tests__/agency.test.ts +0 -120
- package/src/mixins/__tests__/appData.test.ts +0 -203
- package/src/mixins/__tests__/assetCredentials.test.ts +0 -47
- package/src/mixins/__tests__/assetUpload.test.ts +0 -191
- package/src/mixins/__tests__/authRefusalObservability.test.ts +0 -396
- package/src/mixins/__tests__/backgroundCredential.httpIntegration.test.ts +0 -130
- package/src/mixins/__tests__/chains.test.ts +0 -113
- package/src/mixins/__tests__/commonsSignIn.test.ts +0 -1147
- package/src/mixins/__tests__/connectedApps.test.ts +0 -146
- package/src/mixins/__tests__/deviceTokenMintPinned.test.ts +0 -113
- package/src/mixins/__tests__/discoveryErrorHandling.test.ts +0 -265
- package/src/mixins/__tests__/followCacheInvalidation.test.ts +0 -173
- package/src/mixins/__tests__/followGraph.test.ts +0 -147
- package/src/mixins/__tests__/followGraphPagination.test.ts +0 -271
- package/src/mixins/__tests__/getFileDownloadUrl.test.ts +0 -346
- package/src/mixins/__tests__/getFollowStatuses.test.ts +0 -95
- package/src/mixins/__tests__/getUsersByIds.test.ts +0 -176
- package/src/mixins/__tests__/identityBackup.test.ts +0 -315
- package/src/mixins/__tests__/identityLink.test.ts +0 -89
- package/src/mixins/__tests__/identityWriteCacheInvalidation.test.ts +0 -407
- package/src/mixins/__tests__/inferenceFactory.test.ts +0 -58
- package/src/mixins/__tests__/linkedAccounts.test.ts +0 -109
- package/src/mixins/__tests__/notifications.read.test.ts +0 -82
- package/src/mixins/__tests__/onTokensChanged.test.ts +0 -129
- package/src/mixins/__tests__/preSessionSkipAuth.test.ts +0 -284
- package/src/mixins/__tests__/privacyCacheInvalidation.test.ts +0 -155
- package/src/mixins/__tests__/reputation.test.ts +0 -522
- package/src/mixins/__tests__/serviceAuth.test.ts +0 -889
- package/src/mixins/__tests__/serviceTokenJwks.test.ts +0 -208
- package/src/mixins/__tests__/store.test.ts +0 -304
- package/src/mixins/__tests__/topics.test.ts +0 -155
- package/src/mixins/__tests__/userReadCacheBypass.test.ts +0 -129
- package/src/mixins/__tests__/userTokenAuth.test.ts +0 -746
- package/src/mixins/__tests__/verifyChallenge.test.ts +0 -161
- package/src/mixins/__tests__/verifyServiceActingAs.test.ts +0 -167
- package/src/mixins/__tests__/webauthnAuth.test.ts +0 -279
- package/src/mixins/index.ts +0 -203
- package/src/mixins/mixinHelpers.ts +0 -69
- package/src/server/__tests__/auth.test.ts +0 -78
- package/src/server/__tests__/capabilityTicket.test.ts +0 -111
- package/src/server/__tests__/cors.socket.test.ts +0 -225
- package/src/server/__tests__/cors.test.ts +0 -158
- package/src/server/__tests__/rateLimit.test.ts +0 -257
- package/src/server/__tests__/requesterAssertion.test.ts +0 -359
- package/src/server/__tests__/safeFetch.test.ts +0 -232
- package/src/server/__tests__/securityHeaders.test.ts +0 -387
- package/src/server/__tests__/serviceTokenAttribution.test.ts +0 -396
- package/src/server/__tests__/traffic.test.ts +0 -180
- package/src/server/__tests__/trafficNodeHttp.test.ts +0 -38
- package/src/server/__tests__/userInvalidation.test.ts +0 -203
- package/src/server/__tests__/verifySecret.test.ts +0 -40
- package/src/server/__tests__/workloadIdentity.client.test.ts +0 -16
- package/src/server/__tests__/workloadIdentity.test.ts +0 -128
- package/src/session/__tests__/SessionClient.additive.test.ts +0 -153
- package/src/session/__tests__/SessionClient.broadcastChannel.test.ts +0 -114
- package/src/session/__tests__/SessionClient.diagnostics.test.ts +0 -91
- package/src/session/__tests__/SessionClient.directory.test.ts +0 -688
- package/src/session/__tests__/SessionClient.httpIntegration.test.ts +0 -65
- package/src/session/__tests__/SessionClient.identityPin.test.ts +0 -175
- package/src/session/__tests__/SessionClient.rest.test.ts +0 -119
- package/src/session/__tests__/SessionClient.serverEvents.test.ts +0 -72
- package/src/session/__tests__/SessionClient.socket.test.ts +0 -202
- package/src/session/__tests__/SessionClient.socketFactory.test.ts +0 -81
- package/src/session/__tests__/SessionClient.state.test.ts +0 -78
- package/src/session/__tests__/SessionClient.switchTokenOrder.test.ts +0 -170
- package/src/session/__tests__/accountDelegationAccess.test.ts +0 -104
- package/src/session/__tests__/accountDialogController.test.ts +0 -2502
- package/src/session/__tests__/accountDialogShape.test.ts +0 -120
- package/src/session/__tests__/accountSwitchTargets.test.ts +0 -137
- package/src/session/__tests__/authStateStore.test.ts +0 -451
- package/src/session/__tests__/deviceDirectory.test.ts +0 -422
- package/src/session/__tests__/deviceSwitcherRows.test.ts +0 -223
- package/src/session/__tests__/identityPin.test.ts +0 -131
- package/src/session/__tests__/identitySession.test.ts +0 -194
- package/src/session/__tests__/projectSessionState.test.ts +0 -105
- package/src/session/__tests__/refresh.identityPin.test.ts +0 -307
- package/src/session/__tests__/refresh.test.ts +0 -606
- package/src/session/__tests__/sessionIntegration.test.ts +0 -209
- package/src/session/__tests__/sharedDeviceCredential.test.ts +0 -300
- package/src/utils/__tests__/accountUtils.test.ts +0 -151
- package/src/utils/__tests__/activityId.test.ts +0 -45
- package/src/utils/__tests__/asyncUtils.test.ts +0 -279
- package/src/utils/__tests__/authWebUrl.test.ts +0 -15
- package/src/utils/__tests__/cacheKey.test.ts +0 -0
- package/src/utils/__tests__/cacheLifecycle.test.ts +0 -65
- package/src/utils/__tests__/coldBoot.test.ts +0 -496
- package/src/utils/__tests__/commonsApproval.test.ts +0 -60
- package/src/utils/__tests__/identityCacheSweep.test.ts +0 -151
- package/src/utils/__tests__/languageUtils.test.ts +0 -244
- package/src/utils/__tests__/oauthPkce.test.ts +0 -303
- package/src/utils/__tests__/officialOrigins.test.ts +0 -31
- package/src/utils/__tests__/oxyServiceEnvironment.test.ts +0 -7
- package/src/utils/__tests__/profileLinks.test.ts +0 -180
- package/src/utils/__tests__/redactUrl.test.ts +0 -33
- package/src/utils/__tests__/registrableApex.test.ts +0 -62
- package/src/utils/__tests__/requestUtilsAbort.test.ts +0 -155
- package/src/utils/__tests__/textNormalization.test.ts +0 -205
- package/src/utils/__tests__/validationUtils.test.ts +0 -703
- package/src/utils/__tests__/webauthnOrigin.test.ts +0 -83
- package/src/utils/webauthnOrigin.ts +0 -52
|
@@ -0,0 +1,144 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `oxy.billing` — the signed-in user's subscription, wallet and payment history.
|
|
3
|
+
*
|
|
4
|
+
* Every call reads the SIGNED-IN user's data unless a `userId` is passed (the
|
|
5
|
+
* API refuses any other user's). Checkout, plan changes and cancellation live
|
|
6
|
+
* under `/billing` (Stripe) and are not wrapped here yet.
|
|
7
|
+
*
|
|
8
|
+
* The types model the JSON these routes actually return (`subscription.controller`,
|
|
9
|
+
* `payment.controller`, `wallet.routes` in `packages/api`); `Date` columns
|
|
10
|
+
* arrive as ISO-8601 strings.
|
|
11
|
+
*/
|
|
12
|
+
import type { OxyContext } from '../client/context';
|
|
13
|
+
|
|
14
|
+
const SUBSCRIPTION_TTL = 2 * 60 * 1000;
|
|
15
|
+
const WALLET_TTL = 60 * 1000;
|
|
16
|
+
|
|
17
|
+
/** Subscription tier. */
|
|
18
|
+
export type SubscriptionPlan = 'basic' | 'pro' | 'business';
|
|
19
|
+
|
|
20
|
+
/** Lifecycle state of a subscription. */
|
|
21
|
+
export type SubscriptionStatus = 'active' | 'canceled' | 'expired';
|
|
22
|
+
|
|
23
|
+
/** Feature flags toggled by the active plan. */
|
|
24
|
+
export interface SubscriptionFeatures {
|
|
25
|
+
analytics: boolean;
|
|
26
|
+
premiumBadge: boolean;
|
|
27
|
+
unlimitedFollowing: boolean;
|
|
28
|
+
higherUploadLimits: boolean;
|
|
29
|
+
promotedPosts: boolean;
|
|
30
|
+
businessTools: boolean;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* A user's subscription. A user who never subscribed gets `{ plan: 'basic' }`,
|
|
35
|
+
* so every other field is optional.
|
|
36
|
+
*/
|
|
37
|
+
export interface Subscription {
|
|
38
|
+
plan: SubscriptionPlan;
|
|
39
|
+
status?: SubscriptionStatus;
|
|
40
|
+
userId?: string;
|
|
41
|
+
startDate?: string;
|
|
42
|
+
endDate?: string;
|
|
43
|
+
autoRenew?: boolean;
|
|
44
|
+
paymentMethod?: string;
|
|
45
|
+
latestInvoice?: string;
|
|
46
|
+
features?: SubscriptionFeatures;
|
|
47
|
+
createdAt?: string;
|
|
48
|
+
updatedAt?: string;
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
/** A payment history entry (a `deposit` or `purchase` transaction). */
|
|
52
|
+
export interface Payment {
|
|
53
|
+
id: string;
|
|
54
|
+
userId: string;
|
|
55
|
+
type: string;
|
|
56
|
+
amount: number;
|
|
57
|
+
status: string;
|
|
58
|
+
description?: string;
|
|
59
|
+
itemId?: string;
|
|
60
|
+
itemType?: string;
|
|
61
|
+
/** When the payment was created. */
|
|
62
|
+
timestamp?: string;
|
|
63
|
+
completedAt?: string;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
/** A user's FairCoin wallet. */
|
|
67
|
+
export interface Wallet {
|
|
68
|
+
userId: string;
|
|
69
|
+
balance: number;
|
|
70
|
+
/** On-chain withdrawal address, `null` until one is set. */
|
|
71
|
+
address: string | null;
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
export type WalletTransactionType = 'deposit' | 'withdrawal' | 'transfer' | 'purchase';
|
|
75
|
+
export type WalletTransactionStatus = 'pending' | 'completed' | 'failed' | 'cancelled';
|
|
76
|
+
|
|
77
|
+
/** One wallet ledger entry. */
|
|
78
|
+
export interface WalletTransaction {
|
|
79
|
+
id: string;
|
|
80
|
+
userId: string | { _id: string; username?: string };
|
|
81
|
+
type: WalletTransactionType;
|
|
82
|
+
amount: number;
|
|
83
|
+
status: WalletTransactionStatus;
|
|
84
|
+
description?: string;
|
|
85
|
+
recipientId?: string | { _id: string; username?: string } | null;
|
|
86
|
+
itemId?: string;
|
|
87
|
+
itemType?: string;
|
|
88
|
+
timestamp?: string;
|
|
89
|
+
completedAt?: string;
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
export interface WalletPagination {
|
|
93
|
+
total: number;
|
|
94
|
+
limit: number;
|
|
95
|
+
offset: number;
|
|
96
|
+
hasMore: boolean;
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
/** A page of wallet transactions. */
|
|
100
|
+
export interface WalletTransactionsPage {
|
|
101
|
+
data: WalletTransaction[];
|
|
102
|
+
pagination: WalletPagination;
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
export class BillingApi {
|
|
106
|
+
constructor(protected readonly ctx: OxyContext) {}
|
|
107
|
+
|
|
108
|
+
/** The signed-in user's payment history. Never cached. */
|
|
109
|
+
async payments(): Promise<Payment[]> {
|
|
110
|
+
return this.ctx.request<Payment[]>('GET', '/payments/user', undefined, { cache: false });
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
/** A user's subscription (default: the signed-in user's). */
|
|
114
|
+
async subscription(userId?: string): Promise<Subscription> {
|
|
115
|
+
const id = this.resolveUserId(userId);
|
|
116
|
+
return this.ctx.request<Subscription>('GET', `/subscription/${id}`, undefined, {
|
|
117
|
+
cache: true,
|
|
118
|
+
cacheTTL: SUBSCRIPTION_TTL,
|
|
119
|
+
});
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
/** A user's wallet (default: the signed-in user's). Cached briefly: the balance moves. */
|
|
123
|
+
async wallet(userId?: string): Promise<Wallet> {
|
|
124
|
+
const id = this.resolveUserId(userId);
|
|
125
|
+
return this.ctx.request<Wallet>('GET', `/wallet/${id}`, undefined, { cache: true, cacheTTL: WALLET_TTL });
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
/** A page of a user's wallet transactions (default: the signed-in user's). Never cached. */
|
|
129
|
+
async walletTransactions(
|
|
130
|
+
options: { userId?: string; limit?: number; offset?: number } = {},
|
|
131
|
+
): Promise<WalletTransactionsPage> {
|
|
132
|
+
const id = this.resolveUserId(options.userId);
|
|
133
|
+
const params: Record<string, number> = {};
|
|
134
|
+
if (options.limit) params.limit = options.limit;
|
|
135
|
+
if (options.offset) params.offset = options.offset;
|
|
136
|
+
return this.ctx.request<WalletTransactionsPage>('GET', `/wallet/transactions/${id}`, params, { cache: false });
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
private resolveUserId(userId?: string): string {
|
|
140
|
+
const id = userId || this.ctx.oxy.session.userId;
|
|
141
|
+
if (!id) throw new Error('User not authenticated');
|
|
142
|
+
return id;
|
|
143
|
+
}
|
|
144
|
+
}
|
package/src/api/civic.ts
ADDED
|
@@ -0,0 +1,428 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `oxy.civic` — the Commons "Oxy ID": the public, verifiable citizen-identity
|
|
3
|
+
* card a person shows and others scan, real-life attestation, the validator
|
|
4
|
+
* (jury) flow, personhood vouching, and verifiable credentials.
|
|
5
|
+
*
|
|
6
|
+
* - `publicCard` fetches a user's signed card and verifies the Oxy custodial
|
|
7
|
+
* attestation CLIENT-SIDE, so a scanner can trust the card OFFLINE (a cached
|
|
8
|
+
* card replayed without network) instead of re-trusting the transport.
|
|
9
|
+
* - `idPayload` / `buildAttestQrPayload` build the QRs a person shows; the
|
|
10
|
+
* scanner parses them with `parseIdPayload` / `parseAttestPayload`
|
|
11
|
+
* (`civic/payloads.ts`).
|
|
12
|
+
* - `attest`, `validation.vote`, `vouch`, `credentials.issue` sign a self-issued
|
|
13
|
+
* v2 record on the caller's own chain with the on-device key, so they are
|
|
14
|
+
* NATIVE-ONLY — they throw on web, where there is no key.
|
|
15
|
+
*
|
|
16
|
+
* Wire shapes come from `@oxy.so/contracts`. Card verification NEVER throws on a
|
|
17
|
+
* bad or absent signature — it returns `verified: false` so the UI can render a
|
|
18
|
+
* forged/unsigned card as visibly untrusted. A transport failure still rejects.
|
|
19
|
+
*/
|
|
20
|
+
import type {
|
|
21
|
+
CredentialIssueResult,
|
|
22
|
+
CredentialListResult,
|
|
23
|
+
CredentialStatus,
|
|
24
|
+
CredentialVerifyResult,
|
|
25
|
+
PersonhoodStatusResult,
|
|
26
|
+
RealLifeAttestationResult,
|
|
27
|
+
SignedPublicCard,
|
|
28
|
+
ValidationRequestSummary,
|
|
29
|
+
ValidationVerdict,
|
|
30
|
+
ValidationVoteResult,
|
|
31
|
+
VerifiableCredentialResponse,
|
|
32
|
+
VouchResult,
|
|
33
|
+
} from '@oxy.so/contracts';
|
|
34
|
+
import type { OxyContext } from '../client/context';
|
|
35
|
+
import { verifyPublicCardAttestation, type AttestQrPayload } from '../civic/payloads';
|
|
36
|
+
import { buildUserDid, signOwnChainRecord } from './identity';
|
|
37
|
+
|
|
38
|
+
/** Short-TTL read cache for public civic reads. */
|
|
39
|
+
const SHORT_TTL = 60 * 1000;
|
|
40
|
+
|
|
41
|
+
/**
|
|
42
|
+
* Validity window of a real-life-attestation QR, matching the server's
|
|
43
|
+
* `REAL_LIFE_NONCE_MAX_AGE_MS` ceiling. The server is authoritative on
|
|
44
|
+
* freshness; this is the client-issued `exp`.
|
|
45
|
+
*/
|
|
46
|
+
const ATTEST_QR_TTL_MS = 10 * 60 * 1000;
|
|
47
|
+
|
|
48
|
+
/** AtProto-style collections of the civic records. */
|
|
49
|
+
const ATTEST_COLLECTION = 'app.oxy.attestation';
|
|
50
|
+
const VALIDATION_COLLECTION = 'app.oxy.validation';
|
|
51
|
+
const VOUCH_COLLECTION = 'app.oxy.vouch';
|
|
52
|
+
/**
|
|
53
|
+
* Each credential is its own chain entry, so its `rkey` MUST be unique (a fresh
|
|
54
|
+
* nonce), unlike the one-per-subject vouch keyed on the subject DID.
|
|
55
|
+
*/
|
|
56
|
+
const CREDENTIAL_COLLECTION = 'app.oxy.credential';
|
|
57
|
+
|
|
58
|
+
/**
|
|
59
|
+
* The W3C base VC type that MUST be present in every credential's `types`;
|
|
60
|
+
* prepended when the caller omits it (the server rejects a record lacking it).
|
|
61
|
+
*/
|
|
62
|
+
const CREDENTIAL_BASE_TYPE = 'VerifiableCredential';
|
|
63
|
+
|
|
64
|
+
/** Every credential read (holder list + by-record verify) starts with this. */
|
|
65
|
+
const CREDENTIAL_CACHE_PREFIX = 'GET:/civic/credentials/';
|
|
66
|
+
/** Every personhood-status read starts with this. */
|
|
67
|
+
const PERSONHOOD_CACHE_PREFIX = 'GET:/civic/personhood/';
|
|
68
|
+
/**
|
|
69
|
+
* `GET /users/me`: a subject crossing the personhood threshold flips their
|
|
70
|
+
* mirrored `User.verified`, so a vouch / withdraw sweeps it.
|
|
71
|
+
*/
|
|
72
|
+
const USERS_ME_CACHE_PREFIX = 'GET:/users/me';
|
|
73
|
+
|
|
74
|
+
/**
|
|
75
|
+
* A `SignedPublicCard` plus the client's verdict. `verified` is `true` ONLY when
|
|
76
|
+
* `attestation` is present and its signature over `canonicalize(card)` checks
|
|
77
|
+
* out against `attestation.publicKey`. It does NOT on its own establish that
|
|
78
|
+
* `publicKey` is Oxy's key — that anchor is the Oxy API the card came from (over
|
|
79
|
+
* TLS) and `attestation.issuer`. A `false` verdict MUST be shown as untrusted.
|
|
80
|
+
*/
|
|
81
|
+
export interface CivicCardResult extends SignedPublicCard {
|
|
82
|
+
verified: boolean;
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
/** Input for {@link CivicApi.attest} — the scanned QR's fields plus B's support signals. */
|
|
86
|
+
export interface SubmitRealLifeAttestationInput {
|
|
87
|
+
/** The DID of the person being attested (A); becomes the record's `about`. */
|
|
88
|
+
subjectDid: string;
|
|
89
|
+
/** Opaque interaction id from the QR. */
|
|
90
|
+
context: string;
|
|
91
|
+
/** Single-use nonce from the QR (also the record's `rkey`). */
|
|
92
|
+
nonce: string;
|
|
93
|
+
/** Nonce expiry from the QR (epoch ms). */
|
|
94
|
+
exp: number;
|
|
95
|
+
/** Coarse co-location proof (optional). */
|
|
96
|
+
geohash?: string;
|
|
97
|
+
/** Whether B's device biometric gate fired before signing (optional). */
|
|
98
|
+
biometricOk?: boolean;
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
/** Result of `oxy.civic.validation.deny`. */
|
|
102
|
+
export interface DenyValidationResult {
|
|
103
|
+
denied: boolean;
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
/** Input for {@link CivicApi.vouch} — the subject (A) the caller (B) vouches for. */
|
|
107
|
+
export interface VouchForPersonInput {
|
|
108
|
+
/** A's DID (`did:web:oxy.so:u:<userId>`); becomes the vouch record's `about`. */
|
|
109
|
+
subjectDid: string;
|
|
110
|
+
/**
|
|
111
|
+
* B's chosen stake (the `stake` wire field). Omitted ⇒ the server's default;
|
|
112
|
+
* the server clamps it and echoes the recorded amount as `VouchResult.stakeAmount`.
|
|
113
|
+
*/
|
|
114
|
+
stakeAmount?: number;
|
|
115
|
+
/** Whether B's device biometric gate fired before signing (optional signal). */
|
|
116
|
+
biometricOk?: boolean;
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
/** Result of {@link CivicApi.withdrawVouch}. */
|
|
120
|
+
export interface WithdrawVouchResult {
|
|
121
|
+
withdrawn: boolean;
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
/** Input for `oxy.civic.credentials.issue`. */
|
|
125
|
+
export interface IssueCredentialInput {
|
|
126
|
+
/** The holder's Oxy DID; becomes the record's `about`. */
|
|
127
|
+
holderDid: string;
|
|
128
|
+
/**
|
|
129
|
+
* The VC type tags. `'VerifiableCredential'` is prepended when omitted;
|
|
130
|
+
* provide at least one specific type (e.g. `'EmploymentCredential'`).
|
|
131
|
+
*/
|
|
132
|
+
types: string[];
|
|
133
|
+
/** The issuer-asserted claim set about the holder (signed verbatim). */
|
|
134
|
+
claims: Record<string, unknown>;
|
|
135
|
+
/**
|
|
136
|
+
* Optional ISO-8601 expiry; absent = non-expiring. Converted to epoch ms in the
|
|
137
|
+
* signed record, so a holder cannot extend validity after the fact.
|
|
138
|
+
*/
|
|
139
|
+
expiresAt?: string;
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
/** Result of `oxy.civic.credentials.revoke`. */
|
|
143
|
+
export interface RevokeCredentialResult {
|
|
144
|
+
revoked: boolean;
|
|
145
|
+
credential: VerifiableCredentialResponse;
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
export class CivicApi {
|
|
149
|
+
/** The validator (jury) flow — MEDIUM-weight peer validation. */
|
|
150
|
+
readonly validation: CivicValidationApi;
|
|
151
|
+
/** Verifiable credentials. */
|
|
152
|
+
readonly credentials: CivicCredentialsApi;
|
|
153
|
+
|
|
154
|
+
constructor(private readonly ctx: OxyContext) {
|
|
155
|
+
this.validation = new CivicValidationApi(ctx);
|
|
156
|
+
this.credentials = new CivicCredentialsApi(ctx);
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
/**
|
|
160
|
+
* A user's signed public Oxy ID card, with the Oxy attestation verified
|
|
161
|
+
* client-side. Public; short-TTL cached. A bad or absent signature does NOT
|
|
162
|
+
* reject — it yields `verified: false`.
|
|
163
|
+
*/
|
|
164
|
+
async publicCard(userId: string): Promise<CivicCardResult> {
|
|
165
|
+
const signed = await this.ctx.request<SignedPublicCard>('GET', `/civic/${encodeURIComponent(userId)}/card`, undefined, {
|
|
166
|
+
cache: true,
|
|
167
|
+
cacheTTL: SHORT_TTL,
|
|
168
|
+
});
|
|
169
|
+
const verified = await verifyPublicCardAttestation(signed.card, signed.attestation);
|
|
170
|
+
return { card: signed.card, attestation: signed.attestation, verified };
|
|
171
|
+
}
|
|
172
|
+
|
|
173
|
+
/**
|
|
174
|
+
* The signed-in user's Oxy ID QR payload: `oxycommons://card?did=<did>&v=1`.
|
|
175
|
+
* Encodes ONLY the DID; a scanner resolves the signed card via `publicCard`.
|
|
176
|
+
* Throws when signed out.
|
|
177
|
+
*/
|
|
178
|
+
idPayload(): string {
|
|
179
|
+
return `oxycommons://card?did=${this.myDid('build an Oxy ID payload')}&v=1`;
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
/**
|
|
183
|
+
* The real-life-attestation QR the signed-in user (A) shows to be attested by
|
|
184
|
+
* a counterparty (B):
|
|
185
|
+
* `oxycommons://attest?subject=<A.did>&ctx=<context>&nonce=<fresh>&exp=<now+10m>`.
|
|
186
|
+
* A fresh crypto-random nonce per call (single-use replay guard). Throws when
|
|
187
|
+
* signed out.
|
|
188
|
+
*/
|
|
189
|
+
async buildAttestQrPayload(input: { context: string }): Promise<AttestQrPayload> {
|
|
190
|
+
const subject = this.myDid('build an attestation QR');
|
|
191
|
+
const { SignatureService } = await import('../crypto/internal');
|
|
192
|
+
const nonce = await SignatureService.generateChallenge();
|
|
193
|
+
const exp = Date.now() + ATTEST_QR_TTL_MS;
|
|
194
|
+
const payload =
|
|
195
|
+
`oxycommons://attest?subject=${subject}` +
|
|
196
|
+
`&ctx=${encodeURIComponent(input.context)}` +
|
|
197
|
+
`&nonce=${nonce}&exp=${exp}`;
|
|
198
|
+
return { payload, nonce, exp };
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
/**
|
|
202
|
+
* Submit a real-life counterparty attestation as the SCANNER (B): sign a
|
|
203
|
+
* self-issued `real_life_attestation` record on B's own chain referencing A via
|
|
204
|
+
* `record.about`, then `POST /civic/attestations`. The server enforces nonce
|
|
205
|
+
* single-use, freshness, graph-exclusion and the per-pair cooldown, then awards
|
|
206
|
+
* A the HIGH-weight points. NATIVE-ONLY.
|
|
207
|
+
*/
|
|
208
|
+
async attest(input: SubmitRealLifeAttestationInput): Promise<RealLifeAttestationResult> {
|
|
209
|
+
const envelope = await signOwnChainRecord(
|
|
210
|
+
this.ctx,
|
|
211
|
+
'real_life_attestation',
|
|
212
|
+
{
|
|
213
|
+
about: input.subjectDid,
|
|
214
|
+
context: input.context,
|
|
215
|
+
nonce: input.nonce,
|
|
216
|
+
exp: input.exp,
|
|
217
|
+
...(input.geohash !== undefined ? { geohash: input.geohash } : {}),
|
|
218
|
+
...(input.biometricOk !== undefined ? { biometricOk: input.biometricOk } : {}),
|
|
219
|
+
},
|
|
220
|
+
{ collection: ATTEST_COLLECTION, rkey: input.nonce },
|
|
221
|
+
);
|
|
222
|
+
return this.ctx.request<RealLifeAttestationResult>('POST', '/civic/attestations', envelope, { cache: false });
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
/**
|
|
226
|
+
* Vouch that another user is a real person as the VOUCHER (B): sign a
|
|
227
|
+
* self-issued `personhood_vouch` record (`{ about, stake? }`) on B's own chain,
|
|
228
|
+
* then `POST /civic/personhood/vouch`. The server enforces voucher eligibility
|
|
229
|
+
* and graph-exclusion, stakes B, and recomputes A's personhood. One vouch per
|
|
230
|
+
* subject (`rkey: <subjectDid>`, last-writer-wins). NATIVE-ONLY.
|
|
231
|
+
*/
|
|
232
|
+
async vouch(input: VouchForPersonInput): Promise<VouchResult> {
|
|
233
|
+
const envelope = await signOwnChainRecord(
|
|
234
|
+
this.ctx,
|
|
235
|
+
'personhood_vouch',
|
|
236
|
+
{
|
|
237
|
+
about: input.subjectDid,
|
|
238
|
+
...(input.stakeAmount !== undefined ? { stake: input.stakeAmount } : {}),
|
|
239
|
+
...(input.biometricOk !== undefined ? { biometricOk: input.biometricOk } : {}),
|
|
240
|
+
},
|
|
241
|
+
{ collection: VOUCH_COLLECTION, rkey: input.subjectDid },
|
|
242
|
+
);
|
|
243
|
+
const result = await this.ctx.request<VouchResult>('POST', '/civic/personhood/vouch', envelope, { cache: false });
|
|
244
|
+
this.sweepPersonhood();
|
|
245
|
+
return result;
|
|
246
|
+
}
|
|
247
|
+
|
|
248
|
+
/**
|
|
249
|
+
* Withdraw the signed-in user's active vouch for a subject. The subject is
|
|
250
|
+
* recomputed (which may demote them).
|
|
251
|
+
*
|
|
252
|
+
* @param subjectUserId - The subject's account id (NOT a DID).
|
|
253
|
+
*/
|
|
254
|
+
async withdrawVouch(subjectUserId: string): Promise<WithdrawVouchResult> {
|
|
255
|
+
const result = await this.ctx.request<WithdrawVouchResult>(
|
|
256
|
+
'DELETE',
|
|
257
|
+
`/civic/personhood/vouch/${encodeURIComponent(subjectUserId)}`,
|
|
258
|
+
undefined,
|
|
259
|
+
{ cache: false },
|
|
260
|
+
);
|
|
261
|
+
this.sweepPersonhood();
|
|
262
|
+
return result;
|
|
263
|
+
}
|
|
264
|
+
|
|
265
|
+
/**
|
|
266
|
+
* A user's public personhood status snapshot (default: the signed-in user's).
|
|
267
|
+
* A zeroed `unverified` shape when none exists yet. Short-TTL cached.
|
|
268
|
+
*/
|
|
269
|
+
async personhood(userId?: string): Promise<PersonhoodStatusResult> {
|
|
270
|
+
const id = userId ?? this.myUserId('resolve personhood status');
|
|
271
|
+
return this.ctx.request<PersonhoodStatusResult>('GET', `/civic/personhood/${encodeURIComponent(id)}`, undefined, {
|
|
272
|
+
cache: true,
|
|
273
|
+
cacheTTL: SHORT_TTL,
|
|
274
|
+
});
|
|
275
|
+
}
|
|
276
|
+
|
|
277
|
+
/** A vouch / withdraw changes personhood reads and (via `verified`) `/users/me`. */
|
|
278
|
+
private sweepPersonhood(): void {
|
|
279
|
+
this.ctx.http.invalidateCache({ prefixes: [PERSONHOOD_CACHE_PREFIX, USERS_ME_CACHE_PREFIX] });
|
|
280
|
+
}
|
|
281
|
+
|
|
282
|
+
private myUserId(action: string): string {
|
|
283
|
+
const userId = this.ctx.oxy.session.userId;
|
|
284
|
+
if (!userId) {
|
|
285
|
+
throw new Error(`No authenticated user — cannot ${action}.`);
|
|
286
|
+
}
|
|
287
|
+
return userId;
|
|
288
|
+
}
|
|
289
|
+
|
|
290
|
+
private myDid(action: string): string {
|
|
291
|
+
return buildUserDid(this.myUserId(action));
|
|
292
|
+
}
|
|
293
|
+
}
|
|
294
|
+
|
|
295
|
+
/** `oxy.civic.validation` — a randomly selected juror's duties. */
|
|
296
|
+
export class CivicValidationApi {
|
|
297
|
+
constructor(private readonly ctx: OxyContext) {}
|
|
298
|
+
|
|
299
|
+
/** The signed-in user's pending jury duties. Never cached; `[]` when on no juries. */
|
|
300
|
+
async inbox(): Promise<ValidationRequestSummary[]> {
|
|
301
|
+
const res = await this.ctx.request<{ requests?: ValidationRequestSummary[] }>('GET', '/civic/validations/inbox', undefined, {
|
|
302
|
+
cache: false,
|
|
303
|
+
});
|
|
304
|
+
return res.requests ?? [];
|
|
305
|
+
}
|
|
306
|
+
|
|
307
|
+
/**
|
|
308
|
+
* Cast a SIGNED verdict as a selected juror: a self-issued `validation_verdict`
|
|
309
|
+
* record bound to `requestId` + `payloadHash` (so it cannot be replayed onto a
|
|
310
|
+
* different request or an altered payload). NATIVE-ONLY.
|
|
311
|
+
*
|
|
312
|
+
* @param payloadHash - The request's canonical payload hash (from the inbox).
|
|
313
|
+
*/
|
|
314
|
+
async vote(requestId: string, payloadHash: string, verdict: ValidationVerdict): Promise<ValidationVoteResult> {
|
|
315
|
+
const envelope = await signOwnChainRecord(
|
|
316
|
+
this.ctx,
|
|
317
|
+
'validation_verdict',
|
|
318
|
+
{ requestId, payloadHash, verdict },
|
|
319
|
+
{ collection: VALIDATION_COLLECTION, rkey: requestId },
|
|
320
|
+
);
|
|
321
|
+
return this.ctx.request<ValidationVoteResult>(
|
|
322
|
+
'POST',
|
|
323
|
+
`/civic/validations/${encodeURIComponent(requestId)}/vote`,
|
|
324
|
+
envelope,
|
|
325
|
+
{ cache: false },
|
|
326
|
+
);
|
|
327
|
+
}
|
|
328
|
+
|
|
329
|
+
/** Recuse from a validation request: the juror leaves the jury and it is re-tallied. */
|
|
330
|
+
async deny(requestId: string): Promise<DenyValidationResult> {
|
|
331
|
+
return this.ctx.request<DenyValidationResult>(
|
|
332
|
+
'POST',
|
|
333
|
+
`/civic/validations/${encodeURIComponent(requestId)}/deny`,
|
|
334
|
+
undefined,
|
|
335
|
+
{ cache: false },
|
|
336
|
+
);
|
|
337
|
+
}
|
|
338
|
+
}
|
|
339
|
+
|
|
340
|
+
/** `oxy.civic.credentials` — verifiable credentials. */
|
|
341
|
+
export class CivicCredentialsApi {
|
|
342
|
+
constructor(private readonly ctx: OxyContext) {}
|
|
343
|
+
|
|
344
|
+
/**
|
|
345
|
+
* Issue a verifiable credential as the ISSUER: sign a self-issued `credential`
|
|
346
|
+
* record on the caller's own chain whose `record.about` is the HOLDER's DID,
|
|
347
|
+
* then `POST /civic/credentials`. `'VerifiableCredential'` is ensured as the
|
|
348
|
+
* base type; an `expiresAt` ISO string becomes epoch ms. NATIVE-ONLY.
|
|
349
|
+
*/
|
|
350
|
+
async issue(input: IssueCredentialInput): Promise<CredentialIssueResult> {
|
|
351
|
+
const types = input.types.includes(CREDENTIAL_BASE_TYPE) ? input.types : [CREDENTIAL_BASE_TYPE, ...input.types];
|
|
352
|
+
|
|
353
|
+
let expiresAtMs: number | undefined;
|
|
354
|
+
if (input.expiresAt !== undefined) {
|
|
355
|
+
const parsed = Date.parse(input.expiresAt);
|
|
356
|
+
if (Number.isNaN(parsed)) {
|
|
357
|
+
throw new Error('Invalid expiresAt — must be an ISO 8601 date string.');
|
|
358
|
+
}
|
|
359
|
+
expiresAtMs = parsed;
|
|
360
|
+
}
|
|
361
|
+
|
|
362
|
+
const record: Record<string, unknown> = {
|
|
363
|
+
about: input.holderDid,
|
|
364
|
+
types,
|
|
365
|
+
claims: input.claims,
|
|
366
|
+
...(expiresAtMs !== undefined ? { expiresAt: expiresAtMs } : {}),
|
|
367
|
+
};
|
|
368
|
+
|
|
369
|
+
// A fresh crypto-random rkey: every credential is its own chain entry.
|
|
370
|
+
const { SignatureService } = await import('../crypto/internal');
|
|
371
|
+
const rkey = await SignatureService.generateChallenge();
|
|
372
|
+
const envelope = await signOwnChainRecord(this.ctx, 'credential', record, { collection: CREDENTIAL_COLLECTION, rkey });
|
|
373
|
+
const result = await this.ctx.request<CredentialIssueResult>('POST', '/civic/credentials', envelope, { cache: false });
|
|
374
|
+
this.sweep();
|
|
375
|
+
return result;
|
|
376
|
+
}
|
|
377
|
+
|
|
378
|
+
/**
|
|
379
|
+
* A holder's credentials, newest first (default holder: the signed-in user),
|
|
380
|
+
* optionally filtered by status. Public; short-TTL cached.
|
|
381
|
+
*
|
|
382
|
+
* @param holderUserId - The holder's account id (NOT a DID).
|
|
383
|
+
*/
|
|
384
|
+
async list(holderUserId?: string, opts: { status?: CredentialStatus } = {}): Promise<CredentialListResult> {
|
|
385
|
+
const holder = holderUserId ?? this.ctx.oxy.session.userId;
|
|
386
|
+
if (!holder) {
|
|
387
|
+
throw new Error('No authenticated user — cannot list credentials.');
|
|
388
|
+
}
|
|
389
|
+
const base = `/civic/credentials/${encodeURIComponent(holder)}`;
|
|
390
|
+
const url = opts.status ? `${base}?status=${encodeURIComponent(opts.status)}` : base;
|
|
391
|
+
return this.ctx.request<CredentialListResult>('GET', url, undefined, { cache: true, cacheTTL: SHORT_TTL });
|
|
392
|
+
}
|
|
393
|
+
|
|
394
|
+
/**
|
|
395
|
+
* Verify a credential by its signed-record id: the server re-checks the
|
|
396
|
+
* signature against a CURRENT verification method of the issuer DID, then
|
|
397
|
+
* that it is neither revoked nor expired. A failing credential yields
|
|
398
|
+
* `valid: false`, not a throw. Short-TTL cached.
|
|
399
|
+
*/
|
|
400
|
+
async verify(recordId: string): Promise<CredentialVerifyResult> {
|
|
401
|
+
return this.ctx.request<CredentialVerifyResult>(
|
|
402
|
+
'GET',
|
|
403
|
+
`/civic/credentials/by-record/${encodeURIComponent(recordId)}/verify`,
|
|
404
|
+
undefined,
|
|
405
|
+
{ cache: true, cacheTTL: SHORT_TTL },
|
|
406
|
+
);
|
|
407
|
+
}
|
|
408
|
+
|
|
409
|
+
/**
|
|
410
|
+
* Revoke a credential the signed-in user issued.
|
|
411
|
+
*
|
|
412
|
+
* @param id - The credential's id (the projection row id, NOT the record id).
|
|
413
|
+
*/
|
|
414
|
+
async revoke(id: string): Promise<RevokeCredentialResult> {
|
|
415
|
+
const result = await this.ctx.request<RevokeCredentialResult>(
|
|
416
|
+
'POST',
|
|
417
|
+
`/civic/credentials/${encodeURIComponent(id)}/revoke`,
|
|
418
|
+
undefined,
|
|
419
|
+
{ cache: false },
|
|
420
|
+
);
|
|
421
|
+
this.sweep();
|
|
422
|
+
return result;
|
|
423
|
+
}
|
|
424
|
+
|
|
425
|
+
private sweep(): void {
|
|
426
|
+
this.ctx.http.invalidateCache({ prefixes: [CREDENTIAL_CACHE_PREFIX] });
|
|
427
|
+
}
|
|
428
|
+
}
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `oxy.contacts` — privacy-preserving discovery of which address-book contacts
|
|
3
|
+
* are on Oxy.
|
|
4
|
+
*
|
|
5
|
+
* Hash locally, send only digests; the server answers with the Oxy user ids
|
|
6
|
+
* and the hashes that matched. Hashing must match the server
|
|
7
|
+
* (`utils/contactHash.ts`): SHA-256, lowercase hex, over
|
|
8
|
+
* - an email: `trim().toLowerCase()`;
|
|
9
|
+
* - a phone: trim → keep one leading `+` → strip non-digits → prepend `+` if missing.
|
|
10
|
+
*/
|
|
11
|
+
import type { OxyContext } from '../client/context';
|
|
12
|
+
|
|
13
|
+
/** One contact that is on Oxy. */
|
|
14
|
+
export interface ContactDiscoveryMatch {
|
|
15
|
+
/** The Oxy user id. */
|
|
16
|
+
userId: string;
|
|
17
|
+
/** The request hash that matched. */
|
|
18
|
+
hashedIdentifier: string;
|
|
19
|
+
matchType: 'email' | 'phone';
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
export interface ContactDiscoveryResponse {
|
|
23
|
+
matches: ContactDiscoveryMatch[];
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
export class ContactsApi {
|
|
27
|
+
constructor(protected readonly ctx: OxyContext) {}
|
|
28
|
+
|
|
29
|
+
/**
|
|
30
|
+
* Which of these hashed contacts are on Oxy. Either list may be empty, not
|
|
31
|
+
* both; at most 200 hashes per list per call (batch larger books).
|
|
32
|
+
*/
|
|
33
|
+
async discover(hashedEmails: string[], hashedPhones: string[]): Promise<ContactDiscoveryResponse> {
|
|
34
|
+
return this.ctx.request<ContactDiscoveryResponse>(
|
|
35
|
+
'POST',
|
|
36
|
+
'/contacts/discover',
|
|
37
|
+
{ hashedEmails, hashedPhones },
|
|
38
|
+
{ cache: false },
|
|
39
|
+
);
|
|
40
|
+
}
|
|
41
|
+
}
|