@lotics/app-sdk 0.29.0 → 0.30.0

package/dist/src/hooks.d.ts

@@ -1,4 +1,4 @@
-import type { AppWorkflows, AppQueries } from "./types.js";
+import type { AppWorkflows, AppWorkflowResults, AppQueries } from "./types.js";
 import type { ResolvedMember } from "./members.js";
 /** Fields shared by every query hook's return value. */
 interface QueryStateBase {
@@ -151,17 +151,21 @@ export interface PaginatedQueryOptions extends BaseQueryOptions {
  */
 export declare function useWorkflow<K extends keyof AppWorkflows & string>(alias: K): UseWorkflowFn<K>;
 export declare function useWorkflow(alias: string): (inputs?: Record<string, unknown>) => Promise<WorkflowResult>;
-type UseWorkflowFn<K extends keyof AppWorkflows & string> = AppWorkflows[K] extends Record<string, unknown> ? AppWorkflows[K] extends Record<string, never> ? (inputs?: Record<string, never>) => Promise<WorkflowResult> : (inputs: AppWorkflows[K]) => Promise<WorkflowResult> : (inputs?: Record<string, unknown>) => Promise<WorkflowResult>;
+type ResultDataOf<K extends string> = K extends keyof AppWorkflowResults ? AppWorkflowResults[K] : unknown;
+type UseWorkflowFn<K extends keyof AppWorkflows & string> = AppWorkflows[K] extends Record<string, unknown> ? AppWorkflows[K] extends Record<string, never> ? (inputs?: Record<string, never>) => Promise<WorkflowResult<ResultDataOf<K>>> : (inputs: AppWorkflows[K]) => Promise<WorkflowResult<ResultDataOf<K>>> : (inputs?: Record<string, unknown>) => Promise<WorkflowResult<ResultDataOf<K>>>;
 /**
  * Result of an app-workflow run — the execute endpoint's response. `files` holds
  * any document a workflow step generated (e.g. via a `generate_*_from_template`
  * tool), resolved for download: read `files[0].url` and pass it to `openExternal`.
- * A workflow that generates no file resolves with `files` absent.
+ * A workflow that generates no file resolves with `files` absent. `data` is the
+ * structured value the workflow returned via `return({ data })`, typed per the
+ * alias's declared `outputs` schema (`unknown` when none was declared).
  */
-export interface WorkflowResult {
+export interface WorkflowResult<TData = unknown> {
     status: "success" | "error";
     message?: string;
     files?: UploadedFile[];
+    data?: TData;
 }
 type QueryArgs<K extends keyof AppQueries & string, O> = AppQueries[K] extends Record<string, never> ? [params?: Record<string, never>, opts?: O] : [params: AppQueries[K], opts?: O];
 /**

package/dist/src/types.d.ts

@@ -23,6 +23,27 @@
  */
 export interface AppWorkflows {
 }
+/**
+ * App-specific workflow-RESULT augmentation point. Same pattern as AppWorkflows,
+ * but maps each alias to the type of the `data` its workflow returns via
+ * `return({ data })` — derived from the alias's declared `outputs` schema.
+ *
+ * The base SDK ships it empty, so `useWorkflow(alias)` resolves `result.data` as
+ * `unknown`. Per-app codegen augments it for aliases that declare `outputs`:
+ *
+ * ```ts
+ * // .lotics/app_workflows.d.ts (generated)
+ * declare module "@lotics/app-sdk" {
+ *   interface AppWorkflowResults {
+ *     "computeQuote": { total: number; lines: ReadonlyArray<{ name: string; amount: number }> };
+ *   }
+ * }
+ * ```
+ *
+ * An alias absent from this map (no declared `outputs`) gets `result.data: unknown`.
+ */
+export interface AppWorkflowResults {
+}
 /**
  * App-specific named-query augmentation point. Same pattern as AppWorkflows.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/app-sdk",
-  "version": "0.29.0",
+  "version": "0.30.0",
   "description": "Runtime SDK for Lotics custom-code apps — typed hooks, postMessage bridge, mount entry point",
   "type": "module",
   "exports": {