@ductape/sdk 0.0.4-v51 → 0.0.4-v52

package/dist/resilience/fallback.service.js

@@ -0,0 +1,511 @@
+"use strict";
+/**
+ * Fallback Service
+ *
+ * Code-first API for defining and managing fallbacks with sequential failover.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FallbackService = exports.FallbackError = void 0;
+const types_1 = require("./types");
+const resilienceApi_service_1 = require("../api/services/resilienceApi.service");
+/**
+ * Error class for fallback operations
+ */
+class FallbackError extends Error {
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'FallbackError';
+    }
+}
+exports.FallbackError = FallbackError;
+/**
+ * Provider builder that records fallback provider configuration
+ */
+class RecordingFallbackProviderBuilder {
+    constructor(providerName, options) {
+        this.providerName = providerName;
+        this.options = options;
+        this._retries = 2;
+    }
+    weight(_value) {
+        // Fallback doesn't use weight, but we implement for interface compatibility
+        return this;
+    }
+    healthcheck(tag) {
+        this._healthcheck = tag;
+        return this;
+    }
+    app(tag) {
+        this._type = types_1.FeatureEventTypes.ACTION;
+        this._app = tag;
+        return new RecordingFallbackAppProviderBuilder(this, this._app);
+    }
+    /**
+     * @deprecated Features are deprecated - use workflow() instead
+     */
+    feature(tag) {
+        console.warn('feature() is deprecated. Use workflow() instead.');
+        this._type = types_1.FeatureEventTypes.ACTION;
+        this._event = tag;
+        this.finalize();
+        return this;
+    }
+    database(tag) {
+        this._type = types_1.FeatureEventTypes.ACTION;
+        this._app = tag;
+        return new RecordingFallbackDatabaseProviderBuilder(this, tag);
+    }
+    workflow(tag) {
+        this._type = types_1.FeatureEventTypes.ACTION;
+        this._event = tag;
+        return new RecordingFallbackWorkflowProviderBuilder(this, tag);
+    }
+    notification(tag) {
+        this._type = types_1.FeatureEventTypes.ACTION;
+        this._event = tag;
+        return new RecordingFallbackNotificationProviderBuilder(this, tag);
+    }
+    mapInput(mapper) {
+        this._inputMapper = mapper;
+        return this;
+    }
+    mapOutput(mapper) {
+        this._outputMapper = mapper;
+        return this;
+    }
+    retries(count) {
+        this._retries = count;
+        return this;
+    }
+    checkInterval(ms) {
+        this._checkInterval = ms;
+        return this;
+    }
+    /**
+     * Set event/action name (used by sub-builders)
+     */
+    setEvent(event) {
+        this._event = event;
+        this.finalize();
+    }
+    /**
+     * Set workflow input (used by workflow builder)
+     */
+    setWorkflowInput(input) {
+        this._workflowInput = input;
+        this.finalize();
+    }
+    /**
+     * Finalize and add provider to options
+     */
+    finalize() {
+        const inputSchema = this.generateInputSchema();
+        const outputSchema = this.generateOutputSchema();
+        const option = {
+            provider: this.providerName,
+            healthcheck: this._healthcheck,
+            type: this._type || types_1.FeatureEventTypes.ACTION,
+            app: this._app,
+            event: this._event || '',
+            input: this._workflowInput || inputSchema,
+            output: outputSchema,
+            retries: this._retries,
+            check_interval: this._checkInterval,
+        };
+        this.options.push(option);
+    }
+    /**
+     * Generate input schema from mapper function
+     */
+    generateInputSchema() {
+        if (!this._inputMapper) {
+            return {};
+        }
+        const proxyHandler = {
+            get: (_target, prop) => {
+                if (typeof prop === 'string') {
+                    return `$Input{${prop}}`;
+                }
+                return undefined;
+            },
+        };
+        try {
+            const proxy = new Proxy({}, proxyHandler);
+            return this._inputMapper(proxy);
+        }
+        catch (_a) {
+            return {};
+        }
+    }
+    /**
+     * Generate output schema from mapper function
+     */
+    generateOutputSchema() {
+        if (!this._outputMapper) {
+            return {};
+        }
+        const proxyHandler = {
+            get: (_target, prop) => {
+                if (typeof prop === 'string') {
+                    return `$Response{${prop}}`;
+                }
+                return undefined;
+            },
+        };
+        try {
+            const proxy = new Proxy({}, proxyHandler);
+            return this._outputMapper(proxy);
+        }
+        catch (_a) {
+            return {};
+        }
+    }
+}
+class RecordingFallbackAppProviderBuilder {
+    constructor(parent, appTag) {
+        this.parent = parent;
+        this.appTag = appTag;
+    }
+    action(event) {
+        this.parent.setEvent(event);
+        return this.parent;
+    }
+    weight(value) {
+        return this.parent.weight(value);
+    }
+    healthcheck(tag) {
+        return this.parent.healthcheck(tag);
+    }
+    app(tag) {
+        return this.parent.app(tag);
+    }
+    feature(tag) {
+        return this.parent.feature(tag);
+    }
+    database(tag) {
+        return this.parent.database(tag);
+    }
+    workflow(tag) {
+        return this.parent.workflow(tag);
+    }
+    notification(tag) {
+        return this.parent.notification(tag);
+    }
+    mapInput(mapper) {
+        return this.parent.mapInput(mapper);
+    }
+    mapOutput(mapper) {
+        return this.parent.mapOutput(mapper);
+    }
+    retries(count) {
+        return this.parent.retries(count);
+    }
+    checkInterval(ms) {
+        return this.parent.checkInterval(ms);
+    }
+}
+class RecordingFallbackDatabaseProviderBuilder {
+    constructor(parent, dbTag) {
+        this.parent = parent;
+        this.dbTag = dbTag;
+    }
+    action(event) {
+        this.parent.setEvent(event);
+        return this.parent;
+    }
+    weight(value) {
+        return this.parent.weight(value);
+    }
+    healthcheck(tag) {
+        return this.parent.healthcheck(tag);
+    }
+    app(tag) {
+        return this.parent.app(tag);
+    }
+    feature(tag) {
+        return this.parent.feature(tag);
+    }
+    database(tag) {
+        return this.parent.database(tag);
+    }
+    workflow(tag) {
+        return this.parent.workflow(tag);
+    }
+    notification(tag) {
+        return this.parent.notification(tag);
+    }
+    mapInput(mapper) {
+        return this.parent.mapInput(mapper);
+    }
+    mapOutput(mapper) {
+        return this.parent.mapOutput(mapper);
+    }
+    retries(count) {
+        return this.parent.retries(count);
+    }
+    checkInterval(ms) {
+        return this.parent.checkInterval(ms);
+    }
+}
+class RecordingFallbackWorkflowProviderBuilder {
+    constructor(parent, workflowTag) {
+        this.parent = parent;
+        this.workflowTag = workflowTag;
+    }
+    input(data) {
+        this.parent.setWorkflowInput(data);
+        return this.parent;
+    }
+    weight(value) {
+        return this.parent.weight(value);
+    }
+    healthcheck(tag) {
+        return this.parent.healthcheck(tag);
+    }
+    app(tag) {
+        return this.parent.app(tag);
+    }
+    feature(tag) {
+        return this.parent.feature(tag);
+    }
+    database(tag) {
+        return this.parent.database(tag);
+    }
+    workflow(tag) {
+        return this.parent.workflow(tag);
+    }
+    notification(tag) {
+        return this.parent.notification(tag);
+    }
+    mapInput(mapper) {
+        return this.parent.mapInput(mapper);
+    }
+    mapOutput(mapper) {
+        return this.parent.mapOutput(mapper);
+    }
+    retries(count) {
+        return this.parent.retries(count);
+    }
+    checkInterval(ms) {
+        return this.parent.checkInterval(ms);
+    }
+}
+class RecordingFallbackNotificationProviderBuilder {
+    constructor(parent, notificationTag) {
+        this.parent = parent;
+        this.notificationTag = notificationTag;
+    }
+    event(event) {
+        this.parent.setEvent(event);
+        return this.parent;
+    }
+    weight(value) {
+        return this.parent.weight(value);
+    }
+    healthcheck(tag) {
+        return this.parent.healthcheck(tag);
+    }
+    app(tag) {
+        return this.parent.app(tag);
+    }
+    feature(tag) {
+        return this.parent.feature(tag);
+    }
+    database(tag) {
+        return this.parent.database(tag);
+    }
+    workflow(tag) {
+        return this.parent.workflow(tag);
+    }
+    notification(tag) {
+        return this.parent.notification(tag);
+    }
+    mapInput(mapper) {
+        return this.parent.mapInput(mapper);
+    }
+    mapOutput(mapper) {
+        return this.parent.mapOutput(mapper);
+    }
+    retries(count) {
+        return this.parent.retries(count);
+    }
+    checkInterval(ms) {
+        return this.parent.checkInterval(ms);
+    }
+}
+/**
+ * Recording context that captures fallback configuration during handler execution
+ */
+class RecordingFallbackContext {
+    constructor(inputSchema) {
+        this._options = [];
+        this._input = inputSchema;
+    }
+    get input() {
+        const proxyHandler = {
+            get: (target, prop) => {
+                if (typeof prop === 'string') {
+                    return `$Input{${prop}}`;
+                }
+                return undefined;
+            },
+        };
+        return new Proxy({}, proxyHandler);
+    }
+    primary(name) {
+        return new RecordingFallbackProviderBuilder(name, this._options);
+    }
+    fallback(name) {
+        return new RecordingFallbackProviderBuilder(name, this._options);
+    }
+    auth(field) {
+        return `$Auth{${field}}`;
+    }
+    token(key) {
+        return `$Secret{${key}}`;
+    }
+    variable(app, key) {
+        return `$Variable{${app}}{${key}}`;
+    }
+    constant(app, key) {
+        return `$Constant{${app}}{${key}}`;
+    }
+    /**
+     * Build the fallback schema from recorded configuration
+     */
+    build(tag, name, description) {
+        if (this._options.length === 0) {
+            throw new FallbackError('At least one provider must be configured', 'NO_PROVIDERS_CONFIGURED');
+        }
+        return {
+            tag,
+            name,
+            description,
+            input: this._input,
+            options: this._options,
+        };
+    }
+    get options() {
+        return this._options;
+    }
+}
+/**
+ * Fallback Service
+ *
+ * Provides code-first API for defining, creating, and managing fallbacks.
+ */
+class FallbackService {
+    constructor(config) {
+        this.apiService = new resilienceApi_service_1.ResilienceApiService({
+            token: config.token,
+            env_type: config.env_type,
+            base_url: config.base_url,
+        });
+    }
+    /**
+     * Define a fallback using code-first API
+     *
+     * @example
+     * ```ts
+     * const fallback = await fallbackService.define({
+     *   product: 'my-product',
+     *   tag: 'payment-fallback',
+     *   name: 'Payment Provider Fallback',
+     *   input: {
+     *     amount: { type: 'number', required: true },
+     *     currency: { type: 'string', required: true },
+     *   },
+     *   handler: async (ctx) => {
+     *     ctx.primary('stripe')
+     *       .healthcheck('stripe-health')
+     *       .app('stripe-app')
+     *       .action('charge')
+     *       .mapInput((input) => ({ body: { amount: input.amount } }))
+     *       .mapOutput((res) => ({ chargeId: res.id }))
+     *       .retries(2);
+     *
+     *     ctx.fallback('paypal')
+     *       .healthcheck('paypal-health')
+     *       .app('paypal-app')
+     *       .action('payment')
+     *       .mapInput((input) => ({ body: { amount: input.amount } }))
+     *       .mapOutput((res) => ({ chargeId: res.id }))
+     *       .retries(2);
+     *   },
+     * });
+     * ```
+     */
+    async define(options) {
+        const ctx = new RecordingFallbackContext(options.input);
+        // Execute the handler to record the configuration
+        await options.handler(ctx);
+        // Build the schema
+        const schema = ctx.build(options.tag, options.name, options.description);
+        const definedFallback = {
+            tag: options.tag,
+            name: options.name,
+            description: options.description,
+            input: options.input,
+            compile: () => schema,
+        };
+        // If product is specified, register immediately
+        if (options.product) {
+            await this.create(options.product, definedFallback);
+        }
+        return definedFallback;
+    }
+    /**
+     * Create a fallback from a defined fallback or schema
+     */
+    async create(product, fallback) {
+        const schema = 'compile' in fallback ? fallback.compile() : fallback;
+        return await this.apiService.createFallback(product, schema);
+    }
+    /**
+     * Update an existing fallback
+     */
+    async update(product, tag, fallback) {
+        if ('handler' in fallback && fallback.handler && fallback.input) {
+            const ctx = new RecordingFallbackContext(fallback.input);
+            await fallback.handler(ctx);
+            const schema = ctx.build(tag, fallback.name, fallback.description);
+            return await this.apiService.updateFallback(product, tag, schema);
+        }
+        return await this.apiService.updateFallback(product, tag, fallback);
+    }
+    /**
+     * Fetch a fallback by tag
+     */
+    async fetch(product, tag) {
+        return await this.apiService.getFallback(product, tag);
+    }
+    /**
+     * Fetch all fallbacks for a product
+     */
+    async fetchAll(product) {
+        return await this.apiService.listFallbacks(product);
+    }
+    /**
+     * Delete a fallback
+     */
+    async delete(product, tag) {
+        await this.apiService.deleteFallback(product, tag);
+    }
+    /**
+     * Run a fallback
+     */
+    async run(options) {
+        return await this.apiService.runFallback(options);
+    }
+    /**
+     * Dispatch/schedule a fallback for later execution
+     */
+    async dispatch(options) {
+        return await this.apiService.dispatchFallback(options);
+    }
+}
+exports.FallbackService = FallbackService;
+exports.default = FallbackService;
+//# sourceMappingURL=fallback.service.js.map

