@ketrics/sdk-backend 0.2.0

package/dist/secret-errors.js

@@ -0,0 +1,172 @@
+"use strict";
+/**
+ * Ketrics SDK - Secret Error Classes
+ *
+ * Provides typed errors for secret operations in tenant applications.
+ *
+ * Error Hierarchy:
+ * - SecretError (base)
+ *   - SecretNotFoundError
+ *   - SecretAccessDeniedError
+ *   - SecretDecryptionError
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SecretDecryptionError = exports.SecretAccessDeniedError = exports.SecretNotFoundError = exports.SecretError = void 0;
+exports.isSecretError = isSecretError;
+exports.isSecretErrorType = isSecretErrorType;
+// ============================================================================
+// Base Error Class
+// ============================================================================
+/**
+ * Base error class for all Secret errors
+ *
+ * All Secret errors extend this class and include:
+ * - secretCode: The secret code that caused the error
+ * - operation: The operation that failed
+ * - timestamp: When the error occurred
+ */
+class SecretError extends Error {
+    constructor(message, secretCode, operation) {
+        super(message);
+        this.name = this.constructor.name;
+        this.secretCode = secretCode;
+        this.operation = operation;
+        this.timestamp = new Date();
+        // Maintains proper stack trace for where error was thrown
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Serialize error for logging
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            secretCode: this.secretCode,
+            operation: this.operation,
+            timestamp: this.timestamp.toISOString(),
+        };
+    }
+}
+exports.SecretError = SecretError;
+// ============================================================================
+// Specific Error Classes
+// ============================================================================
+/**
+ * Error thrown when a secret is not found
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const secret = await ketrics.Secret.get('unknown-secret');
+ * } catch (error) {
+ *   if (error instanceof ketrics.SecretNotFoundError) {
+ *     console.log(`Secret '${error.secretCode}' not found`);
+ *   }
+ * }
+ * ```
+ */
+class SecretNotFoundError extends SecretError {
+    constructor(secretCode) {
+        super(`Secret '${secretCode}' not found. Verify the secret code is correct and the secret exists.`, secretCode, 'get');
+    }
+}
+exports.SecretNotFoundError = SecretNotFoundError;
+/**
+ * Error thrown when application does not have access to a secret
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const secret = await ketrics.Secret.get('restricted-secret');
+ * } catch (error) {
+ *   if (error instanceof ketrics.SecretAccessDeniedError) {
+ *     console.log(`No access to secret '${error.secretCode}'`);
+ *   }
+ * }
+ * ```
+ */
+class SecretAccessDeniedError extends SecretError {
+    constructor(secretCode) {
+        super(`Access denied to secret '${secretCode}'. The application does not have an access grant for this secret.`, secretCode, 'get');
+    }
+}
+exports.SecretAccessDeniedError = SecretAccessDeniedError;
+/**
+ * Error thrown when secret decryption fails
+ *
+ * This typically indicates a KMS key issue or corrupted data.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const secret = await ketrics.Secret.get('encrypted-secret');
+ * } catch (error) {
+ *   if (error instanceof ketrics.SecretDecryptionError) {
+ *     console.log(`Failed to decrypt secret: ${error.reason}`);
+ *   }
+ * }
+ * ```
+ */
+class SecretDecryptionError extends SecretError {
+    constructor(secretCode, reason) {
+        super(`Failed to decrypt secret '${secretCode}': ${reason}`, secretCode, 'decrypt');
+        this.reason = reason;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            reason: this.reason,
+        };
+    }
+}
+exports.SecretDecryptionError = SecretDecryptionError;
+// ============================================================================
+// Type Guards
+// ============================================================================
+/**
+ * Type guard to check if an error is a SecretError
+ *
+ * @param error - The error to check
+ * @returns True if the error is a SecretError
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const secret = await ketrics.Secret.get('my-secret');
+ * } catch (error) {
+ *   if (isSecretError(error)) {
+ *     console.log(`Secret error: ${error.secretCode}`);
+ *   }
+ * }
+ * ```
+ */
+function isSecretError(error) {
+    return error instanceof SecretError;
+}
+/**
+ * Type guard to check if an error is a specific SecretError type
+ *
+ * @param error - The error to check
+ * @param errorClass - The error class to check against
+ * @returns True if the error is an instance of the specified class
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const secret = await ketrics.Secret.get('my-secret');
+ * } catch (error) {
+ *   if (isSecretErrorType(error, SecretNotFoundError)) {
+ *     console.log('Secret not found');
+ *   } else if (isSecretErrorType(error, SecretAccessDeniedError)) {
+ *     console.log('Access denied');
+ *   }
+ * }
+ * ```
+ */
+function isSecretErrorType(error, errorClass) {
+    return error instanceof errorClass;
+}
+//# sourceMappingURL=secret-errors.js.map

