@object-ui/data-objectstack 0.5.0 → 2.0.0

package/dist/index.cjs

@@ -377,11 +377,15 @@ var ObjectStackAdapter = class {
     __publicField(this, "maxReconnectAttempts");
     __publicField(this, "reconnectDelay");
     __publicField(this, "reconnectAttempts", 0);
+    __publicField(this, "baseUrl");
+    __publicField(this, "token");
     this.client = new import_client.ObjectStackClient(config);
     this.metadataCache = new MetadataCache(config.cache);
     this.autoReconnect = config.autoReconnect ?? true;
     this.maxReconnectAttempts = config.maxReconnectAttempts ?? 3;
     this.reconnectDelay = config.reconnectDelay ?? 1e3;
+    this.baseUrl = config.baseUrl;
+    this.token = config.token;
   }
   /**
    * Ensure the client is connected to the server.
@@ -521,8 +525,8 @@ var ObjectStackAdapter = class {
   async findOne(resource, id, _params) {
     await this.connect();
     try {
-      const record = await this.client.data.get(resource, String(id));
-      return record;
+      const result = await this.client.data.get(resource, String(id));
+      return result.record;
     } catch (error) {
       if (error?.status === 404) {
         return null;
@@ -535,14 +539,16 @@ var ObjectStackAdapter = class {
    */
   async create(resource, data) {
     await this.connect();
-    return this.client.data.create(resource, data);
+    const result = await this.client.data.create(resource, data);
+    return result.record;
   }
   /**
    * Update an existing record.
    */
   async update(resource, id, data) {
     await this.connect();
-    return this.client.data.update(resource, String(id), data);
+    const result = await this.client.data.update(resource, String(id), data);
+    return result.record;
   }
   /**
    * Delete a record.
@@ -550,7 +556,7 @@ var ObjectStackAdapter = class {
   async delete(resource, id) {
     await this.connect();
     const result = await this.client.data.delete(resource, String(id));
-    return result.success;
+    return result.deleted;
   }
   /**
    * Bulk operations with optimized batch processing and error handling.
@@ -632,7 +638,7 @@ var ObjectStackAdapter = class {
             }
             try {
               const result = await this.client.data.update(resource, String(id), item);
-              results.push(result);
+              results.push(result.record);
               completed++;
               emitProgress();
             } catch (error) {
@@ -757,6 +763,68 @@ var ObjectStackAdapter = class {
   getClient() {
     return this.client;
   }
+  /**
+   * Get the discovery information from the connected server.
+   * Returns the capabilities and service status of the ObjectStack server.
+   * 
+   * Note: This accesses an internal property of the ObjectStackClient.
+   * The discovery data is populated during client.connect() and cached.
+   * 
+   * @returns Promise resolving to discovery data, or null if not connected
+   */
+  async getDiscovery() {
+    try {
+      await this.connect();
+      return this.client.discoveryInfo || null;
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Get a view definition for an object.
+   * Attempts to fetch from the server metadata API.
+   * Falls back to null if the server doesn't provide view definitions,
+   * allowing the consumer to use static config.
+   * 
+   * @param objectName - Object name
+   * @param viewId - View identifier
+   * @returns Promise resolving to the view definition or null
+   */
+  async getView(objectName, viewId) {
+    await this.connect();
+    try {
+      const cacheKey = `view:${objectName}:${viewId}`;
+      return await this.metadataCache.get(cacheKey, async () => {
+        const result = await this.client.meta.getItem(objectName, `views/${viewId}`);
+        if (result && result.item) return result.item;
+        return result ?? null;
+      });
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Get an application definition by name or ID.
+   * Attempts to fetch from the server metadata API.
+   * Falls back to null if the server doesn't provide app definitions,
+   * allowing the consumer to use static config.
+   * 
+   * @param appId - Application identifier
+   * @returns Promise resolving to the app definition or null
+   */
+  async getApp(appId) {
+    await this.connect();
+    try {
+      const cacheKey = `app:${appId}`;
+      return await this.metadataCache.get(cacheKey, async () => {
+        const result = await this.client.meta.getItem("apps", appId);
+        if (result && result.item) return result.item;
+        return result ?? null;
+      });
+    } catch {
+      return null;
+    }
+  }
   /**
    * Get cache statistics for monitoring performance.
    */
@@ -777,6 +845,98 @@ var ObjectStackAdapter = class {
   clearCache() {
     this.metadataCache.clear();
   }
+  /**
+   * Upload a single file to a resource.
+   * Posts the file as multipart/form-data to the ObjectStack server.
+   *
+   * @param resource - The resource/object name to attach the file to
+   * @param file - File object or Blob to upload
+   * @param options - Additional upload options (recordId, fieldName, metadata)
+   * @returns Promise resolving to the upload result (file URL, metadata)
+   */
+  async uploadFile(resource, file, options) {
+    await this.connect();
+    const formData = new FormData();
+    formData.append("file", file);
+    if (options?.recordId) {
+      formData.append("recordId", options.recordId);
+    }
+    if (options?.fieldName) {
+      formData.append("fieldName", options.fieldName);
+    }
+    if (options?.metadata) {
+      formData.append("metadata", JSON.stringify(options.metadata));
+    }
+    const url = `${this.baseUrl}/api/data/${encodeURIComponent(resource)}/upload`;
+    const response = await fetch(url, {
+      method: "POST",
+      body: formData,
+      headers: {
+        ...this.getAuthHeaders()
+      }
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({ message: response.statusText }));
+      throw new ObjectStackError(
+        error.message || `Upload failed with status ${response.status}`,
+        "UPLOAD_ERROR",
+        response.status
+      );
+    }
+    return response.json();
+  }
+  /**
+   * Upload multiple files to a resource.
+   * Posts all files as a single multipart/form-data request.
+   *
+   * @param resource - The resource/object name to attach the files to
+   * @param files - Array of File objects or Blobs to upload
+   * @param options - Additional upload options
+   * @returns Promise resolving to array of upload results
+   */
+  async uploadFiles(resource, files, options) {
+    await this.connect();
+    const formData = new FormData();
+    files.forEach((file, idx) => {
+      formData.append(`files`, file, file.name || `file-${idx}`);
+    });
+    if (options?.recordId) {
+      formData.append("recordId", options.recordId);
+    }
+    if (options?.fieldName) {
+      formData.append("fieldName", options.fieldName);
+    }
+    if (options?.metadata) {
+      formData.append("metadata", JSON.stringify(options.metadata));
+    }
+    const url = `${this.baseUrl}/api/data/${encodeURIComponent(resource)}/upload`;
+    const response = await fetch(url, {
+      method: "POST",
+      body: formData,
+      headers: {
+        ...this.getAuthHeaders()
+      }
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({ message: response.statusText }));
+      throw new ObjectStackError(
+        error.message || `Upload failed with status ${response.status}`,
+        "UPLOAD_ERROR",
+        response.status
+      );
+    }
+    return response.json();
+  }
+  /**
+   * Get authorization headers from the adapter config.
+   */
+  getAuthHeaders() {
+    const headers = {};
+    if (this.token) {
+      headers["Authorization"] = `Bearer ${this.token}`;
+    }
+    return headers;
+  }
 };
 function createObjectStackAdapter(config) {
   return new ObjectStackAdapter(config);

package/dist/index.d.cts

@@ -1,5 +1,6 @@
 import { ObjectStackClient } from '@objectstack/client';
-import { DataSource, QueryParams, QueryResult } from '@object-ui/types';
+import { DataSource, QueryParams, QueryResult, FileUploadResult } from '@object-ui/types';
+export { FileUploadResult } from '@object-ui/types';
 
 /**
  * ObjectUI
@@ -188,6 +189,7 @@ type ConnectionStateListener = (event: ConnectionStateEvent) => void;
  * Event listener type for batch operation progress
  */
 type BatchProgressListener = (event: BatchProgressEvent) => void;
+
 /**
  * ObjectStack Data Source Adapter
  *
@@ -228,6 +230,8 @@ declare class ObjectStackAdapter<T = unknown> implements DataSource<T> {
     private maxReconnectAttempts;
     private reconnectDelay;
     private reconnectAttempts;
+    private baseUrl;
+    private token?;
     constructor(config: {
         baseUrl: string;
         token?: string;
@@ -321,6 +325,37 @@ declare class ObjectStackAdapter<T = unknown> implements DataSource<T> {
      * Get access to the underlying ObjectStack client for advanced operations.
      */
     getClient(): ObjectStackClient;
+    /**
+     * Get the discovery information from the connected server.
+     * Returns the capabilities and service status of the ObjectStack server.
+     *
+     * Note: This accesses an internal property of the ObjectStackClient.
+     * The discovery data is populated during client.connect() and cached.
+     *
+     * @returns Promise resolving to discovery data, or null if not connected
+     */
+    getDiscovery(): Promise<unknown | null>;
+    /**
+     * Get a view definition for an object.
+     * Attempts to fetch from the server metadata API.
+     * Falls back to null if the server doesn't provide view definitions,
+     * allowing the consumer to use static config.
+     *
+     * @param objectName - Object name
+     * @param viewId - View identifier
+     * @returns Promise resolving to the view definition or null
+     */
+    getView(objectName: string, viewId: string): Promise<unknown | null>;
+    /**
+     * Get an application definition by name or ID.
+     * Attempts to fetch from the server metadata API.
+     * Falls back to null if the server doesn't provide app definitions,
+     * allowing the consumer to use static config.
+     *
+     * @param appId - Application identifier
+     * @returns Promise resolving to the app definition or null
+     */
+    getApp(appId: string): Promise<unknown | null>;
     /**
      * Get cache statistics for monitoring performance.
      */
@@ -335,6 +370,40 @@ declare class ObjectStackAdapter<T = unknown> implements DataSource<T> {
      * Clear all cache entries and statistics.
      */
     clearCache(): void;
+    /**
+     * Upload a single file to a resource.
+     * Posts the file as multipart/form-data to the ObjectStack server.
+     *
+     * @param resource - The resource/object name to attach the file to
+     * @param file - File object or Blob to upload
+     * @param options - Additional upload options (recordId, fieldName, metadata)
+     * @returns Promise resolving to the upload result (file URL, metadata)
+     */
+    uploadFile(resource: string, file: File | Blob, options?: {
+        recordId?: string;
+        fieldName?: string;
+        metadata?: Record<string, unknown>;
+        onProgress?: (percent: number) => void;
+    }): Promise<FileUploadResult>;
+    /**
+     * Upload multiple files to a resource.
+     * Posts all files as a single multipart/form-data request.
+     *
+     * @param resource - The resource/object name to attach the files to
+     * @param files - Array of File objects or Blobs to upload
+     * @param options - Additional upload options
+     * @returns Promise resolving to array of upload results
+     */
+    uploadFiles(resource: string, files: (File | Blob)[], options?: {
+        recordId?: string;
+        fieldName?: string;
+        metadata?: Record<string, unknown>;
+        onProgress?: (percent: number) => void;
+    }): Promise<FileUploadResult[]>;
+    /**
+     * Get authorization headers from the adapter config.
+     */
+    private getAuthHeaders;
 }
 /**
  * Factory function to create an ObjectStack data source.

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import { ObjectStackClient } from '@objectstack/client';
-import { DataSource, QueryParams, QueryResult } from '@object-ui/types';
+import { DataSource, QueryParams, QueryResult, FileUploadResult } from '@object-ui/types';
+export { FileUploadResult } from '@object-ui/types';
 
 /**
  * ObjectUI
@@ -188,6 +189,7 @@ type ConnectionStateListener = (event: ConnectionStateEvent) => void;
  * Event listener type for batch operation progress
  */
 type BatchProgressListener = (event: BatchProgressEvent) => void;
+
 /**
  * ObjectStack Data Source Adapter
  *
@@ -228,6 +230,8 @@ declare class ObjectStackAdapter<T = unknown> implements DataSource<T> {
     private maxReconnectAttempts;
     private reconnectDelay;
     private reconnectAttempts;
+    private baseUrl;
+    private token?;
     constructor(config: {
         baseUrl: string;
         token?: string;
@@ -321,6 +325,37 @@ declare class ObjectStackAdapter<T = unknown> implements DataSource<T> {
      * Get access to the underlying ObjectStack client for advanced operations.
      */
     getClient(): ObjectStackClient;
+    /**
+     * Get the discovery information from the connected server.
+     * Returns the capabilities and service status of the ObjectStack server.
+     *
+     * Note: This accesses an internal property of the ObjectStackClient.
+     * The discovery data is populated during client.connect() and cached.
+     *
+     * @returns Promise resolving to discovery data, or null if not connected
+     */
+    getDiscovery(): Promise<unknown | null>;
+    /**
+     * Get a view definition for an object.
+     * Attempts to fetch from the server metadata API.
+     * Falls back to null if the server doesn't provide view definitions,
+     * allowing the consumer to use static config.
+     *
+     * @param objectName - Object name
+     * @param viewId - View identifier
+     * @returns Promise resolving to the view definition or null
+     */
+    getView(objectName: string, viewId: string): Promise<unknown | null>;
+    /**
+     * Get an application definition by name or ID.
+     * Attempts to fetch from the server metadata API.
+     * Falls back to null if the server doesn't provide app definitions,
+     * allowing the consumer to use static config.
+     *
+     * @param appId - Application identifier
+     * @returns Promise resolving to the app definition or null
+     */
+    getApp(appId: string): Promise<unknown | null>;
     /**
      * Get cache statistics for monitoring performance.
      */
@@ -335,6 +370,40 @@ declare class ObjectStackAdapter<T = unknown> implements DataSource<T> {
      * Clear all cache entries and statistics.
      */
     clearCache(): void;
+    /**
+     * Upload a single file to a resource.
+     * Posts the file as multipart/form-data to the ObjectStack server.
+     *
+     * @param resource - The resource/object name to attach the file to
+     * @param file - File object or Blob to upload
+     * @param options - Additional upload options (recordId, fieldName, metadata)
+     * @returns Promise resolving to the upload result (file URL, metadata)
+     */
+    uploadFile(resource: string, file: File | Blob, options?: {
+        recordId?: string;
+        fieldName?: string;
+        metadata?: Record<string, unknown>;
+        onProgress?: (percent: number) => void;
+    }): Promise<FileUploadResult>;
+    /**
+     * Upload multiple files to a resource.
+     * Posts all files as a single multipart/form-data request.
+     *
+     * @param resource - The resource/object name to attach the files to
+     * @param files - Array of File objects or Blobs to upload
+     * @param options - Additional upload options
+     * @returns Promise resolving to array of upload results
+     */
+    uploadFiles(resource: string, files: (File | Blob)[], options?: {
+        recordId?: string;
+        fieldName?: string;
+        metadata?: Record<string, unknown>;
+        onProgress?: (percent: number) => void;
+    }): Promise<FileUploadResult[]>;
+    /**
+     * Get authorization headers from the adapter config.
+     */
+    private getAuthHeaders;
 }
 /**
  * Factory function to create an ObjectStack data source.

package/dist/index.js

@@ -345,11 +345,15 @@ var ObjectStackAdapter = class {
     __publicField(this, "maxReconnectAttempts");
     __publicField(this, "reconnectDelay");
     __publicField(this, "reconnectAttempts", 0);
+    __publicField(this, "baseUrl");
+    __publicField(this, "token");
     this.client = new ObjectStackClient(config);
     this.metadataCache = new MetadataCache(config.cache);
     this.autoReconnect = config.autoReconnect ?? true;
     this.maxReconnectAttempts = config.maxReconnectAttempts ?? 3;
     this.reconnectDelay = config.reconnectDelay ?? 1e3;
+    this.baseUrl = config.baseUrl;
+    this.token = config.token;
   }
   /**
    * Ensure the client is connected to the server.
@@ -489,8 +493,8 @@ var ObjectStackAdapter = class {
   async findOne(resource, id, _params) {
     await this.connect();
     try {
-      const record = await this.client.data.get(resource, String(id));
-      return record;
+      const result = await this.client.data.get(resource, String(id));
+      return result.record;
     } catch (error) {
       if (error?.status === 404) {
         return null;
@@ -503,14 +507,16 @@ var ObjectStackAdapter = class {
    */
   async create(resource, data) {
     await this.connect();
-    return this.client.data.create(resource, data);
+    const result = await this.client.data.create(resource, data);
+    return result.record;
   }
   /**
    * Update an existing record.
    */
   async update(resource, id, data) {
     await this.connect();
-    return this.client.data.update(resource, String(id), data);
+    const result = await this.client.data.update(resource, String(id), data);
+    return result.record;
   }
   /**
    * Delete a record.
@@ -518,7 +524,7 @@ var ObjectStackAdapter = class {
   async delete(resource, id) {
     await this.connect();
     const result = await this.client.data.delete(resource, String(id));
-    return result.success;
+    return result.deleted;
   }
   /**
    * Bulk operations with optimized batch processing and error handling.
@@ -600,7 +606,7 @@ var ObjectStackAdapter = class {
             }
             try {
               const result = await this.client.data.update(resource, String(id), item);
-              results.push(result);
+              results.push(result.record);
               completed++;
               emitProgress();
             } catch (error) {
@@ -725,6 +731,68 @@ var ObjectStackAdapter = class {
   getClient() {
     return this.client;
   }
+  /**
+   * Get the discovery information from the connected server.
+   * Returns the capabilities and service status of the ObjectStack server.
+   * 
+   * Note: This accesses an internal property of the ObjectStackClient.
+   * The discovery data is populated during client.connect() and cached.
+   * 
+   * @returns Promise resolving to discovery data, or null if not connected
+   */
+  async getDiscovery() {
+    try {
+      await this.connect();
+      return this.client.discoveryInfo || null;
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Get a view definition for an object.
+   * Attempts to fetch from the server metadata API.
+   * Falls back to null if the server doesn't provide view definitions,
+   * allowing the consumer to use static config.
+   * 
+   * @param objectName - Object name
+   * @param viewId - View identifier
+   * @returns Promise resolving to the view definition or null
+   */
+  async getView(objectName, viewId) {
+    await this.connect();
+    try {
+      const cacheKey = `view:${objectName}:${viewId}`;
+      return await this.metadataCache.get(cacheKey, async () => {
+        const result = await this.client.meta.getItem(objectName, `views/${viewId}`);
+        if (result && result.item) return result.item;
+        return result ?? null;
+      });
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Get an application definition by name or ID.
+   * Attempts to fetch from the server metadata API.
+   * Falls back to null if the server doesn't provide app definitions,
+   * allowing the consumer to use static config.
+   * 
+   * @param appId - Application identifier
+   * @returns Promise resolving to the app definition or null
+   */
+  async getApp(appId) {
+    await this.connect();
+    try {
+      const cacheKey = `app:${appId}`;
+      return await this.metadataCache.get(cacheKey, async () => {
+        const result = await this.client.meta.getItem("apps", appId);
+        if (result && result.item) return result.item;
+        return result ?? null;
+      });
+    } catch {
+      return null;
+    }
+  }
   /**
    * Get cache statistics for monitoring performance.
    */
@@ -745,6 +813,98 @@ var ObjectStackAdapter = class {
   clearCache() {
     this.metadataCache.clear();
   }
+  /**
+   * Upload a single file to a resource.
+   * Posts the file as multipart/form-data to the ObjectStack server.
+   *
+   * @param resource - The resource/object name to attach the file to
+   * @param file - File object or Blob to upload
+   * @param options - Additional upload options (recordId, fieldName, metadata)
+   * @returns Promise resolving to the upload result (file URL, metadata)
+   */
+  async uploadFile(resource, file, options) {
+    await this.connect();
+    const formData = new FormData();
+    formData.append("file", file);
+    if (options?.recordId) {
+      formData.append("recordId", options.recordId);
+    }
+    if (options?.fieldName) {
+      formData.append("fieldName", options.fieldName);
+    }
+    if (options?.metadata) {
+      formData.append("metadata", JSON.stringify(options.metadata));
+    }
+    const url = `${this.baseUrl}/api/data/${encodeURIComponent(resource)}/upload`;
+    const response = await fetch(url, {
+      method: "POST",
+      body: formData,
+      headers: {
+        ...this.getAuthHeaders()
+      }
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({ message: response.statusText }));
+      throw new ObjectStackError(
+        error.message || `Upload failed with status ${response.status}`,
+        "UPLOAD_ERROR",
+        response.status
+      );
+    }
+    return response.json();
+  }
+  /**
+   * Upload multiple files to a resource.
+   * Posts all files as a single multipart/form-data request.
+   *
+   * @param resource - The resource/object name to attach the files to
+   * @param files - Array of File objects or Blobs to upload
+   * @param options - Additional upload options
+   * @returns Promise resolving to array of upload results
+   */
+  async uploadFiles(resource, files, options) {
+    await this.connect();
+    const formData = new FormData();
+    files.forEach((file, idx) => {
+      formData.append(`files`, file, file.name || `file-${idx}`);
+    });
+    if (options?.recordId) {
+      formData.append("recordId", options.recordId);
+    }
+    if (options?.fieldName) {
+      formData.append("fieldName", options.fieldName);
+    }
+    if (options?.metadata) {
+      formData.append("metadata", JSON.stringify(options.metadata));
+    }
+    const url = `${this.baseUrl}/api/data/${encodeURIComponent(resource)}/upload`;
+    const response = await fetch(url, {
+      method: "POST",
+      body: formData,
+      headers: {
+        ...this.getAuthHeaders()
+      }
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({ message: response.statusText }));
+      throw new ObjectStackError(
+        error.message || `Upload failed with status ${response.status}`,
+        "UPLOAD_ERROR",
+        response.status
+      );
+    }
+    return response.json();
+  }
+  /**
+   * Get authorization headers from the adapter config.
+   */
+  getAuthHeaders() {
+    const headers = {};
+    if (this.token) {
+      headers["Authorization"] = `Bearer ${this.token}`;
+    }
+    return headers;
+  }
 };
 function createObjectStackAdapter(config) {
   return new ObjectStackAdapter(config);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@object-ui/data-objectstack",
-  "version": "0.5.0",
+  "version": "2.0.0",
   "description": "ObjectStack Data Adapter for Object UI",
   "license": "MIT",
   "type": "module",
@@ -20,14 +20,14 @@
     "README.md"
   ],
   "dependencies": {
-    "@objectstack/client": "^0.9.1",
-    "@object-ui/core": "0.5.0",
-    "@object-ui/types": "0.5.0"
+    "@objectstack/client": "^2.0.7",
+    "@object-ui/core": "2.0.0",
+    "@object-ui/types": "2.0.0"
   },
   "devDependencies": {
     "tsup": "^8.0.1",
     "typescript": "^5.3.3",
-    "vitest": "^1.2.0"
+    "vitest": "^4.0.18"
   },
   "publishConfig": {
     "access": "public"

package/src/connection.test.ts

@@ -98,3 +98,44 @@ describe('Batch Progress Events', () => {
     unsubscribe();
   });
 });
+
+describe('getDiscovery', () => {
+  it('should return discoveryInfo from the underlying client after connect', async () => {
+    const mockDiscovery = {
+      name: 'test-server',
+      version: '1.0.0',
+      services: {
+        auth: { enabled: false, status: 'unavailable' },
+        data: { enabled: true, status: 'available' },
+      },
+    };
+
+    const adapter = new ObjectStackAdapter({
+      baseUrl: 'http://localhost:3000',
+      autoReconnect: false,
+    });
+
+    // Mock the underlying client's connect method and discoveryInfo property
+    const client = adapter.getClient();
+    vi.spyOn(client, 'connect').mockResolvedValue(mockDiscovery as any);
+    // Simulate what connect() does: sets discoveryInfo
+    (client as any).discoveryInfo = mockDiscovery;
+
+    const discovery = await adapter.getDiscovery();
+    expect(discovery).toEqual(mockDiscovery);
+    expect((discovery as any)?.services?.auth?.enabled).toBe(false);
+  });
+
+  it('should return null when connection fails', async () => {
+    const adapter = new ObjectStackAdapter({
+      baseUrl: 'http://localhost:3000',
+      autoReconnect: false,
+    });
+
+    const client = adapter.getClient();
+    vi.spyOn(client, 'connect').mockRejectedValue(new Error('Connection failed'));
+
+    const discovery = await adapter.getDiscovery();
+    expect(discovery).toBeNull();
+  });
+});

package/src/errors.test.ts

@@ -270,7 +270,7 @@ describe('Error Helpers', () => {
 
       expect(error).toBeInstanceOf(MetadataNotFoundError);
       expect(error.statusCode).toBe(404);
-      expect((error as MetadataNotFoundError).details.objectName).toBe('users');
+      expect((error as MetadataNotFoundError).details?.objectName).toBe('users');
     });
 
     it('should create generic error for 404 without metadata context', () => {

package/src/index.ts

@@ -7,7 +7,7 @@
  */
 
 import { ObjectStackClient, type QueryOptions as ObjectStackQueryOptions } from '@objectstack/client';
-import type { DataSource, QueryParams, QueryResult } from '@object-ui/types';
+import type { DataSource, QueryParams, QueryResult, FileUploadResult } from '@object-ui/types';
 import { convertFiltersToAST } from '@object-ui/core';
 import { MetadataCache } from './cache/MetadataCache';
 import {
@@ -53,6 +53,9 @@ export type ConnectionStateListener = (event: ConnectionStateEvent) => void;
  */
 export type BatchProgressListener = (event: BatchProgressEvent) => void;
 
+// Re-export FileUploadResult from types for consumers
+export type { FileUploadResult } from '@object-ui/types';
+
 /**
  * ObjectStack Data Source Adapter
  * 
@@ -93,6 +96,8 @@ export class ObjectStackAdapter<T = unknown> implements DataSource<T> {
   private maxReconnectAttempts: number;
   private reconnectDelay: number;
   private reconnectAttempts: number = 0;
+  private baseUrl: string;
+  private token?: string;
 
   constructor(config: {
     baseUrl: string;
@@ -111,6 +116,8 @@ export class ObjectStackAdapter<T = unknown> implements DataSource<T> {
     this.autoReconnect = config.autoReconnect ?? true;
     this.maxReconnectAttempts = config.maxReconnectAttempts ?? 3;
     this.reconnectDelay = config.reconnectDelay ?? 1000;
+    this.baseUrl = config.baseUrl;
+    this.token = config.token;
   }
 
   /**
@@ -279,8 +286,8 @@ export class ObjectStackAdapter<T = unknown> implements DataSource<T> {
     await this.connect();
 
     try {
-      const record = await this.client.data.get<T>(resource, String(id));
-      return record;
+      const result = await this.client.data.get<T>(resource, String(id));
+      return result.record;
     } catch (error: unknown) {
       // If record not found, return null instead of throwing
       if ((error as Record<string, unknown>)?.status === 404) {
@@ -295,7 +302,8 @@ export class ObjectStackAdapter<T = unknown> implements DataSource<T> {
    */
   async create(resource: string, data: Partial<T>): Promise<T> {
     await this.connect();
-    return this.client.data.create<T>(resource, data);
+    const result = await this.client.data.create<T>(resource, data);
+    return result.record;
   }
 
   /**
@@ -303,7 +311,8 @@ export class ObjectStackAdapter<T = unknown> implements DataSource<T> {
    */
   async update(resource: string, id: string | number, data: Partial<T>): Promise<T> {
     await this.connect();
-    return this.client.data.update<T>(resource, String(id), data);
+    const result = await this.client.data.update<T>(resource, String(id), data);
+    return result.record;
   }
 
   /**
@@ -312,7 +321,7 @@ export class ObjectStackAdapter<T = unknown> implements DataSource<T> {
   async delete(resource: string, id: string | number): Promise<boolean> {
     await this.connect();
     const result = await this.client.data.delete(resource, String(id));
-    return result.success;
+    return result.deleted;
   }
 
   /**
@@ -416,7 +425,7 @@ export class ObjectStackAdapter<T = unknown> implements DataSource<T> {
             
             try {
               const result = await this.client.data.update<T>(resource, String(id), item);
-              results.push(result);
+              results.push(result.record);
               completed++;
               emitProgress();
             } catch (error: unknown) {
@@ -582,6 +591,82 @@ export class ObjectStackAdapter<T = unknown> implements DataSource<T> {
     return this.client;
   }
 
+  /**
+   * Get the discovery information from the connected server.
+   * Returns the capabilities and service status of the ObjectStack server.
+   * 
+   * Note: This accesses an internal property of the ObjectStackClient.
+   * The discovery data is populated during client.connect() and cached.
+   * 
+   * @returns Promise resolving to discovery data, or null if not connected
+   */
+  async getDiscovery(): Promise<unknown | null> {
+    try {
+      // Ensure we're connected first
+      await this.connect();
+      
+      // Access discovery data from the client
+      // The ObjectStackClient caches discovery during connect()
+      // This is an internal property, but documented for this use case
+      // @ts-expect-error - Accessing internal discoveryInfo property
+      return this.client.discoveryInfo || null;
+    } catch {
+      return null;
+    }
+  }
+
+  /**
+   * Get a view definition for an object.
+   * Attempts to fetch from the server metadata API.
+   * Falls back to null if the server doesn't provide view definitions,
+   * allowing the consumer to use static config.
+   * 
+   * @param objectName - Object name
+   * @param viewId - View identifier
+   * @returns Promise resolving to the view definition or null
+   */
+  async getView(objectName: string, viewId: string): Promise<unknown | null> {
+    await this.connect();
+
+    try {
+      const cacheKey = `view:${objectName}:${viewId}`;
+      return await this.metadataCache.get(cacheKey, async () => {
+        // Try meta.getItem for view metadata
+        const result: any = await this.client.meta.getItem(objectName, `views/${viewId}`);
+        if (result && result.item) return result.item;
+        return result ?? null;
+      });
+    } catch {
+      // Server doesn't support view metadata — return null to fall back to static config
+      return null;
+    }
+  }
+
+  /**
+   * Get an application definition by name or ID.
+   * Attempts to fetch from the server metadata API.
+   * Falls back to null if the server doesn't provide app definitions,
+   * allowing the consumer to use static config.
+   * 
+   * @param appId - Application identifier
+   * @returns Promise resolving to the app definition or null
+   */
+  async getApp(appId: string): Promise<unknown | null> {
+    await this.connect();
+
+    try {
+      const cacheKey = `app:${appId}`;
+      return await this.metadataCache.get(cacheKey, async () => {
+        const result: any = await this.client.meta.getItem('apps', appId);
+        if (result && result.item) return result.item;
+        return result ?? null;
+      });
+    } catch {
+      // Server doesn't support app metadata — return null to fall back to static config
+      return null;
+    }
+  }
+
   /**
    * Get cache statistics for monitoring performance.
    */
@@ -604,6 +689,131 @@ export class ObjectStackAdapter<T = unknown> implements DataSource<T> {
   clearCache(): void {
     this.metadataCache.clear();
   }
+
+  /**
+   * Upload a single file to a resource.
+   * Posts the file as multipart/form-data to the ObjectStack server.
+   *
+   * @param resource - The resource/object name to attach the file to
+   * @param file - File object or Blob to upload
+   * @param options - Additional upload options (recordId, fieldName, metadata)
+   * @returns Promise resolving to the upload result (file URL, metadata)
+   */
+  async uploadFile(
+    resource: string,
+    file: File | Blob,
+    options?: {
+      recordId?: string;
+      fieldName?: string;
+      metadata?: Record<string, unknown>;
+      onProgress?: (percent: number) => void;
+    },
+  ): Promise<FileUploadResult> {
+    await this.connect();
+
+    const formData = new FormData();
+    formData.append('file', file);
+
+    if (options?.recordId) {
+      formData.append('recordId', options.recordId);
+    }
+    if (options?.fieldName) {
+      formData.append('fieldName', options.fieldName);
+    }
+    if (options?.metadata) {
+      formData.append('metadata', JSON.stringify(options.metadata));
+    }
+
+    const url = `${this.baseUrl}/api/data/${encodeURIComponent(resource)}/upload`;
+
+    const response = await fetch(url, {
+      method: 'POST',
+      body: formData,
+      headers: {
+        ...(this.getAuthHeaders()),
+      },
+    });
+
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({ message: response.statusText }));
+      throw new ObjectStackError(
+        error.message || `Upload failed with status ${response.status}`,
+        'UPLOAD_ERROR',
+        response.status,
+      );
+    }
+
+    return response.json();
+  }
+
+  /**
+   * Upload multiple files to a resource.
+   * Posts all files as a single multipart/form-data request.
+   *
+   * @param resource - The resource/object name to attach the files to
+   * @param files - Array of File objects or Blobs to upload
+   * @param options - Additional upload options
+   * @returns Promise resolving to array of upload results
+   */
+  async uploadFiles(
+    resource: string,
+    files: (File | Blob)[],
+    options?: {
+      recordId?: string;
+      fieldName?: string;
+      metadata?: Record<string, unknown>;
+      onProgress?: (percent: number) => void;
+    },
+  ): Promise<FileUploadResult[]> {
+    await this.connect();
+
+    const formData = new FormData();
+    files.forEach((file, idx) => {
+      formData.append(`files`, file, (file as File).name || `file-${idx}`);
+    });
+
+    if (options?.recordId) {
+      formData.append('recordId', options.recordId);
+    }
+    if (options?.fieldName) {
+      formData.append('fieldName', options.fieldName);
+    }
+    if (options?.metadata) {
+      formData.append('metadata', JSON.stringify(options.metadata));
+    }
+
+    const url = `${this.baseUrl}/api/data/${encodeURIComponent(resource)}/upload`;
+
+    const response = await fetch(url, {
+      method: 'POST',
+      body: formData,
+      headers: {
+        ...(this.getAuthHeaders()),
+      },
+    });
+
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({ message: response.statusText }));
+      throw new ObjectStackError(
+        error.message || `Upload failed with status ${response.status}`,
+        'UPLOAD_ERROR',
+        response.status,
+      );
+    }
+
+    return response.json();
+  }
+
+  /**
+   * Get authorization headers from the adapter config.
+   */
+  private getAuthHeaders(): Record<string, string> {
+    const headers: Record<string, string> = {};
+    if (this.token) {
+      headers['Authorization'] = `Bearer ${this.token}`;
+    }
+    return headers;
+  }
 }
 
 /**

package/src/upload.test.ts

@@ -0,0 +1,112 @@
+/**
+ * Tests for ObjectStackAdapter file upload integration
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { ObjectStackAdapter } from './index';
+
+describe('ObjectStackAdapter File Upload', () => {
+  let adapter: ObjectStackAdapter;
+
+  beforeEach(() => {
+    adapter = new ObjectStackAdapter({
+      baseUrl: 'http://localhost:3000',
+      autoReconnect: false,
+    });
+    vi.clearAllMocks();
+  });
+
+  describe('uploadFile', () => {
+    it('should be a method on the adapter', () => {
+      expect(typeof adapter.uploadFile).toBe('function');
+    });
+
+    it('should call fetch with multipart form data when connected', async () => {
+      const mockResponse = {
+        ok: true,
+        json: vi.fn().mockResolvedValue({
+          id: 'file-1',
+          filename: 'test.pdf',
+          mimeType: 'application/pdf',
+          size: 1024,
+          url: 'http://localhost:3000/files/file-1',
+        }),
+      };
+
+      global.fetch = vi.fn().mockResolvedValue(mockResponse);
+
+      // Manually set connected state by accessing private field
+      (adapter as any).connected = true;
+      (adapter as any).connectionState = 'connected';
+
+      const file = new File(['test content'], 'test.pdf', { type: 'application/pdf' });
+
+      const result = await adapter.uploadFile('documents', file, {
+        recordId: 'rec-123',
+        fieldName: 'attachment',
+      });
+
+      expect(global.fetch).toHaveBeenCalledWith(
+        expect.stringContaining('/api/data/documents/upload'),
+        expect.objectContaining({
+          method: 'POST',
+          body: expect.any(FormData),
+        }),
+      );
+
+      expect(result.id).toBe('file-1');
+      expect(result.filename).toBe('test.pdf');
+    });
+
+    it('should throw on upload failure', async () => {
+      const mockResponse = {
+        ok: false,
+        status: 413,
+        statusText: 'Payload Too Large',
+        json: vi.fn().mockResolvedValue({ message: 'File too large' }),
+      };
+
+      global.fetch = vi.fn().mockResolvedValue(mockResponse);
+
+      // Manually set connected state
+      (adapter as any).connected = true;
+      (adapter as any).connectionState = 'connected';
+
+      const file = new File(['test'], 'large.bin', { type: 'application/octet-stream' });
+
+      await expect(adapter.uploadFile('documents', file)).rejects.toThrow('File too large');
+    });
+  });
+
+  describe('uploadFiles', () => {
+    it('should be a method on the adapter', () => {
+      expect(typeof adapter.uploadFiles).toBe('function');
+    });
+
+    it('should upload multiple files', async () => {
+      const mockResponse = {
+        ok: true,
+        json: vi.fn().mockResolvedValue([
+          { id: 'file-1', filename: 'a.pdf', mimeType: 'application/pdf', size: 100, url: '/files/1' },
+          { id: 'file-2', filename: 'b.pdf', mimeType: 'application/pdf', size: 200, url: '/files/2' },
+        ]),
+      };
+
+      global.fetch = vi.fn().mockResolvedValue(mockResponse);
+
+      // Manually set connected state
+      (adapter as any).connected = true;
+      (adapter as any).connectionState = 'connected';
+
+      const files = [
+        new File(['content1'], 'a.pdf', { type: 'application/pdf' }),
+        new File(['content2'], 'b.pdf', { type: 'application/pdf' }),
+      ];
+
+      const results = await adapter.uploadFiles('documents', files);
+
+      expect(results).toHaveLength(2);
+      expect(results[0].id).toBe('file-1');
+      expect(results[1].id).toBe('file-2');
+    });
+  });
+});