@logixjs/query 0.0.2 → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/Engine.cjs +1 -1
- package/dist/Engine.cjs.map +1 -1
- package/dist/Engine.d.cts +2 -2
- package/dist/Engine.d.ts +2 -2
- package/dist/Engine.js +1 -1
- package/dist/Query.cjs +25 -31
- package/dist/Query.cjs.map +1 -1
- package/dist/Query.d.cts +6 -6
- package/dist/Query.d.ts +6 -6
- package/dist/Query.js +2 -2
- package/dist/{chunk-7IVR4THQ.js → chunk-3P3M3A55.js} +3 -3
- package/dist/chunk-3P3M3A55.js.map +1 -0
- package/dist/{chunk-DMEHDC55.js → chunk-N5QJMXER.js} +26 -32
- package/dist/chunk-N5QJMXER.js.map +1 -0
- package/dist/index.cjs +25 -31
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +2 -2
- package/package.json +11 -6
- package/dist/chunk-7IVR4THQ.js.map +0 -1
- package/dist/chunk-DMEHDC55.js.map +0 -1
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import {
|
|
2
2
|
Engine
|
|
3
|
-
} from "./chunk-
|
|
3
|
+
} from "./chunk-3P3M3A55.js";
|
|
4
4
|
import {
|
|
5
5
|
toStateTraitSpec
|
|
6
6
|
} from "./chunk-BERAWANA.js";
|
|
@@ -52,7 +52,7 @@ var autoTrigger = (module, config) => module.logic(($) => {
|
|
|
52
52
|
const prev = pending.get(name);
|
|
53
53
|
if (!prev) return;
|
|
54
54
|
pending.delete(name);
|
|
55
|
-
yield* Fiber.
|
|
55
|
+
yield* Fiber.interrupt(prev);
|
|
56
56
|
});
|
|
57
57
|
const sourcePathOf = (name) => `queries.${name}`;
|
|
58
58
|
const refresh = (name, options) => $.traits.source.refresh(sourcePathOf(name), options);
|
|
@@ -60,9 +60,9 @@ var autoTrigger = (module, config) => module.logic(($) => {
|
|
|
60
60
|
yield* cancelPending(name);
|
|
61
61
|
const fiber = yield* Effect.forkScoped(
|
|
62
62
|
Effect.sleep(Duration.millis(ms)).pipe(
|
|
63
|
-
Effect.
|
|
63
|
+
Effect.flatMap(() => refresh(name)),
|
|
64
64
|
Effect.ensuring(Effect.sync(() => pending.delete(name))),
|
|
65
|
-
Effect.
|
|
65
|
+
Effect.catchCause(() => Effect.void)
|
|
66
66
|
)
|
|
67
67
|
);
|
|
68
68
|
pending.set(name, fiber);
|
|
@@ -134,21 +134,23 @@ var autoTrigger = (module, config) => module.logic(($) => {
|
|
|
134
134
|
});
|
|
135
135
|
const refreshAll = (options) => Effect.forEach(
|
|
136
136
|
Object.keys(config.queries),
|
|
137
|
-
(name) => cancelPending(name).pipe(Effect.
|
|
137
|
+
(name) => cancelPending(name).pipe(Effect.flatMap(() => refresh(name, options)))
|
|
138
138
|
).pipe(Effect.asVoid);
|
|
139
139
|
const setup = $.lifecycle.onStart(maybeAutoRefresh("mount"));
|
|
140
140
|
const run = Effect.suspend(
|
|
141
141
|
() => Effect.all(
|
|
142
142
|
[
|
|
143
143
|
// params/ui changes: handled by Query's default logic, avoiding scattered UI-side useEffect triggers.
|
|
144
|
-
|
|
144
|
+
// Keep params/ui-driven auto refresh aligned with action stream order.
|
|
145
|
+
// `source.refresh` already forks IO internally, so the watcher itself can stay ordered.
|
|
146
|
+
$.onAction("setParams").run(
|
|
145
147
|
(action) => Effect.gen(function* () {
|
|
146
148
|
const state = yield* $.state.read;
|
|
147
149
|
const next = { ...state, params: action.payload };
|
|
148
150
|
yield* maybeAutoRefresh("keyChange", next);
|
|
149
151
|
})
|
|
150
152
|
),
|
|
151
|
-
$.onAction("setUi").
|
|
153
|
+
$.onAction("setUi").run(
|
|
152
154
|
(action) => Effect.gen(function* () {
|
|
153
155
|
const state = yield* $.state.read;
|
|
154
156
|
const next = { ...state, ui: action.payload };
|
|
@@ -214,7 +216,7 @@ var invalidate = (module, config) => module.logic(
|
|
|
214
216
|
);
|
|
215
217
|
|
|
216
218
|
// src/Query.ts
|
|
217
|
-
var InvalidateRequestSchema = Schema.Union(
|
|
219
|
+
var InvalidateRequestSchema = Schema.Union([
|
|
218
220
|
Schema.Struct({
|
|
219
221
|
kind: Schema.Literal("byResource"),
|
|
220
222
|
resourceId: Schema.String
|
|
@@ -228,7 +230,7 @@ var InvalidateRequestSchema = Schema.Union(
|
|
|
228
230
|
kind: Schema.Literal("byTag"),
|
|
229
231
|
tag: Schema.String
|
|
230
232
|
})
|
|
231
|
-
);
|
|
233
|
+
]);
|
|
232
234
|
var assertQueryName = (name) => {
|
|
233
235
|
if (!name) {
|
|
234
236
|
throw new Error(`[Query.make] query name must be non-empty`);
|
|
@@ -240,6 +242,15 @@ var assertQueryName = (name) => {
|
|
|
240
242
|
throw new Error(`[Query.make] query name "${name}" is reserved`);
|
|
241
243
|
}
|
|
242
244
|
};
|
|
245
|
+
var buildRefreshTargetSchema = (names) => {
|
|
246
|
+
if (names.length === 0) {
|
|
247
|
+
return Schema.Never;
|
|
248
|
+
}
|
|
249
|
+
return Schema.Literals(names);
|
|
250
|
+
};
|
|
251
|
+
var buildQueriesSchema = (queries) => Schema.Struct(
|
|
252
|
+
Object.fromEntries(Object.keys(queries).map((key) => [key, Schema.Unknown]))
|
|
253
|
+
);
|
|
243
254
|
var make = (id, config) => {
|
|
244
255
|
const queryBuilder = {
|
|
245
256
|
source: (q) => q
|
|
@@ -250,28 +261,13 @@ var make = (id, config) => {
|
|
|
250
261
|
return raw(queryBuilder);
|
|
251
262
|
})();
|
|
252
263
|
const queriesForTraits = queries;
|
|
253
|
-
|
|
264
|
+
const queryNames = Object.keys(queries);
|
|
265
|
+
for (const name of queryNames) {
|
|
254
266
|
assertQueryName(name);
|
|
255
267
|
}
|
|
256
|
-
const RefreshTargetSchema = (
|
|
257
|
-
const names = Object.keys(queries);
|
|
258
|
-
if (names.length === 0) return Schema.Never;
|
|
259
|
-
if (names.length === 1) {
|
|
260
|
-
return Schema.Literal(names[0]);
|
|
261
|
-
}
|
|
262
|
-
const asUnionMembers = (items) => {
|
|
263
|
-
if (items.length < 2) {
|
|
264
|
-
throw new Error(`[Query.make] internal error: expected at least 2 query names for union`);
|
|
265
|
-
}
|
|
266
|
-
return items;
|
|
267
|
-
};
|
|
268
|
-
const members = names.map((n) => Schema.Literal(n));
|
|
269
|
-
return Schema.Union(...asUnionMembers(members));
|
|
270
|
-
})();
|
|
268
|
+
const RefreshTargetSchema = buildRefreshTargetSchema(queryNames);
|
|
271
269
|
const UiSchema = Schema.Unknown;
|
|
272
|
-
const QueriesSchema =
|
|
273
|
-
Object.fromEntries(Object.keys(queries).map((k) => [k, Schema.Unknown]))
|
|
274
|
-
);
|
|
270
|
+
const QueriesSchema = buildQueriesSchema(queries);
|
|
275
271
|
const StateSchema = Schema.Struct({
|
|
276
272
|
params: config.params,
|
|
277
273
|
ui: UiSchema,
|
|
@@ -313,9 +309,7 @@ var make = (id, config) => {
|
|
|
313
309
|
const initial = (params) => ({
|
|
314
310
|
params: params ?? config.initialParams,
|
|
315
311
|
ui: config.ui ?? {},
|
|
316
|
-
queries: Object.fromEntries(
|
|
317
|
-
Object.keys(queries).map((k) => [k, Logix3.Resource.Snapshot.idle()])
|
|
318
|
-
)
|
|
312
|
+
queries: Object.fromEntries(Object.keys(queries).map((key) => [key, Logix3.Resource.Snapshot.idle()]))
|
|
319
313
|
});
|
|
320
314
|
const controller = {
|
|
321
315
|
make: (runtime) => {
|
|
@@ -352,4 +346,4 @@ var make = (id, config) => {
|
|
|
352
346
|
export {
|
|
353
347
|
make
|
|
354
348
|
};
|
|
355
|
-
//# sourceMappingURL=chunk-
|
|
349
|
+
//# sourceMappingURL=chunk-N5QJMXER.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/Query.ts","../src/internal/logics/auto-trigger.ts","../src/internal/logics/invalidate.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 * 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"],"mappings":"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","names":["Logix","Logix","Effect","Effect"]}
|
package/dist/index.cjs
CHANGED
|
@@ -88,7 +88,7 @@ var middleware = (config) => /* @__PURE__ */ (() => {
|
|
|
88
88
|
})();
|
|
89
89
|
|
|
90
90
|
// src/Engine.ts
|
|
91
|
-
var EngineTagImpl = class extends import_effect2.
|
|
91
|
+
var EngineTagImpl = class extends import_effect2.ServiceMap.Service()("@logixjs/query/Engine") {
|
|
92
92
|
};
|
|
93
93
|
var Engine = Object.assign(EngineTagImpl, {
|
|
94
94
|
layer: (engine2) => import_effect2.Layer.succeed(EngineTagImpl, engine2),
|
|
@@ -136,7 +136,7 @@ var autoTrigger = (module2, config) => module2.logic(($) => {
|
|
|
136
136
|
const prev = pending.get(name);
|
|
137
137
|
if (!prev) return;
|
|
138
138
|
pending.delete(name);
|
|
139
|
-
yield* import_effect3.Fiber.
|
|
139
|
+
yield* import_effect3.Fiber.interrupt(prev);
|
|
140
140
|
});
|
|
141
141
|
const sourcePathOf = (name) => `queries.${name}`;
|
|
142
142
|
const refresh = (name, options) => $.traits.source.refresh(sourcePathOf(name), options);
|
|
@@ -144,9 +144,9 @@ var autoTrigger = (module2, config) => module2.logic(($) => {
|
|
|
144
144
|
yield* cancelPending(name);
|
|
145
145
|
const fiber = yield* import_effect3.Effect.forkScoped(
|
|
146
146
|
import_effect3.Effect.sleep(import_effect3.Duration.millis(ms)).pipe(
|
|
147
|
-
import_effect3.Effect.
|
|
147
|
+
import_effect3.Effect.flatMap(() => refresh(name)),
|
|
148
148
|
import_effect3.Effect.ensuring(import_effect3.Effect.sync(() => pending.delete(name))),
|
|
149
|
-
import_effect3.Effect.
|
|
149
|
+
import_effect3.Effect.catchCause(() => import_effect3.Effect.void)
|
|
150
150
|
)
|
|
151
151
|
);
|
|
152
152
|
pending.set(name, fiber);
|
|
@@ -218,21 +218,23 @@ var autoTrigger = (module2, config) => module2.logic(($) => {
|
|
|
218
218
|
});
|
|
219
219
|
const refreshAll = (options) => import_effect3.Effect.forEach(
|
|
220
220
|
Object.keys(config.queries),
|
|
221
|
-
(name) => cancelPending(name).pipe(import_effect3.Effect.
|
|
221
|
+
(name) => cancelPending(name).pipe(import_effect3.Effect.flatMap(() => refresh(name, options)))
|
|
222
222
|
).pipe(import_effect3.Effect.asVoid);
|
|
223
223
|
const setup = $.lifecycle.onStart(maybeAutoRefresh("mount"));
|
|
224
224
|
const run = import_effect3.Effect.suspend(
|
|
225
225
|
() => import_effect3.Effect.all(
|
|
226
226
|
[
|
|
227
227
|
// params/ui changes: handled by Query's default logic, avoiding scattered UI-side useEffect triggers.
|
|
228
|
-
|
|
228
|
+
// Keep params/ui-driven auto refresh aligned with action stream order.
|
|
229
|
+
// `source.refresh` already forks IO internally, so the watcher itself can stay ordered.
|
|
230
|
+
$.onAction("setParams").run(
|
|
229
231
|
(action) => import_effect3.Effect.gen(function* () {
|
|
230
232
|
const state = yield* $.state.read;
|
|
231
233
|
const next = { ...state, params: action.payload };
|
|
232
234
|
yield* maybeAutoRefresh("keyChange", next);
|
|
233
235
|
})
|
|
234
236
|
),
|
|
235
|
-
$.onAction("setUi").
|
|
237
|
+
$.onAction("setUi").run(
|
|
236
238
|
(action) => import_effect3.Effect.gen(function* () {
|
|
237
239
|
const state = yield* $.state.read;
|
|
238
240
|
const next = { ...state, ui: action.payload };
|
|
@@ -324,7 +326,7 @@ var toStateTraitSpec = (input) => {
|
|
|
324
326
|
};
|
|
325
327
|
|
|
326
328
|
// src/Query.ts
|
|
327
|
-
var InvalidateRequestSchema = import_effect5.Schema.Union(
|
|
329
|
+
var InvalidateRequestSchema = import_effect5.Schema.Union([
|
|
328
330
|
import_effect5.Schema.Struct({
|
|
329
331
|
kind: import_effect5.Schema.Literal("byResource"),
|
|
330
332
|
resourceId: import_effect5.Schema.String
|
|
@@ -338,7 +340,7 @@ var InvalidateRequestSchema = import_effect5.Schema.Union(
|
|
|
338
340
|
kind: import_effect5.Schema.Literal("byTag"),
|
|
339
341
|
tag: import_effect5.Schema.String
|
|
340
342
|
})
|
|
341
|
-
);
|
|
343
|
+
]);
|
|
342
344
|
var assertQueryName = (name) => {
|
|
343
345
|
if (!name) {
|
|
344
346
|
throw new Error(`[Query.make] query name must be non-empty`);
|
|
@@ -350,6 +352,15 @@ var assertQueryName = (name) => {
|
|
|
350
352
|
throw new Error(`[Query.make] query name "${name}" is reserved`);
|
|
351
353
|
}
|
|
352
354
|
};
|
|
355
|
+
var buildRefreshTargetSchema = (names) => {
|
|
356
|
+
if (names.length === 0) {
|
|
357
|
+
return import_effect5.Schema.Never;
|
|
358
|
+
}
|
|
359
|
+
return import_effect5.Schema.Literals(names);
|
|
360
|
+
};
|
|
361
|
+
var buildQueriesSchema = (queries) => import_effect5.Schema.Struct(
|
|
362
|
+
Object.fromEntries(Object.keys(queries).map((key) => [key, import_effect5.Schema.Unknown]))
|
|
363
|
+
);
|
|
353
364
|
var make = (id, config) => {
|
|
354
365
|
const queryBuilder = {
|
|
355
366
|
source: (q) => q
|
|
@@ -360,28 +371,13 @@ var make = (id, config) => {
|
|
|
360
371
|
return raw(queryBuilder);
|
|
361
372
|
})();
|
|
362
373
|
const queriesForTraits = queries;
|
|
363
|
-
|
|
374
|
+
const queryNames = Object.keys(queries);
|
|
375
|
+
for (const name of queryNames) {
|
|
364
376
|
assertQueryName(name);
|
|
365
377
|
}
|
|
366
|
-
const RefreshTargetSchema = (
|
|
367
|
-
const names = Object.keys(queries);
|
|
368
|
-
if (names.length === 0) return import_effect5.Schema.Never;
|
|
369
|
-
if (names.length === 1) {
|
|
370
|
-
return import_effect5.Schema.Literal(names[0]);
|
|
371
|
-
}
|
|
372
|
-
const asUnionMembers = (items) => {
|
|
373
|
-
if (items.length < 2) {
|
|
374
|
-
throw new Error(`[Query.make] internal error: expected at least 2 query names for union`);
|
|
375
|
-
}
|
|
376
|
-
return items;
|
|
377
|
-
};
|
|
378
|
-
const members = names.map((n) => import_effect5.Schema.Literal(n));
|
|
379
|
-
return import_effect5.Schema.Union(...asUnionMembers(members));
|
|
380
|
-
})();
|
|
378
|
+
const RefreshTargetSchema = buildRefreshTargetSchema(queryNames);
|
|
381
379
|
const UiSchema = import_effect5.Schema.Unknown;
|
|
382
|
-
const QueriesSchema =
|
|
383
|
-
Object.fromEntries(Object.keys(queries).map((k) => [k, import_effect5.Schema.Unknown]))
|
|
384
|
-
);
|
|
380
|
+
const QueriesSchema = buildQueriesSchema(queries);
|
|
385
381
|
const StateSchema = import_effect5.Schema.Struct({
|
|
386
382
|
params: config.params,
|
|
387
383
|
ui: UiSchema,
|
|
@@ -423,9 +419,7 @@ var make = (id, config) => {
|
|
|
423
419
|
const initial = (params) => ({
|
|
424
420
|
params: params ?? config.initialParams,
|
|
425
421
|
ui: config.ui ?? {},
|
|
426
|
-
queries: Object.fromEntries(
|
|
427
|
-
Object.keys(queries).map((k) => [k, Logix4.Resource.Snapshot.idle()])
|
|
428
|
-
)
|
|
422
|
+
queries: Object.fromEntries(Object.keys(queries).map((key) => [key, Logix4.Resource.Snapshot.idle()]))
|
|
429
423
|
});
|
|
430
424
|
const controller = {
|
|
431
425
|
make: (runtime) => {
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/index.ts","../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","../src/TanStack.ts","../src/internal/engine/tanstack.ts","../src/internal/tanstack/observer.ts"],"sourcesContent":["// Public barrel for @logixjs/query\n// Recommended usage:\n// import * as Query from \"@logixjs/query\"\n// Then Query exposes namespaces like make / traits / Engine / TanStack.\n\nexport { make } from './Query.js'\nexport type * from './Query.js'\n\nexport { toStateTraitSpec as traits, source } from './Traits.js'\nexport type * from './Traits.js'\n\nexport { Engine } from './Engine.js'\nexport type { InvalidateRequest, MiddlewareConfig } from './Engine.js'\n\nexport * as TanStack from './TanStack.js'\n","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","export * from './internal/engine/tanstack.js'\nexport * from './internal/tanstack/observer.js'\n","import { Effect, Option } from 'effect'\nimport type { QueryClient } from '@tanstack/query-core'\nimport type { Engine, InvalidateRequest } from '../../Engine.js'\n\nconst makeQueryKey = (resourceId: string, keyHash: string) => [resourceId, keyHash] as const\n\nexport interface TanStackEngineConfig {\n /**\n * The max number of entries per resourceId in the local fast cache.\n * - Goal: prevent unbounded memory growth when the key space is unbounded.\n * - Semantics: evicts oldest entries in insertion order (FIFO); cache misses fall back to re-loading.\n * - Set to Infinity to disable the cap (not recommended for long-running processes).\n */\n readonly maxEntriesPerResource?: number\n}\n\n/**\n * TanStack engine:\n * - Uses QueryClient for invalidation (easy integration with TanStack ecosystem).\n * - fetch/peekFresh uses a slim in-memory cache to avoid frequently creating Query objects on the Logix runtime hot path.\n * - Still preserves Logix Runtime's keyHash gating and ResourceSnapshot source-of-truth semantics.\n */\nexport const engine = (queryClient: QueryClient, config?: TanStackEngineConfig): Engine => {\n const byResourceId = new Map<string, Map<string, unknown>>()\n const maxEntriesPerResource = config?.maxEntriesPerResource ?? 2000\n\n // Align with external QueryClient.clear(): when QueryCache is cleared, clear the local fast cache as well.\n try {\n const queryCache: any = (queryClient as any).getQueryCache?.()\n if (queryCache && typeof queryCache.clear === 'function') {\n const original = queryCache.clear.bind(queryCache)\n queryCache.clear = () => {\n byResourceId.clear()\n return original()\n }\n }\n } catch {\n // ignore\n }\n\n const ensureBucket = (resourceId: string): Map<string, unknown> => {\n let bucket = byResourceId.get(resourceId)\n if (!bucket) {\n bucket = new Map<string, unknown>()\n byResourceId.set(resourceId, bucket)\n }\n return bucket\n }\n\n const evictIfNeeded = (bucket: Map<string, unknown>): void => {\n if (maxEntriesPerResource === Infinity) return\n if (!Number.isFinite(maxEntriesPerResource) || maxEntriesPerResource <= 0) return\n while (bucket.size > maxEntriesPerResource) {\n const firstKey = bucket.keys().next().value as string | undefined\n if (firstKey === undefined) return\n bucket.delete(firstKey)\n }\n }\n\n const fetchFast: Engine['fetchFast'] = (resourceId, keyHash, effect) =>\n Effect.suspend(() => {\n const hit = byResourceId.get(resourceId)?.get(keyHash)\n if (hit !== undefined) {\n return Effect.succeed(hit as any)\n }\n\n return Effect.map(effect, (out) => {\n if (out !== undefined) {\n const bucket = ensureBucket(resourceId)\n bucket.set(keyHash, out)\n evictIfNeeded(bucket)\n }\n return out as any\n })\n })\n\n return {\n fetch: ({ resourceId, keyHash, effect }) => fetchFast!(resourceId, keyHash, effect),\n\n fetchFast,\n\n invalidate: (request: InvalidateRequest) =>\n Effect.gen(function* () {\n yield* Effect.sync(() => {\n if (request.kind === 'byParams') {\n const bucket = byResourceId.get(request.resourceId)\n if (!bucket) return\n bucket.delete(request.keyHash)\n if (bucket.size === 0) {\n byResourceId.delete(request.resourceId)\n }\n return\n }\n\n if (request.kind === 'byResource') {\n byResourceId.delete(request.resourceId)\n return\n }\n\n // byTag: we currently lack a serializable tags mapping; conservatively clear all (explainable but coarse).\n byResourceId.clear()\n })\n\n // Sync to QueryClient (if there are external observers/ecosystem consumers).\n yield* Effect.tryPromise({\n try: () => {\n if (request.kind === 'byResource') {\n return queryClient.invalidateQueries({\n queryKey: [request.resourceId],\n })\n }\n\n if (request.kind === 'byParams') {\n return queryClient.invalidateQueries({\n queryKey: makeQueryKey(request.resourceId, request.keyHash),\n })\n }\n\n return queryClient.invalidateQueries({\n predicate: (q) => {\n const tags = (q.meta as any)?.tags\n return Array.isArray(tags) && tags.includes(request.tag)\n },\n })\n },\n catch: (e) => e,\n }).pipe(Effect.asVoid)\n }),\n\n peekFresh: <A>({ resourceId, keyHash }: { readonly resourceId: string; readonly keyHash: string }) =>\n Effect.sync(() => {\n const hit = byResourceId.get(resourceId)?.get(keyHash) as A | undefined\n return hit === undefined ? Option.none<A>() : Option.some(hit)\n }),\n }\n}\n","import { Effect } from 'effect'\nimport type { QueryClient } from '@tanstack/query-core'\nimport { QueryObserver } from '@tanstack/query-core'\n\n/**\n * observe (subscribe within scope + cleanup):\n * - For scenarios where you want \"TanStack-like automatic tracking\" of enabled/queryKey changes.\n * - Provided as infrastructure; domain logic can choose to use it (no hard dependency).\n */\nexport const observe = <TData = unknown>(params: {\n readonly queryClient: QueryClient\n readonly options: ConstructorParameters<typeof QueryObserver<TData>>[1]\n readonly onResult: (result: unknown) => void\n}): Effect.Effect<QueryObserver<TData>, never, any> =>\n Effect.gen(function* () {\n const observer = new QueryObserver<TData>(params.queryClient, params.options as any)\n const unsubscribe = observer.subscribe(params.onResult as any)\n yield* Effect.addFinalizer(() => Effect.sync(() => unsubscribe()))\n return observer\n })\n"],"mappings":"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","names":["Logix","import_effect","import_effect","import_effect","engine","module","engine","Logix","import_effect","module","Logix","module","import_effect","import_effect"]}
|
|
1
|
+
{"version":3,"sources":["../src/index.ts","../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","../src/TanStack.ts","../src/internal/engine/tanstack.ts","../src/internal/tanstack/observer.ts"],"sourcesContent":["// Public barrel for @logixjs/query\n// Recommended usage:\n// import * as Query from \"@logixjs/query\"\n// Then Query exposes namespaces like make / traits / Engine / TanStack.\n\nexport { make } from './Query.js'\nexport type * from './Query.js'\n\nexport { toStateTraitSpec as traits, source } from './Traits.js'\nexport type * from './Traits.js'\n\nexport { Engine } from './Engine.js'\nexport type { InvalidateRequest, MiddlewareConfig } from './Engine.js'\n\nexport * as TanStack from './TanStack.js'\n","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","export * from './internal/engine/tanstack.js'\nexport * from './internal/tanstack/observer.js'\n","import { Effect, Option } from 'effect'\nimport type { QueryClient } from '@tanstack/query-core'\nimport type { Engine, InvalidateRequest } from '../../Engine.js'\n\nconst makeQueryKey = (resourceId: string, keyHash: string) => [resourceId, keyHash] as const\n\nexport interface TanStackEngineConfig {\n /**\n * The max number of entries per resourceId in the local fast cache.\n * - Goal: prevent unbounded memory growth when the key space is unbounded.\n * - Semantics: evicts oldest entries in insertion order (FIFO); cache misses fall back to re-loading.\n * - Set to Infinity to disable the cap (not recommended for long-running processes).\n */\n readonly maxEntriesPerResource?: number\n}\n\n/**\n * TanStack engine:\n * - Uses QueryClient for invalidation (easy integration with TanStack ecosystem).\n * - fetch/peekFresh uses a slim in-memory cache to avoid frequently creating Query objects on the Logix runtime hot path.\n * - Still preserves Logix Runtime's keyHash gating and ResourceSnapshot source-of-truth semantics.\n */\nexport const engine = (queryClient: QueryClient, config?: TanStackEngineConfig): Engine => {\n const byResourceId = new Map<string, Map<string, unknown>>()\n const maxEntriesPerResource = config?.maxEntriesPerResource ?? 2000\n\n // Align with external QueryClient.clear(): when QueryCache is cleared, clear the local fast cache as well.\n try {\n const queryCache: any = (queryClient as any).getQueryCache?.()\n if (queryCache && typeof queryCache.clear === 'function') {\n const original = queryCache.clear.bind(queryCache)\n queryCache.clear = () => {\n byResourceId.clear()\n return original()\n }\n }\n } catch {\n // ignore\n }\n\n const ensureBucket = (resourceId: string): Map<string, unknown> => {\n let bucket = byResourceId.get(resourceId)\n if (!bucket) {\n bucket = new Map<string, unknown>()\n byResourceId.set(resourceId, bucket)\n }\n return bucket\n }\n\n const evictIfNeeded = (bucket: Map<string, unknown>): void => {\n if (maxEntriesPerResource === Infinity) return\n if (!Number.isFinite(maxEntriesPerResource) || maxEntriesPerResource <= 0) return\n while (bucket.size > maxEntriesPerResource) {\n const firstKey = bucket.keys().next().value as string | undefined\n if (firstKey === undefined) return\n bucket.delete(firstKey)\n }\n }\n\n const fetchFast: Engine['fetchFast'] = (resourceId, keyHash, effect) =>\n Effect.suspend(() => {\n const hit = byResourceId.get(resourceId)?.get(keyHash)\n if (hit !== undefined) {\n return Effect.succeed(hit as any)\n }\n\n return Effect.map(effect, (out) => {\n if (out !== undefined) {\n const bucket = ensureBucket(resourceId)\n bucket.set(keyHash, out)\n evictIfNeeded(bucket)\n }\n return out as any\n })\n })\n\n return {\n fetch: ({ resourceId, keyHash, effect }) => fetchFast!(resourceId, keyHash, effect),\n\n fetchFast,\n\n invalidate: (request: InvalidateRequest) =>\n Effect.gen(function* () {\n yield* Effect.sync(() => {\n if (request.kind === 'byParams') {\n const bucket = byResourceId.get(request.resourceId)\n if (!bucket) return\n bucket.delete(request.keyHash)\n if (bucket.size === 0) {\n byResourceId.delete(request.resourceId)\n }\n return\n }\n\n if (request.kind === 'byResource') {\n byResourceId.delete(request.resourceId)\n return\n }\n\n // byTag: we currently lack a serializable tags mapping; conservatively clear all (explainable but coarse).\n byResourceId.clear()\n })\n\n // Sync to QueryClient (if there are external observers/ecosystem consumers).\n yield* Effect.tryPromise({\n try: () => {\n if (request.kind === 'byResource') {\n return queryClient.invalidateQueries({\n queryKey: [request.resourceId],\n })\n }\n\n if (request.kind === 'byParams') {\n return queryClient.invalidateQueries({\n queryKey: makeQueryKey(request.resourceId, request.keyHash),\n })\n }\n\n return queryClient.invalidateQueries({\n predicate: (q) => {\n const tags = (q.meta as any)?.tags\n return Array.isArray(tags) && tags.includes(request.tag)\n },\n })\n },\n catch: (e) => e,\n }).pipe(Effect.asVoid)\n }),\n\n peekFresh: <A>({ resourceId, keyHash }: { readonly resourceId: string; readonly keyHash: string }) =>\n Effect.sync(() => {\n const hit = byResourceId.get(resourceId)?.get(keyHash) as A | undefined\n return hit === undefined ? Option.none<A>() : Option.some(hit)\n }),\n }\n}\n","import { Effect } from 'effect'\nimport type { QueryClient } from '@tanstack/query-core'\nimport { QueryObserver } from '@tanstack/query-core'\n\n/**\n * observe (subscribe within scope + cleanup):\n * - For scenarios where you want \"TanStack-like automatic tracking\" of enabled/queryKey changes.\n * - Provided as infrastructure; domain logic can choose to use it (no hard dependency).\n */\nexport const observe = <TData = unknown>(params: {\n readonly queryClient: QueryClient\n readonly options: ConstructorParameters<typeof QueryObserver<TData>>[1]\n readonly onResult: (result: unknown) => void\n}): Effect.Effect<QueryObserver<TData>, never, any> =>\n Effect.gen(function* () {\n const observer = new QueryObserver<TData>(params.queryClient, params.options as any)\n const unsubscribe = observer.subscribe(params.onResult as any)\n yield* Effect.addFinalizer(() => Effect.sync(() => unsubscribe()))\n return observer\n })\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,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,CAACC,YAA6D,qBAAM,QAAQ,eAAeA,OAAM;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,UAAMC,UAAS,UAAU;AACzB,QAAI,CAACA,QAAO,UAAW,QAAO;AAE9B,UAAM,UAAU,OAAOA,QAAO,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;AAkFhB,IAAM,SAAS,CAKpB,WAS8C;AAezC,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;;;AMxSA;AAAA;AAAA;AAAA;AAAA;;;ACAA,IAAAC,iBAA+B;AAI/B,IAAM,eAAe,CAAC,YAAoB,YAAoB,CAAC,YAAY,OAAO;AAkB3E,IAAM,SAAS,CAAC,aAA0B,WAA0C;AACzF,QAAM,eAAe,oBAAI,IAAkC;AAC3D,QAAM,wBAAwB,QAAQ,yBAAyB;AAG/D,MAAI;AACF,UAAM,aAAmB,YAAoB,gBAAgB;AAC7D,QAAI,cAAc,OAAO,WAAW,UAAU,YAAY;AACxD,YAAM,WAAW,WAAW,MAAM,KAAK,UAAU;AACjD,iBAAW,QAAQ,MAAM;AACvB,qBAAa,MAAM;AACnB,eAAO,SAAS;AAAA,MAClB;AAAA,IACF;AAAA,EACF,QAAQ;AAAA,EAER;AAEA,QAAM,eAAe,CAAC,eAA6C;AACjE,QAAI,SAAS,aAAa,IAAI,UAAU;AACxC,QAAI,CAAC,QAAQ;AACX,eAAS,oBAAI,IAAqB;AAClC,mBAAa,IAAI,YAAY,MAAM;AAAA,IACrC;AACA,WAAO;AAAA,EACT;AAEA,QAAM,gBAAgB,CAAC,WAAuC;AAC5D,QAAI,0BAA0B,SAAU;AACxC,QAAI,CAAC,OAAO,SAAS,qBAAqB,KAAK,yBAAyB,EAAG;AAC3E,WAAO,OAAO,OAAO,uBAAuB;AAC1C,YAAM,WAAW,OAAO,KAAK,EAAE,KAAK,EAAE;AACtC,UAAI,aAAa,OAAW;AAC5B,aAAO,OAAO,QAAQ;AAAA,IACxB;AAAA,EACF;AAEA,QAAM,YAAiC,CAAC,YAAY,SAAS,WAC3D,sBAAO,QAAQ,MAAM;AACnB,UAAM,MAAM,aAAa,IAAI,UAAU,GAAG,IAAI,OAAO;AACrD,QAAI,QAAQ,QAAW;AACrB,aAAO,sBAAO,QAAQ,GAAU;AAAA,IAClC;AAEA,WAAO,sBAAO,IAAI,QAAQ,CAAC,QAAQ;AACjC,UAAI,QAAQ,QAAW;AACrB,cAAM,SAAS,aAAa,UAAU;AACtC,eAAO,IAAI,SAAS,GAAG;AACvB,sBAAc,MAAM;AAAA,MACtB;AACA,aAAO;AAAA,IACT,CAAC;AAAA,EACH,CAAC;AAEH,SAAO;AAAA,IACL,OAAO,CAAC,EAAE,YAAY,SAAS,OAAO,MAAM,UAAW,YAAY,SAAS,MAAM;AAAA,IAElF;AAAA,IAEA,YAAY,CAAC,YACX,sBAAO,IAAI,aAAa;AACtB,aAAO,sBAAO,KAAK,MAAM;AACvB,YAAI,QAAQ,SAAS,YAAY;AAC/B,gBAAM,SAAS,aAAa,IAAI,QAAQ,UAAU;AAClD,cAAI,CAAC,OAAQ;AACb,iBAAO,OAAO,QAAQ,OAAO;AAC7B,cAAI,OAAO,SAAS,GAAG;AACrB,yBAAa,OAAO,QAAQ,UAAU;AAAA,UACxC;AACA;AAAA,QACF;AAEA,YAAI,QAAQ,SAAS,cAAc;AACjC,uBAAa,OAAO,QAAQ,UAAU;AACtC;AAAA,QACF;AAGA,qBAAa,MAAM;AAAA,MACrB,CAAC;AAGD,aAAO,sBAAO,WAAW;AAAA,QACvB,KAAK,MAAM;AACT,cAAI,QAAQ,SAAS,cAAc;AACjC,mBAAO,YAAY,kBAAkB;AAAA,cACnC,UAAU,CAAC,QAAQ,UAAU;AAAA,YAC/B,CAAC;AAAA,UACH;AAEA,cAAI,QAAQ,SAAS,YAAY;AAC/B,mBAAO,YAAY,kBAAkB;AAAA,cACnC,UAAU,aAAa,QAAQ,YAAY,QAAQ,OAAO;AAAA,YAC5D,CAAC;AAAA,UACH;AAEA,iBAAO,YAAY,kBAAkB;AAAA,YACnC,WAAW,CAAC,MAAM;AAChB,oBAAM,OAAQ,EAAE,MAAc;AAC9B,qBAAO,MAAM,QAAQ,IAAI,KAAK,KAAK,SAAS,QAAQ,GAAG;AAAA,YACzD;AAAA,UACF,CAAC;AAAA,QACH;AAAA,QACA,OAAO,CAAC,MAAM;AAAA,MAChB,CAAC,EAAE,KAAK,sBAAO,MAAM;AAAA,IACvB,CAAC;AAAA,IAEH,WAAW,CAAI,EAAE,YAAY,QAAQ,MACnC,sBAAO,KAAK,MAAM;AAChB,YAAM,MAAM,aAAa,IAAI,UAAU,GAAG,IAAI,OAAO;AACrD,aAAO,QAAQ,SAAY,sBAAO,KAAQ,IAAI,sBAAO,KAAK,GAAG;AAAA,IAC/D,CAAC;AAAA,EACL;AACF;;;ACvIA,IAAAC,iBAAuB;AAEvB,wBAA8B;AAOvB,IAAM,UAAU,CAAkB,WAKvC,sBAAO,IAAI,aAAa;AACtB,QAAM,WAAW,IAAI,gCAAqB,OAAO,aAAa,OAAO,OAAc;AACnF,QAAM,cAAc,SAAS,UAAU,OAAO,QAAe;AAC7D,SAAO,sBAAO,aAAa,MAAM,sBAAO,KAAK,MAAM,YAAY,CAAC,CAAC;AACjE,SAAO;AACT,CAAC;","names":["Logix","import_effect","import_effect","import_effect","engine","module","engine","Logix","import_effect","module","Logix","module","import_effect","import_effect"]}
|