@baasix/sdk 0.1.18 → 0.1.20

package/dist/index.d.cts

@@ -3,7 +3,7 @@ export { a as HttpClientConfig, R as RequestOptions } from './client-BHbM3KOy.cj
 import { S as StorageAdapter } from './types-BdjsGANq.cjs';
 export { a as STORAGE_KEYS, b as StorageKey } from './types-BdjsGANq.cjs';
 import { AuthModule } from './modules/auth.cjs';
-export { InviteOptions, OAuthOptions, OAuthProvider, VerifyInviteResult } from './modules/auth.cjs';
+export { AuthMethods, InviteOptions, LoginResult, OAuthOptions, OAuthProvider, SOCIAL_PROVIDERS, TwoFactorChallengeResponse, TwoFactorEnableResult, VerifyInviteResult } from './modules/auth.cjs';
 import { ItemsModule } from './modules/items.cjs';
 export { ImportResult, QueryBuilder } from './modules/items.cjs';
 import { FilesModule } from './modules/files.cjs';
@@ -146,6 +146,7 @@ declare class NotificationsModule {
         limit?: number;
         page?: number;
         filter?: Record<string, unknown>;
+        sort?: string[] | Record<string, "asc" | "desc">;
     }): Promise<PaginatedResponse<Notification>>;
     /**
      * Get unread notification count
@@ -171,6 +172,33 @@ declare class NotificationsModule {
     markAsSeen(notificationIds?: string[]): Promise<{
         count: number;
     }>;
+    /**
+     * Mark notifications as unseen (unread)
+     *
+     * @example
+     * ```typescript
+     * // Mark specific notifications as unseen
+     * await baasix.notifications.markAsUnseen(['id1', 'id2']);
+     *
+     * // Mark all notifications as unseen
+     * await baasix.notifications.markAsUnseen();
+     * ```
+     */
+    markAsUnseen(notificationIds?: string[]): Promise<{
+        count: number;
+    }>;
+    /**
+     * Get the per-type notification link templates configured in settings
+     * (`metadata.notificationLinks`). Templates may contain `{{field}}`
+     * placeholders resolved from the notification (including `data.*` paths).
+     *
+     * @example
+     * ```typescript
+     * const links = await baasix.notifications.getLinks();
+     * // { task_assigned: '/pages/?slug=tasks&id={{data.taskId}}' }
+     * ```
+     */
+    getLinks(): Promise<Record<string, string>>;
     /**
      * Delete notifications for the current user
      *
@@ -459,7 +487,9 @@ declare class SettingsModule {
      * });
      * ```
      */
-    update(settings: Partial<Settings>): Promise<Settings>;
+    update(settings: Partial<Settings>, options?: {
+        tenantId?: string | number;
+    }): Promise<Settings>;
     /**
      * Set a specific setting
      *
@@ -2066,14 +2096,19 @@ declare class ServerModule {
     /**
      * Get server information including project settings
      *
+     * @param tenantId - Optional tenant ID to fetch tenant-merged project settings
+     *
      * @example
      * ```typescript
      * const info = await baasix.server.info();
      * console.log('Project:', info.project?.name);
      * console.log('Version:', info.version);
+     *
+     * // Tenant-aware: settings merged for the given tenant
+     * const tenantInfo = await baasix.server.info("tenant-uuid");
      * ```
      */
