@ethlete/query 6.0.0-next.6 → 6.0.0-next.60

package/generators/report-legacy-query-apis/migration.js

@@ -0,0 +1,256 @@
+import { joinPathFragments } from '@nx/devkit';
+import { writeFileSync } from 'fs';
+import { dirname } from 'path';
+import * as ts from 'typescript';
+import { createMigrationScope } from '../migrate-to-query-v3/migration-scope.js';
+import { QUERY_V3_MIGRATION_REPORT_PATH, QueryV3MigrationReport, } from '../migrate-to-query-v3/report.js';
+import { createSourceFile, getLineNumber, getLineNumberFromPosition } from '../migrate-to-query-v3/shared.js';
+const SOURCE = 'report-legacy-query-apis';
+const SCAN_FILE_ENV = 'ETHLETE_SCAN_FILE';
+const QUERY_PACKAGE = '@ethlete/query';
+const DOCS_URL = 'https://ethlete-sdk-docs.web.app';
+const GROUPS_DOCS = `${DOCS_URL}/query/groups`;
+const COLLECTIONS_GUIDE = `${DOCS_URL}/query/migrating-from-v2#query-collections`;
+const INFINITY_GUIDE = `${DOCS_URL}/query/migrating-from-v2#infinity-queries`;
+const TRIGGER_DOCS = `${DOCS_URL}/components/paged-query-trigger`;
+const ENTITY_GUIDE = `${DOCS_URL}/query/migrating-from-v2#entitystore-becomes-invalidates-and-tags`;
+const CACHING_DOCS = `${DOCS_URL}/query/caching`;
+const TEMPLATES_GUIDE = `${DOCS_URL}/query/migrating-from-v2#templates-read-signals-not-directives`;
+const COLLECTION_FNS = ['createQueryCollection', 'createQueryCollectionSignal', 'createQueryCollectionSubject'];
+const COLLECTION_STATE_FN = 'switchQueryCollectionState';
+const INFINITY_CONFIG_FN = 'createInfinityQueryConfig';
+const ENTITY_STORE_CLASS = 'EntityStore';
+const LEGACY_CREATOR_FN = 'createLegacyQueryCreator';
+const INFINITY_DIRECTIVE = 'InfinityQueryDirective';
+const INFINITY_TRIGGER_DIRECTIVE = 'InfinityQueryTriggerDirective';
+const QUERY_DIRECTIVE = 'QueryDirective';
+const QUERY_DIRECTIVE_PATTERN = /\*etQuery(?![\w-])|\[etQuery\](?=\s*=)/g;
+const INFINITY_DIRECTIVE_PATTERN = /\*etInfinityQuery(?![\w-])/g;
+const INFINITY_TRIGGER_PATTERN = /(?<![\w-])etInfinityQueryTrigger(?![\w-])|<et-infinity-query-trigger(?![\w-])/g;
+const ENTITY_ACTION = `Move every write into the store to \`invalidates\` on the mutation creator (${CACHING_DOCS}#invalidating-from-the-mutation) ` +
+    `and \`tags\` on the reads it changes (${CACHING_DOCS}#tags), and add \`withOptimisticUpdate\` where the UI must change ` +
+    `before the response (${CACHING_DOCS}#optimistic-updates) - see ${ENTITY_GUIDE}.`;
+const isScannableFile = (filePath) => /\.(ts|mts|cts)$/.test(filePath) && !filePath.endsWith('.d.ts');
+const collectQueryImports = (sourceFile) => {
+    const named = new Map();
+    const namespaces = new Set();
+    for (const statement of sourceFile.statements) {
+        if (!ts.isImportDeclaration(statement) ||
+            !ts.isStringLiteral(statement.moduleSpecifier) ||
+            statement.moduleSpecifier.text !== QUERY_PACKAGE) {
+            continue;
+        }
+        const bindings = statement.importClause?.namedBindings;
+        if (!bindings)
+            continue;
+        if (ts.isNamespaceImport(bindings)) {
+            namespaces.add(bindings.name.text);
+            continue;
+        }
+        for (const element of bindings.elements) {
+            named.set(element.name.text, (element.propertyName ?? element.name).text);
+        }
+    }
+    return { named, namespaces };
+};
+const importedNameOf = (expression, imports) => {
+    if (ts.isIdentifier(expression))
+        return imports.named.get(expression.text);
+    if (ts.isPropertyAccessExpression(expression) &&
+        ts.isIdentifier(expression.expression) &&
+        imports.namespaces.has(expression.expression.text)) {
+        return expression.name.text;
+    }
+    return undefined;
+};
+const hasImported = (imports, exportName) => imports.namespaces.size > 0 || [...imports.named.values()].includes(exportName);
+const declaredNameOf = (node) => {
+    const parent = node.parent;
+    if ((ts.isVariableDeclaration(parent) || ts.isPropertyDeclaration(parent) || ts.isPropertyAssignment(parent)) &&
+        parent.initializer === node &&
+        (ts.isIdentifier(parent.name) || ts.isPrivateIdentifier(parent.name))) {
+        return parent.name.text;
+    }
+    return undefined;
+};
+const propertyNamed = (literal, name) => literal.properties.find((property) => (ts.isPropertyAssignment(property) || ts.isShorthandPropertyAssignment(property)) &&
+    ts.isIdentifier(property.name) &&
+    property.name.text === name);
+const isEntityConfigCall = (call, config, imports) => importedNameOf(call.expression, imports) === LEGACY_CREATOR_FN ||
+    (ts.isPropertyAccessExpression(call.expression) && propertyNamed(config, 'route') !== undefined);
+const scanSource = (options) => {
+    const { tree, filePath, sourceFile, imports, report } = options;
+    const at = (node) => [{ filePath, line: getLineNumber(node, sourceFile) }];
+    const keyOf = (kind, node) => `${SOURCE}:${kind}:${filePath}:${node.getStart(sourceFile)}`;
+    const visit = (node) => {
+        if (ts.isCallExpression(node)) {
+            const importedName = importedNameOf(node.expression, imports);
+            const name = declaredNameOf(node);
+            if (importedName && COLLECTION_FNS.includes(importedName)) {
+                report.addFollowUp({
+                    title: `Replace the query collection ${name ?? importedName}`,
+                    summary: `${name ? `\`${name}\` is built with` : 'This call is'} \`${importedName}\`, a legacy query collection. v3 has no query collections.`,
+                    action: `Move an action set where the latest run wins to \`createQueryGroup\` (${GROUPS_DOCS}), a query picked by context to a \`computed\`, and an auth collection to \`createBearerAuthProvider\` - see ${COLLECTIONS_GUIDE}.`,
+                    locations: at(node),
+                    source: SOURCE,
+                    dedupeKey: keyOf('collection', node),
+                });
+            }
+            if (importedName === COLLECTION_STATE_FN) {
+                report.addFollowUp({
+                    title: `Replace switchQueryCollectionState()`,
+                    summary: `\`switchQueryCollectionState()\` reads the state of the query collection member that ran last.`,
+                    action: `Read \`succeeded$\`, \`loading()\` or \`error()\` of the query group that replaces the collection (${GROUPS_DOCS}) - see ${COLLECTIONS_GUIDE}.`,
+                    locations: at(node),
+                    source: SOURCE,
+                    dedupeKey: keyOf('collection-state', node),
+                });
+            }
+            if (importedName === INFINITY_CONFIG_FN) {
+                report.addFollowUp({
+                    title: `Replace the infinity query ${name ?? importedName}`,
+                    summary: `${name ? `\`${name}\` is built with` : 'This call is'} \`createInfinityQueryConfig\`, the legacy infinite query.`,
+                    action: `Move it to \`createPagedQueryStack\` and bind \`[etPagedQueryTrigger]\` to the stack (${TRIGGER_DOCS}) - see ${INFINITY_GUIDE}.`,
+                    locations: at(node),
+                    source: SOURCE,
+                    dedupeKey: keyOf('infinity-config', node),
+                });
+            }
+            const [config] = node.arguments;
+            if (config && ts.isObjectLiteralExpression(config) && isEntityConfigCall(node, config, imports)) {
+                const entity = propertyNamed(config, 'entity');
+                if (entity) {
+                    report.addFollowUp({
+                        title: `Replace the entity config of ${name ?? 'the query creator'}`,
+                        summary: `${name ? `\`${name}\` has` : 'This query creator has'} an \`entity\` config that writes its response into a legacy EntityStore. v3 has no entity store.`,
+                        action: ENTITY_ACTION,
+                        locations: at(entity),
+                        source: SOURCE,
+                        dedupeKey: keyOf('entity-config', entity),
+                    });
+                }
+            }
+        }
+        if (ts.isNewExpression(node) && importedNameOf(node.expression, imports) === ENTITY_STORE_CLASS) {
+            const name = declaredNameOf(node);
+            report.addFollowUp({
+                title: `Replace the entity store ${name ?? ENTITY_STORE_CLASS}`,
+                summary: `${name ? `\`${name}\` is` : 'This is'} a legacy \`EntityStore\`. v3 has no entity store.`,
+                action: ENTITY_ACTION,
+                locations: at(node),
+                source: SOURCE,
+                dedupeKey: keyOf('entity-store', node),
+            });
+        }
+        if (ts.isDecorator(node)) {
+            scanComponentTemplate({ tree, filePath, sourceFile, decorator: node, imports, report });
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(sourceFile);
+};
+const scanComponentTemplate = (options) => {
+    const { tree, filePath, sourceFile, decorator, imports, report } = options;
+    const usesDirective = hasImported(imports, INFINITY_DIRECTIVE);
+    const usesTrigger = hasImported(imports, INFINITY_TRIGGER_DIRECTIVE);
+    const usesQueryDirective = hasImported(imports, QUERY_DIRECTIVE);
+    if (!usesDirective && !usesTrigger && !usesQueryDirective)
+        return;
+    const call = decorator.expression;
+    if (!ts.isCallExpression(call) || !ts.isIdentifier(call.expression) || call.expression.text !== 'Component')
+        return;
+    const [metadata] = call.arguments;
+    if (!metadata || !ts.isObjectLiteralExpression(metadata))
+        return;
+    const template = propertyNamed(metadata, 'template');
+    const templateUrl = propertyNamed(metadata, 'templateUrl');
+    let scanned;
+    if (template &&
+        ts.isPropertyAssignment(template) &&
+        (ts.isStringLiteral(template.initializer) || ts.isNoSubstitutionTemplateLiteral(template.initializer))) {
+        scanned = { text: template.initializer.text, filePath, firstLine: getLineNumber(template.initializer, sourceFile) };
+    }
+    if (templateUrl &&
+        ts.isPropertyAssignment(templateUrl) &&
+        (ts.isStringLiteral(templateUrl.initializer) || ts.isNoSubstitutionTemplateLiteral(templateUrl.initializer))) {
+        const templatePath = joinPathFragments(dirname(filePath), templateUrl.initializer.text);
+        const text = tree.read(templatePath, 'utf-8');
+        if (text !== null)
+            scanned = { text, filePath: templatePath, firstLine: 1 };
+    }
+    if (!scanned)
+        return;
+    const { text, firstLine } = scanned;
+    const templatePath = scanned.filePath;
+    const matches = (pattern) => Array.from(text.matchAll(pattern), (match) => ({
+        line: firstLine + getLineNumberFromPosition(text, match.index) - 1,
+    }));
+    if (usesDirective) {
+        for (const { line } of matches(INFINITY_DIRECTIVE_PATTERN)) {
+            report.addFollowUp({
+                title: 'Replace *etInfinityQuery',
+                summary: 'The template renders a legacy infinite query through `*etInfinityQuery`.',
+                action: `Render the items of the paged query stack that replaces the config with \`@for (item of stack.items(); track item.id)\` - see ${INFINITY_GUIDE}.`,
+                locations: [{ filePath: templatePath, line }],
+                source: SOURCE,
+                dedupeKey: `${SOURCE}:infinity-directive:${templatePath}:${line}`,
+            });
+        }
+    }
+    if (usesQueryDirective) {
+        for (const { line } of matches(QUERY_DIRECTIVE_PATTERN)) {
+            report.addFollowUp({
+                title: 'Replace *etQuery',
+                summary: 'The template renders a query through `*etQuery`, which accepts only legacy queries. Moving its creator off the interop breaks this template.',
+                action: `Read the query's \`loading()\`, \`error()\` and \`response()\` signals in \`@if\` / \`@switch\` blocks - see ${TEMPLATES_GUIDE}.`,
+                locations: [{ filePath: templatePath, line }],
+                source: SOURCE,
+                dedupeKey: `${SOURCE}:query-directive:${templatePath}:${line}`,
+            });
+        }
+    }
+    if (usesTrigger) {
+        for (const { line } of matches(INFINITY_TRIGGER_PATTERN)) {
+            report.addFollowUp({
+                title: 'Replace etInfinityQueryTrigger with etPagedQueryTrigger',
+                summary: '`etInfinityQueryTrigger` loads the next page of a legacy infinite query.',
+                action: `Bind \`[etPagedQueryTrigger]\` to the paged query stack and drop the \`@if (canLoadMore && !loading)\` around it; a trigger on a button becomes \`(click)="stack.fetchNextPage()"\` with \`[etQueryButton]\` - see ${TRIGGER_DOCS}.`,
+                locations: [{ filePath: templatePath, line }],
+                source: SOURCE,
+                dedupeKey: `${SOURCE}:infinity-trigger:${templatePath}:${line}`,
+            });
+        }
+    }
+};
+export const reportLegacyQueryApis = (tree, scope) => {
+    const report = new QueryV3MigrationReport();
+    scope.visit(tree, (filePath) => {
+        if (!isScannableFile(filePath))
+            return;
+        const content = tree.read(filePath, 'utf-8');
+        if (!content || (!content.includes(QUERY_PACKAGE) && !content.includes('entity')))
+            return;
+        const sourceFile = createSourceFile(content, filePath);
+        scanSource({ tree, filePath, sourceFile, imports: collectQueryImports(sourceFile), report });
+    });
+    return report;
+};
+export default async function migrate(tree, schema) {
+    console.log('\n🔄 Reporting legacy query collections, infinity queries, *etQuery templates and entity stores...');
+    const scope = createMigrationScope(tree, schema);
+    console.log(`   Scope: ${scope.describe()}`);
+    const report = reportLegacyQueryApis(tree, scope);
+    const scanFile = process.env[SCAN_FILE_ENV];
+    if (scanFile) {
+        const files = new Set(report.tasks.flatMap((task) => task.locations.map((location) => location.filePath)));
+        writeFileSync(scanFile, JSON.stringify([...files].sort()), 'utf8');
+        return;
+    }
+    if (report.tasks.length === 0 && !tree.exists(QUERY_V3_MIGRATION_REPORT_PATH)) {
+        console.log('   Nothing found.');
+        return;
+    }
+    report.writeToTree(tree, `${SOURCE} in ${scope.describe()}`);
+    report.printSummary();
+}
+//# sourceMappingURL=migration.js.map

