@gencow/core 0.1.3 → 0.1.5

package/dist/index.d.ts

@@ -4,7 +4,7 @@
  * Provides: query, mutation, storage, scheduler, auth
  * All with Convex-compatible DX patterns.
  */
-export type { GencowCtx, AuthCtx, UserIdentity, QueryDef, MutationDef, RealtimeCtx, HttpActionDef, HttpActionRequest, HttpActionResponse, HttpActionHandler } from "./reactive";
+export type { GencowCtx, AuthCtx, UserIdentity, QueryDef, MutationDef, RealtimeCtx, HttpActionDef, HttpActionRequest, HttpActionResponse, HttpActionHandler, AIContext, AIMessage, AIResult } from "./reactive";
 export { query, mutation, httpAction, invalidateQueries, buildRealtimeCtx, subscribe, unsubscribe, registerClient, deregisterClient, handleWsMessage, getQueryHandler, getQueryDef, getRegisteredQueries, getRegisteredMutations, getRegisteredHttpActions } from "./reactive";
 export type { Storage } from "./storage";
 export { createScheduler, getSchedulerInfo } from "./scheduler";

package/dist/reactive.d.ts

@@ -33,6 +33,29 @@ export interface RealtimeCtx {
  * Convex의 ctx 패턴과 동일하게, 이 객체를 통해서만 DB/Storage/Auth에 접근 가능.
  * fs, child_process 등 원시 Node.js API는 노출되지 않음.
  */
+export interface AIMessage {
+    role: "user" | "system" | "assistant";
+    content: string;
+}
+export interface AIResult {
+    text: string;
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    creditsCharged: number;
+    model: string;
+}
+export interface AIContext {
+    /** AI 텍스트 생성 — ctx.ai.chat({ model, messages }) */
+    chat: (opts: {
+        model?: string;
+        messages: AIMessage[];
+        temperature?: number;
+        maxTokens?: number;
+    }) => Promise<AIResult>;
+}
 export interface GencowCtx {
     /** Drizzle DB 인스턴스 — ctx.db.select().from(table) */
     db: any;
@@ -46,6 +69,8 @@ export interface GencowCtx {
     realtime: RealtimeCtx;
     /** 재시도 — ctx.retry(fn, opts) — exponential backoff + jitter */
     retry: <T>(fn: () => Promise<T>, options?: import("./retry").RetryOptions) => Promise<T>;
+    /** AI 헬퍼 — ctx.ai.chat({ model, messages }) — 로컬: 직접 호출, BaaS: Control Plane 프록시 */
+    ai?: AIContext;
 }
 type QueryHandler<TArgs = any, TReturn = any> = (ctx: GencowCtx, args: TArgs) => Promise<TReturn>;
 type MutationHandler<TArgs = any, TReturn = any> = (ctx: GencowCtx, args: TArgs) => Promise<TReturn>;

package/dist/storage.js

@@ -1,6 +1,16 @@
 import * as fs from "fs/promises";
 import * as path from "path";
 import * as crypto from "crypto";
+// ─── Constants ──────────────────────────────────────────
+/** 파일 업로드 최대 크기: 50MB (하드코딩 — 사용자가 오버라이드 불가) */
+const MAX_FILE_SIZE = 50 * 1024 * 1024;
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes}B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)}KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}
 // ─── Implementation ─────────────────────────────────────
 const metaStore = new Map();
 /**
@@ -16,6 +26,10 @@ export function createStorage(dir = "./uploads") {
     fs.mkdir(dir, { recursive: true }).catch(() => { });
     return {
         async store(file, filename) {
+            // 크기 제한 검증
+            if (file.size > MAX_FILE_SIZE) {
+                throw new Error(`File too large: ${formatBytes(file.size)} exceeds limit of ${formatBytes(MAX_FILE_SIZE)}`);
+            }
             const id = crypto.randomUUID();
             const name = filename || (file instanceof File ? file.name : `${id}.bin`);
             const filePath = path.join(dir, id);
@@ -33,6 +47,10 @@ export function createStorage(dir = "./uploads") {
         async storeBuffer(buffer, filename, type = "application/octet-stream") {
             const id = crypto.randomUUID();
             const filePath = path.join(dir, id);
+            // 크기 제한 검증
+            if (buffer.length > MAX_FILE_SIZE) {
+                throw new Error(`File too large: ${formatBytes(buffer.length)} exceeds limit of ${formatBytes(MAX_FILE_SIZE)}`);
+            }
             await fs.writeFile(filePath, buffer);
             metaStore.set(id, {
                 id,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gencow/core",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Gencow core library — defineQuery, defineMutation, reactive subscriptions",
   "type": "module",
   "main": "dist/index.js",

package/src/index.ts

@@ -5,7 +5,7 @@
  * All with Convex-compatible DX patterns.
  */
 
