feat: add fluxer upstream source and self-hosting documentation
- Clone of github.com/fluxerapp/fluxer (official upstream) - SELF_HOSTING.md: full VM rebuild procedure, architecture overview, service reference, step-by-step setup, troubleshooting, seattle reference - dev/.env.example: all env vars with secrets redacted and generation instructions - dev/livekit.yaml: LiveKit config template with placeholder keys - fluxer-seattle/: existing seattle deployment setup scripts
This commit is contained in:
137
fluxer/packages/openapi/src/registry/SchemaLoader.tsx
Normal file
137
fluxer/packages/openapi/src/registry/SchemaLoader.tsx
Normal file
@@ -0,0 +1,137 @@
|
||||
/*
|
||||
* Copyright (C) 2026 Fluxer Contributors
|
||||
*
|
||||
* This file is part of Fluxer.
|
||||
*
|
||||
* Fluxer is free software: you can redistribute it and/or modify
|
||||
* it under the terms of the GNU Affero General Public License as published by
|
||||
* the Free Software Foundation, either version 3 of the License, or
|
||||
* (at your option) any later version.
|
||||
*
|
||||
* Fluxer is distributed in the hope that it will be useful,
|
||||
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
* GNU Affero General Public License for more details.
|
||||
*
|
||||
* You should have received a copy of the GNU Affero General Public License
|
||||
* along with Fluxer. If not, see <https://www.gnu.org/licenses/>.
|
||||
*/
|
||||
|
||||
import * as fs from 'node:fs';
|
||||
import * as path from 'node:path';
|
||||
import {setSchemaName, zodToOpenAPISchema} from '@fluxer/openapi/src/converters/ZodToOpenAPI';
|
||||
import type {OpenAPISchema} from '@fluxer/openapi/src/Types';
|
||||
import type {z} from 'zod';
|
||||
|
||||
export interface LoadedSchema {
|
||||
name: string;
|
||||
zodSchema: z.ZodTypeAny;
|
||||
openAPISchema: OpenAPISchema;
|
||||
}
|
||||
|
||||
function discoverSchemaModules(rootDir: string): Array<string> {
|
||||
if (!fs.existsSync(rootDir)) {
|
||||
return [];
|
||||
}
|
||||
|
||||
const results: Array<string> = [];
|
||||
const stack: Array<string> = [rootDir];
|
||||
|
||||
while (stack.length > 0) {
|
||||
const currentDir = stack.pop();
|
||||
if (!currentDir) break;
|
||||
|
||||
const entries = fs.readdirSync(currentDir, {withFileTypes: true});
|
||||
for (const entry of entries) {
|
||||
const fullPath = path.join(currentDir, entry.name);
|
||||
|
||||
if (entry.isDirectory()) {
|
||||
if (entry.name === 'tests' || entry.name === 'node_modules') continue;
|
||||
stack.push(fullPath);
|
||||
continue;
|
||||
}
|
||||
|
||||
if (!entry.isFile()) continue;
|
||||
if (!entry.name.endsWith('.tsx')) continue;
|
||||
if (entry.name.endsWith('.test.tsx')) continue;
|
||||
|
||||
results.push(fullPath);
|
||||
}
|
||||
}
|
||||
|
||||
return results.sort();
|
||||
}
|
||||
|
||||
function getModulePaths(basePath: string): Array<string> {
|
||||
const schemaDomains = path.join(basePath, 'packages', 'schema', 'src', 'domains');
|
||||
return discoverSchemaModules(schemaDomains);
|
||||
}
|
||||
|
||||
function isZodSchema(value: unknown): value is z.ZodTypeAny {
|
||||
return (
|
||||
value !== null &&
|
||||
typeof value === 'object' &&
|
||||
'_def' in value &&
|
||||
typeof (value as {parse?: unknown}).parse === 'function'
|
||||
);
|
||||
}
|
||||
|
||||
export async function loadSchemas(basePath: string): Promise<Map<string, LoadedSchema>> {
|
||||
const schemas = new Map<string, LoadedSchema>();
|
||||
const collectedSchemas: Array<{name: string; zodSchema: z.ZodTypeAny}> = [];
|
||||
|
||||
const modulePaths = getModulePaths(basePath);
|
||||
|
||||
for (const modulePath of modulePaths) {
|
||||
try {
|
||||
const moduleExports = await import(modulePath);
|
||||
|
||||
for (const [exportName, exportValue] of Object.entries(moduleExports)) {
|
||||
if (exportName.startsWith('_')) {
|
||||
continue;
|
||||
}
|
||||
if (typeof exportValue === 'function') {
|
||||
continue;
|
||||
}
|
||||
|
||||
if (isZodSchema(exportValue)) {
|
||||
collectedSchemas.push({name: exportName, zodSchema: exportValue});
|
||||
}
|
||||
}
|
||||
} catch (error) {
|
||||
console.warn(`Warning: Could not load schema module ${modulePath}:`, error);
|
||||
}
|
||||
}
|
||||
|
||||
for (const {name, zodSchema} of collectedSchemas) {
|
||||
setSchemaName(zodSchema, name);
|
||||
}
|
||||
|
||||
for (const {name, zodSchema} of collectedSchemas) {
|
||||
const openAPISchemaOrRef = zodToOpenAPISchema(zodSchema);
|
||||
if ('$ref' in openAPISchemaOrRef) {
|
||||
throw new Error(`Top-level schema export must not be a $ref: ${name}`);
|
||||
}
|
||||
const openAPISchema: OpenAPISchema = openAPISchemaOrRef;
|
||||
schemas.set(name, {
|
||||
name,
|
||||
zodSchema,
|
||||
openAPISchema,
|
||||
});
|
||||
}
|
||||
|
||||
return schemas;
|
||||
}
|
||||
|
||||
export function getSchemaNames(basePath: string): Array<string> {
|
||||
const modulePaths = getModulePaths(basePath);
|
||||
const names: Array<string> = [];
|
||||
|
||||
for (const modulePath of modulePaths) {
|
||||
const parts = modulePath.split('/');
|
||||
const fileName = parts[parts.length - 1];
|
||||
names.push(fileName);
|
||||
}
|
||||
|
||||
return names;
|
||||
}
|
||||
Reference in New Issue
Block a user