package/generators/report-legacy-query-apis/schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "report-legacy-query-apis",
+  "title": "Report legacy query collections, infinity queries, *etQuery templates and entity stores",
+  "type": "object",
+  "properties": {
+    "projects": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Nx projects to scan. Defaults to every project in the workspace.",
+      "alias": "project"
+    },
+    "include": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Path prefixes to scan, relative to the workspace root (e.g. 'libs/queries'). Unioned with `projects`. Defaults to the whole workspace.",
+      "alias": "includePath"
+    }
+  },
+  "required": []
+}

package/migrations/query-field-default-types.md

@@ -0,0 +1,43 @@
+# `queryField<T>()` is typed by its default and reads the URL into that type
+
+`queryField<T>()` used to be typed `T | null` whatever its default, and guessed the type of a URL
+value: `?id=123` became the number `123` even in a `queryField<string>()`. Now:
+
+- A field with a non-null `defaultValue` is typed `T`, and a reset or an unreadable URL value falls
+  back to the default.
+- A URL value is read into the type of the default (number, boolean, string, string list). Without a
+  default it stays a string.
+- Any other `T` needs a `queryParamToValue`: `queryField<number>()` without a default, a `Date` or an
+  object default.
+- `searchQueryField()` and `sortQueryField()` no longer count in `activeFilterCount`, whatever their key.
+
+The type check finds every call site that has to change.
+
+## Find the call sites
+
+```bash
+grep -rnE '\bqueryField<' apps libs --include='*.ts'
+```
+
+## What to change
+
+1. `queryField<number>()` or `queryField<boolean>()` without a default: give it the `defaultValue` it
+   effectively had, or add `queryParamToValue: transformToNumber` (`transformToBoolean`, …) and keep
+   the `null` start. Both transforms are exported from `@ethlete/query`.
+2. A `Date` or object default without a `queryParamToValue`: add one (`transformToDate` for a date).
+3. A field that must hold `null` beside a non-null default - an explicit "none" - is declared
+   `queryField<T | null>({ defaultValue: … })`.
+4. Delete the `?? DEFAULT` on reads of a field that now has a non-null type, and any `!` or cast that
+   only existed to strip `null`.
+5. A field bound to a native `<input type="number">` is declared `number | null`: the input writes
+   `null` when cleared.
+6. A field that relied on the old guess - a `queryField<string>()` read as a number somewhere - gets
+   the type it was really used as.
+7. A UI that counted a search or sort field as a filter: pass `skipInFilterCount: false` to keep it.
+
+## When you are done
+
+Run the type check, the lint task and the tests of every project you changed, and check in the
+browser that a reload restores each list.
+
+The query forms guide is at <https://ethlete-sdk-docs.web.app/query/query-forms>.

