@sentzunhat/zacatl 0.0.14 → 0.0.21

package/build/error/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./bad-request";
+export * from "./bad-resource";
+export * from "./custom";
+export * from "./forbidden";
+export * from "./internal-server";
+export * from "./not-found";
+export * from "./unauthorized";
+export * from "./validation";
+//# sourceMappingURL=index.d.ts.map

package/build/error/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"./src/","sources":["error/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/build/error/index.js

@@ -0,0 +1,9 @@
+export * from "./bad-request";
+export * from "./bad-resource";
+export * from "./custom";
+export * from "./forbidden";
+export * from "./internal-server";
+export * from "./not-found";
+export * from "./unauthorized";
+export * from "./validation";
+//# sourceMappingURL=index.js.map

package/build/error/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"./src/","sources":["error/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC","sourcesContent":["export * from \"./bad-request\";\nexport * from \"./bad-resource\";\nexport * from \"./custom\";\nexport * from \"./forbidden\";\nexport * from \"./internal-server\";\nexport * from \"./not-found\";\nexport * from \"./unauthorized\";\nexport * from \"./validation\";\n"]}

package/build/error/internal-server.d.ts

@@ -0,0 +1,7 @@
+import { CustomError, CustomErrorsArgs } from "./custom";
+export interface InternalServerErrorArgs extends CustomErrorsArgs {
+}
+export declare class InternalServerError extends CustomError {
+    constructor({ message, reason, metadata, error }: InternalServerErrorArgs);
+}
+//# sourceMappingURL=internal-server.d.ts.map

package/build/error/internal-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-server.d.ts","sourceRoot":"./src/","sources":["error/internal-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEzD,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB;CAAG;AAEpE,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,uBAAuB;CAS1E"}

package/build/error/internal-server.js

@@ -0,0 +1,13 @@
+import { CustomError } from "./custom";
+export class InternalServerError extends CustomError {
+    constructor({ message, reason, metadata, error }) {
+        super({
+            message,
+            code: 500,
+            reason,
+            metadata,
+            error,
+        });
+    }
+}
+//# sourceMappingURL=internal-server.js.map

package/build/error/internal-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-server.js","sourceRoot":"./src/","sources":["error/internal-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAoB,MAAM,UAAU,CAAC;AAIzD,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAClD,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAA2B;QACvE,KAAK,CAAC;YACJ,OAAO;YACP,IAAI,EAAE,GAAG;YACT,MAAM;YACN,QAAQ;YACR,KAAK;SACN,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { CustomError, CustomErrorsArgs } from \"./custom\";\n\nexport interface InternalServerErrorArgs extends CustomErrorsArgs {}\n\nexport class InternalServerError extends CustomError {\n  constructor({ message, reason, metadata, error }: InternalServerErrorArgs) {\n    super({\n      message,\n      code: 500,\n      reason,\n      metadata,\n      error,\n    });\n  }\n}\n"]}

package/build/error/not-found.d.ts

@@ -0,0 +1,7 @@
+import { CustomError, CustomErrorsArgs } from "./custom";
+export interface NotFoundErrorArgs extends CustomErrorsArgs {
+}
+export declare class NotFoundError extends CustomError {
+    constructor({ message, reason, metadata, error }: NotFoundErrorArgs);
+}
+//# sourceMappingURL=not-found.d.ts.map

package/build/error/not-found.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"not-found.d.ts","sourceRoot":"./src/","sources":["error/not-found.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEzD,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;CAAG;AAE9D,qBAAa,aAAc,SAAQ,WAAW;gBAChC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,iBAAiB;CASpE"}

package/build/error/not-found.js

@@ -0,0 +1,13 @@
+import { CustomError } from "./custom";
+export class NotFoundError extends CustomError {
+    constructor({ message, reason, metadata, error }) {
+        super({
+            message,
+            code: 404,
+            reason,
+            metadata,
+            error,
+        });
+    }
+}
+//# sourceMappingURL=not-found.js.map

package/build/error/not-found.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"not-found.js","sourceRoot":"./src/","sources":["error/not-found.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAoB,MAAM,UAAU,CAAC;AAIzD,MAAM,OAAO,aAAc,SAAQ,WAAW;IAC5C,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAqB;QACjE,KAAK,CAAC;YACJ,OAAO;YACP,IAAI,EAAE,GAAG;YACT,MAAM;YACN,QAAQ;YACR,KAAK;SACN,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { CustomError, CustomErrorsArgs } from \"./custom\";\n\nexport interface NotFoundErrorArgs extends CustomErrorsArgs {}\n\nexport class NotFoundError extends CustomError {\n  constructor({ message, reason, metadata, error }: NotFoundErrorArgs) {\n    super({\n      message,\n      code: 404,\n      reason,\n      metadata,\n      error,\n    });\n  }\n}\n"]}

