@ductape/sdk 0.0.4-v6 → 0.0.4-v61

package/dist/jobs/types.d.ts

@@ -0,0 +1,449 @@
+/**
+ * Job Management Types
+ * Defines interfaces for job state management, retry strategies, and job operations
+ */
+import { IActionRequest, INotificationRequest, IStorageRequest, IPublishRequest } from '../types/processor.types';
+/**
+ * Job status throughout its lifecycle
+ */
+export declare enum JobStatus {
+    SCHEDULED = "scheduled",
+    QUEUED = "queued",
+    RUNNING = "running",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    CANCELLED = "cancelled",
+    PAUSED = "paused"
+}
+/**
+ * Job types that can be scheduled
+ */
+export declare enum JobType {
+    ACTION = "action",
+    NOTIFICATION = "notification",
+    DATABASE_ACTION = "database_action",
+    DATABASE_OPERATION = "database_operation",
+    GRAPH_ACTION = "graph_action",
+    GRAPH_OPERATION = "graph_operation",
+    WORKFLOW = "workflow",
+    STORAGE = "storage",
+    PUBLISH = "publish"
+}
+/**
+ * Retry configuration for jobs
+ */
+export interface IRetryConfig {
+    /** Initial delay in milliseconds before first retry (default: 1000) */
+    initialDelay?: number;
+    /** Maximum delay in milliseconds between retries (default: 300000 - 5 minutes) */
+    maxDelay?: number;
+    /** Multiplier for exponential backoff (default: 2) */
+    backoffMultiplier?: number;
+    /** Only retry on these error types */
+    retryableErrors?: string[];
+    /** Never retry on these error types */
+    nonRetryableErrors?: string[];
+    /** Add jitter to prevent thundering herd */
+    jitter?: boolean;
+    /** Jitter percentage (0-1, default: 0.3) */
+    jitterPercent?: number;
+}
+/**
+ * Schedule configuration for jobs
+ */
+export interface IJobSchedule {
+    /** When to start the job (Unix timestamp in ms or ISO date string) */
+    start_at?: number | string;
+    /** Cron expression for recurring jobs */
+    cron?: string;
+    /** Interval in milliseconds for recurring jobs */
+    every?: number;
+    /** Maximum number of times to run (for recurring jobs) */
+    limit?: number;
+    /** Stop recurring after this date */
+    endDate?: number | string;
+    /** Timezone for cron expressions */
+    tz?: string;
+}
+/**
+ * Job execution record
+ */
+export interface IJobExecution {
+    /** Execution number (1-indexed) */
+    number: number;
+    /** When execution started */
+    started_at: number;
+    /** When execution completed */
+    completed_at?: number;
+    /** Duration in milliseconds */
+    duration_ms?: number;
+    /** Execution status */
+    status: 'completed' | 'failed';
+    /** Error message if failed */
+    error?: string;
+    /** Error code if failed */
+    error_code?: string;
+    /** Result data if completed */
+    result?: Record<string, unknown>;
+}
+/**
+ * Complete job record stored in Redis
+ */
+export interface IJob {
+    /** Unique job ID */
+    id: string;
+    /** Current job status */
+    status: JobStatus;
+    /** Job type (action, notification, etc.) */
+    type: JobType;
+    /** Namespace that created this job */
+    namespace: string;
+    /** Product tag */
+    product: string;
+    /** Environment slug */
+    env: string;
+    /** Job event/tag identifier */
+    event: string;
+    /** App/database/graph tag (depending on type) */
+    app?: string;
+    /** Scheduled start time */
+    scheduled_at: number;
+    /** When job started executing */
+    started_at?: number;
+    /** When job completed */
+    completed_at?: number;
+    /** Whether this is a recurring job */
+    recurring: boolean;
+    /** Cron expression (if recurring) */
+    cron?: string;
+    /** Interval in ms (if recurring) */
+    every?: number;
+    /** Next scheduled run time */
+    next_run_at?: number;
+    /** Total execution count */
+    execution_count: number;
+    /** Maximum executions limit */
+    limit?: number;
+    /** End date for recurring job */
+    end_date?: number;
+    /** Timezone for cron */
+    tz?: string;
+    /** Maximum retry attempts */
+    retries: number;
+    /** Current retry count */
+    retry_count: number;
+    /** Retry configuration */
+    retry_config?: IRetryConfig;
+    /** Last error message */
+    last_error?: string;
+    /** Last error code */
+    last_error_code?: string;
+    /** Job input data */
+    input: Record<string, unknown>;
+    /** Job result (if completed) */
+    result?: Record<string, unknown>;
+    /** Session info */
+    session?: {
+        tag: string;
+        token: string;
+    };
+    /** Cache tag */
+    cache?: string;
+    /** Workspace ID */
+    workspace_id: string;
+    /** Created timestamp */
+    created_at: number;
+    /** Last updated timestamp */
+    updated_at: number;
+    /** Cancellation reason (if cancelled) */
+    cancel_reason?: string;
+}
+/**
+ * Job execution history
+ */
+export interface IJobHistory {
+    /** Job ID */
+    job_id: string;
+    /** Total executions */
+    total_executions: number;
+    /** Successful executions */
+    successful_executions: number;
+    /** Failed executions */
+    failed_executions: number;
+    /** Execution records */
+    executions: IJobExecution[];
+}
+/**
+ * Options for listing jobs
+ */
+export interface IJobListOptions {
+    /** Filter by status */
+    status?: JobStatus | JobStatus[];
+    /** Filter by recurring */
+    recurring?: boolean;
+    /** Filter by product */
+    product?: string;
+    /** Filter by environment */
+    env?: string;
+    /** Filter by job type/namespace */
+    namespace?: string;
+    /** Maximum results */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+    /** Start date filter (Unix timestamp or ISO string) */
+    from?: number | string;
+    /** End date filter (Unix timestamp or ISO string) */
+    to?: number | string;
+}
+/**
+ * Job list result
+ */
+export interface IJobListResult {
+    /** List of jobs */
+    jobs: IJob[];
+    /** Total count (before pagination) */
+    total: number;
+    /** Applied limit */
+    limit: number;
+    /** Applied offset */
+    offset: number;
+}
+/**
+ * Job statistics
+ */
+export interface IJobStats {
+    /** Total jobs */
+    total: number;
+    /** Scheduled jobs */
+    scheduled: number;
+    /** Queued jobs */
+    queued: number;
+    /** Running jobs */
+    running: number;
+    /** Completed jobs */
+    completed: number;
+    /** Failed jobs */
+    failed: number;
+    /** Cancelled jobs */
+    cancelled: number;
+    /** Paused jobs */
+    paused: number;
+    /** Jobs completed on first try */
+    completed_first_try: number;
+    /** Jobs completed after retry */
+    completed_after_retry: number;
+    /** Success rate (0-1) */
+    success_rate: number;
+    /** Average retry count for completed jobs */
+    avg_retry_count: number;
+}
+/**
+ * Result of dispatching a job
+ */
+export interface IDispatchResult {
+    /** Unique job ID for tracking */
+    job_id: string;
+    /** Job status */
+    status: JobStatus.SCHEDULED | JobStatus.QUEUED;
+    /** Scheduled start time */
+    scheduled_at: number;
+    /** Whether this is a recurring job */
+    recurring: boolean;
+    /** Next run time for recurring jobs */
+    next_run_at?: number;
+}
+/**
+ * Webhook configuration for job events
+ */
+export interface IJobWebhookConfig {
+    /** Webhook URL */
+    url: string;
+    /** Events to trigger webhook */
+    events: JobWebhookEvent[];
+    /** Secret for signing payloads */
+    secret?: string;
+    /** Additional headers */
+    headers?: Record<string, string>;
+}
+/**
+ * Job webhook events
+ */
+export type JobWebhookEvent = 'job.scheduled' | 'job.started' | 'job.completed' | 'job.failed' | 'job.cancelled' | 'job.paused' | 'job.resumed' | 'job.retrying';
+/**
+ * Webhook payload
+ */
+export interface IJobWebhookPayload {
+    /** Event type */
+    event: JobWebhookEvent;
+    /** Event timestamp */
+    timestamp: number;
+    /** Job data */
+    job: {
+        id: string;
+        status: JobStatus;
+        namespace: string;
+        product: string;
+        env: string;
+        event: string;
+        scheduled_at: number;
+        execution_count?: number;
+        error?: string;
+        error_code?: string;
+        result?: Record<string, unknown>;
+    };
+}
+/**
+ * Options for retrying a job
+ */
+export interface IRetryOptions {
+    /** Delay before retry in milliseconds */
+    delay?: number;
+    /** Override retry configuration */
+    retryConfig?: IRetryConfig;
+}
+/**
+ * Options for cancelling a job
+ */
+export interface ICancelOptions {
+    /** Reason for cancellation */
+    reason?: string;
+}
+/**
+ * Options for rescheduling a job
+ */
+export interface IRescheduleOptions {
+    /** New start time */
+    start_at?: number | string;
+    /** New cron expression (for recurring jobs) */
+    cron?: string;
+    /** New interval (for recurring jobs) */
+    every?: number;
+    /** New timezone */
+    tz?: string;
+}
+/**
+ * Base dispatch input with common options
+ */
+export interface IJobDispatchOptions {
+    /** Number of retries on failure */
+    retries?: number;
+    /** Retry configuration */
+    retryConfig?: IRetryConfig;
+    /** Schedule configuration */
+    schedule?: IJobSchedule;
+    /** Session info */
+    session?: {
+        tag: string;
+        token: string;
+    };
+    /** Cache tag */
+    cache?: string;
+}
+/**
+ * Action dispatch input
+ */
+export interface IActionJobDispatch extends IJobDispatchOptions {
+    env: string;
+    product: string;
+    app: string;
+    event: string;
+    input: IActionRequest;
+}
+/**
+ * Notification dispatch input
+ */
+export interface INotificationJobDispatch extends IJobDispatchOptions {
+    env: string;
+    product: string;
+    notification: string;
+    event: string;
+    input: INotificationRequest;
+}
+/**
+ * Database operation dispatch input
+ */
+export interface IDatabaseOperationJobDispatch extends IJobDispatchOptions {
+    env: string;
+    product: string;
+    database: string;
+    operation: string;
+    input: Record<string, unknown>;
+}
+/**
+ * Workflow dispatch input
+ */
+export interface IWorkflowJobDispatch extends IJobDispatchOptions {
+    env: string;
+    product: string;
+    workflow: string;
+    input: Record<string, unknown>;
+}
+/**
+ * Storage dispatch input
+ */
+export interface IStorageJobDispatch extends IJobDispatchOptions {
+    env: string;
+    product: string;
+    storage: string;
+    event: string;
+    input: IStorageRequest;
+}
+/**
+ * Publish dispatch input
+ */
+export interface IPublishJobDispatch extends IJobDispatchOptions {
+    env: string;
+    product: string;
+    broker: string;
+    event: string;
+    input: IPublishRequest;
+}
+/**
+ * Graph operation dispatch input
+ */
+export interface IGraphOperationJobDispatch extends IJobDispatchOptions {
+    env: string;
+    product: string;
+    graph: string;
+    operation: string;
+    input: Record<string, unknown>;
+}
+/**
+ * Redis key prefixes for job storage
+ */
+export declare const JOB_REDIS_KEYS: {
+    /** Job data: job:{workspace_id}:{job_id} */
+    readonly JOB: "job";
+    /** Job index by status: job_status:{workspace_id}:{status} */
+    readonly JOB_STATUS: "job_status";
+    /** Job index by product: job_product:{workspace_id}:{product} */
+    readonly JOB_PRODUCT: "job_product";
+    /** Job execution history: job_history:{workspace_id}:{job_id} */
+    readonly JOB_HISTORY: "job_history";
+    /** Webhook config: job_webhook:{workspace_id} */
+    readonly JOB_WEBHOOK: "job_webhook";
+    /** Job stats: job_stats:{workspace_id}:{product} */
+    readonly JOB_STATS: "job_stats";
+};
+/**
+ * Default job configuration
+ */
+export declare const JOB_DEFAULTS: {
+    /** Default max retries */
+    readonly MAX_RETRIES: 0;
+    /** Default initial retry delay (1 second) */
+    readonly INITIAL_DELAY: 1000;
+    /** Default max retry delay (5 minutes) */
+    readonly MAX_DELAY: 300000;
+    /** Default backoff multiplier */
+    readonly BACKOFF_MULTIPLIER: 2;
+    /** Default jitter percentage */
+    readonly JITTER_PERCENT: 0.3;
+    /** Job data TTL in seconds (90 days) */
+    readonly JOB_TTL: number;
+    /** Job history TTL in seconds (30 days) */
+    readonly HISTORY_TTL: number;
+    /** Max history entries per job */
+    readonly MAX_HISTORY_ENTRIES: 100;
+};

