@ram_28/kf-ai-sdk 2.0.12 → 2.0.13

package/docs/workflow.md

@@ -11,8 +11,6 @@ import {
   Activity,
   ActivityInstance,
   useActivityForm,
-  useActivityTable,
-  ActivityTableStatus,
 } from "@ram_28/kf-ai-sdk/workflow";
 
 // Type-only exports
@@ -22,9 +20,6 @@ import type {
   WorkflowStartResponseType,
   UseActivityFormOptions,
   UseActivityFormReturn,
-  UseActivityTableOptionsType,
-  UseActivityTableReturnType,
-  ActivityRowType,
 } from "@ram_28/kf-ai-sdk/workflow";
 
 // Field classes (for defining Activity fields)
@@ -87,72 +82,11 @@ System fields present on every activity instance. Returned alongside activity-sp
 type ActivityInstanceFieldsType = {
   _id: StringFieldType;
   Status: SelectFieldType<"InProgress" | "Completed">;
-  AssignedTo: UserFieldType;
+  AssignedTo: ReferenceFieldType<{ _id: StringFieldType; username: StringFieldType }>;
   CompletedAt: DateTimeFieldType;
 };
 ```
 
-### ActivityTableStatus (constant)
-
-```typescript
-const ActivityTableStatus = {
-  InProgress: 'inprogress',
-  Completed: 'completed',
-} as const;
-
-type ActivityTableStatusType =
-  (typeof ActivityTableStatus)[keyof typeof ActivityTableStatus];
-```
-
-### ActivityRowType\<A\>
-
-Row type for activity table data. Combines activity instance system fields with entity-specific fields.
-
-```typescript
-type ActivityRowType<A extends Activity<any, any, any>> =
-  ActivityInstanceFieldsType & ExtractActivityEntity<A>;
-```
-
-Concrete example — for `ManagerApprovalActivity` with `{ ManagerApproved: boolean, ManagerReason: string }`:
-
-```typescript
-// ActivityRowType<ManagerApprovalActivity> resolves to:
-{
-  // System fields (from ActivityInstanceFieldsType)
-  _id: string;
-  Status: "InProgress" | "Completed";
-  AssignedTo: UserFieldType;
-  CompletedAt: string;
-
-  // Entity fields (from ManagerApprovalEntityType)
-  ManagerApproved: boolean;
-  ManagerReason: string;
-}
-```
-
-### UseActivityTableOptionsType\<A\>
-
-```typescript
-interface UseActivityTableOptionsType<A extends Activity<any, any, any>> {
-  status: ActivityTableStatusType;
-  onError?: (error: Error) => void;
-  onSuccess?: (data: ActivityRowType<A>[]) => void;
-}
-```
-
-### UseActivityTableReturnType\<A\>
-
-```typescript
-interface UseActivityTableReturnType<A extends Activity<any, any, any>> {
-  rows: ActivityRowType<A>[];
-  totalItems: number;
-  isLoading: boolean;
-  isFetching: boolean;
-  error: Error | null;
-  refetch: () => Promise<ListResponseType<ActivityRowType<A>>>;
-}
-```
-
 ### UseActivityFormOptions\<A\>
 
 ```typescript
@@ -448,40 +382,6 @@ User clicks Complete
 
 ---
 
-## useActivityTable Hook
-
-React hook for listing workflow activity instances. Fetches data from
-`getInProgressList()` or `getCompletedList()` and the corresponding
-metrics endpoint.
-
-### Signature
-
-```typescript
-useActivityTable(activity: A, options: UseActivityTableOptionsType<A>)
-  : UseActivityTableReturnType<A>
-```
-
-### Options
-
-| Property | Type | Default | Description |
-|----------|------|---------|-------------|
-| `status` | `ActivityTableStatusType` | *required* | `ActivityTableStatus.InProgress` or `ActivityTableStatus.Completed` |
-| `onError` | `(error: Error) => void` | — | Error callback |
-| `onSuccess` | `(data: ActivityRowType<A>[]) => void` | — | Success callback |
-
-### Return Value
-
-| Property | Type | Description |
-|----------|------|-------------|
-| `rows` | `ActivityRowType<A>[]` | Activity instance records (system + entity fields) |
-| `totalItems` | `number` | Total count (from metrics endpoint) |
-| `isLoading` | `boolean` | Initial load in progress |
-| `isFetching` | `boolean` | Any fetch in progress (including refetch) |
-| `error` | `Error \| null` | Fetch error |
-| `refetch` | `() => Promise<...>` | Refetch both list and metrics |
-
----
-
 ## Use Case: Employee Creating Leave
 
 ### Step 1 — Start the workflow
