@objectstack/client 2.0.0 → 2.0.1

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { FilterCondition, QueryAST, SortNode, AggregationNode } from '@objectstack/spec/data';
-import { GetDiscoveryResponse, StandardErrorCode, ErrorCategory, GetMetaTypesResponse, GetMetaItemsResponse, MetadataCacheRequest, MetadataCacheResponse, LoginRequest, SessionResponse, FileUploadResponse, BatchUpdateRequest, BatchUpdateResponse, BatchOptions } from '@objectstack/spec/api';
-export { BatchOperationResult, BatchOptions, BatchRecord, BatchUpdateRequest, BatchUpdateResponse, DeleteManyRequest, ErrorCategory, GetDiscoveryResponse, GetMetaItemsResponse, GetMetaTypesResponse, MetadataCacheRequest, MetadataCacheResponse, StandardErrorCode, UpdateManyRequest } from '@objectstack/spec/api';
+import { GetDiscoveryResponse, StandardErrorCode, ErrorCategory, GetMetaTypesResponse, GetMetaItemsResponse, MetadataCacheRequest, MetadataCacheResponse, LoginRequest, SessionResponse, RegisterRequest, FileUploadResponse, CheckPermissionRequest, CheckPermissionResponse, GetObjectPermissionsResponse, GetEffectivePermissionsResponse, RealtimeConnectRequest, RealtimeConnectResponse, RealtimeSubscribeRequest, RealtimeSubscribeResponse, SetPresenceRequest, GetPresenceResponse, GetWorkflowConfigResponse, GetWorkflowStateResponse, WorkflowTransitionRequest, WorkflowTransitionResponse, WorkflowApproveRequest, WorkflowApproveResponse, WorkflowRejectRequest, WorkflowRejectResponse, ListViewsResponse, GetViewResponse, CreateViewRequest, CreateViewResponse, UpdateViewRequest, UpdateViewResponse, DeleteViewResponse, RegisterDeviceRequest, RegisterDeviceResponse, UnregisterDeviceResponse, GetNotificationPreferencesResponse, UpdateNotificationPreferencesRequest, UpdateNotificationPreferencesResponse, ListNotificationsResponse, MarkNotificationsReadResponse, MarkAllNotificationsReadResponse, AiNlqRequest, AiNlqResponse, AiChatRequest, AiChatResponse, AiSuggestRequest, AiSuggestResponse, AiInsightsRequest, AiInsightsResponse, GetLocalesResponse, GetTranslationsResponse, GetFieldLabelsResponse, BatchUpdateRequest, BatchUpdateResponse, BatchOptions } from '@objectstack/spec/api';
+export { AiChatRequest, AiChatResponse, AiInsightsRequest, AiInsightsResponse, AiNlqRequest, AiNlqResponse, AiSuggestRequest, AiSuggestResponse, BatchOperationResult, BatchOptions, BatchRecord, BatchUpdateRequest, BatchUpdateResponse, CheckPermissionRequest, CheckPermissionResponse, CreateViewResponse, DeleteManyRequest, DeleteViewResponse, ErrorCategory, GetDiscoveryResponse, GetEffectivePermissionsResponse, GetFieldLabelsResponse, GetLocalesResponse, GetMetaItemsResponse, GetMetaTypesResponse, GetObjectPermissionsResponse, GetPresenceResponse, GetTranslationsResponse, GetViewResponse, GetWorkflowConfigResponse, GetWorkflowStateResponse, ListNotificationsResponse, ListViewsResponse, MetadataCacheRequest, MetadataCacheResponse, RealtimeConnectRequest, RealtimeConnectResponse, RealtimeSubscribeRequest, RealtimeSubscribeResponse, RefreshTokenRequest, RegisterDeviceRequest, RegisterDeviceResponse, RegisterRequest, StandardErrorCode, UpdateManyRequest, UpdateViewResponse, WorkflowApproveRequest, WorkflowApproveResponse, WorkflowRejectRequest, WorkflowRejectResponse, WorkflowTransitionRequest, WorkflowTransitionResponse } from '@objectstack/spec/api';
 import { Logger } from '@objectstack/core';
 
 /**
@@ -62,6 +62,26 @@ declare class FilterBuilder<T = any> {
      * IS NOT NULL filter: field IS NOT NULL
      */
     isNotNull<K extends keyof T>(field: K): this;