package/dist/secret-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret-errors.js","sourceRoot":"","sources":["../src/secret-errors.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAiKH,sCAEC;AAsBD,8CAKC;AA5LD,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAsB,WAAY,SAAQ,KAAK;IAU7C,YAAY,OAAe,EAAE,UAAkB,EAAE,SAAiB;QAChE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAE5B,0DAA0D;QAC1D,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;SACxC,CAAC;IACJ,CAAC;CACF;AAnCD,kCAmCC;AAED,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E;;;;;;;;;;;;;GAaG;AACH,MAAa,mBAAoB,SAAQ,WAAW;IAClD,YAAY,UAAkB;QAC5B,KAAK,CACH,WAAW,UAAU,uEAAuE,EAC5F,UAAU,EACV,KAAK,CACN,CAAC;IACJ,CAAC;CACF;AARD,kDAQC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAa,uBAAwB,SAAQ,WAAW;IACtD,YAAY,UAAkB;QAC5B,KAAK,CACH,4BAA4B,UAAU,mEAAmE,EACzG,UAAU,EACV,KAAK,CACN,CAAC;IACJ,CAAC;CACF;AARD,0DAQC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAa,qBAAsB,SAAQ,WAAW;IAIpD,YAAY,UAAkB,EAAE,MAAc;QAC5C,KAAK,CACH,6BAA6B,UAAU,MAAM,MAAM,EAAE,EACrD,UAAU,EACV,SAAS,CACV,CAAC;QACF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,MAAM;QACJ,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;IACJ,CAAC;CACF;AAnBD,sDAmBC;AAED,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,aAAa,CAAC,KAAc;IAC1C,OAAO,KAAK,YAAY,WAAW,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,iBAAiB,CAC/B,KAAc,EACd,UAAuC;IAEvC,OAAO,KAAK,YAAY,UAAU,CAAC;AACrC,CAAC"}

package/dist/secrets.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Ketrics SDK - Secret Interfaces
+ *
+ * Provides type definitions for accessing encrypted secrets
+ * from tenant applications.
+ *
+ * Usage in tenant code:
+ * ```typescript
+ * // Get a secret value
+ * const apiKey = await ketrics.Secret.get('stripe-api-key');
+ * console.log('API Key retrieved');
+ *
+ * // Check if a secret exists
+ * if (await ketrics.Secret.exists('optional-api-key')) {
+ *   const key = await ketrics.Secret.get('optional-api-key');
+ *   // Use the key
+ * }
+ * ```
+ *
+ * Error Handling:
+ * - Secret.get() throws SecretNotFoundError if secret doesn't exist
+ * - Secret.get() throws SecretAccessDeniedError if no access grant
+ * - Secret.get() throws SecretDecryptionError if decryption fails
+ */
+/**
+ * Secret Interface
+ *
+ * Static interface for retrieving secret values.
+ * Secrets are encrypted at rest using tenant-specific KMS keys.
+ */
+export interface ISecret {
+    /**
+     * Get a secret value by code
+     *
+     * @param secretCode - Secret code (e.g., "api-key", "db-password")
+     * @returns The decrypted secret value
+     * @throws SecretNotFoundError if secret doesn't exist
+     * @throws SecretAccessDeniedError if application has no access grant
+     * @throws SecretDecryptionError if decryption fails
+     */
+    get(secretCode: string): Promise<string>;
+    /**
+     * Check if a secret exists and is accessible
+     *
+     * @param secretCode - Secret code to check
+     * @returns True if secret exists and is accessible
+     */
+    exists(secretCode: string): Promise<boolean>;
+}
+//# sourceMappingURL=secrets.d.ts.map

package/dist/secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB;;;;;;;;OAQG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEzC;;;;;OAKG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9C"}

package/dist/secrets.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Ketrics SDK - Secret Interfaces
+ *
+ * Provides type definitions for accessing encrypted secrets
+ * from tenant applications.
+ *
+ * Usage in tenant code:
+ * ```typescript
+ * // Get a secret value
+ * const apiKey = await ketrics.Secret.get('stripe-api-key');
+ * console.log('API Key retrieved');
+ *
+ * // Check if a secret exists
+ * if (await ketrics.Secret.exists('optional-api-key')) {
+ *   const key = await ketrics.Secret.get('optional-api-key');
+ *   // Use the key
+ * }
+ * ```
+ *
+ * Error Handling:
+ * - Secret.get() throws SecretNotFoundError if secret doesn't exist
+ * - Secret.get() throws SecretAccessDeniedError if no access grant
+ * - Secret.get() throws SecretDecryptionError if decryption fails
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=secrets.js.map