-    info(): Promise<ServerInfo>;
+    info(tenantId?: string): Promise<ServerInfo>;
     /**
      * Check server health
      *

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export { a as HttpClientConfig, R as RequestOptions } from './client-D67LK80v.js
 import { S as StorageAdapter } from './types-BdjsGANq.js';
 export { a as STORAGE_KEYS, b as StorageKey } from './types-BdjsGANq.js';
 import { AuthModule } from './modules/auth.js';
-export { InviteOptions, OAuthOptions, OAuthProvider, VerifyInviteResult } from './modules/auth.js';
+export { AuthMethods, InviteOptions, LoginResult, OAuthOptions, OAuthProvider, SOCIAL_PROVIDERS, TwoFactorChallengeResponse, TwoFactorEnableResult, VerifyInviteResult } from './modules/auth.js';
 import { ItemsModule } from './modules/items.js';
 export { ImportResult, QueryBuilder } from './modules/items.js';
 import { FilesModule } from './modules/files.js';
@@ -146,6 +146,7 @@ declare class NotificationsModule {
         limit?: number;
         page?: number;
         filter?: Record<string, unknown>;
+        sort?: string[] | Record<string, "asc" | "desc">;
     }): Promise<PaginatedResponse<Notification>>;
     /**
      * Get unread notification count
@@ -171,6 +172,33 @@ declare class NotificationsModule {
     markAsSeen(notificationIds?: string[]): Promise<{
         count: number;
     }>;
+    /**
+     * Mark notifications as unseen (unread)
+     *
+     * @example
+     * ```typescript
+     * // Mark specific notifications as unseen
+     * await baasix.notifications.markAsUnseen(['id1', 'id2']);
+     *
+     * // Mark all notifications as unseen
+     * await baasix.notifications.markAsUnseen();
+     * ```
+     */
+    markAsUnseen(notificationIds?: string[]): Promise<{
+        count: number;
+    }>;
+    /**
+     * Get the per-type notification link templates configured in settings
+     * (`metadata.notificationLinks`). Templates may contain `{{field}}`
+     * placeholders resolved from the notification (including `data.*` paths).
+     *
+     * @example
+     * ```typescript
+     * const links = await baasix.notifications.getLinks();
+     * // { task_assigned: '/pages/?slug=tasks&id={{data.taskId}}' }
+     * ```
+     */
+    getLinks(): Promise<Record<string, string>>;
     /**
      * Delete notifications for the current user
      *
@@ -459,7 +487,9 @@ declare class SettingsModule {
      * });
      * ```
      */
-    update(settings: Partial<Settings>): Promise<Settings>;
+    update(settings: Partial<Settings>, options?: {
+        tenantId?: string | number;
+    }): Promise<Settings>;
     /**
      * Set a specific setting
      *
@@ -2066,14 +2096,19 @@ declare class ServerModule {
     /**
      * Get server information including project settings
      *
+     * @param tenantId - Optional tenant ID to fetch tenant-merged project settings
+     *
      * @example
      * ```typescript
      * const info = await baasix.server.info();
      * console.log('Project:', info.project?.name);
      * console.log('Version:', info.version);
+     *
+     * // Tenant-aware: settings merged for the given tenant
+     * const tenantInfo = await baasix.server.info("tenant-uuid");
      * ```
      */
