@coduckai/sdk 0.1.0

package/dist/client/index.js

@@ -0,0 +1,57 @@
+import axios from 'axios';
+
+// src/client/index.ts
+var TOKEN_KEY = "token";
+function setToken(token) {
+  if (typeof localStorage !== "undefined") {
+    localStorage.setItem(TOKEN_KEY, token);
+  }
+}
+function getToken() {
+  if (typeof localStorage !== "undefined") {
+    return localStorage.getItem(TOKEN_KEY);
+  }
+  return null;
+}
+function clearToken() {
+  if (typeof localStorage !== "undefined") {
+    localStorage.removeItem(TOKEN_KEY);
+  }
+}
+function isAuthenticated() {
+  return !!getToken();
+}
+function getBaseUrl() {
+  if (typeof import.meta !== "undefined" && import.meta.env?.VITE_API_URL) {
+    return import.meta.env.VITE_API_URL;
+  }
+  return "/api";
+}
+var api = axios.create({
+  baseURL: getBaseUrl(),
+  headers: { "Content-Type": "application/json" }
+});
+api.interceptors.request.use((config) => {
+  const token = getToken();
+  if (token) {
+    config.headers.Authorization = `Bearer ${token}`;
+  }
+  return config;
+});
+api.interceptors.response.use(
+  (response) => response,
+  (error) => {
+    if (error.response?.status === 401) {
+      clearToken();
+      if (typeof window !== "undefined") {
+        window.location.href = "/login";
+      }
+    }
+    return Promise.reject(error);
+  }
+);
+var client_default = api;
+
+export { clearToken, client_default as default, getToken, isAuthenticated, setToken };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/client/index.ts"],"names":[],"mappings":";;;AAeA,IAAM,SAAA,GAAY,OAAA;AAEX,SAAS,SAAS,KAAA,EAAqB;AAC5C,EAAA,IAAI,OAAO,iBAAiB,WAAA,EAAa;AACvC,IAAA,YAAA,CAAa,OAAA,CAAQ,WAAW,KAAK,CAAA;AAAA,EACvC;AACF;AAEO,SAAS,QAAA,GAA0B;AACxC,EAAA,IAAI,OAAO,iBAAiB,WAAA,EAAa;AACvC,IAAA,OAAO,YAAA,CAAa,QAAQ,SAAS,CAAA;AAAA,EACvC;AACA,EAAA,OAAO,IAAA;AACT;AAEO,SAAS,UAAA,GAAmB;AACjC,EAAA,IAAI,OAAO,iBAAiB,WAAA,EAAa;AACvC,IAAA,YAAA,CAAa,WAAW,SAAS,CAAA;AAAA,EACnC;AACF;AAEO,SAAS,eAAA,GAA2B;AACzC,EAAA,OAAO,CAAC,CAAC,QAAA,EAAS;AACpB;AAIA,SAAS,UAAA,GAAqB;AAE5B,EAAA,IAAI,OAAO,MAAA,CAAA,IAAA,KAAgB,WAAA,IAAgB,MAAA,CAAA,IAAA,CAAoB,KAAK,YAAA,EAAc;AAChF,IAAA,OAAQ,YAAoB,GAAA,CAAI,YAAA;AAAA,EAClC;AAEA,EAAA,OAAO,MAAA;AACT;AAEA,IAAM,GAAA,GAAqB,MAAM,MAAA,CAAO;AAAA,EACtC,SAAS,UAAA,EAAW;AAAA,EACpB,OAAA,EAAS,EAAE,cAAA,EAAgB,kBAAA;AAC7B,CAAC,CAAA;AAGD,GAAA,CAAI,YAAA,CAAa,OAAA,CAAQ,GAAA,CAAI,CAAC,MAAA,KAAW;AACvC,EAAA,MAAM,QAAQ,QAAA,EAAS;AACvB,EAAA,IAAI,KAAA,EAAO;AACT,IAAA,MAAA,CAAO,OAAA,CAAQ,aAAA,GAAgB,CAAA,OAAA,EAAU,KAAK,CAAA,CAAA;AAAA,EAChD;AACA,EAAA,OAAO,MAAA;AACT,CAAC,CAAA;AAGD,GAAA,CAAI,aAAa,QAAA,CAAS,GAAA;AAAA,EACxB,CAAC,QAAA,KAAa,QAAA;AAAA,EACd,CAAC,KAAA,KAAU;AACT,IAAA,IAAI,KAAA,CAAM,QAAA,EAAU,MAAA,KAAW,GAAA,EAAK;AAClC,MAAA,UAAA,EAAW;AACX,MAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AACjC,QAAA,MAAA,CAAO,SAAS,IAAA,GAAO,QAAA;AAAA,MACzB;AAAA,IACF;AACA,IAAA,OAAO,OAAA,CAAQ,OAAO,KAAK,CAAA;AAAA,EAC7B;AACF,CAAA;AAEA,IAAO,cAAA,GAAQ","file":"index.js","sourcesContent":["/**\n * @coduckai/sdk/client — Frontend API Client (browser-only)\n *\n * Pre-configured Axios instance with auth interceptor.\n *\n * Usage:\n *   import api, { setToken, clearToken } from '@coduckai/sdk/client';\n *   const { data } = await api.get('/recipes');\n *   setToken(loginData.token);\n */\n\nimport axios, { type AxiosInstance } from 'axios';\n\n// ── Token Management ───────────────────────────────────\n\nconst TOKEN_KEY = 'token';\n\nexport function setToken(token: string): void {\n  if (typeof localStorage !== 'undefined') {\n    localStorage.setItem(TOKEN_KEY, token);\n  }\n}\n\nexport function getToken(): string | null {\n  if (typeof localStorage !== 'undefined') {\n    return localStorage.getItem(TOKEN_KEY);\n  }\n  return null;\n}\n\nexport function clearToken(): void {\n  if (typeof localStorage !== 'undefined') {\n    localStorage.removeItem(TOKEN_KEY);\n  }\n}\n\nexport function isAuthenticated(): boolean {\n  return !!getToken();\n}\n\n// ── Axios Instance ─────────────────────────────────────\n\nfunction getBaseUrl(): string {\n  // Vite: VITE_API_URL\n  if (typeof import.meta !== 'undefined' && (import.meta as any).env?.VITE_API_URL) {\n    return (import.meta as any).env.VITE_API_URL;\n  }\n  // Fallback: relative /api\n  return '/api';\n}\n\nconst api: AxiosInstance = axios.create({\n  baseURL: getBaseUrl(),\n  headers: { 'Content-Type': 'application/json' },\n});\n\n// Request interceptor — attach Bearer token\napi.interceptors.request.use((config) => {\n  const token = getToken();\n  if (token) {\n    config.headers.Authorization = `Bearer ${token}`;\n  }\n  return config;\n});\n\n// Response interceptor — handle 401\napi.interceptors.response.use(\n  (response) => response,\n  (error) => {\n    if (error.response?.status === 401) {\n      clearToken();\n      if (typeof window !== 'undefined') {\n        window.location.href = '/login';\n      }\n    }\n    return Promise.reject(error);\n  }\n);\n\nexport default api;\n"]}

