aurabase-js 0.1.0 → 0.2.1

package/README.md

@@ -12,6 +12,74 @@ yarn add aurabase-js
 pnpm add aurabase-js
 ```
 
+설치 후 아래 명령어 한 번으로 `lib/` 폴더와 환경변수 파일을 자동 생성합니다:
+
+```bash
+npx aurabase-js init
+```
+
+```
+aurabase-js init
+──────────────────────────────────
+✔ lib/client.ts 생성
+✔ lib/server.ts 생성
+✔ lib/admin.ts  생성
+
+📋 환경변수 설정
+──────────────────────────────────
+✔ .env.local 생성 — 아래 값을 채워주세요
+
+  NEXT_PUBLIC_AURABASE_URL=https://your-project.cloudfront.net
+  NEXT_PUBLIC_AURABASE_ANON_KEY=your-anon-key
+  NEXT_PUBLIC_AURABASE_SERVICE_ROLE_KEY=your-service-role-key
+
+  → AuraBase 대시보드 API Keys 메뉴에서 확인하세요.
+```
+
+---
+
+## ⚙️ 환경변수 설정 (Next.js)
+
+설치 후 프로젝트 루트에 `.env.local` 파일을 생성하고 아래 값을 입력하세요.
+
+```env
+# AuraBase 프로젝트 URL
+NEXT_PUBLIC_AURABASE_URL=https://your-project.cloudfront.net
+
+# 일반 사용자용 키 (클라이언트 컴포넌트, RLS 적용)
+NEXT_PUBLIC_AURABASE_ANON_KEY=your-anon-key
+
+# 관리자용 키 (서버 컴포넌트 / API Route 전용, RLS 우회)
+NEXT_PUBLIC_AURABASE_SERVICE_ROLE_KEY=your-service-role-key
+```
+
+> 위 값은 AuraBase 대시보드 → **API Keys** 메뉴에서 확인할 수 있습니다.
+
+### `lib/client.ts` — 클라이언트 컴포넌트용
+
+```typescript
+import { createClient } from 'aurabase-js'
+
+export const client = createClient({
+  url: process.env.NEXT_PUBLIC_AURABASE_URL!,
+  anonKey: process.env.NEXT_PUBLIC_AURABASE_ANON_KEY!,
+})
+```
+
+### `lib/admin.ts` — 서버 전용 (API Route, Server Component)
+
+```typescript
+import { createClient } from 'aurabase-js'
+
+// ⚠️ 절대 클라이언트 컴포넌트에서 사용 금지 — RLS를 우회합니다
+export const admin = createClient({
+  url: process.env.NEXT_PUBLIC_AURABASE_URL!,
+  anonKey: process.env.NEXT_PUBLIC_AURABASE_SERVICE_ROLE_KEY!,
+})
+```
+
+---
+
 ## 사용법
 
 ### 클라이언트 생성
@@ -20,8 +88,8 @@ pnpm add aurabase-js
 import { createClient } from 'aurabase-js'
 
 const aurabase = createClient({
-  url: 'http://localhost:8000', // 또는 배포된 URL
-  anonKey: 'your-anon-key'
+  url: process.env.NEXT_PUBLIC_AURABASE_URL!,
+  anonKey: process.env.NEXT_PUBLIC_AURABASE_ANON_KEY!,
 })
 ```
 

package/dist/cli.js

