@ductape/sdk 0.0.4-v51 → 0.0.4-v52

package/dist/resilience/healthcheck.service.js

@@ -0,0 +1,379 @@
+"use strict";
+/**
+ * Healthcheck Service
+ *
+ * Code-first API for defining and managing healthchecks.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthcheckService = exports.HealthcheckError = void 0;
+const types_1 = require("./types");
+const resilienceApi_service_1 = require("../api/services/resilienceApi.service");
+/**
+ * Error class for healthcheck operations
+ */
+class HealthcheckError extends Error {
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'HealthcheckError';
+    }
+}
+exports.HealthcheckError = HealthcheckError;
+/**
+ * Recording context that captures healthcheck configuration during handler execution
+ */
+class RecordingHealthcheckContext {
+    constructor() {
+        this._probe = null;
+        this._interval = 60000;
+        this._retries = 2;
+        this._envs = [];
+        this._onFailure = null;
+    }
+    probe() {
+        return new RecordingProbeBuilder(this);
+    }
+    setProbe(probe) {
+        this._probe = probe;
+    }
+    interval(ms) {
+        this._interval = ms;
+    }
+    retries(count) {
+        this._retries = count;
+    }
+    env(slug, options) {
+        const envConfig = Object.assign({ slug }, options);
+        this._envs.push(envConfig);
+    }
+    onFailure() {
+        if (!this._onFailure) {
+            this._onFailure = {
+                notifications: [],
+                webhooks: [],
+                emit: [],
+            };
+        }
+        return new RecordingFailureNotificationBuilder(this._onFailure);
+    }
+    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 healthcheck schema from recorded configuration
+     */
+    build(tag, name, description) {
+        if (!this._probe) {
+            throw new HealthcheckError('Healthcheck probe not configured', 'PROBE_NOT_CONFIGURED');
+        }
+        if (this._envs.length === 0) {
+            throw new HealthcheckError('At least one environment must be configured', 'NO_ENVS_CONFIGURED');
+        }
+        return {
+            tag,
+            name,
+            description,
+            probe: this._probe,
+            interval: this._interval,
+            retries: this._retries,
+            onFailure: this._onFailure || undefined,
+            envs: this._envs,
+        };
+    }
+}
+/**
+ * Probe builder that records probe configuration
+ */
+class RecordingProbeBuilder {
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    app(tag) {
+        return new RecordingAppProbeBuilder(this.ctx, tag);
+    }
+    database(tag) {
+        return new RecordingDatabaseProbeBuilder(this.ctx, tag);
+    }
+    workflow(tag) {
+        return new RecordingWorkflowProbeBuilder(this.ctx, tag);
+    }
+}
+class RecordingAppProbeBuilder {
+    constructor(ctx, appTag) {
+        this.ctx = ctx;
+        this.appTag = appTag;
+    }
+    action(event) {
+        return new RecordingAppProbeActionBuilder(this.ctx, this.appTag, event);
+    }
+}
+class RecordingAppProbeActionBuilder {
+    constructor(ctx, appTag, event) {
+        this.ctx = ctx;
+        this.appTag = appTag;
+        this.event = event;
+        // Set probe immediately (input is optional)
+        this.ctx.setProbe({
+            type: types_1.ProbeType.APP,
+            app: this.appTag,
+            event: this.event,
+        });
+    }
+    input(data) {
+        this.ctx.setProbe({
+            type: types_1.ProbeType.APP,
+            app: this.appTag,
+            event: this.event,
+            input: data,
+        });
+    }
+}
+class RecordingDatabaseProbeBuilder {
+    constructor(ctx, dbTag) {
+        this.ctx = ctx;
+        this.dbTag = dbTag;
+    }
+    action(event) {
+        return new RecordingDatabaseProbeActionBuilder(this.ctx, this.dbTag, event);
+    }
+}
+class RecordingDatabaseProbeActionBuilder {
+    constructor(ctx, dbTag, event) {
+        this.ctx = ctx;
+        this.dbTag = dbTag;
+        this.event = event;
+        // Set probe immediately (input is optional)
+        this.ctx.setProbe({
+            type: types_1.ProbeType.DATABASE,
+            database: this.dbTag,
+            event: this.event,
+        });
+    }
+    input(data) {
+        this.ctx.setProbe({
+            type: types_1.ProbeType.DATABASE,
+            database: this.dbTag,
+            event: this.event,
+            input: data,
+        });
+    }
+}
+class RecordingWorkflowProbeBuilder {
+    constructor(ctx, workflowTag) {
+        this.ctx = ctx;
+        this.workflowTag = workflowTag;
+    }
+    input(data) {
+        this.ctx.setProbe({
+            type: types_1.ProbeType.WORKFLOW,
+            workflow: this.workflowTag,
+            input: data,
+        });
+    }
+}
+/**
+ * Failure notification builder
+ */
+class RecordingFailureNotificationBuilder {
+    constructor(onFailure) {
+        this.onFailure = onFailure;
+    }
+    notification(tag) {
+        return new RecordingNotificationMessageBuilder(this.onFailure, tag);
+    }
+    webhook(config) {
+        this.onFailure.webhooks = this.onFailure.webhooks || [];
+        this.onFailure.webhooks.push(config);
+        return this;
+    }
+    emit(config) {
+        this.onFailure.emit = this.onFailure.emit || [];
+        this.onFailure.emit.push(config);
+        return this;
+    }
+}
+class RecordingNotificationMessageBuilder {
+    constructor(onFailure, notificationTag) {
+        this.onFailure = onFailure;
+        this.notificationTag = notificationTag;
+    }
+    message(event) {
+        return new RecordingNotificationChannelBuilder(this.onFailure, this.notificationTag, event);
+    }
+}
+class RecordingNotificationChannelBuilder {
+    constructor(onFailure, notificationTag, message) {
+        this.parentOnFailure = onFailure;
+        this.currentNotification = {
+            notification: notificationTag,
+            message,
+            channels: {},
+        };
+        this.parentOnFailure.notifications = this.parentOnFailure.notifications || [];
+        this.parentOnFailure.notifications.push(this.currentNotification);
+    }
+    notification(tag) {
+        return new RecordingNotificationMessageBuilder(this.parentOnFailure, tag);
+    }
+    webhook(config) {
+        this.parentOnFailure.webhooks = this.parentOnFailure.webhooks || [];
+        this.parentOnFailure.webhooks.push(config);
+        return this;
+    }
+    emit(config) {
+        this.parentOnFailure.emit = this.parentOnFailure.emit || [];
+        this.parentOnFailure.emit.push(config);
+        return this;
+    }
+    push(config) {
+        this.currentNotification.channels.push = config || {};
+        return this;
+    }
+    email(config) {
+        this.currentNotification.channels.email = config;
+        return this;
+    }
+    sms(config) {
+        this.currentNotification.channels.sms = config;
+        return this;
+    }
+    callback(config) {
+        this.currentNotification.channels.callback = config || {};
+        return this;
+    }
+}
+/**
+ * Healthcheck Service
+ *
+ * Provides code-first API for defining, creating, and managing healthchecks.
+ */
+class HealthcheckService {
+    constructor(config) {
+        this.apiService = new resilienceApi_service_1.ResilienceApiService({
+            token: config.token,
+            env_type: config.env_type,
+            base_url: config.base_url,
+        });
+    }
+    /**
+     * 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');
+     *   },
+     * });
+     * ```
+     */
+    async define(options) {
+        const ctx = new RecordingHealthcheckContext();
+        // 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 definedHealthcheck = {
+            tag: options.tag,
+            name: options.name,
+            description: options.description,
+            compile: () => schema,
+        };
+        // If product is specified, register immediately
+        if (options.product) {
+            await this.create(options.product, definedHealthcheck);
+        }
+        return definedHealthcheck;
+    }
+    /**
+     * Create a healthcheck from a defined healthcheck or schema
+     */
+    async create(product, healthcheck) {
+        const schema = 'compile' in healthcheck ? healthcheck.compile() : healthcheck;
+        return await this.apiService.createHealthcheck(product, schema);
+    }
+    /**
+     * Update an existing healthcheck
+     */
+    async update(product, tag, healthcheck) {
+        if ('handler' in healthcheck && healthcheck.handler) {
+            const ctx = new RecordingHealthcheckContext();
+            await healthcheck.handler(ctx);
+            const schema = ctx.build(tag, healthcheck.name, healthcheck.description);
+            return await this.apiService.updateHealthcheck(product, tag, schema);
+        }
+        return await this.apiService.updateHealthcheck(product, tag, healthcheck);
+    }
+    /**
+     * Fetch a healthcheck by tag
+     */
+    async fetch(product, tag) {
+        return await this.apiService.getHealthcheck(product, tag);
+    }
+    /**
+     * Fetch all healthchecks for a product
+     */
+    async fetchAll(product) {
+        return await this.apiService.listHealthchecks(product);
+    }
+    /**
+     * Delete a healthcheck
+     */
+    async delete(product, tag) {
+        await this.apiService.deleteHealthcheck(product, tag);
+    }
+    /**
+     * Get the current status of a healthcheck
+     */
+    async getStatus(options) {
+        return await this.apiService.getHealthcheckStatus(options.product, options.tag, options.env);
+    }
+    /**
+     * 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'
+     * ```
+     */
+    async check(options) {
+        return await this.getStatus(options);
+    }
+    /**
+     * Manually trigger a healthcheck
+     */
+    async run(options) {
+        return await this.apiService.runHealthcheck(options.product, options.tag, options.env);
+    }
+    /**
+     * @deprecated Use run() instead
+     */
+    async runNow(options) {
+        return await this.run(options);
+    }
+}
+exports.HealthcheckService = HealthcheckService;
+exports.default = HealthcheckService;
+//# sourceMappingURL=healthcheck.service.js.map

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

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

