@1matrix/config-loader 0.1.0

package/README.md

@@ -0,0 +1,352 @@
+# @onematrix/config-loader
+
+Hot-reloadable public configuration management for Web3 applications with GitHub webhook integration.
+
+## Features
+
+- ✅ **Hot Reloading**: Automatically update configurations without restarting your application
+- ✅ **GitHub Integration**: Fetch configurations from a dedicated GitHub repository
+- ✅ **Webhook Support**: Real-time updates via GitHub webhooks
+- ✅ **Polling Backup**: Periodic polling as a fallback mechanism
+- ✅ **Schema Validation**: JSON Schema validation for all configurations
+- ✅ **Environment Support**: Map NODE_ENV to different configuration directories
+- ✅ **Fail-safe Caching**: Local cache fallback when GitHub is unavailable
+- ✅ **TypeScript**: Full TypeScript support with type definitions
+- ✅ **Event-Driven**: Listen to configuration changes with EventEmitter
+
+## Installation
+
+```bash
+pnpm add @onematrix/config-loader
+```
+
+## Quick Start
+
+### 1. Initialize ConfigLoader
+
+```typescript
+import { ConfigLoader } from '@onematrix/config-loader';
+
+const config = new ConfigLoader({
+  repository: 'OneMatrixL1/public-configs',
+  branch: 'main',
+  githubToken: process.env.GITHUB_TOKEN,
+  webhookSecret: process.env.GITHUB_WEBHOOK_SECRET,
+  cacheFile: './config-cache.json',
+  pollingInterval: 5 * 60 * 1000 // 5 minutes
+});
+
+await config.initialize();
+```
+
+### 2. Access Configuration
+
+```typescript
+// Get specific value
+const apiKeyName = config.get('api-keys.a129f786...');
+
+// Get with type inference
+const handlers = config.get<string[]>('intent-handlers', []);
+
+// Check if exists
+if (config.has('api-keys.some-hash')) {
+  // ...
+}
+
+// Get all configs
+const allConfigs = config.getAll();
+```
+
+### 3. Listen to Updates
+
+```typescript
+// Listen to all updates
+config.on('update', (newConfigs, changedKeys) => {
+  console.log('Updated configs:', changedKeys);
+});
+
+// Listen to specific config updates
+config.on('update:api-keys', (newApiKeys) => {
+  console.log('API keys changed');
+});
+
+// Listen to validation errors
+config.on('validation-error', (configName, errors) => {
+  console.error('Validation failed:', configName, errors);
+});
+```
+
+### 4. Set Up Webhook (Express)
+
+```typescript
+import express from 'express';
+
+const app = express();
+
+app.post(
+  '/webhook/config-update',
+  express.json(),
+  config.createWebhookHandler({
+    onUpdate: (configs) => console.log('Updated via webhook'),
+    onError: (err) => console.error(err)
+  })
+);
+```
+
+## Configuration Repository Structure
+
+Your GitHub configuration repository should follow this structure:
+
+```
+public-configs/
+├── schemas/
+│   ├── api-keys.schema.json
+│   ├── roles.schema.json
+│   └── intent-handlers.schema.json
+├── dev/
+│   ├── api-keys.json
+│   ├── roles.json
+│   └── intent-handlers.json
+├── staging/
+│   └── ...
+└── prod/
+    └── ...
+```
+
+### Example Configurations
+
+**`dev/api-keys.json`**
+```json
+{
+  "a129f7860d47c0630e6d06c153fe36711f25a31bfb4304dc6d2a79e609da0e96": "VNIDC",
+  "b234c8971e58d1741f7e17d264gf47822g36b42cgc5415ed7e3b8a710eb1fa07": "SERVICE_2"
+}
+```
+
+**`dev/roles.json`**
+```json
+{
+  "explorer.viewer": [
+    "0xE61383556642AF1Bd7c5756b13f19A63Dc8601df",
+    "0x7d5538fEe2CE89dA936ec29cC48386b6E7548FaB"
+  ],
+  "admin": [
+    "0x194f5b1755562966302Ef0BbF4349c842c60FC42"
+  ]
+}
+```
+
+**`dev/intent-handlers.json`**
+```json
+[
+  "0x84f915BcbD5C1134BCb93a0f50D9D36E6D3b508c",
+  "0x626b1E2458A9307E73A570c291bCd467216cc1D7"
+]
+```
+
+### Example Schemas
+
+**`schemas/api-keys.schema.json`**
+```json
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "patternProperties": {
+    "^[a-f0-9]{64}$": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "additionalProperties": false
+}
+```
+
+## API Reference
+
+### ConfigLoader Options
+
+```typescript
+interface ConfigLoaderOptions {
+  repository: string;              // GitHub repository (owner/repo)
+  branch: string;                  // Branch to fetch from
+  githubToken?: string;            // GitHub personal access token
+  webhookSecret?: string;          // GitHub webhook secret
+  envMappings?: Record<string, string>; // NODE_ENV to directory mappings
+  defaultEnv?: string;             // Default environment (default: 'dev')
+  pollingInterval?: number;        // Polling interval in ms (default: 300000)
+  cacheFile?: string;              // Cache file path (default: './config-cache.json')
+  usePackageSchemas?: boolean;     // Use built-in schemas (default: true)
+}
+```
+
+### Methods
+
+#### `async initialize(): Promise<void>`
+Initialize the config loader. Attempts to load from GitHub, falls back to cache if unavailable.
+
+#### `async refresh(): Promise<void>`
+Manually refresh configurations from GitHub.
+
+#### `get<T>(path: string, defaultValue?: T): T | undefined`
+Get a configuration value by dot-notation path.
+
+#### `has(path: string): boolean`
+Check if a configuration path exists.
+
+#### `getAll(): Record<string, any>`
+Get all configurations.
+
+#### `getCurrentEnvironment(): string`
+Get the current environment name.
+
+#### `getConfigNames(): string[]`
+Get names of all loaded configurations.
+
+#### `createWebhookHandler(options?: WebhookHandlerOptions): ExpressMiddleware`
+Create an Express middleware for handling GitHub webhooks.
+
+#### `destroy(): void`
+Clean up resources (stop polling, remove listeners).
+
+### Events
+
+#### `'update'`
+Emitted when configurations are updated.
+```typescript
+config.on('update', (newConfigs: Record<string, any>, changedKeys: string[]) => {
+  // Handle update
+});
+```
+
+#### `'update:${configName}'`
+Emitted when a specific configuration is updated.
+```typescript
+config.on('update:api-keys', (newApiKeys: any) => {
+  // Handle API keys update
+});
+```
+
+#### `'validation-error'`
+Emitted when configuration validation fails.
+```typescript
+config.on('validation-error', (configName: string, errors: any[]) => {
+  // Handle validation error
+});
+```
+
+#### `'error'`
+Emitted when an error occurs.
+```typescript
+config.on('error', (error: Error) => {
+  // Handle error
+});
+```
+
+## GitHub Webhook Setup
+
+### 1. Create Webhook in GitHub Repository
+
+1. Go to your config repository → Settings → Webhooks → Add webhook
+2. Payload URL: `https://your-app.com/webhook/config-update`
+3. Content type: `application/json`
+4. Secret: Generate a strong random secret
+5. Events: Select "Just the push event"
+6. Active: ✅
+
+### 2. Configure Branch Protection
+
+Ensure only authorized users can update configs:
+
+1. Go to Settings → Branches → Add rule
+2. Branch name pattern: `main`
+3. Enable:
+   - Require pull request reviews (at least 1 approval)
+   - Require status checks before merging
+   - Restrict push access to admins
+
+### 3. Set Environment Variables
+
+```bash
+GITHUB_TOKEN=ghp_your_personal_access_token
+GITHUB_WEBHOOK_SECRET=your_webhook_secret
+```
+
+## Environment Mapping
+
+Map `NODE_ENV` values to configuration directories:
+
+```typescript
+const config = new ConfigLoader({
+  // ...
+  envMappings: {
+    'dev': 'dev',
+    'development': 'dev',
+    'develop': 'develop',
+    'stg': 'stg',
+    'staging': 'staging',
+    'prod': 'prod',
+    'production': 'production'
+  },
+  defaultEnv: 'dev'
+});
+```
+
+## Security Best Practices
+
+### ✅ DO
+
+- Store only hashed/public data in configurations (e.g., Keccak256 hashes)
+- Use environment variables for webhook secrets and GitHub tokens
+- Enable branch protection on configuration repository
+- Monitor `validation-error` events for malicious payloads
+- Set up alerts for repeated webhook validation failures
+
+### ❌ DON'T
+
+- Store raw API keys or passwords in configuration files
+- Expose webhook endpoints without signature validation
+- Allow direct pushes to main branch (require PRs)
+- Disable schema validation
+- Use weak webhook secrets
+
+## Testing
+
+```bash
+# Run tests
+pnpm test
+
+# Run tests in watch mode
+pnpm test:watch
+
+# Run tests with coverage
+pnpm test:coverage
+```
+
+## Building
+
+```bash
+# Build TypeScript to JavaScript
+pnpm build
+
+# Build and watch for changes
+pnpm build:watch
+```
+
+## Examples
+
+See the `examples/` directory for complete examples:
+
+- `basic-usage.ts`: Simple configuration loading
+- `express-integration.ts`: Full Express.js integration with webhooks
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions are welcome! Please open an issue or submit a pull request.
+
+## Support
+
+For issues and questions, please open an issue on GitHub.

