@ductape/sdk 0.0.4-v51 → 0.0.4-v52

package/dist/init.interface.d.ts

@@ -0,0 +1,407 @@
+import { IProduct, IProductApp, IProductCache, IProductDatabase, IProductDatabaseAction, IProductDatabaseMigration, IProductEnv, IProductFeature, IProductFallback, IProductJobs, IProductMessageBroker, IProductMessageBrokerTopic, IProductNotification, IProductNotificationTemplate, IProductQuota, IProductSession, IProductStorage, IProductAppHealth, IParsedSample, IFetchUsersPayload, IFetchFilesPayload, FetchRemoteCachePayload, IApp, IAppConstants, IAppEnv, IAppVariables, IAppWebhook, IAppWebhookEvent, IAppAuth, ICreateAppBuilder, IActionUpdate, ImportDocsTypes, IProcessorInput, IActionProcessorInput, IDBActionProcessorInput, INotificationProcessorInput, IStorageProcessorInput, IMessageBrokerPublishInput, IMessageBrokerSubscribeInput, ISessionInput, ISessionPayload, ISessionRefreshPayload, IRegisterWebhook, IGenerateWebhookLink, LogQueryParams } from './types';
+import { PublicStates } from './types/enums';
+export interface IProductCreateInput {
+    data: IProduct;
+}
+export interface IProductFetchInput {
+    tag: string;
+}
+export interface IProductUpdateInput {
+    tag: string;
+    data: Partial<IProduct>;
+}
+export interface IProductInitInput {
+    productTag: string;
+}
+export interface IProductUpdateValidationInput {
+    tag: string;
+    update: Partial<IParsedSample>;
+}
+export interface IProductEnvCreateInput {
+    data: IProductEnv;
+}
+export interface IProductEnvFetchInput {
+    slug: string;
+}
+export interface IProductEnvUpdateInput {
+    slug: string;
+    data: Partial<IProductEnv>;
+}
+export interface IProductAppConnectInput {
+    appTag: string;
+}
+export interface IProductAppAddInput {
+    app: IProductApp;
+}
+export interface IProductAppFetchInput {
+    tag: string;
+}
+export interface IProductAppUpdateInput {
+    accessTag: string;
+    data: Partial<IProductApp>;
+}
+export interface IProductAppWebhooksFetchAllInput {
+    accessTag: string;
+}
+export interface IProductAppWebhooksEnableInput {
+    data: IRegisterWebhook;
+}
+export interface IProductAppWebhooksGenerateLinkInput {
+    data: IGenerateWebhookLink;
+}
+export interface IProductAppHealthCreateInput {
+    data: Partial<IProductAppHealth>;
+}
+export interface IProductAppHealthUpdateInput {
+    tag: string;
+    data: Partial<IProductAppHealth>;
+}
+export interface IProductAppHealthFetchInput {
+    access_tag: string;
+    tag: string;
+}
+export interface IProductAppHealthFetchAllInput {
+    access_tag: string;
+}
+export interface ISessionCreateInput {
+    payload: IProductSession;
+}
+export interface ISessionUpdateInput {
+    tag: string;
+    payload: Partial<IProductSession>;
+}
+export interface ISessionFetchInput {
+    tag: string;
+}
+export interface ISessionUsersInput {
+    data: IFetchUsersPayload;
+}
+export interface IQuotaCreateInput {
+    data: Partial<IProductQuota>;
+}
+export interface IQuotaFetchInput {
+    tag: string;
+}
+export interface IQuotaUpdateInput {
+    tag: string;
+    data: Partial<IProductQuota>;
+}
+export interface IFallbackCreateInput {
+    data: Partial<IProductFallback>;
+}
+export interface IFallbackFetchInput {
+    tag: string;
+}
+export interface IFallbackUpdateInput {
+    tag: string;
+    data: Partial<IProductFallback>;
+}
+export interface IStorageCreateInput {
+    data: IProductStorage;
+}
+export interface IStorageFetchInput {
+    tag: string;
+}
+export interface IStorageUpdateInput {
+    tag: string;
+    data: Partial<IProductStorage>;
+}
+export interface IStorageFilesInput {
+    data: IFetchFilesPayload;
+}
+export interface IEventsCreateInput {
+    data: Partial<IProductMessageBroker>;
+}
+export interface IEventsFetchInput {
+    tag: string;
+}
+export interface IEventsUpdateInput {
+    tag: string;
+    data: Partial<IProductMessageBroker>;
+}
+export interface IEventsTopicCreateInput {
+    data: IProductMessageBrokerTopic;
+}
+export interface IEventsTopicFetchAllInput {
+    messageBrokerTag: string;
+}
+export interface IEventsTopicFetchInput {
+    tag: string;
+}
+export interface IEventsTopicUpdateInput {
+    tag: string;
+    data: Partial<IProductMessageBrokerTopic>;
+}
+export interface INotificationsCreateInput {
+    data: IProductNotification;
+}
+export interface INotificationsFetchInput {
+    tag: string;
+}
+export interface INotificationsUpdateInput {
+    tag: string;
+    data: Partial<IProductNotification>;
+}
+export interface INotificationMessageCreateInput {
+    data: IProductNotificationTemplate;
+}
+export interface INotificationMessageFetchAllInput {
+    notificationTag: string;
+}
+export interface INotificationMessageFetchInput {
+    tag: string;
+}
+export interface INotificationMessageUpdateInput {
+    tag: string;
+    data: Partial<IProductNotificationTemplate>;
+}
+export interface IDatabaseCreateInput {
+    data: IProductDatabase;
+}
+export interface IDatabaseFetchInput {
+    tag: string;
+}
+export interface IDatabaseUpdateInput {
+    tag: string;
+    data: Partial<IProductDatabase>;
+}
+export interface IDatabaseActionCreateInput {
+    data: IProductDatabaseAction;
+}
+export interface IDatabaseActionFetchAllInput {
+    databaseTag: string;
+}
+export interface IDatabaseActionFetchInput {
+    tag: string;
+}
+export interface IDatabaseActionUpdateInput {
+    tag: string;
+    data: Partial<IProductDatabaseAction>;
+}
+export interface IDatabaseMigrationCreateInput {
+    data: IProductDatabaseMigration;
+}
+export interface IDatabaseMigrationFetchAllInput {
+    databaseTag: string;
+}
+export interface IDatabaseMigrationFetchInput {
+    tag: string;
+}
+export interface IDatabaseMigrationUpdateInput {
+    tag: string;
+    data: Partial<IProductDatabaseMigration>;
+}
+export interface IJobsCreateInput {
+    data: Partial<IProductJobs>;
+}
+export interface IJobsFetchInput {
+    tag: string;
+}
+export interface IJobsUpdateInput {
+    tag: string;
+    data: Partial<IProductJobs>;
+}
+export interface ICachesCreateInput {
+    data: IProductCache;
+}
+export interface ICachesFetchInput {
+    tag: string;
+}
+export interface ICachesUpdateInput {
+    tag: string;
+    data: Partial<IProductCache>;
+}
+export interface ICachesValuesInput {
+    data: FetchRemoteCachePayload;
+}
+export interface IFeaturesCreateInput {
+    data: Partial<IProductFeature>;
+}
+export interface IFeaturesFetchInput {
+    tag: string;
+}
+export interface IFeaturesUpdateInput {
+    tag: string;
+    data: Partial<IProductCache>;
+}
+export interface IAppCreateInput {
+    data: ICreateAppBuilder;
+}
+export interface IAppFetchInput {
+    tag: string;
+}
+export interface IAppUpdateInput {
+    tag: string;
+    data: Partial<IApp>;
+}
+export interface IAppInitInput {
+    appTag: string;
+}
+export interface IAppValidationInput {
+    selector: string;
+    update: Partial<IParsedSample>;
+}
+export interface IAppEnvCreateInput {
+    data: IAppEnv;
+}
+export interface IAppEnvFetchInput {
+    slug: string;
+}
+export interface IAppEnvUpdateInput {
+    slug: string;
+    data: Partial<IAppEnv>;
+}
+export interface IVariablesCreateInput {
+    data: IAppVariables;
+}
+export interface IVariablesFetchInput {
+    tag: string;
+}
+export interface IVariablesUpdateInput {
+    tag: string;
+    data: Partial<IAppVariables>;
+}
+export interface IConstantsCreateInput {
+    data: IAppConstants;
+}
+export interface IConstantsFetchInput {
+    tag: string;
+}
+export interface IConstantsUpdateInput {
+    tag: string;
+    data: Partial<IAppVariables>;
+}
+export interface IActionsImportInput {
+    file: Buffer;
+    type: ImportDocsTypes;
+    version: string;
+    appTag?: string;
+    updateIfExists?: boolean;
+    isAdminImport?: boolean;
+}
+export interface IActionsCreateInput {
+    data: Partial<IActionUpdate> & {
+        tag: string;
+        name: string;
+        resource: string;
+        method: string;
+    };
+}
+export interface IActionsFetchInput {
+    tag: string;
+}
+export interface IActionsUpdateInput {
+    tag: string;
+    data: Partial<IActionUpdate>;
+}
+export interface IAuthsCreateInput {
+    data: IAppAuth;
+}
+export interface IAuthsFetchInput {
+    tag: string;
+}
+export interface IAuthsUpdateInput {
+    tag: string;
+    data: Partial<IAppAuth>;
+}
+export interface IWebhooksCreateInput {
+    data: Partial<IAppWebhook>;
+}
+export interface IWebhooksFetchInput {
+    tag: string;
+}
+export interface IWebhooksUpdateInput {
+    tag: string;
+    data: Partial<IAppWebhook>;
+}
+export interface IWebhookEventsCreateInput {
+    data: IAppWebhookEvent;
+}
+export interface IWebhookEventsFetchAllInput {
+    webhookTag: string;
+}
+export interface IWebhookEventsFetchInput {
+    tag: string;
+}
+export interface IWebhookEventsUpdateInput {
+    tag: string;
+    data: Partial<IAppWebhookEvent>;
+}
+export interface IProcessorJobScheduleInput {
+    data: IProduct;
+}
+export interface IProcessorActionRunInput {
+    data: IActionProcessorInput;
+}
+export interface IProcessorDbExecuteInput {
+    data: IDBActionProcessorInput;
+}
+export interface IProcessorDbMigrationRunInput {
+    migration: string;
+    env: string;
+    product: string;
+}
+export interface IProcessorDbMigrationRollbackInput {
+    migration: string;
+    env: string;
+    product: string;
+}
+export interface IProcessorSessionStartInput {
+    data: ISessionInput;
+}
+export interface IProcessorSessionDecryptInput {
+    data: ISessionPayload;
+}
+export interface IProcessorSessionRefreshInput {
+    data: ISessionRefreshPayload;
+}
+export interface IProcessorFeatureRunInput {
+    data: IProcessorInput;
+}
+export interface IProcessorFeatureOutputInput {
+    process_id: string;
+}
+export interface IProcessorFeatureReplayInput {
+    process_id: string;
+}
+export interface IProcessorFeatureResumeInput {
+    process_id: string;
+}
+export interface IProcessorQuotaRunInput {
+    data: IProcessorInput;
+}
+export interface IProcessorFallbackRunInput {
+    data: IProcessorInput;
+}
+export interface IProcessorNotificationSendInput {
+    data: INotificationProcessorInput;
+}
+export interface IProcessorStorageReadFileInput {
+    path: string;
+}
+export interface IProcessorStorageSaveInput {
+    data: IStorageProcessorInput;
+}
+export interface IProcessorMessageBrokerPublishInput {
+    data: IMessageBrokerPublishInput;
+}
+export interface IProcessorMessageBrokerSubscribeInput {
+    data: IMessageBrokerSubscribeInput;
+}
+export interface ILogsInitInput {
+    productTag?: string;
+    appTag?: string;
+}
+export interface ILogsFetchInput {
+    params: LogQueryParams;
+}
+export interface IFetchWorkspaceAppsInput {
+    status: PublicStates;
+}
+export interface IFetchWorkspaceProjectsInput {
+    status: PublicStates;
+}
+export interface IGetHealthcheckStatusInput {
+    productTag: string;
+    envSlug: string;
+}

