@shahadpichen/docpush 1.0.0

package/README.md

@@ -0,0 +1,129 @@
+# DocPush
+
+Self-hosted, Git-backed collaborative documentation platform.
+
+## Features
+
+- 📝 **Git-backed** - All docs stored in your GitHub repo
+- 🔐 **Flexible Auth** - Public, magic link, or OAuth
+- ✏️ **Draft System** - Branch-based editing with approval workflow
+- 💬 **Comments** - Collaborative review process
+- ⚛️ **React Components** - Headless UI components for your app
+
+## Quick Start
+
+```bash
+# Install
+npm install @shahadpichen/docpush
+
+# Initialize
+npx @shahadpichen/docpush init
+
+# Configure docs.config.js and .env
+
+# Start
+npx @shahadpichen/docpush start
+```
+
+## Configuration
+
+Create `docs.config.js`:
+
+```javascript
+module.exports = {
+  github: {
+    owner: "your-username",
+    repo: "your-repo",
+    branch: "main",
+    docsPath: "docs",
+  },
+  auth: {
+    mode: "public",
+    adminPassword: "your-admin-password",
+  },
+  admins: {
+    emails: ["admin@example.com"],
+  },
+};
+```
+
+Create `.env`:
+
+```
+GITHUB_TOKEN=ghp_your_token
+APP_URL=http://localhost:3000
+SESSION_SECRET=your-secret
+```
+
+## Auth Modes
+
+### Public Mode
+
+Anyone can submit drafts, admin approves.
+
+```javascript
+auth: {
+  mode: 'public',
+  adminPassword: 'admin123',
+}
+```
+
+### Domain-Restricted Mode
+
+Only users with allowed email domains can edit.
+
+```javascript
+auth: {
+  mode: 'domain-restricted',
+  allowedDomains: ['company.com'],
+  emailFrom: 'docs@company.com',
+}
+```
+
+### OAuth Mode
+
+GitHub/Google sign-in.
+
+```javascript
+auth: {
+  mode: 'oauth',
+  providers: ['github', 'google'],
+}
+```
+
+## React Components
+
+Import components for your own UI:
+
+```tsx
+import {
+  DocPushProvider,
+  DocsSidebar,
+  MarkdownViewer,
+  MarkdownEditor,
+  useDocs,
+  useDrafts,
+} from "docpush/react";
+
+function App() {
+  return (
+    <DocPushProvider config={{ apiUrl: "http://localhost:3000" }}>
+      <DocsPage />
+    </DocPushProvider>
+  );
+}
+```
+
+## API Endpoints
+
+| Endpoint                       | Description        |
+| ------------------------------ | ------------------ |
+| `GET /api/docs/tree`           | Get docs file tree |
+| `GET /api/docs/:path`          | Get doc content    |
+| `GET /api/drafts`              | List drafts        |
+| `POST /api/drafts`             | Create draft       |
+| `POST /api/drafts/:id/approve` | Approve draft      |
+
+## License
+
+MIT

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,2 @@
+export declare function initCommand(): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AA+EA,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAsCjD"}

package/dist/cli/commands/init.js

