@omnikit-ai/sdk 2.0.7 → 2.0.9

package/dist/index.d.mts

@@ -229,11 +229,12 @@ interface LLMMessage {
     }>;
 }
 /**
- * Available LLM models for InvokeLLM
- * - 'gemini-flash': Fast and cost-effective (default)
- * - 'gemini-pro': Smarter with extended thinking (128 token thinking budget)
+ * Available LLM models:
+ * - Gemini 2.5: 'gemini-2.5-flash-lite' (fastest), 'gemini-2.5-flash', 'gemini-2.5-pro'
+ * - Gemini 3: 'gemini-3-flash' (best multimodal), 'gemini-3-pro' (advanced reasoning)
+ * - Legacy aliases: 'gemini-flash', 'gemini-pro', 'gemini-pro-3' (for backward compatibility)
  */
-type LLMModel = 'gemini-flash' | 'gemini-pro';
+type LLMModel = 'gemini-2.5-flash-lite' | 'gemini-2.5-flash' | 'gemini-2.5-pro' | 'gemini-3-flash' | 'gemini-3-pro' | 'gemini-flash' | 'gemini-pro' | 'gemini-pro-3';
 interface LLMParams {
     /** Message-based format for advanced use */
     messages?: LLMMessage[];
@@ -253,9 +254,11 @@ interface LLMParams {
         type: 'json_object';
     } | Record<string, any>;
     /**
-     * Model to use for LLM processing
-     * - 'gemini-flash': Fast and cost-effective (default)
-     * - 'gemini-pro': Smarter with extended thinking for complex reasoning
+     * Model to use for LLM processing.
+     * Defaults: 'gemini-2.5-flash-lite' for text, 'gemini-3-flash' for files/images.
+     * - 'gemini-2.5-flash-lite': Fastest, best for simple text tasks
+     * - 'gemini-3-flash': Best multimodal (images, PDFs, videos)
+     * - 'gemini-2.5-pro' / 'gemini-3-pro': Advanced reasoning
      */
     model?: LLMModel | string;
     /**
@@ -842,6 +845,21 @@ interface OmnikitClient {
     metadata: CachedMetadata;
     /** Collection operations */
     collections: Record<string, CollectionClass>;
+    /**
+     * Get a collection by name (function-style accessor)
+     * Alternative to omnikit.collections.name for more intuitive API
+     *
+     * @param name - Collection name (case-insensitive)
+     * @returns CollectionClass with CRUD methods
+     *
+     * @example
+     * ```typescript
+     * // Both of these work:
+     * await omnikit.collection('user').list()
+     * await omnikit.collections.user.list()
+     * ```
+     */
+    collection(name: string): CollectionClass;
     /** @deprecated Use collections instead */
     entities: Record<string, CollectionClass>;
     /** Integration operations */
@@ -1111,6 +1129,19 @@ interface LiveVoiceServerMessage {
     session_id?: string;
     duration_seconds?: number;
 }
+/**
+ * Global window extensions used by the SDK
+ */
+declare global {
+    interface Window {
+        /**
+         * Opens the login modal (registered by LoginModalProvider in main.jsx)
+         * Used by auth.login() to show inline login for public apps instead of redirecting
+         * @param returnUrl - URL to return to after successful login
+         */
+        __omnikit_openLoginModal?: (returnUrl?: string) => void;
+    }
+}
 
 /**
  * Omnikit SDK v2.0 - Main Client
@@ -1196,6 +1227,24 @@ declare class APIClient implements OmnikitClient {
      * Lazy getter for collections - auto-initializes on first access
      */
     get collections(): Record<string, CollectionClass>;
+    /**
+     * Helper method to access a collection by name.
+     * Provides a more intuitive API: omnikit.collection('user').list()
+     * This is an alternative to: omnikit.collections.user.list()
+     *
+     * @param name - Collection name (case-insensitive, supports PascalCase, camelCase, snake_case)
+     * @returns CollectionClass with CRUD methods
+     *
+     * @example
+     * ```typescript
+     * // All of these work:
+     * await omnikit.collection('user').list()
+     * await omnikit.collection('User').list()
+     * await omnikit.collection('chatbot').list()
+     * await omnikit.collection('Chatbot').list()
+     * ```
+     */
+    collection(name: string): CollectionClass;
     /**
      * @deprecated Use collections instead. This alias exists for backward compatibility.
      */
@@ -1271,11 +1320,6 @@ declare class APIClient implements OmnikitClient {
      * Fetch app schema from backend
      */
     private fetchAppSchema;
-    /**
-     * Fetch integration schema from backend
-     * Returns ServicesSchema (new flat format) or IntegrationSchema (legacy)
-     */
-    private fetchIntegrationSchema;
     /**
      * Create collection classes from schema
      */

package/dist/index.d.ts

@@ -229,11 +229,12 @@ interface LLMMessage {
     }>;
 }
 /**
- * Available LLM models for InvokeLLM
- * - 'gemini-flash': Fast and cost-effective (default)
- * - 'gemini-pro': Smarter with extended thinking (128 token thinking budget)
+ * Available LLM models:
+ * - Gemini 2.5: 'gemini-2.5-flash-lite' (fastest), 'gemini-2.5-flash', 'gemini-2.5-pro'
+ * - Gemini 3: 'gemini-3-flash' (best multimodal), 'gemini-3-pro' (advanced reasoning)
+ * - Legacy aliases: 'gemini-flash', 'gemini-pro', 'gemini-pro-3' (for backward compatibility)
  */
-type LLMModel = 'gemini-flash' | 'gemini-pro';
+type LLMModel = 'gemini-2.5-flash-lite' | 'gemini-2.5-flash' | 'gemini-2.5-pro' | 'gemini-3-flash' | 'gemini-3-pro' | 'gemini-flash' | 'gemini-pro' | 'gemini-pro-3';
 interface LLMParams {
     /** Message-based format for advanced use */
     messages?: LLMMessage[];
@@ -253,9 +254,11 @@ interface LLMParams {
         type: 'json_object';
     } | Record<string, any>;
     /**
-     * Model to use for LLM processing
-     * - 'gemini-flash': Fast and cost-effective (default)
-     * - 'gemini-pro': Smarter with extended thinking for complex reasoning
+     * Model to use for LLM processing.
+     * Defaults: 'gemini-2.5-flash-lite' for text, 'gemini-3-flash' for files/images.
+     * - 'gemini-2.5-flash-lite': Fastest, best for simple text tasks
+     * - 'gemini-3-flash': Best multimodal (images, PDFs, videos)
+     * - 'gemini-2.5-pro' / 'gemini-3-pro': Advanced reasoning
      */
     model?: LLMModel | string;
     /**
@@ -842,6 +845,21 @@ interface OmnikitClient {
     metadata: CachedMetadata;
     /** Collection operations */
     collections: Record<string, CollectionClass>;
+    /**
+     * Get a collection by name (function-style accessor)
+     * Alternative to omnikit.collections.name for more intuitive API
+     *
+     * @param name - Collection name (case-insensitive)
+     * @returns CollectionClass with CRUD methods
+     *
+     * @example
+     * ```typescript
+     * // Both of these work:
+     * await omnikit.collection('user').list()
+     * await omnikit.collections.user.list()
+     * ```
+     */
+    collection(name: string): CollectionClass;
     /** @deprecated Use collections instead */
     entities: Record<string, CollectionClass>;
     /** Integration operations */
@@ -1111,6 +1129,19 @@ interface LiveVoiceServerMessage {
     session_id?: string;
     duration_seconds?: number;
 }
+/**
+ * Global window extensions used by the SDK
+ */
+declare global {
+    interface Window {
+        /**
+         * Opens the login modal (registered by LoginModalProvider in main.jsx)
+         * Used by auth.login() to show inline login for public apps instead of redirecting
+         * @param returnUrl - URL to return to after successful login
+         */
+        __omnikit_openLoginModal?: (returnUrl?: string) => void;
+    }
+}
 
 /**
  * Omnikit SDK v2.0 - Main Client
@@ -1196,6 +1227,24 @@ declare class APIClient implements OmnikitClient {
      * Lazy getter for collections - auto-initializes on first access
      */
     get collections(): Record<string, CollectionClass>;
+    /**
+     * Helper method to access a collection by name.
+     * Provides a more intuitive API: omnikit.collection('user').list()
+     * This is an alternative to: omnikit.collections.user.list()
+     *
+     * @param name - Collection name (case-insensitive, supports PascalCase, camelCase, snake_case)
+     * @returns CollectionClass with CRUD methods
+     *
+     * @example
+     * ```typescript
+     * // All of these work:
+     * await omnikit.collection('user').list()
+     * await omnikit.collection('User').list()
+     * await omnikit.collection('chatbot').list()
+     * await omnikit.collection('Chatbot').list()
+     * ```
+     */
+    collection(name: string): CollectionClass;
     /**
      * @deprecated Use collections instead. This alias exists for backward compatibility.
      */
@@ -1271,11 +1320,6 @@ declare class APIClient implements OmnikitClient {
      * Fetch app schema from backend
      */
     private fetchAppSchema;
-    /**
-     * Fetch integration schema from backend
-     * Returns ServicesSchema (new flat format) or IntegrationSchema (legacy)
-     */
-    private fetchIntegrationSchema;
     /**
      * Create collection classes from schema
      */

package/dist/index.js

@@ -437,8 +437,17 @@ var LiveVoiceSessionImpl = class {
 
 // src/client.ts
 var LLM_MODEL_MAP = {
+  // Gemini 2.5 models
+  "gemini-2.5-flash-lite": "vertex_ai/gemini-2.5-flash-lite",
+  "gemini-2.5-flash": "vertex_ai/gemini-2.5-flash",
+  "gemini-2.5-pro": "vertex_ai/gemini-2.5-pro",
+  // Gemini 3 models
+  "gemini-3-flash": "vertex_ai/gemini-3-flash-preview",
+  "gemini-3-pro": "vertex_ai/gemini-3-pro-preview",
+  // Legacy aliases (for backward compatibility)
   "gemini-flash": "vertex_ai/gemini-2.5-flash",
-  "gemini-pro": "vertex_ai/gemini-2.5-pro"
+  "gemini-pro": "vertex_ai/gemini-2.5-pro",
+  "gemini-pro-3": "vertex_ai/gemini-3-pro-preview"
 };
 function mapLLMModel(model) {
   if (!model) return void 0;
@@ -616,6 +625,26 @@ var APIClient = class {
   get collections() {
     return this.createCollectionsProxy(false);
   }
+  /**
+   * Helper method to access a collection by name.
+   * Provides a more intuitive API: omnikit.collection('user').list()
+   * This is an alternative to: omnikit.collections.user.list()
+   *
+   * @param name - Collection name (case-insensitive, supports PascalCase, camelCase, snake_case)
+   * @returns CollectionClass with CRUD methods
+   *
+   * @example
+   * ```typescript
+   * // All of these work:
+   * await omnikit.collection('user').list()
+   * await omnikit.collection('User').list()
+   * await omnikit.collection('chatbot').list()
+   * await omnikit.collection('Chatbot').list()
+   * ```
+   */
+  collection(name) {
+    return this.collections[name];
+  }
   /**
    * @deprecated Use collections instead. This alias exists for backward compatibility.
    */
@@ -697,8 +726,12 @@ var APIClient = class {
       },
       login(returnUrl) {
         const fullReturnUrl = returnUrl || (typeof window !== "undefined" ? window.location.href : "/");
-        const encodedReturnUrl = encodeURIComponent(fullReturnUrl);
         if (typeof window !== "undefined") {
+          if (window.__omnikit_openLoginModal) {
+            window.__omnikit_openLoginModal(fullReturnUrl);
+            return;
+          }
+          const encodedReturnUrl = encodeURIComponent(fullReturnUrl);
           const currentPath = window.location.pathname;
           const apiSitesMatch = currentPath.match(/^\/api\/sites\/([^\/]+)/);
           if (apiSitesMatch) {
@@ -1097,10 +1130,15 @@ Example: await ${collectionName}.list({ limit: 100, sort: '-created_at' })`,
    */
   createServicesProxy(useServiceToken) {
     const client = this;
+    function normalizeServiceName(name) {
+      if (!name) return name;
+      return name.charAt(0).toUpperCase() + name.slice(1);
+    }
     return new Proxy({}, {
       get(target, serviceName) {
         if (typeof serviceName === "string" && !serviceName.startsWith("_")) {
-          if (serviceName === "CheckJobStatus") {
+          const normalizedName = normalizeServiceName(serviceName);
+          if (normalizedName === "CheckJobStatus") {
             return async function(params) {
               await client.ensureInitialized();
               if (!params?.job_id) {
@@ -1116,7 +1154,7 @@ Example: await ${collectionName}.list({ limit: 100, sort: '-created_at' })`,
               );
             };
           }
-          if (serviceName === "DownloadPrivateFile") {
+          if (normalizedName === "DownloadPrivateFile") {
             return async function(params) {
               await client.ensureInitialized();
               if (!params?.file_uri) {
@@ -1140,7 +1178,7 @@ Example: await ${collectionName}.list({ limit: 100, sort: '-created_at' })`,
           }
           return async function(params, asyncOptions) {
             await client.ensureInitialized();
-            if (serviceName === "InvokeLLM") {
+            if (normalizedName === "InvokeLLM") {
               if (params?.model) {
                 params = { ...params, model: mapLLMModel(params.model) };
               }
@@ -1149,7 +1187,7 @@ Example: await ${collectionName}.list({ limit: 100, sort: '-created_at' })`,
               }
             }
             let response;
-            const method = client._services[serviceName];
+            const method = client._services[normalizedName];
             if (method) {
               response = await method(params, useServiceToken);
             } else {
@@ -1165,10 +1203,10 @@ Example: await ${collectionName}.list({ limit: 100, sort: '-created_at' })`,
                 "UploadPrivateFile": "services/files/private/init",
                 "CreateFileSignedUrl": "services/files/signed-url"
               };
-              const servicePath = servicePathMap[serviceName];
+              const servicePath = servicePathMap[normalizedName];
               if (!servicePath) {
                 throw new OmnikitError(
-                  `Service '${serviceName}' not found. Known services: ${Object.keys(servicePathMap).join(", ")}`,
+                  `Service '${serviceName}' not found. Known services: ${Object.keys(servicePathMap).join(", ")} (camelCase also supported)`,
                   404,
                   "SERVICE_NOT_FOUND"
                 );
@@ -1181,6 +1219,12 @@ Example: await ${collectionName}.list({ limit: 100, sort: '-created_at' })`,
               } else if (client.userToken) {
                 headers["Authorization"] = `Bearer ${client.userToken}`;
               }
+              if ((normalizedName === "UploadFile" || normalizedName === "uploadFile") && params?.file instanceof File) {
+                return client.handleFileUpload(params.file, servicePath, useServiceToken);
+              }
+              if ((normalizedName === "UploadPrivateFile" || normalizedName === "uploadPrivateFile") && params?.file instanceof File) {
+                return client.handleFileUpload(params.file, servicePath, useServiceToken);
+              }
               const fetchResponse = await fetch(
                 `${client.baseUrl}/apps/${client.appId}/${servicePath}`,
                 {
@@ -1336,23 +1380,6 @@ Example: await ${collectionName}.list({ limit: 100, sort: '-created_at' })`,
     }
     return await response.json();
   }
-  /**
-   * Fetch integration schema from backend
-   * Returns ServicesSchema (new flat format) or IntegrationSchema (legacy)
-   */
-  async fetchIntegrationSchema() {
-    try {
-      const response = await fetch(
-        `${this.baseUrl}/apps/${this.appId}/services`
-      );
-      if (!response.ok) {
-        return null;
-      }
-      return await response.json();
-    } catch (error) {
-      return null;
-    }
-  }
   /**
    * Create collection classes from schema
    */