npm - @objectql/sdk - Versions diffs - 1.8.0 → 1.8.2 - Mend

@objectql/sdk 1.8.0 → 1.8.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/dist/index.js CHANGED Viewed

@@ -1,6 +1,49 @@
 "use strict";
+/**
+ * @objectql/sdk - Universal HTTP Client for ObjectQL
+ *
+ * This package provides type-safe HTTP clients for ObjectQL servers.
+ * It works seamlessly in browsers, Node.js, Deno, and edge runtimes.
+ *
+ * ## Browser Compatibility
+ *
+ * The SDK uses modern JavaScript APIs:
+ * - fetch API (universal)
+ * - AbortSignal.timeout() (Chrome 103+, Firefox 100+, Safari 16.4+)
+ *
+ * For older browsers, a polyfill is automatically applied if AbortSignal.timeout is not available.
+ *
+ * @packageDocumentation
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RemoteDriver = void 0;
+exports.MetadataApiClient = exports.DataApiClient = exports.RemoteDriver = void 0;
+const types_1 = require("@objectql/types");
+/**
+ * Polyfill for AbortSignal.timeout if not available (for older browsers)
+ * This ensures the SDK works universally across all JavaScript environments.
+ */
+if (typeof AbortSignal !== 'undefined' && !AbortSignal.timeout) {
+    AbortSignal.timeout = function (ms) {
+        const controller = new AbortController();
+        setTimeout(() => controller.abort(), ms);
+        return controller.signal;
+    };
+}
+/**
+ * Helper function to create a timeout signal that works in all environments
+ */
+function createTimeoutSignal(ms) {
+    if (typeof AbortSignal !== 'undefined' && AbortSignal.timeout) {
+        return AbortSignal.timeout(ms);
+    }
+    // Fallback for environments without AbortSignal
+    const controller = new AbortController();
+    setTimeout(() => controller.abort(), ms);
+    return controller.signal;
+}
+/**
+ * Legacy Driver implementation that uses JSON-RPC style API
+ */
 class RemoteDriver {
     constructor(baseUrl) {
         this.baseUrl = baseUrl;
@@ -56,4 +99,175 @@ class RemoteDriver {
     }
 }
 exports.RemoteDriver = RemoteDriver;
+/**
+ * REST-based Data API Client
+ *
+ * Implements type-safe client for ObjectQL Data API endpoints.
+ * Uses the RESTful interface described in docs/api/rest.md
+ *
+ * @example
+ * ```typescript
+ * const client = new DataApiClient({ baseUrl: 'http://localhost:3000' });
+ *
+ * // List users
+ * const response = await client.list('users', {
+ *   filter: [['status', '=', 'active']],
+ *   sort: [['created_at', 'desc']],
+ *   limit: 20
+ * });
+ *
+ * // Get single user
+ * const user = await client.get('users', 'user_123');
+ *
+ * // Create user
+ * const newUser = await client.create('users', {
+ *   name: 'Alice',
+ *   email: 'alice@example.com'
+ * });
+ * ```
+ */
+class DataApiClient {
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/$/, '');
+        this.token = config.token;
+        this.headers = config.headers || {};
+        this.timeout = config.timeout || 30000;
+    }
+    async request(method, path, body, queryParams) {
+        const url = new URL(`${this.baseUrl}${path}`);
+        // Add query parameters
+        if (queryParams) {
+            Object.entries(queryParams).forEach(([key, value]) => {
+                if (value !== undefined && value !== null) {
+                    url.searchParams.append(key, typeof value === 'object' ? JSON.stringify(value) : String(value));
+                }
+            });
+        }
+        const headers = {
+            'Content-Type': 'application/json',
+            ...this.headers
+        };
+        if (this.token) {
+            headers['Authorization'] = `Bearer ${this.token}`;
+        }
+        const response = await fetch(url.toString(), {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+            signal: createTimeoutSignal(this.timeout)
+        });
+        const json = await response.json();
+        if (json.error) {
+            throw new types_1.ObjectQLError({
+                code: json.error.code || types_1.ApiErrorCode.INTERNAL_ERROR,
+                message: json.error.message,
+                details: json.error.details
+            });
+        }
+        return json;
+    }
+    async list(objectName, params) {
+        return this.request('GET', `/api/data/${objectName}`, undefined, params);
+    }
+    async get(objectName, id) {
+        return this.request('GET', `/api/data/${objectName}/${id}`);
+    }
+    async create(objectName, data) {
+        return this.request('POST', `/api/data/${objectName}`, data);
+    }
+    async createMany(objectName, data) {
+        return this.request('POST', `/api/data/${objectName}`, data);
+    }
+    async update(objectName, id, data) {
+        return this.request('PUT', `/api/data/${objectName}/${id}`, data);
+    }
+    async updateMany(objectName, request) {
+        return this.request('POST', `/api/data/${objectName}/bulk-update`, request);
+    }
+    async delete(objectName, id) {
+        return this.request('DELETE', `/api/data/${objectName}/${id}`);
+    }
+    async deleteMany(objectName, request) {
+        return this.request('POST', `/api/data/${objectName}/bulk-delete`, request);
+    }
+    async count(objectName, filters) {
+        return this.request('GET', `/api/data/${objectName}`, undefined, { filter: filters, limit: 0 });
+    }
+}
+exports.DataApiClient = DataApiClient;
+/**
+ * REST-based Metadata API Client
+ *
+ * Implements type-safe client for ObjectQL Metadata API endpoints.
+ * Uses the interface described in docs/api/metadata.md
+ *
+ * @example
+ * ```typescript
+ * const client = new MetadataApiClient({ baseUrl: 'http://localhost:3000' });
+ *
+ * // List all objects
+ * const objects = await client.listObjects();
+ *
+ * // Get detailed object metadata
+ * const userSchema = await client.getObject('users');
+ * console.log(userSchema.fields);
+ *
+ * // Get field metadata
+ * const emailField = await client.getField('users', 'email');
+ *
+ * // List actions
+ * const actions = await client.listActions('users');
+ * ```
+ */
+class MetadataApiClient {
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/$/, '');
+        this.token = config.token;
+        this.headers = config.headers || {};
+        this.timeout = config.timeout || 30000;
+    }
+    async request(method, path, body) {
+        const headers = {
+            'Content-Type': 'application/json',
+            ...this.headers
+        };
+        if (this.token) {
+            headers['Authorization'] = `Bearer ${this.token}`;
+        }
+        const response = await fetch(`${this.baseUrl}${path}`, {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+            signal: createTimeoutSignal(this.timeout)
+        });
+        const json = await response.json();
+        if (json.error) {
+            throw new types_1.ObjectQLError({
+                code: json.error.code || types_1.ApiErrorCode.INTERNAL_ERROR,
+                message: json.error.message,
+                details: json.error.details
+            });
+        }
+        return json;
+    }
+    async listObjects() {
+        return this.request('GET', '/api/metadata/objects');
+    }
+    async getObject(objectName) {
+        return this.request('GET', `/api/metadata/object/${objectName}`);
+    }
+    async getField(objectName, fieldName) {
+        return this.request('GET', `/api/metadata/object/${objectName}/fields/${fieldName}`);
+    }
+    async listActions(objectName) {
+        return this.request('GET', `/api/metadata/object/${objectName}/actions`);
+    }
+    async listByType(metadataType) {
+        return this.request('GET', `/api/metadata/${metadataType}`);
+    }
+    async getMetadata(metadataType, id) {
+        return this.request('GET', `/api/metadata/${metadataType}/${id}`);
+    }
+}
+exports.MetadataApiClient = MetadataApiClient;
 //# sourceMappingURL=index.js.map

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;~~AAEA~~,MAAa,YAAY;IACrB,YAAoB,OAAe;QAAf,YAAO,GAAP,OAAO,CAAQ;IAAG,CAAC;IAE/B,KAAK,CAAC,OAAO,CAAC,EAAU,EAAE,UAAkB,EAAE,IAAS;QAC3D,iFAAiF;QACjF,2CAA2C;QAC3C,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC;QAEnE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE;YAC9B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACL,cAAc,EAAE,kBAAkB;aACrC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACjB,EAAE;gBACF,MAAM,EAAE,UAAU;gBAClB,IAAI;aACP,CAAC;SACL,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAE9B,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAAkB,EAAE,KAAU,EAAE,OAAa;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,UAAkB,EAAE,EAAmB,EAAE,KAAW,EAAE,OAAa;QAC7E,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,kDAAkD;IACjH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,UAAkB,EAAE,IAAS,EAAE,OAAa;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,UAAkB,EAAE,EAAmB,EAAE,IAAS,EAAE,OAAa;QAC1E,8FAA8F;QAC9F,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,UAAkB,EAAE,EAAmB,EAAE,OAAa;QAC/D,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,UAAkB,EAAE,OAAY,EAAE,OAAa;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,UAAkB,EAAE,IAAW,EAAE,OAAa;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,UAAkB,EAAE,OAAY,EAAE,IAAS,EAAE,OAAa;QACvE,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,UAAkB,EAAE,OAAY,EAAE,OAAa;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;CACJ;AAjED,oCAiEC"}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/jest.config.js CHANGED Viewed

