@codegenapps/frontend-sdk 1.0.2 → 1.0.3

package/README.md

@@ -31,7 +31,7 @@ async function initialize() {
     baseUrl: 'http://localhost:8080/api',
 
     // A function that provides your SDK license key
-    licenseKeyProvider: () => 'YOUR_SDK_LICENSE_KEY',
+    licenseKeyProvider: () => 'YOUR_API_KEY',
 
     // (Optional) A function that provides the JWT for authenticated requests
     tokenProvider: () => localStorage.getItem('jwt_token'),
@@ -60,7 +60,38 @@ async function fetchDocuments() {
   }
 }
 
-initialize().then(fetchDocuments);
+initialize().then(async () => {
+  await fetchDocuments();
+  await loginUser(); // 示範登入功能
+});
+
+// 3. Perform login
+async function loginUser() {
+  const API_KEY = 'YOUR_API_KEY'; 
+  const account = 'test@example.com';  
+  const password = 'testpassword';      
+
+  try {
+    console.log(`嘗試使用帳號: ${account}, API Key: ${API_KEY} 登入...`);
+    const { data, error } = await cga.auth.login(account, password, API_KEY);
+
+    if (error) {
+      console.error('登入失敗:', error);
+      return;
+    }
+
+    console.log('登入成功! 取得的資料:', data);
+    // 您可以在這裡處理登入成功後的邏輯，例如儲存 JWT token
+    if (data && data.token) {
+      localStorage.setItem('jwt_token', data.token);
+      console.log('JWT Token 已儲存到 localStorage。');
+    }
+
+  } catch (err) {
+    console.error('執行登入時發生意外錯誤:', err);
+  }
+}
+
 ```
 
 ## Usage with Frameworks
@@ -210,6 +241,47 @@ Example: `cga.from('daily_active_user').byPk({ activity_date: '...', user_id: 1,
 
 Executes the query and returns a `Promise` that resolves to `{ data, error }`. **All query chains must end with `.run()`.**
 
+### Customizing Requests
+
+While the query builder provides methods for common operations, you can further customize requests by passing an `options` object to the action methods (`select`, `insert`, `update`, `delete`).
+
+#### Adding Custom Headers
+
+You can add or override headers for a specific request.
+
+```javascript
+const { data, error } = await cga
+  .from('documents')
+  .select('id, title', { // <-- Pass options here
+    headers: {
+      'X-Request-ID': 'custom-request-12345'
+    }
+  })
+  .run();
+```
+
+#### Adding Custom Query Parameters
+
+For special query parameters not covered by the built-in filter methods, you can use `axiosConfig.params`. These will be merged with the parameters generated by the builder.
+
+```javascript
+const { data, error } = await cga
+  .from('documents')
+  .select('id, title', { // <-- Pass options here
+    axiosConfig: {
+      params: {
+        '_cache': false,
+        'apiVersion': '2.1'
+      }
+    }
+  })
+  .eq('owner_id', 1) // Builder params are still used
+  .run();
+
+// The above request will be sent to a URL like:
+// /api/documents?_cache=false&apiVersion=2.1&filter=owner_id,eq,1
+```
+
 ## License
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codegenapps/frontend-sdk",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "A frontend SDK for seamless API integration, driven by a dynamic schema.",
   "type": "module",
   "main": "dist/index.umd.js",