@krutai/db-service 1.0.1

package/README.md

@@ -0,0 +1,58 @@
+# @krutai/db-service
+
+TypeScript/JavaScript client for fetching database configuration from KrutAI DB service.
+
+## Database support
+
+This package currently provides configuration for **PostgreSQL only**.
+
+## Installation
+
+```bash
+npm install @krutai/db-service
+```
+
+## Quick start
+
+```ts
+import { DbService } from '@krutai/db-service';
+
+const client = new DbService({
+  apiKey: process.env.KRUTAI_API_KEY!,
+  serverUrl: 'http://localhost:8000', // optional
+});
+
+await client.initialize();
+
+const config = await client.getDbConfig({
+  projectId: 'your-project-id',
+  dbName: 'your-db-name',
+});
+
+console.log(config.dbUrl); // postgres connection URL
+```
+
+## Environment variables
+
+- `KRUTAI_API_KEY`: used automatically if `apiKey` is not passed in constructor.
+
+## API overview
+
+- `new DbService(config)` creates a client instance.
+- `initialize()` validates API key with the service (unless `validateOnInit: false`).
+- `isInitialized()` returns whether client is initialized.
+- `getDbConfig({ projectId, dbName })` returns `{ dbUrl }`.
+- `dbService(config)` helper returns a `DbService` instance.
+
+## Configuration
+
+`DbServiceConfig` fields:
+
+- `apiKey` (string, required)
+- `serverUrl` (string, optional, default: `http://localhost:8000`)
+- `validateOnInit` (boolean, optional, default: `true`)
+
+## Errors
+
+- Throws `DbServiceKeyValidationError` for invalid or rejected API keys.
+- Throws `Error` for invalid request input or non-OK responses from DB service.

package/dist/index.d.mts

@@ -0,0 +1,37 @@
+declare class DbServiceKeyValidationError extends Error {
+    constructor(message: string);
+}
+interface DbServiceConfig {
+    apiKey: string;
+    serverUrl?: string;
+    validateOnInit?: boolean;
+}
+interface DbConfigRequest {
+    projectId: string;
+    dbName: string;
+}
+interface DbConfigResponse {
+    dbUrl: string;
+}
+declare const DEFAULT_SERVER_URL = "http://localhost:8000";
+declare const DEFAULT_DB_MANAGE_PREFIX = "/db-manage";
+declare function validateApiKeyFormat(apiKey?: string): void;
+declare function validateApiKeyWithService(apiKey?: string, serverUrl?: string): Promise<boolean>;
+declare class DbService {
+    private readonly apiKey;
+    private readonly serverUrl;
+    private readonly dbManagePrefix;
+    private readonly config;
+    private initialized;
+    constructor(config: DbServiceConfig);
+    initialize(): Promise<void>;
+    isInitialized(): boolean;
+    private assertInitialized;
+    private headers;
+    private url;
+    getDbConfig(request: DbConfigRequest): Promise<DbConfigResponse>;
+}
+declare function dbService(config: DbServiceConfig): DbService;
+declare const VERSION = "0.1.0";
+
+export { DEFAULT_DB_MANAGE_PREFIX, DEFAULT_SERVER_URL, type DbConfigRequest, type DbConfigResponse, DbService, type DbServiceConfig, DbServiceKeyValidationError, VERSION, dbService, validateApiKeyFormat, validateApiKeyWithService };

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+declare class DbServiceKeyValidationError extends Error {
+    constructor(message: string);
+}
+interface DbServiceConfig {
+    apiKey: string;
+    serverUrl?: string;
+    validateOnInit?: boolean;
+}
+interface DbConfigRequest {
+    projectId: string;
+    dbName: string;
+}
+interface DbConfigResponse {
+    dbUrl: string;
+}
+declare const DEFAULT_SERVER_URL = "http://localhost:8000";
+declare const DEFAULT_DB_MANAGE_PREFIX = "/db-manage";
+declare function validateApiKeyFormat(apiKey?: string): void;
+declare function validateApiKeyWithService(apiKey?: string, serverUrl?: string): Promise<boolean>;
+declare class DbService {
+    private readonly apiKey;
+    private readonly serverUrl;
+    private readonly dbManagePrefix;
+    private readonly config;
+    private initialized;
+    constructor(config: DbServiceConfig);
+    initialize(): Promise<void>;
+    isInitialized(): boolean;
+    private assertInitialized;
+    private headers;
+    private url;
+    getDbConfig(request: DbConfigRequest): Promise<DbConfigResponse>;
+}
+declare function dbService(config: DbServiceConfig): DbService;
+declare const VERSION = "0.1.0";
+
+export { DEFAULT_DB_MANAGE_PREFIX, DEFAULT_SERVER_URL, type DbConfigRequest, type DbConfigResponse, DbService, type DbServiceConfig, DbServiceKeyValidationError, VERSION, dbService, validateApiKeyFormat, validateApiKeyWithService };