package/dist/db/index.cjs

@@ -0,0 +1,126 @@
+'use strict';
+
+var pg = require('pg');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var pg__default = /*#__PURE__*/_interopDefault(pg);
+
+// src/internal/env.ts
+function getEnv(key, fallback) {
+  return process.env[key] || fallback;
+}
+function isServer() {
+  return typeof window === "undefined";
+}
+function assertServer(moduleName) {
+  if (!isServer()) {
+    throw new Error(
+      `@coduckai/sdk/${moduleName} is server-only. Use @coduckai/sdk/client for browser code.`
+    );
+  }
+}
+
+// src/internal/config.ts
+var globalConfig = {};
+function getConfig() {
+  return globalConfig;
+}
+assertServer("db");
+var { Pool } = pg__default.default;
+var pool = null;
+function getPool() {
+  if (!pool) {
+    const config = getConfig();
+    const connectionString = config.db?.connectionString || getEnv("DATABASE_URL");
+    if (!connectionString) {
+      throw new Error("@coduckai/sdk/db: DATABASE_URL environment variable is required");
+    }
+    pool = new Pool({ connectionString });
+  }
+  return pool;
+}
+var db = {
+  /**
+   * Run a query, returns all rows
+   */
+  async query(sql, params) {
+    const result = await getPool().query(sql, params);
+    return result.rows;
+  },
+  /**
+   * Run a query, returns the first row or null
+   */
+  async queryOne(sql, params) {
+    const result = await getPool().query(sql, params);
+    return result.rows[0] || null;
+  },
+  /**
+   * Run a query that doesn't return rows (INSERT/UPDATE/DELETE)
+   */
+  async execute(sql, params) {
+    const result = await getPool().query(sql, params);
+    return { rowCount: result.rowCount ?? 0 };
+  },
+  /**
+   * Paginated query — automatically appends LIMIT/OFFSET and runs COUNT
+   */
+  async paginate(sql, params, options) {
+    const { page, pageSize } = options;
+    const offset = (page - 1) * pageSize;
+    const countSql = `SELECT COUNT(*) as total FROM (${sql}) AS _count_query`;
+    const countResult = await getPool().query(countSql, params);
+    const total = parseInt(countResult.rows[0].total, 10);
+    const dataSql = `${sql} LIMIT $${params.length + 1} OFFSET $${params.length + 2}`;
+    const dataResult = await getPool().query(dataSql, [...params, pageSize, offset]);
+    return {
+      data: dataResult.rows,
+      total,
+      page,
+      pageSize,
+      totalPages: Math.ceil(total / pageSize)
+    };
+  },
+  /**
+   * Run multiple queries in a transaction. Auto-commits on success, rolls back on error.
+   */
+  async transaction(fn) {
+    const client = await getPool().connect();
+    try {
+      await client.query("BEGIN");
+      const txClient = createTransactionClient(client);
+      const result = await fn(txClient);
+      await client.query("COMMIT");
+      return result;
+    } catch (error) {
+      await client.query("ROLLBACK");
+      throw error;
+    } finally {
+      client.release();
+    }
+  },
+  /**
+   * Get the underlying pg Pool (escape hatch)
+   */
+  getPool
+};
+function createTransactionClient(client) {
+  return {
+    async query(sql, params) {
+      const result = await client.query(sql, params);
+      return result.rows;
+    },
+    async queryOne(sql, params) {
+      const result = await client.query(sql, params);
+      return result.rows[0] || null;
+    },
+    async execute(sql, params) {
+      const result = await client.query(sql, params);
+      return { rowCount: result.rowCount ?? 0 };
+    }
+  };
+}
+
+exports.db = db;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/db/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internal/env.ts","../../src/internal/config.ts","../../src/db/index.ts"],"names":["pg"],"mappings":";;;;;;;;;AAIO,SAAS,MAAA,CAAO,KAAa,QAAA,EAAuC;AACzE,EAAA,OAAO,OAAA,CAAQ,GAAA,CAAI,GAAG,CAAA,IAAK,QAAA;AAC7B;AAUO,SAAS,QAAA,GAAoB;AAClC,EAAA,OAAO,OAAO,MAAA,KAAW,WAAA;AAC3B;AAEO,SAAS,aAAa,UAAA,EAA0B;AACrD,EAAA,IAAI,CAAC,UAAS,EAAG;AACf,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,iBAAiB,UAAU,CAAA,2DAAA;AAAA,KAC7B;AAAA,EACF;AACF;;;ACJA,IAAI,eAA0B,EAAC;AAMxB,SAAS,SAAA,GAAuB;AACrC,EAAA,OAAO,YAAA;AACT;AChBA,YAAA,CAAa,IAAI,CAAA;AAGjB,IAAM,EAAE,MAAK,GAAIA,mBAAA;AAoBjB,IAAI,IAAA,GAAuB,IAAA;AAE3B,SAAS,OAAA,GAAmB;AAC1B,EAAA,IAAI,CAAC,IAAA,EAAM;AACT,IAAA,MAAM,SAAS,SAAA,EAAU;AACzB,IAAA,MAAM,gBAAA,GAAmB,MAAA,CAAO,EAAA,EAAI,gBAAA,IAAoB,OAAO,cAAc,CAAA;AAC7E,IAAA,IAAI,CAAC,gBAAA,EAAkB;AACrB,MAAA,MAAM,IAAI,MAAM,iEAAiE,CAAA;AAAA,IACnF;AACA,IAAA,IAAA,GAAO,IAAI,IAAA,CAAK,EAAE,gBAAA,EAAkB,CAAA;AAAA,EACtC;AACA,EAAA,OAAO,IAAA;AACT;AAIO,IAAM,EAAA,GAAK;AAAA;AAAA;AAAA;AAAA,EAIhB,MAAM,KAAA,CACJ,GAAA,EACA,MAAA,EACc;AACd,IAAA,MAAM,SAAS,MAAM,OAAA,EAAQ,CAAE,KAAA,CAAS,KAAK,MAAM,CAAA;AACnD,IAAA,OAAO,MAAA,CAAO,IAAA;AAAA,EAChB,CAAA;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,QAAA,CACJ,GAAA,EACA,MAAA,EACmB;AACnB,IAAA,MAAM,SAAS,MAAM,OAAA,EAAQ,CAAE,KAAA,CAAS,KAAK,MAAM,CAAA;AACnD,IAAA,OAAO,MAAA,CAAO,IAAA,CAAK,CAAC,CAAA,IAAK,IAAA;AAAA,EAC3B,CAAA;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,OAAA,CACJ,GAAA,EACA,MAAA,EAC+B;AAC/B,IAAA,MAAM,SAAS,MAAM,OAAA,EAAQ,CAAE,KAAA,CAAM,KAAK,MAAM,CAAA;AAChD,IAAA,OAAO,EAAE,QAAA,EAAU,MAAA,CAAO,QAAA,IAAY,CAAA,EAAE;AAAA,EAC1C,CAAA;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,QAAA,CACJ,GAAA,EACA,MAAA,EACA,OAAA,EAC6B;AAC7B,IAAA,MAAM,EAAE,IAAA,EAAM,QAAA,EAAS,GAAI,OAAA;AAC3B,IAAA,MAAM,MAAA,GAAA,CAAU,OAAO,CAAA,IAAK,QAAA;AAG5B,IAAA,MAAM,QAAA,GAAW,kCAAkC,GAAG,CAAA,iBAAA,CAAA;AACtD,IAAA,MAAM,cAAc,MAAM,OAAA,EAAQ,CAAE,KAAA,CAAM,UAAU,MAAM,CAAA;AAC1D,IAAA,MAAM,QAAQ,QAAA,CAAS,WAAA,CAAY,KAAK,CAAC,CAAA,CAAE,OAAO,EAAE,CAAA;AAGpD,IAAA,MAAM,OAAA,GAAU,CAAA,EAAG,GAAG,CAAA,QAAA,EAAW,MAAA,CAAO,SAAS,CAAC,CAAA,SAAA,EAAY,MAAA,CAAO,MAAA,GAAS,CAAC,CAAA,CAAA;AAC/E,IAAA,MAAM,UAAA,GAAa,MAAM,OAAA,EAAQ,CAAE,KAAA,CAAS,OAAA,EAAS,CAAC,GAAG,MAAA,EAAQ,QAAA,EAAU,MAAM,CAAC,CAAA;AAElF,IAAA,OAAO;AAAA,MACL,MAAM,UAAA,CAAW,IAAA;AAAA,MACjB,KAAA;AAAA,MACA,IAAA;AAAA,MACA,QAAA;AAAA,MACA,UAAA,EAAY,IAAA,CAAK,IAAA,CAAK,KAAA,GAAQ,QAAQ;AAAA,KACxC;AAAA,EACF,CAAA;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,YAAe,EAAA,EAAuD;AAC1E,IAAA,MAAM,MAAA,GAAS,MAAM,OAAA,EAAQ,CAAE,OAAA,EAAQ;AACvC,IAAA,IAAI;AACF,MAAA,MAAM,MAAA,CAAO,MAAM,OAAO,CAAA;AAC1B,MAAA,MAAM,QAAA,GAAW,wBAAwB,MAAM,CAAA;AAC/C,MAAA,MAAM,MAAA,GAAS,MAAM,EAAA,CAAG,QAAQ,CAAA;AAChC,MAAA,MAAM,MAAA,CAAO,MAAM,QAAQ,CAAA;AAC3B,MAAA,OAAO,MAAA;AAAA,IACT,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,MAAA,CAAO,MAAM,UAAU,CAAA;AAC7B,MAAA,MAAM,KAAA;AAAA,IACR,CAAA,SAAE;AACA,MAAA,MAAA,CAAO,OAAA,EAAQ;AAAA,IACjB;AAAA,EACF,CAAA;AAAA;AAAA;AAAA;AAAA,EAKA;AACF;AAUA,SAAS,wBAAwB,MAAA,EAAuC;AACtE,EAAA,OAAO;AAAA,IACL,MAAM,KAAA,CAAiD,GAAA,EAAa,MAAA,EAAkC;AACpG,MAAA,MAAM,MAAA,GAAS,MAAM,MAAA,CAAO,KAAA,CAAS,KAAK,MAAM,CAAA;AAChD,MAAA,OAAO,MAAA,CAAO,IAAA;AAAA,IAChB,CAAA;AAAA,IACA,MAAM,QAAA,CAAoD,GAAA,EAAa,MAAA,EAAuC;AAC5G,MAAA,MAAM,MAAA,GAAS,MAAM,MAAA,CAAO,KAAA,CAAS,KAAK,MAAM,CAAA;AAChD,MAAA,OAAO,MAAA,CAAO,IAAA,CAAK,CAAC,CAAA,IAAK,IAAA;AAAA,IAC3B,CAAA;AAAA,IACA,MAAM,OAAA,CAAQ,GAAA,EAAa,MAAA,EAAmD;AAC5E,MAAA,MAAM,MAAA,GAAS,MAAM,MAAA,CAAO,KAAA,CAAM,KAAK,MAAM,CAAA;AAC7C,MAAA,OAAO,EAAE,QAAA,EAAU,MAAA,CAAO,QAAA,IAAY,CAAA,EAAE;AAAA,IAC1C;AAAA,GACF;AACF","file":"index.cjs","sourcesContent":["/**\n * Environment variable helpers\n */\n\nexport function getEnv(key: string, fallback?: string): string | undefined {\n  return process.env[key] || fallback;\n}\n\nexport function requireEnv(key: string): string {\n  const val = process.env[key];\n  if (!val) {\n    throw new Error(`@coduckai/sdk: Missing required environment variable: ${key}`);\n  }\n  return val;\n}\n\nexport function isServer(): boolean {\n  return typeof window === 'undefined';\n}\n\nexport function assertServer(moduleName: string): void {\n  if (!isServer()) {\n    throw new Error(\n      `@coduckai/sdk/${moduleName} is server-only. Use @coduckai/sdk/client for browser code.`\n    );\n  }\n}\n","/**\n * Global SDK configuration\n *\n * CoDuck apps use env vars automatically — no configure() needed.\n * Standalone usage can call configure() to override.\n */\n\nexport interface SDKConfig {\n  auth?: {\n    jwtSecret?: string;\n    jwtExpiresIn?: string;\n    bcryptRounds?: number;\n  };\n  db?: {\n    connectionString?: string;\n  };\n  client?: {\n    baseUrl?: string;\n    tokenKey?: string;\n  };\n}\n\nlet globalConfig: SDKConfig = {};\n\nexport function setConfig(config: SDKConfig): void {\n  globalConfig = { ...globalConfig, ...config };\n}\n\nexport function getConfig(): SDKConfig {\n  return globalConfig;\n}\n","/**\n * @coduckai/sdk/db — Database module (server-only)\n *\n * Wraps pg Pool. Returns rows directly, adds pagination and transactions.\n *\n * Usage:\n *   import { db } from '@coduckai/sdk/db';\n *   const users = await db.query('SELECT * FROM users WHERE active = $1', [true]);\n *   const user = await db.queryOne('SELECT * FROM users WHERE id = $1', [id]);\n */\n\nimport { assertServer, getEnv } from '../internal/env';\nimport { getConfig } from '../internal/config';\n\nassertServer('db');\n\nimport pg from 'pg';\nconst { Pool } = pg;\nimport type { PoolClient, QueryResultRow } from 'pg';\n\n// ── Types ──────────────────────────────────────────────\n\nexport interface PaginationOptions {\n  page: number;\n  pageSize: number;\n}\n\nexport interface PaginatedResult<T> {\n  data: T[];\n  total: number;\n  page: number;\n  pageSize: number;\n  totalPages: number;\n}\n\n// ── Pool (lazy singleton) ──────────────────────────────\n\nlet pool: pg.Pool | null = null;\n\nfunction getPool(): pg.Pool {\n  if (!pool) {\n    const config = getConfig();\n    const connectionString = config.db?.connectionString || getEnv('DATABASE_URL');\n    if (!connectionString) {\n      throw new Error('@coduckai/sdk/db: DATABASE_URL environment variable is required');\n    }\n    pool = new Pool({ connectionString });\n  }\n  return pool;\n}\n\n// ── DB API ─────────────────────────────────────────────\n\nexport const db = {\n  /**\n   * Run a query, returns all rows\n   */\n  async query<T extends QueryResultRow = QueryResultRow>(\n    sql: string,\n    params?: unknown[]\n  ): Promise<T[]> {\n    const result = await getPool().query<T>(sql, params);\n    return result.rows;\n  },\n\n  /**\n   * Run a query, returns the first row or null\n   */\n  async queryOne<T extends QueryResultRow = QueryResultRow>(\n    sql: string,\n    params?: unknown[]\n  ): Promise<T | null> {\n    const result = await getPool().query<T>(sql, params);\n    return result.rows[0] || null;\n  },\n\n  /**\n   * Run a query that doesn't return rows (INSERT/UPDATE/DELETE)\n   */\n  async execute(\n    sql: string,\n    params?: unknown[]\n  ): Promise<{ rowCount: number }> {\n    const result = await getPool().query(sql, params);\n    return { rowCount: result.rowCount ?? 0 };\n  },\n\n  /**\n   * Paginated query — automatically appends LIMIT/OFFSET and runs COUNT\n   */\n  async paginate<T extends QueryResultRow = QueryResultRow>(\n    sql: string,\n    params: unknown[],\n    options: PaginationOptions\n  ): Promise<PaginatedResult<T>> {\n    const { page, pageSize } = options;\n    const offset = (page - 1) * pageSize;\n\n    // Count query — wrap the user's SQL\n    const countSql = `SELECT COUNT(*) as total FROM (${sql}) AS _count_query`;\n    const countResult = await getPool().query(countSql, params);\n    const total = parseInt(countResult.rows[0].total, 10);\n\n    // Data query — append LIMIT/OFFSET\n    const dataSql = `${sql} LIMIT $${params.length + 1} OFFSET $${params.length + 2}`;\n    const dataResult = await getPool().query<T>(dataSql, [...params, pageSize, offset]);\n\n    return {\n      data: dataResult.rows,\n      total,\n      page,\n      pageSize,\n      totalPages: Math.ceil(total / pageSize),\n    };\n  },\n\n  /**\n   * Run multiple queries in a transaction. Auto-commits on success, rolls back on error.\n   */\n  async transaction<T>(fn: (tx: TransactionClient) => Promise<T>): Promise<T> {\n    const client = await getPool().connect();\n    try {\n      await client.query('BEGIN');\n      const txClient = createTransactionClient(client);\n      const result = await fn(txClient);\n      await client.query('COMMIT');\n      return result;\n    } catch (error) {\n      await client.query('ROLLBACK');\n      throw error;\n    } finally {\n      client.release();\n    }\n  },\n\n  /**\n   * Get the underlying pg Pool (escape hatch)\n   */\n  getPool,\n};\n\n// ── Transaction Client ─────────────────────────────────\n\nexport interface TransactionClient {\n  query<T extends QueryResultRow = QueryResultRow>(sql: string, params?: unknown[]): Promise<T[]>;\n  queryOne<T extends QueryResultRow = QueryResultRow>(sql: string, params?: unknown[]): Promise<T | null>;\n  execute(sql: string, params?: unknown[]): Promise<{ rowCount: number }>;\n}\n\nfunction createTransactionClient(client: PoolClient): TransactionClient {\n  return {\n    async query<T extends QueryResultRow = QueryResultRow>(sql: string, params?: unknown[]): Promise<T[]> {\n      const result = await client.query<T>(sql, params);\n      return result.rows;\n    },\n    async queryOne<T extends QueryResultRow = QueryResultRow>(sql: string, params?: unknown[]): Promise<T | null> {\n      const result = await client.query<T>(sql, params);\n      return result.rows[0] || null;\n    },\n    async execute(sql: string, params?: unknown[]): Promise<{ rowCount: number }> {\n      const result = await client.query(sql, params);\n      return { rowCount: result.rowCount ?? 0 };\n    },\n  };\n}\n"]}