package/migrations/search-query-field-string.md

@@ -0,0 +1,43 @@
+# `searchQueryField()` is a `string` that starts at `''`
+
+`searchQueryField()` used to be typed `string | null` and start at `null`. It is typed `string` now and
+starts at `''`, so `[formField]` binds it to `<et-input>` under `strictTemplates`. An empty search still
+writes no URL param, so URLs do not change. The type check finds most call sites; a comparison with
+`null` compiles and silently stops matching.
+
+## Find the call sites
+
+```bash
+grep -rnE 'searchQueryField\(' apps libs --include='*.ts' -l
+```
+
+In each file found, and in each file that reads the form's value, look for the search field's key
+(`search`, `query`, `q`, …) next to `null`:
+
+```bash
+grep -rnE '(search|query|q)\b[^;]*(null|\?\?)' apps libs --include='*.ts'
+```
+
+## What to change
+
+1. A write of `null` - `setValue({ search: null, … })`, `patchValue({ search: null })`, a seed object,
+   a test fixture - writes `''` instead.
+2. A check for an empty search - `search === null`, `search !== null`, `search == null`,
+   `search ?? ''` - becomes `search === ''`, `search !== ''`, or just `search`. `?? ''` is dead code
+   now; delete it.
+3. A search that goes into a request body or GraphQL variables passes `search || null` where the API
+   expects `null` for "no search". Query params need nothing: the client drops an empty string.
+4. A type that restates the value, such as `search: string | null` in an interface built from the
+   form, becomes `string`. Prefer deriving it from `ReturnType<typeof qf.value>`.
+5. A test that expects `null` for an empty search expects `''`.
+
+## Leave these alone
+
+- `queryField<string>()` fields. They still start at `null`.
+- The legacy `SearchQueryField` class. It is unchanged.
+
+## When you are done
+
+Run the type check, the lint task and the tests of every project you changed.
+
+The query forms guide is at <https://ethlete-sdk-docs.web.app/query/query-forms>.