package/dist/config-loader.d.ts

@@ -0,0 +1,26 @@
+import EventEmitter from 'eventemitter3';
+import { ConfigLoaderOptions, WebhookHandlerOptions, ExpressMiddleware } from './types';
+export declare class ConfigLoader extends EventEmitter {
+    readonly options: ConfigLoaderOptions;
+    private readonly logger;
+    private readonly githubFetcher;
+    private readonly cacheFetcher;
+    private readonly validator;
+    private readonly envMapper;
+    private configs;
+    private poller;
+    lastUpdateTimestamp: number | null;
+    constructor(options: ConfigLoaderOptions);
+    initialize(): Promise<void>;
+    refresh(): Promise<void>;
+    get<T = any>(path: string, defaultValue?: T): T | undefined;
+    has(path: string): boolean;
+    getAll(): Record<string, any>;
+    getCurrentEnvironment(): string;
+    getConfigNames(): string[];
+    createWebhookHandler(options?: WebhookHandlerOptions): ExpressMiddleware;
+    reload(): Promise<void>;
+    private detectChanges;
+    destroy(): void;
+}
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../src/config-loader.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,eAAe,CAAC;AAUzC,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAMxF,qBAAa,YAAa,SAAQ,YAAY;IAC5C,SAAgB,OAAO,EAAE,mBAAmB,CAAC;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,MAAM,CAAsB;IAC7B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;gBAK9B,OAAO,EAAE,mBAAmB;IAoDlC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiC3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAyE9B,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAS3D,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQ1B,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAQ7B,qBAAqB,IAAI,MAAM;IAQ/B,cAAc,IAAI,MAAM,EAAE;IAS1B,oBAAoB,CAAC,OAAO,GAAE,qBAA0B,GAAG,iBAAiB;IAQtE,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAU7B,OAAO,CAAC,aAAa;IA0BrB,OAAO,IAAI,IAAI;CAOhB"}