package/dist/resilience/fallback.service.js.map

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

package/dist/resilience/healthcheck.service.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Healthcheck Service
+ *
+ * Code-first API for defining and managing healthchecks.
+ */
+import { IHealthcheckDefineOptions, IHealthcheckSchema, IHealthcheckStatus, IHealthcheckRunResult, IDefinedHealthcheck, IResilienceServiceConfig } from './types';
+/**
+ * Error class for healthcheck operations
+ */
+export declare class HealthcheckError extends Error {
+    code: string;
+    details?: unknown;
+    constructor(message: string, code: string, details?: unknown);
+}
+/**
+ * Healthcheck Service
+ *
+ * Provides code-first API for defining, creating, and managing healthchecks.
+ */
+export declare class HealthcheckService {
+    private apiService;
+    constructor(config: IResilienceServiceConfig);
+    /**
+     * Define a healthcheck using code-first API
+     *
+     * @example
+     * ```ts
+     * const healthcheck = await healthcheckService.define({
+     *   product: 'my-product',
+     *   tag: 'stripe-health',
+     *   name: 'Stripe API Health',
+     *   handler: async (ctx) => {
+     *     ctx.probe().app('stripe-app').action('health');
+     *     ctx.interval(30000);
+     *     ctx.retries(2);
+     *     ctx.env('prd');
+     *     ctx.env('stg');
+     *   },
+     * });
+     * ```
+     */
+    define(options: IHealthcheckDefineOptions): Promise<IDefinedHealthcheck>;
+    /**
+     * Create a healthcheck from a defined healthcheck or schema
+     */
+    create(product: string, healthcheck: IDefinedHealthcheck | IHealthcheckSchema): Promise<IHealthcheckSchema>;
+    /**
+     * Update an existing healthcheck
+     */
+    update(product: string, tag: string, healthcheck: Partial<IHealthcheckDefineOptions> | Partial<IHealthcheckSchema>): Promise<IHealthcheckSchema>;
+    /**
+     * Fetch a healthcheck by tag
+     */
+    fetch(product: string, tag: string): Promise<IHealthcheckSchema>;
+    /**
+     * Fetch all healthchecks for a product
+     */
+    fetchAll(product: string): Promise<IHealthcheckSchema[]>;
+    /**
+     * Delete a healthcheck
+     */
+    delete(product: string, tag: string): Promise<void>;
+    /**
+     * Get the current status of a healthcheck
+     */
+    getStatus(options: {
+        product: string;
+        env: string;
+        tag: string;
+    }): Promise<IHealthcheckStatus>;
+    /**
+     * Alias for getStatus - check the health of a service
+     *
+     * @example
+     * ```ts
+     * const status = await resilience.healthcheck.check({
+     *   product: 'my-product',
+     *   env: 'prd',
+     *   tag: 'stripe-health',
+     * });
+     * console.log(status.status); // 'healthy' | 'unhealthy' | 'degraded'
+     * ```
+     */
+    check(options: {
+        product: string;
+        env: string;
+        tag: string;
+    }): Promise<IHealthcheckStatus>;
+    /**
+     * Manually trigger a healthcheck
+     */
+    run(options: {
+        product: string;
+        env: string;
+        tag: string;
+    }): Promise<IHealthcheckRunResult>;
+    /**
+     * @deprecated Use run() instead
+     */
+    runNow(options: {
+        product: string;
+        env: string;
+        tag: string;
+    }): Promise<IHealthcheckRunResult>;
+}
+export default HealthcheckService;