@ram_28/kf-ai-sdk 2.0.14 → 2.0.15

package/sdk/workflow/createFieldFromMeta.ts

@@ -0,0 +1,110 @@
+// ============================================================
+// FIELD FACTORY — Runtime Field Construction from Metadata
+// ============================================================
+// Creates BaseField instances from raw BP activity Input metadata.
+// Used by useActivityForm to dynamically build fields when BP
+// metadata is fetched at runtime.
+
+import { StringField } from '../bdo/fields/StringField';
+import { NumberField } from '../bdo/fields/NumberField';
+import { BooleanField } from '../bdo/fields/BooleanField';
+import { DateField } from '../bdo/fields/DateField';
+import { DateTimeField } from '../bdo/fields/DateTimeField';
+import { TextField } from '../bdo/fields/TextField';
+import { SelectField } from '../bdo/fields/SelectField';
+import { ReferenceField } from '../bdo/fields/ReferenceField';
+import { UserField } from '../bdo/fields/UserField';
+import { FileField } from '../bdo/fields/FileField';
+import type { BaseField } from '../bdo/fields/BaseField';
+
+/**
+ * Create a BaseField instance from raw Input field metadata.
+ * Used by useActivityForm to dynamically construct fields from BP metadata.
+ *
+ * @param fieldId - The field identifier (e.g., "StartDate", "LeaveType")
+ * @param meta - Raw field metadata from BP Activity Input definition
+ * @returns A BaseField instance matching the metadata Type
+ */
+export function createFieldFromMeta(
+  fieldId: string,
+  meta: Record<string, unknown>,
+): BaseField<unknown> {
+  const fullMeta = { _id: fieldId, ...meta };
+  const type = meta.Type as string;
+
+  // String + Enum constraint → SelectField
+  if (
+    type === 'String' &&
+    (meta.Constraint as Record<string, unknown> | undefined)?.Enum
+  ) {
+    return new SelectField(fullMeta as any);
+  }
+
+  switch (type) {
+    case 'String':
+      return new StringField(fullMeta as any);
+    case 'Number':
+      return new NumberField(fullMeta as any);
+    case 'Boolean':
+      return new BooleanField(fullMeta as any);
+    case 'Date':
+      return new DateField(fullMeta as any);
+    case 'DateTime':
+      return new DateTimeField(fullMeta as any);
+    case 'Text':
+      return new TextField(fullMeta as any);
+    case 'Reference':
+      return new ReferenceField(fullMeta as any);
+    case 'User':
+      return new UserField(fullMeta as any);
+    case 'File':
+      return new FileField(fullMeta as any);
+    default:
+      return new StringField(fullMeta as any);
+  }
+}
+
+/**
+ * Build a fields map from an Activity's Input metadata.
+ *
+ * @param input - The Input object from BP Activity definition
+ *                (Record of fieldId → raw field metadata)
+ * @returns Record of fieldId → BaseField instance
+ */
+export function buildFieldsFromInput(
+  input: Record<string, Record<string, unknown>>,
+): Record<string, BaseField<unknown>> {
+  const fields: Record<string, BaseField<unknown>> = {};
+  for (const [fieldId, fieldMeta] of Object.entries(input)) {
+    fields[fieldId] = createFieldFromMeta(fieldId, fieldMeta);
+  }
+  return fields;
+}
+
+/**
+ * Search all activities in a BP blob for a field definition by name.
+ * Used to discover field metadata for Context-derived readonly fields.
+ *
+ * @param currentActivityDef - The current activity definition (to skip)
+ * @param bpSchema - The full BP schema (with BDOBlob)
+ * @param fieldName - The field name to search for
+ * @returns The field metadata or null if not found
+ */
+export function findFieldInBpActivities(
+  currentActivityDef: Record<string, unknown> | null,
+  bpSchema: Record<string, unknown> | null | undefined,
+  fieldName: string,
+): Record<string, unknown> | null {
+  const blob = (bpSchema as any)?.BDOBlob;
+  if (!blob?.Activity) return null;
+
+  const currentId = (currentActivityDef as any)?.Id;
+
+  for (const activity of blob.Activity as any[]) {
+    if (activity.Id === currentId) continue;
+    if (activity.Input?.[fieldName]) {
+      return activity.Input[fieldName];
+    }
+  }
+  return null;
+}

