@baasix/types 1.0.7 → 1.0.9

package/dist/index.d.mts

@@ -729,6 +729,19 @@ interface QueryParams<T = unknown> {
      * Filter conditions for related items (O2M/M2M)
      */
     relConditions?: Record<string, Filter>;
+    /**
+     * Whether to compute the total record count for the result.
+     *
+     * When omitted (`undefined`), the server falls back to the deployment
+     * default (env `COUNT_BY_DEFAULT`, which itself defaults to `true`).
+     * Passing `false` skips the COUNT query even when the default is on;
+     * passing `true` forces it even when the default is off.
+     *
+     * When the count is skipped, `totalCount` is returned as `null`.
+     * When `limit` is `-1` (return all) with no offset, the count is taken
+     * from the result length instead of running a separate query.
+     */
+    count?: boolean;
     /**
      * Additional metadata
      */
@@ -817,7 +830,12 @@ interface StatsResult {
  */
 interface PaginatedResponse<T> {
     data: T[];
-    totalCount?: number;
+    /**
+     * Total number of records matching the query.
+     * `null` when the count was intentionally skipped via `count: false`
+     * (or the deployment default `COUNT_BY_DEFAULT=false`).
+     */
+    totalCount?: number | null;
     page?: number;
     limit?: number;
     totalPages?: number;
@@ -861,7 +879,11 @@ interface BulkResponse<T = string[]> {
  */
 interface ReadResult<T = any> {
     data: T[];
-    totalCount: number;
+    /**
+     * Total number of records matching the query.
+     * `null` when the count was intentionally skipped (see `QueryParams.count`).
+     */
+    totalCount: number | null;
     page?: number;
     limit?: number;
 }
@@ -1365,6 +1387,21 @@ type AnyRecord = Record<string, unknown>;
 interface Settings {
     [key: string]: unknown;
 }
+/**
+ * Session type limits
+ */
+interface SessionTypeLimits {
+    /** -1 = unlimited, 0 = disabled, positive n = max concurrent sessions */
+    web?: number;
+    mobile?: number;
+}
+/**
+ * Session limits by role and type
+ */
+interface SessionLimits {
+    default?: SessionTypeLimits;
+    roles?: Record<string, SessionTypeLimits>;
+}
 /**
  * Tenant settings
  */
@@ -1394,6 +1431,7 @@ interface TenantSettings {
     email_icon?: any;
     metadata?: Record<string, any>;
     modules?: Record<string, any>;
+    session_limits?: SessionLimits | null;
     [key: string]: any;
 }
 /**
@@ -2083,4 +2121,4 @@ interface ExpressPluginContext extends PluginRouteContext {
     getPluginService: (pluginName: string, serviceName: string) => any;
 }
 
-export type { Accountability, Aggregate, AggregateConfig, AggregateFunction, AggregateMapping, AnyRecord, AssetQuery, AssetTransformOptions, AssociationDefinition, AssociationType, AuthMode, AuthProviderType, AuthResponse, AuthState, AuthStateEvent, AuthTokens, BaasixPlugin, BackgroundTask, BaseItem, BulkResponse, CacheConfig, CacheEntry, CacheSetOptions, CacheStrategy, CollectionItem, CreatePermissionData, DatePart, DateTruncPrecision, DeepPartial, DefaultValueType, DeleteResponse, ErrorResponse, ExportOptions, ExportResult, Express, ExpressApp, ExpressNextFunction, ExpressPluginContext, ExpressPluginMiddleware, ExpressPluginRoute, ExpressPluginRouteHandler, ExpressRequest, ExpressResponse, ExpressRouter, FieldDefinition, FieldInfo, FieldType, FieldValidation, FieldValidationRules, FieldValues, FileData, FileMetadata, Filter, FilterCondition, FilterObject, FilterOperator, FilterValue, FlattenedField, GeoJSONGeometry, GeoJSONLineString, GeoJSONPoint, GeoJSONPolygon, Hook, HookContext, HookEvent, HookFunction, HookHandler, HttpMethod, IAssetsService, ICacheAdapter, ICacheService, IFilesService, IHooksManager, IItemsService, IMailService, IMigrationService, INotificationService, IPermissionService, IRealtimeService, IReportService, ISettingsService, ISocketService, IStatsService, IStorageService, ITasksService, IWorkflowService, ImportOptions, ImportResult, IncludeConfig, IndexDefinition, InternalUploadedFile, JWTPayload, KeysOfType, LoadedPlugin, LogicalFilter, LoginCredentials, MagicLinkOptions, MailOptions, MutationResponse, NextFunction, Notification, NotificationOptions, NotificationType, OAuth2Config, OAuth2Tokens, OAuth2UserInfo, OperatorName, PaginatedResponse, PaginationMetadata, PaginationOptions, PasswordResetOptions, Permission, PermissionAction, PermissionData, PluginApp, PluginAuthProvider, PluginContext, PluginDefinition, PluginFactory, PluginHook, PluginHookContext, PluginHookEvent, PluginHookHandler, PluginManagerOptions, PluginMeta, PluginMiddleware, PluginNextFunction, PluginRequest, PluginResponse, PluginRoute, PluginRouteContext, PluginRouteHandler, PluginRouter, PluginSchedule, PluginSchemaDefinition, PluginService, PluginServiceFactory, PluginType, ProcessedImage, ProcessedInclude, QueryContext, QueryOptions, QueryParams, ReadResult, RegisterData, RelationshipDefinition, RelationshipType, ReportConfig, ReportQuery, ReportResult, Request, Response, Role, Router, SchemaDefinition, SchemaInfo, SchemaValidation, SeedData, SeedResult, SendNotificationData, SenderConfig, ServiceOptions, Session, Settings, SingleResponse, SoftDeletableItem, Sort, SortDirection, SortItem, SortObject, StartServerOptions, StatsQuery, StatsResult, StorageAdapter, StorageProvider, Tenant, TenantSettings, TimestampedItem, UploadOptions, UploadedFile, User, UserWithPassword, UserWithRolesAndPermissions, ValidationResult, WithOptional, WithRequired, Workflow, WorkflowEdge, WorkflowExecution, WorkflowExecutionLog, WorkflowExecutionStatus, WorkflowFlowData, WorkflowNode, WorkflowNodeData, WorkflowStatus, WorkflowTrigger, WorkflowTriggerType };
+export type { Accountability, Aggregate, AggregateConfig, AggregateFunction, AggregateMapping, AnyRecord, AssetQuery, AssetTransformOptions, AssociationDefinition, AssociationType, AuthMode, AuthProviderType, AuthResponse, AuthState, AuthStateEvent, AuthTokens, BaasixPlugin, BackgroundTask, BaseItem, BulkResponse, CacheConfig, CacheEntry, CacheSetOptions, CacheStrategy, CollectionItem, CreatePermissionData, DatePart, DateTruncPrecision, DeepPartial, DefaultValueType, DeleteResponse, ErrorResponse, ExportOptions, ExportResult, Express, ExpressApp, ExpressNextFunction, ExpressPluginContext, ExpressPluginMiddleware, ExpressPluginRoute, ExpressPluginRouteHandler, ExpressRequest, ExpressResponse, ExpressRouter, FieldDefinition, FieldInfo, FieldType, FieldValidation, FieldValidationRules, FieldValues, FileData, FileMetadata, Filter, FilterCondition, FilterObject, FilterOperator, FilterValue, FlattenedField, GeoJSONGeometry, GeoJSONLineString, GeoJSONPoint, GeoJSONPolygon, Hook, HookContext, HookEvent, HookFunction, HookHandler, HttpMethod, IAssetsService, ICacheAdapter, ICacheService, IFilesService, IHooksManager, IItemsService, IMailService, IMigrationService, INotificationService, IPermissionService, IRealtimeService, IReportService, ISettingsService, ISocketService, IStatsService, IStorageService, ITasksService, IWorkflowService, ImportOptions, ImportResult, IncludeConfig, IndexDefinition, InternalUploadedFile, JWTPayload, KeysOfType, LoadedPlugin, LogicalFilter, LoginCredentials, MagicLinkOptions, MailOptions, MutationResponse, NextFunction, Notification, NotificationOptions, NotificationType, OAuth2Config, OAuth2Tokens, OAuth2UserInfo, OperatorName, PaginatedResponse, PaginationMetadata, PaginationOptions, PasswordResetOptions, Permission, PermissionAction, PermissionData, PluginApp, PluginAuthProvider, PluginContext, PluginDefinition, PluginFactory, PluginHook, PluginHookContext, PluginHookEvent, PluginHookHandler, PluginManagerOptions, PluginMeta, PluginMiddleware, PluginNextFunction, PluginRequest, PluginResponse, PluginRoute, PluginRouteContext, PluginRouteHandler, PluginRouter, PluginSchedule, PluginSchemaDefinition, PluginService, PluginServiceFactory, PluginType, ProcessedImage, ProcessedInclude, QueryContext, QueryOptions, QueryParams, ReadResult, RegisterData, RelationshipDefinition, RelationshipType, ReportConfig, ReportQuery, ReportResult, Request, Response, Role, Router, SchemaDefinition, SchemaInfo, SchemaValidation, SeedData, SeedResult, SendNotificationData, SenderConfig, ServiceOptions, Session, SessionLimits, SessionTypeLimits, Settings, SingleResponse, SoftDeletableItem, Sort, SortDirection, SortItem, SortObject, StartServerOptions, StatsQuery, StatsResult, StorageAdapter, StorageProvider, Tenant, TenantSettings, TimestampedItem, UploadOptions, UploadedFile, User, UserWithPassword, UserWithRolesAndPermissions, ValidationResult, WithOptional, WithRequired, Workflow, WorkflowEdge, WorkflowExecution, WorkflowExecutionLog, WorkflowExecutionStatus, WorkflowFlowData, WorkflowNode, WorkflowNodeData, WorkflowStatus, WorkflowTrigger, WorkflowTriggerType };

package/dist/index.d.ts

@@ -729,6 +729,19 @@ interface QueryParams<T = unknown> {
      * Filter conditions for related items (O2M/M2M)
      */
     relConditions?: Record<string, Filter>;
+    /**
+     * Whether to compute the total record count for the result.
+     *
+     * When omitted (`undefined`), the server falls back to the deployment
+     * default (env `COUNT_BY_DEFAULT`, which itself defaults to `true`).
+     * Passing `false` skips the COUNT query even when the default is on;
+     * passing `true` forces it even when the default is off.
+     *
+     * When the count is skipped, `totalCount` is returned as `null`.
+     * When `limit` is `-1` (return all) with no offset, the count is taken
+     * from the result length instead of running a separate query.
+     */
+    count?: boolean;
     /**
      * Additional metadata
      */
@@ -817,7 +830,12 @@ interface StatsResult {
  */
 interface PaginatedResponse<T> {
     data: T[];
-    totalCount?: number;
+    /**
+     * Total number of records matching the query.
+     * `null` when the count was intentionally skipped via `count: false`
+     * (or the deployment default `COUNT_BY_DEFAULT=false`).
+     */
+    totalCount?: number | null;
     page?: number;
     limit?: number;
     totalPages?: number;
@@ -861,7 +879,11 @@ interface BulkResponse<T = string[]> {
  */
 interface ReadResult<T = any> {
     data: T[];
-    totalCount: number;
+    /**
+     * Total number of records matching the query.
+     * `null` when the count was intentionally skipped (see `QueryParams.count`).
+     */
+    totalCount: number | null;
     page?: number;
     limit?: number;
 }
@@ -1365,6 +1387,21 @@ type AnyRecord = Record<string, unknown>;
 interface Settings {
     [key: string]: unknown;
 }
+/**
+ * Session type limits
+ */
+interface SessionTypeLimits {
+    /** -1 = unlimited, 0 = disabled, positive n = max concurrent sessions */
+    web?: number;
+    mobile?: number;
+}
+/**
+ * Session limits by role and type
+ */
+interface SessionLimits {
+    default?: SessionTypeLimits;
+    roles?: Record<string, SessionTypeLimits>;
+}
 /**
  * Tenant settings
  */
@@ -1394,6 +1431,7 @@ interface TenantSettings {
     email_icon?: any;
     metadata?: Record<string, any>;
     modules?: Record<string, any>;
+    session_limits?: SessionLimits | null;
     [key: string]: any;
 }
 /**
@@ -2083,4 +2121,4 @@ interface ExpressPluginContext extends PluginRouteContext {
     getPluginService: (pluginName: string, serviceName: string) => any;
 }
 
-export type { Accountability, Aggregate, AggregateConfig, AggregateFunction, AggregateMapping, AnyRecord, AssetQuery, AssetTransformOptions, AssociationDefinition, AssociationType, AuthMode, AuthProviderType, AuthResponse, AuthState, AuthStateEvent, AuthTokens, BaasixPlugin, BackgroundTask, BaseItem, BulkResponse, CacheConfig, CacheEntry, CacheSetOptions, CacheStrategy, CollectionItem, CreatePermissionData, DatePart, DateTruncPrecision, DeepPartial, DefaultValueType, DeleteResponse, ErrorResponse, ExportOptions, ExportResult, Express, ExpressApp, ExpressNextFunction, ExpressPluginContext, ExpressPluginMiddleware, ExpressPluginRoute, ExpressPluginRouteHandler, ExpressRequest, ExpressResponse, ExpressRouter, FieldDefinition, FieldInfo, FieldType, FieldValidation, FieldValidationRules, FieldValues, FileData, FileMetadata, Filter, FilterCondition, FilterObject, FilterOperator, FilterValue, FlattenedField, GeoJSONGeometry, GeoJSONLineString, GeoJSONPoint, GeoJSONPolygon, Hook, HookContext, HookEvent, HookFunction, HookHandler, HttpMethod, IAssetsService, ICacheAdapter, ICacheService, IFilesService, IHooksManager, IItemsService, IMailService, IMigrationService, INotificationService, IPermissionService, IRealtimeService, IReportService, ISettingsService, ISocketService, IStatsService, IStorageService, ITasksService, IWorkflowService, ImportOptions, ImportResult, IncludeConfig, IndexDefinition, InternalUploadedFile, JWTPayload, KeysOfType, LoadedPlugin, LogicalFilter, LoginCredentials, MagicLinkOptions, MailOptions, MutationResponse, NextFunction, Notification, NotificationOptions, NotificationType, OAuth2Config, OAuth2Tokens, OAuth2UserInfo, OperatorName, PaginatedResponse, PaginationMetadata, PaginationOptions, PasswordResetOptions, Permission, PermissionAction, PermissionData, PluginApp, PluginAuthProvider, PluginContext, PluginDefinition, PluginFactory, PluginHook, PluginHookContext, PluginHookEvent, PluginHookHandler, PluginManagerOptions, PluginMeta, PluginMiddleware, PluginNextFunction, PluginRequest, PluginResponse, PluginRoute, PluginRouteContext, PluginRouteHandler, PluginRouter, PluginSchedule, PluginSchemaDefinition, PluginService, PluginServiceFactory, PluginType, ProcessedImage, ProcessedInclude, QueryContext, QueryOptions, QueryParams, ReadResult, RegisterData, RelationshipDefinition, RelationshipType, ReportConfig, ReportQuery, ReportResult, Request, Response, Role, Router, SchemaDefinition, SchemaInfo, SchemaValidation, SeedData, SeedResult, SendNotificationData, SenderConfig, ServiceOptions, Session, Settings, SingleResponse, SoftDeletableItem, Sort, SortDirection, SortItem, SortObject, StartServerOptions, StatsQuery, StatsResult, StorageAdapter, StorageProvider, Tenant, TenantSettings, TimestampedItem, UploadOptions, UploadedFile, User, UserWithPassword, UserWithRolesAndPermissions, ValidationResult, WithOptional, WithRequired, Workflow, WorkflowEdge, WorkflowExecution, WorkflowExecutionLog, WorkflowExecutionStatus, WorkflowFlowData, WorkflowNode, WorkflowNodeData, WorkflowStatus, WorkflowTrigger, WorkflowTriggerType };
+export type { Accountability, Aggregate, AggregateConfig, AggregateFunction, AggregateMapping, AnyRecord, AssetQuery, AssetTransformOptions, AssociationDefinition, AssociationType, AuthMode, AuthProviderType, AuthResponse, AuthState, AuthStateEvent, AuthTokens, BaasixPlugin, BackgroundTask, BaseItem, BulkResponse, CacheConfig, CacheEntry, CacheSetOptions, CacheStrategy, CollectionItem, CreatePermissionData, DatePart, DateTruncPrecision, DeepPartial, DefaultValueType, DeleteResponse, ErrorResponse, ExportOptions, ExportResult, Express, ExpressApp, ExpressNextFunction, ExpressPluginContext, ExpressPluginMiddleware, ExpressPluginRoute, ExpressPluginRouteHandler, ExpressRequest, ExpressResponse, ExpressRouter, FieldDefinition, FieldInfo, FieldType, FieldValidation, FieldValidationRules, FieldValues, FileData, FileMetadata, Filter, FilterCondition, FilterObject, FilterOperator, FilterValue, FlattenedField, GeoJSONGeometry, GeoJSONLineString, GeoJSONPoint, GeoJSONPolygon, Hook, HookContext, HookEvent, HookFunction, HookHandler, HttpMethod, IAssetsService, ICacheAdapter, ICacheService, IFilesService, IHooksManager, IItemsService, IMailService, IMigrationService, INotificationService, IPermissionService, IRealtimeService, IReportService, ISettingsService, ISocketService, IStatsService, IStorageService, ITasksService, IWorkflowService, ImportOptions, ImportResult, IncludeConfig, IndexDefinition, InternalUploadedFile, JWTPayload, KeysOfType, LoadedPlugin, LogicalFilter, LoginCredentials, MagicLinkOptions, MailOptions, MutationResponse, NextFunction, Notification, NotificationOptions, NotificationType, OAuth2Config, OAuth2Tokens, OAuth2UserInfo, OperatorName, PaginatedResponse, PaginationMetadata, PaginationOptions, PasswordResetOptions, Permission, PermissionAction, PermissionData, PluginApp, PluginAuthProvider, PluginContext, PluginDefinition, PluginFactory, PluginHook, PluginHookContext, PluginHookEvent, PluginHookHandler, PluginManagerOptions, PluginMeta, PluginMiddleware, PluginNextFunction, PluginRequest, PluginResponse, PluginRoute, PluginRouteContext, PluginRouteHandler, PluginRouter, PluginSchedule, PluginSchemaDefinition, PluginService, PluginServiceFactory, PluginType, ProcessedImage, ProcessedInclude, QueryContext, QueryOptions, QueryParams, ReadResult, RegisterData, RelationshipDefinition, RelationshipType, ReportConfig, ReportQuery, ReportResult, Request, Response, Role, Router, SchemaDefinition, SchemaInfo, SchemaValidation, SeedData, SeedResult, SendNotificationData, SenderConfig, ServiceOptions, Session, SessionLimits, SessionTypeLimits, Settings, SingleResponse, SoftDeletableItem, Sort, SortDirection, SortItem, SortObject, StartServerOptions, StatsQuery, StatsResult, StorageAdapter, StorageProvider, Tenant, TenantSettings, TimestampedItem, UploadOptions, UploadedFile, User, UserWithPassword, UserWithRolesAndPermissions, ValidationResult, WithOptional, WithRequired, Workflow, WorkflowEdge, WorkflowExecution, WorkflowExecutionLog, WorkflowExecutionStatus, WorkflowFlowData, WorkflowNode, WorkflowNodeData, WorkflowStatus, WorkflowTrigger, WorkflowTriggerType };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@baasix/types",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "Shared TypeScript types for Baasix packages",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

package/src/common.ts

@@ -80,6 +80,23 @@ export interface Settings {
   [key: string]: unknown;
 }
 
+/**
+ * Session type limits
+ */
+export interface SessionTypeLimits {
+  /** -1 = unlimited, 0 = disabled, positive n = max concurrent sessions */
+  web?: number;
+  mobile?: number;
+}
+
+/**
+ * Session limits by role and type
+ */
+export interface SessionLimits {
+  default?: SessionTypeLimits;
+  roles?: Record<string, SessionTypeLimits>;
+}
+
 /**
  * Tenant settings
  */
@@ -109,6 +126,7 @@ export interface TenantSettings {
   email_icon?: any;
   metadata?: Record<string, any>;
   modules?: Record<string, any>;
+  session_limits?: SessionLimits | null;
   [key: string]: any;
 }
 

package/src/index.ts

@@ -1,309 +1,311 @@
-/**
- * @baasix/types
- * Shared TypeScript types for Baasix packages
- *
- * This package provides common type definitions used across:
- * - @baasix/core (backend)
- * - @baasix/sdk (client SDK)
- * - @baasix/cli (command-line interface)
- * - @baasix/app (admin panel)
- */
-
-// ============================================================================
-// Auth Types
-// ============================================================================
-export type {
-  // User types
-  User,
-  UserWithPassword,
-  UserWithRolesAndPermissions,
-  // Role & Permission types
-  Role,
-  PermissionAction,
-  Permission,
-  PermissionData,
-  CreatePermissionData,
-  // Tenant types
-  Tenant,
-  // Session & Token types
-  Session,
-  AuthTokens,
-  JWTPayload,
-  // Accountability
-  Accountability,
-  // Auth request/response types
-  LoginCredentials,
-  RegisterData,
-  AuthResponse,
-  AuthStateEvent,
-  AuthState,
-  MagicLinkOptions,
-  PasswordResetOptions,
-  // OAuth types
-  OAuth2Tokens,
-  OAuth2UserInfo,
-  // Auth mode
-  AuthMode,
-} from "./auth";
-
-// ============================================================================
-// Schema Types
-// ============================================================================
-export type {
-  // Field types
-  FieldType,
-  DefaultValueType,
-  FieldValidationRules,
-  FieldValues,
-  FieldDefinition,
-  FlattenedField,
-  FieldInfo,
-  // Schema types
-  IndexDefinition,
-  SchemaDefinition,
-  SchemaInfo,
-  SchemaValidation,
-  FieldValidation,
-  ValidationResult,
-  // Relationship types
-  RelationshipType,
-  AssociationType,
-  RelationshipDefinition,
-  AssociationDefinition,
-  IncludeConfig,
-  ProcessedInclude,
-} from "./schema";
-
-// ============================================================================
-// Query Types (includes Report & Stats query types)
-// ============================================================================
-export type {
-  // Filter types
-  FilterOperator,
-  OperatorName,
-  FilterValue,
-  FilterCondition,
-  LogicalFilter,
-  Filter,
-  FilterObject,
-  // Sort types
-  SortDirection,
-  Sort,
-  SortItem,
-  SortObject,
-  // Pagination types
-  PaginationOptions,
-  PaginationMetadata,
-  // Aggregation types
-  AggregateFunction,
-  AggregateConfig,
-  Aggregate,
-  AggregateMapping,
-  DatePart,
-  DateTruncPrecision,
-  // Query parameters
-  QueryParams,
-  QueryOptions,
-  QueryContext,
-  // Report query types
-  ReportConfig,
-  ReportResult,
-  ReportQuery,
-  // Stats query types
-  StatsQuery,
-  StatsResult,
-} from "./query";
-
-// ============================================================================
-// Response Types
-// ============================================================================
-export type {
-  PaginatedResponse,
-  SingleResponse,
-  MutationResponse,
-  DeleteResponse,
-  BulkResponse,
-  ReadResult,
-  ErrorResponse,
-} from "./response";
-
-// ============================================================================
-// File Types (includes Import/Export types)
-// ============================================================================
-export type {
-  // File metadata
-  FileMetadata,
-  FileData,
-  UploadOptions,
-  InternalUploadedFile,
-  // Asset types
-  AssetTransformOptions,
-  AssetQuery,
-  ProcessedImage,
-  // Storage types
-  StorageProvider,
-  StorageAdapter,
-  // Import/Export types
-  UploadedFile,
-  ImportOptions,
-  ExportOptions,
-  ImportResult,
-  ExportResult,
-} from "./files";
-
-// ============================================================================
-// Workflow Types
-// ============================================================================
-export type {
-  WorkflowTriggerType,
-  WorkflowStatus,
-  Workflow,
-  WorkflowFlowData,
-  WorkflowTrigger,
-  WorkflowNode,
-  WorkflowNodeData,
-  WorkflowEdge,
-  WorkflowExecutionStatus,
-  WorkflowExecution,
-  WorkflowExecutionLog,
-} from "./workflow";
-
-// ============================================================================
-// Notification Types
-// ============================================================================
-export type {
-  NotificationType,
-  Notification,
-  NotificationOptions,
-  SendNotificationData,
-} from "./notification";
-
-// ============================================================================
-// Spatial/GeoJSON Types
-// ============================================================================
-export type {
-  GeoJSONPoint,
-  GeoJSONLineString,
-  GeoJSONPolygon,
-  GeoJSONGeometry,
-} from "./spatial";
-
-// ============================================================================
-// Cache Types
-// ============================================================================
-export type {
-  CacheConfig,
-  CacheSetOptions,
-  CacheStrategy,
-  CacheEntry,
-  ICacheAdapter,
-} from "./cache";
-
-// ============================================================================
-// Common Types
-// ============================================================================
-export type {
-  // Base types
-  BaseItem,
-  TimestampedItem,
-  SoftDeletableItem,
-  // Utility types
-  DeepPartial,
-  CollectionItem,
-  WithRequired,
-  WithOptional,
-  KeysOfType,
-  AnyRecord,
-  // Settings types
-  Settings,
-  TenantSettings,
-  // Task types
-  BackgroundTask,
-  // Hook types
-  HookEvent,
-  HookContext,
-  HookHandler,
-  Hook,
-  // HTTP types
-  HttpMethod,
-  // Mail types
-  MailOptions,
-  SenderConfig,
-  // Seed types
-  SeedData,
-  SeedResult,
-} from "./common";
-
-// ============================================================================
-// Plugin Types
-// ============================================================================
-export type {
-  // Express types (actual Express types from @types/express)
-  Request,
-  Response,
-  NextFunction,
-  Express,
-  Router,
-  // Express type aliases
-  ExpressRequest,
-  ExpressResponse,
-  ExpressNextFunction,
-  ExpressApp,
-  ExpressRouter,
-  // Express-compatible types (can be used without importing express)
-  PluginRequest,
-  PluginResponse,
-  PluginNextFunction,
-  PluginApp,
-  PluginRouter,
-  // Service interfaces
-  ServiceOptions,
-  IItemsService,
-  IPermissionService,
-  IMailService,
-  IStorageService,
-  ISettingsService,
-  ISocketService,
-  IRealtimeService,
-  ITasksService,
-  IWorkflowService,
-  IMigrationService,
-  IHooksManager,
-  HookFunction,
-  ICacheService,
-  IFilesService,
-  IAssetsService,
-  INotificationService,
-  IReportService,
-  IStatsService,
-  // Plugin types
-  PluginType,
-  PluginMeta,
-  PluginSchemaDefinition,
-  PluginRouteContext,
-  PluginRouteHandler,
-  PluginRoute,
-  PluginHookEvent,
-  PluginHookContext,
-  PluginHookHandler,
-  PluginHook,
-  PluginContext,
-  PluginServiceFactory,
-  PluginService,
-  AuthProviderType,
-  OAuth2Config,
-  PluginAuthProvider,
-  PluginMiddleware,
-  PluginSchedule,
-  PluginDefinition,
-  PluginFactory,
-  BaasixPlugin,
-  LoadedPlugin,
-  PluginManagerOptions,
-  StartServerOptions,
-  // Express-typed plugin types (for core package)
-  ExpressPluginRouteHandler,
-  ExpressPluginRoute,
-  ExpressPluginMiddleware,
-  ExpressPluginContext,
-} from "./plugin";
+/**
+ * @baasix/types
+ * Shared TypeScript types for Baasix packages
+ *
+ * This package provides common type definitions used across:
+ * - @baasix/core (backend)
+ * - @baasix/sdk (client SDK)
+ * - @baasix/cli (command-line interface)
+ * - @baasix/app (admin panel)
+ */
+
+// ============================================================================
+// Auth Types
+// ============================================================================
+export type {
+  // User types
+  User,
+  UserWithPassword,
+  UserWithRolesAndPermissions,
+  // Role & Permission types
+  Role,
+  PermissionAction,
+  Permission,
+  PermissionData,
+  CreatePermissionData,
+  // Tenant types
+  Tenant,
+  // Session & Token types
+  Session,
+  AuthTokens,
+  JWTPayload,
+  // Accountability
+  Accountability,
+  // Auth request/response types
+  LoginCredentials,
+  RegisterData,
+  AuthResponse,
+  AuthStateEvent,
+  AuthState,
+  MagicLinkOptions,
+  PasswordResetOptions,
+  // OAuth types
+  OAuth2Tokens,
+  OAuth2UserInfo,
+  // Auth mode
+  AuthMode,
+} from "./auth";
+
+// ============================================================================
+// Schema Types
+// ============================================================================
+export type {
+  // Field types
+  FieldType,
+  DefaultValueType,
+  FieldValidationRules,
+  FieldValues,
+  FieldDefinition,
+  FlattenedField,
+  FieldInfo,
+  // Schema types
+  IndexDefinition,
+  SchemaDefinition,
+  SchemaInfo,
+  SchemaValidation,
+  FieldValidation,
+  ValidationResult,
+  // Relationship types
+  RelationshipType,
+  AssociationType,
+  RelationshipDefinition,
+  AssociationDefinition,
+  IncludeConfig,
+  ProcessedInclude,
+} from "./schema";
+
+// ============================================================================
+// Query Types (includes Report & Stats query types)
+// ============================================================================
+export type {
+  // Filter types
+  FilterOperator,
+  OperatorName,
+  FilterValue,
+  FilterCondition,
+  LogicalFilter,
+  Filter,
+  FilterObject,
+  // Sort types
+  SortDirection,
+  Sort,
+  SortItem,
+  SortObject,
+  // Pagination types
+  PaginationOptions,
+  PaginationMetadata,
+  // Aggregation types
+  AggregateFunction,
+  AggregateConfig,
+  Aggregate,
+  AggregateMapping,
+  DatePart,
+  DateTruncPrecision,
+  // Query parameters
+  QueryParams,
+  QueryOptions,
+  QueryContext,
+  // Report query types
+  ReportConfig,
+  ReportResult,
+  ReportQuery,
+  // Stats query types
+  StatsQuery,
+  StatsResult,
+} from "./query";
+
+// ============================================================================
+// Response Types
+// ============================================================================
+export type {
+  PaginatedResponse,
+  SingleResponse,
+  MutationResponse,
+  DeleteResponse,
+  BulkResponse,
+  ReadResult,
+  ErrorResponse,
+} from "./response";
+
+// ============================================================================
+// File Types (includes Import/Export types)
+// ============================================================================
+export type {
+  // File metadata
+  FileMetadata,
+  FileData,
+  UploadOptions,
+  InternalUploadedFile,
+  // Asset types
+  AssetTransformOptions,
+  AssetQuery,
+  ProcessedImage,
+  // Storage types
+  StorageProvider,
+  StorageAdapter,
+  // Import/Export types
+  UploadedFile,
+  ImportOptions,
+  ExportOptions,
+  ImportResult,
+  ExportResult,
+} from "./files";
+
+// ============================================================================
+// Workflow Types
+// ============================================================================
+export type {
+  WorkflowTriggerType,
+  WorkflowStatus,
+  Workflow,
+  WorkflowFlowData,
+  WorkflowTrigger,
+  WorkflowNode,
+  WorkflowNodeData,
+  WorkflowEdge,
+  WorkflowExecutionStatus,
+  WorkflowExecution,
+  WorkflowExecutionLog,
+} from "./workflow";
+
+// ============================================================================
+// Notification Types
+// ============================================================================
+export type {
+  NotificationType,
+  Notification,
+  NotificationOptions,
+  SendNotificationData,
+} from "./notification";
+
+// ============================================================================
+// Spatial/GeoJSON Types
+// ============================================================================
+export type {
+  GeoJSONPoint,
+  GeoJSONLineString,
+  GeoJSONPolygon,
+  GeoJSONGeometry,
+} from "./spatial";
+
+// ============================================================================
+// Cache Types
+// ============================================================================
+export type {
+  CacheConfig,
+  CacheSetOptions,
+  CacheStrategy,
+  CacheEntry,
+  ICacheAdapter,
+} from "./cache";
+
+// ============================================================================
+// Common Types
+// ============================================================================
+export type {
+  // Base types
+  BaseItem,
+  TimestampedItem,
+  SoftDeletableItem,
+  // Utility types
+  DeepPartial,
+  CollectionItem,
+  WithRequired,
+  WithOptional,
+  KeysOfType,
+  AnyRecord,
+  // Settings types
+  Settings,
+  TenantSettings,
+  SessionTypeLimits,
+  SessionLimits,
+  // Task types
+  BackgroundTask,
+  // Hook types
+  HookEvent,
+  HookContext,
+  HookHandler,
+  Hook,
+  // HTTP types
+  HttpMethod,
+  // Mail types
+  MailOptions,
+  SenderConfig,
+  // Seed types
+  SeedData,
+  SeedResult,
+} from "./common";
+
+// ============================================================================
+// Plugin Types
+// ============================================================================
+export type {
+  // Express types (actual Express types from @types/express)
+  Request,
+  Response,
+  NextFunction,
+  Express,
+  Router,
+  // Express type aliases
+  ExpressRequest,
+  ExpressResponse,
+  ExpressNextFunction,
+  ExpressApp,
+  ExpressRouter,
+  // Express-compatible types (can be used without importing express)
+  PluginRequest,
+  PluginResponse,
+  PluginNextFunction,
+  PluginApp,
+  PluginRouter,
+  // Service interfaces
+  ServiceOptions,
+  IItemsService,
+  IPermissionService,
+  IMailService,
+  IStorageService,
+  ISettingsService,
+  ISocketService,
+  IRealtimeService,
+  ITasksService,
+  IWorkflowService,
+  IMigrationService,
+  IHooksManager,
+  HookFunction,
+  ICacheService,
+  IFilesService,
+  IAssetsService,
+  INotificationService,
+  IReportService,
+  IStatsService,
+  // Plugin types
+  PluginType,
+  PluginMeta,
+  PluginSchemaDefinition,
+  PluginRouteContext,
+  PluginRouteHandler,
+  PluginRoute,
+  PluginHookEvent,
+  PluginHookContext,
+  PluginHookHandler,
+  PluginHook,
+  PluginContext,
+  PluginServiceFactory,
+  PluginService,
+  AuthProviderType,
+  OAuth2Config,
+  PluginAuthProvider,
+  PluginMiddleware,
+  PluginSchedule,
+  PluginDefinition,
+  PluginFactory,
+  BaasixPlugin,
+  LoadedPlugin,
+  PluginManagerOptions,
+  StartServerOptions,
+  // Express-typed plugin types (for core package)
+  ExpressPluginRouteHandler,
+  ExpressPluginRoute,
+  ExpressPluginMiddleware,
+  ExpressPluginContext,
+} from "./plugin";

package/src/query.ts

@@ -353,6 +353,20 @@ export interface QueryParams<T = unknown> {
    */
   relConditions?: Record<string, Filter>;
 
+  /**
+   * Whether to compute the total record count for the result.
+   *
+   * When omitted (`undefined`), the server falls back to the deployment
+   * default (env `COUNT_BY_DEFAULT`, which itself defaults to `true`).
+   * Passing `false` skips the COUNT query even when the default is on;
+   * passing `true` forces it even when the default is off.
+   *
+   * When the count is skipped, `totalCount` is returned as `null`.
+   * When `limit` is `-1` (return all) with no offset, the count is taken
+   * from the result length instead of running a separate query.
+   */
+  count?: boolean;
+
   /**
    * Additional metadata
    */

package/src/response.ts

@@ -12,7 +12,12 @@
  */
 export interface PaginatedResponse<T> {
   data: T[];
-  totalCount?: number;
+  /**
+   * Total number of records matching the query.
+   * `null` when the count was intentionally skipped via `count: false`
+   * (or the deployment default `COUNT_BY_DEFAULT=false`).
+   */
+  totalCount?: number | null;
   page?: number;
   limit?: number;
   totalPages?: number;
@@ -55,7 +60,11 @@ export interface BulkResponse<T = string[]> {
  */
 export interface ReadResult<T = any> {
   data: T[];
-  totalCount: number;
+  /**
+   * Total number of records matching the query.
+   * `null` when the count was intentionally skipped (see `QueryParams.count`).
+   */
+  totalCount: number | null;
   page?: number;
   limit?: number;
 }