@object-ui/data-objectstack 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 ObjectQL
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,45 @@
+# @object-ui/data-objectstack
+
+Official ObjectStack data adapter for Object UI.
+
+## Overview
+
+This package provides the `ObjectStackAdapter` class, which connects Object UI's universal `DataSource` interface with the `@objectstack/client` SDK.
+
+This enables strictly typed, metadata-driven UI components to communicate seamlessly with ObjectStack backends (Steedos, Salesforce, etc.).
+
+## Installation
+
+```bash
+npm install @object-ui/data-objectstack @objectstack/client
+```
+
+## Usage
+
+```typescript
+import { createObjectStackAdapter } from '@object-ui/data-objectstack';
+import { SchemaRenderer } from '@object-ui/react';
+
+// 1. Create the adapter
+const dataSource = createObjectStackAdapter({
+  baseUrl: 'https://api.example.com',
+  token: 'your-api-token' // Optional if effectively handling auth elsewhere
+});
+
+// 2. Pass to the Renderer
+function App() {
+  return (
+    <SchemaRenderer 
+      schema={mySchema} 
+      dataSource={dataSource} 
+    />
+  );
+}
+```
+
+## Features
+
+- ✅ **CRUD Operations**: Implements `find`, `findOne`, `create`, `update`, `delete`.
+- ✅ **Metadata Fetching**: Implements `getObjectSchema` to power auto-generated forms and grids.
+- ✅ **Query Translation**: Converts Object UI's OData-like query parameters to ObjectStack's native query format.
+- ✅ **Bulk Operations**: Supports batch create/update/delete.

package/dist/index.cjs

@@ -0,0 +1,182 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ObjectStackAdapter: () => ObjectStackAdapter,
+  createObjectStackAdapter: () => createObjectStackAdapter
+});
+module.exports = __toCommonJS(index_exports);
+var import_client = require("@objectstack/client");
+var import_core = require("@object-ui/core");
+var ObjectStackAdapter = class {
+  constructor(config) {
+    __publicField(this, "client");
+    __publicField(this, "connected", false);
+    this.client = new import_client.ObjectStackClient(config);
+  }
+  /**
+   * Ensure the client is connected to the server.
+   * Call this before making requests or it will auto-connect on first request.
+   */
+  async connect() {
+    if (!this.connected) {
+      await this.client.connect();
+      this.connected = true;
+    }
+  }
+  /**
+   * Find multiple records with query parameters.
+   * Converts OData-style params to ObjectStack query options.
+   */
+  async find(resource, params) {
+    await this.connect();
+    const queryOptions = this.convertQueryParams(params);
+    const result = await this.client.data.find(resource, queryOptions);
+    return {
+      data: result.value,
+      total: result.count,
+      page: params?.$skip ? Math.floor(params.$skip / (params.$top || 20)) + 1 : 1,
+      pageSize: params?.$top,
+      hasMore: result.value.length === params?.$top
+    };
+  }
+  /**
+   * Find a single record by ID.
+   */
+  async findOne(resource, id, _params) {
+    await this.connect();
+    try {
+      const record = await this.client.data.get(resource, String(id));
+      return record;
+    } catch (error) {
+      if (error?.status === 404) {
+        return null;
+      }
+      throw error;
+    }
+  }
+  /**
+   * Create a new record.
+   */
+  async create(resource, data) {
+    await this.connect();
+    return this.client.data.create(resource, data);
+  }
+  /**
+   * Update an existing record.
+   */
+  async update(resource, id, data) {
+    await this.connect();
+    return this.client.data.update(resource, String(id), data);
+  }
+  /**
+   * Delete a record.
+   */
+  async delete(resource, id) {
+    await this.connect();
+    const result = await this.client.data.delete(resource, String(id));
+    return result.success;
+  }
+  /**
+   * Bulk operations (optional implementation).
+   */
+  async bulk(resource, operation, data) {
+    await this.connect();
+    switch (operation) {
+      case "create":
+        return this.client.data.createMany(resource, data);
+      case "delete": {
+        const ids = data.map((item) => item.id).filter(Boolean);
+        await this.client.data.deleteMany(resource, ids);
+        return [];
+      }
+      case "update": {
+        const results = await Promise.all(
+          data.map(
+            (item) => this.client.data.update(resource, String(item.id), item)
+          )
+        );
+        return results;
+      }
+      default:
+        throw new Error(`Unsupported bulk operation: ${operation}`);
+    }
+  }
+  /**
+   * Convert ObjectUI QueryParams to ObjectStack QueryOptions.
+   * Maps OData-style conventions to ObjectStack conventions.
+   */
+  convertQueryParams(params) {
+    if (!params) return {};
+    const options = {};
+    if (params.$select) {
+      options.select = params.$select;
+    }
+    if (params.$filter) {
+      options.filters = (0, import_core.convertFiltersToAST)(params.$filter);
+    }
+    if (params.$orderby) {
+      const sortArray = Object.entries(params.$orderby).map(([field, order]) => {
+        return order === "desc" ? `-${field}` : field;
+      });
+      options.sort = sortArray;
+    }
+    if (params.$skip !== void 0) {
+      options.skip = params.$skip;
+    }
+    if (params.$top !== void 0) {
+      options.top = params.$top;
+    }
+    return options;
+  }
+  /**
+   * Get object schema/metadata from ObjectStack.
+   * 
+   * @param objectName - Object name
+   * @returns Promise resolving to the object schema
+   */
+  async getObjectSchema(objectName) {
+    await this.connect();
+    try {
+      const schema = await this.client.meta.getObject(objectName);
+      return schema;
+    } catch (error) {
+      console.error(`Failed to fetch schema for ${objectName}:`, error);
+      throw error;
+    }
+  }
+  /**
+   * Get access to the underlying ObjectStack client for advanced operations.
+   */
+  getClient() {
+    return this.client;
+  }
+};
+function createObjectStackAdapter(config) {
+  return new ObjectStackAdapter(config);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ObjectStackAdapter,
+  createObjectStackAdapter
+});