-export type { GencowCtx, AuthCtx, UserIdentity, QueryDef, MutationDef, RealtimeCtx, HttpActionDef, HttpActionRequest, HttpActionResponse, HttpActionHandler } from "./reactive";
+export type { GencowCtx, AuthCtx, UserIdentity, QueryDef, MutationDef, RealtimeCtx, HttpActionDef, HttpActionRequest, HttpActionResponse, HttpActionHandler, AIContext, AIMessage, AIResult } from "./reactive";
 export { query, mutation, httpAction, invalidateQueries, buildRealtimeCtx, subscribe, unsubscribe, registerClient, deregisterClient, handleWsMessage, getQueryHandler, getQueryDef, getRegisteredQueries, getRegisteredMutations, getRegisteredHttpActions } from "./reactive";
 export type { Storage } from "./storage";
 export { createScheduler, getSchedulerInfo } from "./scheduler";

package/src/reactive.ts

@@ -39,6 +39,30 @@ export interface RealtimeCtx {
  * Convex의 ctx 패턴과 동일하게, 이 객체를 통해서만 DB/Storage/Auth에 접근 가능.
  * fs, child_process 등 원시 Node.js API는 노출되지 않음.
  */
+// ─── AI Context ─────────────────────────────────────────
+
+export interface AIMessage {
+    role: "user" | "system" | "assistant";
+    content: string;
+}
+
+export interface AIResult {
+    text: string;
+    usage: { promptTokens: number; completionTokens: number; totalTokens: number };
+    creditsCharged: number;
+    model: string;
+}
+
+export interface AIContext {
+    /** AI 텍스트 생성 — ctx.ai.chat({ model, messages }) */
+    chat: (opts: {
+        model?: string;
+        messages: AIMessage[];
+        temperature?: number;
+        maxTokens?: number;
+    }) => Promise<AIResult>;
+}
+
 export interface GencowCtx {
     /** Drizzle DB 인스턴스 — ctx.db.select().from(table) */
     db: any; // typed per-app via generic
@@ -52,6 +76,8 @@ export interface GencowCtx {
     realtime: RealtimeCtx;
     /** 재시도 — ctx.retry(fn, opts) — exponential backoff + jitter */
     retry: <T>(fn: () => Promise<T>, options?: import("./retry").RetryOptions) => Promise<T>;
+    /** AI 헬퍼 — ctx.ai.chat({ model, messages }) — 로컬: 직접 호출, BaaS: Control Plane 프록시 */
+    ai?: AIContext;
 }
 
 // ─── Types ──────────────────────────────────────────────

package/src/storage.ts

@@ -2,6 +2,17 @@ import * as fs from "fs/promises";
 import * as path from "path";
 import * as crypto from "crypto";
 
+// ─── Constants ──────────────────────────────────────────
+
+/** 파일 업로드 최대 크기: 50MB (하드코딩 — 사용자가 오버라이드 불가) */
+const MAX_FILE_SIZE = 50 * 1024 * 1024;
+
+function formatBytes(bytes: number): string {
+    if (bytes < 1024) return `${bytes}B`;
+    if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}
+
 // ─── Types ──────────────────────────────────────────────
 
 interface StorageFile {
@@ -43,6 +54,13 @@ export function createStorage(dir: string = "./uploads"): Storage {
 
     return {
         async store(file: File | Blob, filename?: string): Promise<string> {
+            // 크기 제한 검증
+            if (file.size > MAX_FILE_SIZE) {
+                throw new Error(
+                    `File too large: ${formatBytes(file.size)} exceeds limit of ${formatBytes(MAX_FILE_SIZE)}`
+                );
+            }
+
             const id = crypto.randomUUID();
             const name = filename || (file instanceof File ? file.name : `${id}.bin`);
             const filePath = path.join(dir, id);
@@ -69,6 +87,13 @@ export function createStorage(dir: string = "./uploads"): Storage {
             const id = crypto.randomUUID();
             const filePath = path.join(dir, id);
 
+            // 크기 제한 검증
+            if (buffer.length > MAX_FILE_SIZE) {
+                throw new Error(
+                    `File too large: ${formatBytes(buffer.length)} exceeds limit of ${formatBytes(MAX_FILE_SIZE)}`
+                );
+            }
+
             await fs.writeFile(filePath, buffer);
 
             metaStore.set(id, {