package/build/error/unauthorized.d.ts

@@ -0,0 +1,7 @@
+import { CustomError, CustomErrorsArgs } from "./custom";
+export interface UnauthorizedErrorArgs extends CustomErrorsArgs {
+}
+export declare class UnauthorizedError extends CustomError {
+    constructor({ message, reason, metadata, error }: UnauthorizedErrorArgs);
+}
+//# sourceMappingURL=unauthorized.d.ts.map

package/build/error/unauthorized.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unauthorized.d.ts","sourceRoot":"./src/","sources":["error/unauthorized.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEzD,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;CAAG;AAElE,qBAAa,iBAAkB,SAAQ,WAAW;gBACpC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,qBAAqB;CASxE"}

package/build/error/unauthorized.js

@@ -0,0 +1,13 @@
+import { CustomError } from "./custom";
+export class UnauthorizedError extends CustomError {
+    constructor({ message, reason, metadata, error }) {
+        super({
+            message,
+            code: 401,
+            reason,
+            metadata,
+            error,
+        });
+    }
+}
+//# sourceMappingURL=unauthorized.js.map

package/build/error/unauthorized.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unauthorized.js","sourceRoot":"./src/","sources":["error/unauthorized.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAoB,MAAM,UAAU,CAAC;AAIzD,MAAM,OAAO,iBAAkB,SAAQ,WAAW;IAChD,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAyB;QACrE,KAAK,CAAC;YACJ,OAAO;YACP,IAAI,EAAE,GAAG;YACT,MAAM;YACN,QAAQ;YACR,KAAK;SACN,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { CustomError, CustomErrorsArgs } from \"./custom\";\n\nexport interface UnauthorizedErrorArgs extends CustomErrorsArgs {}\n\nexport class UnauthorizedError extends CustomError {\n  constructor({ message, reason, metadata, error }: UnauthorizedErrorArgs) {\n    super({\n      message,\n      code: 401,\n      reason,\n      metadata,\n      error,\n    });\n  }\n}\n"]}

package/build/error/validation.d.ts

@@ -0,0 +1,7 @@
+import { CustomError, CustomErrorsArgs } from "./custom";
+export interface ValidationErrorArgs extends CustomErrorsArgs {
+}
+export declare class ValidationError extends CustomError {
+    constructor({ message, reason, metadata, error }: ValidationErrorArgs);
+}
+//# sourceMappingURL=validation.d.ts.map

package/build/error/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"./src/","sources":["error/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEzD,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;CAAG;AAEhE,qBAAa,eAAgB,SAAQ,WAAW;gBAClC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,mBAAmB;CAStE"}

package/build/error/validation.js

@@ -0,0 +1,13 @@
+import { CustomError } from "./custom";
+export class ValidationError extends CustomError {
+    constructor({ message, reason, metadata, error }) {
+        super({
+            message,
+            code: 422,
+            reason,
+            metadata,
+            error,
+        });
+    }
+}
+//# sourceMappingURL=validation.js.map

package/build/error/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"./src/","sources":["error/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAoB,MAAM,UAAU,CAAC;AAIzD,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC9C,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAuB;QACnE,KAAK,CAAC;YACJ,OAAO;YACP,IAAI,EAAE,GAAG;YACT,MAAM;YACN,QAAQ;YACR,KAAK;SACN,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { CustomError, CustomErrorsArgs } from \"./custom\";\n\nexport interface ValidationErrorArgs extends CustomErrorsArgs {}\n\nexport class ValidationError extends CustomError {\n  constructor({ message, reason, metadata, error }: ValidationErrorArgs) {\n    super({\n      message,\n      code: 422,\n      reason,\n      metadata,\n      error,\n    });\n  }\n}\n"]}

package/build/examples/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./providers";
+export * from "./repositories";
+//# sourceMappingURL=index.d.ts.map

package/build/examples/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"./src/","sources":["examples/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC"}

package/build/examples/index.js

@@ -0,0 +1,3 @@
+export * from "./providers";
+export * from "./repositories";
+//# sourceMappingURL=index.js.map