@@ -0,0 +1,144 @@
+#!/usr/bin/env node
+"use strict";
+
+const fs = require('fs');
+const path = require('path');
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+const BOLD   = '\x1b[1m';
+const GREEN  = '\x1b[32m';
+const YELLOW = '\x1b[33m';
+const CYAN   = '\x1b[36m';
+const RESET  = '\x1b[0m';
+
+function success(msg) { console.log(`${GREEN}✔${RESET} ${msg}`); }
+function warn(msg)    { console.log(`${YELLOW}⚠${RESET}  ${msg}`); }
+function info(msg)    { console.log(`${CYAN}ℹ${RESET}  ${msg}`); }
+
+// ─── 생성할 파일 내용 ──────────────────────────────────────────────────────────
+
+const CLIENT_TS = `import { createClient } from 'aurabase-js';
+
+export const client = createClient({
+  url: process.env.NEXT_PUBLIC_AURABASE_URL || '',
+  anonKey: process.env.NEXT_PUBLIC_AURABASE_ANON_KEY || '',
+});
+`;
+
+const SERVER_TS = `import { createClient } from 'aurabase-js';
+import { cookies } from 'next/headers';
+
+export async function server() {
+  const cookieStore = await cookies();
+  const accessToken = cookieStore.get('access_token')?.value;
+
+  const client = createClient({
+    url: process.env.NEXT_PUBLIC_AURABASE_URL || '',
+    anonKey: process.env.NEXT_PUBLIC_AURABASE_ANON_KEY || '',
+  });
+
+  if (accessToken) {
+    client.setAccessToken(accessToken);
+  }
+
+  return client;
+}
+`;
+
+const ADMIN_TS = `import { createClient } from 'aurabase-js';
+
+/**
+ * Admin client with service_role key
+ * ⚠️ ONLY use on server-side (API routes, server components)
+ * ⚠️ Bypasses all RLS policies - use with caution!
+ */
+export const admin = createClient({
+  url: process.env.NEXT_PUBLIC_AURABASE_URL || '',
+  anonKey: process.env.NEXT_PUBLIC_AURABASE_SERVICE_ROLE_KEY || '',
+});
+`;
+
+const ENV_EXAMPLE = `# AuraBase
+NEXT_PUBLIC_AURABASE_URL=https://your-project.cloudfront.net
+NEXT_PUBLIC_AURABASE_ANON_KEY=your-anon-key
+NEXT_PUBLIC_AURABASE_SERVICE_ROLE_KEY=your-service-role-key
+`;
+
+// ─── init ─────────────────────────────────────────────────────────────────────
+
+function init() {
+  const cwd = process.cwd();
+  const libDir = path.join(cwd, 'lib');
+
+  console.log('');
+  console.log(`${BOLD}aurabase-js init${RESET}`);
+  console.log('──────────────────────────────────');
+
+  if (!fs.existsSync(libDir)) {
+    fs.mkdirSync(libDir, { recursive: true });
+    success('lib/ 폴더 생성');
+  } else {
+    info('lib/ 폴더가 이미 존재합니다');
+  }
+
+  const files = [
+    ['lib/client.ts', CLIENT_TS],
+    ['lib/server.ts', SERVER_TS],
+    ['lib/admin.ts',  ADMIN_TS],
+  ];
+
+  for (const [relPath, content] of files) {
+    const fullPath = path.join(cwd, relPath);
+    if (fs.existsSync(fullPath)) {
+      warn(`${relPath} 이미 존재 — 건너뜀`);
+    } else {
+      fs.writeFileSync(fullPath, content, 'utf8');
+      success(`${relPath} 생성`);
+    }
+  }
+
+  const envPath = path.join(cwd, '.env.local');
+  console.log('');
+  console.log(`${BOLD}📋 환경변수 설정${RESET}`);
+  console.log('──────────────────────────────────');
+
+  if (!fs.existsSync(envPath)) {
+    fs.writeFileSync(envPath, ENV_EXAMPLE, 'utf8');
+    success('.env.local 생성 — 아래 값을 채워주세요');
+  } else {
+    info('.env.local 이미 존재 — 아래 항목이 있는지 확인하세요');
+  }
+
+  console.log('');
+  console.log(`  ${CYAN}NEXT_PUBLIC_AURABASE_URL${RESET}=https://your-project.cloudfront.net`);
+  console.log(`  ${CYAN}NEXT_PUBLIC_AURABASE_ANON_KEY${RESET}=your-anon-key`);
+  console.log(`  ${CYAN}NEXT_PUBLIC_AURABASE_SERVICE_ROLE_KEY${RESET}=your-service-role-key`);
+  console.log('');
+  console.log(`  → AuraBase 대시보드 ${BOLD}API Keys${RESET} 메뉴에서 확인하세요.`);
+  console.log('');
+  console.log(`${GREEN}✔ 완료!${RESET} 이제 아래처럼 사용할 수 있습니다:`);
+  console.log('');
+  console.log(`  ${CYAN}// 클라이언트 컴포넌트${RESET}`);
+  console.log(`  import { client } from '@/lib/client'`);
+  console.log(`  const { data } = await client.from('todos').select('*')`);
+  console.log('');
+  console.log(`  ${CYAN}// 서버 전용 (API Route, Server Component)${RESET}`);
+  console.log(`  import { admin } from '@/lib/admin'`);
+  console.log(`  const { data } = await admin.from('todos').select('*')`);
+  console.log('');
+}
+
+// ─── 진입점 ────────────────────────────────────────────────────────────────────
+
+if (command === 'init') {
+  init();
+} else {
+  console.log('');
+  console.log(`${BOLD}aurabase-js CLI${RESET}`);
+  console.log('');
+  console.log('사용법:');
+  console.log(`  ${CYAN}npx aurabase-js init${RESET}   lib/ 폴더 및 환경변수 파일 자동 생성`);
+  console.log('');
+}