package/dist/jobs/types.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * Job Management Types
+ * Defines interfaces for job state management, retry strategies, and job operations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JOB_DEFAULTS = exports.JOB_REDIS_KEYS = exports.JobType = exports.JobStatus = void 0;
+/**
+ * Job status throughout its lifecycle
+ */
+var JobStatus;
+(function (JobStatus) {
+    JobStatus["SCHEDULED"] = "scheduled";
+    JobStatus["QUEUED"] = "queued";
+    JobStatus["RUNNING"] = "running";
+    JobStatus["COMPLETED"] = "completed";
+    JobStatus["FAILED"] = "failed";
+    JobStatus["CANCELLED"] = "cancelled";
+    JobStatus["PAUSED"] = "paused";
+})(JobStatus || (exports.JobStatus = JobStatus = {}));
+/**
+ * Job types that can be scheduled
+ */
+var JobType;
+(function (JobType) {
+    JobType["ACTION"] = "action";
+    JobType["NOTIFICATION"] = "notification";
+    JobType["DATABASE_ACTION"] = "database_action";
+    JobType["DATABASE_OPERATION"] = "database_operation";
+    JobType["GRAPH_ACTION"] = "graph_action";
+    JobType["GRAPH_OPERATION"] = "graph_operation";
+    JobType["WORKFLOW"] = "workflow";
+    JobType["STORAGE"] = "storage";
+    JobType["PUBLISH"] = "publish";
+})(JobType || (exports.JobType = JobType = {}));
+/**
+ * Redis key prefixes for job storage
+ */
+exports.JOB_REDIS_KEYS = {
+    /** Job data: job:{workspace_id}:{job_id} */
+    JOB: 'job',
+    /** Job index by status: job_status:{workspace_id}:{status} */
+    JOB_STATUS: 'job_status',
+    /** Job index by product: job_product:{workspace_id}:{product} */
+    JOB_PRODUCT: 'job_product',
+    /** Job execution history: job_history:{workspace_id}:{job_id} */
+    JOB_HISTORY: 'job_history',
+    /** Webhook config: job_webhook:{workspace_id} */
+    JOB_WEBHOOK: 'job_webhook',
+    /** Job stats: job_stats:{workspace_id}:{product} */
+    JOB_STATS: 'job_stats',
+};
+/**
+ * Default job configuration
+ */
+exports.JOB_DEFAULTS = {
+    /** Default max retries */
+    MAX_RETRIES: 0,
+    /** Default initial retry delay (1 second) */
+    INITIAL_DELAY: 1000,
+    /** Default max retry delay (5 minutes) */
+    MAX_DELAY: 300000,
+    /** Default backoff multiplier */
+    BACKOFF_MULTIPLIER: 2,
+    /** Default jitter percentage */
+    JITTER_PERCENT: 0.3,
+    /** Job data TTL in seconds (90 days) */
+    JOB_TTL: 90 * 24 * 60 * 60,
+    /** Job history TTL in seconds (30 days) */
+    HISTORY_TTL: 30 * 24 * 60 * 60,
+    /** Max history entries per job */
+    MAX_HISTORY_ENTRIES: 100,
+};
+//# sourceMappingURL=types.js.map

