@owneraio/finp2p-sdk-js 0.28.26 → 0.29.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 +93 -2
- package/lib/OwneraAPI/__tests__/apiErrorShape.test.d.ts +1 -0
- package/lib/OwneraAPI/__tests__/apiErrorShape.test.js +264 -0
- package/lib/OwneraAPI/__tests__/apiErrorShape.test.js.map +1 -0
- package/lib/OwneraAPI/__tests__/utils.test.d.ts +1 -0
- package/lib/OwneraAPI/__tests__/utils.test.js +82 -0
- package/lib/OwneraAPI/__tests__/utils.test.js.map +1 -0
- package/lib/OwneraAPI/finp2p-node-api/__tests__/agreements.test.d.ts +1 -0
- package/lib/OwneraAPI/finp2p-node-api/__tests__/agreements.test.js +149 -0
- package/lib/OwneraAPI/finp2p-node-api/__tests__/agreements.test.js.map +1 -0
- package/lib/OwneraAPI/finp2p-node-api/__tests__/approvalsConfig.test.js +5 -12
- package/lib/OwneraAPI/finp2p-node-api/__tests__/approvalsConfig.test.js.map +1 -1
- package/lib/OwneraAPI/finp2p-node-api/__tests__/collateral.test.d.ts +1 -0
- package/lib/OwneraAPI/finp2p-node-api/__tests__/collateral.test.js +502 -0
- package/lib/OwneraAPI/finp2p-node-api/__tests__/collateral.test.js.map +1 -0
- package/lib/OwneraAPI/finp2p-node-api/__tests__/createIntentMetadata.test.d.ts +1 -0
- package/lib/OwneraAPI/finp2p-node-api/__tests__/createIntentMetadata.test.js +56 -0
- package/lib/OwneraAPI/finp2p-node-api/__tests__/createIntentMetadata.test.js.map +1 -0
- package/lib/OwneraAPI/finp2p-node-api/__tests__/dryRunExecute.test.d.ts +1 -0
- package/lib/OwneraAPI/finp2p-node-api/__tests__/dryRunExecute.test.js +75 -0
- package/lib/OwneraAPI/finp2p-node-api/__tests__/dryRunExecute.test.js.map +1 -0
- package/lib/OwneraAPI/finp2p-node-api/__tests__/pathEncoding.test.d.ts +1 -0
- package/lib/OwneraAPI/finp2p-node-api/__tests__/pathEncoding.test.js +348 -0
- package/lib/OwneraAPI/finp2p-node-api/__tests__/pathEncoding.test.js.map +1 -0
- package/lib/OwneraAPI/finp2p-node-api/__tests__/rejectIntent.test.d.ts +1 -0
- package/lib/OwneraAPI/finp2p-node-api/__tests__/rejectIntent.test.js +97 -0
- package/lib/OwneraAPI/finp2p-node-api/__tests__/rejectIntent.test.js.map +1 -0
- package/lib/OwneraAPI/finp2p-node-api/agreements.d.ts +8 -0
- package/lib/OwneraAPI/finp2p-node-api/agreements.js +31 -0
- package/lib/OwneraAPI/finp2p-node-api/agreements.js.map +1 -0
- package/lib/OwneraAPI/finp2p-node-api/certificates.js +15 -6
- package/lib/OwneraAPI/finp2p-node-api/certificates.js.map +1 -1
- package/lib/OwneraAPI/finp2p-node-api/collateral.d.ts +16 -0
- package/lib/OwneraAPI/finp2p-node-api/collateral.js +131 -0
- package/lib/OwneraAPI/finp2p-node-api/collateral.js.map +1 -0
- package/lib/OwneraAPI/finp2p-node-api/custodies.js +13 -2
- package/lib/OwneraAPI/finp2p-node-api/custodies.js.map +1 -1
- package/lib/OwneraAPI/finp2p-node-api/documents.js +22 -9
- package/lib/OwneraAPI/finp2p-node-api/documents.js.map +1 -1
- package/lib/OwneraAPI/finp2p-node-api/investorAccounts.d.ts +13 -0
- package/lib/OwneraAPI/finp2p-node-api/investorAccounts.js +71 -0
- package/lib/OwneraAPI/finp2p-node-api/investorAccounts.js.map +1 -0
- package/lib/OwneraAPI/finp2p-node-api/ledgers.js +13 -2
- package/lib/OwneraAPI/finp2p-node-api/ledgers.js.map +1 -1
- package/lib/OwneraAPI/finp2p-node-api/messages.js +12 -3
- package/lib/OwneraAPI/finp2p-node-api/messages.js.map +1 -1
- package/lib/OwneraAPI/finp2p-node-api/operations.js +37 -15
- package/lib/OwneraAPI/finp2p-node-api/operations.js.map +1 -1
- package/lib/OwneraAPI/finp2p-node-api/policies.js +14 -5
- package/lib/OwneraAPI/finp2p-node-api/policies.js.map +1 -1
- package/lib/OwneraAPI/finp2p-node-api/profiles.js +82 -45
- package/lib/OwneraAPI/finp2p-node-api/profiles.js.map +1 -1
- package/lib/OwneraAPI/finp2p-node-api/tokens.js +20 -0
- package/lib/OwneraAPI/finp2p-node-api/tokens.js.map +1 -1
- package/lib/OwneraAPI/index.js +6 -0
- package/lib/OwneraAPI/index.js.map +1 -1
- package/lib/OwneraAPI/oss-api/__tests__/buildGraphQLQuery.test.d.ts +1 -0
- package/lib/OwneraAPI/oss-api/__tests__/buildGraphQLQuery.test.js +253 -0
- package/lib/OwneraAPI/oss-api/__tests__/buildGraphQLQuery.test.js.map +1 -0
- package/lib/OwneraAPI/oss-api/__tests__/filterUtils.test.d.ts +1 -0
- package/lib/OwneraAPI/oss-api/__tests__/filterUtils.test.js +15 -0
- package/lib/OwneraAPI/oss-api/__tests__/filterUtils.test.js.map +1 -0
- package/lib/OwneraAPI/oss-api/__tests__/getAgreements.test.d.ts +1 -0
- package/lib/OwneraAPI/oss-api/__tests__/getAgreements.test.js +175 -0
- package/lib/OwneraAPI/oss-api/__tests__/getAgreements.test.js.map +1 -0
- package/lib/OwneraAPI/oss-api/__tests__/getAllExecutionPlans.test.js +52 -0
- package/lib/OwneraAPI/oss-api/__tests__/getAllExecutionPlans.test.js.map +1 -1
- package/lib/OwneraAPI/oss-api/__tests__/getCollateralAgreements.test.d.ts +1 -0
- package/lib/OwneraAPI/oss-api/__tests__/getCollateralAgreements.test.js +321 -0
- package/lib/OwneraAPI/oss-api/__tests__/getCollateralAgreements.test.js.map +1 -0
- package/lib/OwneraAPI/oss-api/__tests__/getCollateralReports.test.d.ts +1 -0
- package/lib/OwneraAPI/oss-api/__tests__/getCollateralReports.test.js +152 -0
- package/lib/OwneraAPI/oss-api/__tests__/getCollateralReports.test.js.map +1 -0
- package/lib/OwneraAPI/oss-api/__tests__/ossQueryEscaping.test.d.ts +1 -0
- package/lib/OwneraAPI/oss-api/__tests__/ossQueryEscaping.test.js +347 -0
- package/lib/OwneraAPI/oss-api/__tests__/ossQueryEscaping.test.js.map +1 -0
- package/lib/OwneraAPI/oss-api/filterUtils.d.ts +20 -0
- package/lib/OwneraAPI/oss-api/filterUtils.js +57 -5
- package/lib/OwneraAPI/oss-api/filterUtils.js.map +1 -1
- package/lib/OwneraAPI/oss-api/oss.js +730 -74
- package/lib/OwneraAPI/oss-api/oss.js.map +1 -1
- package/lib/OwneraAPI/oss-api/queryUtils.d.ts +1 -0
- package/lib/OwneraAPI/oss-api/queryUtils.js +6 -5
- package/lib/OwneraAPI/oss-api/queryUtils.js.map +1 -1
- package/lib/OwneraAPI/oss-api/queryValidation.d.ts +3 -1
- package/lib/OwneraAPI/oss-api/queryValidation.js +21 -2
- package/lib/OwneraAPI/oss-api/queryValidation.js.map +1 -1
- package/lib/OwneraAPI/payment-adapter-api/__tests__/updateBalance.test.d.ts +1 -0
- package/lib/OwneraAPI/payment-adapter-api/__tests__/updateBalance.test.js +42 -0
- package/lib/OwneraAPI/payment-adapter-api/__tests__/updateBalance.test.js.map +1 -0
- package/lib/OwneraAPI/payment-adapter-api/vanilla/__tests__/payouts.test.d.ts +1 -0
- package/lib/OwneraAPI/payment-adapter-api/vanilla/__tests__/payouts.test.js +73 -0
- package/lib/OwneraAPI/payment-adapter-api/vanilla/__tests__/payouts.test.js.map +1 -0
- package/lib/OwneraAPI/payment-adapter-api/vanilla/payouts.js +23 -11
- package/lib/OwneraAPI/payment-adapter-api/vanilla/payouts.js.map +1 -1
- package/lib/OwneraAPI/payment-adapter-api/vanilla/update-balance.d.ts +1 -1
- package/lib/OwneraAPI/payment-adapter-api/vanilla/update-balance.js +3 -1
- package/lib/OwneraAPI/payment-adapter-api/vanilla/update-balance.js.map +1 -1
- package/lib/OwneraAPI/utils.d.ts +39 -0
- package/lib/OwneraAPI/utils.js +176 -82
- package/lib/OwneraAPI/utils.js.map +1 -1
- package/lib/core/__tests__/consoleLogger.test.d.ts +1 -0
- package/lib/core/__tests__/consoleLogger.test.js +269 -0
- package/lib/core/__tests__/consoleLogger.test.js.map +1 -0
- package/lib/core/__tests__/createAssetNameUniqueness.test.d.ts +1 -0
- package/lib/core/__tests__/createAssetNameUniqueness.test.js +95 -0
- package/lib/core/__tests__/createAssetNameUniqueness.test.js.map +1 -0
- package/lib/core/__tests__/custodianPrecedence.test.d.ts +1 -0
- package/lib/core/__tests__/custodianPrecedence.test.js +683 -0
- package/lib/core/__tests__/custodianPrecedence.test.js.map +1 -0
- package/lib/core/__tests__/executeIntentSettlementAssets.test.d.ts +1 -0
- package/lib/core/__tests__/executeIntentSettlementAssets.test.js +128 -0
- package/lib/core/__tests__/executeIntentSettlementAssets.test.js.map +1 -0
- package/lib/core/__tests__/logException.test.d.ts +1 -0
- package/lib/core/__tests__/logException.test.js +49 -0
- package/lib/core/__tests__/logException.test.js.map +1 -0
- package/lib/core/__tests__/multiplyDecimalStrings.test.d.ts +1 -0
- package/lib/core/__tests__/multiplyDecimalStrings.test.js +37 -0
- package/lib/core/__tests__/multiplyDecimalStrings.test.js.map +1 -0
- package/lib/core/__tests__/settlementExecutionAmount.test.d.ts +1 -0
- package/lib/core/__tests__/settlementExecutionAmount.test.js +300 -0
- package/lib/core/__tests__/settlementExecutionAmount.test.js.map +1 -0
- package/lib/core/asset.js +21 -27
- package/lib/core/asset.js.map +1 -1
- package/lib/core/custodian.d.ts +30 -0
- package/lib/core/custodian.js +49 -0
- package/lib/core/custodian.js.map +1 -0
- package/lib/core/index.d.ts +1 -0
- package/lib/core/index.js +3 -1
- package/lib/core/index.js.map +1 -1
- package/lib/core/intents/__tests__/intentErrorCode.test.d.ts +1 -0
- package/lib/core/intents/__tests__/intentErrorCode.test.js +111 -0
- package/lib/core/intents/__tests__/intentErrorCode.test.js.map +1 -0
- package/lib/core/intents/__tests__/intentHandleReject.test.d.ts +1 -0
- package/lib/core/intents/__tests__/intentHandleReject.test.js +50 -0
- package/lib/core/intents/__tests__/intentHandleReject.test.js.map +1 -0
- package/lib/core/intents/__tests__/loanIntentAdditionalAccounts.test.d.ts +1 -0
- package/lib/core/intents/__tests__/loanIntentAdditionalAccounts.test.js +185 -0
- package/lib/core/intents/__tests__/loanIntentAdditionalAccounts.test.js.map +1 -0
- package/lib/core/intents/__tests__/loanIntentCustodianPrecedence.test.d.ts +1 -0
- package/lib/core/intents/__tests__/loanIntentCustodianPrecedence.test.js +85 -0
- package/lib/core/intents/__tests__/loanIntentCustodianPrecedence.test.js.map +1 -0
- package/lib/core/intents/__tests__/loanIntentMetadata.test.d.ts +1 -0
- package/lib/core/intents/__tests__/loanIntentMetadata.test.js +81 -0
- package/lib/core/intents/__tests__/loanIntentMetadata.test.js.map +1 -0
- package/lib/core/intents/__tests__/moveIntentSegregatedAccounts.test.d.ts +1 -0
- package/lib/core/intents/__tests__/moveIntentSegregatedAccounts.test.js +203 -0
- package/lib/core/intents/__tests__/moveIntentSegregatedAccounts.test.js.map +1 -0
- package/lib/core/intents/createIntent/createIntent.js +4 -3
- package/lib/core/intents/createIntent/createIntent.js.map +1 -1
- package/lib/core/intents/createIntent/createMoveIntentReq.d.ts +0 -1
- package/lib/core/intents/createIntent/createMoveIntentReq.js +15 -8
- package/lib/core/intents/createIntent/createMoveIntentReq.js.map +1 -1
- package/lib/core/intents/createIntent/helpers.d.ts +6 -2
- package/lib/core/intents/createIntent/helpers.js +27 -17
- package/lib/core/intents/createIntent/helpers.js.map +1 -1
- package/lib/core/intents/createLoanIntent.js +64 -19
- package/lib/core/intents/createLoanIntent.js.map +1 -1
- package/lib/core/intents/executeIntent.js +102 -41
- package/lib/core/intents/executeIntent.js.map +1 -1
- package/lib/core/intents/executeLoanIntent.js +48 -23
- package/lib/core/intents/executeLoanIntent.js.map +1 -1
- package/lib/core/intents/executeMoveIntent.js.map +1 -1
- package/lib/core/intents/executePrivateIntent.js +46 -13
- package/lib/core/intents/executePrivateIntent.js.map +1 -1
- package/lib/core/intents/executeRedemptionIntent.d.ts +1 -0
- package/lib/core/intents/executeRedemptionIntent.js +23 -9
- package/lib/core/intents/executeRedemptionIntent.js.map +1 -1
- package/lib/core/intents/executeTransferRequest.d.ts +5 -0
- package/lib/core/intents/executeTransferRequest.js +14 -3
- package/lib/core/intents/executeTransferRequest.js.map +1 -1
- package/lib/core/intents/getIntent.js +9 -0
- package/lib/core/intents/getIntent.js.map +1 -1
- package/lib/core/intents/transfer.js +7 -2
- package/lib/core/intents/transfer.js.map +1 -1
- package/lib/core/intents/updateMoveIntentReq.d.ts +4 -3
- package/lib/core/intents/updateMoveIntentReq.js +14 -12
- package/lib/core/intents/updateMoveIntentReq.js.map +1 -1
- package/lib/core/intents/utils.d.ts +15 -7
- package/lib/core/intents/utils.js +35 -26
- package/lib/core/intents/utils.js.map +1 -1
- package/lib/core/logger.js +128 -22
- package/lib/core/logger.js.map +1 -1
- package/lib/core/normalizers/__tests__/normalizeOperationResponse.test.d.ts +1 -0
- package/lib/core/normalizers/__tests__/normalizeOperationResponse.test.js +60 -0
- package/lib/core/normalizers/__tests__/normalizeOperationResponse.test.js.map +1 -0
- package/lib/core/normalizers/normalizeOperationResponse.d.ts +6 -0
- package/lib/core/normalizers/normalizeOperationResponse.js +4 -5
- package/lib/core/normalizers/normalizeOperationResponse.js.map +1 -1
- package/lib/core/sdk.d.ts +4 -0
- package/lib/core/sdk.js +2 -2
- package/lib/core/sdk.js.map +1 -1
- package/lib/core/user.d.ts +2 -2
- package/lib/core/user.js +6 -3
- package/lib/core/user.js.map +1 -1
- package/lib/core/utils.d.ts +17 -1
- package/lib/core/utils.js +75 -16
- package/lib/core/utils.js.map +1 -1
- package/lib/index.d.ts +1 -0
- package/lib/index.js +3 -1
- package/lib/index.js.map +1 -1
- package/lib/types/Agreements/Agreements.d.ts +355 -0
- package/lib/types/Agreements/Agreements.js +3 -0
- package/lib/types/Agreements/Agreements.js.map +1 -0
- package/lib/types/Agreements/index.d.ts +1 -0
- package/lib/types/Agreements/index.js +18 -0
- package/lib/types/Agreements/index.js.map +1 -0
- package/lib/types/Collateral/Collateral.d.ts +564 -0
- package/lib/types/Collateral/Collateral.js +3 -0
- package/lib/types/Collateral/Collateral.js.map +1 -0
- package/lib/types/Collateral/index.d.ts +1 -0
- package/lib/types/Collateral/index.js +18 -0
- package/lib/types/Collateral/index.js.map +1 -0
- package/lib/types/Core/Intents.d.ts +115 -3
- package/lib/types/Core/Intents.js +9 -0
- package/lib/types/Core/Intents.js.map +1 -1
- package/lib/types/Core/OwneraAPI.d.ts +25 -1
- package/lib/types/Core/User.d.ts +28 -3
- package/lib/types/InvestorAccounts/InvestorAccounts.d.ts +171 -0
- package/lib/types/InvestorAccounts/InvestorAccounts.js +35 -0
- package/lib/types/InvestorAccounts/InvestorAccounts.js.map +1 -0
- package/lib/types/InvestorAccounts/index.d.ts +1 -0
- package/lib/types/InvestorAccounts/index.js +18 -0
- package/lib/types/InvestorAccounts/index.js.map +1 -0
- package/lib/types/Operations/Operations.d.ts +11 -0
- package/lib/types/Oss/Agreements.d.ts +671 -0
- package/lib/types/Oss/Agreements.js +3 -0
- package/lib/types/Oss/Agreements.js.map +1 -0
- package/lib/types/Oss/Oss.d.ts +81 -1
- package/lib/types/Oss/OssSchemas.d.ts +50 -0
- package/lib/types/Oss/OssSchemas.js.map +1 -1
- package/lib/types/Oss/index.d.ts +1 -0
- package/lib/types/Oss/index.js +1 -0
- package/lib/types/Oss/index.js.map +1 -1
- package/lib/types/Oss/utils.d.ts +39 -0
- package/lib/types/PaymentAdapter/PaymentAdapter.d.ts +7 -0
- package/lib/types/PaymentAdapter/index.d.ts +33 -1
- package/lib/types/Profiles/Intents.d.ts +24 -12
- package/lib/types/Profiles/Profiles.d.ts +46 -1
- package/lib/types/Tokens/Tokens.d.ts +109 -1
- package/lib/types/index.d.ts +3 -0
- package/lib/types/index.js +3 -0
- package/lib/types/index.js.map +1 -1
- package/lib/types/utils.d.ts +5 -0
- package/lib/types/utils.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -18,6 +18,27 @@ To build the `lib/` and use the package, just run `yarn build`.
|
|
|
18
18
|
|
|
19
19
|
### Usage
|
|
20
20
|
|
|
21
|
+
### Collateral
|
|
22
|
+
|
|
23
|
+
`sdk.owneraAPI.collateral` supports `collateral-terms/v3`; agreement proposals explicitly default
|
|
24
|
+
to that template. Reports are nominal-only, with the priced asset list proposed separately through
|
|
25
|
+
the attribution approval APIs:
|
|
26
|
+
|
|
27
|
+
```typescript
|
|
28
|
+
await sdk.owneraAPI.collateral.createReport(agreementId, {
|
|
29
|
+
type: 'variation',
|
|
30
|
+
nominalMarginAmount: '1000000',
|
|
31
|
+
actions: [{}],
|
|
32
|
+
});
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
Use `CreateCollateralReportRequest` for this body. `CreateNominalCollateralReportRequest` remains
|
|
36
|
+
a deprecated alias; valued report creation and `CollateralReportValuedLine` have been removed.
|
|
37
|
+
The SDK strips extra runtime fields from report creation. The haircut method is agreement policy
|
|
38
|
+
(`terms.haircutApplyMethod`); reports carry no method, and attribution lines carry seven valuation
|
|
39
|
+
fields. OSS report actions expose their nominal amount and recovered asset, while execution-plan
|
|
40
|
+
assets retain valuation metadata.
|
|
41
|
+
|
|
21
42
|
### Core
|
|
22
43
|
[SDK](./classes/Sdk.md)
|
|
23
44
|
|
|
@@ -26,7 +47,7 @@ import { Sdk } from "@owneraio/finp2p-sdk-js";
|
|
|
26
47
|
|
|
27
48
|
const sdk = new Sdk({
|
|
28
49
|
orgId: "bank-il",
|
|
29
|
-
custodianOrgId: 'bank-il',
|
|
50
|
+
custodianOrgId: 'bank-il', // default custodian — see "Custodian org id" below
|
|
30
51
|
owneraAPIAddress: "https://my-ownera-node.io",
|
|
31
52
|
authConfig: {
|
|
32
53
|
apiKey: "<my-api-key>",
|
|
@@ -39,6 +60,76 @@ const sdk = new Sdk({
|
|
|
39
60
|
});
|
|
40
61
|
```
|
|
41
62
|
|
|
63
|
+
#### Custodian org id
|
|
64
|
+
|
|
65
|
+
`custodianOrgId` on the `Sdk` constructor is the **default custodian** for the client: the one used
|
|
66
|
+
whenever a call does not determine a custodian of its own.
|
|
67
|
+
|
|
68
|
+
An investor's custodian is fixed when their finId account is created, so it is really a property of
|
|
69
|
+
the account rather than of the client. Every stamping site resolves it from up to three inputs —
|
|
70
|
+
the custodian already on the account (from the intent, or the account passed with the call), a
|
|
71
|
+
custodian passed with the call, and the constructor default — and the default is always last. The
|
|
72
|
+
order of the first two depends on **whose account is being stamped**:
|
|
73
|
+
|
|
74
|
+
- **the executor's own account** (e.g. the taker's asset account when executing someone else's
|
|
75
|
+
intent) — a **custodian passed with the call wins**; the intent's value belongs to the
|
|
76
|
+
counterparty and is only a fallback;
|
|
77
|
+
- **the counterparty's account** (e.g. the intent owner's account on a buying intent) — the
|
|
78
|
+
**intent's own custodian is authoritative**; a per-call value does not override it.
|
|
79
|
+
|
|
80
|
+
Per-call custodian and resolution order by flow:
|
|
81
|
+
|
|
82
|
+
| Flow | Per-call field | Resolution order |
|
|
83
|
+
|---|---|---|
|
|
84
|
+
| `user.addAccount()` | `options.custodianOrgId` | per-call → default |
|
|
85
|
+
| `user.transfer()` | `Transfer.sourceFallbackCustodianOrgId` / `destinationFallbackCustodianOrgId` (per side, fallback only) | account → per-call → default |
|
|
86
|
+
| `user.executeIntent()` — primarySale / sellingIntent destination | `IntentExecution.destinationCustodianOrgId` | per-call → intent → default |
|
|
87
|
+
| `user.executeIntent()` — buyingIntent asset source | `IntentExecution.sourceCustodianOrgId` | per-call → default |
|
|
88
|
+
| `user.executeIntent()` — buyingIntent asset destination, sellingIntent source | — (counterparty's account) | intent → default |
|
|
89
|
+
| `user.executeIntent()` — buyingIntent settlement source | — (intent owner's account) | intent settlement account → caller's settlement account → intent asset account → default |
|
|
90
|
+
| `user.executeIntent()` — settlement account, executor's leg (source on primarySale/sellingIntent, destination on buyingIntent) | `IntentExecution.sourceCustodianOrgId` / `destinationCustodianOrgId` | account → per-call → default |
|
|
91
|
+
| `user.executeIntent()` — settlement account, counterparty's leg | — (the per-call value describes the executor, never the counterparty) | account → default |
|
|
92
|
+
| `user.executePrivateIntent()` — source | `IntentExecution.sourceCustodianOrgId` | intent → per-call → default |
|
|
93
|
+
| `user.executePrivateIntent()` — destination | `IntentExecution.destinationCustodianOrgId` | per-call → intent → default (DvD: per-call → default — the intent step is skipped) |
|
|
94
|
+
| `user.executePrivateIntent()` — settlement source (executor's paying account) | `IntentExecution.sourceCustodianOrgId` | account → per-call → default |
|
|
95
|
+
| `user.executePrivateIntent()` — settlement destination (offeror's account) | — (counterparty's account) | account → default |
|
|
96
|
+
| `user.executeTransferRequest()` | `sourceCustodianOrgId` / `destinationCustodianOrgId` on the call's data | per-call → intent account → default |
|
|
97
|
+
| `user.executeRedemptionIntent()` — seller side | `IntentExecution.sourceCustodianOrgId` | per-call → seller's account → default |
|
|
98
|
+
| `user.executeRedemptionIntent()` — settlement source | — (issuer's account) | account → default |
|
|
99
|
+
| `asset.createPrimarySale()` | `CreatePrimarySale.custodianOrgId` | per-call → default |
|
|
100
|
+
| loan create / loan execute asset accounts | `sourceCustodianOrgId` / `destinationCustodianOrgId` | per-call → default |
|
|
101
|
+
| loan execute settlement accounts | `sourceCustodianOrgId` / `destinationCustodianOrgId` | intent settlement account → per-call → default |
|
|
102
|
+
|
|
103
|
+
Set the default and pass nothing per call, and every account and instruction is custodied there —
|
|
104
|
+
the single-custodian setup. Pass a custodian per call to custody different investors at different
|
|
105
|
+
organizations, with the default covering anything left unspecified.
|
|
106
|
+
|
|
107
|
+
The default is optional: omit it if every call supplies its own. Ordinary use of the default is
|
|
108
|
+
logged at debug, naming the site, so it is easy to see which flows rely on it.
|
|
109
|
+
|
|
110
|
+
A custodian is required, though. If a call falls all the way through to the default — an empty
|
|
111
|
+
string counts as absent — and none is configured, it fails before anything is sent to the Router:
|
|
112
|
+
|
|
113
|
+
```ts
|
|
114
|
+
try {
|
|
115
|
+
await user.addAccount();
|
|
116
|
+
} catch (e) {
|
|
117
|
+
// {
|
|
118
|
+
// code: 400,
|
|
119
|
+
// name: 'CustodianOrgIdError',
|
|
120
|
+
// message: "No custodian org id could be resolved for user.addAccount. Pass a custodian with
|
|
121
|
+
// the call, or set a default 'custodianOrgId' when constructing the Sdk. A custodian
|
|
122
|
+
// is required — an empty value is rejected by the Router.",
|
|
123
|
+
// data: { site: 'user.addAccount' },
|
|
124
|
+
// }
|
|
125
|
+
}
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
`data.site` names the exact stamping site — `user.addAccount`, `transfer.sourceAccount`,
|
|
129
|
+
`executePrivateIntent.destinationAccount`, `createPrimarySale`, and so on — so a misconfiguration
|
|
130
|
+
points straight at the flow that hit it, rather than surfacing later as a generic
|
|
131
|
+
`Minimum length violation: "orgId"` from the Router.
|
|
132
|
+
|
|
42
133
|
#### Inner Properties:
|
|
43
134
|
- [logger](./classes/Sdk.md#logger)
|
|
44
135
|
- [nodeId](./classes/Sdk.md#nodeid)
|
|
@@ -99,4 +190,4 @@ const org = sdk.getOrganization({});
|
|
|
99
190
|
```
|
|
100
191
|
|
|
101
192
|
### Another examples
|
|
102
|
-
More extended recipes you can check [here](https://finp2p-docs.ownera.io/recipes)
|
|
193
|
+
More extended recipes you can check [here](https://finp2p-docs.ownera.io/recipes)
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,264 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
|
|
3
|
+
function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
|
|
4
|
+
return new (P || (P = Promise))(function (resolve, reject) {
|
|
5
|
+
function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
|
|
6
|
+
function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
|
|
7
|
+
function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
|
|
8
|
+
step((generator = generator.apply(thisArg, _arguments || [])).next());
|
|
9
|
+
});
|
|
10
|
+
};
|
|
11
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
12
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
13
|
+
};
|
|
14
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
15
|
+
const http_1 = __importDefault(require("http"));
|
|
16
|
+
const stream_1 = require("stream");
|
|
17
|
+
const util_1 = require("util");
|
|
18
|
+
const index_1 = require("../../index");
|
|
19
|
+
const utils_1 = require("../utils");
|
|
20
|
+
/**
|
|
21
|
+
* Router request helpers reject with `code` = the HTTP status (a fixed numeric code when no
|
|
22
|
+
* response arrived) and never embed the AxiosError, whose request config carries the org's
|
|
23
|
+
* bearer token.
|
|
24
|
+
*/
|
|
25
|
+
const TOKEN = 'Bearer SECRET-ORG-JWT';
|
|
26
|
+
const logger = { debug: jest.fn(), info: jest.fn(), warning: jest.fn(), error: jest.fn() };
|
|
27
|
+
const routes = new Map([
|
|
28
|
+
['/empty401', (res) => res.writeHead(401).end()],
|
|
29
|
+
['/empty503', (res) => res.writeHead(503).end()],
|
|
30
|
+
[
|
|
31
|
+
'/json404',
|
|
32
|
+
(res) => res
|
|
33
|
+
.writeHead(404, { 'Content-Type': 'application/json' })
|
|
34
|
+
.end(JSON.stringify({ errors: [{ code: 1101, message: 'Resource id not found' }] })),
|
|
35
|
+
],
|
|
36
|
+
['/text500', (res) => res.writeHead(500, { 'Content-Type': 'text/plain' }).end('Profile not found')],
|
|
37
|
+
[
|
|
38
|
+
'/code403',
|
|
39
|
+
(res) => res
|
|
40
|
+
.writeHead(403, { 'Content-Type': 'application/json' })
|
|
41
|
+
.end(JSON.stringify({ code: 3401, message: 'Signature rejected' })),
|
|
42
|
+
],
|
|
43
|
+
['/null500', (res) => res.writeHead(500, { 'Content-Type': 'application/json' }).end('null')],
|
|
44
|
+
['/hang', () => undefined],
|
|
45
|
+
]);
|
|
46
|
+
let server;
|
|
47
|
+
let baseUrl;
|
|
48
|
+
const withToken = (connector) => {
|
|
49
|
+
connector.interceptors.request.use((config) => {
|
|
50
|
+
config.headers.Authorization = TOKEN;
|
|
51
|
+
return config;
|
|
52
|
+
});
|
|
53
|
+
return connector;
|
|
54
|
+
};
|
|
55
|
+
const connectorWithToken = (url) => withToken((0, utils_1.createConnector)(url));
|
|
56
|
+
const rejection = (promise) => __awaiter(void 0, void 0, void 0, function* () {
|
|
57
|
+
try {
|
|
58
|
+
yield promise;
|
|
59
|
+
}
|
|
60
|
+
catch (e) {
|
|
61
|
+
return e;
|
|
62
|
+
}
|
|
63
|
+
throw new Error('expected a rejection');
|
|
64
|
+
});
|
|
65
|
+
/** A URL on a port nothing listens on, so a request to it is refused. */
|
|
66
|
+
const refusedUrl = () => __awaiter(void 0, void 0, void 0, function* () {
|
|
67
|
+
const closed = http_1.default.createServer();
|
|
68
|
+
yield new Promise((resolve) => closed.listen(0, '127.0.0.1', resolve));
|
|
69
|
+
const port = closed.address().port;
|
|
70
|
+
yield new Promise((resolve) => closed.close(() => resolve()));
|
|
71
|
+
return `http://127.0.0.1:${port}/`;
|
|
72
|
+
});
|
|
73
|
+
beforeAll(() => __awaiter(void 0, void 0, void 0, function* () {
|
|
74
|
+
server = http_1.default.createServer((req, res) => {
|
|
75
|
+
// answer once the request body is fully read, so an upload sees the reply rather than a reset connection
|
|
76
|
+
req.on('end', () => {
|
|
77
|
+
var _a;
|
|
78
|
+
const route = routes.get((_a = req.url) !== null && _a !== void 0 ? _a : '');
|
|
79
|
+
// keep the typeof check: without it CodeQL flags this call (js/unvalidated-dynamic-method-call),
|
|
80
|
+
// and a `??` fallback is not enough
|
|
81
|
+
if (typeof route === 'function')
|
|
82
|
+
route(res);
|
|
83
|
+
else
|
|
84
|
+
res.writeHead(200).end('{}');
|
|
85
|
+
});
|
|
86
|
+
req.resume();
|
|
87
|
+
});
|
|
88
|
+
yield new Promise((resolve) => server.listen(0, '127.0.0.1', resolve));
|
|
89
|
+
baseUrl = `http://127.0.0.1:${server.address().port}/`;
|
|
90
|
+
}));
|
|
91
|
+
afterAll(() => new Promise((resolve) => server.close(() => resolve())));
|
|
92
|
+
describe('router request helper rejections', () => {
|
|
93
|
+
it('an empty-bodied 401 rejects with code 401 and a plain data.error, without the token', () => __awaiter(void 0, void 0, void 0, function* () {
|
|
94
|
+
const e = yield rejection((0, utils_1.apiGet)('/empty401', connectorWithToken(baseUrl), logger));
|
|
95
|
+
expect(e).toMatchObject({
|
|
96
|
+
code: 401,
|
|
97
|
+
name: 'errorGetAPI',
|
|
98
|
+
message: 'Cannot GET to /empty401',
|
|
99
|
+
data: { error: { message: 'Request failed with status code 401', code: 'ERR_BAD_REQUEST' } },
|
|
100
|
+
});
|
|
101
|
+
expect(JSON.stringify(e)).not.toContain('SECRET-ORG-JWT');
|
|
102
|
+
}));
|
|
103
|
+
it('an empty-bodied 503 rejects with code 503', () => __awaiter(void 0, void 0, void 0, function* () {
|
|
104
|
+
const e = yield rejection((0, utils_1.apiGet)('/empty503', connectorWithToken(baseUrl), logger));
|
|
105
|
+
expect(e.code).toBe(503);
|
|
106
|
+
expect(JSON.stringify(e)).not.toContain('SECRET-ORG-JWT');
|
|
107
|
+
}));
|
|
108
|
+
it('a JSON error body is kept as data.error, with the HTTP status (not errors[0].code) as code', () => __awaiter(void 0, void 0, void 0, function* () {
|
|
109
|
+
const e = yield rejection((0, utils_1.apiPost)('/json404', { a: 1 }, connectorWithToken(baseUrl), logger));
|
|
110
|
+
expect(e).toEqual({
|
|
111
|
+
code: 404,
|
|
112
|
+
name: 'errorPostAPI',
|
|
113
|
+
message: 'Cannot POST to /json404',
|
|
114
|
+
data: { error: { errors: [{ code: 1101, message: 'Resource id not found' }] }, request: { a: 1 } },
|
|
115
|
+
});
|
|
116
|
+
}));
|
|
117
|
+
it('a plain-text error body is kept as is', () => __awaiter(void 0, void 0, void 0, function* () {
|
|
118
|
+
const e = yield rejection((0, utils_1.apiGet)('/text500', connectorWithToken(baseUrl), logger));
|
|
119
|
+
expect(e).toMatchObject({ code: 500, data: { error: 'Profile not found' } });
|
|
120
|
+
}));
|
|
121
|
+
it('the HTTP status is the code even when the body carries its own code', () => __awaiter(void 0, void 0, void 0, function* () {
|
|
122
|
+
const e = yield rejection((0, utils_1.apiGet)('/code403', connectorWithToken(baseUrl), logger));
|
|
123
|
+
expect(e).toMatchObject({ code: 403, data: { error: { code: 3401, message: 'Signature rejected' } } });
|
|
124
|
+
}));
|
|
125
|
+
it('a null JSON body is treated like an empty one', () => __awaiter(void 0, void 0, void 0, function* () {
|
|
126
|
+
const e = yield rejection((0, utils_1.apiGet)('/null500', connectorWithToken(baseUrl), logger));
|
|
127
|
+
expect(e).toMatchObject({
|
|
128
|
+
code: 500,
|
|
129
|
+
data: { error: { message: 'Request failed with status code 500', code: 'ERR_BAD_RESPONSE' } },
|
|
130
|
+
});
|
|
131
|
+
}));
|
|
132
|
+
it('a transport failure rejects with the numeric transport code, without the token', () => __awaiter(void 0, void 0, void 0, function* () {
|
|
133
|
+
const e = yield rejection((0, utils_1.apiGet)('/x', connectorWithToken(yield refusedUrl()), logger));
|
|
134
|
+
expect(e).toMatchObject({
|
|
135
|
+
code: utils_1.TRANSPORT_ERROR_CODE,
|
|
136
|
+
name: 'errorGetAPI',
|
|
137
|
+
data: { error: { code: 'ECONNREFUSED' } },
|
|
138
|
+
});
|
|
139
|
+
expect(JSON.stringify(e)).not.toContain('SECRET-ORG-JWT');
|
|
140
|
+
}));
|
|
141
|
+
it('the transport code is the literal 999: numeric, not 4xx, not 409/500/502', () => {
|
|
142
|
+
expect(utils_1.TRANSPORT_ERROR_CODE).toBe(999);
|
|
143
|
+
});
|
|
144
|
+
it('toSdkError never throws, and keeps what it can of data it cannot spread', () => {
|
|
145
|
+
const unreadable = new Proxy({}, {
|
|
146
|
+
ownKeys() {
|
|
147
|
+
throw new Error('unreadable');
|
|
148
|
+
},
|
|
149
|
+
});
|
|
150
|
+
expect((0, utils_1.toSdkError)({ response: { status: 401 } }, 'errorGetAPI', 'Cannot GET to /x', unreadable)).toMatchObject({
|
|
151
|
+
code: utils_1.TRANSPORT_ERROR_CODE,
|
|
152
|
+
name: 'errorGetAPI',
|
|
153
|
+
message: 'Cannot GET to /x',
|
|
154
|
+
data: { error: {} },
|
|
155
|
+
});
|
|
156
|
+
const hostileResponse = Object.defineProperty({}, 'response', {
|
|
157
|
+
get() {
|
|
158
|
+
throw new Error('unreadable');
|
|
159
|
+
},
|
|
160
|
+
});
|
|
161
|
+
expect((0, utils_1.toSdkError)(hostileResponse, 'errorPostAPI', 'Cannot POST to /x', { request: { a: 1 } })).toMatchObject({
|
|
162
|
+
code: utils_1.TRANSPORT_ERROR_CODE,
|
|
163
|
+
data: { error: {}, request: { a: 1 } },
|
|
164
|
+
});
|
|
165
|
+
});
|
|
166
|
+
it('the transport code is exported from the package root', () => {
|
|
167
|
+
expect(index_1.TRANSPORT_ERROR_CODE).toBe(999);
|
|
168
|
+
});
|
|
169
|
+
it('a timeout rejects with the transport code, without the token', () => __awaiter(void 0, void 0, void 0, function* () {
|
|
170
|
+
const e = yield rejection((0, utils_1.apiGet)('/hang', connectorWithToken(baseUrl), logger, { timeout: 200 }));
|
|
171
|
+
expect(e).toMatchObject({ code: 999, name: 'errorGetAPI', data: { error: { code: 'ECONNABORTED' } } });
|
|
172
|
+
expect(JSON.stringify(e)).not.toContain('SECRET-ORG-JWT');
|
|
173
|
+
}));
|
|
174
|
+
it('a request-interceptor failure carrying the config as its code does not leak it', () => __awaiter(void 0, void 0, void 0, function* () {
|
|
175
|
+
const connector = (0, utils_1.createConnector)(baseUrl);
|
|
176
|
+
let thrownConfigHadToken = false;
|
|
177
|
+
// axios runs request interceptors last-registered first: this one is registered before the
|
|
178
|
+
// token interceptor, so the config it throws already carries the token
|
|
179
|
+
connector.interceptors.request.use((config) => {
|
|
180
|
+
thrownConfigHadToken = config.headers.Authorization === TOKEN;
|
|
181
|
+
throw Object.assign(new Error('signing failed'), { code: config });
|
|
182
|
+
});
|
|
183
|
+
withToken(connector);
|
|
184
|
+
const e = yield rejection((0, utils_1.apiGet)('/x', connector, logger));
|
|
185
|
+
expect(thrownConfigHadToken).toBe(true);
|
|
186
|
+
expect(e).toMatchObject({ code: 999, data: { error: { message: 'signing failed', code: undefined } } });
|
|
187
|
+
expect(JSON.stringify(e)).not.toContain('SECRET-ORG-JWT');
|
|
188
|
+
}));
|
|
189
|
+
it('a failure whose properties throw on access still rejects', () => __awaiter(void 0, void 0, void 0, function* () {
|
|
190
|
+
const connector = (0, utils_1.createConnector)(baseUrl);
|
|
191
|
+
connector.interceptors.request.use(() => {
|
|
192
|
+
throw Object.defineProperty({}, 'message', {
|
|
193
|
+
get() {
|
|
194
|
+
throw new Error('hostile getter');
|
|
195
|
+
},
|
|
196
|
+
});
|
|
197
|
+
});
|
|
198
|
+
const e = yield rejection((0, utils_1.apiGet)('/x', connector, logger));
|
|
199
|
+
expect(e).toMatchObject({ code: 999, name: 'errorGetAPI', message: 'Cannot GET to /x' });
|
|
200
|
+
}));
|
|
201
|
+
it('docGetFile rejects on an HTTP error instead of hanging, without the response stream', () => __awaiter(void 0, void 0, void 0, function* () {
|
|
202
|
+
const e = yield rejection((0, utils_1.docGetFile)('/json404', connectorWithToken(baseUrl), logger));
|
|
203
|
+
expect(e).toMatchObject({
|
|
204
|
+
code: 404,
|
|
205
|
+
name: 'errorDocGetAPI',
|
|
206
|
+
data: { error: { message: 'Request failed with status code 404', code: 'ERR_BAD_REQUEST' } },
|
|
207
|
+
});
|
|
208
|
+
expect(JSON.stringify(e)).not.toContain('SECRET-ORG-JWT');
|
|
209
|
+
}));
|
|
210
|
+
it('docGetFile destroys the unread error body, so the failure does not hold its socket', () => __awaiter(void 0, void 0, void 0, function* () {
|
|
211
|
+
const body = stream_1.Readable.from(['{"errors":[{"code":1101,"message":"Document not found"}]}']);
|
|
212
|
+
const failure = { message: 'Request failed with status code 404', response: { status: 404, data: body } };
|
|
213
|
+
const connector = { defaults: {}, get: () => Promise.reject(failure) };
|
|
214
|
+
const e = yield rejection((0, utils_1.docGetFile)('/documents/x', connector, logger));
|
|
215
|
+
expect(e.code).toBe(404);
|
|
216
|
+
expect(body.destroyed).toBe(true);
|
|
217
|
+
}));
|
|
218
|
+
it('logs through a logger whose error method relies on `this`', () => __awaiter(void 0, void 0, void 0, function* () {
|
|
219
|
+
class ClassLogger {
|
|
220
|
+
constructor() {
|
|
221
|
+
this.lines = [];
|
|
222
|
+
}
|
|
223
|
+
debug() { }
|
|
224
|
+
info() { }
|
|
225
|
+
warning() { }
|
|
226
|
+
error(...input) {
|
|
227
|
+
this.lines.push(input);
|
|
228
|
+
}
|
|
229
|
+
}
|
|
230
|
+
const classLogger = new ClassLogger();
|
|
231
|
+
yield rejection((0, utils_1.apiGet)('/empty401', connectorWithToken(baseUrl), classLogger));
|
|
232
|
+
expect(classLogger.lines.length).toBeGreaterThan(0);
|
|
233
|
+
}));
|
|
234
|
+
});
|
|
235
|
+
describe('every request helper rejects with the same shape', () => {
|
|
236
|
+
const helpers = [
|
|
237
|
+
['errorGetAPI', (path, connector) => (0, utils_1.apiGet)(path, connector, logger)],
|
|
238
|
+
['errorPostAPI', (path, connector) => (0, utils_1.apiPost)(path, { a: 1 }, connector, logger)],
|
|
239
|
+
['errorPutAPI', (path, connector) => (0, utils_1.apiPut)(path, { a: 1 }, connector, logger)],
|
|
240
|
+
['errorPatchAPI', (path, connector) => (0, utils_1.apiPatch)(path, { a: 1 }, connector, logger)],
|
|
241
|
+
['errorDeleteAPI', (path, connector) => (0, utils_1.apiDelete)(path, connector, logger)],
|
|
242
|
+
['errorDocGetAPI', (path, connector) => (0, utils_1.docGetFile)(path, connector, logger)],
|
|
243
|
+
['errorDocPostAPI', (path, connector) => (0, utils_1.docPost)(path, [stream_1.Readable.from(['file'])], connector, logger)],
|
|
244
|
+
['errorDocPutAPI', (path, connector) => (0, utils_1.docPut)(path, { file: stream_1.Readable.from(['file']) }, connector, logger)],
|
|
245
|
+
];
|
|
246
|
+
// inspect, not JSON.stringify: the doc helpers' `data.request` holds the upload streams. Custom
|
|
247
|
+
// inspect hooks and truncation are off, so nothing can hide the token from the check.
|
|
248
|
+
const withoutToken = (e) => expect((0, util_1.inspect)(e, { depth: null, customInspect: false, maxArrayLength: null, maxStringLength: null })).not.toContain('SECRET-ORG-JWT');
|
|
249
|
+
it.each(helpers)('%s: an empty-bodied 401 rejects with code 401, without the token', (name, call) => __awaiter(void 0, void 0, void 0, function* () {
|
|
250
|
+
const e = yield rejection(call('/empty401', connectorWithToken(baseUrl)));
|
|
251
|
+
expect(e).toMatchObject({
|
|
252
|
+
code: 401,
|
|
253
|
+
name,
|
|
254
|
+
data: { error: { message: 'Request failed with status code 401', code: 'ERR_BAD_REQUEST' } },
|
|
255
|
+
});
|
|
256
|
+
withoutToken(e);
|
|
257
|
+
}));
|
|
258
|
+
it.each(helpers)('%s: a refused connection rejects with the transport code, without the token', (name, call) => __awaiter(void 0, void 0, void 0, function* () {
|
|
259
|
+
const e = yield rejection(call('/x', connectorWithToken(yield refusedUrl())));
|
|
260
|
+
expect(e).toMatchObject({ code: utils_1.TRANSPORT_ERROR_CODE, name, data: { error: { code: 'ECONNREFUSED' } } });
|
|
261
|
+
withoutToken(e);
|
|
262
|
+
}));
|
|
263
|
+
});
|
|
264
|
+
//# sourceMappingURL=apiErrorShape.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"apiErrorShape.test.js","sourceRoot":"","sources":["../../../src/OwneraAPI/__tests__/apiErrorShape.test.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
const graphql_ws_1 = require("graphql-ws");
|
|
4
|
+
const utils_1 = require("../utils");
|
|
5
|
+
jest.mock('graphql-ws', () => ({ createClient: jest.fn() }));
|
|
6
|
+
const makeLogger = () => ({
|
|
7
|
+
debug: jest.fn(),
|
|
8
|
+
info: jest.fn(),
|
|
9
|
+
warning: jest.fn(),
|
|
10
|
+
error: jest.fn(),
|
|
11
|
+
});
|
|
12
|
+
describe('GqlClient subscriptions', () => {
|
|
13
|
+
// A mocked shared graphql-ws client: captures the operation sink and hands out listener removers.
|
|
14
|
+
const setup = () => {
|
|
15
|
+
let sink;
|
|
16
|
+
const unsubscribe = jest.fn();
|
|
17
|
+
const removeListeners = [jest.fn(), jest.fn(), jest.fn()];
|
|
18
|
+
let listenerIndex = 0;
|
|
19
|
+
const wsClient = {
|
|
20
|
+
on: jest.fn(() => removeListeners[listenerIndex++]),
|
|
21
|
+
subscribe: jest.fn((_payload, operationSink) => {
|
|
22
|
+
sink = operationSink;
|
|
23
|
+
return unsubscribe;
|
|
24
|
+
}),
|
|
25
|
+
terminate: jest.fn(),
|
|
26
|
+
};
|
|
27
|
+
jest.mocked(graphql_ws_1.createClient).mockReturnValue(wsClient);
|
|
28
|
+
const client = new utils_1.GqlClient('http://oss.example/graphql', () => 'token', makeLogger());
|
|
29
|
+
const callbacks = {
|
|
30
|
+
onNext: jest.fn(),
|
|
31
|
+
onError: jest.fn(),
|
|
32
|
+
onOperationError: jest.fn(),
|
|
33
|
+
onComplete: jest.fn(),
|
|
34
|
+
onStart: jest.fn(),
|
|
35
|
+
onClose: jest.fn(),
|
|
36
|
+
};
|
|
37
|
+
const handle = client.subscribe(Object.assign({ query: 'subscription test { test }' }, callbacks));
|
|
38
|
+
return { sink: () => sink, unsubscribe, removeListeners, wsClient, callbacks, handle };
|
|
39
|
+
};
|
|
40
|
+
it('reports an operation error through onOperationError only, and drops the listeners', () => {
|
|
41
|
+
const { sink, removeListeners, wsClient, callbacks } = setup();
|
|
42
|
+
const operationError = [{ message: 'operation refused' }];
|
|
43
|
+
sink().error(operationError);
|
|
44
|
+
expect(callbacks.onOperationError).toHaveBeenCalledWith(operationError);
|
|
45
|
+
expect(callbacks.onError).not.toHaveBeenCalled();
|
|
46
|
+
expect(wsClient.on).toHaveBeenCalledWith('error', callbacks.onError);
|
|
47
|
+
removeListeners.forEach((removeListener) => expect(removeListener).toHaveBeenCalledTimes(1));
|
|
48
|
+
});
|
|
49
|
+
it('reports a fatal close through onOperationError too, as the "ended for good" signal', () => {
|
|
50
|
+
const { sink, callbacks } = setup();
|
|
51
|
+
const closeEvent = { code: 4401, reason: 'Unauthorized' };
|
|
52
|
+
sink().error(closeEvent);
|
|
53
|
+
expect(callbacks.onOperationError).toHaveBeenCalledWith(closeEvent);
|
|
54
|
+
});
|
|
55
|
+
it('dispose() ends only the operation, drops the listeners and does not report a completion', () => {
|
|
56
|
+
const { sink, unsubscribe, removeListeners, wsClient, callbacks, handle } = setup();
|
|
57
|
+
handle.dispose();
|
|
58
|
+
// graphql-ws completes the sink after the unsubscribe it was asked for
|
|
59
|
+
sink().complete();
|
|
60
|
+
handle.dispose();
|
|
61
|
+
expect(unsubscribe).toHaveBeenCalledTimes(1);
|
|
62
|
+
expect(callbacks.onComplete).not.toHaveBeenCalled();
|
|
63
|
+
removeListeners.forEach((removeListener) => expect(removeListener).toHaveBeenCalledTimes(1));
|
|
64
|
+
expect(wsClient.terminate).not.toHaveBeenCalled();
|
|
65
|
+
});
|
|
66
|
+
it('a server completion reports onComplete once and drops the listeners', () => {
|
|
67
|
+
const { sink, unsubscribe, removeListeners, callbacks, handle } = setup();
|
|
68
|
+
sink().complete();
|
|
69
|
+
handle.dispose();
|
|
70
|
+
expect(callbacks.onComplete).toHaveBeenCalledTimes(1);
|
|
71
|
+
// the operation is already over, so there is nothing left to unsubscribe
|
|
72
|
+
expect(unsubscribe).not.toHaveBeenCalled();
|
|
73
|
+
removeListeners.forEach((removeListener) => expect(removeListener).toHaveBeenCalledTimes(1));
|
|
74
|
+
});
|
|
75
|
+
it('terminate() restarts the shared client and keeps the operation and its listeners', () => {
|
|
76
|
+
const { removeListeners, wsClient, handle } = setup();
|
|
77
|
+
handle.terminate();
|
|
78
|
+
expect(wsClient.terminate).toHaveBeenCalledTimes(1);
|
|
79
|
+
removeListeners.forEach((removeListener) => expect(removeListener).not.toHaveBeenCalled());
|
|
80
|
+
});
|
|
81
|
+
});
|
|
82
|
+
//# sourceMappingURL=utils.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"utils.test.js","sourceRoot":"","sources":["../../../src/OwneraAPI/__tests__/utils.test.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|