@ketrics/sdk-backend 0.2.0

package/dist/errors.d.ts

@@ -0,0 +1,244 @@
+/**
+ * Ketrics SDK - Volume Error Classes
+ *
+ * Complete error hierarchy for Volume SDK operations.
+ * All errors extend VolumeError for consistent handling.
+ *
+ * @example
+ * ```typescript
+ * import { Volume, VolumeNotFoundError, FileNotFoundError } from '@ketrics/sdk';
+ *
+ * try {
+ *   const volume = await Volume.connect('uploads');
+ *   const file = await volume.get('missing.txt');
+ * } catch (error) {
+ *   if (error instanceof VolumeNotFoundError) {
+ *     console.log('Volume not found:', error.volumeCode);
+ *   } else if (error instanceof FileNotFoundError) {
+ *     console.log('File not found:', error.key);
+ *   } else if (isVolumeError(error)) {
+ *     console.log('Volume error:', error.message);
+ *   }
+ * }
+ * ```
+ */
+/**
+ * Volume permission values
+ */
+export type VolumePermissionValue = 'ReadObject' | 'CreateObject' | 'UpdateObject' | 'DeleteObject' | 'ListObjects';
+/**
+ * Base error class for all Volume SDK errors.
+ *
+ * Provides consistent properties across all error types.
+ * Use the type guards (isVolumeError, isVolumeErrorType) for type-safe error handling.
+ */
+export declare abstract class VolumeError extends Error {
+    /** Volume code where error occurred */
+    readonly volumeCode: string;
+    /** Operation that caused the error */
+    readonly operation: string;
+    /** Timestamp when error occurred */
+    readonly timestamp: Date;
+    constructor(volumeCode: string, operation: string, message: string);
+    /**
+     * Convert error to JSON for logging/serialization.
+     * Does not include stack trace or internal details.
+     */
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Thrown when a volume does not exist.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await Volume.connect('nonexistent');
+ * } catch (error) {
+ *   if (error instanceof VolumeNotFoundError) {
+ *     console.log(`Volume '${error.volumeCode}' not found`);
+ *   }
+ * }
+ * ```
+ */
+export declare class VolumeNotFoundError extends VolumeError {
+    constructor(volumeCode: string);
+}
+/**
+ * Thrown when the application does not have an access grant to the volume.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await Volume.connect('restricted');
+ * } catch (error) {
+ *   if (error instanceof VolumeAccessDeniedError) {
+ *     console.log(`No access to volume '${error.volumeCode}'`);
+ *   }
+ * }
+ * ```
+ */
+export declare class VolumeAccessDeniedError extends VolumeError {
+    constructor(volumeCode: string);
+}
+/**
+ * Thrown when an operation requires a permission that was not granted.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await volume.delete('file.txt'); // No DELETE permission
+ * } catch (error) {
+ *   if (error instanceof VolumePermissionDeniedError) {
+ *     console.log(`Missing permission: ${error.requiredPermission}`);
+ *   }
+ * }
+ * ```
+ */
+export declare class VolumePermissionDeniedError extends VolumeError {
+    /** The permission that was required but not granted */
+    readonly requiredPermission: VolumePermissionValue;
+    constructor(volumeCode: string, requiredPermission: VolumePermissionValue, operation: string, message?: string);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Thrown when a file does not exist in the volume.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await volume.get('missing.txt');
+ * } catch (error) {
+ *   if (error instanceof FileNotFoundError) {
+ *     console.log(`File '${error.key}' not found`);
+ *   }
+ * }
+ * ```
+ */
+export declare class FileNotFoundError extends VolumeError {
+    /** The file key that was not found */
+    readonly key: string;
+    constructor(volumeCode: string, key: string);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Thrown when attempting to create a file that already exists (with ifNotExists option).
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await volume.put('config.json', data, { ifNotExists: true });
+ * } catch (error) {
+ *   if (error instanceof FileAlreadyExistsError) {
+ *     console.log(`File '${error.key}' already exists`);
+ *   }
+ * }
+ * ```
+ */
+export declare class FileAlreadyExistsError extends VolumeError {
+    /** The file key that already exists */
+    readonly key: string;
+    constructor(volumeCode: string, key: string);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Thrown when a file path is invalid (e.g., path traversal attempt).
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await volume.get('../../../etc/passwd');
+ * } catch (error) {
+ *   if (error instanceof InvalidPathError) {
+ *     console.log(`Invalid path: ${error.reason}`);
+ *   }
+ * }
+ * ```
+ */
+export declare class InvalidPathError extends VolumeError {
+    /** The invalid path */
+    readonly path: string;
+    /** Reason the path is invalid */
+    readonly reason: string;
+    constructor(path: string, reason: string);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Thrown when a file exceeds the volume's size limit.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await volume.put('large-file.zip', hugeBuffer);
+ * } catch (error) {
+ *   if (error instanceof FileSizeLimitError) {
+ *     console.log(`File too large: ${error.size} > ${error.maxSize}`);
+ *   }
+ * }
+ * ```
+ */
+export declare class FileSizeLimitError extends VolumeError {
+    /** The file key */
+    readonly key: string;
+    /** Actual file size in bytes */
+    readonly size: number;
+    /** Maximum allowed size in bytes */
+    readonly maxSize: number;
+    constructor(volumeCode: string, key: string, size: number, maxSize: number);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Thrown when a file's content type is not allowed by the volume.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await volume.put('script.exe', buffer);
+ * } catch (error) {
+ *   if (error instanceof ContentTypeNotAllowedError) {
+ *     console.log(`Content type '${error.contentType}' not allowed`);
+ *     console.log(`Allowed: ${error.allowedTypes.join(', ')}`);
+ *   }
+ * }
+ * ```
+ */
+export declare class ContentTypeNotAllowedError extends VolumeError {
+    /** The file key */
+    readonly key: string;
+    /** The content type that was rejected */
+    readonly contentType: string;
+    /** List of allowed content types/extensions */
+    readonly allowedTypes: string[];
+    constructor(volumeCode: string, key: string, contentType: string, allowedTypes: string[]);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Type guard to check if an error is a VolumeError.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await volume.get('file.txt');
+ * } catch (error) {
+ *   if (isVolumeError(error)) {
+ *     console.log('Volume error:', error.volumeCode, error.operation);
+ *   }
+ * }
+ * ```
+ */
+export declare function isVolumeError(error: unknown): error is VolumeError;
+/**
+ * Type guard to check if an error is a specific VolumeError type.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await volume.get('file.txt');
+ * } catch (error) {
+ *   if (isVolumeErrorType(error, FileNotFoundError)) {
+ *     console.log('File not found:', error.key);
+ *   }
+ * }
+ * ```
+ */
+export declare function isVolumeErrorType<T extends VolumeError>(error: unknown, errorClass: new (...args: never[]) => T): error is T;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC7B,YAAY,GACZ,cAAc,GACd,cAAc,GACd,cAAc,GACd,aAAa,CAAC;AAElB;;;;;GAKG;AACH,8BAAsB,WAAY,SAAQ,KAAK;IAC7C,uCAAuC;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;gBAEb,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAalE;;;OAGG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CASlC;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,UAAU,EAAE,MAAM;CAG/B;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,uBAAwB,SAAQ,WAAW;gBAC1C,UAAU,EAAE,MAAM;CAO/B;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,2BAA4B,SAAQ,WAAW;IAC1D,uDAAuD;IACvD,QAAQ,CAAC,kBAAkB,EAAE,qBAAqB,CAAC;gBAGjD,UAAU,EAAE,MAAM,EAClB,kBAAkB,EAAE,qBAAqB,EACzC,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM;IAWlB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAMlC;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;IAChD,sCAAsC;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IAK3C,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAMlC;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,sBAAuB,SAAQ,WAAW;IACrD,uCAAuC;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IAS3C,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAMlC;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,uBAAuB;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAMxC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOlC;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAmB,SAAQ,WAAW;IACjD,mBAAmB;IACnB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAa1E,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQlC;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,0BAA2B,SAAQ,WAAW;IACzD,mBAAmB;IACnB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,+CAA+C;IAC/C,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;gBAG9B,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EAAE;IAYxB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQlC;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,WAAW,EACrD,KAAK,EAAE,OAAO,EACd,UAAU,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,GACtC,KAAK,IAAI,CAAC,CAEZ"}