package/migrations.json

@@ -0,0 +1,87 @@
+{
+  "migrations": [
+    {
+      "name": "to-query-v3",
+      "version": "5.42.0",
+      "kind": "auto",
+      "level": "optional",
+      "description": "Move the legacy query system onto the new one through the interop layer.",
+      "generator": "@ethlete/query:migrate-to-query-v3",
+      "docs": "/query/migrating-from-v2"
+    },
+    {
+      "name": "prep-for-query-v3",
+      "version": "6.0.0-beta.8",
+      "kind": "auto",
+      "level": "required",
+      "description": "Prepare the call sites the v3 query system changes, before the move itself.",
+      "generator": "@ethlete/query:prep-for-query-v3",
+      "docs": "/query/migrating-from-v2"
+    },
+    {
+      "name": "query-client-features",
+      "version": "6.0.0-next.23",
+      "kind": "auto",
+      "level": "required",
+      "description": "Move the createQueryClient multiTabSync and persistence options onto opt-in features.",
+      "generator": "@ethlete/query:migrate-query-client-features",
+      "docs": "/query/features"
+    },
+    {
+      "name": "query-opt-in-features",
+      "version": "6.0.0-next.23",
+      "kind": "auto",
+      "level": "required",
+      "description": "Move query clients onto the opt-in error pipeline, and bearer auth onto the opt-in multi-tab sync feature.",
+      "generator": "@ethlete/query:migrate-query-opt-in-features",
+      "docs": "/query/features"
+    },
+    {
+      "name": "deprecate-legacy-queries",
+      "version": "6.0.0-next.24",
+      "kind": "auto",
+      "level": "recommended",
+      "description": "Mark the remaining createLegacyQueryCreator wrappers as deprecated, so their call sites surface as still on v2.",
+      "generator": "@ethlete/query:deprecate-legacy-queries",
+      "scan": "@ethlete/query:deprecate-legacy-queries",
+      "docs": "/query/legacy"
+    },
+    {
+      "name": "search-query-field-string",
+      "version": "6.0.0-next.52",
+      "kind": "assisted",
+      "level": "required",
+      "description": "searchQueryField() is typed string and starts at '' instead of null; writes and checks of null move to ''.",
+      "instructions": "./migrations/search-query-field-string.md",
+      "docs": "/query/query-forms"
+    },
+    {
+      "name": "query-field-default-types",
+      "version": "6.0.0-next.52",
+      "kind": "assisted",
+      "level": "required",
+      "description": "queryField() is typed by its default and reads the URL into that type; fields without a default or with a non-primitive one need a queryParamToValue.",
+      "instructions": "./migrations/query-field-default-types.md",
+      "docs": "/query/query-forms"
+    },
+    {
+      "name": "report-legacy-query-apis",
+      "version": "6.0.0-next.55",
+      "kind": "auto",
+      "level": "optional",
+      "description": "List every query collection, infinity query, *etQuery template and entity store that still needs a hand edit in query-v3-migration-tasks.md.",
+      "generator": "@ethlete/query:report-legacy-query-apis",
+      "scan": "@ethlete/query:report-legacy-query-apis",
+      "docs": "/query/migrating-from-v2"
+    },
+    {
+      "name": "devtools-contract-entry-point",
+      "version": "6.0.0-next.55",
+      "kind": "auto",
+      "level": "required",
+      "description": "Import the devtools contract (the names @ethlete/query-devtools reads) from @ethlete/query/devtools-contract instead of @ethlete/query.",
+      "generator": "@ethlete/query:move-devtools-contract-imports",
+      "docs": "/query-devtools/#the-devtools-contract"
+    }
+  ]
+}