@@ -0,0 +1,116 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initCommand = initCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const WELCOME_TEMPLATE = `# Welcome to Your Documentation
+
+This is your first document! Edit it to get started.
+
+## Getting Started
+
+1. Edit files in the \`docs/\` folder
+2. Changes are saved as drafts (Git branches)
+3. Admins can approve drafts to publish
+
+## Configuration
+
+Edit \`docs.config.js\` to configure:
+- GitHub repository
+- Authentication mode
+- Admin users
+`;
+const CONFIG_TEMPLATE = `module.exports = {
+  // Your GitHub repository
+  github: {
+    owner: 'your-org',          // TODO: Change to your GitHub org/username
+    repo: 'your-repo',           // TODO: Change to your repository name
+    branch: 'main',              // Main branch
+    docsPath: 'docs'             // Path to docs folder
+  },
+
+  // Authentication mode
+  auth: {
+    mode: 'public',              // Options: 'public' | 'domain-restricted' | 'oauth'
+    adminPassword: 'changeme'    // TODO: Change this password! (for public mode)
+  },
+
+  // Admin users (for domain-restricted and oauth modes)
+  admins: {
+    emails: ['admin@example.com'] // TODO: Add your admin emails
+  },
+
+  // Optional: Branding
+  branding: {
+    name: 'Documentation',
+    // logo: '/logo.png'
+  }
+};
+`;
+const ENV_TEMPLATE = `# Required
+GITHUB_TOKEN=ghp_your_token_here
+APP_URL=http://localhost:3000
+SESSION_SECRET=generate-random-string-here-change-in-production
+
+# Database (optional - uses SQLite if not provided)
+# DATABASE_PATH=./docpush.db
+
+# Auth - Domain Restricted (only if using this mode)
+# RESEND_API_KEY=re_your_key_here
+
+# Auth - OAuth (only if using this mode)
+# GITHUB_CLIENT_ID=your_client_id
+# GITHUB_CLIENT_SECRET=your_client_secret
+# GOOGLE_CLIENT_ID=your_client_id
+# GOOGLE_CLIENT_SECRET=your_client_secret
+
+# Media - S3 (optional)
+# S3_BUCKET=your-bucket
+# AWS_REGION=us-east-1
+# AWS_ACCESS_KEY_ID=your_key
+# AWS_SECRET_ACCESS_KEY=your_secret
+
+# Search - Algolia (optional but recommended)
+# NEXT_PUBLIC_ALGOLIA_APP_ID=your_app_id
+# NEXT_PUBLIC_ALGOLIA_SEARCH_KEY=your_search_only_api_key
+# NEXT_PUBLIC_ALGOLIA_INDEX_NAME=your_index_name
+`;
+async function initCommand() {
+    console.log(chalk_1.default.blue('🚀 Initializing DocPush...\n'));
+    // 1. Create docs folder
+    await fs_extra_1.default.ensureDir('./docs');
+    await fs_extra_1.default.writeFile('./docs/welcome.md', WELCOME_TEMPLATE);
+    console.log(chalk_1.default.green('✓'), 'Created docs/ folder with welcome.md');
+    // 2. Create config file
+    if (!(await fs_extra_1.default.pathExists('./docs.config.js'))) {
+        await fs_extra_1.default.writeFile('./docs.config.js', CONFIG_TEMPLATE);
+        console.log(chalk_1.default.green('✓'), 'Created docs.config.js');
+    }
+    else {
+        console.log(chalk_1.default.yellow('⚠'), 'docs.config.js already exists, skipping');
+    }
+    // 3. Create .env.example
+    await fs_extra_1.default.writeFile('./.env.example', ENV_TEMPLATE);
+    console.log(chalk_1.default.green('✓'), 'Created .env.example');
+    // 4. Update package.json scripts
+    const pkgPath = './package.json';
+    if (await fs_extra_1.default.pathExists(pkgPath)) {
+        const pkg = await fs_extra_1.default.readJson(pkgPath);
+        pkg.scripts = {
+            ...pkg.scripts,
+            'docs:dev': 'docpush start',
+            'docs:build': 'docpush build',
+        };
+        await fs_extra_1.default.writeJson(pkgPath, pkg, { spaces: 2 });
+        console.log(chalk_1.default.green('✓'), 'Updated package.json scripts');
+    }
+    console.log(chalk_1.default.blue('\n📝 Next steps:'));
+    console.log('  1. Copy .env.example to .env and fill in values');
+    console.log('  2. Edit docs.config.js with your GitHub repo');
+    console.log('  3. Create a GitHub Personal Access Token with "repo" scope');
+    console.log('  4. Run: npm run docs:dev\n');
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":";;;;;AA+EA,kCAsCC;AApHD,kDAA0B;AAC1B,wDAA0B;AAE1B,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;CAgBxB,CAAC;AAEF,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BvB,CAAC;AAEF,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BpB,CAAC;AAEK,KAAK,UAAU,WAAW;IAC/B,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC,CAAC;IAExD,wBAAwB;IACxB,MAAM,kBAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC7B,MAAM,kBAAE,CAAC,SAAS,CAAC,mBAAmB,EAAE,gBAAgB,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,sCAAsC,CAAC,CAAC;IAEtE,wBAAwB;IACxB,IAAI,CAAC,CAAC,MAAM,kBAAE,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC;QAC/C,MAAM,kBAAE,CAAC,SAAS,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,wBAAwB,CAAC,CAAC;IAC1D,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,yCAAyC,CAAC,CAAC;IAC5E,CAAC;IAED,yBAAyB;IACzB,MAAM,kBAAE,CAAC,SAAS,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;IACnD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,sBAAsB,CAAC,CAAC;IAEtD,iCAAiC;IACjC,MAAM,OAAO,GAAG,gBAAgB,CAAC;IACjC,IAAI,MAAM,kBAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACvC,GAAG,CAAC,OAAO,GAAG;YACZ,GAAG,GAAG,CAAC,OAAO;YACd,UAAU,EAAE,eAAe;YAC3B,YAAY,EAAE,eAAe;SAC9B,CAAC;QACF,MAAM,kBAAE,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,8BAA8B,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;IAC5E,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;AAC9C,CAAC"}

package/dist/cli/commands/start.d.ts

@@ -0,0 +1,4 @@
+export declare function startCommand(options: {
+    port: string;
+}): Promise<void>;
+//# sourceMappingURL=start.d.ts.map

package/dist/cli/commands/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/start.ts"],"names":[],"mappings":"AAGA,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB3E"}

package/dist/cli/commands/start.js

@@ -0,0 +1,58 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startCommand = startCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const dotenv_1 = require("dotenv");
+async function startCommand(options) {
+    // Load .env file from current working directory
+    (0, dotenv_1.config)();
+    const port = Number.parseInt(options.port);
+    console.log(chalk_1.default.blue('🚀 Starting DocPush...\n'));
+    // Dynamically import and start the server
+    try {
+        const { startServer } = await Promise.resolve().then(() => __importStar(require('../../server')));
+        await startServer(port);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        console.error(chalk_1.default.red('❌ Failed to start server:'), message);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=start.js.map

package/dist/cli/commands/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../../src/cli/commands/start.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGA,oCAiBC;AApBD,kDAA0B;AAC1B,mCAAgC;AAEzB,KAAK,UAAU,YAAY,CAAC,OAAyB;IAC1D,gDAAgD;IAChD,IAAA,eAAM,GAAE,CAAC;IAET,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC,CAAC;IAEpD,0CAA0C;IAC1C,IAAI,CAAC;QACH,MAAM,EAAE,WAAW,EAAE,GAAG,wDAAa,cAAc,GAAC,CAAC;QACrD,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACzE,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,2BAA2B,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const init_1 = require("./commands/init");
+const start_1 = require("./commands/start");
+const program = new commander_1.Command();
+program
+    .name('docpush')
+    .description('Self-hosted, Git-backed collaborative documentation platform')
+    .version('1.0.0');
+program
+    .command('init')
+    .description('Initialize DocPush in the current directory')
+    .action(init_1.initCommand);
+program
+    .command('start')
+    .description('Start the DocPush development server')
+    .option('-p, --port <port>', 'Port to run on', '3000')
+    .action(start_1.startCommand);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;;AAEA,yCAAoC;AACpC,0CAA8C;AAC9C,4CAAgD;AAEhD,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,SAAS,CAAC;KACf,WAAW,CAAC,8DAA8D,CAAC;KAC3E,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,6CAA6C,CAAC;KAC1D,MAAM,CAAC,kBAAW,CAAC,CAAC;AAEvB,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,sCAAsC,CAAC;KACnD,MAAM,CAAC,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,CAAC;KACrD,MAAM,CAAC,oBAAY,CAAC,CAAC;AAExB,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/core/config/index.d.ts

@@ -0,0 +1,3 @@
+export { loadConfig, resetConfigCache, configSchema, validateEnv } from './loader';
+export type { DocsConfig } from './loader';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACnF,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}

package/dist/core/config/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateEnv = exports.configSchema = exports.resetConfigCache = exports.loadConfig = void 0;
+var loader_1 = require("./loader");
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return loader_1.loadConfig; } });
+Object.defineProperty(exports, "resetConfigCache", { enumerable: true, get: function () { return loader_1.resetConfigCache; } });
+Object.defineProperty(exports, "configSchema", { enumerable: true, get: function () { return loader_1.configSchema; } });
+Object.defineProperty(exports, "validateEnv", { enumerable: true, get: function () { return loader_1.validateEnv; } });
+//# sourceMappingURL=index.js.map

