meridianjs 0.2.3 → 0.2.4

package/dist/services/service-client.js

@@ -0,0 +1,156 @@
+import { MeridianError } from "../core/types.js";
+export class ServiceClient {
+    providers;
+    providerNames;
+    strategy;
+    failoverOn;
+    roundRobinIndex = 0;
+    latencyMs;
+    costs;
+    getStats;
+    constructor(providerNames, providers, config, getStats) {
+        if (providers.length === 0) {
+            throw new Error("ServiceClient requires at least one provider.");
+        }
+        this.providerNames = providerNames;
+        this.providers = providers;
+        this.strategy = config.strategy ?? "failover";
+        this.failoverOn = new Set(config.failoverOn ?? ["rate_limit", "network", "provider"]);
+        this.latencyMs = new Array(providers.length).fill(0);
+        this.costs = config.costs ?? {};
+        this.getStats = getStats;
+    }
+    get(endpoint, options) {
+        return this.route("get", endpoint, options);
+    }
+    post(endpoint, options) {
+        return this.route("post", endpoint, options);
+    }
+    put(endpoint, options) {
+        return this.route("put", endpoint, options);
+    }
+    patch(endpoint, options) {
+        return this.route("patch", endpoint, options);
+    }
+    delete(endpoint, options) {
+        return this.route("delete", endpoint, options);
+    }
+    async *paginate(endpoint, options) {
+        const idx = this.selectIndex();
+        yield* this.providers[idx].paginate(endpoint, options);
+    }
+    async *stream(endpoint, options) {
+        const idx = this.selectIndex();
+        yield* this.providers[idx].stream(endpoint, options);
+    }
+    async batch(requests, concurrencyLimit = 10) {
+        const idx = this.selectIndex();
+        return this.providers[idx].batch(requests, concurrencyLimit);
+    }
+    selectIndex() {
+        if (this.strategy === "round-robin") {
+            const idx = this.roundRobinIndex % this.providers.length;
+            this.roundRobinIndex++;
+            return idx;
+        }
+        if (this.strategy === "lowest-latency")
+            return this.fastestIndex();
+        if (this.strategy === "cheapest")
+            return this.cheapestIndex();
+        if (this.strategy === "highest-success-rate")
+            return this.highestSuccessRateIndex();
+        return 0;
+    }
+    failoverOrder() {
+        if (this.strategy === "lowest-latency") {
+            return this.latencyMs
+                .map((ms, idx) => ({ idx, ms }))
+                .sort((a, b) => a.ms - b.ms)
+                .map(({ idx }) => idx);
+        }
+        if (this.strategy === "cheapest") {
+            return this.providerNames
+                .map((name, idx) => ({ idx, cost: this.costs[name] ?? Number.POSITIVE_INFINITY }))
+                .sort((a, b) => a.cost - b.cost)
+                .map(({ idx }) => idx);
+        }
+        if (this.strategy === "highest-success-rate") {
+            const stats = this.getStats?.() ?? {};
+            return this.providerNames
+                .map((name, idx) => ({
+                idx,
+                rate: Number.parseFloat(stats[name]?.successRate ?? "100"),
+            }))
+                .sort((a, b) => b.rate - a.rate)
+                .map(({ idx }) => idx);
+        }
+        return this.providers.map((_, i) => i);
+    }
+    fastestIndex() {
+        let best = 0;
+        for (let i = 1; i < this.latencyMs.length; i++) {
+            if (this.latencyMs[i] < this.latencyMs[best])
+                best = i;
+        }
+        return best;
+    }
+    cheapestIndex() {
+        let best = 0;
+        let bestCost = this.costs[this.providerNames[0]] ?? Number.POSITIVE_INFINITY;
+        for (let i = 1; i < this.providerNames.length; i++) {
+            const cost = this.costs[this.providerNames[i]] ?? Number.POSITIVE_INFINITY;
+            if (cost < bestCost) {
+                bestCost = cost;
+                best = i;
+            }
+        }
+        return best;
+    }
+    highestSuccessRateIndex() {
+        const stats = this.getStats?.() ?? {};
+        let best = 0;
+        let bestRate = Number.parseFloat(stats[this.providerNames[0]]?.successRate ?? "100");
+        for (let i = 1; i < this.providerNames.length; i++) {
+            const rate = Number.parseFloat(stats[this.providerNames[i]]?.successRate ?? "100");
+            if (rate > bestRate) {
+                bestRate = rate;
+                best = i;
+            }
+        }
+        return best;
+    }
+    async route(method, endpoint, options) {
+        if (this.strategy === "round-robin") {
+            const idx = this.roundRobinIndex % this.providers.length;
+            this.roundRobinIndex++;
+            const result = await this.providers[idx][method](endpoint, options);
+            this.updateLatency(idx, result.meta.trace?.latency);
+            return result;
+        }
+        const order = this.failoverOrder();
+        let lastError = null;
+        for (const idx of order) {
+            try {
+                const result = await this.providers[idx][method](endpoint, options);
+                this.updateLatency(idx, result.meta.trace?.latency);
+                return result;
+            }
+            catch (err) {
+                if (err instanceof MeridianError && this.failoverOn.has(err.category)) {
+                    lastError = err;
+                    continue;
+                }
+                throw err;
+            }
+        }
+        throw (lastError ??
+            new MeridianError(`All providers failed: ${this.providerNames.join(", ")}`, "provider", this.providerNames[0] ?? "service", false));
+    }
+    updateLatency(idx, latency) {
+        if (latency === undefined)
+            return;
+        const current = this.latencyMs[idx];
+        this.latencyMs[idx] = current === 0 ? latency : 0.3 * latency + 0.7 * current;
+    }
+}
+//# sourceMappingURL=service-client.js.map

