@ductape/sdk 0.0.4-v51 → 0.0.4-v52

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

@@ -1,5 +1,6 @@
 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';
@@ -9,10 +10,8 @@ export interface IProcessorInputGeneric {
     tag: string;
 }
 export interface IProcessorInputSessionGeneric extends IProcessorInputGeneric {
-    session?: {
-        tag: string;
-        token: string;
-    };
+    /** Session token in format: session_tag:jwt_token */
+    session?: string;
     cache?: string;
 }
 export interface IProcessorInput extends IProcessorInputSessionGeneric {
@@ -147,6 +146,13 @@ 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;
@@ -183,7 +189,6 @@ export interface IProductMessageBrokerTopic {
     name: string;
     tag: string;
     description?: string;
-    idempotent: boolean;
     queueUrls?: [{
         env_slug: string;
         url: string;
@@ -217,18 +222,50 @@ 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;
+    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?: {
-        tag: string;
-        token: string;
-    };
+    /** Session token in format: session_tag:jwt_token */
+    session?: string;
 }
 export interface IJobProcessorInput {
     env: string;
@@ -238,10 +275,8 @@ export interface IJobProcessorInput {
     retries: number;
     input: IActionRequest | INotificationRequest | IDbActionRequest | IFunctionRequest | IStorageRequest | Record<string, unknown> | IPublishRequest;
     start_at: number;
-    session?: {
-        tag: string;
-        token: string;
-    };
+    /** Session token in format: session_tag:jwt_token */
+    session?: string;
     repeat?: IJobRepeatOptions;
 }
 interface IJobRepeatOptions {
@@ -261,10 +296,8 @@ export interface IStorageProcessorInput {
     input: IStorageRequest;
     event: string;
     retries?: number;
-    session?: {
-        tag: string;
-        token: string;
-    };
+    /** Session token in format: session_tag:jwt_token */
+    session?: string;
 }
 export interface IFunctionProcessorInput {
     env: string;
@@ -286,17 +319,15 @@ export interface IMessageBrokerPublishInput {
     event: string;
     cache?: string;
     product: string;
-    message: Record<string, unknown>;
-    session?: {
-        tag: string;
-        token: string;
-    };
+    input: IPublishRequest;
+    /** Session token in format: session_tag:jwt_token */
+    session?: string;
 }
 export interface IMessageBrokerSubscribeInput {
     env: string;
     event: string;
     product: string;
-    callback: (message: object) => Promise<void>;
+    input: ISubscribeRequest;
 }
 export interface IDBActionProcessorInput {
     env: string;
@@ -305,10 +336,8 @@ export interface IDBActionProcessorInput {
     input: IDbActionRequest;
     event: string;
     retries?: number;
-    session?: {
-        tag: string;
-        token: string;
-    };
+    /** Session token in format: session_tag:jwt_token */
+    session?: string;
 }
 export interface INotificationProcessorInput {
     env: string;
@@ -317,10 +346,8 @@ export interface INotificationProcessorInput {
     event: string;
     input: INotificationRequest;
     retries?: number;
-    session?: {
-        tag: string;
-        token: string;
-    };
+    /** Session token in format: session_tag:jwt_token */
+    session?: string;
 }
 export interface IWebhooks {
     uuid: string;
@@ -353,4 +380,139 @@ export interface IFileURLPayload {
     __v?: number;
     _id?: string;
 }
-export {};
+/**
+ * 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;
+    event: string;
+    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":";;;AAmLA,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":";;;AAoLA,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"}