package/dist/init.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=init.interface.js.map

package/dist/init.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.interface.js","sourceRoot":"","sources":["../src/init.interface.ts"],"names":[],"mappings":""}

package/dist/jobs/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Jobs Module
+ *
+ * Provides comprehensive job scheduling and management for Ductape.
+ *
+ * Features:
+ * - Schedule jobs for deferred execution
+ * - Recurring jobs with cron or interval schedules
+ * - Automatic retry with exponential backoff
+ * - Job lifecycle management (pause, resume, cancel)
+ * - Execution history and statistics
+ * - Webhook notifications for job events
+ *
+ * @example
+ * ```ts
+ * // Get job status
+ * const job = await ductape.jobs.get('job_abc123');
+ *
+ * // List all scheduled jobs
+ * const { jobs } = await ductape.jobs.list({ status: 'scheduled' });
+ *
+ * // Cancel a job
+ * await ductape.jobs.cancel('job_abc123');
+ *
+ * // Pause/Resume recurring jobs
+ * await ductape.jobs.pause('job_abc123');
+ * await ductape.jobs.resume('job_abc123');
+ *
+ * // Retry a failed job
+ * await ductape.jobs.retry('job_abc123', { delay: 5000 });
+ *
+ * // Get job statistics
+ * const stats = await ductape.jobs.getStats({ product: 'my-app' });
+ * ```
+ */
+export { JobsService } from './jobs.service';
+export { JobStateManager } from './jobs.state';
+export { JobStatus, JobType, IJob, IJobExecution, IJobHistory, IJobListOptions, IJobListResult, IJobStats, IJobSchedule, IRetryConfig, IDispatchResult, IJobWebhookConfig, IJobWebhookPayload, IRetryOptions, ICancelOptions, IRescheduleOptions, IJobDispatchOptions, IActionJobDispatch, INotificationJobDispatch, IDatabaseOperationJobDispatch, IWorkflowJobDispatch, IStorageJobDispatch, IPublishJobDispatch, IGraphOperationJobDispatch, JobWebhookEvent, JOB_REDIS_KEYS, JOB_DEFAULTS, } from './types';