package/build/examples/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"./src/","sources":["examples/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC","sourcesContent":["export * from \"./providers\";\nexport * from \"./repositories\";\n"]}

package/build/examples/providers/file-system-provider.d.ts

@@ -0,0 +1,13 @@
+export interface FileSystemProviderConfig {
+    basePath: string;
+}
+export declare class FileSystemProvider {
+    private basePath;
+    constructor(config: FileSystemProviderConfig);
+    readFile(filePath: string): Promise<string>;
+    writeFile(filePath: string, contents: string): Promise<void>;
+    fileExists(filePath: string): Promise<boolean>;
+    deleteFile(filePath: string): Promise<void>;
+    listFiles(dirPath: string): Promise<string[]>;
+}
+//# sourceMappingURL=file-system-provider.d.ts.map

package/build/examples/providers/file-system-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system-provider.d.ts","sourceRoot":"./src/","sources":["examples/providers/file-system-provider.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,wBAAwB;IAOtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkB3C,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB5D,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAa9C,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB3C,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAcpD"}

package/build/examples/providers/file-system-provider.js

@@ -0,0 +1,82 @@
+import { promises as fs } from "fs";
+import path from "path";
+import { CustomError } from "../../error";
+export class FileSystemProvider {
+    basePath;
+    constructor(config) {
+        this.basePath = config.basePath;
+    }
+    async readFile(filePath) {
+        try {
+            const fullPath = path.join(this.basePath, filePath);
+            return await fs.readFile(fullPath, "utf-8");
+        }
+        catch (error) {
+            throw new CustomError({
+                message: `Failed to read file: ${filePath}`,
+                code: 500,
+                reason: "file read error",
+                error: error,
+                metadata: { filePath },
+            });
+        }
+    }
+    async writeFile(filePath, contents) {
+        try {
+            const fullPath = path.join(this.basePath, filePath);
+            const dir = path.dirname(fullPath);
+            await fs.mkdir(dir, { recursive: true });
+            await fs.writeFile(fullPath, contents, "utf-8");
+        }
+        catch (error) {
+            throw new CustomError({
+                message: `Failed to write file: ${filePath}`,
+                code: 500,
+                reason: "file write error",
+                error: error,
+                metadata: { filePath },
+            });
+        }
+    }
+    async fileExists(filePath) {
+        try {
+            const fullPath = path.join(this.basePath, filePath);
+            await fs.access(fullPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async deleteFile(filePath) {
+        try {
+            const fullPath = path.join(this.basePath, filePath);
+            await fs.unlink(fullPath);
+        }
+        catch (error) {
+            throw new CustomError({
+                message: `Failed to delete file: ${filePath}`,
+                code: 500,
+                reason: "file deletion error",
+                error: error,
+                metadata: { filePath },
+            });
+        }
+    }
+    async listFiles(dirPath) {
+        try {
+            const fullPath = path.join(this.basePath, dirPath);
+            return await fs.readdir(fullPath);
+        }
+        catch (error) {
+            throw new CustomError({
+                message: `Failed to list files in: ${dirPath}`,
+                code: 500,
+                reason: "directory read error",
+                error: error,
+                metadata: { dirPath },
+            });
+        }
+    }
+}
+//# sourceMappingURL=file-system-provider.js.map

package/build/examples/providers/file-system-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system-provider.js","sourceRoot":"./src/","sources":["examples/providers/file-system-provider.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * FileSystemProvider\n * Handles reading and writing configuration files (YAML, JSON, CSV)\n * Useful for CLI tools that need to persist user preferences and settings\n */\nimport { promises as fs } from \"fs\";\nimport path from \"path\";\nimport { CustomError } from \"../../error\";\n\nexport interface FileSystemProviderConfig {\n  basePath: string;\n}\n\nexport class FileSystemProvider {\n  private basePath: string;\n\n  constructor(config: FileSystemProviderConfig) {\n    this.basePath = config.basePath;\n  }\n\n  /**\n   * Read a file and return its contents as text\n   */\n  async readFile(filePath: string): Promise<string> {\n    try {\n      const fullPath = path.join(this.basePath, filePath);\n      return await fs.readFile(fullPath, \"utf-8\");\n    } catch (error: unknown) {\n      throw new CustomError({\n        message: `Failed to read file: ${filePath}`,\n        code: 500,\n        reason: \"file read error\",\n        error: error as Error,\n        metadata: { filePath },\n      });\n    }\n  }\n\n  /**\n   * Write text contents to a file\n   */\n  async writeFile(filePath: string, contents: string): Promise<void> {\n    try {\n      const fullPath = path.join(this.basePath, filePath);\n      const dir = path.dirname(fullPath);\n\n      // Create directory if it doesn't exist\n      await fs.mkdir(dir, { recursive: true });\n      await fs.writeFile(fullPath, contents, \"utf-8\");\n    } catch (error: unknown) {\n      throw new CustomError({\n        message: `Failed to write file: ${filePath}`,\n        code: 500,\n        reason: \"file write error\",\n        error: error as Error,\n        metadata: { filePath },\n      });\n    }\n  }\n\n  /**\n   * Check if a file exists\n   */\n  async fileExists(filePath: string): Promise<boolean> {\n    try {\n      const fullPath = path.join(this.basePath, filePath);\n      await fs.access(fullPath);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Delete a file\n   */\n  async deleteFile(filePath: string): Promise<void> {\n    try {\n      const fullPath = path.join(this.basePath, filePath);\n      await fs.unlink(fullPath);\n    } catch (error: unknown) {\n      throw new CustomError({\n        message: `Failed to delete file: ${filePath}`,\n        code: 500,\n        reason: \"file deletion error\",\n        error: error as Error,\n        metadata: { filePath },\n      });\n    }\n  }\n\n  /**\n   * List files in a directory\n   */\n  async listFiles(dirPath: string): Promise<string[]> {\n    try {\n      const fullPath = path.join(this.basePath, dirPath);\n      return await fs.readdir(fullPath);\n    } catch (error: unknown) {\n      throw new CustomError({\n        message: `Failed to list files in: ${dirPath}`,\n        code: 500,\n        reason: \"directory read error\",\n        error: error as Error,\n        metadata: { dirPath },\n      });\n    }\n  }\n}\n"]}

package/build/examples/providers/filesystem-provider.d.ts

@@ -0,0 +1,15 @@
+export interface FileSystemProviderConfig {
+    encoding?: BufferEncoding;
+}
+export declare class FileSystemProvider {
+    private encoding;
+    constructor(config?: FileSystemProviderConfig);
+    readYAML: (filePath: string) => Record<string, unknown>;
+    readJSON: (filePath: string) => unknown;
+    readText: (filePath: string) => string;
+    writeYAML: (filePath: string, data: Record<string, unknown>) => void;
+    writeJSON: (filePath: string, data: unknown, pretty?: boolean) => void;
+    writeText: (filePath: string, content: string) => void;
+    exists(filePath: string): boolean;
+}
+//# sourceMappingURL=filesystem-provider.d.ts.map

package/build/examples/providers/filesystem-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-provider.d.ts","sourceRoot":"./src/","sources":["examples/providers/filesystem-provider.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAgBD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAiB;gBAErB,MAAM,GAAE,wBAA6B;IAOjD,QAAQ,GAAI,UAAU,MAAM,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwBpD;IAKF,QAAQ,GAAI,UAAU,MAAM,KAAG,OAAO,CAuBpC;IAKF,QAAQ,GAAI,UAAU,MAAM,KAAG,MAAM,CAsBnC;IAKF,SAAS,GAAI,UAAU,MAAM,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI,CAgBjE;IAKF,SAAS,GAAI,UAAU,MAAM,EAAE,MAAM,OAAO,EAAE,gBAAa,KAAG,IAAI,CAiBhE;IAKF,SAAS,GAAI,UAAU,MAAM,EAAE,SAAS,MAAM,KAAG,IAAI,CAcnD;IAKF,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAIlC"}

package/build/examples/providers/filesystem-provider.js

@@ -0,0 +1,139 @@
+import { readFileSync, writeFileSync, existsSync } from "fs";
+import { homedir } from "os";
+import { CustomError } from "../../error";
+const expandUserPath = (filePath) => {
+    if (filePath.startsWith("~/")) {
+        return filePath.replace("~", homedir());
+    }
+    return filePath;
+};
+export class FileSystemProvider {
+    encoding;
+    constructor(config = {}) {
+        this.encoding = config.encoding || "utf-8";
+    }
+    readYAML = (filePath) => {
+        const path = expandUserPath(filePath);
+        try {
+            if (!existsSync(path)) {
+                throw new CustomError({
+                    message: `File not found: ${filePath}`,
+                    code: 404,
+                    reason: "file does not exist",
+                });
+            }
+            const yaml = require("js-yaml");
+            const content = readFileSync(path, this.encoding);
+            return yaml.load(content);
+        }
+        catch (error) {
+            throw new CustomError({
+                message: `Failed to read YAML file: ${filePath}`,
+                code: 500,
+                reason: "file read error",
+                error: error,
+                metadata: { filePath },
+            });
+        }
+    };
+    readJSON = (filePath) => {
+        const path = expandUserPath(filePath);
+        try {
+            if (!existsSync(path)) {
+                throw new CustomError({
+                    message: `File not found: ${filePath}`,
+                    code: 404,
+                    reason: "file does not exist",
+                });
+            }
+            const content = readFileSync(path, this.encoding);
+            return JSON.parse(content);
+        }
+        catch (error) {
+            throw new CustomError({
+                message: `Failed to read JSON file: ${filePath}`,
+                code: 500,
+                reason: "file read error",
+                error: error,
+                metadata: { filePath },
+            });
+        }
+    };
+    readText = (filePath) => {
+        const path = expandUserPath(filePath);
+        try {
+            if (!existsSync(path)) {
+                throw new CustomError({
+                    message: `File not found: ${filePath}`,
+                    code: 404,
+                    reason: "file does not exist",
+                });
+            }
+            return readFileSync(path, this.encoding);
+        }
+        catch (error) {
+            throw new CustomError({
+                message: `Failed to read text file: ${filePath}`,
+                code: 500,
+                reason: "file read error",
+                error: error,
+                metadata: { filePath },
+            });
+        }
+    };
+    writeYAML = (filePath, data) => {
+        const path = expandUserPath(filePath);
+        try {
+            const yaml = require("js-yaml");
+            const content = yaml.dump(data);
+            writeFileSync(path, content, this.encoding);
+        }
+        catch (error) {
+            throw new CustomError({
+                message: `Failed to write YAML file: ${filePath}`,
+                code: 500,
+                reason: "file write error",
+                error: error,
+                metadata: { filePath },
+            });
+        }
+    };
+    writeJSON = (filePath, data, pretty = true) => {
+        const path = expandUserPath(filePath);
+        try {
+            const content = pretty
+                ? JSON.stringify(data, null, 2)
+                : JSON.stringify(data);
+            writeFileSync(path, content, this.encoding);
+        }
+        catch (error) {
+            throw new CustomError({
+                message: `Failed to write JSON file: ${filePath}`,
+                code: 500,
+                reason: "file write error",
+                error: error,
+                metadata: { filePath },
+            });
+        }
+    };
+    writeText = (filePath, content) => {
+        const path = expandUserPath(filePath);
+        try {
+            writeFileSync(path, content, this.encoding);
+        }
+        catch (error) {
+            throw new CustomError({
+                message: `Failed to write text file: ${filePath}`,
+                code: 500,
+                reason: "file write error",
+                error: error,
+                metadata: { filePath },
+            });
+        }
+    };
+    exists(filePath) {
+        const path = expandUserPath(filePath);
+        return existsSync(path);
+    }
+}
+//# sourceMappingURL=filesystem-provider.js.map

package/build/examples/providers/filesystem-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-provider.js","sourceRoot":"./src/","sources":["examples/providers/filesystem-provider.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Example: FileSystem Provider Implementation\n *\n * Handles reading and writing configuration files (YAML, JSON, CSV)\n * Useful for CLI applications that manage config files\n *\n * Installation: npm install js-yaml\n *\n * @example\n * ```typescript\n * const fsProvider = new FileSystemProvider();\n * const config = await fsProvider.readYAML('~/.config/app/config.yaml');\n * await fsProvider.writeJSON('~/.config/app/state.json', state);\n * ```\n */\nimport { readFileSync, writeFileSync, existsSync } from \"fs\";\nimport { homedir } from \"os\";\nimport { CustomError } from \"../../error\";\n\nexport interface FileSystemProviderConfig {\n  encoding?: BufferEncoding;\n}\n\n/**\n * Expand ~/ to home directory path\n */\nconst expandUserPath = (filePath: string): string => {\n  if (filePath.startsWith(\"~/\")) {\n    return filePath.replace(\"~\", homedir());\n  }\n  return filePath;\n};\n\n/**\n * FileSystem provider for configuration management\n * Supports YAML, JSON, and plain text files\n */\nexport class FileSystemProvider {\n  private encoding: BufferEncoding;\n\n  constructor(config: FileSystemProviderConfig = {}) {\n    this.encoding = config.encoding || \"utf-8\";\n  }\n\n  /**\n   * Read YAML file\n   */\n  readYAML = (filePath: string): Record<string, unknown> => {\n    const path = expandUserPath(filePath);\n\n    try {\n      if (!existsSync(path)) {\n        throw new CustomError({\n          message: `File not found: ${filePath}`,\n          code: 404,\n          reason: \"file does not exist\",\n        });\n      }\n\n      const yaml = require(\"js-yaml\"); // Lazy load\n      const content = readFileSync(path, this.encoding);\n      return yaml.load(content) as Record<string, unknown>;\n    } catch (error: unknown) {\n      throw new CustomError({\n        message: `Failed to read YAML file: ${filePath}`,\n        code: 500,\n        reason: \"file read error\",\n        error: error as Error,\n        metadata: { filePath },\n      });\n    }\n  };\n\n  /**\n   * Read JSON file\n   */\n  readJSON = (filePath: string): unknown => {\n    const path = expandUserPath(filePath);\n\n    try {\n      if (!existsSync(path)) {\n        throw new CustomError({\n          message: `File not found: ${filePath}`,\n          code: 404,\n          reason: \"file does not exist\",\n        });\n      }\n\n      const content = readFileSync(path, this.encoding);\n      return JSON.parse(content);\n    } catch (error: unknown) {\n      throw new CustomError({\n        message: `Failed to read JSON file: ${filePath}`,\n        code: 500,\n        reason: \"file read error\",\n        error: error as Error,\n        metadata: { filePath },\n      });\n    }\n  };\n\n  /**\n   * Read plain text file\n   */\n  readText = (filePath: string): string => {\n    const path = expandUserPath(filePath);\n\n    try {\n      if (!existsSync(path)) {\n        throw new CustomError({\n          message: `File not found: ${filePath}`,\n          code: 404,\n          reason: \"file does not exist\",\n        });\n      }\n\n      return readFileSync(path, this.encoding);\n    } catch (error: unknown) {\n      throw new CustomError({\n        message: `Failed to read text file: ${filePath}`,\n        code: 500,\n        reason: \"file read error\",\n        error: error as Error,\n        metadata: { filePath },\n      });\n    }\n  };\n\n  /**\n   * Write YAML file\n   */\n  writeYAML = (filePath: string, data: Record<string, unknown>): void => {\n    const path = expandUserPath(filePath);\n\n    try {\n      const yaml = require(\"js-yaml\"); // Lazy load\n      const content = yaml.dump(data);\n      writeFileSync(path, content, this.encoding);\n    } catch (error: unknown) {\n      throw new CustomError({\n        message: `Failed to write YAML file: ${filePath}`,\n        code: 500,\n        reason: \"file write error\",\n        error: error as Error,\n        metadata: { filePath },\n      });\n    }\n  };\n\n  /**\n   * Write JSON file\n   */\n  writeJSON = (filePath: string, data: unknown, pretty = true): void => {\n    const path = expandUserPath(filePath);\n\n    try {\n      const content = pretty\n        ? JSON.stringify(data, null, 2)\n        : JSON.stringify(data);\n      writeFileSync(path, content, this.encoding);\n    } catch (error: unknown) {\n      throw new CustomError({\n        message: `Failed to write JSON file: ${filePath}`,\n        code: 500,\n        reason: \"file write error\",\n        error: error as Error,\n        metadata: { filePath },\n      });\n    }\n  };\n\n  /**\n   * Write plain text file\n   */\n  writeText = (filePath: string, content: string): void => {\n    const path = expandUserPath(filePath);\n\n    try {\n      writeFileSync(path, content, this.encoding);\n    } catch (error: unknown) {\n      throw new CustomError({\n        message: `Failed to write text file: ${filePath}`,\n        code: 500,\n        reason: \"file write error\",\n        error: error as Error,\n        metadata: { filePath },\n      });\n    }\n  };\n\n  /**\n   * Check if file exists\n   */\n  exists(filePath: string): boolean {\n    const path = expandUserPath(filePath);\n    return existsSync(path);\n  }\n}\n"]}