package/dist/index.d.cts

@@ -0,0 +1,106 @@
+import { ObjectStackClient } from '@objectstack/client';
+import { DataSource, QueryParams, QueryResult } from '@object-ui/types';
+
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+/**
+ * ObjectStack Data Source Adapter
+ *
+ * Bridges the ObjectStack Client SDK with the ObjectUI DataSource interface.
+ * This allows Object UI applications to seamlessly integrate with ObjectStack
+ * backends while maintaining the universal DataSource abstraction.
+ *
+ * @example
+ * ```typescript
+ * import { ObjectStackAdapter } from '@object-ui/data-objectstack';
+ *
+ * const dataSource = new ObjectStackAdapter({
+ *   baseUrl: 'https://api.example.com',
+ *   token: 'your-api-token'
+ * });
+ *
+ * const users = await dataSource.find('users', {
+ *   $filter: { status: 'active' },
+ *   $top: 10
+ * });
+ * ```
+ */
+declare class ObjectStackAdapter<T = any> implements DataSource<T> {
+    private client;
+    private connected;
+    constructor(config: {
+        baseUrl: string;
+        token?: string;
+        fetch?: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+    });
+    /**
+     * Ensure the client is connected to the server.
+     * Call this before making requests or it will auto-connect on first request.
+     */
+    connect(): Promise<void>;
+    /**
+     * Find multiple records with query parameters.
+     * Converts OData-style params to ObjectStack query options.
+     */
+    find(resource: string, params?: QueryParams): Promise<QueryResult<T>>;
+    /**
+     * Find a single record by ID.
+     */
+    findOne(resource: string, id: string | number, _params?: QueryParams): Promise<T | null>;
+    /**
+     * Create a new record.
+     */
+    create(resource: string, data: Partial<T>): Promise<T>;
+    /**
+     * Update an existing record.
+     */
+    update(resource: string, id: string | number, data: Partial<T>): Promise<T>;
+    /**
+     * Delete a record.
+     */
+    delete(resource: string, id: string | number): Promise<boolean>;
+    /**
+     * Bulk operations (optional implementation).
+     */
+    bulk(resource: string, operation: 'create' | 'update' | 'delete', data: Partial<T>[]): Promise<T[]>;
+    /**
+     * Convert ObjectUI QueryParams to ObjectStack QueryOptions.
+     * Maps OData-style conventions to ObjectStack conventions.
+     */
+    private convertQueryParams;
+    /**
+     * Get object schema/metadata from ObjectStack.
+     *
+     * @param objectName - Object name
+     * @returns Promise resolving to the object schema
+     */
+    getObjectSchema(objectName: string): Promise<any>;
+    /**
+     * Get access to the underlying ObjectStack client for advanced operations.
+     */
+    getClient(): ObjectStackClient;
+}
+/**
+ * Factory function to create an ObjectStack data source.
+ *
+ * @example
+ * ```typescript
+ * const dataSource = createObjectStackAdapter({
+ *   baseUrl: process.env.API_URL,
+ *   token: process.env.API_TOKEN
+ * });
+ * ```
+ */
+declare function createObjectStackAdapter<T = any>(config: {
+    baseUrl: string;
+    token?: string;
+    fetch?: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+}): DataSource<T>;
+
+export { ObjectStackAdapter, createObjectStackAdapter };