package/dist/index.js

@@ -30,6 +30,11 @@ module.exports = __toCommonJS(index_exports);
 var QueryBuilder = class {
   constructor(url, anonKey, accessToken, tableName, headers = {}) {
     this.isSingle = false;
+    this._method = "GET";
+    this._body = void 0;
+    this._isUpsert = false;
+    this._onConflict = void 0;
+    this._idValue = void 0;
     this.url = url;
     this.anonKey = anonKey;
     this.accessToken = accessToken;
@@ -44,94 +49,119 @@ var QueryBuilder = class {
    * .select('*')
    */
   select(columns = "*") {
-    this.queryParams.set("select", columns);
+    if (columns !== "*") this.queryParams.set("select", columns.replace(/\s/g, ""));
     return this;
   }
-  /**
-   * Filter by column equality
-   * @example
-   * .eq('id', 1)
-   * .eq('status', 'active')
-   */
   eq(column, value) {
-    this.queryParams.append(column, `eq.${value}`);
+    if (column === "id") this._idValue = value;
+    this.queryParams.append("eq", `${column}:${value}`);
     return this;
   }
   /**
    * Filter by column inequality
    */
   neq(column, value) {
-    this.queryParams.append(column, `neq.${value}`);
+    this.queryParams.append("neq", `${column}:${value}`);
     return this;
   }
   /**
    * Filter by greater than
    */
   gt(column, value) {
-    this.queryParams.append(column, `gt.${value}`);
+    this.queryParams.append("gt", `${column}:${value}`);
     return this;
   }
   /**
    * Filter by greater than or equal
    */
   gte(column, value) {
-    this.queryParams.append(column, `gte.${value}`);
+    this.queryParams.append("gte", `${column}:${value}`);
     return this;
   }
   /**
    * Filter by less than
    */
   lt(column, value) {
-    this.queryParams.append(column, `lt.${value}`);
+    this.queryParams.append("lt", `${column}:${value}`);
     return this;
   }
   /**
    * Filter by less than or equal
    */
   lte(column, value) {
-    this.queryParams.append(column, `lte.${value}`);
+    this.queryParams.append("lte", `${column}:${value}`);
     return this;
   }
   /**
    * Filter by like pattern
    */
   like(column, pattern) {
-    this.queryParams.append(column, `like.${pattern}`);
+    this.queryParams.append("like", `${column}:${pattern}`);
     return this;
   }
   /**
    * Filter by case-insensitive like pattern
    */
   ilike(column, pattern) {
-    this.queryParams.append(column, `ilike.${pattern}`);
+    this.queryParams.append("ilike", `${column}:${pattern}`);
     return this;
   }
   /**
    * Filter by array contains
    */
   contains(column, value) {
-    this.queryParams.append(column, `cs.{${value.join(",")}}`);
+    this.queryParams.append("contains", `${column}:${JSON.stringify(value)}`);
     return this;
   }
   /**
    * Filter by value in array
    */
   in(column, values) {
-    this.queryParams.append(column, `in.(${values.join(",")})`);
+    this.queryParams.append("in", `${column}:${values.join(",")}`);
     return this;
   }
   /**
    * Filter for null values
    */
   isNull(column) {
-    this.queryParams.append(column, "is.null");
+    this.queryParams.append("is_null", `${column}:true`);
     return this;
   }
   /**
    * Filter for non-null values
    */
   isNotNull(column) {
-    this.queryParams.append(column, "is.not.null");
+    this.queryParams.append("is_null", `${column}:false`);
+    return this;
+  }
+  /**
+   * Full-text search across all columns
+   */
+  search(query) {
+    this.queryParams.set("search", query);
+    return this;
+  }
+  /**
+   * Negate a filter
+   * @example .not('eq', 'category', 'Electronics')
+   */
+  not(operator, column, value) {
+    this.queryParams.append("not", `${operator}:${column}:${value}`);
+    return this;
+  }
+  /**
+   * OR conditions
+   * @example .or('category.eq.Electronics,price.lt.100000')
+   */
+  or(conditions) {
+    this.queryParams.set("or", conditions);
+    return this;
+  }
+  /**
+   * Filter by array contained by
+   */
+  containedBy(column, value) {
+    this.queryParams.append("contained_by", `${column}:${JSON.stringify(value)}`);
     return this;
   }
   /**
@@ -146,7 +176,8 @@ var QueryBuilder = class {
     if (nullsFirst !== void 0) {
       orderStr += nullsFirst ? ".nullsfirst" : ".nullslast";
     }
-    this.queryParams.append("order", orderStr);
+    const existing = this.queryParams.get("order");
+    this.queryParams.set("order", existing ? `${existing},${orderStr}` : orderStr);
     return this;
   }
   /**
@@ -194,28 +225,36 @@ var QueryBuilder = class {
       ...this.headers
     };
   }
-  async request(method, body) {
-    const queryString = this.queryParams.toString();
-    const fullUrl = `${this.url}/rest/v1/${this.tableName}${queryString ? `?${queryString}` : ""}`;
-    const options = {
-      method,
-      headers: this.getHeaders()
-    };
-    if (body && method !== "GET") {
-      options.body = JSON.stringify(body);
-      options.headers["Prefer"] = "return=representation";
+  buildUrl() {
+    const qs = this.queryParams.toString();
+    if (this._isUpsert) {
+      const conflict = this._onConflict ? `?on_conflict=${this._onConflict}` : "";
+      return `${this.url}/api/${this.tableName}/upsert${conflict}`;
+    }
+    if ((this._method === "PATCH" || this._method === "DELETE") && this._idValue !== void 0) {
+      return `${this.url}/api/${this.tableName}/${this._idValue}/`;
+    }
+    return `${this.url}/api/${this.tableName}/${qs ? `?${qs}` : ""}`;
+  }
+  async execute() {
+    const fullUrl = this.buildUrl();
+    const reqHeaders = this.getHeaders();
+    const options = { method: this._method, headers: reqHeaders };
+    if (this._body !== void 0 && this._method !== "GET") {
+      options.body = JSON.stringify(this._body);
+      reqHeaders["Prefer"] = "return=representation";
     }
     try {
       const response = await fetch(fullUrl, options);
+      const text = await response.text();
       let data = null;
       let error = null;
-      const text = await response.text();
       if (text) {
         try {
           const parsed = JSON.parse(text);
           if (!response.ok) {
             error = {
-              message: parsed.message || parsed.error || `HTTP ${response.status}`,
+              message: parsed.message || parsed.error || parsed.detail || `HTTP ${response.status}`,
               code: parsed.code,
               details: parsed.details
             };
@@ -223,69 +262,54 @@ var QueryBuilder = class {
             data = this.isSingle && Array.isArray(parsed) ? parsed[0] ?? null : parsed;
           }
         } catch {
-          if (!response.ok) {
-            error = {
-              message: text || `HTTP ${response.status}`
-            };
-          }
+          if (!response.ok) error = { message: text || `HTTP ${response.status}` };
         }
       }
-      return {
-        data,
-        error,
-        status: response.status,
-        statusText: response.statusText
-      };
+      return { data, error, status: response.status, statusText: response.statusText };
     } catch (err) {
       return {
         data: null,
-        error: {
-          message: err instanceof Error ? err.message : "Network error"
-        },
+        error: { message: err instanceof Error ? err.message : "Network error" },
         status: 0,
         statusText: "Network Error"
       };
     }
   }
-  /**
-   * Execute SELECT query
-   */
   async then(resolve, reject) {
     try {
-      const result = await this.request("GET");
+      const result = await this.execute();
       await resolve(result);
     } catch (err) {
-      if (reject) {
-        await reject(err);
-      }
+      if (reject) await reject(err);
     }
   }
-  /**
-   * Insert row(s)
-   */
-  async insert(row) {
+  // CUD — 모두 this 반환 → Supabase 스타일 체이닝 지원
+  // .insert({ title: '할일' })
+  insert(row) {
+    this._method = "POST";
     const rows = Array.isArray(row) ? row : [row];
-    return this.request("POST", rows.length === 1 ? rows[0] : rows);
+    this._body = rows.length === 1 ? rows[0] : rows;
+    return this;
   }
-  /**
-   * Update row(s)
-   */
-  async update(data) {
-    return this.request("PATCH", data);
+  // .update({ completed: true }).eq('id', 1)
+  update(data) {
+    this._method = "PATCH";
+    this._body = data;
+    return this;
   }
-  /**
-   * Upsert row(s)
-   */
-  async upsert(row) {
+  // .upsert({ id: 1, title: '수정됨' }, { onConflict: 'id' })
+  upsert(row, options = {}) {
+    this._method = "POST";
+    this._isUpsert = true;
+    this._onConflict = options.onConflict;
     const rows = Array.isArray(row) ? row : [row];
-    this.headers["Prefer"] = "resolution=merge-duplicates,return=representation";
-    return this.request("POST", rows.length === 1 ? rows[0] : rows);
+    this._body = rows.length === 1 ? rows[0] : rows;
+    return this;
   }
-  /**
-   * Delete row(s)
-   */
-  async delete() {
-    return this.request("DELETE");
+  // .delete().eq('id', 1)
+  delete() {
+    this._method = "DELETE";
+    return this;
   }
 };
 
@@ -585,7 +609,7 @@ var AuraBaseClient = class {
   async rpc(functionName, params) {
     const token = this.accessToken || this.anonKey;
     try {
-      const response = await fetch(`${this.url}/rpc/v1/${functionName}`, {
+      const response = await fetch(`${this.url}/api/${functionName}/`, {
         method: "POST",
         headers: {
           "Content-Type": "application/json",
@@ -759,6 +783,23 @@ var StorageBucket = class {
 
 // src/index.ts
 function createClient(options) {
+  if (!options.url) {
+    console.warn(
+      "[aurabase-js] NEXT_PUBLIC_AURABASE_URL이 설정되지 않았습니다.\n" +
+      ".env.local 파일에 다음 항목을 추가하세요:\n\n" +
+      "  NEXT_PUBLIC_AURABASE_URL=https://your-project.cloudfront.net\n" +
+      "  NEXT_PUBLIC_AURABASE_ANON_KEY=your-anon-key\n" +
+      "  NEXT_PUBLIC_AURABASE_SERVICE_ROLE_KEY=your-service-role-key\n"
+    );
+  }
+  if (!options.anonKey) {
+    console.warn(
+      "[aurabase-js] anonKey가 설정되지 않았습니다.\n" +
+      ".env.local 파일에 다음 항목을 추가하세요:\n\n" +
+      "  NEXT_PUBLIC_AURABASE_ANON_KEY=your-anon-key          (클라이언트용)\n" +
+      "  NEXT_PUBLIC_AURABASE_SERVICE_ROLE_KEY=your-service-role-key  (서버/admin용)\n"
+    );
+  }
   return new AuraBaseClient(options);
 }
 var index_default = createClient;