package/dist/config-loader.js

@@ -0,0 +1,174 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigLoader = void 0;
+const eventemitter3_1 = __importDefault(require("eventemitter3"));
+const github_fetcher_1 = require("./fetcher/github-fetcher");
+const file_cache_fetcher_1 = require("./fetcher/file-cache-fetcher");
+const schema_validator_1 = require("./validator/schema-validator");
+const webhook_handler_1 = require("./webhook/webhook-handler");
+const config_poller_1 = require("./poller/config-poller");
+const env_mapper_1 = require("./utils/env-mapper");
+const deep_get_1 = require("./utils/deep-get");
+const default_schemas_1 = require("./validator/default-schemas");
+const logger_1 = require("./utils/logger");
+class ConfigLoader extends eventemitter3_1.default {
+    constructor(options) {
+        super();
+        if (!options.repository) {
+            throw new Error('repository option is required');
+        }
+        if (!options.branch) {
+            throw new Error('branch option is required');
+        }
+        this.options = {
+            pollingInterval: 5 * 60 * 1000,
+            defaultEnv: 'dev',
+            envMappings: {},
+            usePackageSchemas: true,
+            cacheFile: './config-cache.json',
+            ...options
+        };
+        this.logger = new logger_1.Logger('ConfigLoader');
+        const [owner, repo] = this.options.repository.split('/');
+        if (!owner || !repo) {
+            throw new Error('repository must be in format "owner/repo"');
+        }
+        this.githubFetcher = new github_fetcher_1.GitHubFetcher({
+            owner,
+            repo,
+            branch: this.options.branch,
+            token: this.options.githubToken
+        });
+        this.cacheFetcher = new file_cache_fetcher_1.FileCacheFetcher(this.options.cacheFile);
+        this.validator = new schema_validator_1.SchemaValidator();
+        this.envMapper = new env_mapper_1.EnvMapper(this.options.envMappings, this.options.defaultEnv);
+        this.configs = {};
+        this.poller = null;
+        this.lastUpdateTimestamp = null;
+    }
+    async initialize() {
+        try {
+            this.logger.info('Initializing ConfigLoader...');
+            await this.refresh();
+            this.logger.info('Successfully initialized from GitHub');
+        }
+        catch (error) {
+            const err = error;
+            this.logger.warn('Failed to load from GitHub, attempting cache fallback:', err.message);
+            this.emit('error', err);
+            const cached = await this.cacheFetcher.read();
+            if (cached) {
+                this.configs = cached;
+                this.lastUpdateTimestamp = Date.now();
+                this.emit('update', this.configs, Object.keys(this.configs));
+                this.logger.info('Loaded configurations from cache');
+            }
+            else {
+                throw new Error('Failed to initialize: no GitHub access and no cache available');
+            }
+        }
+        if (this.options.pollingInterval && this.options.pollingInterval > 0) {
+            this.poller = new config_poller_1.ConfigPoller(this, this.options.pollingInterval);
+            this.poller.start();
+            this.logger.info(`Started polling with interval: ${this.options.pollingInterval}ms`);
+        }
+    }
+    async refresh() {
+        const env = this.envMapper.resolve();
+        this.logger.debug(`Refreshing configs for environment: ${env}`);
+        const schemas = this.options.usePackageSchemas ? { ...default_schemas_1.defaultSchemas } : {};
+        try {
+            const repoSchemas = await this.githubFetcher.fetchAllSchemas();
+            Object.assign(schemas, repoSchemas);
+            this.logger.debug(`Loaded ${Object.keys(schemas).length} schemas`);
+        }
+        catch (error) {
+            const err = error;
+            this.logger.warn('Failed to fetch repo schemas, using defaults:', err.message);
+        }
+        this.validator.loadSchemas(schemas);
+        const newConfigs = await this.githubFetcher.fetchAllConfigs(env);
+        this.logger.debug(`Fetched ${Object.keys(newConfigs).length} config files`);
+        const validatedConfigs = {};
+        for (const [name, data] of Object.entries(newConfigs)) {
+            const result = this.validator.validate(name, data);
+            if (!result.valid) {
+                this.logger.error(`Validation failed for ${name}:`, result.errors);
+                this.emit('validation-error', name, result.errors);
+                continue;
+            }
+            validatedConfigs[name] = data;
+        }
+        const changedKeys = this.detectChanges(validatedConfigs);
+        this.configs = validatedConfigs;
+        this.lastUpdateTimestamp = Date.now();
+        try {
+            await this.cacheFetcher.write(validatedConfigs);
+            this.logger.debug('Updated cache file');
+        }
+        catch (error) {
+            const err = error;
+            this.logger.warn('Failed to update cache:', err.message);
+        }
+        if (changedKeys.length > 0) {
+            this.logger.info(`Configs updated: ${changedKeys.join(', ')}`);
+            this.emit('update', validatedConfigs, changedKeys);
+            for (const key of changedKeys) {
+                this.emit(`update:${key}`, validatedConfigs[key]);
+            }
+        }
+        else {
+            this.logger.debug('No config changes detected');
+        }
+    }
+    get(path, defaultValue) {
+        return (0, deep_get_1.deepGet)(this.configs, path, defaultValue);
+    }
+    has(path) {
+        return (0, deep_get_1.deepGet)(this.configs, path) !== undefined;
+    }
+    getAll() {
+        return { ...this.configs };
+    }
+    getCurrentEnvironment() {
+        return this.envMapper.resolve();
+    }
+    getConfigNames() {
+        return Object.keys(this.configs);
+    }
+    createWebhookHandler(options = {}) {
+        const handler = new webhook_handler_1.WebhookHandler(this, options);
+        return handler.createMiddleware();
+    }
+    async reload() {
+        await this.refresh();
+    }
+    detectChanges(newConfigs) {
+        const changed = [];
+        for (const key of Object.keys(newConfigs)) {
+            const oldValue = JSON.stringify(this.configs[key]);
+            const newValue = JSON.stringify(newConfigs[key]);
+            if (oldValue !== newValue) {
+                changed.push(key);
+            }
+        }
+        for (const key of Object.keys(this.configs)) {
+            if (!(key in newConfigs)) {
+                changed.push(key);
+            }
+        }
+        return changed;
+    }
+    destroy() {
+        if (this.poller) {
+            this.poller.stop();
+        }
+        this.removeAllListeners();
+        this.logger.info('ConfigLoader destroyed');
+    }
+}
+exports.ConfigLoader = ConfigLoader;
+//# sourceMappingURL=config-loader.js.map