package/dist/index.d.ts

@@ -0,0 +1,106 @@
+import { ObjectStackClient } from '@objectstack/client';
+import { DataSource, QueryParams, QueryResult } from '@object-ui/types';
+
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+/**
+ * ObjectStack Data Source Adapter
+ *
+ * Bridges the ObjectStack Client SDK with the ObjectUI DataSource interface.
+ * This allows Object UI applications to seamlessly integrate with ObjectStack
+ * backends while maintaining the universal DataSource abstraction.
+ *
+ * @example
+ * ```typescript
+ * import { ObjectStackAdapter } from '@object-ui/data-objectstack';
+ *
+ * const dataSource = new ObjectStackAdapter({
+ *   baseUrl: 'https://api.example.com',
+ *   token: 'your-api-token'
+ * });
+ *
+ * const users = await dataSource.find('users', {
+ *   $filter: { status: 'active' },
+ *   $top: 10
+ * });
+ * ```
+ */
+declare class ObjectStackAdapter<T = any> implements DataSource<T> {
+    private client;
+    private connected;
+    constructor(config: {
+        baseUrl: string;
+        token?: string;
+        fetch?: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+    });
+    /**
+     * Ensure the client is connected to the server.
+     * Call this before making requests or it will auto-connect on first request.
+     */
+    connect(): Promise<void>;
+    /**
+     * Find multiple records with query parameters.
+     * Converts OData-style params to ObjectStack query options.
+     */
+    find(resource: string, params?: QueryParams): Promise<QueryResult<T>>;
+    /**
+     * Find a single record by ID.
+     */
+    findOne(resource: string, id: string | number, _params?: QueryParams): Promise<T | null>;
+    /**
+     * Create a new record.
+     */
+    create(resource: string, data: Partial<T>): Promise<T>;
+    /**
+     * Update an existing record.
+     */
+    update(resource: string, id: string | number, data: Partial<T>): Promise<T>;
+    /**
+     * Delete a record.
+     */
+    delete(resource: string, id: string | number): Promise<boolean>;
+    /**
+     * Bulk operations (optional implementation).
+     */
+    bulk(resource: string, operation: 'create' | 'update' | 'delete', data: Partial<T>[]): Promise<T[]>;
+    /**
+     * Convert ObjectUI QueryParams to ObjectStack QueryOptions.
+     * Maps OData-style conventions to ObjectStack conventions.
+     */
+    private convertQueryParams;
+    /**
+     * Get object schema/metadata from ObjectStack.
+     *
+     * @param objectName - Object name
+     * @returns Promise resolving to the object schema
+     */
+    getObjectSchema(objectName: string): Promise<any>;
+    /**
+     * Get access to the underlying ObjectStack client for advanced operations.
+     */
+    getClient(): ObjectStackClient;
+}
+/**
+ * Factory function to create an ObjectStack data source.
+ *
+ * @example
+ * ```typescript
+ * const dataSource = createObjectStackAdapter({
+ *   baseUrl: process.env.API_URL,
+ *   token: process.env.API_TOKEN
+ * });
+ * ```
+ */
+declare function createObjectStackAdapter<T = any>(config: {
+    baseUrl: string;
+    token?: string;
+    fetch?: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+}): DataSource<T>;
+
+export { ObjectStackAdapter, createObjectStackAdapter };

