@slflows/sdk 0.6.2 → 0.8.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,59 @@ 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;
+}
+/**
+ * Output from the suggestValues function.
+ */
+interface SuggestValuesOutput {
+    /** Array of suggested values to present to the user */
+    suggestedValues: SuggestedValue[];
+}
+/**
+ * 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 {
@@ -1070,7 +1120,12 @@ interface EntityNonSchedulableLifecycleCallbackOutput extends BaseLifecycleCallb
 }
 interface EntitySchedulableLifecycleCallbackOutput extends BaseLifecycleCallbackOutput {
     newStatus: "in_progress" | "draining";
-    nextScheduleDelay?: number;
+    /** 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.
+     */
+    nextScheduleDelay?: number | null;
 }
 type EntityLifecycleCallbackOutput = EntityNonSchedulableLifecycleCallbackOutput | EntitySchedulableLifecycleCallbackOutput;
 interface AppNonSchedulableLifecycleCallbackOutput extends BaseLifecycleCallbackOutput {
@@ -1078,7 +1133,12 @@ interface AppNonSchedulableLifecycleCallbackOutput extends BaseLifecycleCallback
 }
 interface AppSchedulableLifecycleCallbackOutput extends BaseLifecycleCallbackOutput {
     newStatus: "in_progress" | "draining";
-    nextScheduleDelay?: number;
+    /** 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.
+     */
+    nextScheduleDelay?: number | null;
 }
 type AppLifecycleCallbackOutput = AppNonSchedulableLifecycleCallbackOutput | AppSchedulableLifecycleCallbackOutput;
 type AppLifecycleStatus = "draft" | "in_progress" | "ready" | "failed" | "draining" | "draining_failed" | "drained";
@@ -1156,6 +1216,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.6.2",
+  "version": "0.8.0",
   "files": [
     "dist"
   ],