package/dist/jobs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/jobs/types.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIH;;GAEG;AACH,IAAY,SAQX;AARD,WAAY,SAAS;IACnB,oCAAuB,CAAA;IACvB,8BAAiB,CAAA;IACjB,gCAAmB,CAAA;IACnB,oCAAuB,CAAA;IACvB,8BAAiB,CAAA;IACjB,oCAAuB,CAAA;IACvB,8BAAiB,CAAA;AACnB,CAAC,EARW,SAAS,yBAAT,SAAS,QAQpB;AAED;;GAEG;AACH,IAAY,OAUX;AAVD,WAAY,OAAO;IACjB,4BAAiB,CAAA;IACjB,wCAA6B,CAAA;IAC7B,8CAAmC,CAAA;IACnC,oDAAyC,CAAA;IACzC,wCAA6B,CAAA;IAC7B,8CAAmC,CAAA;IACnC,gCAAqB,CAAA;IACrB,8BAAmB,CAAA;IACnB,8BAAmB,CAAA;AACrB,CAAC,EAVW,OAAO,uBAAP,OAAO,QAUlB;AAyaD;;GAEG;AACU,QAAA,cAAc,GAAG;IAC5B,4CAA4C;IAC5C,GAAG,EAAE,KAAK;IACV,8DAA8D;IAC9D,UAAU,EAAE,YAAY;IACxB,iEAAiE;IACjE,WAAW,EAAE,aAAa;IAC1B,iEAAiE;IACjE,WAAW,EAAE,aAAa;IAC1B,iDAAiD;IACjD,WAAW,EAAE,aAAa;IAC1B,oDAAoD;IACpD,SAAS,EAAE,WAAW;CACd,CAAC;AAEX;;GAEG;AACU,QAAA,YAAY,GAAG;IAC1B,0BAA0B;IAC1B,WAAW,EAAE,CAAC;IACd,6CAA6C;IAC7C,aAAa,EAAE,IAAI;IACnB,0CAA0C;IAC1C,SAAS,EAAE,MAAM;IACjB,iCAAiC;IACjC,kBAAkB,EAAE,CAAC;IACrB,gCAAgC;IAChC,cAAc,EAAE,GAAG;IACnB,wCAAwC;IACxC,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;IAC1B,2CAA2C;IAC3C,WAAW,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;IAC9B,kCAAkC;IAClC,mBAAmB,EAAE,GAAG;CAChB,CAAC"}

