meridianjs 0.2.3 → 0.2.5
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/CHANGELOG.md +97 -150
- package/README.md +214 -122
- package/dist/analytics/collector.d.ts +44 -0
- package/dist/analytics/collector.d.ts.map +1 -0
- package/dist/analytics/collector.js +82 -0
- package/dist/analytics/collector.js.map +1 -0
- package/dist/analytics/index.d.ts +3 -0
- package/dist/analytics/index.d.ts.map +1 -0
- package/dist/analytics/index.js +2 -0
- package/dist/analytics/index.js.map +1 -0
- package/dist/capabilities/index.d.ts +3 -0
- package/dist/capabilities/index.d.ts.map +1 -0
- package/dist/capabilities/index.js +2 -0
- package/dist/capabilities/index.js.map +1 -0
- package/dist/capabilities/registry.d.ts +6 -0
- package/dist/capabilities/registry.d.ts.map +1 -0
- package/dist/capabilities/registry.js +61 -0
- package/dist/capabilities/registry.js.map +1 -0
- package/dist/core/pipeline.d.ts +3 -1
- package/dist/core/pipeline.d.ts.map +1 -1
- package/dist/core/pipeline.js +42 -0
- package/dist/core/pipeline.js.map +1 -1
- package/dist/core/types.d.ts +42 -1
- package/dist/core/types.d.ts.map +1 -1
- package/dist/core/types.js +1 -1
- package/dist/core/types.js.map +1 -1
- package/dist/debug/index.d.ts +3 -0
- package/dist/debug/index.d.ts.map +1 -0
- package/dist/debug/index.js +2 -0
- package/dist/debug/index.js.map +1 -0
- package/dist/debug/recorder.d.ts +32 -0
- package/dist/debug/recorder.d.ts.map +1 -0
- package/dist/debug/recorder.js +76 -0
- package/dist/debug/recorder.js.map +1 -0
- package/dist/generator/cli.d.ts +20 -0
- package/dist/generator/cli.d.ts.map +1 -0
- package/dist/generator/cli.js +56 -0
- package/dist/generator/cli.js.map +1 -0
- package/dist/generator/index.d.ts +9 -0
- package/dist/generator/index.d.ts.map +1 -0
- package/dist/generator/index.js +49 -0
- package/dist/generator/index.js.map +1 -0
- package/dist/generator/openapi.d.ts +13 -0
- package/dist/generator/openapi.d.ts.map +1 -0
- package/dist/generator/openapi.js +49 -0
- package/dist/generator/openapi.js.map +1 -0
- package/dist/generator/templates.d.ts +16 -0
- package/dist/generator/templates.d.ts.map +1 -0
- package/dist/generator/templates.js +292 -0
- package/dist/generator/templates.js.map +1 -0
- package/dist/index.d.ts +33 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +101 -0
- package/dist/index.js.map +1 -1
- package/dist/policies/builtin.d.ts +40 -0
- package/dist/policies/builtin.d.ts.map +1 -0
- package/dist/policies/builtin.js +186 -0
- package/dist/policies/builtin.js.map +1 -0
- package/dist/policies/index.d.ts +2 -0
- package/dist/policies/index.d.ts.map +1 -0
- package/dist/policies/index.js +2 -0
- package/dist/policies/index.js.map +1 -0
- package/dist/public.d.ts +17 -0
- package/dist/public.d.ts.map +1 -1
- package/dist/public.js +15 -0
- package/dist/public.js.map +1 -1
- package/dist/schema/index.d.ts +2 -0
- package/dist/schema/index.d.ts.map +1 -0
- package/dist/schema/index.js +2 -0
- package/dist/schema/index.js.map +1 -0
- package/dist/schema/monitor.d.ts +23 -0
- package/dist/schema/monitor.d.ts.map +1 -0
- package/dist/schema/monitor.js +70 -0
- package/dist/schema/monitor.js.map +1 -0
- package/dist/services/index.d.ts +2 -0
- package/dist/services/index.d.ts.map +1 -0
- package/dist/services/index.js +2 -0
- package/dist/services/index.js.map +1 -0
- package/dist/services/service-client.d.ts +41 -0
- package/dist/services/service-client.d.ts.map +1 -0
- package/dist/services/service-client.js +243 -0
- package/dist/services/service-client.js.map +1 -0
- package/dist/transactions/index.d.ts +3 -0
- package/dist/transactions/index.d.ts.map +1 -0
- package/dist/transactions/index.js +2 -0
- package/dist/transactions/index.js.map +1 -0
- package/dist/transactions/saga.d.ts +22 -0
- package/dist/transactions/saga.d.ts.map +1 -0
- package/dist/transactions/saga.js +58 -0
- package/dist/transactions/saga.js.map +1 -0
- package/dist/validation/drift-detector.d.ts.map +1 -1
- package/dist/validation/drift-detector.js +17 -8
- package/dist/validation/drift-detector.js.map +1 -1
- package/package.json +7 -3
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
import { DriftDetector } from "../validation/drift-detector.js";
|
|
2
|
+
function inferSchema(value) {
|
|
3
|
+
if (Array.isArray(value)) {
|
|
4
|
+
return { type: "array", items: value.length > 0 ? inferSchema(value[0]) : { type: "unknown" } };
|
|
5
|
+
}
|
|
6
|
+
if (value !== null && typeof value === "object") {
|
|
7
|
+
const props = {};
|
|
8
|
+
for (const [k, v] of Object.entries(value)) {
|
|
9
|
+
props[k] = inferSchema(v);
|
|
10
|
+
}
|
|
11
|
+
const required = Object.keys(value);
|
|
12
|
+
return { type: "object", properties: props, required };
|
|
13
|
+
}
|
|
14
|
+
if (typeof value === "string")
|
|
15
|
+
return { type: "string" };
|
|
16
|
+
if (typeof value === "number")
|
|
17
|
+
return { type: "number" };
|
|
18
|
+
if (typeof value === "boolean")
|
|
19
|
+
return { type: "boolean" };
|
|
20
|
+
return { type: "null" };
|
|
21
|
+
}
|
|
22
|
+
export class SchemaMonitor {
|
|
23
|
+
storage;
|
|
24
|
+
detector = new DriftDetector();
|
|
25
|
+
constructor(storage) {
|
|
26
|
+
this.storage = storage;
|
|
27
|
+
}
|
|
28
|
+
async snapshot(provider, endpoint, data) {
|
|
29
|
+
const schema = inferSchema(data);
|
|
30
|
+
const version = new Date().toISOString();
|
|
31
|
+
await this.storage.save(provider, endpoint, schema, version);
|
|
32
|
+
}
|
|
33
|
+
async check(provider, endpoint, data) {
|
|
34
|
+
const previous = await this.storage.load(provider, endpoint);
|
|
35
|
+
const current = inferSchema(data);
|
|
36
|
+
if (!previous) {
|
|
37
|
+
await this.storage.save(provider, endpoint, current, new Date().toISOString());
|
|
38
|
+
return [];
|
|
39
|
+
}
|
|
40
|
+
return this.detector.detect(previous, current);
|
|
41
|
+
}
|
|
42
|
+
async list(provider) {
|
|
43
|
+
return this.storage.list(provider);
|
|
44
|
+
}
|
|
45
|
+
async diff(provider, endpoint, data) {
|
|
46
|
+
return this.check(provider, endpoint, data);
|
|
47
|
+
}
|
|
48
|
+
async report(provider) {
|
|
49
|
+
const metadata = await this.storage.list(provider);
|
|
50
|
+
const endpoints = await Promise.all(metadata.map(async (m) => {
|
|
51
|
+
const schema = await this.storage.load(provider, m.endpoint);
|
|
52
|
+
const fieldCount = schema?.type === "object" ? Object.keys(schema.properties ?? {}).length : 1;
|
|
53
|
+
return {
|
|
54
|
+
endpoint: m.endpoint,
|
|
55
|
+
version: m.version,
|
|
56
|
+
fieldCount,
|
|
57
|
+
schema: schema ?? { type: "unknown" },
|
|
58
|
+
};
|
|
59
|
+
}));
|
|
60
|
+
return { provider, endpoints, generatedAt: new Date().toISOString() };
|
|
61
|
+
}
|
|
62
|
+
async alert(provider, endpoint, data, callback) {
|
|
63
|
+
const drifts = await this.check(provider, endpoint, data);
|
|
64
|
+
if (drifts.length > 0) {
|
|
65
|
+
callback(drifts, provider, endpoint);
|
|
66
|
+
}
|
|
67
|
+
return drifts;
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
//# sourceMappingURL=monitor.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"monitor.js","sourceRoot":"","sources":["../../src/schema/monitor.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import type { StreamChunk } from "../core/streaming.js";
|
|
2
|
+
import type { BatchRequest, NormalizedResponse, RequestOptions } from "../core/types.js";
|
|
3
|
+
import { MeridianError } from "../core/types.js";
|
|
4
|
+
import type { ServiceConfig } from "../core/types.js";
|
|
5
|
+
import type { ProviderClient } from "../index.js";
|
|
6
|
+
export declare class ServiceClient {
|
|
7
|
+
private providers;
|
|
8
|
+
private providerNames;
|
|
9
|
+
private strategy;
|
|
10
|
+
private failoverOn;
|
|
11
|
+
private roundRobinIndex;
|
|
12
|
+
private latencyMs;
|
|
13
|
+
private costs;
|
|
14
|
+
private weights;
|
|
15
|
+
private regions;
|
|
16
|
+
private defaultRegion;
|
|
17
|
+
private getStats;
|
|
18
|
+
constructor(providerNames: string[], providers: ProviderClient[], config: Pick<ServiceConfig, "strategy" | "failoverOn" | "costs" | "weights" | "regions" | "defaultRegion">, getStats?: () => Record<string, {
|
|
19
|
+
successRate: string;
|
|
20
|
+
}>);
|
|
21
|
+
get<T = unknown>(endpoint: string, options?: RequestOptions): Promise<NormalizedResponse<T>>;
|
|
22
|
+
post<T = unknown>(endpoint: string, options?: RequestOptions): Promise<NormalizedResponse<T>>;
|
|
23
|
+
put<T = unknown>(endpoint: string, options?: RequestOptions): Promise<NormalizedResponse<T>>;
|
|
24
|
+
patch<T = unknown>(endpoint: string, options?: RequestOptions): Promise<NormalizedResponse<T>>;
|
|
25
|
+
delete<T = unknown>(endpoint: string, options?: RequestOptions): Promise<NormalizedResponse<T>>;
|
|
26
|
+
paginate<T = unknown>(endpoint: string, options?: RequestOptions): AsyncGenerator<NormalizedResponse<T>>;
|
|
27
|
+
stream<T = unknown>(endpoint: string, options?: RequestOptions): AsyncGenerator<StreamChunk<T>>;
|
|
28
|
+
batch<T = unknown>(requests: BatchRequest[], concurrencyLimit?: number): Promise<Array<NormalizedResponse<T> | MeridianError>>;
|
|
29
|
+
private selectIndex;
|
|
30
|
+
private failoverOrder;
|
|
31
|
+
private fastestIndex;
|
|
32
|
+
private cheapestIndex;
|
|
33
|
+
private highestSuccessRateIndex;
|
|
34
|
+
private route;
|
|
35
|
+
private weightedIndex;
|
|
36
|
+
private weightedFailoverOrder;
|
|
37
|
+
private geoIndex;
|
|
38
|
+
private geoFailoverOrder;
|
|
39
|
+
private updateLatency;
|
|
40
|
+
}
|
|
41
|
+
//# sourceMappingURL=service-client.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"service-client.d.ts","sourceRoot":"","sources":["../../src/services/service-client.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,243 @@
|
|
|
1
|
+
import { MeridianError } from "../core/types.js";
|
|
2
|
+
export class ServiceClient {
|
|
3
|
+
providers;
|
|
4
|
+
providerNames;
|
|
5
|
+
strategy;
|
|
6
|
+
failoverOn;
|
|
7
|
+
roundRobinIndex = 0;
|
|
8
|
+
latencyMs;
|
|
9
|
+
costs;
|
|
10
|
+
weights;
|
|
11
|
+
regions;
|
|
12
|
+
defaultRegion;
|
|
13
|
+
getStats;
|
|
14
|
+
constructor(providerNames, providers, config, getStats) {
|
|
15
|
+
if (providers.length === 0) {
|
|
16
|
+
throw new Error("ServiceClient requires at least one provider.");
|
|
17
|
+
}
|
|
18
|
+
this.providerNames = providerNames;
|
|
19
|
+
this.providers = providers;
|
|
20
|
+
this.strategy = config.strategy ?? "failover";
|
|
21
|
+
this.failoverOn = new Set(config.failoverOn ?? ["rate_limit", "network", "provider"]);
|
|
22
|
+
this.latencyMs = new Array(providers.length).fill(0);
|
|
23
|
+
this.costs = config.costs ?? {};
|
|
24
|
+
this.weights = config.weights ?? {};
|
|
25
|
+
this.regions = config.regions ?? {};
|
|
26
|
+
if (config.defaultRegion !== undefined)
|
|
27
|
+
this.defaultRegion = config.defaultRegion;
|
|
28
|
+
this.getStats = getStats;
|
|
29
|
+
}
|
|
30
|
+
get(endpoint, options) {
|
|
31
|
+
return this.route("get", endpoint, options);
|
|
32
|
+
}
|
|
33
|
+
post(endpoint, options) {
|
|
34
|
+
return this.route("post", endpoint, options);
|
|
35
|
+
}
|
|
36
|
+
put(endpoint, options) {
|
|
37
|
+
return this.route("put", endpoint, options);
|
|
38
|
+
}
|
|
39
|
+
patch(endpoint, options) {
|
|
40
|
+
return this.route("patch", endpoint, options);
|
|
41
|
+
}
|
|
42
|
+
delete(endpoint, options) {
|
|
43
|
+
return this.route("delete", endpoint, options);
|
|
44
|
+
}
|
|
45
|
+
async *paginate(endpoint, options) {
|
|
46
|
+
const idx = this.selectIndex();
|
|
47
|
+
yield* this.providers[idx].paginate(endpoint, options);
|
|
48
|
+
}
|
|
49
|
+
async *stream(endpoint, options) {
|
|
50
|
+
const idx = this.selectIndex();
|
|
51
|
+
yield* this.providers[idx].stream(endpoint, options);
|
|
52
|
+
}
|
|
53
|
+
async batch(requests, concurrencyLimit = 10) {
|
|
54
|
+
const idx = this.selectIndex();
|
|
55
|
+
return this.providers[idx].batch(requests, concurrencyLimit);
|
|
56
|
+
}
|
|
57
|
+
selectIndex() {
|
|
58
|
+
if (this.strategy === "round-robin") {
|
|
59
|
+
const idx = this.roundRobinIndex % this.providers.length;
|
|
60
|
+
this.roundRobinIndex++;
|
|
61
|
+
return idx;
|
|
62
|
+
}
|
|
63
|
+
if (this.strategy === "lowest-latency")
|
|
64
|
+
return this.fastestIndex();
|
|
65
|
+
if (this.strategy === "cheapest")
|
|
66
|
+
return this.cheapestIndex();
|
|
67
|
+
if (this.strategy === "highest-success-rate")
|
|
68
|
+
return this.highestSuccessRateIndex();
|
|
69
|
+
if (this.strategy === "weighted")
|
|
70
|
+
return this.weightedIndex();
|
|
71
|
+
if (this.strategy === "geo")
|
|
72
|
+
return this.geoIndex();
|
|
73
|
+
return 0;
|
|
74
|
+
}
|
|
75
|
+
failoverOrder() {
|
|
76
|
+
if (this.strategy === "lowest-latency") {
|
|
77
|
+
return this.latencyMs
|
|
78
|
+
.map((ms, idx) => ({ idx, ms }))
|
|
79
|
+
.sort((a, b) => a.ms - b.ms)
|
|
80
|
+
.map(({ idx }) => idx);
|
|
81
|
+
}
|
|
82
|
+
if (this.strategy === "cheapest") {
|
|
83
|
+
return this.providerNames
|
|
84
|
+
.map((name, idx) => ({ idx, cost: this.costs[name] ?? Number.POSITIVE_INFINITY }))
|
|
85
|
+
.sort((a, b) => a.cost - b.cost)
|
|
86
|
+
.map(({ idx }) => idx);
|
|
87
|
+
}
|
|
88
|
+
if (this.strategy === "highest-success-rate") {
|
|
89
|
+
const stats = this.getStats?.() ?? {};
|
|
90
|
+
return this.providerNames
|
|
91
|
+
.map((name, idx) => ({
|
|
92
|
+
idx,
|
|
93
|
+
rate: Number.parseFloat(stats[name]?.successRate ?? "100"),
|
|
94
|
+
}))
|
|
95
|
+
.sort((a, b) => b.rate - a.rate)
|
|
96
|
+
.map(({ idx }) => idx);
|
|
97
|
+
}
|
|
98
|
+
if (this.strategy === "weighted") {
|
|
99
|
+
return this.weightedFailoverOrder();
|
|
100
|
+
}
|
|
101
|
+
if (this.strategy === "geo") {
|
|
102
|
+
return this.geoFailoverOrder();
|
|
103
|
+
}
|
|
104
|
+
return this.providers.map((_, i) => i);
|
|
105
|
+
}
|
|
106
|
+
fastestIndex() {
|
|
107
|
+
let best = 0;
|
|
108
|
+
for (let i = 1; i < this.latencyMs.length; i++) {
|
|
109
|
+
if (this.latencyMs[i] < this.latencyMs[best])
|
|
110
|
+
best = i;
|
|
111
|
+
}
|
|
112
|
+
return best;
|
|
113
|
+
}
|
|
114
|
+
cheapestIndex() {
|
|
115
|
+
let best = 0;
|
|
116
|
+
let bestCost = this.costs[this.providerNames[0]] ?? Number.POSITIVE_INFINITY;
|
|
117
|
+
for (let i = 1; i < this.providerNames.length; i++) {
|
|
118
|
+
const cost = this.costs[this.providerNames[i]] ?? Number.POSITIVE_INFINITY;
|
|
119
|
+
if (cost < bestCost) {
|
|
120
|
+
bestCost = cost;
|
|
121
|
+
best = i;
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
return best;
|
|
125
|
+
}
|
|
126
|
+
highestSuccessRateIndex() {
|
|
127
|
+
const stats = this.getStats?.() ?? {};
|
|
128
|
+
let best = 0;
|
|
129
|
+
let bestRate = Number.parseFloat(stats[this.providerNames[0]]?.successRate ?? "100");
|
|
130
|
+
for (let i = 1; i < this.providerNames.length; i++) {
|
|
131
|
+
const rate = Number.parseFloat(stats[this.providerNames[i]]?.successRate ?? "100");
|
|
132
|
+
if (rate > bestRate) {
|
|
133
|
+
bestRate = rate;
|
|
134
|
+
best = i;
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
return best;
|
|
138
|
+
}
|
|
139
|
+
async route(method, endpoint, options) {
|
|
140
|
+
if (this.strategy === "round-robin") {
|
|
141
|
+
const idx = this.roundRobinIndex % this.providers.length;
|
|
142
|
+
this.roundRobinIndex++;
|
|
143
|
+
const result = await this.providers[idx][method](endpoint, options);
|
|
144
|
+
this.updateLatency(idx, result.meta.trace?.latency);
|
|
145
|
+
return result;
|
|
146
|
+
}
|
|
147
|
+
// weighted/geo: select primary probabilistically/by-region, failover through rest
|
|
148
|
+
if (this.strategy === "weighted" || this.strategy === "geo") {
|
|
149
|
+
const primaryIdx = this.selectIndex();
|
|
150
|
+
try {
|
|
151
|
+
const result = await this.providers[primaryIdx][method](endpoint, options);
|
|
152
|
+
this.updateLatency(primaryIdx, result.meta.trace?.latency);
|
|
153
|
+
return result;
|
|
154
|
+
}
|
|
155
|
+
catch (err) {
|
|
156
|
+
if (!(err instanceof MeridianError) || !this.failoverOn.has(err.category))
|
|
157
|
+
throw err;
|
|
158
|
+
}
|
|
159
|
+
const fallbacks = this.failoverOrder().filter((i) => i !== primaryIdx);
|
|
160
|
+
let lastError = null;
|
|
161
|
+
for (const idx of fallbacks) {
|
|
162
|
+
try {
|
|
163
|
+
const result = await this.providers[idx][method](endpoint, options);
|
|
164
|
+
this.updateLatency(idx, result.meta.trace?.latency);
|
|
165
|
+
return result;
|
|
166
|
+
}
|
|
167
|
+
catch (err) {
|
|
168
|
+
if (err instanceof MeridianError && this.failoverOn.has(err.category)) {
|
|
169
|
+
lastError = err;
|
|
170
|
+
continue;
|
|
171
|
+
}
|
|
172
|
+
throw err;
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
throw (lastError ??
|
|
176
|
+
new MeridianError(`All providers failed: ${this.providerNames.join(", ")}`, "provider", this.providerNames[0] ?? "service", false));
|
|
177
|
+
}
|
|
178
|
+
const order = this.failoverOrder();
|
|
179
|
+
let lastError = null;
|
|
180
|
+
for (const idx of order) {
|
|
181
|
+
try {
|
|
182
|
+
const result = await this.providers[idx][method](endpoint, options);
|
|
183
|
+
this.updateLatency(idx, result.meta.trace?.latency);
|
|
184
|
+
return result;
|
|
185
|
+
}
|
|
186
|
+
catch (err) {
|
|
187
|
+
if (err instanceof MeridianError && this.failoverOn.has(err.category)) {
|
|
188
|
+
lastError = err;
|
|
189
|
+
continue;
|
|
190
|
+
}
|
|
191
|
+
throw err;
|
|
192
|
+
}
|
|
193
|
+
}
|
|
194
|
+
throw (lastError ??
|
|
195
|
+
new MeridianError(`All providers failed: ${this.providerNames.join(", ")}`, "provider", this.providerNames[0] ?? "service", false));
|
|
196
|
+
}
|
|
197
|
+
weightedIndex() {
|
|
198
|
+
const totalWeight = this.providerNames.reduce((sum, name) => sum + (this.weights[name] ?? 1), 0);
|
|
199
|
+
let rand = Math.random() * totalWeight;
|
|
200
|
+
for (let i = 0; i < this.providerNames.length; i++) {
|
|
201
|
+
rand -= this.weights[this.providerNames[i]] ?? 1;
|
|
202
|
+
if (rand <= 0)
|
|
203
|
+
return i;
|
|
204
|
+
}
|
|
205
|
+
return this.providerNames.length - 1;
|
|
206
|
+
}
|
|
207
|
+
weightedFailoverOrder() {
|
|
208
|
+
return this.providerNames
|
|
209
|
+
.map((name, idx) => ({ idx, weight: this.weights[name] ?? 1 }))
|
|
210
|
+
.sort((a, b) => b.weight - a.weight)
|
|
211
|
+
.map(({ idx }) => idx);
|
|
212
|
+
}
|
|
213
|
+
geoIndex() {
|
|
214
|
+
const region = process.env.MERIDIAN_REGION ?? this.defaultRegion;
|
|
215
|
+
if (region) {
|
|
216
|
+
const preferred = this.regions[region];
|
|
217
|
+
if (preferred && preferred.length > 0) {
|
|
218
|
+
const idx = this.providerNames.indexOf(preferred[0]);
|
|
219
|
+
if (idx !== -1)
|
|
220
|
+
return idx;
|
|
221
|
+
}
|
|
222
|
+
}
|
|
223
|
+
return 0;
|
|
224
|
+
}
|
|
225
|
+
geoFailoverOrder() {
|
|
226
|
+
const region = process.env.MERIDIAN_REGION ?? this.defaultRegion;
|
|
227
|
+
if (region) {
|
|
228
|
+
const preferred = (this.regions[region] ?? [])
|
|
229
|
+
.map((name) => this.providerNames.indexOf(name))
|
|
230
|
+
.filter((i) => i !== -1);
|
|
231
|
+
const rest = this.providerNames.map((_, i) => i).filter((i) => !preferred.includes(i));
|
|
232
|
+
return [...preferred, ...rest];
|
|
233
|
+
}
|
|
234
|
+
return this.providers.map((_, i) => i);
|
|
235
|
+
}
|
|
236
|
+
updateLatency(idx, latency) {
|
|
237
|
+
if (latency === undefined)
|
|
238
|
+
return;
|
|
239
|
+
const current = this.latencyMs[idx];
|
|
240
|
+
this.latencyMs[idx] = current === 0 ? latency : 0.3 * latency + 0.7 * current;
|
|
241
|
+
}
|
|
242
|
+
}
|
|
243
|
+
//# sourceMappingURL=service-client.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"service-client.js","sourceRoot":"","sources":["../../src/services/service-client.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transactions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transactions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import type { NormalizedResponse } from "../core/types.js";
|
|
2
|
+
export interface TransactionStep<T = unknown> {
|
|
3
|
+
name: string;
|
|
4
|
+
execute: () => Promise<NormalizedResponse<T>>;
|
|
5
|
+
rollback?: (result: NormalizedResponse<T>) => Promise<void>;
|
|
6
|
+
}
|
|
7
|
+
export interface TransactionResult {
|
|
8
|
+
succeeded: string[];
|
|
9
|
+
rolledBack: string[];
|
|
10
|
+
results: Record<string, NormalizedResponse<unknown>>;
|
|
11
|
+
}
|
|
12
|
+
export declare class TransactionError extends Error {
|
|
13
|
+
readonly failed: string;
|
|
14
|
+
readonly succeeded: string[];
|
|
15
|
+
readonly rolledBack: string[];
|
|
16
|
+
readonly rollbackErrors: Record<string, string>;
|
|
17
|
+
readonly results: Record<string, NormalizedResponse<unknown>>;
|
|
18
|
+
readonly cause: unknown;
|
|
19
|
+
constructor(message: string, failed: string, succeeded: string[], rolledBack: string[], rollbackErrors: Record<string, string>, results: Record<string, NormalizedResponse<unknown>>, cause: unknown);
|
|
20
|
+
}
|
|
21
|
+
export declare function runTransaction(steps: TransactionStep[]): Promise<TransactionResult>;
|
|
22
|
+
//# sourceMappingURL=saga.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"saga.d.ts","sourceRoot":"","sources":["../../src/transactions/saga.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAG3D,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;CACtD;AAED,qBAAa,gBAAiB,SAAQ,KAAK;aAGvB,MAAM,EAAE,MAAM;aACd,SAAS,EAAE,MAAM,EAAE;aACnB,UAAU,EAAE,MAAM,EAAE;aACpB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;aACtC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC;aACpD,KAAK,EAAE,OAAO;gBAN9B,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EAAE,EACnB,UAAU,EAAE,MAAM,EAAE,EACpB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACtC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC,EACpD,KAAK,EAAE,OAAO;CAQjC;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA+CzF"}
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
import { MeridianError } from "../core/types.js";
|
|
2
|
+
export class TransactionError extends Error {
|
|
3
|
+
failed;
|
|
4
|
+
succeeded;
|
|
5
|
+
rolledBack;
|
|
6
|
+
rollbackErrors;
|
|
7
|
+
results;
|
|
8
|
+
cause;
|
|
9
|
+
constructor(message, failed, succeeded, rolledBack, rollbackErrors, results, cause) {
|
|
10
|
+
super(message);
|
|
11
|
+
this.failed = failed;
|
|
12
|
+
this.succeeded = succeeded;
|
|
13
|
+
this.rolledBack = rolledBack;
|
|
14
|
+
this.rollbackErrors = rollbackErrors;
|
|
15
|
+
this.results = results;
|
|
16
|
+
this.cause = cause;
|
|
17
|
+
this.name = "TransactionError";
|
|
18
|
+
if (Error.captureStackTrace) {
|
|
19
|
+
Error.captureStackTrace(this, TransactionError);
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
}
|
|
23
|
+
export async function runTransaction(steps) {
|
|
24
|
+
const succeeded = [];
|
|
25
|
+
const results = {};
|
|
26
|
+
for (let i = 0; i < steps.length; i++) {
|
|
27
|
+
const step = steps[i];
|
|
28
|
+
try {
|
|
29
|
+
const result = await step.execute();
|
|
30
|
+
succeeded.push(step.name);
|
|
31
|
+
results[step.name] = result;
|
|
32
|
+
}
|
|
33
|
+
catch (err) {
|
|
34
|
+
// Step failed — run compensating rollbacks in reverse order
|
|
35
|
+
const rolledBack = [];
|
|
36
|
+
const rollbackErrors = {};
|
|
37
|
+
for (let j = i - 1; j >= 0; j--) {
|
|
38
|
+
const prev = steps[j];
|
|
39
|
+
if (prev.rollback && results[prev.name]) {
|
|
40
|
+
try {
|
|
41
|
+
await prev.rollback(results[prev.name]);
|
|
42
|
+
rolledBack.push(prev.name);
|
|
43
|
+
}
|
|
44
|
+
catch (rbErr) {
|
|
45
|
+
rollbackErrors[prev.name] = rbErr instanceof Error ? rbErr.message : String(rbErr);
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
const cause = err instanceof MeridianError ? err : err;
|
|
50
|
+
const message = `Transaction failed at step "${step.name}": ${err instanceof Error ? err.message : String(err)}${rolledBack.length > 0 ? `. Rolled back: [${rolledBack.join(", ")}]` : ""}${Object.keys(rollbackErrors).length > 0
|
|
51
|
+
? `. Rollback errors: ${JSON.stringify(rollbackErrors)}`
|
|
52
|
+
: ""}`;
|
|
53
|
+
throw new TransactionError(message, step.name, succeeded, rolledBack, rollbackErrors, results, cause);
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
return { succeeded, rolledBack: [], results };
|
|
57
|
+
}
|
|
58
|
+
//# sourceMappingURL=saga.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"saga.js","sourceRoot":"","sources":["../../src/transactions/saga.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"drift-detector.d.ts","sourceRoot":"","sources":["../../src/validation/drift-detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE5D,qBAAa,aAAa;IACxB,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE;
|
|
1
|
+
{"version":3,"file":"drift-detector.d.ts","sourceRoot":"","sources":["../../src/validation/drift-detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE5D,qBAAa,aAAa;IACxB,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE;CAgG5D"}
|
|
@@ -30,14 +30,23 @@ export class DriftDetector {
|
|
|
30
30
|
if (field in oldProps) {
|
|
31
31
|
const oldField = oldProps[field];
|
|
32
32
|
const newField = newProps[field];
|
|
33
|
-
if (oldField && newField
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
33
|
+
if (oldField && newField) {
|
|
34
|
+
if (oldField.type !== newField.type) {
|
|
35
|
+
drifts.push({
|
|
36
|
+
type: "TYPE_CHANGED",
|
|
37
|
+
field,
|
|
38
|
+
oldValue: oldField.type,
|
|
39
|
+
newValue: newField.type,
|
|
40
|
+
severity: "ERROR",
|
|
41
|
+
});
|
|
42
|
+
}
|
|
43
|
+
else {
|
|
44
|
+
// Same type — recurse to detect structural changes within
|
|
45
|
+
const nested = this.detect(oldField, newField);
|
|
46
|
+
for (const d of nested) {
|
|
47
|
+
drifts.push({ ...d, field: `${field}.${d.field}` });
|
|
48
|
+
}
|
|
49
|
+
}
|
|
41
50
|
}
|
|
42
51
|
}
|
|
43
52
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"drift-detector.js","sourceRoot":"","sources":["../../src/validation/drift-detector.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAa;IACxB,MAAM,CAAC,SAAiB,EAAE,SAAiB;QACzC,MAAM,MAAM,GAAkB,EAAE,CAAC;QAEjC,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YACtC,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,cAAc;gBACpB,KAAK,EAAE,MAAM;gBACb,QAAQ,EAAE,SAAS,CAAC,IAAI;gBACxB,QAAQ,EAAE,SAAS,CAAC,IAAI;gBACxB,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC;QACL,CAAC;QAED,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC/D,MAAM,QAAQ,GAAG,SAAS,CAAC,UAAU,IAAI,EAAE,CAAC;YAC5C,MAAM,QAAQ,GAAG,SAAS,CAAC,UAAU,IAAI,EAAE,CAAC;YAC5C,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;YACtD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;YAEtD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC1C,IAAI,CAAC,CAAC,KAAK,IAAI,QAAQ,CAAC,EAAE,CAAC;oBACzB,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI,EAAE,eAAe;wBACrB,KAAK;wBACL,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC;wBACzB,QAAQ,EAAE,SAAS;wBACnB,QAAQ,EAAE,OAAO;qBAClB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC1C,IAAI,KAAK,IAAI,QAAQ,EAAE,CAAC;oBACtB,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;oBACjC,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;oBAEjC,IAAI,QAAQ,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,EAAE,CAAC;
|
|
1
|
+
{"version":3,"file":"drift-detector.js","sourceRoot":"","sources":["../../src/validation/drift-detector.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "meridianjs",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.5",
|
|
4
4
|
"description": "Meridian - A TypeScript-first SDK that enforces a single stable contract across all third-party API providers",
|
|
5
5
|
"main": "dist/public.js",
|
|
6
6
|
"types": "dist/public.d.ts",
|
|
@@ -28,10 +28,14 @@
|
|
|
28
28
|
"proxy": "node dist/proxy/cli.js",
|
|
29
29
|
"proxy:build": "npm run build && npm run proxy",
|
|
30
30
|
"example:swap": "vite-node examples/provider-swap/index.ts",
|
|
31
|
-
"test:contracts": "node scripts/test-contracts.mjs"
|
|
31
|
+
"test:contracts": "node scripts/test-contracts.mjs",
|
|
32
|
+
"test:contracts:all": "node scripts/test-contracts.mjs",
|
|
33
|
+
"benchmark": "npx tsx benchmarks/pipeline-overhead.ts",
|
|
34
|
+
"pkg:check": "npx publint && npx are-the-types-wrong . --pack"
|
|
32
35
|
},
|
|
33
36
|
"bin": {
|
|
34
|
-
"boundary-proxy": "dist/proxy/cli.js"
|
|
37
|
+
"boundary-proxy": "dist/proxy/cli.js",
|
|
38
|
+
"meridian": "dist/generator/cli.js"
|
|
35
39
|
},
|
|
36
40
|
"keywords": ["api", "sdk", "normalization", "circuit-breaker", "rate-limiting", "retry"],
|
|
37
41
|
"license": "MIT",
|