package/build/examples/providers/index.d.ts

@@ -0,0 +1,6 @@
+import { ProcessProvider } from "./process-provider";
+import { FileSystemProvider } from "./filesystem-provider";
+export { ProcessProvider, FileSystemProvider };
+export type { ProcessProviderConfig, CommandResult } from "./process-provider";
+export type { FileSystemProviderConfig } from "./filesystem-provider";
+//# sourceMappingURL=index.d.ts.map

package/build/examples/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"./src/","sources":["examples/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,CAAC;AAC/C,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC/E,YAAY,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC"}

package/build/examples/providers/index.js

@@ -0,0 +1,4 @@
+import { ProcessProvider } from "./process-provider";
+import { FileSystemProvider } from "./filesystem-provider";
+export { ProcessProvider, FileSystemProvider };
+//# sourceMappingURL=index.js.map

package/build/examples/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"./src/","sources":["examples/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,CAAC","sourcesContent":["import { ProcessProvider } from \"./process-provider\";\nimport { FileSystemProvider } from \"./filesystem-provider\";\n\nexport { ProcessProvider, FileSystemProvider };\nexport type { ProcessProviderConfig, CommandResult } from \"./process-provider\";\nexport type { FileSystemProviderConfig } from \"./filesystem-provider\";\n"]}