package/dist/db/index.d.cts

@@ -0,0 +1,62 @@
+import pg, { QueryResultRow } from 'pg';
+
+/**
+ * @coduckai/sdk/db — Database module (server-only)
+ *
+ * Wraps pg Pool. Returns rows directly, adds pagination and transactions.
+ *
+ * Usage:
+ *   import { db } from '@coduckai/sdk/db';
+ *   const users = await db.query('SELECT * FROM users WHERE active = $1', [true]);
+ *   const user = await db.queryOne('SELECT * FROM users WHERE id = $1', [id]);
+ */
+
+interface PaginationOptions {
+    page: number;
+    pageSize: number;
+}
+interface PaginatedResult<T> {
+    data: T[];
+    total: number;
+    page: number;
+    pageSize: number;
+    totalPages: number;
+}
+declare function getPool(): pg.Pool;
+declare const db: {
+    /**
+     * Run a query, returns all rows
+     */
+    query<T extends QueryResultRow = QueryResultRow>(sql: string, params?: unknown[]): Promise<T[]>;
+    /**
+     * Run a query, returns the first row or null
+     */
+    queryOne<T extends QueryResultRow = QueryResultRow>(sql: string, params?: unknown[]): Promise<T | null>;
+    /**
+     * Run a query that doesn't return rows (INSERT/UPDATE/DELETE)
+     */
+    execute(sql: string, params?: unknown[]): Promise<{
+        rowCount: number;
+    }>;
+    /**
+     * Paginated query — automatically appends LIMIT/OFFSET and runs COUNT
+     */
+    paginate<T extends QueryResultRow = QueryResultRow>(sql: string, params: unknown[], options: PaginationOptions): Promise<PaginatedResult<T>>;
+    /**
+     * Run multiple queries in a transaction. Auto-commits on success, rolls back on error.
+     */
+    transaction<T>(fn: (tx: TransactionClient) => Promise<T>): Promise<T>;
+    /**
+     * Get the underlying pg Pool (escape hatch)
+     */
+    getPool: typeof getPool;
+};
+interface TransactionClient {
+    query<T extends QueryResultRow = QueryResultRow>(sql: string, params?: unknown[]): Promise<T[]>;
+    queryOne<T extends QueryResultRow = QueryResultRow>(sql: string, params?: unknown[]): Promise<T | null>;
+    execute(sql: string, params?: unknown[]): Promise<{
+        rowCount: number;
+    }>;
+}
+
+export { type PaginatedResult, type PaginationOptions, type TransactionClient, db };