@@ -642,63 +542,18 @@ function LeaveRequestPage() {
 
 ## Use Case: Manager Approving Leave
 
-### Step 1 — List in-progress items with useActivityTable
+### Step 1 — List in-progress items
 
-```tsx
-import { useMemo, useState } from "react";
-import { useActivityTable, ActivityTableStatus } from "@ram_28/kf-ai-sdk/workflow";
-import { SimpleLeaveProcess, ManagerApprovalActivity } from "@/bdo/workflows/SimpleLeaveProcess";
-
-function ManagerApprovalPage() {
-  const activity = useMemo(() => new SimpleLeaveProcess().managerApprovalActivity(), []);
-  const [selectedId, setSelectedId] = useState<string | null>(null);
+```typescript
+import { SimpleLeaveProcess } from "@/bdo/workflows/SimpleLeaveProcess";
 
-  const { rows, totalItems, isLoading, error, refetch } = useActivityTable(activity, {
-    status: ActivityTableStatus.InProgress,
-  });
+const wf = new SimpleLeaveProcess();
+const activity = wf.managerApprovalActivity();
 
-  if (isLoading) return <div>Loading...</div>;
-  if (error) return <div>Error: {error.message}</div>;
-
-  if (selectedId) {
-    return (
-      <ApprovalForm
-        activityInstanceId={selectedId}
-        onComplete={() => {
-          setSelectedId(null);
-          refetch();
-        }}
-      />
-    );
-  }
+const result = await activity.getInProgressList();
 
-  return (
-    <div>
-      <h2>Pending Approvals ({totalItems})</h2>
-      <table>
-        <thead>
-          <tr>
-            <th>ID</th>
-            <th>Status</th>
-            <th>Assigned To</th>
-            <th>Action</th>
-          </tr>
-        </thead>
-        <tbody>
-          {rows.map((row) => (
-            <tr key={row._id}>
-              <td>{row._id}</td>
-              <td>{row.Status}</td>
-              <td>{row.AssignedTo._name}</td>
-              <td>
-                <button onClick={() => setSelectedId(row._id)}>Review</button>
-              </td>
-            </tr>
-          ))}
-        </tbody>
-      </table>
-    </div>
-  );
+for (const item of result.Data) {
+  console.log(item._id, item.Status, item.AssignedTo.username);
 }
 ```
 
@@ -848,7 +703,7 @@ const progressList = await wf.progress(BPInstanceId);
 |-------|------|-------------|
 | `_id` | `StringFieldType` | Unique activity instance identifier |
 | `Status` | `SelectFieldType<"InProgress" \| "Completed">` | Current status |
-| `AssignedTo` | `UserFieldType` | Assigned user (has `._id` and `._name`) |
+| `AssignedTo` | `ReferenceFieldType<UserRefType>` | Assigned user (has `._id` and `.username`) |
 | `CompletedAt` | `DateTimeFieldType` | Completion timestamp (`"YYYY-MM-DDTHH:MM:SS"`) |
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ram_28/kf-ai-sdk",
-  "version": "2.0.12",
+  "version": "2.0.13",
   "description": "Type-safe, AI-driven SDK for building modern web applications with role-based access control",
   "author": "Ramprasad",
   "license": "MIT",

package/sdk/api/client.ts

@@ -253,7 +253,7 @@ export function createResourceClient<T = any>(
         throw new Error(`Failed to create ${basePath}: ${response.statusText}`);
       }
 
-      return response.json();
+      return (await response.json()).Data;
     },
 
     async update(
@@ -272,7 +272,7 @@ export function createResourceClient<T = any>(
         );
       }
 
-      return response.json();
+      return (await response.json()).Data;
     },
 
     async delete(id: string): Promise<DeleteResponseType> {
@@ -555,7 +555,12 @@ export function createResourceClient<T = any>(
 
       const responseData: { Data: FileDownloadResponseType } =
         await response.json();
-      return responseData.Data;
+      const downloadData = responseData.Data;
+      // Normalize: runtime returns DownloadUrl, components expect URL
+      if (downloadData && (downloadData as any).DownloadUrl && !(downloadData as any).URL) {
+        (downloadData as any).URL = (downloadData as any).DownloadUrl;
+      }
+      return downloadData;
     },
 
     async getDownloadUrls(
@@ -578,7 +583,16 @@ export function createResourceClient<T = any>(
 
       const responseData: { Data: FileDownloadResponseType[] } =
         await response.json();
-      return responseData.Data;
+      const downloadList = responseData.Data;
+      // Normalize: runtime returns DownloadUrl, components expect URL
+      if (Array.isArray(downloadList)) {
+        downloadList.forEach((item) => {
+          if (item && (item as any).DownloadUrl && !(item as any).URL) {
+            (item as any).URL = (item as any).DownloadUrl;
+          }
+        });
+      }
+      return downloadList;
     },
 
     async deleteAttachment(

package/sdk/bdo/core/types.ts

@@ -119,6 +119,7 @@ export interface UserFieldMetaType extends BaseFieldMetaType {
   Type: "User";
   Constraint?: BaseConstraintType;
   View?: {
+    DataObject?: { Type: string; Id: string };
     Filter?: Record<string, unknown>;
     Sort?: unknown[];
     BusinessEntity?: string;

package/sdk/bdo/fields/NumberField.ts

@@ -27,7 +27,8 @@ export class NumberField extends BaseField<NumberFieldType> {
   get fractionPart(): number | undefined { return (this._meta as NumberFieldMetaType).Constraint?.FractionPart; }
 
   validate(value: NumberFieldType | undefined): ValidationResultType {
-    if (value !== undefined && value !== null && (typeof value !== "number" || isNaN(value))) {
+    if (value == null || value === ("" as any)) return { valid: true, errors: [] };
+    if (typeof value !== "number" || isNaN(value)) {
       return {
         valid: false,
         errors: [`${this.label} must be a valid number`],

package/sdk/bdo/fields/ReferenceField.ts

@@ -68,14 +68,15 @@ export class ReferenceField<TRef = unknown> extends BaseField<
   }
 
   /**
-   * Fetch referenced records from the backend, returned as typed TRef[]
+   * Fetch referenced records from the backend via the fetchField API.
+   * Requires the field to be bound to a parent BDO.
    */
-  async fetchOptions(instanceId?: string): Promise<TRef[]> {
+  async fetchOptions(instanceId: string): Promise<TRef[]> {
     if (!this._parentBoId) {
       throw new Error(
         `Field ${this.id} not bound to a BDO. Cannot fetch options.`
       );
     }
-    return api(this._parentBoId).fetchField<TRef>(instanceId ?? "new", this.id);
+    return api(this._parentBoId).fetchField<TRef>(instanceId, this.id);
   }
 }

package/sdk/bdo/fields/SelectField.ts

@@ -57,14 +57,14 @@ export class SelectField<T extends string | number = string> extends BaseField<T
   /**
    * Fetch dynamic options from the backend, returned as typed SelectOption[]
    */
-  async fetchOptions(instanceId?: string): Promise<SelectOptionType<T>[]> {
+  async fetchOptions(instanceId: string): Promise<SelectOptionType<T>[]> {
     if (!this._parentBoId) {
       throw new Error(
         `Field ${this.id} not bound to a BDO. Cannot fetch options.`
       );
     }
     const response = await api(this._parentBoId).fetchField<FetchFieldOptionType>(
-      instanceId ?? "new",
+      instanceId,
       this.id
     );
     return response.map((item) => ({

package/sdk/bdo/fields/UserField.ts

@@ -5,6 +5,7 @@
 
 import type { UserFieldType } from "../../types/base-fields";
 import type { UserFieldMetaType, ValidationResultType } from "../core/types";
+import { api } from "../../api/client";
 import { BaseField } from "./BaseField";
 
 /**
@@ -27,6 +28,19 @@ export class UserField extends BaseField<UserFieldType> {
     return (this._meta as UserFieldMetaType).View?.BusinessEntity;
   }
 
+  /**
+   * Fetch user records from the backend via the fetchField API.
+   * Requires the field to be bound to a parent BDO.
+   */
+  async fetchOptions(instanceId: string): Promise<UserFieldType[]> {
+    if (!this._parentBoId) {
+      throw new Error(
+        `Field ${this.id} not bound to a BDO. Cannot fetch options.`
+      );
+    }
+    return api(this._parentBoId).fetchField<UserFieldType>(instanceId, this.id);
+  }
+
   validate(value: UserFieldType | undefined): ValidationResultType {
     if (value === undefined || value === null) {
       return { valid: true, errors: [] };

package/sdk/components/hooks/useForm/createItemProxy.ts

@@ -2,6 +2,10 @@ import type { UseFormReturn, Path, FieldValues } from "react-hook-form";
 import type { BaseBdo } from "../../../bdo";
 import type { BaseFieldMetaType } from "../../../bdo/core/types";
 import type { BaseField } from "../../../bdo/fields/BaseField";
+import type { FileType } from "../../../types/base-fields";
+import type { FileDownloadResponseType, AttachmentViewType } from "../../../types/common";
+import { api } from "../../../api/client";
+import { validateFileExtension, extractFileExtension } from "../../../bdo/fields/attachment-constants";
 import { validateConstraints } from "./createResolver";
 import type {
   FormItemType,
@@ -17,6 +21,10 @@ import type {
  * Key principle: Item has NO state. It's a view over RHF's state.
  * Editable fields get set(), readonly fields do not.
  *
+ * Draft-based upload: In create mode (no _id), upload() automatically creates
+ * a draft record via draftInteraction() to get an _id, then uploads immediately.
+ * On form submit, if a draft _id exists, update() is used instead of create().
+ *
  * @param bdo - The BDO instance for field metadata
  * @param form - The RHF useForm return object
  * @returns SmartFormItem proxy
@@ -28,6 +36,35 @@ export function createItemProxy<B extends BaseBdo<any, any, any>>(
   const fields = bdo.getFields();
   const accessorCache = new Map<string, EditableFormFieldAccessorType<unknown> | ReadonlyFormFieldAccessorType<unknown>>();
 
+  // Draft tracking for create mode — shared across all attachment fields in this form
+  const boIdShared = bdo.getBoId();
+  let draftId: string | null = null;
+  let draftPromise: Promise<string> | null = null;
+
+  /**
+   * Ensures a record _id exists for attachment uploads.
+   * In edit mode, returns the existing _id.
+   * In create mode, creates a draft record via draftInteraction() to get an _id.
+   * The draft _id is shared across all attachment fields and only created once.
+   */
+  async function ensureDraft(): Promise<string> {
+    // If form already has an _id (edit mode or previous draft), use it
+    const existing = form.getValues("_id" as Path<FieldValues>) as string | undefined;
+    if (existing) return existing;
+    if (draftId) return draftId;
+    if (!draftPromise) {
+      draftPromise = api(boIdShared).draftInteraction({}).then((d: any) => {
+        draftId = d._id;
+        form.setValue("_id" as Path<FieldValues>, draftId as any, { shouldDirty: false });
+        return draftId!;
+      }).catch((err: Error) => {
+        draftPromise = null;
+        throw err;
+      });
+    }
+    return draftPromise;
+  }
+
   return new Proxy({} as FormItemType<ExtractEditableType<B>, ExtractReadonlyType<B>>, {
     get(_, prop: string | symbol) {
       // Handle symbol properties (e.g., Symbol.toStringTag)
@@ -50,6 +87,11 @@ export function createItemProxy<B extends BaseBdo<any, any, any>>(
         return () => form.trigger();
       }
 
+      // Internal: check if a draft was created (used by handleSubmit)
+      if (prop === "_hasDraft") {
+        return () => !!draftId;
+      }
+
       // Return cached accessor if available
       if (accessorCache.has(prop)) {
         return accessorCache.get(prop);
@@ -67,7 +109,21 @@ export function createItemProxy<B extends BaseBdo<any, any, any>>(
       // Full validation: type + constraint + expression (matches createResolver pipeline)
       const validate = () => {
         if (!bdoField) return { valid: true, errors: [] };
-        const value = form.getValues(prop as Path<FieldValues>);
+        let value = form.getValues(prop as Path<FieldValues>);
+
+        // Coerce string → number for NumberField (HTML inputs always send strings)
+        if ("integerPart" in bdoField && typeof value === "string" && value !== "") {
+          const num = Number(value);
+          if (!isNaN(num)) {
+            value = num;
+            form.setValue(prop as Path<FieldValues>, num as any, { shouldDirty: false });
+          }
+        }
+
+        // Match backend BDO core: skip ALL validation for non-required empty fields
+        if (!bdoField.required && (value == null || value === "" || (Array.isArray(value) && value.length === 0))) {
+          return { valid: true, errors: [] };
+        }
 
         // 1. Type validation
         const typeResult = bdoField.validate(value);
@@ -98,13 +154,20 @@ export function createItemProxy<B extends BaseBdo<any, any, any>>(
       };
 
       if (!isReadOnly) {
+        // Defensive get(): File fields return [] instead of null/undefined, Image returns null
+        const fieldGet = () => {
+          const val = form.getValues(prop as Path<FieldValues>);
+          if (fieldMeta.Type === "File") return val ?? [];
+          return val;
+        };
+
         const accessor: EditableFormFieldAccessorType<unknown> = {
           label: bdoField?.label ?? prop,
           required: bdoField?.required ?? false,
           readOnly: false,
           defaultValue: bdoField?.defaultValue,
           meta: fieldMeta,
-          get: () => form.getValues(prop as Path<FieldValues>),
+          get: fieldGet,
           getOrDefault,
           set: (value: unknown) => {
             form.setValue(prop as Path<FieldValues>, value as any, {
@@ -115,20 +178,172 @@ export function createItemProxy<B extends BaseBdo<any, any, any>>(
           },
           validate,
         };
+
+        // Enrich Image/File field accessors with attachment methods (draft-based upload)
+        if (fieldMeta.Type === "Image" || fieldMeta.Type === "File") {
+          const boId = boIdShared;
+          const requireInstanceId = (): string => {
+            const id = form.getValues("_id" as Path<FieldValues>) as string | undefined;
+            if (!id) throw new Error("Save the record before attachment operations");
+            return id;
+          };
+
+          if (fieldMeta.Type === "Image") {
+            // Image: single file upload — always uploads immediately (draft in create mode)
+            (accessor as any).upload = async (file: File): Promise<FileType> => {
+              validateFileExtension(file.name, "Image");
+              const id = await ensureDraft();
+
+              const [uploadInfo] = await api(boId).getUploadUrl(id, prop, [
+                { FileName: file.name, Size: file.size, FileExtension: extractFileExtension(file.name) },
+              ]);
+              await fetch(uploadInfo.UploadUrl.URL, {
+                method: "PUT",
+                headers: { "Content-Type": uploadInfo.ContentType },
+                body: file,
+              });
+              const metadata: FileType = {
+                _id: uploadInfo._id,
+                _name: uploadInfo._name,
+                FileName: uploadInfo.FileName,
+                FileExtension: uploadInfo.FileExtension,
+                Size: uploadInfo.Size,
+                ContentType: uploadInfo.ContentType,
+              };
+              form.setValue(prop as Path<FieldValues>, metadata as any, { shouldDirty: true });
+              return metadata;
+            };
+
+            (accessor as any).deleteAttachment = async (): Promise<void> => {
+              const val = form.getValues(prop as Path<FieldValues>) as any;
+              const instanceId = requireInstanceId();
+              if (!(val?._id)) throw new Error(`${prop} has no image to delete`);
+              await api(boId).deleteAttachment(instanceId, prop, val._id);
+              form.setValue(prop as Path<FieldValues>, null as any, { shouldDirty: true });
+            };
+
+            (accessor as any).getDownloadUrl = async (viewType?: AttachmentViewType): Promise<FileDownloadResponseType> => {
+              const val = form.getValues(prop as Path<FieldValues>) as any;
+              const instanceId = requireInstanceId();
+              if (!(val?._id)) throw new Error(`${prop} has no image`);
+              return api(boId).getDownloadUrl(instanceId, prop, val._id, viewType);
+            };
+          } else {
+            // File field — multi-file, always uploads immediately (draft in create mode)
+            (accessor as any).upload = async (files: File[]): Promise<FileType[]> => {
+              for (const file of files) validateFileExtension(file.name, "File");
+              const id = await ensureDraft();
+
+              const requests = files.map((file) => ({
+                FileName: file.name,
+                Size: file.size,
+                FileExtension: extractFileExtension(file.name),
+              }));
+              const uploadInfos = await api(boId).getUploadUrl(id, prop, requests);
+              const uploaded: FileType[] = await Promise.all(
+                files.map(async (file, i) => {
+                  await fetch(uploadInfos[i].UploadUrl.URL, {
+                    method: "PUT",
+                    headers: { "Content-Type": uploadInfos[i].ContentType },
+                    body: file,
+                  });
+                  return {
+                    _id: uploadInfos[i]._id,
+                    _name: uploadInfos[i]._name,
+                    FileName: uploadInfos[i].FileName,
+                    FileExtension: uploadInfos[i].FileExtension,
+                    Size: uploadInfos[i].Size,
+                    ContentType: uploadInfos[i].ContentType,
+                  };
+                }),
+              );
+              const current = (form.getValues(prop as Path<FieldValues>) as FileType[] | undefined) ?? [];
+              form.setValue(prop as Path<FieldValues>, [...current, ...uploaded] as any, { shouldDirty: true });
+              return uploaded;
+            };
+
+            (accessor as any).deleteAttachment = async (attachmentId: string): Promise<void> => {
+              const current = (form.getValues(prop as Path<FieldValues>) as any[]) ?? [];
+              const instanceId = requireInstanceId();
+              await api(boId).deleteAttachment(instanceId, prop, attachmentId);
+              form.setValue(
+                prop as Path<FieldValues>,
+                current.filter((f) => f._id !== attachmentId) as any,
+                { shouldDirty: true },
+              );
+            };
+
+            (accessor as any).getDownloadUrl = async (
+              attachmentId: string,
+              viewType?: AttachmentViewType,
+            ): Promise<FileDownloadResponseType> => {
+              const instanceId = requireInstanceId();
+              return api(boId).getDownloadUrl(instanceId, prop, attachmentId, viewType);
+            };
+            (accessor as any).getDownloadUrls = async (
+              viewType?: AttachmentViewType,
+            ): Promise<FileDownloadResponseType[]> => {
+              const instanceId = requireInstanceId();
+              return api(boId).getDownloadUrls(instanceId, prop, viewType);
+            };
+          }
+        }
+
         accessorCache.set(prop, accessor);
         return accessor;
       }
 
+      // Defensive get() for readonly accessor too
+      const readonlyGet = () => {
+        const val = form.getValues(prop as Path<FieldValues>);
+        if (fieldMeta.Type === "File") return val ?? [];
+        return val;
+      };
+
       const accessor: ReadonlyFormFieldAccessorType<unknown> = {
         label: bdoField?.label ?? prop,
         required: bdoField?.required ?? false,
         readOnly: true,
         defaultValue: bdoField?.defaultValue,
         meta: fieldMeta,
-        get: () => form.getValues(prop as Path<FieldValues>),
+        get: readonlyGet,
         getOrDefault,
         validate,
       };
+
+      // Enrich readonly Image/File field accessors with download methods
+      if (fieldMeta.Type === "Image" || fieldMeta.Type === "File") {
+        const boId = boIdShared;
+        const requireInstanceId = (): string => {
+          const id = form.getValues("_id" as Path<FieldValues>) as string | undefined;
+          if (!id) throw new Error("Cannot perform attachment operation: item has no _id. Save the item first.");
+          return id;
+        };
+
+        if (fieldMeta.Type === "Image") {
+          (accessor as any).getDownloadUrl = async (viewType?: AttachmentViewType): Promise<FileDownloadResponseType> => {
+            const val = form.getValues(prop as Path<FieldValues>) as any;
+            const instanceId = requireInstanceId();
+            if (!(val?._id)) throw new Error(`${prop} has no image to download`);
+            return api(boId).getDownloadUrl(instanceId, prop, val._id, viewType);
+          };
+        } else {
+          (accessor as any).getDownloadUrl = async (
+            attachmentId: string,
+            viewType?: AttachmentViewType,
+          ): Promise<FileDownloadResponseType> => {
+            const instanceId = requireInstanceId();
+            return api(boId).getDownloadUrl(instanceId, prop, attachmentId, viewType);
+          };
+          (accessor as any).getDownloadUrls = async (
+            viewType?: AttachmentViewType,
+          ): Promise<FileDownloadResponseType[]> => {
+            const instanceId = requireInstanceId();
+            return api(boId).getDownloadUrls(instanceId, prop, viewType);
+          };
+        }
+      }
+
       accessorCache.set(prop, accessor);
       return accessor;
     },
@@ -137,6 +352,8 @@ export function createItemProxy<B extends BaseBdo<any, any, any>>(
       if (typeof prop === "symbol") return false;
       if (prop === "_id" || prop === "toJSON" || prop === "validate")
         return true;
+      if (prop === "_hasDraft")
+        return true;
       return prop in fields;
     },
 
@@ -148,7 +365,7 @@ export function createItemProxy<B extends BaseBdo<any, any, any>>(
       if (typeof prop === "symbol") return undefined;
       return {
         configurable: true,
-        enumerable: prop !== "toJSON" && prop !== "validate",
+        enumerable: prop !== "toJSON" && prop !== "validate" && prop !== "_hasDraft",
       };
     },
   });