package/package.json

@@ -1,22 +1,34 @@
 {
   "name": "@ethlete/query",
-  "version": "6.0.0-next.6",
+  "version": "6.0.0-next.60",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ethlete-io/ethdk",
+    "directory": "libs/query"
+  },
   "license": "MIT",
   "sideEffects": false,
   "peerDependencies": {
-    "@analogjs/vite-plugin-angular": "2.5.1",
-    "@angular/common": "21.2.13",
-    "@angular/core": "21.2.13",
-    "@angular/forms": "21.2.13",
-    "@angular/router": "21.2.13",
-    "@ethlete/core": "^5.0.0-next.0",
-    "@ethlete/types": "^2.0.0-next.0",
-    "@nx/devkit": "22.7.2",
-    "@nx/vite": "22.7.2",
-    "rxjs": "7.8.2",
-    "socket.io-client": "4.8.3",
-    "typescript": "5.9.3",
-    "vite": "8.0.13"
+    "@angular/common": "^22.1.0",
+    "@angular/core": "^22.1.0",
+    "@angular/forms": "^22.1.0",
+    "@angular/router": "^22.1.0",
+    "@ethlete/core": "^5.0.0-beta.11",
+    "@ethlete/types": "^2.0.0-beta.4",
+    "@nx/devkit": "^24.0.0",
+    "rxjs": "^7.8.0",
+    "typescript": "^6.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@nx/devkit": {
+      "optional": true
+    },
+    "typescript": {
+      "optional": true
+    }
+  },
+  "ethlete": {
+    "migrations": "./migrations.json"
   },
   "generators": "./generators/generators.json",
   "module": "fesm2022/ethlete-query.mjs",
@@ -29,6 +41,14 @@
       "types": "./types/ethlete-query.d.ts",
       "default": "./fesm2022/ethlete-query.mjs"
     },