package/dist/db/index.d.ts

@@ -0,0 +1,62 @@
+import pg, { QueryResultRow } from 'pg';
+
+/**
+ * @coduckai/sdk/db — Database module (server-only)
+ *
+ * Wraps pg Pool. Returns rows directly, adds pagination and transactions.
+ *
+ * Usage:
+ *   import { db } from '@coduckai/sdk/db';
+ *   const users = await db.query('SELECT * FROM users WHERE active = $1', [true]);
+ *   const user = await db.queryOne('SELECT * FROM users WHERE id = $1', [id]);
+ */
+
+interface PaginationOptions {
+    page: number;
+    pageSize: number;
+}
+interface PaginatedResult<T> {
+    data: T[];
+    total: number;
+    page: number;
+    pageSize: number;
+    totalPages: number;
+}
+declare function getPool(): pg.Pool;
+declare const db: {
+    /**
+     * Run a query, returns all rows
+     */
+    query<T extends QueryResultRow = QueryResultRow>(sql: string, params?: unknown[]): Promise<T[]>;
+    /**
+     * Run a query, returns the first row or null
+     */
+    queryOne<T extends QueryResultRow = QueryResultRow>(sql: string, params?: unknown[]): Promise<T | null>;
+    /**
+     * Run a query that doesn't return rows (INSERT/UPDATE/DELETE)
+     */
+    execute(sql: string, params?: unknown[]): Promise<{
+        rowCount: number;
+    }>;
+    /**
+     * Paginated query — automatically appends LIMIT/OFFSET and runs COUNT
+     */
+    paginate<T extends QueryResultRow = QueryResultRow>(sql: string, params: unknown[], options: PaginationOptions): Promise<PaginatedResult<T>>;
+    /**
+     * Run multiple queries in a transaction. Auto-commits on success, rolls back on error.
+     */
+    transaction<T>(fn: (tx: TransactionClient) => Promise<T>): Promise<T>;
+    /**
+     * Get the underlying pg Pool (escape hatch)
+     */
+    getPool: typeof getPool;
+};
+interface TransactionClient {
+    query<T extends QueryResultRow = QueryResultRow>(sql: string, params?: unknown[]): Promise<T[]>;
+    queryOne<T extends QueryResultRow = QueryResultRow>(sql: string, params?: unknown[]): Promise<T | null>;
+    execute(sql: string, params?: unknown[]): Promise<{
+        rowCount: number;
+    }>;
+}
+
+export { type PaginatedResult, type PaginationOptions, type TransactionClient, db };

