@ram_28/kf-ai-sdk 2.0.2 → 2.0.3

package/dist/workflow/client.d.ts

@@ -0,0 +1,39 @@
+import type { ActivityOperations, WorkflowStartResponseType } from "./types";
+/**
+ * Workflow client for Business Process / Activity operations.
+ *
+ * @example
+ * ```typescript
+ * const wf = new Workflow<LeaveType>("SimpleLeaveProcess");
+ *
+ * // Start workflow
+ * const { activityId, activityInstanceId } = await wf.start();
+ *
+ * // Get activity operations
+ * const act = wf.activity("EMPLOYEE_INPUT");
+ *
+ * // Instance operations (instanceId as first param)
+ * await act.read("inst_123");
+ * await act.draftStart("inst_123", data);
+ * await act.draftEnd("inst_123", data);
+ * await act.complete("inst_123");
+ *
+ * // List operations
+ * await act.list({ Page: 1, PageSize: 10 });
+ * await act.metric({ Metric: [...] });
+ * ```
+ */
+export declare class Workflow<T = any> {
+    private bp_id;
+    constructor(bp_id: string);
+    /**
+     * Start a new workflow instance
+     */
+    start(): Promise<WorkflowStartResponseType>;
+    /**
+     * Get all operations for a specific activity
+     * @param activity_id - Activity identifier
+     */
+    activity(activity_id: string): ActivityOperations<T>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/workflow/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../sdk/workflow/client.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAEV,kBAAkB,EAElB,yBAAyB,EAC1B,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,QAAQ,CAAC,CAAC,GAAG,GAAG;IAC3B,OAAO,CAAC,KAAK,CAAS;gBAEV,KAAK,EAAE,MAAM;IAIzB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,yBAAyB,CAAC;IAgBjD;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,CAAC,CAAC,CAAC;CAiIrD"}

package/dist/workflow/components/useActivityForm/createActivityItemProxy.d.ts

@@ -0,0 +1,16 @@
+import type { UseFormReturn, FieldValues } from "react-hook-form";
+import type { FormItemType } from "../../../components/hooks/useForm/types";
+import type { Activity } from "../../Activity";
+import type { ExtractActivityEditable, ExtractActivityReadonly } from "./types";
+/**
+ * Creates a Proxy-based Item that delegates to RHF for state management.
+ *
+ * Key principle: Item has NO state. It's a view over RHF's state.
+ * Editable fields get set(), readonly fields do not.
+ *
+ * @param activity - The Activity instance for field metadata
+ * @param form - The RHF useForm return object
+ * @returns FormItemType proxy
+ */
+export declare function createActivityItemProxy<A extends Activity<any, any, any>>(activity: A, form: UseFormReturn<FieldValues>): FormItemType<ExtractActivityEditable<A>, ExtractActivityReadonly<A>>;
+//# sourceMappingURL=createActivityItemProxy.d.ts.map

package/dist/workflow/components/useActivityForm/createActivityItemProxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createActivityItemProxy.d.ts","sourceRoot":"","sources":["../../../../sdk/workflow/components/useActivityForm/createActivityItemProxy.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAQ,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGxE,OAAO,KAAK,EACV,YAAY,EAGb,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EACvE,QAAQ,EAAE,CAAC,EACX,IAAI,EAAE,aAAa,CAAC,WAAW,CAAC,GAC/B,YAAY,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,uBAAuB,CAAC,CAAC,CAAC,CAAC,CA2FtE"}

package/dist/workflow/components/useActivityForm/createActivityResolver.d.ts

@@ -0,0 +1,22 @@
+import type { FieldValues } from "react-hook-form";
+import type { Activity } from "../../Activity";
+/**
+ * Creates a React Hook Form resolver for Activity field validation.
+ *
+ * Validates only editable fields using BaseField.validate().
+ * Readonly fields (editable: false) are skipped.
+ *
+ * @param activity - The Activity instance with field definitions
+ * @returns RHF Resolver function
+ */
+export declare function createActivityResolver<A extends Activity<any, any, any>>(activity: A): (values: FieldValues, _context: any, options: any) => Promise<{
+    values: FieldValues;
+    errors: {};
+} | {
+    values: {};
+    errors: Record<string, {
+        type: string;
+        message: string;
+    }>;
+}>;
+//# sourceMappingURL=createActivityResolver.d.ts.map

package/dist/workflow/components/useActivityForm/createActivityResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createActivityResolver.d.ts","sourceRoot":"","sources":["../../../../sdk/workflow/components/useActivityForm/createActivityResolver.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EACtE,QAAQ,EAAE,CAAC,IAGG,QAAQ,WAAW,EAAE,UAAU,GAAG,EAAE,SAAS,GAAG;;;;;;cACvB,MAAM;iBAAW,MAAM;;GAkC/D"}

package/dist/workflow/components/useActivityForm/index.d.ts

@@ -0,0 +1,3 @@
+export { useActivityForm } from './useActivityForm';
+export type { UseActivityFormOptions, UseActivityFormReturn, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/workflow/components/useActivityForm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../sdk/workflow/components/useActivityForm/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EACV,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,SAAS,CAAC"}

package/dist/workflow/components/useActivityForm/types.d.ts

@@ -0,0 +1,80 @@
+import type { UseFormWatch, UseFormSetValue, UseFormGetValues, UseFormReset, UseFormTrigger, Control, FieldErrors } from "react-hook-form";
+import type { Activity } from "../../Activity";
+import type { HandleSubmitType, FormItemType, FormRegisterType, EditableFormFieldAccessorType, ReadonlyFormFieldAccessorType } from "../../../components/hooks/useForm/types";
+export type { HandleSubmitType, FormItemType, FormRegisterType, EditableFormFieldAccessorType, ReadonlyFormFieldAccessorType, };
+/** Extract TEntity from an Activity instance */
+export type ExtractActivityEntity<A> = A extends Activity<infer E, any, any> ? E : never;
+/** Extract TEditable from an Activity instance */
+export type ExtractActivityEditable<A> = A extends Activity<any, infer E, any> ? E : never;
+/** Extract TReadonly from an Activity instance */
+export type ExtractActivityReadonly<A> = A extends Activity<any, any, infer R> ? R : never;
+/** All accessible fields (editable + readonly) */
+export type AllActivityFields<A> = ExtractActivityEditable<A> & ExtractActivityReadonly<A>;
+/**
+ * useActivityForm hook options.
+ *
+ * The Activity instance already carries businessProcessId, activityId, and field definitions.
+ * Options only contain runtime configuration.
+ */
+export interface UseActivityFormOptions<A extends Activity<any, any, any>> {
+    /** Activity instance identifier */
+    activity_instance_id: string;
+    /** Default form values */
+    defaultValues?: Partial<ExtractActivityEditable<A>>;
+    /**
+     * Validation mode — controls when validation runs
+     * @default "onBlur"
+     */
+    mode?: "onBlur" | "onChange" | "onSubmit" | "onTouched" | "all";
+    /**
+     * Whether to enable activity.read() on mount
+     * @default true
+     */
+    enabled?: boolean;
+}
+/**
+ * useActivityForm hook return type — mirrors useForm return structure
+ */
+export interface UseActivityFormReturn<A extends Activity<any, any, any>> {
+    /** Item proxy with typed field accessors */
+    item: FormItemType<ExtractActivityEditable<A>, ExtractActivityReadonly<A>>;
+    /** The Activity instance */
+    activity: A;
+    /** Smart register with auto-disable for readonly fields */
+    register: FormRegisterType<ExtractActivityEditable<A>, ExtractActivityReadonly<A>>;
+    /** Handle form submission — calls activity.update() + activity.draftEnd() */
+    handleSubmit: HandleSubmitType<AllActivityFields<A>>;
+    /** Handle form completion — calls activity.complete() */
+    handleComplete: HandleSubmitType<AllActivityFields<A>>;
+    /** Watch field values */
+    watch: UseFormWatch<AllActivityFields<A>>;
+    /** Set field value programmatically */
+    setValue: UseFormSetValue<ExtractActivityEditable<A>>;
+    /** Get current field values */
+    getValues: UseFormGetValues<AllActivityFields<A>>;
+    /** Reset form to default values */
+    reset: UseFormReset<AllActivityFields<A>>;
+    /** Trigger validation for specific fields or all fields */
+    trigger: UseFormTrigger<AllActivityFields<A>>;
+    /** RHF control object (for Controller components) */
+    control: Control<AllActivityFields<A>>;
+    /** Form validation errors */
+    errors: FieldErrors<AllActivityFields<A>>;
+    /** Form is valid */
+    isValid: boolean;
+    /** Form has been modified */
+    isDirty: boolean;
+    /** Form is currently submitting (save or complete) */
+    isSubmitting: boolean;
+    /** Form submission was successful */
+    isSubmitSuccessful: boolean;
+    /** True during activity.read() */
+    isLoading: boolean;
+    /** Schema/data load error */
+    loadError: Error | null;
+    /** Any error active */
+    hasError: boolean;
+    /** Clear all form errors */
+    clearErrors: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/workflow/components/useActivityForm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../sdk/workflow/components/useActivityForm/types.ts"],"names":[],"mappings":"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"}

package/dist/workflow/components/useActivityForm/useActivityForm.d.ts

@@ -0,0 +1,4 @@
+import type { Activity } from "../../Activity";
+import type { UseActivityFormOptions, UseActivityFormReturn } from "./types";
+export declare function useActivityForm<A extends Activity<any, any, any>>(activity: A, options: UseActivityFormOptions<A>): UseActivityFormReturn<A>;
+//# sourceMappingURL=useActivityForm.d.ts.map

package/dist/workflow/components/useActivityForm/useActivityForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActivityForm.d.ts","sourceRoot":"","sources":["../../../../sdk/workflow/components/useActivityForm/useActivityForm.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EAEtB,MAAM,SAAS,CAAC;AAUjB,wBAAgB,eAAe,CAC7B,CAAC,SAAS,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAEjC,QAAQ,EAAE,CAAC,EACX,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC,GACjC,qBAAqB,CAAC,CAAC,CAAC,CAkW1B"}

package/dist/workflow/index.d.ts

@@ -0,0 +1,8 @@
+export { Workflow } from './client';
+export { Activity } from './Activity';
+export { ActivityInstance } from './ActivityInstance';
+export type { ActivityInstanceType, EditableFieldAccessor, ReadonlyFieldAccessor, } from './ActivityInstance';
+export type { ActivityInstanceFieldsType, ActivityOperations, ActivityProgressType, WorkflowStartResponseType, } from './types';
+export { useActivityForm } from './components/useActivityForm';
+export type { UseActivityFormOptions, UseActivityFormReturn, } from './components/useActivityForm';
+//# sourceMappingURL=index.d.ts.map

package/dist/workflow/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../sdk/workflow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,0BAA0B,EAC1B,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,YAAY,EACV,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,8BAA8B,CAAC"}

package/dist/workflow/types.d.ts

@@ -0,0 +1,53 @@
+import type { ListOptionsType, ListResponseType, MetricOptionsType, MetricResponseType, DraftResponseType, CreateUpdateResponseType } from "../types/common";
+import type { StringFieldType, SelectFieldType, DateTimeFieldType, ReferenceFieldType } from "../types/base-fields";
+import type { UserRefType } from "../types/base-fields";
+/**
+ * Response from Workflow.start()
+ */
+export interface WorkflowStartResponseType {
+    activityId: string;
+    activityInstanceId: string;
+}
+/**
+ * Response from the activity progress endpoint
+ */
+export interface ActivityProgressType {
+    Stage?: string;
+    Progress?: number;
+    [key: string]: any;
+}
+/**
+ * System fields present on every activity instance response.
+ * Returned alongside activity-specific fields from `list()` and `read()`.
+ */
+export type ActivityInstanceFieldsType = {
+    _id: StringFieldType;
+    Status: SelectFieldType<"InProgress" | "Completed">;
+    AssignedTo: ReferenceFieldType<UserRefType>;
+    CompletedAt: DateTimeFieldType;
+};
+/**
+ * Unified activity operations — returned by Workflow.activity(activityId)
+ *
+ * List-level methods operate on the activity as a whole.
+ * Instance-level methods accept `instanceId` as their first parameter.
+ */
+export interface ActivityOperations<T> {
+    /** List activity instances (POST .../list) */
+    list(options?: ListOptionsType): Promise<ListResponseType<ActivityInstanceFieldsType & T>>;
+    /** Get activity metrics (POST .../metric) */
+    metric(options: Omit<MetricOptionsType, "Type">): Promise<MetricResponseType>;
+    /** Read the activity instance data (GET .../read) */
+    read(instanceId: string): Promise<ActivityInstanceFieldsType & T>;
+    /** Update the activity instance (POST .../update) */
+    update(instanceId: string, data: Partial<T>): Promise<CreateUpdateResponseType>;
+    /** Start a draft edit session (PATCH .../draft) */
+    draftStart(instanceId: string, data: Partial<T>): Promise<DraftResponseType>;
+    /** End a draft edit session and commit (POST .../draft) */
+    draftEnd(instanceId: string, data: Partial<T>): Promise<CreateUpdateResponseType>;
+    /** Complete the activity (POST .../done) */
+    complete(instanceId: string): Promise<CreateUpdateResponseType>;
+    /** Get activity progress (GET .../progress) */
+    progress(instanceId: string): Promise<ActivityProgressType>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/workflow/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../sdk/workflow/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACzB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,GAAG,EAAE,eAAe,CAAC;IACrB,MAAM,EAAE,eAAe,CAAC,YAAY,GAAG,WAAW,CAAC,CAAC;IACpD,UAAU,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC5C,WAAW,EAAE,iBAAiB,CAAC;CAChC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC;IAGnC,8CAA8C;IAC9C,IAAI,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,0BAA0B,GAAG,CAAC,CAAC,CAAC,CAAC;IAE3F,6CAA6C;IAC7C,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAI9E,qDAAqD;IACrD,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,GAAG,CAAC,CAAC,CAAC;IAElE,qDAAqD;IACrD,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAEhF,mDAAmD;IACnD,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE7E,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAElF,4CAA4C;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAEhE,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC7D"}

package/dist/workflow.cjs

@@ -0,0 +1 @@
+"use strict";var F=Object.defineProperty;var U=(c,s,t)=>s in c?F(c,s,{enumerable:!0,configurable:!0,writable:!0,value:t}):c[s]=t;var b=(c,s,t)=>U(c,typeof s!="symbol"?s+"":s,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("./client-DtPpfJc1.cjs"),L=require("./BaseField-Drp0-OxL.cjs"),f=require("react"),p=require("./index.esm-DuwT11sx.cjs"),N=require("./error-handling-CAoD0Kwb.cjs");class q{constructor(s){b(this,"bp_id");this.bp_id=s}async start(){const s=await fetch(`${d.getApiBaseUrl()}/api/app/process/${this.bp_id}/start`,{method:"POST",headers:d.getDefaultHeaders()});if(!s.ok)throw new Error(`Failed to start process: ${s.statusText}`);return s.json()}activity(s){const t=`/api/app/process/${this.bp_id}/${s}`;return{async list(i){const a={Type:"List",...i},e=await fetch(`${d.getApiBaseUrl()}${t}/list`,{method:"POST",headers:d.getDefaultHeaders(),body:JSON.stringify(a)});if(!e.ok)throw new Error(`Failed to list activities: ${e.statusText}`);return e.json()},async metric(i){const a={Type:"Metric",...i},e=await fetch(`${d.getApiBaseUrl()}${t}/metric`,{method:"POST",headers:d.getDefaultHeaders(),body:JSON.stringify(a)});if(!e.ok)throw new Error(`Failed to get activity metrics: ${e.statusText}`);return e.json()},async read(i){const a=await fetch(`${d.getApiBaseUrl()}${t}/${i}/read`,{method:"GET",headers:d.getDefaultHeaders()});if(!a.ok)throw new Error(`Failed to read activity: ${a.statusText}`);return(await a.json()).Data},async update(i,a){const e=await fetch(`${d.getApiBaseUrl()}${t}/${i}/update`,{method:"POST",headers:d.getDefaultHeaders(),body:JSON.stringify(a)});if(!e.ok)throw new Error(`Failed to update activity: ${e.statusText}`);return e.json()},async draftStart(i,a){const e=await fetch(`${d.getApiBaseUrl()}${t}/${i}/draft`,{method:"PATCH",headers:d.getDefaultHeaders(),body:JSON.stringify(a)});if(!e.ok)throw new Error(`Failed to start draft: ${e.statusText}`);return e.json()},async draftEnd(i,a){const e=await fetch(`${d.getApiBaseUrl()}${t}/${i}/draft`,{method:"POST",headers:d.getDefaultHeaders(),body:JSON.stringify(a)});if(!e.ok)throw new Error(`Failed to end draft: ${e.statusText}`);return e.json()},async complete(i){const a=await fetch(`${d.getApiBaseUrl()}${t}/${i}/done`,{method:"POST",headers:d.getDefaultHeaders()});if(!a.ok)throw new Error(`Failed to complete activity: ${a.statusText}`);return a.json()},async progress(i){const a=await fetch(`${d.getApiBaseUrl()}${t}/${i}/progress`,{method:"GET",headers:d.getDefaultHeaders()});if(!a.ok)throw new Error(`Failed to get activity progress: ${a.statusText}`);return a.json()}}}}class x{constructor(s,t,i,a){b(this,"_id");b(this,"_data");b(this,"_ops");b(this,"_fields");b(this,"_accessorCache",new Map);this._ops=s,this._id=t,this._data={...i},this._fields=a}toJSON(){return{...this._data}}validate(){const s=[];for(const[t,i]of Object.entries(this._fields)){const a=this._data[t],e=i.validate(a);e.valid||s.push(...e.errors)}return{valid:s.length===0,errors:s}}async update(s){return this._ops.update(this._id,s)}async save(s){return this._ops.draftEnd(this._id,s)}async complete(){return this._ops.complete(this._id)}async progress(){return this._ops.progress(this._id)}_getAccessor(s){if(this._accessorCache.has(s))return this._accessorCache.get(s);const t=this._fields[s],i=(t==null?void 0:t.meta)??{_id:s,Name:s,Type:"String"},a=(t==null?void 0:t.readOnly)??!1,e=()=>t?t.validate(this._data[s]):{valid:!0,errors:[]};let r;return a?r={label:(t==null?void 0:t.label)??s,required:(t==null?void 0:t.required)??!1,readOnly:!0,defaultValue:t==null?void 0:t.defaultValue,meta:i,get:()=>this._data[s],validate:e}:r={label:(t==null?void 0:t.label)??s,required:(t==null?void 0:t.required)??!1,readOnly:!1,defaultValue:t==null?void 0:t.defaultValue,meta:i,get:()=>this._data[s],set:y=>{this._data[s]=y},validate:e},this._accessorCache.set(s,r),r}}function G(c,s,t,i){const a=new x(c,s,t,i);return new Proxy(a,{get(e,r,y){return r==="validate"||r==="toJSON"||r==="update"||r==="save"||r==="complete"||r==="progress"||r==="_ops"||r==="_data"||r==="_fields"||r==="_accessorCache"||r==="_getAccessor"||typeof r=="symbol"?Reflect.get(e,r,y):r==="_id"?e._id:e._getAccessor(r)},has(e,r){return typeof r=="symbol"?!1:r==="validate"||r==="toJSON"||r==="update"||r==="save"||r==="complete"||r==="progress"||r==="_id"?!0:r in e._fields},ownKeys(e){return[...Object.keys(e._fields),"_id","validate","toJSON","update","save","complete","progress"]},getOwnPropertyDescriptor(e,r){if(typeof r!="symbol")return{configurable:!0,enumerable:r!=="validate"&&r!=="toJSON"&&r!=="update"&&r!=="save"&&r!=="complete"&&r!=="progress"}}})}class K{constructor(){b(this,"_fieldsCache",null)}_ops(){return new q(this.meta.businessProcessId).activity(this.meta.activityId)}_discoverFields(){if(this._fieldsCache)return this._fieldsCache;const s={};for(const t of Object.keys(this)){const i=this[t];i instanceof L.BaseField&&(s[t]=i)}return this._fieldsCache=s,s}async getInstanceList(s){return this._ops().list(s)}async instanceMetrics(s){return this._ops().metric(s)}async getInstance(s){const t=this._ops(),i=await t.read(s),a=this._discoverFields();return G(t,s,i,a)}_getFields(){return this._discoverFields()}_getOps(){return this._ops()}}function W(c){return async(s,t,i)=>{const a={},e=c._getFields(),r=(i==null?void 0:i.names)??Object.keys(e);for(const y of r){const w=e[y];if(!w||w.readOnly)continue;const $=s[y],O=w.validate($);!O.valid&&O.errors.length>0&&(a[y]={type:"validate",message:O.errors[0]||`${y} is invalid`})}return Object.keys(a).length===0?{values:s,errors:{}}:{values:{},errors:a}}}function z(c,s){const t=c._getFields();return new Proxy({},{get(i,a){if(typeof a=="symbol")return;if(a==="toJSON")return()=>s.getValues();if(a==="validate")return()=>s.trigger();const e=t[a],r=(e==null?void 0:e.meta)??{_id:a,Name:a,Type:"String"},y=(e==null?void 0:e.readOnly)??!1,w=()=>e?e.validate(s.getValues(a)):{valid:!0,errors:[]};return y?{label:(e==null?void 0:e.label)??a,required:(e==null?void 0:e.required)??!1,readOnly:!0,defaultValue:e==null?void 0:e.defaultValue,meta:r,get:()=>s.getValues(a),validate:w}:{label:(e==null?void 0:e.label)??a,required:(e==null?void 0:e.required)??!1,readOnly:!1,defaultValue:e==null?void 0:e.defaultValue,meta:r,get:()=>s.getValues(a),set:S=>{s.setValue(a,S,{shouldDirty:!0,shouldTouch:!0,shouldValidate:!1})},validate:w}},has(i,a){return typeof a=="symbol"?!1:a==="toJSON"||a==="validate"?!0:a in t},ownKeys(i){return[...Object.keys(t),"toJSON","validate"]},getOwnPropertyDescriptor(i,a){if(typeof a!="symbol")return{configurable:!0,enumerable:a!=="toJSON"&&a!=="validate"}}})}function Q(c,s){const{activity_instance_id:t,defaultValues:i={},mode:a="onBlur",enabled:e=!0}=s,[r,y]=f.useState(!1),[w,$]=f.useState(null),[O,S]=f.useState(!1),j=f.useRef(!1),A=f.useRef(null),T=f.useMemo(()=>c._getFields(),[c]),V=f.useMemo(()=>Object.keys(T).filter(u=>T[u].readOnly),[T]),J=f.useMemo(()=>W(c),[c]),n=p.useForm({mode:a,defaultValues:i,resolver:J}),P=f.useMemo(()=>z(c,n),[c,n]),v=f.useMemo(()=>c._getOps(),[c]);f.useEffect(()=>{if(!e)return;let u=!0;return(async()=>{y(!0),$(null);try{const o=await v.read(t);if(!u)return;o&&typeof o=="object"&&n.reset({...i,...o})}catch(o){if(!u)return;console.error("Failed to read activity data:",o),$(N.toError(o))}finally{u&&y(!1)}})(),()=>{u=!1}},[e,v,t]);const k=f.useCallback(async u=>{V.length!==0&&(j.current||(A.current&&clearTimeout(A.current),A.current=setTimeout(async()=>{if(!j.current){j.current=!0;try{const l=n.getValues(),o={},h=new Set(V);Object.keys(l).forEach(_=>{h.has(_)||(o[_]=l[_])});const g=await v.draftStart(t,o);g&&typeof g=="object"&&Object.entries(g).forEach(([_,m])=>{h.has(_)&&n.getValues(_)!==m&&n.setValue(_,m,{shouldDirty:!1,shouldValidate:!1})})}catch(l){console.warn("Draft computation failed:",l)}finally{j.current=!1}}},300)))},[v,V,n]),R=f.useCallback((u,l)=>{const o=T[u],h=o?o.readOnly:!1,g=l==null?void 0:l.onBlur,_=async C=>{g&&await g(C);let B=!0;a==="onBlur"||a==="onTouched"||a==="all"?B=await n.trigger(u):B=!n.getFieldState(u,n.formState).error,B&&await k(u)},m=n.register(u,{...l,onBlur:_,...h?{disabled:!0}:{}});return h?{...m,disabled:!0}:m},[n,T,k,a]),H=f.useCallback((u,l)=>n.handleSubmit(async(o,h)=>{S(!0);try{const g={},_=new Set(V);Object.keys(o).forEach(m=>{!_.has(m)&&o[m]!==void 0&&(g[m]=o[m])}),await v.update(t,g),await v.draftEnd(t,g),await(u==null?void 0:u(o,h))}catch(g){l==null||l(N.toError(g),h)}finally{S(!1)}},(o,h)=>{l==null||l(o,h)}),[n,v,V]),M=f.useCallback((u,l)=>n.handleSubmit(async(o,h)=>{S(!0);try{await v.complete(t),await(u==null?void 0:u(o,h))}catch(g){l==null||l(N.toError(g),h)}finally{S(!1)}},(o,h)=>{l==null||l(o,h)}),[n,v]),D=f.useCallback(()=>{n.clearErrors()},[n]),E=!!w;return{item:P,activity:c,register:R,handleSubmit:H,handleComplete:M,watch:n.watch,setValue:n.setValue,getValues:n.getValues,reset:n.reset,trigger:n.trigger,control:n.control,errors:n.formState.errors,isValid:n.formState.isValid,isDirty:n.formState.isDirty,isSubmitting:n.formState.isSubmitting||O,isSubmitSuccessful:n.formState.isSubmitSuccessful,isLoading:r,loadError:w,hasError:E,clearErrors:D}}exports.Activity=K;exports.ActivityInstance=x;exports.Workflow=q;exports.useActivityForm=Q;

package/dist/workflow.d.ts

@@ -0,0 +1,8 @@
+export { Workflow } from './workflow/client';
+export { Activity } from './workflow/Activity';
+export { ActivityInstance } from './workflow/ActivityInstance';
+export type { ActivityInstanceType, EditableFieldAccessor, ReadonlyFieldAccessor, } from './workflow/ActivityInstance';
+export type { ActivityInstanceFieldsType, ActivityOperations, ActivityProgressType, WorkflowStartResponseType, } from './workflow/types';
+export { useActivityForm } from './workflow/components/useActivityForm';
+export type { UseActivityFormOptions, UseActivityFormReturn, } from './workflow/components/useActivityForm';
+//# sourceMappingURL=workflow.d.ts.map

package/dist/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../sdk/workflow.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,0BAA0B,EAC1B,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,YAAY,EACV,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,uCAAuC,CAAC"}