package/dist/resilience/index.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Ductape Resilience Module
+ *
+ * Provides code-first API for building resilient integrations with
+ * healthchecks, quotas (load distribution), and fallbacks (automatic failover).
+ *
+ * @example
+ * ```ts
+ * import { ResilienceService, HealthcheckService, QuotaService, FallbackService } from '@ductape/sdk';
+ *
+ * // Create a unified resilience service
+ * const resilience = new ResilienceService({
+ *   workspace_id: 'your-workspace-id',
+ *   public_key: 'your-public-key',
+ *   user_id: 'your-user-id',
+ *   token: 'your-token',
+ *   env_type: 'prd',
+ * });
+ *
+ * // Define a healthcheck
+ * const healthcheck = await resilience.healthcheck.define({
+ *   product: 'my-product',
+ *   tag: 'stripe-health',
+ *   handler: async (ctx) => {
+ *     ctx.probe().app('stripe-app').action('health');
+ *     ctx.interval(30000);
+ *     ctx.retries(2);
+ *     ctx.env('prd');
+ *   },
+ * });
+ *
+ * // Define a quota
+ * const quota = await resilience.quota.define({
+ *   product: 'my-product',
+ *   tag: 'sms-quota',
+ *   input: {
+ *     phone: { type: 'string', required: true },
+ *     message: { type: 'string', required: true },
+ *   },
+ *   handler: async (ctx) => {
+ *     ctx.provider('twilio')
+ *       .weight(70)
+ *       .healthcheck('twilio-health')
+ *       .app('twilio-app')
+ *       .action('send-sms')
+ *       .retries(2);
+ *
+ *     ctx.provider('nexmo')
+ *       .weight(30)
+ *       .healthcheck('nexmo-health')
+ *       .app('nexmo-app')
+ *       .action('send-sms')
+ *       .retries(2);
+ *   },
+ * });
+ *
+ * // Define a fallback
+ * const fallback = await resilience.fallback.define({
+ *   product: 'my-product',
+ *   tag: 'payment-fallback',
+ *   input: {
+ *     amount: { type: 'number', required: true },
+ *   },
+ *   handler: async (ctx) => {
+ *     ctx.primary('stripe')
+ *       .healthcheck('stripe-health')
+ *       .app('stripe-app')
+ *       .action('charge')
+ *       .retries(2);
+ *
+ *     ctx.fallback('paypal')
+ *       .healthcheck('paypal-health')
+ *       .app('paypal-app')
+ *       .action('payment')
+ *       .retries(2);
+ *   },
+ * });
+ *
+ * // Run quota
+ * const result = await resilience.quota.run({
+ *   product: 'my-product',
+ *   env: 'prd',
+ *   tag: 'sms-quota',
+ *   input: { phone: '+1234567890', message: 'Hello!' },
+ * });
+ *
+ * // Run fallback
+ * const paymentResult = await resilience.fallback.run({
+ *   product: 'my-product',
+ *   env: 'prd',
+ *   tag: 'payment-fallback',
+ *   input: { amount: 1000 },
+ * });
+ * ```
+ */
+export { ResilienceService, ResilienceError, IDefinedResilience, } from './resilience.service';
+export { default as ResilienceServiceDefault } from './resilience.service';
+export { HealthcheckService, HealthcheckError } from './healthcheck.service';
+export { default as HealthcheckServiceDefault } from './healthcheck.service';
+export { QuotaService, QuotaError } from './quota.service';
+export { default as QuotaServiceDefault } from './quota.service';
+export { FallbackService, FallbackError } from './fallback.service';
+export { default as FallbackServiceDefault } from './fallback.service';
+export * from './types';

