@slflows/sdk 0.7.0 → 0.9.0

package/dist/v1/index.d.ts

@@ -852,6 +852,8 @@ interface AppConfigField {
     required: boolean;
     default?: unknown;
     sensitive?: boolean;
+    /** Auto-populate from an upstream block's output when connected. */
+    populateFrom?: PopulateFrom;
 }
 interface AppSignal {
     name: string;
@@ -912,11 +914,67 @@ interface AppBlockConfigField {
     default?: unknown;
     fieldKey?: string;
     sensitive?: boolean;
+    /**
+     * Function to provide suggested values for this config field.
+     * Called when the user is editing this field to provide autocomplete suggestions.
+     */
+    suggestValues?: (input: SuggestValuesInput) => SuggestValuesOutput | Promise<SuggestValuesOutput>;
+}
+interface AppBlockInputConfigField {
+    name: string;
+    description?: string;
+    type: Type;
+    required: boolean;
+    default?: unknown;
+    sensitive?: boolean;
+    /** Auto-populate from an upstream block's output when connected. */
+    populateFrom?: PopulateFrom;
+    /**
+     * Function to provide suggested values for this config field.
+     * Called when the user is editing this field to provide autocomplete suggestions.
+     */
+    suggestValues?: (input: SuggestValuesInput) => SuggestValuesOutput | Promise<SuggestValuesOutput>;
+}
+/**
+ * Input provided to the suggestValues function.
+ * Contains app and block context along with the user's search phrase.
+ */
+interface SuggestValuesInput {
+    /** App installation context and configuration */
+    app: AppContext;
+    /** Block (entity) instance context and configuration */
+    block: EntityContext;
+    /** Optional search phrase entered by the user to filter suggestions */
+    searchPhrase?: string;
+    /**
+     * Static input config values from other fields on the same input.
+     * Only present for input-level config fields. Contains the parsed values
+     * of sibling config fields whose expressions are static JSON values.
+     */
+    staticInputConfig?: Record<string, unknown>;
+}
+/**
+ * Output from the suggestValues function.
+ */
+interface SuggestValuesOutput {
+    /** Array of suggested values to present to the user */
+    suggestedValues: SuggestedValue[];
+    /** Optional message to display above the suggestions list */
+    message?: string;
+}
+/**
+ * A single suggested value with a display label and actual value.
+ */
+interface SuggestedValue {
+    /** Display label shown to the user */
+    label: string;
+    /** The actual value to use when selected */
+    value: unknown;
 }
 interface AppBlockComponentInput {
     name?: string;
     description?: string;
-    config?: Record<string, AppBlockConfigField>;
+    config?: Record<string, AppBlockInputConfigField>;
     onEvent: (input: EventInput) => Promise<void>;
 }
 interface AppBlockComponentOutput {
@@ -1071,10 +1129,10 @@ interface EntityNonSchedulableLifecycleCallbackOutput extends BaseLifecycleCallb
 interface EntitySchedulableLifecycleCallbackOutput extends BaseLifecycleCallbackOutput {
     newStatus: "in_progress" | "draining";
     /** Specifies the time in seconds after which the callback will
-    * be called again in case the entity is not in a complete state.
-    * If set to null, the callback won't be called again. It can be
-    * invoked using lifecycle.sync() from e.g. an http request handler.
-    */
+     * be called again in case the entity is not in a complete state.
+     * If set to null, the callback won't be called again. It can be
+     * invoked using lifecycle.sync() from e.g. an http request handler.
+     */
     nextScheduleDelay?: number | null;
 }
 type EntityLifecycleCallbackOutput = EntityNonSchedulableLifecycleCallbackOutput | EntitySchedulableLifecycleCallbackOutput;
@@ -1084,10 +1142,10 @@ interface AppNonSchedulableLifecycleCallbackOutput extends BaseLifecycleCallback
 interface AppSchedulableLifecycleCallbackOutput extends BaseLifecycleCallbackOutput {
     newStatus: "in_progress" | "draining";
     /** Specifies the time in seconds after which the callback will
-    * be called again in case the app is not in a complete state. If
-    * set to null, the callback won't be called again. It can be
-    * invoked using lifecycle.sync() from e.g. an http request handler.
-    */
+     * be called again in case the app is not in a complete state. If
+     * set to null, the callback won't be called again. It can be
+     * invoked using lifecycle.sync() from e.g. an http request handler.
+     */
     nextScheduleDelay?: number | null;
 }
 type AppLifecycleCallbackOutput = AppNonSchedulableLifecycleCallbackOutput | AppSchedulableLifecycleCallbackOutput;
@@ -1166,6 +1224,26 @@ interface UIRequest {
     type: string;
     payload?: any;
 }
+/**
+ * Auto-populates a config field from an upstream block's output when connected.
+ *
+ * @example
+ * ```typescript
+ * // Simple property
+ * populateFrom: { blockKey: "pull_request", outputProperty: "url" }
+ * // → outputs.<block>.url
+ *
+ * // Nested property (dot notation)
+ * populateFrom: { blockKey: "pull_request", outputProperty: "data.repository.url" }
+ * // → outputs.<block>.data.repository.url
+ * ```
+ */
+interface PopulateFrom {
+    /** Block key to find upstream. Must be from the same app installation. */
+    blockKey: string;
+    /** Property path in the upstream block's output. Use dot notation for nested access. */
+    outputProperty: string;
+}
 
 export { blocks, defineApp, events, getInvocationMetadata, http, kv, lifecycle, messaging, timers, ui };
-export type { AppBlock, AppBlockComponentInput, AppBlockComponentOutput, AppBlockConfigField, AppBlockHTTPComponent, AppBlockSchedule, AppBlockSignal, AppBlockUIComponent, AppConfigField, AppContext, AppHTTPComponent, AppHTTPEndpoint, AppInput, AppLifecycleCallbackOutput, AppLifecycleStatus, AppOnCreateOutput, AppOnHTTPRequestInput, AppOnInternalMessageInput, AppOnTimerInput, AppOnTriggerInput, AppOnUIRequestInput, AppSchedule, AppSchema, AppSignal, AppUIComponent, EntityContext, EntityHTTPEndpoint, EntityInput, EntityLifecycleCallbackOutput, EntityLifecycleComponent, EntityLifecycleStatus, EntityOnHTTPRequestInput, EntityOnInternalMessageInput, EntityOnTimerInput, EntityOnTriggerInput, EntityOnUIRequestInput, EntityOutput, EntityView, EntityViewType, EventContext, EventInput, HTTPRequest, JsonSchema, ScheduleDefinition, Type, UIRequest };
+export type { AppBlock, AppBlockComponentInput, AppBlockComponentOutput, AppBlockConfigField, AppBlockHTTPComponent, AppBlockInputConfigField, AppBlockSchedule, AppBlockSignal, AppBlockUIComponent, AppConfigField, AppContext, AppHTTPComponent, AppHTTPEndpoint, AppInput, AppLifecycleCallbackOutput, AppLifecycleStatus, AppOnCreateOutput, AppOnHTTPRequestInput, AppOnInternalMessageInput, AppOnTimerInput, AppOnTriggerInput, AppOnUIRequestInput, AppSchedule, AppSchema, AppSignal, AppUIComponent, EntityContext, EntityHTTPEndpoint, EntityInput, EntityLifecycleCallbackOutput, EntityLifecycleComponent, EntityLifecycleStatus, EntityOnHTTPRequestInput, EntityOnInternalMessageInput, EntityOnTimerInput, EntityOnTriggerInput, EntityOnUIRequestInput, EntityOutput, EntityView, EntityViewType, EventContext, EventInput, HTTPRequest, JsonSchema, PopulateFrom, ScheduleDefinition, SuggestValuesInput, SuggestValuesOutput, SuggestedValue, Type, UIRequest };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slflows/sdk",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "files": [
     "dist"
   ],