@chainlink/external-adapter-framework 0.8.1 → 0.9.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/adapter/basic.d.ts +6 -50
- package/adapter/basic.js +2 -165
- package/adapter/basic.js.map +1 -1
- package/adapter/endpoint.d.ts +6 -6
- package/adapter/endpoint.js +0 -1
- package/adapter/endpoint.js.map +1 -1
- package/adapter/price.d.ts +8 -38
- package/adapter/price.js +1 -43
- package/adapter/price.js.map +1 -1
- package/adapter/types.d.ts +14 -37
- package/background-executor.js +4 -19
- package/background-executor.js.map +1 -1
- package/cache/index.d.ts +16 -9
- package/cache/index.js +46 -4
- package/cache/index.js.map +1 -1
- package/config/index.d.ts +11 -19
- package/config/index.js +39 -54
- package/config/index.js.map +1 -1
- package/examples/bank-frick/accounts.d.ts +25 -17
- package/examples/bank-frick/accounts.js +13 -23
- package/examples/bank-frick/accounts.js.map +1 -1
- package/examples/bank-frick/config/index.d.ts +0 -5
- package/examples/bank-frick/config/index.js +0 -5
- package/examples/bank-frick/config/index.js.map +1 -1
- package/examples/bank-frick/index.d.ts +15 -1
- package/examples/bank-frick/index.js +1 -1
- package/examples/coingecko/src/config/index.d.ts +0 -7
- package/examples/coingecko/src/config/index.js +1 -8
- package/examples/coingecko/src/config/index.js.map +1 -1
- package/examples/coingecko/src/crypto-utils.d.ts +4 -19
- package/examples/coingecko/src/crypto-utils.js +2 -1
- package/examples/coingecko/src/crypto-utils.js.map +1 -1
- package/examples/coingecko/src/endpoint/coins.d.ts +3 -20
- package/examples/coingecko/src/endpoint/coins.js +2 -2
- package/examples/coingecko/src/endpoint/coins.js.map +1 -1
- package/examples/coingecko/src/endpoint/crypto-marketcap.d.ts +2 -2
- package/examples/coingecko/src/endpoint/crypto-marketcap.js +2 -2
- package/examples/coingecko/src/endpoint/crypto-marketcap.js.map +1 -1
- package/examples/coingecko/src/endpoint/crypto-volume.d.ts +2 -2
- package/examples/coingecko/src/endpoint/crypto-volume.js +2 -2
- package/examples/coingecko/src/endpoint/crypto-volume.js.map +1 -1
- package/examples/coingecko/src/endpoint/crypto.d.ts +4 -2
- package/examples/coingecko/src/endpoint/crypto.js +2 -2
- package/examples/coingecko/src/endpoint/crypto.js.map +1 -1
- package/examples/coingecko/src/endpoint/dominance.d.ts +2 -2
- package/examples/coingecko/src/endpoint/dominance.js +2 -2
- package/examples/coingecko/src/endpoint/dominance.js.map +1 -1
- package/examples/coingecko/src/endpoint/global-marketcap.d.ts +2 -2
- package/examples/coingecko/src/endpoint/global-marketcap.js +2 -2
- package/examples/coingecko/src/endpoint/global-marketcap.js.map +1 -1
- package/examples/coingecko/src/global-utils.d.ts +3 -18
- package/examples/coingecko/src/global-utils.js.map +1 -1
- package/examples/coingecko/src/index.js +1 -3
- package/examples/coingecko/src/index.js.map +1 -1
- package/examples/coingecko-old/batch-warming.d.ts +7 -0
- package/examples/coingecko-old/batch-warming.js +54 -0
- package/examples/coingecko-old/batch-warming.js.map +1 -0
- package/examples/coingecko-old/index.d.ts +2 -0
- package/examples/coingecko-old/index.js +12 -0
- package/examples/coingecko-old/index.js.map +1 -0
- package/examples/coingecko-old/rest.d.ts +12 -0
- package/examples/coingecko-old/rest.js +55 -0
- package/examples/coingecko-old/rest.js.map +1 -0
- package/examples/cryptocompare/src/config/index.d.ts +0 -7
- package/examples/cryptocompare/src/config/index.js +1 -8
- package/examples/cryptocompare/src/config/index.js.map +1 -1
- package/examples/cryptocompare/src/endpoints/crypto.d.ts +2 -14
- package/examples/cryptocompare/src/endpoints/crypto.js.map +1 -1
- package/examples/cryptocompare/src/index.js +1 -3
- package/examples/cryptocompare/src/index.js.map +1 -1
- package/examples/genesis/config/index.d.ts +0 -5
- package/examples/genesis/config/index.js +0 -5
- package/examples/genesis/config/index.js.map +1 -1
- package/examples/genesis/index.js +1 -1
- package/examples/genesis/sseStream.d.ts +2 -13
- package/examples/genesis/sseStream.js +1 -4
- package/examples/genesis/sseStream.js.map +1 -1
- package/examples/ncfx/config/index.d.ts +12 -0
- package/examples/ncfx/config/index.js +16 -0
- package/examples/ncfx/config/index.js.map +1 -0
- package/examples/ncfx/index.d.ts +13 -0
- package/examples/ncfx/index.js +12 -0
- package/examples/ncfx/index.js.map +1 -0
- package/examples/ncfx/websocket.d.ts +47 -0
- package/examples/ncfx/websocket.js +74 -0
- package/examples/ncfx/websocket.js.map +1 -0
- package/index.d.ts +0 -1
- package/index.js +6 -4
- package/index.js.map +1 -1
- package/metrics/index.d.ts +0 -2
- package/metrics/index.js +4 -5
- package/metrics/index.js.map +1 -1
- package/metrics/util.d.ts +5 -5
- package/metrics/util.js.map +1 -1
- package/package.json +9 -7
- package/rate-limiting/background/fixed-frequency.d.ts +3 -2
- package/rate-limiting/background/fixed-frequency.js.map +1 -1
- package/rate-limiting/index.d.ts +4 -4
- package/rate-limiting/index.js +1 -1
- package/rate-limiting/index.js.map +1 -1
- package/rate-limiting/request/simple-counting.d.ts +3 -2
- package/rate-limiting/request/simple-counting.js.map +1 -1
- package/transports/batch-warming.d.ts +17 -39
- package/transports/batch-warming.js +16 -43
- package/transports/batch-warming.js.map +1 -1
- package/transports/index.d.ts +31 -65
- package/transports/index.js +59 -2
- package/transports/index.js.map +1 -1
- package/transports/metrics.d.ts +2 -2
- package/transports/metrics.js +2 -2
- package/transports/metrics.js.map +1 -1
- package/transports/rest.d.ts +30 -42
- package/transports/rest.js +25 -17
- package/transports/rest.js.map +1 -1
- package/transports/sse.d.ts +20 -40
- package/transports/sse.js +8 -10
- package/transports/sse.js.map +1 -1
- package/transports/websocket.d.ts +25 -40
- package/transports/websocket.js +16 -13
- package/transports/websocket.js.map +1 -1
- package/util/logger.d.ts +0 -2
- package/util/logger.js +7 -4
- package/util/logger.js.map +1 -1
- package/util/request.d.ts +10 -46
- package/util/subscription-set/subscription-set.d.ts +1 -1
- package/util/subscription-set/subscription-set.js +1 -1
- package/util/subscription-set/subscription-set.js.map +1 -1
- package/util/test-payload-loader.d.ts +0 -1
- package/util/test-payload-loader.js +1 -2
- package/util/test-payload-loader.js.map +1 -1
- package/validation/error.d.ts +3 -1
- package/validation/error.js +4 -2
- package/validation/error.js.map +1 -1
- package/validation/index.js +17 -26
- package/validation/index.js.map +1 -1
- package/validation/input-params.d.ts +1 -0
- package/validation/input-params.js +28 -0
- package/validation/input-params.js.map +1 -1
- package/validation/input-validator.js +2 -1
- package/validation/input-validator.js.map +1 -1
- package/validation/override-functions.d.ts +3 -0
- package/validation/override-functions.js +41 -0
- package/validation/override-functions.js.map +1 -0
- package/README.md +0 -67
- package/transports/routing.d.ts +0 -21
- package/transports/routing.js +0 -50
- package/transports/routing.js.map +0 -1
package/adapter/types.d.ts
CHANGED
|
@@ -1,13 +1,12 @@
|
|
|
1
|
-
import type EventSource from 'eventsource';
|
|
2
1
|
import Redis from 'ioredis';
|
|
3
|
-
import { Cache } from '../cache';
|
|
4
|
-
import { AdapterConfig, BaseAdapterConfig, SettingsMap } from '../config';
|
|
5
|
-
import { AdapterRateLimitTier, BackgroundExecuteRateLimiter, RequestRateLimiter } from '../rate-limiting';
|
|
6
|
-
import { Transport, TransportGenerics } from '../transports';
|
|
7
|
-
import { AdapterRequest, SubscriptionSetFactory } from '../util';
|
|
8
|
-
import { InputParameters } from '../validation';
|
|
9
|
-
import { Adapter } from './basic';
|
|
10
2
|
import { AdapterEndpoint } from './endpoint';
|
|
3
|
+
import { CustomSettingsType, SettingsMap, AdapterConfig, BaseAdapterConfig } from '../config';
|
|
4
|
+
import { RequestRateLimiter, BackgroundExecuteRateLimiter, AdapterRateLimitTier } from '../rate-limiting';
|
|
5
|
+
import { Transport } from '../transports';
|
|
6
|
+
import { SubscriptionSetFactory } from '../util';
|
|
7
|
+
import { InputParameters } from '../validation';
|
|
8
|
+
import { Cache } from '../cache';
|
|
9
|
+
import type EventSource from 'eventsource';
|
|
11
10
|
export declare type CustomAdapterSettings = SettingsMap & NegatedAdapterSettings;
|
|
12
11
|
declare type NegatedAdapterSettings = {
|
|
13
12
|
[K in keyof BaseAdapterConfig]?: never;
|
|
@@ -33,11 +32,11 @@ export interface AdapterDependencies {
|
|
|
33
32
|
* Context that will be used on background executions of a Transport.
|
|
34
33
|
* For example, the endpointName used to log statements or generate Cache keys.
|
|
35
34
|
*/
|
|
36
|
-
export interface AdapterContext<
|
|
35
|
+
export interface AdapterContext<CustomSettings extends CustomSettingsType<CustomSettings> = SettingsMap> {
|
|
37
36
|
/** Endpoint instance within the adapter that the Transport is related to */
|
|
38
|
-
adapterEndpoint: AdapterEndpoint<
|
|
37
|
+
adapterEndpoint: AdapterEndpoint<unknown, unknown, CustomSettings>;
|
|
39
38
|
/** Initialized config for the adapter that the Transport can access */
|
|
40
|
-
adapterConfig: AdapterConfig<
|
|
39
|
+
adapterConfig: AdapterConfig<CustomSettings>;
|
|
41
40
|
}
|
|
42
41
|
/**
|
|
43
42
|
* Structure to describe rate limits specs for the Adapter
|
|
@@ -46,24 +45,12 @@ export interface AdapterRateLimitingConfig {
|
|
|
46
45
|
/** Adapter rate limits, gotten from the specific tier requested */
|
|
47
46
|
tiers: Record<string, AdapterRateLimitTier>;
|
|
48
47
|
}
|
|
49
|
-
/**
|
|
50
|
-
* Type to perform arbitrary modifications on an adapter request
|
|
51
|
-
*/
|
|
52
|
-
export declare type RequestTransform = (req: AdapterRequest) => void;
|
|
53
|
-
/**
|
|
54
|
-
* Map of overrides objects (symbol -\> symbol) per adapter name
|
|
55
|
-
*/
|
|
56
|
-
export declare type Overrides = {
|
|
57
|
-
[adapterName: string]: {
|
|
58
|
-
[symbol: string]: string;
|
|
59
|
-
};
|
|
60
|
-
};
|
|
61
48
|
/**
|
|
62
49
|
* Main structure of an External Adapter
|
|
63
50
|
*/
|
|
64
51
|
export interface AdapterParams<CustomSettings extends SettingsMap> {
|
|
65
52
|
/** Name of the adapter */
|
|
66
|
-
name:
|
|
53
|
+
name: string;
|
|
67
54
|
/** If present, the string that will be used for requests with no specified endpoint */
|
|
68
55
|
defaultEndpoint?: string;
|
|
69
56
|
/**
|
|
@@ -75,7 +62,7 @@ export interface AdapterParams<CustomSettings extends SettingsMap> {
|
|
|
75
62
|
* We also can't use generics, because if we had more than one transport with different requests (very likely)
|
|
76
63
|
* then those new types wouldn't match with each other.
|
|
77
64
|
*/
|
|
78
|
-
endpoints: AdapterEndpoint<any>[];
|
|
65
|
+
endpoints: AdapterEndpoint<any, any, CustomSettings>[];
|
|
79
66
|
/** Map of overrides to the default config values for an Adapter */
|
|
80
67
|
envDefaultOverrides?: Partial<BaseAdapterConfig>;
|
|
81
68
|
/** List of custom env vars for this particular adapter (e.g. RPC_URL) */
|
|
@@ -84,10 +71,6 @@ export interface AdapterParams<CustomSettings extends SettingsMap> {
|
|
|
84
71
|
rateLimiting?: AdapterRateLimitingConfig;
|
|
85
72
|
/** Overrides for converting the 'base' parameter that are hardcoded into the adapter. */
|
|
86
73
|
overrides?: Record<string, string>;
|
|
87
|
-
/** Transforms that will apply to the request before submitting it through the adapter request flow */
|
|
88
|
-
requestTransforms?: RequestTransform[];
|
|
89
|
-
/** Bootstrap function that will run when initializing the adapter */
|
|
90
|
-
bootstrap?: (adapter: Adapter<CustomSettings>) => Promise<void>;
|
|
91
74
|
}
|
|
92
75
|
/**
|
|
93
76
|
* Structure to describe rate limits specs for a specific adapter endpoint
|
|
@@ -100,25 +83,19 @@ export interface EndpointRateLimitingConfig {
|
|
|
100
83
|
*/
|
|
101
84
|
allocationPercentage: number;
|
|
102
85
|
}
|
|
103
|
-
/**
|
|
104
|
-
* Helper type structure that contains the different types passed to the generic parameters of an AdapterEndpoint
|
|
105
|
-
*/
|
|
106
|
-
export declare type EndpointGenerics = TransportGenerics;
|
|
107
86
|
/**
|
|
108
87
|
* Structure to describe a specific endpoint in an [[Adapter]]
|
|
109
88
|
*/
|
|
110
|
-
export interface AdapterEndpointParams<
|
|
89
|
+
export interface AdapterEndpointParams<Params, Result, CustomSettings extends SettingsMap> {
|
|
111
90
|
/** Name that will be used to match input params to this endpoint (case insensitive) */
|
|
112
91
|
name: string;
|
|
113
92
|
/** List of alternative endpoint names that will resolve to this same transport (case insensitive) */
|
|
114
93
|
aliases?: string[];
|
|
115
94
|
/** Transport that will be used to handle data processing and communication for this endpoint */
|
|
116
|
-
transport: Transport<
|
|
95
|
+
transport: Transport<Params, Result, CustomSettings>;
|
|
117
96
|
/** Specification of what the body of a request hitting this endpoint should look like (used for validation) */
|
|
118
97
|
inputParameters: InputParameters;
|
|
119
98
|
/** Specific details related to the rate limiting for this endpoint in particular */
|
|
120
99
|
rateLimiting?: EndpointRateLimitingConfig;
|
|
121
|
-
/** Custom function that generates cache keys */
|
|
122
|
-
cacheKeyGenerator?: (data: Record<string, unknown>) => string;
|
|
123
100
|
}
|
|
124
101
|
export {};
|
package/background-executor.js
CHANGED
|
@@ -24,8 +24,8 @@ var __importStar = (this && this.__importStar) || function (mod) {
|
|
|
24
24
|
};
|
|
25
25
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
26
26
|
exports.callBackgroundExecutes = void 0;
|
|
27
|
-
const metrics = __importStar(require("./metrics"));
|
|
28
27
|
const util_1 = require("./util");
|
|
28
|
+
const metrics = __importStar(require("./metrics"));
|
|
29
29
|
const logger = (0, util_1.makeLogger)('BackgroundExecutor');
|
|
30
30
|
/**
|
|
31
31
|
* Very simple background loop that will call the [[Transport.backgroundExecute]] functions in all Transports.
|
|
@@ -47,12 +47,11 @@ async function callBackgroundExecutes(adapter, apiShutdownPromise) {
|
|
|
47
47
|
clearTimeout(timeoutsMap[endpointName]);
|
|
48
48
|
}
|
|
49
49
|
});
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
const backgroundExecute = transport.backgroundExecute?.bind(transport);
|
|
50
|
+
for (const endpoint of adapter.endpoints) {
|
|
51
|
+
const backgroundExecute = endpoint.transport.backgroundExecute?.bind(endpoint.transport);
|
|
53
52
|
if (!backgroundExecute) {
|
|
54
53
|
logger.debug(`Endpoint "${endpoint.name}" has no background execute, skipping...`);
|
|
55
|
-
|
|
54
|
+
continue;
|
|
56
55
|
}
|
|
57
56
|
const context = {
|
|
58
57
|
adapterEndpoint: endpoint,
|
|
@@ -77,20 +76,6 @@ async function callBackgroundExecutes(adapter, apiShutdownPromise) {
|
|
|
77
76
|
};
|
|
78
77
|
// Start recursive async calls
|
|
79
78
|
handler();
|
|
80
|
-
};
|
|
81
|
-
for (const endpoint of adapter.endpoints) {
|
|
82
|
-
const { transport } = endpoint;
|
|
83
|
-
// Check if transport is a MetaTransport by casting and checking a known property (transports)
|
|
84
|
-
const castMeta = transport;
|
|
85
|
-
if (castMeta.transports) {
|
|
86
|
-
logger.debug(`Encountered MetaTransport ${transport.constructor.name}, calling backgroundExecute on all transports`);
|
|
87
|
-
for (const nestedTransport of Object.values(castMeta.transports)) {
|
|
88
|
-
callBackgroundExecute(endpoint, nestedTransport);
|
|
89
|
-
}
|
|
90
|
-
}
|
|
91
|
-
else {
|
|
92
|
-
callBackgroundExecute(endpoint, transport);
|
|
93
|
-
}
|
|
94
79
|
}
|
|
95
80
|
}
|
|
96
81
|
exports.callBackgroundExecutes = callBackgroundExecutes;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"background-executor.js","sourceRoot":"","sources":["../../src/background-executor.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AACA,mDAAoC;AAEpC,
|
|
1
|
+
{"version":3,"file":"background-executor.js","sourceRoot":"","sources":["../../src/background-executor.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AACA,iCAAmC;AACnC,mDAAoC;AAEpC,MAAM,MAAM,GAAG,IAAA,iBAAU,EAAC,oBAAoB,CAAC,CAAA;AAE/C;;;;;;GAMG;AACI,KAAK,UAAU,sBAAsB,CAAC,OAAgB,EAAE,kBAAkC;IAC/F,uFAAuF;IACvF,4FAA4F;IAC5F,IAAI,YAAY,GAAG,KAAK,CAAA;IACxB,MAAM,WAAW,GAEb,EAAE,CAAA;IAEN,kBAAkB,EAAE,IAAI,CAAC,GAAG,EAAE;QAC5B,YAAY,GAAG,IAAI,CAAA;QACnB,KAAK,MAAM,YAAY,IAAI,WAAW,EAAE;YACtC,MAAM,CAAC,KAAK,CAAC,kCAAkC,YAAY,GAAG,CAAC,CAAA;YAC/D,WAAW,CAAC,YAAY,CAAC,CAAC,KAAK,EAAE,CAAA;YACjC,YAAY,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAAA;SACxC;IACH,CAAC,CAAC,CAAA;IAEF,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,SAAS,EAAE;QACxC,MAAM,iBAAiB,GAAG,QAAQ,CAAC,SAAS,CAAC,iBAAiB,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;QACxF,IAAI,CAAC,iBAAiB,EAAE;YACtB,MAAM,CAAC,KAAK,CAAC,aAAa,QAAQ,CAAC,IAAI,0CAA0C,CAAC,CAAA;YAClF,SAAQ;SACT;QAED,MAAM,OAAO,GAAmB;YAC9B,eAAe,EAAE,QAAQ;YACzB,aAAa,EAAE,OAAO,CAAC,MAAM;SAC9B,CAAA;QAED,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;YACzB,IAAI,YAAY,EAAE;gBAChB,MAAM,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAA;gBAChF,OAAM;aACP;YACD,qDAAqD;YACrD,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE,CAAA;YAEhE,2EAA2E;YAC3E,MAAM,YAAY,GAAG,OAAO,CAAC,wBAAwB;iBAClD,MAAM,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;iBACnC,UAAU,EAAE,CAAA;YAEf,MAAM,CAAC,KAAK,CAAC,4CAA4C,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAA;YAC1E,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAA;YACnD,MAAM,CAAC,KAAK,CACV,6CAA6C,QAAQ,CAAC,IAAI,mBAAmB,UAAU,IAAI,CAC5F,CAAA;YAED,YAAY,EAAE,CAAA;YACd,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;QAC9D,CAAC,CAAA;QAED,8BAA8B;QAC9B,OAAO,EAAE,CAAA;KACV;AACH,CAAC;AAvDD,wDAuDC"}
|
package/cache/index.d.ts
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
import { AdapterEndpoint } from '../adapter';
|
|
2
2
|
import { AdapterConfig, SettingsMap } from '../config';
|
|
3
|
-
import { AdapterResponse, sleep } from '../util';
|
|
4
|
-
export * from './factory';
|
|
3
|
+
import { AdapterMiddlewareBuilder, AdapterResponse, sleep } from '../util';
|
|
5
4
|
export * from './local';
|
|
6
5
|
export * from './redis';
|
|
6
|
+
export * from './factory';
|
|
7
7
|
/**
|
|
8
8
|
* An object describing an entry in the cache.
|
|
9
9
|
* @typeParam T - the type of the entry's value
|
|
@@ -49,13 +49,13 @@ export interface Cache<T = unknown> {
|
|
|
49
49
|
*/
|
|
50
50
|
delete: (key: string) => Promise<void>;
|
|
51
51
|
}
|
|
52
|
-
export declare const calculateCacheKey: <
|
|
53
|
-
adapterEndpoint: AdapterEndpoint<
|
|
54
|
-
adapterConfig: AdapterConfig<
|
|
52
|
+
export declare const calculateCacheKey: <Params, Result, CustomSettings extends SettingsMap>({ adapterEndpoint, adapterConfig, }: {
|
|
53
|
+
adapterEndpoint: AdapterEndpoint<Params, Result, CustomSettings>;
|
|
54
|
+
adapterConfig: AdapterConfig<CustomSettings>;
|
|
55
55
|
}, data: unknown) => string;
|
|
56
|
-
export declare const calculateFeedId: <
|
|
57
|
-
adapterEndpoint: AdapterEndpoint<
|
|
58
|
-
adapterConfig: AdapterConfig<
|
|
56
|
+
export declare const calculateFeedId: <Params, Result, CustomSettings extends SettingsMap>({ adapterEndpoint, adapterConfig, }: {
|
|
57
|
+
adapterEndpoint: AdapterEndpoint<Params, Result, CustomSettings>;
|
|
58
|
+
adapterConfig: AdapterConfig<CustomSettings>;
|
|
59
59
|
}, data: unknown) => string;
|
|
60
60
|
/**
|
|
61
61
|
* Calculates a unique key from the provided data.
|
|
@@ -71,7 +71,6 @@ export declare const calculateFeedId: <T extends import("../transports").Transpo
|
|
|
71
71
|
* ```
|
|
72
72
|
*/
|
|
73
73
|
export declare const calculateKey: <CustomSettings extends SettingsMap>(data: unknown, paramNames: string[], adapterConfig: AdapterConfig<CustomSettings>) => string;
|
|
74
|
-
export declare const calculateStaleness: (expirationTimestamp: number | undefined, ttl: number) => number;
|
|
75
74
|
/**
|
|
76
75
|
* Polls the provided Cache for an AdapterResponse set in the provided key. If the maximum
|
|
77
76
|
* amount of retries is exceeded, it returns undefined instead.
|
|
@@ -85,3 +84,11 @@ export declare const pollResponseFromCache: (cache: Cache<AdapterResponse>, key:
|
|
|
85
84
|
maxRetries: number;
|
|
86
85
|
sleep: number;
|
|
87
86
|
}, retry?: number) => Promise<AdapterResponse | undefined>;
|
|
87
|
+
/**
|
|
88
|
+
* Given a Cache instance in the adapter dependencies, builds a middleware function that will perform
|
|
89
|
+
* a get from said Cache and return that if found; otherwise it'll continue the middleware chain.
|
|
90
|
+
*
|
|
91
|
+
* @param adapter - an initialized adapter
|
|
92
|
+
* @returns the cache middleware function
|
|
93
|
+
*/
|
|
94
|
+
export declare const buildCacheMiddleware: AdapterMiddlewareBuilder;
|
package/cache/index.js
CHANGED
|
@@ -10,15 +10,28 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
|
|
|
10
10
|
if (k2 === undefined) k2 = k;
|
|
11
11
|
o[k2] = m[k];
|
|
12
12
|
}));
|
|
13
|
+
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
|
|
14
|
+
Object.defineProperty(o, "default", { enumerable: true, value: v });
|
|
15
|
+
}) : function(o, v) {
|
|
16
|
+
o["default"] = v;
|
|
17
|
+
});
|
|
18
|
+
var __importStar = (this && this.__importStar) || function (mod) {
|
|
19
|
+
if (mod && mod.__esModule) return mod;
|
|
20
|
+
var result = {};
|
|
21
|
+
if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
|
|
22
|
+
__setModuleDefault(result, mod);
|
|
23
|
+
return result;
|
|
24
|
+
};
|
|
13
25
|
var __exportStar = (this && this.__exportStar) || function(m, exports) {
|
|
14
26
|
for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
|
|
15
27
|
};
|
|
16
28
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
17
|
-
exports.
|
|
29
|
+
exports.buildCacheMiddleware = exports.pollResponseFromCache = exports.calculateKey = exports.calculateFeedId = exports.calculateCacheKey = void 0;
|
|
18
30
|
const util_1 = require("../util");
|
|
19
|
-
|
|
31
|
+
const cacheMetrics = __importStar(require("./metrics"));
|
|
20
32
|
__exportStar(require("./local"), exports);
|
|
21
33
|
__exportStar(require("./redis"), exports);
|
|
34
|
+
__exportStar(require("./factory"), exports);
|
|
22
35
|
const logger = (0, util_1.makeLogger)('Cache');
|
|
23
36
|
// Uses calculateKey to generate a unique key from the endpoint name, data, and input parameters
|
|
24
37
|
const calculateCacheKey = ({ adapterEndpoint, adapterConfig, }, data) => {
|
|
@@ -61,6 +74,10 @@ const calculateKey = (data, paramNames, adapterConfig) => {
|
|
|
61
74
|
const params = data;
|
|
62
75
|
let cacheKey = '';
|
|
63
76
|
for (const paramName of paramNames) {
|
|
77
|
+
// Ignore overrides param when generating cache keys
|
|
78
|
+
if (paramName === 'overrides') {
|
|
79
|
+
continue;
|
|
80
|
+
}
|
|
64
81
|
const param = params[paramName];
|
|
65
82
|
if (param === undefined) {
|
|
66
83
|
continue;
|
|
@@ -87,7 +104,7 @@ const calculateKey = (data, paramNames, adapterConfig) => {
|
|
|
87
104
|
return cacheKey;
|
|
88
105
|
};
|
|
89
106
|
exports.calculateKey = calculateKey;
|
|
90
|
-
// Calculate the amount of time
|
|
107
|
+
// Calculate the amount of time the non-expired entry has been in the cache
|
|
91
108
|
const calculateStaleness = (expirationTimestamp, ttl) => {
|
|
92
109
|
if (expirationTimestamp) {
|
|
93
110
|
const createTimestamp = expirationTimestamp - ttl;
|
|
@@ -99,7 +116,6 @@ const calculateStaleness = (expirationTimestamp, ttl) => {
|
|
|
99
116
|
return ttl;
|
|
100
117
|
}
|
|
101
118
|
};
|
|
102
|
-
exports.calculateStaleness = calculateStaleness;
|
|
103
119
|
/**
|
|
104
120
|
* Polls the provided Cache for an AdapterResponse set in the provided key. If the maximum
|
|
105
121
|
* amount of retries is exceeded, it returns undefined instead.
|
|
@@ -130,4 +146,30 @@ const pollResponseFromCache = async (cache, key, options, retry = 0) => {
|
|
|
130
146
|
return (0, exports.pollResponseFromCache)(cache, key, options, retry + 1);
|
|
131
147
|
};
|
|
132
148
|
exports.pollResponseFromCache = pollResponseFromCache;
|
|
149
|
+
/**
|
|
150
|
+
* Given a Cache instance in the adapter dependencies, builds a middleware function that will perform
|
|
151
|
+
* a get from said Cache and return that if found; otherwise it'll continue the middleware chain.
|
|
152
|
+
*
|
|
153
|
+
* @param adapter - an initialized adapter
|
|
154
|
+
* @returns the cache middleware function
|
|
155
|
+
*/
|
|
156
|
+
const buildCacheMiddleware = (adapter) => async (req, res) => {
|
|
157
|
+
const response = await adapter.dependencies.cache.get(req.requestContext.cacheKey);
|
|
158
|
+
if (response) {
|
|
159
|
+
logger.debug('Found response from cache, sending that');
|
|
160
|
+
if (adapter.config.METRICS_ENABLED && adapter.config.EXPERIMENTAL_METRICS_ENABLED) {
|
|
161
|
+
const label = cacheMetrics.cacheMetricsLabel(req.requestContext.cacheKey, req.requestContext.meta?.metrics?.feedId || 'N/A', adapter.config.CACHE_TYPE);
|
|
162
|
+
// Record cache staleness and cache get count and value
|
|
163
|
+
const staleness = calculateStaleness(response.maxAge, adapter.config.CACHE_MAX_AGE);
|
|
164
|
+
cacheMetrics.cacheGet(label, response.result, staleness);
|
|
165
|
+
req.requestContext.meta = {
|
|
166
|
+
...req.requestContext.meta,
|
|
167
|
+
metrics: { ...req.requestContext.meta?.metrics, cacheHit: true },
|
|
168
|
+
};
|
|
169
|
+
}
|
|
170
|
+
return res.send(response);
|
|
171
|
+
}
|
|
172
|
+
logger.debug('Did not find response in cache, moving to next middleware');
|
|
173
|
+
};
|
|
174
|
+
exports.buildCacheMiddleware = buildCacheMiddleware;
|
|
133
175
|
//# sourceMappingURL=index.js.map
|
package/cache/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cache/index.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cache/index.ts"],"names":[],"mappings":"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"}
|
package/config/index.d.ts
CHANGED
|
@@ -3,6 +3,11 @@ export declare const BaseSettings: {
|
|
|
3
3
|
readonly description: "The URL that certain transports use to retrieve data";
|
|
4
4
|
readonly type: "string";
|
|
5
5
|
};
|
|
6
|
+
readonly API_KEY: {
|
|
7
|
+
readonly description: "Default setting for an EA key";
|
|
8
|
+
readonly type: "string";
|
|
9
|
+
readonly sensitive: true;
|
|
10
|
+
};
|
|
6
11
|
readonly API_TIMEOUT: {
|
|
7
12
|
readonly description: "The number of milliseconds a request can be pending before returning a timeout error for data provider request";
|
|
8
13
|
readonly type: "number";
|
|
@@ -18,31 +23,16 @@ export declare const BaseSettings: {
|
|
|
18
23
|
readonly type: "string";
|
|
19
24
|
readonly default: "/";
|
|
20
25
|
};
|
|
21
|
-
readonly BATCH_TRANSPORT_SETUP_VALIDATION: {
|
|
22
|
-
readonly description: "Flag to toggle batch transport setup validation";
|
|
23
|
-
readonly type: "boolean";
|
|
24
|
-
readonly default: false;
|
|
25
|
-
};
|
|
26
26
|
readonly CACHE_MAX_AGE: {
|
|
27
27
|
readonly description: "Maximum amount of time (in ms) that a response will stay cached";
|
|
28
28
|
readonly type: "number";
|
|
29
29
|
readonly default: 90000;
|
|
30
30
|
};
|
|
31
|
-
readonly CACHE_REDIS_CONNECTION_TIMEOUT: {
|
|
32
|
-
readonly description: "Connection timeout for redis client";
|
|
33
|
-
readonly type: "number";
|
|
34
|
-
readonly default: 15000;
|
|
35
|
-
};
|
|
36
31
|
readonly CACHE_REDIS_HOST: {
|
|
37
32
|
readonly description: "Hostname for the Redis instance to be used";
|
|
38
33
|
readonly type: "string";
|
|
39
34
|
readonly default: "127.0.0.1";
|
|
40
35
|
};
|
|
41
|
-
readonly CACHE_REDIS_MAX_RECONNECT_COOLDOWN: {
|
|
42
|
-
readonly description: "Max cooldown (in ms) before attempting redis reconnection";
|
|
43
|
-
readonly type: "number";
|
|
44
|
-
readonly default: 3000;
|
|
45
|
-
};
|
|
46
36
|
readonly CACHE_REDIS_PASSWORD: {
|
|
47
37
|
readonly description: "The password required for redis auth";
|
|
48
38
|
readonly type: "string";
|
|
@@ -161,6 +151,11 @@ export declare const BaseSettings: {
|
|
|
161
151
|
readonly description: "Override the base websocket URL within the EA.";
|
|
162
152
|
readonly type: "string";
|
|
163
153
|
};
|
|
154
|
+
readonly WS_API_KEY: {
|
|
155
|
+
readonly description: "The websocket API key to authenticate with";
|
|
156
|
+
readonly type: "string";
|
|
157
|
+
readonly sensitive: true;
|
|
158
|
+
};
|
|
164
159
|
readonly WS_SUBSCRIPTION_TTL: {
|
|
165
160
|
readonly description: "";
|
|
166
161
|
readonly type: "number";
|
|
@@ -213,13 +208,10 @@ export declare const BaseSettings: {
|
|
|
213
208
|
readonly type: "string";
|
|
214
209
|
};
|
|
215
210
|
};
|
|
216
|
-
export declare const buildAdapterConfig: <CustomSettings extends CustomSettingsType<CustomSettings> = EmptySettings>({ overrides, customSettings,
|
|
211
|
+
export declare const buildAdapterConfig: <CustomSettings extends CustomSettingsType<CustomSettings> = EmptySettings>({ overrides, customSettings, }: {
|
|
217
212
|
overrides?: Partial<BaseAdapterConfig> | undefined;
|
|
218
213
|
customSettings?: SettingsMap | undefined;
|
|
219
|
-
envVarsPrefix?: string | undefined;
|
|
220
214
|
}) => AdapterConfig<CustomSettings>;
|
|
221
|
-
export declare const validateAdapterConfig: <CustomSettings extends CustomSettingsType<CustomSettings> = EmptySettings>(adapterConfig: AdapterConfig<CustomSettings>, customSettings?: SettingsMap) => void;
|
|
222
|
-
export declare const getEnv: (name: string, config: Setting, prefix?: string) => SettingValueType | null;
|
|
223
215
|
declare type SettingValueType = string | number | boolean;
|
|
224
216
|
declare type SettingType<C extends Setting> = C['type'] extends 'string' ? string : C['type'] extends 'number' ? number : C['type'] extends 'boolean' ? boolean : C['type'] extends 'enum' ? C['options'] extends readonly string[] ? C['options'][number] : never : never;
|
|
225
217
|
declare type BaseSettingsType = typeof BaseSettings;
|
package/config/index.js
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
"use strict";
|
|
2
|
+
// Import { getRandomRequiredEnv, getRandomEnv, getEnv } from '../util'
|
|
2
3
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.
|
|
4
|
+
exports.buildAdapterConfig = exports.BaseSettings = void 0;
|
|
4
5
|
exports.BaseSettings = {
|
|
5
6
|
// V2 compat
|
|
6
7
|
// ADAPTER_URL: {
|
|
@@ -11,6 +12,11 @@ exports.BaseSettings = {
|
|
|
11
12
|
description: 'The URL that certain transports use to retrieve data',
|
|
12
13
|
type: 'string',
|
|
13
14
|
},
|
|
15
|
+
API_KEY: {
|
|
16
|
+
description: 'Default setting for an EA key',
|
|
17
|
+
type: 'string',
|
|
18
|
+
sensitive: true,
|
|
19
|
+
},
|
|
14
20
|
API_TIMEOUT: {
|
|
15
21
|
description: 'The number of milliseconds a request can be pending before returning a timeout error for data provider request',
|
|
16
22
|
type: 'number',
|
|
@@ -26,11 +32,6 @@ exports.BaseSettings = {
|
|
|
26
32
|
type: 'string',
|
|
27
33
|
default: '/',
|
|
28
34
|
},
|
|
29
|
-
BATCH_TRANSPORT_SETUP_VALIDATION: {
|
|
30
|
-
description: 'Flag to toggle batch transport setup validation',
|
|
31
|
-
type: 'boolean',
|
|
32
|
-
default: false,
|
|
33
|
-
},
|
|
34
35
|
CACHE_MAX_AGE: {
|
|
35
36
|
description: 'Maximum amount of time (in ms) that a response will stay cached',
|
|
36
37
|
type: 'number',
|
|
@@ -44,11 +45,10 @@ exports.BaseSettings = {
|
|
|
44
45
|
// type: 'number',
|
|
45
46
|
// default: 30000,
|
|
46
47
|
// },
|
|
47
|
-
CACHE_REDIS_CONNECTION_TIMEOUT: {
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
},
|
|
48
|
+
// CACHE_REDIS_CONNECTION_TIMEOUT: {
|
|
49
|
+
// type: 'number',
|
|
50
|
+
// default: 15000,
|
|
51
|
+
// },
|
|
52
52
|
CACHE_REDIS_HOST: {
|
|
53
53
|
description: 'Hostname for the Redis instance to be used',
|
|
54
54
|
type: 'string',
|
|
@@ -59,11 +59,10 @@ exports.BaseSettings = {
|
|
|
59
59
|
// type: 'number',
|
|
60
60
|
// default: 500,
|
|
61
61
|
// },
|
|
62
|
-
CACHE_REDIS_MAX_RECONNECT_COOLDOWN: {
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
},
|
|
62
|
+
// CACHE_REDIS_MAX_RECONNECT_COOLDOWN: {
|
|
63
|
+
// type: 'number',
|
|
64
|
+
// default: 3000,
|
|
65
|
+
// },
|
|
67
66
|
CACHE_REDIS_PASSWORD: {
|
|
68
67
|
description: 'The password required for redis auth',
|
|
69
68
|
type: 'string',
|
|
@@ -221,6 +220,11 @@ exports.BaseSettings = {
|
|
|
221
220
|
description: 'Override the base websocket URL within the EA.',
|
|
222
221
|
type: 'string',
|
|
223
222
|
},
|
|
223
|
+
WS_API_KEY: {
|
|
224
|
+
description: 'The websocket API key to authenticate with',
|
|
225
|
+
type: 'string',
|
|
226
|
+
sensitive: true,
|
|
227
|
+
},
|
|
224
228
|
WS_SUBSCRIPTION_TTL: {
|
|
225
229
|
description: '',
|
|
226
230
|
type: 'number',
|
|
@@ -286,11 +290,12 @@ exports.BaseSettings = {
|
|
|
286
290
|
type: 'string',
|
|
287
291
|
},
|
|
288
292
|
};
|
|
289
|
-
const buildAdapterConfig = ({ overrides = {}, customSettings = {},
|
|
293
|
+
const buildAdapterConfig = ({ overrides = {}, customSettings = {}, }) => {
|
|
294
|
+
const validationErrors = [];
|
|
290
295
|
const vars = {};
|
|
291
296
|
// Iterate base adapter env vars
|
|
292
297
|
for (const [key, config] of Object.entries(exports.BaseSettings)) {
|
|
293
|
-
const value =
|
|
298
|
+
const value = getEnv(key, config) ?? overrides?.[key] ?? config.default;
|
|
294
299
|
vars[key] = value;
|
|
295
300
|
}
|
|
296
301
|
// Iterate custom vars
|
|
@@ -298,47 +303,28 @@ const buildAdapterConfig = ({ overrides = {}, customSettings = {}, envVarsPrefix
|
|
|
298
303
|
if (exports.BaseSettings[key]) {
|
|
299
304
|
throw new Error(`Custom env var "${key}" declared, but a base framework env var with that name already exists.`);
|
|
300
305
|
}
|
|
301
|
-
const value =
|
|
306
|
+
const value = getEnv(key, config) ?? config.default;
|
|
307
|
+
// Check if a required setting has been provided
|
|
308
|
+
if (config.required && value === null) {
|
|
309
|
+
validationErrors.push(`${key}: Value is required, but none was provided`);
|
|
310
|
+
}
|
|
311
|
+
else if (config.validate) {
|
|
312
|
+
// Cast validate to unknown because TS can't select one of multiple variants of the validate function signature
|
|
313
|
+
const validationRes = config.validate(value);
|
|
314
|
+
if (validationRes) {
|
|
315
|
+
validationErrors.push(`${key}: ${validationRes}`);
|
|
316
|
+
}
|
|
317
|
+
}
|
|
302
318
|
vars[key] = value;
|
|
303
319
|
}
|
|
304
|
-
return vars;
|
|
305
|
-
};
|
|
306
|
-
exports.buildAdapterConfig = buildAdapterConfig;
|
|
307
|
-
const validateAdapterConfig = (adapterConfig, customSettings = {}) => {
|
|
308
|
-
const validationErrors = [];
|
|
309
|
-
Object.entries(exports.BaseSettings)
|
|
310
|
-
.concat(Object.entries(customSettings || {}))
|
|
311
|
-
.forEach(([name, setting]) => {
|
|
312
|
-
validateSetting(name, adapterConfig[name], setting, validationErrors);
|
|
313
|
-
});
|
|
314
320
|
if (validationErrors.length > 0) {
|
|
315
321
|
throw new Error(`Validation failed for the following variables:\n ${validationErrors.join('\n')}`);
|
|
316
322
|
}
|
|
323
|
+
return vars;
|
|
317
324
|
};
|
|
318
|
-
exports.
|
|
319
|
-
const
|
|
320
|
-
|
|
321
|
-
if (config.required && (value === null || value === undefined)) {
|
|
322
|
-
validationErrors.push(`${key}: Value is required, but none was provided`);
|
|
323
|
-
}
|
|
324
|
-
else if (config.validate) {
|
|
325
|
-
// Cast validate to unknown because TS can't select one of multiple variants of the validate function signature
|
|
326
|
-
const validationRes = config.validate(value);
|
|
327
|
-
if (validationRes) {
|
|
328
|
-
validationErrors.push(`${key}: ${validationRes}`);
|
|
329
|
-
}
|
|
330
|
-
}
|
|
331
|
-
};
|
|
332
|
-
const getEnvName = (name, prefix = '') => {
|
|
333
|
-
const envName = prefix ? `${prefix}_${name}` : name;
|
|
334
|
-
if (!isEnvNameValid(envName)) {
|
|
335
|
-
throw new Error(`Invalid environment var name: ${envName}. Only '/^[_a-z0-9]+$/i' is supported.`);
|
|
336
|
-
}
|
|
337
|
-
return envName;
|
|
338
|
-
};
|
|
339
|
-
const isEnvNameValid = (name) => /^[_a-z0-9]+$/i.test(name);
|
|
340
|
-
const getEnv = (name, config, prefix = '') => {
|
|
341
|
-
const value = process.env[getEnvName(name, prefix)];
|
|
325
|
+
exports.buildAdapterConfig = buildAdapterConfig;
|
|
326
|
+
const getEnv = (name, config) => {
|
|
327
|
+
const value = process.env[name];
|
|
342
328
|
if (!value) {
|
|
343
329
|
return null;
|
|
344
330
|
}
|
|
@@ -356,5 +342,4 @@ const getEnv = (name, config, prefix = '') => {
|
|
|
356
342
|
return value;
|
|
357
343
|
}
|
|
358
344
|
};
|
|
359
|
-
exports.getEnv = getEnv;
|
|
360
345
|
//# sourceMappingURL=index.js.map
|
package/config/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":";;;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"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"}
|