aurabase-js 0.2.0 → 0.2.1

package/.omc/state/hud-state.json

@@ -1,6 +1,6 @@
 {
-  "timestamp": "2026-03-09T12:13:53.326Z",
+  "timestamp": "2026-03-09T11:49:17.080Z",
   "backgroundTasks": [],
-  "sessionStartTimestamp": "2026-03-09T11:58:48.482Z",
-  "sessionId": "faa7b8297096020e"
+  "sessionStartTimestamp": "2026-03-09T11:37:51.558Z",
+  "sessionId": "a7635597b80deb9e"
 }

package/.omc/state/hud-stdin-cache.json

@@ -1 +1 @@
-{"session_id":"1c1e8df6-335a-4058-8bd4-4c0a67d996cd","transcript_path":"C:\\Users\\Jay\\.claude\\projects\\D--000-FrontEnd-242-dino-game\\1c1e8df6-335a-4058-8bd4-4c0a67d996cd.jsonl","cwd":"D:\\000.FrontEnd\\242.dino_game\\packages\\aurabase-js","model":{"id":"GLM-5","display_name":"GLM-5"},"workspace":{"current_dir":"D:\\000.FrontEnd\\242.dino_game\\packages\\aurabase-js","project_dir":"D:\\000.FrontEnd\\242.dino_game","added_dirs":[]},"version":"2.1.71","output_style":{"name":"default"},"cost":{"total_cost_usd":2.0622670000000003,"total_duration_ms":1138675,"total_api_duration_ms":541251,"total_lines_added":199,"total_lines_removed":15},"context_window":{"total_input_tokens":64548,"total_output_tokens":11199,"context_window_size":200000,"current_usage":{"input_tokens":169,"output_tokens":64,"cache_creation_input_tokens":0,"cache_read_input_tokens":70720},"used_percentage":35,"remaining_percentage":65},"exceeds_200k_tokens":false}
+{"session_id":"85311ae7-4e13-466c-9bb0-4bf05ada3ed1","transcript_path":"C:\\Users\\Jay\\.claude\\projects\\D--000-FrontEnd-242-dino-game\\85311ae7-4e13-466c-9bb0-4bf05ada3ed1.jsonl","cwd":"D:\\000.FrontEnd\\242.dino_game\\packages\\aurabase-js","model":{"id":"GLM-5","display_name":"GLM-5"},"workspace":{"current_dir":"D:\\000.FrontEnd\\242.dino_game\\packages\\aurabase-js","project_dir":"D:\\000.FrontEnd\\242.dino_game","added_dirs":[]},"version":"2.1.71","output_style":{"name":"default"},"cost":{"total_cost_usd":1.0113789999999998,"total_duration_ms":1112478,"total_api_duration_ms":476001,"total_lines_added":1354,"total_lines_removed":2},"context_window":{"total_input_tokens":32475,"total_output_tokens":11628,"context_window_size":200000,"current_usage":{"input_tokens":169,"output_tokens":104,"cache_creation_input_tokens":0,"cache_read_input_tokens":48768},"used_percentage":24,"remaining_percentage":76},"exceeds_200k_tokens":false}

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

@@ -1,132 +1,144 @@
 #!/usr/bin/env node
 "use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-