package/dist/config-loader.js.map

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

package/dist/fetcher/file-cache-fetcher.d.ts

@@ -0,0 +1,9 @@
+export declare class FileCacheFetcher {
+    private readonly cacheFile;
+    constructor(cacheFilePath: string);
+    read(): Promise<Record<string, any> | null>;
+    write(configs: Record<string, any>): Promise<void>;
+    exists(): boolean;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=file-cache-fetcher.d.ts.map

package/dist/fetcher/file-cache-fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-cache-fetcher.d.ts","sourceRoot":"","sources":["../../src/fetcher/file-cache-fetcher.ts"],"names":[],"mappings":"AAMA,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAKvB,aAAa,EAAE,MAAM;IAQ3B,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAkB3C,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBxD,MAAM,IAAI,OAAO;IAOX,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/dist/fetcher/file-cache-fetcher.js

@@ -0,0 +1,80 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileCacheFetcher = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+class FileCacheFetcher {
+    constructor(cacheFilePath) {
+        this.cacheFile = cacheFilePath;
+    }
+    async read() {
+        try {
+            if (!fs.existsSync(this.cacheFile)) {
+                return null;
+            }
+            const content = await fs.promises.readFile(this.cacheFile, 'utf8');
+            return JSON.parse(content);
+        }
+        catch (error) {
+            const err = error;
+            throw new Error(`Failed to read cache file: ${err.message}`);
+        }
+    }
+    async write(configs) {
+        try {
+            const dir = path.dirname(this.cacheFile);
+            if (!fs.existsSync(dir)) {
+                await fs.promises.mkdir(dir, { recursive: true });
+            }
+            const data = JSON.stringify(configs, null, 2);
+            await fs.promises.writeFile(this.cacheFile, data, 'utf8');
+        }
+        catch (error) {
+            const err = error;
+            throw new Error(`Failed to write cache file: ${err.message}`);
+        }
+    }
+    exists() {
+        return fs.existsSync(this.cacheFile);
+    }
+    async clear() {
+        if (this.exists()) {
+            await fs.promises.unlink(this.cacheFile);
+        }
+    }
+}
+exports.FileCacheFetcher = FileCacheFetcher;
+//# sourceMappingURL=file-cache-fetcher.js.map

package/dist/fetcher/file-cache-fetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-cache-fetcher.js","sourceRoot":"","sources":["../../src/fetcher/file-cache-fetcher.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,2CAA6B;AAK7B,MAAa,gBAAgB;IAM3B,YAAY,aAAqB;QAC/B,IAAI,CAAC,SAAS,GAAG,aAAa,CAAC;IACjC,CAAC;IAMD,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBACnC,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACnE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAc,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAMD,KAAK,CAAC,KAAK,CAAC,OAA4B;QACtC,IAAI,CAAC;YAEH,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACpD,CAAC;YAED,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC9C,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC5D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAc,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,+BAA+B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAMD,MAAM;QACJ,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAKD,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YAClB,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;CACF;AAhED,4CAgEC"}

package/dist/fetcher/github-fetcher.d.ts

@@ -0,0 +1,14 @@
+import { GitHubFetcherOptions } from '../types';
+export declare class GitHubFetcher {
+    private readonly owner;
+    private readonly repo;
+    private readonly branch;
+    private readonly octokit;
+    constructor(options: GitHubFetcherOptions);
+    fetchConfig(env: string, configName: string): Promise<any>;
+    private getConfigPath;
+    fetchSchema(schemaName: string): Promise<any | null>;
+    fetchAllConfigs(env: string): Promise<Record<string, any>>;
+    fetchAllSchemas(): Promise<Record<string, any>>;
+}
+//# sourceMappingURL=github-fetcher.d.ts.map

package/dist/fetcher/github-fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-fetcher.d.ts","sourceRoot":"","sources":["../../src/fetcher/github-fetcher.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAKhD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAKtB,OAAO,EAAE,oBAAoB;IAgBnC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAsChE,OAAO,CAAC,aAAa;IAef,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAkCpD,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IA0B1D,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAmCtD"}