@soulcraft/sdk 2.2.0 → 2.4.0

package/dist/server/instance-pool.js

@@ -55,6 +55,34 @@
  * const brain = await pool.forUser(session.user.emailHash, workspaceId)
  * const results = await brain.find({ query: 'inventory items' })
  * ```
+ *
+ * @example Singleton pattern — single fixed instance with pool benefits
+ *
+ * For a "platform brain" or other single-instance use case that still needs
+ * mutex deduplication, Cortex loading, and proper `close()` on shutdown,
+ * use `per-scope` with `maxInstances: 1` and a fixed scope key:
+ *
+ * ```typescript
+ * import { BrainyInstancePool } from '@soulcraft/sdk/server'
+ *
+ * // One pool for the single platform-wide brain
+ * const platformPool = new BrainyInstancePool({
+ *   storage: 'mmap-filesystem',
+ *   dataPath: '/mnt/brainy-data/platform',
+ *   strategy: 'per-scope',
+ *   maxInstances: 1,
+ * })
+ *
+ * // Always use the same fixed key — the pool handles init-once and dedup
+ * const brain = await platformPool.forScope('platform', async (dataPath) => {
+ *   const brain = await Brainy.create({ storage: 'mmap-filesystem', dataPath })
+ *   // Run any one-time setup (migrations, seed data, etc.)
+ *   return brain
+ * })
+ *
+ * // Shutdown flushes and closes the single instance
+ * await platformPool.shutdown()
+ * ```
  */
 import { createHash } from 'crypto';
 import fs from 'fs/promises';

package/dist/server/instance-pool.js.map

@@ -1 +1 @@
-{"version":3,"file":"instance-pool.js","sourceRoot":"","sources":["../../src/server/instance-pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACnC,OAAO,EAAE,MAAM,aAAa,CAAA;AAC5B,OAAO,IAAI,MAAM,MAAM,CAAA;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAyF1C,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,OAAO,kBAAkB;IACZ,MAAM,CAA8B;IACpC,KAAK,CAA0B;IAChD,oEAAoE;IACnD,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAA;IAE7D;;OAEG;IACH,YAAY,MAA0B;QACpC,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAA;QAE9D,IAAI,CAAC,MAAM,GAAG;YACZ,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,CAAC,GAAG,MAAM,IAAI,WAAW,EAAE,CAAC;YAClF,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,UAAU;YAC/C,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC;SAC1C,CAAA;QAED,IAAI,CAAC,KAAK,GAAG,IAAI,QAAQ,CAAiB;YACxC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY;YAC7B,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;gBAChC,4EAA4E;gBAC5E,4EAA4E;gBAC5E,KAAK,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;oBAC1B,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,GAAG,CAAC,CAAA;gBACzD,CAAC,CAAC,CAAA;YACJ,CAAC;SACF,CAAC,CAAA;IACJ,CAAC;IAED,8EAA8E;IAE9E;;;;;;;;;;OAUG;IACH,KAAK,CAAC,OAAO,CAAC,MAAc,EAAE,WAAmB;QAC/C,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,wDAAwD,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAA;QAClG,CAAC;QACD,MAAM,GAAG,GAAG,GAAG,MAAM,IAAI,WAAW,EAAE,CAAA;QACtC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAA;QACxE,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,WAAW,CAAC,CAAA;IAC5C,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,SAAS,CAAC,UAAkB;QAChC,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,0DAA0D,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAA;QACpG,CAAC;QACD,MAAM,GAAG,GAAG,UAAU,CAAA;QACtB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;QAC/D,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,WAAW,CAAC,CAAA;IAC5C,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,QAAQ,CAAC,GAAW,EAAE,OAA8B;QACxD,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,yDAAyD,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAA;QACnG,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAClC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAA;QAEzB,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAE,CAAA;QAC/B,CAAC;QAED,MAAM,WAAW,GAAG,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;YAC3C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YAC1B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACxB,OAAO,KAAK,CAAA;QACd,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACf,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACxB,MAAM,GAAG,CAAA;QACX,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CAAA;QAClC,OAAO,WAAW,CAAA;IACpB,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACjC,IAAI,CAAC,KAAK;YAAE,OAAM;QAClB,uEAAuE;QACvE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACtB,MAAM,KAAK,CAAC,KAAK,EAAE,CAAA;IACrB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,MAAM,GAAoB,EAAE,CAAA;QAClC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAChD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACtB,MAAM,CAAC,IAAI,CACT,KAAK,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC1B,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAA;YAClD,CAAC,CAAC,CACH,CAAA;QACH,CAAC;QACD,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAC3B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAA;QACrB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;YACrB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY;YACjC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC7B,CAAA;IACH,CAAC;IAED,8EAA8E;IAE9E;;;;;;;;;OASG;IACK,YAAY,CAAC,GAAW,EAAE,WAAmB;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAClC,IAAI,MAAM;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAE1C,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAE,CAAA;QAC/B,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;YAC/D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YAC1B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACxB,OAAO,KAAK,CAAA;QACd,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACf,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACxB,MAAM,GAAG,CAAA;QACX,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CAAA;QAClC,OAAO,WAAW,CAAA;IACpB,CAAC;IAED;;;;;;;;;OASG;IACK,KAAK,CAAC,WAAW,CAAC,WAAmB;QAC3C,MAAM,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAEhD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAC5B,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC;YACvB,OAAO,EAAE;gBACP,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,EAAE,aAAa,EAAE,WAAW,EAAE;aACxC;YACD,OAAO,EACL,IAAI,CAAC,MAAM,CAAC,OAAO,KAAK,iBAAiB;gBACvC,CAAC,CAAC,CAAC,mBAAmB,CAAC;gBACvB,CAAC,CAAC,EAAE;SACT,CAAC,CAAA;QAEF,MAAM,KAAK,CAAC,IAAI,EAAE,CAAA;QAElB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACvB,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;QAC9C,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;QACtC,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,OAAO,QAAQ,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,CAAC,CAAA;QAE7G,OAAO,KAAK,CAAA;IACd,CAAC;CACF;AAED,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAC9E,CAAC"}
+{"version":3,"file":"instance-pool.js","sourceRoot":"","sources":["../../src/server/instance-pool.ts"],"names":[],"mappings":"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"}

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

@@ -155,6 +155,7 @@ export interface NamespaceRouterConfig {
 export type DispatchResult = {
     type: 'response';
     response: SoulcraftRPCResponse;
+    headers?: Record<string, string>;
 } | {
     type: 'stream';
     id: string;

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

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

package/dist/server/rpc-cache.d.ts

@@ -0,0 +1,181 @@
+/**
+ * @module server/rpc-cache
+ * @description Application-level RPC response cache for the Soulcraft namespace router.
+ *
+ * Wraps an existing {@link NamespaceRouter} with transparent caching that:
+ * - Avoids auth + dispatch + JSON serialization overhead at high QPS
+ * - Deduplicates concurrent identical requests via singleflight
+ * - Attaches `Cache-Control`, `ETag`, and `X-Cache` headers for CDN/browser participation
+ *
+ * The cache operates at the scope level (tenant, published-app, etc.). All entries for a
+ * scope are flushed when any write method executes in that scope — slightly aggressive but
+ * simple and correct for the expected cache sizes (<2000 entries per LRU).
+ *
+ * Off by default. Products opt in by passing `cache` config to `createSoulcraftRouter()`.
+ *
+ * @example Venue — per-tenant caching for anonymous visitors
+ * ```typescript
+ * const sdkRouter = createSoulcraftRouter({
+ *   resolveBrain: (ctx) => pool.forTenant(ctx.workspaceId),
+ *   authenticate: (ctx) => verifySession(ctx.request),
+ *   providers: { graph: graphHandler, search: searchHandler },
+ *   cache: {
+ *     scopeKey: (ctx) => ctx.workspaceId || null,
+ *   },
+ * })
+ * ```
+ */
+import type { NamespaceRouter, RequestContext } from './namespace-router.js';
+/**
+ * Pluggable cache storage abstraction.
+ *
+ * Ships with {@link LruCacheProvider} for single-process deployments.
+ * Implement this interface for Redis, Memcached, or other shared stores.
+ */
+export interface CacheProvider {
+    /** Retrieve a cached entry by key. Returns `undefined` on miss. */
+    get(key: string): CacheEntry | undefined;
+    /** Store an entry. */
+    set(key: string, entry: CacheEntry): void;
+    /** Invalidate all entries whose key starts with the given scope prefix. */
+    invalidateScope(scopePrefix: string): void;
+    /** Delete a single entry. */
+    delete(key: string): void;
+    /** Number of entries currently stored. */
+    size(): number;
+}
+/**
+ * A cached RPC response with its ETag and expiration timestamp.
+ */
+export interface CacheEntry {
+    /** JSON-serialized response body. */
+    body: string;
+    /** Quoted ETag value (truncated SHA-256 of body). */
+    etag: string;
+    /** Unix timestamp (ms) when this entry expires. */
+    expiresAt: number;
+}
+/**
+ * Product-facing cache configuration passed to `createSoulcraftRouter()`.
+ */
+export interface RpcCacheConfig {
+    /**
+     * Extracts the cache scope key from a request context.
+     *
+     * Return `null` to skip caching for this request entirely (e.g. workspace
+     * editing in Workshop should not be cached).
+     *
+     * @param ctx - The request context with user and workspace info.
+     * @returns A scope key string, or `null` to bypass the cache.
+     */
+    scopeKey: (ctx: RequestContext) => string | null;
+    /**
+     * Map of `namespace.method` → TTL in seconds for cacheable methods.
+     *
+     * @default DEFAULT_CACHEABLE_METHODS
+     */
+    methods?: Record<string, number>;
+    /**
+     * Enable singleflight deduplication of concurrent identical requests.
+     *
+     * @default true
+     */
+    singleflight?: boolean;
+    /**
+     * Optional metrics callback fired on cache events.
+     */
+    onMetrics?: (event: CacheMetricsEvent) => void;
+    /**
+     * Custom cache provider. Defaults to {@link LruCacheProvider} with 2000 entries.
+     */
+    provider?: CacheProvider;
+}
+/**
+ * Metrics event emitted by the cache layer.
+ */
+export interface CacheMetricsEvent {
+    /** Event type. */
+    type: 'hit' | 'miss' | 'singleflight' | 'invalidate';
+    /** The scope key for this request. */
+    scope: string;
+    /** The target namespace. */
+    ns: string;
+    /** The method name. */
+    method: string;
+}
+/**
+ * Default method→TTL map for cacheable read methods.
+ *
+ * Products can override this entirely via `RpcCacheConfig.methods`, or use
+ * these defaults which cover the most common high-QPS read patterns.
+ */
+export declare const DEFAULT_CACHEABLE_METHODS: Record<string, number>;
+/**
+ * In-process LRU cache provider backed by `lru-cache`.
+ *
+ * Suitable for single-process deployments. For multi-server deployments,
+ * implement {@link CacheProvider} with a shared store (Redis, etc.).
+ *
+ * @example
+ * ```typescript
+ * const provider = new LruCacheProvider({ maxEntries: 5000 })
+ * ```
+ */
+export declare class LruCacheProvider implements CacheProvider {
+    private readonly _lru;
+    /**
+     * @param options - Provider options.
+     * @param options.maxEntries - Maximum number of cached entries. Defaults to 2000.
+     */
+    constructor(options?: {
+        maxEntries?: number;
+    });
+    /**
+     * @param key - Cache key.
+     * @returns The cached entry, or `undefined` on miss.
+     */
+    get(key: string): CacheEntry | undefined;
+    /**
+     * @param key - Cache key.
+     * @param entry - The entry to store.
+     */
+    set(key: string, entry: CacheEntry): void;
+    /**
+     * Invalidate all entries whose key starts with the given scope prefix.
+     *
+     * Iterates all keys in the LRU — acceptable for cache sizes ≤ 2000.
+     *
+     * @param scopePrefix - The scope prefix to match (e.g. `"tenant-123:"`).
+     */
+    invalidateScope(scopePrefix: string): void;
+    /**
+     * @param key - Cache key to delete.
+     */
+    delete(key: string): void;
+    /**
+     * @returns The number of entries currently in the cache.
+     */
+    size(): number;
+}
+/**
+ * Wraps a {@link NamespaceRouter} with transparent response caching.
+ *
+ * The returned router has the same `dispatch()` signature as the inner router.
+ * Cacheable read methods are served from cache when fresh; write methods flush
+ * all cached entries for the current scope.
+ *
+ * @param innerRouter - The namespace router to wrap.
+ * @param config - Cache configuration.
+ * @returns A new {@link NamespaceRouter} with caching applied.
+ *
+ * @example
+ * ```typescript
+ * const router = createNamespaceRouter(routerConfig)
+ * const cachedRouter = createCachedDispatch(router, {
+ *   scopeKey: (ctx) => ctx.workspaceId || null,
+ * })
+ * const result = await cachedRouter.dispatch(rpc, request)
+ * ```
+ */
+export declare function createCachedDispatch(innerRouter: NamespaceRouter, config: RpcCacheConfig): NamespaceRouter;
+//# sourceMappingURL=rpc-cache.d.ts.map

package/dist/server/rpc-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-cache.d.ts","sourceRoot":"","sources":["../../src/server/rpc-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAKH,OAAO,KAAK,EACV,eAAe,EAEf,cAAc,EAEf,MAAM,uBAAuB,CAAA;AAM9B;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAA;IACxC,sBAAsB;IACtB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;IACzC,2EAA2E;IAC3E,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1C,6BAA6B;IAC7B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,0CAA0C;IAC1C,IAAI,IAAI,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAA;IACZ,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;OAQG;IACH,QAAQ,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,MAAM,GAAG,IAAI,CAAA;IAEhD;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAEhC;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IAEtB;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAA;IAE9C;;OAEG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kBAAkB;IAClB,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,cAAc,GAAG,YAAY,CAAA;IACpD,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,4BAA4B;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAA;CACf;AAMD;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAiC5D,CAAA;AAmCD;;;;;;;;;;GAUG;AACH,qBAAa,gBAAiB,YAAW,aAAa;IACpD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA8B;IAEnD;;;OAGG;gBACS,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAM7C;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIxC;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAIzC;;;;;;OAMG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAQ1C;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB;;OAEG;IACH,IAAI,IAAI,MAAM;CAGf;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,eAAe,EAC5B,MAAM,EAAE,cAAc,GACrB,eAAe,CA+HjB"}

package/dist/server/rpc-cache.js

@@ -0,0 +1,314 @@
+/**
+ * @module server/rpc-cache
+ * @description Application-level RPC response cache for the Soulcraft namespace router.
+ *
+ * Wraps an existing {@link NamespaceRouter} with transparent caching that:
+ * - Avoids auth + dispatch + JSON serialization overhead at high QPS
+ * - Deduplicates concurrent identical requests via singleflight
+ * - Attaches `Cache-Control`, `ETag`, and `X-Cache` headers for CDN/browser participation
+ *
+ * The cache operates at the scope level (tenant, published-app, etc.). All entries for a
+ * scope are flushed when any write method executes in that scope — slightly aggressive but
+ * simple and correct for the expected cache sizes (<2000 entries per LRU).
+ *
+ * Off by default. Products opt in by passing `cache` config to `createSoulcraftRouter()`.
+ *
+ * @example Venue — per-tenant caching for anonymous visitors
+ * ```typescript
+ * const sdkRouter = createSoulcraftRouter({
+ *   resolveBrain: (ctx) => pool.forTenant(ctx.workspaceId),
+ *   authenticate: (ctx) => verifySession(ctx.request),
+ *   providers: { graph: graphHandler, search: searchHandler },
+ *   cache: {
+ *     scopeKey: (ctx) => ctx.workspaceId || null,
+ *   },
+ * })
+ * ```
+ */
+import { createHash } from 'crypto';
+import { LRUCache } from 'lru-cache';
+// ─────────────────────────────────────────────────────────────────────────────
+// Default cacheable methods — namespace.method → TTL in seconds
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Default method→TTL map for cacheable read methods.
+ *
+ * Products can override this entirely via `RpcCacheConfig.methods`, or use
+ * these defaults which cover the most common high-QPS read patterns.
+ */
+export const DEFAULT_CACHEABLE_METHODS = {
+    // Brainy entity reads
+    'brainy.find': 10,
+    'brainy.get': 10,
+    'brainy.getRelations': 10,
+    // Graph namespace
+    'graph.getData': 30,
+    'graph.getFocused': 30,
+    'graph.getNeighbors': 30,
+    'graph.getStats': 60,
+    // Search namespace
+    'search.query': 10,
+    'search.unified': 10,
+    // Collections reads
+    'collections.list': 30,
+    'collections.get': 30,
+    'collections.getItems': 30,
+    // Config
+    'config.get': 300,
+    // VFS reads
+    'brainy.vfs.readFile': 10,
+    'brainy.vfs.readdir': 10,
+    'brainy.vfs.stat': 10,
+    'brainy.vfs.tree': 30,
+    // Workspace reads
+    'workspace.list': 30,
+    'workspace.get': 30,
+};
+/**
+ * Methods that invalidate all cached entries for the current scope.
+ *
+ * Any successful dispatch of these methods triggers a full scope flush.
+ */
+const SCOPE_INVALIDATING_METHODS = new Set([
+    'add',
+    'update',
+    'delete',
+    'relate',
+    'unrelate',
+    'writeFile',
+    'mkdir',
+    'rmdir',
+    'unlink',
+    'rename',
+    'clear',
+    'save',
+    'restore',
+    'import',
+    'create',
+    'remove',
+    'set',
+    'put',
+    'patch',
+    'move',
+    'copy',
+]);
+// ─────────────────────────────────────────────────────────────────────────────
+// LRU cache provider
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * In-process LRU cache provider backed by `lru-cache`.
+ *
+ * Suitable for single-process deployments. For multi-server deployments,
+ * implement {@link CacheProvider} with a shared store (Redis, etc.).
+ *
+ * @example
+ * ```typescript
+ * const provider = new LruCacheProvider({ maxEntries: 5000 })
+ * ```
+ */
+export class LruCacheProvider {
+    _lru;
+    /**
+     * @param options - Provider options.
+     * @param options.maxEntries - Maximum number of cached entries. Defaults to 2000.
+     */
+    constructor(options) {
+        this._lru = new LRUCache({
+            max: options?.maxEntries ?? 2000,
+        });
+    }
+    /**
+     * @param key - Cache key.
+     * @returns The cached entry, or `undefined` on miss.
+     */
+    get(key) {
+        return this._lru.get(key);
+    }
+    /**
+     * @param key - Cache key.
+     * @param entry - The entry to store.
+     */
+    set(key, entry) {
+        this._lru.set(key, entry);
+    }
+    /**
+     * Invalidate all entries whose key starts with the given scope prefix.
+     *
+     * Iterates all keys in the LRU — acceptable for cache sizes ≤ 2000.
+     *
+     * @param scopePrefix - The scope prefix to match (e.g. `"tenant-123:"`).
+     */
+    invalidateScope(scopePrefix) {
+        for (const key of this._lru.keys()) {
+            if (key.startsWith(scopePrefix)) {
+                this._lru.delete(key);
+            }
+        }
+    }
+    /**
+     * @param key - Cache key to delete.
+     */
+    delete(key) {
+        this._lru.delete(key);
+    }
+    /**
+     * @returns The number of entries currently in the cache.
+     */
+    size() {
+        return this._lru.size;
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Core: createCachedDispatch
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Wraps a {@link NamespaceRouter} with transparent response caching.
+ *
+ * The returned router has the same `dispatch()` signature as the inner router.
+ * Cacheable read methods are served from cache when fresh; write methods flush
+ * all cached entries for the current scope.
+ *
+ * @param innerRouter - The namespace router to wrap.
+ * @param config - Cache configuration.
+ * @returns A new {@link NamespaceRouter} with caching applied.
+ *
+ * @example
+ * ```typescript
+ * const router = createNamespaceRouter(routerConfig)
+ * const cachedRouter = createCachedDispatch(router, {
+ *   scopeKey: (ctx) => ctx.workspaceId || null,
+ * })
+ * const result = await cachedRouter.dispatch(rpc, request)
+ * ```
+ */
+export function createCachedDispatch(innerRouter, config) {
+    const provider = config.provider ?? new LruCacheProvider();
+    const methods = config.methods ?? DEFAULT_CACHEABLE_METHODS;
+    const enableSingleflight = config.singleflight ?? true;
+    const onMetrics = config.onMetrics;
+    /** In-flight singleflight promises, keyed by cache key. */
+    const inflight = new Map();
+    return {
+        async dispatch(rpc, requestOrCtx) {
+            // ── Resolve scope ────────────────────────────────────────────────
+            const ctx = _buildMinimalContext(requestOrCtx);
+            const scope = config.scopeKey(ctx);
+            // No scope → pass through entirely (caching disabled for this request).
+            if (scope === null) {
+                return innerRouter.dispatch(rpc, requestOrCtx);
+            }
+            const { ns, method } = rpc;
+            const methodKey = `${ns}.${method}`;
+            // ── Write methods → delegate then flush scope ────────────────────
+            if (SCOPE_INVALIDATING_METHODS.has(method)) {
+                const result = await innerRouter.dispatch(rpc, requestOrCtx);
+                // Only flush on successful writes.
+                if (result.type === 'response' && !result.response.error) {
+                    const scopePrefix = `${scope}:`;
+                    provider.invalidateScope(scopePrefix);
+                    onMetrics?.({ type: 'invalidate', scope, ns, method });
+                }
+                return result;
+            }
+            // ── Non-cacheable method → pass through ──────────────────────────
+            const ttlSeconds = methods[methodKey];
+            if (ttlSeconds === undefined) {
+                return innerRouter.dispatch(rpc, requestOrCtx);
+            }
+            // ── Streaming requests are never cached ──────────────────────────
+            if (rpc.stream) {
+                return innerRouter.dispatch(rpc, requestOrCtx);
+            }
+            // ── Build cache key ──────────────────────────────────────────────
+            const argsHash = createHash('sha256')
+                .update(JSON.stringify(rpc.args))
+                .digest('hex')
+                .slice(0, 16);
+            const cacheKey = `${scope}:${methodKey}:${argsHash}`;
+            // ── Check cache ──────────────────────────────────────────────────
+            const cached = provider.get(cacheKey);
+            if (cached && Date.now() < cached.expiresAt) {
+                onMetrics?.({ type: 'hit', scope, ns, method });
+                const response = JSON.parse(cached.body);
+                return {
+                    type: 'response',
+                    response,
+                    headers: {
+                        'Cache-Control': `public, max-age=${ttlSeconds}`,
+                        'ETag': cached.etag,
+                        'X-Cache': 'HIT',
+                    },
+                };
+            }
+            // ── Singleflight deduplication ───────────────────────────────────
+            if (enableSingleflight) {
+                const existing = inflight.get(cacheKey);
+                if (existing) {
+                    onMetrics?.({ type: 'singleflight', scope, ns, method });
+                    return existing;
+                }
+            }
+            // ── Miss: dispatch and cache ─────────────────────────────────────
+            onMetrics?.({ type: 'miss', scope, ns, method });
+            const promise = (async () => {
+                const result = await innerRouter.dispatch(rpc, requestOrCtx);
+                // Only cache successful non-streaming responses.
+                if (result.type === 'response' && !result.response.error) {
+                    const body = JSON.stringify(result.response);
+                    const etag = `"${createHash('sha256').update(body).digest('hex').slice(0, 32)}"`;
+                    const entry = {
+                        body,
+                        etag,
+                        expiresAt: Date.now() + ttlSeconds * 1000,
+                    };
+                    provider.set(cacheKey, entry);
+                    return {
+                        type: 'response',
+                        response: result.response,
+                        headers: {
+                            'Cache-Control': `public, max-age=${ttlSeconds}`,
+                            'ETag': etag,
+                            'X-Cache': 'MISS',
+                        },
+                    };
+                }
+                return result;
+            })();
+            if (enableSingleflight) {
+                inflight.set(cacheKey, promise);
+            }
+            try {
+                return await promise;
+            }
+            finally {
+                if (enableSingleflight) {
+                    inflight.delete(cacheKey);
+                }
+            }
+        },
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Internal helpers
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Builds a minimal {@link RequestContext} for scope key extraction.
+ *
+ * The scope key function only needs the request and workspace ID — it does
+ * not need the full authenticated context.
+ *
+ * @param requestOrCtx - Raw HTTP request or pre-authenticated context.
+ * @returns A minimal request context.
+ */
+function _buildMinimalContext(requestOrCtx) {
+    if (requestOrCtx instanceof Request) {
+        const workspaceId = requestOrCtx.headers.get('x-workspace-id') ?? '';
+        return { request: requestOrCtx, user: null, workspaceId };
+    }
+    return {
+        request: requestOrCtx.request,
+        user: requestOrCtx.user,
+        workspaceId: requestOrCtx.workspaceId,
+    };
+}
+//# sourceMappingURL=rpc-cache.js.map

package/dist/server/rpc-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-cache.js","sourceRoot":"","sources":["../../src/server/rpc-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAkGpC,gFAAgF;AAChF,gEAAgE;AAChE,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAA2B;IAC/D,sBAAsB;IACtB,aAAa,EAAE,EAAE;IACjB,YAAY,EAAE,EAAE;IAChB,qBAAqB,EAAE,EAAE;IAEzB,kBAAkB;IAClB,eAAe,EAAE,EAAE;IACnB,kBAAkB,EAAE,EAAE;IACtB,oBAAoB,EAAE,EAAE;IACxB,gBAAgB,EAAE,EAAE;IAEpB,mBAAmB;IACnB,cAAc,EAAE,EAAE;IAClB,gBAAgB,EAAE,EAAE;IAEpB,oBAAoB;IACpB,kBAAkB,EAAE,EAAE;IACtB,iBAAiB,EAAE,EAAE;IACrB,sBAAsB,EAAE,EAAE;IAE1B,SAAS;IACT,YAAY,EAAE,GAAG;IAEjB,YAAY;IACZ,qBAAqB,EAAE,EAAE;IACzB,oBAAoB,EAAE,EAAE;IACxB,iBAAiB,EAAE,EAAE;IACrB,iBAAiB,EAAE,EAAE;IAErB,kBAAkB;IAClB,gBAAgB,EAAE,EAAE;IACpB,eAAe,EAAE,EAAE;CACpB,CAAA;AAED;;;;GAIG;AACH,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAAC;IACzC,KAAK;IACL,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,WAAW;IACX,OAAO;IACP,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,MAAM;IACN,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,KAAK;IACL,KAAK;IACL,OAAO;IACP,MAAM;IACN,MAAM;CACP,CAAC,CAAA;AAEF,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF;;;;;;;;;;GAUG;AACH,MAAM,OAAO,gBAAgB;IACV,IAAI,CAA8B;IAEnD;;;OAGG;IACH,YAAY,OAAiC;QAC3C,IAAI,CAAC,IAAI,GAAG,IAAI,QAAQ,CAAqB;YAC3C,GAAG,EAAE,OAAO,EAAE,UAAU,IAAI,IAAI;SACjC,CAAC,CAAA;IACJ,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC3B,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,GAAW,EAAE,KAAiB;QAChC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IAC3B,CAAC;IAED;;;;;;OAMG;IACH,eAAe,CAAC,WAAmB;QACjC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACnC,IAAI,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;gBAChC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAW;QAChB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACvB,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAA;IACvB,CAAC;CACF;AAED,gFAAgF;AAChF,6BAA6B;AAC7B,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,oBAAoB,CAClC,WAA4B,EAC5B,MAAsB;IAEtB,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,IAAI,gBAAgB,EAAE,CAAA;IAC1D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,yBAAyB,CAAA;IAC3D,MAAM,kBAAkB,GAAG,MAAM,CAAC,YAAY,IAAI,IAAI,CAAA;IACtD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAA;IAElC,2DAA2D;IAC3D,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAmC,CAAA;IAE3D,OAAO;QACL,KAAK,CAAC,QAAQ,CACZ,GAAiB,EACjB,YAA+C;YAE/C,oEAAoE;YACpE,MAAM,GAAG,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAA;YAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;YAElC,wEAAwE;YACxE,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,OAAO,WAAW,CAAC,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC,CAAA;YAChD,CAAC;YAED,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,GAAG,CAAA;YAC1B,MAAM,SAAS,GAAG,GAAG,EAAE,IAAI,MAAM,EAAE,CAAA;YAEnC,oEAAoE;YACpE,IAAI,0BAA0B,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC,CAAA;gBAE5D,mCAAmC;gBACnC,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;oBACzD,MAAM,WAAW,GAAG,GAAG,KAAK,GAAG,CAAA;oBAC/B,QAAQ,CAAC,eAAe,CAAC,WAAW,CAAC,CAAA;oBACrC,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;gBACxD,CAAC;gBAED,OAAO,MAAM,CAAA;YACf,CAAC;YAED,oEAAoE;YACpE,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;YACrC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7B,OAAO,WAAW,CAAC,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC,CAAA;YAChD,CAAC;YAED,oEAAoE;YACpE,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;gBACf,OAAO,WAAW,CAAC,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC,CAAA;YAChD,CAAC;YAED,oEAAoE;YACpE,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;iBAClC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;iBAChC,MAAM,CAAC,KAAK,CAAC;iBACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;YACf,MAAM,QAAQ,GAAG,GAAG,KAAK,IAAI,SAAS,IAAI,QAAQ,EAAE,CAAA;YAEpD,oEAAoE;YACpE,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YACrC,IAAI,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;gBAC5C,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;gBAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;gBACxC,OAAO;oBACL,IAAI,EAAE,UAAU;oBAChB,QAAQ;oBACR,OAAO,EAAE;wBACP,eAAe,EAAE,mBAAmB,UAAU,EAAE;wBAChD,MAAM,EAAE,MAAM,CAAC,IAAI;wBACnB,SAAS,EAAE,KAAK;qBACjB;iBACgB,CAAA;YACrB,CAAC;YAED,oEAAoE;YACpE,IAAI,kBAAkB,EAAE,CAAC;gBACvB,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;gBACvC,IAAI,QAAQ,EAAE,CAAC;oBACb,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;oBACxD,OAAO,QAAQ,CAAA;gBACjB,CAAC;YACH,CAAC;YAED,oEAAoE;YACpE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;YAEhD,MAAM,OAAO,GAAG,CAAC,KAAK,IAA6B,EAAE;gBACnD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC,CAAA;gBAE5D,iDAAiD;gBACjD,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;oBACzD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;oBAC5C,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAA;oBAChF,MAAM,KAAK,GAAe;wBACxB,IAAI;wBACJ,IAAI;wBACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,GAAG,IAAI;qBAC1C,CAAA;oBACD,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;oBAE7B,OAAO;wBACL,IAAI,EAAE,UAAU;wBAChB,QAAQ,EAAE,MAAM,CAAC,QAAQ;wBACzB,OAAO,EAAE;4BACP,eAAe,EAAE,mBAAmB,UAAU,EAAE;4BAChD,MAAM,EAAE,IAAI;4BACZ,SAAS,EAAE,MAAM;yBAClB;qBACgB,CAAA;gBACrB,CAAC;gBAED,OAAO,MAAM,CAAA;YACf,CAAC,CAAC,EAAE,CAAA;YAEJ,IAAI,kBAAkB,EAAE,CAAC;gBACvB,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;YACjC,CAAC;YAED,IAAI,CAAC;gBACH,OAAO,MAAM,OAAO,CAAA;YACtB,CAAC;oBAAS,CAAC;gBACT,IAAI,kBAAkB,EAAE,CAAC;oBACvB,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;gBAC3B,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAED,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;;;;;;;GAQG;AACH,SAAS,oBAAoB,CAAC,YAA+C;IAC3E,IAAI,YAAY,YAAY,OAAO,EAAE,CAAC;QACpC,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAA;QACpE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,CAAA;IAC3D,CAAC;IACD,OAAO;QACL,OAAO,EAAE,YAAY,CAAC,OAAO;QAC7B,IAAI,EAAE,YAAY,CAAC,IAAI;QACvB,WAAW,EAAE,YAAY,CAAC,WAAW;KACtC,CAAA;AACH,CAAC"}