+    /**
+     * BETWEEN filter: field BETWEEN min AND max
+     */
+    between<K extends keyof T>(field: K, min: T[K], max: T[K]): this;
+    /**
+     * CONTAINS filter: field contains value (case-insensitive LIKE %value%)
+     */
+    contains<K extends keyof T>(field: K, value: string): this;
+    /**
+     * STARTS WITH filter: field starts with value (LIKE value%)
+     */
+    startsWith<K extends keyof T>(field: K, value: string): this;
+    /**
+     * ENDS WITH filter: field ends with value (LIKE %value)
+     */
+    endsWith<K extends keyof T>(field: K, value: string): this;
+    /**
+     * EXISTS filter: field is not null (alias for isNotNull)
+     */
+    exists<K extends keyof T>(field: K): this;
     /**
      * Build the filter condition
      */
@@ -110,6 +130,25 @@ declare class QueryBuilder<T = any> {
      * Group by fields
      */
     groupBy<K extends keyof T>(...fields: K[]): this;
+    /**
+     * Expand (eager-load) a related object with an optional sub-query
+     */
+    expand(relation: string, subQuery?: Partial<QueryAST>): this;
+    /**
+     * Add full-text search
+     */
+    search(query: string, options?: {
+        fields?: string[];
+        fuzzy?: boolean;
+    }): this;
+    /**
+     * Set cursor for keyset pagination
+     */
+    cursor(cursor: Record<string, any>): this;
+    /**
+     * Enable SELECT DISTINCT
+     */
+    distinct(): this;
     /**
      * Build the final query AST
      */
@@ -223,7 +262,6 @@ declare class ObjectStackClient {
             graphql: boolean;
             notifications: boolean;
             analytics: boolean;
-            hub: boolean;
             ai: boolean;
             i18n: boolean;
             workflow: boolean;
@@ -232,13 +270,12 @@ declare class ObjectStackClient {
         endpoints?: {
             data: string;
             metadata: string;
-            auth: string;
             graphql?: string | undefined;
             notifications?: string | undefined;
             storage?: string | undefined;
+            auth?: string | undefined;
             automation?: string | undefined;
             analytics?: string | undefined;
-            hub?: string | undefined;
             realtime?: string | undefined;
             ai?: string | undefined;
             i18n?: string | undefined;
@@ -298,18 +335,6 @@ declare class ObjectStackClient {
         meta: (cube: string) => Promise<any>;
         explain: (payload: any) => Promise<any>;
     };
-    /**
-     * Hub Management Services
-     */
-    hub: {
-        spaces: {
-            list: () => Promise<any>;
-            create: (payload: any) => Promise<any>;
-        };
-        plugins: {
-            install: (pkg: string, version?: string) => Promise<any>;
-        };
-    };
     /**
      * Package Management Services
      *
@@ -384,6 +409,14 @@ declare class ObjectStackClient {
         login: (request: LoginRequest) => Promise<SessionResponse>;
         logout: () => Promise<void>;
         me: () => Promise<SessionResponse>;
+        /**
+         * Register a new user account
+         */
+        register: (request: RegisterRequest) => Promise<SessionResponse>;
+        /**
+         * Refresh an authentication token
+         */
+        refreshToken: (refreshToken: string) => Promise<SessionResponse>;
     };
     /**
      * Storage Services
@@ -398,6 +431,181 @@ declare class ObjectStackClient {
     automation: {
         trigger: (triggerName: string, payload: any) => Promise<any>;
     };
+    /**
+     * Permissions Services
+     */
+    permissions: {
+        /**
+         * Check if current user has permission for an action on an object
+         */
+        check: (request: CheckPermissionRequest) => Promise<CheckPermissionResponse>;
+        /**
+         * Get all permissions for a specific object
+         */
+        getObjectPermissions: (object: string) => Promise<GetObjectPermissionsResponse>;
+        /**
+         * Get effective permissions for the current user
+         */
+        getEffectivePermissions: () => Promise<GetEffectivePermissionsResponse>;
+    };
+    /**
+     * Realtime Services
+     */
+    realtime: {
+        /**
+         * Establish a realtime connection
+         */
+        connect: (request?: RealtimeConnectRequest) => Promise<RealtimeConnectResponse>;
+        /**
+         * Disconnect from realtime services
+         */
+        disconnect: () => Promise<void>;
+        /**
+         * Subscribe to a channel
+         */
+        subscribe: (request: RealtimeSubscribeRequest) => Promise<RealtimeSubscribeResponse>;
+        /**
+         * Unsubscribe from a channel
+         */
+        unsubscribe: (subscriptionId: string) => Promise<void>;
+        /**
+         * Set presence state on a channel
+         */
+        setPresence: (channel: string, state: SetPresenceRequest["state"]) => Promise<void>;
+        /**
+         * Get presence information for a channel
+         */
+        getPresence: (channel: string) => Promise<GetPresenceResponse>;
+    };
+    /**
+     * Workflow Services
+     */
+    workflow: {
+        /**
+         * Get workflow configuration for an object
+         */
+        getConfig: (object: string) => Promise<GetWorkflowConfigResponse>;
+        /**
+         * Get current workflow state for a record
+         */
+        getState: (object: string, recordId: string) => Promise<GetWorkflowStateResponse>;
+        /**
+         * Execute a workflow state transition
+         */
+        transition: (request: WorkflowTransitionRequest) => Promise<WorkflowTransitionResponse>;
+        /**
+         * Approve a workflow step
+         */
+        approve: (request: WorkflowApproveRequest) => Promise<WorkflowApproveResponse>;
+        /**
+         * Reject a workflow step
+         */
+        reject: (request: WorkflowRejectRequest) => Promise<WorkflowRejectResponse>;
+    };
+    /**
+     * Views CRUD Services
+     */
+    views: {
+        /**
+         * List views for an object
+         */
+        list: (object: string, type?: "list" | "form") => Promise<ListViewsResponse>;
+        /**
+         * Get a specific view
+         */
+        get: (object: string, viewId: string) => Promise<GetViewResponse>;
+        /**
+         * Create a new view
+         */
+        create: (object: string, data: CreateViewRequest["data"]) => Promise<CreateViewResponse>;
+        /**
+         * Update an existing view
+         */
+        update: (object: string, viewId: string, data: UpdateViewRequest["data"]) => Promise<UpdateViewResponse>;
+        /**
+         * Delete a view
+         */
+        delete: (object: string, viewId: string) => Promise<DeleteViewResponse>;
+    };
+    /**
+     * Notification Services
+     */
+    notifications: {
+        /**
+         * Register a device for push notifications
+         */
+        registerDevice: (request: RegisterDeviceRequest) => Promise<RegisterDeviceResponse>;
+        /**
+         * Unregister a device from push notifications
+         */
+        unregisterDevice: (deviceId: string) => Promise<UnregisterDeviceResponse>;
+        /**
+         * Get notification preferences for the current user
+         */
+        getPreferences: () => Promise<GetNotificationPreferencesResponse>;
+        /**
+         * Update notification preferences
+         */
+        updatePreferences: (preferences: UpdateNotificationPreferencesRequest["preferences"]) => Promise<UpdateNotificationPreferencesResponse>;
+        /**
+         * List notifications for the current user
+         */
+        list: (options?: {
+            read?: boolean;
+            type?: string;
+            limit?: number;
+            cursor?: string;
+        }) => Promise<ListNotificationsResponse>;
+        /**
+         * Mark specific notifications as read
+         */
+        markRead: (ids: string[]) => Promise<MarkNotificationsReadResponse>;
+        /**
+         * Mark all notifications as read
+         */
+        markAllRead: () => Promise<MarkAllNotificationsReadResponse>;
+    };
+    /**
+     * AI Services
+     */
+    ai: {
+        /**
+         * Natural language query — converts natural language to structured query
+         */
+        nlq: (request: AiNlqRequest) => Promise<AiNlqResponse>;
+        /**
+         * Multi-turn AI chat
+         */
+        chat: (request: AiChatRequest) => Promise<AiChatResponse>;
+        /**
+         * AI-powered field value suggestions
+         */
+        suggest: (request: AiSuggestRequest) => Promise<AiSuggestResponse>;
+        /**
+         * AI-powered data insights
+         */
+        insights: (request: AiInsightsRequest) => Promise<AiInsightsResponse>;
+    };
+    /**
+     * Internationalization Services
+     */
+    i18n: {
+        /**
+         * Get available locales
+         */
+        getLocales: () => Promise<GetLocalesResponse>;
+        /**
+         * Get translations for a locale
+         */
+        getTranslations: (locale: string, options?: {
+            namespace?: string;
+            keys?: string[];
+        }) => Promise<GetTranslationsResponse>;
+        /**
+         * Get translated field labels for an object
+         */
+        getFieldLabels: (object: string, locale: string) => Promise<GetFieldLabelsResponse>;
+    };
     /**
      * Data Operations
      */