@c9up/ream 0.1.3

package/dist/router/Router.js

@@ -0,0 +1,552 @@
+/**
+ * Fluent Router — AdonisJS v6 compatible routing with controllers, resources, and groups.
+ *
+ * @implements FR24, FR25, FR26, FR27, FR28
+ */
+import { resolveMiddlewareEntry } from '../server/Server.js';
+// ─── Matchers ───────────────────────────────────────────────
+export const matchers = {
+    /** Match numeric params only. */
+    number() {
+        return { pattern: /^\d+$/ };
+    },
+    /** Match UUID v4 params only. */
+    uuid() {
+        return { pattern: /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i };
+    },
+    /** Match slug params only (lowercase alphanumeric + hyphens). */
+    slug() {
+        return { pattern: /^[a-z0-9]+(?:-[a-z0-9]+)*$/ };
+    },
+};
+// ─── RouteBuilder ───────────────────────────────────────────
+/** Fluent route builder — mutates the already-registered route definition. */
+export class RouteBuilder {
+    #route;
+    constructor(route) {
+        this.#route = route;
+    }
+    /** Name this route (for URL generation and redirects). */
+    as(name) {
+        this.#route.name = name;
+        return this;
+    }
+    /** Add named middleware. */
+    middleware(...names) {
+        this.#route.middleware.push(...names);
+        return this;
+    }
+    /** Add inline middleware functions. */
+    use(...mw) {
+        this.#route.inlineMiddleware.push(...mw);
+        return this;
+    }
+    /** Add authentication guards. */
+    guard(...guards) {
+        this.#route.guards.push(...guards);
+        return this;
+    }
+    /** Require specific roles. */
+    role(...roles) {
+        this.#route.roles.push(...roles);
+        return this;
+    }
+    /** Require specific permissions. */
+    permission(...permissions) {
+        this.#route.permissions.push(...permissions);
+        return this;
+    }
+    /** Add a param constraint. */
+    where(param, matcher) {
+        this.#route.matchers[param] = matcher instanceof RegExp ? { pattern: matcher } : matcher;
+        return this;
+    }
+    /** Attach a validator. */
+    validate(validator) {
+        this.#route.validators.push(validator);
+        return this;
+    }
+    /** Set API version. */
+    version(v) {
+        this.#route.version = v;
+        return this;
+    }
+    /** Restrict to a specific domain. */
+    domain(d) {
+        this.#route.domain = d;
+        return this;
+    }
+    /** Mark as deprecated. */
+    deprecates(version, options) {
+        this.#route.deprecates = { version, sunset: options?.sunset };
+        return this;
+    }
+    /** @internal Get the underlying definition. */
+    getDefinition() {
+        return this.#route;
+    }
+}
+// ─── GroupBuilder ───────────────────────────────────────────
+/** Fluent group builder — returned by router.group(callback). */
+export class GroupBuilder {
+    #routes;
+    constructor(routes) {
+        this.#routes = routes;
+    }
+    /** Set URL prefix for all routes in the group. */
+    prefix(p) {
+        for (const route of this.#routes) {
+            route.path = p + route.path;
+        }
+        return this;
+    }
+    /** Add middleware to all routes in the group. */
+    middleware(...names) {
+        for (const route of this.#routes) {
+            route.middleware = [...names, ...route.middleware];
+        }
+        return this;
+    }
+    /** Add inline middleware to all routes in the group. */
+    use(...mw) {
+        for (const route of this.#routes) {
+            route.inlineMiddleware = [...mw, ...route.inlineMiddleware];
+        }
+        return this;
+    }
+    /** Add guards to all routes in the group. */
+    guard(...guards) {
+        for (const route of this.#routes) {
+            route.guards = [...guards, ...route.guards];
+        }
+        return this;
+    }
+    /** Prefix route names for all routes in the group. */
+    as(namePrefix) {
+        for (const route of this.#routes) {
+            if (route.name) {
+                route.name = `${namePrefix}.${route.name}`;
+            }
+        }
+        return this;
+    }
+    /** Set domain for all routes in the group. */
+    domain(d) {
+        for (const route of this.#routes) {
+            route.domain = d;
+        }
+        return this;
+    }
+    /** Add param matcher to all routes in the group. */
+    where(param, matcher) {
+        const m = matcher instanceof RegExp ? { pattern: matcher } : matcher;
+        for (const route of this.#routes) {
+            if (!(param in route.matchers)) {
+                route.matchers[param] = m;
+            }
+        }
+        return this;
+    }
+}
+function isViewEngine(value) {
+    return (value !== null &&
+        typeof value === 'object' &&
+        'render' in value &&
+        typeof value.render === 'function');
+}
+// ─── OnRouteBuilder ─────────────────────────────────────────
+/** Builder for on(path).render(view) and on(path).redirect(target). */
+export class OnRouteBuilder {
+    #router;
+    #path;
+    constructor(router, path) {
+        this.#router = router;
+        this.#path = path;
+    }
+    /** Render a view (requires Photon/view provider). */
+    render(view, data) {
+        return this.#router.get(this.#path, async (ctx) => {
+            const raw = ctx.store.get('view');
+            if (!isViewEngine(raw)) {
+                throw new Error('View engine not configured. Register a view provider (Photon) first.');
+            }
+            const viewEngine = raw;
+            const html = await viewEngine.render(view, data);
+            ctx.response.type('text/html; charset=utf-8').send(html);
+        });
+    }
+    /** Redirect to a path. */
+    redirect(target, status = 302) {
+        return this.#router.get(this.#path, async (ctx) => {
+            ctx.response.redirect().status(status).toPath(target);
+        });
+    }
+    /** Redirect to a named route. */
+    redirectToRoute(name, params, status = 302) {
+        return this.#router.get(this.#path, async (ctx) => {
+            ctx.response.redirect().status(status).toRoute(name, params);
+        });
+    }
+}
+// ─── Router ─────────────────────────────────────────────────
+/** Main Router. */
+export class Router {
+    #routes = [];
+    #globalMatchers = {};
+    #routerMiddleware = [];
+    #namedMiddleware = new Map();
+    /** Index: static routes by "METHOD:path" for O(1) exact match. */
+    #staticIndex = new Map();
+    /** Index: parametric routes grouped by method. */
+    #paramIndex = new Map();
+    /** Index: named routes for O(1) URL generation. */
+    #nameIndex = new Map();
+    /** Whether the index needs rebuilding. */
+    #indexDirty = true;
+    /** Predefined param matchers. */
+    matchers = matchers;
+    // ─── Router-level middleware (like AdonisJS) ──────────────
+    /**
+     * Register router-level middleware (runs on requests with a matched route).
+     *   router.use([() => import('#middleware/auth_middleware')])
+     */
+    use(middleware) {
+        for (const mw of middleware) {
+            this.#routerMiddleware.push(resolveMiddlewareEntry(mw));
+        }
+        return this;
+    }
+    /**
+     * Register named middleware collection.
+     *   export const middleware = router.named({
+     *     auth: () => import('#middleware/auth_middleware'),
+     *   })
+     */
+    named(collection) {
+        const resolved = {};
+        for (const [name, mw] of Object.entries(collection)) {
+            const fn = resolveMiddlewareEntry(mw);
+            this.#namedMiddleware.set(name, fn);
+            resolved[name] = fn;
+        }
+        return resolved;
+    }
+    /** Get the router-level middleware stack. */
+    getRouterMiddleware() {
+        return [...this.#routerMiddleware];
+    }
+    /** Get a named middleware by name. */
+    getNamedMiddleware(name) {
+        return this.#namedMiddleware.get(name);
+    }
+    // ─── Route registration ───────────────────────────────────
+    /** Register a route with any HTTP method. */
+    route(method, path, handler) {
+        const def = this.#createDefinition(method, path, handler);
+        this.#routes.push(def);
+        this.#indexDirty = true;
+        return new RouteBuilder(def);
+    }
+    get(path, handler) {
+        return this.route('GET', path, handler);
+    }
+    post(path, handler) {
+        return this.route('POST', path, handler);
+    }
+    put(path, handler) {
+        return this.route('PUT', path, handler);
+    }
+    patch(path, handler) {
+        return this.route('PATCH', path, handler);
+    }
+    delete(path, handler) {
+        return this.route('DELETE', path, handler);
+    }
+    head(path, handler) {
+        return this.route('HEAD', path, handler);
+    }
+    options(path, handler) {
+        return this.route('OPTIONS', path, handler);
+    }
+    /** Register a route for all HTTP methods. */
+    any(path, handler) {
+        return this.route('*', path, handler);
+    }
+    // ─── Resource routes ──────────────────────────────────────
+    /**
+     * Register resourceful routes for a controller.
+     * Generates: index, store, show, update, destroy
+     *
+     * Usage:
+     *   router.resource('posts', PostsController)
+     *   // GET    /posts          → PostsController.index
+     *   // POST   /posts          → PostsController.store
+     *   // GET    /posts/:id      → PostsController.show
+     *   // PUT    /posts/:id      → PostsController.update
+     *   // DELETE /posts/:id      → PostsController.destroy
+     */
+    // biome-ignore lint/suspicious/noExplicitAny: see ControllerAction
+    resource(path, controller) {
+        const baseName = path.replace(/\//g, '.');
+        const routes = [];
+        const actions = [
+            { method: 'GET', suffix: '', action: 'index', nameSuffix: 'index' },
+            { method: 'POST', suffix: '', action: 'store', nameSuffix: 'store' },
+            { method: 'GET', suffix: '/:id', action: 'show', nameSuffix: 'show' },
+            { method: 'PUT', suffix: '/:id', action: 'update', nameSuffix: 'update' },
+            { method: 'PATCH', suffix: '/:id', action: 'update', nameSuffix: 'update' },
+            { method: 'DELETE', suffix: '/:id', action: 'destroy', nameSuffix: 'destroy' },
+        ];
+        for (const { method, suffix, action, nameSuffix } of actions) {
+            const def = this.#createDefinition(method, `/${path}${suffix}`, [controller, action]);
+            def.name = `${baseName}.${nameSuffix}`;
+            routes.push(def);
+            this.#routes.push(def);
+        }
+        this.#indexDirty = true;
+        return new GroupBuilder(routes);
+    }
+    group(callbackOrConfig, legacyCallback) {
+        if (typeof callbackOrConfig === 'function') {
+            // AdonisJS-style: group(() => { ... }).prefix().middleware()
+            const snapshot = this.#routes.length;
+            callbackOrConfig();
+            const newRoutes = this.#routes.slice(snapshot);
+            return new GroupBuilder(newRoutes);
+        }
+        // Legacy-style: group({ prefix, guards }, (r) => { ... })
+        const config = callbackOrConfig;
+        const childRouter = new Router();
+        legacyCallback?.(childRouter);
+        for (const route of childRouter.#routes) {
+            this.#routes.push({
+                ...route,
+                path: (config.prefix ?? '') + route.path,
+                middleware: [...(config.middleware ?? []), ...route.middleware],
+                guards: [...(config.guards ?? []), ...route.guards],
+                roles: [...(config.roles ?? []), ...route.roles],
+                permissions: [...(config.permissions ?? []), ...route.permissions],
+            });
+        }
+        this.#indexDirty = true;
+    }
+    // ─── On (view/redirect shortcuts) ─────────────────────────
+    /** Create a view/redirect route shortcut. */
+    on(path) {
+        return new OnRouteBuilder(this, path);
+    }
+    // ─── Global matchers ──────────────────────────────────────
+    /** Set a global param matcher (applied to all routes). */
+    where(param, matcher) {
+        this.#globalMatchers[param] = matcher instanceof RegExp ? { pattern: matcher } : matcher;
+        return this;
+    }
+    // ─── Route matching ───────────────────────────────────────
+    /** Build route indexes for fast matching. Called lazily on first match. */
+    #buildIndex() {
+        this.#staticIndex.clear();
+        this.#paramIndex.clear();
+        this.#nameIndex.clear();
+        for (const route of this.#routes) {
+            // Named route index
+            if (route.name) {
+                this.#nameIndex.set(route.name, route);
+            }
+            const isParam = route.path.includes(':') || route.path.includes('*');
+            if (!isParam && !route.domain) {
+                // Static route — O(1) exact match
+                const key = route.method === '*' ? `*:${route.path}` : `${route.method}:${route.path}`;
+                this.#staticIndex.set(key, route);
+            }
+            else {
+                // Parametric route — indexed by method
+                const methods = route.method === '*'
+                    ? ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS']
+                    : [route.method];
+                for (const m of methods) {
+                    if (!this.#paramIndex.has(m))
+                        this.#paramIndex.set(m, []);
+                    this.#paramIndex.get(m)?.push(route);
+                }
+            }
+        }
+        this.#indexDirty = false;
+    }
+    /** Find a matching route, extracting :param values and validating matchers. */
+    match(method, path, host) {
+        if (this.#indexDirty)
+            this.#buildIndex();
+        const candidates = [path];
+        // Trailing-slash normalisation: `/users/` should match `/users`. Done as
+        // a fallback (not a primary rewrite) so a route declared as `/users/`
+        // still wins its exact match before we try the trimmed form.
+        if (path.length > 1 && path.endsWith('/')) {
+            candidates.push(path.slice(0, -1));
+        }
+        for (const candidatePath of candidates) {
+            // 1. Try static exact match (O(1))
+            const staticRoute = this.#staticIndex.get(`${method}:${candidatePath}`) ??
+                this.#staticIndex.get(`*:${candidatePath}`);
+            if (staticRoute) {
+                if (!staticRoute.domain || !host || matchDomain(staticRoute.domain, host)) {
+                    return { route: staticRoute, params: {} };
+                }
+            }
+            // 2. Try parametric routes (only same-method candidates)
+            const paramCandidates = this.#paramIndex.get(method) ?? [];
+            for (const route of paramCandidates) {
+                if (route.domain && host && !matchDomain(route.domain, host))
+                    continue;
+                const params = matchPath(route.path, candidatePath);
+                if (params === null)
+                    continue;
+                if (!this.#validateMatchers(params, route.matchers))
+                    continue;
+                if (!this.#validateMatchers(params, this.#globalMatchers))
+                    continue;
+                return { route, params };
+            }
+        }
+        return undefined;
+    }
+    // ─── URL generation ───────────────────────────────────────
+    /** Generate a URL from a named route. */
+    makeUrl(name, params) {
+        if (this.#indexDirty)
+            this.#buildIndex();
+        const route = this.#nameIndex.get(name);
+        if (!route) {
+            throw new Error(`Route '${name}' not found. Available: ${this.#routes
+                .filter((r) => r.name)
+                .map((r) => r.name)
+                .join(', ')}`);
+        }
+        let url = route.path;
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                url = url
+                    .replace(`:${key}?`, encodeURIComponent(value))
+                    .replace(`:${key}`, encodeURIComponent(value));
+            }
+        }
+        // Strip remaining optional placeholders (`:name?` segments not provided).
+        url = url.replace(/\/:[A-Za-z_][\w]*\?/g, '');
+        // Any remaining `:foo` is a required param the caller forgot. Surface it
+        // as a configuration error rather than emitting a broken URL.
+        const missing = url.match(/:[A-Za-z_][\w]*/g);
+        if (missing && missing.length > 0) {
+            throw new Error(`Cannot generate URL for route '${name}': missing params ${missing.join(', ')}`);
+        }
+        return url;
+    }
+    // ─── Accessors ────────────────────────────────────────────
+    /** Get all registered routes (for OpenAPI generation, introspection). */
+    getRoutes() {
+        return [...this.#routes];
+    }
+    /** Clear all registered routes (used by hot-reload). */
+    clear() {
+        this.#routes = [];
+        this.#indexDirty = true;
+    }
+    get routeCount() {
+        return this.#routes.length;
+    }
+    // ─── Internals ────────────────────────────────────────────
+    #createDefinition(method, path, handler) {
+        const def = {
+            method: method.toUpperCase(),
+            path,
+            handler: null,
+            middleware: [],
+            inlineMiddleware: [],
+            guards: [],
+            roles: [],
+            permissions: [],
+            validators: [],
+            matchers: {},
+        };
+        if (Array.isArray(handler)) {
+            def.controller = { target: handler[0], method: handler[1] };
+        }
+        else {
+            def.handler = handler;
+        }
+        return def;
+    }
+    #validateMatchers(params, matcherMap) {
+        for (const [param, value] of Object.entries(params)) {
+            const matcher = matcherMap[param];
+            if (!matcher)
+                continue;
+            const regex = matcher instanceof RegExp ? matcher : matcher.pattern;
+            if (!regex.test(value))
+                return false;
+        }
+        return true;
+    }
+}
+// ─── Path matching ──────────────────────────────────────────
+/** Match path pattern against actual path, extracting params. Returns null on no match. */
+function matchPath(pattern, actual) {
+    const patternParts = pattern.split('/');
+    const actualParts = actual.split('/');
+    // Catch-all wildcard: `/assets/*` greedily swallows the remainder of the
+    // path into a `*` param. The wildcard must be the final segment — any
+    // pattern after it would never match.
+    const wildcardIdx = patternParts.indexOf('*');
+    if (wildcardIdx !== -1) {
+        if (wildcardIdx !== patternParts.length - 1)
+            return null;
+        if (actualParts.length < wildcardIdx + 1)
+            return null;
+        const params = {};
+        for (let i = 0; i < wildcardIdx; i++) {
+            const part = patternParts[i];
+            if (part.startsWith(':')) {
+                params[part.substring(1)] = actualParts[i];
+            }
+            else if (part !== actualParts[i]) {
+                return null;
+            }
+        }
+        params['*'] = actualParts.slice(wildcardIdx).join('/');
+        return params;
+    }
+    // Count required (non-optional) pattern parts
+    const requiredCount = patternParts.filter((p) => !p.endsWith('?')).length;
+    const maxCount = patternParts.length;
+    if (actualParts.length < requiredCount || actualParts.length > maxCount)
+        return null;
+    const params = {};
+    for (let i = 0; i < patternParts.length; i++) {
+        const part = patternParts[i];
+        const isOptional = part.endsWith('?');
+        if (part.startsWith(':')) {
+            const paramName = isOptional ? part.slice(1, -1) : part.substring(1);
+            if (i < actualParts.length) {
+                params[paramName] = actualParts[i];
+            }
+            // Optional param with no actual part — skip (param not set)
+        }
+        else if (i < actualParts.length && part !== actualParts[i]) {
+            return null;
+        }
+        else if (i >= actualParts.length && !isOptional) {
+            return null;
+        }
+    }
+    return params;
+}
+/** Match domain pattern against actual host. Supports wildcards like *.example.com */
+function matchDomain(pattern, host) {
+    const actualHost = host.split(':')[0]; // strip port
+    if (pattern === actualHost)
+        return true;
+    if (pattern.startsWith('*.')) {
+        const suffix = pattern.slice(1); // ".example.com"
+        return actualHost.endsWith(suffix) && actualHost.length > suffix.length;
+    }
+    return false;
+}
+//# sourceMappingURL=Router.js.map

package/dist/router/Router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Router.js","sourceRoot":"","sources":["../../src/router/Router.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AA4C5D,+DAA+D;AAE/D,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,iCAAiC;IACjC,MAAM;QACJ,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAA;IAC7B,CAAC;IACD,iCAAiC;IACjC,IAAI;QACF,OAAO,EAAE,OAAO,EAAE,wEAAwE,EAAE,CAAA;IAC9F,CAAC;IACD,iEAAiE;IACjE,IAAI;QACF,OAAO,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAA;IAClD,CAAC;CACF,CAAA;AAED,+DAA+D;AAE/D,8EAA8E;AAC9E,MAAM,OAAO,YAAY;IACvB,MAAM,CAAiB;IAEvB,YAAY,KAAsB;QAChC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;IACrB,CAAC;IAED,0DAA0D;IAC1D,EAAE,CAAC,IAAY;QACb,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAA;QACvB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,4BAA4B;IAC5B,UAAU,CAAC,GAAG,KAAe;QAC3B,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAA;QACrC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,uCAAuC;IACvC,GAAG,CAAC,GAAG,EAAwB;QAC7B,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;QACxC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,iCAAiC;IACjC,KAAK,CAAC,GAAG,MAAgB;QACvB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAA;QAClC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,8BAA8B;IAC9B,IAAI,CAAC,GAAG,KAAe;QACrB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAA;QAChC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,oCAAoC;IACpC,UAAU,CAAC,GAAG,WAAqB;QACjC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAA;QAC5C,OAAO,IAAI,CAAA;IACb,CAAC;IAED,8BAA8B;IAC9B,KAAK,CAAC,KAAa,EAAE,OAA8B;QACjD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,OAAO,YAAY,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAA;QACxF,OAAO,IAAI,CAAA;IACb,CAAC;IAED,0BAA0B;IAC1B,QAAQ,CAAC,SAAiB;QACxB,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACtC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,uBAAuB;IACvB,OAAO,CAAC,CAAS;QACf,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,CAAC,CAAA;QACvB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,qCAAqC;IACrC,MAAM,CAAC,CAAS;QACd,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAA;QACtB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,0BAA0B;IAC1B,UAAU,CAAC,OAAe,EAAE,OAA6B;QACvD,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAA;QAC7D,OAAO,IAAI,CAAA;IACb,CAAC;IAED,+CAA+C;IAC/C,aAAa;QACX,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;CACF;AAED,+DAA+D;AAE/D,iEAAiE;AACjE,MAAM,OAAO,YAAY;IACvB,OAAO,CAAmB;IAE1B,YAAY,MAAyB;QACnC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;IACvB,CAAC;IAED,kDAAkD;IAClD,MAAM,CAAC,CAAS;QACd,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAA;QAC7B,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,iDAAiD;IACjD,UAAU,CAAC,GAAG,KAAe;QAC3B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,KAAK,CAAC,UAAU,GAAG,CAAC,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,CAAA;QACpD,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,wDAAwD;IACxD,GAAG,CAAC,GAAG,EAAwB;QAC7B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,KAAK,CAAC,gBAAgB,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,KAAK,CAAC,gBAAgB,CAAC,CAAA;QAC7D,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,6CAA6C;IAC7C,KAAK,CAAC,GAAG,MAAgB;QACvB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,KAAK,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;QAC7C,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,sDAAsD;IACtD,EAAE,CAAC,UAAkB;QACnB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBACf,KAAK,CAAC,IAAI,GAAG,GAAG,UAAU,IAAI,KAAK,CAAC,IAAI,EAAE,CAAA;YAC5C,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,8CAA8C;IAC9C,MAAM,CAAC,CAAS;QACd,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;QAClB,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,oDAAoD;IACpD,KAAK,CAAC,KAAa,EAAE,OAA8B;QACjD,MAAM,CAAC,GAAG,OAAO,YAAY,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAA;QACpE,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,IAAI,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC/B,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YAC3B,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAQD,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,CACL,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,QAAQ,IAAI,KAAK;QACjB,OAAO,KAAK,CAAC,MAAM,KAAK,UAAU,CACnC,CAAA;AACH,CAAC;AAED,+DAA+D;AAE/D,uEAAuE;AACvE,MAAM,OAAO,cAAc;IACzB,OAAO,CAAQ;IACf,KAAK,CAAQ;IAEb,YAAY,MAAc,EAAE,IAAY;QACtC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;QACrB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;IACnB,CAAC;IAED,qDAAqD;IACrD,MAAM,CAAC,IAAY,EAAE,IAA8B;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAChD,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YACjC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAA;YACzF,CAAC;YACD,MAAM,UAAU,GAAG,GAAG,CAAA;YACtB,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;YAChD,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC1D,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,0BAA0B;IAC1B,QAAQ,CAAC,MAAc,EAAE,MAAM,GAAG,GAAG;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAChD,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QACvD,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,iCAAiC;IACjC,eAAe,CAAC,IAAY,EAAE,MAA+B,EAAE,MAAM,GAAG,GAAG;QACzE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAChD,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QAC9D,CAAC,CAAC,CAAA;IACJ,CAAC;CACF;AAED,+DAA+D;AAE/D,mBAAmB;AACnB,MAAM,OAAO,MAAM;IACjB,OAAO,GAAsB,EAAE,CAAA;IAC/B,eAAe,GAAiC,EAAE,CAAA;IAClD,iBAAiB,GAAyB,EAAE,CAAA;IAC5C,gBAAgB,GAAoC,IAAI,GAAG,EAAE,CAAA;IAE7D,kEAAkE;IAClE,YAAY,GAAiC,IAAI,GAAG,EAAE,CAAA;IACtD,kDAAkD;IAClD,WAAW,GAAmC,IAAI,GAAG,EAAE,CAAA;IACvD,mDAAmD;IACnD,UAAU,GAAiC,IAAI,GAAG,EAAE,CAAA;IACpD,0CAA0C;IAC1C,WAAW,GAAG,IAAI,CAAA;IAElB,iCAAiC;IACxB,QAAQ,GAAG,QAAQ,CAAA;IAE5B,6DAA6D;IAE7D;;;OAGG;IACH,GAAG,CAAC,UAA6B;QAC/B,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;YAC5B,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC,CAAA;QACzD,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAA2C;QAC/C,MAAM,QAAQ,GAAuC,EAAE,CAAA;QACvD,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACpD,MAAM,EAAE,GAAG,sBAAsB,CAAC,EAAE,CAAC,CAAA;YACrC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;YACnC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAA;QACrB,CAAC;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,6CAA6C;IAC7C,mBAAmB;QACjB,OAAO,CAAC,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAAA;IACpC,CAAC;IAED,sCAAsC;IACtC,kBAAkB,CAAC,IAAY;QAC7B,OAAO,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACxC,CAAC;IAED,6DAA6D;IAE7D,6CAA6C;IAC7C,KAAK,CAAC,MAAc,EAAE,IAAY,EAAE,OAAqB;QACvD,MAAM,GAAG,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;QACzD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACtB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;QACvB,OAAO,IAAI,YAAY,CAAC,GAAG,CAAC,CAAA;IAC9B,CAAC;IAED,GAAG,CAAC,IAAY,EAAE,OAAqB;QACrC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;IACzC,CAAC;IAED,IAAI,CAAC,IAAY,EAAE,OAAqB;QACtC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;IAC1C,CAAC;IAED,GAAG,CAAC,IAAY,EAAE,OAAqB;QACrC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;IACzC,CAAC;IAED,KAAK,CAAC,IAAY,EAAE,OAAqB;QACvC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;IAC3C,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,OAAqB;QACxC,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;IAC5C,CAAC;IAED,IAAI,CAAC,IAAY,EAAE,OAAqB;QACtC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;IAC1C,CAAC;IAED,OAAO,CAAC,IAAY,EAAE,OAAqB;QACzC,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;IAC7C,CAAC;IAED,6CAA6C;IAC7C,GAAG,CAAC,IAAY,EAAE,OAAqB;QACrC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;IACvC,CAAC;IAED,6DAA6D;IAE7D;;;;;;;;;;;OAWG;IACH,mEAAmE;IACnE,QAAQ,CAAC,IAAY,EAAE,UAAuC;QAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;QACzC,MAAM,MAAM,GAAsB,EAAE,CAAA;QAEpC,MAAM,OAAO,GAAkF;YAC7F,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE;YACnE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE;YACpE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE;YACrE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE;YACzE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE;YAC3E,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE;SAC/E,CAAA;QAED,KAAK,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,OAAO,EAAE,CAAC;YAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,IAAI,IAAI,GAAG,MAAM,EAAE,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAA;YACrF,GAAG,CAAC,IAAI,GAAG,GAAG,QAAQ,IAAI,UAAU,EAAE,CAAA;YACtC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAChB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACxB,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;QAEvB,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAA;IACjC,CAAC;IA4BD,KAAK,CACH,gBAQK,EACL,cAAyC;QAEzC,IAAI,OAAO,gBAAgB,KAAK,UAAU,EAAE,CAAC;YAC3C,6DAA6D;YAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAA;YACpC,gBAAgB,EAAE,CAAA;YAClB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;YAC9C,OAAO,IAAI,YAAY,CAAC,SAAS,CAAC,CAAA;QACpC,CAAC;QAED,0DAA0D;QAC1D,MAAM,MAAM,GAAG,gBAAgB,CAAA;QAC/B,MAAM,WAAW,GAAG,IAAI,MAAM,EAAE,CAAA;QAChC,cAAc,EAAE,CAAC,WAAW,CAAC,CAAA;QAE7B,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;YACxC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;gBAChB,GAAG,KAAK;gBACR,IAAI,EAAE,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI;gBACxC,UAAU,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC;gBAC/D,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC;gBACnD,KAAK,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC;gBAChD,WAAW,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,WAAW,CAAC;aACnE,CAAC,CAAA;QACJ,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;IACzB,CAAC;IAED,6DAA6D;IAE7D,6CAA6C;IAC7C,EAAE,CAAC,IAAY;QACb,OAAO,IAAI,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACvC,CAAC;IAED,6DAA6D;IAE7D,0DAA0D;IAC1D,KAAK,CAAC,KAAa,EAAE,OAA8B;QACjD,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,GAAG,OAAO,YAAY,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAA;QACxF,OAAO,IAAI,CAAA;IACb,CAAC;IAED,6DAA6D;IAE7D,2EAA2E;IAC3E,WAAW;QACT,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAA;QACzB,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAA;QACxB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAA;QAEvB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,oBAAoB;YACpB,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBACf,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;YACxC,CAAC;YAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;YAEpE,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC9B,kCAAkC;gBAClC,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAA;gBACtF,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YACnC,CAAC;iBAAM,CAAC;gBACN,uCAAuC;gBACvC,MAAM,OAAO,GACX,KAAK,CAAC,MAAM,KAAK,GAAG;oBAClB,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC;oBAC9D,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;gBACpB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;oBACxB,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;wBAAE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;oBACzD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;gBACtC,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,KAAK,CAAA;IAC1B,CAAC;IAED,+EAA+E;IAC/E,KAAK,CAAC,MAAc,EAAE,IAAY,EAAE,IAAa;QAC/C,IAAI,IAAI,CAAC,WAAW;YAAE,IAAI,CAAC,WAAW,EAAE,CAAA;QAExC,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,CAAA;QACzB,yEAAyE;QACzE,sEAAsE;QACtE,6DAA6D;QAC7D,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1C,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;QACpC,CAAC;QAED,KAAK,MAAM,aAAa,IAAI,UAAU,EAAE,CAAC;YACvC,mCAAmC;YACnC,MAAM,WAAW,GACf,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,aAAa,EAAE,CAAC;gBACnD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,aAAa,EAAE,CAAC,CAAA;YAC7C,IAAI,WAAW,EAAE,CAAC;gBAChB,IAAI,CAAC,WAAW,CAAC,MAAM,IAAI,CAAC,IAAI,IAAI,WAAW,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;oBAC1E,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;gBAC3C,CAAC;YACH,CAAC;YAED,yDAAyD;YACzD,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;YAC1D,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;gBACpC,IAAI,KAAK,CAAC,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC;oBAAE,SAAQ;gBAEtE,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,CAAA;gBACnD,IAAI,MAAM,KAAK,IAAI;oBAAE,SAAQ;gBAE7B,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC;oBAAE,SAAQ;gBAC7D,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC;oBAAE,SAAQ;gBAEnE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;YAC1B,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,6DAA6D;IAE7D,yCAAyC;IACzC,OAAO,CAAC,IAAY,EAAE,MAA+B;QACnD,IAAI,IAAI,CAAC,WAAW;YAAE,IAAI,CAAC,WAAW,EAAE,CAAA;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACvC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,UAAU,IAAI,2BAA2B,IAAI,CAAC,OAAO;iBAClD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;iBACrB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;iBAClB,IAAI,CAAC,IAAI,CAAC,EAAE,CAChB,CAAA;QACH,CAAC;QACD,IAAI,GAAG,GAAG,KAAK,CAAC,IAAI,CAAA;QACpB,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClD,GAAG,GAAG,GAAG;qBACN,OAAO,CAAC,IAAI,GAAG,GAAG,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC;qBAC9C,OAAO,CAAC,IAAI,GAAG,EAAE,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAA;YAClD,CAAC;QACH,CAAC;QACD,0EAA0E;QAC1E,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAA;QAC7C,yEAAyE;QACzE,8DAA8D;QAC9D,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAA;QAC7C,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CACb,kCAAkC,IAAI,qBAAqB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAChF,CAAA;QACH,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,6DAA6D;IAE7D,yEAAyE;IACzE,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAA;IAC1B,CAAC;IAED,wDAAwD;IACxD,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,EAAE,CAAA;QACjB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;IACzB,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAA;IAC5B,CAAC;IAED,6DAA6D;IAE7D,iBAAiB,CAAC,MAAc,EAAE,IAAY,EAAE,OAAqB;QACnE,MAAM,GAAG,GAAoB;YAC3B,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE;YAC5B,IAAI;YACJ,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,EAAE;YACd,gBAAgB,EAAE,EAAE;YACpB,MAAM,EAAE,EAAE;YACV,KAAK,EAAE,EAAE;YACT,WAAW,EAAE,EAAE;YACf,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;SACb,CAAA;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,GAAG,CAAC,UAAU,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAA;QAC7D,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,OAAO,GAAG,OAAO,CAAA;QACvB,CAAC;QAED,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,iBAAiB,CACf,MAA8B,EAC9B,UAAwC;QAExC,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACpD,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;YACjC,IAAI,CAAC,OAAO;gBAAE,SAAQ;YACtB,MAAM,KAAK,GAAG,OAAO,YAAY,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAA;YACnE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAA;QACtC,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAED,+DAA+D;AAE/D,2FAA2F;AAC3F,SAAS,SAAS,CAAC,OAAe,EAAE,MAAc;IAChD,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACvC,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAErC,yEAAyE;IACzE,sEAAsE;IACtE,sCAAsC;IACtC,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAC7C,IAAI,WAAW,KAAK,CAAC,CAAC,EAAE,CAAC;QACvB,IAAI,WAAW,KAAK,YAAY,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAA;QACxD,IAAI,WAAW,CAAC,MAAM,GAAG,WAAW,GAAG,CAAC;YAAE,OAAO,IAAI,CAAA;QACrD,MAAM,MAAM,GAA2B,EAAE,CAAA;QACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,CAAC,CAAA;YAC5B,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAA;YAC5C,CAAC;iBAAM,IAAI,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnC,OAAO,IAAI,CAAA;YACb,CAAC;QACH,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACtD,OAAO,MAAM,CAAA;IACf,CAAC;IAED,8CAA8C;IAC9C,MAAM,aAAa,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAA;IACzE,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAA;IAEpC,IAAI,WAAW,CAAC,MAAM,GAAG,aAAa,IAAI,WAAW,CAAC,MAAM,GAAG,QAAQ;QAAE,OAAO,IAAI,CAAA;IAEpF,MAAM,MAAM,GAA2B,EAAE,CAAA;IAEzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,CAAC,CAAA;QAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;QAErC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;YACpE,IAAI,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC;gBAC3B,MAAM,CAAC,SAAS,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAA;YACpC,CAAC;YACD,4DAA4D;QAC9D,CAAC;aAAM,IAAI,CAAC,GAAG,WAAW,CAAC,MAAM,IAAI,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,OAAO,IAAI,CAAA;QACb,CAAC;aAAM,IAAI,CAAC,IAAI,WAAW,CAAC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;YAClD,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED,sFAAsF;AACtF,SAAS,WAAW,CAAC,OAAe,EAAE,IAAY;IAChD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA,CAAC,aAAa;IACnD,IAAI,OAAO,KAAK,UAAU;QAAE,OAAO,IAAI,CAAA;IACvC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA,CAAC,iBAAiB;QACjD,OAAO,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAA;IACzE,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/rpc/RpcProvider.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `RpcProvider` — wires a JSON-RPC 2.0 endpoint into the Ream pipeline.
+ *
+ *   - `register()` — bind a shared `RpcRouter` (with the IoC container, so
+ *     `namespace()` controllers are DI-resolved) under the token `'rpc'`. Apps
+ *     register methods by resolving it:
+ *
+ *       const rpc = app.container.make<RpcRouter>('rpc')
+ *       rpc.method('task.validate', handler).guard('jwt')
+ *       rpc.namespace('user', UserController)
+ *
+ *   - `boot()` — mount `POST <config.rpc.path ?? '/rpc'>` on the core router,
+ *     dispatching every request body (single or batch) to `RpcRouter.handle()`.
+ *
+ * @implements Story 24.1, 24.2
+ */
+import type { AppContext } from '../Provider.js';
+import { Provider } from '../Provider.js';
+import { RpcRouter } from './RpcRouter.js';
+export interface RpcProviderOptions {
+    /** Override the `RpcRouter` instance — used by tests. */
+    router?: RpcRouter;
+}
+export interface RpcConfig {
+    /** HTTP path the JSON-RPC endpoint is mounted at. Default `/rpc`. */
+    path?: string;
+}
+export declare class RpcProvider extends Provider {
+    readonly rpc: RpcRouter;
+    constructor(app: AppContext, options?: RpcProviderOptions);
+    register(): void;
+    boot(): Promise<void>;
+}
+//# sourceMappingURL=RpcProvider.d.ts.map

package/dist/rpc/RpcProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RpcProvider.d.ts","sourceRoot":"","sources":["../../src/rpc/RpcProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,MAAM,CAAC,EAAE,SAAS,CAAA;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,qBAAa,WAAY,SAAQ,QAAQ;IACvC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAA;gBAEX,GAAG,EAAE,UAAU,EAAE,OAAO,GAAE,kBAAuB;IAKpD,QAAQ,IAAI,IAAI;IAKV,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAOrC"}

package/dist/rpc/RpcProvider.js

@@ -0,0 +1,37 @@
+/**
+ * `RpcProvider` — wires a JSON-RPC 2.0 endpoint into the Ream pipeline.
+ *
+ *   - `register()` — bind a shared `RpcRouter` (with the IoC container, so
+ *     `namespace()` controllers are DI-resolved) under the token `'rpc'`. Apps
+ *     register methods by resolving it:
+ *
+ *       const rpc = app.container.make<RpcRouter>('rpc')
+ *       rpc.method('task.validate', handler).guard('jwt')
+ *       rpc.namespace('user', UserController)
+ *
+ *   - `boot()` — mount `POST <config.rpc.path ?? '/rpc'>` on the core router,
+ *     dispatching every request body (single or batch) to `RpcRouter.handle()`.
+ *
+ * @implements Story 24.1, 24.2
+ */
+import { Provider } from '../Provider.js';
+import { RpcRouter } from './RpcRouter.js';
+export class RpcProvider extends Provider {
+    rpc;
+    constructor(app, options = {}) {
+        super(app);
+        this.rpc = options.router ?? new RpcRouter();
+    }
+    register() {
+        this.rpc.useContainer(this.app.container);
+        this.app.container.singleton('rpc', () => this.rpc);
+    }
+    async boot() {
+        const path = this.app.config.get('rpc')?.path ?? '/rpc';
+        const router = this.app.container.make('router');
+        // RpcRouter.handle() reads the registered methods at request time, so the
+        // mount can happen before apps finish registering methods.
+        router.post(path, (ctx) => this.rpc.handle(ctx));
+    }
+}
+//# sourceMappingURL=RpcProvider.js.map

package/dist/rpc/RpcProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RpcProvider.js","sourceRoot":"","sources":["../../src/rpc/RpcProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAY1C,MAAM,OAAO,WAAY,SAAQ,QAAQ;IAC9B,GAAG,CAAW;IAEvB,YAAY,GAAe,EAAE,UAA8B,EAAE;QAC3D,KAAK,CAAC,GAAG,CAAC,CAAA;QACV,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,SAAS,EAAE,CAAA;IAC9C,CAAC;IAEQ,QAAQ;QACf,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QACzC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACrD,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAY,KAAK,CAAC,EAAE,IAAI,IAAI,MAAM,CAAA;QAClE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAS,QAAQ,CAAC,CAAA;QACxD,0EAA0E;QAC1E,2DAA2D;QAC3D,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,GAAgB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;IAC/D,CAAC;CACF"}