Testing claude

[kfirstri]

@claude please summarize all the public facing code

[claude]

Claude finished @kfirstri's task —— View job

---

Task List

• Check for CLAUDE.md files
• Explore repository structure
• Identify public-facing APIs and entry points
• Analyze main SDK components
• Provide comprehensive summary

Summary of Public-Facing Code

The @base44/sdk is a JavaScript/TypeScript SDK for building applications on the Base44 platform. It's published as an npm package and provides a comprehensive client interface for interacting with Base44 services.

Main Entry Points

createClient(config) - Creates a Base44 client instance

• Primary way external apps connect to Base44
• Requires appId parameter to identify your app
• Returns a client with access to all SDK modules

createClientFromRequest(request) - Creates a client from HTTP request

• Used in Base44-hosted backend functions
• Automatically extracts authentication from request headers
• Provides service role access for admin operations

Core Modules

1. Entities Module (base44.entities)

• CRUD operations on data models: create(), read(), update(), delete()
• Query methods: list(), filter(), count(), find()
• Real-time subscriptions: subscribe(), subscribeAll()
• Batch operations: createMany(), updateMany(), deleteMany()

2. Auth Module (base44.auth)

• User authentication: loginViaEmailPassword(), loginViaGoogle(), loginViaOAuth()
• Registration: register(), registerWithGoogle()
• Session management: me(), isAuthenticated(), logout()
• Password operations: changePassword(), resetPassword()

3. Functions Module (base44.functions)

• Invoke custom backend functions: invoke(functionName, data)
• Supports file uploads via multipart/form-data
• Available in both user and service role modes

4. Integrations Module (base44.integrations)

• Pre-built integrations via dynamic properties
• Core integrations include:
  • InvokeLLM() - AI/LLM interactions
  • SendEmail() - Email sending
  • UploadFile() / UploadPrivateFile() - File storage
  • GenerateImage() - Image generation
  • ExtractDataFromUploadedFile() - Data extraction

5. Agents Module (base44.agents)

• AI agent conversations: createConversation(), sendMessage()
• Conversation management: listConversations(), getConversation()
• Message streaming and tool call handling
• Delete conversations: deleteConversation()

6. Analytics Module (base44.analytics)

• Track custom events: track({ eventName, properties })
• Events appear as cards in the Analytics dashboard
• Batched event sending for performance

7. App Logs Module (base44.appLogs)

• Log user activity: logUserInApp(pageName)
• Track page visits and feature usage

Authentication Modes

1. Anonymous Access

• Use modules without authentication
• Limited to public data and operations

2. User Authentication

• Full access scoped to authenticated user
• Set via auth.login*() methods or token

3. Service Role (base44.asServiceRole.*)

• Admin-level permissions
• Only available in backend functions
• Requires service token

Utility Functions

• getAccessToken() / saveAccessToken() / removeAccessToken() - Token management
• getLoginUrl() - Generate OAuth login URLs
• Base44Error - Custom error class for API errors

Key Types Exported

• Base44Client - Main client interface
• User, LoginResponse - Auth types
• RealtimeEvent, RealtimeCallback - Real-time types
• Module-specific types for each SDK module
• ModelFilterParams - Query parameter interface

The SDK is built with TypeScript, includes comprehensive type definitions, and is designed to work in both browser and server environments (Node.js/Deno).