package/dist/index.js

@@ -0,0 +1,158 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/index.ts
+import { ObjectStackClient } from "@objectstack/client";
+import { convertFiltersToAST } from "@object-ui/core";
+var ObjectStackAdapter = class {
+  constructor(config) {
+    __publicField(this, "client");
+    __publicField(this, "connected", false);
+    this.client = new ObjectStackClient(config);
+  }
+  /**
+   * Ensure the client is connected to the server.
+   * Call this before making requests or it will auto-connect on first request.
+   */
+  async connect() {
+    if (!this.connected) {
+      await this.client.connect();
+      this.connected = true;
+    }
+  }
+  /**
+   * Find multiple records with query parameters.
+   * Converts OData-style params to ObjectStack query options.
+   */
+  async find(resource, params) {
+    await this.connect();
+    const queryOptions = this.convertQueryParams(params);
+    const result = await this.client.data.find(resource, queryOptions);
+    return {
+      data: result.value,
+      total: result.count,
+      page: params?.$skip ? Math.floor(params.$skip / (params.$top || 20)) + 1 : 1,
+      pageSize: params?.$top,
+      hasMore: result.value.length === params?.$top
+    };
+  }
+  /**
+   * Find a single record by ID.
+   */
+  async findOne(resource, id, _params) {
+    await this.connect();
+    try {
+      const record = await this.client.data.get(resource, String(id));
+      return record;
+    } catch (error) {
+      if (error?.status === 404) {
+        return null;
+      }
+      throw error;
+    }
+  }
+  /**
+   * Create a new record.
+   */
+  async create(resource, data) {
+    await this.connect();
+    return this.client.data.create(resource, data);
+  }
+  /**
+   * Update an existing record.
+   */
+  async update(resource, id, data) {
+    await this.connect();
+    return this.client.data.update(resource, String(id), data);
+  }
+  /**
+   * Delete a record.
+   */
+  async delete(resource, id) {
+    await this.connect();
+    const result = await this.client.data.delete(resource, String(id));
+    return result.success;
+  }
+  /**
+   * Bulk operations (optional implementation).
+   */
+  async bulk(resource, operation, data) {
+    await this.connect();
+    switch (operation) {
+      case "create":
+        return this.client.data.createMany(resource, data);
+      case "delete": {
+        const ids = data.map((item) => item.id).filter(Boolean);
+        await this.client.data.deleteMany(resource, ids);
+        return [];
+      }
+      case "update": {
+        const results = await Promise.all(
+          data.map(
+            (item) => this.client.data.update(resource, String(item.id), item)
+          )
+        );
+        return results;
+      }
+      default:
+        throw new Error(`Unsupported bulk operation: ${operation}`);
+    }
+  }
+  /**
+   * Convert ObjectUI QueryParams to ObjectStack QueryOptions.
+   * Maps OData-style conventions to ObjectStack conventions.
+   */
+  convertQueryParams(params) {
+    if (!params) return {};
+    const options = {};
+    if (params.$select) {
+      options.select = params.$select;
+    }
+    if (params.$filter) {
+      options.filters = convertFiltersToAST(params.$filter);
+    }
+    if (params.$orderby) {
+      const sortArray = Object.entries(params.$orderby).map(([field, order]) => {
+        return order === "desc" ? `-${field}` : field;
+      });
+      options.sort = sortArray;
+    }
+    if (params.$skip !== void 0) {
+      options.skip = params.$skip;
+    }
+    if (params.$top !== void 0) {
+      options.top = params.$top;
+    }
+    return options;
+  }
+  /**
+   * Get object schema/metadata from ObjectStack.
+   * 
+   * @param objectName - Object name
+   * @returns Promise resolving to the object schema
+   */
+  async getObjectSchema(objectName) {
+    await this.connect();
+    try {
+      const schema = await this.client.meta.getObject(objectName);
+      return schema;
+    } catch (error) {
+      console.error(`Failed to fetch schema for ${objectName}:`, error);
+      throw error;
+    }
+  }
+  /**
+   * Get access to the underlying ObjectStack client for advanced operations.
+   */
+  getClient() {
+    return this.client;
+  }
+};
+function createObjectStackAdapter(config) {
+  return new ObjectStackAdapter(config);
+}
+export {
+  ObjectStackAdapter,
+  createObjectStackAdapter
+};

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@object-ui/data-objectstack",
+  "version": "0.3.0",
+  "description": "ObjectStack Data Adapter for Object UI",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "dependencies": {
+    "@objectstack/client": "^0.3.3",
+    "@object-ui/types": "0.3.0",
+    "@object-ui/core": "0.3.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "clean": "rm -rf dist",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "eslint ."
+  }
+}