-    info(): Promise<ServerInfo>;
+    info(tenantId?: string): Promise<ServerInfo>;
     /**
      * Check server health
      *

package/dist/index.js

@@ -190,7 +190,7 @@ var HttpClient = class {
     } catch {
     }
     const message = errorData.error?.message || errorData.message || response.statusText || "Request failed";
-    const code = errorData.error?.code;
+    const code = errorData.error?.code ?? errorData.code;
     const details = errorData.details;
     return new BaasixError(message, response.status, code, details);
   }
@@ -474,17 +474,123 @@ var MemoryStorageAdapter = class {
 };
 
 // src/modules/auth.ts
+var SOCIAL_PROVIDERS = ["apple", "atlassian", "cognito", "discord", "dropbox", "facebook", "figma", "github", "gitlab", "google", "huggingface", "kakao", "kick", "line", "linear", "linkedin", "microsoft", "naver", "notion", "paybin", "paypal", "polar", "railway", "reddit", "roblox", "salesforce", "slack", "spotify", "tiktok", "twitch", "twitter", "vercel", "vk", "wechat", "zoom"];
 var AuthModule = class {
   client;
   storage;
   authMode;
   onAuthStateChange;
   currentUser = null;
+  authMethodsCache = null;
+  /**
+   * Two-factor authentication (TOTP) helpers.
+   *
+   * @example
+   * ```typescript
+   * const result = await baasix.auth.login({ email, password });
+   * if ("twoFactorRequired" in result && result.twoFactorRequired) {
+   *   const { user, token } = await baasix.auth.twoFactor.verify(result.twoFactorToken, code);
+   * }
+   * ```
+   */
+  twoFactor;
+  /**
+   * Passkey (WebAuthn) registration and authentication helpers.
+   * Browser-only: throws a `BaasixError` when called outside a browser
+   * environment (no `window`/`PublicKeyCredential`).
+   *
+   * @example
+   * ```typescript
+   * // Register a passkey for the currently logged-in user
+   * await baasix.auth.passkey.register("My Laptop");
+   *
+   * // Authenticate with a passkey (no prior login required)
+   * const { user, token } = await baasix.auth.passkey.authenticate();
+   *
+   * // List and remove registered passkeys
+   * const passkeys = await baasix.auth.passkey.list();
+   * await baasix.auth.passkey.remove(passkeys[0].id);
+   * ```
+   */
+  passkey = {
+    register: async (name) => {
+      this.assertBrowser();
+      const { startRegistration } = await import('@simplewebauthn/browser');
+      const options = await this.client.post("/auth/passkey/register/options", {});
+      const attestation = await startRegistration({ optionsJSON: options });
+      await this.client.post("/auth/passkey/register/verify", {
+        response: attestation,
+        name: name || null
+      });
+      return { verified: true };
+    },
+    authenticate: async (opts) => {
+      this.assertBrowser();
+      const { startAuthentication } = await import('@simplewebauthn/browser');
+      const { options, challengeId } = await this.client.post(
+        "/auth/passkey/authenticate/options",
+        {},
+        { skipAuth: true }
+      );
+      const assertion = await startAuthentication({ optionsJSON: options });
+      const response = await this.client.post(
+        "/auth/passkey/authenticate/verify",
+        { challengeId, response: assertion, authMode: opts?.authMode },
+        { skipAuth: true }
+      );
+      await this.storeTokens(response);
+      this.emitAuthStateChange("SIGNED_IN", response.user);
+      return response;
+    },
+    list: async () => (await this.client.get("/auth/passkey")).passkeys,
+    remove: async (id) => {
+      await this.client.delete(`/auth/passkey/${encodeURIComponent(id)}`);
+    }
+  };
   constructor(config) {
     this.client = config.client;
     this.storage = config.storage;
     this.authMode = config.authMode;
     this.onAuthStateChange = config.onAuthStateChange;
+    this.twoFactor = {
+      verify: async (twoFactorToken, code, opts) => {
+        const response = await this.client.post(
+          "/auth/2fa/verify",
+          {
+            twoFactorToken,
+            code,
+            authMode: opts?.authMode,
+            authType: opts?.authType
+          },
+          { skipAuth: true }
+        );
+        await this.storeTokens(response);
+        this.emitAuthStateChange("SIGNED_IN", response.user);
+        return response;
+      },
+      enable: () => {
+        return this.client.post("/auth/2fa/enable");
+      },
+      verifySetup: (code) => {
+        return this.client.post("/auth/2fa/verify-setup", {
+          code
+        });
+      },
+      disable: (password) => {
+        return this.client.post("/auth/2fa/disable", {
+          password
+        });
+      }
+    };
+  }
+  /**
+   * Assert that we're running in a browser environment with WebAuthn support.
+   * Throws a `BaasixError` otherwise.
+   */
+  assertBrowser() {
+    if (typeof window === "undefined" || !window.PublicKeyCredential) {
+      throw new BaasixError("Passkeys are only available in a browser", 400);
+    }
   }
   /**
    * Emit an authentication state change event
@@ -581,9 +687,39 @@ var AuthModule = class {
       },
       { skipAuth: true }
     );
-    await this.storeTokens(response);
-    this.emitAuthStateChange("SIGNED_IN", response.user);
-    return response;
+    if ("twoFactorRequired" in response && response.twoFactorRequired) {
+      return response;
+    }
+    const authResponse = response;
+    await this.storeTokens(authResponse);
+    this.emitAuthStateChange("SIGNED_IN", authResponse.user);
+    return authResponse;
+  }
+  /**
+   * Discover which authentication methods are enabled for this project
+   * (registration, email/password, magic link, passkey, 2FA, and the list
+   * of configured social/OAuth providers). Result is cached per instance;
+   * pass `force: true` to bypass the cache and refetch.
+   *
+   * @example
+   * ```typescript
+   * const methods = await baasix.auth.getAuthMethods();
+   * if (methods.socialProviders.includes("google")) {
+   *   // show "Sign in with Google"
+   * }
+   * ```
+   */
+  async getAuthMethods(force = false) {
+    if (this.authMethodsCache && !force) {
+      return this.authMethodsCache;
+    }
+    const response = await this.client.get(
+      "/",
+      { skipAuth: true }
+    );
+    const authMethods = response?.project?.auth;
+    this.authMethodsCache = authMethods;
+    return authMethods;
   }
   /**
    * Logout the current user
@@ -2404,6 +2540,42 @@ var NotificationsModule = class {
     );
     return { count: response.count };
   }
+  /**
+   * Mark notifications as unseen (unread)
+   *
+   * @example
+   * ```typescript
+   * // Mark specific notifications as unseen
+   * await baasix.notifications.markAsUnseen(['id1', 'id2']);
+   *
+   * // Mark all notifications as unseen
+   * await baasix.notifications.markAsUnseen();
+   * ```
+   */
+  async markAsUnseen(notificationIds) {
+    const response = await this.client.post(
+      "/notifications/mark-unseen",
+      { notificationIds }
+    );
+    return { count: response.count };
+  }
+  /**
+   * Get the per-type notification link templates configured in settings
+   * (`metadata.notificationLinks`). Templates may contain `{{field}}`
+   * placeholders resolved from the notification (including `data.*` paths).
+   *
+   * @example
+   * ```typescript
+   * const links = await baasix.notifications.getLinks();
+   * // { task_assigned: '/pages/?slug=tasks&id={{data.taskId}}' }
+   * ```
+   */
+  async getLinks() {
+    const response = await this.client.get(
+      "/notifications/links"
+    );
+    return response.data ?? {};
+  }
   /**
    * Delete notifications for the current user
    *
@@ -2710,10 +2882,11 @@ var SettingsModule = class {
    * });
    * ```
    */