package/dist/jobs/index.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * Jobs Module
+ *
+ * Provides comprehensive job scheduling and management for Ductape.
+ *
+ * Features:
+ * - Schedule jobs for deferred execution
+ * - Recurring jobs with cron or interval schedules
+ * - Automatic retry with exponential backoff
+ * - Job lifecycle management (pause, resume, cancel)
+ * - Execution history and statistics
+ * - Webhook notifications for job events
+ *
+ * @example
+ * ```ts
+ * // Get job status
+ * const job = await ductape.jobs.get('job_abc123');
+ *
+ * // List all scheduled jobs
+ * const { jobs } = await ductape.jobs.list({ status: 'scheduled' });
+ *
+ * // Cancel a job
+ * await ductape.jobs.cancel('job_abc123');
+ *
+ * // Pause/Resume recurring jobs
+ * await ductape.jobs.pause('job_abc123');
+ * await ductape.jobs.resume('job_abc123');
+ *
+ * // Retry a failed job
+ * await ductape.jobs.retry('job_abc123', { delay: 5000 });
+ *
+ * // Get job statistics
+ * const stats = await ductape.jobs.getStats({ product: 'my-app' });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JOB_DEFAULTS = exports.JOB_REDIS_KEYS = exports.JobType = exports.JobStatus = exports.JobStateManager = exports.JobsService = void 0;
+var jobs_service_1 = require("./jobs.service");
+Object.defineProperty(exports, "JobsService", { enumerable: true, get: function () { return jobs_service_1.JobsService; } });
+var jobs_state_1 = require("./jobs.state");
+Object.defineProperty(exports, "JobStateManager", { enumerable: true, get: function () { return jobs_state_1.JobStateManager; } });
+var types_1 = require("./types");
+// Enums
+Object.defineProperty(exports, "JobStatus", { enumerable: true, get: function () { return types_1.JobStatus; } });
+Object.defineProperty(exports, "JobType", { enumerable: true, get: function () { return types_1.JobType; } });
+// Constants
+Object.defineProperty(exports, "JOB_REDIS_KEYS", { enumerable: true, get: function () { return types_1.JOB_REDIS_KEYS; } });
+Object.defineProperty(exports, "JOB_DEFAULTS", { enumerable: true, get: function () { return types_1.JOB_DEFAULTS; } });
+//# sourceMappingURL=index.js.map

package/dist/jobs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jobs/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;;;AAEH,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AACpB,2CAA+C;AAAtC,6GAAA,eAAe,OAAA;AACxB,iCAmCiB;AAlCf,QAAQ;AACR,kGAAA,SAAS,OAAA;AACT,gGAAA,OAAO,OAAA;AA6BP,YAAY;AACZ,uGAAA,cAAc,OAAA;AACd,qGAAA,YAAY,OAAA"}

package/dist/jobs/jobs.service.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Jobs Service
+ * Provides job management capabilities including scheduling, monitoring, and control
+ */
+import { JobStateManager } from './jobs.state';
+import { IJob, IJobHistory, IJobListOptions, IJobListResult, IJobStats, IJobWebhookConfig, IRetryOptions, ICancelOptions, IRescheduleOptions, JobStatus } from './types';
+export interface IJobsServiceConfig {
+    redisClient: any;
+    workspaceId: string;
+    queues: {
+        jobs: any;
+    };
+}
+/**
+ * JobsService manages the full lifecycle of background jobs
+ */
+export declare class JobsService {
+    private stateManager;
+    private queues;
+    private workspaceId;
+    constructor(config: IJobsServiceConfig);
+    /**
+     * Get a specific job by ID
+     */
+    get(jobId: string): Promise<IJob | null>;
+    /**
+     * List jobs with optional filters
+     */
+    list(options?: IJobListOptions): Promise<IJobListResult>;
+    /**
+     * Cancel a scheduled job
+     */
+    cancel(jobId: string, options?: ICancelOptions): Promise<IJob | null>;
+    /**
+     * Cancel multiple jobs matching filter
+     */
+    cancelMany(filter: {
+        product?: string;
+        status?: JobStatus;
+    }): Promise<{
+        count: number;
+    }>;
+    /**
+     * Pause a recurring job
+     */
+    pause(jobId: string): Promise<IJob | null>;
+    /**
+     * Pause multiple jobs
+     */
+    pauseMany(filter: {
+        product?: string;
+        recurring?: boolean;
+    }): Promise<{
+        count: number;
+    }>;
+    /**
+     * Resume a paused job
+     */
+    resume(jobId: string): Promise<IJob | null>;
+    /**
+     * Resume multiple paused jobs
+     */
+    resumeMany(filter: {
+        product?: string;
+        status?: JobStatus;
+    }): Promise<{
+        count: number;
+    }>;
+    /**
+     * Reschedule a job
+     */
+    reschedule(jobId: string, options: IRescheduleOptions): Promise<IJob | null>;
+    /**
+     * Retry a failed job
+     */
+    retry(jobId: string, options?: IRetryOptions): Promise<IJob | null>;
+    /**
+     * Retry multiple failed jobs
+     */
+    retryMany(filter: {
+        status?: JobStatus;
+        from?: number | string;
+    }): Promise<{
+        count: number;
+    }>;
+    /**
+     * Delete a job
+     */
+    delete(jobId: string): Promise<boolean>;
+    /**
+     * Delete multiple jobs
+     */
+    deleteMany(filter: {
+        status?: JobStatus | JobStatus[];
+        to?: number | string;
+    }): Promise<{
+        count: number;
+    }>;
+    /**
+     * Get job execution history
+     */
+    getHistory(jobId: string, options?: {
+        limit?: number;
+    }): Promise<IJobHistory | null>;
+    /**
+     * Get job statistics
+     */
+    getStats(options?: {
+        product?: string;
+        env?: string;
+        from?: number;
+        to?: number;
+    }): Promise<IJobStats>;
+    /**
+     * Configure webhook for job events
+     */
+    setWebhook(config: IJobWebhookConfig): Promise<void>;
+    /**
+     * Get webhook configuration
+     */
+    getWebhook(): Promise<IJobWebhookConfig | null>;
+    /**
+     * Remove webhook configuration
+     */
+    removeWebhook(): Promise<void>;
+    /**
+     * Mark job as started (called by worker)
+     */
+    markStarted(jobId: string): Promise<IJob | null>;
+    /**
+     * Mark job as completed (called by worker)
+     */
+    markCompleted(jobId: string, result?: Record<string, unknown>): Promise<IJob | null>;
+    /**
+     * Mark job as failed (called by worker)
+     */
+    markFailed(jobId: string, error: string, errorCode?: string): Promise<{
+        job: IJob | null;
+        shouldRetry: boolean;
+        retryDelay: number;
+    }>;
+    /**
+     * Calculate retry delay based on configuration
+     */
+    private calculateRetry;
+    /**
+     * Calculate next run time for recurring jobs
+     */
+    private calculateNextRun;
+    /**
+     * Get state manager for direct access (used by processor)
+     */
+    getStateManager(): JobStateManager;
+}