package/sdk/workflow/index.ts

@@ -12,9 +12,4 @@ export type {
   ActivityProgressType,
   WorkflowStartResponseType,
 } from './types';
-
-export { useActivityForm } from './components/useActivityForm';
-export type {
-  UseActivityFormOptions,
-  UseActivityFormReturn,
-} from './components/useActivityForm';
+export { createFieldFromMeta, buildFieldsFromInput } from './createFieldFromMeta';

package/sdk/workflow/types.ts

@@ -4,7 +4,8 @@
 
 import type {
   ListResponseType,
-  MetricResponseType,
+  ListOptionsType,
+  CountResponseType,
   DraftResponseType,
   CreateUpdateResponseType,
 } from "../types/common";
@@ -13,9 +14,8 @@ import type {
   StringFieldType,
   SelectFieldType,
   DateTimeFieldType,
-  ReferenceFieldType,
+  UserFieldType,
 } from "../types/base-fields";
-import type { UserRefType } from "../types/base-fields";
 
 /**
  * Response from Workflow.start()
@@ -48,8 +48,9 @@ export interface ActivityProgressType {
  */
 export type ActivityInstanceFieldsType = {
   _id: StringFieldType;
+  BPInstanceId: StringFieldType;
   Status: SelectFieldType<"InProgress" | "Completed">;
-  AssignedTo: ReferenceFieldType<UserRefType>;
+  AssignedTo: UserFieldType[];
   CompletedAt: DateTimeFieldType;
 };
 