package/dist/index.js

@@ -0,0 +1,176 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  DEFAULT_DB_MANAGE_PREFIX: () => DEFAULT_DB_MANAGE_PREFIX,
+  DEFAULT_SERVER_URL: () => DEFAULT_SERVER_URL,
+  DbService: () => DbService,
+  DbServiceKeyValidationError: () => DbServiceKeyValidationError,
+  VERSION: () => VERSION,
+  dbService: () => dbService,
+  validateApiKeyFormat: () => validateApiKeyFormat,
+  validateApiKeyWithService: () => validateApiKeyWithService
+});
+module.exports = __toCommonJS(index_exports);
+var DbServiceKeyValidationError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "DbServiceKeyValidationError";
+  }
+};
+var DEFAULT_SERVER_URL = "http://localhost:8000";
+var DEFAULT_DB_MANAGE_PREFIX = "/db-manage";
+function validateApiKeyFormat(apiKey) {
+  const key = apiKey || process.env.KRUTAI_API_KEY;
+  if (!key || typeof key !== "string") {
+    throw new DbServiceKeyValidationError("API key must be a non-empty string");
+  }
+  if (key.trim().length === 0) {
+    throw new DbServiceKeyValidationError("API key cannot be empty or whitespace");
+  }
+}
+async function validateApiKeyWithService(apiKey, serverUrl = DEFAULT_SERVER_URL) {
+  const key = apiKey || process.env.KRUTAI_API_KEY;
+  if (!key) {
+    throw new DbServiceKeyValidationError("API key is required");
+  }
+  validateApiKeyFormat(key);
+  try {
+    const url = `${serverUrl.replace(/\/$/, "")}/validate`;
+    const response = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-api-key": key
+      },
+      body: JSON.stringify({ apiKey: key })
+    });
+    let data = {};
+    try {
+      data = await response.json();
+    } catch {
+    }
+    if (!response.ok) {
+      throw new DbServiceKeyValidationError(
+        data.error || data.message || `API key validation failed: server responded with HTTP ${response.status}`
+      );
+    }
+    if (data.valid === false) {
+      throw new DbServiceKeyValidationError(
+        data.error ?? data.message ?? "API key rejected by server"
+      );
+    }
+    return true;
+  } catch (error) {
+    if (error instanceof DbServiceKeyValidationError) throw error;
+    throw new DbServiceKeyValidationError(
+      `Failed to reach validation endpoint: ${error instanceof Error ? error.message : "Unknown error"}`
+    );
+  }
+}
+var DbService = class {
+  apiKey;
+  serverUrl;
+  dbManagePrefix;
+  config;
+  initialized = false;
+  constructor(config) {
+    this.config = config;
+    this.apiKey = config.apiKey || process.env.KRUTAI_API_KEY || "";
+    this.serverUrl = (config.serverUrl ?? DEFAULT_SERVER_URL).replace(/\/$/, "");
+    this.dbManagePrefix = DEFAULT_DB_MANAGE_PREFIX.replace(/\/$/, "");
+    validateApiKeyFormat(this.apiKey);
+    if (config.validateOnInit === false) {
+      this.initialized = true;
+    }
+  }
+  async initialize() {
+    if (this.initialized) return;
+    if (this.config.validateOnInit !== false) {
+      await validateApiKeyWithService(this.apiKey, this.serverUrl);
+    }
+    this.initialized = true;
+  }
+  isInitialized() {
+    return this.initialized;
+  }
+  assertInitialized() {
+    if (!this.initialized) {
+      throw new Error(
+        "DbService not initialized. Call initialize() first or set validateOnInit to false."
+      );
+    }
+  }
+  headers() {
+    return {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${this.apiKey}`,
+      "x-api-key": this.apiKey
+    };
+  }
+  url(path) {
+    const cleanPath = path.startsWith("/") ? path : `/${path}`;
+    return `${this.serverUrl}${this.dbManagePrefix}${cleanPath}`;
+  }
+  async getDbConfig(request) {
+    this.assertInitialized();
+    if (!request.projectId || request.projectId.trim().length === 0) {
+      throw new Error("projectId is required");
+    }
+    if (!request.dbName || request.dbName.trim().length === 0) {
+      throw new Error("dbName is required");
+    }
+    const response = await fetch(this.url("/config"), {
+      method: "POST",
+      headers: this.headers(),
+      body: JSON.stringify({
+        projectId: request.projectId,
+        dbName: request.dbName
+      })
+    });
+    if (!response.ok) {
+      let message = `DB service returned HTTP ${response.status} for /config`;
+      try {
+        const errorData = await response.json();
+        message = errorData.error ?? errorData.message ?? message;
+      } catch {
+      }
+      throw new Error(message);
+    }
+    return await response.json();
+  }
+};
+function dbService(config) {
+  return new DbService(config);
+}
+var VERSION = "0.1.0";
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_DB_MANAGE_PREFIX,
+  DEFAULT_SERVER_URL,
+  DbService,
+  DbServiceKeyValidationError,
+  VERSION,
+  dbService,
+  validateApiKeyFormat,
+  validateApiKeyWithService
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export class DbServiceKeyValidationError extends Error {\n    constructor(message: string) {\n        super(message);\n        this.name = 'DbServiceKeyValidationError';\n    }\n}\n\nexport interface DbServiceConfig {\n    apiKey: string;\n    serverUrl?: string;\n    validateOnInit?: boolean;\n}\n\nexport interface DbConfigRequest {\n    projectId: string;\n    dbName: string;\n}\n\nexport interface DbConfigResponse {\n    dbUrl: string;\n}\n\nexport const DEFAULT_SERVER_URL = 'http://localhost:8000';\nexport const DEFAULT_DB_MANAGE_PREFIX = '/db-manage';\n\nexport function validateApiKeyFormat(apiKey?: string): void {\n    const key = apiKey || process.env.KRUTAI_API_KEY;\n\n    if (!key || typeof key !== 'string') {\n        throw new DbServiceKeyValidationError('API key must be a non-empty string');\n    }\n\n    if (key.trim().length === 0) {\n        throw new DbServiceKeyValidationError('API key cannot be empty or whitespace');\n    }\n}\n\nexport async function validateApiKeyWithService(\n    apiKey?: string,\n    serverUrl: string = DEFAULT_SERVER_URL\n): Promise<boolean> {\n    const key = apiKey || process.env.KRUTAI_API_KEY;\n    if (!key) {\n        throw new DbServiceKeyValidationError('API key is required');\n    }\n\n    validateApiKeyFormat(key);\n\n    try {\n        const url = `${serverUrl.replace(/\\/$/, '')}/validate`;\n        const response = await fetch(url, {\n            method: 'POST',\n            headers: {\n                'Content-Type': 'application/json',\n                'x-api-key': key,\n            },\n            body: JSON.stringify({ apiKey: key }),\n        });\n\n        let data: { valid?: boolean; message?: string; error?: string } = {};\n        try {\n            data = (await response.json()) as {\n                valid?: boolean;\n                message?: string;\n                error?: string;\n            };\n        } catch {\n            // Ignore parsing errors for non-JSON responses\n        }\n\n        if (!response.ok) {\n            throw new DbServiceKeyValidationError(\n                data.error ||\n                    data.message ||\n                    `API key validation failed: server responded with HTTP ${response.status}`\n            );\n        }\n\n        if (data.valid === false) {\n            throw new DbServiceKeyValidationError(\n                data.error ?? data.message ?? 'API key rejected by server'\n            );\n        }\n\n        return true;\n    } catch (error) {\n        if (error instanceof DbServiceKeyValidationError) throw error;\n        throw new DbServiceKeyValidationError(\n            `Failed to reach validation endpoint: ${error instanceof Error ? error.message : 'Unknown error'}`\n        );\n    }\n}\n\nexport class DbService {\n    private readonly apiKey: string;\n    private readonly serverUrl: string;\n    private readonly dbManagePrefix: string;\n    private readonly config: DbServiceConfig;\n    private initialized = false;\n\n    constructor(config: DbServiceConfig) {\n        this.config = config;\n        this.apiKey = config.apiKey || process.env.KRUTAI_API_KEY || '';\n        this.serverUrl = (config.serverUrl ?? DEFAULT_SERVER_URL).replace(/\\/$/, '');\n        this.dbManagePrefix = DEFAULT_DB_MANAGE_PREFIX.replace(/\\/$/, '');\n\n        validateApiKeyFormat(this.apiKey);\n\n        if (config.validateOnInit === false) {\n            this.initialized = true;\n        }\n    }\n\n    async initialize(): Promise<void> {\n        if (this.initialized) return;\n\n        if (this.config.validateOnInit !== false) {\n            await validateApiKeyWithService(this.apiKey, this.serverUrl);\n        }\n\n        this.initialized = true;\n    }\n\n    isInitialized(): boolean {\n        return this.initialized;\n    }\n\n    private assertInitialized(): void {\n        if (!this.initialized) {\n            throw new Error(\n                'DbService not initialized. Call initialize() first or set validateOnInit to false.'\n            );\n        }\n    }\n\n    private headers(): Record<string, string> {\n        return {\n            'Content-Type': 'application/json',\n            Authorization: `Bearer ${this.apiKey}`,\n            'x-api-key': this.apiKey,\n        };\n    }\n\n    private url(path: string): string {\n        const cleanPath = path.startsWith('/') ? path : `/${path}`;\n        return `${this.serverUrl}${this.dbManagePrefix}${cleanPath}`;\n    }\n\n    async getDbConfig(request: DbConfigRequest): Promise<DbConfigResponse> {\n        this.assertInitialized();\n\n        if (!request.projectId || request.projectId.trim().length === 0) {\n            throw new Error('projectId is required');\n        }\n\n        if (!request.dbName || request.dbName.trim().length === 0) {\n            throw new Error('dbName is required');\n        }\n\n        const response = await fetch(this.url('/config'), {\n            method: 'POST',\n            headers: this.headers(),\n            body: JSON.stringify({\n                projectId: request.projectId,\n                dbName: request.dbName,\n            }),\n        });\n\n        if (!response.ok) {\n            let message = `DB service returned HTTP ${response.status} for /config`;\n            try {\n                const errorData = (await response.json()) as {\n                    message?: string;\n                    error?: string;\n                };\n                message = errorData.error ?? errorData.message ?? message;\n            } catch {\n                // ignore malformed error payloads\n            }\n            throw new Error(message);\n        }\n\n        return (await response.json()) as DbConfigResponse;\n    }\n}\n\nexport function dbService(config: DbServiceConfig): DbService {\n    return new DbService(config);\n}\n\nexport const VERSION = '0.1.0';\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,144 @@
+// src/index.ts
+var DbServiceKeyValidationError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "DbServiceKeyValidationError";
+  }
+};
+var DEFAULT_SERVER_URL = "http://localhost:8000";
+var DEFAULT_DB_MANAGE_PREFIX = "/db-manage";
+function validateApiKeyFormat(apiKey) {
+  const key = apiKey || process.env.KRUTAI_API_KEY;
+  if (!key || typeof key !== "string") {
+    throw new DbServiceKeyValidationError("API key must be a non-empty string");
+  }
+  if (key.trim().length === 0) {
+    throw new DbServiceKeyValidationError("API key cannot be empty or whitespace");
+  }
+}
+async function validateApiKeyWithService(apiKey, serverUrl = DEFAULT_SERVER_URL) {
+  const key = apiKey || process.env.KRUTAI_API_KEY;
+  if (!key) {
+    throw new DbServiceKeyValidationError("API key is required");
+  }
+  validateApiKeyFormat(key);
+  try {
+    const url = `${serverUrl.replace(/\/$/, "")}/validate`;
+    const response = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-api-key": key
+      },
+      body: JSON.stringify({ apiKey: key })
+    });
+    let data = {};
+    try {
+      data = await response.json();
+    } catch {
+    }
+    if (!response.ok) {
+      throw new DbServiceKeyValidationError(
+        data.error || data.message || `API key validation failed: server responded with HTTP ${response.status}`
+      );
+    }
+    if (data.valid === false) {
+      throw new DbServiceKeyValidationError(
+        data.error ?? data.message ?? "API key rejected by server"
+      );
+    }
+    return true;
+  } catch (error) {
+    if (error instanceof DbServiceKeyValidationError) throw error;
+    throw new DbServiceKeyValidationError(
+      `Failed to reach validation endpoint: ${error instanceof Error ? error.message : "Unknown error"}`
+    );
+  }
+}
+var DbService = class {
+  apiKey;
+  serverUrl;
+  dbManagePrefix;
+  config;
+  initialized = false;
+  constructor(config) {
+    this.config = config;
+    this.apiKey = config.apiKey || process.env.KRUTAI_API_KEY || "";
+    this.serverUrl = (config.serverUrl ?? DEFAULT_SERVER_URL).replace(/\/$/, "");
+    this.dbManagePrefix = DEFAULT_DB_MANAGE_PREFIX.replace(/\/$/, "");
+    validateApiKeyFormat(this.apiKey);
+    if (config.validateOnInit === false) {
+      this.initialized = true;
+    }
+  }
+  async initialize() {
+    if (this.initialized) return;
+    if (this.config.validateOnInit !== false) {
+      await validateApiKeyWithService(this.apiKey, this.serverUrl);
+    }
+    this.initialized = true;
+  }
+  isInitialized() {
+    return this.initialized;
+  }
+  assertInitialized() {
+    if (!this.initialized) {
+      throw new Error(
+        "DbService not initialized. Call initialize() first or set validateOnInit to false."
+      );
+    }
+  }
+  headers() {
+    return {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${this.apiKey}`,
+      "x-api-key": this.apiKey
+    };
+  }
+  url(path) {
+    const cleanPath = path.startsWith("/") ? path : `/${path}`;
+    return `${this.serverUrl}${this.dbManagePrefix}${cleanPath}`;
+  }
+  async getDbConfig(request) {
+    this.assertInitialized();
+    if (!request.projectId || request.projectId.trim().length === 0) {
+      throw new Error("projectId is required");
+    }
+    if (!request.dbName || request.dbName.trim().length === 0) {
+      throw new Error("dbName is required");
+    }
+    const response = await fetch(this.url("/config"), {
+      method: "POST",
+      headers: this.headers(),
+      body: JSON.stringify({
+        projectId: request.projectId,
+        dbName: request.dbName
+      })
+    });
+    if (!response.ok) {
+      let message = `DB service returned HTTP ${response.status} for /config`;
+      try {
+        const errorData = await response.json();
+        message = errorData.error ?? errorData.message ?? message;
+      } catch {
+      }
+      throw new Error(message);
+    }
+    return await response.json();
+  }
+};
+function dbService(config) {
+  return new DbService(config);
+}
+var VERSION = "0.1.0";
+export {
+  DEFAULT_DB_MANAGE_PREFIX,
+  DEFAULT_SERVER_URL,
+  DbService,
+  DbServiceKeyValidationError,
+  VERSION,
+  dbService,
+  validateApiKeyFormat,
+  validateApiKeyWithService
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export class DbServiceKeyValidationError extends Error {\n    constructor(message: string) {\n        super(message);\n        this.name = 'DbServiceKeyValidationError';\n    }\n}\n\nexport interface DbServiceConfig {\n    apiKey: string;\n    serverUrl?: string;\n    validateOnInit?: boolean;\n}\n\nexport interface DbConfigRequest {\n    projectId: string;\n    dbName: string;\n}\n\nexport interface DbConfigResponse {\n    dbUrl: string;\n}\n\nexport const DEFAULT_SERVER_URL = 'http://localhost:8000';\nexport const DEFAULT_DB_MANAGE_PREFIX = '/db-manage';\n\nexport function validateApiKeyFormat(apiKey?: string): void {\n    const key = apiKey || process.env.KRUTAI_API_KEY;\n\n    if (!key || typeof key !== 'string') {\n        throw new DbServiceKeyValidationError('API key must be a non-empty string');\n    }\n\n    if (key.trim().length === 0) {\n        throw new DbServiceKeyValidationError('API key cannot be empty or whitespace');\n    }\n}\n\nexport async function validateApiKeyWithService(\n    apiKey?: string,\n    serverUrl: string = DEFAULT_SERVER_URL\n): Promise<boolean> {\n    const key = apiKey || process.env.KRUTAI_API_KEY;\n    if (!key) {\n        throw new DbServiceKeyValidationError('API key is required');\n    }\n\n    validateApiKeyFormat(key);\n\n    try {\n        const url = `${serverUrl.replace(/\\/$/, '')}/validate`;\n        const response = await fetch(url, {\n            method: 'POST',\n            headers: {\n                'Content-Type': 'application/json',\n                'x-api-key': key,\n            },\n            body: JSON.stringify({ apiKey: key }),\n        });\n\n        let data: { valid?: boolean; message?: string; error?: string } = {};\n        try {\n            data = (await response.json()) as {\n                valid?: boolean;\n                message?: string;\n                error?: string;\n            };\n        } catch {\n            // Ignore parsing errors for non-JSON responses\n        }\n\n        if (!response.ok) {\n            throw new DbServiceKeyValidationError(\n                data.error ||\n                    data.message ||\n                    `API key validation failed: server responded with HTTP ${response.status}`\n            );\n        }\n\n        if (data.valid === false) {\n            throw new DbServiceKeyValidationError(\n                data.error ?? data.message ?? 'API key rejected by server'\n            );\n        }\n\n        return true;\n    } catch (error) {\n        if (error instanceof DbServiceKeyValidationError) throw error;\n        throw new DbServiceKeyValidationError(\n            `Failed to reach validation endpoint: ${error instanceof Error ? error.message : 'Unknown error'}`\n        );\n    }\n}\n\nexport class DbService {\n    private readonly apiKey: string;\n    private readonly serverUrl: string;\n    private readonly dbManagePrefix: string;\n    private readonly config: DbServiceConfig;\n    private initialized = false;\n\n    constructor(config: DbServiceConfig) {\n        this.config = config;\n        this.apiKey = config.apiKey || process.env.KRUTAI_API_KEY || '';\n        this.serverUrl = (config.serverUrl ?? DEFAULT_SERVER_URL).replace(/\\/$/, '');\n        this.dbManagePrefix = DEFAULT_DB_MANAGE_PREFIX.replace(/\\/$/, '');\n\n        validateApiKeyFormat(this.apiKey);\n\n        if (config.validateOnInit === false) {\n            this.initialized = true;\n        }\n    }\n\n    async initialize(): Promise<void> {\n        if (this.initialized) return;\n\n        if (this.config.validateOnInit !== false) {\n            await validateApiKeyWithService(this.apiKey, this.serverUrl);\n        }\n\n        this.initialized = true;\n    }\n\n    isInitialized(): boolean {\n        return this.initialized;\n    }\n\n    private assertInitialized(): void {\n        if (!this.initialized) {\n            throw new Error(\n                'DbService not initialized. Call initialize() first or set validateOnInit to false.'\n            );\n        }\n    }\n\n    private headers(): Record<string, string> {\n        return {\n            'Content-Type': 'application/json',\n            Authorization: `Bearer ${this.apiKey}`,\n            'x-api-key': this.apiKey,\n        };\n    }\n\n    private url(path: string): string {\n        const cleanPath = path.startsWith('/') ? path : `/${path}`;\n        return `${this.serverUrl}${this.dbManagePrefix}${cleanPath}`;\n    }\n\n    async getDbConfig(request: DbConfigRequest): Promise<DbConfigResponse> {\n        this.assertInitialized();\n\n        if (!request.projectId || request.projectId.trim().length === 0) {\n            throw new Error('projectId is required');\n        }\n\n        if (!request.dbName || request.dbName.trim().length === 0) {\n            throw new Error('dbName is required');\n        }\n\n        const response = await fetch(this.url('/config'), {\n            method: 'POST',\n            headers: this.headers(),\n            body: JSON.stringify({\n                projectId: request.projectId,\n                dbName: request.dbName,\n            }),\n        });\n\n        if (!response.ok) {\n            let message = `DB service returned HTTP ${response.status} for /config`;\n            try {\n                const errorData = (await response.json()) as {\n                    message?: string;\n                    error?: string;\n                };\n                message = errorData.error ?? errorData.message ?? message;\n            } catch {\n                // ignore malformed error payloads\n            }\n            throw new Error(message);\n        }\n\n        return (await response.json()) as DbConfigResponse;\n    }\n}\n\nexport function dbService(config: DbServiceConfig): DbService {\n    return new DbService(config);\n}\n\nexport const VERSION = '0.1.0';\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@krutai/db-service",
+  "version": "1.0.1",
+  "description": "DB service client for KrutAI",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "prepack": "npm run build",
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "krutai",
+    "database",
+    "db-service"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AccountantAIOrg/krut_packages.git",
+    "directory": "packages/db-service"
+  }
+}