@base44-preview/sdk 0.8.31-pr.195.c0f5839 → 0.8.32-pr.196.8c75df2

package/README.md

@@ -29,7 +29,6 @@ The SDK provides access to Base44's functionality through the following modules:
 - **[`entities`](https://docs.base44.com/developers/references/sdk/docs/interfaces/entities)**: Work with your app's data entities using CRUD operations.
 - **[`functions`](https://docs.base44.com/developers/references/sdk/docs/interfaces/functions)**: Execute backend functions.
 - **[`integrations`](https://docs.base44.com/developers/references/sdk/docs/type-aliases/integrations)**: Access pre-built and third-party integrations.
-- **`mobile`**: Send AppUser mobile push notifications from service-role backend code.
 
 ## Quickstarts
 
@@ -97,8 +96,6 @@ Deno.serve(async (req) => {
 });
 ```
 
-Service-role-only modules such as `base44.asServiceRole.mobile` are available only in backend functions. Use `base44.asServiceRole.mobile.sendNotification(...)` to send AppUser push notifications from backend code after validating that the caller is allowed to trigger the notification. Do not expose mobile push sending from frontend/client-side code.
-
 ## Learn more
 
 The best way to get started with the JavaScript SDK is to have Base44 build an app for you. Once you have an app, you can explore the generated code and experiment with the SDK to see how it works in practice. You can also ask Base44 to demonstrate specific features of the SDK.

package/dist/client.js

@@ -10,7 +10,6 @@ import { createAgentsModule } from "./modules/agents.js";
 import { createAppLogsModule } from "./modules/app-logs.js";
 import { createUsersModule } from "./modules/users.js";
 import { RoomsSocket } from "./utils/socket-utils.js";
-import { createMobileModule } from "./modules/mobile.js";
 import { createAnalyticsModule } from "./modules/analytics.js";
 /**
  * Creates a Base44 client.
@@ -194,7 +193,6 @@ export function createClient(config) {
             token,
         }),
         appLogs: createAppLogsModule(serviceRoleAxiosClient, appId),
-        mobile: createMobileModule(serviceRoleAxiosClient, appId),
         cleanup: () => {
             if (socket) {
                 socket.disconnect();

package/dist/client.types.d.ts

@@ -7,7 +7,6 @@ import type { FunctionsModule } from "./modules/functions.types.js";
 import type { AgentsModule } from "./modules/agents.types.js";
 import type { AppLogsModule } from "./modules/app-logs.types.js";
 import type { AnalyticsModule } from "./modules/analytics.types.js";
-import type { MobileModule } from "./modules/mobile.types.js";
 /**
  * Options for creating a Base44 client.
  */
@@ -135,8 +134,6 @@ export interface Base44Client {
         functions: FunctionsModule;
         /** {@link IntegrationsModule | Integrations module} with elevated permissions. */
         integrations: IntegrationsModule;
-        /** {@link MobileModule | Mobile module} for service-role mobile operations. */
-        mobile: MobileModule;
         /** {@link SsoModule | SSO module} for generating SSO tokens.
          * @internal
          */

package/dist/index.d.ts

@@ -13,5 +13,4 @@ export type { AppLogsModule } from "./modules/app-logs.types.js";
 export type { SsoModule, SsoAccessTokenResponse } from "./modules/sso.types.js";
 export type { ConnectorsModule, UserConnectorsModule, } from "./modules/connectors.types.js";
 export type { CustomIntegrationsModule, CustomIntegrationCallParams, CustomIntegrationCallResponse, } from "./modules/custom-integrations.types.js";
-export type { MobileModule, SendNotificationParams, SendNotificationResult, } from "./modules/mobile.types.js";
 export type { GetAccessTokenOptions, SaveAccessTokenOptions, RemoveAccessTokenOptions, GetLoginUrlOptions, } from "./utils/auth-utils.types.js";

package/dist/modules/auth.types.d.ts

@@ -338,8 +338,10 @@ export interface AuthModule {
     /**
      * Registers a new user account.
      *
-     * Creates a new user account with email and password. After successful registration,
-     * use {@linkcode loginViaEmailPassword | loginViaEmailPassword()} to log in the user.
+     * Creates a new user account with email and password. Registration sends an OTP
+     * code to the user's email. Pass that code to
+     * {@linkcode verifyOtp | verifyOtp()} to complete verification, then log the user
+     * in with {@linkcode loginViaEmailPassword | loginViaEmailPassword()}.
      *
      * @param params - Registration details including email, password, and optional fields.
      * @returns Promise resolving to the registration response.
@@ -353,7 +355,13 @@ export interface AuthModule {
      *   referral_code: 'FRIEND2024'
      * });
      *
-     * // Login after registration
+     * // Verify with the OTP code from the user's email
+     * await base44.auth.verifyOtp({
+     *   email: 'newuser@example.com',
+     *   otpCode: '123456'
+     * });
+     *
+     * // Log the user in after verification
      * const { access_token, user } = await base44.auth.loginViaEmailPassword(
      *   'newuser@example.com',
      *   'securePassword123'
@@ -362,17 +370,23 @@ export interface AuthModule {
      */
     register(params: RegisterParams): Promise<any>;
     /**
-     * Verifies an OTP (One-time password) code.
+     * Verifies an OTP (one-time password) code.
      *
-     * Validates an OTP code sent to the user's email during registration
-     * or authentication.
+     * Confirms that the user owns the email address by checking the code sent to
+     * their inbox during {@linkcode register | register()}. After a successful
+     * call, log the user in with
+     * {@linkcode loginViaEmailPassword | loginViaEmailPassword()}. If the code
+     * has expired or the user didn't receive it, send a fresh one with
+     * {@linkcode resendOtp | resendOtp()}.
      *
-     * @param params - Object containing email and OTP code.
-     * @returns Promise resolving to the verification response if valid.
-     * @throws Error if the OTP code is invalid, expired, or verification fails.
+     * @param params - The email being verified and the OTP code the user entered.
+     * @returns Promise resolving to the verification response, which includes an
+     * access token for the now-verified user.
+     * @throws Error if the OTP code is invalid or expired.
      *
      * @example
      * ```typescript
+     * // Verify the code the user entered from their email
      * try {
      *   await base44.auth.verifyOtp({
      *     email: 'user@example.com',
@@ -383,19 +397,45 @@ export interface AuthModule {
      *   console.error('Invalid or expired OTP code');
      * }
      * ```
+     *
+     * @example
+     * ```typescript
+     * // Full registration flow
+     * await base44.auth.register({
+     *   email: 'newuser@example.com',
+     *   password: 'securePassword123'
+     * });
+     *
+     * // The user receives an OTP code by email. Collect it and verify.
+     * await base44.auth.verifyOtp({
+     *   email: 'newuser@example.com',
+     *   otpCode: '123456'
+     * });
+     *
+     * // Log the user in after verification
+     * const { access_token, user } = await base44.auth.loginViaEmailPassword(
+     *   'newuser@example.com',
+     *   'securePassword123'
+     * );
+     * ```
      */
     verifyOtp(params: VerifyOtpParams): Promise<any>;
     /**
      * Resends an OTP code to the user's email address.
      *
-     * Requests a new OTP code to be sent to the specified email address.
+     * Call this when the user didn't receive the original code sent by
+     * {@linkcode register | register()}, or when the previous code has expired.
+     * The new code replaces the previous one. Pass it to
+     * {@linkcode verifyOtp | verifyOtp()} to complete verification.
      *
-     * @param email - Email address to send the OTP to.
-     * @returns Promise resolving when the OTP is sent successfully.
+     * @param email - Email address to send the new OTP to.
+     * @returns Promise resolving once the new OTP has been sent, with a
+     * confirmation message and the new code's expiration window.
      * @throws Error if the email is invalid or the request fails.
      *
      * @example
      * ```typescript
+     * // Resend the OTP when the user didn't receive the original
      * try {
      *   await base44.auth.resendOtp('user@example.com');
      *   console.log('OTP resent! Please check your email.');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.31-pr.195.c0f5839",
+  "version": "0.8.32-pr.196.8c75df2",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/dist/modules/mobile.d.ts

@@ -1,11 +0,0 @@
-import type { AxiosInstance } from "axios";
-import type { MobileModule } from "./mobile.types.js";
-/**
- * Creates the service-role mobile module.
- *
- * @param axios - Axios instance (should be service role client)
- * @param appId - Application ID
- * @returns Mobile module with push notification methods
- * @internal
- */
-export declare function createMobileModule(axios: AxiosInstance, appId: string): MobileModule;

package/dist/modules/mobile.js

@@ -1,47 +0,0 @@
-function validateRequiredString(value, fieldName, maxLength) {
-    if (typeof value !== "string" || value.trim().length === 0) {
-        throw new Error(`${fieldName} is required and must be a string`);
-    }
-    if (maxLength !== undefined && value.length > maxLength) {
-        throw new Error(`${fieldName} must be at most ${maxLength} characters`);
-    }
-}
-function validateOptionalString(value, fieldName, maxLength) {
-    if (value === undefined) {
-        return;
-    }
-    if (typeof value !== "string") {
-        throw new Error(`${fieldName} must be a string`);
-    }
-    if (maxLength !== undefined && value.length > maxLength) {
-        throw new Error(`${fieldName} must be at most ${maxLength} characters`);
-    }
-}
-/**
- * Creates the service-role mobile module.
- *
- * @param axios - Axios instance (should be service role client)
- * @param appId - Application ID
- * @returns Mobile module with push notification methods
- * @internal
- */
-export function createMobileModule(axios, appId) {
-    return {
-        async sendNotification(params) {
-            if (!params || typeof params !== "object") {
-                throw new Error("Notification params are required");
-            }
-            validateRequiredString(params.userId, "userId");
-            validateRequiredString(params.title, "title", 100);
-            validateRequiredString(params.content, "content", 500);
-            validateOptionalString(params.actionLabel, "actionLabel", 50);
-            validateOptionalString(params.actionUrl, "actionUrl");
-            if (params.metadata !== undefined &&
-                (typeof params.metadata !== "object" || Array.isArray(params.metadata))) {
-                throw new Error("metadata must be an object");
-            }
-            const response = await axios.post(`/apps/${appId}/mobile/notifications`, params);
-            return response;
-        },
-    };
-}

package/dist/modules/mobile.types.d.ts

@@ -1,45 +0,0 @@
-/**
- * Parameters for sending a mobile push notification to an app user.
- */
-export interface SendNotificationParams {
-    /** Target AppUser ID. */
-    userId: string;
-    /** Notification title. Maximum 100 characters. */
-    title: string;
-    /** Notification body. Maximum 500 characters. */
-    content: string;
-    /** Optional action label. Maximum 50 characters. */
-    actionLabel?: string;
-    /** Optional action URL opened by the notification action. */
-    actionUrl?: string;
-    /** Optional metadata delivered with the notification event. */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Result returned after attempting to send a mobile push notification.
- */
-export interface SendNotificationResult {
-    /** Channels that completed successfully. */
-    successfulChannels: string[];
-    /** Channel errors keyed by channel name. */
-    failedChannels: Record<string, string>;
-}
-/**
- * Service-role-only mobile module.
- *
- * This module is exposed only as `base44.asServiceRole.mobile` and is intended
- * for Base44-hosted backend functions or validated server-side webhooks. Normal
- * frontend clients do not expose `base44.mobile`.
- */
-export interface MobileModule {
-    /**
-     * Sends a push notification to an app user.
-     *
-     * This method is only available through `base44.asServiceRole.mobile`.
-     * Do not call it from generated frontend/client-side app code.
-     *
-     * @param params - Notification target and content.
-     * @returns The notification delivery result.
-     */
-    sendNotification(params: SendNotificationParams): Promise<SendNotificationResult>;
-}

package/dist/modules/mobile.types.js

@@ -1 +0,0 @@
-export {};