package/dist/db/index.js

@@ -0,0 +1,120 @@
+import pg from 'pg';
+
+// src/internal/env.ts
+function getEnv(key, fallback) {
+  return process.env[key] || fallback;
+}
+function isServer() {
+  return typeof window === "undefined";
+}
+function assertServer(moduleName) {
+  if (!isServer()) {
+    throw new Error(
+      `@coduckai/sdk/${moduleName} is server-only. Use @coduckai/sdk/client for browser code.`
+    );
+  }
+}
+
+// src/internal/config.ts
+var globalConfig = {};
+function getConfig() {
+  return globalConfig;
+}
+assertServer("db");
+var { Pool } = pg;
+var pool = null;
+function getPool() {
+  if (!pool) {
+    const config = getConfig();
+    const connectionString = config.db?.connectionString || getEnv("DATABASE_URL");
+    if (!connectionString) {
+      throw new Error("@coduckai/sdk/db: DATABASE_URL environment variable is required");
+    }
+    pool = new Pool({ connectionString });
+  }
+  return pool;
+}
+var db = {
+  /**
+   * Run a query, returns all rows
+   */
+  async query(sql, params) {
+    const result = await getPool().query(sql, params);
+    return result.rows;
+  },
+  /**
+   * Run a query, returns the first row or null
+   */
+  async queryOne(sql, params) {
+    const result = await getPool().query(sql, params);
+    return result.rows[0] || null;
+  },
+  /**
+   * Run a query that doesn't return rows (INSERT/UPDATE/DELETE)
+   */
+  async execute(sql, params) {
+    const result = await getPool().query(sql, params);
+    return { rowCount: result.rowCount ?? 0 };
+  },
+  /**
+   * Paginated query — automatically appends LIMIT/OFFSET and runs COUNT
+   */
+  async paginate(sql, params, options) {
+    const { page, pageSize } = options;
+    const offset = (page - 1) * pageSize;
+    const countSql = `SELECT COUNT(*) as total FROM (${sql}) AS _count_query`;
+    const countResult = await getPool().query(countSql, params);
+    const total = parseInt(countResult.rows[0].total, 10);
+    const dataSql = `${sql} LIMIT $${params.length + 1} OFFSET $${params.length + 2}`;
+    const dataResult = await getPool().query(dataSql, [...params, pageSize, offset]);
+    return {
+      data: dataResult.rows,
+      total,
+      page,
+      pageSize,
+      totalPages: Math.ceil(total / pageSize)
+    };
+  },
+  /**
+   * Run multiple queries in a transaction. Auto-commits on success, rolls back on error.
+   */
+  async transaction(fn) {
+    const client = await getPool().connect();
+    try {
+      await client.query("BEGIN");
+      const txClient = createTransactionClient(client);
+      const result = await fn(txClient);
+      await client.query("COMMIT");
+      return result;
+    } catch (error) {
+      await client.query("ROLLBACK");
+      throw error;
+    } finally {
+      client.release();
+    }
+  },
+  /**
+   * Get the underlying pg Pool (escape hatch)
+   */
+  getPool
+};
+function createTransactionClient(client) {
+  return {
+    async query(sql, params) {
+      const result = await client.query(sql, params);
+      return result.rows;
+    },
+    async queryOne(sql, params) {
+      const result = await client.query(sql, params);
+      return result.rows[0] || null;
+    },
+    async execute(sql, params) {
+      const result = await client.query(sql, params);
+      return { rowCount: result.rowCount ?? 0 };
+    }
+  };
+}
+
+export { db };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/db/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internal/env.ts","../../src/internal/config.ts","../../src/db/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Environment variable helpers\n */\n\nexport function getEnv(key: string, fallback?: string): string | undefined {\n  return process.env[key] || fallback;\n}\n\nexport function requireEnv(key: string): string {\n  const val = process.env[key];\n  if (!val) {\n    throw new Error(`@coduckai/sdk: Missing required environment variable: ${key}`);\n  }\n  return val;\n}\n\nexport function isServer(): boolean {\n  return typeof window === 'undefined';\n}\n\nexport function assertServer(moduleName: string): void {\n  if (!isServer()) {\n    throw new Error(\n      `@coduckai/sdk/${moduleName} is server-only. Use @coduckai/sdk/client for browser code.`\n    );\n  }\n}\n","/**\n * Global SDK configuration\n *\n * CoDuck apps use env vars automatically — no configure() needed.\n * Standalone usage can call configure() to override.\n */\n\nexport interface SDKConfig {\n  auth?: {\n    jwtSecret?: string;\n    jwtExpiresIn?: string;\n    bcryptRounds?: number;\n  };\n  db?: {\n    connectionString?: string;\n  };\n  client?: {\n    baseUrl?: string;\n    tokenKey?: string;\n  };\n}\n\nlet globalConfig: SDKConfig = {};\n\nexport function setConfig(config: SDKConfig): void {\n  globalConfig = { ...globalConfig, ...config };\n}\n\nexport function getConfig(): SDKConfig {\n  return globalConfig;\n}\n","/**\n * @coduckai/sdk/db — Database module (server-only)\n *\n * Wraps pg Pool. Returns rows directly, adds pagination and transactions.\n *\n * Usage:\n *   import { db } from '@coduckai/sdk/db';\n *   const users = await db.query('SELECT * FROM users WHERE active = $1', [true]);\n *   const user = await db.queryOne('SELECT * FROM users WHERE id = $1', [id]);\n */\n\nimport { assertServer, getEnv } from '../internal/env';\nimport { getConfig } from '../internal/config';\n\nassertServer('db');\n\nimport pg from 'pg';\nconst { Pool } = pg;\nimport type { PoolClient, QueryResultRow } from 'pg';\n\n// ── Types ──────────────────────────────────────────────\n\nexport interface PaginationOptions {\n  page: number;\n  pageSize: number;\n}\n\nexport interface PaginatedResult<T> {\n  data: T[];\n  total: number;\n  page: number;\n  pageSize: number;\n  totalPages: number;\n}\n\n// ── Pool (lazy singleton) ──────────────────────────────\n\nlet pool: pg.Pool | null = null;\n\nfunction getPool(): pg.Pool {\n  if (!pool) {\n    const config = getConfig();\n    const connectionString = config.db?.connectionString || getEnv('DATABASE_URL');\n    if (!connectionString) {\n      throw new Error('@coduckai/sdk/db: DATABASE_URL environment variable is required');\n    }\n    pool = new Pool({ connectionString });\n  }\n  return pool;\n}\n\n// ── DB API ─────────────────────────────────────────────\n\nexport const db = {\n  /**\n   * Run a query, returns all rows\n   */\n  async query<T extends QueryResultRow = QueryResultRow>(\n    sql: string,\n    params?: unknown[]\n  ): Promise<T[]> {\n    const result = await getPool().query<T>(sql, params);\n    return result.rows;\n  },\n\n  /**\n   * Run a query, returns the first row or null\n   */\n  async queryOne<T extends QueryResultRow = QueryResultRow>(\n    sql: string,\n    params?: unknown[]\n  ): Promise<T | null> {\n    const result = await getPool().query<T>(sql, params);\n    return result.rows[0] || null;\n  },\n\n  /**\n   * Run a query that doesn't return rows (INSERT/UPDATE/DELETE)\n   */\n  async execute(\n    sql: string,\n    params?: unknown[]\n  ): Promise<{ rowCount: number }> {\n    const result = await getPool().query(sql, params);\n    return { rowCount: result.rowCount ?? 0 };\n  },\n\n  /**\n   * Paginated query — automatically appends LIMIT/OFFSET and runs COUNT\n   */\n  async paginate<T extends QueryResultRow = QueryResultRow>(\n    sql: string,\n    params: unknown[],\n    options: PaginationOptions\n  ): Promise<PaginatedResult<T>> {\n    const { page, pageSize } = options;\n    const offset = (page - 1) * pageSize;\n\n    // Count query — wrap the user's SQL\n    const countSql = `SELECT COUNT(*) as total FROM (${sql}) AS _count_query`;\n    const countResult = await getPool().query(countSql, params);\n    const total = parseInt(countResult.rows[0].total, 10);\n\n    // Data query — append LIMIT/OFFSET\n    const dataSql = `${sql} LIMIT $${params.length + 1} OFFSET $${params.length + 2}`;\n    const dataResult = await getPool().query<T>(dataSql, [...params, pageSize, offset]);\n\n    return {\n      data: dataResult.rows,\n      total,\n      page,\n      pageSize,\n      totalPages: Math.ceil(total / pageSize),\n    };\n  },\n\n  /**\n   * Run multiple queries in a transaction. Auto-commits on success, rolls back on error.\n   */\n  async transaction<T>(fn: (tx: TransactionClient) => Promise<T>): Promise<T> {\n    const client = await getPool().connect();\n    try {\n      await client.query('BEGIN');\n      const txClient = createTransactionClient(client);\n      const result = await fn(txClient);\n      await client.query('COMMIT');\n      return result;\n    } catch (error) {\n      await client.query('ROLLBACK');\n      throw error;\n    } finally {\n      client.release();\n    }\n  },\n\n  /**\n   * Get the underlying pg Pool (escape hatch)\n   */\n  getPool,\n};\n\n// ── Transaction Client ─────────────────────────────────\n\nexport interface TransactionClient {\n  query<T extends QueryResultRow = QueryResultRow>(sql: string, params?: unknown[]): Promise<T[]>;\n  queryOne<T extends QueryResultRow = QueryResultRow>(sql: string, params?: unknown[]): Promise<T | null>;\n  execute(sql: string, params?: unknown[]): Promise<{ rowCount: number }>;\n}\n\nfunction createTransactionClient(client: PoolClient): TransactionClient {\n  return {\n    async query<T extends QueryResultRow = QueryResultRow>(sql: string, params?: unknown[]): Promise<T[]> {\n      const result = await client.query<T>(sql, params);\n      return result.rows;\n    },\n    async queryOne<T extends QueryResultRow = QueryResultRow>(sql: string, params?: unknown[]): Promise<T | null> {\n      const result = await client.query<T>(sql, params);\n      return result.rows[0] || null;\n    },\n    async execute(sql: string, params?: unknown[]): Promise<{ rowCount: number }> {\n      const result = await client.query(sql, params);\n      return { rowCount: result.rowCount ?? 0 };\n    },\n  };\n}\n"]}