package/dist/core/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/config/index.ts"],"names":[],"mappings":";;;AAAA,mCAAmF;AAA1E,oGAAA,UAAU,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AAAE,sGAAA,YAAY,OAAA;AAAE,qGAAA,WAAW,OAAA"}

package/dist/core/config/loader.d.ts

@@ -0,0 +1,6 @@
+import { type DocsConfig } from './schema';
+export declare function loadConfig(configPath?: string): Promise<DocsConfig>;
+export declare function resetConfigCache(): void;
+export { configSchema, type DocsConfig } from './schema';
+export { validateEnv } from './schema';
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/core/config/loader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,UAAU,EAAgB,MAAM,UAAU,CAAC;AAIzD,wBAAsB,UAAU,CAAC,UAAU,SAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,CA+BrF;AAGD,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAGD,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/core/config/loader.js

@@ -0,0 +1,50 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateEnv = exports.configSchema = void 0;
+exports.loadConfig = loadConfig;
+exports.resetConfigCache = resetConfigCache;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const schema_1 = require("./schema");
+let cachedConfig = null;
+async function loadConfig(configPath = './docs.config.js') {
+    if (cachedConfig)
+        return cachedConfig;
+    const fullPath = node_path_1.default.resolve(process.cwd(), configPath);
+    if (!node_fs_1.default.existsSync(fullPath)) {
+        throw new Error('docs.config.js not found. Run: npx docpush init');
+    }
+    try {
+        // Clear require cache to pick up changes
+        delete require.cache[require.resolve(fullPath)];
+        // Dynamic require - works in Node.js
+        const userConfig = require(fullPath);
+        // Validate with Zod
+        cachedConfig = schema_1.configSchema.parse(userConfig);
+        return cachedConfig;
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === 'ZodError') {
+            console.error('Configuration validation failed:');
+            const zodError = error;
+            zodError.errors.forEach((err) => {
+                console.error(`  - ${err.path.join('.')}: ${err.message}`);
+            });
+            throw new Error('Invalid configuration');
+        }
+        throw error;
+    }
+}
+// Reset cache (useful for testing)
+function resetConfigCache() {
+    cachedConfig = null;
+}
+// Re-export schema and types
+var schema_2 = require("./schema");
+Object.defineProperty(exports, "configSchema", { enumerable: true, get: function () { return schema_2.configSchema; } });
+var schema_3 = require("./schema");
+Object.defineProperty(exports, "validateEnv", { enumerable: true, get: function () { return schema_3.validateEnv; } });
+//# sourceMappingURL=loader.js.map

