@logixjs/query 0.0.2 → 1.0.0

package/dist/Engine.cjs

@@ -64,7 +64,7 @@ var middleware = (config) => /* @__PURE__ */ (() => {
 })();
 
 // src/Engine.ts
-var EngineTagImpl = class extends import_effect2.Context.Tag("@logixjs/query/Engine")() {
+var EngineTagImpl = class extends import_effect2.ServiceMap.Service()("@logixjs/query/Engine") {
 };
 var Engine = Object.assign(EngineTagImpl, {
   layer: (engine) => import_effect2.Layer.succeed(EngineTagImpl, engine),

package/dist/Engine.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/Engine.ts","../src/internal/middleware/middleware.ts"],"sourcesContent":["import type * as EffectOp from '@logixjs/core/EffectOp'\nimport type { JsonValue } from '@logixjs/core/Observability'\nimport { Context, Effect, Layer, Option } from 'effect'\nimport { middleware as middlewareImpl, type MiddlewareConfig } from './internal/middleware/middleware.js'\n\nexport type InvalidateRequest =\n  | { readonly kind: 'byResource'; readonly resourceId: string }\n  | { readonly kind: 'byParams'; readonly resourceId: string; readonly keyHash: string }\n  | { readonly kind: 'byTag'; readonly tag: string }\n\nexport interface Engine {\n  readonly fetch: <A>(args: {\n    readonly resourceId: string\n    readonly keyHash: string\n    readonly effect: Effect.Effect<A, unknown, any>\n    /**\n     * MUST be serializable and slim; recommended default is undefined (lazy),\n     * and only populate it when diagnostics/devtools require it.\n     */\n    readonly meta?: JsonValue\n  }) => Effect.Effect<A, unknown, any>\n\n  /**\n   * perf: optional fast path to avoid allocations on the hot path.\n   * Semantics must match `fetch({ ... })`.\n   */\n  readonly fetchFast?: <A>(\n    resourceId: string,\n    keyHash: string,\n    effect: Effect.Effect<A, unknown, any>,\n    meta?: JsonValue,\n  ) => Effect.Effect<A, unknown, any>\n\n  readonly invalidate: (request: InvalidateRequest) => Effect.Effect<void, unknown, any>\n\n  /**\n   * Read-only fast path: must not trigger IO; used to short-circuit to success before refresh,\n   * avoiding loading jitter.\n   */\n  readonly peekFresh?: <A>(args: {\n    readonly resourceId: string\n    readonly keyHash: string\n  }) => Effect.Effect<Option.Option<A>, never, any>\n}\n\nclass EngineTagImpl extends Context.Tag('@logixjs/query/Engine')<EngineTagImpl, Engine>() {}\n\nexport const Engine = Object.assign(EngineTagImpl, {\n  layer: (engine: Engine): Layer.Layer<EngineTagImpl, never, never> => Layer.succeed(EngineTagImpl, engine),\n  middleware: (config?: MiddlewareConfig): EffectOp.Middleware => middlewareImpl(config),\n})\n\nexport type { MiddlewareConfig }\n","import type * as EffectOp from '@logixjs/core/EffectOp'\nimport { Effect, Option } from 'effect'\nimport { Engine } from '../../Engine.js'\nimport type { Engine as EngineService } from '../../Engine.js'\n\nexport interface MiddlewareConfig {\n  /**\n   * Default: only applies to EffectOp that carries resourceId+keyHash (from StateTrait.source).\n   * Optional: further filter by resourceId.\n   */\n  readonly useFor?: (resourceId: string) => boolean\n}\n\n/**\n * Query middleware (EffectOp): external engine takeover point.\n * - Delegates ResourceSpec.load execution to Engine (cache / in-flight dedupe / invalidation, etc.)\n * - Still preserves Logix Runtime's keyHash gating and ResourceSnapshot source-of-truth semantics\n */\nexport const middleware = (config?: MiddlewareConfig): EffectOp.Middleware =>\n  (() => {\n    // perf: within the same Runtime instance, Engine injection is stable.\n    // Cache it in the middleware closure to avoid a Context lookup on every fetch.\n    let cachedEngine: EngineService | undefined\n\n    return (op) => {\n      if ((op.kind !== 'service' && op.kind !== 'trait-source') || !op.meta?.resourceId || !op.meta.keyHash) {\n        return op.effect as any\n      }\n\n      const resourceId = op.meta.resourceId\n      if (config?.useFor && !config.useFor(resourceId)) {\n        return op.effect as any\n      }\n\n      const keyHash = op.meta.keyHash as string\n\n      if (cachedEngine) {\n        if (cachedEngine.fetchFast) {\n          return cachedEngine.fetchFast(resourceId, keyHash, op.effect as any)\n        }\n        return cachedEngine.fetch({ resourceId, keyHash, effect: op.effect as any })\n      }\n\n      return Effect.serviceOption(Engine).pipe(\n        Effect.flatMap((engineOpt) => {\n          if (Option.isNone(engineOpt)) {\n            return Effect.fail(\n              new Error(\n                `[Query.Engine.middleware] Missing Query.Engine in the Runtime scope; please provide Query.Engine.layer(Query.TanStack.engine(new QueryClient())) (recommended) or Query.Engine.layer(customEngine).`,\n              ),\n            )\n          }\n          cachedEngine = engineOpt.value\n          if (cachedEngine.fetchFast) {\n            return cachedEngine.fetchFast(resourceId, keyHash, op.effect as any)\n          }\n          return cachedEngine.fetch({ resourceId, keyHash, effect: op.effect as any })\n        }),\n      ) as any\n    }\n  })()\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,IAAAA,iBAA+C;;;ACD/C,oBAA+B;AAiBxB,IAAM,aAAa,CAAC,WACxB,uBAAM;AAGL,MAAI;AAEJ,SAAO,CAAC,OAAO;AACb,QAAK,GAAG,SAAS,aAAa,GAAG,SAAS,kBAAmB,CAAC,GAAG,MAAM,cAAc,CAAC,GAAG,KAAK,SAAS;AACrG,aAAO,GAAG;AAAA,IACZ;AAEA,UAAM,aAAa,GAAG,KAAK;AAC3B,QAAI,QAAQ,UAAU,CAAC,OAAO,OAAO,UAAU,GAAG;AAChD,aAAO,GAAG;AAAA,IACZ;AAEA,UAAM,UAAU,GAAG,KAAK;AAExB,QAAI,cAAc;AAChB,UAAI,aAAa,WAAW;AAC1B,eAAO,aAAa,UAAU,YAAY,SAAS,GAAG,MAAa;AAAA,MACrE;AACA,aAAO,aAAa,MAAM,EAAE,YAAY,SAAS,QAAQ,GAAG,OAAc,CAAC;AAAA,IAC7E;AAEA,WAAO,qBAAO,cAAc,MAAM,EAAE;AAAA,MAClC,qBAAO,QAAQ,CAAC,cAAc;AAC5B,YAAI,qBAAO,OAAO,SAAS,GAAG;AAC5B,iBAAO,qBAAO;AAAA,YACZ,IAAI;AAAA,cACF;AAAA,YACF;AAAA,UACF;AAAA,QACF;AACA,uBAAe,UAAU;AACzB,YAAI,aAAa,WAAW;AAC1B,iBAAO,aAAa,UAAU,YAAY,SAAS,GAAG,MAAa;AAAA,QACrE;AACA,eAAO,aAAa,MAAM,EAAE,YAAY,SAAS,QAAQ,GAAG,OAAc,CAAC;AAAA,MAC7E,CAAC;AAAA,IACH;AAAA,EACF;AACF,GAAG;;;ADfL,IAAM,gBAAN,cAA4B,uBAAQ,IAAI,uBAAuB,EAAyB,EAAE;AAAC;AAEpF,IAAM,SAAS,OAAO,OAAO,eAAe;AAAA,EACjD,OAAO,CAAC,WAA6D,qBAAM,QAAQ,eAAe,MAAM;AAAA,EACxG,YAAY,CAAC,WAAmD,WAAe,MAAM;AACvF,CAAC;","names":["import_effect"]}
+{"version":3,"sources":["../src/Engine.ts","../src/internal/middleware/middleware.ts"],"sourcesContent":["import type * as EffectOp from '@logixjs/core/EffectOp'\nimport type { JsonValue } from '@logixjs/core/Observability'\nimport { Effect, Layer, Option, ServiceMap } from 'effect'\nimport { middleware as middlewareImpl, type MiddlewareConfig } from './internal/middleware/middleware.js'\n\nexport type InvalidateRequest =\n  | { readonly kind: 'byResource'; readonly resourceId: string }\n  | { readonly kind: 'byParams'; readonly resourceId: string; readonly keyHash: string }\n  | { readonly kind: 'byTag'; readonly tag: string }\n\nexport interface Engine {\n  readonly fetch: <A>(args: {\n    readonly resourceId: string\n    readonly keyHash: string\n    readonly effect: Effect.Effect<A, unknown, any>\n    /**\n     * MUST be serializable and slim; recommended default is undefined (lazy),\n     * and only populate it when diagnostics/devtools require it.\n     */\n    readonly meta?: JsonValue\n  }) => Effect.Effect<A, unknown, any>\n\n  /**\n   * perf: optional fast path to avoid allocations on the hot path.\n   * Semantics must match `fetch({ ... })`.\n   */\n  readonly fetchFast?: <A>(\n    resourceId: string,\n    keyHash: string,\n    effect: Effect.Effect<A, unknown, any>,\n    meta?: JsonValue,\n  ) => Effect.Effect<A, unknown, any>\n\n  readonly invalidate: (request: InvalidateRequest) => Effect.Effect<void, unknown, any>\n\n  /**\n   * Read-only fast path: must not trigger IO; used to short-circuit to success before refresh,\n   * avoiding loading jitter.\n   */\n  readonly peekFresh?: <A>(args: {\n    readonly resourceId: string\n    readonly keyHash: string\n  }) => Effect.Effect<Option.Option<A>, never, any>\n}\n\nclass EngineTagImpl extends ServiceMap.Service<EngineTagImpl, Engine>()('@logixjs/query/Engine') {}\n\nexport const Engine = Object.assign(EngineTagImpl, {\n  layer: (engine: Engine): Layer.Layer<EngineTagImpl, never, never> => Layer.succeed(EngineTagImpl, engine),\n  middleware: (config?: MiddlewareConfig): EffectOp.Middleware => middlewareImpl(config),\n})\n\nexport type { MiddlewareConfig }\n","import type * as EffectOp from '@logixjs/core/EffectOp'\nimport { Effect, Option, ServiceMap } from 'effect'\nimport { Engine } from '../../Engine.js'\nimport type { Engine as EngineService } from '../../Engine.js'\n\nexport interface MiddlewareConfig {\n  /**\n   * Default: only applies to EffectOp that carries resourceId+keyHash (from StateTrait.source).\n   * Optional: further filter by resourceId.\n   */\n  readonly useFor?: (resourceId: string) => boolean\n}\n\n/**\n * Query middleware (EffectOp): external engine takeover point.\n * - Delegates ResourceSpec.load execution to Engine (cache / in-flight dedupe / invalidation, etc.)\n * - Still preserves Logix Runtime's keyHash gating and ResourceSnapshot source-of-truth semantics\n */\nexport const middleware = (config?: MiddlewareConfig): EffectOp.Middleware =>\n  (() => {\n    // perf: within the same Runtime instance, Engine injection is stable.\n    // Cache it in the middleware closure to avoid a Context lookup on every fetch.\n    let cachedEngine: EngineService | undefined\n\n    return (op) => {\n      if ((op.kind !== 'service' && op.kind !== 'trait-source') || !op.meta?.resourceId || !op.meta.keyHash) {\n        return op.effect as any\n      }\n\n      const resourceId = op.meta.resourceId\n      if (config?.useFor && !config.useFor(resourceId)) {\n        return op.effect as any\n      }\n\n      const keyHash = op.meta.keyHash as string\n\n      if (cachedEngine) {\n        if (cachedEngine.fetchFast) {\n          return cachedEngine.fetchFast(resourceId, keyHash, op.effect as any)\n        }\n        return cachedEngine.fetch({ resourceId, keyHash, effect: op.effect as any })\n      }\n\n      return Effect.serviceOption(Engine as unknown as ServiceMap.Key<any, EngineService>).pipe(\n        Effect.flatMap((engineOpt) => {\n          if (Option.isNone(engineOpt)) {\n            return Effect.fail(\n              new Error(\n                `[Query.Engine.middleware] Missing Query.Engine in the Runtime scope; please provide Query.Engine.layer(Query.TanStack.engine(new QueryClient())) (recommended) or Query.Engine.layer(customEngine).`,\n              ),\n            )\n          }\n          cachedEngine = engineOpt.value\n          if (cachedEngine.fetchFast) {\n            return cachedEngine.fetchFast(resourceId, keyHash, op.effect as any)\n          }\n          return cachedEngine.fetch({ resourceId, keyHash, effect: op.effect as any })\n        }),\n      ) as any\n    }\n  })()\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,IAAAA,iBAAkD;;;ACDlD,oBAA2C;AAiBpC,IAAM,aAAa,CAAC,WACxB,uBAAM;AAGL,MAAI;AAEJ,SAAO,CAAC,OAAO;AACb,QAAK,GAAG,SAAS,aAAa,GAAG,SAAS,kBAAmB,CAAC,GAAG,MAAM,cAAc,CAAC,GAAG,KAAK,SAAS;AACrG,aAAO,GAAG;AAAA,IACZ;AAEA,UAAM,aAAa,GAAG,KAAK;AAC3B,QAAI,QAAQ,UAAU,CAAC,OAAO,OAAO,UAAU,GAAG;AAChD,aAAO,GAAG;AAAA,IACZ;AAEA,UAAM,UAAU,GAAG,KAAK;AAExB,QAAI,cAAc;AAChB,UAAI,aAAa,WAAW;AAC1B,eAAO,aAAa,UAAU,YAAY,SAAS,GAAG,MAAa;AAAA,MACrE;AACA,aAAO,aAAa,MAAM,EAAE,YAAY,SAAS,QAAQ,GAAG,OAAc,CAAC;AAAA,IAC7E;AAEA,WAAO,qBAAO,cAAc,MAAuD,EAAE;AAAA,MACnF,qBAAO,QAAQ,CAAC,cAAc;AAC5B,YAAI,qBAAO,OAAO,SAAS,GAAG;AAC5B,iBAAO,qBAAO;AAAA,YACZ,IAAI;AAAA,cACF;AAAA,YACF;AAAA,UACF;AAAA,QACF;AACA,uBAAe,UAAU;AACzB,YAAI,aAAa,WAAW;AAC1B,iBAAO,aAAa,UAAU,YAAY,SAAS,GAAG,MAAa;AAAA,QACrE;AACA,eAAO,aAAa,MAAM,EAAE,YAAY,SAAS,QAAQ,GAAG,OAAc,CAAC;AAAA,MAC7E,CAAC;AAAA,IACH;AAAA,EACF;AACF,GAAG;;;ADfL,IAAM,gBAAN,cAA4B,0BAAW,QAA+B,EAAE,uBAAuB,EAAE;AAAC;AAE3F,IAAM,SAAS,OAAO,OAAO,eAAe;AAAA,EACjD,OAAO,CAAC,WAA6D,qBAAM,QAAQ,eAAe,MAAM;AAAA,EACxG,YAAY,CAAC,WAAmD,WAAe,MAAM;AACvF,CAAC;","names":["import_effect"]}

package/dist/Engine.d.cts

@@ -1,6 +1,6 @@
 import * as EffectOp from '@logixjs/core/EffectOp';
 import { JsonValue } from '@logixjs/core/Observability';
-import { Effect, Option, Context, Layer } from 'effect';
+import { Effect, Option, ServiceMap, Layer } from 'effect';
 
 interface MiddlewareConfig {
     /**
@@ -21,7 +21,7 @@ type InvalidateRequest = {
     readonly kind: 'byTag';
     readonly tag: string;
 };
-declare const EngineTagImpl_base: Context.TagClass<EngineTagImpl, "@logixjs/query/Engine", Engine>;
+declare const EngineTagImpl_base: ServiceMap.ServiceClass<EngineTagImpl, "@logixjs/query/Engine", Engine>;
 declare class EngineTagImpl extends EngineTagImpl_base {
 }
 interface Engine {

package/dist/Engine.d.ts

@@ -1,6 +1,6 @@
 import * as EffectOp from '@logixjs/core/EffectOp';
 import { JsonValue } from '@logixjs/core/Observability';
-import { Effect, Option, Context, Layer } from 'effect';
+import { Effect, Option, ServiceMap, Layer } from 'effect';
 
 interface MiddlewareConfig {
     /**
@@ -21,7 +21,7 @@ type InvalidateRequest = {
     readonly kind: 'byTag';
     readonly tag: string;
 };
-declare const EngineTagImpl_base: Context.TagClass<EngineTagImpl, "@logixjs/query/Engine", Engine>;
+declare const EngineTagImpl_base: ServiceMap.ServiceClass<EngineTagImpl, "@logixjs/query/Engine", Engine>;
 declare class EngineTagImpl extends EngineTagImpl_base {
 }
 interface Engine {

package/dist/Engine.js

@@ -1,6 +1,6 @@
 import {
   Engine
-} from "./chunk-7IVR4THQ.js";
+} from "./chunk-3P3M3A55.js";
 import "./chunk-PZ5AY32C.js";
 export {
   Engine

package/dist/Query.cjs

@@ -82,7 +82,7 @@ var middleware = (config) => /* @__PURE__ */ (() => {
 })();
 
 // src/Engine.ts
-var EngineTagImpl = class extends import_effect2.Context.Tag("@logixjs/query/Engine")() {
+var EngineTagImpl = class extends import_effect2.ServiceMap.Service()("@logixjs/query/Engine") {
 };
 var Engine = Object.assign(EngineTagImpl, {
   layer: (engine) => import_effect2.Layer.succeed(EngineTagImpl, engine),
@@ -130,7 +130,7 @@ var autoTrigger = (module2, config) => module2.logic(($) => {
     const prev = pending.get(name);
     if (!prev) return;
     pending.delete(name);
-    yield* import_effect3.Fiber.interruptFork(prev);
+    yield* import_effect3.Fiber.interrupt(prev);
   });
   const sourcePathOf = (name) => `queries.${name}`;
   const refresh = (name, options) => $.traits.source.refresh(sourcePathOf(name), options);
@@ -138,9 +138,9 @@ var autoTrigger = (module2, config) => module2.logic(($) => {
     yield* cancelPending(name);
     const fiber = yield* import_effect3.Effect.forkScoped(
       import_effect3.Effect.sleep(import_effect3.Duration.millis(ms)).pipe(
-        import_effect3.Effect.zipRight(refresh(name)),
+        import_effect3.Effect.flatMap(() => refresh(name)),
         import_effect3.Effect.ensuring(import_effect3.Effect.sync(() => pending.delete(name))),
-        import_effect3.Effect.catchAllCause(() => import_effect3.Effect.void)
+        import_effect3.Effect.catchCause(() => import_effect3.Effect.void)
       )
     );
     pending.set(name, fiber);
@@ -212,21 +212,23 @@ var autoTrigger = (module2, config) => module2.logic(($) => {
   });
   const refreshAll = (options) => import_effect3.Effect.forEach(
     Object.keys(config.queries),
-    (name) => cancelPending(name).pipe(import_effect3.Effect.zipRight(refresh(name, options)))
+    (name) => cancelPending(name).pipe(import_effect3.Effect.flatMap(() => refresh(name, options)))
   ).pipe(import_effect3.Effect.asVoid);
   const setup = $.lifecycle.onStart(maybeAutoRefresh("mount"));
   const run = import_effect3.Effect.suspend(
     () => import_effect3.Effect.all(
       [
         // params/ui changes: handled by Query's default logic, avoiding scattered UI-side useEffect triggers.
-        $.onAction("setParams").runFork(
+        // Keep params/ui-driven auto refresh aligned with action stream order.
+        // `source.refresh` already forks IO internally, so the watcher itself can stay ordered.
+        $.onAction("setParams").run(
           (action) => import_effect3.Effect.gen(function* () {
             const state = yield* $.state.read;
             const next = { ...state, params: action.payload };
             yield* maybeAutoRefresh("keyChange", next);
           })
         ),
-        $.onAction("setUi").runFork(
+        $.onAction("setUi").run(
           (action) => import_effect3.Effect.gen(function* () {
             const state = yield* $.state.read;
             const next = { ...state, ui: action.payload };
@@ -317,7 +319,7 @@ var toStateTraitSpec = (input) => {
 };
 
 // src/Query.ts
-var InvalidateRequestSchema = import_effect5.Schema.Union(
+var InvalidateRequestSchema = import_effect5.Schema.Union([
   import_effect5.Schema.Struct({
     kind: import_effect5.Schema.Literal("byResource"),
     resourceId: import_effect5.Schema.String
@@ -331,7 +333,7 @@ var InvalidateRequestSchema = import_effect5.Schema.Union(
     kind: import_effect5.Schema.Literal("byTag"),
     tag: import_effect5.Schema.String
   })
-);
+]);
 var assertQueryName = (name) => {
   if (!name) {
     throw new Error(`[Query.make] query name must be non-empty`);
@@ -343,6 +345,15 @@ var assertQueryName = (name) => {
     throw new Error(`[Query.make] query name "${name}" is reserved`);
   }
 };
+var buildRefreshTargetSchema = (names) => {
+  if (names.length === 0) {
+    return import_effect5.Schema.Never;
+  }
+  return import_effect5.Schema.Literals(names);
+};
+var buildQueriesSchema = (queries) => import_effect5.Schema.Struct(
+  Object.fromEntries(Object.keys(queries).map((key) => [key, import_effect5.Schema.Unknown]))
+);
 var make = (id, config) => {
   const queryBuilder = {
     source: (q) => q
@@ -353,28 +364,13 @@ var make = (id, config) => {
     return raw(queryBuilder);
   })();
   const queriesForTraits = queries;
-  for (const name of Object.keys(queries)) {
+  const queryNames = Object.keys(queries);
+  for (const name of queryNames) {
     assertQueryName(name);
   }
-  const RefreshTargetSchema = (() => {
-    const names = Object.keys(queries);
-    if (names.length === 0) return import_effect5.Schema.Never;
-    if (names.length === 1) {
-      return import_effect5.Schema.Literal(names[0]);
-    }
-    const asUnionMembers = (items) => {
-      if (items.length < 2) {
-        throw new Error(`[Query.make] internal error: expected at least 2 query names for union`);
-      }
-      return items;
-    };
-    const members = names.map((n) => import_effect5.Schema.Literal(n));
-    return import_effect5.Schema.Union(...asUnionMembers(members));
-  })();
+  const RefreshTargetSchema = buildRefreshTargetSchema(queryNames);
   const UiSchema = import_effect5.Schema.Unknown;
-  const QueriesSchema = import_effect5.Schema.Struct(
-    Object.fromEntries(Object.keys(queries).map((k) => [k, import_effect5.Schema.Unknown]))
-  );
+  const QueriesSchema = buildQueriesSchema(queries);
   const StateSchema = import_effect5.Schema.Struct({
     params: config.params,
     ui: UiSchema,
@@ -416,9 +412,7 @@ var make = (id, config) => {
   const initial = (params) => ({
     params: params ?? config.initialParams,
     ui: config.ui ?? {},
-    queries: Object.fromEntries(
-      Object.keys(queries).map((k) => [k, Logix4.Resource.Snapshot.idle()])
-    )
+    queries: Object.fromEntries(Object.keys(queries).map((key) => [key, Logix4.Resource.Snapshot.idle()]))
   });
   const controller = {
     make: (runtime) => {

package/dist/Query.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/Query.ts","../src/internal/logics/auto-trigger.ts","../src/Engine.ts","../src/internal/middleware/middleware.ts","../src/internal/logics/invalidate.ts","../src/Traits.ts"],"sourcesContent":["import * as Logix from '@logixjs/core'\nimport { Effect, Schema } from 'effect'\nimport { autoTrigger } from './internal/logics/auto-trigger.js'\nimport { invalidate } from './internal/logics/invalidate.js'\nimport type { InvalidateRequest } from './Engine.js'\nimport { toStateTraitSpec, type QueryBuilder, type QuerySourceConfig, type QueryResourceData, type QueryResourceError } from './Traits.js'\n\ntype AnyQuerySourceConfig<TParams, TUI> = QuerySourceConfig<TParams, TUI, any, any>\n\ntype EnsureQueries<TParams, TUI, TQueries> = TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>>\n  ? {}\n  : {\n      readonly __queries_must_be_QuerySourceConfig__: never\n    }\n\ntype QueriesOf<TParams, TUI, TQueries> = TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> ? TQueries : never\n\nexport type QueryState<\n  TParams,\n  TUI = unknown,\n  TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {},\n> = {\n  readonly params: TParams\n  readonly ui: TUI\n  readonly queries: {\n    readonly [K in keyof TQueries]: Logix.Resource.ResourceSnapshot<\n      QueryResourceData<TQueries[K]['resource']>,\n      QueryResourceError<TQueries[K]['resource']>\n    >\n  }\n}\n\nexport type QueryName<TQueries extends Record<string, any>> = Extract<keyof TQueries, string>\n\ntype ForbiddenQueryName = 'params' | 'ui' | 'queries'\ntype ForbidQueryNames = {\n  readonly [K in ForbiddenQueryName]?: never\n}\n\nexport type QueryActions<TParams, TUI = unknown, TQueries extends Record<string, any> = {}> = {\n  readonly setParams: Schema.Schema<TParams, any>\n  readonly setUi: Schema.Schema<TUI, any>\n  readonly refresh: Schema.Schema<QueryName<TQueries> | undefined, any>\n  readonly invalidate: Schema.Schema<InvalidateRequest, any>\n}\n\nexport type QueryShape<\n  TParams,\n  TUI = unknown,\n  TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {},\n> = Logix.Shape<Schema.Schema<QueryState<TParams, TUI, TQueries>, any>, QueryActions<TParams, TUI, TQueries>>\n\nexport type QueryAction<\n  TParams,\n  TUI = unknown,\n  TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {},\n> = Logix.ActionOf<QueryShape<TParams, TUI, TQueries>>\n\nexport interface QueryMakeConfig<\n  TParams,\n  TUI = unknown,\n  TQueries = {},\n> {\n  readonly params: Schema.Schema<TParams, any>\n  readonly initialParams: TParams\n  readonly ui?: TUI\n  readonly queries?: (q: QueryBuilder<TParams, TUI>) => TQueries & ForbidQueryNames\n  readonly traits?: unknown\n}\n\nexport interface QueryController<\n  TParams,\n  TUI = unknown,\n  TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {},\n> {\n  readonly runtime: Logix.ModuleRuntime<QueryState<TParams, TUI, TQueries>, QueryAction<TParams, TUI, TQueries>>\n  readonly getState: Effect.Effect<QueryState<TParams, TUI, TQueries>>\n  readonly dispatch: (action: QueryAction<TParams, TUI, TQueries>) => Effect.Effect<void>\n\n  readonly controller: {\n    readonly setParams: (params: TParams) => Effect.Effect<void>\n    readonly setUi: (ui: TUI) => Effect.Effect<void>\n    readonly refresh: (target?: QueryName<TQueries>) => Effect.Effect<void>\n    readonly invalidate: (request: InvalidateRequest) => Effect.Effect<void>\n  }\n}\n\nexport type QueryModuleController<\n  TParams,\n  TUI = unknown,\n  TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {},\n> = {\n  readonly make: (\n    runtime: Logix.ModuleRuntime<QueryState<TParams, TUI, TQueries>, QueryAction<TParams, TUI, TQueries>>,\n  ) => QueryController<TParams, TUI, TQueries>\n}\n\nexport type QueryHandleExt<\n  TParams,\n  TUI = unknown,\n  TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {},\n> = {\n  readonly controller: QueryController<TParams, TUI, TQueries>['controller']\n}\n\nexport type QueryModule<\n  Id extends string,\n  TParams,\n  TUI = unknown,\n  TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {},\n> = Logix.Module.Module<Id, QueryShape<TParams, TUI, TQueries>, QueryHandleExt<TParams, TUI, TQueries>, any> & {\n  readonly controller: QueryModuleController<TParams, TUI, TQueries>\n}\n\nconst InvalidateRequestSchema = Schema.Union(\n  Schema.Struct({\n    kind: Schema.Literal('byResource'),\n    resourceId: Schema.String,\n  }),\n  Schema.Struct({\n    kind: Schema.Literal('byParams'),\n    resourceId: Schema.String,\n    keyHash: Schema.String,\n  }),\n  Schema.Struct({\n    kind: Schema.Literal('byTag'),\n    tag: Schema.String,\n  }),\n) as Schema.Schema<InvalidateRequest, any>\n\nconst assertQueryName = (name: string): void => {\n  if (!name) {\n    throw new Error(`[Query.make] query name must be non-empty`)\n  }\n  if (name.includes('.')) {\n    throw new Error(`[Query.make] query name must not include \".\"; got \"${name}\"`)\n  }\n  if (name === 'params' || name === 'ui' || name === 'queries') {\n    throw new Error(`[Query.make] query name \"${name}\" is reserved`)\n  }\n}\n\nexport const make = <\n  Id extends string,\n  TParams,\n  TUI = unknown,\n  const TQueries = {},\n>(\n  id: Id,\n  config: QueryMakeConfig<TParams, TUI, TQueries> & EnsureQueries<TParams, TUI, TQueries>,\n): QueryModule<Id, TParams, TUI, QueriesOf<TParams, TUI, TQueries>> => {\n  type Queries = QueriesOf<TParams, TUI, TQueries>\n  const queryBuilder: QueryBuilder<TParams, TUI> = {\n    source: (q: any) => q,\n  }\n\n\t  const queries = ((): Queries => {\n\t    const raw = config.queries\n\t    if (!raw) return {} as Queries\n\t    return raw(queryBuilder) as Queries\n\t  })()\n\n  const queriesForTraits: Readonly<Record<string, AnyQuerySourceConfig<TParams, TUI>>> = queries\n  for (const name of Object.keys(queries)) {\n    assertQueryName(name)\n  }\n\n\t  const RefreshTargetSchema = (() => {\n\t    const names = Object.keys(queries) as Array<QueryName<Queries>>\n\t    if (names.length === 0) return Schema.Never as unknown as Schema.Schema<QueryName<Queries>, any>\n\t    if (names.length === 1) {\n\t      return Schema.Literal(names[0] as any) as unknown as Schema.Schema<QueryName<Queries>, any>\n\t    }\n    const asUnionMembers = <A>(items: ReadonlyArray<A>): readonly [A, A, ...Array<A>] => {\n      if (items.length < 2) {\n        throw new Error(`[Query.make] internal error: expected at least 2 query names for union`)\n      }\n      return items as unknown as readonly [A, A, ...Array<A>]\n    }\n\n\t    const members = names.map((n) => Schema.Literal(n as any))\n\t    return Schema.Union(...asUnionMembers(members)) as unknown as Schema.Schema<QueryName<Queries>, any>\n\t  })()\n\n  const UiSchema = Schema.Unknown as Schema.Schema<TUI, any>\n\n\t  const QueriesSchema = Schema.Struct(\n\t    Object.fromEntries((Object.keys(queries) as Array<keyof Queries>).map((k) => [k, Schema.Unknown])) as Record<\n\t      string,\n\t      Schema.Schema<any, any>\n\t    >,\n\t  )\n\n  const StateSchema = Schema.Struct({\n    params: config.params,\n    ui: UiSchema,\n    queries: QueriesSchema,\n  }) as unknown as Schema.Schema<QueryState<TParams, TUI, Queries>, any>\n\n  const Actions = {\n    setParams: config.params,\n    setUi: UiSchema,\n    refresh: Schema.UndefinedOr(RefreshTargetSchema),\n    invalidate: InvalidateRequestSchema,\n  } satisfies QueryActions<TParams, TUI, Queries>\n\n  type Reducers = Logix.ReducersFromMap<typeof StateSchema, typeof Actions>\n\n  const reducers: Reducers = {\n    setParams: (state, action, sink) => {\n      sink?.('params')\n      return { ...state, params: action.payload ?? state.params }\n    },\n    setUi: (state, action, sink) => {\n      sink?.('ui')\n      return { ...state, ui: action.payload ?? state.ui }\n    },\n    refresh: (state) => state,\n    invalidate: (state) => state,\n  } satisfies Reducers\n\n  const queryTraits =\n    Object.keys(queriesForTraits).length > 0 ? toStateTraitSpec<TParams, TUI>({ queries: queriesForTraits }) : undefined\n\n  const traits =\n    queryTraits || config.traits\n      ? ({\n          ...(queryTraits as any),\n          ...(config.traits as any),\n        } as any)\n      : undefined\n\n  const module = Logix.Module.make(id, {\n    state: StateSchema,\n    actions: Actions,\n    reducers,\n    traits,\n  })\n\n  const logics = [\n    autoTrigger<any, TParams, TUI>(module.tag as any, { queries: queriesForTraits }),\n    invalidate<any, TParams, TUI>(module.tag as any, { queries: queriesForTraits }),\n  ] satisfies ReadonlyArray<Logix.ModuleLogic<any, any, any>>\n\n  const initial = (params?: TParams): QueryState<TParams, TUI, Queries> =>\n    ({\n      params: params ?? config.initialParams,\n      ui: (config.ui ?? ({} as unknown as TUI)) as TUI,\n      queries: Object.fromEntries(\n        (Object.keys(queries) as Array<keyof Queries>).map((k) => [k, Logix.Resource.Snapshot.idle()]),\n      ),\n    }) as QueryState<TParams, TUI, Queries>\n\n\t  const controller: QueryModuleController<TParams, TUI, Queries> = {\n\t    make: (\n\t      runtime: Logix.ModuleRuntime<QueryState<TParams, TUI, Queries>, QueryAction<TParams, TUI, Queries>>,\n\t    ): QueryController<TParams, TUI, Queries> => {\n\t      const dispatch = runtime.dispatch\n\t      const actions = module.actions as unknown as {\n\t        readonly setParams: (params: TParams) => QueryAction<TParams, TUI, Queries>\n\t        readonly setUi: (ui: TUI) => QueryAction<TParams, TUI, Queries>\n\t        readonly refresh: (target: QueryName<Queries> | undefined) => QueryAction<TParams, TUI, Queries>\n\t        readonly invalidate: (request: InvalidateRequest) => QueryAction<TParams, TUI, Queries>\n\t      }\n\t\t      return {\n\t\t        runtime,\n\t\t        getState: runtime.getState as Effect.Effect<QueryState<TParams, TUI, Queries>>,\n\t\t        dispatch,\n\t        controller: {\n\t          setParams: (params: TParams) => dispatch(actions.setParams(params)),\n\t          setUi: (ui: TUI) => dispatch(actions.setUi(ui)),\n\t          refresh: (target?: QueryName<Queries>) => dispatch(actions.refresh(target)),\n\t\t          invalidate: (request: InvalidateRequest) => dispatch(actions.invalidate(request)),\n\t\t        },\n\t\t      } as QueryController<TParams, TUI, Queries>\n\t\t    },\n\t\t  }\n\n  ;(module as any).controller = controller\n\n  const EXTEND_HANDLE = Symbol.for('logix.module.handle.extend')\n  ;(module.tag as any)[EXTEND_HANDLE] = (\n    runtime: Logix.ModuleRuntime<QueryState<TParams, TUI, Queries>, QueryAction<TParams, TUI, Queries>>,\n    base: Logix.ModuleHandle<any>,\n  ) => {\n    const c = controller.make(runtime)\n    return {\n      ...base,\n      controller: c.controller,\n    }\n  }\n\n  return module.implement({\n    initial: initial(),\n    logics: [...logics],\n  }) as unknown as QueryModule<Id, TParams, TUI, Queries>\n}\n","import * as Logix from '@logixjs/core'\nimport { Duration, Effect, Fiber } from 'effect'\nimport type { QuerySourceConfig, QueryTrigger } from '../../Traits.js'\nimport { Engine } from '../../Engine.js'\n\nconst defaultTriggers = ['onMount', 'onKeyChange'] as const\n\nconst getTriggers = (triggers: ReadonlyArray<QueryTrigger> | undefined): ReadonlyArray<QueryTrigger> =>\n  triggers ?? defaultTriggers\n\nconst isManualOnly = (triggers: ReadonlyArray<QueryTrigger>): boolean =>\n  triggers.length === 1 && triggers[0] === 'manual'\n\nconst getSnapshotKeyHash = (snapshot: unknown): string | undefined => {\n  if (!snapshot || typeof snapshot !== 'object') return undefined\n  const keyHash = (snapshot as any).keyHash\n  return typeof keyHash === 'string' ? keyHash : undefined\n}\n\nconst getSnapshotStatus = (snapshot: unknown): string | undefined => {\n  if (!snapshot || typeof snapshot !== 'object') return undefined\n  const status = (snapshot as any).status\n  return typeof status === 'string' ? status : undefined\n}\n\nexport interface AutoTriggerLogicConfig<TParams, TUI> {\n  readonly queries: Readonly<Record<string, QuerySourceConfig<TParams, TUI>>>\n}\n\n/**\n * Query auto-trigger logic:\n * - onMount: triggers once on initialization (if the key is valid and current snapshot does not match the same keyHash).\n * - onKeyChange: triggers after params/ui state changes (can debounce; only when keyHash changes or current is idle).\n * - manual-only: when triggers=[\"manual\"], disable onMount/onKeyChange auto triggering.\n */\nexport const autoTrigger = <Sh extends Logix.AnyModuleShape, TParams, TUI>(\n  module: Logix.ModuleTagType<any, Sh>,\n  config: AutoTriggerLogicConfig<TParams, TUI>,\n): Logix.ModuleLogic<Sh, any, never> =>\n  module.logic(($) => {\n    type _State = Logix.StateOf<Sh> & { readonly queries: Record<string, unknown> }\n    type QueryName = Extract<keyof typeof config.queries, string>\n\n    const pending = new Map<string, Fiber.RuntimeFiber<void, any>>()\n    const lastKeyHash = new Map<string, string | undefined>()\n\n    const hydrateFromFreshCache = (\n      name: QueryName,\n      q: QuerySourceConfig<TParams, TUI>,\n      keyHash: string,\n    ): Effect.Effect<boolean, never, any> =>\n      Effect.gen(function* () {\n        const engineOpt = yield* Effect.serviceOption(Engine)\n        if (engineOpt._tag === 'None') return false\n\n        const engine = engineOpt.value\n        if (!engine.peekFresh) return false\n\n        const dataOpt = yield* engine.peekFresh({\n          resourceId: q.resource.id,\n          keyHash,\n        })\n        if (dataOpt._tag === 'None') return false\n\n        const snapshot = Logix.Resource.Snapshot.success({\n          keyHash,\n          data: dataOpt.value,\n        })\n        yield* $.state.mutate((draft) => {\n          ;(draft as Logix.Logic.Draft<_State>).queries[name] = snapshot\n        })\n\n        return true\n      })\n\n    const cancelPending = (name: string): Effect.Effect<void, never, any> =>\n      Effect.gen(function* () {\n        const prev = pending.get(name)\n        if (!prev) return\n        pending.delete(name)\n        yield* Fiber.interruptFork(prev)\n      })\n\n    const sourcePathOf = (name: QueryName): string => `queries.${name}`\n\n    const refresh = (name: QueryName, options?: { readonly force?: boolean }): Effect.Effect<void, never, any> =>\n      $.traits.source.refresh(sourcePathOf(name) as any, options as any) as Effect.Effect<void, never, any>\n\n    const scheduleDebounced = (name: QueryName, ms: number): Effect.Effect<void, never, any> =>\n      Effect.gen(function* () {\n        yield* cancelPending(name)\n        const fiber = yield* Effect.forkScoped(\n          Effect.sleep(Duration.millis(ms)).pipe(\n            Effect.zipRight(refresh(name)),\n            Effect.ensuring(Effect.sync(() => pending.delete(name))),\n            Effect.catchAllCause(() => Effect.void),\n          ),\n        )\n        pending.set(name, fiber)\n      })\n\n    const computeKeyHash = (state: any, q: QuerySourceConfig<TParams, TUI>): string | undefined => {\n      const getAtPath = (root: any, path: string): unknown => {\n        const parts = path.split('.')\n        let cur = root\n        for (const p of parts) {\n          if (cur == null) return undefined\n          cur = cur[p]\n        }\n        return cur\n      }\n\n      try {\n        const keyState = { params: state.params as any, ui: state.ui as any } as any\n        const args = (q.deps as ReadonlyArray<string>).map((dep) => getAtPath(keyState, dep))\n        const key = (q.key as any)(...args)\n        if (key === undefined) return undefined\n        return Logix.Resource.keyHash(key)\n      } catch {\n        return undefined\n      }\n    }\n\n    const maybeAutoRefresh = (\n      phase: 'mount' | 'keyChange',\n      stateOverride?: unknown,\n    ): Effect.Effect<void, never, any> =>\n      Effect.gen(function* () {\n        const state = (stateOverride ?? (yield* $.state.read)) as any\n\n        for (const [name, q] of Object.entries(config.queries)) {\n          const queryName = name as QueryName\n          const triggers = getTriggers(q.triggers)\n          if (isManualOnly(triggers)) {\n            continue\n          }\n\n          if (phase === 'mount' && !triggers.includes('onMount')) {\n            continue\n          }\n\n          if (phase === 'keyChange' && !triggers.includes('onKeyChange')) {\n            continue\n          }\n\n          const keyHash = computeKeyHash(state, q)\n          const snapshot = state?.queries?.[queryName]\n          const snapshotKeyHash = getSnapshotKeyHash(snapshot)\n          const snapshotStatus = getSnapshotStatus(snapshot)\n\n          // Key is unavailable: do not refresh (idle reaping is guaranteed by kernel syncIdleInTransaction).\n          if (keyHash === undefined) {\n            lastKeyHash.set(queryName, undefined)\n            continue\n          }\n\n          // keyHash unchanged and we already have a non-idle snapshot: avoid re-entering loading (reuse existing result).\n          const last = lastKeyHash.get(queryName)\n          if (snapshotStatus && snapshotStatus !== 'idle' && snapshotKeyHash === keyHash && last === keyHash) {\n            continue\n          }\n\n          // If current snapshot is already success/error/loading with the same keyHash: update lastKeyHash and skip.\n          if (snapshotStatus && snapshotStatus !== 'idle' && snapshotKeyHash === keyHash) {\n            lastKeyHash.set(queryName, keyHash)\n            continue\n          }\n\n          lastKeyHash.set(queryName, keyHash)\n\n          // TanStack Query scenario: if we can hit the fresh cache, write a success snapshot directly,\n          // skipping source.refresh (avoids UI jitter and extra transactions like \"cache hit but still loading -> success\").\n          const hydrated = yield* hydrateFromFreshCache(queryName, q, keyHash)\n          if (hydrated) {\n            yield* cancelPending(queryName)\n            continue\n          }\n\n          const debounceMs = q.debounceMs ?? 0\n          if (phase === 'keyChange' && debounceMs > 0) {\n            yield* scheduleDebounced(queryName, debounceMs)\n          } else {\n            // mount / no debounce: trigger immediately\n            yield* cancelPending(queryName)\n            yield* refresh(queryName)\n          }\n        }\n      })\n\n    const refreshAll = (options?: { readonly force?: boolean }): Effect.Effect<void, never, any> =>\n      Effect.forEach(Object.keys(config.queries), (name) =>\n        cancelPending(name).pipe(Effect.zipRight(refresh(name as QueryName, options))),\n      ).pipe(Effect.asVoid)\n\n    const setup = $.lifecycle.onStart(maybeAutoRefresh('mount'))\n\n    const run = Effect.suspend(() =>\n      Effect.all(\n        [\n          // params/ui changes: handled by Query's default logic, avoiding scattered UI-side useEffect triggers.\n          $.onAction('setParams').runFork((action: any) =>\n            Effect.gen(function* () {\n              const state = (yield* $.state.read) as any\n              const next = { ...state, params: action.payload }\n              yield* maybeAutoRefresh('keyChange', next)\n            }),\n          ),\n          $.onAction('setUi').runFork((action: any) =>\n            Effect.gen(function* () {\n              const state = (yield* $.state.read) as any\n              const next = { ...state, ui: action.payload }\n              yield* maybeAutoRefresh('keyChange', next)\n            }),\n          ),\n\n          // Manual refresh: not restricted by triggers (manual-only still allows explicit refresh).\n          $.onAction('refresh').runFork((action: any) =>\n            Effect.gen(function* () {\n              const target = action.payload as QueryName | undefined\n              if (typeof target === 'string' && target.length > 0) {\n                yield* cancelPending(target)\n                yield* refresh(target, { force: true })\n              } else {\n                yield* refreshAll({ force: true })\n              }\n            }),\n          ),\n        ],\n        { concurrency: 'unbounded' },\n      ).pipe(Effect.asVoid),\n    )\n\n    return { setup, run }\n  }) as Logix.ModuleLogic<Sh, any, never>\n","import type * as EffectOp from '@logixjs/core/EffectOp'\nimport type { JsonValue } from '@logixjs/core/Observability'\nimport { Context, Effect, Layer, Option } from 'effect'\nimport { middleware as middlewareImpl, type MiddlewareConfig } from './internal/middleware/middleware.js'\n\nexport type InvalidateRequest =\n  | { readonly kind: 'byResource'; readonly resourceId: string }\n  | { readonly kind: 'byParams'; readonly resourceId: string; readonly keyHash: string }\n  | { readonly kind: 'byTag'; readonly tag: string }\n\nexport interface Engine {\n  readonly fetch: <A>(args: {\n    readonly resourceId: string\n    readonly keyHash: string\n    readonly effect: Effect.Effect<A, unknown, any>\n    /**\n     * MUST be serializable and slim; recommended default is undefined (lazy),\n     * and only populate it when diagnostics/devtools require it.\n     */\n    readonly meta?: JsonValue\n  }) => Effect.Effect<A, unknown, any>\n\n  /**\n   * perf: optional fast path to avoid allocations on the hot path.\n   * Semantics must match `fetch({ ... })`.\n   */\n  readonly fetchFast?: <A>(\n    resourceId: string,\n    keyHash: string,\n    effect: Effect.Effect<A, unknown, any>,\n    meta?: JsonValue,\n  ) => Effect.Effect<A, unknown, any>\n\n  readonly invalidate: (request: InvalidateRequest) => Effect.Effect<void, unknown, any>\n\n  /**\n   * Read-only fast path: must not trigger IO; used to short-circuit to success before refresh,\n   * avoiding loading jitter.\n   */\n  readonly peekFresh?: <A>(args: {\n    readonly resourceId: string\n    readonly keyHash: string\n  }) => Effect.Effect<Option.Option<A>, never, any>\n}\n\nclass EngineTagImpl extends Context.Tag('@logixjs/query/Engine')<EngineTagImpl, Engine>() {}\n\nexport const Engine = Object.assign(EngineTagImpl, {\n  layer: (engine: Engine): Layer.Layer<EngineTagImpl, never, never> => Layer.succeed(EngineTagImpl, engine),\n  middleware: (config?: MiddlewareConfig): EffectOp.Middleware => middlewareImpl(config),\n})\n\nexport type { MiddlewareConfig }\n","import type * as EffectOp from '@logixjs/core/EffectOp'\nimport { Effect, Option } from 'effect'\nimport { Engine } from '../../Engine.js'\nimport type { Engine as EngineService } from '../../Engine.js'\n\nexport interface MiddlewareConfig {\n  /**\n   * Default: only applies to EffectOp that carries resourceId+keyHash (from StateTrait.source).\n   * Optional: further filter by resourceId.\n   */\n  readonly useFor?: (resourceId: string) => boolean\n}\n\n/**\n * Query middleware (EffectOp): external engine takeover point.\n * - Delegates ResourceSpec.load execution to Engine (cache / in-flight dedupe / invalidation, etc.)\n * - Still preserves Logix Runtime's keyHash gating and ResourceSnapshot source-of-truth semantics\n */\nexport const middleware = (config?: MiddlewareConfig): EffectOp.Middleware =>\n  (() => {\n    // perf: within the same Runtime instance, Engine injection is stable.\n    // Cache it in the middleware closure to avoid a Context lookup on every fetch.\n    let cachedEngine: EngineService | undefined\n\n    return (op) => {\n      if ((op.kind !== 'service' && op.kind !== 'trait-source') || !op.meta?.resourceId || !op.meta.keyHash) {\n        return op.effect as any\n      }\n\n      const resourceId = op.meta.resourceId\n      if (config?.useFor && !config.useFor(resourceId)) {\n        return op.effect as any\n      }\n\n      const keyHash = op.meta.keyHash as string\n\n      if (cachedEngine) {\n        if (cachedEngine.fetchFast) {\n          return cachedEngine.fetchFast(resourceId, keyHash, op.effect as any)\n        }\n        return cachedEngine.fetch({ resourceId, keyHash, effect: op.effect as any })\n      }\n\n      return Effect.serviceOption(Engine).pipe(\n        Effect.flatMap((engineOpt) => {\n          if (Option.isNone(engineOpt)) {\n            return Effect.fail(\n              new Error(\n                `[Query.Engine.middleware] Missing Query.Engine in the Runtime scope; please provide Query.Engine.layer(Query.TanStack.engine(new QueryClient())) (recommended) or Query.Engine.layer(customEngine).`,\n              ),\n            )\n          }\n          cachedEngine = engineOpt.value\n          if (cachedEngine.fetchFast) {\n            return cachedEngine.fetchFast(resourceId, keyHash, op.effect as any)\n          }\n          return cachedEngine.fetch({ resourceId, keyHash, effect: op.effect as any })\n        }),\n      ) as any\n    }\n  })()\n","import * as Logix from '@logixjs/core'\nimport { Effect } from 'effect'\nimport { Engine, type InvalidateRequest } from '../../Engine.js'\nimport type { QuerySourceConfig } from '../../Traits.js'\n\nexport interface InvalidateLogicConfig<TParams, TUI> {\n  readonly queries: Readonly<Record<string, QuerySourceConfig<TParams, TUI>>>\n}\n\nconst toInvalidateTargets = <TParams, TUI>(\n  request: InvalidateRequest,\n  queries: Readonly<Record<string, QuerySourceConfig<TParams, TUI>>>,\n): ReadonlyArray<{ readonly name: string; readonly resourceId: string }> => {\n  if (request.kind === 'byResource') {\n    return Object.entries(queries)\n      .filter(([, q]) => q.resource.id === request.resourceId)\n      .map(([name, q]) => ({ name, resourceId: q.resource.id }))\n  }\n\n  if (request.kind === 'byParams') {\n    return Object.entries(queries)\n      .filter(([, q]) => q.resource.id === request.resourceId)\n      .map(([name, q]) => ({ name, resourceId: q.resource.id }))\n  }\n\n  // byTag: prefer QuerySourceConfig.tags for static filtering; if tags are missing, conservatively fall back to refreshing all.\n  const entries = Object.entries(queries)\n  const tagged = entries.filter(([, q]) => Array.isArray(q.tags) && q.tags.includes(request.tag))\n  const selected = tagged.length > 0 ? tagged : entries\n  return selected.map(([name, q]) => ({ name, resourceId: q.resource.id }))\n}\n\nexport const invalidate = <Sh extends Logix.AnyModuleShape, TParams, TUI>(\n  module: Logix.ModuleTagType<any, Sh>,\n  config: InvalidateLogicConfig<TParams, TUI>,\n): Logix.ModuleLogic<Sh, any, never> =>\n  module.logic(($) =>\n    Effect.gen(function* () {\n      yield* $.onAction('invalidate').runFork((action: any) =>\n        Effect.gen(function* () {\n          const request = action.payload as InvalidateRequest\n\n          // 1) Eventize: goes into ReplayLog (kernel-owned).\n          yield* Logix.TraitLifecycle.scopedExecute($ as any, {\n            kind: 'query:invalidate',\n            request,\n          })\n\n          // 2) Call external engine (optional): does not block the fallback path.\n          const engineOpt = yield* Effect.serviceOption(Engine)\n          if (engineOpt._tag !== 'None') {\n            yield* engineOpt.value.invalidate(request)\n          }\n\n          // 3) Immediately refresh related sources (write-back gating is still guaranteed by kernel keyHash).\n          const targets = toInvalidateTargets<TParams, TUI>(request, config.queries)\n          const sourcePathOf = (name: string): string => `queries.${name}`\n          yield* Effect.forEach(\n            targets,\n            (t) =>\n              $.traits.source.refresh(sourcePathOf(t.name) as any, { force: true }) as Effect.Effect<void, never, any>,\n          ).pipe(Effect.asVoid)\n        }),\n      )\n    }),\n  ) as Logix.ModuleLogic<Sh, any, never>\n","import * as Logix from '@logixjs/core'\n\nexport type QueryTrigger = 'onMount' | 'onKeyChange' | 'manual'\n\nexport type QueryConcurrency = 'switch' | 'exhaust'\n\nexport type QueryResourceRef = { readonly id: string }\n\nexport type QueryResource = QueryResourceRef | Logix.Resource.ResourceSpec<any, any, any, any>\n\nexport type QueryResourceKey<R> = R extends Logix.Resource.ResourceSpec<infer Key, any, any, any> ? Key : unknown\n\nexport type QueryResourceData<R> = R extends Logix.Resource.ResourceSpec<any, infer Data, any, any> ? Data : unknown\n\nexport type QueryResourceError<R> = R extends Logix.Resource.ResourceSpec<any, any, infer Err, any> ? Err : unknown\n\nexport type QueryKeyState<TParams, TUI> = Readonly<{\n  readonly params: TParams\n  readonly ui: TUI\n}>\n\nexport type QueryDepsPath<TParams, TUI> = Logix.StateTrait.StateFieldPath<QueryKeyState<TParams, TUI>>\n\ntype DepsArgs<S extends object, Deps extends ReadonlyArray<string>> = {\n  readonly [K in keyof Deps]: Deps[K] extends Logix.StateTrait.StateFieldPath<S>\n    ? Logix.StateTrait.StateAtPath<S, Deps[K]>\n    : any\n}\n\ntype BivariantCallback<Args extends ReadonlyArray<any>, R> = {\n  bivarianceHack(...args: Args): R\n}['bivarianceHack']\n\nexport interface QuerySourceConfig<\n  TParams,\n  TUI = unknown,\n  R extends QueryResource = QueryResource,\n  Deps extends ReadonlyArray<string> = ReadonlyArray<QueryDepsPath<TParams, TUI>>,\n> {\n  readonly resource: R\n  readonly deps: Deps & ReadonlyArray<QueryDepsPath<TParams, TUI>>\n  readonly triggers?: ReadonlyArray<QueryTrigger>\n  /**\n   * Optional exportable trait meta (Devtools / Static IR / docs).\n   *\n   * Constraints:\n   * - Must be serializable (JsonValue only); no closures/functions/Effect/DOM objects.\n   * - Keep it slim; use `annotations` with `x-*` keys for extension hints.\n   */\n  readonly meta?: Logix.StateTrait.TraitMeta\n  /**\n   * Optional static tags for invalidate(byTag), used to narrow byTag from \"refresh all\" to a matched subset.\n   * - Must be serializable (recommend: string constants only)\n   * - If omitted, byTag conservatively falls back to refreshing everything\n   */\n  readonly tags?: ReadonlyArray<string>\n  readonly debounceMs?: number\n  readonly concurrency?: QueryConcurrency\n  readonly key: BivariantCallback<DepsArgs<QueryKeyState<TParams, TUI>, Deps>, QueryResourceKey<R> | undefined>\n}\n\nexport type QueryBuilder<TParams, TUI> = {\n  readonly source: <\n    R extends QueryResource,\n    const Deps extends ReadonlyArray<string> = ReadonlyArray<QueryDepsPath<TParams, TUI>>,\n  >(config: {\n    readonly resource: R\n    readonly deps: Deps & ReadonlyArray<QueryDepsPath<TParams, TUI>>\n    readonly triggers?: ReadonlyArray<QueryTrigger>\n    readonly meta?: Logix.StateTrait.TraitMeta\n    readonly tags?: ReadonlyArray<string>\n    readonly debounceMs?: number\n    readonly concurrency?: QueryConcurrency\n    readonly key: (...depsValues: DepsArgs<QueryKeyState<TParams, TUI>, Deps>) => QueryResourceKey<R> | undefined\n  }) => QuerySourceConfig<TParams, TUI, R, Deps>\n}\n\n/**\n * Query.source:\n * - Strongly typed helper to preserve `deps` as a tuple and infer `key(...depsValues)` argument types from it.\n * - Recommended usage inside `Query.make(..., { queries: { name: Query.source({ ... }) } })`.\n */\nexport const source = <\n  TParams,\n  TUI = unknown,\n  R extends QueryResource = QueryResource,\n  const Deps extends ReadonlyArray<string> = ReadonlyArray<QueryDepsPath<TParams, TUI>>,\n>(config: {\n  readonly resource: R\n  readonly deps: Deps & ReadonlyArray<QueryDepsPath<TParams, TUI>>\n  readonly triggers?: ReadonlyArray<QueryTrigger>\n  readonly meta?: Logix.StateTrait.TraitMeta\n  readonly tags?: ReadonlyArray<string>\n  readonly debounceMs?: number\n  readonly concurrency?: QueryConcurrency\n  readonly key: (...depsValues: DepsArgs<QueryKeyState<TParams, TUI>, Deps>) => QueryResourceKey<R> | undefined\n}): QuerySourceConfig<TParams, TUI, R, Deps> => config as QuerySourceConfig<TParams, TUI, R, Deps>\n\nexport interface QueryTraitsInput<TParams, TUI> {\n  readonly queries: Readonly<Record<string, QuerySourceConfig<TParams, TUI, any>>>\n}\n\n/**\n * Lowering rules (Query -> StateTrait):\n * - Each Query rule maps to a `StateTrait.source`, writing back to `queries.<name>` (isomorphic to module state).\n * - keySelector computes key from `{ params; ui }`; keyHash/race gating is guaranteed by the kernel source runtime.\n *\n * Notes:\n * - deps uses module-root paths (e.g. \"params.q\" / \"ui.query.autoEnabled\"), aligned with the constraints in 007/004.\n * - concurrency \"exhaust\" is represented as \"exhaust-trailing\" in the kernel.\n */\nexport const toStateTraitSpec = <TParams, TUI>(\n  input: QueryTraitsInput<TParams, TUI>,\n): Logix.StateTrait.StateTraitSpec<any> => {\n  const out: Record<string, Logix.StateTrait.StateTraitEntry<any, any>> = {}\n\n  for (const [name, q] of Object.entries(input.queries)) {\n    const triggers = q.triggers ?? (['onMount', 'onKeyChange'] as const)\n\n    // \"manual\" must be exclusive to avoid ambiguous semantics (configuration error).\n    if (triggers.includes('manual') && triggers.length > 1) {\n      throw new Error(\n        `[Query.traits] \"manual\" must be exclusive, but got triggers=[${triggers.join(', ')}] for query \"${name}\".`,\n      )\n    }\n\n    out[`queries.${name}`] = Logix.StateTrait.source({\n      // deps: used for graph building/diagnostics/future reverse-closure; Query also reuses deps to converge triggers.\n      deps: q.deps as any,\n      resource: q.resource.id,\n      triggers,\n      debounceMs: q.debounceMs,\n      concurrency: q.concurrency === 'exhaust' ? 'exhaust-trailing' : q.concurrency,\n      key: (...depsValues: ReadonlyArray<any>) => (q.key as any)(...depsValues),\n      meta: q.meta,\n    })\n  }\n\n  return out as Logix.StateTrait.StateTraitSpec<any>\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAAAA,SAAuB;AACvB,IAAAC,iBAA+B;;;ACD/B,YAAuB;AACvB,IAAAC,iBAAwC;;;ACCxC,IAAAC,iBAA+C;;;ACD/C,oBAA+B;AAiBxB,IAAM,aAAa,CAAC,WACxB,uBAAM;AAGL,MAAI;AAEJ,SAAO,CAAC,OAAO;AACb,QAAK,GAAG,SAAS,aAAa,GAAG,SAAS,kBAAmB,CAAC,GAAG,MAAM,cAAc,CAAC,GAAG,KAAK,SAAS;AACrG,aAAO,GAAG;AAAA,IACZ;AAEA,UAAM,aAAa,GAAG,KAAK;AAC3B,QAAI,QAAQ,UAAU,CAAC,OAAO,OAAO,UAAU,GAAG;AAChD,aAAO,GAAG;AAAA,IACZ;AAEA,UAAM,UAAU,GAAG,KAAK;AAExB,QAAI,cAAc;AAChB,UAAI,aAAa,WAAW;AAC1B,eAAO,aAAa,UAAU,YAAY,SAAS,GAAG,MAAa;AAAA,MACrE;AACA,aAAO,aAAa,MAAM,EAAE,YAAY,SAAS,QAAQ,GAAG,OAAc,CAAC;AAAA,IAC7E;AAEA,WAAO,qBAAO,cAAc,MAAM,EAAE;AAAA,MAClC,qBAAO,QAAQ,CAAC,cAAc;AAC5B,YAAI,qBAAO,OAAO,SAAS,GAAG;AAC5B,iBAAO,qBAAO;AAAA,YACZ,IAAI;AAAA,cACF;AAAA,YACF;AAAA,UACF;AAAA,QACF;AACA,uBAAe,UAAU;AACzB,YAAI,aAAa,WAAW;AAC1B,iBAAO,aAAa,UAAU,YAAY,SAAS,GAAG,MAAa;AAAA,QACrE;AACA,eAAO,aAAa,MAAM,EAAE,YAAY,SAAS,QAAQ,GAAG,OAAc,CAAC;AAAA,MAC7E,CAAC;AAAA,IACH;AAAA,EACF;AACF,GAAG;;;ADfL,IAAM,gBAAN,cAA4B,uBAAQ,IAAI,uBAAuB,EAAyB,EAAE;AAAC;AAEpF,IAAM,SAAS,OAAO,OAAO,eAAe;AAAA,EACjD,OAAO,CAAC,WAA6D,qBAAM,QAAQ,eAAe,MAAM;AAAA,EACxG,YAAY,CAAC,WAAmD,WAAe,MAAM;AACvF,CAAC;;;AD7CD,IAAM,kBAAkB,CAAC,WAAW,aAAa;AAEjD,IAAM,cAAc,CAAC,aACnB,YAAY;AAEd,IAAM,eAAe,CAAC,aACpB,SAAS,WAAW,KAAK,SAAS,CAAC,MAAM;AAE3C,IAAM,qBAAqB,CAAC,aAA0C;AACpE,MAAI,CAAC,YAAY,OAAO,aAAa,SAAU,QAAO;AACtD,QAAM,UAAW,SAAiB;AAClC,SAAO,OAAO,YAAY,WAAW,UAAU;AACjD;AAEA,IAAM,oBAAoB,CAAC,aAA0C;AACnE,MAAI,CAAC,YAAY,OAAO,aAAa,SAAU,QAAO;AACtD,QAAM,SAAU,SAAiB;AACjC,SAAO,OAAO,WAAW,WAAW,SAAS;AAC/C;AAYO,IAAM,cAAc,CACzBC,SACA,WAEAA,QAAO,MAAM,CAAC,MAAM;AAIlB,QAAM,UAAU,oBAAI,IAA2C;AAC/D,QAAM,cAAc,oBAAI,IAAgC;AAExD,QAAM,wBAAwB,CAC5B,MACA,GACA,YAEA,sBAAO,IAAI,aAAa;AACtB,UAAM,YAAY,OAAO,sBAAO,cAAc,MAAM;AACpD,QAAI,UAAU,SAAS,OAAQ,QAAO;AAEtC,UAAM,SAAS,UAAU;AACzB,QAAI,CAAC,OAAO,UAAW,QAAO;AAE9B,UAAM,UAAU,OAAO,OAAO,UAAU;AAAA,MACtC,YAAY,EAAE,SAAS;AAAA,MACvB;AAAA,IACF,CAAC;AACD,QAAI,QAAQ,SAAS,OAAQ,QAAO;AAEpC,UAAM,WAAiB,eAAS,SAAS,QAAQ;AAAA,MAC/C;AAAA,MACA,MAAM,QAAQ;AAAA,IAChB,CAAC;AACD,WAAO,EAAE,MAAM,OAAO,CAAC,UAAU;AAC/B;AAAC,MAAC,MAAoC,QAAQ,IAAI,IAAI;AAAA,IACxD,CAAC;AAED,WAAO;AAAA,EACT,CAAC;AAEH,QAAM,gBAAgB,CAAC,SACrB,sBAAO,IAAI,aAAa;AACtB,UAAM,OAAO,QAAQ,IAAI,IAAI;AAC7B,QAAI,CAAC,KAAM;AACX,YAAQ,OAAO,IAAI;AACnB,WAAO,qBAAM,cAAc,IAAI;AAAA,EACjC,CAAC;AAEH,QAAM,eAAe,CAAC,SAA4B,WAAW,IAAI;AAEjE,QAAM,UAAU,CAAC,MAAiB,YAChC,EAAE,OAAO,OAAO,QAAQ,aAAa,IAAI,GAAU,OAAc;AAEnE,QAAM,oBAAoB,CAAC,MAAiB,OAC1C,sBAAO,IAAI,aAAa;AACtB,WAAO,cAAc,IAAI;AACzB,UAAM,QAAQ,OAAO,sBAAO;AAAA,MAC1B,sBAAO,MAAM,wBAAS,OAAO,EAAE,CAAC,EAAE;AAAA,QAChC,sBAAO,SAAS,QAAQ,IAAI,CAAC;AAAA,QAC7B,sBAAO,SAAS,sBAAO,KAAK,MAAM,QAAQ,OAAO,IAAI,CAAC,CAAC;AAAA,QACvD,sBAAO,cAAc,MAAM,sBAAO,IAAI;AAAA,MACxC;AAAA,IACF;AACA,YAAQ,IAAI,MAAM,KAAK;AAAA,EACzB,CAAC;AAEH,QAAM,iBAAiB,CAAC,OAAY,MAA2D;AAC7F,UAAM,YAAY,CAAC,MAAW,SAA0B;AACtD,YAAM,QAAQ,KAAK,MAAM,GAAG;AAC5B,UAAI,MAAM;AACV,iBAAW,KAAK,OAAO;AACrB,YAAI,OAAO,KAAM,QAAO;AACxB,cAAM,IAAI,CAAC;AAAA,MACb;AACA,aAAO;AAAA,IACT;AAEA,QAAI;AACF,YAAM,WAAW,EAAE,QAAQ,MAAM,QAAe,IAAI,MAAM,GAAU;AACpE,YAAM,OAAQ,EAAE,KAA+B,IAAI,CAAC,QAAQ,UAAU,UAAU,GAAG,CAAC;AACpF,YAAM,MAAO,EAAE,IAAY,GAAG,IAAI;AAClC,UAAI,QAAQ,OAAW,QAAO;AAC9B,aAAa,eAAS,QAAQ,GAAG;AAAA,IACnC,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAEA,QAAM,mBAAmB,CACvB,OACA,kBAEA,sBAAO,IAAI,aAAa;AACtB,UAAM,QAAS,kBAAkB,OAAO,EAAE,MAAM;AAEhD,eAAW,CAAC,MAAM,CAAC,KAAK,OAAO,QAAQ,OAAO,OAAO,GAAG;AACtD,YAAM,YAAY;AAClB,YAAM,WAAW,YAAY,EAAE,QAAQ;AACvC,UAAI,aAAa,QAAQ,GAAG;AAC1B;AAAA,MACF;AAEA,UAAI,UAAU,WAAW,CAAC,SAAS,SAAS,SAAS,GAAG;AACtD;AAAA,MACF;AAEA,UAAI,UAAU,eAAe,CAAC,SAAS,SAAS,aAAa,GAAG;AAC9D;AAAA,MACF;AAEA,YAAM,UAAU,eAAe,OAAO,CAAC;AACvC,YAAM,WAAW,OAAO,UAAU,SAAS;AAC3C,YAAM,kBAAkB,mBAAmB,QAAQ;AACnD,YAAM,iBAAiB,kBAAkB,QAAQ;AAGjD,UAAI,YAAY,QAAW;AACzB,oBAAY,IAAI,WAAW,MAAS;AACpC;AAAA,MACF;AAGA,YAAM,OAAO,YAAY,IAAI,SAAS;AACtC,UAAI,kBAAkB,mBAAmB,UAAU,oBAAoB,WAAW,SAAS,SAAS;AAClG;AAAA,MACF;AAGA,UAAI,kBAAkB,mBAAmB,UAAU,oBAAoB,SAAS;AAC9E,oBAAY,IAAI,WAAW,OAAO;AAClC;AAAA,MACF;AAEA,kBAAY,IAAI,WAAW,OAAO;AAIlC,YAAM,WAAW,OAAO,sBAAsB,WAAW,GAAG,OAAO;AACnE,UAAI,UAAU;AACZ,eAAO,cAAc,SAAS;AAC9B;AAAA,MACF;AAEA,YAAM,aAAa,EAAE,cAAc;AACnC,UAAI,UAAU,eAAe,aAAa,GAAG;AAC3C,eAAO,kBAAkB,WAAW,UAAU;AAAA,MAChD,OAAO;AAEL,eAAO,cAAc,SAAS;AAC9B,eAAO,QAAQ,SAAS;AAAA,MAC1B;AAAA,IACF;AAAA,EACF,CAAC;AAEH,QAAM,aAAa,CAAC,YAClB,sBAAO;AAAA,IAAQ,OAAO,KAAK,OAAO,OAAO;AAAA,IAAG,CAAC,SAC3C,cAAc,IAAI,EAAE,KAAK,sBAAO,SAAS,QAAQ,MAAmB,OAAO,CAAC,CAAC;AAAA,EAC/E,EAAE,KAAK,sBAAO,MAAM;AAEtB,QAAM,QAAQ,EAAE,UAAU,QAAQ,iBAAiB,OAAO,CAAC;AAE3D,QAAM,MAAM,sBAAO;AAAA,IAAQ,MACzB,sBAAO;AAAA,MACL;AAAA;AAAA,QAEE,EAAE,SAAS,WAAW,EAAE;AAAA,UAAQ,CAAC,WAC/B,sBAAO,IAAI,aAAa;AACtB,kBAAM,QAAS,OAAO,EAAE,MAAM;AAC9B,kBAAM,OAAO,EAAE,GAAG,OAAO,QAAQ,OAAO,QAAQ;AAChD,mBAAO,iBAAiB,aAAa,IAAI;AAAA,UAC3C,CAAC;AAAA,QACH;AAAA,QACA,EAAE,SAAS,OAAO,EAAE;AAAA,UAAQ,CAAC,WAC3B,sBAAO,IAAI,aAAa;AACtB,kBAAM,QAAS,OAAO,EAAE,MAAM;AAC9B,kBAAM,OAAO,EAAE,GAAG,OAAO,IAAI,OAAO,QAAQ;AAC5C,mBAAO,iBAAiB,aAAa,IAAI;AAAA,UAC3C,CAAC;AAAA,QACH;AAAA;AAAA,QAGA,EAAE,SAAS,SAAS,EAAE;AAAA,UAAQ,CAAC,WAC7B,sBAAO,IAAI,aAAa;AACtB,kBAAM,SAAS,OAAO;AACtB,gBAAI,OAAO,WAAW,YAAY,OAAO,SAAS,GAAG;AACnD,qBAAO,cAAc,MAAM;AAC3B,qBAAO,QAAQ,QAAQ,EAAE,OAAO,KAAK,CAAC;AAAA,YACxC,OAAO;AACL,qBAAO,WAAW,EAAE,OAAO,KAAK,CAAC;AAAA,YACnC;AAAA,UACF,CAAC;AAAA,QACH;AAAA,MACF;AAAA,MACA,EAAE,aAAa,YAAY;AAAA,IAC7B,EAAE,KAAK,sBAAO,MAAM;AAAA,EACtB;AAEA,SAAO,EAAE,OAAO,IAAI;AACtB,CAAC;;;AGzOH,IAAAC,SAAuB;AACvB,IAAAC,iBAAuB;AAQvB,IAAM,sBAAsB,CAC1B,SACA,YAC0E;AAC1E,MAAI,QAAQ,SAAS,cAAc;AACjC,WAAO,OAAO,QAAQ,OAAO,EAC1B,OAAO,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,OAAO,QAAQ,UAAU,EACtD,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,YAAY,EAAE,SAAS,GAAG,EAAE;AAAA,EAC7D;AAEA,MAAI,QAAQ,SAAS,YAAY;AAC/B,WAAO,OAAO,QAAQ,OAAO,EAC1B,OAAO,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,OAAO,QAAQ,UAAU,EACtD,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,YAAY,EAAE,SAAS,GAAG,EAAE;AAAA,EAC7D;AAGA,QAAM,UAAU,OAAO,QAAQ,OAAO;AACtC,QAAM,SAAS,QAAQ,OAAO,CAAC,CAAC,EAAE,CAAC,MAAM,MAAM,QAAQ,EAAE,IAAI,KAAK,EAAE,KAAK,SAAS,QAAQ,GAAG,CAAC;AAC9F,QAAM,WAAW,OAAO,SAAS,IAAI,SAAS;AAC9C,SAAO,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,YAAY,EAAE,SAAS,GAAG,EAAE;AAC1E;AAEO,IAAM,aAAa,CACxBC,SACA,WAEAA,QAAO;AAAA,EAAM,CAAC,MACZ,sBAAO,IAAI,aAAa;AACtB,WAAO,EAAE,SAAS,YAAY,EAAE;AAAA,MAAQ,CAAC,WACvC,sBAAO,IAAI,aAAa;AACtB,cAAM,UAAU,OAAO;AAGvB,eAAa,sBAAe,cAAc,GAAU;AAAA,UAClD,MAAM;AAAA,UACN;AAAA,QACF,CAAC;AAGD,cAAM,YAAY,OAAO,sBAAO,cAAc,MAAM;AACpD,YAAI,UAAU,SAAS,QAAQ;AAC7B,iBAAO,UAAU,MAAM,WAAW,OAAO;AAAA,QAC3C;AAGA,cAAM,UAAU,oBAAkC,SAAS,OAAO,OAAO;AACzE,cAAM,eAAe,CAAC,SAAyB,WAAW,IAAI;AAC9D,eAAO,sBAAO;AAAA,UACZ;AAAA,UACA,CAAC,MACC,EAAE,OAAO,OAAO,QAAQ,aAAa,EAAE,IAAI,GAAU,EAAE,OAAO,KAAK,CAAC;AAAA,QACxE,EAAE,KAAK,sBAAO,MAAM;AAAA,MACtB,CAAC;AAAA,IACH;AAAA,EACF,CAAC;AACH;;;ACjEF,IAAAC,SAAuB;AA+GhB,IAAM,mBAAmB,CAC9B,UACyC;AACzC,QAAM,MAAkE,CAAC;AAEzE,aAAW,CAAC,MAAM,CAAC,KAAK,OAAO,QAAQ,MAAM,OAAO,GAAG;AACrD,UAAM,WAAW,EAAE,YAAa,CAAC,WAAW,aAAa;AAGzD,QAAI,SAAS,SAAS,QAAQ,KAAK,SAAS,SAAS,GAAG;AACtD,YAAM,IAAI;AAAA,QACR,gEAAgE,SAAS,KAAK,IAAI,CAAC,gBAAgB,IAAI;AAAA,MACzG;AAAA,IACF;AAEA,QAAI,WAAW,IAAI,EAAE,IAAU,kBAAW,OAAO;AAAA;AAAA,MAE/C,MAAM,EAAE;AAAA,MACR,UAAU,EAAE,SAAS;AAAA,MACrB;AAAA,MACA,YAAY,EAAE;AAAA,MACd,aAAa,EAAE,gBAAgB,YAAY,qBAAqB,EAAE;AAAA,MAClE,KAAK,IAAI,eAAoC,EAAE,IAAY,GAAG,UAAU;AAAA,MACxE,MAAM,EAAE;AAAA,IACV,CAAC;AAAA,EACH;AAEA,SAAO;AACT;;;ALzBA,IAAM,0BAA0B,sBAAO;AAAA,EACrC,sBAAO,OAAO;AAAA,IACZ,MAAM,sBAAO,QAAQ,YAAY;AAAA,IACjC,YAAY,sBAAO;AAAA,EACrB,CAAC;AAAA,EACD,sBAAO,OAAO;AAAA,IACZ,MAAM,sBAAO,QAAQ,UAAU;AAAA,IAC/B,YAAY,sBAAO;AAAA,IACnB,SAAS,sBAAO;AAAA,EAClB,CAAC;AAAA,EACD,sBAAO,OAAO;AAAA,IACZ,MAAM,sBAAO,QAAQ,OAAO;AAAA,IAC5B,KAAK,sBAAO;AAAA,EACd,CAAC;AACH;AAEA,IAAM,kBAAkB,CAAC,SAAuB;AAC9C,MAAI,CAAC,MAAM;AACT,UAAM,IAAI,MAAM,2CAA2C;AAAA,EAC7D;AACA,MAAI,KAAK,SAAS,GAAG,GAAG;AACtB,UAAM,IAAI,MAAM,sDAAsD,IAAI,GAAG;AAAA,EAC/E;AACA,MAAI,SAAS,YAAY,SAAS,QAAQ,SAAS,WAAW;AAC5D,UAAM,IAAI,MAAM,4BAA4B,IAAI,eAAe;AAAA,EACjE;AACF;AAEO,IAAM,OAAO,CAMlB,IACA,WACqE;AAErE,QAAM,eAA2C;AAAA,IAC/C,QAAQ,CAAC,MAAW;AAAA,EACtB;AAEC,QAAM,WAAW,MAAe;AAC9B,UAAM,MAAM,OAAO;AACnB,QAAI,CAAC,IAAK,QAAO,CAAC;AAClB,WAAO,IAAI,YAAY;AAAA,EACzB,GAAG;AAEJ,QAAM,mBAAiF;AACvF,aAAW,QAAQ,OAAO,KAAK,OAAO,GAAG;AACvC,oBAAgB,IAAI;AAAA,EACtB;AAEC,QAAM,uBAAuB,MAAM;AACjC,UAAM,QAAQ,OAAO,KAAK,OAAO;AACjC,QAAI,MAAM,WAAW,EAAG,QAAO,sBAAO;AACtC,QAAI,MAAM,WAAW,GAAG;AACtB,aAAO,sBAAO,QAAQ,MAAM,CAAC,CAAQ;AAAA,IACvC;AACD,UAAM,iBAAiB,CAAI,UAA0D;AACnF,UAAI,MAAM,SAAS,GAAG;AACpB,cAAM,IAAI,MAAM,wEAAwE;AAAA,MAC1F;AACA,aAAO;AAAA,IACT;AAEC,UAAM,UAAU,MAAM,IAAI,CAAC,MAAM,sBAAO,QAAQ,CAAQ,CAAC;AACzD,WAAO,sBAAO,MAAM,GAAG,eAAe,OAAO,CAAC;AAAA,EAChD,GAAG;AAEJ,QAAM,WAAW,sBAAO;AAEvB,QAAM,gBAAgB,sBAAO;AAAA,IAC3B,OAAO,YAAa,OAAO,KAAK,OAAO,EAA2B,IAAI,CAAC,MAAM,CAAC,GAAG,sBAAO,OAAO,CAAC,CAAC;AAAA,EAInG;AAED,QAAM,cAAc,sBAAO,OAAO;AAAA,IAChC,QAAQ,OAAO;AAAA,IACf,IAAI;AAAA,IACJ,SAAS;AAAA,EACX,CAAC;AAED,QAAM,UAAU;AAAA,IACd,WAAW,OAAO;AAAA,IAClB,OAAO;AAAA,IACP,SAAS,sBAAO,YAAY,mBAAmB;AAAA,IAC/C,YAAY;AAAA,EACd;AAIA,QAAM,WAAqB;AAAA,IACzB,WAAW,CAAC,OAAO,QAAQ,SAAS;AAClC,aAAO,QAAQ;AACf,aAAO,EAAE,GAAG,OAAO,QAAQ,OAAO,WAAW,MAAM,OAAO;AAAA,IAC5D;AAAA,IACA,OAAO,CAAC,OAAO,QAAQ,SAAS;AAC9B,aAAO,IAAI;AACX,aAAO,EAAE,GAAG,OAAO,IAAI,OAAO,WAAW,MAAM,GAAG;AAAA,IACpD;AAAA,IACA,SAAS,CAAC,UAAU;AAAA,IACpB,YAAY,CAAC,UAAU;AAAA,EACzB;AAEA,QAAM,cACJ,OAAO,KAAK,gBAAgB,EAAE,SAAS,IAAI,iBAA+B,EAAE,SAAS,iBAAiB,CAAC,IAAI;AAE7G,QAAM,SACJ,eAAe,OAAO,SACjB;AAAA,IACC,GAAI;AAAA,IACJ,GAAI,OAAO;AAAA,EACb,IACA;AAEN,QAAMC,UAAe,cAAO,KAAK,IAAI;AAAA,IACnC,OAAO;AAAA,IACP,SAAS;AAAA,IACT;AAAA,IACA;AAAA,EACF,CAAC;AAED,QAAM,SAAS;AAAA,IACb,YAA+BA,QAAO,KAAY,EAAE,SAAS,iBAAiB,CAAC;AAAA,IAC/E,WAA8BA,QAAO,KAAY,EAAE,SAAS,iBAAiB,CAAC;AAAA,EAChF;AAEA,QAAM,UAAU,CAAC,YACd;AAAA,IACC,QAAQ,UAAU,OAAO;AAAA,IACzB,IAAK,OAAO,MAAO,CAAC;AAAA,IACpB,SAAS,OAAO;AAAA,MACb,OAAO,KAAK,OAAO,EAA2B,IAAI,CAAC,MAAM,CAAC,GAAS,gBAAS,SAAS,KAAK,CAAC,CAAC;AAAA,IAC/F;AAAA,EACF;AAED,QAAM,aAA2D;AAAA,IAC/D,MAAM,CACJ,YAC2C;AAC3C,YAAM,WAAW,QAAQ;AACzB,YAAM,UAAUA,QAAO;AAMtB,aAAO;AAAA,QACL;AAAA,QACA,UAAU,QAAQ;AAAA,QAClB;AAAA,QACD,YAAY;AAAA,UACV,WAAW,CAAC,WAAoB,SAAS,QAAQ,UAAU,MAAM,CAAC;AAAA,UAClE,OAAO,CAAC,OAAY,SAAS,QAAQ,MAAM,EAAE,CAAC;AAAA,UAC9C,SAAS,CAAC,WAAgC,SAAS,QAAQ,QAAQ,MAAM,CAAC;AAAA,UACzE,YAAY,CAAC,YAA+B,SAAS,QAAQ,WAAW,OAAO,CAAC;AAAA,QAClF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAED,EAACA,QAAe,aAAa;AAE9B,QAAM,gBAAgB,uBAAO,IAAI,4BAA4B;AAC5D,EAACA,QAAO,IAAY,aAAa,IAAI,CACpC,SACA,SACG;AACH,UAAM,IAAI,WAAW,KAAK,OAAO;AACjC,WAAO;AAAA,MACL,GAAG;AAAA,MACH,YAAY,EAAE;AAAA,IAChB;AAAA,EACF;AAEA,SAAOA,QAAO,UAAU;AAAA,IACtB,SAAS,QAAQ;AAAA,IACjB,QAAQ,CAAC,GAAG,MAAM;AAAA,EACpB,CAAC;AACH;","names":["Logix","import_effect","import_effect","import_effect","module","Logix","import_effect","module","Logix","module"]}
+{"version":3,"sources":["../src/Query.ts","../src/internal/logics/auto-trigger.ts","../src/Engine.ts","../src/internal/middleware/middleware.ts","../src/internal/logics/invalidate.ts","../src/Traits.ts"],"sourcesContent":["import * as Logix from '@logixjs/core'\nimport { Effect, Schema } from 'effect'\nimport { autoTrigger } from './internal/logics/auto-trigger.js'\nimport { invalidate } from './internal/logics/invalidate.js'\nimport type { InvalidateRequest } from './Engine.js'\nimport { toStateTraitSpec, type QueryBuilder, type QuerySourceConfig, type QueryResourceData, type QueryResourceError } from './Traits.js'\n\ntype AnyQuerySourceConfig<TParams, TUI> = QuerySourceConfig<TParams, TUI, any, any>\n\ntype EnsureQueries<TParams, TUI, TQueries> = TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>>\n  ? {}\n  : {\n      readonly __queries_must_be_QuerySourceConfig__: never\n    }\n\ntype QueriesOf<TParams, TUI, TQueries> = TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> ? TQueries : never\n\nexport type QueryState<\n  TParams,\n  TUI = unknown,\n  TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {},\n> = {\n  readonly params: TParams\n  readonly ui: TUI\n  readonly queries: {\n    readonly [K in keyof TQueries]: Logix.Resource.ResourceSnapshot<\n      QueryResourceData<TQueries[K]['resource']>,\n      QueryResourceError<TQueries[K]['resource']>\n    >\n  }\n}\n\nexport type QueryName<TQueries extends Record<string, any>> = Extract<keyof TQueries, string>\n\ntype ForbiddenQueryName = 'params' | 'ui' | 'queries'\ntype ForbidQueryNames = {\n  readonly [K in ForbiddenQueryName]?: never\n}\n\nexport type QueryActions<TParams, TUI = unknown, TQueries extends Record<string, any> = {}> = {\n  readonly setParams: Schema.Schema<TParams>\n  readonly setUi: Schema.Schema<TUI>\n  readonly refresh: Schema.Schema<QueryName<TQueries> | undefined>\n  readonly invalidate: Schema.Schema<InvalidateRequest>\n}\n\nexport type QueryShape<\n  TParams,\n  TUI = unknown,\n  TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {},\n> = Logix.Shape<Schema.Schema<QueryState<TParams, TUI, TQueries>>, QueryActions<TParams, TUI, TQueries>>\n\nexport type QueryAction<\n  TParams,\n  TUI = unknown,\n  TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {},\n> = Logix.ActionOf<QueryShape<TParams, TUI, TQueries>>\n\nexport interface QueryMakeConfig<\n  TParams,\n  TUI = unknown,\n  TQueries = {},\n> {\n  readonly params: Schema.Schema<TParams>\n  readonly initialParams: TParams\n  readonly ui?: TUI\n  readonly queries?: (q: QueryBuilder<TParams, TUI>) => TQueries & ForbidQueryNames\n  readonly traits?: unknown\n}\n\nexport interface QueryController<\n  TParams,\n  TUI = unknown,\n  TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {},\n> {\n  readonly runtime: Logix.ModuleRuntime<QueryState<TParams, TUI, TQueries>, QueryAction<TParams, TUI, TQueries>>\n  readonly getState: Effect.Effect<QueryState<TParams, TUI, TQueries>>\n  readonly dispatch: (action: QueryAction<TParams, TUI, TQueries>) => Effect.Effect<void>\n\n  readonly controller: {\n    readonly setParams: (params: TParams) => Effect.Effect<void>\n    readonly setUi: (ui: TUI) => Effect.Effect<void>\n    readonly refresh: (target?: QueryName<TQueries>) => Effect.Effect<void>\n    readonly invalidate: (request: InvalidateRequest) => Effect.Effect<void>\n  }\n}\n\nexport type QueryModuleController<\n  TParams,\n  TUI = unknown,\n  TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {},\n> = {\n  readonly make: (\n    runtime: Logix.ModuleRuntime<QueryState<TParams, TUI, TQueries>, QueryAction<TParams, TUI, TQueries>>,\n  ) => QueryController<TParams, TUI, TQueries>\n}\n\nexport type QueryHandleExt<\n  TParams,\n  TUI = unknown,\n  TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {},\n> = {\n  readonly controller: QueryController<TParams, TUI, TQueries>['controller']\n}\n\nexport type QueryModule<\n  Id extends string,\n  TParams,\n  TUI = unknown,\n  TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {},\n> = Logix.Module.Module<Id, QueryShape<TParams, TUI, TQueries>, QueryHandleExt<TParams, TUI, TQueries>, any> & {\n  readonly controller: QueryModuleController<TParams, TUI, TQueries>\n}\n\nconst InvalidateRequestSchema = Schema.Union([\n  Schema.Struct({\n    kind: Schema.Literal('byResource'),\n    resourceId: Schema.String,\n  }),\n  Schema.Struct({\n    kind: Schema.Literal('byParams'),\n    resourceId: Schema.String,\n    keyHash: Schema.String,\n  }),\n  Schema.Struct({\n    kind: Schema.Literal('byTag'),\n    tag: Schema.String,\n  }),\n]) as Schema.Schema<InvalidateRequest>\n\nconst assertQueryName = (name: string): void => {\n  if (!name) {\n    throw new Error(`[Query.make] query name must be non-empty`)\n  }\n  if (name.includes('.')) {\n    throw new Error(`[Query.make] query name must not include \".\"; got \"${name}\"`)\n  }\n  if (name === 'params' || name === 'ui' || name === 'queries') {\n    throw new Error(`[Query.make] query name \"${name}\" is reserved`)\n  }\n}\n\n\nconst buildRefreshTargetSchema = <TQueries extends Record<string, AnyQuerySourceConfig<any, any>>>(\n  names: ReadonlyArray<QueryName<TQueries>>,\n): Schema.Schema<QueryName<TQueries>> => {\n  if (names.length === 0) {\n    return Schema.Never as unknown as Schema.Schema<QueryName<TQueries>>\n  }\n\n  return Schema.Literals(names as [QueryName<TQueries>, ...Array<QueryName<TQueries>>]) as unknown as Schema.Schema<QueryName<TQueries>>\n}\n\nconst buildQueriesSchema = <TQueries extends Record<string, AnyQuerySourceConfig<any, any>>>(queries: TQueries) =>\n  Schema.Struct(\n    Object.fromEntries((Object.keys(queries) as Array<keyof TQueries>).map((key) => [key, Schema.Unknown])) as Record<\n      string,\n      Schema.Schema<any>\n    >,\n  )\n\nexport const make = <\n  Id extends string,\n  TParams,\n  TUI = unknown,\n  const TQueries = {},\n>(\n  id: Id,\n  config: QueryMakeConfig<TParams, TUI, TQueries> & EnsureQueries<TParams, TUI, TQueries>,\n): QueryModule<Id, TParams, TUI, QueriesOf<TParams, TUI, TQueries>> => {\n  type Queries = QueriesOf<TParams, TUI, TQueries>\n\n  const queryBuilder: QueryBuilder<TParams, TUI> = {\n    source: (q: any) => q,\n  }\n\n  const queries = ((): Queries => {\n    const raw = config.queries\n    if (!raw) return {} as Queries\n    return raw(queryBuilder) as Queries\n  })()\n\n  const queriesForTraits: Readonly<Record<string, AnyQuerySourceConfig<TParams, TUI>>> = queries\n  const queryNames = Object.keys(queries) as Array<QueryName<Queries>>\n  for (const name of queryNames) {\n    assertQueryName(name)\n  }\n\n  const RefreshTargetSchema = buildRefreshTargetSchema<Queries>(queryNames)\n\n  const UiSchema = Schema.Unknown as Schema.Schema<TUI>\n\n  const QueriesSchema = buildQueriesSchema<Queries>(queries)\n\n  const StateSchema = Schema.Struct({\n    params: config.params,\n    ui: UiSchema,\n    queries: QueriesSchema,\n  }) as unknown as Schema.Schema<QueryState<TParams, TUI, Queries>>\n\n  const Actions = {\n    setParams: config.params,\n    setUi: UiSchema,\n    refresh: Schema.UndefinedOr(RefreshTargetSchema),\n    invalidate: InvalidateRequestSchema,\n  } satisfies QueryActions<TParams, TUI, Queries>\n\n  type Reducers = Logix.ReducersFromMap<typeof StateSchema, typeof Actions>\n\n  const reducers: Reducers = {\n    setParams: (state, action, sink) => {\n      sink?.('params')\n      return { ...state, params: action.payload ?? state.params }\n    },\n    setUi: (state, action, sink) => {\n      sink?.('ui')\n      return { ...state, ui: action.payload ?? state.ui }\n    },\n    refresh: (state) => state,\n    invalidate: (state) => state,\n  } satisfies Reducers\n\n  const queryTraits =\n    Object.keys(queriesForTraits).length > 0 ? toStateTraitSpec<TParams, TUI>({ queries: queriesForTraits }) : undefined\n\n  const traits =\n    queryTraits || config.traits\n      ? ({\n          ...(queryTraits as any),\n          ...(config.traits as any),\n        } as any)\n      : undefined\n\n  const module = Logix.Module.make(id, {\n    state: StateSchema,\n    actions: Actions,\n    reducers,\n    traits,\n  })\n\n  const logics = [\n    autoTrigger<any, TParams, TUI>(module.tag as any, { queries: queriesForTraits }),\n    invalidate<any, TParams, TUI>(module.tag as any, { queries: queriesForTraits }),\n  ] satisfies ReadonlyArray<Logix.ModuleLogic<any, any, any>>\n\n  const initial = (params?: TParams): QueryState<TParams, TUI, Queries> =>\n    ({\n      params: params ?? config.initialParams,\n      ui: (config.ui ?? ({} as unknown as TUI)) as TUI,\n      queries: Object.fromEntries((Object.keys(queries) as Array<keyof Queries>).map((key) => [key, Logix.Resource.Snapshot.idle()])),\n    }) as QueryState<TParams, TUI, Queries>\n\n  const controller: QueryModuleController<TParams, TUI, Queries> = {\n    make: (\n      runtime: Logix.ModuleRuntime<QueryState<TParams, TUI, Queries>, QueryAction<TParams, TUI, Queries>>,\n    ): QueryController<TParams, TUI, Queries> => {\n      const dispatch = runtime.dispatch\n      const actions = module.actions as unknown as {\n        readonly setParams: (params: TParams) => QueryAction<TParams, TUI, Queries>\n        readonly setUi: (ui: TUI) => QueryAction<TParams, TUI, Queries>\n        readonly refresh: (target: QueryName<Queries> | undefined) => QueryAction<TParams, TUI, Queries>\n        readonly invalidate: (request: InvalidateRequest) => QueryAction<TParams, TUI, Queries>\n      }\n\n      return {\n        runtime,\n        getState: runtime.getState as Effect.Effect<QueryState<TParams, TUI, Queries>>,\n        dispatch,\n        controller: {\n          setParams: (params: TParams) => dispatch(actions.setParams(params)),\n          setUi: (ui: TUI) => dispatch(actions.setUi(ui)),\n          refresh: (target?: QueryName<Queries>) => dispatch(actions.refresh(target)),\n          invalidate: (request: InvalidateRequest) => dispatch(actions.invalidate(request)),\n        },\n      } as QueryController<TParams, TUI, Queries>\n    },\n  }\n\n  ;(module as any).controller = controller\n\n  const EXTEND_HANDLE = Symbol.for('logix.module.handle.extend')\n  ;(module.tag as any)[EXTEND_HANDLE] = (\n    runtime: Logix.ModuleRuntime<QueryState<TParams, TUI, Queries>, QueryAction<TParams, TUI, Queries>>,\n    base: Logix.ModuleHandle<any>,\n  ) => {\n    const c = controller.make(runtime)\n    return {\n      ...base,\n      controller: c.controller,\n    }\n  }\n\n  return module.implement({\n    initial: initial(),\n    logics: [...logics],\n  }) as unknown as QueryModule<Id, TParams, TUI, Queries>\n}\n","import * as Logix from '@logixjs/core'\nimport { Duration, Effect, Fiber, ServiceMap } from 'effect'\nimport type { QuerySourceConfig, QueryTrigger } from '../../Traits.js'\nimport { Engine } from '../../Engine.js'\n\nconst defaultTriggers = ['onMount', 'onKeyChange'] as const\n\nconst getTriggers = (triggers: ReadonlyArray<QueryTrigger> | undefined): ReadonlyArray<QueryTrigger> =>\n  triggers ?? defaultTriggers\n\nconst isManualOnly = (triggers: ReadonlyArray<QueryTrigger>): boolean =>\n  triggers.length === 1 && triggers[0] === 'manual'\n\nconst getSnapshotKeyHash = (snapshot: unknown): string | undefined => {\n  if (!snapshot || typeof snapshot !== 'object') return undefined\n  const keyHash = (snapshot as any).keyHash\n  return typeof keyHash === 'string' ? keyHash : undefined\n}\n\nconst getSnapshotStatus = (snapshot: unknown): string | undefined => {\n  if (!snapshot || typeof snapshot !== 'object') return undefined\n  const status = (snapshot as any).status\n  return typeof status === 'string' ? status : undefined\n}\n\nexport interface AutoTriggerLogicConfig<TParams, TUI> {\n  readonly queries: Readonly<Record<string, QuerySourceConfig<TParams, TUI>>>\n}\n\n/**\n * Query auto-trigger logic:\n * - onMount: triggers once on initialization (if the key is valid and current snapshot does not match the same keyHash).\n * - onKeyChange: triggers after params/ui state changes (can debounce; only when keyHash changes or current is idle).\n * - manual-only: when triggers=[\"manual\"], disable onMount/onKeyChange auto triggering.\n */\nexport const autoTrigger = <Sh extends Logix.AnyModuleShape, TParams, TUI>(\n  module: Logix.ModuleTagType<any, Sh>,\n  config: AutoTriggerLogicConfig<TParams, TUI>,\n): Logix.ModuleLogic<Sh, any, never> =>\n  module.logic(($) => {\n    type _State = Logix.StateOf<Sh> & { readonly queries: Record<string, unknown> }\n    type QueryName = Extract<keyof typeof config.queries, string>\n\n    const pending = new Map<string, Fiber.Fiber<void, any>>()\n    const lastKeyHash = new Map<string, string | undefined>()\n\n    const hydrateFromFreshCache = (\n      name: QueryName,\n      q: QuerySourceConfig<TParams, TUI>,\n      keyHash: string,\n    ): Effect.Effect<boolean, never, any> =>\n      Effect.gen(function* () {\n        const engineOpt = yield* Effect.serviceOption(Engine as unknown as ServiceMap.Key<any, import('../../Engine.js').Engine>)\n        if (engineOpt._tag === 'None') return false\n\n        const engine = engineOpt.value\n        if (!engine.peekFresh) return false\n\n        const dataOpt = yield* engine.peekFresh({\n          resourceId: q.resource.id,\n          keyHash,\n        })\n        if (dataOpt._tag === 'None') return false\n\n        const snapshot = Logix.Resource.Snapshot.success({\n          keyHash,\n          data: dataOpt.value,\n        })\n        yield* $.state.mutate((draft) => {\n          ;(draft as Logix.Logic.Draft<_State>).queries[name] = snapshot\n        })\n\n        return true\n      })\n\n    const cancelPending = (name: string): Effect.Effect<void, never, any> =>\n      Effect.gen(function* () {\n        const prev = pending.get(name)\n        if (!prev) return\n        pending.delete(name)\n        yield* Fiber.interrupt(prev)\n      })\n\n    const sourcePathOf = (name: QueryName): string => `queries.${name}`\n\n    const refresh = (name: QueryName, options?: { readonly force?: boolean }): Effect.Effect<void, never, any> =>\n      $.traits.source.refresh(sourcePathOf(name) as any, options as any) as Effect.Effect<void, never, any>\n\n    const scheduleDebounced = (name: QueryName, ms: number): Effect.Effect<void, never, any> =>\n      Effect.gen(function* () {\n        yield* cancelPending(name)\n          const fiber = yield* Effect.forkScoped(\n            Effect.sleep(Duration.millis(ms)).pipe(\n              Effect.flatMap(() => refresh(name)),\n              Effect.ensuring(Effect.sync(() => pending.delete(name))),\n              Effect.catchCause(() => Effect.void),\n            ),\n          )\n        pending.set(name, fiber)\n      })\n\n    const computeKeyHash = (state: any, q: QuerySourceConfig<TParams, TUI>): string | undefined => {\n      const getAtPath = (root: any, path: string): unknown => {\n        const parts = path.split('.')\n        let cur = root\n        for (const p of parts) {\n          if (cur == null) return undefined\n          cur = cur[p]\n        }\n        return cur\n      }\n\n      try {\n        const keyState = { params: state.params as any, ui: state.ui as any } as any\n        const args = (q.deps as ReadonlyArray<string>).map((dep) => getAtPath(keyState, dep))\n        const key = (q.key as any)(...args)\n        if (key === undefined) return undefined\n        return Logix.Resource.keyHash(key)\n      } catch {\n        return undefined\n      }\n    }\n\n    const maybeAutoRefresh = (\n      phase: 'mount' | 'keyChange',\n      stateOverride?: unknown,\n    ): Effect.Effect<void, never, any> =>\n      Effect.gen(function* () {\n        const state = (stateOverride ?? (yield* $.state.read)) as any\n\n        for (const [name, q] of Object.entries(config.queries)) {\n          const queryName = name as QueryName\n          const triggers = getTriggers(q.triggers)\n          if (isManualOnly(triggers)) {\n            continue\n          }\n\n          if (phase === 'mount' && !triggers.includes('onMount')) {\n            continue\n          }\n\n          if (phase === 'keyChange' && !triggers.includes('onKeyChange')) {\n            continue\n          }\n\n          const keyHash = computeKeyHash(state, q)\n          const snapshot = state?.queries?.[queryName]\n          const snapshotKeyHash = getSnapshotKeyHash(snapshot)\n          const snapshotStatus = getSnapshotStatus(snapshot)\n\n          // Key is unavailable: do not refresh (idle reaping is guaranteed by kernel syncIdleInTransaction).\n          if (keyHash === undefined) {\n            lastKeyHash.set(queryName, undefined)\n            continue\n          }\n\n          // keyHash unchanged and we already have a non-idle snapshot: avoid re-entering loading (reuse existing result).\n          const last = lastKeyHash.get(queryName)\n          if (snapshotStatus && snapshotStatus !== 'idle' && snapshotKeyHash === keyHash && last === keyHash) {\n            continue\n          }\n\n          // If current snapshot is already success/error/loading with the same keyHash: update lastKeyHash and skip.\n          if (snapshotStatus && snapshotStatus !== 'idle' && snapshotKeyHash === keyHash) {\n            lastKeyHash.set(queryName, keyHash)\n            continue\n          }\n\n          lastKeyHash.set(queryName, keyHash)\n\n          // TanStack Query scenario: if we can hit the fresh cache, write a success snapshot directly,\n          // skipping source.refresh (avoids UI jitter and extra transactions like \"cache hit but still loading -> success\").\n          const hydrated = yield* hydrateFromFreshCache(queryName, q, keyHash)\n          if (hydrated) {\n            yield* cancelPending(queryName)\n            continue\n          }\n\n          const debounceMs = q.debounceMs ?? 0\n          if (phase === 'keyChange' && debounceMs > 0) {\n            yield* scheduleDebounced(queryName, debounceMs)\n          } else {\n            // mount / no debounce: trigger immediately\n            yield* cancelPending(queryName)\n            yield* refresh(queryName)\n          }\n        }\n      })\n\n    const refreshAll = (options?: { readonly force?: boolean }): Effect.Effect<void, never, any> =>\n      Effect.forEach(Object.keys(config.queries), (name) =>\n        cancelPending(name).pipe(Effect.flatMap(() => refresh(name as QueryName, options))),\n      ).pipe(Effect.asVoid)\n\n    const setup = $.lifecycle.onStart(maybeAutoRefresh('mount'))\n\n    const run = Effect.suspend(() =>\n      Effect.all(\n        [\n          // params/ui changes: handled by Query's default logic, avoiding scattered UI-side useEffect triggers.\n          // Keep params/ui-driven auto refresh aligned with action stream order.\n          // `source.refresh` already forks IO internally, so the watcher itself can stay ordered.\n          $.onAction('setParams').run((action: any) =>\n            Effect.gen(function* () {\n              const state = (yield* $.state.read) as any\n              const next = { ...state, params: action.payload }\n              yield* maybeAutoRefresh('keyChange', next)\n            }),\n          ),\n          $.onAction('setUi').run((action: any) =>\n            Effect.gen(function* () {\n              const state = (yield* $.state.read) as any\n              const next = { ...state, ui: action.payload }\n              yield* maybeAutoRefresh('keyChange', next)\n            }),\n          ),\n\n          // Manual refresh: not restricted by triggers (manual-only still allows explicit refresh).\n          $.onAction('refresh').runFork((action: any) =>\n            Effect.gen(function* () {\n              const target = action.payload as QueryName | undefined\n              if (typeof target === 'string' && target.length > 0) {\n                yield* cancelPending(target)\n                yield* refresh(target, { force: true })\n              } else {\n                yield* refreshAll({ force: true })\n              }\n            }),\n          ),\n        ],\n        { concurrency: 'unbounded' },\n      ).pipe(Effect.asVoid),\n    )\n\n    return { setup, run }\n  }) as Logix.ModuleLogic<Sh, any, never>\n","import type * as EffectOp from '@logixjs/core/EffectOp'\nimport type { JsonValue } from '@logixjs/core/Observability'\nimport { Effect, Layer, Option, ServiceMap } from 'effect'\nimport { middleware as middlewareImpl, type MiddlewareConfig } from './internal/middleware/middleware.js'\n\nexport type InvalidateRequest =\n  | { readonly kind: 'byResource'; readonly resourceId: string }\n  | { readonly kind: 'byParams'; readonly resourceId: string; readonly keyHash: string }\n  | { readonly kind: 'byTag'; readonly tag: string }\n\nexport interface Engine {\n  readonly fetch: <A>(args: {\n    readonly resourceId: string\n    readonly keyHash: string\n    readonly effect: Effect.Effect<A, unknown, any>\n    /**\n     * MUST be serializable and slim; recommended default is undefined (lazy),\n     * and only populate it when diagnostics/devtools require it.\n     */\n    readonly meta?: JsonValue\n  }) => Effect.Effect<A, unknown, any>\n\n  /**\n   * perf: optional fast path to avoid allocations on the hot path.\n   * Semantics must match `fetch({ ... })`.\n   */\n  readonly fetchFast?: <A>(\n    resourceId: string,\n    keyHash: string,\n    effect: Effect.Effect<A, unknown, any>,\n    meta?: JsonValue,\n  ) => Effect.Effect<A, unknown, any>\n\n  readonly invalidate: (request: InvalidateRequest) => Effect.Effect<void, unknown, any>\n\n  /**\n   * Read-only fast path: must not trigger IO; used to short-circuit to success before refresh,\n   * avoiding loading jitter.\n   */\n  readonly peekFresh?: <A>(args: {\n    readonly resourceId: string\n    readonly keyHash: string\n  }) => Effect.Effect<Option.Option<A>, never, any>\n}\n\nclass EngineTagImpl extends ServiceMap.Service<EngineTagImpl, Engine>()('@logixjs/query/Engine') {}\n\nexport const Engine = Object.assign(EngineTagImpl, {\n  layer: (engine: Engine): Layer.Layer<EngineTagImpl, never, never> => Layer.succeed(EngineTagImpl, engine),\n  middleware: (config?: MiddlewareConfig): EffectOp.Middleware => middlewareImpl(config),\n})\n\nexport type { MiddlewareConfig }\n","import type * as EffectOp from '@logixjs/core/EffectOp'\nimport { Effect, Option, ServiceMap } from 'effect'\nimport { Engine } from '../../Engine.js'\nimport type { Engine as EngineService } from '../../Engine.js'\n\nexport interface MiddlewareConfig {\n  /**\n   * Default: only applies to EffectOp that carries resourceId+keyHash (from StateTrait.source).\n   * Optional: further filter by resourceId.\n   */\n  readonly useFor?: (resourceId: string) => boolean\n}\n\n/**\n * Query middleware (EffectOp): external engine takeover point.\n * - Delegates ResourceSpec.load execution to Engine (cache / in-flight dedupe / invalidation, etc.)\n * - Still preserves Logix Runtime's keyHash gating and ResourceSnapshot source-of-truth semantics\n */\nexport const middleware = (config?: MiddlewareConfig): EffectOp.Middleware =>\n  (() => {\n    // perf: within the same Runtime instance, Engine injection is stable.\n    // Cache it in the middleware closure to avoid a Context lookup on every fetch.\n    let cachedEngine: EngineService | undefined\n\n    return (op) => {\n      if ((op.kind !== 'service' && op.kind !== 'trait-source') || !op.meta?.resourceId || !op.meta.keyHash) {\n        return op.effect as any\n      }\n\n      const resourceId = op.meta.resourceId\n      if (config?.useFor && !config.useFor(resourceId)) {\n        return op.effect as any\n      }\n\n      const keyHash = op.meta.keyHash as string\n\n      if (cachedEngine) {\n        if (cachedEngine.fetchFast) {\n          return cachedEngine.fetchFast(resourceId, keyHash, op.effect as any)\n        }\n        return cachedEngine.fetch({ resourceId, keyHash, effect: op.effect as any })\n      }\n\n      return Effect.serviceOption(Engine as unknown as ServiceMap.Key<any, EngineService>).pipe(\n        Effect.flatMap((engineOpt) => {\n          if (Option.isNone(engineOpt)) {\n            return Effect.fail(\n              new Error(\n                `[Query.Engine.middleware] Missing Query.Engine in the Runtime scope; please provide Query.Engine.layer(Query.TanStack.engine(new QueryClient())) (recommended) or Query.Engine.layer(customEngine).`,\n              ),\n            )\n          }\n          cachedEngine = engineOpt.value\n          if (cachedEngine.fetchFast) {\n            return cachedEngine.fetchFast(resourceId, keyHash, op.effect as any)\n          }\n          return cachedEngine.fetch({ resourceId, keyHash, effect: op.effect as any })\n        }),\n      ) as any\n    }\n  })()\n","import * as Logix from '@logixjs/core'\nimport { Effect, ServiceMap } from 'effect'\nimport { Engine, type InvalidateRequest } from '../../Engine.js'\nimport type { QuerySourceConfig } from '../../Traits.js'\n\nexport interface InvalidateLogicConfig<TParams, TUI> {\n  readonly queries: Readonly<Record<string, QuerySourceConfig<TParams, TUI>>>\n}\n\nconst toInvalidateTargets = <TParams, TUI>(\n  request: InvalidateRequest,\n  queries: Readonly<Record<string, QuerySourceConfig<TParams, TUI>>>,\n): ReadonlyArray<{ readonly name: string; readonly resourceId: string }> => {\n  if (request.kind === 'byResource') {\n    return Object.entries(queries)\n      .filter(([, q]) => q.resource.id === request.resourceId)\n      .map(([name, q]) => ({ name, resourceId: q.resource.id }))\n  }\n\n  if (request.kind === 'byParams') {\n    return Object.entries(queries)\n      .filter(([, q]) => q.resource.id === request.resourceId)\n      .map(([name, q]) => ({ name, resourceId: q.resource.id }))\n  }\n\n  // byTag: prefer QuerySourceConfig.tags for static filtering; if tags are missing, conservatively fall back to refreshing all.\n  const entries = Object.entries(queries)\n  const tagged = entries.filter(([, q]) => Array.isArray(q.tags) && q.tags.includes(request.tag))\n  const selected = tagged.length > 0 ? tagged : entries\n  return selected.map(([name, q]) => ({ name, resourceId: q.resource.id }))\n}\n\nexport const invalidate = <Sh extends Logix.AnyModuleShape, TParams, TUI>(\n  module: Logix.ModuleTagType<any, Sh>,\n  config: InvalidateLogicConfig<TParams, TUI>,\n): Logix.ModuleLogic<Sh, any, never> =>\n  module.logic(($) =>\n    Effect.gen(function* () {\n      yield* $.onAction('invalidate').runFork((action: any) =>\n        Effect.gen(function* () {\n          const request = action.payload as InvalidateRequest\n\n          // 1) Eventize: goes into ReplayLog (kernel-owned).\n          yield* Logix.TraitLifecycle.scopedExecute($ as any, {\n            kind: 'query:invalidate',\n            request,\n          })\n\n          // 2) Call external engine (optional): does not block the fallback path.\n          const engineOpt = yield* Effect.serviceOption(Engine as unknown as ServiceMap.Key<any, import('../../Engine.js').Engine>)\n          if (engineOpt._tag !== 'None') {\n            yield* engineOpt.value.invalidate(request)\n          }\n\n          // 3) Immediately refresh related sources (write-back gating is still guaranteed by kernel keyHash).\n          const targets = toInvalidateTargets<TParams, TUI>(request, config.queries)\n          const sourcePathOf = (name: string): string => `queries.${name}`\n          yield* Effect.forEach(\n            targets,\n            (t) =>\n              $.traits.source.refresh(sourcePathOf(t.name) as any, { force: true }) as Effect.Effect<void, never, any>,\n          ).pipe(Effect.asVoid)\n        }),\n      )\n    }),\n  ) as Logix.ModuleLogic<Sh, any, never>\n","import * as Logix from '@logixjs/core'\n\nexport type QueryTrigger = 'onMount' | 'onKeyChange' | 'manual'\n\nexport type QueryConcurrency = 'switch' | 'exhaust'\n\nexport type QueryResourceRef = { readonly id: string }\n\nexport type QueryResource = QueryResourceRef | Logix.Resource.ResourceSpec<any, any, any, any>\n\nexport type QueryResourceKey<R> = R extends Logix.Resource.ResourceSpec<infer Key, any, any, any> ? Key : unknown\n\nexport type QueryResourceData<R> = R extends Logix.Resource.ResourceSpec<any, infer Data, any, any> ? Data : unknown\n\nexport type QueryResourceError<R> = R extends Logix.Resource.ResourceSpec<any, any, infer Err, any> ? Err : unknown\n\nexport type QueryKeyState<TParams, TUI> = Readonly<{\n  readonly params: TParams\n  readonly ui: TUI\n}>\n\nexport type QueryDepsPath<TParams, TUI> = Logix.StateTrait.StateFieldPath<QueryKeyState<TParams, TUI>>\n\ntype DepsArgs<S extends object, Deps extends ReadonlyArray<string>> = {\n  readonly [K in keyof Deps]: Deps[K] extends Logix.StateTrait.StateFieldPath<S>\n    ? Logix.StateTrait.StateAtPath<S, Deps[K]>\n    : any\n}\n\ntype BivariantCallback<Args extends ReadonlyArray<any>, R> = {\n  bivarianceHack(...args: Args): R\n}['bivarianceHack']\n\nexport interface QuerySourceConfig<\n  TParams,\n  TUI = unknown,\n  R extends QueryResource = QueryResource,\n  Deps extends ReadonlyArray<string> = ReadonlyArray<QueryDepsPath<TParams, TUI>>,\n> {\n  readonly resource: R\n  readonly deps: Deps & ReadonlyArray<QueryDepsPath<TParams, TUI>>\n  readonly triggers?: ReadonlyArray<QueryTrigger>\n  /**\n   * Optional exportable trait meta (Devtools / Static IR / docs).\n   *\n   * Constraints:\n   * - Must be serializable (JsonValue only); no closures/functions/Effect/DOM objects.\n   * - Keep it slim; use `annotations` with `x-*` keys for extension hints.\n   */\n  readonly meta?: Logix.StateTrait.TraitMeta\n  /**\n   * Optional static tags for invalidate(byTag), used to narrow byTag from \"refresh all\" to a matched subset.\n   * - Must be serializable (recommend: string constants only)\n   * - If omitted, byTag conservatively falls back to refreshing everything\n   */\n  readonly tags?: ReadonlyArray<string>\n  readonly debounceMs?: number\n  readonly concurrency?: QueryConcurrency\n  readonly key: BivariantCallback<DepsArgs<QueryKeyState<TParams, TUI>, Deps>, QueryResourceKey<R> | undefined>\n}\n\nexport type QueryBuilder<TParams, TUI> = {\n  readonly source: <\n    R extends QueryResource,\n    const Deps extends ReadonlyArray<string> = ReadonlyArray<QueryDepsPath<TParams, TUI>>,\n  >(config: {\n    readonly resource: R\n    readonly deps: Deps & ReadonlyArray<QueryDepsPath<TParams, TUI>>\n    readonly triggers?: ReadonlyArray<QueryTrigger>\n    readonly meta?: Logix.StateTrait.TraitMeta\n    readonly tags?: ReadonlyArray<string>\n    readonly debounceMs?: number\n    readonly concurrency?: QueryConcurrency\n    readonly key: (...depsValues: DepsArgs<QueryKeyState<TParams, TUI>, Deps>) => QueryResourceKey<R> | undefined\n  }) => QuerySourceConfig<TParams, TUI, R, Deps>\n}\n\n/**\n * Query.source:\n * - Strongly typed helper to preserve `deps` as a tuple and infer `key(...depsValues)` argument types from it.\n * - Recommended usage inside `Query.make(..., { queries: { name: Query.source({ ... }) } })`.\n */\nexport const source = <\n  TParams,\n  TUI = unknown,\n  R extends QueryResource = QueryResource,\n  const Deps extends ReadonlyArray<string> = ReadonlyArray<QueryDepsPath<TParams, TUI>>,\n>(config: {\n  readonly resource: R\n  readonly deps: Deps & ReadonlyArray<QueryDepsPath<TParams, TUI>>\n  readonly triggers?: ReadonlyArray<QueryTrigger>\n  readonly meta?: Logix.StateTrait.TraitMeta\n  readonly tags?: ReadonlyArray<string>\n  readonly debounceMs?: number\n  readonly concurrency?: QueryConcurrency\n  readonly key: (...depsValues: DepsArgs<QueryKeyState<TParams, TUI>, Deps>) => QueryResourceKey<R> | undefined\n}): QuerySourceConfig<TParams, TUI, R, Deps> => config as QuerySourceConfig<TParams, TUI, R, Deps>\n\nexport interface QueryTraitsInput<TParams, TUI> {\n  readonly queries: Readonly<Record<string, QuerySourceConfig<TParams, TUI, any>>>\n}\n\n/**\n * Lowering rules (Query -> StateTrait):\n * - Each Query rule maps to a `StateTrait.source`, writing back to `queries.<name>` (isomorphic to module state).\n * - keySelector computes key from `{ params; ui }`; keyHash/race gating is guaranteed by the kernel source runtime.\n *\n * Notes:\n * - deps uses module-root paths (e.g. \"params.q\" / \"ui.query.autoEnabled\"), aligned with the constraints in 007/004.\n * - concurrency \"exhaust\" is represented as \"exhaust-trailing\" in the kernel.\n */\nexport const toStateTraitSpec = <TParams, TUI>(\n  input: QueryTraitsInput<TParams, TUI>,\n): Logix.StateTrait.StateTraitSpec<any> => {\n  const out: Record<string, Logix.StateTrait.StateTraitEntry<any, any>> = {}\n\n  for (const [name, q] of Object.entries(input.queries)) {\n    const triggers = q.triggers ?? (['onMount', 'onKeyChange'] as const)\n\n    // \"manual\" must be exclusive to avoid ambiguous semantics (configuration error).\n    if (triggers.includes('manual') && triggers.length > 1) {\n      throw new Error(\n        `[Query.traits] \"manual\" must be exclusive, but got triggers=[${triggers.join(', ')}] for query \"${name}\".`,\n      )\n    }\n\n    out[`queries.${name}`] = Logix.StateTrait.source({\n      // deps: used for graph building/diagnostics/future reverse-closure; Query also reuses deps to converge triggers.\n      deps: q.deps as any,\n      resource: q.resource.id,\n      triggers,\n      debounceMs: q.debounceMs,\n      concurrency: q.concurrency === 'exhaust' ? 'exhaust-trailing' : q.concurrency,\n      key: (...depsValues: ReadonlyArray<any>) => (q.key as any)(...depsValues),\n      meta: q.meta,\n    })\n  }\n\n  return out as Logix.StateTrait.StateTraitSpec<any>\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAAAA,SAAuB;AACvB,IAAAC,iBAA+B;;;ACD/B,YAAuB;AACvB,IAAAC,iBAAoD;;;ACCpD,IAAAC,iBAAkD;;;ACDlD,oBAA2C;AAiBpC,IAAM,aAAa,CAAC,WACxB,uBAAM;AAGL,MAAI;AAEJ,SAAO,CAAC,OAAO;AACb,QAAK,GAAG,SAAS,aAAa,GAAG,SAAS,kBAAmB,CAAC,GAAG,MAAM,cAAc,CAAC,GAAG,KAAK,SAAS;AACrG,aAAO,GAAG;AAAA,IACZ;AAEA,UAAM,aAAa,GAAG,KAAK;AAC3B,QAAI,QAAQ,UAAU,CAAC,OAAO,OAAO,UAAU,GAAG;AAChD,aAAO,GAAG;AAAA,IACZ;AAEA,UAAM,UAAU,GAAG,KAAK;AAExB,QAAI,cAAc;AAChB,UAAI,aAAa,WAAW;AAC1B,eAAO,aAAa,UAAU,YAAY,SAAS,GAAG,MAAa;AAAA,MACrE;AACA,aAAO,aAAa,MAAM,EAAE,YAAY,SAAS,QAAQ,GAAG,OAAc,CAAC;AAAA,IAC7E;AAEA,WAAO,qBAAO,cAAc,MAAuD,EAAE;AAAA,MACnF,qBAAO,QAAQ,CAAC,cAAc;AAC5B,YAAI,qBAAO,OAAO,SAAS,GAAG;AAC5B,iBAAO,qBAAO;AAAA,YACZ,IAAI;AAAA,cACF;AAAA,YACF;AAAA,UACF;AAAA,QACF;AACA,uBAAe,UAAU;AACzB,YAAI,aAAa,WAAW;AAC1B,iBAAO,aAAa,UAAU,YAAY,SAAS,GAAG,MAAa;AAAA,QACrE;AACA,eAAO,aAAa,MAAM,EAAE,YAAY,SAAS,QAAQ,GAAG,OAAc,CAAC;AAAA,MAC7E,CAAC;AAAA,IACH;AAAA,EACF;AACF,GAAG;;;ADfL,IAAM,gBAAN,cAA4B,0BAAW,QAA+B,EAAE,uBAAuB,EAAE;AAAC;AAE3F,IAAM,SAAS,OAAO,OAAO,eAAe;AAAA,EACjD,OAAO,CAAC,WAA6D,qBAAM,QAAQ,eAAe,MAAM;AAAA,EACxG,YAAY,CAAC,WAAmD,WAAe,MAAM;AACvF,CAAC;;;AD7CD,IAAM,kBAAkB,CAAC,WAAW,aAAa;AAEjD,IAAM,cAAc,CAAC,aACnB,YAAY;AAEd,IAAM,eAAe,CAAC,aACpB,SAAS,WAAW,KAAK,SAAS,CAAC,MAAM;AAE3C,IAAM,qBAAqB,CAAC,aAA0C;AACpE,MAAI,CAAC,YAAY,OAAO,aAAa,SAAU,QAAO;AACtD,QAAM,UAAW,SAAiB;AAClC,SAAO,OAAO,YAAY,WAAW,UAAU;AACjD;AAEA,IAAM,oBAAoB,CAAC,aAA0C;AACnE,MAAI,CAAC,YAAY,OAAO,aAAa,SAAU,QAAO;AACtD,QAAM,SAAU,SAAiB;AACjC,SAAO,OAAO,WAAW,WAAW,SAAS;AAC/C;AAYO,IAAM,cAAc,CACzBC,SACA,WAEAA,QAAO,MAAM,CAAC,MAAM;AAIlB,QAAM,UAAU,oBAAI,IAAoC;AACxD,QAAM,cAAc,oBAAI,IAAgC;AAExD,QAAM,wBAAwB,CAC5B,MACA,GACA,YAEA,sBAAO,IAAI,aAAa;AACtB,UAAM,YAAY,OAAO,sBAAO,cAAc,MAA0E;AACxH,QAAI,UAAU,SAAS,OAAQ,QAAO;AAEtC,UAAM,SAAS,UAAU;AACzB,QAAI,CAAC,OAAO,UAAW,QAAO;AAE9B,UAAM,UAAU,OAAO,OAAO,UAAU;AAAA,MACtC,YAAY,EAAE,SAAS;AAAA,MACvB;AAAA,IACF,CAAC;AACD,QAAI,QAAQ,SAAS,OAAQ,QAAO;AAEpC,UAAM,WAAiB,eAAS,SAAS,QAAQ;AAAA,MAC/C;AAAA,MACA,MAAM,QAAQ;AAAA,IAChB,CAAC;AACD,WAAO,EAAE,MAAM,OAAO,CAAC,UAAU;AAC/B;AAAC,MAAC,MAAoC,QAAQ,IAAI,IAAI;AAAA,IACxD,CAAC;AAED,WAAO;AAAA,EACT,CAAC;AAEH,QAAM,gBAAgB,CAAC,SACrB,sBAAO,IAAI,aAAa;AACtB,UAAM,OAAO,QAAQ,IAAI,IAAI;AAC7B,QAAI,CAAC,KAAM;AACX,YAAQ,OAAO,IAAI;AACnB,WAAO,qBAAM,UAAU,IAAI;AAAA,EAC7B,CAAC;AAEH,QAAM,eAAe,CAAC,SAA4B,WAAW,IAAI;AAEjE,QAAM,UAAU,CAAC,MAAiB,YAChC,EAAE,OAAO,OAAO,QAAQ,aAAa,IAAI,GAAU,OAAc;AAEnE,QAAM,oBAAoB,CAAC,MAAiB,OAC1C,sBAAO,IAAI,aAAa;AACtB,WAAO,cAAc,IAAI;AACvB,UAAM,QAAQ,OAAO,sBAAO;AAAA,MAC1B,sBAAO,MAAM,wBAAS,OAAO,EAAE,CAAC,EAAE;AAAA,QAChC,sBAAO,QAAQ,MAAM,QAAQ,IAAI,CAAC;AAAA,QAClC,sBAAO,SAAS,sBAAO,KAAK,MAAM,QAAQ,OAAO,IAAI,CAAC,CAAC;AAAA,QACvD,sBAAO,WAAW,MAAM,sBAAO,IAAI;AAAA,MACrC;AAAA,IACF;AACF,YAAQ,IAAI,MAAM,KAAK;AAAA,EACzB,CAAC;AAEH,QAAM,iBAAiB,CAAC,OAAY,MAA2D;AAC7F,UAAM,YAAY,CAAC,MAAW,SAA0B;AACtD,YAAM,QAAQ,KAAK,MAAM,GAAG;AAC5B,UAAI,MAAM;AACV,iBAAW,KAAK,OAAO;AACrB,YAAI,OAAO,KAAM,QAAO;AACxB,cAAM,IAAI,CAAC;AAAA,MACb;AACA,aAAO;AAAA,IACT;AAEA,QAAI;AACF,YAAM,WAAW,EAAE,QAAQ,MAAM,QAAe,IAAI,MAAM,GAAU;AACpE,YAAM,OAAQ,EAAE,KAA+B,IAAI,CAAC,QAAQ,UAAU,UAAU,GAAG,CAAC;AACpF,YAAM,MAAO,EAAE,IAAY,GAAG,IAAI;AAClC,UAAI,QAAQ,OAAW,QAAO;AAC9B,aAAa,eAAS,QAAQ,GAAG;AAAA,IACnC,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAEA,QAAM,mBAAmB,CACvB,OACA,kBAEA,sBAAO,IAAI,aAAa;AACtB,UAAM,QAAS,kBAAkB,OAAO,EAAE,MAAM;AAEhD,eAAW,CAAC,MAAM,CAAC,KAAK,OAAO,QAAQ,OAAO,OAAO,GAAG;AACtD,YAAM,YAAY;AAClB,YAAM,WAAW,YAAY,EAAE,QAAQ;AACvC,UAAI,aAAa,QAAQ,GAAG;AAC1B;AAAA,MACF;AAEA,UAAI,UAAU,WAAW,CAAC,SAAS,SAAS,SAAS,GAAG;AACtD;AAAA,MACF;AAEA,UAAI,UAAU,eAAe,CAAC,SAAS,SAAS,aAAa,GAAG;AAC9D;AAAA,MACF;AAEA,YAAM,UAAU,eAAe,OAAO,CAAC;AACvC,YAAM,WAAW,OAAO,UAAU,SAAS;AAC3C,YAAM,kBAAkB,mBAAmB,QAAQ;AACnD,YAAM,iBAAiB,kBAAkB,QAAQ;AAGjD,UAAI,YAAY,QAAW;AACzB,oBAAY,IAAI,WAAW,MAAS;AACpC;AAAA,MACF;AAGA,YAAM,OAAO,YAAY,IAAI,SAAS;AACtC,UAAI,kBAAkB,mBAAmB,UAAU,oBAAoB,WAAW,SAAS,SAAS;AAClG;AAAA,MACF;AAGA,UAAI,kBAAkB,mBAAmB,UAAU,oBAAoB,SAAS;AAC9E,oBAAY,IAAI,WAAW,OAAO;AAClC;AAAA,MACF;AAEA,kBAAY,IAAI,WAAW,OAAO;AAIlC,YAAM,WAAW,OAAO,sBAAsB,WAAW,GAAG,OAAO;AACnE,UAAI,UAAU;AACZ,eAAO,cAAc,SAAS;AAC9B;AAAA,MACF;AAEA,YAAM,aAAa,EAAE,cAAc;AACnC,UAAI,UAAU,eAAe,aAAa,GAAG;AAC3C,eAAO,kBAAkB,WAAW,UAAU;AAAA,MAChD,OAAO;AAEL,eAAO,cAAc,SAAS;AAC9B,eAAO,QAAQ,SAAS;AAAA,MAC1B;AAAA,IACF;AAAA,EACF,CAAC;AAEH,QAAM,aAAa,CAAC,YAClB,sBAAO;AAAA,IAAQ,OAAO,KAAK,OAAO,OAAO;AAAA,IAAG,CAAC,SAC3C,cAAc,IAAI,EAAE,KAAK,sBAAO,QAAQ,MAAM,QAAQ,MAAmB,OAAO,CAAC,CAAC;AAAA,EACpF,EAAE,KAAK,sBAAO,MAAM;AAEtB,QAAM,QAAQ,EAAE,UAAU,QAAQ,iBAAiB,OAAO,CAAC;AAE3D,QAAM,MAAM,sBAAO;AAAA,IAAQ,MACzB,sBAAO;AAAA,MACL;AAAA;AAAA;AAAA;AAAA,QAIE,EAAE,SAAS,WAAW,EAAE;AAAA,UAAI,CAAC,WAC3B,sBAAO,IAAI,aAAa;AACtB,kBAAM,QAAS,OAAO,EAAE,MAAM;AAC9B,kBAAM,OAAO,EAAE,GAAG,OAAO,QAAQ,OAAO,QAAQ;AAChD,mBAAO,iBAAiB,aAAa,IAAI;AAAA,UAC3C,CAAC;AAAA,QACH;AAAA,QACA,EAAE,SAAS,OAAO,EAAE;AAAA,UAAI,CAAC,WACvB,sBAAO,IAAI,aAAa;AACtB,kBAAM,QAAS,OAAO,EAAE,MAAM;AAC9B,kBAAM,OAAO,EAAE,GAAG,OAAO,IAAI,OAAO,QAAQ;AAC5C,mBAAO,iBAAiB,aAAa,IAAI;AAAA,UAC3C,CAAC;AAAA,QACH;AAAA;AAAA,QAGA,EAAE,SAAS,SAAS,EAAE;AAAA,UAAQ,CAAC,WAC7B,sBAAO,IAAI,aAAa;AACtB,kBAAM,SAAS,OAAO;AACtB,gBAAI,OAAO,WAAW,YAAY,OAAO,SAAS,GAAG;AACnD,qBAAO,cAAc,MAAM;AAC3B,qBAAO,QAAQ,QAAQ,EAAE,OAAO,KAAK,CAAC;AAAA,YACxC,OAAO;AACL,qBAAO,WAAW,EAAE,OAAO,KAAK,CAAC;AAAA,YACnC;AAAA,UACF,CAAC;AAAA,QACH;AAAA,MACF;AAAA,MACA,EAAE,aAAa,YAAY;AAAA,IAC7B,EAAE,KAAK,sBAAO,MAAM;AAAA,EACtB;AAEA,SAAO,EAAE,OAAO,IAAI;AACtB,CAAC;;;AG3OH,IAAAC,SAAuB;AACvB,IAAAC,iBAAmC;AAQnC,IAAM,sBAAsB,CAC1B,SACA,YAC0E;AAC1E,MAAI,QAAQ,SAAS,cAAc;AACjC,WAAO,OAAO,QAAQ,OAAO,EAC1B,OAAO,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,OAAO,QAAQ,UAAU,EACtD,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,YAAY,EAAE,SAAS,GAAG,EAAE;AAAA,EAC7D;AAEA,MAAI,QAAQ,SAAS,YAAY;AAC/B,WAAO,OAAO,QAAQ,OAAO,EAC1B,OAAO,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,OAAO,QAAQ,UAAU,EACtD,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,YAAY,EAAE,SAAS,GAAG,EAAE;AAAA,EAC7D;AAGA,QAAM,UAAU,OAAO,QAAQ,OAAO;AACtC,QAAM,SAAS,QAAQ,OAAO,CAAC,CAAC,EAAE,CAAC,MAAM,MAAM,QAAQ,EAAE,IAAI,KAAK,EAAE,KAAK,SAAS,QAAQ,GAAG,CAAC;AAC9F,QAAM,WAAW,OAAO,SAAS,IAAI,SAAS;AAC9C,SAAO,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,YAAY,EAAE,SAAS,GAAG,EAAE;AAC1E;AAEO,IAAM,aAAa,CACxBC,SACA,WAEAA,QAAO;AAAA,EAAM,CAAC,MACZ,sBAAO,IAAI,aAAa;AACtB,WAAO,EAAE,SAAS,YAAY,EAAE;AAAA,MAAQ,CAAC,WACvC,sBAAO,IAAI,aAAa;AACtB,cAAM,UAAU,OAAO;AAGvB,eAAa,sBAAe,cAAc,GAAU;AAAA,UAClD,MAAM;AAAA,UACN;AAAA,QACF,CAAC;AAGD,cAAM,YAAY,OAAO,sBAAO,cAAc,MAA0E;AACxH,YAAI,UAAU,SAAS,QAAQ;AAC7B,iBAAO,UAAU,MAAM,WAAW,OAAO;AAAA,QAC3C;AAGA,cAAM,UAAU,oBAAkC,SAAS,OAAO,OAAO;AACzE,cAAM,eAAe,CAAC,SAAyB,WAAW,IAAI;AAC9D,eAAO,sBAAO;AAAA,UACZ;AAAA,UACA,CAAC,MACC,EAAE,OAAO,OAAO,QAAQ,aAAa,EAAE,IAAI,GAAU,EAAE,OAAO,KAAK,CAAC;AAAA,QACxE,EAAE,KAAK,sBAAO,MAAM;AAAA,MACtB,CAAC;AAAA,IACH;AAAA,EACF,CAAC;AACH;;;ACjEF,IAAAC,SAAuB;AA+GhB,IAAM,mBAAmB,CAC9B,UACyC;AACzC,QAAM,MAAkE,CAAC;AAEzE,aAAW,CAAC,MAAM,CAAC,KAAK,OAAO,QAAQ,MAAM,OAAO,GAAG;AACrD,UAAM,WAAW,EAAE,YAAa,CAAC,WAAW,aAAa;AAGzD,QAAI,SAAS,SAAS,QAAQ,KAAK,SAAS,SAAS,GAAG;AACtD,YAAM,IAAI;AAAA,QACR,gEAAgE,SAAS,KAAK,IAAI,CAAC,gBAAgB,IAAI;AAAA,MACzG;AAAA,IACF;AAEA,QAAI,WAAW,IAAI,EAAE,IAAU,kBAAW,OAAO;AAAA;AAAA,MAE/C,MAAM,EAAE;AAAA,MACR,UAAU,EAAE,SAAS;AAAA,MACrB;AAAA,MACA,YAAY,EAAE;AAAA,MACd,aAAa,EAAE,gBAAgB,YAAY,qBAAqB,EAAE;AAAA,MAClE,KAAK,IAAI,eAAoC,EAAE,IAAY,GAAG,UAAU;AAAA,MACxE,MAAM,EAAE;AAAA,IACV,CAAC;AAAA,EACH;AAEA,SAAO;AACT;;;ALzBA,IAAM,0BAA0B,sBAAO,MAAM;AAAA,EAC3C,sBAAO,OAAO;AAAA,IACZ,MAAM,sBAAO,QAAQ,YAAY;AAAA,IACjC,YAAY,sBAAO;AAAA,EACrB,CAAC;AAAA,EACD,sBAAO,OAAO;AAAA,IACZ,MAAM,sBAAO,QAAQ,UAAU;AAAA,IAC/B,YAAY,sBAAO;AAAA,IACnB,SAAS,sBAAO;AAAA,EAClB,CAAC;AAAA,EACD,sBAAO,OAAO;AAAA,IACZ,MAAM,sBAAO,QAAQ,OAAO;AAAA,IAC5B,KAAK,sBAAO;AAAA,EACd,CAAC;AACH,CAAC;AAED,IAAM,kBAAkB,CAAC,SAAuB;AAC9C,MAAI,CAAC,MAAM;AACT,UAAM,IAAI,MAAM,2CAA2C;AAAA,EAC7D;AACA,MAAI,KAAK,SAAS,GAAG,GAAG;AACtB,UAAM,IAAI,MAAM,sDAAsD,IAAI,GAAG;AAAA,EAC/E;AACA,MAAI,SAAS,YAAY,SAAS,QAAQ,SAAS,WAAW;AAC5D,UAAM,IAAI,MAAM,4BAA4B,IAAI,eAAe;AAAA,EACjE;AACF;AAGA,IAAM,2BAA2B,CAC/B,UACuC;AACvC,MAAI,MAAM,WAAW,GAAG;AACtB,WAAO,sBAAO;AAAA,EAChB;AAEA,SAAO,sBAAO,SAAS,KAA6D;AACtF;AAEA,IAAM,qBAAqB,CAAkE,YAC3F,sBAAO;AAAA,EACL,OAAO,YAAa,OAAO,KAAK,OAAO,EAA4B,IAAI,CAAC,QAAQ,CAAC,KAAK,sBAAO,OAAO,CAAC,CAAC;AAIxG;AAEK,IAAM,OAAO,CAMlB,IACA,WACqE;AAGrE,QAAM,eAA2C;AAAA,IAC/C,QAAQ,CAAC,MAAW;AAAA,EACtB;AAEA,QAAM,WAAW,MAAe;AAC9B,UAAM,MAAM,OAAO;AACnB,QAAI,CAAC,IAAK,QAAO,CAAC;AAClB,WAAO,IAAI,YAAY;AAAA,EACzB,GAAG;AAEH,QAAM,mBAAiF;AACvF,QAAM,aAAa,OAAO,KAAK,OAAO;AACtC,aAAW,QAAQ,YAAY;AAC7B,oBAAgB,IAAI;AAAA,EACtB;AAEA,QAAM,sBAAsB,yBAAkC,UAAU;AAExE,QAAM,WAAW,sBAAO;AAExB,QAAM,gBAAgB,mBAA4B,OAAO;AAEzD,QAAM,cAAc,sBAAO,OAAO;AAAA,IAChC,QAAQ,OAAO;AAAA,IACf,IAAI;AAAA,IACJ,SAAS;AAAA,EACX,CAAC;AAED,QAAM,UAAU;AAAA,IACd,WAAW,OAAO;AAAA,IAClB,OAAO;AAAA,IACP,SAAS,sBAAO,YAAY,mBAAmB;AAAA,IAC/C,YAAY;AAAA,EACd;AAIA,QAAM,WAAqB;AAAA,IACzB,WAAW,CAAC,OAAO,QAAQ,SAAS;AAClC,aAAO,QAAQ;AACf,aAAO,EAAE,GAAG,OAAO,QAAQ,OAAO,WAAW,MAAM,OAAO;AAAA,IAC5D;AAAA,IACA,OAAO,CAAC,OAAO,QAAQ,SAAS;AAC9B,aAAO,IAAI;AACX,aAAO,EAAE,GAAG,OAAO,IAAI,OAAO,WAAW,MAAM,GAAG;AAAA,IACpD;AAAA,IACA,SAAS,CAAC,UAAU;AAAA,IACpB,YAAY,CAAC,UAAU;AAAA,EACzB;AAEA,QAAM,cACJ,OAAO,KAAK,gBAAgB,EAAE,SAAS,IAAI,iBAA+B,EAAE,SAAS,iBAAiB,CAAC,IAAI;AAE7G,QAAM,SACJ,eAAe,OAAO,SACjB;AAAA,IACC,GAAI;AAAA,IACJ,GAAI,OAAO;AAAA,EACb,IACA;AAEN,QAAMC,UAAe,cAAO,KAAK,IAAI;AAAA,IACnC,OAAO;AAAA,IACP,SAAS;AAAA,IACT;AAAA,IACA;AAAA,EACF,CAAC;AAED,QAAM,SAAS;AAAA,IACb,YAA+BA,QAAO,KAAY,EAAE,SAAS,iBAAiB,CAAC;AAAA,IAC/E,WAA8BA,QAAO,KAAY,EAAE,SAAS,iBAAiB,CAAC;AAAA,EAChF;AAEA,QAAM,UAAU,CAAC,YACd;AAAA,IACC,QAAQ,UAAU,OAAO;AAAA,IACzB,IAAK,OAAO,MAAO,CAAC;AAAA,IACpB,SAAS,OAAO,YAAa,OAAO,KAAK,OAAO,EAA2B,IAAI,CAAC,QAAQ,CAAC,KAAW,gBAAS,SAAS,KAAK,CAAC,CAAC,CAAC;AAAA,EAChI;AAEF,QAAM,aAA2D;AAAA,IAC/D,MAAM,CACJ,YAC2C;AAC3C,YAAM,WAAW,QAAQ;AACzB,YAAM,UAAUA,QAAO;AAOvB,aAAO;AAAA,QACL;AAAA,QACA,UAAU,QAAQ;AAAA,QAClB;AAAA,QACA,YAAY;AAAA,UACV,WAAW,CAAC,WAAoB,SAAS,QAAQ,UAAU,MAAM,CAAC;AAAA,UAClE,OAAO,CAAC,OAAY,SAAS,QAAQ,MAAM,EAAE,CAAC;AAAA,UAC9C,SAAS,CAAC,WAAgC,SAAS,QAAQ,QAAQ,MAAM,CAAC;AAAA,UAC1E,YAAY,CAAC,YAA+B,SAAS,QAAQ,WAAW,OAAO,CAAC;AAAA,QAClF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEC,EAACA,QAAe,aAAa;AAE9B,QAAM,gBAAgB,uBAAO,IAAI,4BAA4B;AAC5D,EAACA,QAAO,IAAY,aAAa,IAAI,CACpC,SACA,SACG;AACH,UAAM,IAAI,WAAW,KAAK,OAAO;AACjC,WAAO;AAAA,MACL,GAAG;AAAA,MACH,YAAY,EAAE;AAAA,IAChB;AAAA,EACF;AAEA,SAAOA,QAAO,UAAU;AAAA,IACtB,SAAS,QAAQ;AAAA,IACjB,QAAQ,CAAC,GAAG,MAAM;AAAA,EACpB,CAAC;AACH;","names":["Logix","import_effect","import_effect","import_effect","module","Logix","import_effect","module","Logix","module"]}

package/dist/Query.d.cts

@@ -23,15 +23,15 @@ type ForbidQueryNames = {
     readonly [K in ForbiddenQueryName]?: never;
 };
 type QueryActions<TParams, TUI = unknown, TQueries extends Record<string, any> = {}> = {
-    readonly setParams: Schema.Schema<TParams, any>;
-    readonly setUi: Schema.Schema<TUI, any>;
-    readonly refresh: Schema.Schema<QueryName<TQueries> | undefined, any>;
-    readonly invalidate: Schema.Schema<InvalidateRequest, any>;
+    readonly setParams: Schema.Schema<TParams>;
+    readonly setUi: Schema.Schema<TUI>;
+    readonly refresh: Schema.Schema<QueryName<TQueries> | undefined>;
+    readonly invalidate: Schema.Schema<InvalidateRequest>;
 };
-type QueryShape<TParams, TUI = unknown, TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {}> = Logix.Shape<Schema.Schema<QueryState<TParams, TUI, TQueries>, any>, QueryActions<TParams, TUI, TQueries>>;
+type QueryShape<TParams, TUI = unknown, TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {}> = Logix.Shape<Schema.Schema<QueryState<TParams, TUI, TQueries>>, QueryActions<TParams, TUI, TQueries>>;
 type QueryAction<TParams, TUI = unknown, TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {}> = Logix.ActionOf<QueryShape<TParams, TUI, TQueries>>;
 interface QueryMakeConfig<TParams, TUI = unknown, TQueries = {}> {
-    readonly params: Schema.Schema<TParams, any>;
+    readonly params: Schema.Schema<TParams>;
     readonly initialParams: TParams;
     readonly ui?: TUI;
     readonly queries?: (q: QueryBuilder<TParams, TUI>) => TQueries & ForbidQueryNames;

package/dist/Query.d.ts

@@ -23,15 +23,15 @@ type ForbidQueryNames = {
     readonly [K in ForbiddenQueryName]?: never;
 };
 type QueryActions<TParams, TUI = unknown, TQueries extends Record<string, any> = {}> = {
-    readonly setParams: Schema.Schema<TParams, any>;
-    readonly setUi: Schema.Schema<TUI, any>;
-    readonly refresh: Schema.Schema<QueryName<TQueries> | undefined, any>;
-    readonly invalidate: Schema.Schema<InvalidateRequest, any>;
+    readonly setParams: Schema.Schema<TParams>;
+    readonly setUi: Schema.Schema<TUI>;
+    readonly refresh: Schema.Schema<QueryName<TQueries> | undefined>;
+    readonly invalidate: Schema.Schema<InvalidateRequest>;
 };
-type QueryShape<TParams, TUI = unknown, TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {}> = Logix.Shape<Schema.Schema<QueryState<TParams, TUI, TQueries>, any>, QueryActions<TParams, TUI, TQueries>>;
+type QueryShape<TParams, TUI = unknown, TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {}> = Logix.Shape<Schema.Schema<QueryState<TParams, TUI, TQueries>>, QueryActions<TParams, TUI, TQueries>>;
 type QueryAction<TParams, TUI = unknown, TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {}> = Logix.ActionOf<QueryShape<TParams, TUI, TQueries>>;
 interface QueryMakeConfig<TParams, TUI = unknown, TQueries = {}> {
-    readonly params: Schema.Schema<TParams, any>;
+    readonly params: Schema.Schema<TParams>;
     readonly initialParams: TParams;
     readonly ui?: TUI;
     readonly queries?: (q: QueryBuilder<TParams, TUI>) => TQueries & ForbidQueryNames;

package/dist/Query.js

@@ -1,7 +1,7 @@
 import {
   make
-} from "./chunk-DMEHDC55.js";
-import "./chunk-7IVR4THQ.js";
+} from "./chunk-N5QJMXER.js";
+import "./chunk-3P3M3A55.js";
 import "./chunk-BERAWANA.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/{chunk-7IVR4THQ.js → chunk-3P3M3A55.js}

@@ -1,5 +1,5 @@
 // src/Engine.ts
-import { Context, Layer } from "effect";
+import { Layer, ServiceMap as ServiceMap2 } from "effect";
 
 // src/internal/middleware/middleware.ts
 import { Effect, Option } from "effect";
@@ -40,7 +40,7 @@ var middleware = (config) => /* @__PURE__ */ (() => {
 })();
 
 // src/Engine.ts
-var EngineTagImpl = class extends Context.Tag("@logixjs/query/Engine")() {
+var EngineTagImpl = class extends ServiceMap2.Service()("@logixjs/query/Engine") {
 };
 var Engine = Object.assign(EngineTagImpl, {
   layer: (engine) => Layer.succeed(EngineTagImpl, engine),
@@ -50,4 +50,4 @@ var Engine = Object.assign(EngineTagImpl, {
 export {
   Engine
 };
-//# sourceMappingURL=chunk-7IVR4THQ.js.map
+//# sourceMappingURL=chunk-3P3M3A55.js.map

package/dist/chunk-3P3M3A55.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/Engine.ts","../src/internal/middleware/middleware.ts"],"sourcesContent":["import type * as EffectOp from '@logixjs/core/EffectOp'\nimport type { JsonValue } from '@logixjs/core/Observability'\nimport { Effect, Layer, Option, ServiceMap } from 'effect'\nimport { middleware as middlewareImpl, type MiddlewareConfig } from './internal/middleware/middleware.js'\n\nexport type InvalidateRequest =\n  | { readonly kind: 'byResource'; readonly resourceId: string }\n  | { readonly kind: 'byParams'; readonly resourceId: string; readonly keyHash: string }\n  | { readonly kind: 'byTag'; readonly tag: string }\n\nexport interface Engine {\n  readonly fetch: <A>(args: {\n    readonly resourceId: string\n    readonly keyHash: string\n    readonly effect: Effect.Effect<A, unknown, any>\n    /**\n     * MUST be serializable and slim; recommended default is undefined (lazy),\n     * and only populate it when diagnostics/devtools require it.\n     */\n    readonly meta?: JsonValue\n  }) => Effect.Effect<A, unknown, any>\n\n  /**\n   * perf: optional fast path to avoid allocations on the hot path.\n   * Semantics must match `fetch({ ... })`.\n   */\n  readonly fetchFast?: <A>(\n    resourceId: string,\n    keyHash: string,\n    effect: Effect.Effect<A, unknown, any>,\n    meta?: JsonValue,\n  ) => Effect.Effect<A, unknown, any>\n\n  readonly invalidate: (request: InvalidateRequest) => Effect.Effect<void, unknown, any>\n\n  /**\n   * Read-only fast path: must not trigger IO; used to short-circuit to success before refresh,\n   * avoiding loading jitter.\n   */\n  readonly peekFresh?: <A>(args: {\n    readonly resourceId: string\n    readonly keyHash: string\n  }) => Effect.Effect<Option.Option<A>, never, any>\n}\n\nclass EngineTagImpl extends ServiceMap.Service<EngineTagImpl, Engine>()('@logixjs/query/Engine') {}\n\nexport const Engine = Object.assign(EngineTagImpl, {\n  layer: (engine: Engine): Layer.Layer<EngineTagImpl, never, never> => Layer.succeed(EngineTagImpl, engine),\n  middleware: (config?: MiddlewareConfig): EffectOp.Middleware => middlewareImpl(config),\n})\n\nexport type { MiddlewareConfig }\n","import type * as EffectOp from '@logixjs/core/EffectOp'\nimport { Effect, Option, ServiceMap } from 'effect'\nimport { Engine } from '../../Engine.js'\nimport type { Engine as EngineService } from '../../Engine.js'\n\nexport interface MiddlewareConfig {\n  /**\n   * Default: only applies to EffectOp that carries resourceId+keyHash (from StateTrait.source).\n   * Optional: further filter by resourceId.\n   */\n  readonly useFor?: (resourceId: string) => boolean\n}\n\n/**\n * Query middleware (EffectOp): external engine takeover point.\n * - Delegates ResourceSpec.load execution to Engine (cache / in-flight dedupe / invalidation, etc.)\n * - Still preserves Logix Runtime's keyHash gating and ResourceSnapshot source-of-truth semantics\n */\nexport const middleware = (config?: MiddlewareConfig): EffectOp.Middleware =>\n  (() => {\n    // perf: within the same Runtime instance, Engine injection is stable.\n    // Cache it in the middleware closure to avoid a Context lookup on every fetch.\n    let cachedEngine: EngineService | undefined\n\n    return (op) => {\n      if ((op.kind !== 'service' && op.kind !== 'trait-source') || !op.meta?.resourceId || !op.meta.keyHash) {\n        return op.effect as any\n      }\n\n      const resourceId = op.meta.resourceId\n      if (config?.useFor && !config.useFor(resourceId)) {\n        return op.effect as any\n      }\n\n      const keyHash = op.meta.keyHash as string\n\n      if (cachedEngine) {\n        if (cachedEngine.fetchFast) {\n          return cachedEngine.fetchFast(resourceId, keyHash, op.effect as any)\n        }\n        return cachedEngine.fetch({ resourceId, keyHash, effect: op.effect as any })\n      }\n\n      return Effect.serviceOption(Engine as unknown as ServiceMap.Key<any, EngineService>).pipe(\n        Effect.flatMap((engineOpt) => {\n          if (Option.isNone(engineOpt)) {\n            return Effect.fail(\n              new Error(\n                `[Query.Engine.middleware] Missing Query.Engine in the Runtime scope; please provide Query.Engine.layer(Query.TanStack.engine(new QueryClient())) (recommended) or Query.Engine.layer(customEngine).`,\n              ),\n            )\n          }\n          cachedEngine = engineOpt.value\n          if (cachedEngine.fetchFast) {\n            return cachedEngine.fetchFast(resourceId, keyHash, op.effect as any)\n          }\n          return cachedEngine.fetch({ resourceId, keyHash, effect: op.effect as any })\n        }),\n      ) as any\n    }\n  })()\n"],"mappings":";AAEA,SAAiB,OAAe,cAAAA,mBAAkB;;;ACDlD,SAAS,QAAQ,cAA0B;AAiBpC,IAAM,aAAa,CAAC,WACxB,uBAAM;AAGL,MAAI;AAEJ,SAAO,CAAC,OAAO;AACb,QAAK,GAAG,SAAS,aAAa,GAAG,SAAS,kBAAmB,CAAC,GAAG,MAAM,cAAc,CAAC,GAAG,KAAK,SAAS;AACrG,aAAO,GAAG;AAAA,IACZ;AAEA,UAAM,aAAa,GAAG,KAAK;AAC3B,QAAI,QAAQ,UAAU,CAAC,OAAO,OAAO,UAAU,GAAG;AAChD,aAAO,GAAG;AAAA,IACZ;AAEA,UAAM,UAAU,GAAG,KAAK;AAExB,QAAI,cAAc;AAChB,UAAI,aAAa,WAAW;AAC1B,eAAO,aAAa,UAAU,YAAY,SAAS,GAAG,MAAa;AAAA,MACrE;AACA,aAAO,aAAa,MAAM,EAAE,YAAY,SAAS,QAAQ,GAAG,OAAc,CAAC;AAAA,IAC7E;AAEA,WAAO,OAAO,cAAc,MAAuD,EAAE;AAAA,MACnF,OAAO,QAAQ,CAAC,cAAc;AAC5B,YAAI,OAAO,OAAO,SAAS,GAAG;AAC5B,iBAAO,OAAO;AAAA,YACZ,IAAI;AAAA,cACF;AAAA,YACF;AAAA,UACF;AAAA,QACF;AACA,uBAAe,UAAU;AACzB,YAAI,aAAa,WAAW;AAC1B,iBAAO,aAAa,UAAU,YAAY,SAAS,GAAG,MAAa;AAAA,QACrE;AACA,eAAO,aAAa,MAAM,EAAE,YAAY,SAAS,QAAQ,GAAG,OAAc,CAAC;AAAA,MAC7E,CAAC;AAAA,IACH;AAAA,EACF;AACF,GAAG;;;ADfL,IAAM,gBAAN,cAA4BC,YAAW,QAA+B,EAAE,uBAAuB,EAAE;AAAC;AAE3F,IAAM,SAAS,OAAO,OAAO,eAAe;AAAA,EACjD,OAAO,CAAC,WAA6D,MAAM,QAAQ,eAAe,MAAM;AAAA,EACxG,YAAY,CAAC,WAAmD,WAAe,MAAM;AACvF,CAAC;","names":["ServiceMap","ServiceMap"]}