+    "./devtools-contract": {
+      "types": "./types/ethlete-query-devtools-contract.d.ts",
+      "default": "./fesm2022/ethlete-query-devtools-contract.mjs"
+    },
+    "./ngrx-toolkit": {
+      "types": "./types/ethlete-query-ngrx-toolkit.d.ts",
+      "default": "./fesm2022/ethlete-query-ngrx-toolkit.mjs"
+    },
     "./testing": {
       "types": "./types/ethlete-query-testing.d.ts",
       "default": "./fesm2022/ethlete-query-testing.mjs"

package/types/ethlete-query-devtools-contract.d.ts

@@ -0,0 +1,2 @@
+import { ɵDescribableFeature as DescribableFeature, ɵEMPTY_QUERY_DEVTOOLS_FAULT as EMPTY_QUERY_DEVTOOLS_FAULT, ɵJsonPath as JsonPath, ɵMAX_QUERY_BATCH_TOMBSTONES as MAX_QUERY_BATCH_TOMBSTONES, ɵMAX_QUERY_BATCH_TOMBSTONE_BUCKETS as MAX_QUERY_BATCH_TOMBSTONE_BUCKETS, ɵMAX_QUERY_DEVTOOLS_TOMBSTONES as MAX_QUERY_DEVTOOLS_TOMBSTONES, ɵOverrideOp as OverrideOp, ɵQUERY_DEVTOOLS_FAULT_STATUSES as QUERY_DEVTOOLS_FAULT_STATUSES, ɵQUERY_DEVTOOLS_TOKEN_TTL_LIMIT as QUERY_DEVTOOLS_TOKEN_TTL_LIMIT, ɵQueryDevtoolsAbout as QueryDevtoolsAbout, ɵQueryDevtoolsAuthAccountView as QueryDevtoolsAuthAccountView, ɵQueryDevtoolsAuthLocalAccount as QueryDevtoolsAuthLocalAccount, ɵQueryDevtoolsAuthProviderHandle as QueryDevtoolsAuthProviderHandle, ɵQueryDevtoolsAuthProviderRegistration as QueryDevtoolsAuthProviderRegistration, ɵQueryDevtoolsAuthQuery as QueryDevtoolsAuthQuery, ɵQueryDevtoolsAuthSeed as QueryDevtoolsAuthSeed, ɵQueryDevtoolsAuthSession as QueryDevtoolsAuthSession, ɵQueryDevtoolsEntry as QueryDevtoolsEntry, ɵQueryDevtoolsEntryKind as QueryDevtoolsEntryKind, ɵQueryDevtoolsEntryMeta as QueryDevtoolsEntryMeta, ɵQueryDevtoolsFault as QueryDevtoolsFault, ɵQueryDevtoolsFaultTarget as QueryDevtoolsFaultTarget, ɵQueryDevtoolsFeature as QueryDevtoolsFeature, ɵQueryDevtoolsFormField as QueryDevtoolsFormField, ɵQueryDevtoolsFormHandle as QueryDevtoolsFormHandle, ɵQueryDevtoolsFormLinksHandle as QueryDevtoolsFormLinksHandle, ɵQueryDevtoolsFormLinksRecorder as QueryDevtoolsFormLinksRecorder, ɵQueryDevtoolsMock as QueryDevtoolsMock, ɵQueryDevtoolsMockTarget as QueryDevtoolsMockTarget, ɵQueryDevtoolsOverrideEntry as QueryDevtoolsOverrideEntry, ɵQueryDevtoolsOverrideTransfer as QueryDevtoolsOverrideTransfer, ɵQueryDevtoolsOverrideTransferParse as QueryDevtoolsOverrideTransferParse, ɵQueryDevtoolsOverridesHandle as QueryDevtoolsOverridesHandle, ɵQueryDevtoolsOverridesRecorder as QueryDevtoolsOverridesRecorder, ɵQueryDevtoolsPayload as QueryDevtoolsPayload, ɵQueryDevtoolsRegistrar as QueryDevtoolsRegistrar, ɵQueryDevtoolsRegistration as QueryDevtoolsRegistration, ɵQueryDevtoolsResolvedFault as QueryDevtoolsResolvedFault, ɵQueryDevtoolsResolvedMock as QueryDevtoolsResolvedMock, ɵQueryDevtoolsRoutePart as QueryDevtoolsRoutePart, ɵQueryDevtoolsRun as QueryDevtoolsRun, ɵQueryDevtoolsRunError as QueryDevtoolsRunError, ɵQueryDevtoolsRunStatus as QueryDevtoolsRunStatus, ɵQueryDevtoolsSchemaComponents as QueryDevtoolsSchemaComponents, ɵQueryDevtoolsSchemaRoute as QueryDevtoolsSchemaRoute, ɵQueryDevtoolsSchemaSeed as QueryDevtoolsSchemaSeed, ɵQueryDevtoolsSchemaState as QueryDevtoolsSchemaState, ɵQueryDevtoolsSeedStyle as QueryDevtoolsSeedStyle, ɵQueryDevtoolsSettings as QueryDevtoolsSettings, ɵQueryDevtoolsStats as QueryDevtoolsStats, ɵQueryDevtoolsStatsHandle as QueryDevtoolsStatsHandle, ɵQueryDevtoolsStatsRecorder as QueryDevtoolsStatsRecorder, ɵQueryDevtoolsStorageScope as QueryDevtoolsStorageScope, ɵRestoredQueryDevtoolsOverrides as RestoredQueryDevtoolsOverrides, ɵaddQueryDevtoolsAuthAccount as addQueryDevtoolsAuthAccount, ɵapplyQueryDevtoolsOverrides as applyQueryDevtoolsOverrides, ɵapplyQueryDevtoolsTokenTtl as applyQueryDevtoolsTokenTtl, ɵarmAllQueryDevtoolsMocks as armAllQueryDevtoolsMocks, ɵarmQueryDevtoolsMock as armQueryDevtoolsMock, ɵarmQueryDevtoolsOverrideTransfer as armQueryDevtoolsOverrideTransfer, ɵcanOverrideQueryDevtoolsTokenTtl as canOverrideQueryDevtoolsTokenTtl, ɵclearQueryDevtoolsArmedMocks as clearQueryDevtoolsArmedMocks, ɵclearQueryDevtoolsAuthCredentials as clearQueryDevtoolsAuthCredentials, ɵclearQueryDevtoolsAuthSessions as clearQueryDevtoolsAuthSessions, ɵclearQueryDevtoolsFaults as clearQueryDevtoolsFaults, ɵclearQueryDevtoolsMockStore as clearQueryDevtoolsMockStore, ɵclearQueryDevtoolsOverrideStore as clearQueryDevtoolsOverrideStore, ɵclearQueryDevtoolsStore as clearQueryDevtoolsStore, ɵclearQueryDevtoolsTombstones as clearQueryDevtoolsTombstones, ɵclearRestoredQueryDevtoolsOverrides as clearRestoredQueryDevtoolsOverrides, ɵcollectLeafPaths as collectLeafPaths, ɵcollectQueryDevtoolsSchemaComponents as collectQueryDevtoolsSchemaComponents, ɵcountUnresolvedQueryDevtoolsOverrides as countUnresolvedQueryDevtoolsOverrides, ɵcreateQueryDevtoolsOverrides as createQueryDevtoolsOverrides, ɵdeleteQueryDevtoolsMock as deleteQueryDevtoolsMock, ɵdetectPaginationShape as detectPaginationShape, ɵforgetQueryDevtoolsAuthSession as forgetQueryDevtoolsAuthSession, ɵforgetQueryDevtoolsAuthSessionsFor as forgetQueryDevtoolsAuthSessionsFor, ɵgenerateQueryDevtoolsNumberPreset as generateQueryDevtoolsNumberPreset, ɵgenerateQueryDevtoolsSampleNumber as generateQueryDevtoolsSampleNumber, ɵgenerateQueryDevtoolsStringPreset as generateQueryDevtoolsStringPreset, ɵhasQueryDevtoolsOverridesAtPath as hasQueryDevtoolsOverridesAtPath, ɵisDateShapedLeaf as isDateShapedLeaf, ɵisQueryDevtoolsEnabled as isQueryDevtoolsEnabled, ɵisQueryDevtoolsFaultArmed as isQueryDevtoolsFaultArmed, ɵisQueryDevtoolsRepositoryLive as isQueryDevtoolsRepositoryLive, ɵloadQueryDevtoolsSchema as loadQueryDevtoolsSchema, ɵloginQueryDevtoolsAuthAccount as loginQueryDevtoolsAuthAccount, ɵlogoutQueryDevtoolsAuthSession as logoutQueryDevtoolsAuthSession, ɵmatchesQueryDevtoolsMockPattern as matchesQueryDevtoolsMockPattern, ɵmatchesQueryDevtoolsMockQuery as matchesQueryDevtoolsMockQuery, ɵmeasureQueryDevtoolsPayload as measureQueryDevtoolsPayload, ɵparseQueryDevtoolsOverrideTransfer as parseQueryDevtoolsOverrideTransfer, ɵqueryDevtoolsAbout as queryDevtoolsAbout, ɵqueryDevtoolsAllowsLocalAuthSessions as queryDevtoolsAllowsLocalAuthSessions, ɵqueryDevtoolsApiEnvIds as queryDevtoolsApiEnvIds, ɵqueryDevtoolsApiEnvIsProduction as queryDevtoolsApiEnvIsProduction, ɵqueryDevtoolsApiEnvScope as queryDevtoolsApiEnvScope, ɵqueryDevtoolsApiEnvValues as queryDevtoolsApiEnvValues, ɵqueryDevtoolsApiEnvs as queryDevtoolsApiEnvs, ɵqueryDevtoolsArmedMocks as queryDevtoolsArmedMocks, ɵqueryDevtoolsArmedMocksRestored as queryDevtoolsArmedMocksRestored, ɵqueryDevtoolsAuthAccountsFor as queryDevtoolsAuthAccountsFor, ɵqueryDevtoolsAuthActive as queryDevtoolsAuthActive, ɵqueryDevtoolsAuthFieldsFor as queryDevtoolsAuthFieldsFor, ɵqueryDevtoolsAuthOtherScopeCount as queryDevtoolsAuthOtherScopeCount, ɵqueryDevtoolsAuthSessions as queryDevtoolsAuthSessions, ɵqueryDevtoolsAuthSessionsFor as queryDevtoolsAuthSessionsFor, ɵqueryDevtoolsAuthTabLocal as queryDevtoolsAuthTabLocal, ɵqueryDevtoolsEntries as queryDevtoolsEntries, ɵqueryDevtoolsFaults as queryDevtoolsFaults, ɵqueryDevtoolsFaultsRestored as queryDevtoolsFaultsRestored, ɵqueryDevtoolsMockId as queryDevtoolsMockId, ɵqueryDevtoolsMocks as queryDevtoolsMocks, ɵqueryDevtoolsOverridePersistence as queryDevtoolsOverridePersistence, ɵqueryDevtoolsRequestPath as queryDevtoolsRequestPath, ɵqueryDevtoolsResponseHistory as queryDevtoolsResponseHistory, ɵqueryDevtoolsRestoredOverridesScope as queryDevtoolsRestoredOverridesScope, ɵqueryDevtoolsSchemaNames as queryDevtoolsSchemaNames, ɵqueryDevtoolsSchemaRoutes as queryDevtoolsSchemaRoutes, ɵqueryDevtoolsSchemaState as queryDevtoolsSchemaState, ɵqueryDevtoolsSettings as queryDevtoolsSettings, ɵqueryDevtoolsStorage as queryDevtoolsStorage, ɵqueryDevtoolsTokenTtls as queryDevtoolsTokenTtls, ɵreadQueryDevtoolsStore as readQueryDevtoolsStore, ɵregisterEthleteVersion as registerEthleteVersion, ɵremoveQueryDevtoolsAuthAccount as removeQueryDevtoolsAuthAccount, ɵrenameQueryDevtoolsAuthSession as renameQueryDevtoolsAuthSession, ɵrestoredQueryDevtoolsOverrides as restoredQueryDevtoolsOverrides, ɵsaveQueryDevtoolsMock as saveQueryDevtoolsMock, ɵseedQueryDevtoolsSchemaBody as seedQueryDevtoolsSchemaBody, ɵseedQueryDevtoolsSchemaRoute as seedQueryDevtoolsSchemaRoute, ɵserializeQueryDevtoolsOverrideTransfer as serializeQueryDevtoolsOverrideTransfer, ɵsetQueryDevtoolsApiEnv as setQueryDevtoolsApiEnv, ɵsetQueryDevtoolsAppInfo as setQueryDevtoolsAppInfo, ɵsetQueryDevtoolsArmedMocksScope as setQueryDevtoolsArmedMocksScope, ɵsetQueryDevtoolsAuthCredentials as setQueryDevtoolsAuthCredentials, ɵsetQueryDevtoolsAuthTabLocal as setQueryDevtoolsAuthTabLocal, ɵsetQueryDevtoolsFault as setQueryDevtoolsFault, ɵsetQueryDevtoolsFaultsScope as setQueryDevtoolsFaultsScope, ɵsetQueryDevtoolsOverridePersistence as setQueryDevtoolsOverridePersistence, ɵsetQueryDevtoolsOverridesScope as setQueryDevtoolsOverridesScope, ɵsetQueryDevtoolsSettings as setQueryDevtoolsSettings, ɵsmartDuplicateArrayItem as smartDuplicateArrayItem, ɵsnapshotQueryDevtoolsHandle as snapshotQueryDevtoolsHandle, ɵstringifyQueryRouteParts as stringifyQueryRouteParts, ɵsumQueryDevtoolsStats as sumQueryDevtoolsStats, ɵswitchQueryDevtoolsAuthSession as switchQueryDevtoolsAuthSession, ɵtombstoneOf as tombstoneOf, ɵwriteQueryDevtoolsStore as writeQueryDevtoolsStore } from "@ethlete/query";
+export { type DescribableFeature, EMPTY_QUERY_DEVTOOLS_FAULT, type JsonPath, MAX_QUERY_BATCH_TOMBSTONES, MAX_QUERY_BATCH_TOMBSTONE_BUCKETS, MAX_QUERY_DEVTOOLS_TOMBSTONES, type OverrideOp, QUERY_DEVTOOLS_FAULT_STATUSES, QUERY_DEVTOOLS_TOKEN_TTL_LIMIT, type QueryDevtoolsAbout, type QueryDevtoolsAuthAccountView, type QueryDevtoolsAuthLocalAccount, type QueryDevtoolsAuthProviderHandle, type QueryDevtoolsAuthProviderRegistration, type QueryDevtoolsAuthQuery, type QueryDevtoolsAuthSeed, type QueryDevtoolsAuthSession, type QueryDevtoolsEntry, type QueryDevtoolsEntryKind, type QueryDevtoolsEntryMeta, type QueryDevtoolsFault, type QueryDevtoolsFaultTarget, type QueryDevtoolsFeature, type QueryDevtoolsFormField, type QueryDevtoolsFormHandle, type QueryDevtoolsFormLinksHandle, type QueryDevtoolsFormLinksRecorder, type QueryDevtoolsMock, type QueryDevtoolsMockTarget, type QueryDevtoolsOverrideEntry, type QueryDevtoolsOverrideTransfer, type QueryDevtoolsOverrideTransferParse, type QueryDevtoolsOverridesHandle, type QueryDevtoolsOverridesRecorder, type QueryDevtoolsPayload, type QueryDevtoolsRegistrar, type QueryDevtoolsRegistration, type QueryDevtoolsResolvedFault, type QueryDevtoolsResolvedMock, type QueryDevtoolsRoutePart, type QueryDevtoolsRun, type QueryDevtoolsRunError, type QueryDevtoolsRunStatus, type QueryDevtoolsSchemaComponents, type QueryDevtoolsSchemaRoute, type QueryDevtoolsSchemaSeed, type QueryDevtoolsSchemaState, type QueryDevtoolsSeedStyle, type QueryDevtoolsSettings, type QueryDevtoolsStats, type QueryDevtoolsStatsHandle, type QueryDevtoolsStatsRecorder, type QueryDevtoolsStorageScope, type RestoredQueryDevtoolsOverrides, addQueryDevtoolsAuthAccount, applyQueryDevtoolsOverrides, applyQueryDevtoolsTokenTtl, armAllQueryDevtoolsMocks, armQueryDevtoolsMock, armQueryDevtoolsOverrideTransfer, canOverrideQueryDevtoolsTokenTtl, clearQueryDevtoolsArmedMocks, clearQueryDevtoolsAuthCredentials, clearQueryDevtoolsAuthSessions, clearQueryDevtoolsFaults, clearQueryDevtoolsMockStore, clearQueryDevtoolsOverrideStore, clearQueryDevtoolsStore, clearQueryDevtoolsTombstones, clearRestoredQueryDevtoolsOverrides, collectLeafPaths, collectQueryDevtoolsSchemaComponents, countUnresolvedQueryDevtoolsOverrides, createQueryDevtoolsOverrides, deleteQueryDevtoolsMock, detectPaginationShape, forgetQueryDevtoolsAuthSession, forgetQueryDevtoolsAuthSessionsFor, generateQueryDevtoolsNumberPreset, generateQueryDevtoolsSampleNumber, generateQueryDevtoolsStringPreset, hasQueryDevtoolsOverridesAtPath, isDateShapedLeaf, isQueryDevtoolsEnabled, isQueryDevtoolsFaultArmed, isQueryDevtoolsRepositoryLive, loadQueryDevtoolsSchema, loginQueryDevtoolsAuthAccount, logoutQueryDevtoolsAuthSession, matchesQueryDevtoolsMockPattern, matchesQueryDevtoolsMockQuery, measureQueryDevtoolsPayload, parseQueryDevtoolsOverrideTransfer, queryDevtoolsAbout, queryDevtoolsAllowsLocalAuthSessions, queryDevtoolsApiEnvIds, queryDevtoolsApiEnvIsProduction, queryDevtoolsApiEnvScope, queryDevtoolsApiEnvValues, queryDevtoolsApiEnvs, queryDevtoolsArmedMocks, queryDevtoolsArmedMocksRestored, queryDevtoolsAuthAccountsFor, queryDevtoolsAuthActive, queryDevtoolsAuthFieldsFor, queryDevtoolsAuthOtherScopeCount, queryDevtoolsAuthSessions, queryDevtoolsAuthSessionsFor, queryDevtoolsAuthTabLocal, queryDevtoolsEntries, queryDevtoolsFaults, queryDevtoolsFaultsRestored, queryDevtoolsMockId, queryDevtoolsMocks, queryDevtoolsOverridePersistence, queryDevtoolsRequestPath, queryDevtoolsResponseHistory, queryDevtoolsRestoredOverridesScope, queryDevtoolsSchemaNames, queryDevtoolsSchemaRoutes, queryDevtoolsSchemaState, queryDevtoolsSettings, queryDevtoolsStorage, queryDevtoolsTokenTtls, readQueryDevtoolsStore, registerEthleteVersion, removeQueryDevtoolsAuthAccount, renameQueryDevtoolsAuthSession, restoredQueryDevtoolsOverrides, saveQueryDevtoolsMock, seedQueryDevtoolsSchemaBody, seedQueryDevtoolsSchemaRoute, serializeQueryDevtoolsOverrideTransfer, setQueryDevtoolsApiEnv, setQueryDevtoolsAppInfo, setQueryDevtoolsArmedMocksScope, setQueryDevtoolsAuthCredentials, setQueryDevtoolsAuthTabLocal, setQueryDevtoolsFault, setQueryDevtoolsFaultsScope, setQueryDevtoolsOverridePersistence, setQueryDevtoolsOverridesScope, setQueryDevtoolsSettings, smartDuplicateArrayItem, snapshotQueryDevtoolsHandle, stringifyQueryRouteParts, sumQueryDevtoolsStats, switchQueryDevtoolsAuthSession, tombstoneOf, writeQueryDevtoolsStore };