package/src/index.ts

@@ -0,0 +1,231 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { ObjectStackClient, type QueryOptions as ObjectStackQueryOptions } from '@objectstack/client';
+import type { DataSource, QueryParams, QueryResult } from '@object-ui/types';
+import { convertFiltersToAST } from '@object-ui/core';
+
+/**
+ * ObjectStack Data Source Adapter
+ * 
+ * Bridges the ObjectStack Client SDK with the ObjectUI DataSource interface.
+ * This allows Object UI applications to seamlessly integrate with ObjectStack
+ * backends while maintaining the universal DataSource abstraction.
+ * 
+ * @example
+ * ```typescript
+ * import { ObjectStackAdapter } from '@object-ui/data-objectstack';
+ * 
+ * const dataSource = new ObjectStackAdapter({
+ *   baseUrl: 'https://api.example.com',
+ *   token: 'your-api-token'
+ * });
+ * 
+ * const users = await dataSource.find('users', {
+ *   $filter: { status: 'active' },
+ *   $top: 10
+ * });
+ * ```
+ */
+export class ObjectStackAdapter<T = any> implements DataSource<T> {
+  private client: ObjectStackClient;
+  private connected: boolean = false;
+
+  constructor(config: {
+    baseUrl: string;
+    token?: string;
+    fetch?: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+  }) {
+    this.client = new ObjectStackClient(config);
+  }
+
+  /**
+   * Ensure the client is connected to the server.
+   * Call this before making requests or it will auto-connect on first request.
+   */
+  async connect(): Promise<void> {
+    if (!this.connected) {
+      await this.client.connect();
+      this.connected = true;
+    }
+  }
+
+  /**
+   * Find multiple records with query parameters.
+   * Converts OData-style params to ObjectStack query options.
+   */
+  async find(resource: string, params?: QueryParams): Promise<QueryResult<T>> {
+    await this.connect();
+
+    const queryOptions = this.convertQueryParams(params);
+    const result = await this.client.data.find<T>(resource, queryOptions);
+
+    return {
+      data: result.value,
+      total: result.count,
+      page: params?.$skip ? Math.floor(params.$skip / (params.$top || 20)) + 1 : 1,
+      pageSize: params?.$top,
+      hasMore: result.value.length === params?.$top,
+    };
+  }
+
+  /**
+   * Find a single record by ID.
+   */
+  async findOne(resource: string, id: string | number, _params?: QueryParams): Promise<T | null> {
+    await this.connect();
+
+    try {
+      const record = await this.client.data.get<T>(resource, String(id));
+      return record;
+    } catch (error) {
+      // If record not found, return null instead of throwing
+      if ((error as any)?.status === 404) {
+        return null;
+      }
+      throw error;
+    }
+  }
+
+  /**
+   * Create a new record.
+   */
+  async create(resource: string, data: Partial<T>): Promise<T> {
+    await this.connect();
+    return this.client.data.create<T>(resource, data);
+  }
+
+  /**
+   * Update an existing record.
+   */
+  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);
+  }
+
+  /**
+   * Delete a record.
+   */
+  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;
+  }
+
+  /**
+   * Bulk operations (optional implementation).
+   */
+  async bulk(resource: string, operation: 'create' | 'update' | 'delete', data: Partial<T>[]): Promise<T[]> {
+    await this.connect();
+
+    switch (operation) {
+      case 'create':
+        return this.client.data.createMany<T>(resource, data);
+      case 'delete': {
+        const ids = data.map(item => (item as any).id).filter(Boolean);
+        await this.client.data.deleteMany(resource, ids);
+        return [];
+      }
+      case 'update': {
+        // For update, we need to handle each record individually
+        // or use the batch update if all records get the same changes
+        const results = await Promise.all(
+          data.map(item => 
+            this.client.data.update<T>(resource, String((item as any).id), item)
+          )
+        );
+        return results;
+      }
+      default:
+        throw new Error(`Unsupported bulk operation: ${operation}`);
+    }
+  }
+
+  /**
+   * Convert ObjectUI QueryParams to ObjectStack QueryOptions.
+   * Maps OData-style conventions to ObjectStack conventions.
+   */
+  private convertQueryParams(params?: QueryParams): ObjectStackQueryOptions {
+    if (!params) return {};
+
+    const options: ObjectStackQueryOptions = {};
+
+    // Selection
+    if (params.$select) {
+      options.select = params.$select;
+    }
+
+    // Filtering - convert to ObjectStack FilterNode AST format
+    if (params.$filter) {
+      options.filters = convertFiltersToAST(params.$filter);
+    }
+
+    // Sorting - convert to ObjectStack format
+    if (params.$orderby) {
+      const sortArray = Object.entries(params.$orderby).map(([field, order]) => {
+        return order === 'desc' ? `-${field}` : field;
+      });
+      options.sort = sortArray;
+    }
+
+    // Pagination
+    if (params.$skip !== undefined) {
+      options.skip = params.$skip;
+    }
+
+    if (params.$top !== undefined) {
+      options.top = params.$top;
+    }
+
+    return options;
+  }
+
+  /**
+   * Get object schema/metadata from ObjectStack.
+   * 
+   * @param objectName - Object name
+   * @returns Promise resolving to the object schema
+   */
+  async getObjectSchema(objectName: string): Promise<any> {
+    await this.connect();
+    
+    try {
+      const schema = await this.client.meta.getObject(objectName);
+      return schema;
+    } catch (error) {
+      console.error(`Failed to fetch schema for ${objectName}:`, error);
+      throw error;
+    }
+  }
+
+  /**
+   * Get access to the underlying ObjectStack client for advanced operations.
+   */
+  getClient(): ObjectStackClient {
+    return this.client;
+  }
+}
+
+/**
+ * Factory function to create an ObjectStack data source.
+ * 
+ * @example
+ * ```typescript
+ * const dataSource = createObjectStackAdapter({
+ *   baseUrl: process.env.API_URL,
+ *   token: process.env.API_TOKEN
+ * });
+ * ```
+ */
+export function createObjectStackAdapter<T = any>(config: {
+  baseUrl: string;
+  token?: string;
+  fetch?: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+}): DataSource<T> {
+  return new ObjectStackAdapter<T>(config);
+}