package/dist/services/service-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-client.js","sourceRoot":"","sources":["../../src/services/service-client.ts"],"names":[],"mappings":"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"}

package/dist/transactions/index.d.ts

@@ -0,0 +1,3 @@
+export { runTransaction, TransactionError } from "./saga.js";
+export type { TransactionStep, TransactionResult } from "./saga.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/transactions/index.d.ts.map

@@ -0,0 +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"}

package/dist/transactions/index.js

@@ -0,0 +1,2 @@
+export { runTransaction, TransactionError } from "./saga.js";
+//# sourceMappingURL=index.js.map

package/dist/transactions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transactions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC"}

package/dist/transactions/saga.d.ts

@@ -0,0 +1,22 @@
+import type { NormalizedResponse } from "../core/types.js";
+export interface TransactionStep<T = unknown> {
+    name: string;
+    execute: () => Promise<NormalizedResponse<T>>;
+    rollback?: (result: NormalizedResponse<T>) => Promise<void>;
+}
+export interface TransactionResult {
+    succeeded: string[];
+    rolledBack: string[];
+    results: Record<string, NormalizedResponse<unknown>>;
+}
+export declare class TransactionError extends Error {
+    readonly failed: string;
+    readonly succeeded: string[];
+    readonly rolledBack: string[];
+    readonly rollbackErrors: Record<string, string>;
+    readonly results: Record<string, NormalizedResponse<unknown>>;
+    readonly cause: unknown;
+    constructor(message: string, failed: string, succeeded: string[], rolledBack: string[], rollbackErrors: Record<string, string>, results: Record<string, NormalizedResponse<unknown>>, cause: unknown);
+}
+export declare function runTransaction(steps: TransactionStep[]): Promise<TransactionResult>;
+//# sourceMappingURL=saga.d.ts.map

package/dist/transactions/saga.d.ts.map

@@ -0,0 +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"}

package/dist/transactions/saga.js