package/dist/resilience/index.js

@@ -0,0 +1,140 @@
+"use strict";
+/**
+ * Ductape Resilience Module
+ *
+ * Provides code-first API for building resilient integrations with
+ * healthchecks, quotas (load distribution), and fallbacks (automatic failover).
+ *
+ * @example
+ * ```ts
+ * import { ResilienceService, HealthcheckService, QuotaService, FallbackService } from '@ductape/sdk';
+ *
+ * // Create a unified resilience service
+ * const resilience = new ResilienceService({
+ *   workspace_id: 'your-workspace-id',
+ *   public_key: 'your-public-key',
+ *   user_id: 'your-user-id',
+ *   token: 'your-token',
+ *   env_type: 'prd',
+ * });
+ *
+ * // Define a healthcheck
+ * const healthcheck = await resilience.healthcheck.define({
+ *   product: 'my-product',
+ *   tag: 'stripe-health',
+ *   handler: async (ctx) => {
+ *     ctx.probe().app('stripe-app').action('health');
+ *     ctx.interval(30000);
+ *     ctx.retries(2);
+ *     ctx.env('prd');
+ *   },
+ * });
+ *
+ * // Define a quota
+ * const quota = await resilience.quota.define({
+ *   product: 'my-product',
+ *   tag: 'sms-quota',
+ *   input: {
+ *     phone: { type: 'string', required: true },
+ *     message: { type: 'string', required: true },
+ *   },
+ *   handler: async (ctx) => {
+ *     ctx.provider('twilio')
+ *       .weight(70)
+ *       .healthcheck('twilio-health')
+ *       .app('twilio-app')
+ *       .action('send-sms')
+ *       .retries(2);
+ *
+ *     ctx.provider('nexmo')
+ *       .weight(30)
+ *       .healthcheck('nexmo-health')
+ *       .app('nexmo-app')
+ *       .action('send-sms')
+ *       .retries(2);
+ *   },
+ * });
+ *
+ * // Define a fallback
+ * const fallback = await resilience.fallback.define({
+ *   product: 'my-product',
+ *   tag: 'payment-fallback',
+ *   input: {
+ *     amount: { type: 'number', required: true },
+ *   },
+ *   handler: async (ctx) => {
+ *     ctx.primary('stripe')
+ *       .healthcheck('stripe-health')
+ *       .app('stripe-app')
+ *       .action('charge')
+ *       .retries(2);
+ *
+ *     ctx.fallback('paypal')
+ *       .healthcheck('paypal-health')
+ *       .app('paypal-app')
+ *       .action('payment')
+ *       .retries(2);
+ *   },
+ * });
+ *
+ * // Run quota
+ * const result = await resilience.quota.run({
+ *   product: 'my-product',
+ *   env: 'prd',
+ *   tag: 'sms-quota',
+ *   input: { phone: '+1234567890', message: 'Hello!' },
+ * });
+ *
+ * // Run fallback
+ * const paymentResult = await resilience.fallback.run({
+ *   product: 'my-product',
+ *   env: 'prd',
+ *   tag: 'payment-fallback',
+ *   input: { amount: 1000 },
+ * });
+ * ```
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FallbackServiceDefault = exports.FallbackError = exports.FallbackService = exports.QuotaServiceDefault = exports.QuotaError = exports.QuotaService = exports.HealthcheckServiceDefault = exports.HealthcheckError = exports.HealthcheckService = exports.ResilienceServiceDefault = exports.ResilienceError = exports.ResilienceService = void 0;
+// Main service
+var resilience_service_1 = require("./resilience.service");
+Object.defineProperty(exports, "ResilienceService", { enumerable: true, get: function () { return resilience_service_1.ResilienceService; } });
+Object.defineProperty(exports, "ResilienceError", { enumerable: true, get: function () { return resilience_service_1.ResilienceError; } });
+var resilience_service_2 = require("./resilience.service");
+Object.defineProperty(exports, "ResilienceServiceDefault", { enumerable: true, get: function () { return __importDefault(resilience_service_2).default; } });
+// Individual services
+var healthcheck_service_1 = require("./healthcheck.service");
+Object.defineProperty(exports, "HealthcheckService", { enumerable: true, get: function () { return healthcheck_service_1.HealthcheckService; } });
+Object.defineProperty(exports, "HealthcheckError", { enumerable: true, get: function () { return healthcheck_service_1.HealthcheckError; } });
+var healthcheck_service_2 = require("./healthcheck.service");
+Object.defineProperty(exports, "HealthcheckServiceDefault", { enumerable: true, get: function () { return __importDefault(healthcheck_service_2).default; } });
+var quota_service_1 = require("./quota.service");
+Object.defineProperty(exports, "QuotaService", { enumerable: true, get: function () { return quota_service_1.QuotaService; } });
+Object.defineProperty(exports, "QuotaError", { enumerable: true, get: function () { return quota_service_1.QuotaError; } });
+var quota_service_2 = require("./quota.service");
+Object.defineProperty(exports, "QuotaServiceDefault", { enumerable: true, get: function () { return __importDefault(quota_service_2).default; } });
+var fallback_service_1 = require("./fallback.service");
+Object.defineProperty(exports, "FallbackService", { enumerable: true, get: function () { return fallback_service_1.FallbackService; } });
+Object.defineProperty(exports, "FallbackError", { enumerable: true, get: function () { return fallback_service_1.FallbackError; } });
+var fallback_service_2 = require("./fallback.service");
+Object.defineProperty(exports, "FallbackServiceDefault", { enumerable: true, get: function () { return __importDefault(fallback_service_2).default; } });
+// Types
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/resilience/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resilience/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8FG;;;;;;;;;;;;;;;;;;;;AAEH,eAAe;AACf,2DAI8B;AAH5B,uHAAA,iBAAiB,OAAA;AACjB,qHAAA,eAAe,OAAA;AAGjB,2DAA2E;AAAlE,+IAAA,OAAO,OAA4B;AAE5C,sBAAsB;AACtB,6DAA6E;AAApE,yHAAA,kBAAkB,OAAA;AAAE,uHAAA,gBAAgB,OAAA;AAC7C,6DAA6E;AAApE,iJAAA,OAAO,OAA6B;AAE7C,iDAA2D;AAAlD,6GAAA,YAAY,OAAA;AAAE,2GAAA,UAAU,OAAA;AACjC,iDAAiE;AAAxD,qIAAA,OAAO,OAAuB;AAEvC,uDAAoE;AAA3D,mHAAA,eAAe,OAAA;AAAE,iHAAA,aAAa,OAAA;AACvC,uDAAuE;AAA9D,2IAAA,OAAO,OAA0B;AAE1C,QAAQ;AACR,0CAAwB"}