package/dist/errors.js

@@ -0,0 +1,316 @@
+"use strict";
+/**
+ * Ketrics SDK - Volume Error Classes
+ *
+ * Complete error hierarchy for Volume SDK operations.
+ * All errors extend VolumeError for consistent handling.
+ *
+ * @example
+ * ```typescript
+ * import { Volume, VolumeNotFoundError, FileNotFoundError } from '@ketrics/sdk';
+ *
+ * try {
+ *   const volume = await Volume.connect('uploads');
+ *   const file = await volume.get('missing.txt');
+ * } catch (error) {
+ *   if (error instanceof VolumeNotFoundError) {
+ *     console.log('Volume not found:', error.volumeCode);
+ *   } else if (error instanceof FileNotFoundError) {
+ *     console.log('File not found:', error.key);
+ *   } else if (isVolumeError(error)) {
+ *     console.log('Volume error:', error.message);
+ *   }
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContentTypeNotAllowedError = exports.FileSizeLimitError = exports.InvalidPathError = exports.FileAlreadyExistsError = exports.FileNotFoundError = exports.VolumePermissionDeniedError = exports.VolumeAccessDeniedError = exports.VolumeNotFoundError = exports.VolumeError = void 0;
+exports.isVolumeError = isVolumeError;
+exports.isVolumeErrorType = isVolumeErrorType;
+/**
+ * Base error class for all Volume SDK errors.
+ *
+ * Provides consistent properties across all error types.
+ * Use the type guards (isVolumeError, isVolumeErrorType) for type-safe error handling.
+ */
+class VolumeError extends Error {
+    constructor(volumeCode, operation, message) {
+        super(message);
+        this.name = this.constructor.name;
+        this.volumeCode = volumeCode;
+        this.operation = operation;
+        this.timestamp = new Date();
+        // Maintains proper stack trace for where error was thrown
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Convert error to JSON for logging/serialization.
+     * Does not include stack trace or internal details.
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            volumeCode: this.volumeCode,
+            operation: this.operation,
+            timestamp: this.timestamp.toISOString(),
+        };
+    }
+}
+exports.VolumeError = VolumeError;
+/**
+ * Thrown when a volume does not exist.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await Volume.connect('nonexistent');
+ * } catch (error) {
+ *   if (error instanceof VolumeNotFoundError) {
+ *     console.log(`Volume '${error.volumeCode}' not found`);
+ *   }
+ * }
+ * ```
+ */
+class VolumeNotFoundError extends VolumeError {
+    constructor(volumeCode) {
+        super(volumeCode, 'connect', `Volume '${volumeCode}' not found`);
+    }
+}
+exports.VolumeNotFoundError = VolumeNotFoundError;
+/**
+ * Thrown when the application does not have an access grant to the volume.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await Volume.connect('restricted');
+ * } catch (error) {
+ *   if (error instanceof VolumeAccessDeniedError) {
+ *     console.log(`No access to volume '${error.volumeCode}'`);
+ *   }
+ * }
+ * ```
+ */
+class VolumeAccessDeniedError extends VolumeError {
+    constructor(volumeCode) {
+        super(volumeCode, 'connect', `Application does not have access to volume '${volumeCode}'`);
+    }
+}
+exports.VolumeAccessDeniedError = VolumeAccessDeniedError;
+/**
+ * Thrown when an operation requires a permission that was not granted.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await volume.delete('file.txt'); // No DELETE permission
+ * } catch (error) {
+ *   if (error instanceof VolumePermissionDeniedError) {
+ *     console.log(`Missing permission: ${error.requiredPermission}`);
+ *   }
+ * }
+ * ```
+ */
+class VolumePermissionDeniedError extends VolumeError {
+    constructor(volumeCode, requiredPermission, operation, message) {
+        super(volumeCode, operation, message ||
+            `Operation '${operation}' requires '${requiredPermission}' permission on volume '${volumeCode}'`);
+        this.requiredPermission = requiredPermission;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            requiredPermission: this.requiredPermission,
+        };
+    }
+}
+exports.VolumePermissionDeniedError = VolumePermissionDeniedError;
+/**
+ * Thrown when a file does not exist in the volume.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await volume.get('missing.txt');
+ * } catch (error) {
+ *   if (error instanceof FileNotFoundError) {
+ *     console.log(`File '${error.key}' not found`);
+ *   }
+ * }
+ * ```
+ */
+class FileNotFoundError extends VolumeError {
+    constructor(volumeCode, key) {
+        super(volumeCode, 'get', `File '${key}' not found in volume '${volumeCode}'`);
+        this.key = key;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            key: this.key,
+        };
+    }
+}
+exports.FileNotFoundError = FileNotFoundError;
+/**
+ * Thrown when attempting to create a file that already exists (with ifNotExists option).
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await volume.put('config.json', data, { ifNotExists: true });
+ * } catch (error) {
+ *   if (error instanceof FileAlreadyExistsError) {
+ *     console.log(`File '${error.key}' already exists`);
+ *   }
+ * }
+ * ```
+ */
+class FileAlreadyExistsError extends VolumeError {
+    constructor(volumeCode, key) {
+        super(volumeCode, 'put', `File '${key}' already exists in volume '${volumeCode}'`);
+        this.key = key;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            key: this.key,
+        };
+    }
+}
+exports.FileAlreadyExistsError = FileAlreadyExistsError;
+/**
+ * Thrown when a file path is invalid (e.g., path traversal attempt).
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await volume.get('../../../etc/passwd');
+ * } catch (error) {
+ *   if (error instanceof InvalidPathError) {
+ *     console.log(`Invalid path: ${error.reason}`);
+ *   }
+ * }
+ * ```
+ */
+class InvalidPathError extends VolumeError {
+    constructor(path, reason) {
+        super('', 'validate', `Invalid path '${path}': ${reason}`);
+        this.path = path;
+        this.reason = reason;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            path: this.path,
+            reason: this.reason,
+        };
+    }
+}
+exports.InvalidPathError = InvalidPathError;
+/**
+ * Thrown when a file exceeds the volume's size limit.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await volume.put('large-file.zip', hugeBuffer);
+ * } catch (error) {
+ *   if (error instanceof FileSizeLimitError) {
+ *     console.log(`File too large: ${error.size} > ${error.maxSize}`);
+ *   }
+ * }
+ * ```
+ */
+class FileSizeLimitError extends VolumeError {
+    constructor(volumeCode, key, size, maxSize) {
+        const sizeMB = (size / (1024 * 1024)).toFixed(2);
+        const maxMB = (maxSize / (1024 * 1024)).toFixed(2);
+        super(volumeCode, 'put', `File '${key}' (${sizeMB}MB) exceeds volume limit (${maxMB}MB)`);
+        this.key = key;
+        this.size = size;
+        this.maxSize = maxSize;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            key: this.key,
+            size: this.size,
+            maxSize: this.maxSize,
+        };
+    }
+}
+exports.FileSizeLimitError = FileSizeLimitError;
+/**
+ * Thrown when a file's content type is not allowed by the volume.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await volume.put('script.exe', buffer);
+ * } catch (error) {
+ *   if (error instanceof ContentTypeNotAllowedError) {
+ *     console.log(`Content type '${error.contentType}' not allowed`);
+ *     console.log(`Allowed: ${error.allowedTypes.join(', ')}`);
+ *   }
+ * }
+ * ```
+ */
+class ContentTypeNotAllowedError extends VolumeError {
+    constructor(volumeCode, key, contentType, allowedTypes) {
+        super(volumeCode, 'put', `Content type '${contentType}' not allowed for volume '${volumeCode}'. Allowed: ${allowedTypes.join(', ')}`);
+        this.key = key;
+        this.contentType = contentType;
+        this.allowedTypes = allowedTypes;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            key: this.key,
+            contentType: this.contentType,
+            allowedTypes: this.allowedTypes,
+        };
+    }
+}
+exports.ContentTypeNotAllowedError = ContentTypeNotAllowedError;
+// ============================================================================
+// Type Guards
+// ============================================================================
+/**
+ * Type guard to check if an error is a VolumeError.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await volume.get('file.txt');
+ * } catch (error) {
+ *   if (isVolumeError(error)) {
+ *     console.log('Volume error:', error.volumeCode, error.operation);
+ *   }
+ * }
+ * ```
+ */
+function isVolumeError(error) {
+    return error instanceof VolumeError;
+}
+/**
+ * Type guard to check if an error is a specific VolumeError type.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await volume.get('file.txt');
+ * } catch (error) {
+ *   if (isVolumeErrorType(error, FileNotFoundError)) {
+ *     console.log('File not found:', error.key);
+ *   }
+ * }
+ * ```
+ */
+function isVolumeErrorType(error, errorClass) {
+    return error instanceof errorClass;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/http.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Ketrics SDK - HTTP Client Interfaces
+ *
+ * Provides type definitions for making external API requests
+ * from tenant applications.
+ */
+/**
+ * HTTP Request Configuration
+ */
+export interface HttpRequestConfig {
+    /** Request headers */
+    headers?: Record<string, string>;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Query parameters */
+    params?: Record<string, string | number | boolean>;
+    /** Maximum redirects to follow */
+    maxRedirects?: number;
+}
+/**
+ * HTTP Response
+ */
+export interface HttpResponse<T = unknown> {
+    /** Response data */
+    data: T;
+    /** HTTP status code */
+    status: number;
+    /** HTTP status text */
+    statusText: string;
+    /** Response headers */
+    headers: Record<string, string>;
+}
+/**
+ * HTTP Client Interface
+ *
+ * Simple HTTP client for making external API requests.
+ * Wraps axios with default timeout and user agent.
+ */
+export interface HttpClient {
+    /**
+     * Send GET request
+     */
+    get<T = unknown>(url: string, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    /**
+     * Send POST request
+     */
+    post<T = unknown>(url: string, data?: unknown, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    /**
+     * Send PUT request
+     */
+    put<T = unknown>(url: string, data?: unknown, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    /**
+     * Send DELETE request
+     */
+    delete<T = unknown>(url: string, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACnD,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,oBAAoB;IACpB,IAAI,EAAE,CAAC,CAAC;IACR,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAEpF;;OAEG;IACH,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAErG;;OAEG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAEpG;;OAEG;IACH,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;CACxF"}

package/dist/http.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Ketrics SDK - HTTP Client Interfaces
+ *
+ * Provides type definitions for making external API requests
+ * from tenant applications.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}