@slflows/sdk 0.0.7 → 0.1.0

package/dist/v1/index.d.ts

@@ -1,448 +1,50 @@
 /**
- * Main schema interface for defining a Flows app.
- *
- * An app consists of blocks (entities) that can process events, manage state,
- * expose HTTP endpoints, and handle scheduled tasks. Apps are the fundamental
- * unit of deployment in Flows.
- *
- * @example
- * ```typescript
- * export default defineApp({
- *   name: "Data Processor",
- *   blocks: {
- *     processor: {
- *       name: "Process Data",
- *       description: "Transforms incoming data",
- *       inputs: {
- *         data: {
- *           name: "Input Data",
- *           onEvent: async (input) => {
- *             // Process the event
- *             await events.emit(processedData);
- *           }
- *         }
- *       },
- *       outputs: {
- *         processed: {
- *           name: "Processed Data",
- *           default: true
- *         }
- *       }
- *     }
- *   }
- * });
- * ```
+ * Key-value pair for storage operations.
+ * Supports TTL (time-to-live) and optimistic locking for safe concurrent access.
  */
-interface AppSchema {
-    /** Display name for the app */
-    name?: string;
-    /**
-     * Instructions shown to users when installing the app.
-     * Supports Markdown formatting.
-     */
-    installationInstructions?: string;
-    /**
-     * Configuration fields for the app. These are set during installation
-     * and available to all blocks within the app.
-     */
-    config?: Record<string, AppConfigField>;
-    /**
-     * Signals exported by the app.
-     * These are available to all blocks within the app.
-     */
-    signals?: Record<string, AppSignal>;
-    /**
-     * Lifecycle hook called when the app needs to synchronize its state.
-     * Use this to provision resources, validate configuration, or perform setup.
-     */
-    onSync?: (input: AppInput) => Promise<AppLifecycleCallbackOutput>;
-    /**
-     * Lifecycle hook called when the app is being drained (shut down).
-     * Use this to clean up resources, save state, or perform teardown.
-     */
-    onDrain?: (input: AppInput) => Promise<AppLifecycleCallbackOutput>;
-    /** Custom status description shown when the app is in draft mode */
-    draftCustomStatusDescription?: string;
-    /**
-     * Handler for internal messages sent to the app from blocks.
-     * Used for app-level coordination and communication.
-     */
-    onInternalMessage?: (input: AppOnInternalMessageInput) => Promise<void>;
-    /**
-     * Map of block definitions. Each block becomes an entity that can be
-     * placed on the flow canvas. Key is the block type ID.
-     */
-    blocks: Record<string, AppBlock>;
-    /** HTTP server configuration for app-level endpoints */
-    http?: AppHTTPComponent;
-    /** UI component configuration for custom app interfaces */
-    ui?: AppUIComponent;
-    /**
-     * Declarative schedules that trigger at app level.
-     * Use for periodic maintenance, data synchronization, etc.
-     */
-    schedules?: Record<string, AppSchedule>;
+interface KVPair {
+    /** The storage key */
+    key: string;
     /**
-     * Handler for imperative timers set by the app.
-     * Called when a timer created with timers.set() expires.
+     * The stored value. May be undefined (key doesn't exist),
+     * null (explicitly set to null), or any other value.
      */
-    onTimer?: (input: AppOnTimerInput) => Promise<void>;
-}
-interface AppUIComponent {
-    onRequest: (input: AppOnUIRequestInput) => Promise<any>;
-}
-type SimpleType = "string" | "number" | "boolean" | "any";
-type SimpleTypeArray = [SimpleType];
-interface JsonSchema {
-    type?: string;
-    properties?: Record<string, JsonSchema>;
-    items?: JsonSchema;
-    required?: string[];
-    enum?: (string | number)[];
-    anyOf?: JsonSchema[];
-    oneOf?: JsonSchema[];
-    description?: string;
-    additionalProperties?: boolean | {
-        type: "string" | "number" | "boolean" | "object" | "array";
-    };
-}
-type Type = SimpleType | SimpleTypeArray | JsonSchema;
-interface AppConfigField {
-    name: string;
-    description?: string;
-    type: Type;
-    fixed?: boolean;
-    required: boolean;
-    default?: unknown;
-    sensitive?: boolean;
-}
-interface AppSignal {
-    name: string;
-    description: string;
-    sensitive?: boolean;
-}
-interface AppHTTPComponent {
-    onRequest: (input: AppOnHTTPRequestInput) => Promise<void>;
-}
-type ScheduleDefinition = {
-    type: "cron";
-    cron: {
-        expression: string;
-        location: string;
-    };
-} | {
-    type: "frequency";
-    frequency: {
-        interval: number;
-        unit?: "seconds" | "minutes" | "hours";
+    value?: any;
+    /** Unix timestamp of when this key was last updated */
+    updatedAt?: number;
+    /** Time-to-live in seconds. If set, key will expire after this duration */
+    ttl?: number;
+    /** Optional lock information for atomic operations */
+    lock?: {
+        /** Unique lock identifier */
+        id: string;
+        /** Lock timeout in seconds */
+        timeout?: number;
     };
-};
-interface AppSchedule {
-    description?: string;
-    customizable?: boolean;
-    definition: ScheduleDefinition;
-    onTrigger: (input: AppOnTriggerInput) => Promise<void>;
-}
-interface AppBlock {
-    name?: string;
-    description?: string;
-    category?: string;
-    config?: Record<string, AppBlockConfigField>;
-    onInternalMessage?: (input: EntityOnInternalMessageInput) => Promise<void>;
-    inputs?: Record<string, AppBlockComponentInput>;
-    outputs?: Record<string, AppBlockComponentOutput>;
-    signals?: Record<string, AppBlockSignal>;
-    onSync?: (input: EntityInput) => EntityLifecycleCallbackOutput | Promise<EntityLifecycleCallbackOutput>;
-    onDrain?: (input: EntityInput) => EntityLifecycleCallbackOutput | Promise<EntityLifecycleCallbackOutput>;
-    draftCustomStatusDescription?: string;
-    http?: AppBlockHTTPComponent;
-    ui?: AppBlockUIComponent;
-    schedules?: Record<string, AppBlockSchedule>;
-    onTimer?: (input: EntityOnTimerInput) => Promise<void>;
-}
-interface AppBlockConfigField {
-    name: string;
-    description?: string;
-    type: Type;
-    fixed?: boolean;
-    required: boolean;
-    default?: unknown;
-    fieldKey?: string;
-    sensitive?: boolean;
-}
-interface AppBlockComponentInput {
-    name?: string;
-    description?: string;
-    config?: Record<string, AppBlockConfigField>;
-    onEvent: (input: EventInput) => Promise<void>;
-}
-interface AppBlockComponentOutput {
-    name?: string;
-    description?: string;
-    default?: boolean;
-    /**
-     * Defines which inputs can provide parent events for this output.
-     * Used for type inference - determines what fields and types will be
-     * available in the output event based on parent input types.
-     * Should be a list of input keys that can be used as parents.
-     */
-    possiblePrimaryParents?: string[];
-    secondary?: boolean;
-    type?: Type;
-}
-interface AppBlockHTTPComponent {
-    onRequest: (input: EntityOnHTTPRequestInput) => Promise<void>;
-}
-interface AppBlockUIComponent {
-    onRequest: (input: EntityOnUIRequestInput) => Promise<any>;
-    views?: EntityView[] | null;
-}
-interface AppBlockSignal {
-    name: string;
-    description: string;
-    sensitive?: boolean;
-}
-interface AppBlockSchedule {
-    description?: string;
-    customizable?: boolean;
-    definition: ScheduleDefinition;
-    onTrigger: (input: EntityOnTriggerInput) => Promise<void>;
 }
-interface EntityView {
-    id: string;
-    label: string;
-    type: EntityViewType;
+/**
+ * Input parameters for listing key-value pairs with optional pagination.
+ * Used with kv.app.list() and kv.block.list() to retrieve multiple keys.
+ */
+interface KVListInput {
+    /** Prefix to filter keys (e.g., "user:" to get all user-related keys) */
+    keyPrefix: string;
+    /** Starting key for pagination (from previous nextStartingKey) */
+    startingKey?: string;
 }
-type EntityViewType = "default" | "fullScreen" | "regular";
 /**
- * Input context provided to app-level handlers.
- * Contains app configuration and runtime information.
+ * Output from key-value list operations with pagination support.
+ * Contains the retrieved key-value pairs and pagination information.
  */
-interface AppInput {
-    /** App installation context and configuration */
-    app: AppContext;
+interface KVListOutput {
+    /** Array of key-value pairs matching the prefix */
+    pairs: Array<KVPair>;
+    /** Next starting key for pagination (undefined if no more results) */
+    nextStartingKey?: string;
 }
 /**
- * App runtime context containing configuration and endpoints.
- * Available in all app-level handlers (onSync, onDrain, onInternalMessage, etc.).
- */
-interface AppContext {
-    /** App configuration values set during installation */
-    config: Record<string, any>;
-    /** Current status of the app installation */
-    status: "draft" | "in_progress" | "ready" | "failed" | "draining" | "draining_failed" | "drained";
-    /** HTTP endpoint information for this app */
-    http: AppHTTPEndpoint;
-    /** URL for managing this app installation */
-    installationUrl: string;
-    /** Signals exported by this app */
-    signals: Record<string, any>;
-}
-/**
- * HTTP endpoint information for app-level HTTP handlers.
- */
-interface AppHTTPEndpoint {
-    /** Base URL for this app's HTTP endpoints */
-    url: string;
-}
-/**
- * Input context provided to block-level handlers.
- * Extends AppInput with block-specific context.
- */
-interface EntityInput extends AppInput {
-    /** Block (entity) instance context and configuration */
-    block: EntityContext;
-}
-/**
- * Block (entity) runtime context containing configuration and state.
- * Available in all block-level handlers (onEvent, onSync, onDrain, etc.).
- */
-interface EntityContext {
-    /** Unique identifier for this block instance */
-    id: string;
-    /** Display name of this block instance */
-    name: string;
-    /** Description of this block instance */
-    description: string;
-    /** Block configuration values set in the flow */
-    config: Record<string, any>;
-    /** Lifecycle state information (null if block has no lifecycle) */
-    lifecycle: EntityLifecycleComponent | null;
-    /** HTTP endpoint information (null if block has no HTTP handler) */
-    http: EntityHTTPEndpoint | null;
-}
-interface EntityLifecycleComponent {
-    status: EntityLifecycleStatus;
-    signals: Record<string, any> | null;
-}
-type EntityLifecycleStatus = "draft" | "in_progress" | "ready" | "drifted" | "failed" | "draining" | "draining_failed" | "drained";
-interface EntityHTTPEndpoint {
-    url: string;
-}
-/**
- * Input context provided to event handlers (onEvent).
- * Extends EntityInput with event-specific information.
- */
-interface EventInput extends EntityInput {
-    /** Event data and metadata */
-    event: EventContext;
-}
-/**
- * Event context containing the event data and metadata.
- * Available in all onEvent handlers when processing incoming events.
- */
-interface EventContext {
-    /** Unique identifier for this event */
-    id: string;
-    /** Configuration values for the specific input that received this event */
-    inputConfig: Record<string, any>;
-    /**
-     * Echo information for request-response patterns.
-     * Present when this event was emitted with echo: true.
-     */
-    echo?: {
-        /** The event body that was echoed */
-        body: any;
-        /** The output key where the original event was emitted */
-        outputKey: string;
-    };
-}
-interface EntityLifecycleCallbackOutput {
-    signalUpdates?: Record<string, any>;
-    newStatus?: EntityLifecycleStatus;
-    customStatusDescription?: string | null;
-    nextScheduleDelay?: number;
-}
-interface AppLifecycleCallbackOutput {
-    signalUpdates?: Record<string, any>;
-    newStatus?: AppLifecycleStatus;
-    customStatusDescription?: string | null;
-    nextScheduleDelay?: number;
-}
-type AppLifecycleStatus = "draft" | "in_progress" | "ready" | "failed" | "draining" | "draining_failed" | "drained";
-interface AppOnCreateOutput {
-    ok?: {};
-    redirect?: {
-        url: string;
-        method: string;
-    };
-}
-interface AppOnInternalMessageInput extends AppInput {
-    message: {
-        publisherId: string;
-        body: any;
-    };
-}
-interface EntityOnInternalMessageInput extends EntityInput {
-    message: {
-        body: any;
-    };
-}
-interface AppOnTimerInput extends AppInput {
-    timer: {
-        id: string;
-        payload: any;
-        prompt?: {
-            id: string;
-            description?: string;
-        };
-    };
-}
-interface EntityOnTimerInput extends EntityInput {
-    timer: {
-        id: string;
-        payload: any;
-        pendingEvent?: {
-            id: string;
-            body?: any;
-            status?: string;
-        };
-    };
-}
-interface AppOnTriggerInput extends AppInput {
-    schedule: {
-        time: string;
-    };
-}
-interface EntityOnTriggerInput extends EntityInput {
-    schedule: {
-        time: string;
-    };
-}
-interface AppOnHTTPRequestInput extends AppInput {
-    request: HTTPRequest;
-}
-interface EntityOnHTTPRequestInput extends EntityInput {
-    request: HTTPRequest;
-}
-interface HTTPRequest {
-    requestId: string;
-    path: string;
-    method: string;
-    headers: Record<string, string>;
-    query: Record<string, string>;
-    params: Record<string, string>;
-    rawBody: string;
-    body: any;
-}
-interface AppOnUIRequestInput extends AppInput {
-    request: UIRequest;
-}
-interface EntityOnUIRequestInput extends EntityInput {
-    request: UIRequest;
-}
-interface UIRequest {
-    type: string;
-    payload?: any;
-}
-
-/**
- * Key-value pair for storage operations.
- * Supports TTL (time-to-live) and optimistic locking for safe concurrent access.
- */
-interface KVPair {
-    /** The storage key */
-    key: string;
-    /**
-     * The stored value. May be undefined (key doesn't exist),
-     * null (explicitly set to null), or any other value.
-     */
-    value?: any;
-    /** Unix timestamp of when this key was last updated */
-    updatedAt?: number;
-    /** Time-to-live in seconds. If set, key will expire after this duration */
-    ttl?: number;
-    /** Optional lock information for atomic operations */
-    lock?: {
-        /** Unique lock identifier */
-        id: string;
-        /** Lock timeout in seconds */
-        timeout?: number;
-    };
-}
-/**
- * Input parameters for listing key-value pairs with optional pagination.
- * Used with kv.app.list() and kv.block.list() to retrieve multiple keys.
- */
-interface KVListInput {
-    /** Prefix to filter keys (e.g., "user:" to get all user-related keys) */
-    keyPrefix: string;
-    /** Starting key for pagination (from previous nextStartingKey) */
-    startingKey?: string;
-}
-/**
- * Output from key-value list operations with pagination support.
- * Contains the retrieved key-value pairs and pagination information.
- */
-interface KVListOutput {
-    /** Array of key-value pairs matching the prefix */
-    pairs: Array<KVPair>;
-    /** Next starting key for pagination (undefined if no more results) */
-    nextStartingKey?: string;
-}
-/**
- * Input parameters for listing blocks within the same app installation.
- * Used to discover other blocks for coordination and messaging.
+ * Input parameters for listing blocks within the same app installation.
+ * Used to discover other blocks for coordination and messaging.
  */
 interface ListBlocksInput {
     /** Filter by specific block type IDs (omit to list all blocks) */
@@ -501,7 +103,7 @@ interface CreatePendingEventOptions {
     /** Optional predicted event payload */
     event?: Record<string, any>;
     /** Which output this will emit on (optional) */
-    outputId?: string;
+    outputKey?: string;
     /** Parent event (auto-populated in handlers) */
     parentEventId?: string;
     /** Additional parent event IDs for complex lineage */
@@ -517,7 +119,7 @@ interface UpdatePendingEventOptions {
     /** Updated event data (replaces previous event data) */
     event?: Record<string, any>;
     /** Updated output ID to emit on when completed */
-    outputId?: string;
+    outputKey?: string;
     /** Updated parent event ID for lineage tracking */
     parentEventId?: string;
     /** Updated additional parent event IDs */
@@ -581,7 +183,7 @@ declare const getInvocationMetadata: () => Promise<InvocationMetadata>;
  * await events.emit({ message: "Hello World" });
  *
  * // Emit to specific output
- * await events.emit(data, { outputId: "success" });
+ * await events.emit(data, { outputKey: "success" });
  *
  * // Create pending event for long operation
  * const pendingId = await events.createPending({
@@ -1017,13 +619,13 @@ declare const lifecycle: {
  * @example
  * ```typescript
  * // Set a timer for 30 seconds
- * const timerId = await timers.set(30, {
+ * const timerId = await timers.app.set(30, {
  *   inputPayload: { action: "retry" },
  *   description: "Retry failed operation"
  * });
  *
  * // Cancel the timer
- * await timers.unset(timerId);
+ * await timers.app.unset(timerId);
  * ```
  */
 declare const timers: {
@@ -1034,6 +636,22 @@ declare const timers: {
         description?: string;
     }) => Promise<string>;
     unset: (id: string) => Promise<void>;
+    block: {
+        set: (delaySeconds: number, options: {
+            inputPayload?: unknown;
+            pendingEventId?: string;
+            description?: string;
+        }) => Promise<string>;
+        unset: (id: string) => Promise<void>;
+    };
+    app: {
+        set: (delaySeconds: number, options: {
+            inputPayload?: unknown;
+            promptId?: string;
+            description?: string;
+        }) => Promise<string>;
+        unset: (id: string) => Promise<void>;
+    };
 };
 /**
  * UI service for managing custom block widgets.
@@ -1107,4 +725,401 @@ declare const ui: {
  */
 declare function defineApp(app: AppSchema): AppSchema;
 
+/**
+ * Main schema interface for defining a Flows app.
+ *
+ * An app consists of blocks (entities) that can process events, manage state,
+ * expose HTTP endpoints, and handle scheduled tasks. Apps are the fundamental
+ * unit of deployment in Flows.
+ *
+ * @example
+ * ```typescript
+ * export default defineApp({
+ *   name: "Data Processor",
+ *   blocks: {
+ *     processor: {
+ *       name: "Process Data",
+ *       description: "Transforms incoming data",
+ *       inputs: {
+ *         data: {
+ *           name: "Input Data",
+ *           onEvent: async (input) => {
+ *             // Process the event
+ *             await events.emit(processedData);
+ *           }
+ *         }
+ *       },
+ *       outputs: {
+ *         processed: {
+ *           name: "Processed Data",
+ *           default: true
+ *         }
+ *       }
+ *     }
+ *   }
+ * });
+ * ```
+ */
+interface AppSchema {
+    /** Display name for the app */
+    name?: string;
+    /**
+     * Instructions shown to users when installing the app.
+     * Supports Markdown formatting.
+     */
+    installationInstructions?: string;
+    /**
+     * Configuration fields for the app. These are set during installation
+     * and available to all blocks within the app.
+     */
+    config?: Record<string, AppConfigField>;
+    /**
+     * Signals exported by the app.
+     * These are available to all blocks within the app.
+     */
+    signals?: Record<string, AppSignal>;
+    /**
+     * Lifecycle hook called when the app needs to synchronize its state.
+     * Use this to provision resources, validate configuration, or perform setup.
+     */
+    onSync?: (input: AppInput) => Promise<AppLifecycleCallbackOutput>;
+    /**
+     * Lifecycle hook called when the app is being drained (shut down).
+     * Use this to clean up resources, save state, or perform teardown.
+     */
+    onDrain?: (input: AppInput) => Promise<AppLifecycleCallbackOutput>;
+    /** Custom status description shown when the app is in draft mode */
+    draftCustomStatusDescription?: string;
+    /**
+     * Handler for internal messages sent to the app from blocks.
+     * Used for app-level coordination and communication.
+     */
+    onInternalMessage?: (input: AppOnInternalMessageInput) => Promise<void>;
+    /**
+     * Map of block definitions. Each block becomes an entity that can be
+     * placed on the flow canvas. Key is the block type ID.
+     */
+    blocks: Record<string, AppBlock>;
+    /** HTTP server configuration for app-level endpoints */
+    http?: AppHTTPComponent;
+    /** UI component configuration for custom app interfaces */
+    ui?: AppUIComponent;
+    /**
+     * Declarative schedules that trigger at app level.
+     * Use for periodic maintenance, data synchronization, etc.
+     */
+    schedules?: Record<string, AppSchedule>;
+    /**
+     * Handler for imperative timers set by the app.
+     * Called when a timer created with timers.app.set() expires.
+     */
+    onTimer?: (input: AppOnTimerInput) => Promise<void>;
+}
+interface AppUIComponent {
+    onRequest: (input: AppOnUIRequestInput) => Promise<any>;
+}
+type SimpleType = "string" | "number" | "boolean" | "any";
+type SimpleTypeArray = [SimpleType];
+interface JsonSchema {
+    type?: string;
+    properties?: Record<string, JsonSchema>;
+    items?: JsonSchema;
+    required?: string[];
+    enum?: (string | number)[];
+    anyOf?: JsonSchema[];
+    oneOf?: JsonSchema[];
+    description?: string;
+    additionalProperties?: boolean | {
+        type: "string" | "number" | "boolean" | "object" | "array";
+    };
+}
+type Type = SimpleType | SimpleTypeArray | JsonSchema;
+interface AppConfigField {
+    name: string;
+    description?: string;
+    type: Type;
+    fixed?: boolean;
+    required: boolean;
+    default?: unknown;
+    sensitive?: boolean;
+}
+interface AppSignal {
+    name: string;
+    description: string;
+    sensitive?: boolean;
+}
+interface AppHTTPComponent {
+    onRequest: (input: AppOnHTTPRequestInput) => Promise<void>;
+}
+type ScheduleDefinition = {
+    type: "cron";
+    cron: {
+        expression: string;
+        location: string;
+    };
+} | {
+    type: "frequency";
+    frequency: {
+        interval: number;
+        unit?: "seconds" | "minutes" | "hours";
+    };
+};
+interface AppSchedule {
+    description?: string;
+    customizable?: boolean;
+    definition: ScheduleDefinition;
+    onTrigger: (input: AppOnTriggerInput) => Promise<void>;
+}
+interface AppBlock {
+    name?: string;
+    description?: string;
+    category?: string;
+    config?: Record<string, AppBlockConfigField>;
+    onInternalMessage?: (input: EntityOnInternalMessageInput) => Promise<void>;
+    inputs?: Record<string, AppBlockComponentInput>;
+    outputs?: Record<string, AppBlockComponentOutput>;
+    signals?: Record<string, AppBlockSignal>;
+    onSync?: (input: EntityInput) => EntityLifecycleCallbackOutput | Promise<EntityLifecycleCallbackOutput>;
+    onDrain?: (input: EntityInput) => EntityLifecycleCallbackOutput | Promise<EntityLifecycleCallbackOutput>;
+    draftCustomStatusDescription?: string;
+    http?: AppBlockHTTPComponent;
+    ui?: AppBlockUIComponent;
+    schedules?: Record<string, AppBlockSchedule>;
+    onTimer?: (input: EntityOnTimerInput) => Promise<void>;
+}
+interface AppBlockConfigField {
+    name: string;
+    description?: string;
+    type: Type;
+    fixed?: boolean;
+    required: boolean;
+    default?: unknown;
+    fieldKey?: string;
+    sensitive?: boolean;
+}
+interface AppBlockComponentInput {
+    name?: string;
+    description?: string;
+    config?: Record<string, AppBlockConfigField>;
+    onEvent: (input: EventInput) => Promise<void>;
+}
+interface AppBlockComponentOutput {
+    name?: string;
+    description?: string;
+    default?: boolean;
+    /**
+     * Defines which inputs can provide parent events for this output.
+     * Used for type inference - determines what fields and types will be
+     * available in the output event based on parent input types.
+     * Should be a list of input keys that can be used as parents.
+     */
+    possiblePrimaryParents?: string[];
+    secondary?: boolean;
+    type?: Type;
+}
+interface AppBlockHTTPComponent {
+    onRequest: (input: EntityOnHTTPRequestInput) => Promise<void>;
+}
+interface AppBlockUIComponent {
+    onRequest: (input: EntityOnUIRequestInput) => Promise<any>;
+    views?: EntityView[] | null;
+}
+interface AppBlockSignal {
+    name: string;
+    description: string;
+    sensitive?: boolean;
+}
+interface AppBlockSchedule {
+    description?: string;
+    customizable?: boolean;
+    definition: ScheduleDefinition;
+    onTrigger: (input: EntityOnTriggerInput) => Promise<void>;
+}
+interface EntityView {
+    id: string;
+    label: string;
+    type: EntityViewType;
+}
+type EntityViewType = "default" | "fullScreen" | "regular";
+/**
+ * Input context provided to app-level handlers.
+ * Contains app configuration and runtime information.
+ */
+interface AppInput {
+    /** App installation context and configuration */
+    app: AppContext;
+}
+/**
+ * App runtime context containing configuration and endpoints.
+ * Available in all app-level handlers (onSync, onDrain, onInternalMessage, etc.).
+ */
+interface AppContext {
+    /** App configuration values set during installation */
+    config: Record<string, any>;
+    /** Current status of the app installation */
+    status: "draft" | "in_progress" | "ready" | "failed" | "draining" | "draining_failed" | "drained";
+    /** HTTP endpoint information for this app */
+    http: AppHTTPEndpoint;
+    /** URL for managing this app installation */
+    installationUrl: string;
+    /** Signals exported by this app */
+    signals: Record<string, any>;
+}
+/**
+ * HTTP endpoint information for app-level HTTP handlers.
+ */
+interface AppHTTPEndpoint {
+    /** Base URL for this app's HTTP endpoints */
+    url: string;
+}
+/**
+ * Input context provided to block-level handlers.
+ * Extends AppInput with block-specific context.
+ */
+interface EntityInput extends AppInput {
+    /** Block (entity) instance context and configuration */
+    block: EntityContext;
+}
+/**
+ * Block (entity) runtime context containing configuration and state.
+ * Available in all block-level handlers (onEvent, onSync, onDrain, etc.).
+ */
+interface EntityContext {
+    /** Unique identifier for this block instance */
+    id: string;
+    /** Display name of this block instance */
+    name: string;
+    /** Description of this block instance */
+    description: string;
+    /** Block configuration values set in the flow */
+    config: Record<string, any>;
+    /** Lifecycle state information (null if block has no lifecycle) */
+    lifecycle: EntityLifecycleComponent | null;
+    /** HTTP endpoint information (null if block has no HTTP handler) */
+    http: EntityHTTPEndpoint | null;
+}
+interface EntityLifecycleComponent {
+    status: EntityLifecycleStatus;
+    signals: Record<string, any> | null;
+}
+type EntityLifecycleStatus = "draft" | "in_progress" | "ready" | "drifted" | "failed" | "draining" | "draining_failed" | "drained";
+interface EntityHTTPEndpoint {
+    url: string;
+}
+/**
+ * Input context provided to event handlers (onEvent).
+ * Extends EntityInput with event-specific information.
+ */
+interface EventInput extends EntityInput {
+    /** Event data and metadata */
+    event: EventContext;
+}
+/**
+ * Event context containing the event data and metadata.
+ * Available in all onEvent handlers when processing incoming events.
+ */
+interface EventContext {
+    /** Unique identifier for this event */
+    id: string;
+    /** Configuration values for the specific input that received this event */
+    inputConfig: Record<string, any>;
+    /**
+     * Echo information for request-response patterns.
+     * Present when this event was emitted with echo: true.
+     */
+    echo?: {
+        /** The event body that was echoed */
+        body: any;
+        /** The output key where the original event was emitted */
+        outputKey: string;
+    };
+}
+interface EntityLifecycleCallbackOutput {
+    signalUpdates?: Record<string, any>;
+    newStatus?: EntityLifecycleStatus;
+    customStatusDescription?: string | null;
+    nextScheduleDelay?: number;
+}
+interface AppLifecycleCallbackOutput {
+    signalUpdates?: Record<string, any>;
+    newStatus?: AppLifecycleStatus;
+    customStatusDescription?: string | null;
+    nextScheduleDelay?: number;
+}
+type AppLifecycleStatus = "draft" | "in_progress" | "ready" | "failed" | "draining" | "draining_failed" | "drained";
+interface AppOnCreateOutput {
+    ok?: {};
+    redirect?: {
+        url: string;
+        method: string;
+    };
+}
+interface AppOnInternalMessageInput extends AppInput {
+    message: {
+        body: any;
+    };
+}
+interface EntityOnInternalMessageInput extends EntityInput {
+    message: {
+        body: any;
+    };
+}
+interface AppOnTimerInput extends AppInput {
+    timer: {
+        id: string;
+        payload: any;
+        prompt?: {
+            id: string;
+            description?: string;
+        };
+    };
+}
+interface EntityOnTimerInput extends EntityInput {
+    timer: {
+        id: string;
+        payload: any;
+        pendingEvent?: {
+            id: string;
+            body?: any;
+            status?: string;
+        };
+    };
+}
+interface AppOnTriggerInput extends AppInput {
+    schedule: {
+        time: string;
+    };
+}
+interface EntityOnTriggerInput extends EntityInput {
+    schedule: {
+        time: string;
+    };
+}
+interface AppOnHTTPRequestInput extends AppInput {
+    request: HTTPRequest;
+}
+interface EntityOnHTTPRequestInput extends EntityInput {
+    request: HTTPRequest;
+}
+interface HTTPRequest {
+    requestId: string;
+    path: string;
+    method: string;
+    headers: Record<string, string>;
+    query: Record<string, string>;
+    params: Record<string, string>;
+    rawBody: string;
+    body: any;
+}
+interface AppOnUIRequestInput extends AppInput {
+    request: UIRequest;
+}
+interface EntityOnUIRequestInput extends EntityInput {
+    request: UIRequest;
+}
+interface UIRequest {
+    type: string;
+    payload?: any;
+}
+
 export { type AppBlock, type AppBlockComponentInput, type AppBlockComponentOutput, type AppBlockConfigField, type AppBlockHTTPComponent, type AppBlockSchedule, type AppBlockSignal, type AppBlockUIComponent, type AppConfigField, type AppContext, type AppHTTPComponent, type AppHTTPEndpoint, type AppInput, type AppLifecycleCallbackOutput, type AppLifecycleStatus, type AppOnCreateOutput, type AppOnHTTPRequestInput, type AppOnInternalMessageInput, type AppOnTimerInput, type AppOnTriggerInput, type AppOnUIRequestInput, type AppSchedule, type AppSchema, type AppSignal, type AppUIComponent, type EntityContext, type EntityHTTPEndpoint, type EntityInput, type EntityLifecycleCallbackOutput, type EntityLifecycleComponent, type EntityLifecycleStatus, type EntityOnHTTPRequestInput, type EntityOnInternalMessageInput, type EntityOnTimerInput, type EntityOnTriggerInput, type EntityOnUIRequestInput, type EntityView, type EntityViewType, type EventContext, type EventInput, type HTTPRequest, type JsonSchema, type ScheduleDefinition, type Type, type UIRequest, blocks, defineApp, events, getInvocationMetadata, http, kv, lifecycle, messaging, timers, ui };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slflows/sdk",
-  "version": "0.0.7",
+  "version": "0.1.0",
   "files": [
     "dist"
   ],
@@ -15,7 +15,6 @@
     "typescript": "^5.8.3"
   },
   "scripts": {
-    "build": "tsc && rollup -c",
-    "prepare": "pkgroll --clean-dist --src types"
+    "build": "tsc && rollup -c && pkgroll --clean-dist --src types"
   }
 }