package/build/examples/providers/process-provider.d.ts

@@ -0,0 +1,19 @@
+export interface ProcessProviderConfig {
+    shell?: string;
+    timeout?: number;
+}
+export interface CommandResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    success: boolean;
+}
+export declare class ProcessProvider {
+    private shell;
+    private timeout;
+    constructor(config?: ProcessProviderConfig);
+    execute(command: string): Promise<CommandResult>;
+    executeWithStatus(command: string): Promise<CommandResult>;
+    executeStream(command: string, onStdout?: (data: string) => void, onStderr?: (data: string) => void): Promise<CommandResult>;
+}
+//# sourceMappingURL=process-provider.d.ts.map

package/build/examples/providers/process-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-provider.d.ts","sourceRoot":"./src/","sources":["examples/providers/process-provider.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,GAAE,qBAA0B;IAQxC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAiChD,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAqB1D,aAAa,CACjB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EACjC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAChC,OAAO,CAAC,aAAa,CAAC;CAwD1B"}

package/build/examples/providers/process-provider.js

@@ -0,0 +1,101 @@
+import { exec, spawn } from "child_process";
+import { promisify } from "util";
+import { CustomError } from "../../error";
+const execAsync = promisify(exec);
+export class ProcessProvider {
+    shell;
+    timeout;
+    constructor(config = {}) {
+        this.shell = config.shell || "/bin/bash";
+        this.timeout = config.timeout || 30000;
+    }
+    async execute(command) {
+        try {
+            const { stdout, stderr } = await execAsync(command, {
+                timeout: this.timeout,
+                shell: this.shell,
+            });
+            return {
+                stdout: stdout.trim(),
+                stderr: stderr.trim(),
+                exitCode: 0,
+                success: true,
+            };
+        }
+        catch (error) {
+            const err = error;
+            throw new CustomError({
+                message: `Command execution failed: ${command}`,
+                code: 500,
+                reason: "process execution error",
+                error: err,
+                metadata: {
+                    command,
+                    stdout: err.stdout || "",
+                    stderr: err.stderr || "",
+                },
+            });
+        }
+    }
+    async executeWithStatus(command) {
+        return new Promise((resolve) => {
+            exec(command, { timeout: this.timeout, shell: this.shell }, (error, stdout, stderr) => {
+                resolve({
+                    stdout: stdout.trim(),
+                    stderr: stderr.trim(),
+                    exitCode: error?.code || 0,
+                    success: !error,
+                });
+            });
+        });
+    }
+    async executeStream(command, onStdout, onStderr) {
+        return new Promise((resolve, reject) => {
+            try {
+                const child = spawn(command, [], {
+                    shell: this.shell,
+                    timeout: this.timeout,
+                });
+                let stdout = "";
+                let stderr = "";
+                child.stdout.on("data", (data) => {
+                    const text = data.toString();
+                    stdout += text;
+                    onStdout?.(text);
+                });
+                child.stderr.on("data", (data) => {
+                    const text = data.toString();
+                    stderr += text;
+                    onStderr?.(text);
+                });
+                child.on("close", (code) => {
+                    resolve({
+                        stdout: stdout.trim(),
+                        stderr: stderr.trim(),
+                        exitCode: code || 0,
+                        success: code === 0,
+                    });
+                });
+                child.on("error", (error) => {
+                    reject(new CustomError({
+                        message: `Process error: ${command}`,
+                        code: 500,
+                        reason: "process stream error",
+                        error,
+                        metadata: { command, stderr },
+                    }));
+                });
+            }
+            catch (error) {
+                reject(new CustomError({
+                    message: `Failed to spawn process: ${command}`,
+                    code: 500,
+                    reason: "process spawn error",
+                    error: error,
+                    metadata: { command },
+                }));
+            }
+        });
+    }
+}
+//# sourceMappingURL=process-provider.js.map

