@dava96/osrs-wiki-bucket-builder 1.0.5 → 1.0.6

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export * from './query-builder.js';
 export * from './types.js';
+export * from './response-types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -1,3 +1,4 @@
 export * from './query-builder.js';
 export * from './types.js';
+export * from './response-types.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC"}

package/dist/query-builder.d.ts

@@ -1,15 +1,37 @@
-import type { BucketName } from './generated/definitions.js';
+import type { BucketName, BucketRegistry } from './generated/definitions.js';
+import type { BucketMetaFields, SelectResult, ValidField } from './response-types.js';
 import { type BucketCondition, type BucketHelperCondition, type Operator, type OrderByDirection, type ScalarValue } from './types.js';
 /**
  * A type-safe query builder for OSRS Wiki Buckets.
  *
- * Uses recursive generics to track joined buckets and available fields.
+ * Uses recursive generics to track joined buckets, available fields, and the
+ * inferred result shape. As you chain `.select()`, `.join()`, and `.where()`,
+ * the builder accumulates type information so you get full autocomplete on
+ * field names and automatically inferred response types.
  *
  * @template TMain The name of the primary bucket.
- * @template TJoined A union of alias names or bucket names that have been joined.
- * @template TSelected The shape of the selected data so far.
+ * @template TJoinMap A record mapping alias/bucket names to their target bucket names.
+ * @template TSelected The accumulated result shape (defaults to the full bucket type).
+ * @template THasSelected Whether `.select()` has been called (used to switch from
+ *   full-type default to narrowed selection).
+ *
+ * @example
+ * ```typescript
+ * import { bucket, InferBucketResult } from '@dava96/osrs-wiki-bucket-builder';
+ *
+ * const query = bucket('exchange').select('id', 'name', 'value');
+ * type Row = InferBucketResult<typeof query>;
+ * // Row = { id: number; name: string; value: number; page_name: string; page_name_sub: string }
+ * ```
  */