@@ -3,7 +3,9 @@ module.exports = {
   testEnvironment: 'node',
   testMatch: ['**/test/**/*.test.ts'],
   moduleNameMapper: {
-    '^@objectql/(.*)$': '<rootDir>/../$1/src',
+    '^@objectql/types$': '<rootDir>/../../foundation/types/src',
+    '^@objectql/core$': '<rootDir>/../../foundation/core/src',
+    '^@objectql/platform-node$': '<rootDir>/../../foundation/platform-node/src',
   },
   transform: {
     '^.+\\.ts$': ['ts-jest', {

package/package.json CHANGED Viewed

@@ -1,16 +1,46 @@
 {
   "name": "@objectql/sdk",
-  "version": "1.8.0",
+  "version": "1.8.2",
+  "description": "Remote HTTP driver for ObjectQL - Universal client for browser, Node.js, and edge runtimes",
+  "keywords": [
+    "objectql",
+    "sdk",
+    "driver",
+    "remote",
+    "http",
+    "client",
+    "browser",
+    "frontend",
+    "universal",
+    "api",
+    "rest",
+    "fetch",
+    "typescript",
+    "esm",
+    "react",
+    "vue",
+    "angular"
+  ],
   "license": "MIT",
-  "description": "Remote/HTTP Driver for ObjectQL",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "browser": "dist/index.js",
+  "sideEffects": false,
   "dependencies": {
-    "@objectql/types": "1.8.0"
+    "@objectql/types": "1.8.2"
   },
   "devDependencies": {
     "typescript": "^5.3.0"
   },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/objectstack-ai/objectql.git",
+    "directory": "packages/drivers/sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/objectstack-ai/objectql/issues"
+  },
+  "homepage": "https://objectql.org",
   "scripts": {
     "build": "tsc",
     "test": "jest"

package/src/index.ts CHANGED Viewed

@@ -1,5 +1,76 @@
-import { Driver } from '@objectql/types';
+/**
+ * @objectql/sdk - Universal HTTP Client for ObjectQL
+ *
+ * This package provides type-safe HTTP clients for ObjectQL servers.
+ * It works seamlessly in browsers, Node.js, Deno, and edge runtimes.
+ *
+ * ## Browser Compatibility
+ *
+ * The SDK uses modern JavaScript APIs:
+ * - fetch API (universal)
+ * - AbortSignal.timeout() (Chrome 103+, Firefox 100+, Safari 16.4+)
+ *
+ * For older browsers, a polyfill is automatically applied if AbortSignal.timeout is not available.
+ *
+ * @packageDocumentation
+ */
+import {
+    Driver,
+    IDataApiClient,
+    IMetadataApiClient,
+    DataApiClientConfig,
+    MetadataApiClientConfig,
+    DataApiListParams,
+    DataApiListResponse,
+    DataApiItemResponse,
+    DataApiCreateRequest,
+    DataApiCreateManyRequest,
+    DataApiUpdateRequest,
+    DataApiBulkUpdateRequest,
+    DataApiBulkDeleteRequest,
+    DataApiCountResponse,
+    DataApiDeleteResponse,
+    DataApiResponse,
+    MetadataApiObjectListResponse,
+    MetadataApiObjectDetailResponse,
+    FieldMetadataResponse,
+    MetadataApiActionsResponse,
+    MetadataApiListResponse,
+    MetadataApiResponse,
+    ObjectQLError,
+    ApiErrorCode,
+    FilterExpression
+} from '@objectql/types';
+/**
+ * Polyfill for AbortSignal.timeout if not available (for older browsers)
+ * This ensures the SDK works universally across all JavaScript environments.
+ */
+if (typeof AbortSignal !== 'undefined' && !AbortSignal.timeout) {
+    (AbortSignal as any).timeout = function(ms: number): AbortSignal {
+        const controller = new AbortController();
+        setTimeout(() => controller.abort(), ms);
+        return controller.signal;
+    };
+}
+/**
+ * Helper function to create a timeout signal that works in all environments
+ */
+function createTimeoutSignal(ms: number): AbortSignal {
+    if (typeof AbortSignal !== 'undefined' && AbortSignal.timeout) {
+        return AbortSignal.timeout(ms);
+    }
+    // Fallback for environments without AbortSignal
+    const controller = new AbortController();
+    setTimeout(() => controller.abort(), ms);
+    return controller.signal;
+}
+/**
+ * Legacy Driver implementation that uses JSON-RPC style API
+ */
 export class RemoteDriver implements Driver {
     constructor(private baseUrl: string) {}
@@ -66,3 +137,272 @@ export class RemoteDriver implements Driver {
         return this.request('deleteMany', objectName, { filters });
     }
 }
+/**
+ * REST-based Data API Client
+ *
+ * Implements type-safe client for ObjectQL Data API endpoints.
+ * Uses the RESTful interface described in docs/api/rest.md
+ *
+ * @example
+ * ```typescript
+ * const client = new DataApiClient({ baseUrl: 'http://localhost:3000' });
+ *
+ * // List users
+ * const response = await client.list('users', {
+ *   filter: [['status', '=', 'active']],
+ *   sort: [['created_at', 'desc']],
+ *   limit: 20
+ * });
+ *
+ * // Get single user
+ * const user = await client.get('users', 'user_123');
+ *
+ * // Create user
+ * const newUser = await client.create('users', {
+ *   name: 'Alice',
+ *   email: 'alice@example.com'
+ * });
+ * ```
+ */
+export class DataApiClient implements IDataApiClient {
+    private baseUrl: string;
+    private token?: string;
+    private headers: Record<string, string>;
+    private timeout: number;
+    constructor(config: DataApiClientConfig) {
+        this.baseUrl = config.baseUrl.replace(/\/$/, '');
+        this.token = config.token;
+        this.headers = config.headers || {};
+        this.timeout = config.timeout || 30000;
+    }
+    private async request<T>(
+        method: string,
+        path: string,
+        body?: unknown,
+        queryParams?: Record<string, unknown>
+    ): Promise<T> {
+        const url = new URL(`${this.baseUrl}${path}`);
+        // Add query parameters
+        if (queryParams) {
+            Object.entries(queryParams).forEach(([key, value]) => {
+                if (value !== undefined && value !== null) {
+                    url.searchParams.append(key, typeof value === 'object' ? JSON.stringify(value) : String(value));
+                }
+            });
+        }
+        const headers: Record<string, string> = {
+            'Content-Type': 'application/json',
+            ...this.headers
+        };
+        if (this.token) {
+            headers['Authorization'] = `Bearer ${this.token}`;
+        }
+        const response = await fetch(url.toString(), {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+            signal: createTimeoutSignal(this.timeout)
+        });
+        const json = await response.json();
+        if (json.error) {
+            throw new ObjectQLError({
+                code: json.error.code || ApiErrorCode.INTERNAL_ERROR,
+                message: json.error.message,
+                details: json.error.details
+            });
+        }
+        return json as T;
+    }
+    async list<T = unknown>(objectName: string, params?: DataApiListParams): Promise<DataApiListResponse<T>> {
+        return this.request<DataApiListResponse<T>>(
+            'GET',
+            `/api/data/${objectName}`,
+            undefined,
+            params as Record<string, unknown>
+        );
+    }
+    async get<T = unknown>(objectName: string, id: string | number): Promise<DataApiItemResponse<T>> {
+        return this.request<DataApiItemResponse<T>>(
+            'GET',
+            `/api/data/${objectName}/${id}`
+        );
+    }
+    async create<T = unknown>(objectName: string, data: DataApiCreateRequest): Promise<DataApiItemResponse<T>> {
+        return this.request<DataApiItemResponse<T>>(
+            'POST',
+            `/api/data/${objectName}`,
+            data
+        );
+    }
+    async createMany<T = unknown>(objectName: string, data: DataApiCreateManyRequest): Promise<DataApiListResponse<T>> {
+        return this.request<DataApiListResponse<T>>(
+            'POST',
+            `/api/data/${objectName}`,
+            data
+        );
+    }
+    async update<T = unknown>(objectName: string, id: string | number, data: DataApiUpdateRequest): Promise<DataApiItemResponse<T>> {
+        return this.request<DataApiItemResponse<T>>(
+            'PUT',
+            `/api/data/${objectName}/${id}`,
+            data
+        );
+    }
+    async updateMany(objectName: string, request: DataApiBulkUpdateRequest): Promise<DataApiResponse> {
+        return this.request<DataApiResponse>(
+            'POST',
+            `/api/data/${objectName}/bulk-update`,
+            request
+        );
+    }
+    async delete(objectName: string, id: string | number): Promise<DataApiDeleteResponse> {
+        return this.request<DataApiDeleteResponse>(
+            'DELETE',
+            `/api/data/${objectName}/${id}`
+        );
+    }
+    async deleteMany(objectName: string, request: DataApiBulkDeleteRequest): Promise<DataApiDeleteResponse> {
+        return this.request<DataApiDeleteResponse>(
+            'POST',
+            `/api/data/${objectName}/bulk-delete`,
+            request
+        );
+    }
+    async count(objectName: string, filters?: FilterExpression): Promise<DataApiCountResponse> {
+        return this.request<DataApiCountResponse>(
+            'GET',
+            `/api/data/${objectName}`,
+            undefined,
+            { filter: filters, limit: 0 }
+        );
+    }
+}
+/**
+ * REST-based Metadata API Client
+ *
+ * Implements type-safe client for ObjectQL Metadata API endpoints.
+ * Uses the interface described in docs/api/metadata.md
+ *
+ * @example
+ * ```typescript
+ * const client = new MetadataApiClient({ baseUrl: 'http://localhost:3000' });
+ *
+ * // List all objects
+ * const objects = await client.listObjects();
+ *
+ * // Get detailed object metadata
+ * const userSchema = await client.getObject('users');
+ * console.log(userSchema.fields);
+ *
+ * // Get field metadata
+ * const emailField = await client.getField('users', 'email');
+ *
+ * // List actions
+ * const actions = await client.listActions('users');
+ * ```
+ */
+export class MetadataApiClient implements IMetadataApiClient {
+    private baseUrl: string;
+    private token?: string;
+    private headers: Record<string, string>;
+    private timeout: number;
+    constructor(config: MetadataApiClientConfig) {
+        this.baseUrl = config.baseUrl.replace(/\/$/, '');
+        this.token = config.token;
+        this.headers = config.headers || {};
+        this.timeout = config.timeout || 30000;
+    }
+    private async request<T>(method: string, path: string, body?: unknown): Promise<T> {
+        const headers: Record<string, string> = {
+            'Content-Type': 'application/json',
+            ...this.headers
+        };
+        if (this.token) {
+            headers['Authorization'] = `Bearer ${this.token}`;
+        }
+        const response = await fetch(`${this.baseUrl}${path}`, {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+            signal: createTimeoutSignal(this.timeout)
+        });
+        const json = await response.json();
+        if (json.error) {
+            throw new ObjectQLError({
+                code: json.error.code || ApiErrorCode.INTERNAL_ERROR,
+                message: json.error.message,
+                details: json.error.details
+            });
+        }
+        return json as T;
+    }
+    async listObjects(): Promise<MetadataApiObjectListResponse> {
+        return this.request<MetadataApiObjectListResponse>(
+            'GET',
+            '/api/metadata/objects'
+        );
+    }
+    async getObject(objectName: string): Promise<MetadataApiObjectDetailResponse> {
+        return this.request<MetadataApiObjectDetailResponse>(
+            'GET',
+            `/api/metadata/object/${objectName}`
+        );
+    }
+    async getField(objectName: string, fieldName: string): Promise<FieldMetadataResponse> {
+        return this.request<FieldMetadataResponse>(
+            'GET',
+            `/api/metadata/object/${objectName}/fields/${fieldName}`
+        );
+    }
+    async listActions(objectName: string): Promise<MetadataApiActionsResponse> {
+        return this.request<MetadataApiActionsResponse>(
+            'GET',
+            `/api/metadata/object/${objectName}/actions`
+        );
+    }
+    async listByType<T = unknown>(metadataType: string): Promise<MetadataApiListResponse<T>> {
+        return this.request<MetadataApiListResponse<T>>(
+            'GET',
+            `/api/metadata/${metadataType}`
+        );
+    }
+    async getMetadata<T = unknown>(metadataType: string, id: string): Promise<MetadataApiResponse<T>> {
+        return this.request<MetadataApiResponse<T>>(
+            'GET',
+            `/api/metadata/${metadataType}/${id}`
+        );
+    }
+}