@@ -62,17 +63,17 @@ export type ActivityInstanceFieldsType = {
 export interface ActivityOperations<T> {
   // ── List-level ──────────────────────────────────────────────
 
-  /** List in-progress activity instances (GET .../inprogress/list) */
-  inProgressList(): Promise<ListResponseType<ActivityInstanceFieldsType & T>>;
+  /** List in-progress activity instances (POST .../inprogress/list) */
+  inProgressList(options?: ListOptionsType): Promise<ListResponseType<ActivityInstanceFieldsType & T>>;
 
-  /** List completed activity instances (GET .../completed/list) */
-  completedList(): Promise<ListResponseType<ActivityInstanceFieldsType & T>>;
+  /** List completed activity instances (POST .../completed/list) */
+  completedList(options?: ListOptionsType): Promise<ListResponseType<ActivityInstanceFieldsType & T>>;
 
-  /** Get in-progress activity metrics (GET .../inprogress/metric) */
-  inProgressMetric(): Promise<MetricResponseType>;
+  /** Get in-progress activity count (POST .../inprogress/metric) */
+  inProgressMetric(options?: ListOptionsType): Promise<CountResponseType>;
 
-  /** Get completed activity metrics (GET .../completed/metric) */
-  completedMetric(): Promise<MetricResponseType>;
+  /** Get completed activity count (POST .../completed/metric) */
+  completedMetric(options?: ListOptionsType): Promise<CountResponseType>;
 
   // ── Instance-level ──────────────────────────────────────────
 

package/sdk/workflow.ts

@@ -17,9 +17,18 @@ export type {
   ActivityProgressType,
   WorkflowStartResponseType,
 } from './workflow/types';
+export { createFieldFromMeta, buildFieldsFromInput } from './workflow/createFieldFromMeta';
 
-export { useActivityForm } from './workflow/components/useActivityForm';
+export { useActivityForm } from './components/hooks/useActivityForm';
 export type {
   UseActivityFormOptions,
   UseActivityFormReturn,
-} from './workflow/components/useActivityForm';
+} from './components/hooks/useActivityForm';
+
+export { useActivityTable, ActivityTableStatus } from './components/hooks/useActivityTable';
+export type {
+  UseActivityTableOptionsType,
+  UseActivityTableReturnType,
+  ActivityTableStatusType,
+  ActivityRowType,
+} from './components/hooks/useActivityTable';

package/sdk/workflow.types.ts

@@ -9,3 +9,10 @@ export type {
   ActivityProgressType,
   WorkflowStartResponseType,
 } from './workflow/types';
+
+export type {
+  UseActivityTableOptionsType,
+  UseActivityTableReturnType,
+  ActivityTableStatusType,
+  ActivityRowType,
+} from './components/hooks/useActivityTable/types';

package/dist/BaseField-B6da88U7.js

@@ -1,40 +0,0 @@
-var i = Object.defineProperty;
-var s = (t, e, a) => e in t ? i(t, e, { enumerable: !0, configurable: !0, writable: !0, value: a }) : t[e] = a;
-var r = (t, e, a) => s(t, typeof e != "symbol" ? e + "" : e, a);
-class u {
-  constructor(e) {
-    /** Full raw backend meta */
-    r(this, "_meta");
-    r(this, "_parentBoId");
-    this._meta = e;
-  }
-  // === Convenience getters (transform backend naming → SDK naming) ===
-  get id() {
-    return this._meta._id;
-  }
-  get label() {
-    return this._meta.Name || this._meta._id;
-  }
-  get readOnly() {
-    return this._meta.ReadOnly ?? !1;
-  }
-  get required() {
-    var e;
-    return ((e = this._meta.Constraint) == null ? void 0 : e.Required) ?? this._meta.Required ?? !1;
-  }
-  get defaultValue() {
-    var e;
-    return this._meta.DefaultValue ?? ((e = this._meta.Constraint) == null ? void 0 : e.DefaultValue);
-  }
-  get primaryKey() {
-    var e;
-    return ((e = this._meta.Constraint) == null ? void 0 : e.PrimaryKey) ?? !1;
-  }
-  /** Full raw meta (the exact JSON passed to constructor) */
-  get meta() {
-    return this._meta;
-  }
-}
-export {
-  u as B
-};

package/dist/BaseField-Drp0-OxL.cjs

@@ -1 +0,0 @@
-"use strict";var i=Object.defineProperty;var s=(t,e,a)=>e in t?i(t,e,{enumerable:!0,configurable:!0,writable:!0,value:a}):t[e]=a;var r=(t,e,a)=>s(t,typeof e!="symbol"?e+"":e,a);class u{constructor(e){r(this,"_meta");r(this,"_parentBoId");this._meta=e}get id(){return this._meta._id}get label(){return this._meta.Name||this._meta._id}get readOnly(){return this._meta.ReadOnly??!1}get required(){var e;return((e=this._meta.Constraint)==null?void 0:e.Required)??this._meta.Required??!1}get defaultValue(){var e;return this._meta.DefaultValue??((e=this._meta.Constraint)==null?void 0:e.DefaultValue)}get primaryKey(){var e;return((e=this._meta.Constraint)==null?void 0:e.PrimaryKey)??!1}get meta(){return this._meta}}exports.BaseField=u;

package/dist/error-handling-CAoD0Kwb.cjs

@@ -1 +0,0 @@
-"use strict";function o(t){if(t instanceof Error)return t;if(typeof t=="string")return new Error(t);if(t!==null&&typeof t=="object"&&"message"in t&&typeof t.message=="string"){const n=new Error(t.message);return Object.assign(n,t),n}return new Error(String(t))}exports.toError=o;

package/dist/error-handling-CrhTtD88.js

@@ -1,14 +0,0 @@
-function o(n) {
-  if (n instanceof Error)
-    return n;
-  if (typeof n == "string")
-    return new Error(n);
-  if (n !== null && typeof n == "object" && "message" in n && typeof n.message == "string") {
-    const t = new Error(n.message);
-    return Object.assign(t, n), t;
-  }
-  return new Error(String(n));
-}
-export {
-  o as t
-};