package/dist/email/index.cjs

@@ -0,0 +1,29 @@
+'use strict';
+
+// src/internal/env.ts
+function isServer() {
+  return typeof window === "undefined";
+}
+function assertServer(moduleName) {
+  if (!isServer()) {
+    throw new Error(
+      `@coduckai/sdk/${moduleName} is server-only. Use @coduckai/sdk/client for browser code.`
+    );
+  }
+}
+
+// src/email/index.ts
+assertServer("email");
+var email = {
+  send: notImplemented("email.send"),
+  sendTemplate: notImplemented("email.sendTemplate")
+};
+function notImplemented(name) {
+  return () => {
+    throw new Error(`@coduckai/sdk: ${name}() is not yet implemented. Coming in v0.3.0.`);
+  };
+}
+
+exports.email = email;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/email/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internal/env.ts","../../src/email/index.ts"],"names":[],"mappings":";;;AAgBO,SAAS,QAAA,GAAoB;AAClC,EAAA,OAAO,OAAO,MAAA,KAAW,WAAA;AAC3B;AAEO,SAAS,aAAa,UAAA,EAA0B;AACrD,EAAA,IAAI,CAAC,UAAS,EAAG;AACf,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,iBAAiB,UAAU,CAAA,2DAAA;AAAA,KAC7B;AAAA,EACF;AACF;;;ACnBA,YAAA,CAAa,OAAO,CAAA;AAEb,IAAM,KAAA,GAAQ;AAAA,EACnB,IAAA,EAAM,eAAe,YAAY,CAAA;AAAA,EACjC,YAAA,EAAc,eAAe,oBAAoB;AACnD;AAEA,SAAS,eAAe,IAAA,EAAc;AACpC,EAAA,OAAO,MAAM;AACX,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,eAAA,EAAkB,IAAI,CAAA,4CAAA,CAA8C,CAAA;AAAA,EACtF,CAAA;AACF","file":"index.cjs","sourcesContent":["/**\n * Environment variable helpers\n */\n\nexport function getEnv(key: string, fallback?: string): string | undefined {\n  return process.env[key] || fallback;\n}\n\nexport function requireEnv(key: string): string {\n  const val = process.env[key];\n  if (!val) {\n    throw new Error(`@coduckai/sdk: Missing required environment variable: ${key}`);\n  }\n  return val;\n}\n\nexport function isServer(): boolean {\n  return typeof window === 'undefined';\n}\n\nexport function assertServer(moduleName: string): void {\n  if (!isServer()) {\n    throw new Error(\n      `@coduckai/sdk/${moduleName} is server-only. Use @coduckai/sdk/client for browser code.`\n    );\n  }\n}\n","/**\n * @coduckai/sdk/email — Email via Resend (server-only)\n *\n * Coming in v0.3.0.\n */\n\nimport { assertServer } from '../internal/env';\nassertServer('email');\n\nexport const email = {\n  send: notImplemented('email.send'),\n  sendTemplate: notImplemented('email.sendTemplate'),\n};\n\nfunction notImplemented(name: string) {\n  return () => {\n    throw new Error(`@coduckai/sdk: ${name}() is not yet implemented. Coming in v0.3.0.`);\n  };\n}\n"]}