-// src/cli.ts
-var fs = __toESM(require("fs"));
-var path = __toESM(require("path"));
-var TEMPLATES = {
-  "lib/aurabase.ts": `import { createClient } from 'aurabase-js';
-
-const AURABASE_URL = process.env.NEXT_PUBLIC_AURABASE_URL || 'https://your-project.cloudfront.net';
-const AURABASE_ANON_KEY = process.env.NEXT_PUBLIC_AURABASE_ANON_KEY || '';
-
-export const aurabase = createClient({
-  url: AURABASE_URL,
-  anonKey: AURABASE_ANON_KEY,
-});
-`,
-  "lib/supabase.ts": `import { createClient } from 'aurabase-js';
 
-const AURABASE_URL = process.env.NEXT_PUBLIC_AURABASE_URL || 'https://your-project.cloudfront.net';
-const AURABASE_ANON_KEY = process.env.NEXT_PUBLIC_AURABASE_ANON_KEY || '';
+const fs = require('fs');
+const path = require('path');
 
-export const supabase = createClient({
-  url: AURABASE_URL,
-  anonKey: AURABASE_ANON_KEY,
-});
+const args = process.argv.slice(2);
+const command = args[0];
 
-// Alias for backward compatibility
-export const aurabase = supabase;
-`
-};
-var ENV_TEMPLATE = `
-# AuraBase Configuration
-# Add these to your .env.local file:
+const BOLD   = '\x1b[1m';
+const GREEN  = '\x1b[32m';
+const YELLOW = '\x1b[33m';
+const CYAN   = '\x1b[36m';
+const RESET  = '\x1b[0m';
 
-NEXT_PUBLIC_AURABASE_URL=https://your-project.cloudfront.net
-NEXT_PUBLIC_AURABASE_ANON_KEY=your-anon-key-here
+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 || '',
+});
 `;
-function findProjectRoot() {
-  let dir = process.cwd();
-  while (dir !== path.dirname(dir)) {
-    if (fs.existsSync(path.join(dir, "package.json"))) {
-      return dir;
-    }
-    dir = path.dirname(dir);
-  }
-  return process.cwd();
-}
-function init(filename = "lib/aurabase.ts") {
-  const projectRoot = findProjectRoot();
-  const filePath = path.join(projectRoot, filename);
-  const dir = path.dirname(filePath);
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true });
-  }
-  if (fs.existsSync(filePath)) {
-    console.log(`\x1B[33m\u26A0 ${filename} already exists. Skipping...\x1B[0m`);
-    return;
+
+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);
   }
-  const template = TEMPLATES[filename] || TEMPLATES["lib/aurabase.ts"];
-  fs.writeFileSync(filePath, template.trim() + "\n");
-  console.log(`\x1B[32m\u2713 Created ${filename}\x1B[0m`);
-  console.log("\x1B[36m%s\x1B[0m", ENV_TEMPLATE);
+
+  return client;
 }
-function showHelp() {
-  console.log(`
-\x1B[1mAuraBase JS CLI\x1B[0m
+`;
 
-\x1B[1mUsage:\x1B[0m
-  npx aurabase-js init [options]
+const ADMIN_TS = `import { createClient } from 'aurabase-js';
 
-\x1B[1mCommands:\x1B[0m
-  init              Create lib/aurabase.ts file
-  init --supabase   Create lib/supabase.ts file (alias name)
+/**
+ * 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 || '',
+});
+`;
 
-\x1B[1mOptions:\x1B[0m
-  -h, --help        Show this help message
-  -v, --version     Show version
+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
+`;
 
-\x1B[1mExamples:\x1B[0m
-  npx aurabase-js init
-  npx aurabase-js init --supabase
-`);
-}
-function showVersion() {
-  const pkgPath = path.join(__dirname, "..", "package.json");
-  const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
-  console.log(pkg.version);
-}
-function main() {
-  const args = process.argv.slice(2);
-  if (args.length === 0 || args.includes("-h") || args.includes("--help")) {
-    showHelp();
-    return;
+// ─── 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/ 폴더가 이미 존재합니다');
   }
-  if (args.includes("-v") || args.includes("--version")) {
-    showVersion();
-    return;
+
+  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} 생성`);
+    }
   }
-  if (args[0] === "init") {
-    const useSupabase = args.includes("--supabase");
-    const filename = useSupabase ? "lib/supabase.ts" : "lib/aurabase.ts";
-    init(filename);
-    return;
+
+  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(`\x1B[31mUnknown command: ${args[0]}\x1B[0m`);
-  showHelp();
-  process.exit(1);
+
+  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('');
 }
-main();