-export declare class BucketQueryBuilder<TMain extends BucketName, TJoined extends string = never, TSelected = object> {
+export declare class BucketQueryBuilder<TMain extends BucketName, TJoinMap extends Record<string, BucketName> = Record<string, never>, TSelected = BucketRegistry[TMain] & BucketMetaFields, THasSelected extends boolean = false> {
+    /**
+     * Type-level accessor for the inferred result shape.
+     *
+     * This property does not exist at runtime — it is a compile-time brand
+     * used by {@link InferBucketResult} to extract the result type.
+     */
+    readonly __resultType: TSelected;
     private readonly mainBucket;
     private joins;
     private selections;
@@ -20,46 +42,84 @@ export declare class BucketQueryBuilder<TMain extends BucketName, TJoined extend
     private aliasMap;
     constructor(bucket: TMain);
     /**
-     * Selects fields to retrieve.
-     * Supports dot notation for joined buckets (e.g. `shop.price`) and wildcards (`*`, `shop.*`).
+     * Selects fields to retrieve from the query results.
+     *
+     * Supports plain field names, dot notation for joined buckets
+     * (e.g. `'exchange.value'`), and wildcards (`'*'`, `'exchange.*'`).
+     *
+     * Multiple `.select()` calls accumulate — they merge fields rather
+     * than replacing previous selections.
+     *
+     * @param fields - One or more field names to include in the result.
+     *   Your IDE will autocomplete valid field names based on the bucket
+     *   and any active joins.
      *
-     * @param fields The fields to select.
+     * @example
+     * ```typescript
+     * bucket('exchange').select('id', 'name');          // plain fields
+     * bucket('exchange').select('*');                    // all fields
+     * query.join('exchange', 'ex', 'item_name', 'name')
+     *      .select('item_name', 'ex.value', 'ex.limit'); // joined fields
+     * ```
      */
-    select<F extends string>(...fields: F[]): BucketQueryBuilder<TMain, TJoined, TSelected & {
-        [K in F]: unknown;
-    }>;
+    select<F extends ValidField<TMain, TJoinMap>>(...fields: F[]): BucketQueryBuilder<TMain, TJoinMap, THasSelected extends true ? TSelected & SelectResult<TMain, TJoinMap, F> : SelectResult<TMain, TJoinMap, F> & BucketMetaFields, true>;
     /**
      * Joins another bucket to the query.
      *
-     * @param targetBucket The name of the bucket to join.
-     * @param sourceField The field in the current result set to join ON.
-     * @param targetField The field in the target bucket to join ON.
+     * The join is a LEFT JOIN — main bucket rows always appear, but joined
+     * fields may be absent when there is no matching row in the target bucket
+     * (e.g. untradeable items have no exchange entry).
+     *
+     * After joining, dot-notation fields like `'exchange.value'` become
+     * available in `.select()` and `.where()`.
+     *
+     * @param targetBucket - The name of the bucket to join.
+     * @param sourceField - The field in the current result set to join ON.
+     * @param targetField - The field in the target bucket to join ON.
+     *
+     * @example
+     * ```typescript
+     * bucket('infobox_item')
+     *   .join('exchange', 'item_name', 'name')
+     *   .select('item_name', 'exchange.value');
+     * ```
      */
-    join<TTarget extends BucketName>(targetBucket: TTarget, sourceField: string, targetField: string): BucketQueryBuilder<TMain, TJoined | TTarget, TSelected>;
+    join<TTarget extends BucketName>(targetBucket: TTarget, sourceField: string, targetField: string): BucketQueryBuilder<TMain, TJoinMap & Record<TTarget, TTarget>, TSelected, THasSelected>;
     /**
      * Joins another bucket with an alias.
      *
-     * @param targetBucket The name of the bucket to join.
-     * @param alias An alias for this bucket to use in select/where.
-     * @param sourceField The field in the current result set to join ON.
-     * @param targetField The field in the target bucket to join ON.
+     * Aliases let you give joined buckets shorter names for use in
+     * `.select()` and `.where()`. The alias is resolved to the real
+     * bucket name in the generated Lua query.
+     *
+     * @param targetBucket - The name of the bucket to join.
+     * @param alias - An alias for this bucket to use in select/where.
+     * @param sourceField - The field in the current result set to join ON.
+     * @param targetField - The field in the target bucket to join ON.
+     *
+     * @example
+     * ```typescript
+     * bucket('infobox_item')
+     *   .join('exchange', 'ex', 'item_name', 'name')
+     *   .select('item_name', 'ex.value', 'ex.limit');
+     * ```
      */
-    join<TTarget extends BucketName, TAlias extends string>(targetBucket: TTarget, alias: TAlias, sourceField: string, targetField: string): BucketQueryBuilder<TMain, TJoined | TAlias, TSelected>;
+    join<TTarget extends BucketName, TAlias extends string>(targetBucket: TTarget, alias: TAlias, sourceField: string, targetField: string): BucketQueryBuilder<TMain, TJoinMap & Record<TAlias, TTarget>, TSelected, THasSelected>;
     /**
      * Filters results by field equality.
      *
-     * @param field The field to filter on.
-     * @param value The value to match (implies `=` operator).
+     * @param field - The field to filter on. Supports autocomplete for valid field names.
+     * @param value - The value to match (implies `=` operator).
      */
-    where(field: string, value: ScalarValue | BucketHelperCondition): this;
+    where(field: ValidField<TMain, TJoinMap>, value: ScalarValue | BucketHelperCondition): this;
     /**
      * Filters results with an explicit operator.
      *
-     * @param field The field to filter on.
-     * @param op The comparison operator.
-     * @param value The value to compare against.
+     * @param field - The field to filter on. Supports autocomplete for valid field names.
+     * @param op - The comparison operator (`=`, `!=`, `>`, `<`, `>=`, `<=`).
+     * @param value - The value to compare against.
      */
-    where(field: string, op: Operator, value: ScalarValue | BucketHelperCondition): this;
+    where(field: ValidField<TMain, TJoinMap>, op: Operator, value: ScalarValue | BucketHelperCondition): this;
     /**
      * Adds multiple conditions (implicitly AND).
      *
@@ -68,20 +128,30 @@ export declare class BucketQueryBuilder<TMain extends BucketName, TJoined extend
     where(...conditions: BucketCondition[]): this;
     /**
      * Shorthand for `where(field, '!=', value)`.
+     *
+     * @param field - The field to exclude matches on.
+     * @param value - The value to exclude.
      */
-    whereNot(field: string, value: ScalarValue): this;
+    whereNot(field: ValidField<TMain, TJoinMap>, value: ScalarValue): this;
     /**
      * Filters for rows where field is NULL.
+     *
+     * @param field - The field to check for NULL.
      */
-    whereNull(field: string): this;
+    whereNull(field: ValidField<TMain, TJoinMap>): this;
     /**
      * Filters for rows where field is NOT NULL.
+     *
+     * @param field - The field to check for NOT NULL.
      */
-    whereNotNull(field: string): this;
+    whereNotNull(field: ValidField<TMain, TJoinMap>): this;
     /**
      * Filters for rows where field is between two values (inclusive).
+     *
+     * @param field - The field to filter on.
+     * @param range - A tuple of `[min, max]` values (inclusive on both ends).
      */
-    whereBetween(field: string, range: [ScalarValue, ScalarValue]): this;
+    whereBetween(field: ValidField<TMain, TJoinMap>, range: [ScalarValue, ScalarValue]): this;
     /**
      * Conditionally applies a callback to the query.
      *
@@ -91,9 +161,17 @@ export declare class BucketQueryBuilder<TMain extends BucketName, TJoined extend
     when(condition: boolean, callback: (query: this) => void): this;
     /**
      * Filters for rows where field matches any of the given values.
-     * Generates `Bucket.Or({field, v1}, {field, v2}, ...)`.
+     * Generates `Bucket.Or({field, v1}, {field, v2}, ...)` internally.
+     *
+     * @param field - The field to match against.
+     * @param values - An array of values; rows matching any value are included.
+     *
+     * @example
+     * ```typescript
+     * bucket('exchange').whereIn('name', ['Bronze axe', 'Iron axe', 'Steel axe']);
+     * ```
      */
-    whereIn(field: string, values: ScalarValue[]): this;
+    whereIn(field: ValidField<TMain, TJoinMap>, values: ScalarValue[]): this;
     /**
      * Sets the maximum number of rows to return.
      * Accepted range is 1–5000. Defaults to 500.
@@ -113,9 +191,19 @@ export declare class BucketQueryBuilder<TMain extends BucketName, TJoined extend
      */
     paginate(page: number, perPage: number): this;
     /**
-     * Creates an independent copy of this query builder's state.
+     * Creates an independent deep copy of this query builder's state.
+     *
+     * Useful for building query variants from a shared base without
+     * mutating the original.
+     *
+     * @example
+     * ```typescript
+     * const base = bucket('exchange').select('name', 'value').where('value', '>', 0);
+     * const expensive = base.clone().orderBy('value', 'desc').limit(5);
+     * const cheap = base.clone().orderBy('value', 'asc').limit(5);
+     * ```
      */
-    clone(): BucketQueryBuilder<TMain, TJoined, TSelected>;
+    clone(): BucketQueryBuilder<TMain, TJoinMap, TSelected, THasSelected>;
     /**
      * Orders results by a selected field.
      *
@@ -148,18 +236,54 @@ export declare class BucketQueryBuilder<TMain extends BucketName, TJoined extend
     /**
      * Executes the query and returns the Lua query string.
      *
-     * @param options Configuration options.
-     * @param options.encodeURI Whether to URI encode the output (default: true).
-     *                          Set to `false` if you need the raw Lua string for debugging.
+     * @param options - Configuration options.
+     * @param options.encodeURI - Whether to URI encode the output (default: true).
+     *                            Set to `false` if you need the raw Lua string for debugging.
+     *
+     * @example
+     * ```typescript
+     * const encoded = bucket('exchange').select('name').run();                 // URL-encoded
+     * const raw = bucket('exchange').select('name').run({ encodeURI: false }); // raw Lua
+     * ```
      */
     run(options?: {
         encodeURI?: boolean;
     }): string;
+    /**
+     * Generates the full OSRS Wiki Bucket API URL, ready for `fetch()`.
+     *
+     * This is a convenience method that calls `.run()` internally and
+     * wraps the result in the standard API URL template. The query is
+     * always URI-encoded.
+     *
+     * @returns The complete API URL as a string.
+     *
+     * @example
+     * ```typescript
+     * const query = bucket('exchange').select('name', 'value').where('name', 'Abyssal whip');
+     * const data = await fetch(query.toUrl()).then(r => r.json());
+     * ```
+     */
+    toUrl(): string;
 }
 /**
  * Creates a new query builder for the given bucket.
  *
- * @param bucket The name of the bucket to query.
+ * This is the main entry point for building queries. The returned builder
+ * provides autocomplete for field names and tracks the result type as you
+ * chain methods.
+ *
+ * @param bucket - The name of the bucket to query.
+ *
+ * @example
+ * ```typescript
+ * import { bucket } from '@dava96/osrs-wiki-bucket-builder';
+ *
+ * const query = bucket('exchange')
+ *   .select('id', 'name', 'value')
+ *   .where('name', 'Abyssal whip')
+ *   .run();
+ * ```
  */
 export declare function bucket<K extends BucketName>(bucket: K): BucketQueryBuilder<K>;
 //# sourceMappingURL=query-builder.d.ts.map

package/dist/query-builder.d.ts.map

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

package/dist/query-builder.js

@@ -1,13 +1,29 @@
 import { BUCKET_FIELDS } from './generated/definitions.js';
 import { Bucket, QUERY_DEFAULTS, } from './types.js';
+/** Base URL for the OSRS Wiki Bucket API. */
+const BUCKET_API_BASE = 'https://oldschool.runescape.wiki/api.php';
 /**
  * A type-safe query builder for OSRS Wiki Buckets.
  *
- * Uses recursive generics to track joined buckets and available fields.
+ * Uses recursive generics to track joined buckets, available fields, and the
+ * inferred result shape. As you chain `.select()`, `.join()`, and `.where()`,
+ * the builder accumulates type information so you get full autocomplete on
+ * field names and automatically inferred response types.
  *
  * @template TMain The name of the primary bucket.
- * @template TJoined A union of alias names or bucket names that have been joined.
- * @template TSelected The shape of the selected data so far.
+ * @template TJoinMap A record mapping alias/bucket names to their target bucket names.
+ * @template TSelected The accumulated result shape (defaults to the full bucket type).
+ * @template THasSelected Whether `.select()` has been called (used to switch from
+ *   full-type default to narrowed selection).
+ *
+ * @example
+ * ```typescript
+ * import { bucket, InferBucketResult } from '@dava96/osrs-wiki-bucket-builder';
+ *
+ * const query = bucket('exchange').select('id', 'name', 'value');
+ * type Row = InferBucketResult<typeof query>;
+ * // Row = { id: number; name: string; value: number; page_name: string; page_name_sub: string }
+ * ```
  */
 export class BucketQueryBuilder {
     mainBucket;
@@ -23,37 +39,52 @@ export class BucketQueryBuilder {
         this.aliasMap[bucket] = bucket;
     }
     /**
-     * Selects fields to retrieve.
-     * Supports dot notation for joined buckets (e.g. `shop.price`) and wildcards (`*`, `shop.*`).
+     * Selects fields to retrieve from the query results.
+     *
+     * Supports plain field names, dot notation for joined buckets
+     * (e.g. `'exchange.value'`), and wildcards (`'*'`, `'exchange.*'`).
      *
-     * @param fields The fields to select.
+     * Multiple `.select()` calls accumulate — they merge fields rather
+     * than replacing previous selections.
+     *
+     * @param fields - One or more field names to include in the result.
+     *   Your IDE will autocomplete valid field names based on the bucket
+     *   and any active joins.
+     *
+     * @example
+     * ```typescript
+     * bucket('exchange').select('id', 'name');          // plain fields
+     * bucket('exchange').select('*');                    // all fields
+     * query.join('exchange', 'ex', 'item_name', 'name')
+     *      .select('item_name', 'ex.value', 'ex.limit'); // joined fields
+     * ```
      */
     select(...fields) {
         this.selections.push(...fields);
         return this;
     }
-    join(targetBucket, arg2, arg3, arg4) {
+    join(targetBucket, aliasOrSourceField, sourceOrTargetField, maybeTargetField) {
         let alias;
         let sourceField;
         let targetField;
-        if (arg4) {
-            alias = arg2;
-            sourceField = arg3;
-            targetField = arg4;
+        if (maybeTargetField) {
+            alias = aliasOrSourceField;
+            sourceField = sourceOrTargetField;
+            targetField = maybeTargetField;
         }
         else {
-            sourceField = arg2;
-            targetField = arg3;
+            sourceField = aliasOrSourceField;
+            targetField = sourceOrTargetField;
         }
-        const joinObj = {
+        const joinEntry = {
             target: targetBucket,
             onSource: sourceField,
             onTarget: targetField,
         };
         if (alias) {
-            joinObj.alias = alias;
+            joinEntry.alias = alias;
         }
-        this.joins.push(joinObj);
+        this.joins.push(joinEntry);
         if (alias) {
             this.aliasMap[alias] = targetBucket;
         }
@@ -94,24 +125,34 @@ export class BucketQueryBuilder {
     }
     /**
      * Shorthand for `where(field, '!=', value)`.
+     *
+     * @param field - The field to exclude matches on.
+     * @param value - The value to exclude.
      */
     whereNot(field, value) {
         return this.where(field, '!=', value);
     }
     /**
      * Filters for rows where field is NULL.
+     *
+     * @param field - The field to check for NULL.
      */
     whereNull(field) {
         return this.where(field, Bucket.Null());
     }
     /**
      * Filters for rows where field is NOT NULL.
+     *
+     * @param field - The field to check for NOT NULL.
      */
     whereNotNull(field) {
         return this.where(field, '!=', Bucket.Null());
     }
     /**
      * Filters for rows where field is between two values (inclusive).
+     *
+     * @param field - The field to filter on.
+     * @param range - A tuple of `[min, max]` values (inclusive on both ends).
      */
     whereBetween(field, range) {
         return this.where(field, '>=', range[0]).where(field, '<=', range[1]);
@@ -130,7 +171,15 @@ export class BucketQueryBuilder {
     }
     /**
      * Filters for rows where field matches any of the given values.
-     * Generates `Bucket.Or({field, v1}, {field, v2}, ...)`.
+     * Generates `Bucket.Or({field, v1}, {field, v2}, ...)` internally.
+     *
+     * @param field - The field to match against.
+     * @param values - An array of values; rows matching any value are included.
+     *
+     * @example
+     * ```typescript
+     * bucket('exchange').whereIn('name', ['Bronze axe', 'Iron axe', 'Steel axe']);
+     * ```
      */
     whereIn(field, values) {
         const conditions = values.map((v) => [field, v]);
@@ -175,7 +224,17 @@ export class BucketQueryBuilder {
         return this;
     }
     /**
-     * Creates an independent copy of this query builder's state.
+     * Creates an independent deep copy of this query builder's state.
+     *
+     * Useful for building query variants from a shared base without
+     * mutating the original.
+     *
+     * @example
+     * ```typescript
+     * const base = bucket('exchange').select('name', 'value').where('value', '>', 0);
+     * const expensive = base.clone().orderBy('value', 'desc').limit(5);
+     * const cheap = base.clone().orderBy('value', 'asc').limit(5);
+     * ```
      */
     clone() {
         const clone = new BucketQueryBuilder(this.mainBucket);
@@ -373,20 +432,59 @@ export class BucketQueryBuilder {
     /**
      * Executes the query and returns the Lua query string.
      *
-     * @param options Configuration options.
-     * @param options.encodeURI Whether to URI encode the output (default: true).
-     *                          Set to `false` if you need the raw Lua string for debugging.
+     * @param options - Configuration options.
+     * @param options.encodeURI - Whether to URI encode the output (default: true).
+     *                            Set to `false` if you need the raw Lua string for debugging.
+     *
+     * @example
+     * ```typescript
+     * const encoded = bucket('exchange').select('name').run();                 // URL-encoded
+     * const raw = bucket('exchange').select('name').run({ encodeURI: false }); // raw Lua
+     * ```
      */
     run(options = {}) {
         const sql = this.printSQL();
         const shouldEncode = options.encodeURI ?? true;
         return shouldEncode ? encodeURIComponent(sql) : sql;
     }
+    /**
+     * Generates the full OSRS Wiki Bucket API URL, ready for `fetch()`.
+     *
+     * This is a convenience method that calls `.run()` internally and
+     * wraps the result in the standard API URL template. The query is
+     * always URI-encoded.
+     *
+     * @returns The complete API URL as a string.
+     *
+     * @example
+     * ```typescript
+     * const query = bucket('exchange').select('name', 'value').where('name', 'Abyssal whip');
+     * const data = await fetch(query.toUrl()).then(r => r.json());
+     * ```
+     */
+    toUrl() {
+        const encodedQuery = this.run();
+        return `${BUCKET_API_BASE}?action=bucket&format=json&query=${encodedQuery}`;
+    }
 }
 /**
  * Creates a new query builder for the given bucket.
  *
- * @param bucket The name of the bucket to query.
+ * This is the main entry point for building queries. The returned builder
+ * provides autocomplete for field names and tracks the result type as you
+ * chain methods.
+ *
+ * @param bucket - The name of the bucket to query.
+ *
+ * @example
+ * ```typescript
+ * import { bucket } from '@dava96/osrs-wiki-bucket-builder';
+ *
+ * const query = bucket('exchange')
+ *   .select('id', 'name', 'value')
+ *   .where('name', 'Abyssal whip')
+ *   .run();
+ * ```
  */
 export function bucket(bucket) {
     return new BucketQueryBuilder(bucket);

package/dist/query-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"query-builder.js","sourceRoot":"","sources":["../src/query-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EACH,MAAM,EACN,cAAc,GAMjB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;GAQG;AACH,MAAM,OAAO,kBAAkB;IACV,UAAU,CAAQ;IAC3B,KAAK,GAAkF,EAAE,CAAC;IAC1F,UAAU,GAAa,EAAE,CAAC;IAC1B,YAAY,GAAsB,EAAE,CAAC;IACrC,UAAU,GAAW,cAAc,CAAC,KAAK,CAAC;IAC1C,WAAW,GAAW,cAAc,CAAC,MAAM,CAAC;IAC5C,YAAY,GAA0D,EAAE,CAAC;IACzE,QAAQ,GAA2B,EAAE,CAAC;IAE9C,YAAY,MAAa;QACrB,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC;QACzB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IACnC,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAmB,GAAG,MAAW;QACnC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;QAChC,OAAO,IAAwF,CAAC;IACpG,CAAC;IA8BD,IAAI,CAAC,YAAwB,EAAE,IAAY,EAAE,IAAY,EAAE,IAAa;QACpE,IAAI,KAAyB,CAAC;QAC9B,IAAI,WAAmB,CAAC;QACxB,IAAI,WAAmB,CAAC;QAExB,IAAI,IAAI,EAAE,CAAC;YACP,KAAK,GAAG,IAAI,CAAC;YACb,WAAW,GAAG,IAAI,CAAC;YACnB,WAAW,GAAG,IAAI,CAAC;QACvB,CAAC;aAAM,CAAC;YACJ,WAAW,GAAG,IAAI,CAAC;YACnB,WAAW,GAAG,IAAI,CAAC;QACvB,CAAC;QAED,MAAM,OAAO,GAA2E;YACpF,MAAM,EAAE,YAAY;YACpB,QAAQ,EAAE,WAAW;YACrB,QAAQ,EAAE,WAAW;SACxB,CAAC;QACF,IAAI,KAAK,EAAE,CAAC;YACR,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;QAC1B,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEzB,IAAI,KAAK,EAAE,CAAC;YACR,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC;QACxC,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;QAC/C,CAAC;QAED,OAAO,IAAI,CAAC;IAChB,CAAC;IA0BD,KAAK,CAAC,GAAG,IAAmF;QACxF,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACpB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;gBACpB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,IAAI,GAAG,EAAE,CAAC;oBAC5D,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAW,EAAE,GAA4B,CAAC,CAAC,CAAC;gBAC9E,CAAC;qBAAM,CAAC;oBACJ,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAW,EAAE,IAAI,CAAC,CAAC,CAAgB,CAAC,CAAC,CAAC;gBACxE,CAAC;YACL,CAAC;iBAAM,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAwC,CAAC;gBAC3D,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,IAAI,GAAG,EAAE,CAAC;oBAC5D,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAW,EAAE,IAAI,CAAC,CAAC,CAAa,EAAE,GAA4B,CAAC,CAAC,CAAC;gBACnG,CAAC;qBAAM,CAAC;oBACJ,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAW,EAAE,IAAI,CAAC,CAAC,CAAa,EAAE,GAAkB,CAAC,CAAC,CAAC;gBACzF,CAAC;YACL,CAAC;iBAAM,CAAC;gBACJ,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAyB,EAAE,CAAC,CAAC;YAClE,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAyB,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAa,EAAE,KAAkB;QACtC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,KAAa;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,KAAa;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,KAAa,EAAE,KAAiC;QACzD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,SAAkB,EAAE,QAA+B;QACpD,IAAI,SAAS,EAAE,CAAC;YACZ,QAAQ,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,KAAa,EAAE,MAAqB;QACxC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAoB,CAAC,CAAC;QACpE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAa;QACf,IAAI,CAAC,KAAK,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC;QAC3C,CAAC;aAAM,IAAI,KAAK,GAAG,cAAc,CAAC,SAAS,EAAE,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,SAAS,KAAK,gBAAgB,cAAc,CAAC,SAAS,aAAa,CAAC,CAAC;YAClF,IAAI,CAAC,UAAU,GAAG,cAAc,CAAC,SAAS,CAAC;QAC/C,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QAC5B,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAc;QACjB,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;QAC1B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,IAAY,EAAE,OAAe;QAClC,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK;QACD,MAAM,KAAK,GAAG,IAAI,kBAAkB,CAA4B,IAAI,CAAC,UAAU,CAAC,CAAC;QACjF,KAAK,CAAC,QAAQ,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QACtC,KAAK,CAAC,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9B,KAAK,CAAC,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;QACxC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;QACnE,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QACnC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACrC,KAAK,CAAC,YAAY,GAAG,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC;QAC5C,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAA4B,KAAiB,EAAE,SAA2B;QAC7E,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACpD,IAAI,aAAa,GAAG,KAAK,CAAC;YAE1B,IAAI,CAAC,WAAW,EAAE,CAAC;gBACf,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;oBAChC,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;wBACd,aAAa,GAAG,IAAI,CAAC;wBACrB,MAAM;oBACV,CAAC;oBACD,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;wBACrB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;wBAChC,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,GAAG,GAAG,CAAC,EAAE,CAAC;4BAChC,aAAa,GAAG,IAAI,CAAC;4BACrB,MAAM;wBACV,CAAC;oBACL,CAAC;gBACL,CAAC;YACL,CAAC;YAED,IAAI,CAAC,WAAW,IAAI,CAAC,aAAa,EAAE,CAAC;gBACjC,OAAO,CAAC,IAAI,CACR,2BAA2B,KAAK,8DAA8D,CACjG,CAAC;YACN,CAAC;QACL,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK;QACD,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACd,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;OAGG;IACK,YAAY,CAAC,KAAa;QAC9B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QACvC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QACnC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACxB,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACpC,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACK,WAAW,CAAC,KAAa;QAC7B,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YAChB,MAAM,SAAS,GAAa,EAAE,CAAC;YAC/B,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YACxD,SAAS,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YACnD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACzB,MAAM,YAAY,GAAG,aAAa,CAAC,CAAC,CAAC,MAAoB,CAAC,IAAI,EAAE,CAAC;gBACjE,SAAS,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAC7E,CAAC;YACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,CAAC,KAAK,CAAC,CAAC;YACnB,CAAC;YACD,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBACpB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;gBACxB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;gBAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAExC,IAAI,CAAC,UAAU,EAAE,CAAC;oBACd,OAAO,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;gBAC1B,CAAC;gBAED,IAAI,QAAQ,KAAK,GAAG,EAAE,CAAC;oBACnB,MAAM,MAAM,GAAG,aAAa,CAAC,UAAwB,CAAC,IAAI,EAAE,CAAC;oBAC7D,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,UAAU,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC7D,CAAC;qBAAM,CAAC;oBACJ,OAAO,CAAC,IAAI,UAAU,IAAI,QAAQ,GAAG,CAAC,CAAC;gBAC3C,CAAC;YACL,CAAC;QACL,CAAC;QAED,OAAO,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,QAAQ;QACJ,IAAI,GAAG,GAAG,WAAW,IAAI,CAAC,UAAU,IAAI,CAAC;QAEzC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACzB,IAAI,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACxC,IAAI,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YAE9C,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,GAAG,GAAG,GAAG,IAAI,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;YACtC,CAAC;YACD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3B,SAAS,GAAG,GAAG,CAAC,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;YAC3C,CAAC;YAED,GAAG,IAAI,UAAU,CAAC,CAAC,MAAM,OAAO,GAAG,OAAO,SAAS,IAAI,CAAC;QAC5D,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,cAAc,GAAa,EAAE,CAAC;YACpC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBAC9B,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;YAChD,CAAC;YACD,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;gBACnD,GAAG,IAAI,WAAW,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;YAC3C,CAAC;QACL,CAAC;QAED,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;gBAC7C,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;oBACrB,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACxE,CAAC;gBACD,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;YACxC,CAAC,CAAC,CAAC;YACH,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACtB,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC;YAC1B,CAAC;QACL,CAAC;QAED,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACzC,GAAG,IAAI,aAAa,KAAK,OAAO,CAAC,CAAC,SAAS,IAAI,CAAC;QACpD,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,KAAK,cAAc,CAAC,KAAK,EAAE,CAAC;YAC3C,GAAG,IAAI,UAAU,IAAI,CAAC,UAAU,GAAG,CAAC;QACxC,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,KAAK,cAAc,CAAC,MAAM,EAAE,CAAC;YAC7C,GAAG,IAAI,WAAW,IAAI,CAAC,WAAW,GAAG,CAAC;QAC1C,CAAC;QAED,GAAG,IAAI,QAAQ,CAAC;QAChB,OAAO,GAAG,CAAC;IACf,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,IAAqB;QACzC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YACtE,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC9C,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpF,OAAO,UAAU,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,GAAG,CAAC;YACpE,CAAC;YACD,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;gBACvB,OAAO,cAAc,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,SAAU,CAAC,GAAG,CAAC;YAClE,CAAC;YACD,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;gBACxB,OAAO,eAAe,CAAC;YAC3B,CAAC;QACL,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,IAAI,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC5B,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YACrC,CAAC;YAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACpB,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;gBACvB,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,IAAI,MAAM,IAAI,MAAM,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;oBAChG,OAAO,MAAM,KAAK,oBAAoB,CAAC;gBAC3C,CAAC;gBACD,MAAM,GAAG,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;gBAChE,OAAO,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;YACpC,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACpB,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;gBACvB,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;oBACrE,OAAO,MAAM,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC;gBAC3E,CAAC;gBACD,MAAM,GAAG,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;gBAChE,OAAO,MAAM,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC;YAClD,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;;;;;OAMG;IACH,GAAG,CAAC,UAAmC,EAAE;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC5B,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC;QAC/C,OAAO,YAAY,CAAC,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACxD,CAAC;CACJ;AAED;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAuB,MAAS;IAClD,OAAO,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"query-builder.js","sourceRoot":"","sources":["../src/query-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EACH,MAAM,EACN,cAAc,GAMjB,MAAM,YAAY,CAAC;AAEpB,6CAA6C;AAC7C,MAAM,eAAe,GAAG,0CAA0C,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,kBAAkB;IAcV,UAAU,CAAQ;IAC3B,KAAK,GAAkF,EAAE,CAAC;IAC1F,UAAU,GAAa,EAAE,CAAC;IAC1B,YAAY,GAAsB,EAAE,CAAC;IACrC,UAAU,GAAW,cAAc,CAAC,KAAK,CAAC;IAC1C,WAAW,GAAW,cAAc,CAAC,MAAM,CAAC;IAC5C,YAAY,GAA0D,EAAE,CAAC;IACzE,QAAQ,GAA2B,EAAE,CAAC;IAE9C,YAAY,MAAa;QACrB,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC;QACzB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IACnC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,CACF,GAAG,MAAW;QASd,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;QAChC,OAAO,IAON,CAAC;IACN,CAAC;IAuDD,IAAI,CACA,YAAwB,EACxB,kBAA0B,EAC1B,mBAA2B,EAC3B,gBAAyB;QAEzB,IAAI,KAAyB,CAAC;QAC9B,IAAI,WAAmB,CAAC;QACxB,IAAI,WAAmB,CAAC;QAExB,IAAI,gBAAgB,EAAE,CAAC;YACnB,KAAK,GAAG,kBAAkB,CAAC;YAC3B,WAAW,GAAG,mBAAmB,CAAC;YAClC,WAAW,GAAG,gBAAgB,CAAC;QACnC,CAAC;aAAM,CAAC;YACJ,WAAW,GAAG,kBAAkB,CAAC;YACjC,WAAW,GAAG,mBAAmB,CAAC;QACtC,CAAC;QAED,MAAM,SAAS,GAA2E;YACtF,MAAM,EAAE,YAAY;YACpB,QAAQ,EAAE,WAAW;YACrB,QAAQ,EAAE,WAAW;SACxB,CAAC;QACF,IAAI,KAAK,EAAE,CAAC;YACR,SAAS,CAAC,KAAK,GAAG,KAAK,CAAC;QAC5B,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAE3B,IAAI,KAAK,EAAE,CAAC;YACR,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC;QACxC,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;QAC/C,CAAC;QAED,OAAO,IAAiG,CAAC;IAC7G,CAAC;IA0BD,KAAK,CAAC,GAAG,IAAmF;QACxF,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACpB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;gBACpB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,IAAI,GAAG,EAAE,CAAC;oBAC5D,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAW,EAAE,GAA4B,CAAC,CAAC,CAAC;gBAC9E,CAAC;qBAAM,CAAC;oBACJ,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAW,EAAE,IAAI,CAAC,CAAC,CAAgB,CAAC,CAAC,CAAC;gBACxE,CAAC;YACL,CAAC;iBAAM,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAwC,CAAC;gBAC3D,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,IAAI,GAAG,EAAE,CAAC;oBAC5D,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAW,EAAE,IAAI,CAAC,CAAC,CAAa,EAAE,GAA4B,CAAC,CAAC,CAAC;gBACnG,CAAC;qBAAM,CAAC;oBACJ,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAW,EAAE,IAAI,CAAC,CAAC,CAAa,EAAE,GAAkB,CAAC,CAAC,CAAC;gBACzF,CAAC;YACL,CAAC;iBAAM,CAAC;gBACJ,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAyB,EAAE,CAAC,CAAC;YAClE,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAyB,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,KAAkC,EAAE,KAAkB;QAC3D,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACH,SAAS,CAAC,KAAkC;QACxC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,KAAkC;QAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,KAAkC,EAAE,KAAiC;QAC9E,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,SAAkB,EAAE,QAA+B;QACpD,IAAI,SAAS,EAAE,CAAC;YACZ,QAAQ,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,KAAkC,EAAE,MAAqB;QAC7D,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAoB,CAAC,CAAC;QACpE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAa;QACf,IAAI,CAAC,KAAK,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC;QAC3C,CAAC;aAAM,IAAI,KAAK,GAAG,cAAc,CAAC,SAAS,EAAE,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,SAAS,KAAK,gBAAgB,cAAc,CAAC,SAAS,aAAa,CAAC,CAAC;YAClF,IAAI,CAAC,UAAU,GAAG,cAAc,CAAC,SAAS,CAAC;QAC/C,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QAC5B,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAc;QACjB,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;QAC1B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,IAAY,EAAE,OAAe;QAClC,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK;QACD,MAAM,KAAK,GAAG,IAAI,kBAAkB,CAA2C,IAAI,CAAC,UAAU,CAAC,CAAC;QAChG,KAAK,CAAC,QAAQ,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QACtC,KAAK,CAAC,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9B,KAAK,CAAC,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;QACxC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;QACnE,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QACnC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACrC,KAAK,CAAC,YAAY,GAAG,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC;QAC5C,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAA4B,KAAiB,EAAE,SAA2B;QAC7E,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACpD,IAAI,aAAa,GAAG,KAAK,CAAC;YAE1B,IAAI,CAAC,WAAW,EAAE,CAAC;gBACf,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;oBAChC,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;wBACd,aAAa,GAAG,IAAI,CAAC;wBACrB,MAAM;oBACV,CAAC;oBACD,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;wBACrB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;wBAChC,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,GAAG,GAAG,CAAC,EAAE,CAAC;4BAChC,aAAa,GAAG,IAAI,CAAC;4BACrB,MAAM;wBACV,CAAC;oBACL,CAAC;gBACL,CAAC;YACL,CAAC;YAED,IAAI,CAAC,WAAW,IAAI,CAAC,aAAa,EAAE,CAAC;gBACjC,OAAO,CAAC,IAAI,CACR,2BAA2B,KAAK,8DAA8D,CACjG,CAAC;YACN,CAAC;QACL,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK;QACD,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACd,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;OAGG;IACK,YAAY,CAAC,KAAa;QAC9B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QACvC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QACnC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACxB,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACpC,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACK,WAAW,CAAC,KAAa;QAC7B,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YAChB,MAAM,SAAS,GAAa,EAAE,CAAC;YAC/B,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YACxD,SAAS,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YACnD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACzB,MAAM,YAAY,GAAG,aAAa,CAAC,CAAC,CAAC,MAAoB,CAAC,IAAI,EAAE,CAAC;gBACjE,SAAS,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAC7E,CAAC;YACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,CAAC,KAAK,CAAC,CAAC;YACnB,CAAC;YACD,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBACpB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;gBACxB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;gBAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAExC,IAAI,CAAC,UAAU,EAAE,CAAC;oBACd,OAAO,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;gBAC1B,CAAC;gBAED,IAAI,QAAQ,KAAK,GAAG,EAAE,CAAC;oBACnB,MAAM,MAAM,GAAG,aAAa,CAAC,UAAwB,CAAC,IAAI,EAAE,CAAC;oBAC7D,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,UAAU,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC7D,CAAC;qBAAM,CAAC;oBACJ,OAAO,CAAC,IAAI,UAAU,IAAI,QAAQ,GAAG,CAAC,CAAC;gBAC3C,CAAC;YACL,CAAC;QACL,CAAC;QAED,OAAO,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,QAAQ;QACJ,IAAI,GAAG,GAAG,WAAW,IAAI,CAAC,UAAU,IAAI,CAAC;QAEzC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACzB,IAAI,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACxC,IAAI,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YAE9C,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,GAAG,GAAG,GAAG,IAAI,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;YACtC,CAAC;YACD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3B,SAAS,GAAG,GAAG,CAAC,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;YAC3C,CAAC;YAED,GAAG,IAAI,UAAU,CAAC,CAAC,MAAM,OAAO,GAAG,OAAO,SAAS,IAAI,CAAC;QAC5D,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,cAAc,GAAa,EAAE,CAAC;YACpC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBAC9B,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;YAChD,CAAC;YACD,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;gBACnD,GAAG,IAAI,WAAW,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;YAC3C,CAAC;QACL,CAAC;QAED,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;gBAC7C,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;oBACrB,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACxE,CAAC;gBACD,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;YACxC,CAAC,CAAC,CAAC;YACH,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACtB,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC;YAC1B,CAAC;QACL,CAAC;QAED,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACzC,GAAG,IAAI,aAAa,KAAK,OAAO,CAAC,CAAC,SAAS,IAAI,CAAC;QACpD,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,KAAK,cAAc,CAAC,KAAK,EAAE,CAAC;YAC3C,GAAG,IAAI,UAAU,IAAI,CAAC,UAAU,GAAG,CAAC;QACxC,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,KAAK,cAAc,CAAC,MAAM,EAAE,CAAC;YAC7C,GAAG,IAAI,WAAW,IAAI,CAAC,WAAW,GAAG,CAAC;QAC1C,CAAC;QAED,GAAG,IAAI,QAAQ,CAAC;QAChB,OAAO,GAAG,CAAC;IACf,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,IAAqB;QACzC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YACtE,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC9C,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpF,OAAO,UAAU,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,GAAG,CAAC;YACpE,CAAC;YACD,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;gBACvB,OAAO,cAAc,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,SAAU,CAAC,GAAG,CAAC;YAClE,CAAC;YACD,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;gBACxB,OAAO,eAAe,CAAC;YAC3B,CAAC;QACL,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,IAAI,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC5B,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YACrC,CAAC;YAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACpB,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;gBACvB,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,IAAI,MAAM,IAAI,MAAM,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;oBAChG,OAAO,MAAM,KAAK,oBAAoB,CAAC;gBAC3C,CAAC;gBACD,MAAM,GAAG,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;gBAChE,OAAO,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;YACpC,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACpB,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;gBACvB,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;oBACrE,OAAO,MAAM,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC;gBAC3E,CAAC;gBACD,MAAM,GAAG,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;gBAChE,OAAO,MAAM,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC;YAClD,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,UAAmC,EAAE;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC5B,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC;QAC/C,OAAO,YAAY,CAAC,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACxD,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK;QACD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAChC,OAAO,GAAG,eAAe,oCAAoC,YAAY,EAAE,CAAC;IAChF,CAAC;CACJ;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,MAAM,CAAuB,MAAS;IAClD,OAAO,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC"}

package/dist/response-types.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Type-level utilities for inferring the shape of bucket query responses.
+ *
+ * These types work in tandem with {@link BucketQueryBuilder} to provide
+ * compile-time type safety for API responses. As you chain `.select()`,
+ * `.join()`, and other methods, the builder accumulates a result type
+ * that precisely describes the shape of each row returned by the API.
+ *
+ * @module response-types
+ */
+import type { BucketRegistry, BucketName } from './generated/definitions.js';
+/**
+ * Meta-fields that the Wiki Bucket API injects into every response row.
+ *
+ * These are not part of any bucket's schema but are always present in
+ * the JSON response. `page_name` identifies the source wiki page and
+ * `page_name_sub` identifies the subpage or version variant.
+ *
+ * @example
+ * ```typescript
+ * // Every row in the response includes these:
+ * // { "page_name": "Abyssal whip", "page_name_sub": "", "id": 4151, ... }
+ * ```
+ */
+export interface BucketMetaFields {
+    /** The wiki page that sourced this row. */
+    page_name: string;
+    /** The subpage or version variant (empty string if none). */
+    page_name_sub: string;
+}
+/**
+ * Computes the union of all valid field names for a given bucket and join map.
+ *
+ * This powers autocomplete in `.select()` and `.where()`. It includes:
+ * - Direct fields from the main bucket (e.g. `'id'`, `'name'`)
+ * - Dot-prefixed fields from joined buckets (e.g. `'exchange.value'`)
+ * - The global wildcard `'*'` which selects all main bucket fields
+ * - Alias wildcards like `'exchange.*'` which select all fields from a join
+ *
+ * @template TMain - The main bucket being queried.
+ * @template TJoinMap - A record mapping alias names to their target bucket names.
+ *
+ * @example
+ * ```typescript
+ * // For bucket('infobox_item').join('exchange', 'ex', 'item_name', 'name'):
+ * // ValidField = 'item_name' | 'weight' | ... | 'ex.id' | 'ex.name' | ... | '*' | 'ex.*'
+ * ```
+ */
+export type ValidField<TMain extends BucketName, TJoinMap extends Record<string, BucketName>> = (keyof BucketRegistry[TMain] & string) | JoinedFields<TJoinMap> | '*' | JoinedWildcards<TJoinMap>;
+/**
+ * Generates dot-prefixed field names for all joined buckets.
+ * E.g. if TJoinMap = { ex: 'exchange' }, produces `'ex.id' | 'ex.name' | ...`
+ */
+type JoinedFields<TJoinMap extends Record<string, BucketName>> = {
+    [A in keyof TJoinMap & string]: `${A}.${keyof BucketRegistry[TJoinMap[A]] & string}`;
+}[keyof TJoinMap & string];
+/**
+ * Generates wildcard selectors for all joined buckets.
+ * E.g. if TJoinMap = { ex: 'exchange' }, produces `'ex.*'`
+ */
+type JoinedWildcards<TJoinMap extends Record<string, BucketName>> = `${keyof TJoinMap & string}.*`;
+/**
+ * Resolves a single field string to its TypeScript type by delegating to
+ * specialised helpers for each field format.
+ *
+ * The resolution strategy (in order):
+ * 1. `'*'`          → Full main bucket type via {@link ResolveWildcard}
+ * 2. `'alias.*'`    → All aliased fields via {@link ResolveAliasWildcard}
+ * 3. `'alias.field'`→ Single joined field via {@link ResolveDottedField}
+ * 4. `'field'`      → Single main bucket field via {@link ResolveMainField}
+ *
+ * Falls back to `unknown` for unrecognised fields.
+ */
+type ResolveField<TMain extends BucketName, TJoinMap extends Record<string, BucketName>, F extends string> = F extends '*' ? ResolveWildcard<TMain> : F extends `${infer Alias}.*` ? ResolveAliasWildcard<TJoinMap, Alias> : F extends `${infer Alias}.${infer Field}` ? ResolveDottedField<TJoinMap, Alias, Field> : ResolveMainField<TMain, F>;
+/** Resolves `'*'` to the full main bucket interface. */
+type ResolveWildcard<TMain extends BucketName> = BucketRegistry[TMain];
+/**
+ * Resolves `'alias.*'` to all fields from the aliased bucket,
+ * with each key prefixed by the alias (e.g. `'ex.id'`, `'ex.name'`).
+ */
+type ResolveAliasWildcard<TJoinMap extends Record<string, BucketName>, Alias extends string> = Alias extends keyof TJoinMap ? {
+    [K in keyof BucketRegistry[TJoinMap[Alias]] & string as `${Alias}.${K}`]: BucketRegistry[TJoinMap[Alias]][K];
+} : unknown;
+/**
+ * Resolves `'alias.field'` to the field's type from the joined bucket.
+ * First checks if the alias is in the join map, then falls back to
+ * checking if it's a raw bucket name (for unaliased joins).
+ */
+type ResolveDottedField<TJoinMap extends Record<string, BucketName>, Alias extends string, Field extends string> = Alias extends keyof TJoinMap ? LookupField<TJoinMap[Alias], Field> : Alias extends BucketName ? LookupField<Alias, Field> : unknown;
+/** Resolves a plain field name to its type from the main bucket. */
+type ResolveMainField<TMain extends BucketName, F extends string> = F extends keyof BucketRegistry[TMain] ? BucketRegistry[TMain][F] : unknown;
+/** Looks up a field's type from a specific bucket, returning `unknown` if not found. */
+type LookupField<B extends BucketName, F extends string> = F extends keyof BucketRegistry[B] ? BucketRegistry[B][F] : unknown;
+/**
+ * Builds the result object type from a set of selected field strings.
+ *
+ * This is the core type that powers the inferred response shape. It:
+ * - Expands `'*'` to the full main bucket interface
+ * - Expands `'alias.*'` to all prefixed fields from the joined bucket
+ * - Maps plain and dotted fields to their resolved types
+ *
+ * @template TMain - The main bucket name.
+ * @template TJoinMap - Record mapping join aliases to bucket names.
+ * @template Fields - Union of selected field strings.
+ *
+ * @example
+ * ```typescript
+ * type R = SelectResult<'storeline', { exchange: 'exchange' }, 'sold_by' | 'exchange.value'>;
+ * // { sold_by: string; 'exchange.value': number }
+ * ```
+ */
+export type SelectResult<TMain extends BucketName, TJoinMap extends Record<string, BucketName>, Fields extends string> = ('*' extends Fields ? BucketRegistry[TMain] : object) & ExpandAliasWildcards<TMain, TJoinMap, Fields> & {
+    [F in Fields as F extends '*' ? never : F extends `${string}.*` ? never : F]: ResolveField<TMain, TJoinMap, F>;
+};
+/**
+ * Expands alias wildcards (e.g. 'exchange.*') into their full prefixed field sets.
+ * Uses UnionToIntersection to merge multiple wildcard expansions.
+ */
+type ExpandAliasWildcards<TMain extends BucketName, TJoinMap extends Record<string, BucketName>, Fields extends string> = UnionToIntersection<Fields extends `${infer A}.*` ? ResolveField<TMain, TJoinMap, `${A}.*`> : never>;
+/** Converts a union type to an intersection type. */
+type UnionToIntersection<U> = (U extends unknown ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
+/**
+ * Extracts the inferred result type from a `BucketQueryBuilder` instance.
+ *
+ * Use this with `typeof` to get the response row shape without executing the query:
+ *
+ * @example
+ * ```typescript
+ * const query = bucket('exchange').select('id', 'name', 'value');
+ * type Row = InferBucketResult<typeof query>;
+ * // Row = { id: number; name: string; value: number; page_name: string; page_name_sub: string }
+ *
+ * const raw = await fetch(query.toUrl()).then(r => r.json());
+ * const response = new BucketResponse<Row>(raw);
+ * response.first()?.name; // ✅ autocomplete, typed as string
+ * ```
+ */
+export type InferBucketResult<T> = T extends {
+    readonly __resultType: infer R;
+} ? R : unknown;
+export {};
+//# sourceMappingURL=response-types.d.ts.map

package/dist/response-types.d.ts.map

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

package/dist/response-types.js

@@ -0,0 +1,12 @@
+/**
+ * Type-level utilities for inferring the shape of bucket query responses.
+ *
+ * These types work in tandem with {@link BucketQueryBuilder} to provide
+ * compile-time type safety for API responses. As you chain `.select()`,
+ * `.join()`, and other methods, the builder accumulates a result type
+ * that precisely describes the shape of each row returned by the API.
+ *
+ * @module response-types
+ */
+export {};
+//# sourceMappingURL=response-types.js.map

package/dist/response-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-types.js","sourceRoot":"","sources":["../src/response-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/types.d.ts

@@ -60,10 +60,48 @@ export interface BucketApiResponse<T = unknown> {
     error?: string;
 }
 /**
- * Helper class to manipulate/view the response.
+ * Helper class to manipulate and access bucket API response data.
+ *
+ * Can be instantiated directly with a generic type, or use the static
+ * {@link BucketResponse.from} factory to automatically infer the type
+ * from a query builder instance.
+ *
+ * @template T The expected shape of each result row.
+ *
+ * @example
+ * ```typescript
+ * // Option 1: Manual type parameter
+ * const response = new BucketResponse<{ id: number; name: string }>(raw);
+ *
+ * // Option 2: Automatic inference via .from()
+ * const query = bucket('exchange').select('id', 'name');
+ * const response = BucketResponse.from(query, raw);
+ * response.first()?.name; // ✅ typed as string
+ * ```
  */
 export declare class BucketResponse<T = unknown> {
     private readonly raw;
+    /**
+     * Creates a typed `BucketResponse` by inferring the result type
+     * from a `BucketQueryBuilder` instance.
+     *
+     * This eliminates the need to manually specify `InferBucketResult<typeof query>`
+     * — the type flows automatically from the builder's accumulated generics.
+     *
+     * @param _query - The query builder instance (used only for type inference, not called at runtime).
+     * @param raw - The raw JSON response from the Wiki API.
+     *
+     * @example
+     * ```typescript
+     * const query = bucket('exchange').select('name', 'value').where('name', 'Abyssal whip');
+     * const raw = await fetch(query.toUrl()).then(r => r.json());
+     * const response = BucketResponse.from(query, raw);
+     * response.first()?.value; // ✅ typed as number
+     * ```
+     */
+    static from<Q extends {
+        readonly __resultType: unknown;
+    }>(_query: Q, raw: BucketApiResponse<Q['__resultType']>): BucketResponse<Q['__resultType']>;
     constructor(raw: BucketApiResponse<T>);
     /**
      * The Lua query string returned by the API.

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,4BAA4B,CAAC;AAE3C,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AACpD,MAAM,MAAM,QAAQ,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AAC5D,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,MAAM,CAAC;AAE9C,eAAO,MAAM,cAAc;;;;CAI1B,CAAC;AAEF,MAAM,WAAW,WAAW;IACxB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,eAAe,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,SAAS;IACtB,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,eAAe,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;AAEzE,MAAM,MAAM,eAAe,GACrB,CAAC,MAAM,EAAE,WAAW,CAAC,GACrB,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,GAC/B,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAC/B,CAAC,MAAM,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC;AAChD,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,qBAAqB,GAAG;IAAE,MAAM,EAAE,eAAe,EAAE,CAAA;CAAE,CAAC;AAEtG;;;GAGG;AACH,eAAO,MAAM,MAAM;IACf;;;OAGG;yBACkB,eAAe,EAAE,KAAG,qBAAqB;IAE9D;;;OAGG;wBACiB,eAAe,EAAE,KAAG,qBAAqB;IAE7D;;;OAGG;qBACc,eAAe,KAAG,qBAAqB;IAExD;;OAEG;gBACO,qBAAqB;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,OAAO;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,cAAc,CAAC,CAAC,GAAG,OAAO;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAEtD;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;OAGG;IACH,IAAI,OAAO,IAAI,CAAC,EAAE,CAKjB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED;;OAEG;IACH,KAAK,IAAI,CAAC,GAAG,SAAS;CAGzB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,4BAA4B,CAAC;AAE3C,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AACpD,MAAM,MAAM,QAAQ,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AAC5D,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,MAAM,CAAC;AAE9C,eAAO,MAAM,cAAc;;;;CAI1B,CAAC;AAEF,MAAM,WAAW,WAAW;IACxB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,eAAe,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,SAAS;IACtB,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,eAAe,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;AAEzE,MAAM,MAAM,eAAe,GACrB,CAAC,MAAM,EAAE,WAAW,CAAC,GACrB,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,GAC/B,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAC/B,CAAC,MAAM,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC;AAChD,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,qBAAqB,GAAG;IAAE,MAAM,EAAE,eAAe,EAAE,CAAA;CAAE,CAAC;AAEtG;;;GAGG;AACH,eAAO,MAAM,MAAM;IACf;;;OAGG;yBACkB,eAAe,EAAE,KAAG,qBAAqB;IAE9D;;;OAGG;wBACiB,eAAe,EAAE,KAAG,qBAAqB;IAE7D;;;OAGG;qBACc,eAAe,KAAG,qBAAqB;IAExD;;OAEG;gBACO,qBAAqB;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,OAAO;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,cAAc,CAAC,CAAC,GAAG,OAAO;IA0BvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAzBhC;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS;QAAE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;KAAE,EACpD,MAAM,EAAE,CAAC,EACT,GAAG,EAAE,iBAAiB,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,GAC1C,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;gBAIP,GAAG,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAEtD;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;OAGG;IACH,IAAI,OAAO,IAAI,CAAC,EAAE,CAKjB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED;;OAEG;IACH,KAAK,IAAI,CAAC,GAAG,SAAS;CAGzB"}

package/dist/types.js

@@ -33,10 +33,48 @@ export const Bucket = {
     Null: () => ({ _type: 'NULL' }),
 };
 /**
- * Helper class to manipulate/view the response.
+ * Helper class to manipulate and access bucket API response data.
+ *
+ * Can be instantiated directly with a generic type, or use the static
+ * {@link BucketResponse.from} factory to automatically infer the type
+ * from a query builder instance.
+ *
+ * @template T The expected shape of each result row.
+ *
+ * @example
+ * ```typescript
+ * // Option 1: Manual type parameter
+ * const response = new BucketResponse<{ id: number; name: string }>(raw);
+ *
+ * // Option 2: Automatic inference via .from()
+ * const query = bucket('exchange').select('id', 'name');
+ * const response = BucketResponse.from(query, raw);
+ * response.first()?.name; // ✅ typed as string
+ * ```
  */
 export class BucketResponse {
     raw;
+    /**
+     * Creates a typed `BucketResponse` by inferring the result type
+     * from a `BucketQueryBuilder` instance.
+     *
+     * This eliminates the need to manually specify `InferBucketResult<typeof query>`
+     * — the type flows automatically from the builder's accumulated generics.
+     *
+     * @param _query - The query builder instance (used only for type inference, not called at runtime).
+     * @param raw - The raw JSON response from the Wiki API.
+     *
+     * @example
+     * ```typescript
+     * const query = bucket('exchange').select('name', 'value').where('name', 'Abyssal whip');
+     * const raw = await fetch(query.toUrl()).then(r => r.json());
+     * const response = BucketResponse.from(query, raw);
+     * response.first()?.value; // ✅ typed as number
+     * ```
+     */
+    static from(_query, raw) {
+        return new BucketResponse(raw);
+    }
     constructor(raw) {
         this.raw = raw;
     }

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,4BAA4B,CAAC;AAM3C,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,KAAK,EAAE,GAAG;IACV,SAAS,EAAE,IAAI;IACf,MAAM,EAAE,CAAC;CACZ,CAAC;AAyBF;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IAClB;;;OAGG;IACH,GAAG,EAAE,CAAC,GAAG,UAA6B,EAAyB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IAEhG;;;OAGG;IACH,EAAE,EAAE,CAAC,GAAG,UAA6B,EAAyB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAE9F;;;OAGG;IACH,GAAG,EAAE,CAAC,SAA0B,EAAyB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAEzF;;OAEG;IACH,IAAI,EAAE,GAA0B,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;CACzD,CAAC;AAWF;;GAEG;AACH,MAAM,OAAO,cAAc;IACM;IAA7B,YAA6B,GAAyB;QAAzB,QAAG,GAAH,GAAG,CAAsB;IAAG,CAAC;IAE1D;;OAEG;IACH,IAAI,KAAK;QACL,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC;IAChC,CAAC;IAED;;;OAGG;IACH,IAAI,OAAO;QACP,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACL,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;CACJ"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,4BAA4B,CAAC;AAM3C,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,KAAK,EAAE,GAAG;IACV,SAAS,EAAE,IAAI;IACf,MAAM,EAAE,CAAC;CACZ,CAAC;AAyBF;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IAClB;;;OAGG;IACH,GAAG,EAAE,CAAC,GAAG,UAA6B,EAAyB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IAEhG;;;OAGG;IACH,EAAE,EAAE,CAAC,GAAG,UAA6B,EAAyB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAE9F;;;OAGG;IACH,GAAG,EAAE,CAAC,SAA0B,EAAyB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAEzF;;OAEG;IACH,IAAI,EAAE,GAA0B,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;CACzD,CAAC;AAWF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,cAAc;IA0BM;IAzB7B;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,IAAI,CACP,MAAS,EACT,GAAyC;QAEzC,OAAO,IAAI,cAAc,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,YAA6B,GAAyB;QAAzB,QAAG,GAAH,GAAG,CAAsB;IAAG,CAAC;IAE1D;;OAEG;IACH,IAAI,KAAK;QACL,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC;IAChC,CAAC;IAED;;;OAGG;IACH,IAAI,OAAO;QACP,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACL,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;CACJ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dava96/osrs-wiki-bucket-builder",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",

package/readme.md

@@ -12,6 +12,7 @@ Generates valid Lua query strings that can be executed via the Wiki's `action=bu
 ## Features
 
 - **Strict Typing** — TypeScript definitions generated from `Special:AllPages` ensure only valid bucket names and fields compile.
+- **Inferred Response Types** — `.select()`, `.join()`, and `.where()` constrain fields to valid names and accumulate a result type that precisely describes each row.
 - **Fluent API** — Chain `.select()`, `.join()`, `.where()`, `.orderBy()`, `.limit()`, `.offset()`.
 - **Join Aliases** — Multi-bucket joins with alias support and dot-notation (`shop.price`).
 - **Wildcard Expansion** — Client-side `*` and `alias.*` expansion to strict field lists.
@@ -26,18 +27,21 @@ npm install @dava96/osrs-wiki-bucket-builder
 ## Quick Start
 
 ```typescript
-import { bucket } from '@dava96/osrs-wiki-bucket-builder';
+import { bucket, BucketResponse } from '@dava96/osrs-wiki-bucket-builder';
+import type { InferBucketResult } from '@dava96/osrs-wiki-bucket-builder';
 
 const query = bucket('exchange')
     .select('id', 'name', 'value')
-    .where('name', 'Abyssal whip')
-    .run();
+    .where('name', 'Abyssal whip');
 
-// query is a URL-encoded Lua string, ready to use in a fetch call
-const url = `https://oldschool.runescape.wiki/api.php?action=bucket&format=json&query=${query}`;
-const response = await fetch(url);
-const data = await response.json();
-console.log(data.bucket); // [{ id: ..., name: 'Abyssal whip', value: ... }]
+// .toUrl() generates the full API URL, ready to fetch
+const raw = await fetch(query.toUrl()).then(r => r.json());
+
+// BucketResponse.from() infers the result type from the query
+const response = BucketResponse.from(query, raw);
+const whip = response.first();
+console.log(whip?.name);  // ✅ typed as string
+console.log(whip?.value); // ✅ typed as number
 ```
 
 [▶ Run this query](https://oldschool.runescape.wiki/api.php?action=bucket&query=bucket(%27exchange%27).select(%27id%27,%20%27name%27,%20%27value%27).where({%20%27name%27,%20%27Abyssal%20whip%27%20}).run())
@@ -421,11 +425,9 @@ import { bucket, BucketResponse } from '@dava96/osrs-wiki-bucket-builder';
 const query = bucket('exchange')
     .select('name', 'value')
     .where('name', 'Abyssal whip')
-    .first()
-    .run();
+    .first();
 
-const url = `https://oldschool.runescape.wiki/api.php?action=bucket&format=json&query=${query}`;
-const raw = await fetch(url).then(r => r.json());
+const raw = await fetch(query.toUrl()).then(r => r.json());
 const response = new BucketResponse(raw);
 
 console.log(response.results); // Array of matching rows
@@ -434,6 +436,45 @@ console.log(response.query);   // The Lua query echoed by the API
 console.log(response.error);   // Error message if the query failed
 ```
 
+#### `BucketResponse.from()` — typed responses from queries
+
+Use `BucketResponse.from(query, raw)` to automatically infer the result type from the query builder. No manual type parameter required:
+
+```typescript
+const query = bucket('exchange').select('name', 'value');
+const raw = await fetch(query.toUrl()).then(r => r.json());
+const response = BucketResponse.from(query, raw);
+
+response.first()?.name;  // ✅ typed as string
+response.first()?.value; // ✅ typed as number
+```
+
+### `InferBucketResult` — extract the result type
+
+Use `InferBucketResult<typeof query>` to extract the inferred row type without executing the query. Useful for typing variables, function parameters, or API response handlers:
+
+```typescript
+import type { InferBucketResult } from '@dava96/osrs-wiki-bucket-builder';
+
+const query = bucket('exchange').select('id', 'name', 'value');
+type ExchangeRow = InferBucketResult<typeof query>;
+// ExchangeRow = { id: number; name: string; value: number; page_name: string; page_name_sub: string }
+```
+
+### `.toUrl()` — generate the full API URL
+
+Generates the complete Wiki API URL with all query parameters, ready to pass to `fetch()`:
+
+```typescript
+const url = bucket('exchange')
+    .select('name', 'value')
+    .where('value', '>', 100000)
+    .limit(10)
+    .toUrl();
+
+const data = await fetch(url).then(r => r.json());
+```
+
 ---
 
 ## Full Example
@@ -487,6 +528,7 @@ const query = bucket('infobox_item')
 | `.clone()` | Deep copies the builder |
 | `.run(options?)` | Returns the Lua query string (URI-encoded by default) |
 | `.printSQL()` | Returns the raw Lua query string |
+| `.toUrl()` | Generates the full Wiki API URL, ready to `fetch()` |
 
 ### Bucket Helpers
 
@@ -505,6 +547,9 @@ const query = bucket('infobox_item')
 | `BucketRegistry` | Maps bucket names to their field interfaces |
 | `BUCKET_FIELDS` | Runtime map of field names per bucket |
 | `BucketResponse<T>` | Response wrapper class |
+| `BucketResponse.from()` | Creates a typed response from a query builder |
+| `InferBucketResult<T>` | Extracts the inferred row type from a query |
+| `BucketMetaFields` | The `page_name` and `page_name_sub` fields present on every row |
 | `Operator` | Valid comparison operators |
 | `ScalarValue` | `string \| number \| boolean` |