raffel 0.1.2

package/dist/server/route-discovery.js

@@ -0,0 +1,154 @@
+/**
+ * Route Discovery
+ *
+ * Loads route definitions from a directory tree and registers them
+ * into a RouterModule with deterministic path-to-name mapping.
+ */
+import { readdir } from 'node:fs/promises';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { createRouterModule } from './router-module.js';
+const DEFAULT_EXTENSIONS = ['.js', '.mjs', '.ts'];
+const DEFAULT_IGNORE_DIRS = new Set(['node_modules', '.git']);
+/**
+ * Convert a route file path into a canonical handler name.
+ */
+export function pathToRouteName(rootDir, filePath) {
+    const relativePath = path.relative(rootDir, filePath);
+    const parsed = path.parse(relativePath);
+    const segments = relativePath.split(path.sep);
+    segments[segments.length - 1] = parsed.name;
+    if (segments[segments.length - 1] === 'index' && segments.length > 1) {
+        segments.pop();
+    }
+    return segments.filter((segment) => segment.length > 0).join('.');
+}
+function normalizeExtensions(extensions) {
+    if (!extensions || extensions.length === 0)
+        return DEFAULT_EXTENSIONS;
+    return extensions.map((ext) => (ext.startsWith('.') ? ext : `.${ext}`));
+}
+function isRouteDefinition(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const record = value;
+    if (record.kind !== 'procedure' && record.kind !== 'stream' && record.kind !== 'event') {
+        return false;
+    }
+    if (typeof record.handler !== 'function') {
+        return false;
+    }
+    if (record.interceptors !== undefined && !Array.isArray(record.interceptors)) {
+        return false;
+    }
+    return true;
+}
+async function collectRouteFiles(rootDir, extensions, ignore) {
+    const entries = await readdir(rootDir, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        const fullPath = path.join(rootDir, entry.name);
+        if (entry.isDirectory()) {
+            if (DEFAULT_IGNORE_DIRS.has(entry.name)) {
+                continue;
+            }
+            if (ignore?.(fullPath)) {
+                continue;
+            }
+            files.push(...await collectRouteFiles(fullPath, extensions, ignore));
+            continue;
+        }
+        if (!entry.isFile())
+            continue;
+        if (ignore?.(fullPath)) {
+            continue;
+        }
+        const ext = path.extname(entry.name);
+        if (extensions.includes(ext)) {
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+/**
+ * Load route files into a RouterModule.
+ */
+export async function loadRouterModule(options) {
+    const rootDir = path.resolve(options.rootDir);
+    const extensions = normalizeExtensions(options.extensions);
+    const module = createRouterModule(options.prefix ?? '');
+    const files = await collectRouteFiles(rootDir, extensions, options.ignore);
+    const seen = new Map();
+    for (const filePath of files) {
+        const routeName = pathToRouteName(rootDir, filePath);
+        if (!routeName) {
+            throw new Error(`Route file '${filePath}' resolves to an empty handler name`);
+        }
+        const existing = seen.get(routeName);
+        if (existing) {
+            throw new Error(`Duplicate route name '${routeName}' from '${existing}' and '${filePath}'`);
+        }
+        seen.set(routeName, filePath);
+        const mod = await import(pathToFileURL(filePath).href);
+        const definition = mod.route ?? mod.default;
+        if (!isRouteDefinition(definition)) {
+            throw new Error(`Invalid route definition in '${filePath}'`);
+        }
+        registerRoute(module, routeName, definition);
+    }
+    return module;
+}
+function registerRoute(module, name, definition) {
+    const interceptors = definition.interceptors ?? [];
+    const schema = definition.schema;
+    if (definition.kind === 'procedure') {
+        const builder = module.procedure(name);
+        // Cast to z.ZodType - the schema is expected to be a Zod schema for the builder API
+        if (schema?.input)
+            builder.input(schema.input);
+        if (schema?.output)
+            builder.output(schema.output);
+        if (definition.description)
+            builder.description(definition.description);
+        if (definition.graphql)
+            builder.graphql(definition.graphql.type);
+        for (const interceptor of interceptors)
+            builder.use(interceptor);
+        // Cast needed because ProcedureHandler allows sync returns but builder expects Promise
+        builder.handler(definition.handler);
+        return;
+    }
+    if (definition.kind === 'stream') {
+        const builder = module.stream(name);
+        // Cast to z.ZodType - the schema is expected to be a Zod schema for the builder API
+        if (schema?.input)
+            builder.input(schema.input);
+        if (schema?.output)
+            builder.output(schema.output);
+        if (definition.description)
+            builder.description(definition.description);
+        for (const interceptor of interceptors)
+            builder.use(interceptor);
+        // Cast needed because StreamHandler is a union type
+        builder.handler(definition.handler);
+        return;
+    }
+    const builder = module.event(name);
+    // Cast to z.ZodType - the schema is expected to be a Zod schema for the builder API
+    if (schema?.input)
+        builder.input(schema.input);
+    if (definition.description)
+        builder.description(definition.description);
+    for (const interceptor of interceptors)
+        builder.use(interceptor);
+    if (definition.delivery)
+        builder.delivery(definition.delivery);
+    if (definition.retryPolicy)
+        builder.retryPolicy(definition.retryPolicy);
+    if (definition.deduplicationWindow !== undefined) {
+        builder.deduplicationWindow(definition.deduplicationWindow);
+    }
+    // Cast needed because EventHandler allows void return but builder expects Promise<void>
+    builder.handler(definition.handler);
+}
+//# sourceMappingURL=route-discovery.js.map

package/dist/server/route-discovery.js.map

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

package/dist/server/router-module.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Router Module
+ *
+ * Reusable route bundles with prefix composition and module-level interceptors.
+ */
+import type { Interceptor, ProcedureHandler, StreamHandler, EventHandler, DeliveryGuarantee, RetryPolicy, StreamDirection, JsonRpcMeta, GrpcMeta } from '../types/index.js';
+import type { HandlerSchema } from '../validation/index.js';
+import type { RouterModule, BeforeHook, AfterHook, ErrorHook } from './types.js';
+type ModuleRouteKind = 'procedure' | 'stream' | 'event';
+export interface ModuleRoute {
+    kind: ModuleRouteKind;
+    name: string;
+    handler: ProcedureHandler | StreamHandler | EventHandler;
+    /** Short summary for OpenAPI (one-liner) */
+    summary?: string;
+    /** Description for OpenAPI (supports markdown) */
+    description?: string;
+    /** Tags for OpenAPI grouping */
+    tags?: string[];
+    /** HTTP path override for procedures */
+    httpPath?: string;
+    /** HTTP method override for procedures */
+    httpMethod?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+    /** JSON-RPC metadata for USD generation */
+    jsonrpc?: JsonRpcMeta;
+    /** gRPC metadata for USD generation */
+    grpc?: GrpcMeta;
+    moduleInterceptors: Interceptor[];
+    interceptors: Interceptor[];
+    schema?: HandlerSchema;
+    streamDirection?: StreamDirection;
+    delivery?: DeliveryGuarantee;
+    retryPolicy?: RetryPolicy;
+    deduplicationWindow?: number;
+    /** Procedure hooks (only for procedure kind) */
+    beforeHooks?: BeforeHook<any>[];
+    afterHooks?: AfterHook<any, any>[];
+    errorHooks?: ErrorHook<any>[];
+    /** GraphQL mapping (only for procedure kind) */
+    graphql?: {
+        type: 'query' | 'mutation';
+    };
+}
+export interface RouterModuleDefinition {
+    routes: ModuleRoute[];
+}
+export declare function createRouterModule(prefix?: string): RouterModule;
+export declare function getRouterModuleDefinition(module: RouterModule): RouterModuleDefinition;
+export {};
+//# sourceMappingURL=router-module.d.ts.map

package/dist/server/router-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-module.d.ts","sourceRoot":"","sources":["../../src/server/router-module.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,WAAW,EACX,QAAQ,EACT,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,KAAK,EAIV,YAAY,EACZ,UAAU,EACV,SAAS,EACT,SAAS,EACV,MAAM,YAAY,CAAA;AAEnB,KAAK,eAAe,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAA;AAEvD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,gBAAgB,GAAG,aAAa,GAAG,YAAY,CAAA;IACxD,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAA;IAC7E,2CAA2C;IAC3C,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,uCAAuC;IACvC,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,kBAAkB,EAAE,WAAW,EAAE,CAAA;IACjC,YAAY,EAAE,WAAW,EAAE,CAAA;IAC3B,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,gDAAgD;IAChD,WAAW,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAAA;IAC/B,UAAU,CAAC,EAAE,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAA;IAClC,UAAU,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,CAAA;IAC7B,gDAAgD;IAChD,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,OAAO,GAAG,UAAU,CAAA;KAAE,CAAA;CACzC;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,WAAW,EAAE,CAAA;CACtB;AAyQD,wBAAgB,kBAAkB,CAAC,MAAM,SAAK,GAAG,YAAY,CAG5D;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,sBAAsB,CAOtF"}

package/dist/server/router-module.js

@@ -0,0 +1,250 @@
+/**
+ * Router Module
+ *
+ * Reusable route bundles with prefix composition and module-level interceptors.
+ */
+const MODULE_DEF = Symbol('raffel.router-module');
+function buildName(prefix, name) {
+    if (!prefix)
+        return name;
+    if (!name)
+        return prefix;
+    return `${prefix}.${name}`;
+}
+function createProcedureBuilder(definition, name, moduleInterceptors) {
+    let inputSchema;
+    let outputSchema;
+    let summary;
+    let description;
+    let procedureTags;
+    let httpPath;
+    let httpMethod;
+    const interceptors = [];
+    const beforeHooks = [];
+    const afterHooks = [];
+    const errorHooks = [];
+    let graphqlMeta;
+    let jsonrpcMeta;
+    let grpcMeta;
+    const builder = {
+        input(schema) {
+            inputSchema = schema;
+            return builder;
+        },
+        output(schema) {
+            outputSchema = schema;
+            return builder;
+        },
+        summary(sum) {
+            summary = sum;
+            return builder;
+        },
+        tags(tagsArr) {
+            procedureTags = tagsArr;
+            return builder;
+        },
+        description(desc) {
+            description = desc;
+            return builder;
+        },
+        http(path, method) {
+            httpPath = path;
+            httpMethod = method;
+            return builder;
+        },
+        use(interceptor) {
+            interceptors.push(interceptor);
+            return builder;
+        },
+        graphql(type) {
+            graphqlMeta = { type };
+            return builder;
+        },
+        jsonrpc(meta) {
+            jsonrpcMeta = meta;
+            return builder;
+        },
+        grpc(meta) {
+            grpcMeta = meta;
+            return builder;
+        },
+        before(hook) {
+            beforeHooks.push(hook);
+            return builder;
+        },
+        after(hook) {
+            afterHooks.push(hook);
+            return builder;
+        },
+        error(hook) {
+            errorHooks.push(hook);
+            return builder;
+        },
+        handler(fn) {
+            const schema = {};
+            if (inputSchema)
+                schema.input = inputSchema;
+            if (outputSchema)
+                schema.output = outputSchema;
+            definition.routes.push({
+                kind: 'procedure',
+                name,
+                handler: fn,
+                summary,
+                description,
+                tags: procedureTags,
+                httpPath,
+                httpMethod,
+                jsonrpc: jsonrpcMeta,
+                grpc: grpcMeta,
+                moduleInterceptors: [...moduleInterceptors],
+                interceptors: [...interceptors],
+                schema: schema.input || schema.output ? schema : undefined,
+                beforeHooks: beforeHooks.length > 0 ? [...beforeHooks] : undefined,
+                afterHooks: afterHooks.length > 0 ? [...afterHooks] : undefined,
+                errorHooks: errorHooks.length > 0 ? [...errorHooks] : undefined,
+                graphql: graphqlMeta,
+            });
+        },
+    };
+    return builder;
+}
+function createStreamBuilder(definition, name, moduleInterceptors) {
+    let inputSchema;
+    let outputSchema;
+    let description;
+    let streamDirection;
+    const interceptors = [];
+    const builder = {
+        input(schema) {
+            inputSchema = schema;
+            return builder;
+        },
+        output(schema) {
+            outputSchema = schema;
+            return builder;
+        },
+        direction(direction) {
+            streamDirection = direction;
+            return builder;
+        },
+        description(desc) {
+            description = desc;
+            return builder;
+        },
+        use(interceptor) {
+            interceptors.push(interceptor);
+            return builder;
+        },
+        handler(fn) {
+            const schema = {};
+            if (inputSchema)
+                schema.input = inputSchema;
+            if (outputSchema)
+                schema.output = outputSchema;
+            definition.routes.push({
+                kind: 'stream',
+                name,
+                handler: fn,
+                description,
+                moduleInterceptors: [...moduleInterceptors],
+                interceptors: [...interceptors],
+                schema: schema.input || schema.output ? schema : undefined,
+                streamDirection,
+            });
+        },
+    };
+    return builder;
+}
+function createEventBuilder(definition, name, moduleInterceptors) {
+    let inputSchema;
+    let description;
+    let deliveryGuarantee = 'best-effort';
+    let retryPolicy;
+    let deduplicationWindow;
+    const interceptors = [];
+    const builder = {
+        input(schema) {
+            inputSchema = schema;
+            return builder;
+        },
+        description(desc) {
+            description = desc;
+            return builder;
+        },
+        use(interceptor) {
+            interceptors.push(interceptor);
+            return builder;
+        },
+        delivery(guarantee) {
+            deliveryGuarantee = guarantee;
+            return builder;
+        },
+        retryPolicy(policy) {
+            retryPolicy = policy;
+            return builder;
+        },
+        deduplicationWindow(ms) {
+            deduplicationWindow = ms;
+            return builder;
+        },
+        handler(fn) {
+            const schema = {};
+            if (inputSchema)
+                schema.input = inputSchema;
+            definition.routes.push({
+                kind: 'event',
+                name,
+                handler: fn,
+                description,
+                moduleInterceptors: [...moduleInterceptors],
+                interceptors: [...interceptors],
+                schema: schema.input ? schema : undefined,
+                delivery: deliveryGuarantee,
+                retryPolicy,
+                deduplicationWindow,
+            });
+        },
+    };
+    return builder;
+}
+function createModuleView(definition, prefix, inheritedInterceptors) {
+    const moduleInterceptors = [...inheritedInterceptors];
+    const module = {
+        use(interceptor) {
+            moduleInterceptors.push(interceptor);
+            return module;
+        },
+        procedure(name) {
+            const fullName = buildName(prefix, name);
+            return createProcedureBuilder(definition, fullName, [...moduleInterceptors]);
+        },
+        stream(name) {
+            const fullName = buildName(prefix, name);
+            return createStreamBuilder(definition, fullName, [...moduleInterceptors]);
+        },
+        event(name) {
+            const fullName = buildName(prefix, name);
+            return createEventBuilder(definition, fullName, [...moduleInterceptors]);
+        },
+        group(subPrefix) {
+            const fullPrefix = buildName(prefix, subPrefix);
+            return createModuleView(definition, fullPrefix, [...moduleInterceptors]);
+        },
+        [MODULE_DEF]: definition,
+    };
+    return module;
+}
+export function createRouterModule(prefix = '') {
+    const definition = { routes: [] };
+    return createModuleView(definition, prefix, []);
+}
+export function getRouterModuleDefinition(module) {
+    const internal = module;
+    const definition = internal[MODULE_DEF];
+    if (!definition) {
+        throw new Error('Invalid RouterModule instance');
+    }
+    return definition;
+}
+//# sourceMappingURL=router-module.js.map

package/dist/server/router-module.js.map

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

package/dist/server/shared-context.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Cross-Protocol Context Sharing
+ *
+ * Enables sharing authentication and session context across different
+ * protocols (HTTP, WebSocket, Streams). This allows users authenticated
+ * via HTTP to use WebSocket/SSE without re-authenticating.
+ *
+ * @example
+ * import { createServer } from 'raffel'
+ * import { createSharedContextFactory } from 'raffel/server/shared-context'
+ * import { createSessionTracker } from 'raffel/http/session'
+ *
+ * const sessions = createSessionTracker({ maxAge: 3600000 })
+ *
+ * const server = createServer({
+ *   websocket: {
+ *     contextFactory: createSharedContextFactory({
+ *       sessions,
+ *       cookieName: 'session_id',
+ *     }),
+ *   },
+ * })
+ */
+import type { IncomingMessage } from 'node:http';
+import type { Context, AuthContext } from '../types/index.js';
+import type { Session, SessionTracker } from '../http/session.js';
+/**
+ * Options for creating a shared context factory
+ */
+export interface SharedContextFactoryOptions {
+    /** Session tracker instance (shared across protocols) */
+    sessions: SessionTracker;
+    /** Cookie name for session ID
+     * @default 'session_id'
+     */
+    cookieName?: string;
+    /** Also check query param for session ID (useful for EventSource)
+     * @default 'sessionId'
+     */
+    queryParamName?: string | false;
+    /** Also check Authorization header for bearer token
+     * @default true
+     */
+    checkAuthHeader?: boolean;
+    /** Custom session to auth mapper */
+    mapSessionToAuth?: (session: Session) => AuthContext;
+    /** Called when context is created (for logging/metrics) */
+    onContextCreated?: (ctx: Partial<Context>, req: IncomingMessage) => void;
+}
+/**
+ * Context factory function type for WebSocket/Streams
+ * Returns partial context that will be merged into the full context
+ */
+export type ProtocolContextFactory<WS = unknown> = (ws: WS, req: IncomingMessage) => Partial<Omit<Context, 'requestId' | 'extensions'>> | Promise<Partial<Omit<Context, 'requestId' | 'extensions'>>>;
+/**
+ * Create a context factory for WebSocket/Streams that shares sessions with HTTP
+ *
+ * This factory extracts the session ID from:
+ * 1. Cookies (from the WebSocket upgrade request)
+ * 2. Query params (for EventSource that can't set cookies)
+ * 3. Authorization header (for bearer tokens)
+ *
+ * @example
+ * const contextFactory = createSharedContextFactory({
+ *   sessions,
+ *   cookieName: 'session_id',
+ * })
+ *
+ * // Use with WebSocket
+ * const server = createServer({
+ *   websocket: { contextFactory },
+ * })
+ *
+ * // Now WebSocket handlers can access ctx.auth
+ * server.ws
+ *   .onSubscribe(async (channel, ctx) => {
+ *     if (!ctx.auth?.authenticated) {
+ *       throw new Error('Must be logged in')
+ *     }
+ *   })
+ *   .channel('chat', { type: 'private' })
+ */
+export declare function createSharedContextFactory(options: SharedContextFactoryOptions): ProtocolContextFactory;
+/**
+ * Create a simple auth context factory for protocols that don't need session storage
+ * Just extracts auth info from the request without persistence
+ *
+ * @example
+ * const contextFactory = createAuthContextFactory({
+ *   verifyToken: async (token) => {
+ *     // Verify JWT and return user info
+ *     const payload = await verifyJWT(token)
+ *     return { authenticated: true, principal: payload.sub }
+ *   },
+ * })
+ */
+export declare function createAuthContextFactory(options: {
+    /** Verify bearer token and return auth context */
+    verifyToken?: (token: string) => Promise<AuthContext | null>;
+    /** Verify API key and return auth context */
+    verifyApiKey?: (apiKey: string) => Promise<AuthContext | null>;
+    /** API key header name
+     * @default 'x-api-key'
+     */
+    apiKeyHeader?: string;
+    /** Also check query param for API key
+     * @default 'apiKey'
+     */
+    apiKeyQueryParam?: string | false;
+}): ProtocolContextFactory;
+/**
+ * Merge multiple context factories into one
+ * Each factory is tried in order; first non-empty auth wins
+ *
+ * @example
+ * const contextFactory = mergeContextFactories([
+ *   createSharedContextFactory({ sessions }),
+ *   createAuthContextFactory({ verifyToken }),
+ * ])
+ */
+export declare function mergeContextFactories(factories: ProtocolContextFactory[]): ProtocolContextFactory;
+/**
+ * Symbol for storing session in context.extensions
+ * Usage: ctx.extensions.get(SESSION_SYMBOL)
+ */
+export declare const SESSION_SYMBOL: unique symbol;
+/**
+ * Symbol for storing original HTTP request in context.extensions
+ * Usage: ctx.extensions.get(HTTP_REQUEST_SYMBOL)
+ */
+export declare const HTTP_REQUEST_SYMBOL: unique symbol;
+/**
+ * Helper to get session from context extensions
+ */
+export declare function getSessionFromContext(ctx: Context): Session | undefined;
+/**
+ * Helper to get original HTTP request from context extensions
+ */
+export declare function getHttpRequestFromContext(ctx: Context): IncomingMessage | undefined;
+//# sourceMappingURL=shared-context.d.ts.map

package/dist/server/shared-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-context.d.ts","sourceRoot":"","sources":["../../src/server/shared-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAMjE;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,yDAAyD;IACzD,QAAQ,EAAE,cAAc,CAAA;IAExB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAE/B;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IAEzB,oCAAoC;IACpC,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,WAAW,CAAA;IAEpD,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,eAAe,KAAK,IAAI,CAAA;CACzE;AAED;;;GAGG;AACH,MAAM,MAAM,sBAAsB,CAAC,EAAE,GAAG,OAAO,IAAI,CACjD,EAAE,EAAE,EAAE,EACN,GAAG,EAAE,eAAe,KACjB,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,CAAA;AAqErH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,2BAA2B,GACnC,sBAAsB,CA4DxB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,kDAAkD;IAClD,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IAC5D,6CAA6C;IAC7C,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IAC9D;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;CAClC,GAAG,sBAAsB,CA8CzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,sBAAsB,EAAE,GAClC,sBAAsB,CAiBxB;AAMD;;;GAGG;AACH,eAAO,MAAM,cAAc,eAA+B,CAAA;AAE1D;;;GAGG;AACH,eAAO,MAAM,mBAAmB,eAAmC,CAAA;AAEnE;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAEvE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAEnF"}