package/dist/core/config/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../src/core/config/loader.ts"],"names":[],"mappings":";;;;;;AAMA,gCA+BC;AAGD,4CAEC;AA1CD,sDAAyB;AACzB,0DAA6B;AAC7B,qCAAyD;AAEzD,IAAI,YAAY,GAAsB,IAAI,CAAC;AAEpC,KAAK,UAAU,UAAU,CAAC,UAAU,GAAG,kBAAkB;IAC9D,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC;IAEtC,MAAM,QAAQ,GAAG,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAC;IAEzD,IAAI,CAAC,iBAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IAED,IAAI,CAAC;QACH,yCAAyC;QACzC,OAAO,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QAEhD,qCAAqC;QACrC,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QAErC,oBAAoB;QACpB,YAAY,GAAG,qBAAY,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAE9C,OAAO,YAAY,CAAC;IACtB,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACxD,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;YAClD,MAAM,QAAQ,GAAG,KAA0E,CAAC;YAC5F,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC9B,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7D,CAAC,CAAC,CAAC;YACH,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,mCAAmC;AACnC,SAAgB,gBAAgB;IAC9B,YAAY,GAAG,IAAI,CAAC;AACtB,CAAC;AAED,6BAA6B;AAC7B,mCAAyD;AAAhD,sGAAA,YAAY,OAAA;AACrB,mCAAuC;AAA9B,qGAAA,WAAW,OAAA"}

