@omnikit-ai/sdk 2.0.6 → 2.0.8

package/dist/index.d.mts

@@ -232,8 +232,9 @@ interface LLMMessage {
  * Available LLM models for InvokeLLM
  * - 'gemini-flash': Fast and cost-effective (default)
  * - 'gemini-pro': Smarter with extended thinking (128 token thinking budget)
+ * - 'gemini-pro-3': Gemini 3 Pro Preview with low thinking effort
  */
-type LLMModel = 'gemini-flash' | 'gemini-pro';
+type LLMModel = 'gemini-flash' | 'gemini-pro' | 'gemini-pro-3';
 interface LLMParams {
     /** Message-based format for advanced use */
     messages?: LLMMessage[];
@@ -256,6 +257,7 @@ interface LLMParams {
      * Model to use for LLM processing
      * - 'gemini-flash': Fast and cost-effective (default)
      * - 'gemini-pro': Smarter with extended thinking for complex reasoning
+     * - 'gemini-pro-3': Gemini 3 Pro Preview with low thinking effort
      */
     model?: LLMModel | string;
     /**
@@ -842,6 +844,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 +1128,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 +1226,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 +1319,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

@@ -232,8 +232,9 @@ interface LLMMessage {
  * Available LLM models for InvokeLLM
  * - 'gemini-flash': Fast and cost-effective (default)
  * - 'gemini-pro': Smarter with extended thinking (128 token thinking budget)
+ * - 'gemini-pro-3': Gemini 3 Pro Preview with low thinking effort
  */
-type LLMModel = 'gemini-flash' | 'gemini-pro';
+type LLMModel = 'gemini-flash' | 'gemini-pro' | 'gemini-pro-3';
 interface LLMParams {
     /** Message-based format for advanced use */
     messages?: LLMMessage[];
@@ -256,6 +257,7 @@ interface LLMParams {
      * Model to use for LLM processing
      * - 'gemini-flash': Fast and cost-effective (default)
      * - 'gemini-pro': Smarter with extended thinking for complex reasoning
+     * - 'gemini-pro-3': Gemini 3 Pro Preview with low thinking effort
      */
     model?: LLMModel | string;
     /**
@@ -842,6 +844,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 +1128,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 +1226,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 +1319,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

@@ -438,7 +438,8 @@ var LiveVoiceSessionImpl = class {
 // src/client.ts
 var LLM_MODEL_MAP = {
   "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 +617,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 +718,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 +1122,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 +1146,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 +1170,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,26 +1179,26 @@ 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 {
               const servicePathMap = {
-                "SendEmail": "email/send",
-                "InvokeLLM": "llm/invoke",
-                "GenerateImage": "image/generate",
-                "GenerateSpeech": "speech/generate",
-                "GenerateVideo": "video/generate",
-                "ExtractData": "extract/data",
-                "SendSMS": "sms/send",
-                "UploadFile": "storage/upload",
-                "UploadPrivateFile": "storage/upload-private",
-                "CreateFileSignedUrl": "storage/signed-url"
+                "SendEmail": "services/email",
+                "InvokeLLM": "services/llm",
+                "GenerateImage": "services/images",
+                "GenerateSpeech": "services/speech",
+                "GenerateVideo": "services/video",
+                "ExtractData": "services/extract-text",
+                "SendSMS": "services/sms",
+                "UploadFile": "services/files",
+                "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"
                 );
@@ -1182,7 +1212,7 @@ Example: await ${collectionName}.list({ limit: 100, sort: '-created_at' })`,
                 headers["Authorization"] = `Bearer ${client.userToken}`;
               }
               const fetchResponse = await fetch(
-                `${client.baseUrl}/apps/${client.appId}/integrations/${servicePath}`,
+                `${client.baseUrl}/apps/${client.appId}/${servicePath}`,
                 {
                   method: "POST",
                   headers,
@@ -1336,23 +1366,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
    */