package/dist/email/index.d.cts

@@ -0,0 +1,11 @@
+/**
+ * @coduckai/sdk/email — Email via Resend (server-only)
+ *
+ * Coming in v0.3.0.
+ */
+declare const email: {
+    send: () => never;
+    sendTemplate: () => never;
+};
+
+export { email };

package/dist/email/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @coduckai/sdk/email — Email via Resend (server-only)
+ *
+ * Coming in v0.3.0.
+ */
+declare const email: {
+    send: () => never;
+    sendTemplate: () => never;
+};
+
+export { email };

package/dist/email/index.js

@@ -0,0 +1,27 @@
+// src/internal/env.ts
+function isServer() {
+  return typeof window === "undefined";
+}
+function assertServer(moduleName) {
+  if (!isServer()) {
+    throw new Error(
+      `@coduckai/sdk/${moduleName} is server-only. Use @coduckai/sdk/client for browser code.`
+    );
+  }
+}
+
+// src/email/index.ts
+assertServer("email");
+var email = {
+  send: notImplemented("email.send"),
+  sendTemplate: notImplemented("email.sendTemplate")
+};
+function notImplemented(name) {
+  return () => {
+    throw new Error(`@coduckai/sdk: ${name}() is not yet implemented. Coming in v0.3.0.`);
+  };
+}
+
+export { email };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/email/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internal/env.ts","../../src/email/index.ts"],"names":[],"mappings":";AAgBO,SAAS,QAAA,GAAoB;AAClC,EAAA,OAAO,OAAO,MAAA,KAAW,WAAA;AAC3B;AAEO,SAAS,aAAa,UAAA,EAA0B;AACrD,EAAA,IAAI,CAAC,UAAS,EAAG;AACf,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,iBAAiB,UAAU,CAAA,2DAAA;AAAA,KAC7B;AAAA,EACF;AACF;;;ACnBA,YAAA,CAAa,OAAO,CAAA;AAEb,IAAM,KAAA,GAAQ;AAAA,EACnB,IAAA,EAAM,eAAe,YAAY,CAAA;AAAA,EACjC,YAAA,EAAc,eAAe,oBAAoB;AACnD;AAEA,SAAS,eAAe,IAAA,EAAc;AACpC,EAAA,OAAO,MAAM;AACX,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,eAAA,EAAkB,IAAI,CAAA,4CAAA,CAA8C,CAAA;AAAA,EACtF,CAAA;AACF","file":"index.js","sourcesContent":["/**\n * Environment variable helpers\n */\n\nexport function getEnv(key: string, fallback?: string): string | undefined {\n  return process.env[key] || fallback;\n}\n\nexport function requireEnv(key: string): string {\n  const val = process.env[key];\n  if (!val) {\n    throw new Error(`@coduckai/sdk: Missing required environment variable: ${key}`);\n  }\n  return val;\n}\n\nexport function isServer(): boolean {\n  return typeof window === 'undefined';\n}\n\nexport function assertServer(moduleName: string): void {\n  if (!isServer()) {\n    throw new Error(\n      `@coduckai/sdk/${moduleName} is server-only. Use @coduckai/sdk/client for browser code.`\n    );\n  }\n}\n","/**\n * @coduckai/sdk/email — Email via Resend (server-only)\n *\n * Coming in v0.3.0.\n */\n\nimport { assertServer } from '../internal/env';\nassertServer('email');\n\nexport const email = {\n  send: notImplemented('email.send'),\n  sendTemplate: notImplemented('email.sendTemplate'),\n};\n\nfunction notImplemented(name: string) {\n  return () => {\n    throw new Error(`@coduckai/sdk: ${name}() is not yet implemented. Coming in v0.3.0.`);\n  };\n}\n"]}