package/dist/core/config/schema.d.ts

@@ -0,0 +1,134 @@
+import { z } from 'zod';
+export declare const configSchema: z.ZodObject<{
+    github: z.ZodObject<{
+        owner: z.ZodString;
+        repo: z.ZodString;
+        branch: z.ZodDefault<z.ZodString>;
+        docsPath: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        owner: string;
+        repo: string;
+        branch: string;
+        docsPath: string;
+    }, {
+        owner: string;
+        repo: string;
+        branch?: string | undefined;
+        docsPath?: string | undefined;
+    }>;
+    auth: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+        mode: z.ZodLiteral<"public">;
+        adminPassword: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        mode: "public";
+        adminPassword: string;
+    }, {
+        mode: "public";
+        adminPassword: string;
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"domain-restricted">;
+        allowedDomains: z.ZodArray<z.ZodString, "many">;
+        emailFrom: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        mode: "domain-restricted";
+        allowedDomains: string[];
+        emailFrom: string;
+    }, {
+        mode: "domain-restricted";
+        allowedDomains: string[];
+        emailFrom: string;
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"oauth">;
+        providers: z.ZodArray<z.ZodEnum<["github", "google"]>, "many">;
+        allowedDomains: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "oauth";
+        providers: ("github" | "google")[];
+        allowedDomains?: string[] | undefined;
+    }, {
+        mode: "oauth";
+        providers: ("github" | "google")[];
+        allowedDomains?: string[] | undefined;
+    }>]>;
+    admins: z.ZodObject<{
+        emails: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        emails: string[];
+    }, {
+        emails: string[];
+    }>;
+    branding: z.ZodOptional<z.ZodObject<{
+        name: z.ZodDefault<z.ZodString>;
+        logo: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        logo?: string | undefined;
+    }, {
+        name?: string | undefined;
+        logo?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    github: {
+        owner: string;
+        repo: string;
+        branch: string;
+        docsPath: string;
+    };
+    auth: {
+        mode: "public";
+        adminPassword: string;
+    } | {
+        mode: "domain-restricted";
+        allowedDomains: string[];
+        emailFrom: string;
+    } | {
+        mode: "oauth";
+        providers: ("github" | "google")[];
+        allowedDomains?: string[] | undefined;
+    };
+    admins: {
+        emails: string[];
+    };
+    branding?: {
+        name: string;
+        logo?: string | undefined;
+    } | undefined;
+}, {
+    github: {
+        owner: string;
+        repo: string;
+        branch?: string | undefined;
+        docsPath?: string | undefined;
+    };
+    auth: {
+        mode: "public";
+        adminPassword: string;
+    } | {
+        mode: "domain-restricted";
+        allowedDomains: string[];
+        emailFrom: string;
+    } | {
+        mode: "oauth";
+        providers: ("github" | "google")[];
+        allowedDomains?: string[] | undefined;
+    };
+    admins: {
+        emails: string[];
+    };
+    branding?: {
+        name?: string | undefined;
+        logo?: string | undefined;
+    } | undefined;
+}>;
+export type DocsConfig = z.infer<typeof configSchema>;
+interface EnvValidationResult {
+    valid: boolean;
+    missing: string[];
+    warnings: string[];
+}
+/**
+ * Validate environment variables with detailed feedback
+ */
+export declare function validateEnv(config?: DocsConfig): EnvValidationResult;
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/dist/core/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/core/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoBxB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BvB,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAEtD,UAAU,mBAAmB;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,mBAAmB,CA+DpE"}