package/dist/logs/logs.types.d.ts

@@ -7,6 +7,10 @@ export interface ILogData {
     successful_feature_execution?: boolean;
     parent_tag?: string;
     child_tag?: string;
+    pricing_tag?: string;
+    pricing_cost?: number;
+    currency?: string;
+    overage?: boolean;
     successful_execution?: boolean;
     failed_execution?: boolean;
     product_tag: string;
@@ -25,6 +29,12 @@ export interface ILogData {
     start?: number;
     end?: number;
     timestamp?: Date;
+    /** Session identifier (e.g., user ID, email) extracted from session token */
+    identifier?: string;
+    /** Session ID from the session token */
+    session_id?: string;
+    /** Session tag identifying the session type */
+    session_tag?: string;
 }
 export declare enum LogEventTypes {
     FEATURE = "feature",
@@ -38,7 +48,12 @@ export declare enum LogEventTypes {
     MESSAGEBROKER = "message_broker",
     QUOTA = "quota",
     FALLBACK = "fallback",
-    DB_MIGRATION = "database_migration"
+    DB_MIGRATION = "database_migration",
+    WORKFLOW = "workflow",
+    WORKFLOW_STEP = "workflow_step",
+    DATABASE = "database",
+    GRAPH = "graph",
+    SESSION = "session"
 }
 export declare enum LogEventStatus {
     SUCCESS = "success",

package/dist/logs/logs.types.js

@@ -20,6 +20,11 @@ var LogEventTypes;
     LogEventTypes["QUOTA"] = "quota";
     LogEventTypes["FALLBACK"] = "fallback";
     LogEventTypes["DB_MIGRATION"] = "database_migration";
+    LogEventTypes["WORKFLOW"] = "workflow";
+    LogEventTypes["WORKFLOW_STEP"] = "workflow_step";
+    LogEventTypes["DATABASE"] = "database";
+    LogEventTypes["GRAPH"] = "graph";
+    LogEventTypes["SESSION"] = "session";
 })(LogEventTypes || (exports.LogEventTypes = LogEventTypes = {}));
 var LogEventStatus;
 (function (LogEventStatus) {

package/dist/logs/logs.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"logs.types.js","sourceRoot":"","sources":["../../src/logs/logs.types.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AA+BH,IAAY,aAaX;AAbD,WAAY,aAAa;IACvB,oCAAmB,CAAA;IACnB,gDAA+B,CAAA;IAC/B,+CAA8B,CAAA;IAC9B,mCAAkB,CAAA;IAClB,wCAAuB,CAAA;IACvB,oCAAmB,CAAA;IACnB,oCAAmB,CAAA;IACnB,6BAAY,CAAA;IACZ,iDAAgC,CAAA;IAChC,gCAAe,CAAA;IACf,sCAAqB,CAAA;IACrB,oDAAmC,CAAA;AACrC,CAAC,EAbW,aAAa,6BAAb,aAAa,QAaxB;AAED,IAAY,cAKX;AALD,WAAY,cAAc;IACxB,qCAAmB,CAAA;IACnB,+BAAa,CAAA;IACb,qCAAmB,CAAA;IACnB,2CAAyB,CAAA;AAC3B,CAAC,EALW,cAAc,8BAAd,cAAc,QAKzB"}
+{"version":3,"file":"logs.types.js","sourceRoot":"","sources":["../../src/logs/logs.types.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAyCH,IAAY,aAkBX;AAlBD,WAAY,aAAa;IACvB,oCAAmB,CAAA;IACnB,gDAA+B,CAAA;IAC/B,+CAA8B,CAAA;IAC9B,mCAAkB,CAAA;IAClB,wCAAuB,CAAA;IACvB,oCAAmB,CAAA;IACnB,oCAAmB,CAAA;IACnB,6BAAY,CAAA;IACZ,iDAAgC,CAAA;IAChC,gCAAe,CAAA;IACf,sCAAqB,CAAA;IACrB,oDAAmC,CAAA;IACnC,sCAAqB,CAAA;IACrB,gDAA+B,CAAA;IAC/B,sCAAqB,CAAA;IACrB,gCAAe,CAAA;IACf,oCAAmB,CAAA;AACrB,CAAC,EAlBW,aAAa,6BAAb,aAAa,QAkBxB;AAED,IAAY,cAKX;AALD,WAAY,cAAc;IACxB,qCAAmB,CAAA;IACnB,+BAAa,CAAA;IACb,qCAAmB,CAAA;IACnB,2CAAyB,CAAA;AAC3B,CAAC,EALW,cAAc,8BAAd,cAAc,QAKzB"}

package/dist/models/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Models Module
+ *
+ * Export all model-related types and services
+ */
+export { ModelService, IModelServiceConfig, ICreateModelInput, IUpdateModelInput, IFetchModelInput, IFetchAllModelsInput, IDeleteModelInput, } from './models.service';

package/dist/models/index.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Models Module
+ *
+ * Export all model-related types and services
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelService = void 0;
+var models_service_1 = require("./models.service");
+Object.defineProperty(exports, "ModelService", { enumerable: true, get: function () { return models_service_1.ModelService; } });
+//# sourceMappingURL=index.js.map

package/dist/models/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,mDAQ0B;AAPxB,8GAAA,YAAY,OAAA"}