package/dist/secrets.js.map

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

package/dist/volumes.d.ts

@@ -0,0 +1,276 @@
+/**
+ * Ketrics SDK - Volume Interfaces and Types
+ *
+ * Provides type definitions for S3-backed volume storage
+ * accessible from tenant applications.
+ */
+import { Readable } from 'stream';
+/**
+ * Content types for put operations
+ */
+export type PutContent = string | Buffer | Readable;
+/**
+ * File content returned from get operation
+ */
+export interface FileContent {
+    /** File content as Buffer */
+    content: Buffer;
+    /** MIME type of the file */
+    contentType: string;
+    /** Size in bytes */
+    contentLength: number;
+    /** Last modification date */
+    lastModified: Date;
+    /** Entity tag (hash of content) */
+    etag: string;
+    /** Custom metadata if present */
+    metadata?: Record<string, string>;
+}
+/**
+ * File metadata without content
+ */
+export interface FileMetadata {
+    /** Relative path within volume */
+    key: string;
+    /** Size in bytes */
+    size: number;
+    /** MIME type */
+    contentType: string;
+    /** Last modification date */
+    lastModified: Date;
+    /** Entity tag */
+    etag: string;
+    /** Custom metadata if present */
+    metadata?: Record<string, string>;
+}
+/**
+ * File info in list results
+ */
+export interface FileInfo {
+    /** Relative path within volume */
+    key: string;
+    /** Size in bytes */
+    size: number;
+    /** Last modification date */
+    lastModified: Date;
+    /** Entity tag */
+    etag: string;
+    /** MIME type (optional) */
+    contentType?: string;
+}
+/**
+ * Options for put operation
+ */
+export interface PutOptions {
+    /** MIME type (auto-detected if not provided) */
+    contentType?: string;
+    /** Custom metadata to store with object */
+    metadata?: Record<string, string>;
+    /** Only create if file doesn't exist */
+    ifNotExists?: boolean;
+}
+/**
+ * Result of put operation
+ */
+export interface PutResult {
+    /** Relative path (user-facing) */
+    key: string;
+    /** Entity tag */
+    etag: string;
+    /** Version ID (if versioning enabled) */
+    versionId?: string;
+    /** Size in bytes */
+    size: number;
+}
+/**
+ * Result of delete operation
+ */
+export interface DeleteResult {
+    /** Deleted file key */
+    key: string;
+    /** Whether delete succeeded */
+    deleted: boolean;
+    /** Version ID (if versioning enabled) */
+    versionId?: string;
+}
+/**
+ * Delete error info for batch operations
+ */
+export interface DeleteError {
+    /** File key that failed */
+    key: string;
+    /** Error code */
+    code: string;
+    /** Error message */
+    message: string;
+}
+/**
+ * Result of deleteByPrefix operation
+ */
+export interface DeleteByPrefixResult {
+    /** Prefix that was deleted */
+    prefix: string;
+    /** Number of objects deleted */
+    deletedCount: number;
+    /** Keys of deleted objects */
+    deletedKeys: string[];
+    /** Any errors that occurred */
+    errors?: DeleteError[];
+}
+/**
+ * Options for list operation
+ */
+export interface ListOptions {
+    /** Filter by key prefix */
+    prefix?: string;
+    /** Maximum items to return (default: 1000, max: 1000) */
+    maxResults?: number;
+    /** Pagination token from previous response */
+    continuationToken?: string;
+    /** Delimiter for hierarchical listing (e.g., '/') */
+    delimiter?: string;
+}
+/**
+ * Result of list operation
+ */
+export interface ListResult {
+    /** Array of file info objects */
+    files: FileInfo[];
+    /** Folder prefixes (only present when delimiter is specified) */
+    folders?: string[];
+    /** Whether more results are available */
+    isTruncated: boolean;
+    /** Token for fetching next page */
+    continuationToken?: string;
+    /** Number of files returned */
+    count: number;
+}
+/**
+ * Options for copy operation
+ */
+export interface CopyOptions {
+    /** Only copy if destination doesn't exist */
+    ifNotExists?: boolean;
+    /** Replace metadata on copy */
+    metadata?: Record<string, string>;
+    /** Metadata directive: COPY or REPLACE */
+    metadataDirective?: 'COPY' | 'REPLACE';
+}
+/**
+ * Result of copy operation
+ */
+export interface CopyResult {
+    /** Source file key */
+    sourceKey: string;
+    /** Destination file key */
+    destinationKey: string;
+    /** Entity tag of copied object */
+    etag: string;
+    /** Last modified date of copy */
+    lastModified: Date;
+}
+/**
+ * Options for move operation
+ */
+export interface MoveOptions {
+    /** Only move if destination doesn't exist */
+    ifNotExists?: boolean;
+}
+/**
+ * Result of move operation
+ */
+export interface MoveResult {
+    /** Source file key */
+    sourceKey: string;
+    /** Destination file key */
+    destinationKey: string;
+    /** Entity tag of moved object */
+    etag: string;
+}
+/**
+ * Options for download URL generation
+ */
+export interface DownloadUrlOptions {
+    /** Seconds until expiration (default: 3600, max: 86400) */
+    expiresIn?: number;
+    /** Override response content type */
+    responseContentType?: string;
+    /** Content-Disposition header (e.g., 'attachment; filename="report.pdf"') */
+    responseContentDisposition?: string;
+}
+/**
+ * Options for upload URL generation
+ */
+export interface UploadUrlOptions {
+    /** Seconds until expiration (default: 3600, max: 86400) */
+    expiresIn?: number;
+    /** Required content type for upload */
+    contentType?: string;
+    /** Maximum upload size in bytes */
+    maxSize?: number;
+}
+/**
+ * Presigned URL result
+ */
+export interface PresignedUrl {
+    /** The presigned URL */
+    url: string;
+    /** Expiration timestamp */
+    expiresAt: Date;
+    /** HTTP method for the URL */
+    method: 'GET' | 'PUT';
+    /** Additional fields for POST-based uploads */
+    fields?: Record<string, string>;
+}
+/**
+ * Volume Interface
+ *
+ * Interface for a connected volume with file operations.
+ * Use Volume.connect() to obtain an instance.
+ *
+ * @example
+ * ```typescript
+ * const volume = await Volume.connect('uploads');
+ *
+ * // Read operations
+ * const file = await volume.get('documents/report.pdf');
+ * const exists = await volume.exists('config.json');
+ * const meta = await volume.getMetadata('image.png');
+ *
+ * // Write operations
+ * await volume.put('data/output.json', JSON.stringify(data));
+ *
+ * // Delete operations
+ * await volume.delete('temp/file.txt');
+ * await volume.deleteByPrefix('temp/');
+ *
+ * // List operations
+ * const files = await volume.list({ prefix: 'documents/' });
+ *
+ * // File management
+ * await volume.copy('source.pdf', 'backup/source.pdf');
+ * await volume.move('temp/upload.pdf', 'final/document.pdf');
+ *
+ * // URL generation
+ * const downloadUrl = await volume.generateDownloadUrl('report.pdf');
+ * const uploadUrl = await volume.generateUploadUrl('uploads/new-file.pdf');
+ * ```
+ */
+export interface IVolume {
+    /** Volume code (read-only) */
+    readonly code: string;
+    /** Granted permissions (read-only) */
+    readonly permissions: ReadonlySet<string>;
+    get(key: string): Promise<FileContent>;
+    exists(key: string): Promise<boolean>;
+    getMetadata(key: string): Promise<FileMetadata>;
+    put(key: string, content: PutContent, options?: PutOptions): Promise<PutResult>;
+    delete(key: string): Promise<DeleteResult>;
+    deleteByPrefix(prefix: string): Promise<DeleteByPrefixResult>;
+    list(options?: ListOptions): Promise<ListResult>;
+    copy(sourceKey: string, destinationKey: string, options?: CopyOptions): Promise<CopyResult>;
+    move(sourceKey: string, destinationKey: string, options?: MoveOptions): Promise<MoveResult>;
+    generateDownloadUrl(key: string, options?: DownloadUrlOptions): Promise<PresignedUrl>;
+    generateUploadUrl(key: string, options?: UploadUrlOptions): Promise<PresignedUrl>;
+}
+//# sourceMappingURL=volumes.d.ts.map

package/dist/volumes.d.ts.map

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

package/dist/volumes.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Ketrics SDK - Volume Interfaces and Types
+ *
+ * Provides type definitions for S3-backed volume storage
+ * accessible from tenant applications.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=volumes.js.map

package/dist/volumes.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@ketrics/sdk-backend",
+  "version": "0.2.0",
+  "description": "Ketrics SDK for backend tenant application code (VM sandbox)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "ketrics",
+    "sdk",
+    "typescript",
+    "types",
+    "tenant",
+    "saas"
+  ],
+  "author": "Ketrics",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ketrics/cl-ketrics-mvp.git",
+    "directory": "ketrics-sdk-backend"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.2",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "@types/node": ">=18.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}