@ductape/sdk 0.1.8 → 0.1.9

package/dist/products/validators/joi-validators/update.userAuth.validator.js

@@ -0,0 +1,48 @@
+"use strict";
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const Joi = __importStar(require("joi"));
+const types_1 = require("../../../types");
+const validatorSchema = Joi.object({
+    schema: Joi.object().pattern(Joi.string(), Joi.any()).optional(),
+    selector: Joi.string().optional(),
+    expiry: Joi.number().optional(),
+    period: Joi.string().valid(...Object.values(types_1.TokenPeriods)).optional(),
+    //tag: Joi.string().required(),
+    name: Joi.string().optional(),
+    description: Joi.string().optional(),
+});
+exports.default = validatorSchema;
+//# sourceMappingURL=update.userAuth.validator.js.map

package/dist/products/validators/joi-validators/update.userAuth.validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.userAuth.validator.js","sourceRoot":"","sources":["../../../../src/products/validators/joi-validators/update.userAuth.validator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,yCAA2B;AAC3B,0CAA8C;AAE7C,MAAM,eAAe,GAAG,GAAG,CAAC,MAAM,CAAC;IAChC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;IAChE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,oBAAY,CAAC,CAAC,CAAC,QAAQ,EAAE;IACrE,+BAA+B;IAC/B,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC;AAEH,kBAAe,eAAe,CAAC"}

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

@@ -0,0 +1,143 @@
+/**
+ * Fallback Service
+ *
+ * Code-first API for defining and managing fallbacks with sequential failover.
+ * Uses ProductBuilder for CRUD operations and ProcessorService for execution.
+ * Implements health-aware sequential failover with minimal latency.
+ */
+import { IFallbackDefineOptions, IFallbackSchema, IFallbackRunOptions, IFallbackDispatchOptions, IDefinedFallback, IResilienceServiceConfig } from './types';
+import { IProductFallback } from '../types/productsBuilder.types';
+/**
+ * Error class for fallback operations
+ */
+export declare class FallbackError extends Error {
+    code: string;
+    details?: unknown;
+    constructor(message: string, code: string, details?: unknown);
+}
+/**
+ * Result of a fallback run with provider and failover information
+ */
+export interface IFallbackRunResult<T = unknown> {
+    data: T;
+    provider: string;
+    latency: number;
+    wasHealthy: boolean;
+    failoverCount: number;
+    triedProviders: string[];
+}
+/**
+ * Fallback Service
+ *
+ * Provides code-first API for defining, creating, and managing fallbacks.
+ * Uses ProductBuilder for CRUD operations and ProcessorService for execution.
+ * Implements health-aware sequential failover with minimal latency.
+ */
+export declare class FallbackService {
+    private config;
+    private productBuilders;
+    private processorCache;
+    private _privateKey;
+    private readonly productEnv;
+    constructor(config: IResilienceServiceConfig & {
+        private_key: string;
+        access_key?: string;
+    });
+    private resolvePE;
+    /**
+     * Gets or creates a cached ProductBuilder
+     */
+    private getProductBuilder;
+    /**
+     * Gets or creates a cached ProcessorService for minimal latency
+     */
+    private getProcessor;
+    /**
+     * 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);
+     *   },
+     * });
+     * ```
+     */
+    define<TInput = Record<string, unknown>>(options: IFallbackDefineOptions<TInput>): Promise<IDefinedFallback>;
+    /**
+     * Create a fallback from a defined fallback or schema
+     */
+    create(product: string, fallback: IDefinedFallback | IFallbackSchema): Promise<IProductFallback>;
+    /**
+     * Fetch a fallback by tag
+     */
+    fetch(product: string, tag: string): Promise<IProductFallback | null>;
+    /**
+     * Fetch all fallbacks for a product
+     */
+    fetchAll(product: string): Promise<IProductFallback[]>;
+    /**
+     * Update an existing fallback
+     */
+    update<TInput = Record<string, unknown>>(product: string, tag: string, fallback: Partial<IFallbackDefineOptions<TInput>> | Partial<IProductFallback>): Promise<void>;
+    /**
+     * Delete a fallback
+     */
+    delete(product: string, tag: string): Promise<void>;
+    /**
+     * Run a fallback with health-aware sequential failover
+     *
+     * Optimization strategies:
+     * 1. Parallel health status lookups from Redis (O(1) per provider)
+     * 2. Skip unhealthy providers immediately
+     * 3. Cached processor instances to avoid re-initialization
+     * 4. Exponential backoff only on failures
+     * 5. Short-circuit on first success
+     */
+    run<TOutput = unknown>(options: IFallbackRunOptions): Promise<IFallbackRunResult<TOutput>>;
+    /**
+     * Parallel health status lookup from Redis - O(n) with parallel I/O
+     */
+    private getHealthStatusesParallel;
+    /**
+     * Order providers by health status: healthy > unknown > unhealthy
+     * Maintains original order within each category (first provider = primary)
+     */
+    private orderProvidersByHealth;
+    /**
+     * Execute provider action with exponential backoff retries
+     */
+    private executeWithRetries;
+    /**
+     * Dispatch fallback for deferred execution via job queue
+     *
+     * Note: For immediate execution, use run() instead.
+     * Dispatch schedules the fallback for background processing.
+     */
+    dispatch(options: IFallbackDispatchOptions): Promise<{
+        jobId: string;
+    }>;
+}
+export default FallbackService;