-  async update(settings) {
+  async update(settings, options) {
     const response = await this.client.patch(
       "/settings",
-      settings
+      settings,
+      options?.tenantId !== void 0 && options?.tenantId !== null ? { params: { tenant_id: options.tenantId } } : void 0
     );
     return response.data;
   }
@@ -4719,15 +4892,23 @@ var ServerModule = class {
   /**
    * Get server information including project settings
    *
+   * @param tenantId - Optional tenant ID to fetch tenant-merged project settings
+   *
    * @example
    * ```typescript
    * const info = await baasix.server.info();
    * console.log('Project:', info.project?.name);
    * console.log('Version:', info.version);
+   *
+   * // Tenant-aware: settings merged for the given tenant
+   * const tenantInfo = await baasix.server.info("tenant-uuid");
    * ```
    */
-  async info() {
-    return this.client.get("/");
+  async info(tenantId) {
+    return this.client.get(
+      "/",
+      tenantId ? { params: { tenant_id: tenantId } } : void 0
+    );
   }
   /**
    * Check server health
@@ -5041,6 +5222,6 @@ function createBaasix(config) {
   return new Baasix(config);
 }
 
-export { AsyncStorageAdapter, AuthModule, Baasix, BaasixError, FilesModule, HttpClient, ItemsModule, LocalStorageAdapter, MemoryStorageAdapter, MigrationsModule, NotificationsModule, PermissionsModule, QueryBuilder, RealtimeChannel, RealtimeModule, ReportsModule, RolesModule, STORAGE_KEYS, SchemasModule, SettingsModule, UsersModule, WorkflowsModule, createBaasix };
+export { AsyncStorageAdapter, AuthModule, Baasix, BaasixError, FilesModule, HttpClient, ItemsModule, LocalStorageAdapter, MemoryStorageAdapter, MigrationsModule, NotificationsModule, PermissionsModule, QueryBuilder, RealtimeChannel, RealtimeModule, ReportsModule, RolesModule, SOCIAL_PROVIDERS, STORAGE_KEYS, SchemasModule, SettingsModule, UsersModule, WorkflowsModule, createBaasix };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map