@ductape/sdk 0.0.4 → 0.0.6

package/dist/types/processor.types.d.ts

@@ -1,25 +1,45 @@
 import { LogEventStatus, LogEventTypes } from '../logs/logs.types';
 import { AWSSQSConfig, GooglePubSubConfig, IActionRequest, IDbActionRequest, IDependencyMatrix, IFeatureEvent, IFeatureSequence, IFunctionRequest, INotificationRequest, IRequest, IStorageRequest, KafkaConfig, MessageBrokerTypes, RabbitMQConfig, RedisConfig } from './productsBuilder.types';
+export { IActionRequest, INotificationRequest, IDbActionRequest, IStorageRequest, IFunctionRequest };
 import { HttpMethods, Notifiers } from './enums';
 import ObjectId from 'bson-objectid';
 import { IParsedSample } from './inputs.types';
-export interface IProcessorInput {
+export interface IProcessorInputGeneric {
     product: string;
     env: string;
-    input: Record<string, unknown>;
     tag: string;
 }
+export interface IProcessorInputSessionGeneric extends IProcessorInputGeneric {
+    /** Session token in format: session_tag:jwt_token */
+    session?: string;
+    cache?: string;
+}
+export interface IProcessorInput extends IProcessorInputSessionGeneric {
+    input: Record<string, unknown>;
+}
 export interface IRefreshTokenReq {
     product_tag: string;
     env: string;
     refreshToken: string;
+    identifier: string;
+    start_at: number;
+    end_at: number;
+    session_tag: string;
+    data: string;
+    session_id: string;
 }
-export interface ISessionInput {
-    product: string;
-    env: string;
-    tag: string;
+export interface ISessionInput extends IProcessorInputGeneric {
     data: Record<string, unknown>;
 }
+export interface ISessionPayload extends IProcessorInputGeneric {
+    token: string;
+}
+export interface ISessionRefreshPayload extends IProcessorInputGeneric {
+    refreshToken: string;
+}
+export interface ISession extends IProcessorInputGeneric {
+    token: string;
+}
 export interface ISessionOutput {
     token: string;
     refreshToken: string;
@@ -50,15 +70,30 @@ export interface IProcessingWaiting extends IProcessingSuccess {
 }
 export interface IProcessorResult {
     status: LogEventStatus;
+    /** Execution window start time (Unix ms). Required for list/timeline and Gantt. */
     start: number;
+    /** For workflow run: 'workflow'. For step results: must be 'workflow_step'. */
     component: LogEventTypes;
+    /** Execution window end time (Unix ms). Required for duration and timeline. */
     end: number;
+    retryable: boolean;
     result: IProcessingOutput;
     env: string;
-    feature_id: string;
+    /** For workflows this is the workflow execution id (workflow_id); for features, the feature id */
+    feature_id?: string;
     product_id: string;
     process_id: string;
     input: IProcessorInput;
+    workflow_id?: string;
+    workflow_tag?: string;
+    product_tag?: string;
+    workspace_id?: string;
+    /** Step-level fields when component is workflow_step (per-step success/failure log) */
+    step_tag?: string;
+    /** Step kind when component is workflow_step: action, notification, storage, produce, database_action, graph, vector, quota, fallback, child_workflow, sleep, wait_for_signal, checkpoint, feature */
+    step_type?: string;
+    step_error?: string;
+    step_duration_ms?: number;
 }
 export interface INotificationInput {
     title: {
@@ -101,18 +136,63 @@ export interface ICallbackHandler {
     method: HttpMethods;
     auth?: IActionRequest;
 }
+/**
+ * @deprecated Use IEmailHandler from './notifications/types/notifications.types' instead
+ * This interface is kept for backward compatibility but only supports SMTP.
+ * For multi-provider support (SMTP, Mailgun, SendGrid, Postmark, Brevo), use the IEmailHandler from notifications.types.ts
+ */
+/**
+ * Email handler configuration - supports multiple providers
+ * @deprecated This interface is kept for backward compatibility.
+ * For new code, use IEmailHandler from './notifications/types/notifications.types'
+ */
 export interface IEmailHandler {
-    host: string;
-    port: string;
-    sender_email: string;
-    auth: {
+    host?: string;
+    port?: string;
+    sender_email?: string;
+    auth?: {
         user: string;
         pass: string;
     };
-    secure: boolean;
+    secure?: boolean;
     tls?: {
         rejectUnauthorized: boolean;
     };
+    provider: EmailProvider;
+    smtp?: {
+        host: string;
+        port: string;
+        sender_email: string;
+        auth: {
+            user: string;
+            pass: string;
+        };
+        secure: boolean;
+        tls?: {
+            rejectUnauthorized: boolean;
+        };
+    };
+    mailgun?: {
+        apiKey: string;
+        domain: string;
+        sender_email: string;
+        region?: 'us' | 'eu';
+        baseUrl?: string;
+    };
+    sendgrid?: {
+        apiKey: string;
+        sender_email: string;
+    };
+    postmark?: {
+        serverToken: string;
+        sender_email: string;
+        messageStream?: string;
+    };
+    brevo?: {
+        apiKey: string;
+        sender_email: string;
+        sender_name?: string;
+    };
 }
 export interface INotificationsHandler {
     type: Notifiers;
@@ -125,10 +205,18 @@ export declare enum SmsProvider {
     PLIVO = "plivo",
     OTHER = "other"
 }
+export declare enum EmailProvider {
+    SMTP = "smtp",
+    MAILGUN = "mailgun",
+    SENDGRID = "sendgrid",
+    POSTMARK = "postmark",
+    BREVO = "brevo"
+}
 export interface ISmsHandler {
     provider: SmsProvider;
     accountSid?: string;
     authToken?: string;
+    apiSecret?: string;
     apiKey?: string;
     sender: string;
 }
@@ -155,6 +243,8 @@ export interface IProductMessageBroker {
     description: string;
     envs: Array<IMessageBrokerEnvs>;
     topics: Array<IProductMessageBrokerTopic>;
+    producers?: Array<IMessageBrokerProducer>;
+    consumers?: Array<IMessageBrokerConsumer>;
 }
 export interface IProductMessageBrokerTopic {
     name: string;
@@ -166,6 +256,23 @@ export interface IProductMessageBrokerTopic {
     }];
     sample: Record<string, unknown>;
     data?: IParsedSample[];
+    idempotent?: boolean;
+}
+export interface IMessageBrokerProducer {
+    _id?: ObjectId;
+    tag: string;
+    topic: string;
+    description?: string;
+    created_at?: Date;
+    updated_at?: Date;
+}
+export interface IMessageBrokerConsumer {
+    _id?: ObjectId;
+    tag: string;
+    topic: string;
+    description?: string;
+    created_at?: Date;
+    updated_at?: Date;
 }
 export interface IMessageBrokerEnvs {
     slug: string;
@@ -193,23 +300,71 @@ export interface INotificationData {
     notifications: Array<IParsedSample>;
     email: Array<IParsedSample>;
 }
+/**
+ * Flat input format for simplified action execution.
+ * Keys are automatically resolved to body, params, query, or headers
+ * based on the action's schema definition.
+ *
+ * For conflicting keys (same key in multiple locations), use prefix syntax:
+ * - 'body:id' -> goes to body.id
+ * - 'params:id' -> goes to params.id
+ * - 'query:id' -> goes to query.id
+ * - 'headers:id' -> goes to headers.id
+ *
+ * @example
+ * ```ts
+ * // Flat input - auto-resolved from schema
+ * const input: IFlatInput = {
+ *   amount: 1000,           // auto-resolves to body.amount
+ *   currency: 'usd',        // auto-resolves to body.currency
+ *   'params:id': 'user_123' // explicit: goes to params.id
+ * };
+ * ```
+ */
+export type IFlatInput = Record<string, unknown>;
+/**
+ * Action input can be either structured (IActionRequest) or flat (IFlatInput)
+ * The SDK will automatically resolve flat inputs to structured format
+ */
+export type IActionInputType = IActionRequest | IFlatInput;
 export interface IActionProcessorInput {
     env: string;
-    product: string;
-    app?: string;
+    product?: string;
+    app: string;
     cache?: string;
-    input: IActionRequest;
-    event: string;
+    /**
+     * Input can be either:
+     * - Structured: { body: {...}, params: {...}, query: {...}, headers: {...} }
+     * - Flat: { key: value, 'prefix:key': value }
+     *
+     * Flat inputs are automatically resolved based on action schema.
+     */
+    input: IActionInputType;
+    action: string;
     retries?: number;
+    /** Session token in format: session_tag:jwt_token */
+    session?: string;
+    /** When set, processAction skips its bootstrap API call (e.g. workflow batch prefetch). */
+    preloadedBootstrap?: unknown;
 }
 export interface IJobProcessorInput {
     env: string;
     product: string;
-    app?: string;
+    event: string;
     cache?: string;
+    retries: number;
     input: IActionRequest | INotificationRequest | IDbActionRequest | IFunctionRequest | IStorageRequest | Record<string, unknown> | IPublishRequest;
-    event: string;
     start_at: number;
+    /** Session token in format: session_tag:jwt_token */
+    session?: string;
+    repeat?: IJobRepeatOptions;
+}
+interface IJobRepeatOptions {
+    cron?: string;
+    every?: number;
+    limit?: number;
+    endDate?: number | string;
+    tz?: string;
 }
 export interface IFileReadResult extends IStorageRequest {
 }
@@ -221,6 +376,10 @@ export interface IStorageProcessorInput {
     input: IStorageRequest;
     event: string;
     retries?: number;
+    /** Session token in format: session_tag:jwt_token */
+    session?: string;
+    /** When set, processStorage skips its bootstrap API call (e.g. workflow batch prefetch). */
+    preloadedBootstrap?: unknown;
 }
 export interface IFunctionProcessorInput {
     env: string;
@@ -243,6 +402,8 @@ export interface IMessageBrokerPublishInput {
     cache?: string;
     product: string;
     input: IPublishRequest;
+    /** Session token in format: session_tag:jwt_token */
+    session?: string;
 }
 export interface IMessageBrokerSubscribeInput {
     env: string;
@@ -257,6 +418,8 @@ export interface IDBActionProcessorInput {
     input: IDbActionRequest;
     event: string;
     retries?: number;
+    /** Session token in format: session_tag:jwt_token */
+    session?: string;
 }
 export interface INotificationProcessorInput {
     env: string;
@@ -265,6 +428,10 @@ export interface INotificationProcessorInput {
     event: string;
     input: INotificationRequest;
     retries?: number;
+    /** Session token in format: session_tag:jwt_token */
+    session?: string;
+    /** When set, processNotification skips its bootstrap API call (e.g. workflow batch prefetch). */
+    preloadedBootstrap?: unknown;
 }
 export interface IWebhooks {
     uuid: string;
@@ -290,7 +457,146 @@ export interface IFileURLPayload {
     type: string;
     product: string;
     provider: string;
+    process_id: string;
     event: string;
     env: string;
     size: number;
+    __v?: number;
+    _id?: string;
+}
+/**
+ * Schedule options for dispatching operations as jobs
+ */
+export interface IDispatchSchedule {
+    /** Start time as Unix timestamp (ms) or ISO date string */
+    start_at?: number | string;
+    /** Cron expression for recurring jobs (e.g., '0 0 * * *' for daily at midnight) */
+    cron?: string;
+    /** Interval in milliseconds for recurring jobs */
+    every?: number;
+    /** Maximum number of times to run (for recurring jobs) */
+    limit?: number;
+    /** End date as Unix timestamp (ms) or ISO date string */
+    endDate?: number | string;
+    /** Timezone for cron expressions (e.g., 'America/New_York') */
+    tz?: string;
+}
+/**
+ * Base dispatch input extending the original processor input with scheduling
+ */
+export interface IDispatchOptions {
+    /** Number of retries on failure */
+    retries?: number;
+    /** Schedule configuration */
+    schedule?: IDispatchSchedule;
+    /** Session token in format: session_tag:jwt_token */
+    session?: string;
+    /** Cache tag */
+    cache?: string;
+}
+/**
+ * Dispatch input for actions - schedules an action to run as a job
+ */
+export interface IActionDispatchInput extends IDispatchOptions {
+    env: string;
+    product: string;
+    app: string;
+    event: string;
+    input: IActionRequest;
+}
+/**
+ * Dispatch input for database actions - schedules a DB action to run as a job
+ */
+export interface IDBActionDispatchInput extends IDispatchOptions {
+    env: string;
+    product: string;
+    database: string;
+    event: string;
+    input: IDbActionRequest;
+}
+/**
+ * Dispatch input for graph actions - schedules a graph action to run as a job
+ */
+export interface IGraphActionDispatchInput extends IDispatchOptions {
+    env: string;
+    product: string;
+    graph: string;
+    event: string;
+    input: Record<string, unknown>;
+}
+/**
+ * Dispatch input for database operations - schedules a DB operation to run as a job
+ */
+export interface IDBOperationDispatchInput extends IDispatchOptions {
+    env: string;
+    product: string;
+    database: string;
+    /** Operation type: createOne, findMany, updateOne, deleteMany, etc. */
+    operation: string;
+    input: Record<string, unknown>;
+}
+/**
+ * Dispatch input for graph operations - schedules a graph operation to run as a job
+ */
+export interface IGraphOperationDispatchInput extends IDispatchOptions {
+    env: string;
+    product: string;
+    graph: string;
+    /** Operation type: createNode, createRelationship, traverse, query, etc. */
+    operation: string;
+    input: Record<string, unknown>;
+}
+/**
+ * Dispatch input for notifications - schedules a notification to be sent as a job
+ */
+export interface INotificationDispatchInput extends IDispatchOptions {
+    env: string;
+    product: string;
+    notification: string;
+    event: string;
+    input: INotificationRequest;
+}
+/**
+ * Dispatch input for storage operations - schedules a storage operation as a job
+ */
+export interface IStorageDispatchInput extends IDispatchOptions {
+    env: string;
+    product: string;
+    storage: string;
+    operation: 'upload' | 'download' | 'delete' | 'list' | 'getMetadata';
+    input: IStorageRequest;
+}
+/**
+ * Dispatch input for message broker publish - schedules a publish as a job
+ */
+export interface IPublishDispatchInput extends IDispatchOptions {
+    env: string;
+    product: string;
+    broker: string;
+    event: string;
+    input: IPublishRequest;
+}
+/**
+ * Dispatch input for features - schedules a feature to run as a job
+ */
+export interface IFeatureDispatchInput extends IDispatchOptions {
+    env: string;
+    product: string;
+    tag: string;
+    input: Record<string, unknown>;
+}
+/**
+ * Result returned when dispatching a job
+ */
+export interface IDispatchResult {
+    /** Unique job ID for tracking */
+    job_id: string;
+    /** Job status */
+    status: 'scheduled' | '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;
 }

package/dist/types/processor.types.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SmsProvider = void 0;
+exports.EmailProvider = exports.SmsProvider = void 0;
 var SmsProvider;
 (function (SmsProvider) {
     SmsProvider["TWILIO"] = "twilio";
@@ -8,4 +8,12 @@ var SmsProvider;
     SmsProvider["PLIVO"] = "plivo";
     SmsProvider["OTHER"] = "other";
 })(SmsProvider || (exports.SmsProvider = SmsProvider = {}));
+var EmailProvider;
+(function (EmailProvider) {
+    EmailProvider["SMTP"] = "smtp";
+    EmailProvider["MAILGUN"] = "mailgun";
+    EmailProvider["SENDGRID"] = "sendgrid";
+    EmailProvider["POSTMARK"] = "postmark";
+    EmailProvider["BREVO"] = "brevo";
+})(EmailProvider || (exports.EmailProvider = EmailProvider = {}));
 //# sourceMappingURL=processor.types.js.map

package/dist/types/processor.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"processor.types.js","sourceRoot":"","sources":["../../src/types/processor.types.ts"],"names":[],"mappings":";;;AAuJA,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,gCAAiB,CAAA;IACjB,8BAAe,CAAA;IACf,8BAAe,CAAA;IACf,8BAAe,CAAA;AACjB,CAAC,EALW,WAAW,2BAAX,WAAW,QAKtB"}
+{"version":3,"file":"processor.types.js","sourceRoot":"","sources":["../../src/types/processor.types.ts"],"names":[],"mappings":";;;AAiPA,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,gCAAiB,CAAA;IACjB,8BAAe,CAAA;IACf,8BAAe,CAAA;IACf,8BAAe,CAAA;AACjB,CAAC,EALW,WAAW,2BAAX,WAAW,QAKtB;AAED,IAAY,aAMX;AAND,WAAY,aAAa;IACvB,8BAAa,CAAA;IACb,oCAAmB,CAAA;IACnB,sCAAqB,CAAA;IACrB,sCAAqB,CAAA;IACrB,gCAAe,CAAA;AACjB,CAAC,EANW,aAAa,6BAAb,aAAa,QAMxB"}