@lotics/app-sdk 0.1.0 → 0.2.0

package/dist/src/hooks.d.ts

@@ -1,4 +1,4 @@
-import type { QueryAst, TableRow, WorkspaceTables } from "./types.js";
+import type { AppWorkflows, QueryAst, TableRow, WorkspaceTables } from "./types.js";
 interface QueryState<R> {
     rows: R[];
     loading: boolean;
@@ -30,6 +30,24 @@ export declare function useMutate(table_id: string): {
 type RowFor<K extends keyof WorkspaceTables & string> = WorkspaceTables[K];
 /** Trigger a workflow by action_id. Returns a callable that runs it. */
 export declare function useAction(action_id: string): (inputs?: Record<string, unknown>) => Promise<unknown>;
+/**
+ * Trigger a workflow by alias from the app's manifest.
+ *
+ * The alias must be declared in `package.json` "lotics.workflows" and synced
+ * to `apps.workflows` on the last deploy. Returns a callable; pass whatever
+ * inputs the workflow expects (the workflow's own trigger schema gates them
+ * server-side).
+ *
+ * Per-app `lotics types` codegen augments `AppWorkflows` with the declared
+ * alias keys — passing an undeclared alias is a compile-time error.
+ *
+ * ```tsx
+ * const issue = useWorkflow("issueInvoiceStorageDrop");
+ * await issue({ record_id: row.__source_record_id });
+ * ```
+ */
+export declare function useWorkflow<K extends keyof AppWorkflows & string>(alias: K): (inputs?: Record<string, unknown>) => Promise<unknown>;
+export declare function useWorkflow(alias: string): (inputs?: Record<string, unknown>) => Promise<unknown>;
 /**
  * Escape hatch — pass a raw query AST. Same shape the server validates via
  * `parseQueryNode`. Use for joins, group-by, projections, and other shapes

package/dist/src/hooks.js

@@ -56,6 +56,9 @@ export function useMutate(table_id) {
 export function useAction(action_id) {
     return useCallback((inputs) => rpc("action", { action_id, inputs: inputs ?? {} }), [action_id]);
 }
+export function useWorkflow(alias) {
+    return useCallback((inputs) => rpc("workflow", { alias, inputs: inputs ?? {} }), [alias]);
+}
 /**
  * Escape hatch — pass a raw query AST. Same shape the server validates via
  * `parseQueryNode`. Use for joins, group-by, projections, and other shapes

package/dist/src/index.d.ts

@@ -10,7 +10,7 @@
  * depending on packages/ui's React Native Web setup.
  */
 export { mount } from "./mount.js";
-export { useTable, useMutate, useAction, useQuery } from "./hooks.js";
+export { useTable, useMutate, useAction, useWorkflow, useQuery } from "./hooks.js";
 export { rpc } from "./rpc.js";
 export type { RpcOp } from "./rpc.js";
-export type { WorkspaceTables, RowOf, TableRow, SourceAddressing, QueryAst } from "./types.js";
+export type { WorkspaceTables, AppWorkflows, RowOf, TableRow, SourceAddressing, QueryAst, } from "./types.js";

package/dist/src/index.js

@@ -10,5 +10,5 @@
  * depending on packages/ui's React Native Web setup.
  */
 export { mount } from "./mount.js";
-export { useTable, useMutate, useAction, useQuery } from "./hooks.js";
+export { useTable, useMutate, useAction, useWorkflow, useQuery } from "./hooks.js";
 export { rpc } from "./rpc.js";

package/dist/src/rpc.d.ts

@@ -14,5 +14,5 @@
  * old bundles must keep working forever, since we can't force users to
  * redeploy. Add new ops alongside existing ones; never repurpose them.
  */
-export type RpcOp = "query" | "mutate" | "action" | "filter";
+export type RpcOp = "query" | "mutate" | "action" | "workflow" | "filter";
 export declare function rpc<T = unknown>(op: RpcOp, payload: unknown): Promise<T>;

package/dist/src/types.d.ts

@@ -22,6 +22,32 @@
  */
 export interface WorkspaceTables {
 }
+/**
+ * App-specific workflow augmentation point. Same pattern as WorkspaceTables.
+ *
+ * The base SDK ships `AppWorkflows` empty — `useWorkflow(alias)` accepts any
+ * string at runtime. Per-app codegen (folded into `lotics app pull`) emits a
+ * file that augments this interface with the aliases declared in the app's
+ * `package.json` lotics.workflows, giving compile-time autocomplete +
+ * "undeclared alias" errors:
+ *
+ * ```ts
+ * // .lotics/types.ts (generated)
+ * import "@lotics/app-sdk";
+ * declare module "@lotics/app-sdk" {
+ *   interface AppWorkflows {
+ *     "issueInvoiceStorageDrop": never;
+ *     "issueInvoiceReuseLift": never;
+ *   }
+ * }
+ * ```
+ *
+ * The `never` value is a placeholder for v2 input/output typing — when the
+ * codegen learns to extract workflow trigger schemas, the value becomes the
+ * input type. For now the hook's runtime signature is unaffected.
+ */
+export interface AppWorkflows {
+}
 /**
  * Helper: row type for a known table id, or fallback for unknown ones.
  * Currently unused by exported hooks (useRecord deferred to v2) but kept

package/package.json

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