package/dist/index.cjs

@@ -0,0 +1,20 @@
+'use strict';
+
+// src/internal/config.ts
+var globalConfig = {};
+function setConfig(config) {
+  globalConfig = { ...globalConfig, ...config };
+}
+function getConfig() {
+  return globalConfig;
+}
+
+// src/index.ts
+function configure(config) {
+  setConfig(config);
+}
+
+exports.configure = configure;
+exports.getConfig = getConfig;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/internal/config.ts","../src/index.ts"],"names":[],"mappings":";;;AAsBA,IAAI,eAA0B,EAAC;AAExB,SAAS,UAAU,MAAA,EAAyB;AACjD,EAAA,YAAA,GAAe,EAAE,GAAG,YAAA,EAAc,GAAG,MAAA,EAAO;AAC9C;AAEO,SAAS,SAAA,GAAuB;AACrC,EAAA,OAAO,YAAA;AACT;;;ACnBO,SAAS,UAAU,MAAA,EAAyB;AACjD,EAAA,SAAA,CAAU,MAAM,CAAA;AAClB","file":"index.cjs","sourcesContent":["/**\n * Global SDK configuration\n *\n * CoDuck apps use env vars automatically — no configure() needed.\n * Standalone usage can call configure() to override.\n */\n\nexport interface SDKConfig {\n  auth?: {\n    jwtSecret?: string;\n    jwtExpiresIn?: string;\n    bcryptRounds?: number;\n  };\n  db?: {\n    connectionString?: string;\n  };\n  client?: {\n    baseUrl?: string;\n    tokenKey?: string;\n  };\n}\n\nlet globalConfig: SDKConfig = {};\n\nexport function setConfig(config: SDKConfig): void {\n  globalConfig = { ...globalConfig, ...config };\n}\n\nexport function getConfig(): SDKConfig {\n  return globalConfig;\n}\n","/**\n * @coduckai/sdk — CoDuck Platform SDK\n *\n * Zero-config in CoDuck apps (env vars auto-detected).\n * For standalone usage, call configure() first.\n */\n\nimport { setConfig, getConfig, type SDKConfig } from './internal/config';\n\nexport type { SDKConfig };\n\nexport function configure(config: SDKConfig): void {\n  setConfig(config);\n}\n\nexport { getConfig };\n"]}

package/dist/index.d.cts

@@ -0,0 +1,32 @@
+/**
+ * Global SDK configuration
+ *
+ * CoDuck apps use env vars automatically — no configure() needed.
+ * Standalone usage can call configure() to override.
+ */
+interface SDKConfig {
+    auth?: {
+        jwtSecret?: string;
+        jwtExpiresIn?: string;
+        bcryptRounds?: number;
+    };
+    db?: {
+        connectionString?: string;
+    };
+    client?: {
+        baseUrl?: string;
+        tokenKey?: string;
+    };
+}
+declare function getConfig(): SDKConfig;
+
+/**
+ * @coduckai/sdk — CoDuck Platform SDK
+ *
+ * Zero-config in CoDuck apps (env vars auto-detected).
+ * For standalone usage, call configure() first.
+ */
+
+declare function configure(config: SDKConfig): void;
+
+export { type SDKConfig, configure, getConfig };