@snackbase/sdk 0.1.1 → 0.2.0

package/dist/{index-Dr6K4PMl.d.mts → index.d.cts}

@@ -1,5 +1,5 @@
 //#region src/types/config.d.ts
-type LogLevel$1 = 'debug' | 'info' | 'warn' | 'error';
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
 type StorageBackend = 'localStorage' | 'sessionStorage' | 'memory' | 'asyncStorage';
 interface SnackBaseConfig {
   /**
@@ -44,7 +44,7 @@ interface SnackBaseConfig {
   /**
    * Logging level (default: 'error')
    */
-  logLevel?: LogLevel$1;
+  logLevel?: LogLevel;
   /**
    * Callback for 401 authentication errors
    */
@@ -73,7 +73,7 @@ interface SnackBaseConfig {
 declare const DEFAULT_CONFIG: Partial<SnackBaseConfig>;
 //#endregion
 //#region src/core/logger.d.ts
-declare enum LogLevel {
+declare enum LogLevel$1 {
   NONE = 0,
   ERROR = 1,
   WARN = 2,
@@ -82,7 +82,7 @@ declare enum LogLevel {
 }
 interface LogEntry {
   timestamp: string;
-  level: LogLevel;
+  level: LogLevel$1;
   message: string;
   data?: any;
 }
@@ -91,8 +91,8 @@ declare class Logger {
   private handlers;
   private logs;
   private maxLogs;
-  constructor(level?: LogLevel);
-  setLevel(level: LogLevel): void;
+  constructor(level?: LogLevel$1);
+  setLevel(level: LogLevel$1): void;
   getLogs(): LogEntry[];
   clearLogs(): void;
   private log;
@@ -153,7 +153,7 @@ declare class HttpClient {
 }
 //#endregion
 //#region src/types/account.d.ts
-interface Account$1 {
+interface Account {
   id: string;
   slug: string;
   name: string;
@@ -176,7 +176,7 @@ interface AccountListParams {
   [key: string]: string | number | boolean | undefined;
 }
 interface AccountListResponse {
-  items: Account$1[];
+  items: Account[];
   total: number;
 }
 interface AccountUserListParams {
@@ -186,7 +186,7 @@ interface AccountUserListParams {
 }
 //#endregion
 //#region src/types/user.d.ts
-interface User$1 {
+interface User {
   id: string;
   email: string;
   role: string;
@@ -218,7 +218,7 @@ interface UserListParams {
   [key: string]: string | number | boolean | undefined;
 }
 interface UserListResponse {
-  items: User$1[];
+  items: User[];
   total: number;
 }
 //#endregion
@@ -246,15 +246,21 @@ interface LoginCredentials {
 interface RegisterData {
   email: string;
   password: string;
-  accountName?: string;
-  accountSlug?: string;
+  account_name?: string;
+  account_slug?: string;
 }
 interface AuthResponse {
-  user: User;
-  account: Account;
+  user?: User;
+  account?: Account;
   token?: string;
+  refresh_token?: string;
   refreshToken?: string;
+  expires_in?: number;
   expiresAt?: string;
+  user_id?: string;
+  account_id?: string;
+  email?: string;
+  role?: string;
 }
 interface PasswordResetRequest {
   account?: string;
@@ -312,8 +318,8 @@ declare class AuthManager {
   constructor(options: AuthManagerOptions);
   initialize(): Promise<void>;
   getState(): AuthState;
-  get user(): User$1 | null;
-  get account(): Account$1 | null;
+  get user(): User | null;
+  get account(): Account | null;
   get token(): string | null;
   get refreshToken(): string | null;
   get isAuthenticated(): boolean;
@@ -442,15 +448,15 @@ declare class AccountService {
   /**
    * Get details for a specific account.
    */
-  get(accountId: string): Promise<Account$1>;
+  get(accountId: string): Promise<Account>;
   /**
    * Create a new account.
    */
-  create(data: AccountCreate): Promise<Account$1>;
+  create(data: AccountCreate): Promise<Account>;
   /**
    * Update an existing account.
    */
-  update(accountId: string, data: AccountUpdate): Promise<Account$1>;
+  update(accountId: string, data: AccountUpdate): Promise<Account>;
   /**
    * Delete an account and all its associated data.
    */
@@ -478,15 +484,15 @@ declare class UserService {
   /**
    * Get details for a specific user.
    */
-  get(userId: string): Promise<User$1>;
+  get(userId: string): Promise<User>;
   /**
    * Create a new user in a specific account.
    */
-  create(data: UserCreate): Promise<User$1>;
+  create(data: UserCreate): Promise<User>;
   /**
    * Update an existing user.
    */
-  update(userId: string, data: UserUpdate): Promise<User$1>;
+  update(userId: string, data: UserUpdate): Promise<User>;
   /**
    * Soft delete (deactivate) a user.
    */
@@ -536,10 +542,107 @@ interface Collection {
 interface CollectionCreate {
   name: string;
   fields: FieldDefinition[];
+  list_rule?: string | null;
+  view_rule?: string | null;
+  create_rule?: string | null;
+  update_rule?: string | null;
+  delete_rule?: string | null;
 }
 interface CollectionUpdate {
   name?: string;
   fields?: FieldDefinition[];
+  list_rule?: string | null;
+  view_rule?: string | null;
+  create_rule?: string | null;
+  update_rule?: string | null;
+  delete_rule?: string | null;
+}
+/**
+ * Comprehensive field definition for export including all metadata
+ */
+interface CollectionExportFieldDefinition {
+  name: string;
+  type: FieldType;
+  required?: boolean;
+  default?: any;
+  unique?: boolean;
+  options?: Record<string, any> | null;
+  collection?: string | null;
+  on_delete?: string | null;
+  pii?: boolean;
+  mask_type?: string | null;
+}
+/**
+ * Access control rules structure for Permission System V2
+ * Rule values:
+ *  - null = locked (access denied)
+ *  - "" (empty string) = public (all users can access)
+ *  - Expression string = conditional access (RLS rule)
+ */
+interface CollectionExportRules {
+  list_rule: string | null;
+  view_rule: string | null;
+  create_rule: string | null;
+  update_rule: string | null;
+  delete_rule: string | null;
+  list_fields: string;
+  view_fields: string;
+  create_fields: string;
+  update_fields: string;
+}
+/**
+ * Single collection in export bundle
+ */
+interface CollectionExportItem {
+  name: string;
+  schema: CollectionExportFieldDefinition[];
+  rules: CollectionExportRules;
+}
+/**
+ * Complete export file structure
+ */
+interface CollectionExportData {
+  version: string;
+  exported_at: string;
+  exported_by: string;
+  collections: CollectionExportItem[];
+}
+/**
+ * Import conflict handling strategies
+ */
+type ImportStrategy = 'error' | 'skip' | 'update';
+/**
+ * Import request payload
+ */
+interface CollectionImportRequest {
+  data: CollectionExportData;
+  strategy?: ImportStrategy;
+}
+/**
+ * Import result for a single collection
+ */
+interface CollectionImportItemResult {
+  name: string;
+  status: 'imported' | 'skipped' | 'updated' | 'error';
+  message: string;
+}
+/**
+ * Complete import operation result
+ */
+interface CollectionImportResult {
+  success: boolean;
+  imported_count: number;
+  skipped_count: number;
+  updated_count: number;
+  failed_count: number;
+  collections: CollectionImportItemResult[];
+  migrations_created: string[];
+}
+/**
+ * Export query parameters
+ */
+interface CollectionExportParams {
+  collection_ids?: string[];
 }
 //#endregion
 //#region src/core/collection-service.d.ts
@@ -577,6 +680,56 @@ declare class CollectionService {
   delete(collectionId: string): Promise<{
     success: boolean;
   }>;
+  /**
+   * Export collections to JSON format.
+   * Returns collection schemas and rules for backup or migration.
+   *
+   * @param params Optional filter by collection IDs
+   * @returns Complete export data structure with collections, schemas, and rules
+   * @throws {AuthorizationError} If user is not a superadmin
+   *
+   * @example
+   * // Export all collections
+   * const exportData = await client.collections.export();
+   *
+   * @example
+   * // Export specific collections
+   * const exportData = await client.collections.export({
+   *   collection_ids: ['col-123', 'col-456']
+   * });
+   */
+  export(params?: CollectionExportParams): Promise<CollectionExportData>;
+  /**
+   * Import collections from JSON export.
+   *
+   * @param request Import request with data and conflict strategy
+   * @returns Import result with per-collection status and migration IDs
+   * @throws {ValidationError} If import data is invalid
+   * @throws {ConflictError} If collection exists and strategy is 'error'
+   * @throws {AuthorizationError} If user is not a superadmin
+   *
+   * @example
+   * // Import with error strategy (fail on conflicts)
+   * const result = await client.collections.import({
+   *   data: exportData,
+   *   strategy: 'error'
+   * });
+   *
+   * @example
+   * // Import with skip strategy (skip existing collections)
+   * const result = await client.collections.import({
+   *   data: exportData,
+   *   strategy: 'skip'
+   * });
+   *
+   * @example
+   * // Import with update strategy (update existing collections)
+   * const result = await client.collections.import({
+   *   data: exportData,
+   *   strategy: 'update'
+   * });
+   */
+  import(request: CollectionImportRequest): Promise<CollectionImportResult>;
 }
 //#endregion
 //#region src/types/record.d.ts
@@ -1029,7 +1182,7 @@ interface AuditLogFilters {
   limit?: number;
   sort?: string;
 }
-type AuditLogExportFormat = 'csv' | 'json';
+type AuditLogExportFormat = 'csv' | 'json' | 'pdf';
 interface AuditLogListResponse {
   items: AuditLog[];
   total: number;
@@ -1051,7 +1204,25 @@ declare class AuditLogService {
    */
   get(logId: string): Promise<AuditLog>;
   /**
-   * Exports audit logs in the specified format.
+   * Exports audit logs in the specified format (JSON, CSV, or PDF).
+   *
+   * @param params Optional filters (account_id, table_name, operation, date range, etc.)
+   * @param format Export format: 'json', 'csv', or 'pdf' (default: 'json')
+   * @returns Exported data as string (base64-encoded for PDF format)
+   * @throws {AuthorizationError} If user is not a superadmin
+   *
+   * @example
+   * // Export as JSON
+   * const jsonData = await client.auditLogs.export({ table_name: 'users' }, 'json');
+   *
+   * @example
+   * // Export as CSV
+   * const csvData = await client.auditLogs.export({ table_name: 'users' }, 'csv');
+   *
+   * @example
+   * // Export as PDF
+   * const pdfBase64 = await client.auditLogs.export({ table_name: 'users' }, 'pdf');
+   * // pdfBase64 is a base64-encoded PDF string
    */
   export(params?: AuditLogFilters, format?: AuditLogExportFormat): Promise<string>;
 }
@@ -1263,7 +1434,7 @@ interface DashboardStats {
   /** Number of new users registered in the last 7 days */
   new_users_7d: number;
   /** List of the most recent user registrations */
-  recent_registrations: User$1[];
+  recent_registrations: User[];
   /** Overview of current system health and status */
   system_health: SystemHealth;
   /** Number of currently active user sessions */
@@ -1903,11 +2074,11 @@ declare class SnackBaseClient {
   /**
    * Returns the current authenticated user.
    */
-  get user(): User$1 | null;
+  get user(): User | null;
   /**
    * Returns the current account.
    */
-  get account(): Account$1 | null;
+  get account(): Account | null;
   /**
    * Returns whether the client is currently authenticated.
    */
@@ -2115,4 +2286,4 @@ type InferSchema<T extends readonly FieldDefinition[]> = { [K in T[number] as K[
  */
 declare function getAutoDetectedStorage(): StorageBackend;
 //#endregion
-export { AuditLogFilters as $, EmailTemplateRenderResponse as A, OAuthCallbackParams as At, SystemHealth as B, SAMLUrlResponse as Bt, FileUploadOptions as C, FieldDefinition as Ct, EmailTemplate as D, AuthResponse as Dt, EmailLogListResponse as E, AuthEvents as Et, ConfigurationStats as F, PasswordResetRequest as Ft, RoleCreate as G, UserUpdate as Gt, CollectionRuleUpdate as H, UserCreate as Ht, ConnectionTestResult as I, RegisterData as It, RuleTestResult as J, LogLevel$1 as Jt, RoleListResponse as K, Account$1 as Kt, ProviderDefinition as L, SAMLCallbackParams as Lt, EmailTemplateUpdate as M, OAuthResponse as Mt, Configuration as N, OAuthUrlResponse as Nt, EmailTemplateFilters as O, AuthState as Ot, ConfigurationCreate as P, PasswordResetConfirm as Pt, AuditLogExportFormat as Q, RecentConfiguration as R, SAMLProvider as Rt, FileMetadata as S, CollectionUpdate as St, EmailLogFilters as T, AuthEvent as Tt, Permission as U, UserListParams as Ut, CollectionRule as V, User$1 as Vt, Role as W, UserListResponse as Wt, RuleValidationResult as X, StorageBackend as Xt, RuleValidationParams as Y, SnackBaseConfig as Yt, AuditLog as Z, RealTimeState as _, BaseRecord as _t, InferSchema as a, InvitationListParams as at, WebSocketAction as b, Collection as bt, CurrentRevisionResponse as c, GroupListParams as ct, MigrationListResponse as d, QueryBuilder as dt, AuditLogListResponse as et, MigrationRevision as f, FilterExpression as ft, RealTimeEvents as g, SortExpression as gt, RealTimeEventHandler as h, SortDirection as ht, Filter as i, InvitationCreate as it, EmailTemplateType as j, OAuthProvider as jt, EmailTemplateRenderRequest as k, LoginCredentials as kt, MigrationHistoryItem as l, GroupListResponse as lt, RealTimeEvent as m, QueryParams as mt, CollectionRecord as n, ApiKeyCreate as nt, ListResponse as o, Group as ot, RealTimeConfig as p, FilterOperator as pt, RoleUpdate as q, DEFAULT_CONFIG as qt, FieldTypeToTs as r, Invitation as rt, SnackBaseClient as s, GroupCreate as st, getAutoDetectedStorage as t, ApiKey as tt, MigrationHistoryResponse as u, GroupUpdate as ut, RealtimeEvent as v, RecordListParams as vt, EmailLog as w, FieldType as wt, WebSocketMessage as x, CollectionCreate as xt, ServerMessage as y, RecordListResponse as yt, DashboardStats as z, SAMLResponse as zt };
+export { type Account, ApiKey, ApiKeyCreate, AuditLog, AuditLogExportFormat, AuditLogFilters, AuditLogListResponse, AuthEvent, AuthEvents, AuthResponse, AuthState, BaseRecord, Collection, CollectionCreate, CollectionExportData, CollectionExportFieldDefinition, CollectionExportItem, CollectionExportParams, CollectionExportRules, CollectionImportItemResult, CollectionImportRequest, CollectionImportResult, CollectionRecord, CollectionRule, CollectionRuleUpdate, CollectionUpdate, Configuration, ConfigurationCreate, ConfigurationStats, ConnectionTestResult, CurrentRevisionResponse, DEFAULT_CONFIG, DashboardStats, EmailLog, EmailLogFilters, EmailLogListResponse, EmailTemplate, EmailTemplateFilters, EmailTemplateRenderRequest, EmailTemplateRenderResponse, EmailTemplateType, EmailTemplateUpdate, FieldDefinition, FieldType, FieldTypeToTs, FileMetadata, FileUploadOptions, Filter, FilterExpression, FilterOperator, Group, GroupCreate, GroupListParams, GroupListResponse, GroupUpdate, ImportStrategy, InferSchema, Invitation, InvitationCreate, InvitationListParams, ListResponse, LogLevel, LoginCredentials, MigrationHistoryItem, MigrationHistoryResponse, MigrationListResponse, MigrationRevision, OAuthCallbackParams, OAuthProvider, OAuthResponse, OAuthUrlResponse, PasswordResetConfirm, PasswordResetRequest, Permission, ProviderDefinition, QueryBuilder, QueryParams, RealTimeConfig, RealTimeEvent, RealTimeEventHandler, RealTimeEvents, RealTimeState, RealtimeEvent, RecentConfiguration, RecordListParams, RecordListResponse, RegisterData, Role, RoleCreate, RoleListResponse, RoleUpdate, RuleTestResult, RuleValidationParams, RuleValidationResult, SAMLCallbackParams, SAMLProvider, SAMLResponse, SAMLUrlResponse, ServerMessage, type SnackBaseClient as SnackBase, SnackBaseClient, SnackBaseConfig, SortDirection, SortExpression, StorageBackend, SystemHealth, type User, UserCreate, UserListParams, type UserListResponse, UserUpdate, WebSocketAction, WebSocketMessage, getAutoDetectedStorage };