@@ -0,0 +1,58 @@
+import { MeridianError } from "../core/types.js";
+export class TransactionError extends Error {
+    failed;
+    succeeded;
+    rolledBack;
+    rollbackErrors;
+    results;
+    cause;
+    constructor(message, failed, succeeded, rolledBack, rollbackErrors, results, cause) {
+        super(message);
+        this.failed = failed;
+        this.succeeded = succeeded;
+        this.rolledBack = rolledBack;
+        this.rollbackErrors = rollbackErrors;
+        this.results = results;
+        this.cause = cause;
+        this.name = "TransactionError";
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, TransactionError);
+        }
+    }
+}
+export async function runTransaction(steps) {
+    const succeeded = [];
+    const results = {};
+    for (let i = 0; i < steps.length; i++) {
+        const step = steps[i];
+        try {
+            const result = await step.execute();
+            succeeded.push(step.name);
+            results[step.name] = result;
+        }
+        catch (err) {
+            // Step failed — run compensating rollbacks in reverse order
+            const rolledBack = [];
+            const rollbackErrors = {};
+            for (let j = i - 1; j >= 0; j--) {
+                const prev = steps[j];
+                if (prev.rollback && results[prev.name]) {
+                    try {
+                        await prev.rollback(results[prev.name]);
+                        rolledBack.push(prev.name);
+                    }
+                    catch (rbErr) {
+                        rollbackErrors[prev.name] = rbErr instanceof Error ? rbErr.message : String(rbErr);
+                    }
+                }
+            }
+            const cause = err instanceof MeridianError ? err : err;
+            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
+                ? `. Rollback errors: ${JSON.stringify(rollbackErrors)}`
+                : ""}`;
+            throw new TransactionError(message, step.name, succeeded, rolledBack, rollbackErrors, results, cause);
+        }
+    }
+    return { succeeded, rolledBack: [], results };
+}
+//# sourceMappingURL=saga.js.map

package/dist/transactions/saga.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"saga.js","sourceRoot":"","sources":["../../src/transactions/saga.ts"],"names":[],"mappings":"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"}

package/dist/validation/drift-detector.d.ts.map

@@ -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;CAwF5D"}
+{"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"}

package/dist/validation/drift-detector.js

@@ -30,14 +30,23 @@ export class DriftDetector {
                 if (field in oldProps) {
                     const oldField = oldProps[field];
                     const newField = newProps[field];
-                    if (oldField && newField && oldField.type !== newField.type) {
-                        drifts.push({
-                            type: "TYPE_CHANGED",
-                            field,
-                            oldValue: oldField.type,
-                            newValue: newField.type,
-                            severity: "ERROR",
-                        });
+                    if (oldField && newField) {
+                        if (oldField.type !== newField.type) {
+                            drifts.push({
+                                type: "TYPE_CHANGED",
+                                field,
+                                oldValue: oldField.type,
+                                newValue: newField.type,
+                                severity: "ERROR",
+                            });
+                        }
+                        else {
+                            // Same type — recurse to detect structural changes within
+                            const nested = this.detect(oldField, newField);
+                            for (const d of nested) {
+                                drifts.push({ ...d, field: `${field}.${d.field}` });
+                            }
+                        }
                     }
                 }
             }

package/dist/validation/drift-detector.js.map

@@ -1 +1 @@
-{"version":3,"file":"drift-detector.js","sourceRoot":"","sources":["../../src/validation/drift-detector.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"drift-detector.js","sourceRoot":"","sources":["../../src/validation/drift-detector.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "meridianjs",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Meridian - A TypeScript-first SDK that enforces a single stable contract across all third-party API providers",
   "main": "dist/public.js",
   "types": "dist/public.d.ts",
@@ -31,7 +31,8 @@
     "test:contracts": "node scripts/test-contracts.mjs"
   },
   "bin": {
-    "boundary-proxy": "dist/proxy/cli.js"
+    "boundary-proxy": "dist/proxy/cli.js",
+    "meridian": "dist/generator/cli.js"
   },
   "keywords": ["api", "sdk", "normalization", "circuit-breaker", "rate-limiting", "retry"],
   "license": "MIT",