@base44-preview/sdk 0.8.17-pr.49.b78ce52 → 0.8.17-pr.73.e88f2f7

package/README.md

@@ -13,6 +13,7 @@ The SDK provides access to Base44's functionality through the following modules:
 - **[`entities`](https://docs.base44.com/sdk-docs/interfaces/entities)**: Work with your app's data entities using CRUD operations.
 - **[`functions`](https://docs.base44.com/sdk-docs/interfaces/functions)**: Execute backend functions.
 - **[`integrations`](https://docs.base44.com/sdk-docs/type-aliases/integrations)**: Pre-built server-side functions for external services.
+- **[`mobile`](#mobile-native-features)**: Send push notifications and access mobile native capabilities.
 
 ## Example
 
@@ -37,6 +38,135 @@ await base44.entities.Task.update(newTask.id, {
 const tasks = await base44.entities.Task.list();
 ```
 
+## Mobile Native Features
+
+The SDK provides mobile native capabilities through the `mobile` module, allowing you to send push notifications to your app users.
+
+### Push Notifications
+
+Send push notifications to users on mobile devices:
+
+```typescript
+import { base44 } from "@/api/base44Client";
+
+// Send a push notification to a user
+await base44.mobile.sendNotification({
+  userId: "user_123",
+  title: "New Message!",
+  content: "You have a new message from John",
+  actionLabel: "View Message",
+  actionUrl: "/messages/456",
+  channels: ["mobile_push"], // Mobile push only
+});
+
+// Send to both mobile push and in-app notifications (default)
+await base44.mobile.sendNotification({
+  userId: "user_456",
+  title: "Order Shipped",
+  content: "Your order #12345 has been shipped and is on its way!",
+  actionLabel: "Track Order",
+  actionUrl: "/orders/12345",
+});
+```
+
+### Notification Channels
+
+The `mobile` module supports two notification channels:
+
+- **`mobile_push`**: Sends a push notification to the user's mobile device (iOS/Android)
+- **`in_app`**: Sends an in-app notification visible in the web interface
+
+By default, notifications are sent to both channels. You can specify specific channels using the `channels` parameter:
+
+```typescript
+// Mobile push only - user will receive push notification on their phone
+await base44.mobile.sendNotification({
+  userId: "user_123",
+  title: "Time-sensitive alert",
+  content: "Your session will expire in 5 minutes",
+  channels: ["mobile_push"],
+});
+
+// In-app only - notification visible only in the web interface
+await base44.mobile.sendNotification({
+  userId: "user_789",
+  title: "System Update",
+  content: "We've updated the dashboard with new features",
+  channels: ["in_app"],
+});
+```
+
+### Common Use Cases
+
+**Order & Delivery Updates**:
+```typescript
+// Notify user when order is ready
+await base44.mobile.sendNotification({
+  userId: order.userId,
+  title: "Order Ready for Pickup",
+  content: `Your order #${order.id} is ready at ${store.name}`,
+  actionLabel: "View Order",
+  actionUrl: `/orders/${order.id}`,
+});
+```
+
+**Chat & Messaging**:
+```typescript
+// Notify user of new messages
+await base44.mobile.sendNotification({
+  userId: recipient.id,
+  title: `New message from ${sender.name}`,
+  content: message.preview,
+  actionLabel: "Reply",
+  actionUrl: `/chats/${conversation.id}`,
+  channels: ["mobile_push"], // Mobile only, avoid duplicate with in-app chat
+});
+```
+
+**Reminders & Events**:
+```typescript
+// Send event reminder
+await base44.mobile.sendNotification({
+  userId: attendee.userId,
+  title: "Event Starting Soon",
+  content: `${event.name} starts in 30 minutes`,
+  actionLabel: "View Details",
+  actionUrl: `/events/${event.id}`,
+});
+```
+
+### Error Handling
+
+The notification API handles errors gracefully:
+
+```typescript
+try {
+  const result = await base44.mobile.sendNotification({
+    userId: "user_123",
+    title: "Test Notification",
+    content: "This is a test",
+  });
+
+  if (result.success) {
+    console.log("Notification sent successfully");
+    console.log("Notification ID:", result.notificationId);
+  }
+} catch (error) {
+  if (error.status === 404) {
+    console.error("User not found");
+  } else if (error.status === 403) {
+    console.error("Not authorized to send notifications");
+  } else {
+    console.error("Failed to send notification:", error.message);
+  }
+}
+```
+
+**Graceful Degradation**:
+- If a user doesn't have mobile push enabled, the notification is still sent to other channels
+- If one channel fails, other channels still receive the notification
+- Notifications are queued and retried automatically for temporary failures
+
 ## Learn more
 
 For complete documentation, guides, and API reference, visit the **[Base44 SDK Documentation](https://docs.base44.com/sdk-getting-started/overview)**.

package/dist/client.js

@@ -9,6 +9,7 @@ import { createFunctionsModule } from "./modules/functions.js";
 import { createAgentsModule } from "./modules/agents.js";
 import { createAppLogsModule } from "./modules/app-logs.js";
 import { createUsersModule } from "./modules/users.js";
+import { createMobileModule } from "./modules/mobile.js";
 import { RoomsSocket } from "./utils/socket-utils.js";
 import { createAnalyticsModule } from "./modules/analytics.js";
 /**
@@ -121,6 +122,7 @@ export function createClient(config) {
         }),
         appLogs: createAppLogsModule(axiosClient, appId),
         users: createUsersModule(axiosClient, appId),
+        mobile: createMobileModule(axiosClient, appId),
         analytics: createAnalyticsModule({
             axiosClient,
             serverUrl,
@@ -152,6 +154,7 @@ export function createClient(config) {
             token,
         }),
         appLogs: createAppLogsModule(serviceRoleAxiosClient, appId),
+        mobile: createMobileModule(serviceRoleAxiosClient, appId),
         cleanup: () => {
             if (socket) {
                 socket.disconnect();

package/dist/client.types.d.ts

@@ -6,6 +6,7 @@ import type { ConnectorsModule } from "./modules/connectors.types.js";
 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 { MobileModule } from "./modules/mobile.types.js";
 import type { AnalyticsModule } from "./modules/analytics.types.js";
 /**
  * Options for creating a Base44 client.
@@ -83,6 +84,8 @@ export interface Base44Client {
     agents: AgentsModule;
     /** {@link AppLogsModule | App logs module} for tracking app usage. */
     appLogs: AppLogsModule;
+    /** {@link MobileModule | Mobile module} for mobile native capabilities like push notifications. */
+    mobile: MobileModule;
     /** {@link AnalyticsModule | Analytics module} for tracking app usage. */
     analytics: AnalyticsModule;
     /** Cleanup function to disconnect WebSocket connections. Call when you're done with the client. */

package/dist/index.d.ts

@@ -10,6 +10,7 @@ export type { IntegrationsModule, IntegrationPackage, IntegrationEndpointFunctio
 export type { FunctionsModule } from "./modules/functions.types.js";
 export type { AgentsModule, AgentConversation, AgentMessage, AgentMessageReasoning, AgentMessageToolCall, AgentMessageUsage, AgentMessageCustomContext, AgentMessageMetadata, CreateConversationParams, } from "./modules/agents.types.js";
 export type { AppLogsModule } from "./modules/app-logs.types.js";
+export type { MobileModule, SendNotificationParams, NotificationResult, NotificationChannel, ChannelResult, } from "./modules/mobile.types.js";
 export type { SsoModule, SsoAccessTokenResponse } from "./modules/sso.types.js";
 export type { ConnectorsModule } from "./modules/connectors.types.js";
 export type { CustomIntegrationsModule, CustomIntegrationCallParams, CustomIntegrationCallResponse, } from "./modules/custom-integrations.types.js";

package/dist/modules/auth.js

@@ -34,16 +34,6 @@ export function createAuthModule(axios, functionsAxiosClient, appId, options) {
             // Redirect to the login page
             window.location.href = loginUrl;
         },
-        // Redirects the user to a provider's login page
-        loginWithProvider(provider, fromUrl = "/") {
-            // Build the full redirect URL
-            const redirectUrl = new URL(fromUrl, window.location.origin).toString();
-            // Build the provider login URL (google is the default, so no provider path needed)
-            const providerPath = provider === "google" ? "" : `/${provider}`;
-            const loginUrl = `${options.serverUrl}/api/apps/auth${providerPath}/login?app_id=${appId}&from_url=${encodeURIComponent(redirectUrl)}`;
-            // Redirect to the provider login page
-            window.location.href = loginUrl;
-        },
         // Logout the current user
         // Removes the token from localStorage and optionally redirects to a URL or reloads the page
         logout(redirectUrl) {

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

@@ -171,27 +171,6 @@ export interface AuthModule {
      * ```
      */
     redirectToLogin(nextUrl: string): void;
-    /**
-     * Redirects the user to a third-party authentication provider's login page.
-     *
-     * Initiates OAuth/SSO login flow with providers like Google, Microsoft, etc. Requires a browser environment and can't be used in the backend.
-     *
-     * @param provider - Name of the supported authentication provider (e.g., 'google', 'microsoft').
-     * @param fromUrl - URL to redirect to after successful authentication. Defaults to '/'.
-     *
-     * @example
-     * ```typescript
-     * // Login with Google and return to current page
-     * base44.auth.loginWithProvider('google', window.location.pathname);
-     * ```
-     *
-     * @example
-     * ```typescript
-     * // Login with GitHub and redirect to dashboard
-     * base44.auth.loginWithProvider('microsoft', '/dashboard');
-     * ```
-     */
-    loginWithProvider(provider: string, fromUrl?: string): void;
     /**
      * Logs out the current user.
      *

package/dist/modules/mobile.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Mobile module for Base44 SDK.
+ *
+ * Provides mobile native capabilities like push notifications.
+ */
+import { AxiosInstance } from "axios";
+import { MobileModule } from "./mobile.types";
+/**
+ * Creates the mobile module for the Base44 SDK.
+ *
+ * @param axios - Axios instance for API requests
+ * @param appId - Application ID
+ * @returns Mobile module with native mobile capabilities
+ * @internal
+ */
+export declare function createMobileModule(axios: AxiosInstance, appId: string): MobileModule;

package/dist/modules/mobile.js

@@ -0,0 +1,39 @@
+/**
+ * Mobile module for Base44 SDK.
+ *
+ * Provides mobile native capabilities like push notifications.
+ */
+/**
+ * Validates notification parameters against character limits.
+ * @param params - Notification parameters to validate
+ * @throws Error if any parameter exceeds its limit
+ */
+function validateNotificationParams(params) {
+    if (params.title.length > 100) {
+        throw new Error(`Title must be 100 characters or less (current: ${params.title.length})`);
+    }
+    if (params.content.length > 500) {
+        throw new Error(`Content must be 500 characters or less (current: ${params.content.length})`);
+    }
+    if (params.actionLabel && params.actionLabel.length > 50) {
+        throw new Error(`Action label must be 50 characters or less (current: ${params.actionLabel.length})`);
+    }
+}
+/**
+ * Creates the mobile module for the Base44 SDK.
+ *
+ * @param axios - Axios instance for API requests
+ * @param appId - Application ID
+ * @returns Mobile module with native mobile capabilities
+ * @internal
+ */
+export function createMobileModule(axios, appId) {
+    return {
+        async sendNotification(params) {
+            // Validate input parameters
+            validateNotificationParams(params);
+            const response = await axios.post(`/api/apps/${appId}/mobile/notifications`, params);
+            return response.data;
+        },
+    };
+}

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

@@ -0,0 +1,86 @@
+/**
+ * TypeScript type definitions for Base44 Mobile SDK.
+ *
+ * Provides mobile native capabilities like push notifications
+ * for apps built with Base44.
+ */
+/**
+ * Channel type for notifications.
+ * - "mobile_push": Send via mobile push notification (Ping service)
+ * - "in_app": Send via in-app notification (WebSocket + MongoDB)
+ */
+export type NotificationChannel = "mobile_push" | "in_app";
+/**
+ * Parameters for sending a notification to an app user.
+ */
+export interface SendNotificationParams {
+    /** App user ID to notify */
+    userId: string;
+    /** Notification title (max 100 characters) */
+    title: string;
+    /** Notification content (max 500 characters, supports HTML) */
+    content: string;
+    /** Optional button text (max 50 characters) */
+    actionLabel?: string;
+    /** Optional button link */
+    actionUrl?: string;
+    /** Optional list of channels. If not specified, uses all channels (mobile_push + in_app) */
+    channels?: NotificationChannel[];
+    /** Optional custom metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Result from a single notification channel.
+ */
+export interface ChannelResult {
+    /** Whether the notification was sent successfully through this channel */
+    success: boolean;
+    /** Error message if the channel failed */
+    error?: string;
+}
+/**
+ * Response from sending a notification.
+ */
+export interface NotificationResult {
+    /** Overall success status */
+    success: boolean;
+    /** Notification ID if in_app channel was used */
+    notificationId?: string;
+    /** Results per channel */
+    channels: {
+        in_app?: ChannelResult;
+        mobile_push?: ChannelResult;
+    };
+}
+/**
+ * Mobile module interface providing mobile native capabilities.
+ */
+export interface MobileModule {
+    /**
+     * Send a notification to an app user.
+     *
+     * @param params - Notification parameters
+     * @returns Promise resolving to notification result
+     *
+     * @example
+     * ```typescript
+     * // Send mobile push notification only
+     * await base44.mobile.sendNotification({
+     *   userId: 'app_user_123',
+     *   title: 'New Message!',
+     *   content: 'You have a new message from John',
+     *   actionLabel: 'View Message',
+     *   actionUrl: '/messages/456',
+     *   channels: ['mobile_push']
+     * });
+     *
+     * // Send to both channels (default)
+     * await base44.mobile.sendNotification({
+     *   userId: 'app_user_123',
+     *   title: 'Order Shipped',
+     *   content: 'Your order #12345 has been shipped'
+     * });
+     * ```
+     */
+    sendNotification(params: SendNotificationParams): Promise<NotificationResult>;
+}

package/dist/modules/mobile.types.js

@@ -0,0 +1,7 @@
+/**
+ * TypeScript type definitions for Base44 Mobile SDK.
+ *
+ * Provides mobile native capabilities like push notifications
+ * for apps built with Base44.
+ */
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.17-pr.49.b78ce52",
+  "version": "0.8.17-pr.73.e88f2f7",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",