package/build/examples/providers/process-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-provider.js","sourceRoot":"./src/","sources":["examples/providers/process-provider.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ProcessProvider\n * Handles execution of shell commands and scripts\n * Useful for CLI tools that need to execute system commands (SSH, Docker, etc.)\n */\nimport { exec, spawn } from \"child_process\";\nimport { promisify } from \"util\";\nimport { CustomError } from \"../../error\";\n\nconst execAsync = promisify(exec);\n\nexport interface ProcessProviderConfig {\n  shell?: string;\n  timeout?: number; // milliseconds\n}\n\nexport interface CommandResult {\n  stdout: string;\n  stderr: string;\n  exitCode: number;\n  success: boolean;\n}\n\nexport class ProcessProvider {\n  private shell: string;\n  private timeout: number;\n\n  constructor(config: ProcessProviderConfig = {}) {\n    this.shell = config.shell || \"/bin/bash\";\n    this.timeout = config.timeout || 30000; // 30 seconds default\n  }\n\n  /**\n   * Execute a shell command and return result\n   */\n  async execute(command: string): Promise<CommandResult> {\n    try {\n      const { stdout, stderr } = await execAsync(command, {\n        timeout: this.timeout,\n        shell: this.shell,\n      });\n\n      return {\n        stdout: stdout.trim(),\n        stderr: stderr.trim(),\n        exitCode: 0,\n        success: true,\n      };\n    } catch (error: unknown) {\n      const err = error as any;\n\n      throw new CustomError({\n        message: `Command execution failed: ${command}`,\n        code: 500,\n        reason: \"process execution error\",\n        error: err,\n        metadata: {\n          command,\n          stdout: err.stdout || \"\",\n          stderr: err.stderr || \"\",\n        },\n      });\n    }\n  }\n\n  /**\n   * Execute a command and return result with exit code\n   */\n  async executeWithStatus(command: string): Promise<CommandResult> {\n    return new Promise((resolve) => {\n      exec(\n        command,\n        { timeout: this.timeout, shell: this.shell },\n        (error, stdout, stderr) => {\n          resolve({\n            stdout: stdout.trim(),\n            stderr: stderr.trim(),\n            exitCode: error?.code || 0,\n            success: !error,\n          });\n        },\n      );\n    });\n  }\n\n  /**\n   * Stream output from a long-running command\n   * Useful for real-time output from deployments\n   */\n  async executeStream(\n    command: string,\n    onStdout?: (data: string) => void,\n    onStderr?: (data: string) => void,\n  ): Promise<CommandResult> {\n    return new Promise((resolve, reject) => {\n      try {\n        const child = spawn(command, [], {\n          shell: this.shell,\n          timeout: this.timeout,\n        });\n\n        let stdout = \"\";\n        let stderr = \"\";\n\n        child.stdout.on(\"data\", (data) => {\n          const text = data.toString();\n          stdout += text;\n          onStdout?.(text);\n        });\n\n        child.stderr.on(\"data\", (data) => {\n          const text = data.toString();\n          stderr += text;\n          onStderr?.(text);\n        });\n\n        child.on(\"close\", (code) => {\n          resolve({\n            stdout: stdout.trim(),\n            stderr: stderr.trim(),\n            exitCode: code || 0,\n            success: code === 0,\n          });\n        });\n\n        child.on(\"error\", (error) => {\n          reject(\n            new CustomError({\n              message: `Process error: ${command}`,\n              code: 500,\n              reason: \"process stream error\",\n              error,\n              metadata: { command, stderr },\n            }),\n          );\n        });\n      } catch (error: unknown) {\n        reject(\n          new CustomError({\n            message: `Failed to spawn process: ${command}`,\n            code: 500,\n            reason: \"process spawn error\",\n            error: error as Error,\n            metadata: { command },\n          }),\n        );\n      }\n    });\n  }\n}\n"]}